@adonis-agora/agent 0.20.0 → 0.22.0

package/dist/src/telescope/rag-data-providers.d.ts

@@ -0,0 +1,69 @@
+import type { DataProvider } from './telescope-sdk.js';
+/**
+ * RAG data providers for the "Agent" Telescope tab — a DELIBERATELY PARTIAL port of the Nest
+ * reference's `rag-data-providers.ts`.
+ *
+ * ## What Adonis's retrieval instrumentation actually publishes
+ *
+ * `@adonis-agora/agent` has exactly ONE retrieval telemetry point today: `agent-loop.ts`'s
+ * inject-mode retrieval path (`deps.retriever` configured) publishes `agora:agent:retrieved` via
+ * `publishAgentRetrieved` (`src/diagnostics.ts`) with payload `{ runId, queryLength, count }` —
+ * nothing else. Telescope's generic diagnostics bridge records it as any other `lib:agent` event:
+ * `type: 'diagnostic'`, `tag: 'lib:agent'`, `content: { event: 'retrieved', payload: {...} }`.
+ *
+ * That payload has NO `store`, `collection`, `retriever` kind, `topScore`, or `durationMs` — unlike
+ * `@dudousxd/nestjs-agent-rag`'s dedicated `aviary:rag:retrieval` channel, which is what lets the
+ * Nest reference build latency histograms, score distributions, and store/collection breakdowns.
+ * `agent-loop.ts` DOES span the retrieval (`spannedAgent('retrieval', ...)`, which carries `topK` and
+ * a `count` result on its `asyncEnd`), but those spans ride raw `node:diagnostics_channel` sub-channels
+ * (`agora:agent:retrieval:start/end/asyncStart/asyncEnd/error`) that NOTHING in `@adonis-agora/telescope`
+ * subscribes to today — confirmed by reading its `diagnostics_watcher.ts` and every `metrics/*.ts` file:
+ * the generic bridge only auto-subscribes to POINT channels a producer registers via
+ * `@adonis-agora/diagnostics`'s `registry.channels`, and `spannedAgent` publishes on ad-hoc sub-channel
+ * names it never registers there (by design — it avoids importing `@adonis-agora/diagnostics` at all).
+ * So the span data is not lost, exactly, but nothing today turns it into a recorded Telescope entry;
+ * building that bridge is a `@adonis-agora/telescope` (or `@adonis-agora/diagnostics`) change, not
+ * something this file can conjure from the entries Telescope already has.
+ *
+ * ## What that leaves portable
+ *
+ * From `{ runId, queryLength, count }` alone: how many retrievals happened, what fraction came back
+ * empty (`count === 0`), the mean passage count, and a retrievals/zero-hits trend. That is FOUR of the
+ * Nest reference's ten RAG providers. The other six — latency distribution, score distribution,
+ * store breakdown, retriever breakdown, per-collection table, slowest-retrievals table — are NOT
+ * ported: there is no field in the recorded entry for any of them, and faking one (e.g. a
+ * `durationMs` of 0 for every row) would render a chart that looks real and lies. Widening
+ * `AgentRetrieved`'s payload (and `agent-loop.ts`'s publish call) to carry that data is the real fix;
+ * it's a `src/diagnostics.ts`/`src/agent-loop.ts` instrumentation change, out of scope for a telescope
+ * extension change, and is called out as the recommended follow-up.
+ *
+ * ## Shares the SAME 5,000-entry window as every other agent provider
+ *
+ * Unlike the Nest reference — where `RagTelescopeWatcher` gives retrieval events their OWN entry type
+ * (`agent-rag`) specifically so a busy retrieval stream can never crowd `run.finished` out of the
+ * agent window — Adonis has no per-extension entry-type/watcher mechanism (see `extension.ts`'s
+ * header for why), so `retrieved` entries live in the exact same capped `lib:agent` slice
+ * `data-providers.ts` reads. A retrieval-heavy deployment can push older `run.*`/`tool-call` entries
+ * out of that window, and vice versa. This is an accepted, documented limitation, not an oversight.
+ */
+/** One retrieval, normalized out of an entry's `content.payload`. */
+interface RagRetrieval {
+    at: number;
+    queryLength: number;
+    count: number;
+}
+/** Fraction (0–1) of retrievals that came back with nothing. `0` over an empty window. */
+export declare function zeroHitRate(retrievals: RagRetrieval[]): number;
+/** Mean passages returned per retrieval. `0` over an empty window. */
+export declare function meanChunks(retrievals: RagRetrieval[]): number;
+/** stat → retrievals recorded in the current window. */
+export declare function ragRetrievalsProvider(): DataProvider;
+/** stat (percent) → share of retrievals that returned nothing. */
+export declare function ragZeroHitRateProvider(): DataProvider;
+/** stat → mean passages returned per retrieval. */
+export declare function ragChunksProvider(): DataProvider;
+/** timeseries → retrievals and zero-hits per bucket, using the same bucketing every other agent
+ * timeseries provider uses (`data-providers.ts`'s `timeBuckets`), not a second bucketing scheme. */
+export declare function ragTrendProvider(): DataProvider;
+export {};
+//# sourceMappingURL=rag-data-providers.d.ts.map

