@letta-ai/letta-agent-sdk 0.2.1

package/dist/interactiveToolPolicy.d.ts

@@ -0,0 +1,4 @@
+export declare function isInteractiveApprovalTool(toolName: string): boolean;
+export declare function requiresRuntimeUserInput(toolName: string): boolean;
+export declare function isHeadlessAutoAllowTool(toolName: string): boolean;
+//# sourceMappingURL=interactiveToolPolicy.d.ts.map

package/dist/interactiveToolPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactiveToolPolicy.d.ts","sourceRoot":"","sources":["../src/interactiveToolPolicy.ts"],"names":[],"mappings":"AAaA,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAElE;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEjE"}

package/dist/local-app-server.d.ts

@@ -0,0 +1,17 @@
+export interface LocalAppServerHandle {
+    url: string;
+    close(): void;
+}
+export interface StartLocalAppServerOptions {
+    listen?: string;
+    backend?: string;
+    startupTimeoutMs?: number;
+    cliPath?: string;
+    env?: Record<string, string | undefined>;
+}
+export declare function buildLocalAppServerArgs(cliPath: string, options?: Pick<StartLocalAppServerOptions, "backend" | "listen">): string[];
+/**
+ * Spawn an SDK-owned Letta Code app-server on an ephemeral loopback port.
+ */
+export declare function startLocalAppServer(options?: StartLocalAppServerOptions): Promise<LocalAppServerHandle>;
+//# sourceMappingURL=local-app-server.d.ts.map

package/dist/local-app-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-app-server.d.ts","sourceRoot":"","sources":["../src/local-app-server.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C;AAeD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,IAAI,CAAC,0BAA0B,EAAE,SAAS,GAAG,QAAQ,CAAM,GACnE,MAAM,EAAE,CAQV;AAYD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,oBAAoB,CAAC,CA+E/B"}

package/dist/protocol.d.ts

