# FileOperationRecord

> **Class** in `deepagents_cli`

📖 [View in docs](https://reference.langchain.com/python/deepagents-cli/file_ops/FileOperationRecord)

Track a single filesystem tool call.

## Signature

```python
FileOperationRecord(
    self,
    tool_name: str,
    display_path: str,
    physical_path: Path | None,
    tool_call_id: str | None,
    args: dict[str, Any] = dict(),
    status: FileOpStatus = 'pending',
    error: str | None = None,
    metrics: FileOpMetrics = FileOpMetrics(),
    diff: str | None = None,
    before_content: str | None = None,
    after_content: str | None = None,
    read_output: str | None = None,
    hitl_approved: bool = False,
)
```

## Constructors

```python
__init__(
    self,
    tool_name: str,
    display_path: str,
    physical_path: Path | None,
    tool_call_id: str | None,
    args: dict[str, Any] = dict(),
    status: FileOpStatus = 'pending',
    error: str | None = None,
    metrics: FileOpMetrics = FileOpMetrics(),
    diff: str | None = None,
    before_content: str | None = None,
    after_content: str | None = None,
    read_output: str | None = None,
    hitl_approved: bool = False,
) -> None
```

| Name | Type |
|------|------|
| `tool_name` | `str` |
| `display_path` | `str` |
| `physical_path` | `Path \| None` |
| `tool_call_id` | `str \| None` |
| `args` | `dict[str, Any]` |
| `status` | `FileOpStatus` |
| `error` | `str \| None` |
| `metrics` | `FileOpMetrics` |
| `diff` | `str \| None` |
| `before_content` | `str \| None` |
| `after_content` | `str \| None` |
| `read_output` | `str \| None` |
| `hitl_approved` | `bool` |


## Properties

- `tool_name`
- `display_path`
- `physical_path`
- `tool_call_id`
- `args`
- `status`
- `error`
- `metrics`
- `diff`
- `before_content`
- `after_content`
- `read_output`
- `hitl_approved`

---

[View source on GitHub](https://github.com/langchain-ai/deepagents/blob/b710a69b12e49479045eaa54dfb709326473500b/libs/cli/deepagents_cli/file_ops.py#L108)