@letta-ai/letta-code 0.30.1 → 0.30.3

package/dist/types/websocket/listener/outbound-wire.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Transport-level outbound wire layer for the listener.
+ *
+ * Owns everything between "a protocol message is ready to leave" and the
+ * socket: the bounded per-transport queue, backpressure policy, and wire perf
+ * telemetry. Message-level concerns (envelope shape, event_seq semantics,
+ * frame classification) stay in protocol-outbound.ts, which hands this module
+ * pre-classified frames with a deferred `build()`.
+ *
+ * Design (borrowed from codex app-server, adapted to our topology — see
+ * LET-10138): producers never interact with socket state; they enqueue into a
+ * bounded queue drained by this module against `bufferedAmount` watermarks.
+ * Snapshot ("status") frames coalesce latest-wins while queued. All other
+ * frames are retained while the connection remains viable. If the bounded
+ * queue fills or the socket stalls, the transport is terminated instead of
+ * silently dropping stream deltas that the listener cannot replay. This
+ * follows Codex's disconnect-slow-client policy.
+ *
+ * Frames are serialized (and take their event_seq) inside `build()` at drain
+ * time, so frames superseded or skipped before build do not consume sequence
+ * numbers.
+ */
+import { type ListenerTransport } from "./transport";
+/**
+ * How a frame behaves under backpressure.
+ * - "critical": never dropped. If the queue reaches capacity, the transport
+ *   is considered stalled and terminated.
+ * - "status": snapshot semantics — a newer frame with the same coalesceKey
+ *   fully supersedes a queued one (loop status, device status, queue state).
+ *   A status frame without a newer replacement is still never dropped.
+ */
+export type OutboundFrameClass = "critical" | "status";
+export interface OutboundFrame {
+    /** Message type label for logs/telemetry (not parsed). */
+    typeLabel: string;
+    frameClass: OutboundFrameClass;
+    /** Required for "status" frames: queued frame with the same key is replaced. */
+    coalesceKey?: string;
+    /**
+     * Serialize the frame. Runs at drain time, immediately before the socket
+     * write. Return null to skip the frame (e.g. sequence numbering became
+     * unavailable). Must be side-effect free until the frame is actually sent;
+     * post-send effects belong in `onSent`.
+     */
+    build(): {
+        payload: string;
+        perfKey: string;
+        onSent?: () => void;
+    } | null;
+    /** Called if the socket write throws. */
+    onSendError?(error: unknown): void;
+}
+/**
+ * Queue and watermark limits.
+ *
+ * MAX_QUEUED_FRAMES follows Codex's bounded-channel approach (they use 128
+ * per connection); we allow more headroom because one relay socket carries
+ * every conversation and status frames coalesce away. HIGH_WATERMARK pauses
+ * draining while the socket's own buffer is congested; KILL_THRESHOLD treats
+ * the socket as stalled and terminates the paired connection.
+ */
+export declare const OUTBOUND_QUEUE_LIMITS: {
+    readonly MAX_QUEUED_FRAMES: 512;
+    readonly HIGH_WATERMARK_BUFFERED_BYTES: number;
+    readonly KILL_THRESHOLD_BUFFERED_BYTES: number;
+    readonly DRAIN_POLL_MS: 50;
+};
+/**
+ * Enqueue a frame and drain as far as the socket allows. When the socket is
+ * healthy this sends synchronously in the same tick (identical behavior to
+ * the pre-queue direct send); the queue only forms under backpressure.
+ */
+export declare function enqueueOutboundFrame(transport: ListenerTransport, frame: OutboundFrame): void;
+/** Test/diagnostic visibility into a transport's queue. */
+export declare function getOutboundQueueStats(transport: ListenerTransport): {
+    queuedFrames: number;
+    killed: boolean;
+};
+export declare const __outboundWireTestUtils: {
+    clearTransportQueue(transport: ListenerTransport): void;
+};
+//# sourceMappingURL=outbound-wire.d.ts.map

