@adonis-agora/agent 0.1.0

package/dist/src/telescope/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../src/telescope/extension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,qBAAqB,EAAkB,MAAM,gBAAgB,CAAC;AAc5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,GAAE,qBAA0B,GAAG,kBAAkB,CAkB5F"}

package/dist/src/telescope/extension.js

@@ -0,0 +1,45 @@
+import { agentDashboard } from './dashboard.js';
+import { agentActiveRunsProvider, agentDelegationsOverTimeProvider, agentRecentApprovalsProvider, agentRecentDelegationsProvider, agentRecentRunsProvider, agentRecentToolCallsProvider, agentRunsOverTimeProvider, agentTokenUsageProvider, agentTokensOverTimeProvider, agentToolCallSuccessRateProvider, agentToolCallsOverTimeProvider, } from './data-providers.js';
+/**
+ * The first-class `@adonis-agora/telescope` extension for `@adonis-agora/agent` (the "Agent" tab): an
+ * "Agent" overview dashboard surfacing recent runs, tool calls, approval decisions, delegations and
+ * token usage, plus the data providers the panels bind to. Wire it into `config/telescope.ts`:
+ *
+ * ```ts
+ * import { defineConfig } from '@adonis-agora/telescope'
+ * import { agentTelescopeExtension } from '@adonis-agora/agent/telescope'
+ *
+ * export default defineConfig({ extensions: [agentTelescopeExtension()] })
+ * ```
+ *
+ * No watcher is contributed — `@adonis-agora/agent` already publishes `agora:agent:*` lifecycle events
+ * onto the diagnostics bus (`src/diagnostics.ts`), and Telescope's generic diagnostics watcher records
+ * them as `type: 'diagnostic'`, `tag: 'lib:agent'`; the entry-backed providers read those recorded
+ * entries. `@adonis-agora/telescope` stays an OPTIONAL, never-imported peer — see `telescope-sdk.ts` for
+ * why the returned object structurally (not nominally) satisfies its `TelescopeExtension` contract, and
+ * why no NestJS-style DI/read-model is resolved (unlike the aviary port; capture is entirely entry-backed).
+ *
+ * No `entryTypes` are contributed: agent events are recorded under the generic `diagnostic` entry type
+ * (`tag: 'lib:agent'`), so there is no dedicated `agent` entry type to navigate to — the "Agent"
+ * dashboard is the entry point. (Same reasoning as `@adonis-agora/media/telescope`.)
+ */
+export function agentTelescopeExtension(opts = {}) {
+    return {
+        name: 'agent',
+        dashboards: () => [agentDashboard(opts)],
+        dataProviders: () => [
+            agentActiveRunsProvider(),
+            agentTokenUsageProvider(),
+            agentToolCallSuccessRateProvider(),
+            agentRunsOverTimeProvider(),
+            agentTokensOverTimeProvider(),
+            agentRecentRunsProvider(),
+            agentToolCallsOverTimeProvider(),
+            agentRecentToolCallsProvider(),
+            agentRecentApprovalsProvider(),
+            agentDelegationsOverTimeProvider(),
+            agentRecentDelegationsProvider(),
+        ],
+    };
+}
+//# sourceMappingURL=extension.js.map

package/dist/src/telescope/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../../../src/telescope/extension.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EACL,uBAAuB,EACvB,gCAAgC,EAChC,4BAA4B,EAC5B,8BAA8B,EAC9B,uBAAuB,EACvB,4BAA4B,EAC5B,yBAAyB,EACzB,uBAAuB,EACvB,2BAA2B,EAC3B,gCAAgC,EAChC,8BAA8B,GAC/B,MAAM,qBAAqB,CAAC;AAG7B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAA8B,EAAE;IACtE,OAAO;QACL,IAAI,EAAE,OAAO;QACb,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACxC,aAAa,EAAE,GAAG,EAAE,CAAC;YACnB,uBAAuB,EAAE;YACzB,uBAAuB,EAAE;YACzB,gCAAgC,EAAE;YAClC,yBAAyB,EAAE;YAC3B,2BAA2B,EAAE;YAC7B,uBAAuB,EAAE;YACzB,8BAA8B,EAAE;YAChC,4BAA4B,EAAE;YAC9B,4BAA4B,EAAE;YAC9B,gCAAgC,EAAE;YAClC,8BAA8B,EAAE;SACjC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/telescope/index.d.ts

