> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenfactory.nebius.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Resources

MCP resource templates for reading files and metadata. No VM needed.

## image\_file

Read a file from a container image.

**URI**: `contree://image/{image}/read/{path}`

| Parameter | Description                          |
| --------- | ------------------------------------ |
| `image`   | Image UUID or `tag:name`             |
| `path`    | Path inside image (no leading slash) |

**Examples:**

```
contree://image/abc123-uuid/read/etc/passwd
contree://image/tag:alpine:latest/read/etc/os-release
contree://image/tag:python:3.11/read/usr/local/lib/python3.11/site-packages/pip/__init__.py
```

**Returns:** Text content or base64-encoded binary.

***

## image\_ls

List directory contents in a container image.

**URI**: `contree://image/{image}/ls/{path}`

| Parameter | Description                   |
| --------- | ----------------------------- |
| `image`   | Image UUID or `tag:name`      |
| `path`    | Directory path (`.` for root) |

**Examples:**

```
contree://image/abc123-uuid/ls/.
contree://image/tag:python:3.11/ls/usr/local/lib
```

**Returns:** JSON with file listing (path, size, mode, is\_dir, mtime).

***

## image\_lineage

View image parent-child relationships and history.

**URI**: `contree://image/{image}/lineage`

| Parameter | Description |
| --------- | ----------- |
| `image`   | Image UUID  |

**Example:**

```
contree://image/abc123-uuid/lineage
```

**Returns:**

```json theme={null}
{
  "image": "abc123",
  "parent": {"image": "parent-uuid", "command": "pip install numpy"},
  "children": [],
  "ancestors": [],
  "root": {"image": "root-uuid", "registry_url": "docker://alpine:latest"},
  "depth": 2
}
```

**Use for:** Rollback (use any ancestor UUID), understanding history.

***

## guide

Agent guides and best practices.

**URI**: `contree://guide/{section}`

| Section      | Description                                   |
| ------------ | --------------------------------------------- |
| `workflow`   | Complete workflow patterns with decision tree |
| `reference`  | Tool reference and quick lookup               |
| `quickstart` | Common workflows and best practices           |
| `state`      | Image state, rollback, disposable mode        |
| `async`      | Parallel execution patterns                   |
| `tagging`    | Agent tagging conventions                     |
| `errors`     | Error handling and debugging                  |

**Examples:**

```
contree://guide/workflow
contree://guide/quickstart
contree://guide/async
contree://guide/errors
```

***

## instance\_operation

Read instance (command execution) operation details from cache.

**URI**: `contree://operations/instance/{operation_id}`

| Parameter      | Description                                 |
| -------------- | ------------------------------------------- |
| `operation_id` | Operation UUID from `run` with `wait=false` |

**Example:**

```
contree://operations/instance/op-abc-123-def
```

**Returns:**

```json theme={null}
{
  "state": "SUCCESS",
  "exit_code": 0,
  "stdout": "Hello, World!",
  "stderr": "",
  "result_image": "uuid-of-result",
  "resources": {"cpu_time_ms": 150, "memory_mb": 64}
}
```

**Use for:** Retrieving cached results of completed command executions.

***

## import\_operation

Read image import operation details from cache.

**URI**: `contree://operations/import/{operation_id}`

| Parameter      | Description                                          |
| -------------- | ---------------------------------------------------- |
| `operation_id` | Operation UUID from `import_image` with `wait=false` |

**Example:**

```
contree://operations/import/op-xyz-789-abc
```

**Returns:**

```json theme={null}
{
  "state": "SUCCESS",
  "registry_url": "docker://python:3.11-slim",
  "result_image": "uuid-of-imported-image",
  "result_tag": "python:3.11-slim"
}
```

**Use for:** Retrieving cached results of completed image imports.