package/dist/types/websocket/listener/outbound-wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-wire.d.ts","sourceRoot":"","sources":["../../../../src/websocket/listener/outbound-wire.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAErB;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,KAAK,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1E,yCAAyC;IACzC,WAAW,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB;;;;;CAKxB,CAAC;AAgDX;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,aAAa,GACnB,IAAI,CAuBN;AA4FD,2DAA2D;AAC3D,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,iBAAiB,GAAG;IACnE,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB,CAMA;AAwMD,eAAO,MAAM,uBAAuB;mCACH,iBAAiB,GAAG,IAAI;CAGxD,CAAC"}

package/dist/types/websocket/listener/permission-mode.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Per-conversation permission mode storage.
+ *
+ * Mirrors the CWD isolation pattern in cwd.ts:
+ * - State is stored in a Map on the long-lived ListenerRuntime (not on the
+ *   ephemeral ConversationRuntime, which gets evicted between turns).
+ * - A scope key derived from agentId + conversationId is used as the map key.
+ */
+import { type PermissionMode } from "../../permissions/mode";
+import type { ListenerRuntime } from "./types";
+export type ConversationPermissionModeState = {
+    mode: PermissionMode;
+};
+export declare function getPermissionModeScopeKey(agentId?: string | null, conversationId?: string | null): string;
+/**
+ * Read-only state lookup for a conversation scope.
+ *
+ * This helper is intended for read paths (status rendering, serialization).
+ * It does not materialize new map entries for missing scopes.
+ */
+export declare function getConversationPermissionModeState(runtime: ListenerRuntime, agentId?: string | null, conversationId?: string | null): Readonly<ConversationPermissionModeState>;
+/**
+ * Returns the canonical mutable state object for a conversation scope.
+ *
+ * This helper materializes missing entries and guarantees stable identity
+ * during a turn so concurrent mode updates (websocket + tool mutations)
+ * apply to the same object reference.
+ */
+export declare function getOrCreateConversationPermissionModeStateRef(runtime: ListenerRuntime, agentId?: string | null, conversationId?: string | null): ConversationPermissionModeState;
+/**
+ * Remove a canonical state entry when it is equivalent to the default state.
+ *
+ * This should be called at turn finalization boundaries, not on each mode
+ * update, to avoid breaking object identity for in-flight turns.
+ */
+export declare function pruneConversationPermissionModeStateIfDefault(runtime: ListenerRuntime, agentId?: string | null, conversationId?: string | null): boolean;
+/**
+ * Load the persisted permission mode map from remote-settings.json.
+ * Converts PersistedPermissionModeState → ConversationPermissionModeState.
+ */
+export declare function loadPersistedPermissionModeMap(): Map<string, ConversationPermissionModeState>;
+/**
+ * Persist permission mode map to remote-settings.json.
+ */
+export declare function persistPermissionModeMapForRuntime(runtime: ListenerRuntime): void;
+//# sourceMappingURL=permission-mode.d.ts.map

package/dist/types/websocket/listener/permission-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-mode.d.ts","sourceRoot":"","sources":["../../../../src/websocket/listener/permission-mode.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,cAAc,CAAC;CACtB,CAAC;AAEF,wBAAgB,yBAAyB,CACvC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,EACvB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAC7B,MAAM,CAOR;AAcD;;;;;GAKG;AACH,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,EACvB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAC7B,QAAQ,CAAC,+BAA+B,CAAC,CA2B3C;AAED;;;;;;GAMG;AACH,wBAAgB,6CAA6C,CAC3D,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,EACvB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAC7B,+BAA+B,CA0BjC;AAED;;;;;GAKG;AACH,wBAAgB,6CAA6C,CAC3D,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,EACvB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAC7B,OAAO,CAWT;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,IAAI,GAAG,CACnD,MAAM,EACN,+BAA+B,CAChC,CAmBA;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,eAAe,GACvB,IAAI,CAEN"}

package/dist/types/websocket/listener/protocol-outbound.d.ts

