@letta-ai/letta-code 0.30.2 → 0.30.3

package/dist/types/tools/impl/shell-env.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Shell environment utilities
+ * Provides enhanced environment variables for shell execution,
+ * including bundled tools like ripgrep in PATH and Letta context for skill scripts.
+ */
+interface LettaInvocation {
+    command: string;
+    args: string[];
+}
+export declare function resolveEntryScriptPath(scriptPath: string, cwd?: string): string;
+export declare function resolveLettaInvocation(env?: NodeJS.ProcessEnv, argv?: string[], execPath?: string, cwd?: string): LettaInvocation | null;
+export declare function getLettaShimDir(env?: NodeJS.ProcessEnv): string;
+export declare function ensureLettaShimDir(invocation: LettaInvocation): string | null;
+/**
+ * Get enhanced environment variables for shell execution.
+ * Includes bundled tools (like ripgrep) in PATH and Letta context for skill scripts.
+ */
+export declare function getShellEnv(): NodeJS.ProcessEnv;
+export {};
+//# sourceMappingURL=shell-env.d.ts.map

package/dist/types/tools/impl/shell-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-env.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/shell-env.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4CH,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAsCD,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,GAAG,GAAE,MAAsB,GAC1B,MAAM,CAMR;AAaD,wBAAgB,sBAAsB,CACpC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,IAAI,GAAE,MAAM,EAAiB,EAC7B,QAAQ,GAAE,MAAyB,EACnC,GAAG,GAAE,MAAsB,GAC1B,eAAe,GAAG,IAAI,CA8BxB;AAQD,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAU5E;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CA2B7E;AA0GD;;;GAGG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAAC,UAAU,CAoM/C"}

package/dist/types/tools/impl/shell-launchers.d.ts

@@ -0,0 +1,14 @@
+type ShellLaunchOptions = {
+    login?: boolean;
+    env?: NodeJS.ProcessEnv;
+    powershellEnvAliases?: string[];
+};
+export declare const STRICT_SHELL_ENV_VAR = "LETTA_BASH_STRICT";
+export declare const STRICT_SHELL_PRELUDE = "set -euo pipefail";
+export declare const POWERSHELL_UTF8_OUTPUT_PREFIX = "try { [Console]::OutputEncoding=[System.Text.Encoding]::UTF8 } catch {}\n";
+export declare function withStrictShellPrelude(command: string, env?: NodeJS.ProcessEnv): string;
+export declare function buildPowerShellCommand(command: string, envAliases?: string[]): string;
+export declare function selectAvailableShellLauncher(launchers: string[][], env?: NodeJS.ProcessEnv): string[] | undefined;
+export declare function buildShellLaunchers(command: string, options?: ShellLaunchOptions): string[][];
+export {};
+//# sourceMappingURL=shell-launchers.d.ts.map

package/dist/types/tools/impl/shell-launchers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-launchers.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/shell-launchers.ts"],"names":[],"mappings":"AAIA,KAAK,kBAAkB,GAAG;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC,CAAC;AAEF,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AACxD,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AACxD,eAAO,MAAM,6BAA6B,8EACmC,CAAC;AAyB9E,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAIR;AA4CD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,UAAU,GAAE,MAAM,EAAO,GACxB,MAAM,CAaR;AAoGD,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,EAAE,EAAE,EACrB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,EAAE,GAAG,SAAS,CAgBtB;AA8DD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,kBAAkB,GAC3B,MAAM,EAAE,EAAE,CAMZ"}

package/dist/types/tools/impl/shell-runner.d.ts

@@ -0,0 +1,24 @@
+export declare class ShellExecutionError extends Error {
+    code?: string;
+    executable?: string;
+    cwd?: string;
+    /** Distinguishes which lookup failed when `code` is ENOENT. */
+    reason?: "executable_missing" | "cwd_missing";
+}
+export type ShellSpawnOptions = {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    timeoutMs: number;
+    signal?: AbortSignal;
+    onOutput?: (chunk: string, stream: "stdout" | "stderr") => void;
+};
+/**
+ * Spawn a command with a specific launcher.
+ * Returns a promise that resolves with the output or rejects with an error.
+ */
+export declare function spawnWithLauncher(launcher: string[], options: ShellSpawnOptions): Promise<{
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+}>;
+//# sourceMappingURL=shell-runner.d.ts.map

