@letta-ai/letta-code 0.30.2 → 0.30.3

package/dist/types/cli/helpers/stream.d.ts

@@ -0,0 +1,75 @@
+import type { Stream } from "@letta-ai/letta-client/core/streaming";
+import type { LettaStreamingResponse, Run } from "@letta-ai/letta-client/resources/agents/messages";
+import type { StopReasonType } from "@letta-ai/letta-client/resources/runs/runs";
+import { type StreamRequestContext } from "../../agent/message";
+import { type createBuffers } from "./accumulator";
+import type { ContextTracker } from "./context-tracker";
+import type { ErrorInfo } from "./stream-processor";
+import { StreamProcessor } from "./stream-processor";
+export type ApprovalRequest = {
+    toolCallId: string;
+    toolName: string;
+    toolArgs: string;
+};
+export type DrainStreamHookContext = {
+    chunk: LettaStreamingResponse;
+    shouldOutput: boolean;
+    errorInfo?: ErrorInfo;
+    updatedApproval?: ApprovalRequest;
+    streamProcessor: StreamProcessor;
+};
+export type DrainStreamHookResult = {
+    shouldOutput?: boolean;
+    shouldAccumulate?: boolean;
+    stopReason?: StopReasonType;
+};
+export type DrainStreamHook = (ctx: DrainStreamHookContext) => DrainStreamHookResult | undefined | Promise<DrainStreamHookResult | undefined>;
+export type DrainResult = {
+    stopReason: StopReasonType;
+    sawStopReasonChunk?: boolean;
+    lastRunId?: string | null;
+    lastSeqId?: number | null;
+    approval?: ApprovalRequest | null;
+    approvals?: ApprovalRequest[];
+    apiDurationMs: number;
+    fallbackError?: string | null;
+};
+type RunsListResponse = Run[] | {
+    getPaginatedItems?: () => Run[];
+};
+type RunsListClient = {
+    runs: {
+        list: (query: {
+            conversation_id?: string | null;
+            agent_id?: string | null;
+            statuses?: string[] | null;
+            order?: string | null;
+            limit?: number | null;
+        }) => Promise<RunsListResponse>;
+    };
+};
+export declare function discoverFallbackRunIdWithTimeout(client: RunsListClient, ctx: StreamRequestContext): Promise<string | null>;
+/**
+ * Attempt to discover a run ID to resume when the initial stream failed before
+ * any run_id-bearing chunk arrived.
+ */
+export declare function discoverFallbackRunIdForResume(client: RunsListClient, ctx: StreamRequestContext): Promise<string | null>;
+export declare function drainStream(stream: Stream<LettaStreamingResponse>, buffers: ReturnType<typeof createBuffers>, refresh: () => void, abortSignal?: AbortSignal, onFirstMessage?: () => void, onChunkProcessed?: DrainStreamHook, contextTracker?: ContextTracker, seenSeqIdThreshold?: number | null, isResumeStream?: boolean, skipCancelToolsOnError?: boolean): Promise<DrainResult>;
+/**
+ * Drain a stream with automatic resume on disconnect.
+ *
+ * If the stream ends without receiving a proper stop_reason chunk (indicating
+ * an unexpected disconnect), this will automatically attempt to resume from
+ * Redis using the last received run_id and seq_id.
+ *
+ * @param stream - Initial stream from agent.messages.stream()
+ * @param buffers - Buffer to accumulate chunks
+ * @param refresh - Callback to refresh UI
+ * @param abortSignal - Optional abort signal for cancellation
+ * @param onFirstMessage - Optional callback to invoke on first message chunk
+ * @param onChunkProcessed - Optional hook to observe/override per-chunk behavior
+ * @returns Result with stop_reason, approval info, and timing
+ */
+export declare function drainStreamWithResume(stream: Stream<LettaStreamingResponse>, buffers: ReturnType<typeof createBuffers>, refresh: () => void, abortSignal?: AbortSignal, onFirstMessage?: () => void, onChunkProcessed?: DrainStreamHook, contextTracker?: ContextTracker, seenSeqIdThreshold?: number | null): Promise<DrainResult>;
+export {};
+//# sourceMappingURL=stream.d.ts.map

