@letta-ai/letta-code 0.30.2 → 0.30.4

package/dist/types/agent/modify.d.ts

@@ -0,0 +1,142 @@
+import type { AgentState, AnthropicModelSettings, GoogleAIModelSettings, OpenAIModelSettings } from "@letta-ai/letta-client/resources/agents/agents";
+import type { Conversation } from "@letta-ai/letta-client/resources/conversations/conversations";
+import type { Backend } from "../backend";
+import { type ModelReasoningSelection } from "./model";
+type ModelSettings = OpenAIModelSettings | AnthropicModelSettings | GoogleAIModelSettings | Record<string, unknown>;
+/**
+ * Builds model_settings from updateArgs based on provider type.
+ * Always ensures parallel_tool_calls is enabled.
+ */
+declare function buildModelSettings(modelHandle: string, updateArgs?: Record<string, unknown>): ModelSettings;
+export declare const __modifyTestUtils: {
+    buildModelSettings: typeof buildModelSettings;
+    updateArgsForModelSettings: typeof updateArgsForModelSettings;
+};
+declare function updateArgsForModelSettings(updateArgs: Record<string, unknown> | undefined, options: {
+    useBackendModelCatalog: boolean;
+}): Record<string, unknown> | undefined;
+/**
+ * Updates an agent's model and model settings.
+ *
+ * Uses the new model_settings field instead of deprecated llm_config.
+ *
+ * @param agentId - The agent ID
+ * @param modelHandle - The model handle (e.g., "anthropic/claude-sonnet-4-5-20250929")
+ * @param updateArgs - Additional config args (context_window, reasoning_effort, enable_reasoner, etc.)
+ * @returns The updated agent state from the server (includes llm_config and model_settings)
+ */
+export interface UpdateLLMConfigOptions {
+    /**
+     * Context window to send explicitly. Wins over updateArgs.context_window
+     * and catalog derivation on EVERY backend — including local backends, where
+     * updateArgs.context_window is otherwise ignored in favor of the pi model
+     * catalog. Preserve paths (reasoning cycles, resume refresh, conversation
+     * carryover, same-variant /model changes) use this to re-send the current
+     * window (LET-9786).
+     */
+    contextWindowOverride?: number;
+}
+export declare function updateAgentLLMConfig(agentId: string, modelHandle: string, updateArgs?: Record<string, unknown>, options?: UpdateLLMConfigOptions): Promise<AgentState>;
+/**
+ * Updates a conversation's model and model settings.
+ *
+ * Uses conversation-scoped model overrides so different conversations can
+ * run with different models without mutating the agent's default model.
+ *
+ * @param conversationId - The conversation ID (or "default")
+ * @param modelHandle - The model handle (e.g., "anthropic/claude-sonnet-4-5-20250929")
+ * @param updateArgs - Additional config args (reasoning_effort, enable_reasoner, etc.)
+ * @returns The updated conversation from the server
+ */
+export declare function updateConversationLLMConfig(conversationId: string, modelHandle: string, updateArgs?: Record<string, unknown>, options?: UpdateLLMConfigOptions): Promise<Conversation>;
+export interface ModelConfigUpdate {
+    /** Model handle, e.g. "anthropic/claude-opus-4-8". Omit to keep the current model. */
+    model?: string;
+    /** Reasoning effort tier. Omit to leave reasoning settings untouched. */
+    reasoningEffort?: ModelReasoningSelection;
+    /** Context window limit. Omit to leave the current limit untouched. */
+    contextWindow?: number;
+}
+export type ModelConfigTarget = {
+    scope: "agent";
+    agentId: string;
+} | {
+    scope: "conversation";
+    conversationId: string;
+    agentId?: string | null;
+};
+/**
+ * Applies a partial model-config update (model, reasoning effort, and/or context
+ * window) without rebuilding settings the caller did not touch.
+ *
+ * - Only `contextWindow`: sends `context_window_limit` alone, preserving the
+ *   current model and model_settings (including reasoning effort).
+ * - `reasoningEffort` without `model`: resolves the current model handle so
+ *   model_settings can be rebuilt for the right provider.
+ * - `model` (with optional effort/context): rebuilds model_settings and derives
+ *   a context window when one is not supplied, matching updateAgentLLMConfig.
+ *
+ * Routes through the supplied backend's updateAgent/updateConversation, so it
+ * works for both local and cloud agents.
+ */
+export declare function updateModelConfig(backend: Backend, target: ModelConfigTarget, update: ModelConfigUpdate): Promise<void>;
+/**
+ * Recompile an agent's system prompt after memory writes so server-side prompt
+ * state picks up the latest memory content.
+ *
+ * @param conversationId - The conversation whose prompt should be recompiled
+ * @param agentId - Agent id for the parent conversation
+ * @param dryRun - Optional dry-run control
+ * @param clientOverride - Optional injected client for tests
+ * @returns The compiled system prompt returned by the API
+ */
+export declare function recompileAgentSystemPrompt(conversationId: string, agentId: string, dryRun?: boolean, clientOverride?: {
+    conversations: {
+        recompile: (conversationId: string, params: {
+            dry_run?: boolean;
+            agent_id?: string;
+        }) => Promise<string>;
+    };
+}): Promise<string>;
+export interface SystemPromptUpdateResult {
+    success: boolean;
+    message: string;
+}
+/**
+ * Updates an agent's system prompt with raw content.
+ *
+ * @param agentId - The agent ID
+ * @param systemPromptContent - The raw system prompt content to update
+ * @returns Result with success status and message
+ */
+export declare function updateAgentSystemPromptRaw(agentId: string, systemPromptContent: string): Promise<SystemPromptUpdateResult>;
+/**
+ * Result from updating a system prompt on an agent
+ */
+export interface UpdateSystemPromptResult {
+    success: boolean;
+    message: string;
+    agent: AgentState | null;
+}
+/**
+ * Updates an agent's system prompt by ID or subagent name.
+ * Resolves the ID to content, updates the agent, and returns the refreshed agent state.
+ *
+ * @param agentId - The agent ID to update
+ * @param systemPromptId - System prompt ID (e.g., "codex") or subagent name (e.g., "recall")
+ * @returns Result with success status, message, and updated agent state
+ */
+export declare function updateAgentSystemPrompt(agentId: string, systemPromptId: string): Promise<UpdateSystemPromptResult>;
+/**
+ * Updates an agent's system prompt to the memfs full-prompt variant when
+ * the stored managed prompt hash is known. Custom prompts are already complete
+ * and are left unchanged.
+ *
+ * MemFS cannot be disabled, so there is no path back to the standard variant.
+ *
+ * @param agentId - The agent ID to update
+ * @returns Result with success status and message
+ */
+export declare function updateAgentSystemPromptMemfs(agentId: string): Promise<SystemPromptUpdateResult>;
+export {};
+//# sourceMappingURL=modify.d.ts.map