package/dist/types/tools/impl/shell-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-runner.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/shell-runner.ts"],"names":[],"mappings":"AAIA,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,MAAM,CAAC,EAAE,oBAAoB,GAAG,aAAa,CAAC;CAC/C;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,KAAK,IAAI,CAAC;CACjE,CAAC;AA6BF;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAgJtE"}

package/dist/types/tools/impl/shell-sandbox.d.ts

@@ -0,0 +1,40 @@
+import type { SandboxAvailability } from "../../sandbox/availability";
+import { type SandboxBackend } from "../../sandbox/policy";
+/**
+ * Applies the cross-agent filesystem sandbox to an agent process's shell
+ * commands at spawn. The whole shell — and anything it forks — runs under a
+ * kernel policy that denies reading or writing other agents' memory while
+ * leaving the current agent's own directory, the repo, and temp writable.
+ *
+ * Shared by every shell executor — the `Bash` tool (`bash.ts`), the Codex
+ * `exec_command`/`write_stdin` sessions (`exec-command.ts`), and the Gemini
+ * `run_shell_command` path (`shell.ts`) — so the kernel owns the whole shell
+ * surface, not just one dialect.
+ *
+ * This is the SOLE cross-agent enforcement for spawned shells: the static
+ * cross-agent guard no longer analyzes shell commands (it was bypassable by
+ * symlinks, command substitution, globbing, and subprocesses). The kernel
+ * resolves real paths regardless of how the command spelled them.
+ *
+ * OFF by default; set `LETTA_FS_SANDBOX=1` to opt in (recommended for
+ * multi-tenant deployments where agents must not read each other's memory).
+ * No-ops when the host has no sandbox backend.
+ */
+export interface ShellSandboxResult {
+    launcher: string[];
+    env: NodeJS.ProcessEnv;
+    /** The backend the launcher was wrapped with, or null when left unchanged. */
+    backend: SandboxBackend | null;
+}
+/**
+ * Apply the cross-agent sandbox to an agent shell launcher. Returns the
+ * launcher (possibly wrapped) and the env to spawn it with (carrying the
+ * sandbox sentinel when wrapped). Returns the inputs unchanged when the shared
+ * gate ({@link resolveShellSandboxContext}) says this process's shells are not
+ * to be wrapped (flag off, already sandboxed, no backend, cwd inside the agents
+ * tree, or no resolvable self roots).
+ */
+export declare function applyShellSandbox(launcher: string[], cwd: string, env: NodeJS.ProcessEnv, 
+/** Injectable for tests; defaults to a real host probe. */
+availability?: SandboxAvailability): ShellSandboxResult;
+//# sourceMappingURL=shell-sandbox.d.ts.map

package/dist/types/tools/impl/shell-sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-sandbox.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/shell-sandbox.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGxE;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,8EAA8E;IAC9E,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAAE,EAClB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,CAAC,UAAU;AACtB,2DAA2D;AAC3D,YAAY,CAAC,EAAE,mBAAmB,GACjC,kBAAkB,CA8BpB"}

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

@@ -0,0 +1,25 @@
+interface ShellArgs {
+    command: string[];
+    workdir?: string;
+    timeout_ms?: number;
+    env_overrides?: NodeJS.ProcessEnv;
+    secretEnv?: Record<string, string>;
+    with_escalated_permissions?: boolean;
+    justification?: string;
+    signal?: AbortSignal;
+    onOutput?: (chunk: string, stream: "stdout" | "stderr") => void;
+}
+export declare function resolveShellWorkdir(workdir?: string): string;
+export interface ShellResult {
+    output: string;
+    stdout: string[];
+    stderr: string[];
+}
+/**
+ * Codex-style shell tool.
+ * Runs an array of shell arguments using execvp-style semantics.
+ * Typically called with ["bash", "-lc", "..."] for shell commands.
+ */
+export declare function shell(args: ShellArgs): Promise<ShellResult>;
+export {};
+//# sourceMappingURL=shell.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/shell.ts"],"names":[],"mappings":"AAaA,UAAU,SAAS;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,KAAK,IAAI,CAAC;CACjE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAS5D;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AA4DD;;;;GAIG;AACH,wBAAsB,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CA6EjE"}

