@sapiom/tools 0.12.0 → 0.14.0

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

@@ -0,0 +1,318 @@
+/**
+ * Tenant-scoped long-term memory on the Sapiom memory gateway.
+ *
+ *   import { memory } from "@sapiom/tools";                 // ambient auth
+ *   const { id } = await memory.append({ content: "User prefers dark mode.", scope: "user" });
+ *   const { results } = await memory.recall({ query: "ui preferences", topK: 5 });
+ *   const record = await memory.get(id);
+ *   await memory.forget(id);
+ *
+ * Or via an explicit client: `createClient({ apiKey }).memory.append(...)`.
+ *
+ * The gateway speaks camelCase JSON, so this client keeps request and response
+ * objects 1:1 with the wire contract.
+ */
+import { Transport } from "../_client/index.js";
+import { MemoryHttpError } from "./errors.js";
+export { MemoryHttpError };
+/** Storage backend selector. Omit for the v0 default `"neon-pgvector"`. */
+export declare const MEMORY_BACKENDS: readonly ["neon-pgvector", "upstash-vector"];
+export type MemoryBackend = (typeof MEMORY_BACKENDS)[number];
+/** Embedding model selector. Omit for the default OpenRouter text-embedding-3-small embedder. */
+export interface MemoryEmbedder {
+    /**
+     * Embedding provider. The gateway is authoritative for provider support and
+     * returns 400 for unknown providers; v0 currently supports `"openrouter"`.
+     */
+    provider: string;
+    /**
+     * Embedding model. A model is part of the store identity, so a write and all
+     * later reads must use the same model. The gateway is authoritative for model
+     * support and returns 400 for unknown models.
+     */
+    model: string;
+}
+/**
+ * Optional store selector. Omit for the default Neon store.
+ *
+ * A memory is only visible from the store it was written to. If you set any of
+ * these fields on append, pass the same `store` to recall/get/forget/sweep.
+ */
+export interface MemoryStore {
+    /**
+     * Storage backend. Default: `"neon-pgvector"`. `"upstash-vector"` is experimental
+     * and does not support keyword recall or sweep.
+     */
+    backend?: MemoryBackend;
+    /**
+     * Embedding model. Default: OpenRouter `"openai/text-embedding-3-small"`.
+     */
+    embedder?: MemoryEmbedder;
+    /**
+     * Physical isolation namespace. Use to separate projects/tenants under one
+     * owner. 1-100 chars, `[a-zA-Z0-9_-]`.
+     */
+    namespace?: string;
+}
+export interface AppendInput {
+    /**
+     * Text to store as a memory (1–32,000 chars). Must not contain secrets — the
+     * gateway runs an admission gate and rejects API keys / tokens / passwords with
+     * a 400 (`error: "SecretDetected"`, `decision: "REJECTED"`) before anything is
+     * embedded or stored.
+     */
+    content: string;
+    /**
+     * Scope label grouping related memories (e.g. "session", "user", "project").
+     * Alphanumeric plus hyphens/underscores, 1–100 chars. Defaults to "default".
+     */
+    scope?: string;
+    /**
+     * Arbitrary JSON stored alongside the memory and returned on read. Opaque to
+     * ranking (not embedded), but usable as a hard `filter` on recall. Max 10 KB when
+     * JSON-serialized.
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Event-time this memory is *about* (ISO-8601), distinct from `createdAt` (the
+     * server ingestion time). Drives temporal recall weighting. When omitted, the
+     * gateway stores `null` and temporal recall falls back to `createdAt`.
+     */
+    occurredAt?: string;
+    /** Optional store selector. Omit for the default store. See {@link MemoryStore}. */
+    store?: MemoryStore;
+}
+export interface AppendResult {
+    /**
+     * UUID of the memory. For `decision: "ADDED"` this is the newly created record;
+     * for `decision: "NOOP"` it is the existing memory that was echoed (nothing was
+     * written).
+     */
+    id: string;
+    /** The stored content, echoed back. */
+    content: string;
+    /** The resolved scope label ("default" when you omitted it). */
+    scope: string;
+    /**
+     * What the gateway did, made legible (never a silent write):
+     * - `"ADDED"` — a new memory was written to the append-log.
+     * - `"NOOP"`  — byte-identical content or a near-exact semantic duplicate in the
+     *   same owner + scope; the existing memory is echoed and nothing is written.
+     *
+     * A secret caught by the admission gate is *not* a decision here — it surfaces as
+     * a 400 {@link MemoryHttpError} whose body carries `decision: "REJECTED"`.
+     */
+    decision: "ADDED" | "NOOP";
+    /** ISO-8601 timestamp when the memory was created (server ingestion time). */
+    createdAt: string;
+    /**
+     * ISO-8601 event-time this memory is *about*, or `null` when none was supplied on
+     * append (the gateway does not backfill it with `createdAt`).
+     */
+    occurredAt: string | null;
+    /** The stored metadata (`{}` when none was provided). */
+    metadata: Record<string, unknown>;
+}
+/**
+ * Retrieval strategy for {@link recall}:
+ * - `"cosine"`  — dense vector similarity (default; supported on every backend).
+ * - `"keyword"` — full-text / BM25 ranking. Neon-only; requesting it on a backend
+ *   that doesn't support it is a 400 {@link MemoryHttpError} (never degraded).
+ */
+export type RetrievalStrategy = "cosine" | "keyword";
+/** Time-decay weighting for {@link RecallInput.weight}. Optional; omit for pure relevance. */
+export interface TemporalWeight {
+    /**
+     * ISO-8601 anchor the decay is measured from. Defaults to "now" at recall time.
+     * (A Unix-epoch integer is not accepted — pass an ISO-8601 string.)
+     */
+    center?: string;
+    /**
+     * Half-life in days (1–365, default 30): a memory whose `occurredAt` is this far
+     * from `center` keeps half its relevance. Smaller = sharper recency preference.
+     */
+    halfLifeDays?: number;
+}
+/** Optional scoring weights for {@link recall}. Extensible; only `temporal` is supported today. */
+export interface RecallWeight {
+    /** Multiplicative time-decay applied to each match's base similarity. */
+    temporal?: TemporalWeight;
+}
+export interface RecallInput {
+    /** Natural-language search text (1–4,096 chars). Embedded and compared against stored memories. */
+    query: string;
+    /** Restrict the search to this scope label. Omit to search every scope for your owner. */
+    scope?: string;
+    /** Maximum number of results to return (1–50). Defaults to 5. */
+    topK?: number;
+    /** Minimum score [0–1]; matches below it are dropped. Defaults to 0. */
+    minSimilarity?: number;
+    /**
+     * Retrieval strategy — `"cosine"` (default) or `"keyword"` (Neon-only). See
+     * {@link RetrievalStrategy}.
+     */
+    strategy?: RetrievalStrategy;
+    /**
+     * Optional scoring weights. Today only `weight.temporal` is honored — it applies
+     * a time-decay against each memory's `occurredAt`. Omit for pure relevance.
+     */
+    weight?: RecallWeight;
+    /**
+     * Hard metadata filter. Neon uses JSONB containment; Upstash supports scalar
+     * equality filters. Applied before ranking; max 4 KB serialized.
+     */
+    filter?: Record<string, unknown>;
+    /** Optional store selector. Pass the same store used at write time. See {@link MemoryStore}. */
+    store?: MemoryStore;
+}
+export interface RecallMatch {
+    /** UUID of the memory. */
+    id: string;
+    /** The stored content. */
+    content: string;
+    /** The scope label. */
+    scope: string;
+    /**
+     * Canonical [0–1] relevance the matches are ranked and thresholded on (highest
+     * first). Provider-neutral: an opaque backend reports only this single score.
+     */
+    score: number;
+    /**
+     * Optional backend-specific score legs. A backend may fill this with its own
+     * components; most dense-only paths omit it entirely. This is an open map —
+     * don't assume a fixed set of keys.
+     */
+    scoreBreakdown?: Record<string, number>;
+    /** ISO-8601 timestamp when the memory was created. */
+    createdAt: string;
+    /** ISO-8601 event-time this memory is *about*, or `null` when none was supplied. */
+    occurredAt: string | null;
+    /** ISO-8601 timestamp this memory was last read, or `null` if never recalled since creation. */
+    lastAccessedAt: string | null;
+    /** The stored metadata. */
+    metadata: Record<string, unknown>;
+}
+export interface RecallResponse {
+    /** Matches ranked by `score` (highest first). Empty when nothing matched or no store exists yet. */
+    results: RecallMatch[];
+    /** The query, echoed back. */
+    query: string;
+    /** The effective top-K used by the gateway. */
+    topK: number;
+    /** Number of results returned (≤ `topK`). */
+    count: number;
+}
+export interface Memory {
+    /** UUID of the memory. */
+    id: string;
+    /** The stored content. */
+    content: string;
+    /** The scope label. */
+    scope: string;
+    /** ISO-8601 timestamp when the memory was created (server ingestion time). */
+    createdAt: string;
+    /** ISO-8601 event-time this memory is *about*, or `null` when none was supplied. */
+    occurredAt: string | null;
+    /** ISO-8601 timestamp this memory was last read, or `null` if never recalled since creation. */
+    lastAccessedAt: string | null;
+    /** The stored metadata. */
+    metadata: Record<string, unknown>;
+}
+/**
+ * Eviction order for {@link sweep}:
+ * - `"lru"`    — least-recently-accessed first (`lastAccessedAt` ascending). Default.
+ * - `"oldest"` — oldest-inserted first (`createdAt` ascending).
+ */
+export type SweepStrategy = "lru" | "oldest";
+export interface SweepInput {
+    /**
+     * Maximum number of memories to preview/delete (1–10,000). Omit to use the
+     * gateway's default sweep batch (100 rows).
+     */
+    count?: number;
+    /** Eviction order — `"lru"` (default) or `"oldest"`. See {@link SweepStrategy}. */
+    strategy?: SweepStrategy;
+    /**
+     * Preview vs delete. **Defaults to `true`** (a safe preview): the gateway returns
+     * the `candidates` it would evict without deleting anything (`evicted: 0`). Pass
+     * `false` to actually evict.
+     */
+    dryRun?: boolean;
+    /** Optional store selector. Sweep is Neon-only. See {@link MemoryStore}. */
+    store?: MemoryStore;
+}
+/** A memory that a `sweep` would evict. */
+export interface MemorySweepCandidate {
+    /** UUID of the memory. */
+    id: string;
+    /** The stored content. */
+    content: string;
+    /** The scope label. */
+    scope: string;
+    /** ISO-8601 timestamp when the memory was created. */
+    createdAt: string;
+    /** ISO-8601 timestamp this memory was last read, or `null` if never recalled since creation. */
+    lastAccessedAt: string | null;
+}
+export interface MemorySweepResponse {
+    /** Number of memories evicted (`0` on a `dryRun`). */
+    evicted: number;
+    /**
+     * The memories that *would* be evicted — present on a `dryRun` (the default).
+     * Review them, then {@link forget} specific ids or re-run `sweep` with
+     * `dryRun: false`.
+     */
+    candidates?: MemorySweepCandidate[];
+}
+/** Per-call options for {@link get} and {@link forget}. */
+export interface MemoryCallOptions {
+    /** Optional store selector. Pass the same store used at write time. See {@link MemoryStore}. */
+    store?: MemoryStore;
+}
+/**
+ * Append a memory to the store (an append-log — no prior memory is mutated). The
+ * gateway runs a secret-detection gate first (a detected secret is rejected with a
+ * 400 {@link MemoryHttpError}, body `decision: "REJECTED"`), then embeds the
+ * content and writes it, returning `decision: "ADDED"`.
+ *
+ * Byte-identical content, or a near-exact semantic duplicate, in the same owner +
+ * scope is a no-op that echoes the existing memory unchanged (`decision: "NOOP"`);
+ * nothing new is written.
+ *
+ * On a full Neon store the gateway returns `507` ({@link MemoryHttpError}); call
+ * {@link sweep} (or {@link forget}) to free space, then retry. On Upstash, first
+ * provisioning can return `422` when the account/index limit is reached.
+ */
+export declare function append(input: AppendInput, transport?: Transport, baseUrl?: string): Promise<AppendResult>;
+/**
+ * Recall memories by natural-language query. Returns the top-K matches ranked by
+ * score; an empty list when nothing matches or no memory store has been provisioned
+ * yet (not an error).
+ *
+ * After the route gate succeeds, infra, child billing, rate-limit, and timeout
+ * failures degrade to an empty result set. Bad requests, missing identity, and
+ * ownership failures (`400`/`401`/`403`) surface as {@link MemoryHttpError}.
+ */
+export declare function recall(input: RecallInput, transport?: Transport, baseUrl?: string): Promise<RecallResponse>;
+/**
+ * Sweep (evict) memories to reclaim space — consumer-triggered, never automatic.
+ * Call it after a `507` on {@link append}, or proactively to compact the store.
+ * Eviction is Neon-only today; a store with nothing to sweep returns `{ evicted: 0 }`.
+ *
+ * `dryRun` **defaults to `true`**: the gateway returns the `candidates` it would
+ * evict without deleting anything — review them, then {@link forget} specific ids
+ * or re-run with `dryRun: false` to actually evict.
+ */
+export declare function sweep(input?: SweepInput, transport?: Transport, baseUrl?: string): Promise<MemorySweepResponse>;
+/**
+ * Fetch a single memory by id. Throws {@link MemoryHttpError} with `status: 404`
+ * when the memory doesn't exist or belongs to another owner (existence is not
+ * leaked across owners).
+ */
+export declare function get(id: string, transport?: Transport, baseUrl?: string, options?: MemoryCallOptions): Promise<Memory>;
+/**
+ * Forget (hard-delete) a memory by id. Idempotent: a missing or already-deleted
+ * id is treated as success by the gateway.
+ */
+export declare function forget(id: string, transport?: Transport, baseUrl?: string, options?: MemoryCallOptions): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/cjs/memory/index.js