package/dist/types/agent/modify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modify.d.ts","sourceRoot":"","sources":["../../../src/agent/modify.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EACV,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,gDAAgD,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,OAAO,EAAgB,KAAK,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAErE,KAAK,aAAa,GACd,mBAAmB,GACnB,sBAAsB,GACtB,qBAAqB,GACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAU5B;;;GAGG;AACH,iBAAS,kBAAkB,CACzB,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,aAAa,CA4Of;AAED,eAAO,MAAM,iBAAiB;;;CAG7B,CAAC;AAEF,iBAAS,0BAA0B,CACjC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC/C,OAAO,EAAE;IAAE,sBAAsB,EAAE,OAAO,CAAA;CAAE,GAC3C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CASrC;AAaD;;;;;;;;;GASG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;;OAOG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAmED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,UAAU,CAAC,CAgCrB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,2BAA2B,CAC/C,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,YAAY,CAAC,CA8CvB;AAED,MAAM,WAAW,iBAAiB;IAChC,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAC1C,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AA+C/E;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,IAAI,CAAC,CA0Df;AAED;;;;;;;;;GASG;AACH,wBAAsB,0BAA0B,CAC9C,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,OAAO,EAChB,cAAc,CAAC,EAAE;IACf,aAAa,EAAE;QACb,SAAS,EAAE,CACT,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE;YACN,OAAO,CAAC,EAAE,OAAO,CAAC;YAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,KACE,OAAO,CAAC,MAAM,CAAC,CAAC;KACtB,CAAC;CACH,GACA,OAAO,CAAC,MAAM,CAAC,CAsBjB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,MAAM,EACf,mBAAmB,EAAE,MAAM,GAC1B,OAAO,CAAC,wBAAwB,CAAC,CAgBnC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,wBAAwB,CAAC,CAqEnC;AAED;;;;;;;;;GASG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,wBAAwB,CAAC,CAgFnC"}

