@letta-ai/letta-code 0.30.2 → 0.30.3

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

@@ -0,0 +1,322 @@
+import type { MessageCreate } from "@letta-ai/letta-client/resources/agents/agents";
+import type { ApprovalCreate } from "@letta-ai/letta-client/resources/agents/messages";
+import type WebSocket from "ws";
+import type { ApprovalDecision, ApprovalResult } from "../../agent/approval-execution";
+import type { SkillSource } from "../../agent/skill-sources";
+import type { ContextTracker } from "../../cli/helpers/context-tracker";
+import type { ApprovalRequest } from "../../cli/helpers/stream";
+import type { ModAdapter } from "../../mods/mod-adapter";
+import type { ApprovalContext } from "../../permissions/analyzer";
+import type { DequeuedBatch, QueueBlockedReason, QueueItem, QueueRuntime } from "../../queue/queue-runtime";
+import type { SharedReminderState } from "../../reminders/state";
+import type { ToolsetName, ToolsetPreference } from "../../tools/toolset";
+import type { ApprovalResponseBody, ClientToolsetConfig, ControlRequest, ExternalToolCallResult, LoopStatus, RuntimeScope, StopReasonType, WsProtocolCommand } from "../../types/protocol_v2";
+import type { ServiceCommandRequest, ServiceCommandResponse } from "../../types/service-protocol";
+import type { ListenerTransport } from "./transport";
+import type { TurnLifecycle } from "./turn-lifecycle";
+export interface StartListenerOptions {
+    connectionId: string;
+    wsUrl: string;
+    supportsSplitStatusChannels?: boolean;
+    deviceId: string;
+    connectionName: string;
+    onConnected: (connectionId: string) => void | Promise<void>;
+    onDisconnected: () => void;
+    onNeedsReregister?: () => void;
+    onError: (error: Error) => void;
+    onStatusChange?: (status: "idle" | "receiving" | "processing", connectionId: string) => void;
+    onLog?: (message: string) => void;
+    onRetrying?: (attempt: number, maxAttempts: number, nextRetryIn: number, connectionId: string) => void;
+    onWsEvent?: (direction: "send" | "recv", label: "client" | "protocol" | "control" | "lifecycle", event: unknown) => void;
+}
+export interface IncomingMessage {
+    type: "message";
+    /**
+     * Transport connection that delivered this message. Queueing carries this
+     * identity through to the turn so approvals and other interactive requests
+     * return to the correct client even when multiple clients share a runtime.
+     */
+    connectionId?: ListenerConnectionId;
+    agentId?: string;
+    conversationId?: string;
+    /** Queue this message as its own turn; never merge with other messages. */
+    noCoalesce?: boolean;
+    imageFailureMode?: "strict" | "drop";
+    clientToolAllowlist?: string[];
+    clientToolset?: ClientToolsetConfig;
+    externalToolScopeIds?: string[];
+    /** Exclude interactive user-input tools (AskUserQuestion) from this turn's toolset. */
+    excludeInteractiveTools?: boolean;
+    messages: Array<(MessageCreate & {
+        client_message_id?: string;
+    }) | ApprovalCreate>;
+    /**
+     * Cloud user id of the human who actually pressed "send", forwarded
+     * from cloud-api's status WS. When set, the listener echoes it on
+     * the outbound createMessage HTTP call (X-Letta-Acting-User-Id) so
+     * cloud attributes credits + rate limits to the actual sender, not
+     * to whoever spawned the sandbox / desktop runtime. Undefined for
+     * self-hosted, single-user, or pre-channel-split flows.
+     */
+    actingUserId?: string;
+}
+export type ProcessQueuedTurn = (queuedTurn: IncomingMessage, dequeuedBatch: DequeuedBatch) => Promise<void>;
+/**
+ * An outbound v2 protocol message as delivered to in-process stream
+ * observers: the pre-envelope message payload plus its resolved runtime
+ * scope (agent/conversation) and optional subagent attribution.
+ */
+export interface ObservedProtocolV2Message {
+    type: string;
+    runtime: {
+        agent_id?: string | null;
+        conversation_id?: string | null;
+    };
+    subagent_id?: string;
+    [key: string]: unknown;
+}
+export type ListenerStreamObserver = (message: ObservedProtocolV2Message) => void;
+export interface PendingExternalToolCall {
+    connectionId: ListenerConnectionId;
+    resolve: (result: ExternalToolCallResult) => void;
+    reject: (error: Error) => void;
+    timeout: ReturnType<typeof setTimeout>;
+}
+export interface ModeChangePayload {
+    mode: "standard" | "acceptEdits" | "unrestricted" | "strict";
+}
+export interface ChangeCwdMessage {
+    agentId?: string | null;
+    conversationId?: string | null;
+    cwd: string;
+}
+export type InboundMessagePayload = (MessageCreate & {
+    client_message_id?: string;
+}) | ApprovalCreate;
+export type ServerMessage = WsProtocolCommand;
+export type InvalidInputCommand = {
+    type: "__invalid_input";
+    runtime: RuntimeScope;
+    reason: string;
+};
+export type ParsedServerMessage = ServerMessage | InvalidInputCommand;
+export type PendingApprovalResolver = {
+    requestId: string;
+    connectionIds: Set<ListenerConnectionId>;
+    resolve: (response: ApprovalResponseBody) => void;
+    reject: (reason: Error) => void;
+    controlRequest?: ControlRequest;
+};
+export type RecoveredPendingApproval = {
+    approval: ApprovalRequest;
+    controlRequest: ControlRequest;
+    approvalContext: ApprovalContext | null;
+};
+export type RecoveredApprovalState = {
+    agentId: string;
+    conversationId: string;
+    approvalsByRequestId: Map<string, RecoveredPendingApproval>;
+    pendingRequestIds: Set<string>;
+    responsesByRequestId: Map<string, ApprovalResponseBody>;
+    autoDecisions?: ApprovalDecision[];
+    allApprovals?: ApprovalRequest[];
+};
+export type ConversationRuntime = {
+    listener: ListenerRuntime;
+    key: string;
+    agentId: string | null;
+    conversationId: string;
+    /** Runtime-scoped SDK override. Undefined uses the process defaults. */
+    skillSources: SkillSource[] | undefined;
+    /** Connection currently executing this conversation's turn, if client-owned. */
+    activeConnectionId: ListenerConnectionId | null;
+    turnLifecycle: TurnLifecycle;
+    messageQueue: Promise<void>;
+    /** Recently accepted ingress IDs, retained for idempotent client retries. */
+    acceptedInputDispositions: Map<string, "started" | "queued">;
+    pendingApprovalResolvers: Map<string, PendingApprovalResolver>;
+    recoveredApprovalState: RecoveredApprovalState | null;
+    readonly lastStopReason: StopReasonType | null;
+    lastTerminalLoopErrorMessage: string | null;
+    lastTerminalLoopErrorRunId: string | null;
+    readonly isProcessing: boolean;
+    readonly activeWorkingDirectory: string | null;
+    expectedWorktreePath: string | null;
+    expectedWorktreeExpiresAt: number | null;
+    readonly activeRunId: string | null;
+    readonly cancelRequested: boolean;
+    queueRuntime: QueueRuntime;
+    queuedMessagesByItemId: Map<string, IncomingMessage>;
+    queuePumpActive: boolean;
+    queuePumpScheduled: boolean;
+    pendingTurns: number;
+    readonly loopStatus: LoopStatus;
+    currentToolset: ToolsetName | null;
+    currentToolsetPreference: ToolsetPreference;
+    currentLoadedTools: string[];
+    pendingApprovalBatchByToolCallId: Map<string, string>;
+    pendingInterruptedResults: Array<ApprovalResult> | null;
+    pendingInterruptedContext: {
+        agentId: string;
+        conversationId: string;
+        continuationEpoch: number;
+    } | null;
+    continuationEpoch: number;
+    pendingInterruptedToolCallIds: string[] | null;
+    /** Per-conversation reminder state (session-context, agent-info, etc.). */
+    reminderState: SharedReminderState;
+    /** Per-conversation tracker for compaction/reflection cadence. */
+    contextTracker: ContextTracker;
+};
+export type ListenerConnectionId = string;
+/**
+ * Explicit destination for one outbound listener message.
+ *
+ * This mirrors Codex's OutgoingEnvelope split. Scoped notifications never
+ * fall back to every connected client: ToSubscribers with an empty subscriber
+ * set is intentionally a no-op.
+ */
+export type ListenerMessageRouting = {
+    type: "ToConnection";
+    connectionId: ListenerConnectionId;
+} | {
+    type: "ToSubscribers";
+} | {
+    type: "Broadcast";
+};
+/**
+ * State owned by one transport connection.
+ *
+ * This mirrors Codex's ConnectionState: the process runtime owns services and
+ * conversations, while each client owns its writer, cancellation handle,
+ * initialization state, subscriptions, request resources, and event sequence.
+ */
+export type ListenerConnectionState = {
+    id: ListenerConnectionId;
+    ordinal: number;
+    writer: ListenerTransport;
+    streamWriter: ListenerTransport | null;
+    cancellation: AbortController;
+    initialized: boolean;
+    subscriptions: Set<string>;
+    eventSeqCounter: number;
+    options: StartListenerOptions;
+};
+export type ListenerRuntime = {
+    socket: WebSocket | null;
+    transport?: ListenerTransport | null;
+    streamSocket?: WebSocket | null;
+    streamTransport?: ListenerTransport | null;
+    heartbeatInterval: NodeJS.Timeout | null;
+    reconnectTimeout: NodeJS.Timeout | null;
+    /**
+     * Epoch ms of the last `pong` observed from the cloud relay. Used by the
+     * heartbeat watchdog to detect a half-open socket (no `close` event) and
+     * force a reconnect. `null` until the first pong on a connection.
+     */
+    lastPongAt: number | null;
+    intentionallyClosed: boolean;
+    hasSuccessfulConnection: boolean;
+    /** True once the WS has connected at least once. Never reset to false. */
+    everConnected: boolean;
+    /** Global local mod adapter for desktop/listener surfaces. */
+    modAdapter?: ModAdapter | undefined;
+    /** Isolated agent-scoped adapters loaded from each agent's MemFS. */
+    agentModAdapters?: Map<string, ModAdapter>;
+    /** Coalesces concurrent first-loads for one agent's scoped adapter. */
+    agentModAdapterLoads?: Map<string, Promise<ModAdapter | null>>;
+    sessionId: string;
+    /** Monotonic allocator used for deterministic connection ordering. */
+    nextConnectionOrdinal: number;
+    /** All currently open listener transports, keyed by explicit identity. */
+    connections: Map<ListenerConnectionId, ListenerConnectionState>;
+    /** Reverse index for Codex-style conversation subscriptions. */
+    connectionIdsByRuntimeKey: Map<string, Set<ListenerConnectionId>>;
+    /** Process-scoped transport used by scheduler/channel/background services. */
+    processTransport: ListenerTransport | null;
+    /** Process-wide services are installed once, regardless of client count. */
+    processServicesStarted: boolean;
+    /** Invalidates process-service attempts that outlive an outbound connection. */
+    processServicesGeneration: number;
+    /** Coalesces concurrent connection attempts while process services initialize. */
+    processServicesReady: Promise<void> | null;
+    /** Generation owned by processServicesReady, or null when no attempt is active. */
+    processServicesReadyGeneration: number | null;
+    serviceCommandHandler: ((command: ServiceCommandRequest) => Promise<ServiceCommandResponse>) | null;
+    serviceCommandTypes: Set<WsProtocolCommand["type"]>;
+    eventSeqCounter: number;
+    queueEmitScheduled: boolean;
+    pendingQueueEmitScope?: {
+        agent_id?: string | null;
+        conversation_id?: string | null;
+    };
+    onWsEvent?: StartListenerOptions["onWsEvent"];
+    reminderState: SharedReminderState;
+    bootWorkingDirectory: string;
+    workingDirectoryByConversation: Map<string, string>;
+    /** Monotonic signal for cwd changes and rejected stale cwd requests. */
+    workingDirectoryRevision?: number;
+    /** Per-conversation permission mode state. Mirrors workingDirectoryByConversation. */
+    permissionModeByConversation: Map<string, import("./permission-mode").ConversationPermissionModeState>;
+    /** Per-conversation skill overrides survive idle ConversationRuntime eviction. */
+    skillSourcesByConversation: Map<string, SkillSource[]>;
+    /** Per-conversation reminder state survives ConversationRuntime eviction. */
+    reminderStateByConversation: Map<string, SharedReminderState>;
+    /** Per-conversation context tracker survives ConversationRuntime eviction. */
+    contextTrackerByConversation: Map<string, ContextTracker>;
+    /** Shared recompile coalescing for memory-writing subagents. */
+    systemPromptRecompileByConversation: Map<string, Promise<void>>;
+    queuedSystemPromptRecompileByConversation: Set<string>;
+    connectionId: string | null;
+    connectionName: string | null;
+    conversationRuntimes: Map<string, ConversationRuntime>;
+    /** Per-conversation worktree directory watchers for CWD auto-detection fallback. */
+    worktreeWatcherByConversation: Map<string, import("./worktree-watcher").WorktreeWatcherState>;
+    /** Agent IDs whose memfs repo has been cloned/pulled this session. Concurrent callers coalesce on the same promise. */
+    memfsSyncedAgents: Map<string, Promise<boolean>>;
+    /** Agent IDs with an in-flight secrets refresh. Concurrent callers coalesce on the same promise. */
+    secretsHydrationByAgent: Map<string, Promise<void>>;
+    /** Per-agent timestamp of the last successful secrets hydration. Used for freshness-based caching. */
+    secretsHydrationFreshnessByAgent: Map<string, number>;
+    /** Agent IDs whose cached secrets are stale and must re-fetch on the next hydration call. */
+    secretsDirtyAgents: Set<string>;
+    pendingExternalToolCalls: Map<string, PendingExternalToolCall>;
+    /**
+     * Agent metadata warmups for listen-mode reminders. The cached promise is
+     * reused while the listener stays connected so first-turn reminders can join
+     * an in-flight sync warmup instead of fetching agent info again.
+     */
+    agentMetadataByAgent: Map<string, Promise<{
+        name: string | null;
+        description: string | null;
+        lastRunAt: string | null;
+    } | null>>;
+    lastEmittedStatus: "idle" | "receiving" | "processing" | null;
+    /**
+     * In-process observers of outbound v2 protocol messages (e.g. the
+     * OpenAI-compat HTTP bridge). Each observer receives every emitted message
+     * with its resolved runtime scope, independent of socket routing, so
+     * protocol consumers can exist without owning a WebSocket.
+     */
+    streamObservers?: Set<ListenerStreamObserver>;
+    /** Unsubscribe from subagent state store (set on socket open, cleared on close). */
+    _unsubscribeSubagentState?: (() => void) | undefined;
+    /** Unsubscribe from subagent stream events (set on socket open, cleared on close). */
+    _unsubscribeSubagentStreamEvents?: (() => void) | undefined;
+};
+export interface InterruptPopulateInput {
+    lastExecutionResults: ApprovalResult[] | null;
+    lastExecutingToolCallIds: string[];
+    lastNeedsUserInputToolCallIds: string[];
+    agentId: string;
+    conversationId: string;
+}
+export interface InterruptToolReturn {
+    tool_call_id: string;
+    status: "success" | "error";
+    tool_return: string;
+    stdout?: string[];
+    stderr?: string[];
+}
+export type { DequeuedBatch, QueueBlockedReason, QueueItem };
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/types/websocket/listener/worktree-ownership.d.ts

