@letta-ai/letta-code 0.30.2 → 0.30.4

package/dist/types/utils/stream-abort-relay.d.ts

@@ -0,0 +1,8 @@
+export interface StreamAbortRelay {
+    signal: AbortSignal;
+    attach: (stream: object) => void;
+    cleanup: () => void;
+}
+export declare function createStreamAbortRelay(parentSignal?: AbortSignal): StreamAbortRelay | null;
+export declare function cleanupStreamAbortRelay(stream: object): void;
+//# sourceMappingURL=stream-abort-relay.d.ts.map

package/dist/types/utils/stream-abort-relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-abort-relay.d.ts","sourceRoot":"","sources":["../../../src/utils/stream-abort-relay.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,sBAAsB,CACpC,YAAY,CAAC,EAAE,WAAW,GACzB,gBAAgB,GAAG,IAAI,CA2BzB;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAQ5D"}

package/dist/types/utils/subagent-stdout-failure.d.ts

@@ -0,0 +1,10 @@
+export declare const SUBAGENT_STDOUT_LOST_MARKER = "headless stdout stream failed before the final result was written";
+export declare function isSubagentStdoutLostError(stderr: string): boolean;
+/**
+ * Write the stdout-lost marker to stderr synchronously. Callers exit the
+ * process right after reporting, so an async `console.error` could be
+ * truncated the same way the stdout stream was — `writeSync` to fd 2
+ * guarantees the marker is flushed before `process.exit` runs.
+ */
+export declare function reportSubagentStdoutLoss(detail?: unknown): void;
+//# sourceMappingURL=subagent-stdout-failure.d.ts.map

package/dist/types/utils/subagent-stdout-failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-stdout-failure.d.ts","sourceRoot":"","sources":["../../../src/utils/subagent-stdout-failure.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,2BAA2B,sEAC6B,CAAC;AAEtE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAO/D"}

package/dist/types/utils/system-prompt-size.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Shared system-prompt size estimator.
+ *
+ * Used by:
+ *   - The `letta memory tokens` CLI command (for subagents + scripts)
+ *   - The startup system-prompt warning
+ *   - The bundled `context-doctor` skill script (via CLI)
+ *
+ * Heuristic: ~4 bytes per token
+ * (codex-rs/core/src/truncate.rs APPROX_BYTES_PER_TOKEN = 4)
+ */
+export declare const SYSTEM_PROMPT_BYTES_PER_TOKEN = 4;
+export interface FileEstimate {
+    path: string;
+    tokens: number;
+}
+export interface SystemPromptSizeEstimate {
+    total: number;
+    files: FileEstimate[];
+}
+export declare function estimateSystemTokens(text: string): number;
+/**
+ * Estimate total token usage of files under `<memoryDir>/system/`, with a per-file breakdown.
+ *
+ * Returns { total: 0, files: [] } when `system/` does not exist (instead of throwing).
+ */
+export declare function estimateSystemPromptSize(memoryDir: string): SystemPromptSizeEstimate;
+/**
+ * Backward-compatible helper returning just the total.
+ */
+export declare function estimateSystemPromptTokensFromMemoryDir(memoryDir: string): number;
+//# sourceMappingURL=system-prompt-size.d.ts.map

package/dist/types/utils/system-prompt-size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt-size.d.ts","sourceRoot":"","sources":["../../../src/utils/system-prompt-size.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIzD;AAgCD;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,GAChB,wBAAwB,CAiB1B;AAED;;GAEG;AACH,wBAAgB,uCAAuC,CACrD,SAAS,EAAE,MAAM,GAChB,MAAM,CAER"}