@@ -0,0 +1,122 @@
+import type { LettaStreamingResponse } from "@letta-ai/letta-client/resources/agents/messages";
+import type { DequeuedBatch } from "../../queue/queue-runtime";
+import type { DeviceStatus, LoopState, QueueMessage, RuntimeScope, StatusMessage, StopReasonType, StreamDelta, SubagentSnapshot, WsProtocolMessage } from "../../types/protocol_v2";
+import { type ListenerTransport } from "./transport";
+import type { ConversationRuntime, IncomingMessage, ListenerMessageRouting, ListenerRuntime } from "./types";
+type RuntimeCarrier = ListenerRuntime | ConversationRuntime | null;
+type PartialRuntimeScope = {
+    agent_id?: string | null;
+    conversation_id?: string | null;
+};
+export declare function emitRuntimeStateUpdates(runtime: RuntimeCarrier, scope: PartialRuntimeScope | undefined): void;
+export declare function buildDeviceStatus(runtime: RuntimeCarrier, params?: {
+    agent_id?: string | null;
+    conversation_id?: string | null;
+}): DeviceStatus;
+export declare function buildLoopStatus(runtime: RuntimeCarrier, params?: {
+    agent_id?: string | null;
+    conversation_id?: string | null;
+}): LoopState;
+export declare function buildQueueSnapshot(runtime: RuntimeCarrier, params?: {
+    agent_id?: string | null;
+    conversation_id?: string | null;
+}): QueueMessage[];
+type OutboundProtocolMessage = WsProtocolMessage extends infer TMessage ? TMessage extends WsProtocolMessage ? Omit<TMessage, "runtime" | "event_seq" | "emitted_at" | "idempotency_key"> : never : never;
+export declare function emitProtocolV2Message(socket: ListenerTransport, runtime: RuntimeCarrier, message: OutboundProtocolMessage, scope: {
+    agent_id?: string | null;
+    conversation_id?: string | null;
+} | undefined, routing: ListenerMessageRouting): void;
+export declare function broadcastServiceProtocolMessage(runtime: ListenerRuntime, message: WsProtocolMessage): void;
+export declare function emitDeviceStatusUpdate(socket: ListenerTransport, runtime: RuntimeCarrier, scope?: PartialRuntimeScope, routing?: ListenerMessageRouting): void;
+export declare function emitLoopStatusUpdate(socket: ListenerTransport, runtime: RuntimeCarrier, scope?: {
+    agent_id?: string | null;
+    conversation_id?: string | null;
+}, routing?: ListenerMessageRouting): void;
+export declare function emitLoopStatusIfOpen(runtime: RuntimeCarrier, scope?: {
+    agent_id?: string | null;
+    conversation_id?: string | null;
+}): void;
+export declare function emitDeviceStatusIfOpen(runtime: RuntimeCarrier, scope?: {
+    agent_id?: string | null;
+    conversation_id?: string | null;
+}): void;
+export declare function emitQueueUpdate(socket: ListenerTransport, runtime: RuntimeCarrier, scope?: {
+    agent_id?: string | null;
+    conversation_id?: string | null;
+}, routing?: ListenerMessageRouting): void;
+export declare function isSystemReminderPart(part: unknown): boolean;
+export declare function emitDequeuedUserMessage(socket: ListenerTransport, runtime: RuntimeCarrier, incoming: IncomingMessage, batch: DequeuedBatch): void;
+export declare function emitQueueUpdateIfOpen(runtime: RuntimeCarrier, scope?: {
+    agent_id?: string | null;
+    conversation_id?: string | null;
+}): void;
+export declare function emitDeviceStatusUpdateIfChanged(socket: ListenerTransport, runtime: RuntimeCarrier, scope?: PartialRuntimeScope, options?: {
+    force?: boolean;
+}, routing?: ListenerMessageRouting): boolean;
+export declare function emitStateSync(socket: ListenerTransport, runtime: RuntimeCarrier, scope: RuntimeScope, options?: {
+    forceDeviceStatus?: boolean;
+    routing?: ListenerMessageRouting;
+}): void;
+export declare function buildSubagentSnapshot(runtime: RuntimeCarrier, scope?: {
+    agent_id?: string | null;
+    conversation_id?: string | null;
+}): SubagentSnapshot[];
+export declare function emitSubagentStateUpdate(socket: ListenerTransport, runtime: RuntimeCarrier, scope?: {
+    agent_id?: string | null;
+    conversation_id?: string | null;
+}, routing?: ListenerMessageRouting): void;
+export declare function emitSubagentStateIfOpen(runtime: RuntimeCarrier, scope?: {
+    agent_id?: string | null;
+    conversation_id?: string | null;
+}): void;
+export declare function scheduleQueueEmit(runtime: ListenerRuntime, scope?: {
+    agent_id?: string | null;
+    conversation_id?: string | null;
+}): void;
+export declare function createLifecycleMessageBase<TMessageType extends string>(messageType: TMessageType, runId?: string | null): {
+    id: string;
+    date: string;
+    message_type: TMessageType;
+    run_id?: string;
+};
+export declare function emitCanonicalMessageDelta(socket: ListenerTransport, runtime: RuntimeCarrier, delta: StreamDelta, scope?: {
+    agent_id?: string | null;
+    conversation_id?: string | null;
+}): void;
+export declare function emitLoopErrorDelta(socket: ListenerTransport, runtime: RuntimeCarrier, params: {
+    message: string;
+    stopReason: StopReasonType;
+    isTerminal: boolean;
+    runId?: string | null;
+    agentId?: string | null;
+    conversationId?: string | null;
+    apiError?: LettaStreamingResponse.LettaErrorMessage;
+}): void;
+export declare function emitRetryDelta(socket: ListenerTransport, runtime: RuntimeCarrier, params: {
+    message: string;
+    reason: StopReasonType;
+    attempt: number;
+    maxAttempts: number;
+    delayMs: number;
+    runId?: string | null;
+    agentId?: string | null;
+    conversationId?: string | null;
+}): void;
+export declare function emitStatusDelta(socket: ListenerTransport, runtime: RuntimeCarrier, params: {
+    message: string;
+    level: StatusMessage["level"];
+    runId?: string | null;
+    agentId?: string | null;
+    conversationId?: string | null;
+}): void;
+export declare function emitInterruptedStatusDelta(socket: ListenerTransport, runtime: RuntimeCarrier, params: {
+    runId?: string | null;
+    agentId?: string | null;
+    conversationId?: string | null;
+}): void;
+export declare function emitStreamDelta(socket: ListenerTransport, runtime: RuntimeCarrier, delta: StreamDelta, scope?: {
+    agent_id?: string | null;
+    conversation_id?: string | null;
+}, subagentId?: string): void;
+export {};
+//# sourceMappingURL=protocol-outbound.d.ts.map

