@workerdeck/core 2.15.0 → 3.0.1

package/build/index.d.mts

@@ -306,22 +306,61 @@ type ShellSummary = {
   endReason?: ShellEndReason;
   bytes: number;
   capped?: boolean;
+  interactive?: boolean;
+  agentWrite?: boolean;
+};
+type ShellView = 'lines' | 'screen';
+type ShellWait = {
+  outcome: 'matched' | 'timeout' | 'exited';
+  match?: string;
+  ms: number;
 };
 type ShellReadResult = {
   shell: ShellSummary;
+  view: ShellView;
   text: string;
   lines: number;
   totalLines: number;
   truncated: boolean;
+  wait?: ShellWait;
 };
 type ShellReadOptions = {
   tail?: number;
+  view?: ShellView;
+  waitFor?: string[];
+  timeoutMs?: number;
+};
+type ShellRunOptions = {
+  command: string;
+  waitFor?: string[];
+  timeoutMs?: number;
+};
+type ShellWriteOptions = {
+  data?: string;
+  keys?: string[];
+  waitFor?: string[];
+  timeoutMs?: number;
+};
+type ShellKillResult = {
+  shell: ShellSummary;
+  killed: boolean;
+};
+type ShellAgentWrite = 'gated' | 'allow';
+type ShellKeyOptions = {
+  applicationCursorKeys?: boolean;
 };
 interface ShellDirectory {
   list(from: string): Promise<ShellSummary[]>;
   read(from: string, shellId: string, options?: ShellReadOptions): Promise<ShellReadResult | undefined>;
+  run(from: string, options: ShellRunOptions): Promise<ShellReadResult>;
+  write(from: string, shellId: string, options: ShellWriteOptions): Promise<ShellReadResult | undefined>;
+  kill(from: string, shellId: string): Promise<ShellKillResult | undefined>;
+  grant(from: string, shellId: string): Promise<ShellSummary | undefined>;
 }
 declare const SHELL_REFUSAL = "shell commands are not available on this session";
