@letta-ai/letta-code 0.30.2 → 0.30.3

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

@@ -0,0 +1 @@
+{"version":3,"file":"truncation.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/truncation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,eAAO,MAAM,MAAM;;;;;;;;;;CAoBT,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAiB,EAC3B,OAAO,CAAC,EAAE,iBAAiB,GAC1B;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAqDnE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,eAAe,CAAC,EAAE,MAAM,EACxB,QAAQ,GAAE,MAAiB,EAC3B,OAAO,CAAC,EAAE,iBAAiB,GAC1B;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAsFA;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,CAAC,EAAE,EACV,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,MAAM,EACjC,QAAQ,GAAE,MAAgB,EAC1B,QAAQ,GAAE,MAAiB,EAC3B,OAAO,CAAC,EAAE,iBAAiB,GAC1B;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CA8DnE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjD"}

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

@@ -0,0 +1,13 @@
+/**
+ * UpdatePlan tool implementation
+ *
+ * This is a no-op tool that exists purely to give the model a structured way
+ * to communicate its plan to the client for rendering. The tool call arguments
+ * are what matter, not the execution.
+ *
+ * Matches the Codex update_plan tool behavior.
+ */
+export declare function update_plan(_args: Record<string, unknown>): Promise<{
+    message: string;
+}>;
+//# sourceMappingURL=update-plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-plan.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/update-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAM9B"}

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

@@ -0,0 +1,15 @@
+export declare function validateRequiredParams<T extends object>(args: T, required: string[], toolName: string): void;
+interface JsonSchema {
+    type?: string;
+    properties?: Record<string, JsonSchema>;
+    items?: JsonSchema;
+    required?: string[];
+    [key: string]: unknown;
+}
+/**
+ * Validates that parameter values match their expected types from the JSON schema.
+ * Throws a clear error if types don't match.
+ */
+export declare function validateParamTypes(args: Record<string, unknown>, schema: JsonSchema, toolName: string): void;
+export {};
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/validation.ts"],"names":[],"mappings":"AAAA,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,EACrD,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,MAAM,EAAE,EAClB,QAAQ,EAAE,MAAM,GACf,IAAI,CASN;AAED,UAAU,UAAU;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,MAAM,GACf,IAAI,CAyCN"}

package/dist/types/tools/impl/view-image.d.ts

@@ -0,0 +1,9 @@
+import { type ToolReturnContent } from "./read";
+interface ViewImageArgs {
+    path: string;
+}
+export declare function view_image(args: ViewImageArgs): Promise<{
+    content: ToolReturnContent;
+}>;
+export {};
+//# sourceMappingURL=view-image.d.ts.map

package/dist/types/tools/impl/view-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-image.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/view-image.ts"],"names":[],"mappings":"AAEA,OAAO,EAAQ,KAAK,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAGtD,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAkBD,wBAAsB,UAAU,CAC9B,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC;IAAE,OAAO,EAAE,iBAAiB,CAAA;CAAE,CAAC,CAczC"}

package/dist/types/tools/impl/write-file-gemini.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Gemini CLI write_file tool - wrapper around Letta Code's Write tool
+ * Uses Gemini's exact schema and description
+ */
+interface WriteFileGeminiArgs {
+    file_path: string;
+    content: string;
+}
+export declare function write_file_gemini(args: WriteFileGeminiArgs): Promise<{
+    message: string;
+}>;
+export {};
+//# sourceMappingURL=write-file-gemini.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write-file-gemini.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/write-file-gemini.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,UAAU,mBAAmB;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAM9B"}

package/dist/types/tools/impl/write-todos-gemini.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Gemini CLI write_todos tool - adapter for Letta Code's todo_write
+ * Uses Gemini's exact schema and description but adapts the params
+ */
+interface WriteTodosGeminiArgs {
+    todos: Array<{
+        description: string;
+        status: "pending" | "in_progress" | "completed" | "cancelled";
+    }>;
+}
+export declare function write_todos(args: WriteTodosGeminiArgs): Promise<{
+    message: string;
+    todos: typeof args.todos;
+}>;
+export {};
+//# sourceMappingURL=write-todos-gemini.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write-todos-gemini.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/write-todos-gemini.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,UAAU,oBAAoB;IAC5B,KAAK,EAAE,KAAK,CAAC;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,WAAW,CAAC;KAC/D,CAAC,CAAC;CACJ;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK,CAAA;CAAE,CAAC,CA6CxD"}

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