package/dist/types/websocket/listener/protocol-outbound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-outbound.d.ts","sourceRoot":"","sources":["../../../../src/websocket/listener/protocol-outbound.ts"],"names":[],"mappings":"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"}

package/dist/types/websocket/listener/remote-settings-lock.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Cross-process lock for remote-settings.json.
+ *
+ * Primary locks and recovery claims are fully initialized before hard-link
+ * publication, so another process never observes an ownerless lock. Recovery
+ * claims form an immutable chain scoped to one dead primary token: a live
+ * claim owner blocks recovery, while a crashed recovery owner is bypassed at
+ * the next depth. This prevents two recoverers from unlinking different
+ * generations of the primary lock.
+ *
+ * The protocol is for a local filesystem shared by processes on one host. A
+ * listener upgrade must stop the old listener before starting code that uses a
+ * different lock protocol.
+ */
+export interface RemoteSettingsLockHandle {
+    lockPath: string;
+    ownerToken: string;
+}
+export declare function tryAcquireRemoteSettingsLockSync(lockPath: string): RemoteSettingsLockHandle | null;
+export declare function tryAcquireRemoteSettingsLock(lockPath: string): Promise<RemoteSettingsLockHandle | null>;
+export declare function releaseRemoteSettingsLockSync(handle: RemoteSettingsLockHandle): void;
+export declare function releaseRemoteSettingsLock(handle: RemoteSettingsLockHandle): Promise<void>;
+export declare function flushAbandonedRemoteSettingsLock(deadline: number): Promise<boolean>;
+//# sourceMappingURL=remote-settings-lock.d.ts.map

