gemi 0.135.0 → 0.137.0

package/dist/ai/memory/AgentMemories.d.ts

@@ -0,0 +1,226 @@
+import { type AgentMemoryKind, type AgentMemoryListOptions, type AgentMemoryRecord, type AgentMemorySearchOptions, type AgentMemorySource, type AgentMemoryStore, type AgentMemoryUpdate, type AgentMemoryWriteAction, InMemoryAgentMemoryStore } from "./AgentMemoryStore";
+/**
+ * A memory about to be written, as `beforeWrite` sees it. Return it (changed
+ * or not) to let the write through, or `null` to refuse it.
+ */
+export type AgentMemoryDraft = {
+    /** The scope key. Changing it is refused: a write stays in the scope it was made for. */
+    scope: string;
+    kind: AgentMemoryKind;
+    content: string;
+    key: string | null;
+    tags: string[];
+    pinned: boolean;
+    expiresAt: number | null;
+    source: AgentMemorySource;
+};
+/**
+ * What `onWrite` hears: a memory added, changed or deleted, or a whole scope
+ * erased. A write that changed nothing (`unchanged`) is not reported.
+ */
+export type AgentMemoryWriteEvent = {
+    action: "added" | "updated";
+    memory: AgentMemoryRecord;
+    by: AgentMemorySource["by"];
+} | {
+    action: "deleted";
+    memory: AgentMemoryRecord;
+    by: AgentMemorySource["by"];
+    /** What the agent gave as its reason, for a `forget`. */
+    reason?: string;
+} | {
+    action: "scope-deleted";
+    scope: string;
+    count: number;
+    by: AgentMemorySource["by"];
+};
+export type AgentMemoriesHooks = {
+    /**
+     * Called before every write, the agent's and the app's: return the memory
+     * to store (changed or not), or `null` to refuse it. An agent is told its
+     * write was refused. Where an app adds its own rules: words it never keeps,
+     * a scope that is switched off, a stricter length.
+     */
+    beforeWrite?: (memory: AgentMemoryDraft, info: {
+        existing: AgentMemoryRecord | null;
+    }) => AgentMemoryDraft | null | void | Promise<AgentMemoryDraft | null | void>;
+    /**
+     * Called after every write that changed something, the agent's and the
+     * app's. For a live "what we remember" screen, or an audit log: deletes are
+     * hard, and this is the only record of them. A hook that throws is logged
+     * and does not undo the write.
+     */
+    onWrite?: (event: AgentMemoryWriteEvent) => void | Promise<void>;
+};
+/** What `AgentMemories.put` takes. */
+export type AgentMemoryInput = {
+    kind: AgentMemoryKind;
+    content: string;
+    key?: string | null;
+    tags?: string[];
+    pinned?: boolean;
+    expiresAt?: number | null;
+    /** Default `{ by: "app" }`. A memory the user typed in a settings screen is `{ by: "user" }`. */
+    source?: AgentMemorySource;
+};
+/** What `AgentMemories.export` answers: everything a scope holds, for a data-access request. */
+export type AgentMemoryExport = {
+    scope: string;
+    /** Epoch milliseconds. */
+    exportedAt: number;
+    memories: AgentMemoryRecord[];
+};
+/** `beforeWrite` said no. An agent's tool is told so; the app's own call throws this. */
+export declare class AgentMemoryRefusedError extends Error {
+    constructor(message?: string);
+}
+/** `update` was given a `version` the memory is no longer at: someone else changed it first. */
+export declare class AgentMemoryConflictError extends Error {
+    readonly current: AgentMemoryRecord;
+    constructor(current: AgentMemoryRecord, expected: number);
+}
+/**
+ * Agent memory outside a run (#936): where memories are kept, and the app's
+ * API over them.
+ *
+ *     AgentMemories.use(new DatabaseAgentMemoryStore(app(DatabaseManager).connection()), {
+ *       onWrite: (event) => Broadcast.to(…).emit("memory", event),
+ *     });
+ *
+ *     await AgentMemories.list(`project:${project.publicId}`);
+ *     await AgentMemories.deleteScope(`user:${user.publicId}`);
+ *
+ * Process-wide, like `AgentJobs`, because a settings screen, an account
+ * deletion and a queued job have no run to reach it through.
+ *
+ * NOTHING HERE CHECKS WHO IS ASKING. A scope key is a capability, as a
+ * `threadId` is: the app's route decides whether the caller may read or
+ * change `project:<id>` before it calls any of these, the same way it does
+ * for threads. Inside a run, tools reach memory through `ctx.memory`, which
+ * only knows the scopes the server resolved for that run.
+ */
+export declare const AgentMemories: {
+    /** The store every part of the feature reads and writes. */
+    readonly store: AgentMemoryStore;
+    /** The hooks given to `use`. */
+    readonly hooks: AgentMemoriesHooks;
+    /**
+     * Sets the store, and the hooks. Call it once, at boot, in every process
+     * that runs agents or reads memories. The default is an
+     * `InMemoryAgentMemoryStore`, which a restart empties.
+     */
+    use(store: AgentMemoryStore, hooks?: AgentMemoriesHooks): void;
+    /** A scope's memories (or several scopes'), oldest first. Paginate with `after`. */
+    list(scope: string | readonly string[], options?: AgentMemoryListOptions): Promise<AgentMemoryRecord[]>;
+    get(id: string): Promise<AgentMemoryRecord | null>;
+    /** Keyword search, best first, as the `recall` tool does it. */
+    search(scope: string | readonly string[], query: string, options?: AgentMemorySearchOptions): Promise<AgentMemoryRecord[]>;
+    /**
+     * Writes a memory into a scope, as the app (`source.by` defaults to
+     * `"app"`): a fact from a form the user filled in, a pin from a settings
+     * screen. With a `key` it replaces the memory at that key. Goes through
+     * `beforeWrite` and `onWrite`; throws `AgentMemoryRefusedError` when
+     * `beforeWrite` refuses it.
+     *
+     * Not held to the limits an agent's writes are (length, secrets, how many
+     * per scope): the app is trusted with its own data. Validate what a user
+     * types here as you would any input.
+     */
+    put(scope: string, input: AgentMemoryInput): Promise<{
+        record: AgentMemoryRecord;
+        action: AgentMemoryWriteAction;
+    }>;
+    /**
+     * Changes a memory. With `{ version }`, only when it is still at that
+     * version, which is what a settings screen editing a memory an agent may
+     * be changing at the same time passes: a conflict throws
+     * `AgentMemoryConflictError` carrying the current memory. `null` when there
+     * is no such memory. Goes through `beforeWrite` and `onWrite`.
+     */
+    update(id: string, patch: AgentMemoryUpdate, options?: {
+        version?: number;
+        by?: AgentMemorySource["by"];
+    }): Promise<AgentMemoryRecord | null>;
+    /**
+     * Hard-deletes memories, and answers how many there were. `onWrite` hears
+     * each one. There is no soft delete: what the user erases is gone.
+     */
+    delete(ids: string | readonly string[], options?: {
+        by?: AgentMemorySource["by"];
+    }): Promise<number>;
+    /**
+     * Hard-deletes everything a scope holds: an account deletion, an erasure
+     * request, "forget everything" in a settings screen.
+     */
+    deleteScope(scope: string, options?: {
+        by?: AgentMemorySource["by"];
+    }): Promise<number>;
+    /** Everything a scope holds, expired memories included: for a data-access or portability request. */
+    export(scope: string): Promise<AgentMemoryExport>;
+    /**
+     * Swaps in a `FakeAgentMemoryStore` for a test, and answers it: an
+     * in-memory store that records what was written, with assertions. Call
+     * `restore()` after the test; a second `fake()` before that answers the
+     * same fake.
+     */
+    fake(): FakeAgentMemoryStore;
+};
+/**
+ * One write, the agent's or the app's: `beforeWrite`, then the store, then
+ * `onWrite`. The run's checks (length, secrets, limits) come before this and
+ * only for an agent's writes.
+ */
+export declare function writeMemory(draft: AgentMemoryDraft, options?: {
+    replaces?: AgentMemoryRecord;
+}): Promise<{
+    record: AgentMemoryRecord;
+    action: AgentMemoryWriteAction;
+}>;
+/** Deletes by id, reporting each to `onWrite`. */
+export declare function deleteMemories(ids: readonly string[], by: AgentMemorySource["by"], reason?: string): Promise<number>;
+/** One write a fake saw. */
+export type RecordedMemoryWrite = {
+    action: AgentMemoryWriteAction;
+    record: AgentMemoryRecord;
+} | {
+    action: "deleted";
+    id: string;
+} | {
+    action: "scope-deleted";
+    scope: string;
+};
+/**
+ * The store `AgentMemories.fake()` installs: an `InMemoryAgentMemoryStore`
+ * that also records every write, with assertions for a test. The assertions
+ * throw plain `Error`s naming what was written, so they work under any test
+ * runner.
+ */
+export declare class FakeAgentMemoryStore extends InMemoryAgentMemoryStore {
+    private readonly previous;
+    private readonly previousHooks;
+    /** Every write since the fake was installed, in order. */
+    readonly writes: RecordedMemoryWrite[];
+    constructor(previous: AgentMemoryStore, previousHooks: AgentMemoriesHooks);
+    upsert(memory: Parameters<InMemoryAgentMemoryStore["upsert"]>[0]): Promise<{
+        record: AgentMemoryRecord;
+        action: AgentMemoryWriteAction;
+    }>;
+    update(id: string, patch: AgentMemoryUpdate, expectedVersion?: number): Promise<AgentMemoryRecord>;
+    delete(ids: readonly string[]): Promise<number>;
+    deleteScope(scope: string): Promise<number>;
+    /** Puts back the store and hooks that were there before `fake()`. */
+    restore(): void;
+    /**
+     * Fails unless a memory was added or updated in `scope` whose content
+     * matches: a string it contains, a regular expression, or a predicate over
+     * the whole record.
+     */
+    assertRemembered(scope: string, match?: string | RegExp | ((record: AgentMemoryRecord) => boolean)): void;
+    /** Fails unless the memory with this id was deleted. */
+    assertForgotten(id: string): void;
+    /** Fails if any memory was added or updated. */
+    assertNothingRemembered(): void;
+    private saved;
+    private summary;
+}
+//# sourceMappingURL=AgentMemories.d.ts.map