@@ -0,0 +1,10 @@
+interface WriteArgs {
+    file_path: string;
+    content: string;
+}
+interface WriteResult {
+    message: string;
+}
+export declare function write(args: WriteArgs): Promise<WriteResult>;
+export {};
+//# sourceMappingURL=write.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../../src/tools/impl/write.ts"],"names":[],"mappings":"AAOA,UAAU,SAAS;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AACD,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CA+BjE"}

package/dist/types/tools/interactive-policy.d.ts

@@ -0,0 +1,12 @@
+export type InteractiveApprovalKind = "ask_user_question";
+/**
+ * Tools that prompt the human for input mid-turn, as toolset names. Headless
+ * clients (SDK sessions, automation) can exclude these from the turn's
+ * toolset via `exclude_interactive_tools` on create_message payloads.
+ */
+export declare const INTERACTIVE_USER_INPUT_TOOL_NAMES: readonly ["AskUserQuestion"];
+export declare function isInteractiveApprovalTool(toolName: string): boolean;
+export declare function getInteractiveApprovalKind(toolName: string): InteractiveApprovalKind | null;
+export declare function requiresRuntimeUserInput(toolName: string): boolean;
+export declare function isHeadlessAutoAllowTool(toolName: string): boolean;
+//# sourceMappingURL=interactive-policy.d.ts.map

package/dist/types/tools/interactive-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-policy.d.ts","sourceRoot":"","sources":["../../../src/tools/interactive-policy.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,uBAAuB,GAAG,mBAAmB,CAAC;AAE1D;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,8BAEN,CAAC;AAQzC,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,GACf,uBAAuB,GAAG,IAAI,CAOhC;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAElE;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEjE"}

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

