@letta-ai/letta-code 0.30.2 → 0.30.4

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

@@ -0,0 +1,267 @@
+export type TelemetrySurface = "letta_code_tui" | "letta_code_headless" | "letta_code_cli_server" | "letta_code_desktop";
+export type TelemetryBackend = "cloud" | "local" | "docker_deprecated" | "self_hosted_api" | "unknown";
+export interface TelemetryInitOptions {
+    handleSigint?: boolean;
+}
+export interface TelemetryEvent {
+    type: "session_start" | "session_end" | "tool_usage" | "error" | "user_input" | "reflection_start" | "reflection_end" | "reflection_arena_vote";
+    timestamp: string;
+    data: Record<string, unknown>;
+}
+export interface SessionStartData {
+    startup_command: string;
+    version: string;
+    platform: string;
+    node_version: string;
+}
+export interface SessionEndData {
+    duration: number;
+    message_count: number;
+    tool_call_count: number;
+    exit_reason?: string;
+    total_api_ms?: number;
+    total_wall_ms?: number;
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    total_tokens?: number;
+    cached_input_tokens?: number;
+    cached_tokens?: number;
+    cache_write_tokens?: number;
+    reasoning_tokens?: number;
+    context_tokens?: number;
+    step_count?: number;
+}
+export interface ToolUsageData {
+    tool_name: string;
+    success: boolean;
+    duration: number;
+    response_length?: number;
+    error_type?: string;
+    stderr?: string;
+}
+export interface ErrorData {
+    error_type: string;
+    error_message: string;
+    context?: string;
+    http_status?: number;
+    model_id?: string;
+    run_id?: string;
+    recent_chunks?: Record<string, unknown>[];
+    debug_log_tail?: string;
+}
+export interface UserInputData {
+    input_length: number;
+    is_command: boolean;
+    command_name?: string;
+    message_type: string;
+    model_id: string;
+}
+export type ReflectionTriggerSource = "manual" | "step-count" | "compaction-event";
+export interface ReflectionStartData {
+    trigger_source: ReflectionTriggerSource;
+    subagent_id?: string;
+    conversation_id?: string;
+    start_message_id?: string;
+    end_message_id?: string;
+    model?: string;
+    version?: string;
+    platform?: string;
+}
+export interface ReflectionEndData {
+    trigger_source: ReflectionTriggerSource;
+    success: boolean;
+    subagent_id?: string;
+    conversation_id?: string;
+    error?: string;
+    step_count?: number;
+    duration_ms?: number;
+    model?: string;
+    version?: string;
+    platform?: string;
+}
+export interface ReflectionArenaVoteData {
+    run_id: string;
+    choice: "win_loss" | "tie";
+    winner: string | null;
+    loser: string | null;
+    winner_agent_id: string | null;
+    loser_agent_id: string | null;
+    parent_agent_id: string;
+    parent_convo_id: string;
+    timestamp: string;
+    feedbackstr: string | null;
+    lc_version: string;
+    memory_base_commit: string | null;
+    memory_candidate_commit: string | null;
+    transcript_payload: string | null;
+    transcript_payload_chars: number | null;
+    transcript_payload_truncated: boolean;
+    version?: string;
+    platform?: string;
+}
+export declare function isLettaCodeDesktopRuntime(env?: NodeJS.ProcessEnv): boolean;
+export declare function getTerminalTelemetrySurface(isHeadless: boolean): TelemetrySurface;
+export declare function getListenerTelemetrySurface(env?: NodeJS.ProcessEnv): TelemetrySurface;
+export declare function resolveTelemetryBackend(options?: {
+    env?: NodeJS.ProcessEnv;
+    serverUrl?: string | null;
+}): TelemetryBackend;
+declare class TelemetryManager {
+    private events;
+    private sessionId;
+    private deviceId;
+    private currentAgentId;
+    private surface;
+    private sessionStartTime;
+    private messageCount;
+    private toolCallCount;
+    private sessionEndTracked;
+    private initialized;
+    private flushInterval;
+    private serverVersion;
+    /** Deduplicates concurrent flushes (prevents the 429 double-flush race on shutdown). */
+    private inflightFlush;
+    private resolveTelemetryApiKey;
+    private getTelemetryDeviceId;
+    private readonly FLUSH_INTERVAL_MS;
+    private readonly MAX_BATCH_SIZE;
+    /** Max time to drain queued events on exit (bounded so we never hang the shell). */
+    private readonly DRAIN_TIMEOUT_MS;
+    private sessionStatsGetter?;
+    constructor();
+    private generateSessionId;
+    /**
+     * Check if telemetry is enabled based on environment variables.
+     * Enabled by default unless explicitly disabled.
+     */
+    private isTelemetryEnabled;
+    /**
+     * Check if the user is connected to Letta Cloud (api.letta.com)
+     */
+    private isCloudUser;
+    /**
+     * Initialize telemetry and start periodic flushing
+     */
+    init(options?: TelemetryInitOptions): void;
+    /**
+     * Track a telemetry event
+     */
+    private track;
+    /**
+     * Set the current agent ID (called from App.tsx when agent changes)
+     * This is automatically added to all telemetry events
+     */
+    setCurrentAgentId(agentId: string | null): void;
+    setSurface(surface: TelemetrySurface): void;
+    /**
+     * Fetch and cache server version from /v1/health (fire-and-forget, best-effort)
+     */
+    fetchServerVersion(): Promise<void>;
+    getServerVersion(): string | null;
+    /**
+     * Set a getter function for session stats (called from App.tsx)
+     * This allows safety net handlers to access stats even if not explicitly passed
+     * Pass undefined to clear the getter (for cleanup)
+     */
+    setSessionStatsGetter(getter?: () => {
+        totalWallMs: number;
+        totalApiMs: number;
+        usage: {
+            promptTokens: number;
+            completionTokens: number;
+            totalTokens: number;
+            cachedInputTokens: number;
+            cacheWriteTokens: number;
+            reasoningTokens: number;
+            contextTokens?: number;
+            stepCount: number;
+        };
+    }): void;
+    /**
+     * Get the current session ID
+     */
+    getSessionId(): string;
+    /**
+     * Get the current message count
+     */
+    getMessageCount(): number;
+    /**
+     * Get the current tool call count
+     */
+    getToolCallCount(): number;
+    /**
+     * Track session start
+     */
+    trackSessionStart(): void;
+    /**
+     * Track session end
+     * @param stats Optional session stats (from sessionStatsRef.current.getSnapshot() in App.tsx)
+     * @param exitReason Optional reason for exit (e.g., "exit_command", "logout", "sigint", "process_exit")
+     */
+    trackSessionEnd(stats?: {
+        totalWallMs: number;
+        totalApiMs: number;
+        usage: {
+            promptTokens: number;
+            completionTokens: number;
+            totalTokens: number;
+            cachedInputTokens: number;
+            cacheWriteTokens: number;
+            reasoningTokens: number;
+            contextTokens?: number;
+            stepCount: number;
+        };
+    }, exitReason?: string): void;
+    /**
+     * Track tool usage
+     */
+    trackToolUsage(toolName: string, success: boolean, duration: number, responseLength?: number, errorType?: string, stderr?: string): void;
+    /**
+     * Track errors
+     */
+    trackError(errorType: string, errorMessage: string, context?: string, options?: {
+        httpStatus?: number;
+        modelId?: string;
+        runId?: string;
+        recentChunks?: Record<string, unknown>[];
+    }): void;
+    /**
+     * Track user input
+     * Note: agent_id is automatically added from currentAgentId
+     */
+    trackUserInput(input: string, messageType: string, modelId: string): void;
+    /**
+     * Track reflection start events (manual and auto-triggered).
+     */
+    trackReflectionStart(triggerSource: ReflectionTriggerSource, options?: {
+        subagentId?: string;
+        conversationId?: string;
+        startMessageId?: string;
+        endMessageId?: string;
+        model?: string | null;
+    }): void;
+    /**
+     * Track reflection completion events.
+     */
+    trackReflectionEnd(triggerSource: ReflectionTriggerSource, success: boolean, options?: {
+        subagentId?: string;
+        conversationId?: string;
+        error?: string;
+        stepCount?: number;
+        durationMs?: number;
+        model?: string | null;
+    }): void;
+    trackReflectionArenaVote(vote: Omit<ReflectionArenaVoteData, "version" | "platform">): void;
+    /** Concurrent callers share one in-flight POST (prevents 429 double-flush race on shutdown). */
+    flush(): Promise<void>;
+    private performFlush;
+    /** Await in-flight flush and drain remaining queue (bounded by DRAIN_TIMEOUT_MS). Replaces fire-and-forget flush on exit. */
+    drain(): Promise<void>;
+    /**
+     * Clean up resources
+     */
+    cleanup(): void;
+}
+export declare const telemetry: TelemetryManager;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/tools/client-tool-serialization.d.ts

