@threadplane/chatInterfacev0.3.4

ClientToolExecutionStore

Structural store contract for guarded browser client-tool execution.

import type { ClientToolExecutionStore } from '@threadplane/chat';

Declaration

export interface ClientToolExecutionStore  {
  claim(key: ClientToolExecutionKey): Promise<'claimed' | ClientToolExecutionRecord>;
  lookup(threadId: string, toolCallIds: readonly string[]): Promise<Record<string, ClientToolExecutionRecord>>;
  record(key: ClientToolExecutionKey, result: ClientToolResult): Promise<void>;
}

Members

claim · overload 1

Atomically claim a tool-call execution. Returns prior state when present.

claim(key: ClientToolExecutionKey): Promise<'claimed' | ClientToolExecutionRecord>;

Parameters

key · required: ClientToolExecutionKey

Returns

Promise<'claimed' | ClientToolExecutionRecord>

lookup · overload 1

Lookup prior execution states for pending tool calls on a thread.

lookup(threadId: string, toolCallIds: readonly string[]): Promise<Record<string, ClientToolExecutionRecord>>;

Parameters

threadId · required: string
toolCallIds · required: readonly string[]

Returns

Promise<Record<string, ClientToolExecutionRecord>>

record · overload 1

Record the final client-tool result for a claimed execution.

record(key: ClientToolExecutionKey, result: ClientToolResult): Promise<void>;

Parameters

key · required: ClientToolExecutionKey
result · required: ClientToolResult

Returns

Promise<void>