@workerdeck/server 2.15.0 → 3.1.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, LocalShellSource, McpConnection, ParkedExecution, Runner, RunnerSnapshot, SHELL_REFUSAL, 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, ShellDirectory, 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, ShellEndReason, ShellInfo, ShellOwner } from "@workerdeck/protocol";
+import { ByModel, CreateSessionRequest, JobEvent, MessageAttachment, ModelRate, PricingTable, 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;
@@ -24,6 +24,11 @@ type SessionNotificationOptions = {
   attempts?: number;
   retryDelayMs?: number;
   decorateInfo?: (info: SessionInfo) => SessionInfo;
+  onError?: (error: unknown, context: NotificationErrorContext) => void;
+};
+type NotificationErrorContext = {
+  op: 'hook' | 'webhook';
+  sessionId: string;
 };
 declare class SessionNotifier {
   #private;
@@ -102,7 +107,7 @@ declare function createFileSessionStore(options?: FileSessionStoreOptions): Sess
 //#region src/services/parking.d.ts
 type ParkErrorContext = {
   sessionId: string;
-  phase: 'park' | 'remember' | 'resume';
+  phase: 'park' | 'remember' | 'resume' | 'discard';
 };
 type SessionParkOptions = {
   registry: SessionRegistry;
@@ -113,6 +118,7 @@ type SessionParkOptions = {
   persistLive?: boolean;
   expiredGraceMs?: number;
   onParking?: (sessionId: string, executionId: string) => boolean;
+  onParked?: (sessionId: string, executionId: string) => void;
   onResumed?: (sessionId: string, runner: Runner) => void;
   onError?: (error: unknown, context: ParkErrorContext) => void;
 };
@@ -129,6 +135,7 @@ declare class SessionParkManager {
   onDetach(sessionId: string): void;
   sessionFor(executionId: string): string | undefined;
   get(id: string): Promise<StoredSessionRecord | null>;
+  retitle(id: string, title: string | undefined): Promise<SessionInfo | undefined>;
   listInfo(): Promise<SessionInfo[]>;
   ensureLive(id: string): Promise<Runner | undefined>;
   submitResult(executionId: string, result: ToolExecutionResult): Promise<{
@@ -164,7 +171,17 @@ type ProcessRow = {
 };
 type ProcessTable = () => ProcessRow[] | null;
 //#endregion
-//#region src/services/shells.d.ts
+//#region src/lib/atomic-file.d.ts
+type JsonWriteOptions = {
+  indent?: number;
+  trailingNewline?: boolean;
+};
+declare function isMissing(error: unknown): boolean;
+declare function writeFileAtomic(path: string, data: string | Uint8Array): Promise<void>;
+declare function writeJsonAtomic(path: string, value: unknown, options?: JsonWriteOptions): Promise<void>;
+declare function readJsonOr(path: string, fallback: unknown): Promise<unknown>;
+//#endregion
+//#region src/services/shell-types.d.ts
 type ShellSize = {
   cols: number;
   rows: number;
@@ -188,7 +205,7 @@ type ShellAttachment = {
   detach: () => void;
 };
 type ShellOutputQuery = {
-  view: 'text' | 'raw';
+  view: 'text' | 'raw' | 'screen';
   tail?: number;
 };
 type ShellErrorContext = {
@@ -196,6 +213,7 @@ type ShellErrorContext = {
   sessionId?: string;
   shellId?: string;
 };
+type ShellErrorReporter = (error: unknown, context: ShellErrorContext) => void;
 type ShellRegistryOptions = {
   generation: string;
   artifactDir: string | null;
@@ -209,7 +227,7 @@ type ShellRegistryOptions = {
   tailFlushMs?: number;
   sweepIntervalMs?: number;
   processTable?: ProcessTable;
-  onError?: (error: unknown, context: ShellErrorContext) => void;
+  onError?: ShellErrorReporter;
 };
 type StoredShellRecord = ShellInfo & {
   generation: string;
@@ -228,18 +246,29 @@ type ShellRegistry = {
   list: (sessionId: string) => ShellInfo[];
   running: () => ShellInfo[];
   kill: (sessionId: string, shellId: string, reason?: ShellEndReason) => ShellInfo | undefined;
+  setAgentWrite: (sessionId: string, shellId: string, enabled: boolean) => 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>;
+  applicationCursorKeys: (sessionId: string, shellId: string) => Promise<boolean>;
+  changed: (sessionId: string, shellId: string, timeoutMs: number) => Promise<void>;
   hydrate: () => Promise<void>;
   sweep: () => Promise<void>;
   flush: () => Promise<void>;
   decorate: (info: SessionInfo) => SessionInfo;
   watch: (runner: Runner) => () => void;
 };
+//#endregion
+//#region src/services/shell-directory.d.ts
+type ShellDirectoryDeps = {
+  runnerFor?: (sessionId: string) => Runner | undefined;
+};
+declare function createShellDirectory(registry: ShellRegistry, deps?: ShellDirectoryDeps): ShellDirectory;
+//#endregion
+//#region src/services/shells.d.ts
 declare function shellPermitted(shells: ShellRegistry | null, runner: Runner, operator: boolean): boolean;
 declare function createShellRegistry(options: ShellRegistryOptions): ShellRegistry;
 //#endregion
@@ -252,6 +281,7 @@ type SpendStore = {
   save(record: SpendRecord): Promise<void>;
 };
 type SpendLedgerOptions = {
+  pricing?: PricingTable;
   store?: SpendStore;
   monthlySubscriptionUsd?: (profile: string) => number | undefined;
   retentionDays?: number;
@@ -271,6 +301,7 @@ declare class SpendLedger {
 declare function createFileSpendStore(path: string, onError?: (error: unknown) => void): SpendStore;
 //#endregion
 //#region src/options.d.ts
+type ShellAgentWriteOption = 'read-only' | 'gated' | 'allow';
 type SdkSessionLister = (options: {
   dir?: string;
   limit?: number;
@@ -296,6 +327,7 @@ type WorkerServerOptions = {
     artifactMaxBytes?: number;
     artifactTtlMs?: number;
     maxRunningPerSession?: number;
+    agentWrite?: ShellAgentWriteOption;
   };
   attachments?: {
     maxFileBytes?: number;
@@ -341,7 +373,9 @@ type WorkerServerOptions = {
   };
   createEngineRunner?: (context: EngineRunnerContext) => Runner | Promise<Runner>;
   engines?: Partial<Record<ProfileEngine, EngineAdapter>>;
+  onDiagnostic?: DiagnosticSink;
 };
+type DiagnosticSink = (error: unknown, where: string) => void;
 type EngineRunnerContext = {
   config: SessionRunnerConfig;
   profile: ProfileInfo;
@@ -502,5 +536,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 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 };
+export { AttachmentStore, type AttachmentStoreOptions, type Authenticator, BridgeHub, type BridgeHubOptions, type CarriedSession, type DiagnosticSink, type EngineRunnerContext, type FileSessionStoreOptions, type JsonWriteOptions, MemorySessionStore, type NotificationErrorContext, 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 ShellAgentWriteOption, type ShellDirectoryDeps, 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, createShellDirectory, createShellRegistry, createWorkerServer, dayKey, isDormant, isMissing, readJsonOr, reloadPlan, sandboxedProviderProfile, shellPermitted, toDurableRecord, writeFileAtomic, writeJsonAtomic };
 //# sourceMappingURL=index.d.mts.map