Graphorin API reference v0.7.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 |
producerTrustClass? | readonly | ToolTrustClass | Trust class of the tool that PRODUCED the stored body (TL-6). read_result re-applies inbound sanitization and dataflow provenance by this class, so an untrusted spill cannot launder to trusted through the built-in reader. | packages/core/src/types/tool.ts:215 |
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 |