package/dist/types/cli/helpers/stream.d.ts.map

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

package/dist/types/cli/helpers/system-prompt-warning.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Startup system prompt warning
+ * Uses same heuristic as context-doctor to estimate system prompt token count on startup
+ */
+import type { AgentState } from "@letta-ai/letta-client/resources/agents/agents";
+import { estimateSystemPromptTokensFromMemoryDir, estimateSystemTokens } from "../../utils/system-prompt-size";
+export { estimateSystemPromptTokensFromMemoryDir, estimateSystemTokens };
+export interface SystemPromptDoctorState {
+    estimated_tokens: number;
+    should_doctor: boolean;
+    updated_at_ms: number;
+}
+export declare function setSystemPromptDoctorState(agentId: string, estimatedTokens: number): SystemPromptDoctorState;
+export declare function getSystemPromptDoctorState(agentId: string): SystemPromptDoctorState | null;
+export declare function refreshSystemPromptDoctorState(agentId: string, agentState: AgentState | null | undefined): SystemPromptDoctorState | null;
+/** On LC CLI startup, display a warning if the system prompt is large. */
+export declare function buildStartupSystemPromptWarning(agentState: AgentState | null | undefined): string | null;
+//# sourceMappingURL=system-prompt-warning.d.ts.map

package/dist/types/cli/helpers/system-prompt-warning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt-warning.d.ts","sourceRoot":"","sources":["../../../../src/cli/helpers/system-prompt-warning.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gDAAgD,CAAC;AAIjF,OAAO,EACL,uCAAuC,EACvC,oBAAoB,EACrB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,uCAAuC,EAAE,oBAAoB,EAAE,CAAC;AAIzE,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AAOD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,GACtB,uBAAuB,CASzB;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,GACd,uBAAuB,GAAG,IAAI,CAEhC;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,GACxC,uBAAuB,GAAG,IAAI,CA2BhC;AAED,0EAA0E;AAC1E,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,GACxC,MAAM,GAAG,IAAI,CAYf"}

package/dist/types/cli/helpers/tool-name-mapping.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Tool name mapping utilities for display purposes.
+ * Centralizes tool name remapping logic used across the UI.
+ */
+/**
+ * Maps internal tool names to user-friendly display names.
+ * Handles multiple tool naming conventions:
+ * - Anthropic toolset (snake_case and camelCase)
+ * - Codex toolset (snake_case and PascalCase)
+ * - Gemini toolset (snake_case and PascalCase)
+ */
+export declare function getDisplayToolName(rawName: string): string;
+/**
+ * Checks if a tool name represents a Task/subagent tool
+ */
+export declare function isTaskTool(name: string): boolean;
+/**
+ * Checks if a tool name represents a TODO/planning tool
+ */
+export declare function isTodoTool(rawName: string, displayName?: string): boolean;
+/**
+ * Checks if a tool name is part of the Task* CRUD family
+ * (TaskCreate / TaskGet / TaskList / TaskUpdate).
+ */
+export declare function isTaskCrudTool(rawName: string): boolean;
+/**
+ * Checks if a tool name represents a plan update tool
+ */
+export declare function isPlanTool(rawName: string, displayName?: string): boolean;
+/**
+ * Checks if a tool requires specialized inline UI instead of generic approval
+ * rendering. File edit/write/patch tools and shell tools use their own views.
+ */
+export declare function isFancyUITool(name: string): boolean;
+/**
+ * Checks if a tool always requires user interaction, even in unrestricted mode.
+ * These are tools that fundamentally need user input to proceed:
+ * - AskUserQuestion: needs user to answer questions
+ *
+ * Other tools (bash, file edits) should respect unrestricted mode and auto-approve.
+ */
+export declare function alwaysRequiresUserInput(name: string): boolean;
+/**
+ * Checks if a tool is a memory tool (server-side memory management)
+ */
+export declare function isMemoryTool(name: string): boolean;
+/**
+ * Checks if a tool is a file edit tool (has old_string/new_string args)
+ */
+export declare function isFileEditTool(name: string): boolean;
+/**
+ * Checks if a tool is a file write tool (has file_path/content args)
+ */
+export declare function isFileWriteTool(name: string): boolean;
+/**
+ * Checks if a tool is a file read tool (has file_path arg)
+ */
+export declare function isFileReadTool(name: string): boolean;
+/**
+ * Checks if a tool is a patch tool (applies unified diffs)
+ */
+export declare function isPatchTool(name: string): boolean;
+/**
+ * Checks if a tool is a shell/bash tool
+ */
+export declare function isShellTool(name: string): boolean;
+/**
+ * Checks if a tool should use shell-style streaming output rendering.
+ * Includes shell command tools plus TaskOutput/BashOutput pollers.
+ */
+export declare function isShellOutputTool(name: string): boolean;
+/**
+ * Checks if a tool is a search/grep tool
+ */
+export declare function isSearchTool(name: string): boolean;
+/**
+ * Checks if a tool is web search.
+ */
+export declare function isWebSearchTool(name: string | undefined): boolean;
+/**
+ * Checks if a tool is a glob tool
+ */
+export declare function isGlobTool(name: string): boolean;
+//# sourceMappingURL=tool-name-mapping.d.ts.map

