@adonis-agora/agent 0.21.0 → 0.22.1

package/dist/src/telescope/extension.js

@@ -1,9 +1,26 @@
+import { agentActorSpendTableProvider, agentModelSpendTableProvider, agentPendingApprovalsCountProvider, agentPendingApprovalsTableProvider, agentRecentRunsTableProvider, agentRecentThreadsTableProvider, agentRecentToolCallsTableProvider, agentRunsByAgentTableProvider, agentRunsDurationProvider, agentRunsFailedProvider, agentRunsSuccessRateProvider, agentRunsTotalProvider, agentRunsTrendProvider, agentSpendByActorProvider, agentSpendByModelProvider, agentSpendTotalProvider, agentTokensTotalProvider, agentToolStatsTableProvider, agentUsageTrendProvider, } from './agent-governance-providers.js';
 import { agentDashboard } from './dashboard.js';
 import { agentActiveRunsProvider, agentDelegationsOverTimeProvider, agentRecentApprovalsProvider, agentRecentDelegationsProvider, agentRecentRunsProvider, agentRecentToolCallsProvider, agentRunsOverTimeProvider, agentTokenUsageProvider, agentTokensOverTimeProvider, agentToolCallSuccessRateProvider, agentToolCallsOverTimeProvider, } from './data-providers.js';