@@ -0,0 +1,355 @@
+import { type MessageChannelToolDiscoveryScope } from "../channels/message-tool";
+import type { ChannelTurnSource } from "../channels/types";
+import { type ModEvents } from "../mods/event-emitter";
+import { type ModPermissionDefinition } from "../mods/permission-registry";
+import { type ModToolDefinition } from "../mods/tool-registry";
+import type { ModContext, ToolApprovalPolicy } from "../mods/types";
+import type { PermissionDecision, PermissionRuleType } from "../permissions/types";
+import { type RuntimeContextSnapshot } from "../runtime-context";
+import { type JsonSchema, type ModelFacingToolForm } from "./model-facing-tool";
+import { type PermissionModeState } from "./permission-mode-state";
+import { type ToolName } from "./tool-definitions";
+export declare const TOOL_NAMES: ToolName[];
+/**
+ * Get the server-facing name for a tool (maps internal names to what the model sees)
+ */
+export declare function getServerToolName(internalName: string): string;
+/**
+ * Get the internal tool name from a server-facing name
+ * Used when the server sends back tool calls/approvals with server names
+ */
+export declare function getInternalToolName(serverName: string): string;
+export declare function filterBuiltInToolNamesByClientAllowlist(toolNames: ToolName[], clientToolAllowlist?: string[]): ToolName[];
+export declare const ANTHROPIC_DEFAULT_TOOLS: ToolName[];
+export declare const OPENAI_DEFAULT_TOOLS: ToolName[];
+export declare const GEMINI_DEFAULT_TOOLS: ToolName[];
+export declare const OPENAI_PASCAL_TOOLS: ToolName[];
+export declare const GEMINI_PASCAL_TOOLS: ToolName[];
+type ToolArgs = Record<string, unknown>;
+interface ToolSchema {
+    name: string;
+    description: string;
+    input_schema: JsonSchema;
+}
+interface ToolDefinition {
+    schema: ToolSchema;
+    modelForm: ModelFacingToolForm;
+    fn: (args: ToolArgs) => Promise<unknown>;
+}
+import type { ImageContent, TextContent } from "@letta-ai/letta-client/resources/agents/messages";
+export type ToolReturnContent = string | Array<TextContent | ImageContent>;
+export type ToolExecutionResult = {
+    toolReturn: ToolReturnContent;
+    status: "success" | "error";
+    stdout?: string[];
+    stderr?: string[];
+};
+type ToolRegistry = Map<string, ToolDefinition>;
+type ToolExecutionContextSnapshot = {
+    toolRegistry: ToolRegistry;
+    externalTools: Map<string, ExternalToolDefinition>;
+    externalExecutor?: ExternalToolExecutor;
+    modContext?: ModContext;
+    modEvents?: ModEvents;
+    modPermissions: Map<string, ModPermissionDefinition>;
+    modTools: Map<string, ModToolDefinition>;
+    workingDirectory: string;
+    runtimeContext: RuntimeContextSnapshot;
+    permissionModeState: PermissionModeState;
+};
+export type CapturedToolExecutionContext = {
+    contextId: string;
+    clientTools: ClientTool[];
+};
+export type PreparedToolExecutionContext = CapturedToolExecutionContext & {
+    loadedToolNames: string[];
+};
+export declare function getExecutionContextById(contextId: string): ToolExecutionContextSnapshot | undefined;
+export declare function updateToolExecutionContextWorkingDirectory(contextId: string, workingDirectory: string): boolean;
+/**
+ * Returns the mutable PermissionModeState for an execution context.
+ */
+export declare function getExecutionContextPermissionModeState(contextId: string): PermissionModeState | undefined;
+export declare function clearCapturedToolExecutionContexts(): void;
+export declare function releaseToolExecutionContext(contextId: string): void;
+/**
+ * Waits for any in-progress toolset switch to complete.
+ * Call this before reading from the registry to ensure you get the final toolset.
+ * Returns immediately if no switch is in progress.
+ */
+export declare function waitForToolsetReady(): Promise<void>;
+/**
+ * Checks if a toolset switch is currently in progress.
+ * Useful for synchronous checks where awaiting isn't possible.
+ */
+export declare function isToolsetSwitchInProgress(): boolean;
+/**
+ * ClientTool interface matching the Letta SDK's expected format.
+ * Used when passing client-side tools via the client_tools field.
+ */
+export interface ClientTool {
+    name: string;
+    description?: string | null;
+    parameters?: {
+        [key: string]: unknown;
+    } | null;
+}
+export interface ExternalToolDefinition {
+    name: string;
+    label?: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    /** Internal registration key; model-facing calls still use name. */
+    registrationKey?: string;
+    connectionId?: string;
+    /** Optional visibility scope; scoped tools are hidden unless selected for a turn. */
+    scopeId?: string;
+    /** Optional runtime owner; runtime-owned tools are visible only in that runtime. */
+    runtime?: {
+        agentId?: string;
+        conversationId?: string;
+    };
+    /** Client-local executor owned by this tool (for example an MCP process). */
+    executor?: ExternalToolExecutor;
+}
+/**
+ * Callback to execute an external tool via SDK
+ */
+export type ExternalToolExecutor = (toolCallId: string, toolName: string, input: Record<string, unknown>, context?: {
+    tool: ExternalToolDefinition;
+}) => Promise<{
+    content: Array<{
+        type: string;
+        text?: string;
+        data?: string;
+        mimeType?: string;
+    }>;
+    isError: boolean;
+}>;
+/**
+ * Register external tools from SDK
+ */
+export declare function registerExternalTools(tools: ExternalToolDefinition[]): void;
+export declare function unregisterExternalTools(tools: ExternalToolDefinition[]): void;
+/**
+ * Set the executor callback for external tools
+ */
+export declare function setExternalToolExecutor(executor: ExternalToolExecutor): void;
+/**
+ * Clear external tools (for testing or session cleanup)
+ */
+export declare function clearExternalTools(): void;
+/**
+ * Check if a tool is external (SDK-executed)
+ */
+export declare function isExternalTool(name: string): boolean;
+/**
+ * Get external tool definition
+ */
+export declare function getExternalToolDefinition(name: string): ExternalToolDefinition | undefined;
+/**
+ * Get all external tools as ClientTool format
+ */
+export declare function getExternalToolsAsClientTools(): ClientTool[];
+/**
+ * Execute an external tool via SDK
+ */
+export declare function executeExternalTool(toolCallId: string, toolName: string, input: Record<string, unknown>, executorOverride?: ExternalToolExecutor, toolDefinition?: ExternalToolDefinition): Promise<ToolExecutionResult>;
+/**
+ * Get all loaded tools in the format expected by the Letta API's client_tools field.
+ * Maps internal tool names to server-facing names for proper tool invocation.
+ * Includes built-in, external, and mod tools.
+ */
+export declare function getClientToolsFromRegistry(): ClientTool[];
+/**
+ * Capture a turn-scoped tool snapshot and corresponding client_tools payload.
+ * The returned context id can be used later to execute tool calls against this
+ * exact snapshot even if the global registry changes between dispatch and execute.
+ */
+export declare function captureToolExecutionContext(workingDirectory?: string, permissionModeState?: PermissionModeState, modContext?: ModContext): CapturedToolExecutionContext;
+export declare function prepareCurrentToolExecutionContext(options?: {
+    workingDirectory?: string;
+    permissionModeState?: PermissionModeState;
+    runtimeContext?: Partial<RuntimeContextSnapshot>;
+    channelToolScope?: MessageChannelToolDiscoveryScope | null;
+    channelTurnSources?: ChannelTurnSource[];
+    modContext?: ModContext;
+    modEvents?: ModEvents;
+    modPermissions?: Map<string, ModPermissionDefinition>;
+    modTools?: Map<string, ModToolDefinition>;
+}): Promise<PreparedToolExecutionContext>;
+export declare function prepareToolExecutionContextForSpecificTools(toolNames: string[], options?: {
+    clientToolAllowlist?: string[];
+    externalToolScopeIds?: string[];
+    workingDirectory?: string;
+    permissionModeState?: PermissionModeState;
+    channelToolScope?: MessageChannelToolDiscoveryScope | null;
+    channelTurnSources?: ChannelTurnSource[];
+    modContext?: ModContext;
+    modEvents?: ModEvents;
+    modPermissions?: Map<string, ModPermissionDefinition>;
+    modTools?: Map<string, ModToolDefinition>;
+    runtimeContext?: Partial<RuntimeContextSnapshot>;
+}): Promise<PreparedToolExecutionContext>;
+export declare function prepareToolExecutionContextForModel(modelIdentifier?: string, options?: {
+    exclude?: ToolName[];
+    include?: ToolName[];
+    clientToolAllowlist?: string[];
+    externalToolScopeIds?: string[];
+    workingDirectory?: string;
+    permissionModeState?: PermissionModeState;
+    channelToolScope?: MessageChannelToolDiscoveryScope | null;
+    channelTurnSources?: ChannelTurnSource[];
+    modContext?: ModContext;
+    modEvents?: ModEvents;
+    modPermissions?: Map<string, ModPermissionDefinition>;
+    modTools?: Map<string, ModToolDefinition>;
+    runtimeContext?: Partial<RuntimeContextSnapshot>;
+}): Promise<PreparedToolExecutionContext>;
+/**
+ * Get permissions for a specific tool.
+ * @param toolName - The name of the tool
+ * @returns Tool permissions object with requiresApproval flag
+ */
+export declare function getToolPermissions(toolName: string): {
+    requiresApproval: boolean;
+    approvalPolicy: ToolApprovalPolicy;
+};
+export declare function getToolApprovalPolicy(toolName: string, contextId?: string | null): ToolApprovalPolicy;
+export declare function isModToolParallelSafeForContext(toolName: string, contextId?: string): boolean;
+/**
+ * Check permission for a tool execution using the full permission system.
+ * @param toolName - Name of the tool
+ * @param toolArgs - Tool arguments
+ * @param workingDirectory - Current working directory (defaults to process.cwd())
+ * @returns Permission decision: "allow", "deny", "ask", or "alwaysAsk"
+ */
+export declare function checkToolPermission(toolName: string, toolArgs: ToolArgs, workingDirectory?: string, permissionModeStateArg?: PermissionModeState, agentIdArg?: string, toolContextIdArg?: string | null, toolCallIdArg?: string | null): Promise<{
+    decision: PermissionDecision;
+    matchedRule?: string;
+    reason?: string;
+}>;
+/**
+ * Save a permission rule to settings
+ * @param rule - Permission rule (e.g., "Read(src/**)")
+ * @param ruleType - Type of rule ("allow", "deny", "ask", or "alwaysAsk")
+ * @param scope - Where to save ("project", "local", "user", or "session")
+ * @param workingDirectory - Current working directory
+ */
+export declare function savePermissionRule(rule: string, ruleType: PermissionRuleType, scope: "project" | "local" | "user" | "session", workingDirectory?: string): Promise<void>;
+/**
+ * Analyze approval context for a tool execution
+ * @param toolName - Name of the tool
+ * @param toolArgs - Tool arguments
+ * @param workingDirectory - Current working directory
+ * @returns Approval context with recommended rule and button text
+ */
+export declare function analyzeToolApproval(toolName: string, toolArgs: ToolArgs, workingDirectory?: string): Promise<import("../permissions/analyzer").ApprovalContext>;
+/**
+ * Loads specific tools by name into the registry.
+ * Used when resuming an agent to load only the tools attached to that agent.
+ *
+ * Acquires the toolset switch lock during loading to prevent message sends from
+ * reading stale tools. Callers should use waitForToolsetReady() before sending messages.
+ *
+ * @param toolNames - Array of specific tool names to load
+ */
+export declare function loadSpecificTools(toolNames: string[]): Promise<void>;
+/**
+ * Loads all tools defined in TOOL_NAMES and constructs their full schemas + function references.
+ * This should be called on program startup.
+ * Will error if any expected tool files are missing.
+ *
+ * Acquires the toolset switch lock during loading to prevent message sends from
+ * reading stale tools. Callers should use waitForToolsetReady() before sending messages.
+ *
+ * @param modelIdentifier - Optional model identifier to select the appropriate toolset
+ * @param options - Optional configuration
+ * @param options.exclude - Tool names to exclude from the loaded toolset
+ * @returns Promise that resolves when all tools are loaded
+ */
+export declare function loadTools(modelIdentifier?: string, options?: {
+    exclude?: ToolName[];
+}): Promise<void>;
+export declare function isOpenAIModel(modelIdentifier: string): boolean;
+export declare function isGeminiModel(modelIdentifier: string): boolean;
+/**
+ * Helper to clip tool return text to a reasonable display size
+ * Used by UI components to truncate long responses for display
+ */
+export declare function clipToolReturn(text: string, maxLines?: number, maxChars?: number): string;
+/**
+ * Executes a tool by name with the provided arguments.
+ *
+ * @param name - The name of the tool to execute
+ * @param args - Arguments object to pass to the tool
+ * @param options - Optional execution options (abort signal, tool call ID, streaming callback)
+ * @returns Promise with the tool's execution result including status and optional stdout/stderr
+ */
+declare function executeToolInner(name: string, args: ToolArgs, options?: {
+    signal?: AbortSignal;
+    toolCallId?: string;
+    onOutput?: (chunk: string, stream: "stdout" | "stderr") => void;
+    toolContextId?: string;
+    parentScope?: {
+        agentId: string;
+        conversationId: string;
+    };
+    channelTurnSources?: ChannelTurnSource[];
+    /** Called after a file-mutating tool (Edit, Write, MultiEdit) writes to disk.
+     *  The listener layer uses this to broadcast the new content via WebSocket. */
+    onFileWrite?: (filePath: string, content: string) => void;
+    toolEndArgsRef?: {
+        current: ToolArgs;
+    };
+}): Promise<ToolExecutionResult>;
+/**
+ * Executes a tool and gives mods a chance to observe or replace the result via
+ * the `tool_end` event. A handler returning `{ result: { status, output } }`
+ * overrides what the agent sees (first handler wins). Only fires for string
+ * results — multimodal/image results pass through unchanged. Delivery is
+ * capability-gated (`events.tools`), so only enabled surfaces receive it.
+ *
+ * @param name - Name of the tool to execute
+ * @param args - Arguments object to pass to the tool
+ * @param options - Optional execution options (abort signal, tool call ID, streaming callback)
+ * @returns Promise with the tool's execution result including status and optional stdout/stderr
+ */
+export declare function executeTool(...params: Parameters<typeof executeToolInner>): Promise<ToolExecutionResult>;
+/**
+ * Gets all loaded tool names (for passing to Letta agent creation).
+ *
+ * @returns Array of tool names
+ */
+export declare function getToolNames(): string[];
+/**
+ * Returns all Letta Code tool names known to this build, regardless of what is currently loaded.
+ * Useful for unlinking/removing tools when switching providers/models.
+ */
+export declare function getAllLettaToolNames(): string[];
+/**
+ * Gets all loaded tool schemas (for inspection/debugging).
+ *
+ * @returns Array of tool schemas
+ */
+export declare function getToolSchemas(): ToolSchema[];
+/**
+ * Gets a single tool's schema by name.
+ *
+ * @param name - The tool name
+ * @returns The tool schema or undefined if not found
+ */
+export declare function getToolSchema(name: string, toolContextId?: string | null): ToolSchema | undefined;
+export declare function refreshDynamicChannelToolsInLoadedRegistry(): Promise<void>;
+/**
+ * Clears the tool registry (useful for testing).
+ */
+export declare function clearTools(): void;
+/**
+ * Clears the tool registry with lock protection.
+ * Acquires the switch lock, clears the registry, then releases the lock.
+ * This ensures sendMessageStream() waits for the clear to complete.
+ */
+export declare function clearToolsWithLock(): void;
+export {};
+//# sourceMappingURL=manager.d.ts.map

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

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