@@ -0,0 +1,14 @@
+import { type ModelFacingToolForm } from "./model-facing-tool";
+interface ClientToolShape {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+interface BuiltInToolShape {
+    modelForm: ModelFacingToolForm;
+}
+interface NamedToolShape extends ClientToolShape {
+}
+export declare function serializeClientTools(registry: ReadonlyMap<string, BuiltInToolShape>, externalTools: ReadonlyMap<string, NamedToolShape>, modTools: ReadonlyMap<string, NamedToolShape>, getServerToolName: (name: string) => string): ClientToolShape[];
+export {};
+//# sourceMappingURL=client-tool-serialization.d.ts.map

package/dist/types/tools/client-tool-serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-tool-serialization.d.ts","sourceRoot":"","sources":["../../../src/tools/client-tool-serialization.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,qBAAqB,CAAC;AAE7B,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,UAAU,gBAAgB;IACxB,SAAS,EAAE,mBAAmB,CAAC;CAChC;AAED,UAAU,cAAe,SAAQ,eAAe;CAAG;AAEnD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAC/C,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,EAClD,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,EAC7C,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAC1C,eAAe,EAAE,CAyBnB"}

package/dist/types/tools/define-tool.d.ts

@@ -0,0 +1,17 @@
+import { type JsonSchema, type ModelFacingToolForm } from "./model-facing-tool";
+export type ToolArgs = Record<string, unknown>;
+export type ToolRunner = (args: ToolArgs) => Promise<unknown>;
+export type TypedToolImplementation<TArgs extends object = ToolArgs, TResult = unknown> = (args: TArgs) => Promise<TResult>;
+export interface ToolAssets {
+    schema: JsonSchema;
+    description: string;
+    modelForm: ModelFacingToolForm;
+    impl: ToolRunner;
+}
+export declare function defineTool<TArgs extends object, TResult>(input: {
+    schema: JsonSchema;
+    description: string;
+    modelForm?: ModelFacingToolForm;
+    impl: TypedToolImplementation<TArgs, TResult>;
+}): ToolAssets;
+//# sourceMappingURL=define-tool.d.ts.map

package/dist/types/tools/define-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/define-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,mBAAmB,EACzB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC/C,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAC9D,MAAM,MAAM,uBAAuB,CACjC,KAAK,SAAS,MAAM,GAAG,QAAQ,EAC/B,OAAO,GAAG,OAAO,IACf,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtC,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,wBAAgB,UAAU,CAAC,KAAK,SAAS,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE;IAC/D,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,IAAI,EAAE,uBAAuB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;CAC/C,GAAG,UAAU,CAYb"}

package/dist/types/tools/filter.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Tool filter manager to control which tools are enabled for the session.
+ * Set via CLI --tools flag.
+ */
+declare class ToolFilterManager {
+    private enabledTools;
+    /**
+     * Set which tools are enabled for this session
+     * @param toolsString - Comma-separated list of tool names, or empty string for no tools
+     */
+    setEnabledTools(toolsString: string): void;
+    /**
+     * Check if a tool is enabled
+     * @param toolName - Name of the tool to check
+     * @returns true if the tool should be loaded, false otherwise
+     */
+    isEnabled(toolName: string): boolean;
+    /**
+     * Get list of enabled tools (null means all tools)
+     */
+    getEnabledTools(): string[] | null;
+    /**
+     * Check if filter is active (i.e., not all tools enabled)
+     */
+    isActive(): boolean;
+    /**
+     * Reset to default (all tools enabled)
+     */
+    reset(): void;
+}
+export declare const toolFilter: ToolFilterManager;
+export {};
+//# sourceMappingURL=filter.d.ts.map

package/dist/types/tools/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../src/tools/filter.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,cAAM,iBAAiB;IACrB,OAAO,CAAC,YAAY,CAAyB;IAE7C;;;OAGG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAa1C;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAUpC;;OAEG;IACH,eAAe,IAAI,MAAM,EAAE,GAAG,IAAI;IAIlC;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAkBD,eAAO,MAAM,UAAU,mBAAc,CAAC"}

package/dist/types/tools/impl/apply-patch.d.ts

@@ -0,0 +1,12 @@
+interface ApplyPatchArgs {
+    input: string;
+}
+interface ApplyPatchResult {
+    message: string;
+}
+/**
+ * ApplyPatch implementation compatible with Codex apply_patch semantics.
+ */
+export declare function apply_patch(args: ApplyPatchArgs): Promise<ApplyPatchResult>;
+export {};
+//# sourceMappingURL=apply-patch.d.ts.map

package/dist/types/tools/impl/apply-patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-patch.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/apply-patch.ts"],"names":[],"mappings":"AAMA,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,gBAAgB;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AA0CD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,gBAAgB,CAAC,CA8E3B"}

package/dist/types/tools/impl/artifact-files.d.ts

@@ -0,0 +1,24 @@
+type ArtifactEncoding = "utf8" | "base64";
+interface ReadArtifactFileArgs {
+    path: string;
+    encoding?: ArtifactEncoding;
+}
+interface WriteArtifactFileArgs {
+    path: string;
+    content: string;
+    encoding?: ArtifactEncoding;
+}
+interface ReadArtifactFileResult {
+    path: string;
+    content: string;
+    encoding: ArtifactEncoding;
+}
+interface WriteArtifactFileResult {
+    path: string;
+    bytes: number;
+    message: string;
+}
+export declare function read_artifact_file(args: ReadArtifactFileArgs): Promise<ReadArtifactFileResult>;
+export declare function write_artifact_file(args: WriteArtifactFileArgs): Promise<WriteArtifactFileResult>;
+export {};
+//# sourceMappingURL=artifact-files.d.ts.map

package/dist/types/tools/impl/artifact-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-files.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/artifact-files.ts"],"names":[],"mappings":"AAUA,KAAK,gBAAgB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE1C,UAAU,oBAAoB;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAED,UAAU,qBAAqB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAED,UAAU,sBAAsB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,UAAU,uBAAuB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAuDD,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,sBAAsB,CAAC,CAoBjC;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,uBAAuB,CAAC,CAalC"}

package/dist/types/tools/impl/ask-user-question.d.ts

@@ -0,0 +1,20 @@
+interface QuestionOption {
+    label: string;
+    description: string;
+}
+interface Question {
+    question: string;
+    header: string;
+    options: QuestionOption[];
+    multiSelect?: boolean;
+}
+interface AskUserQuestionArgs {
+    questions: Question[];
+    answers?: Record<string, string>;
+}
+interface AskUserQuestionResult {
+    message: string;
+}
+export declare function ask_user_question(args: AskUserQuestionArgs): Promise<AskUserQuestionResult>;
+export {};
+//# sourceMappingURL=ask-user-question.d.ts.map

package/dist/types/tools/impl/ask-user-question.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user-question.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/ask-user-question.ts"],"names":[],"mappings":"AAEA,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,QAAQ;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,UAAU,mBAAmB;IAC3B,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,UAAU,qBAAqB;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,qBAAqB,CAAC,CAsDhC"}

package/dist/types/tools/impl/bash-output.d.ts

@@ -0,0 +1,31 @@
+interface GetTaskOutputArgs {
+    task_id: string;
+    block?: boolean;
+    timeout?: number;
+    filter?: string;
+    onOutput?: (chunk: string, stream: "stdout" | "stderr") => void;
+    runningMessageWhenNonBlocking?: boolean;
+}
+interface GetTaskOutputResult {
+    message: string;
+    status?: "running" | "completed" | "failed";
+}
+/**
+ * Core implementation for retrieving task/process output.
+ * Used by both BashOutput (legacy) and TaskOutput (new).
+ * Checks both backgroundProcesses (Bash) and backgroundTasks (Task).
+ */
+export declare function getTaskOutput(args: GetTaskOutputArgs): Promise<GetTaskOutputResult>;
+interface BashOutputArgs {
+    shell_id: string;
+    filter?: string;
+}
+interface BashOutputResult {
+    message: string;
+}
+/**
+ * Legacy BashOutput function - wraps getTaskOutput with non-blocking behavior.
+ */
+export declare function bash_output(args: BashOutputArgs): Promise<BashOutputResult>;
+export {};
+//# sourceMappingURL=bash-output.d.ts.map

package/dist/types/tools/impl/bash-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash-output.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/bash-output.ts"],"names":[],"mappings":"AAWA,UAAU,iBAAiB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,KAAK,IAAI,CAAC;IAChE,6BAA6B,CAAC,EAAE,OAAO,CAAC;CACzC;AAED,UAAU,mBAAmB;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;CAC7C;AA2HD;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAuC9B;AA8MD,UAAU,cAAc;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,gBAAgB;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAW3B"}

package/dist/types/tools/impl/bash.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Execute a command using spawn with explicit shell.
+ * This avoids the double-shell parsing that exec() does.
+ * Uses buildShellLaunchers() to try multiple shells with ENOENT fallback.
+ * Exported for use by bash mode in the CLI.
+ */
+export declare function spawnCommand(command: string, options: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    timeout: number;
+    signal?: AbortSignal;
+    onOutput?: (chunk: string, stream: "stdout" | "stderr") => void;
+    secretEnv?: Record<string, string>;
+}): Promise<{
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+}>;
+interface BashArgs {
+    command: string;
+    timeout?: number;
+    description?: string;
+    run_in_background?: boolean;
+    signal?: AbortSignal;
+    onOutput?: (chunk: string, stream: "stdout" | "stderr") => void;
+    secretEnv?: Record<string, string>;
+    parentScope?: {
+        agentId: string;
+        conversationId: string;
+    };
+}
+interface BashResult {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    status: "success" | "error";
+}
+export declare function bash(args: BashArgs): Promise<BashResult>;
+export {};
+//# sourceMappingURL=bash.d.ts.map