package/dist/types/websocket/listener/remote-settings-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-settings-lock.d.ts","sourceRoot":"","sources":["../../../../src/websocket/listener/remote-settings-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAaH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAgZD,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,MAAM,GACf,wBAAwB,GAAG,IAAI,CAQjC;AAED,wBAAsB,4BAA4B,CAChD,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAQ1C;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,wBAAwB,GAC/B,IAAI,CAmBN;AAED,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,wBAAsB,gCAAgC,CACpD,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC,CAkBlB"}

package/dist/types/websocket/listener/remote-settings.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Persistent remote session settings stored in ~/.letta/remote-settings.json.
+ *
+ * Stores per-conversation CWD and permission mode so both survive letta server
+ * restarts. Mirrors the in-memory Map keys used by cwd.ts and permissionMode.ts.
+ */
+import type { PermissionMode } from "../../permissions/mode";
+/** Persisted permission mode state for a single conversation. */
+export interface PersistedPermissionModeState {
+    mode: PermissionMode;
+}
+export interface RemoteSettings {
+    cwdMap?: Record<string, string>;
+    cwdRepairJournalIds?: string[];
+    permissionModeMap?: Record<string, PersistedPermissionModeState>;
+}
+export declare function getRemoteSettingsPath(): string;
+/**
+ * Load remote settings synchronously from disk (called once at startup).
+ * Populates the in-memory cache. Returns {} on any read/parse error.
+ *
+ * Applies a one-time migration: if cwdMap is absent, tries to load
+ * the legacy ~/.letta/cwd-cache.json.
+ */
+export declare function loadRemoteSettings(): RemoteSettings;
+/**
+ * Merge updates and queue the newest snapshot for serialized persistence.
+ */
+export declare function saveRemoteSettings(updates: Partial<RemoteSettings>): void;
+/**
+ * Queue an explicit cwd assignment even when it matches this process's cache.
+ * Another listener may have published a conditional repair journal after our
+ * cache was loaded; the unconditional set records that this user assignment is
+ * newer than that repair when both are merged under the settings lock.
+ */
+export declare function saveRemoteSettingsCwdAssignment(scopeKey: string, workingDirectory: string): void;
+/**
+ * Attempt immediate repair persistence and fence older queued snapshots.
+ * Transient failures stay queued for the asynchronous retry loop.
+ */
+export declare function saveRemoteSettingsSync(updates: Partial<RemoteSettings>): void;
+export declare function flushRemoteSettingsWrites(): Promise<boolean>;
+/**
+ * Reset the in-memory cache (for testing).
+ */
+export declare function resetRemoteSettingsCache(): void;
+//# sourceMappingURL=remote-settings.d.ts.map

package/dist/types/websocket/listener/remote-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-settings.d.ts","sourceRoot":"","sources":["../../../../src/websocket/listener/remote-settings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AASzD,iEAAiE;AACjE,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC;CAClE;AAgDD,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,CAmEnD;AA6cD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAsBzE;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,GACvB,IAAI,CAmBN;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAc7E;AAED,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,OAAO,CAAC,CAwClE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAM/C"}

package/dist/types/websocket/listener/runtime.d.ts