package/dist/types/utils/task-notifications.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Task Notification Formatting
+ *
+ * Formats background task completion notifications as XML.
+ * The actual queueing is handled by messageQueueBridge.ts.
+ */
+export interface TaskNotification {
+    taskId: string;
+    status: "completed" | "failed";
+    summary: string;
+    result: string;
+    outputFile: string;
+    usage?: {
+        totalTokens?: number;
+        toolUses?: number;
+        durationMs?: number;
+    };
+}
+/**
+ * Format a single notification as XML string for queueing.
+ */
+export declare function formatTaskNotification(notification: TaskNotification): string;
+export declare function extractTaskNotificationsForDisplay(message: string): {
+    notifications: string[];
+    cleanedText: string;
+};
+/**
+ * Append task-notification events to a transcript buffer and flush.
+ *
+ * This is the pure-function core of App.tsx's `appendTaskNotificationEvents`
+ * useCallback. Extracting it here makes the behavioral contract testable:
+ * buffer writes MUST be followed by a flush so that notifications from
+ * background subagent onComplete callbacks (which run outside React's render
+ * cycle) appear immediately instead of waiting for the next unrelated render.
+ */
+export type NotificationBuffer = Pick<import("../cli/helpers/accumulator").Buffers, "byId" | "order">;
+export declare function appendTaskNotificationEventsToBuffer(summaries: string[], buffer: NotificationBuffer, generateId: () => string, flush?: () => void): boolean;
+//# sourceMappingURL=task-notifications.d.ts.map

package/dist/types/utils/task-notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-notifications.d.ts","sourceRoot":"","sources":["../../../src/utils/task-notifications.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAMH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE;QACN,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAqBD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,gBAAgB,GAAG,MAAM,CA0B7E;AAED,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,MAAM,GAAG;IACnE,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB,CAoCA;AAMD;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACnC,OAAO,2BAA2B,EAAE,OAAO,EAC3C,MAAM,GAAG,OAAO,CACjB,CAAC;AAEF,wBAAgB,oCAAoC,CAClD,SAAS,EAAE,MAAM,EAAE,EACnB,MAAM,EAAE,kBAAkB,EAC1B,UAAU,EAAE,MAAM,MAAM,EACxB,KAAK,CAAC,EAAE,MAAM,IAAI,GACjB,OAAO,CAgBT"}

package/dist/types/utils/text-files.d.ts

@@ -0,0 +1,7 @@
+export type Utf16Bom = "UTF-16LE" | "UTF-16BE";
+export declare function getUtf16Bom(bytes: Uint8Array): Utf16Bom | null;
+export declare function invalidUtf8TextFileMessage(filePath: string, detail?: Utf16Bom): string;
+export declare function decodeUtf8TextStrict(bytes: Uint8Array, filePath: string): string;
+export declare function readUtf8TextStrict(filePath: string): Promise<string>;
+export declare function writeUtf8Text(filePath: string, content: string): Promise<void>;
+//# sourceMappingURL=text-files.d.ts.map

package/dist/types/utils/text-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-files.d.ts","sourceRoot":"","sources":["../../../src/utils/text-files.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAE/C,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,QAAQ,GAAG,IAAI,CAK9D;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,QAAQ,GAChB,MAAM,CAMR;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,GACf,MAAM,CAWR;AAED,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG1E;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/types/utils/timing.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Check if debug timings are enabled via LETTA_DEBUG_TIMINGS env var
+ * Set LETTA_DEBUG_TIMINGS=1 or LETTA_DEBUG_TIMINGS=true to enable timing logs
+ */
+export declare function isTimingsEnabled(): boolean;
+/**
+ * Format duration nicely: "245ms" or "1.52s"
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * Format timestamp: "12:34:56.789"
+ */
+export declare function formatTimestamp(date: Date): string;
+/**
+ * Log timing message to stderr (won't interfere with stdout JSON in headless mode)
+ */
+export declare function logTiming(message: string): void;
+/**
+ * Mark a named milestone in the boot/execution sequence.
+ * Call this at key points to track where time is spent.
+ *
+ * @param name - Descriptive name like "SETTINGS_LOADED" or "AGENT_RESOLVED"
+ */
+export declare function markMilestone(name: string): void;
+/**
+ * Measure time elapsed since a previous milestone.
+ *
+ * @param label - Description of what we're measuring (e.g., "tool loading")
+ * @param fromMilestone - Name of the starting milestone
+ */
+export declare function measureSinceMilestone(label: string, fromMilestone: string): void;
+/**
+ * Get the duration between two milestones in milliseconds.
+ * Returns null if either milestone doesn't exist.
+ */
+export declare function getMilestoneDuration(fromMilestone: string, toMilestone: string): number | null;
+/**
+ * Print a summary of all milestones with relative timestamps.
+ * Useful at the end of a benchmark run.
+ */
+export declare function reportAllMilestones(): void;
+/**
+ * Clear all milestones (useful for running multiple benchmarks in sequence).
+ */
+export declare function clearMilestones(): void;
+type SimpleFetch = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+/**
+ * Create an instrumented fetch that logs timing for every request.
+ * Logs request start and end (with duration and status) to stderr.
+ */
+export declare function createTimingFetch(baseFetch: SimpleFetch): SimpleFetch;
+export {};
+//# sourceMappingURL=timing.d.ts.map