@@ -0,0 +1,5 @@
+export { type AgentDashboardOptions, agentDashboard } from './dashboard.js';
+export { agentTelescopeExtension } from './extension.js';
+export { agentActiveRunsProvider, agentDelegationsOverTimeProvider, agentRecentApprovalsProvider, agentRecentDelegationsProvider, agentRecentRunsProvider, agentRecentToolCallsProvider, agentRunsOverTimeProvider, agentTokenUsageProvider, agentTokensOverTimeProvider, agentToolCallSuccessRateProvider, agentToolCallsOverTimeProvider, } from './data-providers.js';
+export type { Column, ContainerLike, DataProvider, DashboardSpec, ExtensionContext, LinkSpec, TelescopeExtension, TelescopeStoreLike, TelescopeEntryLike, } from './telescope-sdk.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/telescope/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/telescope/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,qBAAqB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EACL,uBAAuB,EACvB,gCAAgC,EAChC,4BAA4B,EAC5B,8BAA8B,EAC9B,uBAAuB,EACvB,4BAA4B,EAC5B,yBAAyB,EACzB,uBAAuB,EACvB,2BAA2B,EAC3B,gCAAgC,EAChC,8BAA8B,GAC/B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,MAAM,EACN,aAAa,EACb,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,QAAQ,EACR,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC"}

package/dist/src/telescope/index.js

@@ -0,0 +1,4 @@
+export { agentDashboard } from './dashboard.js';
+export { agentTelescopeExtension } from './extension.js';
+export { agentActiveRunsProvider, agentDelegationsOverTimeProvider, agentRecentApprovalsProvider, agentRecentDelegationsProvider, agentRecentRunsProvider, agentRecentToolCallsProvider, agentRunsOverTimeProvider, agentTokenUsageProvider, agentTokensOverTimeProvider, agentToolCallSuccessRateProvider, agentToolCallsOverTimeProvider, } from './data-providers.js';
+//# sourceMappingURL=index.js.map

package/dist/src/telescope/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/telescope/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EACL,uBAAuB,EACvB,gCAAgC,EAChC,4BAA4B,EAC5B,8BAA8B,EAC9B,uBAAuB,EACvB,4BAA4B,EAC5B,yBAAyB,EACzB,uBAAuB,EACvB,2BAA2B,EAC3B,gCAAgC,EAChC,8BAA8B,GAC/B,MAAM,qBAAqB,CAAC"}

package/dist/src/telescope/telescope-sdk.d.ts

