Graphorin API reference v0.1.0
Graphorin API reference / @graphorin/sessions / / ToolCassetteRecorder
Interface: ToolCassetteRecorder
Defined in: packages/sessions/src/cassette/recorder.ts:52
Surface returned by createToolCassetteRecorder. The recorder is async-only — every event the runtime drains is a Promise so backpressure does not block the agent loop.
Stable
Methods
close()
close(): Promise<ToolCassetteFooterRecord>;Defined in: packages/sessions/src/cassette/recorder.ts:68
Close the cassette + return the footer. Idempotent.
Returns
Promise<ToolCassetteFooterRecord>
flushToFile()
flushToFile(): Promise<{
path: string;
recordCount: number;
sha256: string;
}>;Defined in: packages/sessions/src/cassette/recorder.ts:73
Flush the cassette to the configured outputPath. Returns the { path, recordCount, sha256 } summary surfaced to the caller.
Returns
Promise<{ path: string; recordCount: number; sha256: string; }>
recordAuditSegment()
recordAuditSegment(record): Promise<void>;Defined in: packages/sessions/src/cassette/recorder.ts:66
Record an audit chain segment.
Parameters
| Parameter | Type |
|---|---|
record | Omit<CassetteAuditRecord, "kind"> |
Returns
Promise<void>
recordCompaction()
recordCompaction(record): Promise<void>;Defined in: packages/sessions/src/cassette/recorder.ts:62
Record a compaction event.
Parameters
| Parameter | Type |
|---|---|
record | Omit<CompactionRecord, "kind"> |
Returns
Promise<void>
recordModelFallback()
recordModelFallback(record): Promise<void>;Defined in: packages/sessions/src/cassette/recorder.ts:60
Record a model-fallback chain advance.
Parameters
| Parameter | Type |
|---|---|
record | Omit<ModelFallbackRecord, "kind"> |
Returns
Promise<void>
recordProgressArtifactRef()
recordProgressArtifactRef(record): Promise<void>;Defined in: packages/sessions/src/cassette/recorder.ts:64
Record a progress-artifact-ref spilled-artifact event.
Parameters
| Parameter | Type |
|---|---|
record | Omit<ProgressArtifactRefRecord, "kind"> |
Returns
Promise<void>
recordToolCall()
recordToolCall(record): Promise<void>;Defined in: packages/sessions/src/cassette/recorder.ts:54
Record a tool-call event. Computes hashes lazily.
Parameters
| Parameter | Type |
|---|---|
record | Omit<ToolCallRecord, "kind" | "sha256OfArgs" | "sha256OfOutput"> |
Returns
Promise<void>
recordToolSearchResolved()
recordToolSearchResolved(record): Promise<void>;Defined in: packages/sessions/src/cassette/recorder.ts:58
Record a tool-search-resolved lazy-load event.
Parameters
| Parameter | Type |
|---|---|
record | Omit<ToolSearchResolvedRecord, "kind"> |
Returns
Promise<void>
toString()
toString(): string;Defined in: packages/sessions/src/cassette/recorder.ts:79
Snapshot the buffered cassette body as a single string.
Returns
string