package/dist/types/cli/helpers/tool-name-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-name-mapping.d.ts","sourceRoot":"","sources":["../../../../src/cli/helpers/tool-name-mapping.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsE1D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAIhD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAQzE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAOvD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAMzE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAUnD;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CASpD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CASrD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAapD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAYjD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CASlD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEjE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOhD"}

package/dist/types/cli/helpers/unified-exec-output.d.ts

@@ -0,0 +1,10 @@
+export declare function extractUnifiedExecRunningSessionId(text: string): string | null;
+/**
+ * Codex unified exec returns model-facing metadata before the actual command
+ * output. The TUI shell renderer should stay focused on what the command
+ * printed, while preserving non-zero exits and running session status.
+ */
+export declare function formatUnifiedExecOutputForTui(text: string, options?: {
+    hideEmptyCompletion?: boolean;
+}): string;
+//# sourceMappingURL=unified-exec-output.d.ts.map

package/dist/types/cli/helpers/unified-exec-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified-exec-output.d.ts","sourceRoot":"","sources":["../../../../src/cli/helpers/unified-exec-output.ts"],"names":[],"mappings":"AAuCA,wBAAgB,kCAAkC,CAChD,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,IAAI,CAEf;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1C,MAAM,CAiCR"}

package/dist/types/cli/helpers/zai-errors.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Z.ai-specific error detection, parsing, and formatting.
+ *
+ * Z.ai is an upstream LLM provider using the OpenAI-compatible API.
+ * Errors arrive wrapped in generic "OpenAI" error messages from the server's
+ * openai_client.py. This module extracts Z.ai's own error codes and presents
+ * clear, actionable messages attributed to Z.ai.
+ *
+ * Z.ai error code ranges:
+ *   1000-1004  Auth (authentication failed, token expired, invalid token)
+ *   1100-1121  Account (inactive, locked, arrears, irregular activity)
+ *   1200-1234  API call (invalid params, unsupported model, permissions, network)
+ *   1300-1310  Rate/policy (content filtered, rate limit, quota, subscription expired)
+ *   500        Internal server error
+ */
+/**
+ * Parse a Z.ai error from an error detail string.
+ * Returns the extracted code and message, or null if not a Z.ai error.
+ */
+export declare function parseZaiError(text: string): {
+    code: number;
+    message: string;
+} | null;
+/**
+ * Format a Z.ai error code and message into a user-friendly string.
+ */
+export declare function formatZaiError(code: number, message: string): string;
+/**
+ * Check if an error string contains a Z.ai error. If so, return a formatted
+ * user-friendly message; otherwise return undefined.
+ */
+export declare function checkZaiError(errorText: string): string | undefined;
+/**
+ * Returns true if the error detail contains a Z.ai error code in ranges that
+ * should not be retried (auth, account, rate/policy).
+ */
+export declare function isZaiNonRetryableError(detail: string): boolean;
+//# sourceMappingURL=zai-errors.d.ts.map