package/dist/types/tools/model-facing-tool.d.ts

@@ -0,0 +1,35 @@
+export interface JsonSchema {
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    [key: string]: unknown;
+}
+export type FunctionToolForm = {
+    type: "function";
+    description: string;
+    parameters: JsonSchema;
+};
+export type CustomToolInputFormat = {
+    type: "text";
+} | {
+    type: "grammar";
+    syntax: "lark" | "regex";
+    definition: string;
+};
+export type CustomToolForm = {
+    type: "custom";
+    description: string;
+    format?: CustomToolInputFormat;
+    functionFallback: FunctionToolForm;
+};
+export type ModelFacingToolForm = FunctionToolForm | CustomToolForm;
+export type FunctionOnlyToolPayload = {
+    name: string;
+    description: string;
+    parameters: JsonSchema;
+};
+export declare function functionToolForm(input: {
+    description: string;
+    parameters: JsonSchema;
+}): FunctionToolForm;
+export declare function serializeFunctionOnlyToolPayload(name: string, form: ModelFacingToolForm): FunctionOnlyToolPayload;
+//# sourceMappingURL=model-facing-tool.d.ts.map

package/dist/types/tools/model-facing-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-facing-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/model-facing-tool.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEN,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAG/B,gBAAgB,EAAE,gBAAgB,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,GAAG,cAAc,CAAC;AAEpE,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,UAAU,CAAC;CACxB,GAAG,gBAAgB,CAMnB;AAED,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,mBAAmB,GACxB,uBAAuB,CAczB"}