@@ -0,0 +1,11 @@
+import type { ConversationRuntime } from "./types";
+export declare function resolveGitWorktreeAddTargetPath(command: string, cwd: string): string | null;
+export declare function resolveGitWorktreeAddTargetPathFromLauncher(launcher: string[], cwd: string): string | null;
+export declare function noteExpectedWorktreeForLauncher(launcher: string[], cwd: string): void;
+export declare function hasExpectedWorktreePath(runtime: ConversationRuntime | null, detectedPath: string): boolean;
+export declare function clearExpectedWorktreePath(runtime: ConversationRuntime | null): void;
+export declare const __worktreeOwnershipTestUtils: {
+    resolveGitWorktreeAddTargetPath: typeof resolveGitWorktreeAddTargetPath;
+    resolveGitWorktreeAddTargetPathFromLauncher: typeof resolveGitWorktreeAddTargetPathFromLauncher;
+};
+//# sourceMappingURL=worktree-ownership.d.ts.map

package/dist/types/websocket/listener/worktree-ownership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-ownership.d.ts","sourceRoot":"","sources":["../../../../src/websocket/listener/worktree-ownership.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAyPnD,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,IAAI,CAgBf;AAED,wBAAgB,2CAA2C,CACzD,QAAQ,EAAE,MAAM,EAAE,EAClB,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,IAAI,CAOf;AAED,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,MAAM,EAAE,EAClB,GAAG,EAAE,MAAM,GACV,IAAI,CAgCN;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,mBAAmB,GAAG,IAAI,EACnC,YAAY,EAAE,MAAM,GACnB,OAAO,CAcT;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,mBAAmB,GAAG,IAAI,GAClC,IAAI,CAMN;AAED,eAAO,MAAM,4BAA4B;;;CAGxC,CAAC"}