package/dist/types/agent/personality-default-files.d.ts

@@ -0,0 +1,17 @@
+import { type MemoryWriteSyncMode } from "./memory-git";
+import { type PersonalityAssetId } from "./personality-presets";
+export interface SeedPersonalityDefaultMemoryFilesParams {
+    agentId: string;
+    memoryDir: string;
+    agentTags?: readonly string[] | null;
+    syncMode?: MemoryWriteSyncMode;
+}
+export interface SeedPersonalityDefaultMemoryFilesResult {
+    seededPaths: string[];
+    skippedPaths: string[];
+    errors: string[];
+}
+export declare function getPersonalityAssetPath(assetId: PersonalityAssetId): string;
+export declare function seedPersonalityDefaultMemoryFiles(params: SeedPersonalityDefaultMemoryFilesParams): Promise<SeedPersonalityDefaultMemoryFilesResult>;
+export declare function seedPersonalityDefaultMemoryFilesBestEffort(params: SeedPersonalityDefaultMemoryFilesParams): Promise<SeedPersonalityDefaultMemoryFilesResult>;
+//# sourceMappingURL=personality-default-files.d.ts.map

package/dist/types/agent/personality-default-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personality-default-files.d.ts","sourceRoot":"","sources":["../../../src/agent/personality-default-files.ts"],"names":[],"mappings":"AAaA,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,cAAc,CAAC;AACtB,OAAO,EAGL,KAAK,kBAAkB,EAExB,MAAM,uBAAuB,CAAC;AAI/B,MAAM,WAAW,uCAAuC;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CAChC;AAED,MAAM,WAAW,uCAAuC;IACtD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAUD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAM3E;AAwED,wBAAsB,iCAAiC,CACrD,MAAM,EAAE,uCAAuC,GAC9C,OAAO,CAAC,uCAAuC,CAAC,CA8FlD;AAED,wBAAsB,2CAA2C,CAC/D,MAAM,EAAE,uCAAuC,GAC9C,OAAO,CAAC,uCAAuC,CAAC,CAsBlD"}

package/dist/types/agent/skill-sources.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Source of a skill (for display and override resolution)
+ */
+export type SkillSource = "bundled" | "global" | "agent" | "project";
+export declare const ALL_SKILL_SOURCES: SkillSource[];
+export type SkillSourceSpecifier = SkillSource | "all";
+export type SkillSourceSelectionInput = {
+    skillSourcesRaw?: string;
+    noSkills?: boolean;
+    noBundledSkills?: boolean;
+};
+export declare function isSkillSourceArray(value: unknown): value is SkillSource[];
+export declare function parseSkillSourcesList(skillSourcesRaw: string): SkillSource[];
+export declare function resolveSkillSourcesSelection(input: SkillSourceSelectionInput): SkillSource[];
+//# sourceMappingURL=skill-sources.d.ts.map

package/dist/types/agent/skill-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-sources.d.ts","sourceRoot":"","sources":["../../../src/agent/skill-sources.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAErE,eAAO,MAAM,iBAAiB,EAAE,WAAW,EAK1C,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,KAAK,CAAC;AAEvD,MAAM,MAAM,yBAAyB,GAAG;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAWF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,EAAE,CAKzE;AAOD,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,MAAM,GAAG,WAAW,EAAE,CAgC5E;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,yBAAyB,GAC/B,WAAW,EAAE,CAcf"}