@@ -0,0 +1,51 @@
+import type { PendingControlRequest } from "../../types/protocol_v2";
+import type { ConversationRuntime, ListenerRuntime, RecoveredApprovalState, StartListenerOptions } from "./types";
+export declare function getActiveRuntime(): ListenerRuntime | null;
+export declare function setActiveRuntime(runtime: ListenerRuntime | null): void;
+export declare function safeEmitWsEvent(direction: "send" | "recv", label: "client" | "protocol" | "control" | "lifecycle", event: unknown): void;
+export declare function nextEventSeq(runtime: ListenerRuntime | null): number | null;
+export declare function clearRuntimeTimers(runtime: ListenerRuntime): void;
+/**
+ * How long an evicted conversation's worktree watcher may stay alive waiting
+ * for the conversation to come back. Runtime eviction is routine (it fires
+ * after every quiescent turn), and the watcher's job is to track worktree
+ * changes for an attached client *between* turns — so it must survive
+ * eviction, but not for the life of the process. Without this, one live
+ * fs.watch loop accumulates per conversation ever touched (LET-10138).
+ */
+export declare const WORKTREE_WATCHER_IDLE_STOP_MS: number;
+export declare const __watcherIdleStopTestUtils: {
+    /** Fire every pending idle stop immediately (tests cannot wait 30 minutes). */
+    firePending(listener: ListenerRuntime): void;
+    hasPending(listener: ListenerRuntime, scopeKey: string): boolean;
+};
+export declare function evictConversationRuntimeIfIdle(runtime: ConversationRuntime): boolean;
+export declare function getListenerStatus(listener: ListenerRuntime): "idle" | "receiving" | "processing";
+export declare function emitListenerStatus(listener: ListenerRuntime, onStatusChange: StartListenerOptions["onStatusChange"] | undefined, connectionId: string | undefined): void;
+export declare function getConversationRuntimeKey(agentId?: string | null, conversationId?: string | null): string;
+export declare function createConversationRuntime(listener: ListenerRuntime, agentId?: string | null, conversationId?: string | null): ConversationRuntime;
+export declare function getConversationRuntime(listener: ListenerRuntime, agentId?: string | null, conversationId?: string | null): ConversationRuntime | null;
+export declare function getOrCreateConversationRuntime(listener: ListenerRuntime, agentId?: string | null, conversationId?: string | null): ConversationRuntime;
+export declare function clearRecoveredApprovalState(runtime: ConversationRuntime): void;
+export declare function clearConversationRuntimeState(runtime: ConversationRuntime): void;
+export declare function getRecoveredApprovalStateForScope(runtime: ListenerRuntime, params?: {
+    agent_id?: string | null;
+    conversation_id?: string | null;
+}): RecoveredApprovalState | null;
+export declare function clearRecoveredApprovalStateForScope(runtime: ListenerRuntime, params?: {
+    agent_id?: string | null;
+    conversation_id?: string | null;
+}): void;
+export declare function getPendingControlRequests(runtime: ListenerRuntime, params?: {
+    agent_id?: string | null;
+    conversation_id?: string | null;
+}): PendingControlRequest[];
+export declare function hasInterruptedCacheForScope(runtime: ListenerRuntime, params?: {
+    agent_id?: string | null;
+    conversation_id?: string | null;
+}): boolean;
+export declare function getPendingControlRequestCount(runtime: ListenerRuntime, params?: {
+    agent_id?: string | null;
+    conversation_id?: string | null;
+}): number;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/types/websocket/listener/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/websocket/listener/runtime.ts"],"names":[],"mappings":"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"}

package/dist/types/websocket/listener/scope.d.ts

@@ -0,0 +1,15 @@
+import type { RuntimeScope } from "../../types/protocol_v2";
+import type { ListenerRuntime } from "./types";
+export declare function normalizeCwdAgentId(agentId?: string | null): string | null;
+export declare function normalizeConversationId(conversationId?: string | null): string;
+export declare function resolveScopedAgentId(runtime: ListenerRuntime | null, params?: {
+    agent_id?: string | null;
+}): string | null;
+export declare function resolveScopedConversationId(runtime: ListenerRuntime | null, params?: {
+    conversation_id?: string | null;
+}): string;
+export declare function resolveRuntimeScope(runtime: ListenerRuntime | null, params?: {
+    agent_id?: string | null;
+    conversation_id?: string | null;
+}): RuntimeScope | null;
+//# sourceMappingURL=scope.d.ts.map

package/dist/types/websocket/listener/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../../src/websocket/listener/scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAuB,eAAe,EAAE,MAAM,SAAS,CAAC;AAWpE,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAE1E;AAED,wBAAgB,uBAAuB,CACrC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAC7B,MAAM,CAIR;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,eAAe,GAAG,IAAI,EAC/B,MAAM,CAAC,EAAE;IACP,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,GACA,MAAM,GAAG,IAAI,CASf;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,eAAe,GAAG,IAAI,EAC/B,MAAM,CAAC,EAAE;IACP,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,GACA,MAAM,CAWR;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,eAAe,GAAG,IAAI,EAC/B,MAAM,CAAC,EAAE;IACP,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,GACA,YAAY,GAAG,IAAI,CAUrB"}

