@vendoai/agent 0.4.0

package/dist/test-helpers.js

@@ -0,0 +1,230 @@
+import { MockLanguageModelV3, simulateReadableStream } from "ai/test";
+import { expect } from "vitest";
+export const ZERO_USAGE = {
+    inputTokens: { total: 0, noCache: 0, cacheRead: 0, cacheWrite: 0 },
+    outputTokens: { total: 0, text: 0, reasoning: 0 },
+};
+export function textTurn(text, id = "text_1") {
+    return [
+        { type: "text-start", id },
+        { type: "text-delta", id, delta: text },
+        { type: "text-end", id },
+        { type: "finish", usage: ZERO_USAGE, finishReason: { unified: "stop", raw: undefined } },
+    ];
+}
+export function toolCallTurn(toolName, input, toolCallId = "call_1") {
+    return [
+        { type: "tool-call", toolCallId, toolName, input: JSON.stringify(input) },
+        { type: "finish", usage: ZERO_USAGE, finishReason: { unified: "tool-calls", raw: undefined } },
+    ];
+}
+export function scriptedModel(turns) {
+    const remaining = turns.map((turn) => [...turn]);
+    const prompts = [];
+    const toolNamesPerCall = [];
+    const shift = (request) => {
+        prompts.push(structuredClone(request.prompt));
+        toolNamesPerCall.push((request.tools ?? []).map((tool) => tool.name));
+        const chunks = remaining.shift();
+        if (chunks === undefined)
+            throw new Error("scripted model exhausted");
+        return chunks;
+    };
+    const model = new MockLanguageModelV3({
+        doStream: async (request) => {
+            const chunks = shift(request);
+            return { stream: simulateReadableStream({ chunks }) };
+        },
+        doGenerate: async (request) => {
+            const chunks = shift(request);
+            const finish = chunks.find((part) => part.type === "finish");
+            const content = [];
+            const text = chunks
+                .filter((part) => part.type === "text-delta")
+                .map((part) => part.delta)
+                .join("");
+            if (text.length > 0)
+                content.push({ type: "text", text });
+            for (const part of chunks) {
+                if (part.type === "tool-call")
+                    content.push(structuredClone(part));
+            }
+            return {
+                content,
+                finishReason: finish?.finishReason ?? { unified: "stop", raw: undefined },
+                usage: finish?.usage ?? ZERO_USAGE,
+                warnings: [],
+            };
+        },
+    });
+    model.prompts = prompts;
+    model.toolNamesPerCall = toolNamesPerCall;
+    return model;
+}
+function deepFreeze(value) {
+    if (value !== null && typeof value === "object") {
+        for (const child of Object.values(value))
+            deepFreeze(child);
+        Object.freeze(value);
+    }
+    return value;
+}
+export function testGuard(policy, directions = []) {
+    const approvalsByCall = new Map();
+    const decisions = new Map();
+    const subscribers = new Set();
+    const events = [];
+    const directionValues = [...directions];
+    const guard = {
+        events,
+        directionValues,
+        abandoned: [],
+        // AGENT-6: mirror the real guard — abandoning denies each still-pending
+        // approval (idempotent; unknown/decided ids are no-ops) and notifies
+        // decision subscribers.
+        async abandonApprovals(ids) {
+            for (const id of ids) {
+                const known = [...approvalsByCall.values()].some((approval) => approval.id === id);
+                if (!known || decisions.has(id))
+                    continue;
+                guard.abandoned.push(id);
+                guard.decide(id, false);
+            }
+        },
+        async check(call, descriptor, runCtx) {
+            const action = policy[call.tool] ?? "run";
+            if (action === "run")
+                return { action: "run", decidedBy: "default" };
+            if (action === "block")
+                return { action: "block", reason: "blocked", decidedBy: "rule" };
+            let approval = approvalsByCall.get(call.id);
+            if (approval === undefined) {
+                approval = {
+                    id: `apr_${call.id}`,
+                    call: structuredClone(call),
+                    descriptor: deepFreeze(structuredClone(descriptor)),
+                    inputPreview: JSON.stringify(call.args),
+                    ctx: {
+                        principal: structuredClone(runCtx.principal),
+                        venue: runCtx.venue,
+                        presence: runCtx.presence,
+                        ...(runCtx.appId === undefined ? {} : { appId: runCtx.appId }),
+                        ...(runCtx.trigger === undefined ? {} : { trigger: structuredClone(runCtx.trigger) }),
+                    },
+                    createdAt: new Date().toISOString(),
+                };
+                approvalsByCall.set(call.id, approval);
+            }
+            const approved = decisions.get(approval.id);
+            if (approved === true)
+                return { action: "run", decidedBy: "default" };
+            if (approved === false)
+                return { action: "block", reason: "denied", decidedBy: "rule" };
+            return { action: "ask", approval, decidedBy: "rule" };
+        },
+        async report(event) {
+            events.push(structuredClone(event));
+        },
+        async directions() {
+            return [...directionValues];
+        },
+        onApprovalDecision(callback) {
+            subscribers.add(callback);
+            return () => subscribers.delete(callback);
+        },
+        decide(approvalId, approved) {
+            decisions.set(approvalId, approved);
+            for (const subscriber of subscribers)
+                subscriber(approvalId, approved);
+        },
+        pending() {
+            return [...approvalsByCall.values()].filter((approval) => !decisions.has(approval.id));
+        },
+    };
+    return guard;
+}
+export function boundRegistry(implementations, guard) {
+    const invocations = Object.fromEntries(Object.keys(implementations).map((name) => [name, 0]));
+    return {
+        invocations,
+        async descriptors() {
+            return Object.values(implementations).map(({ descriptor }) => structuredClone(descriptor));
+        },
+        async execute(call, runCtx) {
+            const implementation = implementations[call.tool];
+            if (implementation === undefined) {
+                return { status: "error", error: { code: "not-found", message: `Unknown tool: ${call.tool}` } };
+            }
+            const decision = await guard.check(call, implementation.descriptor, runCtx);
+            let outcome;
+            if (decision.action === "block") {
+                outcome = { status: "blocked", reason: decision.reason };
+            }
+            else if (decision.action === "ask") {
+                outcome = { status: "pending-approval", approvalId: decision.approval.id };
+            }
+            else {
+                invocations[call.tool] = (invocations[call.tool] ?? 0) + 1;
+                try {
+                    outcome = { status: "ok", output: await implementation.execute(call.args, runCtx, call) };
+                }
+                catch (error) {
+                    outcome = {
+                        status: "error",
+                        error: {
+                            code: "execution",
+                            message: error instanceof Error ? error.message : String(error),
+                        },
+                    };
+                }
+            }
+            await guard.report({
+                id: `aud_${call.id}`,
+                at: new Date().toISOString(),
+                kind: "tool-call",
+                principal: structuredClone(runCtx.principal),
+                venue: runCtx.venue,
+                presence: runCtx.presence,
+                ...(runCtx.appId === undefined ? {} : { appId: runCtx.appId }),
+                ...(runCtx.trigger === undefined ? {} : { trigger: structuredClone(runCtx.trigger) }),
+                tool: call.tool,
+                inputPreview: JSON.stringify(call.args),
+                outcome: outcome.status,
+                decidedBy: decision.decidedBy,
+            });
+            return outcome;
+        },
+    };
+}
+// The core conformance kit ships the reference in-memory StoreAdapter; tests
+// exercise the same double every other block will use.
+export { memoryStoreAdapter as memoryStore } from "@vendoai/core/conformance";
+export async function readSse(response) {
+    const raw = await response.text();
+    expect(raw.endsWith("\n\n")).toBe(true);
+    const blocks = raw.slice(0, -2).split("\n\n");
+    expect(blocks.length).toBeGreaterThan(0);
+    expect(blocks.every((block) => block.startsWith("data: ") && !block.includes("\n"))).toBe(true);
+    const rawFrames = blocks.map((block) => `${block}\n\n`);
+    expect(rawFrames.at(-1)).toBe("data: [DONE]\n\n");
+    const parts = blocks.slice(0, -1).map((block) => JSON.parse(block.slice("data: ".length)));
+    return { rawFrames, parts };
+}
+export function ctx(overrides = {}) {
+    return {
+        principal: { kind: "user", subject: "u1" },
+        venue: "chat",
+        presence: "present",
+        sessionId: "s1",
+        ...overrides,
+    };
+}
+/** A minimal single-text-part user UIMessage — the shape every suite feeds stream(). */
+export function userMessage(id, text) {
+    return { id, role: "user", parts: [{ type: "text", text }] };
+}
+/** The first assembled UIMessage part of a given type (e.g. "data-vendo-view"). */
+export function partOfType(message, type) {
+    return message.parts.find((part) => part.type === type);
+}
+//# sourceMappingURL=test-helpers.js.map