package/dist/ai/memory/AgentMemories.d.ts.map

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

package/dist/ai/memory/AgentMemoryStore.d.ts

@@ -0,0 +1,182 @@
+/**
+ * What a memory is about (#936). `fact`, `preference`, `episode` and `note`
+ * are the ones gemi knows; an app may use strings of its own.
+ *
+ * - `fact`: something true about the user or their project ("Open Tue–Sun 8–16").
+ * - `preference`: how they want things done ("never use stock photos of people").
+ * - `episode`: a summary of past work. Written by the extractor (a later phase).
+ * - `note`: a working note, usually in a thread scope.
+ */
+export type AgentMemoryKind = "fact" | "preference" | "episode" | "note" | (string & {});
+/** Who wrote a memory, and from where. Kept for the UI ("saved from this message") and for audits. */
+export type AgentMemorySource = {
+    by: "agent" | "extractor" | "app" | "user";
+    /** The agent whose run wrote it. */
+    agent?: string;
+    runId?: string;
+    threadId?: string;
+    /** The assistant message holding the tool call that wrote it. */
+    messageId?: string;
+};
+/**
+ * One memory, as the store keeps it (#936).
+ *
+ * A short, self-contained note that belongs to exactly one scope. The scope is
+ * the app's key (`project:clx…`, `user:42`), decided on the server for each
+ * run; the model only ever sees the scope's label (`project`) and never this.
+ */
+export type AgentMemoryRecord = {
+    /** `mem_…`. */
+    id: string;
+    /** The app's key, e.g. `project:clx…`. */
+    scope: string;
+    kind: AgentMemoryKind;
+    /** One sentence or a short paragraph. Agents' writes are capped (500 chars by default). */
+    content: string;
+    /**
+     * A stable slot in the scope, e.g. `business.hours`: a write with the same
+     * scope and key replaces the memory there rather than adding another one.
+     * `null` for a memory without one.
+     */
+    key: string | null;
+    /** The app's routing labels, e.g. `["pictures"]`. Empty when there are none. */
+    tags: string[];
+    /** Always listed first in the `<memory>` block. */
+    pinned: boolean;
+    source: AgentMemorySource;
+    /** Starts at 1 and goes up on every change. `update` compares against it. */
+    version: number;
+    /** Epoch milliseconds, on the store's clock. */
+    createdAt: number;
+    updatedAt: number;
+    /** When an agent last read it. Kept up to date in a later phase (#936 P2). */
+    lastUsedAt: number | null;
+    /** When it stops being listed, and `prune` may delete it. `null` for never. */
+    expiresAt: number | null;
+};
+/** What `upsert` is given: the record minus what the store stamps. */
+export type NewAgentMemoryRecord = {
+    id: string;
+    scope: string;
+    kind: AgentMemoryKind;
+    content: string;
+    key?: string | null;
+    tags?: string[];
+    pinned?: boolean;
+    source: AgentMemorySource;
+    expiresAt?: number | null;
+};
+/** The fields `update` may change. The id, the scope and the source never change. */
+export type AgentMemoryUpdate = Partial<Pick<AgentMemoryRecord, "kind" | "content" | "key" | "tags" | "pinned" | "expiresAt">>;
+/** What a write did. `unchanged` when the memory was already there as written. */
+export type AgentMemoryWriteAction = "added" | "updated" | "unchanged";
+export type AgentMemoryListOptions = {
+    /** Only these kinds. */
+    kinds?: readonly string[];
+    /** Only memories carrying at least one of these tags. */
+    tags?: readonly string[];
+    /** At most this many. */
+    limit?: number;
+    /**
+     * The id of the last memory of the previous page: the list goes on after
+     * it. Ignored when that memory is gone or is in none of the scopes.
+     */
+    after?: string;
+    /** List memories past their `expiresAt` too. Default `false`. */
+    includeExpired?: boolean;
+};
+export type AgentMemorySearchOptions = {
+    kinds?: readonly string[];
+    tags?: readonly string[];
+    /** Default 8. */
+    limit?: number;
+};
+/**
+ * Where agent memories live (#936).
+ *
+ * `InMemoryAgentMemoryStore` is the default and is not durable.
+ * `DatabaseAgentMemoryStore` keeps them in a table of the app's database. An
+ * app with a table of its own can implement this over it; the conformance
+ * tests in `ai/memory/stores.test.ts` say what each method must do.
+ *
+ * Every method that lists takes scope keys, never labels. Turning a label
+ * into a key is the run's job, and nothing the model writes reaches here as
+ * a key.
+ */
+export interface AgentMemoryStore {
+    /**
+     * The scopes' memories, oldest first (`createdAt`, then `id`). Expired ones
+     * are left out unless `includeExpired`.
+     */
+    list(scopes: readonly string[], options?: AgentMemoryListOptions): Promise<AgentMemoryRecord[]>;
+    get(id: string): Promise<AgentMemoryRecord | null>;
+    /**
+     * Writes a memory. With a `key`, it replaces the memory already at that
+     * scope and key (`updated`, its version bumped and its id kept), or answers
+     * `unchanged` when nothing differs. Without one it always adds.
+     */
+    upsert(memory: NewAgentMemoryRecord): Promise<{
+        record: AgentMemoryRecord;
+        action: AgentMemoryWriteAction;
+    }>;
+    /**
+     * Changes a memory and bumps its version. With `expectedVersion`, only when
+     * the memory is still at that version (compare-and-set). `null` when there
+     * is no such memory, or its version differs.
+     */
+    update(id: string, patch: AgentMemoryUpdate, expectedVersion?: number): Promise<AgentMemoryRecord | null>;
+    /** Hard-deletes them, and answers how many were there. */
+    delete(ids: readonly string[]): Promise<number>;
+    /** Hard-deletes every memory of a scope, and answers how many. */
+    deleteScope(scope: string): Promise<number>;
+    /**
+     * The scopes' memories that match `query` best, best first: keyword search
+     * (BM25 over the content, key and tags) in P1. A store may answer with a
+     * search of its own (full text, embeddings).
+     */
+    search(scopes: readonly string[], query: string, options?: AgentMemorySearchOptions): Promise<AgentMemoryRecord[]>;
+    /** How many unexpired memories a scope holds. */
+    count(scope: string): Promise<number>;
+    /** Stamps `lastUsedAt`. Optional; used by a later phase (#936 P2). */
+    touch?(ids: readonly string[], at: number): Promise<void>;
+    /** Deletes memories whose `expiresAt` is at or before `now`, and answers how many. */
+    prune?(now: number): Promise<number>;
+}
+/**
+ * A new memory id, ordered by creation within a process: the time in
+ * milliseconds (moved on by one when two ids land in the same one), then
+ * random characters. Ids are the tie-break when two memories share a
+ * `createdAt`, so this keeps "oldest first" in the order they were written.
+ */
+export declare function newMemoryId(): string;
+/** Oldest first, with the id as a tie-break so the order is stable. */
+export declare function oldestFirst(a: AgentMemoryRecord, b: AgentMemoryRecord): number;
+/** Whether `record` carries one of `tags`. No filter matches everything. */
+export declare function hasAnyTag(record: AgentMemoryRecord, tags: readonly string[] | undefined): boolean;
+/** Whether two writes would store the same memory. */
+export declare function sameMemory(record: AgentMemoryRecord, memory: NewAgentMemoryRecord): boolean;
+/**
+ * Memories in a map, for as long as the process lives.
+ *
+ * NOT DURABLE, like `MemoryAgentStore`: a restart forgets everything. It is
+ * the default so that memory works in development and tests without a table;
+ * use `DatabaseAgentMemoryStore` in production. (Named `InMemory…` rather
+ * than `Memory…`, which would make it a `MemoryAgentMemoryStore`.)
+ */
+export declare class InMemoryAgentMemoryStore implements AgentMemoryStore {
+    private memories;
+    list(scopes: readonly string[], options?: AgentMemoryListOptions): Promise<AgentMemoryRecord[]>;
+    get(id: string): Promise<AgentMemoryRecord | null>;
+    upsert(memory: NewAgentMemoryRecord): Promise<{
+        record: AgentMemoryRecord;
+        action: AgentMemoryWriteAction;
+    }>;
+    update(id: string, patch: AgentMemoryUpdate, expectedVersion?: number): Promise<AgentMemoryRecord | null>;
+    delete(ids: readonly string[]): Promise<number>;
+    deleteScope(scope: string): Promise<number>;
+    search(scopes: readonly string[], query: string, options?: AgentMemorySearchOptions): Promise<AgentMemoryRecord[]>;
+    count(scope: string): Promise<number>;
+    touch(ids: readonly string[], at: number): Promise<void>;
+    prune(now: number): Promise<number>;
+}
+//# sourceMappingURL=AgentMemoryStore.d.ts.map