+declare const SHELL_WRITE_REFUSAL = "the agent may not start, type into or kill shells on this session (shell.agentWrite is read-only)";
+declare const SHELL_KEYS_MAX = 64;
+declare const SHELL_KEY_NAMES: readonly string[];
 declare const SHELL_TOOL_SHAPES: {
   readonly shell_list: {
     readonly description: string;
@@ -331,12 +370,51 @@ declare const SHELL_TOOL_SHAPES: {
     readonly description: string;
     readonly shape: {
       readonly shellId: z.ZodString;
+      readonly view: z.ZodOptional<z.ZodEnum<{
+        lines: "lines";
+        screen: "screen";
+      }>>;
       readonly tail: z.ZodOptional<z.ZodNumber>;
+      readonly waitFor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+      readonly timeoutMs: z.ZodOptional<z.ZodNumber>;
+    };
+  };
+  readonly shell_run: {
+    readonly description: string;
+    readonly shape: {
+      readonly command: z.ZodString;
+      readonly waitFor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+      readonly timeoutMs: z.ZodOptional<z.ZodNumber>;
+    };
+  };
+  readonly shell_write: {
+    readonly description: string;
+    readonly shape: {
+      readonly shellId: z.ZodString;
+      readonly data: z.ZodOptional<z.ZodString>;
+      readonly keys: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      readonly waitFor: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+      readonly timeoutMs: z.ZodOptional<z.ZodNumber>;
+    };
+  };
+  readonly shell_kill: {
+    readonly description: string;
+    readonly shape: {
+      readonly shellId: z.ZodString;
+    };
+  };
+  readonly shell_request_write: {
+    readonly description: string;
+    readonly shape: {
+      readonly shellId: z.ZodString;
+      readonly reason: z.ZodString;
     };
   };
 };
 type ShellToolName = keyof typeof SHELL_TOOL_SHAPES;
 declare const SHELL_TOOL_NAMES: ShellToolName[];
+declare const SHELL_READ_TOOL_NAMES: readonly ShellToolName[];
+declare const SHELL_WRITE_TOOL_NAMES: readonly ShellToolName[];
 type ShellToolSpec = {
   name: ShellToolName;
   description: string;
@@ -346,18 +424,33 @@ type ShellToolOutput = {
   text: string;
   isError: boolean;
 };
-declare function shellToolSpecs(): ShellToolSpec[];
+type ShellToolOptions = {
+  write?: boolean;
+};
+declare function shellToolNames(write: boolean): ShellToolName[];
+declare function shellToolSpecs(write?: boolean): ShellToolSpec[];
 declare function isShellToolName(name: string): name is ShellToolName;
+declare function isShellWriteToolName(name: string): boolean;
+declare function shellWriteToolOf(toolName: string): ShellToolName | undefined;
+declare function shellToolOf(toolName: string): ShellToolName | undefined;
+declare function shellToolNeedsCard(toolName: string, agentWrite: ShellAgentWrite | undefined): boolean;
 declare function clampShellTail(tail: number | undefined): number;
+declare function agentMayWrite(shell: Pick<ShellInfo, 'sessionId' | 'owner' | 'agentWrite'>, from: string): boolean;
+declare function shellOwnershipRefusal(shellId: string): string;
+declare function shellWriteDeniedText(name: string, message: string | undefined): string;
+declare function encodeShellKey(key: string, options?: ShellKeyOptions): string | undefined;
+declare function encodeShellKeys(keys: readonly string[], options?: ShellKeyOptions): string;
 declare function shellSummary(info: ShellInfo): ShellSummary;
 declare function shellTail(text: string, tail: number): {
+  view: 'lines';
   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 runShellTool(shells: ShellDirectory, from: string, name: string, args: unknown, options?: ShellToolOptions): Promise<ShellToolOutput>;
+declare function shellReadText(result: ShellReadResult, verb?: 'started' | 'typed'): string;
+declare function shellKillText(result: ShellKillResult): string;
 declare function installShellDirectory(directory: ShellDirectory | undefined): void;
 declare function installedShellDirectory(): ShellDirectory | undefined;
 declare function shellDirectoryHandle(): ShellDirectory;
@@ -386,6 +479,8 @@ type SessionRunnerConfig = CreateSessionRequest & {
   sessionInfoFn?: SessionInfoFn;
   peers?: PeerDirectory;
   shells?: ShellDirectory;
+  shellAgentWrite?: ShellAgentWrite;
+  createdByOperator?: boolean;
 };
 declare class SessionRunner implements Runner {
   #private;
@@ -457,6 +552,7 @@ type AiSdkRunnerConfig = Omit<CreateSessionRequest, 'cwd'> & {
   restore?: RunnerSnapshot;
   peers?: PeerDirectory;
   shells?: ShellDirectory;
+  shellAgentWrite?: ShellAgentWrite;
 };
 type PendingToolCall = {
   toolCallId: string;
@@ -709,6 +805,7 @@ type ToolContextOptions = {
   onSettle?: (executionId: string, result: ToolExecutionResult) => void;
   peers?: PeerDirectory;
   shells?: ShellDirectory;
+  shellWrite?: boolean;
   selfId?: () => string;
 };
 type ToolContext = {
@@ -790,7 +887,9 @@ type HeadTail = {
   totalLines: number;
   totalBytes: number;
 };
+declare const TTY_REDRAW_CARRY = 16;
 declare function ttyText(raw: string): string;
+declare function ttyRedraws(raw: string): boolean;
 declare function splitLines(text: string): string[];
 declare function countLines(text: string): number;
 declare function headTail(text: string, opts: HeadTailOptions): HeadTail;
@@ -1043,6 +1142,7 @@ type CodexRunnerConfig = CreateSessionRequest & {
   backfillHistory?: boolean;
   peers?: PeerDirectory;
   shells?: ShellDirectory;
+  shellAgentWrite?: ShellAgentWrite;
 };
 declare class CodexRunner implements Runner {
   #private;
@@ -1099,5 +1199,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 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 };
+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_KEYS_MAX, SHELL_KEY_NAMES, SHELL_READ_TOOL_NAMES, SHELL_REFUSAL, SHELL_TOOL_NAMES, SHELL_TOOL_SHAPES, SHELL_WRITE_REFUSAL, SHELL_WRITE_TOOL_NAMES, SUPPORTED_ATTACHMENT_TYPES, type SendMessageOptions, type SessionEventListener, type SessionInstructions, SessionRunner, type SessionRunnerConfig, type SettledBy, type ShellAgentWrite, type ShellContextOptions, type ShellDirectory, type ShellKeyOptions, type ShellKillResult, type ShellReadOptions, type ShellReadResult, type ShellRunOptions, type ShellSummary, type ShellToolName, type ShellToolOptions, type ShellToolOutput, type ShellToolSpec, type ShellView, type ShellWait, type ShellWriteOptions, TTY_REDRAW_CARRY, 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, agentMayWrite, attachmentContentBlocks, attachmentKind, attachmentRef, checkClaudeAuth, clampShellTail, claudeAdapter, codexAdapter, composeInstructions, connectAppServer, connectMcpTools, countLines, createEngineSession, createToolContext, createWebFetch, encodeShellKey, encodeShellKeys, getEngineAdapter, headTail, htmlToMarkdown, installPeerDirectory, installShellDirectory, installedPeerDirectory, installedShellDirectory, isHostAllowed, isLocalShellSource, isPrivateAddress, isShellToolName, isShellWriteToolName, 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, shellKillText, shellOwnershipRefusal, shellReadText, shellSummary, shellTail, shellToolNames, shellToolNeedsCard, shellToolOf, shellToolSpecs, shellWriteDeniedText, shellWriteToolOf, splitLines, toApiMessage, toExecutionResult, truncateResultBlocks, ttyRedraws, ttyText, withHostTools, withMcpTools, withPeerContext };
 //# sourceMappingURL=index.d.mts.map