package/dist/types/tools/permission-mode-state.d.ts

@@ -0,0 +1,7 @@
+import { type PermissionMode } from "../permissions/mode";
+/** Mutable, shared-by-reference permission mode state. */
+export type PermissionModeState = {
+    mode: PermissionMode;
+};
+export declare function getEffectivePermissionModeState(permissionModeState?: PermissionModeState): PermissionModeState;
+//# sourceMappingURL=permission-mode-state.d.ts.map

package/dist/types/tools/permission-mode-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-mode-state.d.ts","sourceRoot":"","sources":["../../../src/tools/permission-mode-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAE5B,0DAA0D;AAC1D,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,cAAc,CAAC;CACtB,CAAC;AAEF,wBAAgB,+BAA+B,CAC7C,mBAAmB,CAAC,EAAE,mBAAmB,GACxC,mBAAmB,CAWrB"}

package/dist/types/tools/secret-substitution.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Secret handling for shell tool arguments and output.
+ */
+/**
+ * Scan a command string or command-argument array for `$SECRET_NAME`
+ * references and build an env map of matching secrets from the store.
+ * The shell will expand these vars natively, so secret values never get
+ * injected into the command string itself.
+ */
+export declare function extractSecretEnvFromCommand(command: string | readonly string[], agentId?: string): Record<string, string>;
+/**
+ * Scrub secret values from a string, replacing them with an explicit
+ * placeholder that makes it unambiguous to the LLM that the value is hidden.
+ * Used to prevent secret values from leaking into agent context via tool output.
+ */
+export declare function scrubSecretsFromString(input: string, agentId?: string): string;
+//# sourceMappingURL=secret-substitution.d.ts.map

