@adonis-agora/telescope 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Davi Carvalho
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,26 @@
+# `@adonis-agora/telescope`
+
+Laravel Telescope-style **headless** observability for AdonisJS — records every
+HTTP request and every `agora:<lib>:<event>` diagnostics publish as a queryable
+entry.
+
+```sh
+npm i @adonis-agora/telescope
+node ace configure @adonis-agora/telescope
+```
+
+```ts
+import { TelescopeService } from '@adonis-agora/telescope'
+
+const telescope = await app.container.make(TelescopeService)
+telescope.list({ type: 'request', limit: 50 })
+telescope.byTrace('abc123')
+telescope.topFamilies(10, 'diagnostic')
+```
+
+See the [repo README](../../README.md) and [`DESIGN.md`](../../DESIGN.md) for the
+full contract, the cross-repo decoupling design, and the deferred roadmap.
+
+## License
+
+MIT © Davi Carvalho

package/dist/configure.d.ts

@@ -0,0 +1,16 @@
+import type Configure from '@adonisjs/core/commands/configure';
+/**
+ * `node ace configure @adonis-agora/telescope` — auto-wires the package:
+ *
+ * 1. registers the core service provider in `adonisrc.ts`;
+ * 2. registers {@link TelescopeMiddleware} on the `server` middleware stack;
+ * 3. publishes `config/telescope.ts` and the `lucid` store migration (so switching
+ *    `store: 'lucid'` only needs `node ace migration:run`; the `memory` default
+ *    ignores it);
+ * 4. offers the optional features (watchers / ui / ai / alerts) — each is a subpath
+ *    of this same package. The selected ones get their provider registered in
+ *    `adonisrc.ts` (`@adonis-agora/telescope/<feature>_provider`) and their config stub
+ *    published, folding in what used to be each sub-package's own `configure`.
+ */
+export declare function configure(command: Configure): Promise<void>;
+//# sourceMappingURL=configure.d.ts.map

package/dist/configure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,mCAAmC,CAAC;AAoC/D;;;;;;;;;;;;GAYG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,SAAS,iBAwCjD"}

package/dist/configure.js

@@ -0,0 +1,75 @@
+import { stubsRoot } from './stubs/main.js';
+/**
+ * The opt-in features of `@adonis-agora/telescope`, each shipped as a subpath of this one
+ * package. `configure` always wires the core; these are offered on top.
+ */
+const FEATURES = [
+    {
+        name: 'watchers',
+        message: 'Watchers — record Lucid queries, mail, cache, outbound HTTP and logs',
+        provider: '@adonis-agora/telescope/watchers_provider',
+        configStub: 'config/telescope_watchers.stub',
+    },
+    {
+        name: 'ui',
+        message: 'UI — web dashboard + JSON API at /telescope',
+        provider: '@adonis-agora/telescope/ui_provider',
+        configStub: 'config/telescope_ui.stub',
+    },
+    {
+        name: 'ai',
+        message: 'AI — Claude-powered exception diagnosis',
+        provider: '@adonis-agora/telescope/ai_provider',
+        configStub: 'config/telescope_ai.stub',
+    },
+    {
+        name: 'alerts',
+        message: 'Alerts — notify Slack / webhook on new exception families',
+        provider: '@adonis-agora/telescope/alerts_provider',
+        configStub: 'config/telescope_alerts.stub',
+    },
+];
+/**
+ * `node ace configure @adonis-agora/telescope` — auto-wires the package:
+ *
+ * 1. registers the core service provider in `adonisrc.ts`;
+ * 2. registers {@link TelescopeMiddleware} on the `server` middleware stack;
+ * 3. publishes `config/telescope.ts` and the `lucid` store migration (so switching
+ *    `store: 'lucid'` only needs `node ace migration:run`; the `memory` default
+ *    ignores it);
+ * 4. offers the optional features (watchers / ui / ai / alerts) — each is a subpath
+ *    of this same package. The selected ones get their provider registered in
+ *    `adonisrc.ts` (`@adonis-agora/telescope/<feature>_provider`) and their config stub
+ *    published, folding in what used to be each sub-package's own `configure`.
+ */
+export async function configure(command) {
+    const codemods = await command.createCodemods();
+    // — core —
+    await codemods.updateRcFile((rcFile) => {
+        rcFile.addProvider('@adonis-agora/telescope/telescope_provider');
+    });
+    await codemods.registerMiddleware('server', [
+        { path: '@adonis-agora/telescope/telescope_middleware' },
+    ]);
+    await codemods.makeUsingStub(stubsRoot, 'config/telescope.stub', {});
+    await codemods.makeUsingStub(stubsRoot, 'database/migrations/create_telescope_entries_table.stub', {});
+    // — optional features (subpaths of this same package) —
+    let selected;
+    try {
+        selected = await command.prompt.multiple('Select the optional telescope features to enable', FEATURES.map((feature) => ({ name: feature.name, message: feature.message })));
+    }
+    catch {
+        // Non-interactive runs (CI / --no-interactive) get the core only; features can be
+        // enabled later by re-running configure or wiring the providers by hand.
+        selected = [];
+    }
+    for (const feature of FEATURES) {
+        if (!selected.includes(feature.name))
+            continue;
+        await codemods.updateRcFile((rcFile) => {
+            rcFile.addProvider(feature.provider);
+        });
+        await codemods.makeUsingStub(stubsRoot, feature.configStub, {});
+    }
+}
+//# sourceMappingURL=configure.js.map