@@ -0,0 +1,126 @@
+/**
+ * A local, structural mirror of the `@adonis-agora/telescope` extension SDK contract.
+ *
+ * We deliberately do NOT import `@adonis-agora/telescope` — it lives in a separate repo, so a workspace
+ * dependency would not resolve, and `@adonis-agora/telescope` is only an OPTIONAL peer (a host may run
+ * `@adonis-agora/agent` without any observability at all). This is the same cross-repo decoupling
+ * `@adonis-agora/telescope` itself uses to read `@adonis-agora/diagnostics` without importing it, and the
+ * same pattern `@adonis-agora/media/telescope` and `@adonis-agora/durable/telescope` follow. Instead we
+ * declare the same shapes here; the exported extension object structurally satisfies
+ * `@adonis-agora/telescope`'s `TelescopeExtension` when an app wires it into `config/telescope.ts` (where
+ * both packages are installed). Keep these in lockstep with `@adonis-agora/telescope`'s
+ * `src/extension/types.ts`.
+ */
+/** The slice of a telescope entry the data providers read. */
+export interface TelescopeEntryLike {
+    content?: unknown;
+    createdAt?: Date;
+}
+/** The slice of the telescope store the data providers read (a subset of `TelescopeStore`). */
+export interface TelescopeStoreLike {
+    list(query?: {
+        type?: string;
+        tag?: string;
+        limit?: number;
+    }): Promise<TelescopeEntryLike[]>;
+}
+/** The slice of the AdonisJS container an extension uses to resolve host services. */
+export interface ContainerLike {
+    make<T>(token: unknown): Promise<T>;
+}
+/** Read-only context handed to every extension hook (mirror of `@adonis-agora/telescope`'s). */
+export interface ExtensionContext {
+    readonly store: TelescopeStoreLike;
+    readonly container: ContainerLike;
+    readonly config: unknown;
+}
+export interface ExtensionEntryType {
+    id: string;
+    label: string;
+    dot: string;
+}
+export interface PanelThresholds {
+    warn: number;
+    bad: number;
+    direction: 'up-bad' | 'down-bad';
+}
+export interface DashboardSection {
+    title?: string;
+    cols?: 2 | 3 | 4;
+    panels: Panel[];
+}
+export interface DashboardSpec {
+    id: string;
+    label: string;
+    navGroup?: string;
+    panels: Panel[];
+    sections?: DashboardSection[];
+}
+export interface DataBinding {
+    provider: string;
+    query?: Record<string, unknown>;
+}
+export interface LinkSpec {
+    href: string;
+    external?: boolean;
+}
+export interface Column {
+    key: string;
+    label: string;
+    link?: LinkSpec;
+}
+export type Panel = {
+    kind: 'stat';
+    title: string;
+    data: DataBinding;
+    format?: 'number' | 'percent' | 'duration' | 'rate';
+    accent?: string;
+    spark?: boolean;
+    thresholds?: PanelThresholds;
+} | {
+    kind: 'timeseries';
+    title: string;
+    data: DataBinding;
+    series: string[];
+    style?: 'area' | 'stacked';
+} | {
+    kind: 'topN';
+    title: string;
+    data: DataBinding;
+    limit?: number;
+} | {
+    kind: 'table';
+    title: string;
+    data: DataBinding;
+    columns: Column[];
+} | {
+    kind: 'distribution';
+    title: string;
+    data: DataBinding;
+    markers?: Array<'p50' | 'p95' | 'p99'>;
+    format?: 'duration' | 'number';
+} | {
+    kind: 'gauge';
+    title: string;
+    data: DataBinding;
+    min?: number;
+    max?: number;
+    format?: 'number' | 'percent' | 'duration' | 'rate';
+    thresholds?: PanelThresholds;
+} | {
+    kind: 'breakdown';
+    title: string;
+    data: DataBinding;
+    style?: 'donut' | 'bar';
+};
+export interface DataProvider {
+    name: string;
+    resolve(query: Record<string, unknown> | undefined, ctx: ExtensionContext): Promise<unknown>;
+}
+export interface TelescopeExtension {
+    name: string;
+    entryTypes?(ctx: ExtensionContext): ExtensionEntryType[];
+    dashboards?(ctx: ExtensionContext): DashboardSpec[];
+    dataProviders?(ctx: ExtensionContext): DataProvider[];
+}
+//# sourceMappingURL=telescope-sdk.d.ts.map

package/dist/src/telescope/telescope-sdk.d.ts.map

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

package/dist/src/telescope/telescope-sdk.js

@@ -0,0 +1,15 @@
+/**
+ * A local, structural mirror of the `@adonis-agora/telescope` extension SDK contract.
+ *
+ * We deliberately do NOT import `@adonis-agora/telescope` — it lives in a separate repo, so a workspace
+ * dependency would not resolve, and `@adonis-agora/telescope` is only an OPTIONAL peer (a host may run
+ * `@adonis-agora/agent` without any observability at all). This is the same cross-repo decoupling
+ * `@adonis-agora/telescope` itself uses to read `@adonis-agora/diagnostics` without importing it, and the
+ * same pattern `@adonis-agora/media/telescope` and `@adonis-agora/durable/telescope` follow. Instead we
+ * declare the same shapes here; the exported extension object structurally satisfies
+ * `@adonis-agora/telescope`'s `TelescopeExtension` when an app wires it into `config/telescope.ts` (where
+ * both packages are installed). Keep these in lockstep with `@adonis-agora/telescope`'s
+ * `src/extension/types.ts`.
+ */
+export {};
+//# sourceMappingURL=telescope-sdk.js.map

package/dist/src/telescope/telescope-sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telescope-sdk.js","sourceRoot":"","sources":["../../../src/telescope/telescope-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/src/testing/fake-embedding-provider.d.ts