package/dist/src/telescope/rag-data-providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag-data-providers.d.ts","sourceRoot":"","sources":["../../../src/telescope/rag-data-providers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAwC,MAAM,oBAAoB,CAAC;AAE7F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,qEAAqE;AACrE,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AA+BD,0FAA0F;AAC1F,wBAAgB,WAAW,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,MAAM,CAI9D;AAED,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,MAAM,CAG7D;AAeD,wDAAwD;AACxD,wBAAgB,qBAAqB,IAAI,YAAY,CAEpD;AAED,kEAAkE;AAClE,wBAAgB,sBAAsB,IAAI,YAAY,CAIrD;AAED,mDAAmD;AACnD,wBAAgB,iBAAiB,IAAI,YAAY,CAEhD;AAED;oGACoG;AACpG,wBAAgB,gBAAgB,IAAI,YAAY,CAoB/C"}

package/dist/src/telescope/rag-data-providers.js

@@ -0,0 +1,84 @@
+import { ENTRY_LIMIT, atOf, bucketIndexFor, fetchEntries, timeBuckets } from './data-providers.js';
+const contentOf = (e) => (e.content ?? {});
+/** Read every recorded `retrieved` entry (newest first, capped at {@link ENTRY_LIMIT}). */
+async function readRetrievals(ctx) {
+    const entries = await fetchEntries(ctx, ENTRY_LIMIT);
+    const retrievals = [];
+    for (const entry of entries) {
+        const content = contentOf(entry);
+        if (content.event !== 'retrieved')
+            continue;
+        retrievals.push({
+            at: atOf(entry),
+            queryLength: content.payload?.queryLength ?? 0,
+            count: content.payload?.count ?? 0,
+        });
+    }
+    return retrievals;
+}
+function round(value, places) {
+    const factor = 10 ** places;
+    return Math.round(value * factor) / factor;
+}
+/** Fraction (0–1) of retrievals that came back with nothing. `0` over an empty window. */
+export function zeroHitRate(retrievals) {
+    if (retrievals.length === 0)
+        return 0;
+    const zeroHits = retrievals.filter((r) => r.count === 0).length;
+    return round(zeroHits / retrievals.length, 4);
+}
+/** Mean passages returned per retrieval. `0` over an empty window. */
+export function meanChunks(retrievals) {
+    if (retrievals.length === 0)
+        return 0;
+    return round(retrievals.reduce((sum, r) => sum + r.count, 0) / retrievals.length, 2);
+}
+/** Build a provider from one shaping step over every recorded retrieval. */
+function retrievalProvider(name, format) {
+    return {
+        name,
+        async resolve(_query, ctx) {
+            return format(await readRetrievals(ctx));
+        },
+    };
+}
+/** stat → retrievals recorded in the current window. */
+export function ragRetrievalsProvider() {
+    return retrievalProvider('agent.rag.retrievals', (retrievals) => ({ value: retrievals.length }));
+}
+/** stat (percent) → share of retrievals that returned nothing. */
+export function ragZeroHitRateProvider() {
+    return retrievalProvider('agent.rag.zeroHitRate', (retrievals) => ({
+        value: zeroHitRate(retrievals),
+    }));
+}
+/** stat → mean passages returned per retrieval. */
+export function ragChunksProvider() {
+    return retrievalProvider('agent.rag.chunks', (retrievals) => ({ value: meanChunks(retrievals) }));
+}
+/** timeseries → retrievals and zero-hits per bucket, using the same bucketing every other agent
+ * timeseries provider uses (`data-providers.ts`'s `timeBuckets`), not a second bucketing scheme. */
+export function ragTrendProvider() {
+    return {
+        name: 'agent.rag.trend',
+        async resolve(query, ctx) {
+            const entries = await fetchEntries(ctx, ENTRY_LIMIT);
+            const buckets = Math.max(1, Number(query?.buckets ?? 24));
+            const retrievedEntries = entries.filter((e) => contentOf(e).event === 'retrieved');
+            const { rows, minTime, bucketSize } = timeBuckets(retrievedEntries, buckets, () => ({
+                retrievals: 0,
+                zeroHits: 0,
+            }));
+            for (const entry of retrievedEntries) {
+                const row = rows[bucketIndexFor(entry, minTime, bucketSize, buckets)];
+                if (!row)
+                    continue;
+                row.retrievals += 1;
+                if ((contentOf(entry).payload?.count ?? 0) === 0)
+                    row.zeroHits += 1;
+            }
+            return { rows };
+        },
+    };
+}
+//# sourceMappingURL=rag-data-providers.js.map