@@ -0,0 +1,181 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MEMORY_BACKENDS = exports.MemoryHttpError = void 0;
+exports.append = append;
+exports.recall = recall;
+exports.sweep = sweep;
+exports.get = get;
+exports.forget = forget;
+/**
+ * Tenant-scoped long-term memory on the Sapiom memory gateway.
+ *
+ *   import { memory } from "@sapiom/tools";                 // ambient auth
+ *   const { id } = await memory.append({ content: "User prefers dark mode.", scope: "user" });
+ *   const { results } = await memory.recall({ query: "ui preferences", topK: 5 });
+ *   const record = await memory.get(id);
+ *   await memory.forget(id);
+ *
+ * Or via an explicit client: `createClient({ apiKey }).memory.append(...)`.
+ *
+ * The gateway speaks camelCase JSON, so this client keeps request and response
+ * objects 1:1 with the wire contract.
+ */
+const index_js_1 = require("../_client/index.js");
+const service_url_js_1 = require("../_client/service-url.js");
+const errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "MemoryHttpError", { enumerable: true, get: function () { return errors_js_1.MemoryHttpError; } });
+/**
+ * Memory service ORIGIN. Resolves like every other @sapiom/tools capability: an
+ * explicit `SAPIOM_MEMORY_URL` override wins, else the `SAPIOM_SERVICES_BASE` knob
+ * re-homes it (subdomain preserved), else the production
+ * `https://memory.services.sapiom.ai`. This is the bare origin; the `/v1/memory`
+ * path prefix is appended per-method below (a local override is just the gateway
+ * origin, e.g. `http://memory.services.localhost:3100`).
+ */
+const DEFAULT_BASE_URL = (0, service_url_js_1.resolveServiceUrl)("memory", process.env.SAPIOM_MEMORY_URL);
+// ----- SDK-facing types (identical to the wire; camelCase end to end) -----
+/** Storage backend selector. Omit for the v0 default `"neon-pgvector"`. */
+exports.MEMORY_BACKENDS = ["neon-pgvector", "upstash-vector"];
+// ----- capability operations -----
+/**
+ * Append a memory to the store (an append-log — no prior memory is mutated). The
+ * gateway runs a secret-detection gate first (a detected secret is rejected with a
+ * 400 {@link MemoryHttpError}, body `decision: "REJECTED"`), then embeds the
+ * content and writes it, returning `decision: "ADDED"`.
+ *
+ * Byte-identical content, or a near-exact semantic duplicate, in the same owner +
+ * scope is a no-op that echoes the existing memory unchanged (`decision: "NOOP"`);
+ * nothing new is written.
+ *
+ * On a full Neon store the gateway returns `507` ({@link MemoryHttpError}); call
+ * {@link sweep} (or {@link forget}) to free space, then retry. On Upstash, first
+ * provisioning can return `422` when the account/index limit is reached.
+ */
+async function append(input, transport = (0, index_js_1.defaultTransport)(), baseUrl = DEFAULT_BASE_URL) {
+    const body = { content: input.content };
+    if (input.scope !== undefined)
+        body.scope = input.scope;
+    if (input.metadata !== undefined)
+        body.metadata = input.metadata;
+    if (input.occurredAt !== undefined)
+        body.occurredAt = input.occurredAt;
+    if (input.store !== undefined)
+        body.store = input.store;
+    const res = await (0, errors_js_1.ensureOk)(await transport.fetch(`${baseUrl}/v1/memory/append`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(body),
+    }), "Failed to append memory");
+    return (await res.json());
+}
+/**
+ * Recall memories by natural-language query. Returns the top-K matches ranked by
+ * score; an empty list when nothing matches or no memory store has been provisioned
+ * yet (not an error).
+ *
+ * After the route gate succeeds, infra, child billing, rate-limit, and timeout
+ * failures degrade to an empty result set. Bad requests, missing identity, and
+ * ownership failures (`400`/`401`/`403`) surface as {@link MemoryHttpError}.
+ */
+async function recall(input, transport = (0, index_js_1.defaultTransport)(), baseUrl = DEFAULT_BASE_URL) {
+    const body = { query: input.query };
+    if (input.scope !== undefined)
+        body.scope = input.scope;
+    if (input.topK !== undefined)
+        body.topK = input.topK;
+    if (input.minSimilarity !== undefined)
+        body.minSimilarity = input.minSimilarity;
+    if (input.strategy !== undefined)
+        body.strategy = input.strategy;
+    if (input.weight !== undefined)
+        body.weight = input.weight;
+    if (input.filter !== undefined)
+        body.filter = input.filter;
+    if (input.store !== undefined)
+        body.store = input.store;
+    const res = await (0, errors_js_1.ensureOk)(await transport.fetch(`${baseUrl}/v1/memory/recall`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(body),
+    }), "Failed to recall memories");
+    return (await res.json());
+}
+/**
+ * Sweep (evict) memories to reclaim space — consumer-triggered, never automatic.
+ * Call it after a `507` on {@link append}, or proactively to compact the store.
+ * Eviction is Neon-only today; a store with nothing to sweep returns `{ evicted: 0 }`.
+ *
+ * `dryRun` **defaults to `true`**: the gateway returns the `candidates` it would
+ * evict without deleting anything — review them, then {@link forget} specific ids
+ * or re-run with `dryRun: false` to actually evict.
+ */
+async function sweep(input = {}, transport = (0, index_js_1.defaultTransport)(), baseUrl = DEFAULT_BASE_URL) {
+    const body = {};
+    if (input.count !== undefined)
+        body.count = input.count;
+    if (input.strategy !== undefined)
+        body.strategy = input.strategy;
+    if (input.dryRun !== undefined)
+        body.dryRun = input.dryRun;
+    if (input.store !== undefined)
+        body.store = input.store;
+    const res = await (0, errors_js_1.ensureOk)(await transport.fetch(`${baseUrl}/v1/memory/sweep`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(body),
+    }), "Failed to sweep memories");
+    return (await res.json());
+}
+/**
+ * Build the `/v1/memory/:id` URL for get/forget, including any store selector.
+ */
+function memoryItemUrl(baseUrl, id, options) {
+    const path = `${baseUrl}/v1/memory/${encodeURIComponent(id)}`;
+    const params = new URLSearchParams();
+    const store = options?.store;
+    if (store) {
+        if (store.backend !== undefined) {
+            params.set("storeBackend", store.backend);
+        }
+        if (store.namespace !== undefined) {
+            params.set("storeNamespace", store.namespace);
+        }
+        if (store.embedder !== undefined) {
+            params.set("storeEmbedderProvider", store.embedder.provider);
+            params.set("storeEmbedderModel", store.embedder.model);
+        }
+    }
+    const query = params.toString();
+    return query ? `${path}?${query}` : path;
+}
+/**
+ * Fetch a single memory by id. Throws {@link MemoryHttpError} with `status: 404`
+ * when the memory doesn't exist or belongs to another owner (existence is not
+ * leaked across owners).
+ */
+async function get(id, transport = (0, index_js_1.defaultTransport)(), baseUrl = DEFAULT_BASE_URL, options) {
+    const res = await (0, errors_js_1.ensureOk)(await transport.fetch(memoryItemUrl(baseUrl, id, options)), `Failed to get memory '${id}'`);
+    return (await res.json());
+}
+/**
+ * Forget (hard-delete) a memory by id. Idempotent: a missing or already-deleted
+ * id is treated as success by the gateway.
+ */
+async function forget(id, transport = (0, index_js_1.defaultTransport)(), baseUrl = DEFAULT_BASE_URL, options) {
+    const res = await transport.fetch(memoryItemUrl(baseUrl, id, options), {
+        method: "DELETE",
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            parsed = text;
+        }
+        throw new errors_js_1.MemoryHttpError(`Failed to forget memory '${id}': ${res.status} ${text}`, res.status, parsed);
+    }
+    // 204 No Content — nothing to parse.
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/memory/index.js.map

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

package/dist/cjs/stub/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/stub/index.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAwC3C,4EAA4E;AAC5E,MAAM,MAAM,aAAa,GAAG,MAAM,CAChC,MAAM,EACN,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAC5C,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACxB;AAqXD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,iBAAsB,GAAG,MAAM,CAilBrE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/stub/index.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAqD3C,4EAA4E;AAC5E,MAAM,MAAM,aAAa,GAAG,MAAM,CAChC,MAAM,EACN,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAC5C,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACxB;AAqXD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,iBAAsB,GAAG,MAAM,CA0uBrE"}

package/dist/cjs/stub/index.js

@@ -706,6 +706,108 @@ function createStubClient(opts = {}) {
                 delete: (id) => Promise.resolve(r("email.webhooks.delete", [id], () => undefined)),
             },
         },
