@workerdeck/server 2.13.0 → 2.15.0

package/build/index.d.mts

@@ -1,7 +1,7 @@
 import { IncomingMessage, Server, ServerResponse } from "node:http";
-import { AttachmentInput, BridgeAnswer, BrowserBridgeExecutor, ClaudeAuthProbe, CostLedgerState, EngineAdapter, EngineSessionOptions, HostToolDefinition, LanguageModel, McpConnection, ParkedExecution, Runner, RunnerSnapshot, SessionInstructions, SessionRunnerConfig, ToolExecutionCall, ToolExecutionResult, ToolExecutor, ToolSet } from "@workerdeck/core";
+import { AttachmentInput, BridgeAnswer, BrowserBridgeExecutor, ClaudeAuthProbe, CostLedgerState, EngineAdapter, EngineSessionOptions, HostToolDefinition, LanguageModel, LocalShellSource, McpConnection, ParkedExecution, Runner, RunnerSnapshot, SHELL_REFUSAL, SessionInstructions, SessionRunnerConfig, ToolExecutionCall, ToolExecutionResult, ToolExecutor, ToolSet } from "@workerdeck/core";
 import { JobQueue, QueueAdapter } from "@workerdeck/queue";
-import { ByModel, CreateSessionRequest, JobEvent, MessageAttachment, ModelRate, ProfileEngine, ProfileInfo, ProfileSpend, ProfileUsage, ProviderConfig, SdkSessionSummary, ServerFrame, SessionCapability, SessionInfo, SessionNotification, SessionWebhookConfig } from "@workerdeck/protocol";
+import { ByModel, CreateSessionRequest, JobEvent, MessageAttachment, ModelRate, ProfileEngine, ProfileInfo, ProfileSpend, ProfileUsage, ProviderConfig, SdkSessionSummary, ServerFrame, SessionCapability, SessionInfo, SessionNotification, SessionWebhookConfig, ShellEndReason, ShellInfo, ShellOwner } from "@workerdeck/protocol";
 //#region src/services/bridge.d.ts
 type BridgeHubOptions = {
   timeoutMs?: number;
@@ -156,6 +156,93 @@ type ProfileStore = {
 declare function createMemoryProfileStore(seed?: ProfileInfo[]): ProfileStore;
 declare function createFileProfileStore(path?: string): ProfileStore;
 //#endregion
+//#region src/services/process-tree.d.ts
+type ProcessRow = {
+  pid: number;
+  ppid: number;
+  pgid: number;
+};
+type ProcessTable = () => ProcessRow[] | null;
+//#endregion
+//#region src/services/shells.d.ts
+type ShellSize = {
+  cols: number;
+  rows: number;
+};
+type ShellSink = {
+  write: (data: string) => void;
+  end: (reason: string) => void;
+};
+type ShellSpawnInput = {
+  runner: Runner;
+  command: string;
+  owner: ShellOwner;
+};
+type ShellSpawned = {
+  shell: ShellInfo;
+  source: LocalShellSource;
+};
+type ShellAttachment = {
+  shell: ShellInfo;
+  scrollback: string;
+  detach: () => void;
+};
+type ShellOutputQuery = {
+  view: 'text' | 'raw';
+  tail?: number;
+};
+type ShellErrorContext = {
+  op: 'index' | 'artifact' | 'sweep' | 'listener' | 'kill';
+  sessionId?: string;
+  shellId?: string;
+};
+type ShellRegistryOptions = {
+  generation: string;
+  artifactDir: string | null;
+  timeoutMs?: number;
+  artifactMaxBytes?: number;
+  artifactTtlMs?: number;
+  maxRunningPerSession?: number;
+  maxRunningTotal?: number;
+  spillBytes?: number;
+  tailRingBytes?: number;
+  tailFlushMs?: number;
+  sweepIntervalMs?: number;
+  processTable?: ProcessTable;
+  onError?: (error: unknown, context: ShellErrorContext) => void;
+};
+type StoredShellRecord = ShellInfo & {
+  generation: string;
+  output?: string;
+  artifact?: string;
+};
+type StoredShellIndex = {
+  version: 1;
+  sessionId: string;
+  nextOrdinal: number;
+  shells: StoredShellRecord[];
+};
+type ShellRegistry = {
+  spawn: (input: ShellSpawnInput) => Promise<ShellSpawned>;
+  get: (sessionId: string, shellId: string) => ShellInfo | undefined;
+  list: (sessionId: string) => ShellInfo[];
+  running: () => ShellInfo[];
+  kill: (sessionId: string, shellId: string, reason?: ShellEndReason) => ShellInfo | undefined;
+  killAll: (reason: ShellEndReason) => number;
+  killAllSync: () => void;
+  attach: (sessionId: string, shellId: string, sink: ShellSink) => Promise<ShellAttachment>;
+  write: (sessionId: string, shellId: string, data: string) => void;
+  resize: (sessionId: string, shellId: string, size: ShellSize) => ShellSize;
+  output: (sessionId: string, shellId: string, query: ShellOutputQuery) => Promise<string | undefined>;
+  hydrate: () => Promise<void>;
+  sweep: () => Promise<void>;
+  flush: () => Promise<void>;
+  decorate: (info: SessionInfo) => SessionInfo;
+  watch: (runner: Runner) => () => void;
+};
+declare function shellPermitted(shells: ShellRegistry | null, runner: Runner, operator: boolean): boolean;
+declare function createShellRegistry(options: ShellRegistryOptions): ShellRegistry;
+//#endregion
 //#region src/services/spend-ledger.d.ts
 type SpendRecord = {
   days: Record<string, Record<string, ByModel>>;
@@ -205,7 +292,10 @@ type WorkerServerOptions = {
   shell?: {
     enabled?: boolean;
     timeoutMs?: number;
-    maxOutputBytes?: number;
+    artifactDir?: string;
+    artifactMaxBytes?: number;
+    artifactTtlMs?: number;
+    maxRunningPerSession?: number;
   };
   attachments?: {
     maxFileBytes?: number;
@@ -282,6 +372,11 @@ type DrainReport = {
   working: string[];
   awaitingHuman: string[];
   timedOut: boolean;
+  shells: {
+    sessionId: string;
+    id: string;
+    label: string;
+  }[];
 };
 type DrainOptions = {
   timeoutMs?: number;
@@ -294,6 +389,7 @@ type WorkerServer = {
   queue?: JobQueue;
   bridge: BridgeHub;
   parking: SessionParkManager;
+  shells: ShellRegistry | null;
   listen: (port: number, host?: string) => Promise<{
     port: number;
   }>;
@@ -406,5 +502,5 @@ declare class ProfileUsageTracker {
   usage(profile: string, now?: number): ProfileUsage | undefined;
 }
 //#endregion
-export { AttachmentStore, type AttachmentStoreOptions, type Authenticator, BridgeHub, type BridgeHubOptions, type CarriedSession, type EngineRunnerContext, type FileSessionStoreOptions, MemorySessionStore, type ParkedSessionRecord, type ProducedFile, ProducedFileStore, type ProfileStore, ProfileUsageTracker, type ProviderRunnerOptions, type QueueServerOptions, type ReloadPlan, type SdkSessionLister, type SessionNotificationOptions, SessionNotifier, SessionParkManager, type SessionParkOptions, SessionRegistry, type SessionRegistryOptions, type SessionStore, SpendLedger, type SpendRecord, type SpendStore, type StoredSessionRecord, type WorkerServer, type WorkerServerOptions, createFileProfileStore, createFileSessionStore, createFileSpendStore, createMemoryProfileStore, createProviderRunner, createWorkerServer, dayKey, isDormant, reloadPlan, sandboxedProviderProfile, toDurableRecord };
+export { AttachmentStore, type AttachmentStoreOptions, type Authenticator, BridgeHub, type BridgeHubOptions, type CarriedSession, type EngineRunnerContext, type FileSessionStoreOptions, MemorySessionStore, type ParkedSessionRecord, type ProcessRow, type ProcessTable, type ProducedFile, ProducedFileStore, type ProfileStore, ProfileUsageTracker, type ProviderRunnerOptions, type QueueServerOptions, type ReloadPlan, SHELL_REFUSAL, type SdkSessionLister, type SessionNotificationOptions, SessionNotifier, SessionParkManager, type SessionParkOptions, SessionRegistry, type SessionRegistryOptions, type SessionStore, type ShellRegistry, type ShellRegistryOptions, type ShellSink, SpendLedger, type SpendRecord, type SpendStore, type StoredSessionRecord, type StoredShellIndex, type StoredShellRecord, type WorkerServer, type WorkerServerOptions, createFileProfileStore, createFileSessionStore, createFileSpendStore, createMemoryProfileStore, createProviderRunner, createShellRegistry, createWorkerServer, dayKey, isDormant, reloadPlan, sandboxedProviderProfile, shellPermitted, toDurableRecord };
 //# sourceMappingURL=index.d.mts.map