@workerdeck/core 2.9.0 → 2.11.0

package/build/index.d.mts

@@ -1,5 +1,6 @@
 import { McpServerStatus, Options, Query, SDKMessage, SDKSessionInfo, SDKUserMessage, SessionMessage } from "@anthropic-ai/claude-agent-sdk";
-import { ApiMessage, CreateSessionRequest, EngineCapabilities, McpServerConfigWire, McpServerStatusInfo, MessageAttachment, ModelOption, PermissionMode, PermissionRequest, ProfileEngine, ProfileInfo, SdkSessionSummary, SessionEvent, SessionEventBody, SessionInfo, SessionStatus, ToolCallRequestFrame, ToolExecutionBackend, ToolExecutionOutput } from "@workerdeck/protocol";
+import { ApiMessage, ByModel, CostBreakdown, CreateSessionRequest, EngineCapabilities, McpServerConfigWire, McpServerStatusInfo, MessageAttachment, MessageOrigin, ModelOption, PermissionMode, PermissionRequest, ProfileEngine, ProfileInfo, SdkSessionSummary, SessionEvent, SessionEventBody, SessionInfo, SessionStatus, ToolCallRequestFrame, ToolExecutionBackend, ToolExecutionOutput } from "@workerdeck/protocol";
+import { z } from "zod";
 import { LanguageModel, LanguageModel as LanguageModel$1, ModelMessage, Tool, Tool as Tool$1, ToolSet, ToolSet as ToolSet$1 } from "ai";
 import { SandboxEngine, SandboxVfs } from "@workerdeck/sandbox";
 import { Readable, Writable } from "node:stream";