+        domains: {
+            check: (input) => Promise.resolve(r("domains.check", [input], () => (input.domainNames ?? []).map((domainName) => ({
+                domainName,
+                available: true,
+                purchasePrice: "12.99",
+                renewalPrice: "12.99",
+                premium: false,
+            })))),
+            register: (input) => Promise.resolve(r("domains.register", [input], () => ({
+                domainName: input.domainName,
+                status: "active",
+                expiresAt: "2099-01-01T00:00:00Z",
+                registeredAt: "2099-01-01T00:00:00Z",
+                purchasePrice: "12.99",
+            }))),
+            renew: (input) => Promise.resolve(r("domains.renew", [input], () => ({
+                domainName: input.domainName,
+                expiresAt: "2099-01-01T00:00:00Z",
+                renewalPrice: "12.99",
+            }))),
+            list: () => Promise.resolve(r("domains.list", [], () => [])),
+            get: (input) => Promise.resolve(r("domains.get", [input], () => ({
+                domainName: input.domainName,
+                status: "active",
+                expiresAt: "2099-01-01T00:00:00Z",
+                registeredAt: "2099-01-01T00:00:00Z",
+                nameservers: ["ns1.example.com", "ns2.example.com"],
+                locked: true,
+                transferEligibleAt: null,
+            }))),
+            transferOut: (input) => Promise.resolve(r("domains.transferOut", [input], () => ({
+                domainName: input.domainName,
+                authCode: "stub-auth-code",
+                transferInstructions: "(stub) provide this auth code to the new registrar.",
+            }))),
+            dns: {
+                create: (input) => Promise.resolve(r("domains.dns.create", [input], () => ({
+                    recordId: `stub-record-${++launchSeq}`,
+                    domainName: input.domainName,
+                    type: input.type,
+                    host: input.host,
+                    fqdn: input.host
+                        ? `${input.host}.${input.domainName}`
+                        : input.domainName,
+                    value: input.value,
+                    ttl: input.ttl ?? 300,
+                    ...(input.priority !== undefined && { priority: input.priority }),
+                    createdAt: "2099-01-01T00:00:00Z",
+                }))),
+                list: (input) => Promise.resolve(r("domains.dns.list", [input], () => [])),
+                get: (input) => Promise.resolve(r("domains.dns.get", [input], () => ({
+                    recordId: input.recordId,
+                    domainName: input.domainName,
+                    type: "A",
+                    host: "",
+                    fqdn: input.domainName,
+                    value: "203.0.113.10",
+                    ttl: 300,
+                }))),
+                update: (input) => Promise.resolve(r("domains.dns.update", [input], () => ({
+                    recordId: input.recordId,
+                    domainName: input.domainName,
+                    type: input.type ?? "A",
+                    host: input.host ?? "",
+                    fqdn: input.domainName,
+                    value: input.value ?? "203.0.113.10",
+                    ttl: input.ttl ?? 300,
+                    ...(input.priority !== undefined && { priority: input.priority }),
+                }))),
+                delete: (input) => Promise.resolve(r("domains.dns.delete", [input], () => undefined)),
+            },
+        },
+        memory: {
+            append: (input) => Promise.resolve(r("memory.append", [input], () => ({
+                id: "stub-memory",
+                content: input.content,
+                scope: input.scope ?? "default",
+                decision: "ADDED",
+                createdAt: "2099-01-01T00:00:00Z",
+                occurredAt: input.occurredAt ?? null,
+                metadata: input.metadata ?? {},
+            }))),
+            recall: (input) => Promise.resolve(r("memory.recall", [input], () => ({
+                results: [],
+                query: input.query,
+                topK: input.topK ?? 5,
+                count: 0,
+            }))),
+            sweep: (input) => Promise.resolve(r("memory.sweep", [input], () => input?.dryRun === false
+                ? { evicted: 0 }
+                : { evicted: 0, candidates: [] })),
+            get: (id, options) => Promise.resolve(r("memory.get", [id, options], () => ({
+                id,
+                content: "(stub) memory content",
+                scope: "default",
+                createdAt: "2099-01-01T00:00:00Z",
+                occurredAt: null,
+                lastAccessedAt: null,
+                metadata: {},
+            }))),
+            forget: (id, options) => Promise.resolve(r("memory.forget", [id, options], () => undefined)),
+        },
         withAttribution: () => client,
     };
     return client;