package/dist/configure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure.js","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;GAGG;AACH,MAAM,QAAQ,GAAG;IACf;QACE,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,sEAAsE;QAC/E,QAAQ,EAAE,2CAA2C;QACrD,UAAU,EAAE,gCAAgC;KAC7C;IACD;QACE,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,6CAA6C;QACtD,QAAQ,EAAE,qCAAqC;QAC/C,UAAU,EAAE,0BAA0B;KACvC;IACD;QACE,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,yCAAyC;QAClD,QAAQ,EAAE,qCAAqC;QAC/C,UAAU,EAAE,0BAA0B;KACvC;IACD;QACE,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,2DAA2D;QACpE,QAAQ,EAAE,yCAAyC;QACnD,UAAU,EAAE,8BAA8B;KAC3C;CACO,CAAC;AAIX;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAkB;IAChD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC;IAEhD,WAAW;IACX,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE;QACrC,MAAM,CAAC,WAAW,CAAC,4CAA4C,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,CAAC,kBAAkB,CAAC,QAAQ,EAAE;QAC1C,EAAE,IAAI,EAAE,8CAA8C,EAAE;KACzD,CAAC,CAAC;IAEH,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,uBAAuB,EAAE,EAAE,CAAC,CAAC;IACrE,MAAM,QAAQ,CAAC,aAAa,CAC1B,SAAS,EACT,yDAAyD,EACzD,EAAE,CACH,CAAC;IAEF,wDAAwD;IACxD,IAAI,QAAuB,CAAC;IAC5B,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,QAAQ,CACtC,kDAAkD,EAClD,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAC9E,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,kFAAkF;QAClF,yEAAyE;QACzE,QAAQ,GAAG,EAAE,CAAC;IAChB,CAAC;IAED,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,SAAS;QAE/C,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE;YACrC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QACH,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAClE,CAAC;AACH,CAAC"}

package/dist/providers/telescope_ai_provider.d.ts

