@workerdeck/core 2.12.0 → 2.14.0

package/build/index.d.mts

@@ -1,5 +1,5 @@
 import { McpServerStatus, Options, Query, SDKMessage, SDKSessionInfo, SDKUserMessage, SessionMessage } from "@anthropic-ai/claude-agent-sdk";
-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 { ApiMessage, ByModel, CostBreakdown, CreateSessionRequest, EngineCapabilities, McpServerConfigWire, McpServerStatusInfo, MessageAttachment, MessageOrigin, ModelOption, PermissionMode, PermissionRequest, ProfileEngine, ProfileInfo, SdkSessionSummary, SessionEvent, SessionEventBody, SessionInfo, SessionStatus, ShellEndReason, ShellInfo, ShellOwner, ShellStatus, 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";
@@ -22,9 +22,37 @@ type LocalCommandResult = {
   stderr: string;
   exitCode: number;
 };
+type LocalShellSource = {
+  info(): ShellInfo;
+  text(): string;
+  subscribe(listener: () => void): () => void;
+};
+type ShellContextOptions = {
+  previous?: {
+    lines: number;
+  };
+  collapsed?: boolean;
+};
+type LocalCommandEvent = Extract<SessionEventBody, {
+  type: 'user_message';
+}>;
+type LocalCommandEmit = (text: string, uuid: string, shell: ShellInfo | undefined) => void;
 declare function localCommandTranscript(result: LocalCommandResult): string;
 declare function localCommandContext(pending: readonly string[]): string | undefined;
 declare function isSlashCommand(text: string): boolean;
+declare function isLocalShellSource(input: LocalCommandResult | LocalShellSource): input is LocalShellSource;
+declare function localCommandEvent(text: string, uuid: string, shell: ShellInfo | undefined): LocalCommandEvent;
+declare function shellInlineText(shell: ShellInfo, text: string): string;
+declare function shellContextText(shell: ShellInfo, text: string, options?: ShellContextOptions): string;
+declare class LocalCommandQueue {
+  #private;
+  constructor(emit: LocalCommandEmit);
+  push(input: LocalCommandResult | LocalShellSource): void;
+  take(): string | undefined;
+  materialize(): string[];
+  restore(texts: readonly string[]): void;
+  clear(): void;
+}
 //#endregion
 //#region src/lib/cost-ledger.d.ts
 type CostFigures = {
@@ -226,7 +254,7 @@ interface Runner {
   }): () => void;
   eventAt?(seq: number): SessionEvent | undefined;
   sendMessage(text: string, attachments?: readonly AttachmentInput[], options?: SendMessageOptions): void;
-  queueLocalCommand?(result: LocalCommandResult): void;
+  queueLocalCommand?(input: LocalCommandResult | LocalShellSource): void;
   refreshUsage?(): Promise<void>;
   mcpServers?(): Promise<McpServerStatusInfo[] | undefined>;
   reconnectMcpServer?(name: string): Promise<void>;
@@ -253,6 +281,87 @@ type SubscribeOptions = {
   imageRefs?: boolean;
 };
 //#endregion
+//#region src/lib/instructions.d.ts
+type InstructionsContext = {
+  sessionId: string;
+  cwd?: string;
+  profile?: string;
+};
+type SessionInstructions = string | ((context: InstructionsContext) => string);
+declare function resolveInstructions(instructions: SessionInstructions | undefined, context: InstructionsContext): string | undefined;
+declare function composeInstructions(...parts: Array<SessionInstructions | undefined>): SessionInstructions | undefined;
+//#endregion
+//#region src/lib/shells.d.ts
+type ShellSummary = {
+  id: string;
+  ordinal: number;
+  command: string;
+  label: string;
+  cwd: string;
+  owner: ShellOwner;
+  status: ShellStatus;
+  startedAt: number;
+  endedAt?: number;
+  exitCode?: number;
+  endReason?: ShellEndReason;
+  bytes: number;
+  capped?: boolean;
+};
+type ShellReadResult = {
+  shell: ShellSummary;
+  text: string;
+  lines: number;
+  totalLines: number;
+  truncated: boolean;
+};
+type ShellReadOptions = {
+  tail?: number;
+};
+interface ShellDirectory {
+  list(from: string): Promise<ShellSummary[]>;
+  read(from: string, shellId: string, options?: ShellReadOptions): Promise<ShellReadResult | undefined>;
+}
+declare const SHELL_REFUSAL = "shell commands are not available on this session";
+declare const SHELL_TOOL_SHAPES: {
+  readonly shell_list: {
+    readonly description: string;
+    readonly shape: {};
+  };
+  readonly shell_read: {
+    readonly description: string;
+    readonly shape: {
+      readonly shellId: z.ZodString;
+      readonly tail: z.ZodOptional<z.ZodNumber>;
+    };
+  };
+};
+type ShellToolName = keyof typeof SHELL_TOOL_SHAPES;
+declare const SHELL_TOOL_NAMES: ShellToolName[];
+type ShellToolSpec = {
+  name: ShellToolName;
+  description: string;
+  inputSchema: Record<string, unknown>;
+};
+type ShellToolOutput = {
+  text: string;
+  isError: boolean;
+};
+declare function shellToolSpecs(): ShellToolSpec[];
+declare function isShellToolName(name: string): name is ShellToolName;
+declare function clampShellTail(tail: number | undefined): number;
+declare function shellSummary(info: ShellInfo): ShellSummary;
+declare function shellTail(text: string, tail: number): {
+  text: string;
+  lines: number;
+  totalLines: number;
+  truncated: boolean;
+};
+declare function runShellTool(shells: ShellDirectory, from: string, name: string, args: unknown): Promise<ShellToolOutput>;
+declare function shellReadText(result: ShellReadResult): string;
+declare function installShellDirectory(directory: ShellDirectory | undefined): void;
+declare function installedShellDirectory(): ShellDirectory | undefined;
+declare function shellDirectoryHandle(): ShellDirectory;
+//#endregion
 //#region src/engines/claude/runner.d.ts
 type QueryFn = (params: {
   prompt: AsyncIterable<SDKUserMessage>;
@@ -270,11 +379,13 @@ type SessionRunnerConfig = CreateSessionRequest & {
   env?: Record<string, string | undefined>;
   pathToClaudeCodeExecutable?: string;
   extraOptions?: Partial<Options>;
+  instructions?: SessionInstructions;
   defaultApprovalTimeoutMs?: number | null;
   backfillHistory?: boolean;
   historyFn?: HistoryFn;
   sessionInfoFn?: SessionInfoFn;
   peers?: PeerDirectory;
+  shells?: ShellDirectory;
 };
 declare class SessionRunner implements Runner {
   #private;
@@ -292,7 +403,7 @@ declare class SessionRunner implements Runner {
   costState(): CostLedgerState;
   start(): Promise<void>;
   sendMessage(text: string, attachments?: readonly AttachmentInput[], options?: SendMessageOptions): void;
-  queueLocalCommand(result: LocalCommandResult): void;
+  queueLocalCommand(input: LocalCommandResult | LocalShellSource): void;
   mcpServers(): Promise<McpServerStatusInfo[] | undefined>;
   reconnectMcpServer(name: string): Promise<void>;
   setMcpServerEnabled(name: string, enabled: boolean): Promise<void>;
@@ -324,7 +435,7 @@ type AiSdkRunnerConfig = Omit<CreateSessionRequest, 'cwd'> & {
   cwd?: string;
   languageModel: LanguageModel$1;
   tools?: ToolSet$1;
-  instructions?: string;
+  instructions?: SessionInstructions;
   maxSteps?: number;
   executor?: ToolExecutor;
   executableTools?: string[];
@@ -345,6 +456,7 @@ type AiSdkRunnerConfig = Omit<CreateSessionRequest, 'cwd'> & {
   onClose?: () => void | Promise<void>;
   restore?: RunnerSnapshot;
   peers?: PeerDirectory;
+  shells?: ShellDirectory;
 };
 type PendingToolCall = {
   toolCallId: string;
@@ -396,7 +508,7 @@ declare class AiSdkRunner implements Runner {
   park(): RunnerSnapshot | undefined;
   snapshot(): RunnerSnapshot | undefined;
   sendMessage(text: string, attachments?: readonly AttachmentInput[], options?: SendMessageOptions): void;
-  queueLocalCommand(result: LocalCommandResult): void;
+  queueLocalCommand(input: LocalCommandResult | LocalShellSource): void;
   resolveToolCall(toolCallId: string, output: ToolCallOutput, options?: {
     isError?: boolean;
   }): boolean;
@@ -596,6 +708,7 @@ type ToolContextOptions = {
   onDispatch?: (executionId: string, toolName: string) => void;
   onSettle?: (executionId: string, result: ToolExecutionResult) => void;
   peers?: PeerDirectory;
+  shells?: ShellDirectory;
   selfId?: () => string;
 };
 type ToolContext = {
@@ -631,7 +744,7 @@ type EngineSessionOptions = {
   mcp?: McpConnection;
   mcpTools?: ToolSet$1;
   tools?: Record<string, HostToolDefinition>;
-  instructions?: string;
+  instructions?: SessionInstructions;
   executionLimits?: {
     timeoutMs?: number;
     memoryLimitBytes?: number;
@@ -663,6 +776,25 @@ declare class InputQueue implements AsyncIterable<SDKUserMessage> {
   [Symbol.asyncIterator](): AsyncIterator<SDKUserMessage>;
 }
 //#endregion
+//#region src/lib/tty-text.d.ts
+type HeadTailOptions = {
+  headLines: number;
+  headChars: number;
+  tailLines: number;
+  tailChars: number;
+};
+type HeadTail = {
+  head: string;
+  tail: string;
+  omittedLines: number;
+  totalLines: number;
+  totalBytes: number;
+};
+declare function ttyText(raw: string): string;
+declare function splitLines(text: string): string[];
+declare function countLines(text: string): number;
+declare function headTail(text: string, opts: HeadTailOptions): HeadTail;
+//#endregion
 //#region src/lib/normalize.d.ts
 declare function toApiMessage(message: unknown): ApiMessage;
 declare function mcpStatusInfo(status: McpServerStatus): McpServerStatusInfo;
@@ -905,9 +1037,12 @@ type CodexRunnerConfig = CreateSessionRequest & {
   connectFn: AppServerConnectFn;
   env?: Record<string, string | undefined>;
   codexHome?: string;
+  codexPathOverride?: string;
+  instructions?: SessionInstructions;
   defaultApprovalTimeoutMs?: number | null;
   backfillHistory?: boolean;
   peers?: PeerDirectory;
+  shells?: ShellDirectory;
 };
 declare class CodexRunner implements Runner {
   #private;
@@ -924,7 +1059,7 @@ declare class CodexRunner implements Runner {
   costState(): CostLedgerState;
   start(): Promise<void>;
   sendMessage(text: string, attachments?: readonly AttachmentInput[], options?: SendMessageOptions): void;
-  queueLocalCommand(result: LocalCommandResult): void;
+  queueLocalCommand(input: LocalCommandResult | LocalShellSource): void;
   resolvePermission(requestId: string, decision: PermissionDecision): boolean;
   interrupt(): Promise<void>;
   clearContext(): Promise<void>;
@@ -964,5 +1099,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 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 PeerMention, 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, isSlashCommand, listCodexSessions, localCommandContext, localCommandTranscript, mcpStatusInfo, modelOptionsFromSdk, normalizeMediaType, normalizeSdkMessage, peerDirectoryHandle, peerMentionsEnvelope, peerMessageEnvelope, peerSummary, peerToolSpecs, providerAdapter, recentLines, replaySlice, resolveBundledClaudeExecutable, resolveBundledCodexExecutable, runPeerTool, toApiMessage, toExecutionResult, truncateResultBlocks, withHostTools, withMcpTools, withPeerContext };
+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 HeadTail, type HeadTailOptions, type HistoryFn, type HostFetch, type HostToolDefinition, InputQueue, type InstructionsContext, JsonRpcError, JsonRpcStdioConnection, type LanguageModel, type LocalCommandEmit, type LocalCommandEvent, LocalCommandQueue, type LocalCommandResult, type LocalShellSource, 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 PeerMention, 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, SHELL_REFUSAL, SHELL_TOOL_NAMES, SHELL_TOOL_SHAPES, SUPPORTED_ATTACHMENT_TYPES, type SendMessageOptions, type SessionEventListener, type SessionInstructions, SessionRunner, type SessionRunnerConfig, type SettledBy, type ShellContextOptions, type ShellDirectory, type ShellReadOptions, type ShellReadResult, type ShellSummary, type ShellToolName, type ShellToolOutput, type ShellToolSpec, 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, clampShellTail, claudeAdapter, codexAdapter, composeInstructions, connectAppServer, connectMcpTools, countLines, createEngineSession, createToolContext, createWebFetch, getEngineAdapter, headTail, htmlToMarkdown, installPeerDirectory, installShellDirectory, installedPeerDirectory, installedShellDirectory, isHostAllowed, isLocalShellSource, isPrivateAddress, isShellToolName, isSlashCommand, listCodexSessions, localCommandContext, localCommandEvent, localCommandTranscript, mcpStatusInfo, modelOptionsFromSdk, normalizeMediaType, normalizeSdkMessage, peerDirectoryHandle, peerMentionsEnvelope, peerMessageEnvelope, peerSummary, peerToolSpecs, providerAdapter, recentLines, replaySlice, resolveBundledClaudeExecutable, resolveBundledCodexExecutable, resolveInstructions, runPeerTool, runShellTool, shellContextText, shellDirectoryHandle, shellInlineText, shellReadText, shellSummary, shellTail, shellToolSpecs, splitLines, toApiMessage, toExecutionResult, truncateResultBlocks, ttyText, withHostTools, withMcpTools, withPeerContext };
 //# sourceMappingURL=index.d.mts.map