@@ -0,0 +1,205 @@
+/**
+ * Local protocol type surface consumed by the SDK.
+ *
+ * @letta-ai/letta-code@0.27.11 publishes these declarations under an internal
+ * dist path while its package.json points the public `./protocol` export at a
+ * missing file. Keep the SDK's public types self-contained so CI and consumers
+ * do not depend on that broken subpath export.
+ */
+export interface MessageEnvelope {
+    type: string;
+    session_id?: string;
+    uuid?: string;
+    timestamp?: string;
+    event_seq?: number;
+    agent_id?: string;
+    conversation_id?: string;
+    [key: string]: unknown;
+}
+/**
+ * System prompt preset configuration used by the CLI protocol.
+ */
+export interface SystemPromptPresetConfig {
+    type: "preset";
+    preset: string;
+    append?: string;
+}
+/**
+ * Custom memory block definition accepted when creating agents.
+ */
+export interface CreateBlock {
+    label: string;
+    value: string;
+    base_template_id?: string | null;
+    deployment_id?: string | null;
+    description?: string | null;
+    entity_id?: string | null;
+    hidden?: boolean | null;
+    is_template?: boolean;
+    limit?: number;
+    metadata?: Record<string, unknown> | null;
+    preserve_on_migration?: boolean | null;
+    project_id?: string | null;
+    read_only?: boolean;
+    tags?: string[] | null;
+    template_id?: string | null;
+    template_name?: string | null;
+}
+export interface SystemInitMessage extends MessageEnvelope {
+    type: "system";
+    subtype: "init";
+    agent_id: string;
+    conversation_id: string;
+    model: string;
+    tools: string[];
+    cwd: string;
+    mcp_servers: Array<{
+        name: string;
+        status: string;
+    }>;
+    permission_mode: string;
+    slash_commands: string[];
+    memfs_enabled?: boolean;
+    skill_sources?: Array<"bundled" | "global" | "agent" | "project">;
+    system_info_reminder_enabled?: boolean;
+    reflection_trigger?: "off" | "step-count" | "compaction-event";
+    reflection_behavior?: "reminder" | "auto-launch";
+    reflection_step_count?: number;
+}
+export interface MessageWire extends MessageEnvelope {
+    type: "message";
+    message_type?: string;
+    run_id?: string;
+}
+export interface StreamEvent extends MessageEnvelope {
+    type: "stream_event";
+    event: unknown;
+}
+export type ResultSubtype = "success" | "interrupted" | "error" | string;
+export interface ResultMessage extends MessageEnvelope {
+    type: "result";
+    subtype: ResultSubtype;
+    agent_id?: string;
+    conversation_id: string;
+    duration_ms: number;
+    duration_api_ms?: number;
+    num_turns?: number;
+    result?: string | null;
+    run_ids?: string[];
+    usage?: unknown;
+    stop_reason?: string;
+}
+export interface ErrorMessage extends MessageEnvelope {
+    type: "error";
+    message: string;
+    stop_reason: string;
+    run_id?: string;
+    api_error?: Record<string, unknown>;
+}
+export interface CanUseToolControlRequest {
+    subtype: "can_use_tool";
+    tool_name: string;
+    input: Record<string, unknown>;
+    tool_call_id: string;
+    permission_suggestions?: unknown[];
+    blocked_path?: string | null;
+    diffs?: unknown[];
+}
+export interface RegisterExternalToolsRequest {
+    subtype: "register_external_tools";
+    tools: Array<{
+        name: string;
+        label?: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    }>;
+}
+export interface BootstrapSessionStateRequest {
+    subtype: "bootstrap_session_state";
+    limit?: number;
+    order?: "asc" | "desc";
+}
+export interface RecoverPendingApprovalsControlRequest {
+    subtype: "recover_pending_approvals";
+    agent_id?: string;
+    conversation_id?: string;
+}
+export interface ListMessagesControlRequest {
+    subtype: "list_messages";
+    conversation_id?: string;
+    agent_id?: string;
+    before?: string;
+    after?: string;
+    order?: "asc" | "desc";
+    limit?: number;
+}
+export interface InterruptControlRequest {
+    subtype: "interrupt";
+}
+export interface InitializeControlRequest {
+    subtype: "initialize";
+}
+export interface ExecuteExternalToolControlRequest {
+    subtype: "execute_external_tool";
+    tool_call_id: string;
+    tool_name: string;
+    input: Record<string, unknown>;
+}
+export type ControlRequestBody = InitializeControlRequest | InterruptControlRequest | RegisterExternalToolsRequest | BootstrapSessionStateRequest | RecoverPendingApprovalsControlRequest | ListMessagesControlRequest | CanUseToolControlRequest | ExecuteExternalToolControlRequest | (Record<string, unknown> & {
+    subtype: string;
+});
+export interface ControlRequest extends MessageEnvelope {
+    type: "control_request";
+    request_id: string;
+    request: ControlRequestBody;
+}
+export interface CanUseToolResponseAllow {
+    behavior: "allow";
+    message?: string;
+    updatedInput?: Record<string, unknown> | null;
+    updatedPermissions?: unknown[];
+}
+export interface CanUseToolResponseDeny {
+    behavior: "deny";
+    message: string;
+    interrupt?: boolean;
+}
+export type CanUseToolResponse = CanUseToolResponseAllow | CanUseToolResponseDeny;
+export interface ExternalToolResultContent {
+    type: "text" | "image";
+    text?: string;
+    data?: string;
+    mimeType?: string;
+}
+export interface ExternalToolResultResponse {
+    subtype: "external_tool_result";
+    request_id: string;
+    tool_call_id: string;
+    content: ExternalToolResultContent[];
+    is_error: boolean;
+}
+export type ControlResponseBody = {
+    subtype: "success";
+    request_id: string;
+    response?: CanUseToolResponse | Record<string, unknown>;
+} | {
+    subtype: "error";
+    request_id: string;
+    error: string;
+} | ExternalToolResultResponse;
+export interface ControlResponse extends MessageEnvelope {
+    type: "control_response";
+    response: ControlResponseBody;
+}
+export interface RetryMessage extends MessageEnvelope {
+    type: "retry";
+    reason: string;
+    attempt: number;
+    max_attempts: number;
+    delay_ms: number;
+    run_id?: string;
+}
+export type WireMessage = SystemInitMessage | MessageWire | StreamEvent | ResultMessage | ErrorMessage | RetryMessage | ControlRequest | ControlResponse | (MessageEnvelope & {
+    type: string;
+});
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

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

package/dist/remote-client-session-core.d.ts