package/dist/test-helpers.js.map

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

package/dist/threads.d.ts

@@ -0,0 +1,48 @@
+import { type IsoDateTime, type RunContext, type StoreAdapter, type ThreadId } from "@vendoai/core";
+import type { UIMessage } from "ai";
+/** 03-agent §5 */
+export interface Thread {
+    id: ThreadId;
+    subject: string;
+    messages: UIMessage[];
+    /** Precomputed listing title. Persisted beside the thread so `list` need not load the
+     *  full messages array to derive it; absent on legacy rows (derived from messages then). */
+    title?: string;
+    createdAt: IsoDateTime;
+    updatedAt: IsoDateTime;
+}
+/** 03-agent §5 */
+export interface ThreadSummary {
+    id: ThreadId;
+    title: string;
+    updatedAt: IsoDateTime;
+}
+/** 03-agent §5 */
+export declare class ThreadRepository {
+    private readonly store;
+    constructor(store: StoreAdapter);
+    resolve(id: ThreadId | undefined, ctx: RunContext): Promise<Thread>;
+    get(id: ThreadId, ctx: RunContext): Promise<Thread | null>;
+    list(ctx: RunContext): Promise<ThreadSummary[]>;
+    delete(id: ThreadId, ctx: RunContext): Promise<void>;
+    persist(thread: Thread, messages: UIMessage[]): Promise<void>;
+    /** The Thread as it should be written for this turn: merged messages, a
+     *  freshly-derived listing title (never a stale prior title — `list` reads it
+     *  back without loading messages), and a new updatedAt. */
+    private updatedThread;
+    private create;
+    /** AGENT-11 / ENG-237: drop a subject's threads from the store on session
+     *  eviction. Store-backed: a no-op — the store's own TTL sweep already erased
+     *  the rows (02-store §4 erase cascade) before the umbrella calls this, so the
+     *  list below simply finds none. Internal-default (no `store` configured):
+     *  the ONLY place those rows get reclaimed, since nothing else sweeps them.
+     *  Returns the evicted thread ids so callers can release any per-thread state
+     *  keyed by id (ENG-252 loadouts) — otherwise a reused `thr_*` id would inherit
+     *  the evicted thread's searched-in tools. */
+    evictSubject(subject: string): Promise<ThreadId[]>;
+    /** Follows the store's pagination cursor to exhaustion (it pages at 100) —
+     *  otherwise a subject's >100th thread, possibly their most recently active,
+     *  would silently vanish from `list`/`evictSubject`. */
+    private listRecords;
+}
+//# sourceMappingURL=threads.d.ts.map