package/dist/types/tools/impl/bash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/bash.ts"],"names":[],"mappings":"AAqEA;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IACP,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,KAAK,IAAI,CAAC;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC,GACA,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAyFtE;AAED,UAAU,QAAQ;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,KAAK,IAAI,CAAC;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3D;AAED,UAAU,UAAU;IAClB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;CAC7B;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CA8O9D"}

package/dist/types/tools/impl/edit.d.ts

@@ -0,0 +1,26 @@
+interface EditArgs {
+    file_path: string;
+    old_string: string;
+    new_string: string;
+    replace_all?: boolean;
+    expected_replacements?: number;
+}
+interface EditResult {
+    message: string;
+    replacements: number;
+    startLine?: number;
+}
+/**
+ * Unescapes a string that might have been overly escaped by an LLM.
+ * Based on Gemini CLI's unescapeStringForGeminiBug function.
+ *
+ * LLMs sometimes generate strings with extra escape characters like:
+ * - \\n instead of \n (newline)
+ * - \\t instead of \t (tab)
+ * - \\\" instead of " (quote)
+ * - \\` instead of ` (backtick)
+ */
+export declare function unescapeOverEscapedString(input: string): string;
+export declare function edit(args: EditArgs): Promise<EditResult>;
+export {};
+//# sourceMappingURL=edit.d.ts.map