package/dist/types/tools/secret-substitution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret-substitution.d.ts","sourceRoot":"","sources":["../../../src/tools/secret-substitution.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EACnC,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAyBxB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAaR"}

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

@@ -0,0 +1,71 @@
+import { type ToolAssets } from "./define-tool";
+export declare function buildBashDescriptionForPlatform(platform?: NodeJS.Platform): string;
+declare const toolDefinitions: {
+    readonly AskUserQuestion: ToolAssets;
+    readonly Bash: ToolAssets;
+    readonly BashOutput: ToolAssets;
+    readonly EnterWorktree: ToolAssets;
+    readonly Edit: ToolAssets;
+    readonly Glob: ToolAssets;
+    readonly Grep: ToolAssets;
+    readonly KillBash: ToolAssets;
+    readonly TaskOutput: ToolAssets;
+    readonly TaskStop: ToolAssets;
+    readonly LS: ToolAssets;
+    readonly memory: ToolAssets;
+    readonly memory_apply_patch: ToolAssets;
+    readonly MessageChannel: ToolAssets;
+    readonly MultiEdit: ToolAssets;
+    readonly Read: ToolAssets;
+    readonly read_artifact_file: ToolAssets;
+    readonly view_image: ToolAssets;
+    readonly ViewImage: ToolAssets;
+    readonly ReadLSP: ToolAssets;
+    readonly Skill: ToolAssets;
+    readonly Task: ToolAssets;
+    readonly TaskCreate: ToolAssets;
+    readonly TaskGet: ToolAssets;
+    readonly TaskList: ToolAssets;
+    readonly TaskUpdate: ToolAssets;
+    readonly TodoWrite: ToolAssets;
+    readonly Write: ToolAssets;
+    readonly write_artifact_file: ToolAssets;
+    readonly shell_command: ToolAssets;
+    readonly exec_command: ToolAssets;
+    readonly write_stdin: ToolAssets;
+    readonly shell: ToolAssets;
+    readonly read_file: ToolAssets;
+    readonly list_dir: ToolAssets;
+    readonly grep_files: ToolAssets;
+    readonly apply_patch: ToolAssets;
+    readonly update_plan: ToolAssets;
+    readonly glob_gemini: ToolAssets;
+    readonly list_directory: ToolAssets;
+    readonly read_file_gemini: ToolAssets;
+    readonly read_many_files: ToolAssets;
+    readonly replace: ToolAssets;
+    readonly run_shell_command: ToolAssets;
+    readonly search_file_content: ToolAssets;
+    readonly write_todos: ToolAssets;
+    readonly write_file_gemini: ToolAssets;
+    readonly ShellCommand: ToolAssets;
+    readonly Shell: ToolAssets;
+    readonly ReadFile: ToolAssets;
+    readonly ListDir: ToolAssets;
+    readonly GrepFiles: ToolAssets;
+    readonly ApplyPatch: ToolAssets;
+    readonly UpdatePlan: ToolAssets;
+    readonly RunShellCommand: ToolAssets;
+    readonly ReadFileGemini: ToolAssets;
+    readonly ListDirectory: ToolAssets;
+    readonly GlobGemini: ToolAssets;
+    readonly SearchFileContent: ToolAssets;
+    readonly Replace: ToolAssets;
+    readonly WriteFileGemini: ToolAssets;
+    readonly WriteTodos: ToolAssets;
+    readonly ReadManyFiles: ToolAssets;
+};
+export type ToolName = keyof typeof toolDefinitions;
+export declare const TOOL_DEFINITIONS: Record<ToolName, ToolAssets>;
+export {};
+//# sourceMappingURL=tool-definitions.d.ts.map