package/dist/types/agent/skills.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Skills module - provides skill discovery and management functionality
+ *
+ * Skills are discovered from four sources (in order of priority):
+ * 1. Project skills: .agents/skills/ in current directory, with .skills/ as a legacy fallback (highest priority - overrides)
+ * 2. Agent skills: ~/.letta/agents/{agent-id}/memory/skills/ for agent-specific skills
+ * 3. Global skills: ~/.letta/skills/ for user's personal skills
+ * 4. Bundled skills: embedded in package (lowest priority - defaults)
+ */
+import { type SkillSource } from "./skill-sources";
+export type { SkillSource } from "./skill-sources";
+/**
+ * Represents a skill that can be used by the agent
+ */
+export interface Skill {
+    /** Unique identifier for the skill */
+    id: string;
+    /** Human-readable name of the skill */
+    name: string;
+    /** Description of what the skill does and when to use it */
+    description: string;
+    /** Optional additional trigger guidance from `when_to_use` frontmatter */
+    whenToUse?: string;
+    /** Hint shown in slash-command autocomplete */
+    argumentHint?: string;
+    /** If true, hide from model auto-invocation / Skill tool listings */
+    disableModelInvocation?: boolean;
+    /** If false, hide from slash-command user invocation */
+    userInvocable?: boolean;
+    /** Optional category for organizing skills */
+    category?: string;
+    /** Optional tags for filtering/searching skills */
+    tags?: string[];
+    /** Path to the skill file (empty for bundled skills) */
+    path: string;
+    /** Source of the skill */
+    source: SkillSource;
+    /** Raw content of the skill (for bundled skills) */
+    content?: string;
+}
+/**
+ * Represents the result of skill discovery
+ */
+export interface SkillDiscoveryResult {
+    /** List of discovered skills */
+    skills: Skill[];
+    /** Any errors encountered during discovery */
+    errors: SkillDiscoveryError[];
+}
+export interface SkillDiscoveryOptions {
+    skipBundled?: boolean;
+    sources?: SkillSource[];
+}
+/**
+ * Represents an error that occurred during skill discovery
+ */
+export interface SkillDiscoveryError {
+    /** Path where the error occurred */
+    path: string;
+    /** Error message */
+    message: string;
+}
+export declare function compareSkills(a: Skill, b: Skill): number;
+export declare function getFrontmatterString(frontmatter: Record<string, string | string[]>, key: string): string | undefined;
+export declare function getFrontmatterStringList(frontmatter: Record<string, string | string[]>, key: string): string[] | undefined;
+export declare function getFrontmatterBoolean(frontmatter: Record<string, string | string[]>, key: string): boolean | undefined;
+export declare function isModelInvocableSkill(skill: Skill): boolean;
+export declare function isUserInvocableSkill(skill: Skill): boolean;
+export declare function isSkillAvailableForAgent(skill: Skill, agentId?: string): boolean;
+/**
+ * Canonical directory where project skills are stored.
+ */
+export declare const PROJECT_SKILLS_DIR: string;
+/**
+ * Legacy directory name where project skills were stored.
+ */
+export declare const SKILLS_DIR = ".skills";
+/**
+ * Global skills directory (in user's home directory)
+ */
+export declare const GLOBAL_SKILLS_DIR: string;
+/**
+ * Get the agent-scoped skills directory for a specific agent.
+ * Primary path is ~/.letta/agents/{id}/memory/skills/ (memfs).
+ */
+export declare function getAgentSkillsDir(agentId: string): string;
+/**
+ * Parse a bundled skill from its embedded content
+ */
+/**
+ * Get bundled skills by discovering from the bundled skills directory
+ */
+export declare function getBundledSkills(): Promise<Skill[]>;
+/**
+ * Discovers skills from all sources (bundled, global, agent, project)
+ * Later sources override earlier ones with the same ID.
+ *
+ * Priority order (highest to lowest):
+ * 1. Project skills (the provided project skills path; callers may scan .agents/skills before .skills)
+ * 2. Agent skills (~/.letta/agents/{agent-id}/memory/skills/)
+ * 3. Global skills (~/.letta/skills/)
+ * 4. Bundled skills (embedded in package)
+ *
+ * @param projectSkillsPath - The project skills directory (default: .skills in current directory)
+ * @param agentId - Optional agent ID for agent-scoped skills
+ * @returns A result containing discovered skills and any errors
+ */
+export declare function discoverSkills(projectSkillsPath?: string, agentId?: string, options?: SkillDiscoveryOptions): Promise<SkillDiscoveryResult>;
+/**
+ * Format discovered skills as a system reminder for injection into conversation.
+ * Returns empty string if no skills are available.
+ *
+ * Format: `- name (source): description` for each skill.
+ */
+export declare function formatSkillsAsSystemReminder(skills: Skill[]): string;
+//# sourceMappingURL=skills.d.ts.map

