@adonis-agora/telescope 0.8.0 → 0.8.1

package/CHANGELOG.md

@@ -1,5 +1,45 @@
 # @adonis-agora/telescope
 
+## 0.8.1
+
+### Patch Changes
+
+- [#23](https://github.com/DavideCarvalho/adonis-agora-telescope/pull/23) [`7335b3f`](https://github.com/DavideCarvalho/adonis-agora-telescope/commit/7335b3f4ffe1c885b63c1f909e9d5f2af2e94679) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - Publish a Node.js engine RANGE instead of one exact version. Both packages declared
+  `engines.node: "v26.7.0"` — a single pinned build, written by a renovate "pin dependencies" run
+  that treated a compatibility range as a version to pin. Every install
+  on any other Node emitted an engine warning, and an `engine-strict` install failed outright. Both
+  now declare `>=20.6.0`, the version the code actually requires, and renovate is configured to
+  leave `engines` alone so the fix survives the next cycle.
+
+- [#23](https://github.com/DavideCarvalho/adonis-agora-telescope/pull/23) [`7335b3f`](https://github.com/DavideCarvalho/adonis-agora-telescope/commit/7335b3f4ffe1c885b63c1f909e9d5f2af2e94679) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - Make the `logs` watcher safe to enable from both config files.
+
+  `watchers: ['logs']` can be set in `config/telescope.ts` (where it also accepts a `logs`
+  options block) and in `config/telescope_watchers.ts`. With both set, the second watcher to
+  boot silently did nothing — and then unteed the FIRST watcher's tap on shutdown, so the
+  logger was left half-instrumented. It now detects that the logger is already tapped, warns
+  once naming both config keys, and stays fully inert: it records nothing and its `stop()`
+  restores only what it teed itself.
+
+- [#23](https://github.com/DavideCarvalho/adonis-agora-telescope/pull/23) [`7335b3f`](https://github.com/DavideCarvalho/adonis-agora-telescope/commit/7335b3f4ffe1c885b63c1f909e9d5f2af2e94679) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - Report the real package version over MCP. The `initialize` handshake advertised a hardcoded
+  `0.4.0` regardless of the installed version; it now reads the package's own `VERSION`, which
+  the release pipeline keeps in lockstep with `package.json`.
+
+- [#23](https://github.com/DavideCarvalho/adonis-agora-telescope/pull/23) [`7335b3f`](https://github.com/DavideCarvalho/adonis-agora-telescope/commit/7335b3f4ffe1c885b63c1f909e9d5f2af2e94679) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - Restore the seven `config/*.stub` files, which shipped empty.
+
+  Every config stub the package publishes — `telescope.stub`, `telescope_watchers.stub`,
+  `telescope_ui.stub`, `telescope_ai.stub`, `telescope_alerts.stub`, `telescope_mcp.stub` and
+  `telescope_cpu_profiling.stub` — was a zero-byte file in the published tarball, so
+  `node ace add @adonis-agora/telescope` wrote an EMPTY `config/telescope.ts` (and an empty file
+  for each feature you selected) into your app. Only the migration stub had content.
+
+  The stubs are rebuilt from the current config surface, including everything that landed since
+  they were lost: the `logs` watcher and its `logs` block, `diagnostics.exclude` /
+  `diagnostics.recordClaimed`, `requestCapture`, `redact.perType`, `sampling`, `nPlusOne`, `pulse`,
+  `clientErrors`, `dashboardAuth`, `cpuProfiling.armEnabled`, `queueActions`, `queueManager`, the
+  `every-exception` and `metric-threshold` alert rules, `alerts.geoLookup`, and the whole
+  `telescope_cpu_profiling` config. A test now fails the build if any shipped stub is empty, lacks
+  its `exports(...)` header, or carries a backtick in its body — the defect that emptied them.
+
 ## 0.8.0
 
 ### Minor Changes

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

@@ -1 +1 @@
-{"version":3,"file":"telescope_mcp_provider.d.ts","sourceRoot":"","sources":["../../providers/telescope_mcp_provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAkB/D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,OAAO,OAAO,oBAAoB;IAC3B,SAAS,CAAC,GAAG,EAAE,kBAAkB;gBAAvB,GAAG,EAAE,kBAAkB;IAE7C,OAAO,CAAC,OAAO;IAMT,IAAI;CAqFX"}
+{"version":3,"file":"telescope_mcp_provider.d.ts","sourceRoot":"","sources":["../../providers/telescope_mcp_provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAmB/D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,OAAO,OAAO,oBAAoB;IAC3B,SAAS,CAAC,GAAG,EAAE,kBAAkB;gBAAvB,GAAG,EAAE,kBAAkB;IAE7C,OAAO,CAAC,OAAO;IAMT,IAAI;CAwFX"}

package/dist/providers/telescope_mcp_provider.js

@@ -1,5 +1,6 @@
 import { resolveConfig as resolveTelescopeConfig } from '../src/define_config.js';
 import { resolveConfig, } from '../src/mcp/define_config.js';
+import { VERSION } from '../src/mcp/index.js';
 import { TelescopeMcpServer } from '../src/mcp/server.js';
 import { MetricsService } from '../src/metrics/metrics_service.js';
 import { getTelescopeRuntime } from '../src/registry.js';
@@ -75,7 +76,10 @@ export default class TelescopeMcpProvider {
             : undefined;
         const server = new TelescopeMcpServer(service, metrics, {
             tools: config.tools,
-            serverInfo: { name: 'adonis-telescope', version: '0.4.0' },
+            // Reported to the MCP client on `initialize`. Sourced from the package's own
+            // VERSION const (kept in lockstep with package.json by `scripts/sync-version.mjs`)
+            // so a release bump can never leave a stale version on the wire.
+            serverInfo: { name: 'adonis-telescope', version: VERSION },
             ...(diagnose !== undefined ? { diagnose } : {}),
         });
         const router = await this.app.container.make('router');

package/dist/providers/telescope_mcp_provider.js.map

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

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

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export declare const VERSION = "0.8.0";
+export declare const VERSION = "0.8.1";
 export { TelescopeAiDiagnoser } from './telescope_ai_diagnoser.js';
 export type { AnthropicMessagesClient, DiagnoseOptions, TelescopeAiDiagnoserOptions, } from './telescope_ai_diagnoser.js';
 export { normalizeConfidence, parseDiagnosis } from './diagnoser.js';

package/dist/src/ai/index.js

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export const VERSION = '0.8.0';
+export const VERSION = '0.8.1';
 // — diagnoser —
 export { TelescopeAiDiagnoser } from './telescope_ai_diagnoser.js';
 // — diagnosis model + parsing —

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

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export declare const VERSION = "0.8.0";
+export declare const VERSION = "0.8.1";
 export { consoleChannel, customChannel, slackChannel, webhookChannel, } from './alert_channel.js';
 export type { AlertChannel, ChannelFetch, ConsoleSink } from './alert_channel.js';
 export { formatSlackMessage } from './slack_format.js';

package/dist/src/alerts/index.js

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export const VERSION = '0.8.0';
+export const VERSION = '0.8.1';
 // — channels —
 export { consoleChannel, customChannel, slackChannel, webhookChannel, } from './alert_channel.js';
 // — slack formatting —

package/dist/src/index.d.ts

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export declare const VERSION = "0.8.0";
+export declare const VERSION = "0.8.1";
 export { EntryType, isBatchOrigin } from './entry.js';
 export type { BatchOrigin, BuiltinEntryType, Entry, RecordInput } from './entry.js';
 export type { EntryQuery, TelescopeStore } from './store.js';

package/dist/src/index.js

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export const VERSION = '0.8.0';
+export const VERSION = '0.8.1';
 // — entry model —
 export { EntryType, isBatchOrigin } from './entry.js';
 export { InMemoryTelescopeStore } from './stores/memory.js';

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

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export declare const VERSION = "0.8.0";
+export declare const VERSION = "0.8.1";
 export { defineConfig, resolveConfig, MCP_TOOL_NAMES } from './define_config.js';
 export type { McpToolName, ResolvedTelescopeMcpConfig, TelescopeMcpConfig, } from './define_config.js';
 export { MCP_INTERNAL_ERROR, MCP_METHOD_NOT_FOUND, MCP_TOOLS, MCP_UNAUTHORIZED, TelescopeMcpServer, } from './server.js';

package/dist/src/mcp/index.js

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export const VERSION = '0.8.0';
+export const VERSION = '0.8.1';
 // — config —
 export { defineConfig, resolveConfig, MCP_TOOL_NAMES } from './define_config.js';
 // — server (plain, testable JSON-RPC surface) —

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

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export declare const VERSION = "0.8.0";
+export declare const VERSION = "0.8.1";
 export { defineConfig, resolveConfig } from './define_config.js';
 export type { ResolvedTelescopeCpuProfilingConfig, TelescopeCpuProfilingConfig, } from './define_config.js';
 export { CPU_PROFILE_ENTRY_TYPE, ProfilerService, } from './profiler_service.js';

package/dist/src/profiling/index.js

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export const VERSION = '0.8.0';
+export const VERSION = '0.8.1';
 export { defineConfig, resolveConfig } from './define_config.js';
 export { CPU_PROFILE_ENTRY_TYPE, ProfilerService, } from './profiler_service.js';
 export { CpuProfiler, defaultSessionFactory } from './cpu-profiler.js';

package/dist/src/ui/define_config.d.ts

@@ -99,7 +99,7 @@ export interface ReplayConfig {
     enabled?: boolean;
     /**
      * The local server port the replay targets (`127.0.0.1:<port>`). When omitted,
-     * the `PORT` env var is used, falling back to 3000.
+     * the `PORT` env var is used, falling back to 3333 (the AdonisJS default).
      */
     port?: number;
     /** Per-call timeout in ms. Default 30000. */

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

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export declare const VERSION = "0.8.0";
+export declare const VERSION = "0.8.1";
 export { defineConfig, resolveConfig, normalizePath, defaultAuthorize } from './define_config.js';
 export type { AuthorizeHook, ReplayConfig, ResolvedTelescopeUiConfig, TelescopeUiConfig, UiCredentials, } from './define_config.js';
 export { resolveDashboardAuth, performLogin, readSession, sanitizeReturnTo, decideDashboardAuth, SESSION_COOKIE_NAME, } from './auth.js';

package/dist/src/ui/index.js

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export const VERSION = '0.8.0';
+export const VERSION = '0.8.1';
 // — config —
 export { defineConfig, resolveConfig, normalizePath, defaultAuthorize } from './define_config.js';
 // — built-in `dashboardAuth` login screen (optional; opt-in via `config/telescope_ui.ts`) —

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

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export declare const VERSION = "0.8.0";
+export declare const VERSION = "0.8.1";
 export type { EmitterLike, Watcher } from './emitter.js';
 export { resolveStore, safeRecord } from './record.js';
 export { buildQueryEntry, DB_QUERY_EVENT, LucidQueryWatcher } from './lucid_query_watcher.js';

package/dist/src/watchers/index.js

@@ -1,5 +1,5 @@
 /** Keep in sync with this package's `version` in package.json. */
-export const VERSION = '0.8.0';
+export const VERSION = '0.8.1';
 // — runtime recording (advanced) —
 export { resolveStore, safeRecord } from './record.js';
 // — Lucid query watcher (the headline watcher) —

package/dist/src/watchers/logs_watcher.d.ts

@@ -57,10 +57,26 @@ export declare class LogsWatcher {
     private readonly minLevelIndex;
     private readonly extraTags;
     private logger;
+    /** The levels THIS instance teed, so `stop()` never unwinds another watcher's tap. */
+    private readonly teedLevels;
     constructor(options?: LogsWatcherOptions);
-    /** Tee the level methods on `logger`. Idempotent per instance. */
+    /**
+     * Tee the level methods on `logger`. Idempotent per instance AND per logger: a
+     * level already teed (by this watcher or another one) is left alone, so a logger
+     * is never wrapped twice and a line is never recorded twice.
+     *
+     * The `'logs'` watcher can be enabled from TWO places — `config/telescope.ts`
+     * (with `logs.minLevel` / `logs.tags`) and `config/telescope_watchers.ts` (with no
+     * options). Only the first one to boot owns the tap; the second finds the logger
+     * already teed, warns once naming both config keys, and becomes inert — including
+     * its `stop()`, which would otherwise untee the owner's tap on shutdown.
+     */
     start(logger: LoggerLike): void;
-    /** Restore the original level methods on the tapped instance. */
+    /**
+     * Restore the level methods THIS watcher teed. A watcher that never took the tap
+     * (because another one already held it) restores nothing, so shutting it down
+     * leaves the owner's tap intact.
+     */
     stop(): void;
     /** Build + record a log entry from the level method's arguments. */
     private record;

package/dist/src/watchers/logs_watcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logs_watcher.d.ts","sourceRoot":"","sources":["../../../src/watchers/logs_watcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1D,iFAAiF;AACjF,eAAO,MAAM,UAAU,+DAAgE,CAAC;AACxF,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD;;2CAE2C;AAC3C,KAAK,SAAS,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG;KACtB,KAAK,IAAI,QAAQ,CAAC,CAAC,EAAE,SAAS;CAChC,CAAC;AAEF,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,KAAK,EAAE,QAAQ,CAAC;IAChB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,kDAAkD;IAClD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,uDAAuD;IACvD,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAkBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,IAAI,QAAiB;IAC9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,MAAM,CAA2B;gBAE7B,OAAO,GAAE,kBAAuB;IAK5C,kEAAkE;IAClE,KAAK,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAgC/B,iEAAiE;IACjE,IAAI,IAAI,IAAI;IAYZ,oEAAoE;IACpE,OAAO,CAAC,MAAM;CAGf;AAUD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG;IAC3C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACzC,CAQA;AAeD;kEACkE;AAClE,wBAAgB,aAAa,CAC3B,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,OAAO,EAAE,EACf,SAAS,GAAE,SAAS,MAAM,EAAO,GAChC,WAAW,CAAC,eAAe,CAAC,CAW9B"}
+{"version":3,"file":"logs_watcher.d.ts","sourceRoot":"","sources":["../../../src/watchers/logs_watcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1D,iFAAiF;AACjF,eAAO,MAAM,UAAU,+DAAgE,CAAC;AACxF,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD;;2CAE2C;AAC3C,KAAK,SAAS,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG;KACtB,KAAK,IAAI,QAAQ,CAAC,CAAC,EAAE,SAAS;CAChC,CAAC;AAEF,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,KAAK,EAAE,QAAQ,CAAC;IAChB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,kDAAkD;IAClD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,uDAAuD;IACvD,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAkBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,IAAI,QAAiB;IAC9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,MAAM,CAA2B;IACzC,sFAAsF;IACtF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;gBAEjC,OAAO,GAAE,kBAAuB;IAK5C;;;;;;;;;;OAUG;IACH,KAAK,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAkD/B;;;;OAIG;IACH,IAAI,IAAI,IAAI;IAYZ,oEAAoE;IACpE,OAAO,CAAC,MAAM;CAGf;AAUD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG;IAC3C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACzC,CAQA;AAeD;kEACkE;AAClE,wBAAgB,aAAa,CAC3B,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,OAAO,EAAE,EACf,SAAS,GAAE,SAAS,MAAM,EAAO,GAChC,WAAW,CAAC,eAAe,CAAC,CAW9B"}

package/dist/src/watchers/logs_watcher.js

@@ -36,21 +36,37 @@ export class LogsWatcher {
     minLevelIndex;
     extraTags;
     logger = null;
+    /** The levels THIS instance teed, so `stop()` never unwinds another watcher's tap. */
+    teedLevels = [];
     constructor(options = {}) {
         this.minLevelIndex = LOG_LEVELS.indexOf(options.minLevel ?? 'trace');
         this.extraTags = options.tags ?? [];
     }
-    /** Tee the level methods on `logger`. Idempotent per instance. */
+    /**
+     * Tee the level methods on `logger`. Idempotent per instance AND per logger: a
+     * level already teed (by this watcher or another one) is left alone, so a logger
+     * is never wrapped twice and a line is never recorded twice.
+     *
+     * The `'logs'` watcher can be enabled from TWO places — `config/telescope.ts`
+     * (with `logs.minLevel` / `logs.tags`) and `config/telescope_watchers.ts` (with no
+     * options). Only the first one to boot owns the tap; the second finds the logger
+     * already teed, warns once naming both config keys, and becomes inert — including
+     * its `stop()`, which would otherwise untee the owner's tap on shutdown.
+     */
     start(logger) {
         if (this.logger)
             return;
-        this.logger = logger;
         const watcher = this;
+        let alreadyTeed = false;
         for (let index = 0; index < LOG_LEVELS.length; index++) {
             const level = LOG_LEVELS[index];
             const original = logger[level];
-            if (typeof original !== 'function' || original[TEED])
+            if (typeof original !== 'function')
+                continue;
+            if (original[TEED]) {
+                alreadyTeed = true;
                 continue;
+            }
             const teed = function teedLevel(...args) {
                 // Nested log (e.g. our own failure logging) — call the original but
                 // don't record, breaking the record→log→record loop.
@@ -72,15 +88,30 @@ export class LogsWatcher {
             teed[TEED] = true;
             teed.__telescopeOriginal__ = original;
             logger[level] = teed;
+            this.teedLevels.push(level);
         }
+        if (this.teedLevels.length === 0) {
+            if (alreadyTeed) {
+                console.warn("Telescope: the 'logs' watcher is already tapping this logger, so this second " +
+                    'one records nothing (its minLevel/tags are ignored). Enable it in ONE place: ' +
+                    "either `watchers: ['logs']` in config/telescope.ts (which also accepts a `logs` " +
+                    "options block) or `watchers: ['logs']` in config/telescope_watchers.ts.");
+            }
+            return;
+        }
+        this.logger = logger;
     }
-    /** Restore the original level methods on the tapped instance. */
+    /**
+     * Restore the level methods THIS watcher teed. A watcher that never took the tap
+     * (because another one already held it) restores nothing, so shutting it down
+     * leaves the owner's tap intact.
+     */
     stop() {
         const logger = this.logger;
         if (!logger)
             return;
         this.logger = null;
-        for (const level of LOG_LEVELS) {
+        for (const level of this.teedLevels.splice(0)) {
             const current = logger[level];
             if (current?.[TEED] && current.__telescopeOriginal__) {
                 logger[level] = current.__telescopeOriginal__;

package/dist/src/watchers/logs_watcher.js.map

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

package/dist/stubs/config/telescope.stub

@@ -0,0 +1,193 @@
+{{{
+  exports({ to: app.configPath('telescope.ts') })
+}}}
+import { defineConfig, storage } from '@adonis-agora/telescope'
+
+/**
+ * Configuration for '@adonis-agora/telescope'. Everything is optional — the defaults
+ * use the in-memory store with the 'request' and 'diagnostics' watchers enabled and
+ * a 1000-entry cap.
+ */
+export default defineConfig({
+  /**
+   * Master switch. Set to false to disable all recording (zero overhead).
+   */
+  // enabled: true,
+
+  /**
+   * Which named store backs telescope. The active driver is selected by 'store'
+   * and built from the 'stores' map below.
+   */
+  store: 'memory',
+
+  /**
+   * Named store drivers, built with the 'storage' factory. Each is a lazy thunk —
+   * its peer dependency is only imported when that driver is the active one.
+   *
+   * To persist entries across restarts, install '@adonisjs/lucid', run the
+   * migration this package publishes (or pass autoCreateTable: true), switch
+   * 'store' to 'lucid', and uncomment the lucid driver:
+   */
+  stores: {
+    memory: storage.memory({ limit: 1000 }),
+    // lucid: storage.lucid({ connection: 'pg' }),
+  },
+
+  /**
+   * Active watchers. Omit one to disable it.
+   *  - 'request'     — records each HTTP request (method, url, status, duration).
+   *  - 'diagnostics' — records every diagnostics-bus publish from a sibling Agora lib.
+   *  - 'logs'        — tees the AdonisJS logger and records each line as a 'log' entry.
+   *
+   * Note: '@adonis-agora/telescope/watchers' can also start a logs watcher. Enable
+   * 'logs' in ONE place only — whichever provider boots first owns the tap, and the
+   * other one is ignored (with a warning) so nothing is recorded twice.
+   */
+  // watchers: ['request', 'diagnostics'],
+
+  /**
+   * Fine-tunes the 'diagnostics' watcher.
+   *  - exclude       — 'lib:event' keys to skip recording, e.g. 'media:upload.progress'.
+   *                    The events stay live on the bus for other subscribers.
+   *  - recordClaimed — also record events a lib-specific watcher already claimed
+   *                    (and therefore already recorded as a typed entry). Default false.
+   */
+  // diagnostics: {
+  //   exclude: ['media:upload.progress'],
+  //   recordClaimed: false,
+  // },
+
+  /**
+   * Fine-tunes the 'logs' watcher.
+   *  - minLevel — only record at/above this level ('trace' | 'debug' | 'info' |
+   *               'warn' | 'error' | 'fatal'). Default 'trace' (record everything).
+   *  - tags     — extra tags appended to every recorded log entry.
+   */
+  // logs: {
+  //   minLevel: 'info',
+  //   tags: ['app'],
+  // },
+
+  /**
+   * Request BODY capture. OFF by default — request entries carry no 'body' field
+   * until this block is present. Supplying an empty object turns it on with the
+   * safe defaults below; each gate runs BEFORE the synchronous redaction pass, so a
+   * huge or binary body is never walked (a gated-out body becomes a marker string).
+   *  - maxBodyBytes         — skip bodies over this size, measured in O(1) from
+   *                           content-length or a string/Buffer length. Default
+   *                           131072 (128 KiB); false disables the size gate.
+   *  - skipBodyContentTypes — content types never captured. A string matches as a
+   *                           case-insensitive prefix, a RegExp is tested. Defaults
+   *                           to application/octet-stream, application/offset+octet-stream
+   *                           and multipart/form-data.
+   *  - skipBody             — your own predicate; return true to skip this body.
+   */
+  // requestCapture: {
+  //   maxBodyBytes: 131_072,
+  //   skipBodyContentTypes: ['application/octet-stream', 'multipart/form-data'],
+  //   skipBody: (request) => request.url.startsWith('/webhooks/'),
+  // },
+
+  /**
+   * Sensitive-data redaction. Every entry's content is scrubbed before it is
+   * persisted — a built-in set of sensitive keys ('authorization', 'cookie',
+   * 'password', 'token', 'api_key', 'secret', 'set-cookie', …) is masked with
+   * '[REDACTED]', case-insensitively, at any depth. ENABLED by default.
+   *
+   * 'perType' overrides the NUMERIC bounds for one entry type — useful to give
+   * exception stacks a bigger byte budget than high-volume request entries. Masking
+   * stays global.
+   */
+  // redact: {
+  //   enabled: true,
+  //   keys: ['ssn', 'credit_card'],
+  //   perType: {
+  //     exception: { maxContentBytes: 64_000, maxStringLength: 8_000 },
+  //   },
+  // },
+
+  /**
+   * Tail-sampling on the WRITE path — a dropped entry is never persisted. Accepts
+   * a bare number (a uniform keep-rate for every type) or a per-type map whose
+   * reserved 'default' key covers the rest. A rule object keeps a fraction of the
+   * noise while always retaining what matters.
+   */
+  // sampling: {
+  //   default: 1,
+  //   query: { rate: 0.1, keepErrors: true, keepSlowMs: 500 },
+  // },
+
+  /**
+   * N+1 query-loop detection over stored entries (read-only analysis).
+   * 'threshold' is the minimum repetitions of one query template within a trace.
+   */
+  // nPlusOne: {
+  //   enabled: true,
+  //   threshold: 3,
+  // },
+
+  /**
+   * Pulse — the aggregated 'at a glance' health rollup computed on demand from
+   * stored entries. ENABLED by default over a trailing 1h window with every card.
+   */
+  // pulse: {
+  //   enabled: true,
+  //   windowMs: 3_600_000,
+  //   topN: 5,
+  //   buckets: 60,
+  //   slowRouteMs: 1000,
+  //   // cards: ['counts', 'slowest'],
+  // },
+
+  /**
+   * Live SSE streaming of new entries to the dashboard. ENABLED by default and
+   * zero-overhead while no dashboard is connected. Set enabled: false to turn
+   * the <telescope>/api/stream endpoint off entirely.
+   */
+  // stream: {
+  //   enabled: true,
+  // },
+
+  /**
+   * Background retention. A pruner deletes stale entries on a timer so the store
+   * never grows without bound. OFF unless this block is present — supply it to
+   * delete entries older than 'after', optionally capping by count with 'keepLast'.
+   *  - after      — age cutoff: a ms number or '<int><ms|s|m|h|d>' (default '24h').
+   *  - keepLast   — keep at most the newest N of the entries a cycle would delete.
+   *  - intervalMs — how often a scheduled cycle runs (default 60000).
+   */
+  // prune: {
+  //   after: '24h',
+  //   // keepLast: 10000,
+  //   // intervalMs: 60_000,
+  // },
+
+  /**
+   * Overload protection. A guard samples the event-loop delay and PAUSES ingestion
+   * when the p99 lag crosses maxEventLoopLagMs, resuming once it recovers — so
+   * telescope can never amplify an incident. ENABLED by default at 200ms.
+   */
+  // overload: {
+  //   enabled: true,
+  //   maxEventLoopLagMs: 200,
+  //   startupGraceMs: 5_000,
+  // },
+
+  /**
+   * Public front-end error ingestion: a POST endpoint browsers report client-side
+   * errors to, recorded as 'client_exception' entries. DISABLED by default — while
+   * off no route is registered at all, so a probe cannot tell it is wired.
+   *  - path         — where the endpoint mounts. Default '/telescope/client-errors'.
+   *  - maxBodyBytes — hard cap on the accepted body, checked before validation.
+   *                   Default 32768 (32 KB).
+   *  - rateLimit    — per-IP token bucket, per process. Default 60 requests/minute.
+   *  - authorize    — runs first; return false to reject with 403.
+   */
+  // clientErrors: {
+  //   enabled: true,
+  //   path: '/telescope/client-errors',
+  //   maxBodyBytes: 32_768,
+  //   rateLimit: { perMinute: 60 },
+  //   // authorize: (ctx) => ctx.request.header('x-app-key') === env.get('APP_KEY'),
+  // },
+})

package/dist/stubs/config/telescope_ai.stub

@@ -0,0 +1,57 @@
+{{{
+  exports({ to: app.configPath('telescope_ai.ts') })
+}}}
+import env from '#start/env'
+import { defineConfig } from '@adonis-agora/telescope/ai'
+
+/**
+ * Configuration for '@adonis-agora/telescope/ai'. Diagnosis is on when an Anthropic API
+ * key resolves from the environment; with no key the diagnoser is a safe no-op.
+ *
+ * Add ANTHROPIC_API_KEY to your .env and validate it in start/env.ts:
+ *   ANTHROPIC_API_KEY: Env.schema.string.optional()
+ */
+export default defineConfig({
+  /**
+   * Master switch. Set to false to disable diagnosis entirely.
+   */
+  // enabled: true,
+
+  /**
+   * The Anthropic API key — sourced from the environment, never hardcoded.
+   */
+  apiKey: env.get('ANTHROPIC_API_KEY'),
+
+  /**
+   * Bring your OWN model client instead. Any object with a messages.create method
+   * matching the Anthropic Messages shape is accepted, and takes precedence over
+   * apiKey — telescope then never constructs the Anthropic SDK itself.
+   */
+  // client: myModelClient,
+
+  /**
+   * Claude model id. Defaults to 'claude-sonnet-4-6' (best speed/intelligence
+   * balance). Use 'claude-opus-4-8' for the most capable diagnosis, or
+   * 'claude-haiku-4-5-20251001' for the cheapest.
+   */
+  // model: 'claude-sonnet-4-6',
+
+  /**
+   * Hard cap on generated tokens per diagnosis. Default 1024.
+   */
+  // maxTokens: 1024,
+
+  /**
+   * How long a cached diagnosis stays fresh, in ms. An exception family is
+   * diagnosed once, then served from cache until this elapses. Defaults to 24h.
+   */
+  // cacheTtlMs: 24 * 60 * 60 * 1000,
+
+  /**
+   * Per-diagnosis wall-clock timeout, in ms, enforced by the diagnosis coordinator
+   * that backs the dashboard's Diagnose button, the MCP diagnose_exception tool and
+   * the alerter's 'Probable cause (AI)' section. A slower model call is abandoned
+   * (the caller proceeds without the AI note). Default 8000; 0 or less disables it.
+   */
+  // timeoutMs: 8000,
+})

package/dist/stubs/config/telescope_alerts.stub

@@ -0,0 +1,78 @@
+{{{
+  exports({ to: app.configPath('telescope_alerts.ts') })
+}}}
+import { defineConfig } from '@adonis-agora/telescope/alerts'
+
+/**
+ * Configuration for '@adonis-agora/telescope/alerts'. By default alerting is on, polls
+ * the telescope store every 30s for brand-new exception families, and logs each
+ * alert to the console. Add a Slack or generic webhook channel to ship alerts off-box.
+ */
+export default defineConfig({
+  /**
+   * Master switch. Set to false to disable alerting entirely.
+   */
+  // enabled: true,
+
+  /**
+   * Delivery destinations. Each fired alert is sent to every channel concurrently;
+   * one channel failing never blocks the others. Accepts declarative specs or
+   * pre-built channel objects (slackChannel/webhookChannel/customChannel).
+   */
+  // channels: [
+  //   { type: 'console' },
+  //   { type: 'slack', url: env.get('TELESCOPE_SLACK_WEBHOOK') },
+  //   { type: 'webhook', url: env.get('TELESCOPE_ALERT_WEBHOOK') },
+  // ],
+
+  /**
+   * Rules to evaluate.
+   *  - { type: 'new-exception', window } — page the first time an exception family
+   *    is seen within window (and again after it elapses).
+   *  - { type: 'every-exception', window? } — page for EVERY exception, not just new
+   *    families, still rate-limited per family by cooldown. The optional window only
+   *    counts occurrences shown on the alert; it does not gate firing.
+   *  - { type: 'exception-rate', window, threshold } — page when >= threshold
+   *    exceptions are recorded in the trailing window.
+   *  - { type: 'metric-threshold', metric, window, comparator, threshold, minSamples? }
+   *    — page when a windowed metric crosses a threshold, and AUTO-RESOLVE when it
+   *    clears. metric is one of 'request-p95-ms', 'request-p99-ms', 'query-p95-ms',
+   *    'query-p99-ms', 'cache-hit-rate', 'exception-count'; comparator is 'gte' or
+   *    'lte'. minSamples (default 1) guards a percentile rule against a single
+   *    outlier on a quiet host, and is ignored for 'exception-count'.
+   *
+   * Only the FIRST rule of each type is evaluated — list one rule per type.
+   */
+  // rules: [
+  //   { type: 'new-exception', window: '1h' },
+  //   { type: 'metric-threshold', metric: 'request-p99-ms', window: '5m', comparator: 'gte', threshold: 800 },
+  // ],
+
+  /**
+   * External dashboard URL — when set, Slack alerts include a deep link to the entry.
+   */
+  // dashboardUrl: 'https://telescope.example.com/',
+
+  /**
+   * Poll cadence and re-notify cooldown (duration strings).
+   */
+  // every: '30s',
+  // cooldown: '15m',
+
+  /**
+   * Reporting instance identifier carried on every alert payload. Default 'telescope'.
+   */
+  // instanceId: 'api-eu-west-1',
+
+  /**
+   * Optional IP-to-geo resolver. Called ONLY when an exception alert fires and
+   * carries a client IP; the result renders as a coarse 'Location' field on channels
+   * that support it. Telescope ships no geo database — you own the lookup and any
+   * caching. Return null (or throw) to omit the field.
+   */
+  // geoLookup: async (ip) => {
+  //   const res = await fetch('https://ipapi.example/' + ip)
+  //   const body = await res.json()
+  //   return { city: body.city, country: body.country, countryCode: body.country_code }
+  // },
+})

package/dist/stubs/config/telescope_cpu_profiling.stub

@@ -0,0 +1,42 @@
+{{{
+  exports({ to: app.configPath('telescope_cpu_profiling.ts') })
+}}}
+import { defineConfig } from '@adonis-agora/telescope/cpu_profiling'
+
+/**
+ * Configuration for '@adonis-agora/telescope/cpu_profiling'. On-demand V8 CPU
+ * captures via node:inspector, rendered as a flamegraph in the dashboard.
+ *
+ * Profiling carries real overhead (a running sampling profiler slows the process it
+ * profiles), so it is OFF by default. While disabled the middleware hook is a single
+ * boolean check and node:inspector is never required.
+ */
+export default defineConfig({
+  /**
+   * Master switch. Set to true to enable capture.
+   */
+  enabled: false,
+
+  /**
+   * Fraction (0-1) of requests captured automatically. 0 — the default — means
+   * captures only happen when explicitly armed from the dashboard, which itself
+   * requires cpuProfiling.armEnabled in config/telescope_ui.ts.
+   */
+  // sampleRate: 0,
+
+  /**
+   * Maximum concurrent captures, keeping overhead bounded under load. Default 2.
+   */
+  // maxConcurrent: 2,
+
+  /**
+   * Captures shorter than this many ms are discarded (not worth an entry). Default 5.
+   */
+  // minDurationMs: 5,
+
+  /**
+   * V8 sampling interval in microseconds — lower is finer-grained and costlier.
+   * Default 1000, floored at 100.
+   */
+  // samplingIntervalMicros: 1000,
+})

package/dist/stubs/config/telescope_mcp.stub

@@ -0,0 +1,48 @@
+{{{
+  exports({ to: app.configPath('telescope_mcp.ts') })
+}}}
+import { defineConfig } from '@adonis-agora/telescope/mcp'
+
+/**
+ * Configuration for '@adonis-agora/telescope/mcp'. Exposes the captured telemetry to
+ * a coding agent (Claude Code, Cursor, …) over the Model Context Protocol as a
+ * JSON-RPC endpoint at 'POST /telescope/mcp'.
+ *
+ * Access reuses the SAME guard as the dashboard: allowed automatically outside
+ * production, and in production only when a token / basic credential — or a custom
+ * authorize hook — permits it. A denial is returned as a JSON-RPC -32001 error
+ * (MCP has no transport-level 401).
+ */
+export default defineConfig({
+  /**
+   * Master switch. Set to false to register no routes at all.
+   */
+  // enabled: true,
+
+  /**
+   * URL the JSON-RPC endpoint mounts at.
+   */
+  // path: '/telescope/mcp',
+
+  /**
+   * Access-decision hook (identical to the UI/metrics guard). Return true to allow
+   * the request. Delegate to your own app auth here, e.g.:
+   */
+  // authorize: (ctx) => ctx.auth?.user?.isAdmin === true,
+
+  /**
+   * Built-in credentials for the default policy (ignored when authorize is set):
+   *  - token: allow 'Authorization: Bearer <token>' or '?token=<token>'
+   *  - basic: allow HTTP Basic auth
+   */
+  // credentials: {
+  //   token: env.get('TELESCOPE_MCP_TOKEN'),
+  // },
+
+  /**
+   * Which tools to expose. Omit for all six ('list_entries', 'get_entry',
+   * 'get_trace', 'get_waterfall', 'get_health', 'diagnose_exception'). Restrict to
+   * a read-only surface, e.g.:
+   */
+  // tools: ['list_entries', 'get_entry', 'get_trace', 'get_waterfall', 'get_health'],
+})

package/dist/stubs/config/telescope_ui.stub

@@ -0,0 +1,92 @@
+{{{
+  exports({ to: app.configPath('telescope_ui.ts') })
+}}}
+import { defineConfig } from '@adonis-agora/telescope/ui'
+
+/**
+ * Configuration for '@adonis-agora/telescope/ui'. By default the dashboard mounts at
+ * /telescope and is reachable automatically outside production. In production it is
+ * denied unless you set a token / basic credential below, or supply your own
+ * authorize hook delegating to your app's auth.
+ */
+export default defineConfig({
+  /**
+   * Master switch. Set to false to register no routes at all.
+   */
+  // enabled: true,
+
+  /**
+   * URL prefix. The dashboard is served here; the JSON API lives at <path>/api/*.
+   */
+  // path: '/telescope',
+
+  /**
+   * Access-decision hook. Return true to allow the request, false to reject it
+   * (the guard answers 401 when no credential was presented, 403 when one was and
+   * was rejected). Delegate to your own app auth here, e.g.:
+   */
+  // authorize: (ctx) => ctx.auth?.user?.isAdmin === true,
+
+  /**
+   * Built-in credentials for the default policy (ignored when authorize is set).
+   * Gate a production dashboard without writing a hook:
+   *  - token: allow 'Authorization: Bearer <token>' or '?token=<token>'
+   *  - basic: allow HTTP Basic auth
+   */
+  // credentials: {
+  //   token: env.get('TELESCOPE_UI_TOKEN'),
+  //   basic: { username: 'admin', password: env.get('TELESCOPE_UI_PASSWORD') },
+  // },
+
+  /**
+   * Built-in login screen. When present, the provider mounts a server-rendered
+   * login page plus its submit and logout routes, and stamps a session guard on the
+   * dashboard: an unauthenticated page navigation is redirected to the login page
+   * and an unauthenticated API request gets a 401. The signed session cookie is
+   * minted only by your own login hook.
+   *
+   * This is ADDITIVE and composes WITH authorize (both must pass). Omit it entirely
+   * to keep the dashboard's default behavior. A missing secret or login hook fails
+   * closed at boot.
+   */
+  // dashboardAuth: {
+  //   secret: env.get('TELESCOPE_DASHBOARD_SECRET'),
+  //   ttl: '8h',
+  //   login: async (username, password) => {
+  //     const user = await User.verifyCredentials(username, password)
+  //     return user.isAdmin ? { id: String(user.id), name: user.fullName } : null
+  //   },
+  // },
+
+  /**
+   * Request REPLAY: re-issue a captured request from the dashboard against the
+   * LOCAL server. DISABLED BY DEFAULT because it re-runs a real request that may
+   * MUTATE state (a captured POST/DELETE runs again). It only ever targets
+   * 127.0.0.1:<port> (same-origin, never an arbitrary URL) and strips
+   * cookie/authorization/host headers. Enable it knowingly:
+   */
+  // replay: {
+  //   enabled: true,
+  //   // port: 3333,      // defaults to the PORT env var, then 3333
+  //   // timeoutMs: 30_000,
+  // },
+
+  /**
+   * The dashboard's 'arm a CPU profile' trigger. DISABLED BY DEFAULT, like replay —
+   * arming a capture runs a V8 sampling profiler over the next requests, which costs
+   * real CPU. READING captured profiles is unaffected; only the arm action is gated.
+   * Requires '@adonis-agora/telescope/cpu_profiling' to be installed and enabled.
+   */
+  // cpuProfiling: {
+  //   armEnabled: true,
+  // },
+
+  /**
+   * The queue console's MUTATING actions (retry / enqueue). DISABLED BY DEFAULT,
+   * like replay — they act on real jobs. Reading the queue console is unaffected.
+   * Requires the 'queue-manager' watcher in config/telescope_watchers.ts.
+   */
+  // queueActions: {
+  //   enabled: true,
+  // },
+})

package/dist/stubs/config/telescope_watchers.stub

@@ -0,0 +1,120 @@
+{{{
+  exports({ to: app.configPath('telescope_watchers.ts') })
+}}}
+import { defineConfig } from '@adonis-agora/telescope/watchers'
+
+/**
+ * Configuration for '@adonis-agora/telescope/watchers'. By default only the Lucid
+ * 'query' watcher is enabled — its db:query event is verified against the installed
+ * '@adonisjs/lucid' types. Every other watcher is opt-in.
+ */
+export default defineConfig({
+  /**
+   * Master switch. Set to false to start no per-technology watcher.
+   */
+  // enabled: true,
+
+  /**
+   * Active watchers. Omit one to disable it.
+   *  - 'query'         — records every Lucid SQL query (sql, bindings, duration, connection).
+   *  - 'mail'          — records every email sent (mail:sent).
+   *  - 'cache'         — records @adonisjs/cache hit/miss/write/delete events.
+   *  - 'http-client'   — records every outbound fetch call (method, url, status, duration).
+   *  - 'logs'          — records AdonisJS logger output as 'log' entries. The CORE
+   *                      config can also start this watcher, with minLevel/tags
+   *                      options this one has no place for — enable it in ONE place
+   *                      only. Whichever provider boots first owns the tap; the other
+   *                      is ignored with a warning, so nothing is recorded twice.
+   *  - 'queue'         — records @adonisjs/queue job executions (optional peer). No-op
+   *                      when the peer is absent.
+   *  - 'events'        — records every event emitted through the core Emitter (onAny),
+   *                      with an ignore-list (db:query / mail:sent are excluded by default).
+   *  - 'redis'         — records @adonisjs/redis commands (optional peer; wraps the
+   *                      ioredis sendCommand). No-op when the peer is absent.
+   *  - 'profiling'     — publishes the opt-in profile()/startProfile() timing-span
+   *                      helpers. Wrap a code section to record its label, duration
+   *                      and in-span marks. Zero cost until enabled AND used.
+   *  - 'schedule'      — publishes the opt-in scheduleTask()/recordScheduledRun()
+   *                      helpers. AdonisJS ships no scheduler event to tap, so this
+   *                      is EXPLICIT integration: wrap the closure you hand your
+   *                      scheduler with scheduleTask('name', fn), or call
+   *                      recordScheduledRun(...) from your own scheduler callback.
+   *  - 'queue-manager' — publishes the Live Queue Manager driver behind the queue
+   *                      console (list / inspect / retry / enqueue). This is a live
+   *                      control surface, not an entry watcher — configure it under
+   *                      'queueManager' below.
+   */
+  // watchers: ['query'],
+
+  /**
+   * Tuning for the Lucid 'query' watcher (enabled by default). It records every
+   * SQL query Lucid emits on db:query, grouped by normalized SQL template so the
+   * Pulse slow-query and N+1 cards can roll up 'the same query'.
+   */
+  // query: {
+  //   // Queries at/above this many ms get a 'slow' tag. Default 500.
+  //   slowMs: 500,
+  //   // Keep the raw bound VALUES. Off by default — bindings carry PII/secrets, so
+  //   // they are redacted to '[REDACTED]' placeholders (arity preserved). Default false.
+  //   captureBindings: false,
+  //   // Connection names (case-insensitive) whose queries are NOT recorded.
+  //   ignoreConnections: [],
+  //   // Normalize SQL into the familyHash grouping key (collapse whitespace, replace
+  //   // literals with '?'). Off hashes the raw SQL verbatim. Default true.
+  //   normalize: true,
+  // },
+
+  /**
+   * Tuning for the 'http-client' (outbound) watcher. Outbound HTTP is OPT-IN:
+   * AdonisJS has no single built-in client, so nothing is monkey-patched. Wrap a
+   * fetch with instrumentFetch(fetch) (from '@adonis-agora/telescope/watchers')
+   * and hand it to your client — it inherits the settings below.
+   */
+  // httpClient: {
+  //   // Outbound calls at/above this many ms get a 'slow' tag. Default 1000.
+  //   slowMs: 1000,
+  //   // Hosts (exact, case-insensitive; may include a port) whose calls are not recorded.
+  //   ignoreHosts: [],
+  //   // Record request/response body SIZES (bytes, never the bytes). Default false.
+  //   captureBodies: false,
+  // },
+
+  /**
+   * Tuning for the 'profiling' watcher. Add 'profiling' to watchers, then wrap a
+   * code section with profile('label', fn) (or bracket it with startProfile) —
+   * both imported from '@adonis-agora/telescope/watchers'.
+   */
+  // profiling: {
+  //   // Spans at/above this many ms get a 'slow' tag. Default 100.
+  //   slowMs: 100,
+  //   // Spans below this many ms are discarded (too short to keep). Default 0.
+  //   minDurationMs: 0,
+  // },
+
+  /**
+   * Tuning for the 'schedule' watcher. Add 'schedule' to watchers, then wrap the
+   * closure you hand your scheduler with scheduleTask('name', fn) (or call
+   * recordScheduledRun(...)) — both from '@adonis-agora/telescope/watchers'.
+   */
+  // schedule: {
+  //   // Runs at/above this many ms get a 'slow' tag. Default 1000.
+  //   slowMs: 1000,
+  // },
+
+  /**
+   * Config for the 'queue-manager' capability — the driver behind the dashboard's
+   * live queue console. Add 'queue-manager' to watchers to publish it.
+   *  - queues  — REQUIRED to get anything. @adonisjs/queue has no queue-enumeration
+   *              API (queue names only exist as strings at dispatch time), so there
+   *              is nothing to auto-discover. Default [] (the console reports
+   *              'not configured').
+   *  - adapter — which configured queue adapter to resolve. Omit for the default one.
+   *
+   * The console's MUTATING actions (retry / enqueue) are additionally gated by
+   * queueActions.enabled in config/telescope_ui.ts, and are off by default.
+   */
+  // queueManager: {
+  //   queues: ['default', 'emails'],
+  //   // adapter: 'redis',
+  // },
+})

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adonis-agora/telescope",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Laravel Telescope-style headless observability for AdonisJS — records HTTP requests and every Agora diagnostics event as queryable entries, plus opt-in subpaths for per-technology watchers, a web dashboard, AI exception diagnosis, and alerting.",
   "license": "MIT",
   "repository": {
@@ -143,7 +143,7 @@
     "vitest": "3.2.7"
   },
   "engines": {
-    "node": "v26.7.0"
+    "node": ">=20.6.0"
   },
   "keywords": [
     "adonisjs",