Graphorin API reference v0.4.0
Graphorin API reference / @graphorin/core / / ResultHandle
Interface: ResultHandle
Defined in: packages/core/src/types/tool.ts:193
An opaque, run-scoped reference to a large tool result that was stored out of the conversation buffer rather than inlined in full. The agent inlines preview (plus a retrieval hint) and registers the built-in read_result tool so the model can page through the full artifact behind uri on demand — keeping large results out of the context window (P1-4).
Stable
Properties
| Property | Modifier | Type | Description | Defined in |
|---|---|---|---|---|
bytes? | readonly | number | Total byte size of the full stored artifact, when known. | packages/core/src/types/tool.ts:206 |
kind | readonly | "spill-file" | "resource-link" | Backing store kind. 'spill-file' today; 'resource-link' is reserved for MCP (WI-13). | packages/core/src/types/tool.ts:202 |
mediaType? | readonly | string | MIME type of the stored artifact, when known. | packages/core/src/types/tool.ts:208 |
preview | readonly | string | A bounded preview of the full body (already inlined alongside the handle). | packages/core/src/types/tool.ts:204 |
uri | readonly | string | Opaque, run-scoped URI — e.g. graphorin-spill:<runId>/<toolCallId>.json for a spill artifact. Never a raw filesystem path: the reader resolves it within the configured artifact root, so the model cannot use it to read arbitrary files. | packages/core/src/types/tool.ts:200 |