package/dist/types/agent/skills.d.ts.map

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

package/dist/types/agent/subagent-state.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Subagent state management for tracking active subagents
+ *
+ * This module provides a centralized state store that bridges non-React code
+ * (manager.ts) with React components (SubagentGroupDisplay.tsx).
+ * Uses an event-emitter pattern compatible with React's useSyncExternalStore.
+ */
+export interface ToolCall {
+    id: string;
+    name: string;
+    args: string;
+}
+export interface SubagentState {
+    id: string;
+    type: string;
+    description: string;
+    prompt?: string;
+    status: "pending" | "running" | "completed" | "error";
+    agentId?: string | null;
+    agentURL: string | null;
+    conversationId?: string | null;
+    toolCalls: ToolCall[];
+    maxToolCallsSeen: number;
+    totalTokens: number;
+    durationMs: number;
+    error?: string;
+    model?: string;
+    startTime: number;
+    toolCallId?: string;
+    isBackground?: boolean;
+    silent?: boolean;
+    parentAgentId?: string;
+    parentConversationId?: string;
+}
+export type SubagentLifecycleStatus = SubagentState["status"];
+export interface SubagentLifecycleItem {
+    id: string;
+    type: string;
+    description: string;
+    status: SubagentLifecycleStatus;
+    agentId: string | null;
+    agentUrl: string | null;
+    startedAtMs: number;
+    elapsedMs: number;
+    isBackground: boolean;
+    visibleInTranscript: boolean;
+}
+export interface SubagentLifecycleContext {
+    list(): SubagentLifecycleItem[];
+}
+/**
+ * Generate a unique subagent ID
+ */
+export declare function generateSubagentId(): string;
+/**
+ * Get a subagent by its parent Task tool call ID
+ */
+export declare function getSubagentByToolCallId(toolCallId: string): SubagentState | undefined;
+/**
+ * Register a new subagent when Task tool starts
+ */
+export declare function registerSubagent(id: string, type: string, description: string, toolCallId?: string, isBackground?: boolean, silent?: boolean, parentScope?: {
+    agentId?: string | null;
+    conversationId?: string | null;
+}, prompt?: string): void;
+/**
+ * Update a subagent's state
+ */
+export declare function updateSubagent(id: string, updates: Partial<Omit<SubagentState, "id">>): void;
+/**
+ * Add a tool call to a subagent
+ */
+export declare function addToolCall(subagentId: string, toolCallId: string, toolName: string, toolArgs: string): void;
+/**
+ * Mark a subagent as completed
+ */
+export declare function completeSubagent(id: string, result: {
+    success: boolean;
+    error?: string;
+    totalTokens?: number;
+}): void;
+export declare function __setCompletedSubagentRetentionMsForTests(ms: number): void;
+export declare function __resetCompletedSubagentRetentionMsForTests(): void;
+export declare function getSubagentToolCount(agent: Pick<SubagentState, "toolCalls" | "maxToolCallsSeen">): number;
+/**
+ * Toggle expanded/collapsed state
+ */
+export declare function toggleExpanded(): void;
+/**
+ * Get current expanded state
+ */
+export declare function isExpanded(): boolean;
+/**
+ * Get all active subagents (not yet cleared)
+ */
+export declare function getSubagents(): SubagentState[];
+/**
+ * Get silent background agents that are still pending or running
+ */
+export declare function getActiveBackgroundAgents(): SubagentState[];
+export declare function getSubagentLifecycleItems(): SubagentLifecycleItem[];
+export declare function getSubagentLifecycleSnapshot(): SubagentLifecycleItem[];
+export declare function getSubagentLifecycleContext(): SubagentLifecycleContext;
+export declare function subscribeToSubagentLifecycle(listener: () => void): () => void;
+/**
+ * Get subagents grouped by type
+ */
+export declare function getGroupedSubagents(): Map<string, SubagentState[]>;
+/**
+ * Clear all completed subagents (call on new user message)
+ */
+export declare function clearCompletedSubagents(): void;
+/**
+ * Clear specific subagents by their IDs (call when committing to staticItems)
+ */
+export declare function clearSubagentsByIds(ids: string[]): void;
+/**
+ * Clear all subagents
+ */
+export declare function clearAllSubagents(): void;
+/**
+ * Check if there are any active subagents
+ */
+export declare function hasActiveSubagents(): boolean;
+/**
+ * Mark all running/pending subagents as interrupted
+ * Called when user presses ESC to interrupt execution
+ */
+export declare function interruptActiveSubagents(errorMessage: string): void;
+/**
+ * Subscribe to store changes
+ */
+export declare function subscribe(listener: () => void): () => void;
+/**
+ * Get a snapshot of the current state for React
+ * Returns cached snapshot - only updates when notifyListeners is called
+ */
+export declare function getSnapshot(): {
+    agents: SubagentState[];
+    expanded: boolean;
+};
+/**
+ * A raw message-type event from the subagent's stdout (headless format).
+ * Shape: { type: "message", message_type: string, ...LettaStreamingResponse fields }
+ */
+export interface SubagentStreamEvent {
+    type: "message";
+    message_type: string;
+    [key: string]: unknown;
+}
+/**
+ * Callback for forwarding raw subagent stream events to the WS layer.
+ * The event is the parsed JSON line from the subagent's stdout.
+ */
+export type SubagentStreamEventListener = (subagentId: string, event: SubagentStreamEvent) => void;
+/**
+ * Subscribe to raw subagent stream events (for WS forwarding).
+ * Returns an unsubscribe function.
+ */
+export declare function subscribeToStreamEvents(listener: SubagentStreamEventListener): () => void;
+/**
+ * Emit a raw stream event from a subagent. Called from processStreamEvent
+ * in manager.ts for message-type events that should be forwarded to the web UI.
+ */
+export declare function emitStreamEvent(subagentId: string, event: SubagentStreamEvent): void;
+//# sourceMappingURL=subagent-state.d.ts.map