package/dist/ai/memory/AgentMemoryStore.d.ts.map

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

package/dist/ai/memory/DatabaseAgentMemoryStore.d.ts

@@ -0,0 +1,76 @@
+import type { DatabaseConnection } from "../../database/Connection";
+import type { Dialect } from "../../database/dialect";
+import { type AgentMemoryListOptions, type AgentMemoryRecord, type AgentMemorySearchOptions, type AgentMemoryStore, type AgentMemoryUpdate, type AgentMemoryWriteAction, type NewAgentMemoryRecord } from "./AgentMemoryStore";
+export type DatabaseAgentMemoryStoreOptions = {
+    /**
+     * The table. Default `gemi_agent_memories`. A plain identifier (letters,
+     * digits and underscores), because it is spliced into every statement.
+     */
+    table?: string;
+};
+/**
+ * Agent memories (#936) in a table of the app's own database, so they outlive
+ * the process and every instance sees the same ones.
+ *
+ *     AgentMemories.use(new DatabaseAgentMemoryStore(app(DatabaseManager).connection()));
+ *
+ * Written for SQLite, Postgres and MySQL 8 / MariaDB 10.6+ in raw SQL, like
+ * `DatabaseAgentJobStore`, and the table is the app's to create: add the
+ * Prisma model from docs/ai-memory.md, or call `createTable()`.
+ *
+ * - **One memory per scope and key**: a unique index on `(scope, key)`. A
+ *   keyed write reads the slot and updates it by compare-and-set on
+ *   `version`, or inserts; two writes racing on one key end with one memory.
+ * - **Time** is epoch milliseconds read from the database's clock.
+ * - **Search** loads the scopes' memories and ranks them in JavaScript
+ *   (`rankMemories`), the same on every database. A scope is small.
+ * - **Deletes are hard.** Nothing is kept of a deleted memory; an app that
+ *   wants a trail uses `AgentMemories.use(store, { onWrite })`.
+ */
+export declare class DatabaseAgentMemoryStore implements AgentMemoryStore {
+    readonly table: string;
+    private readonly sql;
+    private readonly dialect;
+    private readonly connection;
+    constructor(connection: Pick<DatabaseConnection, "sql" | "dialect"> & Partial<Pick<DatabaseConnection, "name">>, options?: DatabaseAgentMemoryStoreOptions);
+    /**
+     * Creates the table and its indexes if they do not exist: the DDL Prisma
+     * generates for the model in the docs. For tests and for an app that does
+     * not manage its schema with Prisma.
+     */
+    createTable(): Promise<void>;
+    list(scopes: readonly string[], options?: AgentMemoryListOptions): Promise<AgentMemoryRecord[]>;
+    get(id: string): Promise<AgentMemoryRecord | null>;
+    upsert(memory: NewAgentMemoryRecord): Promise<{
+        record: AgentMemoryRecord;
+        action: AgentMemoryWriteAction;
+    }>;
+    update(id: string, patch: AgentMemoryUpdate, expectedVersion?: number): Promise<AgentMemoryRecord | null>;
+    delete(ids: readonly string[]): Promise<number>;
+    deleteScope(scope: string): Promise<number>;
+    search(scopes: readonly string[], query: string, options?: AgentMemorySearchOptions): Promise<AgentMemoryRecord[]>;
+    count(scope: string): Promise<number>;
+    touch(ids: readonly string[], at: number): Promise<void>;
+    prune(now: number): Promise<number>;
+    /** The store's clock, in epoch milliseconds. */
+    now(): Promise<number>;
+    private insert;
+    private atKey;
+    private mustGet;
+    /** The open ORM transaction, when it is on this store's connection. */
+    private joinable;
+    /** Read at each call and never kept: a stored transaction handle outlives its transaction. */
+    private q;
+    /** `key` is a reserved word in MySQL, so it is always quoted. */
+    private column;
+    private name;
+    /** The database's clock, in epoch milliseconds. As in `DatabaseAgentJobStore`. */
+    private clock;
+    private ms;
+}
+/**
+ * The table as Prisma generates it for the model in the docs, with
+ * `IF NOT EXISTS` added.
+ */
+export declare function createAgentMemoriesTableStatements(dialect: Dialect, table: string): string[];
+//# sourceMappingURL=DatabaseAgentMemoryStore.d.ts.map