package/dist/types/utils/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../../src/utils/timing.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAG1C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI/C;AAYD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAchD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,GACpB,IAAI,CAaN;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,IAAI,CAKf;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAsB1C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAGtC;AAGD,KAAK,WAAW,GAAG,CACjB,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,WAAW,GAAG,WAAW,CAuCrE"}

package/dist/types/utils/transcript-paths.d.ts

@@ -0,0 +1,13 @@
+/** Env override for the reflection transcript root. */
+export declare const TRANSCRIPT_ROOT_ENV = "LETTA_TRANSCRIPT_ROOT";
+/**
+ * Root directory for reflection transcripts: `$LETTA_TRANSCRIPT_ROOT` when set,
+ * else `~/.letta/transcripts`.
+ *
+ * Shared (rather than private to `reflection-transcript.ts`) so the filesystem
+ * sandbox can carve it writable as a harness-metadata path: a memory-subagent
+ * subagent persists its OWN transcript here via the headless loop, and the
+ * write policy governs the agent's non-deterministic work, not harness artifacts.
+ */
+export declare function getTranscriptRoot(): string;
+//# sourceMappingURL=transcript-paths.d.ts.map

package/dist/types/utils/transcript-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-paths.d.ts","sourceRoot":"","sources":["../../../src/utils/transcript-paths.ts"],"names":[],"mappings":"AAGA,uDAAuD;AACvD,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAE3D;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAM1C"}

package/dist/types/utils/tui-perf.d.ts

@@ -0,0 +1,6 @@
+export declare function recordTuiPerf(key: string, sample?: {
+    bytes?: number;
+    ms?: number;
+}): void;
+export declare function recordTuiJsonPayload(key: string, value: unknown): void;
+//# sourceMappingURL=tui-perf.d.ts.map

package/dist/types/utils/tui-perf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui-perf.d.ts","sourceRoot":"","sources":["../../../src/utils/tui-perf.ts"],"names":[],"mappings":"AAiDA,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,GACA,IAAI,CA0BN;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAUtE"}

package/dist/types/utils/type-guards.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Returns true if value is a non-null, non-array object.
+ * Use this instead of `typeof x === "object" && x !== null` when you want
+ * to exclude arrays (the most common intent for a "record" check).
+ */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=type-guards.d.ts.map

package/dist/types/utils/type-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../../../src/utils/type-guards.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE"}

package/dist/types/utils/url.d.ts

@@ -0,0 +1,8 @@
+export declare function parseUrl(value: string, options?: {
+    allowMissingProtocol?: boolean;
+}): URL | null;
+export declare function isLoopbackHostname(hostname: string): boolean;
+export declare function isLoopbackUrl(value: string, options?: {
+    allowMissingProtocol?: boolean;
+}): boolean;
+//# sourceMappingURL=url.d.ts.map

package/dist/types/utils/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../../src/utils/url.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,CACtB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/C,GAAG,GAAG,IAAI,CAyBZ;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAS5D;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/C,OAAO,CAGT"}

