ai-sdk-letta 0.1.0

package/dist/agent.js

@@ -0,0 +1,371 @@
+import { generateText, streamText, stepCountIs } from 'ai';
+import { ToolInteractions } from './interactions.js';
+import { assertImageBudget, compactImagePart, decodeImagePart, imagePartDigest, ImageInputError, isImagePart, toLettaImage } from './images.js';
+/** Most characters of text in one user turn. */
+export const MAX_INPUT_CHARACTERS = 8000;
+const usage = () => ({ inputTokens: { total: undefined, noCache: undefined, cacheRead: undefined, cacheWrite: undefined }, outputTokens: { total: undefined, text: undefined, reasoning: undefined } });
+/**
+ * Canonical key of a semantic transcript (text, user images and completed tool
+ * calls), ignoring SDK metadata and step boundaries. Used to reject replayed or
+ * edited history: a new call must extend exactly what this process already
+ * sent. Images are compared by a SHA-256 of their bytes, so a transcript may
+ * carry either the image data or a compact reference to it.
+ */
+export function historyKey(messages) {
+    const parts = [];
+    for (const message of messages) {
+        if (message.role === 'system')
+            throw new Error('System messages are not supported');
+        const content = typeof message.content === 'string' ? [{ type: 'text', text: message.content }] : message.content;
+        for (const part of content) {
+            if (part.type === 'text') {
+                const last = parts.at(-1);
+                if (last?.role === message.role && typeof last.text === 'string')
+                    last.text += part.text;
+                else
+                    parts.push({ role: message.role, text: part.text });
+            }
+            else if (message.role === 'user' && isImagePart(part)) {
+                // A boundary like text: an image between two texts is not the same turn as the joined text.
+                parts.push({ role: message.role, text: null, image: imagePartDigest(part) });
+            }
+            else if (part.type === 'tool-call' && message.role === 'assistant') {
+                parts.push({ call: part.toolCallId, name: part.toolName, input: part.input });
+            }
+            else if (part.type === 'tool-result' && (message.role === 'assistant' || message.role === 'tool')) {
+                // UI error cards stringify provider error objects; conversion returns an
+                // error-json string whereas response.messages retains the original JSON.
+                // Normalize only error payloads, never successful text/JSON outputs.
+                let output = part.output;
+                if (output.type === 'error-json' && typeof output.value === 'string') {
+                    try {
+                        output = { ...output, value: JSON.parse(output.value) };
+                    }
+                    catch { /* plain error text */ }
+                }
+                parts.push({ result: part.toolCallId, name: part.toolName, output });
+            }
+            else
+                throw new Error('Only text, user image and completed application tool history are supported');
+        }
+    }
+    // Parallel calls arrive call/call/result/result, while UI cards convert as
+    // call/result/call/result. Canonicalize contiguous tool groups only; retain
+    // every ID, name, input and output and all text/turn boundaries.
+    const canonical = [];
+    let tools = [];
+    const flush = () => {
+        tools.sort((a, b) => {
+            const key = (value) => { const p = value; return `${p.call ?? p.result}\u0000${p.call ? '0' : '1'}`; };
+            return key(a).localeCompare(key(b));
+        });
+        canonical.push(...tools);
+        tools = [];
+    };
+    for (const part of parts) {
+        if ('text' in part) {
+            flush();
+            canonical.push(part);
+        }
+        else
+            tools.push(part);
+    }
+    flush();
+    return JSON.stringify(canonical);
+}
+/** Replace user image data with content-hash references so the retained transcript never duplicates image bytes. */
+function compactTranscript(messages) {
+    return messages.map(message => message.role === 'user' && typeof message.content !== 'string'
+        ? { ...message, content: message.content.map(part => isImagePart(part) ? compactImagePart(part) : part) }
+        : message);
+}
+/**
+ * Validate the new user turn and build the single Letta message to send:
+ * a plain string for text-only turns, or text and `ImageContent` items in
+ * their original order.
+ * @throws {ImageInputError} for unsupported, invalid or oversized images
+ */
+export function userTurnContent(content) {
+    const parts = typeof content === 'string' ? [{ type: 'text', text: content }] : content;
+    if (!Array.isArray(parts))
+        throw new Error('Expected a new user turn');
+    const items = [];
+    const images = [];
+    for (const part of parts) {
+        if (part.type === 'text') {
+            const last = items.at(-1);
+            if (last?.type === 'text')
+                last.text += part.text;
+            else
+                items.push({ type: 'text', text: part.text });
+        }
+        else if (isImagePart(part)) {
+            const image = decodeImagePart(part);
+            images.push(image);
+            assertImageBudget(images);
+            items.push(toLettaImage(image));
+        }
+        else if (part.type === 'file') {
+            throw new ImageInputError('image_unsupported_type', `Unsupported attachment type ${String(part.mediaType) || 'unknown'}; only PNG, JPEG, GIF and WebP images are supported`);
+        }
+        else
+            throw new Error('Only text and image input is supported');
+    }
+    const text = items.map(item => item.type === 'text' ? item.text : '').join('');
+    if (text.length > MAX_INPUT_CHARACTERS)
+        throw new Error(`Input text can be up to ${MAX_INPUT_CHARACTERS} characters`);
+    if (!text.trim() && !images.length)
+        throw new Error('Input must contain text or an image');
+    // Whitespace-only text next to images carries nothing; keep text-only turns byte-identical to before.
+    const message = images.length ? items.filter(item => item.type !== 'text' || item.text.trim()) : text;
+    return { message, text, images };
+}
+/**
+ * A persistent, Letta-backed Vercel AI SDK `Agent`.
+ *
+ * Letta owns the only reasoning and tool loop: each call sends exactly one new
+ * user message, and application tools run in this process through the Letta
+ * client-tool protocol (reported as `providerExecuted`). The AI SDK never
+ * dispatches tools itself. History you pass in must extend what this instance
+ * already sent; edits, regeneration and replay are rejected. After any failure
+ * or cancellation the instance refuses further turns, because delivery is
+ * uncertain; reopen it after inspecting the backend.
+ */
+export class LettaAgent {
+    version = 'agent-v1';
+    id;
+    tools;
+    /** Letta-generated agent ID, when known. */
+    lettaAgentId;
+    /** Display-only restored state. */
+    presentation;
+    /** Broker for approvals and `ask_user` questions; connect a renderer to it. */
+    interactions;
+    open;
+    memoryTools;
+    delivery;
+    modelId;
+    history = [];
+    busy = false;
+    unusable = false;
+    active;
+    constructor(options) {
+        this.id = options.id;
+        this.tools = options.tools;
+        this.open = options.open;
+        this.memoryTools = options.memoryTools ?? [];
+        this.lettaAgentId = options.lettaAgentId;
+        this.presentation = options.presentation;
+        this.delivery = options.delivery;
+        this.interactions = options.interactions ?? new ToolInteractions();
+        this.modelId = options.modelId ?? 'letta';
+    }
+    /**
+     * A copy of the transcript this instance has sent and received (images as
+     * content-hash references, never bytes). To send a multimodal turn without
+     * keeping your own history, pass `messages: [...agent.transcript, newUserMessage]`.
+     */
+    get transcript() { return structuredClone(this.history); }
+    /** Abort any running turn, cancel pending prompts, and refuse further turns. */
+    close() { this.unusable = true; this.active?.abort(); this.interactions.close(); }
+    prepare(options) {
+        if (this.unusable)
+            throw new Error('Session closed or delivery uncertain; inspect backend history before reopening (no retries).');
+        if (this.busy)
+            throw new Error('A turn is already running');
+        for (const [key, value] of Object.entries(options)) {
+            if (!['prompt', 'messages', 'abortSignal'].includes(key) && value !== undefined)
+                throw new Error(`Unsupported agent option: ${key}`);
+        }
+        if (options.prompt !== undefined && options.messages !== undefined)
+            throw new Error('Use prompt or messages, not both');
+        const messages = typeof options.prompt === 'string' ? [...this.history, { role: 'user', content: options.prompt }] : options.messages ?? options.prompt;
+        if (!Array.isArray(messages) || !messages.length)
+            throw new Error('Expected a new user turn');
+        const last = messages.at(-1);
+        if (last.role !== 'user')
+            throw new Error('History edits, replay, and regeneration are not supported');
+        // Validate the new turn first, so an oversized or unsupported image is reported as such.
+        const turn = userTurnContent(last.content);
+        if (historyKey(messages.slice(0, -1)) !== historyKey(this.history))
+            throw new Error('History edits, replay, and regeneration are not supported');
+        options.abortSignal?.throwIfAborted();
+        this.busy = true;
+        const control = new AbortController();
+        this.active = control;
+        const signal = options.abortSignal ? AbortSignal.any([options.abortSignal, control.signal]) : control.signal;
+        // The retained transcript keeps images as hashes only; Letta already holds the bytes.
+        // (Compact before cloning: URL objects in image parts are not cloneable.)
+        return { messages: structuredClone(compactTranscript(messages)), message: turn.message, prompt: turn.text.trim() ? turn.text : '[Image]', signal };
+    }
+    model(message, signal) {
+        const run = async (emit) => {
+            let session;
+            let completed = false;
+            const abort = () => { void session?.abort().catch(() => { }); session?.close(); };
+            const calls = new Map();
+            const memoryCalls = new Set();
+            const tokens = usage();
+            let textId = 0;
+            let textOpen = false;
+            const endText = () => { if (textOpen) {
+                emit({ type: 'text-end', id: String(textId) });
+                textOpen = false;
+            } };
+            try {
+                signal.throwIfAborted();
+                session = this.open(signal);
+                signal.addEventListener('abort', abort, { once: true });
+                this.delivery?.begin();
+                await session.send(message);
+                signal.throwIfAborted();
+                for await (const event of session.stream()) {
+                    signal.throwIfAborted();
+                    if (event.type === 'assistant') {
+                        if (!textOpen) {
+                            textId++;
+                            emit({ type: 'text-start', id: String(textId) });
+                            textOpen = true;
+                        }
+                        emit({ type: 'text-delta', id: String(textId), delta: event.content });
+                    }
+                    else if (event.type === 'tool_call') {
+                        endText();
+                        if (calls.has(event.toolCallId) || memoryCalls.has(event.toolCallId))
+                            throw new Error('Duplicate tool call');
+                        // Harness memory operations are not application tool cards/history.
+                        if (this.memoryTools.includes(event.toolName)) {
+                            memoryCalls.add(event.toolCallId);
+                            continue;
+                        }
+                        if (!Object.hasOwn(this.tools, event.toolName))
+                            throw new Error('Unexpected tool call');
+                        calls.set(event.toolCallId, event.toolName);
+                        emit({ type: 'tool-call', toolCallId: event.toolCallId, toolName: event.toolName, input: JSON.stringify(event.toolInput), providerExecuted: true });
+                    }
+                    else if (event.type === 'tool_result') {
+                        // The SDK can emit provisional Bash output as a tool_result before
+                        // the authoritative result. Only known internal calls may use it.
+                        if (memoryCalls.has(event.toolCallId) && event.uuid.startsWith('synthetic-tool-return-stream-'))
+                            continue;
+                        if (memoryCalls.delete(event.toolCallId))
+                            continue;
+                        const toolName = calls.get(event.toolCallId);
+                        if (!toolName)
+                            throw new Error('Unmatched tool result');
+                        let result = event.content;
+                        try {
+                            result = JSON.parse(event.content);
+                        }
+                        catch { /* SDK text output */ }
+                        emit({ type: 'tool-result', toolCallId: event.toolCallId, toolName, result: result ?? 'null', isError: event.isError });
+                        calls.delete(event.toolCallId);
+                    }
+                    else if (event.type === 'stream_event' && event.event.message_type === 'usage_statistics') {
+                        if (typeof event.event.prompt_tokens === 'number')
+                            tokens.inputTokens.total = event.event.prompt_tokens;
+                        if (typeof event.event.completion_tokens === 'number')
+                            tokens.outputTokens.total = event.event.completion_tokens;
+                    }
+                    else if (event.type === 'result') {
+                        if (!event.success || calls.size || memoryCalls.size)
+                            throw new Error('Letta turn failed or left incomplete tools');
+                        endText();
+                        completed = true;
+                        emit({ type: 'finish', finishReason: { unified: 'stop', raw: 'stop' }, usage: tokens });
+                        return;
+                    }
+                }
+                throw new Error('Letta stream closed before completion');
+            }
+            catch (error) {
+                this.unusable = true;
+                throw error;
+            }
+            finally {
+                signal.removeEventListener('abort', abort);
+                if (!completed)
+                    void session?.abort().catch(() => { });
+                session?.close();
+            }
+        };
+        return {
+            specificationVersion: 'v4', provider: 'ai-sdk-letta', modelId: this.modelId, supportedUrls: {},
+            doGenerate: async () => {
+                const content = [];
+                let tokens = usage();
+                await run(part => {
+                    if (part.type === 'text-delta') {
+                        const last = content.at(-1);
+                        if (last?.type === 'text')
+                            last.text += part.delta;
+                        else
+                            content.push({ type: 'text', text: part.delta });
+                    }
+                    else if (part.type === 'tool-call' || part.type === 'tool-result')
+                        content.push(part);
+                    else if (part.type === 'finish')
+                        tokens = part.usage;
+                });
+                return { content, usage: tokens, warnings: [], finishReason: { unified: 'stop', raw: 'stop' } };
+            },
+            doStream: async () => ({ stream: new ReadableStream({
+                    start: controller => {
+                        controller.enqueue({ type: 'stream-start', warnings: [] });
+                        void run(part => controller.enqueue(part)).catch(error => {
+                            try {
+                                controller.enqueue({ type: 'error', error });
+                            }
+                            catch { /* reader closed */ }
+                        }).finally(() => { try {
+                            controller.close();
+                        }
+                        catch { /* reader closed */ } });
+                    },
+                    cancel: () => this.close(),
+                }) }),
+        };
+    }
+    /** Run one turn and wait for the full result. */
+    async generate(options) {
+        const turn = this.prepare(options);
+        try {
+            const result = await generateText({ model: this.model(turn.message, turn.signal), prompt: turn.prompt, tools: this.tools, maxRetries: 0, stopWhen: stepCountIs(1), abortSignal: turn.signal });
+            this.delivery?.complete();
+            this.history = [...turn.messages, ...result.response.messages];
+            return result;
+        }
+        catch (error) {
+            this.unusable = true;
+            throw error;
+        }
+        finally {
+            this.busy = false;
+            this.active = undefined;
+        }
+    }
+    /** Run one turn as a stream (text deltas, provider-executed tool calls and results). */
+    async stream(options) {
+        const turn = this.prepare(options);
+        return streamText({ model: this.model(turn.message, turn.signal), prompt: turn.prompt, tools: this.tools, maxRetries: 0, stopWhen: stepCountIs(1), abortSignal: turn.signal,
+            onError: () => { this.unusable = true; this.busy = false; },
+            onAbort: () => { this.close(); this.busy = false; },
+            onFinish: result => {
+                try {
+                    if (!this.unusable && result.finishReason === 'stop')
+                        this.delivery?.complete();
+                }
+                catch (error) {
+                    this.unusable = true;
+                    throw error;
+                }
+                finally {
+                    this.busy = false;
+                    this.active = undefined;
+                }
+                this.history = [...turn.messages, ...result.response.messages];
+            },
+        });
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/definition.d.ts

@@ -0,0 +1,81 @@
+import type { ToolSet } from 'ai';
+import type { CreateAgentOptions } from '@letta-ai/letta-agent-sdk';
+/** How a single application tool call is authorized. */
+export type ToolPermission = 'allow' | 'ask' | 'deny';
+/** When Letta runs background memory consolidation ("dreaming"). */
+export type DreamingTrigger = 'off' | 'step-count' | 'compaction-event';
+export interface DreamingSettings {
+    /** @default 'step-count' */
+    trigger: DreamingTrigger;
+    /** Steps between dreams when `trigger` is `'step-count'`. @default 25 */
+    stepCount: number;
+}
+/** Input accepted by {@link defineAgent}. */
+export interface AgentDefinitionInput<TOOLS extends ToolSet = ToolSet> {
+    /**
+     * Stable, application-owned logical ID (lowercase letters, digits and `-`).
+     * It is mapped once to the Letta-generated agent ID and never re-created.
+     */
+    id: string;
+    /** Display name. Also stored on the Letta agent and checked on every start. */
+    name: string;
+    /**
+     * Letta model handle, e.g. `openai-codex/gpt-5.5` or `anthropic/claude-sonnet-4-5`.
+     * Only used when the agent is first created; must be connected on the local backend.
+     */
+    model: string;
+    /** System instructions, applied when the agent is first created. */
+    instructions: string;
+    /** AI SDK tools executed in this process when the agent calls them. */
+    tools: TOOLS;
+    /**
+     * Permission per tool. Fail-closed: every tool must be listed.
+     * `ask_user` defaults to `'allow'` (it is itself a human interaction).
+     */
+    permissions?: Partial<Record<Extract<keyof TOOLS, string>, ToolPermission>>;
+    /** Background memory consolidation. @default { trigger: 'step-count', stepCount: 25 } */
+    dreaming?: Partial<DreamingSettings>;
+    /** Per-call tool execution deadline in milliseconds (human waits excluded). @default 5000 */
+    toolTimeoutMs?: number;
+}
+/** A validated, immutable agent definition. */
+export interface AgentDefinition<TOOLS extends ToolSet = ToolSet> {
+    readonly id: string;
+    readonly name: string;
+    readonly model: string;
+    readonly instructions: string;
+    readonly tools: TOOLS;
+    readonly permissions: Readonly<Record<string, ToolPermission>>;
+    readonly dreaming: Readonly<DreamingSettings>;
+    readonly toolTimeoutMs: number;
+}
+/** Tools the harness uses for MemFS. They are confined to the agent's own memory directory. */
+export declare const INTERNAL_MEMORY_TOOLS: readonly ["Read", "Write", "Edit", "Bash"];
+export declare const DEFAULT_DREAMING: Readonly<DreamingSettings>;
+/**
+ * Validate and freeze an agent definition.
+ *
+ * @throws if the ID is invalid, a tool lacks a permission, or a permission names an unknown tool.
+ */
+export declare function defineAgent<TOOLS extends ToolSet>(input: AgentDefinitionInput<TOOLS>): AgentDefinition<TOOLS>;
+/**
+ * Appended to the definition's instructions at creation, so the model knows
+ * what the (enforced) memory policy allows.
+ */
+export declare function memoryPolicyInstructions(dreaming: DreamingSettings): string;
+/** Letta Agent SDK creation options for a definition. */
+export declare function creationOptions(definition: AgentDefinition, cwd: string): CreateAgentOptions;
+/** Protocol command that applies dreaming settings to this project scope only. */
+export declare function dreamingCommand(definition: AgentDefinition, agentId: string, conversationId?: string): {
+    readonly type: "set_reflection_settings";
+    readonly runtime: {
+        readonly agent_id: string;
+        readonly conversation_id: string;
+    };
+    readonly scope: "local_project";
+    readonly settings: {
+        readonly trigger: DreamingTrigger;
+        readonly step_count: number;
+    };
+};
+//# sourceMappingURL=definition.d.ts.map

package/dist/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../src/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,wDAAwD;AACxD,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAEtD,oEAAoE;AACpE,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,YAAY,GAAG,kBAAkB,CAAC;AAExE,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,OAAO,EAAE,eAAe,CAAC;IACzB,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6CAA6C;AAC7C,MAAM,WAAW,oBAAoB,CAAC,KAAK,SAAS,OAAO,GAAG,OAAO;IACnE;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,KAAK,EAAE,KAAK,CAAC;IACb;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,EAAE,MAAM,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;IAC5E,yFAAyF;IACzF,QAAQ,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrC,6FAA6F;IAC7F,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,+CAA+C;AAC/C,MAAM,WAAW,eAAe,CAAC,KAAK,SAAS,OAAO,GAAG,OAAO;IAC9D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IAC/D,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC9C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,+FAA+F;AAC/F,eAAO,MAAM,qBAAqB,4CAA6C,CAAC;AAEhF,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB,CAA2D,CAAC;AAIpH;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,SAAS,OAAO,EAAE,KAAK,EAAE,oBAAoB,CAAC,KAAK,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,CAkC7G;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAM3E;AAED,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAQ5F;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,UAAU,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,SAAY;;;;;;;;;;;EAKvG"}

package/dist/definition.js

@@ -0,0 +1,87 @@
+import { ASK_USER_TOOL } from './tools.js';
+/** Tools the harness uses for MemFS. They are confined to the agent's own memory directory. */
+export const INTERNAL_MEMORY_TOOLS = ['Read', 'Write', 'Edit', 'Bash'];
+export const DEFAULT_DREAMING = Object.freeze({ trigger: 'step-count', stepCount: 25 });
+const permissionValues = ['allow', 'ask', 'deny'];
+/**
+ * Validate and freeze an agent definition.
+ *
+ * @throws if the ID is invalid, a tool lacks a permission, or a permission names an unknown tool.
+ */
+export function defineAgent(input) {
+    if (typeof input.id !== 'string' || !/^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$/.test(input.id)) {
+        throw new Error('Agent id must be 1–64 lowercase letters, digits or "-", starting and ending with a letter or digit');
+    }
+    if (typeof input.name !== 'string' || !input.name.trim() || input.name.length > 120)
+        throw new Error('Agent name must contain 1–120 characters');
+    if (typeof input.model !== 'string' || !input.model.includes('/'))
+        throw new Error('Agent model must be a Letta model handle such as "provider/model"');
+    if (typeof input.instructions !== 'string' || !input.instructions.trim())
+        throw new Error('Agent instructions are required');
+    if (input.tools === null || typeof input.tools !== 'object' || Array.isArray(input.tools))
+        throw new Error('Agent tools must be an object of AI SDK tools; use {} for none');
+    const names = Object.keys(input.tools);
+    for (const name of names) {
+        if (INTERNAL_MEMORY_TOOLS.includes(name))
+            throw new Error(`Tool name "${name}" is reserved for memory operations`);
+        if (!/^[a-zA-Z0-9_-]{1,64}$/.test(name))
+            throw new Error(`Invalid tool name "${name}"`);
+    }
+    const permissions = {};
+    for (const [name, mode] of Object.entries(input.permissions ?? {})) {
+        if (!names.includes(name))
+            throw new Error(`Permission for unknown tool "${name}"`);
+        if (!permissionValues.includes(mode))
+            throw new Error(`Invalid permission for "${name}"`);
+        permissions[name] = mode;
+    }
+    if (names.includes(ASK_USER_TOOL)) {
+        permissions[ASK_USER_TOOL] ??= 'allow';
+        if (permissions[ASK_USER_TOOL] === 'ask')
+            throw new Error('ask_user is already interactive; use "allow" or "deny"');
+    }
+    const missing = names.filter(name => !Object.hasOwn(permissions, name));
+    if (missing.length)
+        throw new Error(`Missing permission for tool(s): ${missing.join(', ')}. Every tool needs "allow", "ask" or "deny".`);
+    const dreaming = { ...DEFAULT_DREAMING, ...input.dreaming };
+    if (!['off', 'step-count', 'compaction-event'].includes(dreaming.trigger))
+        throw new Error('Invalid dreaming trigger');
+    if (!Number.isInteger(dreaming.stepCount) || dreaming.stepCount < 1 || dreaming.stepCount > 10_000)
+        throw new Error('Dreaming stepCount must be a positive integer');
+    const toolTimeoutMs = input.toolTimeoutMs ?? 5000;
+    if (!Number.isInteger(toolTimeoutMs) || toolTimeoutMs < 1 || toolTimeoutMs > 300_000)
+        throw new Error('toolTimeoutMs must be 1–300000');
+    return Object.freeze({
+        id: input.id, name: input.name, model: input.model, instructions: input.instructions, tools: input.tools,
+        permissions: Object.freeze(permissions), dreaming: Object.freeze(dreaming), toolTimeoutMs,
+    });
+}
+/**
+ * Appended to the definition's instructions at creation, so the model knows
+ * what the (enforced) memory policy allows.
+ */
+export function memoryPolicyInstructions(dreaming) {
+    return 'Maintain useful long-term memory in your own MemFS only. Read, Write and Edit are restricted to Markdown files in your memory directory. '
+        + 'Bash is restricted to the exact memory commit command supplied in tool permission feedback; no general shell or filesystem actions are available. '
+        + (dreaming.trigger === 'off'
+            ? 'Background dreaming is off.'
+            : `Background dreaming consolidates memory${dreaming.trigger === 'step-count' ? ` after ${dreaming.stepCount} steps` : ' after compaction'}; do not claim a dream ran without evidence.`);
+}
+/** Letta Agent SDK creation options for a definition. */
+export function creationOptions(definition, cwd) {
+    return {
+        name: definition.name, model: definition.model, cwd, memfs: true,
+        baseTools: [], skillSources: [], systemPrompt: `${definition.instructions}\n\n${memoryPolicyInstructions(definition.dreaming)}`,
+        // Do not pass `dreaming` here: the SDK applies it with scope 'both', which
+        // mutates the user's global Letta defaults. The runtime installs the
+        // definition's settings with scope 'local_project' in the private state cwd.
+    };
+}
+/** Protocol command that applies dreaming settings to this project scope only. */
+export function dreamingCommand(definition, agentId, conversationId = 'default') {
+    return {
+        type: 'set_reflection_settings', runtime: { agent_id: agentId, conversation_id: conversationId },
+        scope: 'local_project', settings: { trigger: definition.dreaming.trigger, step_count: definition.dreaming.stepCount },
+    };
+}
+//# sourceMappingURL=definition.js.map

package/dist/definition.js.map

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

package/dist/history.d.ts

@@ -0,0 +1,38 @@
+import type { LettaCodeSession, ListMessagesOptions, ListMessagesResult, LettaConversation } from '@letta-ai/letta-agent-sdk';
+import type { UIMessage } from 'ai';
+/** Maximum backend records loaded when restoring a conversation's display history. */
+export declare const HISTORY_LIMIT = 10000;
+/** Strip terminal escape sequences and control characters from untrusted text. */
+export declare const sanitizeText: (text: string) => string;
+/** The installed SDK drops agent_id for default history. Its supported command
+ * escape hatch forwards the backend's agent-scoped query, including real cursors.
+ * Named conversations use the ordinary SDK API. Neither path sends input.
+ */
+export declare function historyPage(session: Pick<LettaCodeSession, 'listMessages' | 'sendCommand'>, agentId: string, conversationId: string, options: ListMessagesOptions, timeoutMs?: number): Promise<ListMessagesResult>;
+/** Page backwards through history up to `maximum` records, validating cursors and IDs. */
+export declare function loadHistory(page: (options: ListMessagesOptions) => Promise<ListMessagesResult>, maximum?: number): Promise<{
+    messages: ListMessagesResult['messages'];
+    truncated: boolean;
+}>;
+/** Text shown for a user image that cannot be displayed (unsupported, invalid, or over the display budget). */
+export declare const IMAGE_PLACEHOLDER = "[Image]";
+/** Most decoded image bytes restored for display from one conversation, newest first. Older images become placeholders. */
+export declare const HISTORY_IMAGE_BUDGET: number;
+/** Display projection only. Never reconstruct the model's context from this.
+ * Completed allowlisted app tools become inert output cards; everything else is
+ * omitted, including pending approvals, reasoning, system, memory and events.
+ * User images become `file` parts with a `data:` URL (newest first, within
+ * `imageBudget` bytes); the rest become an `[Image]` text placeholder.
+ */
+export declare function projectHistory(messages: ListMessagesResult['messages'], appTools: readonly string[], imageBudget?: number): UIMessage[];
+/** @throws when the conversation ends with an unanswered user turn or an unfinished tool call. */
+export declare function assertHistorySettled(messages: ListMessagesResult['messages']): void;
+/** List every conversation of one agent, failing closed on foreign or repeated rows. */
+export declare function listConversations(list: (options: {
+    agentId: string;
+    after?: string;
+    limit: number;
+    order: 'asc';
+    orderBy: 'createdAt';
+}) => Promise<LettaConversation[]>, agentId: string): Promise<LettaConversation[]>;
+//# sourceMappingURL=history.d.ts.map

package/dist/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9H,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAGpC,sFAAsF;AACtF,eAAO,MAAM,aAAa,QAAS,CAAC;AAGpC,kFAAkF;AAClF,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,WAA6I,CAAC;AAEvL;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,cAAc,GAAG,aAAa,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAOzN;AAED,0FAA0F;AAC1F,wBAAsB,WAAW,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,kBAAkB,CAAC,EAAE,OAAO,SAAgB,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CA2BzM;AAqBD,+GAA+G;AAC/G,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAC3C,2HAA2H;AAC3H,eAAO,MAAM,oBAAoB,QAAmB,CAAC;AAiCrD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,kBAAkB,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,WAAW,SAAuB,GAAG,SAAS,EAAE,CA8CrJ;AAED,kGAAkG;AAClG,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,UAAU,CAAC,QAe5E;AAED,wFAAwF;AACxF,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,KAAK,OAAO,CAAC,iBAAiB,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAe9N"}