@@ -0,0 +1,20 @@
+import type { ApplicationService } from '@adonisjs/core/types';
+/**
+ * Wires `@adonis-agora/telescope/ai` into the AdonisJS application.
+ *
+ * - `register()` reads `config/telescope_ai.ts` (falling back to an `ai_config`
+ *   key on `config/telescope.ts`), constructs a {@link TelescopeAiDiagnoser}
+ *   backed by the Anthropic Claude API, and binds it into the container so
+ *   controllers / the dashboard can `inject()` it. When AI is disabled or no API
+ *   key resolved, a disabled diagnoser is bound (its `diagnose` is a no-op
+ *   returning `null`), so consumers can inject unconditionally.
+ *
+ * Diagnosis never throws into the app: a model or parse failure resolves to `null`.
+ */
+export default class TelescopeAiProvider {
+    protected app: ApplicationService;
+    constructor(app: ApplicationService);
+    private resolve;
+    register(): void;
+}
+//# sourceMappingURL=telescope_ai_provider.d.ts.map

package/dist/providers/telescope_ai_provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telescope_ai_provider.d.ts","sourceRoot":"","sources":["../../providers/telescope_ai_provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAK/D;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,OAAO,mBAAmB;IAC1B,SAAS,CAAC,GAAG,EAAE,kBAAkB;gBAAvB,GAAG,EAAE,kBAAkB;IAE7C,OAAO,CAAC,OAAO;IAWf,QAAQ;CAeT"}

package/dist/providers/telescope_ai_provider.js

@@ -0,0 +1,45 @@
+import { resolveConfig } from '../src/ai/define_config.js';
+import { createDiagnoser } from '../src/ai/factory.js';
+import { TelescopeAiDiagnoser } from '../src/ai/telescope_ai_diagnoser.js';
+/**
+ * Wires `@adonis-agora/telescope/ai` into the AdonisJS application.
+ *
+ * - `register()` reads `config/telescope_ai.ts` (falling back to an `ai_config`
+ *   key on `config/telescope.ts`), constructs a {@link TelescopeAiDiagnoser}
+ *   backed by the Anthropic Claude API, and binds it into the container so
+ *   controllers / the dashboard can `inject()` it. When AI is disabled or no API
+ *   key resolved, a disabled diagnoser is bound (its `diagnose` is a no-op
+ *   returning `null`), so consumers can inject unconditionally.
+ *
+ * Diagnosis never throws into the app: a model or parse failure resolves to `null`.
+ */
+export default class TelescopeAiProvider {
+    app;
+    constructor(app) {
+        this.app = app;
+    }
+    resolve() {
+        const own = this.app.config.get('telescope_ai', undefined);
+        if (own !== undefined)
+            return resolveConfig(own);
+        const fromTelescope = this.app.config.get('telescope.ai_config', undefined);
+        return resolveConfig(fromTelescope);
+    }
+    register() {
+        const config = this.resolve();
+        this.app.container.singleton(TelescopeAiDiagnoser, () => {
+            const diagnoser = createDiagnoser(config);
+            if (diagnoser !== null)
+                return diagnoser;
+            // No key / disabled: bind a diagnoser whose `diagnose` is a no-op so
+            // consumers can `inject(TelescopeAiDiagnoser)` without a null check.
+            return new TelescopeAiDiagnoser({
+                client: { messages: { create: () => Promise.reject(new Error('disabled')) } },
+                model: config.model,
+                maxTokens: config.maxTokens,
+                enabled: false,
+            });
+        });
+    }
+}
+//# sourceMappingURL=telescope_ai_provider.js.map

package/dist/providers/telescope_ai_provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telescope_ai_provider.js","sourceRoot":"","sources":["../../providers/telescope_ai_provider.ts"],"names":[],"mappings":"AACA,OAAO,EAA0B,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAE3E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,OAAO,mBAAmB;IAChB;IAAtB,YAAsB,GAAuB;QAAvB,QAAG,GAAH,GAAG,CAAoB;IAAG,CAAC;IAEzC,OAAO;QACb,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAgC,cAAc,EAAE,SAAS,CAAC,CAAC;QAC1F,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;QAEjD,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CACvC,qBAAqB,EACrB,SAAS,CACV,CAAC;QACF,OAAO,aAAa,CAAC,aAAa,CAAC,CAAC;IACtC,CAAC;IAED,QAAQ;QACN,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,oBAAoB,EAAE,GAAG,EAAE;YACtD,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;YAC1C,IAAI,SAAS,KAAK,IAAI;gBAAE,OAAO,SAAS,CAAC;YACzC,qEAAqE;YACrE,qEAAqE;YACrE,OAAO,IAAI,oBAAoB,CAAC;gBAC9B,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE;gBAC7E,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,OAAO,EAAE,KAAK;aACf,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/providers/telescope_alerts_provider.d.ts