package/dist/types/websocket/listener/worktree-watcher.d.ts

@@ -0,0 +1,41 @@
+import type { ListenerRuntime } from "./types";
+export interface WorktreeWatcherState {
+    /** The AbortController whose signal cancels the watch loop. */
+    abort: AbortController;
+    /** The directory being watched (e.g. `<cwd>/.letta/worktrees`). */
+    watchedDir: string;
+}
+/**
+ * Start watching `<cwd>/.letta/worktrees/` for new directories.
+ *
+ * When a new directory appears that wasn't present at watch-start time,
+ * the conversation's CWD is automatically updated to point at the new
+ * worktree — unless the stream-based detection already switched it.
+ *
+ * Returns a `WorktreeWatcherState` handle that must be passed to
+ * `stopWorktreeWatcher()` on cleanup, or `null` if the directory
+ * doesn't exist (no-op).
+ */
+export declare function startWorktreeWatcher(params: {
+    runtime: ListenerRuntime;
+    agentId: string | null;
+    conversationId: string;
+}): WorktreeWatcherState | null;
+/**
+ * Stop an active worktree watcher.
+ */
+export declare function stopWorktreeWatcher(state: WorktreeWatcherState): void;
+/**
+ * Stop all active worktree watchers for a listener.
+ */
+export declare function stopAllWorktreeWatchers(runtime: ListenerRuntime): void;
+/**
+ * Convenience: stop any existing watcher for a scope, then start a new one.
+ * Called after every CWD change.
+ */
+export declare function restartWorktreeWatcher(params: {
+    runtime: ListenerRuntime;
+    agentId: string | null;
+    conversationId: string;
+}): void;
+//# sourceMappingURL=worktree-watcher.d.ts.map

package/dist/types/websocket/listener/worktree-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-watcher.d.ts","sourceRoot":"","sources":["../../../../src/websocket/listener/worktree-watcher.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAe/C,MAAM,WAAW,oBAAoB;IACnC,+DAA+D;IAC/D,KAAK,EAAE,eAAe,CAAC;IACvB,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,oBAAoB,GAAG,IAAI,CAsB9B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAErE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAKtE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,IAAI,CAcP"}