package/dist/types/tools/impl/skill-content-registry.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Side-channel registry for skill content injection.
+ *
+ * When the Skill tool reads a SKILL.md file, it queues the content here.
+ * The harness (App.tsx / headless.ts) consumes the queue after tool execution
+ * and injects the content as a user message part alongside the tool result.
+ *
+ * This pattern matches toolImageRegistry.ts - tools return strings only,
+ * rich content is queued and injected at the harness level.
+ */
+interface QueuedSkillContent {
+    toolCallId: string;
+    content: string;
+}
+/**
+ * Queue skill content for injection by the harness.
+ * Called by the Skill tool handler after reading SKILL.md.
+ */
+export declare function queueSkillContent(toolCallId: string, content: string): void;
+/**
+ * Consume all queued skill content.
+ * Returns the queue and clears it. Order is preserved (push order = execution order).
+ */
+export declare function consumeQueuedSkillContent(): QueuedSkillContent[];
+export {};
+//# sourceMappingURL=skill-content-registry.d.ts.map

package/dist/types/tools/impl/skill-content-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-content-registry.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/skill-content-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,UAAU,kBAAkB;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3E;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,kBAAkB,EAAE,CAIhE"}

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

@@ -0,0 +1,45 @@
+interface SkillArgs {
+    skill: string;
+    /** Injected by executeTool - the tool_call_id for this invocation */
+    toolCallId?: string;
+    /** Injected by executeTool in listener mode for scoped agent resolution. */
+    parentScope?: {
+        agentId: string;
+        conversationId: string;
+    };
+}
+interface SkillResult {
+    message: string;
+}
+/**
+ * Read skill content from file or bundled source
+ * Returns both content and the path to the SKILL.md file
+ *
+ * Search order (highest priority first):
+ * 1. Project skills (.agents/skills/, then legacy .skills/ fallback)
+ * 2. Agent memory skills (~/.letta/agents/{id}/memory/skills/)
+ * 3. Agent memory skills fallback ($MEMORY_DIR/skills/)
+ * 4. Global skills (~/.letta/skills/)
+ * 5. Bundled skills
+ */
+export declare function readSkillContent(skillId: string, skillsDir: string, agentId?: string): Promise<{
+    content: string;
+    path: string;
+}>;
+/**
+ * Get skills directory, trying multiple sources
+ */
+export declare function getResolvedSkillsDir(): Promise<string>;
+export interface RenderSkillContentOptions {
+    allowDisabledModelInvocation?: boolean;
+}
+export declare function renderSkillContent(skillName: string, skillContent: string, skillPath: string, options?: RenderSkillContentOptions): string;
+export declare function loadRenderedSkillContent(skillName: string, options?: RenderSkillContentOptions & {
+    agentId?: string;
+    skillsDir?: string;
+}): Promise<string>;
+export declare function wrapSkillContent(skillName: string, content: string): string;
+export declare function wrapSkillPrompt(skillName: string, content: string, userRequest: string): string;
+export declare function skill(args: SkillArgs): Promise<SkillResult>;
+export {};
+//# sourceMappingURL=skill.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/skill.ts"],"names":[],"mappings":"AAmBA,UAAU,SAAS;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3D;AAED,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAuCD;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA0E5C;AAED;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC,CAS5D;AAcD,MAAM,WAAW,yBAAyB;IACxC,4BAA4B,CAAC,EAAE,OAAO,CAAC;CACxC;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,yBAA8B,GACtC,MAAM,CAkBR;AAED,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,yBAAyB,GAAG;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,OAAO,CAAC,MAAM,CAAC,CAQjB;AAUD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAK3E;AAED,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,MAAM,CAGR;AAED,wBAAsB,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAgCjE"}

package/dist/types/tools/impl/task-create.d.ts

@@ -0,0 +1,10 @@
+import { type TaskRecord } from "./tasks/store.js";
+interface TaskCreateArgs {
+    subject?: string;
+    description?: string;
+    activeForm?: string;
+    metadata?: Record<string, string>;
+}
+export declare function task_create(args: TaskCreateArgs): Promise<TaskRecord>;
+export {};
+//# sourceMappingURL=task-create.d.ts.map