@@ -24,6 +25,28 @@ type LocalCommandResult = {
 declare function localCommandTranscript(result: LocalCommandResult): string;
 declare function localCommandContext(pending: readonly string[]): string | undefined;
 //#endregion
+//#region src/lib/cost-ledger.d.ts
+type CostFigures = {
+  byModel?: ByModel;
+  reportedCostUsd?: number;
+};
+type CostLedgerState = CostFigures & {
+  lifetime?: CostFigures;
+};
+declare class CostLedger {
+  #private;
+  carry(state: CostLedgerState | undefined): void;
+  carryUnlessRestored(state: CostLedgerState | undefined): void;
+  observeCumulative(byModel: ByModel | undefined, reportedCostUsd: number | undefined): void;
+  observeDelta(byModel: ByModel): void;
+  rollover(): void;
+  get byModel(): ByModel | undefined;
+  get breakdown(): CostBreakdown;
+  get costUsd(): number | undefined;
+  get reportedCostUsd(): number | undefined;
+  snapshot(): CostLedgerState;
+}
+//#endregion
 //#region src/executors/tool-executor.d.ts
 type ToolExecutionResult = {
   status: 'ok';
@@ -82,6 +105,9 @@ type RunnerSnapshot = {
   parked: ParkedExecution[];
   state: unknown;
 };
+type SendMessageOptions = {
+  origin?: MessageOrigin;
+};
 type PermissionDecision = {
   behavior: 'allow';
   updatedInput?: Record<string, unknown>;
@@ -102,7 +128,7 @@ interface Runner {
     imageRefs?: boolean;
   }): () => void;
   eventAt?(seq: number): SessionEvent | undefined;
-  sendMessage(text: string, attachments?: readonly AttachmentInput[]): void;
+  sendMessage(text: string, attachments?: readonly AttachmentInput[], options?: SendMessageOptions): void;
   queueLocalCommand?(result: LocalCommandResult): void;
   refreshUsage?(): Promise<void>;
   mcpServers?(): Promise<McpServerStatusInfo[] | undefined>;
@@ -117,6 +143,8 @@ interface Runner {
   settleExecution?(executionId: string, result: ToolExecutionResult): boolean;
   park?(): RunnerSnapshot | undefined;
   snapshot?(): RunnerSnapshot | undefined;
+  carryCost?(state: CostLedgerState): void;
+  costState?(): CostLedgerState;
   fail(message: string): void;
   close(reason?: 'client' | 'server' | 'error'): void;
 }
@@ -128,6 +156,87 @@ type SubscribeOptions = {
   imageRefs?: boolean;
 };
 //#endregion
+//#region src/lib/peers.d.ts
+type PeerSessionSummary = {
+  id: string;
+  engine?: ProfileEngine;
+  status: SessionStatus;
+  title?: string;
+  project?: string;
+  cwd: string;
+  profile?: string;
+  lastActivityAt?: number;
+  pendingPermissionCount: number;
+};
+type PeerPeek = PeerSessionSummary & {
+  live: boolean;
+  checklist?: SessionInfo['checklist'];
+  pendingApprovals: string[];
+  recent: string[];
+};
+type PeerSendResult = {
+  delivered: true;
+  sessionId: string;
+  name?: string;
+  queued: boolean;
+} | {
+  delivered: false;
+  reason: string;
+};
+type PeerSendOptions = {
+  hops?: string[];
+};
+interface PeerDirectory {
+  list(from: string): Promise<PeerSessionSummary[]>;
+  peek(from: string, sessionId: string, options?: {
+    recent?: number;
+  }): Promise<PeerPeek | undefined>;
+  send(from: string, sessionId: string, text: string, options?: PeerSendOptions): Promise<PeerSendResult>;
+}
+declare const PEER_MCP_SERVER = "workerdeck";
+declare const PEER_MESSAGE_MAX_CHARS = 16000;
+declare const PEER_RECENT_DEFAULT = 8;
+declare const PEER_RECENT_MAX = 40;
+declare const PEER_TOOL_SHAPES: {
+  readonly peers_list: {
+    readonly description: string;
+    readonly shape: {};
+  };
+  readonly peers_peek: {
+    readonly description: string;
+    readonly shape: {
+      readonly sessionId: z.ZodString;
+      readonly recent: z.ZodOptional<z.ZodNumber>;
+    };
+  };
+  readonly peers_send: {
+    readonly description: string;
+    readonly shape: {
+      readonly sessionId: z.ZodString;
+      readonly text: z.ZodString;
+    };
+  };
+};
+type PeerToolName = keyof typeof PEER_TOOL_SHAPES;
+declare const PEER_TOOL_NAMES: PeerToolName[];
+type PeerToolSpec = {
+  name: PeerToolName;
+  description: string;
+  inputSchema: Record<string, unknown>;
+};
+type PeerToolOutput = {
+  text: string;
+  isError: boolean;
+};
+declare function peerToolSpecs(): PeerToolSpec[];
+declare function runPeerTool(peers: PeerDirectory, from: string, name: string, args: unknown): Promise<PeerToolOutput>;
+declare function peerMessageEnvelope(text: string, origin: MessageOrigin): string;
+declare function peerSummary(info: SessionInfo): PeerSessionSummary;
+declare function recentLines(events: readonly SessionEvent[], limit: number): string[];
+declare function installPeerDirectory(directory: PeerDirectory | undefined): void;
+declare function installedPeerDirectory(): PeerDirectory | undefined;
+declare function peerDirectoryHandle(): PeerDirectory;
+//#endregion
 //#region src/engines/claude/runner.d.ts
 type QueryFn = (params: {
   prompt: AsyncIterable<SDKUserMessage>;
@@ -149,6 +258,7 @@ type SessionRunnerConfig = CreateSessionRequest & {
   backfillHistory?: boolean;
   historyFn?: HistoryFn;
   sessionInfoFn?: SessionInfoFn;
+  peers?: PeerDirectory;
 };
 declare class SessionRunner implements Runner {
   #private;
@@ -162,8 +272,10 @@ declare class SessionRunner implements Runner {
   get pendingApprovals(): PermissionRequest[];
   info(): SessionInfo;
   setTitle(title: string | undefined): void;
+  carryCost(state: CostLedgerState): void;
+  costState(): CostLedgerState;
   start(): Promise<void>;
-  sendMessage(text: string, attachments?: readonly AttachmentInput[]): void;
+  sendMessage(text: string, attachments?: readonly AttachmentInput[], options?: SendMessageOptions): void;
   queueLocalCommand(result: LocalCommandResult): void;
   mcpServers(): Promise<McpServerStatusInfo[] | undefined>;
   reconnectMcpServer(name: string): Promise<void>;
@@ -216,12 +328,13 @@ type AiSdkRunnerConfig = Omit<CreateSessionRequest, 'cwd'> & {
   reportMcpServers?: () => Promise<McpServerStatusInfo[] | undefined>;
   onClose?: () => void | Promise<void>;
   restore?: RunnerSnapshot;
+  peers?: PeerDirectory;
 };
 type PendingToolCall = {
   toolCallId: string;
   toolName: string;
   input: unknown;
-  deferred?: boolean;
+  parkable?: boolean;
   expiresAt?: number;
 };
 type AiSdkSessionState = {
@@ -229,12 +342,6 @@ type AiSdkSessionState = {
   pendingToolCalls: PendingToolCall[];
   dispatched: string[];
   numTurns: number;
-  totalUsage: {
-    input: number;
-    output: number;
-    cacheWrite: number;
-    cacheRead: number;
-  };
   turnAccum?: {
     startedAt: number;
     input: number;
@@ -267,10 +374,12 @@ declare class AiSdkRunner implements Runner {
   get pendingApprovals(): PermissionRequest[];
   get vfs(): SandboxVfs | undefined;
   info(): SessionInfo;
+  carryCost(state: CostLedgerState): void;
+  costState(): CostLedgerState;
   start(): Promise<void>;
   park(): RunnerSnapshot | undefined;
   snapshot(): RunnerSnapshot | undefined;
-  sendMessage(text: string, attachments?: readonly AttachmentInput[]): void;
+  sendMessage(text: string, attachments?: readonly AttachmentInput[], options?: SendMessageOptions): void;
   queueLocalCommand(result: LocalCommandResult): void;
   resolveToolCall(toolCallId: string, output: ToolCallOutput, options?: {
     isError?: boolean;
@@ -470,6 +579,8 @@ type ToolContextOptions = {
   };
   onDispatch?: (executionId: string, toolName: string) => void;
   onSettle?: (executionId: string, result: ToolExecutionResult) => void;
+  peers?: PeerDirectory;
+  selfId?: () => string;
 };
 type ToolContext = {
   vfs: SandboxVfs;
@@ -680,6 +791,19 @@ type AppServerCollabAgentToolCallItem = {
   reasoningEffort?: string | null;
   agentsStates?: Record<string, unknown> | null;
 };
+type AppServerDynamicToolCallItem = {
+  id: string;
+  type: 'dynamicToolCall';
+  tool: string;
+  namespace?: string | null;
+  arguments: unknown;
+  status: string;
+  success?: boolean | null;
+  contentItems?: Array<{
+    type: string;
+    text?: string;
+  }> | null;
+};
 type AppServerUserMessageItem = {
   id: string;
   type: 'userMessage';
@@ -689,7 +813,7 @@ type AppServerContextCompactionItem = {
   id: string;
   type: 'contextCompaction';
 };
-type AppServerItem = AppServerAgentMessageItem | AppServerReasoningItem | AppServerCommandExecutionItem | AppServerFileChangeItem | AppServerMcpToolCallItem | AppServerWebSearchItem | AppServerImageGenerationItem | AppServerImageViewItem | AppServerUserMessageItem | AppServerSubAgentActivityItem | AppServerCollabAgentToolCallItem | AppServerContextCompactionItem;
+type AppServerItem = AppServerAgentMessageItem | AppServerReasoningItem | AppServerCommandExecutionItem | AppServerFileChangeItem | AppServerMcpToolCallItem | AppServerDynamicToolCallItem | AppServerWebSearchItem | AppServerImageGenerationItem | AppServerImageViewItem | AppServerUserMessageItem | AppServerSubAgentActivityItem | AppServerCollabAgentToolCallItem | AppServerContextCompactionItem;
 type AppServerTurn = {
   id: string;
   status: string;
@@ -726,6 +850,10 @@ type AppServerUserInput = {
 } | {
   type: 'localImage';
   path: string;
+} | {
+  type: 'skill';
+  name: string;
+  path: string;
 };
 type AppServerConnection = {
   request(method: string, params?: unknown): Promise<unknown>;
@@ -763,6 +891,7 @@ type CodexRunnerConfig = CreateSessionRequest & {
   codexHome?: string;
   defaultApprovalTimeoutMs?: number | null;
   backfillHistory?: boolean;
+  peers?: PeerDirectory;
 };
 declare class CodexRunner implements Runner {
   #private;
@@ -775,8 +904,10 @@ declare class CodexRunner implements Runner {
   get pendingApprovals(): PermissionRequest[];
   info(): SessionInfo;
   setTitle(title: string | undefined): void;
+  carryCost(state: CostLedgerState): void;
+  costState(): CostLedgerState;
   start(): Promise<void>;
-  sendMessage(text: string, attachments?: readonly AttachmentInput[]): void;
+  sendMessage(text: string, attachments?: readonly AttachmentInput[], options?: SendMessageOptions): void;
   queueLocalCommand(result: LocalCommandResult): void;
   resolvePermission(requestId: string, decision: PermissionDecision): boolean;
   interrupt(): Promise<void>;
@@ -817,5 +948,5 @@ declare class JsonRpcStdioConnection {
 //#region src/engines/provider/adapter.d.ts
 declare const providerAdapter: EngineAdapter;
 //#endregion
-export { AiSdkRunner, type AiSdkRunnerConfig, type AiSdkSessionState, type AppServerConnectFn, type AppServerConnectOptions, type AppServerConnection, type AppServerHistoryTurn, type AppServerItem, type AppServerThreadListResponse, type AppServerThreadSummary, type AppServerTokenUsage, type AppServerTurn, type AppServerUserInput, type AttachmentInput, type AttachmentKind, type BridgeAnswer, BrowserBridgeExecutor, type BrowserBridgeExecutorOptions, CLAUDE_CATALOG, CODEX_CATALOG, type ClaudeAuthProbe, type ClaudeAuthStatus, CodexRunner, type CodexRunnerConfig, type DeferredDispatch, DeferredExecutor, type DeferredExecutorOptions, type EngineAdapter, type EngineAvailability, type EngineRunnerRequest, type EngineSessionOptions, type HistoryFn, type HostFetch, type HostToolDefinition, InputQueue, JsonRpcError, JsonRpcStdioConnection, type LanguageModel, type LocalCommandResult, type McpConnection, type ModelCatalog, type ParkedExecution, type PendingEntry, type PendingKind, type PendingOutcome, PendingRequestRegistry, type PendingToolCall, type PermissionDecision, type QueryFn, QuickJsExecutor, type QuickJsExecutorOptions, type RegisterOptions, type Runner, type RunnerSnapshot, SUPPORTED_ATTACHMENT_TYPES, type SessionEventListener, SessionRunner, type SessionRunnerConfig, type SettledBy, type Tool, type ToolCallOutput, type ToolContext, type ToolContextOptions, type ToolDefinition, type ToolExecutionCall, type ToolExecutionDispatch, type ToolExecutionResult, type ToolExecutor, type ToolSet, type ToolTrust, type WebFetchDigest, type WebFetchFn, type WebFetchOptions, type WebFetchResult, attachmentContentBlocks, attachmentKind, attachmentRef, checkClaudeAuth, claudeAdapter, codexAdapter, connectAppServer, connectMcpTools, createEngineSession, createToolContext, createWebFetch, getEngineAdapter, htmlToMarkdown, isHostAllowed, isPrivateAddress, listCodexSessions, localCommandContext, localCommandTranscript, mcpStatusInfo, modelOptionsFromSdk, normalizeMediaType, normalizeSdkMessage, providerAdapter, replaySlice, resolveBundledClaudeExecutable, resolveBundledCodexExecutable, toApiMessage, toExecutionResult, truncateResultBlocks, withHostTools, withMcpTools };
+export { AiSdkRunner, type AiSdkRunnerConfig, type AiSdkSessionState, type AppServerConnectFn, type AppServerConnectOptions, type AppServerConnection, type AppServerHistoryTurn, type AppServerItem, type AppServerThreadListResponse, type AppServerThreadSummary, type AppServerTokenUsage, type AppServerTurn, type AppServerUserInput, type AttachmentInput, type AttachmentKind, type BridgeAnswer, BrowserBridgeExecutor, type BrowserBridgeExecutorOptions, CLAUDE_CATALOG, CODEX_CATALOG, type ClaudeAuthProbe, type ClaudeAuthStatus, CodexRunner, type CodexRunnerConfig, type CostFigures, CostLedger, type CostLedgerState, type DeferredDispatch, DeferredExecutor, type DeferredExecutorOptions, type EngineAdapter, type EngineAvailability, type EngineRunnerRequest, type EngineSessionOptions, type HistoryFn, type HostFetch, type HostToolDefinition, InputQueue, JsonRpcError, JsonRpcStdioConnection, type LanguageModel, type LocalCommandResult, type McpConnection, type ModelCatalog, PEER_MCP_SERVER, PEER_MESSAGE_MAX_CHARS, PEER_RECENT_DEFAULT, PEER_RECENT_MAX, PEER_TOOL_NAMES, type ParkedExecution, type PeerDirectory, type PeerPeek, type PeerSendOptions, type PeerSendResult, type PeerSessionSummary, type PeerToolName, type PeerToolSpec, type PendingEntry, type PendingKind, type PendingOutcome, PendingRequestRegistry, type PendingToolCall, type PermissionDecision, type QueryFn, QuickJsExecutor, type QuickJsExecutorOptions, type RegisterOptions, type Runner, type RunnerSnapshot, SUPPORTED_ATTACHMENT_TYPES, type SendMessageOptions, type SessionEventListener, SessionRunner, type SessionRunnerConfig, type SettledBy, type Tool, type ToolCallOutput, type ToolContext, type ToolContextOptions, type ToolDefinition, type ToolExecutionCall, type ToolExecutionDispatch, type ToolExecutionResult, type ToolExecutor, type ToolSet, type ToolTrust, type WebFetchDigest, type WebFetchFn, type WebFetchOptions, type WebFetchResult, attachmentContentBlocks, attachmentKind, attachmentRef, checkClaudeAuth, claudeAdapter, codexAdapter, connectAppServer, connectMcpTools, createEngineSession, createToolContext, createWebFetch, getEngineAdapter, htmlToMarkdown, installPeerDirectory, installedPeerDirectory, isHostAllowed, isPrivateAddress, listCodexSessions, localCommandContext, localCommandTranscript, mcpStatusInfo, modelOptionsFromSdk, normalizeMediaType, normalizeSdkMessage, peerDirectoryHandle, peerMessageEnvelope, peerSummary, peerToolSpecs, providerAdapter, recentLines, replaySlice, resolveBundledClaudeExecutable, resolveBundledCodexExecutable, runPeerTool, toApiMessage, toExecutionResult, truncateResultBlocks, withHostTools, withMcpTools };
 //# sourceMappingURL=index.d.mts.map