package/dist/src/telescope/rag-data-providers.js.map

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

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

@@ -93,6 +93,17 @@ export type Panel = {
     title: string;
     data: DataBinding;
     columns: Column[];
+    /**
+     * Opt into paged-table mode: the UI renders prev/next controls and re-resolves this panel's
+     * provider with `query.page` (1-based) and `query.limit` merged in. The provider must then
+     * return `{ rows, total, page, limit }` instead of a bare `{ rows }`. Omit (or `false`) for
+     * the existing bare-rows table. Mirrors `@adonis-agora/telescope`'s `Panel` (table variant) —
+     * kept here so a host on a telescope version that ships it doesn't excess-property-error.
+     * None of this extension's OWN table providers opt in yet: see `agent-governance-providers.ts`
+     * for why (the governance read-model doesn't expose a page+total query for every table this
+     * would apply to).
+     */
+    paged?: boolean;
 } | {
     kind: 'distribution';
     title: string;

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

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

package/dist/stubs/config/agent.stub

@@ -39,6 +39,13 @@ export default defineConfig({
   // defaultRoles: ['ADMIN'],  // roles a tool requires when it declares none (fail-closed)
   // maxSteps: 8,              // cap on model↔tool iterations per turn
 
+  // Governance console — served automatically at <path>/dashboard (default /agent/dashboard), no
+  // separate install. It only mounts once `governanceAuthorize` is set (every panel but Quota reads
+  // the cross-actor governance routes, which need that gate too — see the docs). Toggle it off,
+  // relocate it, or add an extra gate on top of governanceAuthorize:
+  // dashboard: { enabled: true, path: '/agent/dashboard', authorize: (actor) => actor.roles?.includes('ADMIN') ?? false },
+  // governanceAuthorize: (actor) => actor.roles?.includes('ADMIN') ?? false,
+
   // Multimodal uploads — mounts POST /agent/attachments, which stages a file into a model-fetchable
   // MessageAttachment the client sends back with its next chat message. Bind your own store (presign
   // S3/GCS or wrap your media pipeline); `attachmentStores.memory()` inlines bytes as a data: URL.

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@adonis-agora/agent",
-  "version": "0.20.0",
+  "version": "0.22.0",
   "description": "Governed, durable-backed AI agent (chat + tool-calling + governance) for AdonisJS — part of the Agora ecosystem.",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/DavideCarvalho/adonis-agent.git",
+    "url": "git+https://github.com/DavideCarvalho/adonis-agora-agent.git",
     "directory": "packages/adonis"
   },
   "author": "Davi Carvalho <davi@goflip.ai>",
@@ -58,6 +58,16 @@
       "import": "./dist/providers/agent_provider.js",
       "default": "./dist/providers/agent_provider.js"
     },
+    "./dashboard_provider": {
+      "types": "./dist/providers/dashboard_provider.d.ts",
+      "import": "./dist/providers/dashboard_provider.js",
+      "default": "./dist/providers/dashboard_provider.js"
+    },
+    "./dashboard": {
+      "types": "./dist/src/dashboard/index.d.ts",
+      "import": "./dist/src/dashboard/index.js",
+      "default": "./dist/src/dashboard/index.js"
+    },
     "./configure": {
       "types": "./dist/configure.d.ts",
       "import": "./dist/configure.js",
@@ -106,8 +116,8 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.30.0",
-    "@standard-schema/spec": "^1.0.0"
+    "@modelcontextprotocol/sdk": "1.30.0",
+    "@standard-schema/spec": "1.1.0"
   },
   "peerDependencies": {
     "@adonis-agora/authz": ">=0.4.2 <1.0.0",
@@ -166,27 +176,27 @@
     }
   },
   "devDependencies": {
-    "@adonis-agora/authz": "^0.10.1",
-    "@adonis-agora/diagnostics": "^0.2.5",
+    "@adonis-agora/authz": "0.10.1",
+    "@adonis-agora/diagnostics": "0.2.5",
     "@adonis-agora/durable": "0.21.0",
-    "@adonis-agora/telescope": "^0.6.0",
-    "@adonisjs/assembler": "^8.4.0",
+    "@adonis-agora/telescope": "0.6.0",
+    "@adonisjs/assembler": "8.4.0",
     "@adonisjs/core": "7.4.0",
-    "@adonisjs/lucid": "^22.4.0",
+    "@adonisjs/lucid": "22.4.2",
     "@qdrant/js-client-rest": "1.19.0",
-    "@types/node": "^22.0.0",
+    "@types/node": "22.20.0",
     "@types/react": "19.2.18",
     "ai": "7.0.59",
-    "better-sqlite3": "^11.0.0",
-    "luxon": "^3.4.0",
-    "node-sql-parser": "^5.3.0",
+    "better-sqlite3": "11.10.0",
+    "luxon": "3.7.2",
+    "node-sql-parser": "5.4.0",
     "react": "19.2.8",
-    "typescript": "^5.4.0",
-    "vitest": "^3.0.0",
-    "zod": "^3.25.0"
+    "typescript": "5.9.3",
+    "vitest": "3.2.7",
+    "zod": "3.25.76"
   },
   "engines": {
-    "node": ">=22.0.0 <23"
+    "node": "v22.23.2"
   },
   "keywords": [
     "adonisjs",
@@ -204,7 +214,7 @@
     "build": "pnpm run clean && tsc -p tsconfig.build.json && pnpm run copy:stubs && pnpm run check:dist",
     "check:dist": "node ../../scripts/assert-build-output.mjs dist src/index.js",
     "clean": "rm -rf dist",
-    "copy:stubs": "mkdir -p dist/stubs/config dist/stubs/database/migrations && cp stubs/config/agent.stub dist/stubs/config/agent.stub && cp stubs/config/mcp.stub dist/stubs/config/mcp.stub && cp -r stubs/database/migrations/. dist/stubs/database/migrations/",
+    "copy:stubs": "mkdir -p dist/stubs/config dist/stubs/database/migrations dist/assets && cp stubs/config/agent.stub dist/stubs/config/agent.stub && cp stubs/config/mcp.stub dist/stubs/config/mcp.stub && cp -r stubs/database/migrations/. dist/stubs/database/migrations/ && rm -rf dist/assets/spa && cp -r ../dashboard/dist/spa dist/assets/spa",
     "test": "vitest run --passWithNoTests",
     "test:watch": "vitest",
     "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.tests.json"