package/dist/types/tools/impl/edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/edit.ts"],"names":[],"mappings":"AAKA,UAAU,QAAQ;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AACD,UAAU,UAAU;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA6DD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA8B/D;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CA6G9D"}

package/dist/types/tools/impl/enter-worktree.d.ts

@@ -0,0 +1,36 @@
+interface EnterWorktreeResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    status: "success" | "error";
+    worktree_path?: string;
+    branch_name?: string;
+    base_ref?: string;
+    switched_cwd?: boolean;
+}
+export declare function addWindowsPathLengthHint(message: string, platform?: NodeJS.Platform): string;
+/**
+ * Provisions a freshly created worktree: symlinks heavy gitignored directories,
+ * wires git hooks, copies local settings, and copies `.worktreeinclude` paths.
+ * Every step is best-effort — failures are reported as notes and never abort
+ * worktree creation.
+ *
+ * `symlinkDependencies` (opt-in; defaulted off at the tool layer) gates only
+ * the dependency-directory symlinks. When true, node_modules is shared from the
+ * primary checkout to avoid reinstalling — but a package install in the worktree
+ * then writes through to the primary checkout, so worktrees stay isolated unless
+ * it is explicitly requested. Returns `linkedDependencies` so the caller can
+ * tailor its guidance.
+ */
+export declare function provisionWorktree(params: {
+    primaryRoot: string;
+    worktreePath: string;
+    symlinkDependencies: boolean;
+}): Promise<{
+    notes: string[];
+    linkedDependencies: boolean;
+}>;
+export declare function enter_worktree(rawArgs: Record<string, unknown>): Promise<EnterWorktreeResult>;
+export {};
+//# sourceMappingURL=enter-worktree.d.ts.map