@@ -0,0 +1,37 @@
+import { EmbeddingRetriever } from '../rag/embedding-retriever.js';
+import { type IngestDocument } from '../rag/ingest.js';
+import type { EmbeddingProvider } from '../spi/embedding-provider.js';
+import type { RerankOptions, Reranker } from '../spi/reranker.js';
+import type { Passage } from '../spi/retriever.js';
+/**
+ * A deterministic, offline {@link EmbeddingProvider} — no API key, no network. Each text is embedded as
+ * a fixed-length bag-of-words vector: every whitespace/punctuation-delimited token is lower-cased and
+ * hashed into a dimension whose count it increments. Texts that share words land close under cosine
+ * similarity, so retrieval ranks the relevant chunk first, while the mapping stays a pure function of
+ * the input (replay-safe, reproducible across runs). Mirrors the reference deterministic fake.
+ */
+export declare class FakeEmbeddingProvider implements EmbeddingProvider {
+    private readonly dimensions;
+    constructor(dimensions?: number);
+    embed(texts: string[]): Promise<number[][]>;
+    private embedOne;
+}
+/**
+ * A trivial identity {@link Reranker} for tests: keeps the retriever's order, only truncating to
+ * `topK`. Stands in for a real cross-encoder rerank endpoint (provider impls deferred this round).
+ */
+export declare class FakeReranker implements Reranker {
+    rerank(_query: string, passages: Passage[], options?: RerankOptions): Promise<Passage[]>;
+}
+/**
+ * Build a ready-to-use in-memory {@link EmbeddingRetriever} for tests: a {@link MemoryVectorStore} fed
+ * by the given (or a fresh {@link FakeEmbeddingProvider}) embedder, with `documents` ingested. Wire the
+ * result as the config's `retriever` to exercise inject-mode retrieval offline.
+ */
+export declare function inMemoryRetriever(options: {
+    documents?: IngestDocument[];
+    embedder?: EmbeddingProvider;
+    chunkSize?: number;
+    overlap?: number;
+}): Promise<EmbeddingRetriever>;
+//# sourceMappingURL=fake-embedding-provider.d.ts.map

package/dist/src/testing/fake-embedding-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-embedding-provider.d.ts","sourceRoot":"","sources":["../../../src/testing/fake-embedding-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,kBAAkB,CAAC;AAExE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;;;;;GAMG;AACH,qBAAa,qBAAsB,YAAW,iBAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,SAAK;IAEtC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAIjD,OAAO,CAAC,QAAQ;CAWjB;AAYD;;;GAGG;AACH,qBAAa,YAAa,YAAW,QAAQ;IACrC,MAAM,CACV,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,OAAO,EAAE,CAAC;CAGtB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAY9B"}

package/dist/src/testing/fake-embedding-provider.js

@@ -0,0 +1,67 @@
+import { EmbeddingRetriever } from '../rag/embedding-retriever.js';
+import { ingestDocuments } from '../rag/ingest.js';
+import { MemoryVectorStore } from '../rag/memory-vector-store.js';
+/**
+ * A deterministic, offline {@link EmbeddingProvider} — no API key, no network. Each text is embedded as
+ * a fixed-length bag-of-words vector: every whitespace/punctuation-delimited token is lower-cased and
+ * hashed into a dimension whose count it increments. Texts that share words land close under cosine
+ * similarity, so retrieval ranks the relevant chunk first, while the mapping stays a pure function of
+ * the input (replay-safe, reproducible across runs). Mirrors the reference deterministic fake.
+ */
+export class FakeEmbeddingProvider {
+    dimensions;
+    constructor(dimensions = 64) {
+        this.dimensions = dimensions;
+    }
+    async embed(texts) {
+        return texts.map((text) => this.embedOne(text));
+    }
+    embedOne(text) {
+        const vector = new Array(this.dimensions).fill(0);
+        for (const token of text.toLowerCase().split(/[^a-z0-9]+/)) {
+            if (token.length === 0) {
+                continue;
+            }
+            const index = hashToken(token, this.dimensions);
+            vector[index] = (vector[index] ?? 0) + 1;
+        }
+        return vector;
+    }
+}
+/** FNV-1a-ish token hash folded into `[0, dimensions)`. Deterministic and dependency-free. */
+function hashToken(token, dimensions) {
+    let hash = 2166136261;
+    for (let index = 0; index < token.length; index += 1) {
+        hash ^= token.charCodeAt(index);
+        hash = Math.imul(hash, 16777619);
+    }
+    return (hash >>> 0) % dimensions;
+}
+/**
+ * A trivial identity {@link Reranker} for tests: keeps the retriever's order, only truncating to
+ * `topK`. Stands in for a real cross-encoder rerank endpoint (provider impls deferred this round).
+ */
+export class FakeReranker {
+    async rerank(_query, passages, options = {}) {
+        return options.topK !== undefined ? passages.slice(0, options.topK) : passages;
+    }
+}
+/**
+ * Build a ready-to-use in-memory {@link EmbeddingRetriever} for tests: a {@link MemoryVectorStore} fed
+ * by the given (or a fresh {@link FakeEmbeddingProvider}) embedder, with `documents` ingested. Wire the
+ * result as the config's `retriever` to exercise inject-mode retrieval offline.
+ */
+export async function inMemoryRetriever(options) {
+    const embedder = options.embedder ?? new FakeEmbeddingProvider();
+    const store = new MemoryVectorStore();
+    if (options.documents !== undefined && options.documents.length > 0) {
+        await ingestDocuments(options.documents, {
+            embedder,
+            store,
+            ...(options.chunkSize !== undefined ? { chunkSize: options.chunkSize } : {}),
+            ...(options.overlap !== undefined ? { overlap: options.overlap } : {}),
+        });
+    }
+    return new EmbeddingRetriever(embedder, store);
+}
+//# sourceMappingURL=fake-embedding-provider.js.map

