@letta-ai/letta-agent-sdk 0.2.1

package/dist/index.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Letta Agent SDK
+ *
+ * Programmatic control of Letta Code CLI with persistent agent memory.
+ *
+ * @example
+ * ```typescript
+ * import { LettaCodeClient, createAgent, createSession, resumeSession, prompt } from '@letta-ai/letta-agent-sdk';
+ *
+ * const client = new LettaCodeClient({ backend: 'local' });
+ * const agentId = await client.createAgent();
+ * const clientSession = client.resumeSession(agentId);
+ *
+ * // Start session with default agent + new conversation (like `letta`)
+ * const session = createSession();
+ *
+ * // Create a new agent explicitly
+ * const agentId = await createAgent();
+ *
+ * // Resume default conversation on an agent
+ * const session = resumeSession(agentId);
+ *
+ * // Resume specific conversation
+ * const session = resumeSession('conv-xxx');
+ *
+ * // Create new conversation on specific agent
+ * const session = createSession(agentId);
+ *
+ * // One-shot prompt (uses default agent)
+ * const result = await prompt('Hello');
+ * const result = await prompt('Hello', agentId);  // specific agent
+ * ```
+ */
+import type { CreateSessionOptions, CreateAgentOptions, LettaCodeSession, SDKResultMessage } from "./types.js";
+export type { CreateSessionOptions, CreateAgentOptions, LettaCodeBackend, LettaCodeEnvironment, LettaCodeLocalClientOptions, LettaCodeLocalAppServerOptions, LettaCodeRemoteClientOptions, LettaCodeCloudClientOptions, LettaCodeClientOptions, LettaCodeClientSessionOptions, LettaCodeSession, LettaCodeSocketLike, LettaCodeSocketConstructor, SDKMessage, SDKInitMessage, SDKAssistantMessage, SDKToolCallMessage, SDKToolResultMessage, SDKReasoningMessage, SDKResultMessage, SDKErrorCode, SDKStreamEventMessage, SDKStreamEventPayload, SDKStreamEventDeltaPayload, SDKStreamEventMessagePayload, SDKUnknownStreamEventPayload, SDKErrorMessage, SDKRetryMessage, SDKQueueItem, SDKQueueUpdateMessage, SDKLoopStatusMessage, SDKProtocolMessage, SDKProtocolCommand, SendCommandOptions, RunTurnOptions, RecoverPendingApprovalsOptions, RecoverPendingApprovalsResult, SkillSource, DreamingOptions, DreamingTrigger, DreamingBehavior, EffectiveDreamingSettings, PermissionMode, ReasoningEffort, CanUseToolCallback, CanUseToolResponse, CanUseToolResponseAllow, CanUseToolResponseDeny, TextContent, ImageContent, MessageContentItem, SendMessage, ListMessagesOptions, ListMessagesResult, ListModelsResult, LettaCodeModelEntry, UpdateModelOptions, UpdateModelResult, BootstrapStateOptions, BootstrapStateResult, AgentTool, AgentToolResult, AgentToolResultContent, AgentToolUpdateCallback, AnyAgentTool, } from "./types.js";
+export { Session } from "./session.js";
+export { LettaCodeClient } from "./client.js";
+export { extractStreamTextDelta } from "./stream-events.js";
+export { jsonResult, readStringParam, readNumberParam, readBooleanParam, readStringArrayParam, } from "./tool-helpers.js";
+/**
+ * Create a new agent with a default conversation.
+ * Returns the agentId which can be used with resumeSession or createSession.
+ *
+ * @example
+ * ```typescript
+ * // Create agent with default settings.
+ * const agentId = await createAgent();
+ *
+ * // Create agent with custom memory
+ * const agentId = await createAgent({
+ *   memory: ['persona', 'project'],
+ *   persona: 'You are a helpful coding assistant',
+ *   model: 'claude-sonnet-4',
+ *   tags: ['project:docs']
+ * });
+ *
+ * // Then resume the default conversation:
+ * const session = resumeSession(agentId);
+ * ```
+ */
+export declare function createAgent(options?: CreateAgentOptions): Promise<string>;
+/**
+ * Create a new conversation (session).
+ *
+ * - Without agentId: uses default/LRU agent with new conversation (like `letta`)
+ * - With agentId: creates new conversation on specified agent
+ *
+ * @example
+ * ```typescript
+ * // New conversation on default agent (like `letta`)
+ * await using session = createSession();
+ *
+ * // New conversation on specific agent
+ * await using session = createSession(agentId);
+ * ```
+ */
+export declare function createSession(agentId?: string, options?: CreateSessionOptions): LettaCodeSession;
+/**
+ * Resume an existing session.
+ *
+ * - Pass an agent ID (agent-xxx) to resume the default conversation
+ * - Pass a conversation ID (conv-xxx) to resume a specific conversation
+ *
+ * The default conversation always exists after createAgent, so you can:
+ * `createAgent()` → `resumeSession(agentId)` without needing createSession first.
+ *
+ * @example
+ * ```typescript
+ * // Resume default conversation
+ * await using session = resumeSession(agentId);
+ *
+ * // Resume specific conversation
+ * await using session = resumeSession('conv-xxx');
+ * ```
+ */
+export declare function resumeSession(id: string, options?: CreateSessionOptions): LettaCodeSession;
+export declare function prompt(message: string, agentId?: string): Promise<SDKResultMessage>;
+import type { ListMessagesOptions, ListMessagesResult } from "./types.js";
+/**
+ * Fetch conversation messages without requiring a pre-existing session.
+ *
+ * Creates a transient CLI subprocess, fetches the requested message page, and
+ * closes the subprocess.  Useful for prefetching conversation histories before
+ * opening a full session (e.g. desktop sidebar warm-up).
+ *
+ * Routing follows the same agent/conversation semantics as session history:
+ * - Pass a conv-xxx conversationId to read a specific conversation.
+ * - Omit conversationId to read the agent's default conversation.
+ *
+ * @param agentId - Agent ID to fetch messages for.
+ * @param options - Pagination / filtering options (same as ListMessagesOptions).
+ *
+ * @example
+ * ```typescript
+ * // Prefetch default conversation
+ * const { messages } = await listMessagesDirect(agentId);
+ *
+ * // Prefetch a specific conversation
+ * const { messages, hasMore, nextBefore } = await listMessagesDirect(agentId, {
+ *   conversationId: 'conv-abc',
+ *   limit: 20,
+ *   order: 'desc',
+ * });
+ * ```
+ */
+export declare function listMessagesDirect(agentId: string, options?: ListMessagesOptions): Promise<ListMessagesResult>;
+import type { ImageContent } from "./types.js";
+/**
+ * Create image content from a file path.
+ *
+ * @example
+ * ```typescript
+ * await session.send([
+ *   { type: "text", text: "What's in this image?" },
+ *   imageFromFile("./screenshot.png")
+ * ]);
+ * ```
+ */
+export declare function imageFromFile(filePath: string): ImageContent;
+/**
+ * Create image content from base64 data.
+ *
+ * @example
+ * ```typescript
+ * const base64 = fs.readFileSync("image.png").toString("base64");
+ * await session.send([
+ *   { type: "text", text: "Describe this" },
+ *   imageFromBase64(base64, "image/png")
+ * ]);
+ * ```
+ */
+export declare function imageFromBase64(data: string, media_type?: ImageContent["source"]["media_type"]): ImageContent;
+/**
+ * Create image content from a URL.
+ * Fetches the image and converts to base64.
+ *
+ * @example
+ * ```typescript
+ * const img = await imageFromURL("https://example.com/image.png");
+ * await session.send([
+ *   { type: "text", text: "What's this?" },
+ *   img
+ * ]);
+ * ```
+ */
+export declare function imageFromURL(url: string): Promise<ImageContent>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAIH,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAEhB,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAIpB,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAC3B,8BAA8B,EAC9B,4BAA4B,EAC5B,2BAA2B,EAC3B,sBAAsB,EACtB,6BAA6B,EAC7B,gBAAgB,EAChB,mBAAmB,EACnB,0BAA0B,EAC1B,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,EAC1B,4BAA4B,EAC5B,4BAA4B,EAC5B,eAAe,EACf,eAAe,EACf,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,8BAA8B,EAC9B,6BAA6B,EAC7B,WAAW,EACX,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,yBAAyB,EACzB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,sBAAsB,EAEtB,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,WAAW,EAEX,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EAEjB,qBAAqB,EACrB,oBAAoB,EAEpB,SAAS,EACT,eAAe,EACf,sBAAsB,EACtB,uBAAuB,EACvB,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAG5D,OAAO,EACL,UAAU,EACV,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAGnF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC3B,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,GAAE,oBAAyB,GACjC,gBAAgB,CAQlB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,oBAAyB,GACjC,gBAAgB,CAGlB;AAuBD,wBAAsB,MAAM,CAC1B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,CAAC,CAW3B;AAMD,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAY7B;AAOD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAa5D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAe,GAC7D,YAAY,CAKd;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAqBrE"}