package/dist/types/tools/impl/enter-worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enter-worktree.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/enter-worktree.ts"],"names":[],"mappings":"AA6CA,UAAU,mBAAmB;IAC3B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AA2DD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,MAAM,CAeR;AA8kBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,OAAO,CAAC;CAC9B,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,kBAAkB,EAAE,OAAO,CAAA;CAAE,CAAC,CA4C5D;AA6TD,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,mBAAmB,CAAC,CAgK9B"}

package/dist/types/tools/impl/exec-command.d.ts

@@ -0,0 +1,52 @@
+interface ExecCommandArgs {
+    cmd: string;
+    description?: string;
+    workdir?: string;
+    shell?: string;
+    tty?: boolean;
+    yield_time_ms?: number;
+    max_output_tokens?: number;
+    login?: boolean;
+    signal?: AbortSignal;
+    onOutput?: (chunk: string, stream: "stdout" | "stderr") => void;
+    secretEnv?: Record<string, string>;
+    parentScope?: {
+        agentId: string;
+        conversationId: string;
+    };
+}
+interface WriteStdinArgs {
+    session_id: number | string;
+    chars?: string;
+    yield_time_ms?: number;
+    max_output_tokens?: number;
+    signal?: AbortSignal;
+    onOutput?: (chunk: string, stream: "stdout" | "stderr") => void;
+}
+interface ExecCommandResult {
+    output: string;
+}
+type ExecSessionStatus = "running" | "completed" | "failed";
+interface ExecSession {
+    id: string;
+    command: string;
+    output: string;
+    chunks: ExecOutputChunk[];
+    readOffset: number;
+    status: ExecSessionStatus;
+    exitCode: number | null;
+    tty: boolean;
+    cleanupTimer?: ReturnType<typeof setTimeout>;
+}
+type ExecOutputChunk = {
+    text: string;
+    stream: "stdout" | "stderr";
+    start: number;
+    end: number;
+};
+export declare function exec_command(args: ExecCommandArgs): Promise<ExecCommandResult>;
+export declare function write_stdin(args: WriteStdinArgs): Promise<ExecCommandResult>;
+export declare function __clearExecSessionsForTests(): void;
+export declare function __getExecSessionForTests(sessionId: string): ExecSession | undefined;
+export {};
+//# sourceMappingURL=exec-command.d.ts.map