package/dist/types/utils/worktree-lock.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Cross-agent advisory lock so two conversations do not both switch into the
+ * same worktree and clobber each other's uncommitted work. The lock is a small
+ * JSON file written into the worktree's per-worktree git admin directory
+ * (`<common>/worktrees/<name>/`), which keeps it out of the working tree and
+ * lets `git worktree remove` clean it up automatically.
+ *
+ * This module is the pure file-backed primitive (acquire/release plus ownership
+ * and liveness rules). The session-aware orchestration that resolves git dirs
+ * and reads the runtime context lives with the worktree tool.
+ */
+export declare const LOCK_FILENAME = "letta-enter.lock";
+export interface WorktreeLockOwner {
+    conversationId: string | null;
+    agentId: string | null;
+}
+export interface WorktreeLock {
+    conversationId: string | null;
+    agentId: string | null;
+    pid: number;
+    hostname: string;
+    acquiredAt: string;
+}
+export type WorktreeLockOutcome = {
+    outcome: "acquired" | "reentrant" | "reclaimed" | "forced";
+    lock: WorktreeLock;
+    previous?: WorktreeLock;
+} | {
+    outcome: "conflict";
+    heldBy: WorktreeLock;
+};
+export declare function describeHolder(lock: WorktreeLock): string;
+/**
+ * Acquires (or refreshes) the advisory lock for a worktree on behalf of
+ * `owner`. Returns a `conflict` outcome when the worktree is actively held by a
+ * different, live owner and `force` is not set; otherwise writes the lock and
+ * reports how it was obtained.
+ */
+export declare function acquireWorktreeLock(params: {
+    worktreeGitDir: string;
+    owner: WorktreeLockOwner;
+    force?: boolean;
+}): Promise<WorktreeLockOutcome>;
+/** Releases `owner`'s lock on a worktree. No-op if it is held by someone else. */
+export declare function releaseWorktreeLock(params: {
+    worktreeGitDir: string;
+    owner: WorktreeLockOwner;
+}): Promise<boolean>;
+//# sourceMappingURL=worktree-lock.d.ts.map

package/dist/types/utils/worktree-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-lock.d.ts","sourceRoot":"","sources":["../../../src/utils/worktree-lock.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,qBAAqB,CAAC;AAIhD,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,mBAAmB,GAC3B;IACE,OAAO,EAAE,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC3D,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB,GACD;IAAE,OAAO,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAAC;AAgElD,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAKzD;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,iBAAiB,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA2B/B;AAED,kFAAkF;AAClF,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,iBAAiB,CAAC;CAC1B,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnB"}

package/dist/types/version.d.ts

@@ -0,0 +1,2 @@
+export declare function getVersion(): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/types/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/dist/types/websocket/listener/background-process-snapshot.d.ts

@@ -0,0 +1,3 @@
+import type { BackgroundProcessSummary } from "../../types/protocol_v2";
+export declare function buildBackgroundProcessSnapshot(agentId?: string | null, conversationId?: string): BackgroundProcessSummary[];
+//# sourceMappingURL=background-process-snapshot.d.ts.map

package/dist/types/websocket/listener/background-process-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-process-snapshot.d.ts","sourceRoot":"","sources":["../../../../src/websocket/listener/background-process-snapshot.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAYpE,wBAAgB,8BAA8B,CAC5C,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,EACvB,cAAc,SAAY,GACzB,wBAAwB,EAAE,CA+C5B"}

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