package/dist/types/agent/subagent-state.d.ts.map

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

package/dist/types/agent/subagents/context-budget.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Conservative startup-context budgeting for subagents.
+ *
+ * We intentionally avoid tokenizer dependencies here. The estimate is used only
+ * as a safety guard before sending prompts to the API; using 4 chars/token is
+ * conservative enough for English/Markdown prompts while keeping the codepath
+ * synchronous and dependency-free.
+ */
+export declare const STARTUP_CONTEXT_ESTIMATED_CHARS_PER_TOKEN = 4;
+export declare const REFLECTION_STARTUP_CONTEXT_TOKEN_LIMIT = 16000;
+export declare const REFLECTION_STARTUP_CONTEXT_CHAR_LIMIT: number;
+export declare const REFLECTION_PARENT_MEMORY_SNAPSHOT_CHAR_LIMIT = 40000;
+export declare function estimateStartupContextTokens(text: string): number;
+//# sourceMappingURL=context-budget.d.ts.map

package/dist/types/agent/subagents/context-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-budget.d.ts","sourceRoot":"","sources":["../../../../src/agent/subagents/context-budget.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,yCAAyC,IAAI,CAAC;AAC3D,eAAO,MAAM,sCAAsC,QAAS,CAAC;AAC7D,eAAO,MAAM,qCAAqC,QAEP,CAAC;AAI5C,eAAO,MAAM,4CAA4C,QAAS,CAAC;AAEnE,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjE"}