@@ -0,0 +1,23 @@
+import type { ApplicationService } from '@adonisjs/core/types';
+/**
+ * Wires `@adonis-agora/telescope/alerts` into the AdonisJS application.
+ *
+ * - `boot()` reads `config/telescope_alerts.ts` (falling back to an
+ *   `alerts_config` key on `config/telescope.ts`), resolves the live telescope
+ *   store from the core's runtime slot (no DI — same handle the watchers record
+ *   through), and starts an {@link ExceptionPoller} that feeds new exception
+ *   entries to an {@link Alerter}.
+ * - `shutdown()` stops the poller.
+ *
+ * Alerting never throws into the app: a disabled config, a missing store, or a
+ * failing channel all degrade to doing nothing (failures are warn-logged).
+ */
+export default class TelescopeAlertsProvider {
+    protected app: ApplicationService;
+    private poller;
+    constructor(app: ApplicationService);
+    private resolve;
+    boot(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=telescope_alerts_provider.d.ts.map

package/dist/providers/telescope_alerts_provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telescope_alerts_provider.d.ts","sourceRoot":"","sources":["../../providers/telescope_alerts_provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAO/D;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,OAAO,uBAAuB;IAG9B,SAAS,CAAC,GAAG,EAAE,kBAAkB;IAF7C,OAAO,CAAC,MAAM,CAAgC;gBAExB,GAAG,EAAE,kBAAkB;IAE7C,OAAO,CAAC,OAAO;IAcT,IAAI;IA6BJ,QAAQ;CAQf"}

package/dist/providers/telescope_alerts_provider.js

@@ -0,0 +1,72 @@
+import { Alerter } from '../src/alerts/alerter.js';
+import { resolveConfig } from '../src/alerts/define_config.js';
+import { ExceptionPoller } from '../src/alerts/exception_source.js';
+import { getTelescopeRuntime } from '../src/registry.js';
+/**
+ * Wires `@adonis-agora/telescope/alerts` into the AdonisJS application.
+ *
+ * - `boot()` reads `config/telescope_alerts.ts` (falling back to an
+ *   `alerts_config` key on `config/telescope.ts`), resolves the live telescope
+ *   store from the core's runtime slot (no DI — same handle the watchers record
+ *   through), and starts an {@link ExceptionPoller} that feeds new exception
+ *   entries to an {@link Alerter}.
+ * - `shutdown()` stops the poller.
+ *
+ * Alerting never throws into the app: a disabled config, a missing store, or a
+ * failing channel all degrade to doing nothing (failures are warn-logged).
+ */
+export default class TelescopeAlertsProvider {
+    app;
+    poller = null;
+    constructor(app) {
+        this.app = app;
+    }
+    resolve() {
+        const own = this.app.config.get('telescope_alerts', undefined);
+        if (own !== undefined)
+            return resolveConfig(own);
+        const fromTelescope = this.app.config.get('telescope.alerts_config', undefined);
+        return resolveConfig(fromTelescope);
+    }
+    async boot() {
+        const config = this.resolve();
+        if (!config.enabled)
+            return;
+        let store;
+        try {
+            store = getTelescopeRuntime().store;
+        }
+        catch (err) {
+            console.error(`TelescopeAlertsProvider: could not resolve the telescope store: ${asMessage(err)}`);
+            return;
+        }
+        if (store === null)
+            return;
+        const alerter = new Alerter({ alerts: config });
+        this.poller = new ExceptionPoller({
+            store,
+            alerter,
+            intervalMs: config.intervalMs,
+        });
+        try {
+            this.poller.start();
+        }
+        catch (err) {
+            console.error(`TelescopeAlertsProvider: failed to start the alert poller: ${asMessage(err)}`);
+            this.poller = null;
+        }
+    }
+    async shutdown() {
+        try {
+            this.poller?.stop();
+        }
+        catch {
+            // never throw out of shutdown
+        }
+        this.poller = null;
+    }
+}
+function asMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=telescope_alerts_provider.js.map

package/dist/providers/telescope_alerts_provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telescope_alerts_provider.js","sourceRoot":"","sources":["../../providers/telescope_alerts_provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAA8B,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,OAAO,uBAAuB;IAGpB;IAFd,MAAM,GAA2B,IAAI,CAAC;IAE9C,YAAsB,GAAuB;QAAvB,QAAG,GAAH,GAAG,CAAoB;IAAG,CAAC;IAEzC,OAAO;QACb,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAC7B,kBAAkB,EAClB,SAAS,CACV,CAAC;QACF,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;QAEjD,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CACvC,yBAAyB,EACzB,SAAS,CACV,CAAC;QACF,OAAO,aAAa,CAAC,aAAa,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO;QAE5B,IAAI,KAA4B,CAAC;QACjC,IAAI,CAAC;YACH,KAAK,GAAG,mBAAmB,EAAE,CAAC,KAAK,CAAC;QACtC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CACX,mEAAmE,SAAS,CAAC,GAAG,CAAC,EAAE,CACpF,CAAC;YACF,OAAO;QACT,CAAC;QACD,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO;QAE3B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC;YAChC,KAAK;YACL,OAAO;YACP,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC,CAAC;QACH,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,8DAA8D,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9F,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACrB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;QAChC,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;CACF;AAED,SAAS,SAAS,CAAC,GAAY;IAC7B,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC"}

package/dist/providers/telescope_provider.d.ts

@@ -0,0 +1,43 @@
+import type { ApplicationService } from '@adonisjs/core/types';
+/**
+ * Wires `@adonis-agora/telescope` into the AdonisJS application.
+ *
+ * - `register()` binds {@link TelescopeService} into the container, resolving against
+ *   whichever store the provider builds at boot, so controllers can `inject()` it.
+ * - `boot()` reads `config/telescope.ts`, builds the configured store (a key of
+ *   `config.stores`, the `'memory'` shorthand, or a supplied instance), publishes it on
+ *   the global runtime slot (so the request middleware can reach it without DI), and
+ *   starts the {@link DiagnosticsWatcher} when the `diagnostics` watcher is enabled.
+ *   Building the store is async because a driver lazily imports its peer dependency
+ *   (`@adonisjs/lucid` for `lucid`) only when it is the selected one.
+ * - `shutdown()` stops the watcher and clears the runtime slot.
+ *
+ * The request watcher itself runs as `server` middleware, which
+ * `node ace configure @adonis-agora/telescope` registers on the `server` stack.
+ */
+export default class TelescopeProvider {
+    protected app: ApplicationService;
+    private store;
+    private diagnosticsWatcher;
+    constructor(app: ApplicationService);
+    register(): void;
+    boot(): Promise<void>;
+    /**
+     * Build the active store from config. A supplied {@link TelescopeStore} instance is used
+     * as-is; otherwise `config.store` names a driver in `config.stores`, built via its lazy
+     * thunk. The bare `'memory'` shorthand (no matching driver) falls back to the built-in
+     * ring buffer so `node ace configure`'s zero-config default just works.
+     */
+    private buildStore;
+    /**
+     * Wrap the built store with the CENTRAL redaction decorator so every entry's
+     * content is scrubbed before persistence — the single choke point every watcher
+     * records through (see {@link RedactingTelescopeStore}). Skipped only when
+     * `config.redact.enabled` is `false`.
+     */
+    private applyRedaction;
+    /** Construct the extension registry, giving each extension a context over the store + container. */
+    private buildExtensionRegistry;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=telescope_provider.d.ts.map

package/dist/providers/telescope_provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telescope_provider.d.ts","sourceRoot":"","sources":["../../providers/telescope_provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAmB/D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAiB;IAIxB,SAAS,CAAC,GAAG,EAAE,kBAAkB;IAH7C,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,kBAAkB,CAAmC;gBAEvC,GAAG,EAAE,kBAAkB;IAE7C,QAAQ;IAUF,IAAI;IAuBV;;;;;OAKG;YACW,UAAU;IAexB;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAKtB,oGAAoG;IACpG,OAAO,CAAC,sBAAsB;IAaxB,QAAQ;CAKf"}

package/dist/providers/telescope_provider.js

@@ -0,0 +1,103 @@
+import { resolveConfig, } from '../src/define_config.js';
+import { DiagnosticsWatcher } from '../src/diagnostics_watcher.js';
+import { ExtensionRegistry } from '../src/extension/registry.js';
+import { RedactingTelescopeStore } from '../src/redaction/redacting_store.js';
+import { resetTelescopeRuntime, setTelescopeExtensionRegistry, setTelescopeRuntime, } from '../src/registry.js';
+import { TelescopeService } from '../src/service.js';
+import { InMemoryTelescopeStore } from '../src/stores/memory.js';
+/**
+ * Wires `@adonis-agora/telescope` into the AdonisJS application.
+ *
+ * - `register()` binds {@link TelescopeService} into the container, resolving against
+ *   whichever store the provider builds at boot, so controllers can `inject()` it.
+ * - `boot()` reads `config/telescope.ts`, builds the configured store (a key of
+ *   `config.stores`, the `'memory'` shorthand, or a supplied instance), publishes it on
+ *   the global runtime slot (so the request middleware can reach it without DI), and
+ *   starts the {@link DiagnosticsWatcher} when the `diagnostics` watcher is enabled.
+ *   Building the store is async because a driver lazily imports its peer dependency
+ *   (`@adonisjs/lucid` for `lucid`) only when it is the selected one.
+ * - `shutdown()` stops the watcher and clears the runtime slot.
+ *
+ * The request watcher itself runs as `server` middleware, which
+ * `node ace configure @adonis-agora/telescope` registers on the `server` stack.
+ */
+export default class TelescopeProvider {
+    app;
+    store = null;
+    diagnosticsWatcher = null;
+    constructor(app) {
+        this.app = app;
+    }
+    register() {
+        // The store is built asynchronously at boot (a driver may lazily import its peer
+        // dep). Bind the service to resolve against the active store; `boot()` runs before
+        // any request, so the store is always set by the time a controller resolves it.
+        this.app.container.singleton(TelescopeService, () => {
+            const store = this.store ?? new InMemoryTelescopeStore();
+            return new TelescopeService(store);
+        });
+    }
+    async boot() {
+        const config = resolveConfig(this.app.config.get('telescope', {}));
+        const store = this.applyRedaction(await this.buildStore(config), config);
+        this.store = store;
+        if (!config.enabled) {
+            resetTelescopeRuntime();
+            return;
+        }
+        setTelescopeRuntime(store, config.watchers.has('request'));
+        if (config.watchers.has('diagnostics')) {
+            const watcher = new DiagnosticsWatcher(store);
+            watcher.start();
+            this.diagnosticsWatcher = watcher;
+        }
+        // Build the extension registry from `config.extensions` and publish it so the UI can serve each
+        // extension's dashboards + data providers. A collision (duplicate id/name) throws here, at boot.
+        setTelescopeExtensionRegistry(this.buildExtensionRegistry(config, store));
+    }
+    /**
+     * Build the active store from config. A supplied {@link TelescopeStore} instance is used
+     * as-is; otherwise `config.store` names a driver in `config.stores`, built via its lazy
+     * thunk. The bare `'memory'` shorthand (no matching driver) falls back to the built-in
+     * ring buffer so `node ace configure`'s zero-config default just works.
+     */
+    async buildStore(config) {
+        if (typeof config.store !== 'string')
+            return config.store;
+        const provider = config.stores[config.store];
+        if (provider)
+            return provider({ app: this.app });
+        if (config.store === 'memory') {
+            return new InMemoryTelescopeStore({ maxEntries: config.maxEntries });
+        }
+        throw new Error(`@adonis-agora/telescope: config.store is "${config.store}", but config.stores.${config.store} is not defined`);
+    }
+    /**
+     * Wrap the built store with the CENTRAL redaction decorator so every entry's
+     * content is scrubbed before persistence — the single choke point every watcher
+     * records through (see {@link RedactingTelescopeStore}). Skipped only when
+     * `config.redact.enabled` is `false`.
+     */
+    applyRedaction(store, config) {
+        if (!config.redact.enabled)
+            return store;
+        return new RedactingTelescopeStore(store, { keys: config.redact.keys });
+    }
+    /** Construct the extension registry, giving each extension a context over the store + container. */
+    buildExtensionRegistry(config, store) {
+        if (config.extensions.length === 0)
+            return null;
+        const ctx = {
+            store,
+            container: { make: (token) => this.app.container.make(token) },
+            config,
+        };
+        return new ExtensionRegistry(config.extensions, ctx);
+    }
+    async shutdown() {
+        this.diagnosticsWatcher?.stop();
+        this.diagnosticsWatcher = null;
+        resetTelescopeRuntime();
+    }
+}
+//# sourceMappingURL=telescope_provider.js.map

package/dist/providers/telescope_provider.js.map

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

package/dist/providers/telescope_ui_provider.d.ts

@@ -0,0 +1,21 @@
+import type { ApplicationService } from '@adonisjs/core/types';
+/**
+ * Wires `@adonis-agora/telescope/ui` into the AdonisJS application.
+ *
+ * - `boot()` reads `config/telescope_ui.ts`, resolves the live telescope store
+ *   from the core runtime slot (no DI — same handle the watchers record through),
+ *   and registers routes under the configured prefix via the AdonisJS router:
+ *   the dashboard page at the prefix root and the JSON API under `<path>/api/*`.
+ *   Every route runs the configured `authorize` guard first.
+ *
+ * Failures degrade safely: a disabled config or a missing store registers no
+ * routes (warn-logged), so the dashboard simply does not exist rather than
+ * crashing the host.
+ */
+export default class TelescopeUiProvider {
+    protected app: ApplicationService;
+    constructor(app: ApplicationService);
+    private resolve;
+    boot(): Promise<void>;
+}
+//# sourceMappingURL=telescope_ui_provider.d.ts.map

package/dist/providers/telescope_ui_provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telescope_ui_provider.d.ts","sourceRoot":"","sources":["../../providers/telescope_ui_provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAiB/D;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,OAAO,mBAAmB;IAC1B,SAAS,CAAC,GAAG,EAAE,kBAAkB;gBAAvB,GAAG,EAAE,kBAAkB;IAE7C,OAAO,CAAC,OAAO;IAMT,IAAI;CA2FX"}

package/dist/providers/telescope_ui_provider.js

@@ -0,0 +1,119 @@
+import { resolveConfig as resolveTelescopeConfig } from '../src/define_config.js';
+import { getTelescopeRuntime } from '../src/registry.js';
+import { TelescopeService } from '../src/service.js';
+import { TelescopeApi } from '../src/ui/api.js';
+import { renderDashboard } from '../src/ui/dashboard.js';
+import { resolveConfig, } from '../src/ui/define_config.js';
+import { ExtensionApi } from '../src/ui/extension_api.js';
+import { enforceGuard } from '../src/ui/guard.js';
+/**
+ * Wires `@adonis-agora/telescope/ui` into the AdonisJS application.
+ *
+ * - `boot()` reads `config/telescope_ui.ts`, resolves the live telescope store
+ *   from the core runtime slot (no DI — same handle the watchers record through),
+ *   and registers routes under the configured prefix via the AdonisJS router:
+ *   the dashboard page at the prefix root and the JSON API under `<path>/api/*`.
+ *   Every route runs the configured `authorize` guard first.
+ *
+ * Failures degrade safely: a disabled config or a missing store registers no
+ * routes (warn-logged), so the dashboard simply does not exist rather than
+ * crashing the host.
+ */
+export default class TelescopeUiProvider {
+    app;
+    constructor(app) {
+        this.app = app;
+    }
+    resolve() {
+        return resolveConfig(this.app.config.get('telescope_ui', undefined));
+    }
+    async boot() {
+        const config = this.resolve();
+        if (!config.enabled)
+            return;
+        let store;
+        try {
+            store = getTelescopeRuntime().store;
+        }
+        catch (err) {
+            console.error(`TelescopeUiProvider: could not resolve the telescope store: ${asMessage(err)}`);
+            return;
+        }
+        if (store === null) {
+            console.warn('TelescopeUiProvider: telescope store is not booted (is @adonis-agora/telescope enabled?); ' +
+                'dashboard routes not registered.');
+            return;
+        }
+        const service = new TelescopeService(store);
+        const api = new TelescopeApi(service);
+        const apiBase = `${config.path}/api`;
+        const router = await this.app.container.make('router');
+        const guard = config.authorize;
+        // Dashboard page (HTML).
+        router
+            .get(config.path, async (ctx) => {
+            if (!(await enforceGuard(ctx, guard)))
+                return;
+            ctx.response.header('content-type', 'text/html; charset=utf-8');
+            return ctx.response.send(renderDashboard(apiBase));
+        })
+            .as('telescope_ui.dashboard');
+        // JSON API.
+        router
+            .get(`${apiBase}/entries`, async (ctx) => {
+            if (!(await enforceGuard(ctx, guard)))
+                return;
+            return api.list(ctx);
+        })
+            .as('telescope_ui.entries');
+        router
+            .get(`${apiBase}/entries/:id`, async (ctx) => {
+            if (!(await enforceGuard(ctx, guard)))
+                return;
+            return api.show(ctx, String(ctx.params.id));
+        })
+            .as('telescope_ui.entry');
+        router
+            .get(`${apiBase}/trace/:traceId`, async (ctx) => {
+            if (!(await enforceGuard(ctx, guard)))
+                return;
+            return api.trace(ctx, String(ctx.params.traceId));
+        })
+            .as('telescope_ui.trace');
+        router
+            .get(`${apiBase}/stats`, async (ctx) => {
+            if (!(await enforceGuard(ctx, guard)))
+                return;
+            return api.stats(ctx);
+        })
+            .as('telescope_ui.stats');
+        // Extension SDK surface (only when at least one extension contributed a registry at boot).
+        const registry = getTelescopeRuntime().registry;
+        if (registry) {
+            const extCtx = {
+                store,
+                container: { make: (token) => this.app.container.make(token) },
+                config: resolveTelescopeConfig(this.app.config.get('telescope', {})),
+            };
+            const extApi = new ExtensionApi(registry, extCtx);
+            router
+                .get(`${apiBase}/meta`, async (ctx) => {
+                if (!(await enforceGuard(ctx, guard)))
+                    return;
+                return extApi.meta(ctx);
+            })
+                .as('telescope_ui.meta');
+            router
+                .get(`${apiBase}/ext/:ext/data/:provider`, async (ctx) => {
+                if (!(await enforceGuard(ctx, guard)))
+                    return;
+                return extApi.data(ctx, String(ctx.params.ext), String(ctx.params.provider));
+            })
+                .as('telescope_ui.ext_data');
+        }
+    }
+}
+function asMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=telescope_ui_provider.js.map

package/dist/providers/telescope_ui_provider.js.map

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