package/dist/src/testing/fake-embedding-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-embedding-provider.js","sourceRoot":"","sources":["../../../src/testing/fake-embedding-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAuB,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAKlE;;;;;;GAMG;AACH,MAAM,OAAO,qBAAqB;IACH;IAA7B,YAA6B,aAAa,EAAE;QAAf,eAAU,GAAV,UAAU,CAAK;IAAG,CAAC;IAEhD,KAAK,CAAC,KAAK,CAAC,KAAe;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAClD,CAAC;IAEO,QAAQ,CAAC,IAAY;QAC3B,MAAM,MAAM,GAAG,IAAI,KAAK,CAAS,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1D,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;YAC3D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,SAAS;YACX,CAAC;YACD,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YAChD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,8FAA8F;AAC9F,SAAS,SAAS,CAAC,KAAa,EAAE,UAAkB;IAClD,IAAI,IAAI,GAAG,UAAU,CAAC;IACtB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,IAAI,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,YAAY;IACvB,KAAK,CAAC,MAAM,CACV,MAAc,EACd,QAAmB,EACnB,UAAyB,EAAE;QAE3B,OAAO,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACjF,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAKvC;IACC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,qBAAqB,EAAE,CAAC;IACjE,MAAM,KAAK,GAAG,IAAI,iBAAiB,EAAE,CAAC;IACtC,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpE,MAAM,eAAe,CAAC,OAAO,CAAC,SAAS,EAAE;YACvC,QAAQ;YACR,KAAK;YACL,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5E,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACjD,CAAC"}

package/dist/src/testing/fake-media.d.ts

@@ -0,0 +1,44 @@
+import { type DiskBytesReader, type MediaManagerHandle, MediaRagIngestion, type ResolveMediaRef } from '../rag-media/media-rag-ingestion.js';
+import { type ExtractFn, MimeTextExtractor } from '../rag-media/text-extractor.js';
+import { EmbeddingRetriever } from '../rag/embedding-retriever.js';
+import type { VectorStore } from '../rag/vector-store.js';
+import type { EmbeddingProvider } from '../spi/embedding-provider.js';
+/**
+ * An in-memory {@link MediaManagerHandle} for tests: bytes are stored in a per-disk `Map`, keyed by the
+ * object key. Stands in for an `@adonis-agora/media` `MediaManager` — the media→RAG bridge only reads
+ * `disk(name).getBytes(key)`, so this deterministic fake exercises the whole ingestion path offline.
+ */
+export declare class FakeMediaManager implements MediaManagerHandle {
+    private readonly disks;
+    /** Seed a file's bytes on a disk. Accepts a string (UTF-8 encoded) or raw bytes. Chainable. */
+    put(disk: string, key: string, contents: string | Uint8Array): this;
+    disk(name?: string): DiskBytesReader;
+}
+/**
+ * A fake PDF text extractor for tests — stands in for a real (host-supplied) PDF parser without the
+ * dependency. It ignores the bytes and returns fixed text so a test can assert the `application/pdf`
+ * hook is invoked. Register it: `defaultTextExtractor().register('application/pdf', fakePdfExtractor())`.
+ */
+export declare function fakePdfExtractor(text?: string): ExtractFn;
+/**
+ * Build a fully in-memory media→RAG ingestion for tests: a {@link MemoryVectorStore} + a deterministic
+ * {@link FakeEmbeddingProvider} + a {@link FakeMediaManager}, wired into a {@link MediaRagIngestion} and
+ * paired with an {@link EmbeddingRetriever} over the same store/embedder (so a test can ingest then
+ * retrieve, filtering by tenant/owner metadata). Seed files with `media.put(disk, key, contents)`.
+ */
+export declare function inMemoryMediaRagIngestion(options?: {
+    embedder?: EmbeddingProvider;
+    store?: VectorStore;
+    media?: FakeMediaManager;
+    extractor?: MimeTextExtractor;
+    contentTypes?: string[];
+    resolve?: ResolveMediaRef;
+    maxBytes?: number;
+}): {
+    ingestion: MediaRagIngestion;
+    store: VectorStore;
+    embedder: EmbeddingProvider;
+    media: FakeMediaManager;
+    retriever: EmbeddingRetriever;
+};
+//# sourceMappingURL=fake-media.d.ts.map