package/dist/ai/memory/DatabaseAgentMemoryStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseAgentMemoryStore.d.ts","sourceRoot":"","sources":["../../../ai/memory/DatabaseAgentMemoryStore.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAE7B,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAE3B,KAAK,oBAAoB,EAE1B,MAAM,oBAAoB,CAAC;AAG5B,MAAM,MAAM,+BAA+B,GAAG;IAC5C;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAOF;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,wBAAyB,YAAW,gBAAgB;IAC/D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;gBAG9C,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE,KAAK,GAAG,SAAS,CAAC,GACrD,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,EAC3C,OAAO,GAAE,+BAAoC;IAc/C;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,IAAI,CACR,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAiDzB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAMlD,MAAM,CACV,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC;QAAE,MAAM,EAAE,iBAAiB,CAAC;QAAC,MAAM,EAAE,sBAAsB,CAAA;KAAE,CAAC;IAyCnE,MAAM,CACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,iBAAiB,EACxB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IA2B9B,MAAM,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAO/C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK3C,MAAM,CACV,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAKzB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASrC,KAAK,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASxD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOzC,gDAAgD;IAC1C,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;YAMd,MAAM;YAmBN,KAAK;YAQL,OAAO;IAMrB,uEAAuE;IACvE,OAAO,CAAC,QAAQ;IAOhB,8FAA8F;IAC9F,OAAO,CAAC,CAAC;IAIT,iEAAiE;IACjE,OAAO,CAAC,MAAM;IAKd,OAAO,CAAC,IAAI;IAKZ,kFAAkF;IAClF,OAAO,CAAC,KAAK;IAYb,OAAO,CAAC,EAAE;CAMX;AA0CD;;;GAGG;AACH,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAmD5F"}

