@letta-ai/letta-agent-sdk 0.2.7 → 0.3.1

package/dist/client-base.d.ts

@@ -0,0 +1,61 @@
+import { RepositoriesClient } from "./repositories.js";
+import { type ManagementTransport } from "./management.js";
+import type { AgentsClient, ConversationsClient, ModelsClient } from "./management-types.js";
+import type { CreateAgentOptions, CreateSessionOptions, LettaCodeBackend, LettaCodeClientOptions, LettaCodeClientSessionOptions, LettaCodeEnvironment, LettaCodeSession, SDKResultMessage, SendMessage } from "./types.js";
+/**
+ * Top-level Letta Agent SDK client.
+ *
+ * `backend` selects how the SDK reaches or runs the Letta Code harness.
+ * `local` spawns an SDK-owned Letta Code app-server and speaks the websocket
+ * protocol by default, with an explicit stdio fallback for legacy flows.
+ * `remote` connects to a user-managed Letta Code app-server websocket endpoint.
+ * `cloud` uses agents hosted on Letta Cloud, with an explicit remote
+ * environment or SDK-managed sandbox.
+ */
+export declare class LettaAgentClientBase {
+    readonly backend: LettaCodeBackend;
+    readonly environment: LettaCodeEnvironment | undefined;
+    readonly agents: AgentsClient;
+    readonly conversations: ConversationsClient;
+    readonly models: ModelsClient;
+    protected readonly options: LettaCodeClientOptions;
+    private repositoriesClient;
+    private managementTransport;
+    constructor(options?: LettaCodeClientOptions);
+    /**
+     * Create a new Letta Code agent with a default conversation.
+     *
+     * Environment/device selection is intentionally not part of the agent payload;
+     * it belongs to the client/session execution context.
+     */
+    get repositories(): RepositoriesClient;
+    createAgent(options?: CreateAgentOptions): Promise<string>;
+    /**
+     * Create a new conversation/session.
+     *
+     * Without an agent id, this uses the default/LRU agent, matching the legacy
+     * top-level createSession() helper.
+     */
+    createSession(agentIdOrOptions?: string | LettaCodeClientSessionOptions, options?: LettaCodeClientSessionOptions): LettaCodeSession;
+    /**
+     * Resume an existing agent default conversation or a specific conversation.
+     *
+     * `options.environment` overrides the client's default execution target for
+     * Letta Cloud sessions. Remote app-server URLs already select the runtime.
+     */
+    resumeSession(id: string, options?: LettaCodeClientSessionOptions): LettaCodeSession;
+    /** One-shot prompt convenience helper using a new conversation. */
+    prompt(message: SendMessage, agentId?: string, options?: LettaCodeClientSessionOptions): Promise<SDKResultMessage>;
+    private assertSessionBackend;
+    protected useLegacyLocalStdio(): boolean;
+    protected createLocalAgent(_options: CreateAgentOptions): Promise<string>;
+    protected createLocalSession(_agentId: string | undefined, _options: LettaCodeClientSessionOptions, _sessionOptions: CreateSessionOptions): LettaCodeSession;
+    protected resumeLocalSession(_id: string, _options: LettaCodeClientSessionOptions, _sessionOptions: CreateSessionOptions): LettaCodeSession;
+    protected localBackendUnavailableError(): Error;
+    protected createLocalManagementTransport(): ManagementTransport;
+    private remoteOptions;
+    private getRepositoriesClient;
+    private getManagementTransport;
+    private cloudOptions;
+}
+//# sourceMappingURL=client-base.d.ts.map

package/dist/client-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-base.d.ts","sourceRoot":"","sources":["../src/client-base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAavD,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,6BAA6B,EAC7B,oBAAoB,EAIpB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACZ,MAAM,YAAY,CAAC;AAkDpB;;;;;;;;;GASG;AACH,qBAAa,oBAAoB;IAC/B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACnD,OAAO,CAAC,kBAAkB,CAAmC;IAC7D,OAAO,CAAC,mBAAmB,CAAoC;gBAEnD,OAAO,GAAE,sBAA2B;IAyEhD;;;;;OAKG;IACH,IAAI,YAAY,IAAI,kBAAkB,CAErC;IAEK,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC;IAwBpE;;;;;OAKG;IACH,aAAa,CACX,gBAAgB,CAAC,EAAE,MAAM,GAAG,6BAA6B,EACzD,OAAO,GAAE,6BAAkC,GAC1C,gBAAgB;IAuCnB;;;;;OAKG;IACH,aAAa,CACX,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,6BAAkC,GAC1C,gBAAgB;IAsCnB,mEAAmE;IAC7D,MAAM,CACV,OAAO,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,GAAE,6BAAkC,GAC1C,OAAO,CAAC,gBAAgB,CAAC;IAY5B,OAAO,CAAC,oBAAoB;IAsD5B,SAAS,CAAC,mBAAmB,IAAI,OAAO;IAIxC,SAAS,CAAC,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAIzE,SAAS,CAAC,kBAAkB,CAC1B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE,6BAA6B,EACvC,eAAe,EAAE,oBAAoB,GACpC,gBAAgB;IAInB,SAAS,CAAC,kBAAkB,CAC1B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,6BAA6B,EACvC,eAAe,EAAE,oBAAoB,GACpC,gBAAgB;IAInB,SAAS,CAAC,4BAA4B,IAAI,KAAK;IAM/C,SAAS,CAAC,8BAA8B,IAAI,mBAAmB;IAI/D,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,sBAAsB;IAgB9B,OAAO,CAAC,YAAY;CAMrB"}

package/dist/client-entry.d.ts

@@ -0,0 +1,19 @@
+import { LettaAgentClientBase } from "./client-base.js";
+import type { LettaCodeCloudClientOptions, LettaCodeRemoteClientOptions } from "./types.js";
+export type PortableLettaAgentClientOptions = LettaCodeRemoteClientOptions | LettaCodeCloudClientOptions;
+/**
+ * Portable Letta Agent SDK client for browsers and React Native.
+ *
+ * This entry point intentionally excludes local process execution. Use the
+ * package root from Node.js when `backend: "local"` is required.
+ */
+export declare class LettaAgentClient extends LettaAgentClientBase {
+    constructor(options: PortableLettaAgentClientOptions);
+}
+export { CloudManagedSandboxExpiredError } from "./cloud-session.js";
+export { RepositoriesClient } from "./repositories.js";
+export type * from "./management-types.js";
+export { extractStreamTextDelta } from "./stream-events.js";
+export { createReactNativeWebSocketConstructor } from "./websocket.js";
+export type * from "./types.js";
+//# sourceMappingURL=client-entry.d.ts.map

package/dist/client-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-entry.d.ts","sourceRoot":"","sources":["../src/client-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EACV,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,+BAA+B,GACvC,4BAA4B,GAC5B,2BAA2B,CAAC;AAEhC;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,oBAAoB;gBAC5C,OAAO,EAAE,+BAA+B;CAMrD;AAED,OAAO,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,mBAAmB,uBAAuB,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,qCAAqC,EAAE,MAAM,gBAAgB,CAAC;AACvE,mBAAmB,YAAY,CAAC"}