package/dist/src/testing/fake-media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-media.d.ts","sourceRoot":"","sources":["../../../src/testing/fake-media.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,iBAAiB,EAEjB,KAAK,eAAe,EAErB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,KAAK,SAAS,EACd,iBAAiB,EAElB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGtE;;;;GAIG;AACH,qBAAa,gBAAiB,YAAW,kBAAkB;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8C;IAEpE,+FAA+F;IAC/F,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAQnE,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe;CAYrC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,SAAuB,GAAG,SAAS,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACd,GACL;IACD,SAAS,EAAE,iBAAiB,CAAC;IAC7B,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,KAAK,EAAE,gBAAgB,CAAC;IACxB,SAAS,EAAE,kBAAkB,CAAC;CAC/B,CAoBA"}

package/dist/src/testing/fake-media.js

@@ -0,0 +1,69 @@
+import { mediaRagIngestion, } from '../rag-media/media-rag-ingestion.js';
+import { defaultTextExtractor, } from '../rag-media/text-extractor.js';
+import { EmbeddingRetriever } from '../rag/embedding-retriever.js';
+import { MemoryVectorStore } from '../rag/memory-vector-store.js';
+import { FakeEmbeddingProvider } from './fake-embedding-provider.js';
+/**
+ * An in-memory {@link MediaManagerHandle} for tests: bytes are stored in a per-disk `Map`, keyed by the
+ * object key. Stands in for an `@adonis-agora/media` `MediaManager` — the media→RAG bridge only reads
+ * `disk(name).getBytes(key)`, so this deterministic fake exercises the whole ingestion path offline.
+ */
+export class FakeMediaManager {
+    disks = new Map();
+    /** Seed a file's bytes on a disk. Accepts a string (UTF-8 encoded) or raw bytes. Chainable. */
+    put(disk, key, contents) {
+        const bytes = typeof contents === 'string' ? new TextEncoder().encode(contents) : contents;
+        const files = this.disks.get(disk) ?? new Map();
+        files.set(key, bytes);
+        this.disks.set(disk, files);
+        return this;
+    }
+    disk(name) {
+        const diskName = name ?? 'default';
+        return {
+            getBytes: async (key) => {
+                const bytes = this.disks.get(diskName)?.get(key);
+                if (bytes === undefined) {
+                    throw new Error(`FakeMediaManager: no object "${key}" on disk "${diskName}"`);
+                }
+                return bytes;
+            },
+        };
+    }
+}
+/**
+ * A fake PDF text extractor for tests — stands in for a real (host-supplied) PDF parser without the
+ * dependency. It ignores the bytes and returns fixed text so a test can assert the `application/pdf`
+ * hook is invoked. Register it: `defaultTextExtractor().register('application/pdf', fakePdfExtractor())`.
+ */
+export function fakePdfExtractor(text = 'extracted pdf text') {
+    return () => text;
+}
+/**
+ * Build a fully in-memory media→RAG ingestion for tests: a {@link MemoryVectorStore} + a deterministic
+ * {@link FakeEmbeddingProvider} + a {@link FakeMediaManager}, wired into a {@link MediaRagIngestion} and
+ * paired with an {@link EmbeddingRetriever} over the same store/embedder (so a test can ingest then
+ * retrieve, filtering by tenant/owner metadata). Seed files with `media.put(disk, key, contents)`.
+ */
+export function inMemoryMediaRagIngestion(options = {}) {
+    const embedder = options.embedder ?? new FakeEmbeddingProvider();
+    const store = options.store ?? new MemoryVectorStore();
+    const media = options.media ?? new FakeMediaManager();
+    const config = {
+        media,
+        embedder,
+        store,
+        extractor: options.extractor ?? defaultTextExtractor(),
+        ...(options.contentTypes !== undefined ? { contentTypes: options.contentTypes } : {}),
+        ...(options.resolve !== undefined ? { resolve: options.resolve } : {}),
+        ...(options.maxBytes !== undefined ? { maxBytes: options.maxBytes } : {}),
+    };
+    return {
+        ingestion: mediaRagIngestion(config),
+        store,
+        embedder,
+        media,
+        retriever: new EmbeddingRetriever(embedder, store),
+    };
+}
+//# sourceMappingURL=fake-media.js.map