@@ -0,0 +1,140 @@
+import type { BootstrapStateOptions, BootstrapStateResult, CreateAgentOptions, LettaCodeClientSessionOptions, LettaCodeSession, ListModelsResult, ListMessagesOptions, ListMessagesResult, MessageContentItem, RecoverPendingApprovalsOptions, RecoverPendingApprovalsResult, RunTurnOptions, SDKErrorCode, SDKInitMessage, SDKMessage, SDKProtocolCommand, SDKProtocolMessage, SDKResultMessage, SendCommandOptions, SendMessage, UpdateModelOptions, UpdateModelResult } from "./types.js";
+export type RuntimeScope = {
+    agent_id: string;
+    conversation_id: string;
+};
+export type ProtocolMessage = Record<string, unknown> & {
+    type: string;
+    request_id?: string;
+    runtime?: RuntimeScope;
+};
+export type RuntimeSessionMode = {
+    kind: "create-agent";
+    options: CreateAgentOptions;
+} | {
+    kind: "session";
+    agentId?: string;
+    conversationId?: string;
+    newConversation?: boolean;
+    defaultConversation?: boolean;
+    options: LettaCodeClientSessionOptions;
+};
+export type RuntimeTurnResult = {
+    runtime: RuntimeScope;
+    stopReason: string | null;
+    runIds: string[];
+    success?: boolean;
+    detail?: string;
+    errorCode?: SDKErrorCode;
+};
+export type RuntimeSendTurnOptions = {
+    clientMessageId: string;
+};
+export type RuntimeRequestOptions = {
+    timeoutMs?: number;
+    predicate?: (message: ProtocolMessage) => boolean;
+};
+export interface RemoteClientRuntimeController {
+    onMessage(handler: (message: ProtocolMessage, channel?: string) => void): () => void;
+    send(command: Record<string, unknown>): void;
+    sendTurnMessage(runtime: RuntimeScope, message: SendMessage, options: RuntimeSendTurnOptions): void;
+    abort(runtime: RuntimeScope): Promise<void>;
+    request(type: string, body: Record<string, unknown>, options?: RuntimeRequestOptions): Promise<ProtocolMessage>;
+    recoverPendingApprovals(runtime: RuntimeScope, options?: RecoverPendingApprovalsOptions): Promise<RecoverPendingApprovalsResult>;
+    listMessages(conversationId: string, options?: ListMessagesOptions): Promise<ListMessagesResult>;
+    listModels(): Promise<ListModelsResult>;
+    updateModel(runtime: RuntimeScope, payload: {
+        model_id?: string;
+        model_handle?: string;
+    }): Promise<UpdateModelResult>;
+    close(): void;
+}
+export type RuntimeSessionInit = {
+    controller: RemoteClientRuntimeController;
+    runtime: RuntimeScope;
+    model?: string | null;
+    modelSettings?: Record<string, unknown> | null;
+    tools?: string[];
+};
+type RemoteClientSessionCoreConfig = {
+    label: string;
+    requestTimeoutMs?: number;
+};
+export declare function mapPermissionMode(mode: LettaCodeClientSessionOptions["permissionMode"]): string | undefined;
+export declare function ensureSuccess(message: Record<string, unknown>, fallback: string): void;
+export declare function normalizeSendMessage(message: SendMessage): string | MessageContentItem[];
+export declare abstract class RemoteClientSessionCore implements LettaCodeSession {
+    protected readonly mode: RuntimeSessionMode;
+    protected controller: RemoteClientRuntimeController | null;
+    protected runtime: RuntimeScope | null;
+    protected initialized: boolean;
+    protected closed: boolean;
+    protected activeTurnStartedAt: number;
+    protected _agentId: string | null;
+    protected _sessionId: string | null;
+    protected _conversationId: string | null;
+    protected _model: string;
+    protected _modelSettings: Record<string, unknown> | null;
+    private readonly label;
+    private readonly requestTimeoutMs;
+    private streamQueue;
+    private streamResolvers;
+    private removeMessageHandler;
+    private activeTurn;
+    private pendingTurns;
+    private nextTurnId;
+    private messageCounter;
+    private clientMessageCounter;
+    private toolNames;
+    protected constructor(mode: RuntimeSessionMode, config: RemoteClientSessionCoreConfig);
+    initialize(): Promise<SDKInitMessage>;
+    send(message: SendMessage): Promise<void>;
+    runTurn(message: SendMessage, _options?: RunTurnOptions): Promise<SDKResultMessage>;
+    stream(): AsyncGenerator<SDKMessage>;
+    abort(): Promise<void>;
+    sendCommand(command: SDKProtocolCommand): Promise<void>;
+    sendCommand<TResponse extends SDKProtocolMessage = SDKProtocolMessage>(command: SDKProtocolCommand, options: SendCommandOptions): Promise<TResponse>;
+    listModels(): Promise<ListModelsResult>;
+    updateModel(update: string | UpdateModelOptions): Promise<UpdateModelResult>;
+    recoverPendingApprovals(options?: RecoverPendingApprovalsOptions): Promise<RecoverPendingApprovalsResult>;
+    listMessages(options?: ListMessagesOptions): Promise<ListMessagesResult>;
+    bootstrapState(options?: BootstrapStateOptions): Promise<BootstrapStateResult>;
+    close(): void;
+    get agentId(): string | null;
+    get sessionId(): string | null;
+    get conversationId(): string | null;
+    [Symbol.asyncDispose](): Promise<void>;
+    changeDeviceState(updates: {
+        cwd?: string;
+        permissionMode?: LettaCodeClientSessionOptions["permissionMode"];
+        agentId?: string;
+        conversationId?: string;
+    }): Promise<void>;
+    updateToolset(toolsetPreference: string): Promise<void>;
+    protected abstract initializeRuntimeController(): Promise<RuntimeSessionInit>;
+    protected afterRuntimeInitialized(): Promise<void>;
+    protected beforeTurn(): Promise<void>;
+    protected onCoreClose(): void;
+    protected currentOptions(): LettaCodeClientSessionOptions | CreateAgentOptions;
+    protected shouldEnableMemfs(options: LettaCodeClientSessionOptions | CreateAgentOptions): boolean;
+    protected enableMemfsBody(): Record<string, unknown>;
+    protected setModel(model: string): void;
+    private trackSentTurn;
+    private activateTurn;
+    private activateNextTurnFromProtocol;
+    private removeTrackedTurn;
+    private failTurn;
+    private completeActiveTurn;
+    private resolveUpdateModelPayload;
+    protected applyPostInitializeOptions(): Promise<void>;
+    private handleProtocolMessage;
+    private handleLoopStatusMessage;
+    private handleTurnTerminalDelta;
+    private transformStreamDelta;
+    private resultFromTurn;
+    private enqueue;
+    private nextMessage;
+    private resolveAll;
+}
+export {};
+//# sourceMappingURL=remote-client-session-core.d.ts.map