package/dist/types/tools/impl/task-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-create.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/task-create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG/D,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAkC3E"}

package/dist/types/tools/impl/task-get.d.ts

@@ -0,0 +1,7 @@
+import { type TaskRecord } from "./tasks/store.js";
+interface TaskGetArgs {
+    taskId?: string;
+}
+export declare function task_get(args: TaskGetArgs): Promise<TaskRecord>;
+export {};
+//# sourceMappingURL=task-get.d.ts.map

package/dist/types/tools/impl/task-get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-get.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/task-get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG5D,UAAU,WAAW;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAUrE"}

package/dist/types/tools/impl/task-list.d.ts

@@ -0,0 +1,7 @@
+import { type TaskRecord } from "./tasks/store.js";
+interface TaskListResult {
+    tasks: TaskRecord[];
+}
+export declare function task_list(_args: Record<string, unknown>): Promise<TaskListResult>;
+export {};
+//# sourceMappingURL=task-list.d.ts.map

package/dist/types/tools/impl/task-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-list.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/task-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9D,UAAU,cAAc;IACtB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,wBAAsB,SAAS,CAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,cAAc,CAAC,CAEzB"}

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

@@ -0,0 +1,18 @@
+interface TaskOutputArgs {
+    task_id: string;
+    block: boolean;
+    timeout: number;
+    onOutput?: (chunk: string, stream: "stdout" | "stderr") => void;
+}
+interface TaskOutputResult {
+    message: string;
+    status?: "running" | "completed" | "failed";
+}
+/**
+ * TaskOutput - retrieves output from a running or completed background task.
+ * `block` and `timeout` are required by the schema (matches Claude Code's
+ * current tool contract); callers must pass them explicitly.
+ */
+export declare function task_output(args: TaskOutputArgs): Promise<TaskOutputResult>;
+export {};
+//# sourceMappingURL=task-output.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task-output.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/task-output.ts"],"names":[],"mappings":"AAGA,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,KAAK,IAAI,CAAC;CACjE;AAED,UAAU,gBAAgB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;CAC7C;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAW3B"}

package/dist/types/tools/impl/task-stop.d.ts

@@ -0,0 +1,9 @@
+interface TaskStopArgs {
+    task_id: string;
+}
+interface TaskStopResult {
+    killed: boolean;
+}
+export declare function task_stop(args: TaskStopArgs): Promise<TaskStopResult>;
+export {};
+//# sourceMappingURL=task-stop.d.ts.map

package/dist/types/tools/impl/task-stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-stop.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/task-stop.ts"],"names":[],"mappings":"AAOA,UAAU,YAAY;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,cAAc;IACtB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CAsB3E"}

package/dist/types/tools/impl/task-update.d.ts

@@ -0,0 +1,15 @@
+import { type TaskRecord } from "./tasks/store.js";
+interface TaskUpdateArgs {
+    taskId?: string;
+    status?: string;
+    subject?: string;
+    description?: string;
+    activeForm?: string;
+    owner?: string;
+    addBlocks?: string[];
+    addBlockedBy?: string[];
+    metadata?: Record<string, string>;
+}
+export declare function task_update(args: TaskUpdateArgs): Promise<TaskRecord>;
+export {};
+//# sourceMappingURL=task-update.d.ts.map

package/dist/types/tools/impl/task-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-update.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/task-update.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EAGhB,MAAM,kBAAkB,CAAC;AAG1B,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AA2BD,wBAAsB,WAAW,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAoD3E"}

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