package/dist/types/cli/helpers/zai-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zai-errors.d.ts","sourceRoot":"","sources":["../../../../src/cli/helpers/zai-errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAkBH;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAW1C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAiBpE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAInE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAS9D"}

package/dist/types/cli/mods/command-runtime.d.ts

@@ -0,0 +1,13 @@
+import type { ModCommand, ModCommandContext, ModCommandResult } from "./types";
+export declare function parseModSlashCommand(trimmed: string): {
+    command: string;
+    args: string;
+} | null;
+export declare function parseModCommandArgv(args: string): string[];
+export declare function normalizeModCommandResult(result: unknown): ModCommandResult;
+export declare function buildModCommandPrompt(result: {
+    content: string;
+    systemReminder?: boolean;
+}): string;
+export declare function runModCommandWithTimeout(command: ModCommand, context: ModCommandContext): Promise<ModCommandResult>;
+//# sourceMappingURL=command-runtime.d.ts.map

package/dist/types/cli/mods/command-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-runtime.d.ts","sourceRoot":"","sources":["../../../../src/cli/mods/command-runtime.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAI/E,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,IAAI,CAUP;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAkD1D;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAyC3E;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG,MAAM,CAKT;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAuC3B"}

package/dist/types/cli/mods/types.d.ts

@@ -0,0 +1,2 @@
+export type { ModAgentContext, ModBackgroundAgentContext, ModCapabilities, ModCapabilityKind, ModCapabilityRecord, ModCommand, ModCommandContext, ModCommandRegistration, ModCommandResult, ModContext, ModContextWindowContext, ModConversationCloseEvent, ModConversationCloseReason, ModConversationForkOptions, ModConversationHandle, ModConversationHistoryOptions, ModConversationMessage, ModConversationOpenEvent, ModConversationOpenReason, ModConversationSendMessageOptions, ModConversationSendMessageRequestOptions, ModCostContext, ModDiagnostic, ModDiagnosticPhase, ModEventCapabilities, ModEventContext, ModEventEmissionResult, ModEventHandler, ModEventMap, ModEventName, ModEventRegistration, ModEventResultMap, ModMemfsContext, ModModelContext, ModOwner, ModPanel, ModPanelHandle, ModPanelOptions, ModPanelRender, ModPanelRenderContext, ModReflectionContext, ModSourceScope, ModTokenUsageContext, ModTool, ModToolContent, ModToolContentImage, ModToolContentText, ModToolRegistration, ModToolRunContext, ModToolRunResult, ModToolStartEvent, ModToolStartResult, ModTurnStartEvent, ModTurnStartResult, ModUiCapabilities, ModWorkspaceContext, } from "../../mods/types";
+//# sourceMappingURL=types.d.ts.map

package/dist/types/cli/mods/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/cli/mods/types.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,yBAAyB,EACzB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,UAAU,EACV,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,UAAU,EACV,uBAAuB,EACvB,yBAAyB,EACzB,0BAA0B,EAC1B,0BAA0B,EAC1B,qBAAqB,EACrB,6BAA6B,EAC7B,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,iCAAiC,EACjC,wCAAwC,EACxC,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,OAAO,EACP,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,cAAc,CAAC"}

package/dist/types/experiments/manager.d.ts

@@ -0,0 +1,12 @@
+import type { ExperimentId, ExperimentSnapshot } from "./types";
+declare class ExperimentManager {
+    private getStoredOverrides;
+    list(): ExperimentSnapshot[];
+    getSnapshot(id: ExperimentId): ExperimentSnapshot;
+    isEnabled(id: ExperimentId): boolean;
+    set(id: ExperimentId, enabled: boolean): ExperimentSnapshot;
+    toggle(id: ExperimentId): ExperimentSnapshot;
+}
+export declare const experimentManager: ExperimentManager;
+export {};
+//# sourceMappingURL=manager.d.ts.map