package/dist/types/agent/subagents/index.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Subagent configuration, discovery, and management
+ *
+ * Built-in subagents are bundled with the package.
+ * Users can also define custom subagents as Markdown files with YAML frontmatter
+ * in the .letta/agents/ directory.
+ */
+/**
+ * Subagent configuration
+ */
+export type SubagentLaunchProfile = "default" | "memory-subagent";
+export type SubagentRecommendedModelSource = "builtin" | "user";
+/** Exact memory scope handed to a harness-created memory worktree. */
+export interface SubagentMemoryScope {
+    primaryRoot: string | null;
+    writableRoots: string[];
+    readonlyRoots?: string[];
+}
+/**
+ * Subagent execution result
+ */
+export interface SubagentResult {
+    agentId: string;
+    conversationId?: string;
+    report: string;
+    success: boolean;
+    error?: string;
+    totalTokens?: number;
+    stepCount?: number;
+    durationMs?: number;
+}
+export interface SubagentConfig {
+    /** Unique identifier for the subagent */
+    name: string;
+    /** Description of when to use this subagent */
+    description: string;
+    /** System prompt for the subagent */
+    systemPrompt: string;
+    /** Allowed tools - specific list or "all" (invalid names are ignored at runtime) */
+    allowedTools: string[] | "all";
+    /** Recommended model - any model ID from models.json or full handle */
+    recommendedModel: string;
+    /** Whether the recommended model came from bundled defaults or user config. */
+    recommendedModelSource?: SubagentRecommendedModelSource;
+    /** Skills to auto-load */
+    skills: string[];
+    /** Whether this subagent should fork the parent conversation before launch. */
+    fork: boolean;
+    /** Whether this subagent should run in the background by default. */
+    background: boolean;
+    /** Filesystem and env launch behavior for this subagent. */
+    launchProfile: SubagentLaunchProfile;
+}
+/**
+ * Result of subagent discovery
+ */
+export interface SubagentDiscoveryResult {
+    subagents: SubagentConfig[];
+    errors: Array<{
+        path: string;
+        message: string;
+    }>;
+}
+/**
+ * Directory for subagent files (relative to project root)
+ */
+export declare const AGENTS_DIR = ".letta/agents";
+export declare const GLOBAL_AGENTS_DIR: string;
+/**
+ * Get the names of built-in subagents
+ */
+export declare function getBuiltinSubagentNames(): Set<string>;
+/**
+ * Discover subagents from global (~/.letta/agents) and project (.letta/agents) directories
+ * Project-level subagents override global ones with the same name
+ */
+export declare function discoverSubagents(workingDirectory?: string, inheritedConfigs?: Record<string, SubagentConfig>): Promise<SubagentDiscoveryResult>;
+/**
+ * Get all subagent configurations
+ * Includes built-in subagents and any user-defined ones from .letta/agents/
+ * User-defined subagents override built-ins with the same name
+ * Results are cached per working directory
+ */
+export declare function getAllSubagentConfigs(workingDirectory?: string): Promise<Record<string, SubagentConfig>>;
+/**
+ * Clear the subagent config cache (useful when files change)
+ */
+export declare function clearSubagentConfigCache(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/agent/subagents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/agent/subagents/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA6CH;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,iBAAiB,CAAC;AAClE,MAAM,MAAM,8BAA8B,GAAG,SAAS,GAAG,MAAM,CAAC;AAEhE,sEAAsE;AACtE,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,YAAY,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAC/B,uEAAuE;IACvE,gBAAgB,EAAE,MAAM,CAAC;IACzB,+EAA+E;IAC/E,sBAAsB,CAAC,EAAE,8BAA8B,CAAC;IACxD,0BAA0B;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,+EAA+E;IAC/E,IAAI,EAAE,OAAO,CAAC;IACd,qEAAqE;IACrE,UAAU,EAAE,OAAO,CAAC;IACpB,4DAA4D;IAC5D,aAAa,EAAE,qBAAqB,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAMD;;GAEG;AACH,eAAO,MAAM,UAAU,kBAAkB,CAAC;AAY1C,eAAO,MAAM,iBAAiB,QAAuB,CAAC;AA0QtD;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,GAAG,CAAC,MAAM,CAAC,CAErD;AAsDD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,gBAAgB,GAAE,MAAsB,EACxC,gBAAgB,GAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAE9C,GACA,OAAO,CAAC,uBAAuB,CAAC,CAuBlC;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,gBAAgB,GAAE,MAAsB,GACvC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAsCzC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAI/C"}

package/dist/types/agent/subagents/manager.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Subagent manager for spawning and coordinating subagents
+ *
+ * This module handles:
+ * - Spawning subagents via letta CLI in headless mode
+ * - Executing subagents and collecting final reports
+ * - Managing parallel subagent execution
+ */
+import { type BackendMode } from "../../backend";
+import { type SubagentConfig, type SubagentMemoryScope, type SubagentResult } from ".";
+export declare function buildSubagentPrompt(type: string, config: SubagentConfig, userPrompt: string): string;
+interface BuildSubagentArgsOptions {
+    backendMode?: BackendMode;
+    promptTransport?: "argv" | "stdin";
+    /** Runtime platform override for launcher tests. */
+    platform?: NodeJS.Platform;
+    extraTools?: string[];
+    parentAgentId?: string | null;
+    /**
+     * Replace the subagent's configured persona: pass `--system-custom <text>`
+     * to the child instead of `--system <type>`. Only applies to new agents.
+     */
+    systemPromptOverride?: string;
+}
+/**
+ * Build CLI arguments for spawning a subagent
+ */
+export declare function buildSubagentArgs(type: string, config: SubagentConfig, model: string | null, userPrompt: string, existingAgentId?: string, existingConversationId?: string, maxTurns?: number, options?: BuildSubagentArgsOptions): string[];
+export declare function recallPromptForBackend(backendMode?: BackendMode): string;
+/**
+ * Spawn a subagent and execute it autonomously
+ *
+ * @param type - Subagent type (e.g., "code-reviewer", "general-purpose")
+ * @param prompt - The task prompt for the subagent
+ * @param userModel - Optional model override from the parent agent
+ * @param subagentId - ID for tracking in the state store (registered by Task tool)
+ * @param signal - Optional abort signal for interruption handling
+ * @param existingAgentId - Optional ID of an existing agent to deploy
+ * @param existingConversationId - Optional conversation ID to resume
+ * @param parentAgentId - Parent agent ID captured at the synchronous call
+ *   site. Preferred over reading `getCurrentAgentId()` here because this
+ *   function runs after several async yields and the in-process context
+ *   may have drifted (e.g., the listener processing another agent's turn).
+ */
+export declare function spawnSubagent(type: string, prompt: string, userModel: string | undefined, subagentId: string, signal?: AbortSignal, existingAgentId?: string, existingConversationId?: string, maxTurns?: number, forkedContext?: boolean, parentAgentId?: string, transcriptPath?: string, parentConversationId?: string, memoryScope?: SubagentMemoryScope, systemPromptOverride?: string): Promise<SubagentResult>;
+export {};
+//# sourceMappingURL=manager.d.ts.map

package/dist/types/agent/subagents/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../src/agent/subagents/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,OAAO,EACL,KAAK,WAAW,EAGjB,MAAM,WAAW,CAAC;AAkBnB,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACpB,MAAM,GAAG,CAAC;AAqJX,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAED,UAAU,wBAAwB;IAChC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,UAAU,EAAE,MAAM,EAClB,eAAe,CAAC,EAAE,MAAM,EACxB,sBAAsB,CAAC,EAAE,MAAM,EAC/B,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,GAAE,wBAA6B,GACrC,MAAM,EAAE,CAgHV;AAqZD,wBAAgB,sBAAsB,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,MAAM,CAIxE;AAsCD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,WAAW,EACpB,eAAe,CAAC,EAAE,MAAM,EACxB,sBAAsB,CAAC,EAAE,MAAM,EAC/B,QAAQ,CAAC,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,OAAO,EACvB,aAAa,CAAC,EAAE,MAAM,EACtB,cAAc,CAAC,EAAE,MAAM,EACvB,oBAAoB,CAAC,EAAE,MAAM,EAC7B,WAAW,CAAC,EAAE,mBAAmB,EACjC,oBAAoB,CAAC,EAAE,MAAM,GAC5B,OAAO,CAAC,cAAc,CAAC,CAmHzB"}