@@ -0,0 +1,131 @@
+/**
+ * Task tool implementation
+ *
+ * Spawns specialized subagents to handle complex, multi-step tasks autonomously.
+ * Supports both built-in subagent types and custom subagents defined in .letta/agents/.
+ */
+import { completeSubagent, generateSubagentId, getSnapshot as getSubagentSnapshot, registerSubagent } from "../../agent/subagent-state.js";
+import { type SubagentMemoryScope } from "../../agent/subagents";
+import { spawnSubagent } from "../../agent/subagents/manager";
+import { runSubagentStopHooks } from "../../hooks";
+import { addToMessageQueue } from "../../utils/message-queue-bridge.js";
+import { formatTaskNotification } from "../../utils/task-notifications.js";
+interface TaskArgs {
+    command?: "run" | "refresh";
+    subagent_type?: string;
+    prompt?: string;
+    description?: string;
+    model?: string;
+    agent_id?: string;
+    conversation_id?: string;
+    run_in_background?: boolean;
+    max_turns?: number;
+    toolCallId?: string;
+    signal?: AbortSignal;
+    parentScope?: {
+        agentId: string;
+        conversationId: string;
+    };
+}
+export interface SpawnBackgroundSubagentTaskArgs {
+    subagentType: string;
+    prompt: string;
+    description: string;
+    model?: string;
+    /** Replace the subagent's configured system prompt/persona (advanced). */
+    systemPromptOverride?: string;
+    toolCallId?: string;
+    existingAgentId?: string;
+    existingConversationId?: string;
+    maxTurns?: number;
+    forkedContext?: boolean;
+    /** Parent conversation scope for routing notifications in listener mode. */
+    parentScope?: {
+        agentId: string;
+        conversationId: string;
+    };
+    /**
+     * Optional path to a transcript/payload file the subagent should read.
+     * Exposed to the child process as the `TRANSCRIPT_PATH` env var so
+     * prompts can reference `$TRANSCRIPT_PATH` (resolved via Bash) instead
+     * of interpolating an absolute path. Currently used by reflection
+     * subagents.
+     */
+    transcriptPath?: string;
+    /** Optional exact memory scope for harness-created memory worktrees. */
+    memoryScope?: SubagentMemoryScope;
+    /**
+     * When true, skip injecting the completion notification into the primary
+     * agent's message queue and hide from SubagentGroupDisplay.
+     * Use `onComplete` to show a user-facing notification without leaking
+     * into the agent's context.
+     */
+    silentCompletion?: boolean;
+    /**
+     * Emit a completion notification even when `silentCompletion` is true.
+     * Useful when the parent should not stream subagent tokens but still wants
+     * a normal task notification event.
+     */
+    emitCompletionNotification?: boolean;
+    /**
+     * Optional override for the completion notification summary.
+     */
+    completionSummary?: string | ((result: {
+        success: boolean;
+        error?: string;
+    }) => string | Promise<string>);
+    /**
+     * Called after the subagent finishes (success or failure).
+     * Runs regardless of `silentCompletion` and is awaited before
+     * completion notifications/hooks continue.
+     * `report` is the raw final subagent report and may be large; callbacks
+     * should parse/summarize it rather than injecting it directly into context.
+     */
+    onComplete?: (result: {
+        success: boolean;
+        error?: string;
+        agentId?: string;
+        conversationId?: string;
+        stepCount?: number;
+        durationMs?: number;
+        report?: string;
+    }) => void | Promise<void>;
+    /**
+     * Optional dependency overrides for tests.
+     * Production callers should not provide this.
+     */
+    deps?: Partial<SpawnBackgroundSubagentTaskDeps>;
+}
+export interface SpawnBackgroundSubagentTaskResult {
+    taskId: string;
+    outputFile: string;
+    subagentId: string;
+}
+interface SpawnBackgroundSubagentTaskDeps {
+    spawnSubagentImpl: typeof spawnSubagent;
+    addToMessageQueueImpl: typeof addToMessageQueue;
+    formatTaskNotificationImpl: typeof formatTaskNotification;
+    runSubagentStopHooksImpl: typeof runSubagentStopHooks;
+    generateSubagentIdImpl: typeof generateSubagentId;
+    registerSubagentImpl: typeof registerSubagent;
+    completeSubagentImpl: typeof completeSubagent;
+    getSubagentSnapshotImpl: typeof getSubagentSnapshot;
+}
+/**
+ * Wait briefly for a background subagent to publish its agent URL.
+ * This keeps Task mostly non-blocking while allowing static transcript rows
+ * to include an ADE link in the common case.
+ */
+export declare function waitForBackgroundSubagentLink(subagentId: string, timeoutMs?: number | null, signal?: AbortSignal): Promise<void>;
+export declare function waitForBackgroundSubagentAgentId(subagentId: string, timeoutMs?: number | null, signal?: AbortSignal): Promise<string | null>;
+/**
+ * Spawn a background subagent task and return task metadata immediately.
+ * Notification/hook behavior is identical to Task's background path.
+ */
+export declare function spawnBackgroundSubagentTask(args: SpawnBackgroundSubagentTaskArgs): SpawnBackgroundSubagentTaskResult;
+/**
+ * Task tool - Launch a specialized subagent to handle complex tasks
+ */
+export declare function task(args: TaskArgs): Promise<string>;
+export {};
+//# sourceMappingURL=task.d.ts.map

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

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