package/dist/threads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../src/threads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,KAAK,QAAQ,EAAoB,MAAM,eAAe,CAAC;AAClI,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAMpC,kBAAkB;AAClB,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,QAAQ,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB;gGAC4F;IAC5F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,WAAW,CAAC;IACvB,SAAS,EAAE,WAAW,CAAC;CACxB;AAED,kBAAkB;AAClB,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,QAAQ,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,WAAW,CAAC;CACxB;AAqFD,kBAAkB;AAClB,qBAAa,gBAAgB;IAOf,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,YAAY;IAE1C,OAAO,CAAC,EAAE,EAAE,QAAQ,GAAG,SAAS,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBnE,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAY1D,IAAI,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAU/C,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpD,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8CnE;;+DAE2D;IAC3D,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,MAAM;IAWd;;;;;;;kDAO8C;IACxC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAOxD;;4DAEwD;YAC1C,WAAW;CAa1B"}

package/dist/threads.js

@@ -0,0 +1,251 @@
+import { VendoError } from "@vendoai/core";
+import { mintThreadId } from "./ids.js";
+const THREAD_COLLECTION = "vendo_threads";
+const THREAD_ID_PATTERN = /^thr_.+$/;
+/** Reconstruct a Thread from a store record. The store seam (core §12) carries
+ *  the id + timestamps on the VendoRecord envelope and the reserved
+ *  vendo_threads routing projects `data` down to `{ subject, messages }` (02
+ *  §2) — so the whole Thread is never inside `data`. Read it back from the
+ *  envelope, not from `data`. */
+function threadFromRecord(record) {
+    if (!THREAD_ID_PATTERN.test(record.id))
+        return null;
+    // Timestamps ride the envelope, but a hand-written row (threadStore(store).put
+    // accepts any Json) could still be malformed — validate before trusting them so
+    // one bad row cannot brick the whole listing.
+    if (typeof record.createdAt !== "string" || typeof record.updatedAt !== "string")
+        return null;
+    const data = record.data;
+    if (typeof data !== "object" || data === null)
+        return null;
+    const candidate = data;
+    if (typeof candidate.subject !== "string" || !Array.isArray(candidate.messages))
+        return null;
+    return {
+        id: record.id,
+        subject: candidate.subject,
+        messages: candidate.messages,
+        ...(typeof candidate.title === "string" ? { title: candidate.title } : {}),
+        createdAt: record.createdAt,
+        updatedAt: record.updatedAt,
+    };
+}
+function titleFor(thread) {
+    // A persisted title short-circuits the message scan (and the listing skips loading the
+    // messages array entirely once a title exists — routing.ts).
+    if (typeof thread.title === "string" && thread.title.trim())
+        return thread.title.slice(0, 80);
+    return deriveTitle(thread.messages);
+}
+function deriveTitle(messages) {
+    // Messages come from a Json array (parseThreadData accepts any shape), so a
+    // message may lack an iterable `parts` or carry non-text parts — tolerate both,
+    // skipping rather than throwing.
+    for (const message of messages) {
+        if (message === null || typeof message !== "object")
+            continue;
+        if (message.role !== "user")
+            continue;
+        const parts = message.parts;
+        if (!Array.isArray(parts))
+            continue;
+        for (const part of parts) {
+            if (part !== null && typeof part === "object"
+                && part.type === "text"
+                && typeof part.text === "string") {
+                const title = part.text.trim();
+                return title ? title.slice(0, 80) : "New thread";
+            }
+        }
+    }
+    return "New thread";
+}
+function toSummary(thread) {
+    return { id: thread.id, title: titleFor(thread), updatedAt: thread.updatedAt };
+}
+/** Serialize to plain JSON so the value satisfies the store seam's `Json` type
+ *  (drops explicit `undefined`-valued props that JSON.stringify would omit). */
+function toPlainJson(messages) {
+    return JSON.parse(JSON.stringify(messages));
+}
+// ENG-310 / kill-list B5: how many times persist re-reads and re-merges after
+// losing a CAS race. Each retry starts from the freshly-read row, so a loss
+// only recurs while OTHER writers keep landing between our read and our
+// guarded write.
+const MAX_PERSIST_ATTEMPTS = 5;
+/** ENG-310: fold this turn's messages into the CURRENT persisted history —
+ *  upsert by message id (same identity rule as the in-stream upsertMessage),
+ *  so two concurrent turns on one thread both survive: shared history is
+ *  updated in place, each turn's new messages are appended. */
+function mergeMessages(current, turn) {
+    const merged = [...current];
+    for (const message of turn) {
+        const index = merged.findIndex((candidate) => candidate.id === message.id);
+        if (index === -1)
+            merged.push(message);
+        else
+            merged[index] = message;
+    }
+    return merged;
+}
+/** 03-agent §5 */
+export class ThreadRepository {
+    store;
+    // kill-list B5: threads live ONLY in the store — a caller that omits
+    // `createAgent({ store })` still gets one; `createAgent` (agent.ts) passes
+    // core's in-memory `memoryStoreAdapter` (@vendoai/core/conformance) as that
+    // default, so every composition — BYO or store-backed — resolves, lists,
+    // persists, and evicts threads through this SAME code path. There is no
+    // separate in-memory branch here to keep behavior-parity with.
+    constructor(store) {
+        this.store = store;
+    }
+    async resolve(id, ctx) {
+        if (id === undefined)
+            return this.create(ctx);
+        if (!THREAD_ID_PATTERN.test(id)) {
+            throw new VendoError("validation", "threadId is malformed");
+        }
+        // ONE ownership-blind read is the friendly fast-path (03 §5). vendo_threads is
+        // keyed by the bare id, so a foreign row reads as non-null here; reusing the id
+        // would let persist() take it over. Free id → create; ours → return; anyone
+        // else's (or unparseable) → conflict. The store's guarded upsert is the real,
+        // atomic guarantee — this only surfaces the conflict early with a clear error.
+        // Ephemeral principals resolve through this exact path too (02-store §4: no
+        // overlay, ordinary rows under their subject) — nothing here is BYO-specific.
+        const record = await this.store.records(THREAD_COLLECTION).get(id);
+        if (record === null)
+            return this.create(ctx, id);
+        const thread = threadFromRecord(record);
+        if (thread !== null && thread.subject === ctx.principal.subject)
+            return thread;
+        throw new VendoError("conflict", "threadId is already in use");
+    }
+    async get(id, ctx) {
+        if (!THREAD_ID_PATTERN.test(id))
+            return null;
+        // Reserved vendo_threads rows are keyed by the bare thread id (02 §2:
+        // `id` is the thread id). Subject scoping is enforced here, on read, by
+        // checking the row's subject — never returning another subject's thread.
+        const record = await this.store.records(THREAD_COLLECTION).get(id);
+        if (!record)
+            return null;
+        const thread = threadFromRecord(record);
+        if (!thread || thread.subject !== ctx.principal.subject)
+            return null;
+        return thread;
+    }
+    async list(ctx) {
+        const records = await this.listRecords({ subject: ctx.principal.subject });
+        const threads = records
+            .map(threadFromRecord)
+            .filter((thread) => thread !== null && thread.subject === ctx.principal.subject);
+        return threads
+            .map(toSummary)
+            .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
+    }
+    async delete(id, ctx) {
+        if (!THREAD_ID_PATTERN.test(id))
+            return;
+        // The bare id is shared across subjects; delete only after confirming the
+        // row belongs to this subject (get() returns null otherwise), so one
+        // subject can never delete another's thread (03 §5).
+        const existing = await this.get(id, ctx);
+        if (existing === null)
+            return;
+        await this.store.records(THREAD_COLLECTION).delete(id);
+    }
+    async persist(thread, messages) {
+        // ai-SDK UIMessages carry explicit `undefined`-valued optional props on
+        // tool parts (e.g. an approval-requested part with no output yet). The
+        // store seam is typed `Json` and rejects `undefined` values, so serialize
+        // to plain JSON — dropping absent-anyway keys — before it crosses.
+        const turnMessages = toPlainJson(messages);
+        const records = this.store.records(THREAD_COLLECTION);
+        // Guarded write via the store's atomic capability (01 §12 / 02-store §4):
+        // insert-if-absent for a first turn, revision CAS for an existing row —
+        // exactly one concurrent writer lands per attempt; the loser re-reads and
+        // re-merges (ENG-310 / AGENT-9: two overlapping turns on one thread each
+        // finish with their OWN copy of the history, so persist is read-merge-write,
+        // never a blind overwrite). No fallback: v2 has no adapter or row that
+        // predates the capability (kill-list B5 — same reasoning as the crypto v1
+        // cut), so an adapter that omits `atomic` fails closed rather than risking
+        // a lost update under concurrent writers.
+        const atomic = records.atomic;
+        if (atomic === undefined) {
+            throw new VendoError("not-implemented", "thread persistence needs a store with atomic record claims (02-store §4); this adapter omits the capability");
+        }
+        for (let attempt = 0; attempt < MAX_PERSIST_ATTEMPTS; attempt += 1) {
+            const record = await records.get(thread.id);
+            const current = record === null ? null : threadFromRecord(record);
+            if (current !== null && current.subject !== thread.subject) {
+                // Mirror the door's guarded upsert (03 §5): never take over a foreign row.
+                throw new VendoError("conflict", "threadId is already in use");
+            }
+            const updated = this.updatedThread(thread, current === null ? turnMessages : mergeMessages(current.messages, turnMessages));
+            const input = { id: updated.id, data: updated, refs: { subject: updated.subject } };
+            const written = record === null
+                ? await atomic.insertIfAbsent(input)
+                : await atomic.compareAndSwap(input, record.revision);
+            if (written !== null)
+                return;
+        }
+        throw new VendoError("conflict", `thread ${thread.id} persist lost the update race ${MAX_PERSIST_ATTEMPTS} times`);
+    }
+    /** The Thread as it should be written for this turn: merged messages, a
+     *  freshly-derived listing title (never a stale prior title — `list` reads it
+     *  back without loading messages), and a new updatedAt. */
+    updatedThread(thread, messages) {
+        return {
+            ...thread,
+            messages,
+            title: deriveTitle(messages),
+            updatedAt: new Date().toISOString(),
+        };
+    }
+    // create() never writes: it hands back a fresh, not-yet-persisted Thread.
+    // The first persist() call is what puts the row in the store — same for
+    // every composition, so a get()/list() before that first persist correctly
+    // sees nothing yet, exactly as a store-backed agent always has.
+    create(ctx, requestedId) {
+        const now = new Date().toISOString();
+        return {
+            id: requestedId ?? mintThreadId(),
+            subject: ctx.principal.subject,
+            messages: [],
+            createdAt: now,
+            updatedAt: now,
+        };
+    }
+    /** AGENT-11 / ENG-237: drop a subject's threads from the store on session
+     *  eviction. Store-backed: a no-op — the store's own TTL sweep already erased
+     *  the rows (02-store §4 erase cascade) before the umbrella calls this, so the
+     *  list below simply finds none. Internal-default (no `store` configured):
+     *  the ONLY place those rows get reclaimed, since nothing else sweeps them.
+     *  Returns the evicted thread ids so callers can release any per-thread state
+     *  keyed by id (ENG-252 loadouts) — otherwise a reused `thr_*` id would inherit
+     *  the evicted thread's searched-in tools. */
+    async evictSubject(subject) {
+        const records = await this.listRecords({ subject });
+        const ids = records.map((record) => record.id);
+        await Promise.all(ids.map((id) => this.store.records(THREAD_COLLECTION).delete(id)));
+        return ids;
+    }
+    /** Follows the store's pagination cursor to exhaustion (it pages at 100) —
+     *  otherwise a subject's >100th thread, possibly their most recently active,
+     *  would silently vanish from `list`/`evictSubject`. */
+    async listRecords(refs) {
+        const records = [];
+        let cursor;
+        do {
+            const result = await this.store.records(THREAD_COLLECTION).list({
+                refs,
+                ...(cursor === undefined ? {} : { cursor }),
+            });
+            records.push(...result.records);
+            cursor = result.cursor;
+        } while (cursor !== undefined);
+        return records;
+    }
+}
+//# sourceMappingURL=threads.js.map