+import { ragChunksProvider, ragRetrievalsProvider, ragTrendProvider, ragZeroHitRateProvider, } from './rag-data-providers.js';
+/** The provider-name prefix this extension owns. A host contribution may not claim a name under it. */
+const RESERVED_PROVIDER_PREFIX = 'agent.';
 /**
- * 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`:
+ * The first-class `@adonis-agora/telescope` extension for `@adonis-agora/agent` (the "Agent" tab):
+ * the overview dashboard (`dashboard.ts`) plus every data provider its panels bind to, from three
+ * sources:
+ *
+ *  - **Entry-backed** (`data-providers.ts`) — aggregates the `agora:agent:*` events Telescope's
+ *    generic diagnostics bridge records as `type: 'diagnostic'`, `tag: 'lib:agent'`. Ephemeral
+ *    (bounded by Telescope's own retention/entry cap), but needs zero host configuration.
+ *  - **Governance-backed** (`agent-governance-providers.ts`) — reads `AgentGovernanceQueries`, the
+ *    authoritative, restart-surviving read-model `AgentProvider#boot()` already builds from
+ *    `config.governanceQueries` (the SAME read-model the `/agent/governance/*` routes and the
+ *    standalone `@adonis-agora/agent-dashboard` SPA use). Degrades to an empty-but-valid shape when
+ *    governance isn't configured.
+ *  - **RAG** (`rag-data-providers.ts`) — entry-backed like the first group, scoped to what
+ *    `agent-loop.ts`'s inject-mode retrieval actually publishes (`{ runId, queryLength, count }`).
+ *    See that file's header for the FULL list of Nest-reference RAG panels this does NOT cover
+ *    (latency, scores, store/collection breakdown) and why.
  *
  * ```ts
  * import { defineConfig } from '@adonis-agora/telescope'
@@ -12,22 +29,55 @@ import { agentActiveRunsProvider, agentDelegationsOverTimeProvider, agentRecentA
  * 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 watcher, no `entryTypes` — a confirmed SDK constraint, not an oversight
+ *
+ * The Nest reference registers a LIVE watcher (`AgentTelescopeWatcher`/`RagTelescopeWatcher`) and two
+ * bespoke entry types (`agent`, `agent-rag`), because Nest's `TelescopeExtension` supports a
+ * `watchers` hook that lets an extension record entries under its OWN `type`. Checked against the
+ * REAL, current `@adonis-agora/telescope` contract (`~/adonis-telescope/packages/core/src/extension/types.ts`,
+ * mirrored in `telescope-sdk.ts`): `TelescopeExtension` exposes only `entryTypes` / `dashboards` /
+ * `dataProviders` — no `watchers` field exists AT ALL. Every `agora:agent:*` event (including
+ * `retrieved`) is captured by Telescope's ONE generic `DiagnosticsWatcher`, which ALWAYS records
+ * every library's events under the same `type: 'diagnostic'` — an extension has no way to make its
+ * own entries land under a different `type`, so contributing `entryTypes: () => [{ id: 'agent', ... }]`
+ * would add a nav filter that never matches anything real. Same reasoning `@adonis-agora/media`'s and
+ * `@adonis-agora/durable`'s telescope extensions already document for their own "no watcher"
+ * comments — extended here to also cover why RAG can't get its own entry type either, which the Nest
+ * reference relies on specifically so a busy retrieval stream can't crowd `run.*` entries out of the
+ * shared window (see `rag-data-providers.ts`'s header for the consequence: RAG and everything else
+ * share ONE capped `lib:agent` slice here).
+ *
+ * ## Governance wiring is a package-internal registry, not container DI
  *
- * 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`.)
+ * The Nest reference resolves `AGENT_GOVERNANCE_QUERIES` from the host's DI container
+ * (`ctx.moduleRef.get`). `ExtensionContext.container` exists on the Adonis side too, but
+ * `AgentProvider#boot()` doesn't bind `AgentGovernanceQueries` into AdonisJS's container — see
+ * `governance-registry.ts`'s header for exactly why, and for the smaller alternative it uses instead
+ * (`AgentProvider#boot()` pushes the resolved read-model into a package-internal registry;
+ * `agent-governance-providers.ts` reads it back out — no `ctx.container` involved).
+ *
+ * `threadHref`/`runHref` deep-link a table row's `threadId`/`runId` cell to a HOST's own thread/run
+ * viewer — passed straight through to {@link agentDashboard}. `providers`/`sections` let a host
+ * append its own panels to this dashboard (see {@link AgentTelescopeExtensionOptions.providers} and
+ * `AgentDashboardOptions.sections`).
  */
 export function agentTelescopeExtension(opts = {}) {
+    const hostProviders = opts.providers ?? [];
+    const reserved = hostProviders.filter((provider) => provider.name.startsWith(RESERVED_PROVIDER_PREFIX));
+    if (reserved.length > 0) {
+        throw new Error(`agentTelescopeExtension: host-contributed data providers may not use the reserved "${RESERVED_PROVIDER_PREFIX}" prefix — ` +
+            `rename ${reserved.map((provider) => `"${provider.name}"`).join(', ')} to your own namespace.`);
+    }
+    const dashboardOpts = {
+        ...(opts.runHref !== undefined ? { runHref: opts.runHref } : {}),
+        ...(opts.threadHref !== undefined ? { threadHref: opts.threadHref } : {}),
+        ...(opts.sections !== undefined ? { sections: opts.sections } : {}),
+    };
     return {
         name: 'agent',
-        dashboards: () => [agentDashboard(opts)],
+        dashboards: () => [agentDashboard(dashboardOpts)],
         dataProviders: () => [
+            // Entry-backed (data-providers.ts).
             agentActiveRunsProvider(),
             agentTokenUsageProvider(),
             agentToolCallSuccessRateProvider(),
@@ -39,6 +89,33 @@ export function agentTelescopeExtension(opts = {}) {
             agentRecentApprovalsProvider(),
             agentDelegationsOverTimeProvider(),
             agentRecentDelegationsProvider(),
+            // Governance-backed (agent-governance-providers.ts).
+            agentSpendTotalProvider(),
+            agentTokensTotalProvider(),
+            agentSpendByModelProvider(),
+            agentModelSpendTableProvider(),
+            agentUsageTrendProvider(),
+            agentActorSpendTableProvider(),
+            agentSpendByActorProvider(),
+            agentRunsTotalProvider(),
+            agentRunsSuccessRateProvider(),
+            agentRunsFailedProvider(),
+            agentRunsDurationProvider(),
+            agentRunsByAgentTableProvider(),
+            agentRunsTrendProvider(),
+            agentRecentRunsTableProvider(),
+            agentRecentToolCallsTableProvider(),
+            agentRecentThreadsTableProvider(),
+            agentPendingApprovalsCountProvider(),
+            agentPendingApprovalsTableProvider(),
+            agentToolStatsTableProvider(),
+            // RAG (rag-data-providers.ts) — partial scope, see that file's header.
+            ragRetrievalsProvider(),
+            ragZeroHitRateProvider(),
+            ragChunksProvider(),
+            ragTrendProvider(),
+            // Host-contributed.
+            ...hostProviders,
         ],
     };
 }

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

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

package/dist/src/telescope/governance-registry.d.ts

@@ -0,0 +1,15 @@
+import type { AgentGovernanceQueries } from '../spi/governance-queries.js';
+/**
+ * Set by `AgentProvider#boot()` once `config.governanceQueries` resolves (or back to `undefined`
+ * when governance is disabled). Internal wiring only — not re-exported from `src/index.ts` or
+ * `src/telescope/index.ts`'s public surface, only imported directly by the two files that need it.
+ */
+export declare function setTelescopeGovernanceQueries(queries: AgentGovernanceQueries | undefined): void;
+/**
+ * Read by the governance-backed telescope providers. `undefined` before `AgentProvider#boot()` has
+ * run, or when the host has `governanceQueries: false` / never installed a store that defaults one —
+ * every provider in `agent-governance-providers.ts` degrades to an empty-but-valid shape in that case,
+ * mirroring the Nest reference's "host hasn't bound the token" degrade path.
+ */
+export declare function getTelescopeGovernanceQueries(): AgentGovernanceQueries | undefined;
+//# sourceMappingURL=governance-registry.d.ts.map

package/dist/src/telescope/governance-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance-registry.d.ts","sourceRoot":"","sources":["../../../src/telescope/governance-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AA2B3E;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,sBAAsB,GAAG,SAAS,GAAG,IAAI,CAE/F;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,IAAI,sBAAsB,GAAG,SAAS,CAElF"}

package/dist/src/telescope/governance-registry.js

@@ -0,0 +1,42 @@
+/**
+ * The package-internal slot `agent-governance-providers.ts` reads the governance read-model from.
+ *
+ * The Nest reference resolves `AGENT_GOVERNANCE_QUERIES` from the host's DI container at request
+ * time (`ctx.moduleRef.get(...)`) — Nest's module system makes any provider resolvable by any
+ * consumer that declares the token. AdonisJS's real IoC container (`@adonisjs/fold`) CAN bind
+ * arbitrary values too, but resolving one back out without an unsafe cast requires a
+ * `ContainerBindings` module augmentation naming the binding key's type — and that pattern has NO
+ * other precedent anywhere in this package: every binding `AgentProvider#boot()` registers today
+ * is class-keyed (`ToolRegistry`, `AgentRegistry`, `AgentService`), never an interface-shaped SPI
+ * value like `AgentGovernanceQueries`. `governanceQueries` itself stays a boot-time-local variable,
+ * used directly to mount the `/agent/governance/*` routes and never otherwise exposed. Introducing
+ * a brand-new container-augmentation pattern purely so ONE telescope file can read it would be a
+ * bigger footprint than the read is worth — and would need `packages/adonis/src/telescope/*` to
+ * gain a hard dependency on `@adonisjs/core`'s container types, which it currently has none of.
+ *
+ * So this registry is the smaller alternative already precedented one file over: `src/diagnostics.ts`
+ * publishes `emit`/`trace` on a `Symbol.for(...)` slot on `globalThis` so `@adonis-agora/agent` can
+ * read `@adonis-agora/diagnostics`' capability structurally, without importing it. The same shape,
+ * simplified: `providers/agent_provider.ts` (the producer) and this file (the consumer) are compiled
+ * into the SAME package, so there's no cross-`node_modules`-copy identity problem for `Symbol.for`
+ * to solve — an ordinary module-scoped variable is enough.
+ */
+let current;
+/**
+ * Set by `AgentProvider#boot()` once `config.governanceQueries` resolves (or back to `undefined`
+ * when governance is disabled). Internal wiring only — not re-exported from `src/index.ts` or
+ * `src/telescope/index.ts`'s public surface, only imported directly by the two files that need it.
+ */
+export function setTelescopeGovernanceQueries(queries) {
+    current = queries;
+}
+/**
+ * Read by the governance-backed telescope providers. `undefined` before `AgentProvider#boot()` has
+ * run, or when the host has `governanceQueries: false` / never installed a store that defaults one —
+ * every provider in `agent-governance-providers.ts` degrades to an empty-but-valid shape in that case,
+ * mirroring the Nest reference's "host hasn't bound the token" degrade path.
+ */
+export function getTelescopeGovernanceQueries() {
+    return current;
+}
+//# sourceMappingURL=governance-registry.js.map

package/dist/src/telescope/governance-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance-registry.js","sourceRoot":"","sources":["../../../src/telescope/governance-registry.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,IAAI,OAA2C,CAAC;AAEhD;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAAC,OAA2C;IACvF,OAAO,GAAG,OAAO,CAAC;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B;IAC3C,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -1,5 +1,7 @@
+export { agentActorSpendTableProvider, agentModelSpendTableProvider, agentPendingApprovalsCountProvider, agentPendingApprovalsTableProvider, agentRecentRunsTableProvider, agentRecentThreadsTableProvider, agentRecentToolCallsTableProvider, agentRunsByAgentTableProvider, agentRunsDurationProvider, agentRunsFailedProvider, agentRunsSuccessRateProvider, agentRunsTotalProvider, agentRunsTrendProvider, agentSpendByActorProvider, agentSpendByModelProvider, agentSpendTotalProvider, agentTokensTotalProvider, agentToolStatsTableProvider, agentUsageTrendProvider, capErrorMessage, resolveRange, shiftUtcDay, } from './agent-governance-providers.js';
 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';
+export { type AgentTelescopeExtensionOptions, agentTelescopeExtension } from './extension.js';
+export { ragChunksProvider, ragRetrievalsProvider, ragTrendProvider, ragZeroHitRateProvider, zeroHitRate, meanChunks, } from './rag-data-providers.js';
+export type { Column, ContainerLike, DashboardSection, DashboardSpec, DataBinding, DataProvider, ExtensionContext, LinkSpec, Panel, PanelThresholds, TelescopeExtension, TelescopeStoreLike, TelescopeEntryLike, } from './telescope-sdk.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/telescope/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC5B,kCAAkC,EAClC,kCAAkC,EAClC,4BAA4B,EAC5B,+BAA+B,EAC/B,iCAAiC,EACjC,6BAA6B,EAC7B,yBAAyB,EACzB,uBAAuB,EACvB,4BAA4B,EAC5B,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,uBAAuB,EACvB,eAAe,EACf,YAAY,EACZ,WAAW,GACZ,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,KAAK,qBAAqB,EAAE,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;AAC7B,OAAO,EAAE,KAAK,8BAA8B,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAC9F,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,UAAU,GACX,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,MAAM,EACN,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,QAAQ,EACR,KAAK,EACL,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC"}

package/dist/src/telescope/index.js

@@ -1,4 +1,6 @@
+export { agentActorSpendTableProvider, agentModelSpendTableProvider, agentPendingApprovalsCountProvider, agentPendingApprovalsTableProvider, agentRecentRunsTableProvider, agentRecentThreadsTableProvider, agentRecentToolCallsTableProvider, agentRunsByAgentTableProvider, agentRunsDurationProvider, agentRunsFailedProvider, agentRunsSuccessRateProvider, agentRunsTotalProvider, agentRunsTrendProvider, agentSpendByActorProvider, agentSpendByModelProvider, agentSpendTotalProvider, agentTokensTotalProvider, agentToolStatsTableProvider, agentUsageTrendProvider, capErrorMessage, resolveRange, shiftUtcDay, } from './agent-governance-providers.js';
 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';
+export { agentTelescopeExtension } from './extension.js';
+export { ragChunksProvider, ragRetrievalsProvider, ragTrendProvider, ragZeroHitRateProvider, zeroHitRate, meanChunks, } from './rag-data-providers.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/telescope/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC5B,kCAAkC,EAClC,kCAAkC,EAClC,4BAA4B,EAC5B,+BAA+B,EAC/B,iCAAiC,EACjC,6BAA6B,EAC7B,yBAAyB,EACzB,uBAAuB,EACvB,4BAA4B,EAC5B,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,uBAAuB,EACvB,eAAe,EACf,YAAY,EACZ,WAAW,GACZ,MAAM,iCAAiC,CAAC;AACzC,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;AAC7B,OAAO,EAAuC,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAC9F,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,UAAU,GACX,MAAM,yBAAyB,CAAC"}

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adonis-agora/agent",
-  "version": "0.21.0",
+  "version": "0.22.1",
   "description": "Governed, durable-backed AI agent (chat + tool-calling + governance) for AdonisJS — part of the Agora ecosystem.",
   "license": "MIT",
   "repository": {
@@ -184,7 +184,7 @@
     "@adonisjs/core": "7.4.0",
     "@adonisjs/lucid": "22.4.2",
     "@qdrant/js-client-rest": "1.19.0",
-    "@types/node": "22.20.0",
+    "@types/node": "22.20.1",
     "@types/react": "19.2.18",
     "ai": "7.0.59",
     "better-sqlite3": "11.10.0",

package/dist/assets/spa/assets/index-BYLm0nq8.css

@@ -1 +0,0 @@
-:root{--agora-primary: #5a45ff;--agora-primary-soft: hsl(250 74% 51% / .14);--agora-accent: #06b6d4;--bg: hsl(240 10% 6.5%);--panel: hsl(240 9% 9%);--panel-2: hsl(240 9% 11%);--line: hsl(40 30% 82% / .1);--line-soft: hsl(40 30% 82% / .05);--text: hsl(40 28% 92%);--muted: hsl(40 12% 66%);--primary: var(--agora-primary);--primary-fg: hsl(40 40% 96%);--good: #34d399;--warn: #fbbf24;--bad: #f87171;--info: var(--agora-accent)}:root[data-theme=light],:root:not([data-theme=dark]){color-scheme:light}:root[data-theme=dark]{color-scheme:dark}@media(prefers-color-scheme:light){:root:not([data-theme=dark]){--bg: hsl(40 30% 96%);--panel: hsl(40 28% 98%);--panel-2: hsl(40 24% 95%);--line: hsl(240 10% 14% / .12);--line-soft: hsl(240 10% 14% / .06);--text: hsl(240 14% 12%);--muted: hsl(240 6% 42%);--primary-fg: hsl(40 40% 97%)}}:root[data-theme=light]{--bg: hsl(40 30% 96%);--panel: hsl(40 28% 98%);--panel-2: hsl(40 24% 95%);--line: hsl(240 10% 14% / .12);--line-soft: hsl(240 10% 14% / .06);--text: hsl(240 14% 12%);--muted: hsl(240 6% 42%);--primary-fg: hsl(40 40% 97%)}*{box-sizing:border-box}html,body,#root{height:100%;margin:0}body{background:var(--bg);color:var(--text);font-family:ui-sans-serif,system-ui,-apple-system,Segoe UI,sans-serif;-webkit-font-smoothing:antialiased}.mono{font-family:ui-monospace,JetBrains Mono,SF Mono,Menlo,monospace}.tnum{font-variant-numeric:tabular-nums}.app-bg{position:fixed;inset:0;z-index:0;pointer-events:none;background-image:radial-gradient(900px 420px at 82% -10%,hsl(250 74% 51% / .12),transparent 70%),radial-gradient(700px 360px at 8% -12%,hsl(190 90% 50% / .06),transparent 70%);opacity:.9}.shell{position:relative;z-index:1;max-width:1180px;margin:0 auto;padding:28px 24px 64px}.masthead{display:flex;align-items:center;justify-content:space-between;gap:16px;flex-wrap:wrap;margin-bottom:22px}.brand{display:flex;align-items:center;gap:12px}.brand-mark{width:34px;height:34px;border-radius:9px;display:grid;place-items:center;color:var(--primary-fg);background:linear-gradient(140deg,var(--agora-primary),#8b78ff);box-shadow:0 6px 20px #4426df59;font-weight:700}.brand h1{font-size:17px;margin:0;letter-spacing:-.01em}.brand p{margin:1px 0 0;font-size:12px;color:var(--muted)}.tabs{display:flex;gap:6px;flex-wrap:wrap;margin-bottom:20px}.tab{appearance:none;border:1px solid var(--line);background:var(--panel);color:var(--muted);border-radius:999px;padding:7px 14px;font-size:13px;cursor:pointer;display:inline-flex;align-items:center;gap:7px;transition:color .15s,border-color .15s,background .15s}.tab:hover{color:var(--text)}.tab[aria-selected=true]{color:var(--primary-fg);background:var(--primary);border-color:var(--primary)}.controls{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.range-input{background:var(--panel);border:1px solid var(--line);color:var(--text);border-radius:8px;padding:6px 9px;font-size:12px;font-family:inherit}.icon-btn{appearance:none;border:1px solid var(--line);background:var(--panel);color:var(--muted);border-radius:8px;width:34px;height:32px;cursor:pointer;display:grid;place-items:center}.icon-btn:hover{color:var(--text)}.panel{background:linear-gradient(180deg,var(--panel-2),var(--panel));border:1px solid var(--line);border-radius:14px;padding:18px}.grid{display:grid;gap:16px}.grid.cols-3{grid-template-columns:repeat(3,1fr)}.grid.cols-2{grid-template-columns:repeat(2,1fr)}.grid.stat-4{grid-template-columns:repeat(4,1fr)}@media(max-width:900px){.grid.cols-3,.grid.cols-2,.grid.stat-4{grid-template-columns:repeat(2,1fr)}}@media(max-width:560px){.grid.cols-3,.grid.cols-2,.grid.stat-4{grid-template-columns:1fr}}.stat .label{font-size:11px;text-transform:uppercase;letter-spacing:.06em;color:var(--muted);margin-bottom:8px}.stat .value{font-size:24px;font-weight:600;letter-spacing:-.02em}.stat .sub{font-size:12px;color:var(--muted);margin-top:4px}.section-title{display:flex;align-items:center;justify-content:space-between;margin:0 0 14px;gap:12px}.section-title h2{font-size:14px;margin:0;letter-spacing:.01em}.section-title .hint{font-size:12px;color:var(--muted)}.table{width:100%;border-collapse:collapse;font-size:13px}.table th{text-align:left;font-weight:500;font-size:11px;text-transform:uppercase;letter-spacing:.05em;color:var(--muted);padding:0 10px 10px;border-bottom:1px solid var(--line)}.table td{padding:10px;border-bottom:1px solid var(--line-soft);vertical-align:middle}.table tr:last-child td{border-bottom:none}.table .num{text-align:right}.table-wrap{overflow-x:auto}.bar{height:6px;border-radius:999px;background:var(--line);overflow:hidden;min-width:60px}.bar>span{display:block;height:100%;border-radius:999px;background:var(--primary)}.legend{display:flex;flex-direction:column;gap:8px;font-size:12px}.legend .row{display:flex;align-items:center;gap:8px}.swatch{width:10px;height:10px;border-radius:3px;flex:none}.legend .name{flex:1;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.pill{display:inline-flex;align-items:center;gap:6px;padding:2px 9px;border-radius:999px;font-size:11px;border:1px solid var(--line);color:var(--muted)}.dot{width:7px;height:7px;border-radius:999px;background:currentColor;display:inline-block}.s-completed,.s-ok,.s-success,.s-approved{color:var(--good)}.s-running,.s-pending,.s-pending_approval,.s-awaiting_approval{color:var(--info)}.s-failed,.s-error,.s-rejected,.s-forbidden{color:var(--bad)}.s-cancelled,.s-canceled{color:var(--warn)}.btn{appearance:none;border:1px solid var(--line);background:var(--panel);color:var(--text);border-radius:8px;padding:6px 12px;font-size:12px;font-family:inherit;cursor:pointer;transition:color .15s,border-color .15s,background .15s}.btn:hover:not(:disabled){border-color:var(--muted)}.btn:disabled{opacity:.45;cursor:not-allowed}.btn.approve{color:var(--good);border-color:color-mix(in srgb,var(--good) 40%,var(--line))}.btn.reject{color:var(--bad);border-color:color-mix(in srgb,var(--bad) 40%,var(--line))}.rowbtns{display:inline-flex;gap:6px;justify-content:flex-end}.table tr.clickable{cursor:pointer}.table tr.clickable:hover td{background:var(--panel-2)}.th-sort{appearance:none;background:none;border:none;padding:0;margin:0;font:inherit;color:inherit;text-transform:inherit;letter-spacing:inherit;cursor:pointer}.th-sort:hover{color:var(--text)}.warnnum{color:var(--warn)}.msg{border:1px solid var(--line);border-radius:10px;padding:10px 12px;background:var(--panel-2)}.msg-head{display:flex;align-items:center;justify-content:space-between;gap:8px;margin-bottom:6px}.msg-body{font-size:13px;white-space:pre-wrap;word-break:break-word}.empty{color:var(--muted);font-size:13px;text-align:center;padding:26px 10px}.err{color:var(--bad);font-size:13px;padding:20px 10px;text-align:center}.skeleton{border-radius:8px;background:linear-gradient(90deg,var(--line-soft),var(--line),var(--line-soft));background-size:200% 100%;animation:shimmer 1.3s ease-in-out infinite;height:14px}@keyframes shimmer{0%{background-position:200% 0}to{background-position:-200% 0}}.stack{display:flex;flex-direction:column;gap:16px}.muted{color:var(--muted)}.right{text-align:right}.chart-svg{width:100%;height:auto;display:block}.foot{margin-top:26px;font-size:11px;color:var(--muted);text-align:center}