# Panes

> Create, arrange and fill indicator panes.

Source: https://kcq.nebutra.com/docs/agent/tools/panes


<Callout>
  Generated from the pinned chart source (

  [`1aa5e22`](https://github.com/TsekaLuk/KLineChartQuant/blob/1aa5e22c61313a34d08878ad895e604e0d4a85e9/packages/core/src/foundation/agent/chartToolRegistry.ts)

  ). Descriptions are the exact text the model receives.
</Callout>

panes_list [#panes_list]

<ToolMeta label="List panes" safety="read-only" safetyLabel="Read-only" mode="Runs in parallel" origin="Chart core" source="https://github.com/TsekaLuk/KLineChartQuant/blob/1aa5e22c61313a34d08878ad895e604e0d4a85e9/packages/core/src/features/agent/impl/chartAgentController.ts#L483" sourceLabel="Source" />

List the current pane layout and capabilities. Use paneId values from this result when creating drawings or changing a pane.

**Parameters**

This tool takes no input.

<ToolSchema name="panes_list" label="JSON Schema" />

pane_create [#pane_create]

<ToolMeta label="Create pane" safety="destructive" safetyLabel="Modifies the chart" mode="Runs in order" origin="Chart core" source="https://github.com/TsekaLuk/KLineChartQuant/blob/1aa5e22c61313a34d08878ad895e604e0d4a85e9/packages/core/src/features/agent/impl/chartAgentController.ts#L506" sourceLabel="Source" />

Create one indicator pane with a unique paneId, complete indicator params, and a registered sub-pane indicator that has renderers. Returns false when paneId exists or the indicator cannot render in a sub-pane.

**Parameters**

| Name                     | Type                | Required | Constraints               | Description |
| ------------------------ | ------------------- | -------- | ------------------------- | ----------- |
| <code>paneId</code>      | <code>string</code> | Yes      | min length <code>1</code> |             |
| <code>indicatorId</code> | <code>string</code> | Yes      | min length <code>1</code> |             |
| <code>params</code>      | <code>record</code> | Yes      | —                         |             |

**Minimal input** · Required fields only; placeholders are derived from the schema.

```json
{
  "paneId": "<paneId>",
  "indicatorId": "<indicatorId>",
  "params": {}
}
```

<ToolSchema name="pane_create" label="JSON Schema" />

pane_update [#pane_update]

<ToolMeta label="Update pane" safety="destructive" safetyLabel="Modifies the chart" mode="Runs in order" origin="Chart core" source="https://github.com/TsekaLuk/KLineChartQuant/blob/1aa5e22c61313a34d08878ad895e604e0d4a85e9/packages/core/src/features/agent/impl/chartAgentController.ts#L524" sourceLabel="Source" />

Update one pane layout patch. ratio is relative among visible panes; minHeightPx is a positive CSS-pixel constraint.

**Parameters**

| Name                           | Type                 | Required | Constraints               | Description |
| ------------------------------ | -------------------- | -------- | ------------------------- | ----------- |
| <code>paneId</code>            | <code>string</code>  | Yes      | min length <code>1</code> |             |
| <code>patch</code>             | <code>object</code>  | Yes      | —                         |             |
| <code>patch.ratio</code>       | <code>number</code>  | —        | > <code>0</code>          |             |
| <code>patch.visible</code>     | <code>boolean</code> | —        | —                         |             |
| <code>patch.minHeightPx</code> | <code>number</code>  | —        | > <code>0</code>          |             |

**Minimal input** · Required fields only; placeholders are derived from the schema.

```json
{
  "paneId": "<paneId>",
  "patch": {}
}
```

<ToolSchema name="pane_update" label="JSON Schema" />

pane_remove [#pane_remove]

<ToolMeta label="Remove pane" safety="destructive" safetyLabel="Modifies the chart" mode="Runs in order" origin="Chart core" source="https://github.com/TsekaLuk/KLineChartQuant/blob/1aa5e22c61313a34d08878ad895e604e0d4a85e9/packages/core/src/features/agent/impl/chartAgentController.ts#L538" sourceLabel="Source" />

Remove one user pane and its indicator content. System-owned mode panes cannot be removed.

**Parameters**

| Name                | Type                | Required | Constraints               | Description |
| ------------------- | ------------------- | -------- | ------------------------- | ----------- |
| <code>paneId</code> | <code>string</code> | Yes      | min length <code>1</code> |             |

**Minimal input** · Required fields only; placeholders are derived from the schema.

```json
{
  "paneId": "<paneId>"
}
```

<ToolSchema name="pane_remove" label="JSON Schema" />

pane_move [#pane_move]

<ToolMeta label="Move pane" safety="destructive" safetyLabel="Modifies the chart" mode="Runs in order" origin="Chart core" source="https://github.com/TsekaLuk/KLineChartQuant/blob/1aa5e22c61313a34d08878ad895e604e0d4a85e9/packages/core/src/features/agent/impl/chartAgentController.ts#L552" sourceLabel="Source" />

Move one pane to a zero-based layout index without changing its indicator content.

**Parameters**

| Name                     | Type                 | Required | Constraints               | Description |
| ------------------------ | -------------------- | -------- | ------------------------- | ----------- |
| <code>paneId</code>      | <code>string</code>  | Yes      | min length <code>1</code> |             |
| <code>targetIndex</code> | <code>integer</code> | Yes      | ≥ <code>0</code>          |             |

**Minimal input** · Required fields only; placeholders are derived from the schema.

```json
{
  "paneId": "<paneId>",
  "targetIndex": 0
}
```

<ToolSchema name="pane_move" label="JSON Schema" />

pane_replace_content [#pane_replace_content]

<ToolMeta label="Replace pane content" safety="destructive" safetyLabel="Modifies the chart" mode="Runs in order" origin="Chart core" source="https://github.com/TsekaLuk/KLineChartQuant/blob/1aa5e22c61313a34d08878ad895e604e0d4a85e9/packages/core/src/features/agent/impl/chartAgentController.ts#L566" sourceLabel="Source" />

Replace an existing user pane indicator with a registered sub-pane indicator that has renderers and complete params. The pane layout is preserved; returns false when the indicator cannot render in a sub-pane.

**Parameters**

| Name                     | Type                | Required | Constraints               | Description |
| ------------------------ | ------------------- | -------- | ------------------------- | ----------- |
| <code>paneId</code>      | <code>string</code> | Yes      | min length <code>1</code> |             |
| <code>indicatorId</code> | <code>string</code> | Yes      | min length <code>1</code> |             |
| <code>params</code>      | <code>record</code> | Yes      | —                         |             |

**Minimal input** · Required fields only; placeholders are derived from the schema.

```json
{
  "paneId": "<paneId>",
  "indicatorId": "<indicatorId>",
  "params": {}
}
```

<ToolSchema name="pane_replace_content" label="JSON Schema" />

pane_update_content [#pane_update_content]

<ToolMeta label="Update pane content" safety="destructive" safetyLabel="Modifies the chart" mode="Runs in order" origin="Chart core" source="https://github.com/TsekaLuk/KLineChartQuant/blob/1aa5e22c61313a34d08878ad895e604e0d4a85e9/packages/core/src/features/agent/impl/chartAgentController.ts#L590" sourceLabel="Source" />

Replace the complete parameter object of one user pane indicator.

**Parameters**

| Name                | Type                | Required | Constraints               | Description |
| ------------------- | ------------------- | -------- | ------------------------- | ----------- |
| <code>paneId</code> | <code>string</code> | Yes      | min length <code>1</code> |             |
| <code>params</code> | <code>record</code> | Yes      | —                         |             |

**Minimal input** · Required fields only; placeholders are derived from the schema.

```json
{
  "paneId": "<paneId>",
  "params": {}
}
```

<ToolSchema name="pane_update_content" label="JSON Schema" />

panes_clear [#panes_clear]

<ToolMeta label="Clear panes" safety="destructive" safetyLabel="Modifies the chart" mode="Runs in order" origin="Chart core" source="https://github.com/TsekaLuk/KLineChartQuant/blob/1aa5e22c61313a34d08878ad895e604e0d4a85e9/packages/core/src/features/agent/impl/chartAgentController.ts#L603" sourceLabel="Source" />

Remove every user-created indicator pane and its content. Main and mode-owned panes are retained.

**Parameters**

This tool takes no input.

<ToolSchema name="panes_clear" label="JSON Schema" />