package/dist/types/experiments/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/experiments/manager.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,YAAY,EACZ,kBAAkB,EACnB,MAAM,SAAS,CAAC;AA2DjB,cAAM,iBAAiB;IACrB,OAAO,CAAC,kBAAkB;IAQ1B,IAAI,IAAI,kBAAkB,EAAE;IAM5B,WAAW,CAAC,EAAE,EAAE,YAAY,GAAG,kBAAkB;IAmCjD,SAAS,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO;IAIpC,GAAG,CAAC,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,kBAAkB;IAgB3D,MAAM,CAAC,EAAE,EAAE,YAAY,GAAG,kBAAkB;CAI7C;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/dist/types/experiments/types.d.ts

@@ -0,0 +1,14 @@
+export type ExperimentId = "artifacts" | "conversation_titles" | "desktop_conversation_bootstrap" | "diffs" | "reflection_arena" | "tui_cron";
+export type ExperimentSource = "override" | "env" | "default";
+export interface ExperimentDefinition {
+    id: ExperimentId;
+    label: string;
+    description: string;
+    envVar?: string;
+}
+export interface ExperimentSnapshot extends ExperimentDefinition {
+    enabled: boolean;
+    source: ExperimentSource;
+    override: boolean | null;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/experiments/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,qBAAqB,GACrB,gCAAgC,GAChC,OAAO,GACP,kBAAkB,GAClB,UAAU,CAAC;AAEf,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,KAAK,GAAG,SAAS,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,YAAY,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1B"}

package/dist/types/gateway-core.d.ts

@@ -0,0 +1,8 @@
+export type { ChannelGatewayClient, ChannelGatewayDelivery, ChannelGatewayHooks, ChannelGatewayModelStatus, ChannelGatewayRichDraft, } from "./channels/gateway-core";
+export { CHANNEL_GATEWAY_TOOL_SCOPE_ID, ChannelGateway, } from "./channels/gateway-core";
+export type { ExecuteMessageChannelOptions, MessageChannelExecutionResolver, MessageChannelExecutionScope, ResolvedMessageChannelContext, ResolvedProactiveMessageChannelContext, } from "./channels/message-channel-executor";
+export { executeMessageChannel } from "./channels/message-channel-executor";
+export type { BuildMessageChannelToolOptions, MessageChannelToolChannel, ResolvedMessageChannelToolDefinition, } from "./channels/message-channel-tool-definition";
+export { buildMessageChannelExternalToolDefinition } from "./channels/message-channel-tool-definition";
+export type { MessageChannelInput } from "./channels/message-channel-types";
+//# sourceMappingURL=gateway-core.d.ts.map

package/dist/types/gateway-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-core.d.ts","sourceRoot":"","sources":["../../src/gateway-core.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,6BAA6B,EAC7B,cAAc,GACf,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,4BAA4B,EAC5B,+BAA+B,EAC/B,4BAA4B,EAC5B,6BAA6B,EAC7B,sCAAsC,GACvC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,YAAY,EACV,8BAA8B,EAC9B,yBAAyB,EACzB,oCAAoC,GACrC,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,yCAAyC,EAAE,MAAM,4CAA4C,CAAC;AACvG,YAAY,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/types/helpers/usable-directory.d.ts

@@ -0,0 +1,9 @@
+import { type Stats } from "node:fs";
+export type DirectoryUsability = "usable" | "missing" | "not-directory" | "unknown";
+type DirectoryStat = (dirPath: string) => Pick<Stats, "isDirectory"> | undefined;
+export declare function getDirectoryUsability(dirPath: string | null | undefined, statDirectory?: DirectoryStat): DirectoryUsability;
+export declare function isConfirmedUnusableDirectory(dirPath: string | null | undefined, statDirectory?: DirectoryStat): boolean;
+/** True when the path exists and is a directory. */
+export declare function isUsableDirectory(dirPath: string | null | undefined): boolean;
+export {};
+//# sourceMappingURL=usable-directory.d.ts.map

package/dist/types/helpers/usable-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usable-directory.d.ts","sourceRoot":"","sources":["../../../src/helpers/usable-directory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAY,MAAM,SAAS,CAAC;AAE/C,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,SAAS,GACT,eAAe,GACf,SAAS,CAAC;AAEd,KAAK,aAAa,GAAG,CACnB,OAAO,EAAE,MAAM,KACZ,IAAI,CAAC,KAAK,EAAE,aAAa,CAAC,GAAG,SAAS,CAAC;AAM5C,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAClC,aAAa,GAAE,aAAkC,GAChD,kBAAkB,CAepB;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAClC,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAGT;AAED,oDAAoD;AACpD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE7E"}

package/dist/types/hooks/executor.d.ts

@@ -0,0 +1,23 @@
+import { type CommandHookConfig, type HookCommand, type HookExecutionResult, type HookInput, type HookResult } from "./types";
+/**
+ * Execute a single hook with JSON input
+ * Dispatches to appropriate executor based on hook type:
+ * - "command": executes shell command with JSON via stdin
+ * - "prompt": sends to LLM for evaluation
+ */
+export declare function executeHookCommand(hook: HookCommand, input: HookInput, workingDirectory?: string): Promise<HookResult>;
+/**
+ * Execute a command hook with JSON input via stdin
+ * Uses cross-platform shell launchers with fallback support
+ */
+export declare function executeCommandHook(hook: CommandHookConfig, input: HookInput, workingDirectory?: string): Promise<HookResult>;
+/**
+ * Execute multiple hooks sequentially and aggregate results
+ * Stops early if any hook returns BLOCK (exit code 2)
+ */
+export declare function executeHooks(hooks: HookCommand[], input: HookInput, workingDirectory?: string): Promise<HookExecutionResult>;
+/**
+ * Execute hooks in parallel (for non-blocking hooks like PostToolUse)
+ */
+export declare function executeHooksParallel(hooks: HookCommand[], input: HookInput, workingDirectory?: string): Promise<HookExecutionResult>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/types/hooks/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/hooks/executor.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EAExB,KAAK,SAAS,EACd,KAAK,UAAU,EAGhB,MAAM,SAAS,CAAC;AAmEjB;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,SAAS,EAChB,gBAAgB,GAAE,MAAsB,GACvC,OAAO,CAAC,UAAU,CAAC,CAmBrB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,SAAS,EAChB,gBAAgB,GAAE,MAAsB,GACvC,OAAO,CAAC,UAAU,CAAC,CAyDrB;AAoKD;;;GAGG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,WAAW,EAAE,EACpB,KAAK,EAAE,SAAS,EAChB,gBAAgB,GAAE,MAAsB,GACvC,OAAO,CAAC,mBAAmB,CAAC,CAsE9B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,WAAW,EAAE,EACpB,KAAK,EAAE,SAAS,EAChB,gBAAgB,GAAE,MAAsB,GACvC,OAAO,CAAC,mBAAmB,CAAC,CAqD9B"}

package/dist/types/hooks/index.d.ts

@@ -0,0 +1,68 @@
+import type { HookEvent, HookExecutionResult } from "./types";
+export { areHooksDisabled, clearHooksCache } from "./loader";
+export * from "./types";
+/**
+ * Run PreToolUse hooks before a tool is executed
+ * Can block the tool call by returning blocked: true
+ */
+export declare function runPreToolUseHooks(toolName: string, toolInput: Record<string, unknown>, toolCallId?: string, workingDirectory?: string, agentId?: string): Promise<HookExecutionResult>;
+/**
+ * Run PostToolUse hooks after a tool has executed
+ * These run in parallel since they cannot block
+ */
+export declare function runPostToolUseHooks(toolName: string, toolInput: Record<string, unknown>, toolResult: {
+    status: "success" | "error";
+    output?: string;
+}, toolCallId?: string, workingDirectory?: string, agentId?: string, precedingReasoning?: string, precedingAssistantMessage?: string): Promise<HookExecutionResult>;
+/**
+ * Run PostToolUseFailure hooks after a tool has failed
+ * These run in parallel and cannot block (tool already failed)
+ * Stderr from hooks with exit code 2 is fed back to the agent
+ */
+export declare function runPostToolUseFailureHooks(toolName: string, toolInput: Record<string, unknown>, errorMessage: string, errorType?: string, toolCallId?: string, workingDirectory?: string, agentId?: string, precedingReasoning?: string, precedingAssistantMessage?: string): Promise<HookExecutionResult>;
+/**
+ * Run PermissionRequest hooks when a permission dialog would be shown
+ * Can auto-allow (exit 0) or auto-deny (exit 2) the permission
+ */
+export declare function runPermissionRequestHooks(toolName: string, toolInput: Record<string, unknown>, permissionType: "allow" | "deny" | "ask", scope?: "session" | "project" | "user", workingDirectory?: string, agentId?: string): Promise<HookExecutionResult>;
+/**
+ * Run UserPromptSubmit hooks before processing a user's prompt
+ * Can block the prompt from being processed
+ * Skips execution for slash commands (e.g., /help, /clear)
+ */
+export declare function runUserPromptSubmitHooks(prompt: string, isCommand: boolean, agentId?: string, conversationId?: string, workingDirectory?: string): Promise<HookExecutionResult>;
+/**
+ * Run Notification hooks when a notification is sent
+ * These run in parallel and cannot block
+ */
+export declare function runNotificationHooks(message: string, level?: "info" | "warning" | "error", workingDirectory?: string): Promise<HookExecutionResult>;
+/**
+ * Run Stop hooks when the agent finishes responding
+ * Can block stoppage (exit 2), stderr shown to model
+ */
+export declare function runStopHooks(stopReason: string, messageCount?: number, toolCallCount?: number, workingDirectory?: string, precedingReasoning?: string, assistantMessage?: string, userMessage?: string): Promise<HookExecutionResult>;
+/**
+ * Run SubagentStop hooks when a subagent task completes
+ * Can block stoppage (exit 2), stderr shown to subagent
+ */
+export declare function runSubagentStopHooks(subagentType: string, subagentId: string, success: boolean, error?: string, agentId?: string, conversationId?: string, workingDirectory?: string): Promise<HookExecutionResult>;
+/**
+ * Run PreCompact hooks before a compact operation
+ * Cannot block, stderr shown to user only
+ */
+export declare function runPreCompactHooks(contextLength?: number, maxContextLength?: number, agentId?: string, conversationId?: string, workingDirectory?: string): Promise<HookExecutionResult>;
+/**
+ * Run SessionStart hooks when a session begins
+ * Unlike other hooks, SessionStart collects stdout (not stderr) on exit 2
+ * to inject context into the first user message
+ */
+export declare function runSessionStartHooks(isNewSession: boolean, agentId?: string, agentName?: string, conversationId?: string, workingDirectory?: string): Promise<HookExecutionResult>;
+/**
+ * Run SessionEnd hooks when a session ends
+ */
+export declare function runSessionEndHooks(durationMs?: number, messageCount?: number, toolCallCount?: number, agentId?: string, conversationId?: string, workingDirectory?: string): Promise<HookExecutionResult>;
+/**
+ * Check if hooks are configured for a specific event
+ */
+export declare function hasHooks(event: HookEvent, workingDirectory?: string): Promise<boolean>;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/hooks/index.d.ts.map

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

package/dist/types/hooks/loader.d.ts

@@ -0,0 +1,63 @@
+import { type HookCommand, type HookEvent, type HooksConfig } from "./types";
+/**
+ * Clear hooks cache - kept for API compatibility with existing callers.
+ */
+export declare function clearHooksCache(): void;
+/**
+ * Load global hooks configuration from ~/.letta/settings.json
+ * Uses settings-manager cache (loaded at app startup)
+ */
+export declare function loadGlobalHooks(): HooksConfig;
+/**
+ * Load project hooks configuration from .letta/settings.json
+ * Uses settings-manager cache
+ */
+export declare function loadProjectHooks(workingDirectory?: string): Promise<HooksConfig>;
+/**
+ * Load project-local hooks configuration from .letta/settings.local.json
+ * Uses settings-manager cache
+ */
+export declare function loadProjectLocalHooks(workingDirectory?: string): Promise<HooksConfig>;
+/**
+ * Merge hooks configurations
+ * Priority order: project-local > project > global
+ * For each event, hooks are ordered by priority (local first, global last)
+ */
+export declare function mergeHooksConfigs(global: HooksConfig, project: HooksConfig, projectLocal?: HooksConfig): HooksConfig;
+/**
+ * Load merged hooks configuration (global + project + project-local)
+ */
+export declare function loadHooks(workingDirectory?: string): Promise<HooksConfig>;
+/**
+ * Check if a tool name matches a matcher pattern
+ * Patterns:
+ * - "*" or "": matches all tools
+ * - "ToolName": exact match (simple alphanumeric strings)
+ * - "Edit|Write": regex alternation, matches Edit or Write
+ * - "Notebook.*": regex pattern, matches Notebook, NotebookEdit, etc.
+ * - Any valid regex pattern is supported (case-sensitive)
+ */
+export declare function matchesTool(pattern: string, toolName: string): boolean;
+/**
+ * Get all hooks that match a specific event and tool name
+ */
+export declare function getMatchingHooks(config: HooksConfig, event: HookEvent, toolName?: string): HookCommand[];
+/**
+ * Check if there are any hooks configured for a specific event
+ */
+export declare function hasHooksForEvent(config: HooksConfig, event: HookEvent): boolean;
+/**
+ * Check if all hooks are disabled via hooks.disabled across settings levels.
+ *
+ * Precedence:
+ * 1. If user has disabled: false → ENABLED (explicit user override)
+ * 2. If user has disabled: true → DISABLED
+ * 3. If project OR project-local has disabled: true → DISABLED
+ * 4. Default → ENABLED
+ */
+export declare function areHooksDisabled(workingDirectory?: string): boolean;
+/**
+ * Convenience function to load hooks and get matching ones for an event
+ */
+export declare function getHooksForEvent(event: HookEvent, toolName?: string, workingDirectory?: string): Promise<HookCommand[]>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/types/hooks/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/hooks/loader.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,SAAS,EAEd,KAAK,WAAW,EAOjB,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAqBD;;;GAGG;AACH,wBAAgB,eAAe,IAAI,WAAW,CAQ7C;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,gBAAgB,GAAE,MAAsB,GACvC,OAAO,CAAC,WAAW,CAAC,CAmBtB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,gBAAgB,GAAE,MAAsB,GACvC,OAAO,CAAC,WAAW,CAAC,CAgBtB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,WAAW,EACpB,YAAY,GAAE,WAAgB,GAC7B,WAAW,CAwCb;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,gBAAgB,GAAE,MAAsB,GACvC,OAAO,CAAC,WAAW,CAAC,CAQtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAmBtE;AA6BD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,SAAS,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,WAAW,EAAE,CAgCf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,SAAS,GACf,OAAO,CAsBT;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,gBAAgB,GAAE,MAAsB,GACvC,OAAO,CAoDT;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,SAAS,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,gBAAgB,GAAE,MAAsB,GACvC,OAAO,CAAC,WAAW,EAAE,CAAC,CAQxB"}

package/dist/types/hooks/prompt-executor.d.ts

@@ -0,0 +1,7 @@
+import { type HookInput, type HookResult, type PromptHookConfig } from "./types";
+/**
+ * Execute a prompt-based hook by sending the hook input to an LLM
+ * via the POST /v1/agents/{agent_id}/generate endpoint.
+ */
+export declare function executePromptHook(hook: PromptHookConfig, input: HookInput, _workingDirectory?: string): Promise<HookResult>;
+//# sourceMappingURL=prompt-executor.d.ts.map

package/dist/types/hooks/prompt-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-executor.d.ts","sourceRoot":"","sources":["../../../src/hooks/prompt-executor.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,UAAU,EAEf,KAAK,gBAAgB,EAEtB,MAAM,SAAS,CAAC;AAmJjB;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,SAAS,EAChB,iBAAiB,GAAE,MAAsB,GACxC,OAAO,CAAC,UAAU,CAAC,CAqErB"}