package/dist/src/testing/fake-media.js.map

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

package/dist/src/testing/fake-model-provider.d.ts

@@ -0,0 +1,29 @@
+import type { ModelProvider, ModelTurnArgs, ModelTurnResult } from '../index.js';
+export interface FakeTurn {
+    text: string;
+    /** If set, the turn asks to call this tool instead of finishing. */
+    toolCall?: {
+        name: string;
+        input: unknown;
+    };
+    /** If set, the turn reports an actual USD cost — as a gateway provider would. */
+    costUsd?: number;
+}
+/**
+ * `turnIndex` = how many assistant turns have already happened this run (derived from the
+ * message history), so the script is a pure function of its inputs — deterministic and
+ * replay-safe with no internal counter.
+ */
+export type FakeScript = (args: ModelTurnArgs, turnIndex: number) => FakeTurn;
+/**
+ * A deterministic, offline `ModelProvider`. Drives the agent loop without any API key,
+ * streaming the scripted text to the sink and optionally requesting one tool call.
+ */
+export declare class FakeModelProvider implements ModelProvider {
+    private readonly script;
+    constructor(script: FakeScript);
+    runTurn(args: ModelTurnArgs): Promise<ModelTurnResult>;
+}
+/** A trivial script: stream a fixed reply and never call a tool. */
+export declare function echoScript(reply?: string): FakeScript;
+//# sourceMappingURL=fake-model-provider.d.ts.map

package/dist/src/testing/fake-model-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-model-provider.d.ts","sourceRoot":"","sources":["../../../src/testing/fake-model-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEjF,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5C,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,KAAK,QAAQ,CAAC;AAE9E;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEzC,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC;CAwB7D;AAED,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,KAAK,SAAO,GAAG,UAAU,CAEnD"}

package/dist/src/testing/in-memory-actor-directory.d.ts

@@ -0,0 +1,14 @@
+import type { ActorDirectory } from '../spi/actor-directory.js';
+/**
+ * In-memory {@link ActorDirectory}: a plain `actorRef → label` map. Handy for tests, the offline demo,
+ * and small apps that seed a fixed label table at boot. Missing refs are omitted from the result (never
+ * fabricated), so a governance surface falls back to rendering the raw ref.
+ */
+export declare class InMemoryActorDirectory implements ActorDirectory {
+    private readonly labels;
+    constructor(labels?: Record<string, string>);
+    /** Add or overwrite a single ref → label mapping. Returns `this` for chaining. */
+    set(ref: string, label: string): this;
+    resolveDisplay(refs: readonly string[]): Promise<Record<string, string>>;
+}
+//# sourceMappingURL=in-memory-actor-directory.d.ts.map

package/dist/src/testing/in-memory-actor-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-actor-directory.d.ts","sourceRoot":"","sources":["../../../src/testing/in-memory-actor-directory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE;;;;GAIG;AACH,qBAAa,sBAAuB,YAAW,cAAc;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;gBAEjC,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;IAI/C,kFAAkF;IAClF,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAK/B,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAU/E"}

package/dist/src/testing/in-memory-actor-directory.js