package/dist/remote-client-session-core.d.ts.map

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

package/dist/remote.d.ts

@@ -0,0 +1,57 @@
+export type RemoteEnvironmentTarget = {
+    connectionId: string;
+} | {
+    environmentId: string;
+} | {
+    deviceId: string;
+} | {
+    connectionName: string;
+};
+export interface RemoteEnvironmentClientOptions {
+    /** Letta API base URL. Defaults to https://api.letta.com. */
+    baseUrl?: string;
+    /** Bearer token / API key. Defaults to process.env.LETTA_API_KEY when present. */
+    apiKey?: string;
+    /** Additional headers, e.g. x-project-id. */
+    headers?: Record<string, string>;
+    /** Custom fetch implementation for tests or non-standard runtimes. */
+    fetch?: typeof fetch;
+}
+export interface RemoteEnvironmentConnection {
+    id: string;
+    connectionId: string | null;
+    deviceId: string;
+    connectionName: string;
+    organizationId: string;
+    userId?: string;
+    apiKeyOwner?: string;
+    podId: string | null;
+    connectedAt: number | null;
+    lastHeartbeat: number | null;
+    lastSeenAt: number;
+    firstSeenAt: number;
+    currentMode?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface RemoteEnvironmentListResult {
+    connections: RemoteEnvironmentConnection[];
+    hasNextPage: boolean;
+}
+export interface ResolvedRemoteEnvironment {
+    connectionId: string;
+    environment?: RemoteEnvironmentConnection;
+    target: RemoteEnvironmentTarget;
+}
+/**
+ * Small Cloud API helper for resolving explicit Letta Code environments.
+ */
+export declare class RemoteEnvironmentClient {
+    private readonly options;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    constructor(options?: RemoteEnvironmentClientOptions);
+    listEnvironments(): Promise<RemoteEnvironmentListResult>;
+    getEnvironmentByDeviceId(deviceId: string): Promise<RemoteEnvironmentConnection>;
+    resolveEnvironment(target: RemoteEnvironmentTarget): Promise<ResolvedRemoteEnvironment>;
+}
+//# sourceMappingURL=remote.d.ts.map

package/dist/remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../src/remote.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,uBAAuB,GAC/B;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,GACxB;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpB;IAAE,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/B,MAAM,WAAW,8BAA8B;IAC7C,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,sEAAsE;IACtE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,2BAA2B,EAAE,CAAC;IAC3C,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,2BAA2B,CAAC;IAC1C,MAAM,EAAE,uBAAuB,CAAC;CACjC;AAqED;;GAEG;AACH,qBAAa,uBAAuB;IAItB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;gBAEX,OAAO,GAAE,8BAAmC;IAKnE,gBAAgB,IAAI,OAAO,CAAC,2BAA2B,CAAC;IAQxD,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAQhF,kBAAkB,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,yBAAyB,CAAC;CAoC9F"}

package/dist/session.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Session
+ *
+ * Represents a conversation session with a Letta agent.
+ * Implements the V2 API pattern: send() / receive()
+ */
+import type { InternalSessionOptions, SDKMessage, SDKInitMessage, SDKResultMessage, SendMessage, ListMessagesOptions, ListMessagesResult, ListModelsResult, BootstrapStateOptions, BootstrapStateResult, RunTurnOptions, RecoverPendingApprovalsOptions, RecoverPendingApprovalsResult, SDKProtocolCommand, SDKProtocolMessage, SendCommandOptions, UpdateModelOptions, UpdateModelResult } from "./types.js";
+export declare class Session implements AsyncDisposable {
+    private options;
+    private transport;
+    private _agentId;
+    private _sessionId;
+    private _conversationId;
+    private initialized;
+    private externalTools;
+    private streamQueue;
+    private streamResolvers;
+    private pumpPromise;
+    private pumpClosed;
+    private droppedStreamMessages;
+    private sendGeneration;
+    private lastCompletedRunIds;
+    private controlResponseWaiters;
+    constructor(options?: InternalSessionOptions);
+    /**
+     * Initialize the session (called automatically on first send)
+     */
+    initialize(): Promise<SDKInitMessage>;
+    /**
+     * Send a message to the agent
+     *
+     * @param message - Text string or multimodal content array
+     *
+     * @example
+     * // Simple text
+     * await session.send("Hello!");
+     *
+     * @example
+     * // With image
+     * await session.send([
+     *   { type: "text", text: "What's in this image?" },
+     *   { type: "image", source: { type: "base64", mediaType: "image/png", data: "..." } }
+     * ]);
+     */
+    send(message: SendMessage): Promise<void>;
+    /**
+     * Run a full turn (send + stream terminal result), with optional bounded
+     * SDK-owned approval-conflict recovery.
+     */
+    runTurn(message: SendMessage, options?: RunTurnOptions): Promise<SDKResultMessage>;
+    /**
+     * Ask the CLI to recover pending approvals for the current
+     * agent/conversation context.
+     */
+    recoverPendingApprovals(options?: RecoverPendingApprovalsOptions): Promise<RecoverPendingApprovalsResult>;
+    private resolveMaxApprovalRecoveryAttempts;
+    private resolveApprovalRecoveryTimeoutMs;
+    private toTerminalApprovalConflictResult;
+    private runSingleTurn;
+    /**
+     * Stream messages from the agent
+     */
+    stream(): AsyncGenerator<SDKMessage>;
+    private startBackgroundPump;
+    private runBackgroundPump;
+    private handleControlRequest;
+    private enqueueStreamMessage;
+    private nextBufferedMessage;
+    private resolveAllStreamWaiters;
+    private getMessageRunId;
+    private updateCompletedRunIds;
+    /**
+     * Register external tools with the CLI
+     */
+    private registerExternalTools;
+    /**
+     * Convert TypeBox schema to JSON Schema
+     */
+    private schemaToJsonSchema;
+    /**
+     * Handle execute_external_tool control request from CLI
+     */
+    private handleExecuteExternalTool;
+    /**
+     * Handle can_use_tool control request from CLI (Claude SDK compatible format)
+     */
+    private handleCanUseTool;
+    /**
+     * Abort the current operation (interrupt without closing the session)
+     */
+    abort(): Promise<void>;
+    private requestControlResponse;
+    /**
+     * Fetch a page of conversation messages via the CLI control protocol.
+     *
+     * The session must be initialized before calling this method.
+     * Safe to call concurrently with an active stream() — the pump routes
+     * matching control_response messages to this waiter without touching the
+     * stream queue.
+     */
+    listMessages(options?: ListMessagesOptions): Promise<ListMessagesResult>;
+    listModels(): Promise<ListModelsResult>;
+    sendCommand(command: SDKProtocolCommand): Promise<void>;
+    sendCommand<TResponse extends SDKProtocolMessage = SDKProtocolMessage>(command: SDKProtocolCommand, options: SendCommandOptions): Promise<TResponse>;
+    updateModel(_update: string | UpdateModelOptions): Promise<UpdateModelResult>;
+    /**
+     * Fetch all data needed to render the initial conversation view in one round-trip.
+     *
+     * Returns resolved session metadata + initial history page + pending approval flag
+     * + optional timing breakdown.  This is faster than separate initialize() + listMessages()
+     * calls because the CLI collects and returns everything in a single control response.
+     *
+     * The session must be initialized before calling this method.
+     */
+    bootstrapState(options?: BootstrapStateOptions): Promise<BootstrapStateResult>;
+    updateToolset(_toolsetPreference: string): Promise<void>;
+    /**
+     * Close the session
+     */
+    close(): void;
+    /**
+     * Get the agent ID (available after initialization)
+     */
+    get agentId(): string | null;
+    /**
+     * Get the session ID (available after initialization)
+     */
+    get sessionId(): string | null;
+    /**
+     * Get the conversation ID (available after initialization)
+     */
+    get conversationId(): string | null;
+    /**
+     * AsyncDisposable implementation for `await using`
+     */
+    [Symbol.asyncDispose](): Promise<void>;
+    /**
+     * Transform wire message to SDK message
+     */
+    private transformMessage;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

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

package/dist/stream-events.d.ts

@@ -0,0 +1,15 @@
+import type { SDKStreamEventPayload } from "./types.js";
+export type StreamTextKind = "assistant" | "reasoning";
+export interface StreamTextDelta {
+    kind: StreamTextKind;
+    text: string;
+}
+/**
+ * Extract appendable assistant/reasoning text from a stream_event payload.
+ *
+ * Supports both shapes currently emitted by headless mode:
+ * 1) content_block style: { type, delta: { text|reasoning } }
+ * 2) message chunk style: { message_type: "assistant_message"|"reasoning_message", ... }
+ */
+export declare function extractStreamTextDelta(event: SDKStreamEventPayload): StreamTextDelta | null;
+//# sourceMappingURL=stream-events.d.ts.map

package/dist/stream-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-events.d.ts","sourceRoot":"","sources":["../src/stream-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,WAAW,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAoCD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,qBAAqB,GAAG,eAAe,GAAG,IAAI,CAqC3F"}

package/dist/tests/advanced-session.d.ts

@@ -0,0 +1,10 @@
+import type { BootstrapStateOptions, BootstrapStateResult, LettaCodeSession, RecoverPendingApprovalsOptions, RecoverPendingApprovalsResult, SDKInitMessage, SDKResultMessage, SendMessage } from "../types.js";
+export type AdvancedSession = LettaCodeSession & {
+    initialize(): Promise<SDKInitMessage>;
+    runTurn(message: SendMessage): Promise<SDKResultMessage>;
+    recoverPendingApprovals(options?: RecoverPendingApprovalsOptions): Promise<RecoverPendingApprovalsResult>;
+    updateToolset(toolsetPreference: string): Promise<void>;
+    bootstrapState(options?: BootstrapStateOptions): Promise<BootstrapStateResult>;
+};
+export declare function asAdvanced(session: LettaCodeSession): AdvancedSession;
+//# sourceMappingURL=advanced-session.d.ts.map

package/dist/tests/advanced-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced-session.d.ts","sourceRoot":"","sources":["../../src/tests/advanced-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,8BAA8B,EAC9B,6BAA6B,EAC7B,cAAc,EACd,gBAAgB,EAChB,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG;IAC/C,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IACtC,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACzD,uBAAuB,CACrB,OAAO,CAAC,EAAE,8BAA8B,GACvC,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAC1C,aAAa,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,cAAc,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAChF,CAAC;AAEF,wBAAgB,UAAU,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAErE"}