package/dist/types/websocket/listener/stream-observers.d.ts

@@ -0,0 +1,16 @@
+import type { ListenerRuntime, ObservedProtocolV2Message } from "./types";
+/**
+ * Notify in-process observers (e.g. the OpenAI-compat HTTP bridge) of an
+ * outbound v2 protocol message. Observers consume protocol messages without
+ * owning a transport, so callers must notify before any socket-open gate: a
+ * closed or absent socket must not starve them.
+ */
+export declare function notifyStreamObservers(listener: ListenerRuntime | null, message: Record<string, unknown>, runtimeScope: ObservedProtocolV2Message["runtime"]): void;
+/**
+ * Deliver a synthetic terminal event when a runtime is stopped (e.g. a WS
+ * control client replacing a bridge-owned runtime). Without this, in-flight
+ * observers would wait on turns that will never emit again. The observer set
+ * is cleared afterwards: the runtime is dead.
+ */
+export declare function notifyStreamObserversRuntimeStopped(listener: ListenerRuntime): void;
+//# sourceMappingURL=stream-observers.d.ts.map

package/dist/types/websocket/listener/stream-observers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-observers.d.ts","sourceRoot":"","sources":["../../../../src/websocket/listener/stream-observers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAE1E;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,eAAe,GAAG,IAAI,EAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,YAAY,EAAE,yBAAyB,CAAC,SAAS,CAAC,GACjD,IAAI,CAaN;AAED;;;;;GAKG;AACH,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,eAAe,GACxB,IAAI,CAcN"}

package/dist/types/websocket/listener/transport.d.ts

@@ -0,0 +1,30 @@
+import WebSocket from "ws";
+/**
+ * Outbound side of a listener connection.
+ *
+ * Remote environment listeners write protocol frames to a real WebSocket.
+ * Local channel listeners have no remote peer, but still run the same turn
+ * processor; their outbound protocol frames are intentionally discarded.
+ */
+export interface LocalTransport {
+    readonly kind: "local";
+    readonly bufferedAmount: number;
+    isOpen(): boolean;
+    send(data: string): void;
+}
+export interface RuntimeTransport {
+    readonly kind: "runtime";
+    readonly bufferedAmount: number;
+    isOpen(): boolean;
+    send(data: string): void;
+}
+export type ListenerTransport = WebSocket | LocalTransport | RuntimeTransport;
+export declare class LocalListenerTransport implements LocalTransport {
+    readonly kind: "local";
+    readonly bufferedAmount = 0;
+    isOpen(): boolean;
+    send(_data: string): void;
+}
+export declare function isListenerTransportOpen(transport: ListenerTransport): boolean;
+export declare function getListenerTransportKind(transport: ListenerTransport): "websocket" | "local" | "runtime";
+//# sourceMappingURL=transport.d.ts.map

package/dist/types/websocket/listener/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../src/websocket/listener/transport.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,IAAI,CAAC;AAE3B;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,MAAM,IAAI,OAAO,CAAC;IAClB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,MAAM,IAAI,OAAO,CAAC;IAClB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,cAAc,GAAG,gBAAgB,CAAC;AAE9E,qBAAa,sBAAuB,YAAW,cAAc;IAC3D,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IACjC,QAAQ,CAAC,cAAc,KAAK;IAE5B,MAAM,IAAI,OAAO;IAIjB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAI1B;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAK7E;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,iBAAiB,GAC3B,WAAW,GAAG,OAAO,GAAG,SAAS,CAEnC"}

package/dist/types/websocket/listener/turn-context.d.ts

@@ -0,0 +1,7 @@
+import type { ConversationRuntime } from "./types";
+export declare function releaseListenerTurnContext(params: {
+    runtime: ConversationRuntime;
+    agentId?: string | null;
+    conversationId: string;
+}): void;
+//# sourceMappingURL=turn-context.d.ts.map

package/dist/types/websocket/listener/turn-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-context.d.ts","sourceRoot":"","sources":["../../../../src/websocket/listener/turn-context.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,OAAO,EAAE,mBAAmB,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,IAAI,CAyBP"}

