@letta-ai/letta-agent-sdk 0.3.3 → 0.5.1

package/dist/session.d.ts

@@ -1,155 +0,0 @@
-/**
- * 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, ChangeDeviceStateOptions, GetDeviceStatusOptions, SessionDeviceStatus, RunTurnOptions, RecoverPendingApprovalsOptions, RecoverPendingApprovalsResult, RemoveQueuedMessageResult, 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 closed;
-    private initializePromise;
-    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).
-     *
-     * Single-flight: concurrent callers (including lazily-initializing entry
-     * points such as send()) share one in-flight initialization instead of
-     * each connecting the transport. A failed stdio attempt closes the session
-     * because its subprocess transport is no longer safe to reuse.
-     */
-    initialize(): Promise<SDKInitMessage>;
-    private performInitialize;
-    private cleanupFailedInitialize;
-    /**
-     * 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>;
-    changeDeviceState(_updates: ChangeDeviceStateOptions): Promise<void>;
-    removeQueuedMessage(_itemId: string): Promise<RemoveQueuedMessageResult>;
-    getDeviceStatus(_options?: GetDeviceStatusOptions): Promise<SessionDeviceStatus>;
-    onDeviceStatus(_listener: (status: SessionDeviceStatus) => void): () => void;
-    /**
-     * 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

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

package/dist/transport.d.ts

@@ -1,53 +0,0 @@
-/**
- * SubprocessTransport
- *
- * Spawns the Letta Code CLI and communicates via stdin/stdout JSON streams.
- */
-import type { InternalSessionOptions, WireMessage } from "./types.js";
-/**
- * Build the CLI argument array for a given set of session options.
- *
- * Exported as a pure function for testing — this IS the real production code
- * path. SubprocessTransport.buildArgs() delegates here.
- */
-export declare function buildCliArgs(options: InternalSessionOptions): string[];
-export declare class SubprocessTransport {
-    private options;
-    private process;
-    private stdout;
-    private messageQueue;
-    private messageResolvers;
-    private closed;
-    private agentId?;
-    private wireMessageCount;
-    private lastMessageAt;
-    private stderrLines;
-    constructor(options?: InternalSessionOptions);
-    /**
-     * Start the CLI subprocess
-     */
-    connect(): Promise<void>;
-    /**
-     * Send a message to the CLI via stdin
-     */
-    write(data: object): Promise<void>;
-    /**
-     * Read the next message from the CLI
-     */
-    read(): Promise<WireMessage | null>;
-    /**
-     * Async iterator for messages
-     */
-    messages(): AsyncGenerator<WireMessage>;
-    /**
-     * Close the transport
-     */
-    close(): void;
-    get isClosed(): boolean;
-    /** Return buffered stderr output from the CLI subprocess. */
-    getStderr(): string;
-    private handleMessage;
-    private buildArgs;
-    private findCli;
-}
-//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAgCtE;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,EAAE,CA4KtE;AAED,qBAAa,mBAAmB;IAY5B,OAAO,CAAC,OAAO;IAXjB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,gBAAgB,CAAgD;IACxE,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,WAAW,CAAgB;gBAGzB,OAAO,GAAE,sBAA2B;IAG9C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA+E9B;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAmBzC;;OAEG;IACI,QAAQ,IAAI,cAAc,CAAC,WAAW,CAAC;IAW9C;;OAEG;IACH,KAAK,IAAI,IAAI;IAgBb,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,6DAA6D;IAC7D,SAAS,IAAI,MAAM;IAInB,OAAO,CAAC,aAAa;IAqCrB,OAAO,CAAC,SAAS;YAMH,OAAO;CA4CtB"}

package/src/protocol.ts

@@ -1,249 +0,0 @@
-/**
- * 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 });