package/dist/threads.js.map

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

package/dist/tool-pack.d.ts

@@ -0,0 +1,41 @@
+import type { AgentRunReport, Principal, VendoToolEnvelope } from "@vendoai/core";
+/**
+ * Existing-agents contract — the public tool-pack surface a BYO agent loop
+ * gets from the umbrella's `./ai-sdk` and `./mastra` subpaths. Wave 0 freezes
+ * the names and option shapes here (the docs, examples, and both shims build
+ * against them); Wave 1 Lane A supplies the implementation behind them.
+ * Frozen in `docs/superpowers/specs/2026-07-20-existing-agents-contracts.md`.
+ */
+/** Every pack tool is namespaced under this prefix to avoid collisions with
+ *  the host loop's own tools: a registered host tool `host_x` ships as
+ *  `vendo_host_x`; the built-ins below are already prefixed. */
+export declare const VENDO_TOOL_PACK_PREFIX: "vendo_";
+/** Generate UI. Returns fast with a `vendo/app-ref@1`; the build streams over
+ *  the wire, so the host loop is never blocked on generation. */
+export declare const VENDO_CREATE_APP_TOOL: "vendo_create_app";
+/** Whole-task delegation via `agent.asRunner()`; returns `VendoDelegateResult`. */
+export declare const VENDO_DELEGATE_TOOL: "vendo_delegate";
+/** Pack filtering, matched against FINAL (namespaced) tool names. The static
+ *  Mastra shim accepts exactly this (its principal resolves lazily per call
+ *  from the framework's runtime context). */
+export interface VendoToolPackFilter {
+    include?: string[];
+    exclude?: string[];
+}
+/** What the per-request AI SDK shim accepts: tool execution needs a
+ *  principal-scoped RunContext, so the pack is built per request. */
+export interface VendoToolPackOptions extends VendoToolPackFilter {
+    principal: Principal;
+    /** RunContext requires a session id; pass the host session's for audit
+     *  continuity, or leave unset and the shim mints one per pack build. */
+    sessionId?: string;
+}
+/** `vendo_delegate`'s output is plain data (no embed): the run report's
+ *  status and summary, plus envelope refs to anything the delegated run
+ *  produced — the host renders each ref with `<VendoToolResult>` if it wants. */
+export interface VendoDelegateResult {
+    status: AgentRunReport["status"];
+    summary: string;
+    refs: VendoToolEnvelope[];
+}
+//# sourceMappingURL=tool-pack.d.ts.map