package/dist/ai/memory/contextBlock.d.ts

@@ -0,0 +1,32 @@
+import type { AgentMemoryRecord } from "./AgentMemoryStore";
+/** The `<memory>` block's budget, in tokens, when neither the agent nor the run says. */
+export declare const DEFAULT_MEMORY_MAX_TOKENS = 1500;
+export type MemoryBlockScope = {
+    /** What the model calls it: `project`, `user`. */
+    label: string;
+    /** Its memories, in any order. */
+    memories: readonly AgentMemoryRecord[];
+};
+/**
+ * The `<memory>` block (#936): what the model is told about the memories of
+ * the run's scopes, at the end of the system prompt.
+ *
+ * - **Order:** pinned memories first, then the rest, each in the order the
+ *   scopes are declared and oldest first inside a scope. Nothing in the text
+ *   depends on the time of the turn, so it is the same from one turn to the
+ *   next until a memory changes, and the prompt cache holds.
+ * - **Budget:** `maxTokens`, at about four characters a token, the header
+ *   included. What does not fit is counted per scope on a closing line that
+ *   points at `recall` (when the run has it).
+ * - **Data, not instructions:** the header says so, and every memory is put
+ *   on one line with anything tag-like escaped (`blockText`), so a stored
+ *   `</memory>` cannot end the block.
+ *
+ * `null` when there is nothing to list or no budget.
+ */
+export declare function renderMemoryBlock(scopes: readonly MemoryBlockScope[], options: {
+    maxTokens: number;
+    recall: boolean;
+    tools: boolean;
+}): string | null;
+//# sourceMappingURL=contextBlock.d.ts.map