@@ -0,0 +1,48 @@
+import { type ListenerTransport } from "./transport";
+import type { ListenerConnectionId, ListenerConnectionState, ListenerMessageRouting, ListenerRuntime, StartListenerOptions } from "./types";
+export declare const TO_SUBSCRIBERS: {
+    readonly type: "ToSubscribers";
+};
+export declare const BROADCAST: {
+    readonly type: "Broadcast";
+};
+export declare function toListenerConnection(connectionId: ListenerConnectionId): ListenerMessageRouting;
+export declare function createConnectionRequestKey(connectionId: ListenerConnectionId, requestId: string): string;
+export declare function openListenerConnection(params: {
+    runtime: ListenerRuntime;
+    connectionId: ListenerConnectionId;
+    writer: ListenerTransport;
+    streamWriter?: ListenerTransport | null;
+    cancellation?: AbortController;
+    options: StartListenerOptions;
+}): ListenerConnectionState;
+export declare function markListenerConnectionInitialized(runtime: ListenerRuntime, connectionId: ListenerConnectionId): void;
+export declare function subscribeListenerConnection(runtime: ListenerRuntime, connectionId: ListenerConnectionId, scope: {
+    agent_id?: string | null;
+    conversation_id?: string | null;
+}): boolean;
+export declare function unsubscribeListenerConnection(runtime: ListenerRuntime, connectionId: ListenerConnectionId, runtimeKey: string): boolean;
+export declare function getSubscribedListenerConnections(runtime: ListenerRuntime, scope: {
+    agent_id?: string | null;
+    conversation_id?: string | null;
+}): ListenerConnectionState[];
+export declare function findListenerConnectionByTransport(runtime: ListenerRuntime, transport: ListenerTransport): ListenerConnectionState | null;
+export interface ListenerConnectionTarget {
+    connection: ListenerConnectionState | null;
+    transport: ListenerTransport;
+}
+export declare function nextListenerConnectionEventSeq(connection: ListenerConnectionState | null, runtime: ListenerRuntime | null): number | null;
+export declare function resolveListenerConnectionTargets(params: {
+    runtime: ListenerRuntime | null;
+    origin: ListenerTransport;
+    scope: {
+        agent_id?: string | null;
+        conversation_id?: string | null;
+    };
+    routing: ListenerMessageRouting;
+    streamMessage: boolean;
+}): ListenerConnectionTarget[];
+export declare function closeListenerConnection(runtime: ListenerRuntime, connectionId: ListenerConnectionId): ListenerConnectionState | null;
+export declare function suspendListenerConnection(runtime: ListenerRuntime, connectionId: ListenerConnectionId): ListenerConnectionState | null;
+export declare function getOrCreateProcessTransport(runtime: ListenerRuntime): ListenerTransport;
+//# sourceMappingURL=connection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../../src/websocket/listener/connection.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,iBAAiB,EAEvB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,oBAAoB,EACpB,uBAAuB,EACvB,sBAAsB,EACtB,eAAe,EACf,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAEjB,eAAO,MAAM,cAAc;;CAEgB,CAAC;AAE5C,eAAO,MAAM,SAAS;;CAEqB,CAAC;AAE5C,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,oBAAoB,GACjC,sBAAsB,CAExB;AA2CD,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,oBAAoB,EAClC,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,OAAO,EAAE,eAAe,CAAC;IACzB,YAAY,EAAE,oBAAoB,CAAC;IACnC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,YAAY,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACxC,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B,OAAO,EAAE,oBAAoB,CAAC;CAC/B,GAAG,uBAAuB,CAmC1B;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,oBAAoB,GACjC,IAAI,CAKN;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,oBAAoB,EAClC,KAAK,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACnE,OAAO,CAiBT;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,oBAAoB,EAClC,UAAU,EAAE,MAAM,GACjB,OAAO,CAWT;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACnE,uBAAuB,EAAE,CAoB3B;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,iBAAiB,GAC3B,uBAAuB,GAAG,IAAI,CAUhC;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC3C,SAAS,EAAE,iBAAiB,CAAC;CAC9B;AAED,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,uBAAuB,GAAG,IAAI,EAC1C,OAAO,EAAE,eAAe,GAAG,IAAI,GAC9B,MAAM,GAAG,IAAI,CAMf;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE;IACvD,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IAChC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACrE,OAAO,EAAE,sBAAsB,CAAC;IAChC,aAAa,EAAE,OAAO,CAAC;CACxB,GAAG,wBAAwB,EAAE,CA4E7B;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,oBAAoB,GACjC,uBAAuB,GAAG,IAAI,CAahC;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,eAAe,EACxB,YAAY,EAAE,oBAAoB,GACjC,uBAAuB,GAAG,IAAI,CAahC;AAkCD,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,eAAe,GACvB,iBAAiB,CAInB"}

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

@@ -0,0 +1,22 @@
+export declare const MAX_RETRY_DURATION_MS: number;
+export declare const INITIAL_RETRY_DELAY_MS = 1000;
+export declare const MAX_RETRY_DELAY_MS = 30000;
+export declare const LISTENER_STREAM_OPEN_TIMEOUT_MS = 30000;
+export declare const LISTENER_HEARTBEAT_INTERVAL_MS = 30000;
+export declare const LISTENER_PONG_TIMEOUT_MS = 90000;
+/**
+ * Returns true when the listener has not observed a relay `pong` within
+ * `timeoutMs`, indicating a likely half-open socket that should be terminated
+ * to trigger a reconnect. Returns false when no pong has been recorded yet
+ * (`lastPongAt === null`) so a freshly-connected socket is never killed before
+ * its first heartbeat round-trip completes.
+ */
+export declare function isListenerPongStale(lastPongAt: number | null, now: number, timeoutMs: number): boolean;
+export declare const SYSTEM_REMINDER_RE: RegExp;
+export declare const LLM_API_ERROR_MAX_RETRIES = 3;
+export declare const EMPTY_RESPONSE_MAX_RETRIES = 2;
+export declare const MAX_PRE_STREAM_RECOVERY = 2;
+export declare const MAX_POST_STOP_APPROVAL_RECOVERY = 2;
+export declare const PROVIDER_FALLBACK_MAP: Record<string, string>;
+export declare const PROVIDER_FALLBACK_NOTICE = "Anthropic API error; falling back to Bedrock...";
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/websocket/listener/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,QAAgB,CAAC;AACnD,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAKxC,eAAO,MAAM,+BAA+B,QAAQ,CAAC;AAKrD,eAAO,MAAM,8BAA8B,QAAQ,CAAC;AAOpD,eAAO,MAAM,wBAAwB,QAAQ,CAAC;AAE9C;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB,OAAO,CAKT;AAED,eAAO,MAAM,kBAAkB,QACkB,CAAC;AAElD,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAC5C,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,+BAA+B,IAAI,CAAC;AAMjD,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAyBxD,CAAC;AAEF,eAAO,MAAM,wBAAwB,oDACc,CAAC"}