package/dist/types/websocket/listener/turn-lifecycle.d.ts

@@ -0,0 +1,89 @@
+import type { LoopStatus, StopReasonType } from "../../types/protocol_v2";
+export type ActiveTurnLoopStatus = Exclude<LoopStatus, "WAITING_ON_INPUT" | "EXECUTING_COMMAND">;
+export type TurnOrigin = "message" | "approval_recovery";
+export type TurnLease = Readonly<{
+    id: string;
+    signal: AbortSignal;
+}>;
+type IdleTurnState = {
+    kind: "idle";
+    loopStatus: "WAITING_ON_INPUT";
+};
+type CommandTurnState = {
+    kind: "command";
+    loopStatus: "EXECUTING_COMMAND";
+};
+type ActiveTurnState = {
+    kind: "active";
+    origin: TurnOrigin;
+    lease: TurnLease;
+    abortController: AbortController;
+    loopStatus: ActiveTurnLoopStatus;
+    workingDirectory: string;
+    runId: string | null;
+    executingToolCallIds: readonly string[];
+};
+type CancellingTurnState = {
+    kind: "cancelling";
+    origin: TurnOrigin;
+    lease: TurnLease;
+    abortController: AbortController;
+    runId: string | null;
+    executingToolCallIds: readonly string[];
+    loopStatus: "WAITING_ON_INPUT";
+    ownerFinished: boolean;
+    externalSettlementPending: boolean;
+};
+type TurnState = IdleTurnState | CommandTurnState | ActiveTurnState | CancellingTurnState;
+export type TurnLifecycleSnapshot = IdleTurnState | CommandTurnState | Omit<ActiveTurnState, "abortController"> | Omit<CancellingTurnState, "abortController" | "ownerFinished" | "externalSettlementPending">;
+export type TurnCancellationTransition = {
+    transitioned: boolean;
+    lease: TurnLease | null;
+    runId: string | null;
+    executingToolCallIds: readonly string[];
+};
+export type TurnCancellationSettlementTransition = {
+    settled: boolean;
+    released: boolean;
+};
+export type TurnFinishTransition = {
+    finished: boolean;
+    previousKind: "active" | "cancelling" | null;
+    runId: string | null;
+};
+export declare class TurnLifecycle {
+    #private;
+    constructor(createId?: () => string);
+    get kind(): TurnState["kind"];
+    get isProcessing(): boolean;
+    get cancelRequested(): boolean;
+    get loopStatus(): LoopStatus;
+    get activeWorkingDirectory(): string | null;
+    get activeRunId(): string | null;
+    get executingToolCallIds(): readonly string[];
+    get lastStopReason(): StopReasonType | null;
+    get currentLease(): TurnLease | null;
+    snapshot(): TurnLifecycleSnapshot;
+    begin(options: {
+        origin: TurnOrigin;
+        workingDirectory: string;
+        initialStatus?: ActiveTurnLoopStatus;
+        abortController?: AbortController;
+        executingToolCallIds?: readonly string[];
+    }): TurnLease;
+    isCurrent(lease: TurnLease): boolean;
+    setStatus(lease: TurnLease, status: ActiveTurnLoopStatus): boolean;
+    setRunId(lease: TurnLease, runId: string | null): boolean;
+    setExecutingToolCallIds(lease: TurnLease, toolCallIds: readonly string[]): boolean;
+    recordStopReason(lease: TurnLease, stopReason: StopReasonType): boolean;
+    startCommand(): boolean;
+    finishCommand(): boolean;
+    requestCancellation(options?: {
+        waitForExternalSettlement?: boolean;
+    }): TurnCancellationTransition;
+    finish(lease: TurnLease, stopReason: StopReasonType): TurnFinishTransition;
+    settleCancellation(lease: TurnLease): TurnCancellationSettlementTransition;
+    reset(stopReason?: StopReasonType): TurnFinishTransition;
+}
+export {};
+//# sourceMappingURL=turn-lifecycle.d.ts.map

package/dist/types/websocket/listener/turn-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/websocket/listener/turn-lifecycle.ts"],"names":[],"mappings":"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"}