package/dist/ai/memory/contextBlock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextBlock.d.ts","sourceRoot":"","sources":["../../../ai/memory/contextBlock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG5D,yFAAyF;AACzF,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAW9C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACxC,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,gBAAgB,EAAE,EACnC,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC9D,MAAM,GAAG,IAAI,CAyDf"}

package/dist/ai/memory/index.d.ts

@@ -0,0 +1,6 @@
+export { AgentMemories, type AgentMemoriesHooks, AgentMemoryConflictError, type AgentMemoryDraft, type AgentMemoryExport, type AgentMemoryInput, AgentMemoryRefusedError, type AgentMemoryWriteEvent, FakeAgentMemoryStore, type RecordedMemoryWrite, } from "./AgentMemories";
+export { type AgentMemoryKind, type AgentMemoryListOptions, type AgentMemoryRecord, type AgentMemorySearchOptions, type AgentMemorySource, type AgentMemoryStore, type AgentMemoryUpdate, type AgentMemoryWriteAction, InMemoryAgentMemoryStore, type NewAgentMemoryRecord, } from "./AgentMemoryStore";
+export { DEFAULT_MEMORY_MAX_TOKENS } from "./contextBlock";
+export { DatabaseAgentMemoryStore, type DatabaseAgentMemoryStoreOptions, } from "./DatabaseAgentMemoryStore";
+export { type AgentMemoryOptions, type AgentMemoryScopeOptions, type AgentMemoryScopes, type AgentMemoryToolOption, type AgentRunMemoryParams, type AppManagedResult, DEFAULT_MEMORY_LIMITS, type ForgetInput, type ForgetResult, MEMORY_NAMESPACE, type MemoryToolShapes, type RecallInput, type RecallResult, type RememberInput, type RememberResult, type ToolMemory, } from "./runMemory";
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../ai/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,kBAAkB,EACvB,wBAAwB,EACxB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,uBAAuB,EACvB,KAAK,qBAAqB,EAC1B,oBAAoB,EACpB,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,wBAAwB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EACL,wBAAwB,EACxB,KAAK,+BAA+B,GACrC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,qBAAqB,EACrB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC"}