package/dist/types/websocket/listener/cwd-change.d.ts

@@ -0,0 +1,21 @@
+import type { ListenerTransport } from "./transport";
+import type { ConversationRuntime, ListenerRuntime } from "./types";
+export declare function switchCurrentRuntimeWorkingDirectory(workingDirectory: string): Promise<void>;
+/**
+ * Updates a captured tool execution context so tool calls later in the SAME
+ * turn resolve the new working directory. Turns bake their cwd into the
+ * prepared execution context at turn start; without this, an in-flight turn
+ * keeps running tools in the previous directory after a cwd switch.
+ */
+export declare function updateToolExecutionContextCwd(executionContextId: string | undefined, workingDirectory: string): Promise<void>;
+export declare function switchConversationWorkingDirectory(params: {
+    runtime: ListenerRuntime;
+    agentId: string | null;
+    conversationId: string;
+    workingDirectory: string;
+    emitStatus?: boolean;
+    statusRuntime?: ConversationRuntime | ListenerRuntime;
+    statusSocket?: ListenerTransport;
+    updateCurrentRuntimeContext?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=cwd-change.d.ts.map

package/dist/types/websocket/listener/cwd-change.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cwd-change.d.ts","sourceRoot":"","sources":["../../../../src/websocket/listener/cwd-change.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAWpE,wBAAsB,oCAAoC,CACxD,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;;;GAKG;AACH,wBAAsB,6BAA6B,CACjD,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,wBAAsB,kCAAkC,CAAC,MAAM,EAAE;IAC/D,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,mBAAmB,GAAG,eAAe,CAAC;IACtD,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACvC,GAAG,OAAO,CAAC,IAAI,CAAC,CA6ChB"}

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

@@ -0,0 +1,22 @@
+import type { ListenerRuntime } from "./types";
+export declare function getWorkingDirectoryScopeKey(agentId?: string | null, conversationId?: string | null): string;
+export declare function getConversationWorkingDirectory(runtime: ListenerRuntime, agentId?: string | null, conversationId?: string | null): string;
+/**
+ * Repair a boot cwd that disappeared while the listener was running. This can
+ * happen when Desktop renames/deletes its default folder or when the directory
+ * is changed externally. Runtime-context fallback resolution avoids returning
+ * a path that would surface ENOENT/ENOTDIR to a user turn.
+ */
+export declare function getBootWorkingDirectory(runtime: ListenerRuntime): string;
+export declare function pruneStaleConversationWorkingDirectories(runtime: ListenerRuntime): boolean;
+export declare function bumpWorkingDirectoryRevision(runtime: ListenerRuntime): number;
+export declare function getExportedCwdMap(runtime: ListenerRuntime): Record<string, string>;
+/**
+ * @deprecated - the legacy path is only read for one-time migration in remote-settings.ts
+ */
+export declare function getCwdCachePath(): string;
+export declare function loadPersistedCwdMap(): Map<string, string>;
+export declare function persistCwdMap(map: Map<string, string>): void;
+export declare function setConversationWorkingDirectory(runtime: ListenerRuntime, agentId: string | null, conversationId: string, workingDirectory: string): void;
+export declare function seedConversationWorkingDirectory(runtime: ListenerRuntime, agentId: string | null, conversationId: string, workingDirectory: string): boolean;
+//# sourceMappingURL=cwd.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cwd.d.ts","sourceRoot":"","sources":["../../../../src/websocket/listener/cwd.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,wBAAgB,2BAA2B,CACzC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,EACvB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAC7B,MAAM,CAQR;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,EACvB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAC7B,MAAM,CAoBR;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAWxE;AAED,wBAAgB,wCAAwC,CACtD,OAAO,EAAE,eAAe,GACvB,OAAO,CAqBT;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAI7E;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,eAAe,GACvB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIxB;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAMxC;AAED,wBAAgB,mBAAmB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAazD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAE5D;AAMD,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,MAAM,GACvB,IAAI,CAWN;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAiBT"}

package/dist/types/websocket/listener/device-status-cache.d.ts

@@ -0,0 +1,10 @@
+import type { DeviceStatus } from "../../types/protocol_v2";
+import type { ListenerTransport } from "./transport";
+type DeviceStatusScope = {
+    agent_id?: string | null;
+    conversation_id?: string | null;
+};
+export declare function recordDeviceStatus(transport: ListenerTransport, scope: DeviceStatusScope, status: DeviceStatus): void;
+export declare function shouldEmitDeviceStatus(transport: ListenerTransport, scope: DeviceStatusScope, status: DeviceStatus, force?: boolean): boolean;
+export {};
+//# sourceMappingURL=device-status-cache.d.ts.map

package/dist/types/websocket/listener/device-status-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-status-cache.d.ts","sourceRoot":"","sources":["../../../../src/websocket/listener/device-status-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,KAAK,iBAAiB,GAAG;IACvB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAQF,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,YAAY,GACnB,IAAI,CAEN;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,YAAY,EACpB,KAAK,UAAQ,GACZ,OAAO,CAaT"}

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

@@ -0,0 +1,9 @@
+/**
+ * Commands that can be dispatched by a remote client (e.g. letta-cloud desktop)
+ * via the `execute_command` WebSocket message type.
+ *
+ * Kept in a standalone file to avoid circular imports between commands.ts
+ * and protocol-outbound.ts.
+ */
+export declare const SUPPORTED_REMOTE_COMMANDS: readonly string[];
+//# sourceMappingURL=listener-constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"listener-constants.d.ts","sourceRoot":"","sources":["../../../../src/websocket/listener/listener-constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAetD,CAAC"}

package/dist/types/websocket/listener/memfs-sync.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Lazy memfs sync for listen mode.
+ *
+ * When the listener receives the first message for an agent, this module
+ * checks whether the agent has the `git-memory-enabled` tag and, if so,
+ * clones or pulls the memory repo so the Memory tool and $MEMORY_DIR work
+ * correctly — mirroring what the local headless path does during bootstrap.
+ */
+import type { ListenerRuntime } from "./types";
+/**
+ * Ensure the memfs git repo is cloned/pulled for the given agent.
+ *
+ * No-ops if:
+ * - The agent was already synced this session
+ * - The agent doesn't have the `git-memory-enabled` tag
+ *
+ * Concurrent callers for the same agent coalesce onto a single in-flight
+ * promise so turn ordering stays deterministic.
+ *
+ * Non-fatal: logs a warning and returns false on failure so source consumers
+ * do not read a stale checkout.
+ */
+export declare function ensureMemfsSyncedForAgent(listener: ListenerRuntime, agentId: string): Promise<boolean>;
+//# sourceMappingURL=memfs-sync.d.ts.map

package/dist/types/websocket/listener/memfs-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memfs-sync.d.ts","sourceRoot":"","sources":["../../../../src/websocket/listener/memfs-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAiE/C;;;;;;;;;;;;GAYG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAsBlB"}

package/dist/types/websocket/listener/mod-adapter.d.ts

@@ -0,0 +1,48 @@
+import type { ModEvents } from "../../mods/event-emitter";
+import { type ModAdapter } from "../../mods/mod-adapter";
+import type { ModCapabilities, ModContext } from "../../mods/types";
+import { ensureMemfsSyncedForAgent } from "./memfs-sync";
+import type { ListenerRuntime } from "./types";
+export declare const LISTENER_MOD_CAPABILITIES: ModCapabilities;
+export interface CreateListenerModAdapterOptions {
+    agentModsDirectory?: string;
+    cacheDirectory?: string;
+    capabilities?: ModCapabilities;
+    diagnosticsRootDirectory?: string;
+    disabled?: boolean;
+    globalModsDirectory?: string;
+    includeGlobalMods?: boolean;
+    registerCapabilitiesGlobally?: boolean;
+    sessionId?: string | null;
+    workingDirectory?: string | null;
+}
+export declare function createListenerModContext(options?: Pick<CreateListenerModAdapterOptions, "sessionId" | "workingDirectory"> & {
+    agent?: {
+        id: string;
+        name?: string | null;
+        model?: string | null;
+        llm_config?: {
+            model?: string | null;
+            model_endpoint_type?: string | null;
+            reasoning_effort?: string | null;
+        } | null;
+    } | null;
+    modelIdentifier?: string | null;
+    permissionMode?: string | null;
+    toolset?: string | null;
+}): ModContext;
+export declare function createListenerModAdapter(options?: CreateListenerModAdapterOptions): ModAdapter;
+export declare function ensureListenerModAdapter(runtime: ListenerRuntime): ModAdapter;
+export declare function ensureListenerAgentModAdapter(runtime: ListenerRuntime, agentId: string): Promise<ModAdapter | null>;
+export declare function ensureListenerModAdaptersForAgent(runtime: ListenerRuntime, agentId: string): Promise<ModAdapter[]>;
+export declare function getLoadedListenerModAdapters(runtime: ListenerRuntime, agentId?: string | null): ModAdapter[];
+export declare function createListenerModEvents(adapters: ModAdapter[]): ModEvents;
+export declare function reloadListenerModAdapter(runtime: ListenerRuntime, agentId?: string | null): Promise<void>;
+export declare const __listenerModAdapterTestUtils: {
+    setAgentModsDirectoryResolverForTests(resolver: (agentId: string) => string | null): void;
+    setAgentModCacheDirectoryResolverForTests(resolver: (agentId: string) => string): void;
+    setEnsureMemfsSyncedForAgentForTests(ensureSynced: typeof ensureMemfsSyncedForAgent): void;
+    resetForTests(): void;
+};
+export declare function disposeListenerModAdapter(runtime: ListenerRuntime): void;
+//# sourceMappingURL=mod-adapter.d.ts.map

package/dist/types/websocket/listener/mod-adapter.d.ts.map

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

package/dist/types/websocket/listener/mod-commands.d.ts

@@ -0,0 +1,23 @@
+import type { ModCommand, ModCommandResult } from "../../mods/types";
+import type { ModCommandInfo } from "../../types/protocol_v2";
+import type { ConversationRuntime, ListenerRuntime } from "./types";
+/**
+ * Registered mod commands as advertisable facts. Clients read these to surface
+ * mod commands in their palette by their own policy (separate from the built-in
+ * `supported_commands` allowlist).
+ */
+export declare function listListenerModCommands(runtime: ListenerRuntime, agentId?: string | null): ModCommandInfo[];
+/** Look up a registered mod command by id, if any. */
+export declare function getListenerModCommand(runtime: ListenerRuntime, commandId: string, agentId?: string | null): ModCommand | undefined;
+/**
+ * Run a mod command in the listener and return its result. Builds a
+ * ModCommandContext that mirrors the TUI command path (createModConversationHandle
+ * with the shared sendMessageStreamWithBackend so fork/send/updateLlmConfig work
+ * across local and Letta Cloud backends).
+ */
+export declare function runListenerModCommand(conversationRuntime: ConversationRuntime, modCommand: ModCommand, parsed: {
+    commandId: string;
+    args: string;
+    rawInput: string;
+}): Promise<ModCommandResult>;
+//# sourceMappingURL=mod-commands.d.ts.map

package/dist/types/websocket/listener/mod-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod-commands.d.ts","sourceRoot":"","sources":["../../../../src/websocket/listener/mod-commands.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,UAAU,EAEV,gBAAgB,EACjB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAO1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEpE;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,cAAc,EAAE,CAclB;AAED,sDAAsD;AACtD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,UAAU,GAAG,SAAS,CAMxB;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,mBAAmB,EAAE,mBAAmB,EACxC,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC5D,OAAO,CAAC,gBAAgB,CAAC,CAuC3B"}