@letta-ai/letta-agent-sdk 0.3.2 → 0.5.0

package/src/validation.ts

@@ -0,0 +1,238 @@
+/**
+ * SDK Validation
+ *
+ * Validates user-provided options before spawning the CLI.
+ */
+
+import type { 
+  CreateSessionOptions,
+  CreateAgentOptions,
+  MemoryItem, 
+  CreateBlock,
+  SystemPromptPreset,
+  SkillSource,
+  DreamingOptions,
+} from "./types.js";
+
+const VALID_SKILL_SOURCES: SkillSource[] = [
+  "bundled",
+  "global",
+  "agent",
+  "project",
+];
+
+const VALID_REASONING_EFFORTS = [
+  "none",
+  "minimal",
+  "low",
+  "medium",
+  "high",
+  "xhigh",
+] as const;
+
+/**
+ * Extract block labels from memory items.
+ */
+function getBlockLabels(memory: MemoryItem[]): string[] {
+  return memory
+    .map((item) => {
+      if (typeof item === "string") return item; // preset name
+      if ("label" in item) return (item as CreateBlock).label; // CreateBlock
+      return null; // blockId - no label to check
+    })
+    .filter((label): label is string => label !== null);
+}
+
+function validateApprovalRecoveryOptions(options: CreateSessionOptions): void {
+  if (
+    options.maxApprovalRecoveryAttempts !== undefined &&
+    (!Number.isInteger(options.maxApprovalRecoveryAttempts) ||
+      options.maxApprovalRecoveryAttempts < 0)
+  ) {
+    throw new Error(
+      "Invalid maxApprovalRecoveryAttempts. Expected a non-negative integer."
+    );
+  }
+
+  if (
+    options.approvalRecoveryTimeoutMs !== undefined &&
+    (!Number.isInteger(options.approvalRecoveryTimeoutMs) ||
+      options.approvalRecoveryTimeoutMs <= 0)
+  ) {
+    throw new Error(
+      "Invalid approvalRecoveryTimeoutMs. Expected a positive integer."
+    );
+  }
+}
+
+function validateRemovedSessionOptions(options: CreateSessionOptions): void {
+  const removedOptions = options as CreateSessionOptions & Record<string, unknown>;
+  if (removedOptions.systemPrompt !== undefined) {
+    throw new Error("systemPrompt is not supported when opening an existing agent session.");
+  }
+  if (removedOptions.disallowedTools !== undefined) {
+    throw new Error("disallowedTools is not supported when opening an existing agent session.");
+  }
+  if (removedOptions.systemInfoReminder !== undefined) {
+    throw new Error("systemInfoReminder is not supported when opening an existing agent session.");
+  }
+  if (removedOptions.includePartialMessages !== undefined) {
+    throw new Error("includePartialMessages is not supported by app-server sessions.");
+  }
+  if (
+    options.dreaming &&
+    "behavior" in options.dreaming &&
+    options.dreaming.behavior !== undefined
+  ) {
+    throw new Error("dreaming.behavior is not supported when opening an existing agent session.");
+  }
+  if (removedOptions.memfsStartup !== undefined) {
+    throw new Error(
+      "memfsStartup is not supported by the SDK.",
+    );
+  }
+}
+
+/**
+ * Validate systemPrompt preset value.
+ */
+function validateSystemPromptPreset(preset: string): void {
+  const validPresets = [
+    "default",
+    "letta-claude",
+    "letta-codex",
+    "letta-gemini",
+    "claude",
+    "codex",
+    "gemini",
+  ];
+  if (!validPresets.includes(preset)) {
+    throw new Error(
+      `Invalid system prompt preset '${preset}'. ` +
+        `Valid presets: ${validPresets.join(", ")}`
+    );
+  }
+}
+
+function validateSkillSources(sources: SkillSource[] | undefined): void {
+  if (sources === undefined) {
+    return;
+  }
+
+  for (const source of sources) {
+    if (!VALID_SKILL_SOURCES.includes(source)) {
+      throw new Error(
+        `Invalid skill source '${source}'. Valid values: ${VALID_SKILL_SOURCES.join(", ")}`
+      );
+    }
+  }
+}
+
+function validateDreamingOptions(dreaming: DreamingOptions | undefined): void {
+  if (dreaming === undefined) {
+    return;
+  }
+
+  if (
+    dreaming.trigger !== undefined &&
+    !["off", "step-count", "compaction-event"].includes(dreaming.trigger)
+  ) {
+    throw new Error(
+      `Invalid dreaming.trigger '${String(dreaming.trigger)}'. Valid values: off, step-count, compaction-event`
+    );
+  }
+
+  if (
+    dreaming.behavior !== undefined &&
+    !["reminder", "auto-launch"].includes(dreaming.behavior)
+  ) {
+    throw new Error(
+      `Invalid dreaming.behavior '${String(dreaming.behavior)}'. Valid values: reminder, auto-launch`
+    );
+  }
+
+  if (
+    dreaming.stepCount !== undefined &&
+    (!Number.isInteger(dreaming.stepCount) || dreaming.stepCount <= 0)
+  ) {
+    throw new Error(
+      "Invalid dreaming.stepCount. Expected a positive integer."
+    );
+  }
+}
+
+function validateReasoningEffort(value: unknown): void {
+  if (value === undefined) return;
+  if (
+    typeof value !== "string" ||
+    !VALID_REASONING_EFFORTS.includes(value as (typeof VALID_REASONING_EFFORTS)[number])
+  ) {
+    throw new Error(
+      `Invalid reasoningEffort '${String(value)}'. Valid values: ${VALID_REASONING_EFFORTS.join(", ")}`
+    );
+  }
+}
+
+/**
+ * Validate CreateSessionOptions (used by createSession and resumeSession).
+ */
+export function validateCreateSessionOptions(options: CreateSessionOptions): void {
+  validateSkillSources(options.skillSources);
+  validateReasoningEffort(options.reasoningEffort);
+  validateDreamingOptions(options.dreaming);
+  validateApprovalRecoveryOptions(options);
+  validateRemovedSessionOptions(options);
+}
+
+/**
+ * Validate CreateAgentOptions (used by createAgent).
+ */
+export function validateCreateAgentOptions(options: CreateAgentOptions): void {
+  // Validate memory/persona consistency
+  if (options.memory !== undefined) {
+    const blockLabels = getBlockLabels(options.memory);
+
+    if (options.persona !== undefined && !blockLabels.includes("persona")) {
+      throw new Error(
+        "Cannot set 'persona' value - block not included in 'memory'. " +
+          "Either add 'persona' to memory array or remove the persona option."
+      );
+    }
+
+    if (options.human !== undefined && !blockLabels.includes("human")) {
+      throw new Error(
+        "Cannot set 'human' value - block not included in 'memory'. " +
+          "Either add 'human' to memory array or remove the human option."
+      );
+    }
+  }
+
+  // Validate systemPrompt preset if provided as preset object
+  if (
+    options.systemPrompt !== undefined &&
+    typeof options.systemPrompt === "object"
+  ) {
+    validateSystemPromptPreset(options.systemPrompt.preset);
+  } else if (
+    options.systemPrompt !== undefined &&
+    typeof options.systemPrompt === "string"
+  ) {
+    // Check if it's a preset name (if so, validate it)
+    const validPresets = [
+      "default",
+      "letta-claude",
+      "letta-codex",
+      "letta-gemini",
+      "claude",
+      "codex",
+      "gemini",
+    ] as const;
+    if (validPresets.includes(options.systemPrompt as SystemPromptPreset)) {
+      validateSystemPromptPreset(options.systemPrompt);
+    }
+    // If not a preset, it's a custom string - no validation needed
+  }
+
+  validateSkillSources(options.skillSources);
+  validateDreamingOptions(options.dreaming);
+}

package/src/websocket.ts

@@ -0,0 +1,22 @@
+import type {
+  LettaCodeReactNativeSocketConstructor,
+  LettaCodeSocketConstructor,
+  LettaCodeSocketOptions,
+} from "./types.js";
+
+/**
+ * Adapt React Native's three-argument WebSocket constructor to the SDK's
+ * Node-compatible constructor shape. This is only needed when a remote
+ * app-server authenticates its websocket upgrade with headers. Cloud clients
+ * should prefer `webSocketAuth: "query"`.
+ */
+export function createReactNativeWebSocketConstructor(
+  WebSocket: LettaCodeReactNativeSocketConstructor,
+): LettaCodeSocketConstructor {
+  class ReactNativeWebSocketAdapter {
+    constructor(url: string, options?: LettaCodeSocketOptions) {
+      return new WebSocket(url, undefined, options);
+    }
+  }
+  return ReactNativeWebSocketAdapter as unknown as LettaCodeSocketConstructor;
+}

package/dist/protocol.d.ts

@@ -1,205 +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;
-});
-//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

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

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