@@ -0,0 +1,27 @@
+/**
+ * In-memory {@link ActorDirectory}: a plain `actorRef → label` map. Handy for tests, the offline demo,
+ * and small apps that seed a fixed label table at boot. Missing refs are omitted from the result (never
+ * fabricated), so a governance surface falls back to rendering the raw ref.
+ */
+export class InMemoryActorDirectory {
+    labels;
+    constructor(labels = {}) {
+        this.labels = new Map(Object.entries(labels));
+    }
+    /** Add or overwrite a single ref → label mapping. Returns `this` for chaining. */
+    set(ref, label) {
+        this.labels.set(ref, label);
+        return this;
+    }
+    async resolveDisplay(refs) {
+        const out = {};
+        for (const ref of refs) {
+            const label = this.labels.get(ref);
+            if (label !== undefined) {
+                out[ref] = label;
+            }
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=in-memory-actor-directory.js.map

package/dist/src/testing/in-memory-actor-directory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-actor-directory.js","sourceRoot":"","sources":["../../../src/testing/in-memory-actor-directory.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAO,sBAAsB;IAChB,MAAM,CAAsB;IAE7C,YAAY,SAAiC,EAAE;QAC7C,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,kFAAkF;IAClF,GAAG,CAAC,GAAW,EAAE,KAAa;QAC5B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,IAAuB;QAC1C,MAAM,GAAG,GAA2B,EAAE,CAAC;QACvC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACnC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACnB,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}

package/dist/src/testing/in-memory-attachment-staging.d.ts

@@ -0,0 +1,22 @@
+import type { AttachmentStagingStore, StageAttachmentInput } from '../spi/attachment-staging.js';
+import type { MessageAttachment } from '../types.js';
+/** A staged record kept for test assertions (who uploaded what, and the reference it produced). */
+export interface StagedRecord {
+    mediaId: string;
+    filename: string;
+    contentType: string;
+    sizeBytes: number;
+    actorId: string;
+}
+/**
+ * A fully in-memory {@link AttachmentStagingStore} for tests and the offline demo. It encodes the
+ * uploaded bytes into a `data:` URL — a URL the AI SDK's image/file parts fetch inline, with no
+ * external object store or presigning — so a staged attachment is immediately model-fetchable. Every
+ * `stage` call is recorded in {@link staged} for assertions. Not for production (a real store presigns
+ * against S3/GCS or wraps the host's media pipeline).
+ */
+export declare class InMemoryAttachmentStagingStore implements AttachmentStagingStore {
+    readonly staged: StagedRecord[];
+    stage(input: StageAttachmentInput): Promise<MessageAttachment>;
+}
+//# sourceMappingURL=in-memory-attachment-staging.d.ts.map

package/dist/src/testing/in-memory-attachment-staging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-attachment-staging.d.ts","sourceRoot":"","sources":["../../../src/testing/in-memory-attachment-staging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACjG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,mGAAmG;AACnG,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,qBAAa,8BAA+B,YAAW,sBAAsB;IAC3E,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,CAAM;IAE/B,KAAK,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAiBrE"}

package/dist/src/testing/in-memory-attachment-staging.js

@@ -0,0 +1,28 @@
+/**
+ * A fully in-memory {@link AttachmentStagingStore} for tests and the offline demo. It encodes the
+ * uploaded bytes into a `data:` URL — a URL the AI SDK's image/file parts fetch inline, with no
+ * external object store or presigning — so a staged attachment is immediately model-fetchable. Every
+ * `stage` call is recorded in {@link staged} for assertions. Not for production (a real store presigns
+ * against S3/GCS or wraps the host's media pipeline).
+ */
+export class InMemoryAttachmentStagingStore {
+    staged = [];
+    async stage(input) {
+        const mediaId = `media-${this.staged.length + 1}`;
+        this.staged.push({
+            mediaId,
+            filename: input.filename,
+            contentType: input.contentType,
+            sizeBytes: input.sizeBytes,
+            actorId: input.actor.id,
+        });
+        const base64 = input.data.toString('base64');
+        return {
+            mediaId,
+            url: `data:${input.contentType};base64,${base64}`,
+            contentType: input.contentType,
+            name: input.filename,
+        };
+    }
+}
+//# sourceMappingURL=in-memory-attachment-staging.js.map

package/dist/src/testing/in-memory-attachment-staging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-attachment-staging.js","sourceRoot":"","sources":["../../../src/testing/in-memory-attachment-staging.ts"],"names":[],"mappings":"AAYA;;;;;;GAMG;AACH,MAAM,OAAO,8BAA8B;IAChC,MAAM,GAAmB,EAAE,CAAC;IAErC,KAAK,CAAC,KAAK,CAAC,KAA2B;QACrC,MAAM,OAAO,GAAG,SAAS,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACf,OAAO;YACP,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE;SACxB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC7C,OAAO;YACL,OAAO;YACP,GAAG,EAAE,QAAQ,KAAK,CAAC,WAAW,WAAW,MAAM,EAAE;YACjD,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,IAAI,EAAE,KAAK,CAAC,QAAQ;SACrB,CAAC;IACJ,CAAC;CACF"}