package/dist/types/tools/impl/exec-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-command.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/exec-command.ts"],"names":[],"mappings":"AAkCA,UAAU,eAAe;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAMhB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,KAAK,IAAI,CAAC;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3D;AAED,UAAU,cAAc;IACtB,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,KAAK,IAAI,CAAC;CACjE;AAED,UAAU,iBAAiB;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,KAAK,iBAAiB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE5D,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,EAAE,OAAO,CAAC;IACb,YAAY,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;CAC9C;AAiDD,KAAK,eAAe,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AA6kBF,wBAAsB,YAAY,CAChC,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAoC5B;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,iBAAiB,CAAC,CA+C5B;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAOlD;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,GAChB,WAAW,GAAG,SAAS,CAEzB"}

package/dist/types/tools/impl/glob-gemini.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Gemini CLI glob tool - wrapper around Letta Code's Glob tool
+ * Uses Gemini's exact schema and description
+ */
+interface GlobGeminiArgs {
+    pattern: string;
+    dir_path?: string;
+    case_sensitive?: boolean;
+    respect_git_ignore?: boolean;
+    respect_gemini_ignore?: boolean;
+}
+export declare function glob_gemini(args: GlobGeminiArgs): Promise<{
+    message: string;
+}>;
+export {};
+//# sourceMappingURL=glob-gemini.d.ts.map