package/dist/tool-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-pack.d.ts","sourceRoot":"","sources":["../src/tool-pack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElF;;;;;;GAMG;AAEH;;gEAEgE;AAChE,eAAO,MAAM,sBAAsB,EAAG,QAAiB,CAAC;AAExD;iEACiE;AACjE,eAAO,MAAM,qBAAqB,EAAG,kBAA2B,CAAC;AAEjE,mFAAmF;AACnF,eAAO,MAAM,mBAAmB,EAAG,gBAAyB,CAAC;AAE7D;;6CAE6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;qEACqE;AACrE,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D,SAAS,EAAE,SAAS,CAAC;IACrB;4EACwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;iFAEiF;AACjF,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,iBAAiB,EAAE,CAAC;CAC3B"}

package/dist/tool-pack.js

@@ -0,0 +1,17 @@
+/**
+ * Existing-agents contract — the public tool-pack surface a BYO agent loop
+ * gets from the umbrella's `./ai-sdk` and `./mastra` subpaths. Wave 0 freezes
+ * the names and option shapes here (the docs, examples, and both shims build
+ * against them); Wave 1 Lane A supplies the implementation behind them.
+ * Frozen in `docs/superpowers/specs/2026-07-20-existing-agents-contracts.md`.
+ */
+/** Every pack tool is namespaced under this prefix to avoid collisions with
+ *  the host loop's own tools: a registered host tool `host_x` ships as
+ *  `vendo_host_x`; the built-ins below are already prefixed. */
+export const VENDO_TOOL_PACK_PREFIX = "vendo_";
+/** Generate UI. Returns fast with a `vendo/app-ref@1`; the build streams over
+ *  the wire, so the host loop is never blocked on generation. */
+export const VENDO_CREATE_APP_TOOL = "vendo_create_app";
+/** Whole-task delegation via `agent.asRunner()`; returns `VendoDelegateResult`. */
+export const VENDO_DELEGATE_TOOL = "vendo_delegate";
+//# sourceMappingURL=tool-pack.js.map

package/dist/tool-pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-pack.js","sourceRoot":"","sources":["../src/tool-pack.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH;;gEAEgE;AAChE,MAAM,CAAC,MAAM,sBAAsB,GAAG,QAAiB,CAAC;AAExD;iEACiE;AACjE,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAA2B,CAAC;AAEjE,mFAAmF;AACnF,MAAM,CAAC,MAAM,mBAAmB,GAAG,gBAAyB,CAAC"}