package/dist/types/tools/impl/tasks/store.d.ts

@@ -0,0 +1,56 @@
+/**
+ * In-memory task store backing the Task* CRUD family.
+ *
+ * This powers TaskCreate / TaskGet / TaskList / TaskUpdate — the replacement
+ * for the older stateless `TodoWrite` tool. Tasks have stable IDs, dependency
+ * edges (blocks/blockedBy), optional owner, and a free-form metadata bag.
+ *
+ * Scope: process-lifetime. Same model as `process_manager.ts`'s background
+ * task registry. A future follow-up may scope per-conversation.
+ */
+export type TaskStatus = "pending" | "in_progress" | "completed" | "deleted";
+export interface TaskRecord {
+    taskId: string;
+    subject: string;
+    description: string;
+    activeForm?: string;
+    status: TaskStatus;
+    owner?: string;
+    /** IDs of tasks this task blocks (i.e. those tasks can't start until this one finishes) */
+    blocks: string[];
+    /** IDs of tasks that block this task */
+    blockedBy: string[];
+    metadata: Record<string, string>;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface CreateTaskInput {
+    subject: string;
+    description: string;
+    activeForm?: string;
+    metadata?: Record<string, string>;
+}
+export declare function createTask(input: CreateTaskInput): TaskRecord;
+export declare function getTask(taskId: string): TaskRecord | undefined;
+export interface ListTasksOptions {
+    includeDeleted?: boolean;
+}
+export declare function listTasks(options?: ListTasksOptions): TaskRecord[];
+export interface UpdateTaskInput {
+    taskId: string;
+    status?: TaskStatus;
+    subject?: string;
+    description?: string;
+    activeForm?: string;
+    owner?: string;
+    addBlocks?: string[];
+    addBlockedBy?: string[];
+    metadata?: Record<string, string>;
+}
+export declare class TaskNotFoundError extends Error {
+    constructor(taskId: string);
+}
+export declare function updateTask(input: UpdateTaskInput): TaskRecord;
+/** Test-only hook to reset state between unit tests. */
+export declare function _resetTaskStoreForTests(): void;
+//# sourceMappingURL=store.d.ts.map

package/dist/types/tools/impl/tasks/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../../../src/tools/impl/tasks/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;AAE7E,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2FAA2F;IAC3F,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,wCAAwC;IACxC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AA4BD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,CAiB7D;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAG9D;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,UAAU,EAAE,CAStE;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,MAAM,EAAE,MAAM;CAI3B;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,CA2B7D;AAED,wDAAwD;AACxD,wBAAgB,uBAAuB,IAAI,IAAI,CAI9C"}

package/dist/types/tools/impl/todo-write.d.ts

@@ -0,0 +1,14 @@
+interface TodoItem {
+    content: string;
+    status: "pending" | "in_progress" | "completed";
+    activeForm: string;
+}
+interface TodoWriteArgs {
+    todos: TodoItem[];
+}
+interface TodoWriteResult {
+    message: string;
+}
+export declare function todo_write(args: TodoWriteArgs): Promise<TodoWriteResult>;
+export {};
+//# sourceMappingURL=todo-write.d.ts.map

package/dist/types/tools/impl/todo-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-write.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/todo-write.ts"],"names":[],"mappings":"AAEA,UAAU,QAAQ;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;IAChD,UAAU,EAAE,MAAM,CAAC;CACpB;AACD,UAAU,aAAa;IACrB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AACD,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,eAAe,CAAC,CAqB1B"}

package/dist/types/tools/impl/tool-return-clamp.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Backstop clamp for model-facing tool returns.
+ *
+ * Individual tools apply their own limits (see LIMITS in truncation.ts), but
+ * several never bound the total size of the string they return: the Read
+ * variants cap lines and chars-per-line only, Glob/LS/grep_files cap item
+ * counts only, Memory/Skill return file bodies verbatim, and external/MCP and
+ * mod tools can return arbitrarily large output. This module clamps any tool
+ * return that slipped past those per-tool limits before it reaches the model,
+ * writing the full content to an overflow file so nothing is lost.
+ */
+import type { ImageContent, TextContent } from "@letta-ai/letta-client/resources/agents/messages";
+type ClampableToolReturn = string | Array<TextContent | ImageContent>;
+/**
+ * Bound the total size of a tool return. Strings are clamped directly;
+ * multimodal arrays have each text block clamped while image blocks pass
+ * through untouched.
+ */
+export declare function clampToolReturnContent(content: ClampableToolReturn, toolName: string): ClampableToolReturn;
+export {};
+//# sourceMappingURL=tool-return-clamp.d.ts.map

package/dist/types/tools/impl/tool-return-clamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-return-clamp.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/tool-return-clamp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACZ,MAAM,kDAAkD,CAAC;AAI1D,KAAK,mBAAmB,GAAG,MAAM,GAAG,KAAK,CAAC,WAAW,GAAG,YAAY,CAAC,CAAC;AAYtE;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,EAAE,MAAM,GACf,mBAAmB,CASrB"}

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

@@ -0,0 +1,63 @@
+/**
+ * Centralized truncation utilities for tool outputs.
+ * Implements limits similar to Claude Code to prevent excessive token usage.
+ * When outputs exceed limits, full content can be written to overflow files.
+ */
+export declare const LIMITS: {
+    readonly BASH_OUTPUT_CHARS: 30000;
+    readonly TASK_OUTPUT_CHARS: 30000;
+    readonly READ_MAX_LINES: 2000;
+    readonly READ_MAX_CHARS_PER_LINE: 2000;
+    readonly READ_OUTPUT_CHARS: 30000;
+    readonly GREP_OUTPUT_CHARS: 10000;
+    readonly GLOB_MAX_FILES: 2000;
+    readonly LS_MAX_ENTRIES: 1000;
+    readonly TOOL_RETURN_MAX_CHARS: 32000;
+};
+/**
+ * Options for truncation with overflow support
+ */
+export interface TruncationOptions {
+    /** Working directory for overflow file creation */
+    workingDirectory?: string;
+    /** Tool name for overflow file naming */
+    toolName?: string;
+    /** Whether to use middle truncation (keep beginning and end) */
+    useMiddleTruncation?: boolean;
+}
+/**
+ * Truncates text to a maximum character count.
+ * Adds a truncation notice when content exceeds limit.
+ * Optionally writes full output to an overflow file.
+ */
+export declare function truncateByChars(text: string, maxChars: number, toolName?: string, options?: TruncationOptions): {
+    content: string;
+    wasTruncated: boolean;
+    overflowPath?: string;
+};
+/**
+ * Truncates text by line count.
+ * Optionally enforces max characters per line.
+ * Optionally writes full output to an overflow file.
+ */
+export declare function truncateByLines(text: string, maxLines: number, maxCharsPerLine?: number, toolName?: string, options?: TruncationOptions): {
+    content: string;
+    wasTruncated: boolean;
+    originalLineCount: number;
+    linesShown: number;
+    overflowPath?: string;
+};
+/**
+ * Truncates an array of items (file paths, directory entries, etc.)
+ * Optionally writes full output to an overflow file.
+ */
+export declare function truncateArray<T>(items: T[], maxItems: number, formatter: (items: T[]) => string, itemType?: string, toolName?: string, options?: TruncationOptions): {
+    content: string;
+    wasTruncated: boolean;
+    overflowPath?: string;
+};
+/**
+ * Format bytes for human-readable display
+ */
+export declare function formatBytes(bytes: number): string;
+//# sourceMappingURL=truncation.d.ts.map