@adonis-agora/telescope 0.21.0 → 0.22.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @adonis-agora/telescope
 
+## 0.22.0
+
+### Minor Changes
+
+- [#184](https://github.com/DavideCarvalho/adonis-agora-telescope/pull/184) [`01f7971`](https://github.com/DavideCarvalho/adonis-agora-telescope/commit/01f7971a23fe5f3ab0822e4377c89acb65cf10c2) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - Drop Node.js 20 and 22: `engines.node` is now `>=24`. Node 20 reached end-of-life on 2026-04-30, and AdonisJS 7, which these packages require as a peer, needs Node 24 or later (`@adonisjs/core` declares `engines.node >=24.0.0`). The supported lines are the ones Node still maintains that AdonisJS 7 accepts: 24 and 26, both tested in CI.
+
+## 0.21.1
+
+### Patch Changes
+
+- [`dce73c7`](https://github.com/DavideCarvalho/adonis-agora-telescope/commit/dce73c7475723ec9cedff9b0c35ac88396bc2a45) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - Point the `DiagnosticEvent.durationMs` doc link at the OTel mapper's real path
+  
+  The JSDoc on `DiagnosticEvent.durationMs` linked the OTel bridge as
+  `{@link ../otel/mapper.js}`. `diagnostics_registry.ts` sits in `packages/core/src/`,
+  so that path resolves to `packages/core/otel/mapper.js`, which does not exist — the
+  mapper is `packages/core/src/otel/mapper.ts`, one level down, not up. Now `./otel/mapper.js`.
+
 ## 0.21.0
 
 ### Minor Changes

package/README.md

@@ -1,5 +1,7 @@
 # `@adonis-agora/telescope`
 
+[![npm version](https://img.shields.io/npm/v/@adonis-agora/telescope)](https://www.npmjs.com/package/@adonis-agora/telescope) [![npm downloads](https://img.shields.io/npm/dm/@adonis-agora/telescope)](https://www.npmjs.com/package/@adonis-agora/telescope) [![CI](https://github.com/DavideCarvalho/adonis-agora-telescope/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/DavideCarvalho/adonis-agora-telescope/actions/workflows/ci.yml) [![license](https://img.shields.io/npm/l/@adonis-agora/telescope)](https://www.npmjs.com/package/@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.

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.21.0";
+export declare const VERSION = "0.22.0";
 export type { ResolvedTelescopeAiConfig, TelescopeAiConfig, } from './define_config.js';
 export { DEFAULT_MAX_TOKENS, DEFAULT_MODEL, defineConfig, resolveConfig, } from './define_config.js';
 export type { Diagnosis, DiagnosisConfidence, ExceptionEntryContent } 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.21.0';
+export const VERSION = '0.22.0';
 // — config —
 export { DEFAULT_MAX_TOKENS, DEFAULT_MODEL, defineConfig, resolveConfig, } from './define_config.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.21.0";
+export declare const VERSION = "0.22.0";
 export type { AlertChannel, ChannelFetch, ConsoleSink } from './alert_channel.js';
 export { consoleChannel, customChannel, slackChannel, webhookChannel, } from './alert_channel.js';
 export type { AlertDiagnosis, AlertGeoLocation, AlertMetric, AlertPayload, AlertRule, ExceptionAlertContext, GeoLookup, ResolvedAlerts, } from './alert_rule.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.21.0';
+export const VERSION = '0.22.0';
 // — channels —
 export { consoleChannel, customChannel, slackChannel, webhookChannel, } from './alert_channel.js';
 // — alerter (exception source → tracker → channels) —

package/dist/src/diagnostics_registry.d.ts

@@ -60,7 +60,7 @@ export interface DiagnosticEvent<TPayload = unknown> {
      * when known — stamped by `@adonis-agora/diagnostics`'s `emit(..., { durationMs })`.
      * Absent on a point-in-time event with no associated duration, and on envelopes
      * from an `@adonis-agora/diagnostics` version that predates this field. Read by the
-     * OTel bridge ({@link ../otel/mapper.js}) to decide span-vs-log; see its docs for
+     * OTel bridge ({@link ./otel/mapper.js}) to decide span-vs-log; see its docs for
      * the full mapping (including the `payload.durationMs` fallback some libs use).
      */
     durationMs?: number;

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.21.0";
+export declare const VERSION = "0.22.0";
 export { configure } from '../configure.js';
 export type { DiagnoserLike, DiagnosisCoordinatorOptions, DiagnosisSummary, } from './ai/diagnosis_coordinator.js';
 export { DiagnosisCoordinator, formatDiagnosisMarkdown, } from './ai/diagnosis_coordinator.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.21.0';
+export const VERSION = '0.22.0';
 // Re-export the configure hook from the package root so `node ace configure` finds it
 export { configure } from '../configure.js';
 // — AI diagnosis coordinator (wires the MCP tool + the alerter; SDK-free) —

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.21.0";
+export declare const VERSION = "0.22.0";
 export type { McpToolName, ResolvedTelescopeMcpConfig, TelescopeMcpConfig, } from './define_config.js';
 export { defineConfig, MCP_TOOL_NAMES, resolveConfig } from './define_config.js';
 export type { DiagnoseExceptionHook, JsonRpcRequest, McpToolSpec, TelescopeMcpServerOptions, } 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.21.0';
+export const VERSION = '0.22.0';
 // — config —
 export { defineConfig, MCP_TOOL_NAMES, resolveConfig } 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.21.0";
+export declare const VERSION = "0.22.0";
 export { aggregateCpuProfile } from './aggregate-profile.js';
 export type { CpuProfilerOptions, CpuProfilerResult, InspectorSessionLike, SessionFactory, } from './cpu-profiler.js';
 export { CpuProfiler, defaultSessionFactory } from './cpu-profiler.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.21.0';
+export const VERSION = '0.22.0';
 export { aggregateCpuProfile } from './aggregate-profile.js';
 export { CpuProfiler, defaultSessionFactory } from './cpu-profiler.js';
 export { defineConfig, resolveConfig } from './define_config.js';

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.21.0";
+export declare const VERSION = "0.22.0";
 export type { AccessDeniedInfo, AccessDeniedPageOptions, AccessDeniedReason, } from './access_denied_page.js';
 export { CONSOLE as ACCESS_DENIED_CONSOLE, escapeHtml, renderAccessDeniedPage, resolveAccessDeniedPage, } from './access_denied_page.js';
 export type { EntrySummary, RetentionInfo, RetentionOptions, RetentionPruneOptions, RetentionSamplingRate, } from './api.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.21.0';
+export const VERSION = '0.22.0';
 // — the built-in "access denied" page (what a browser sees on a refused page navigation) —
 export { CONSOLE as ACCESS_DENIED_CONSOLE, escapeHtml, renderAccessDeniedPage, resolveAccessDeniedPage, } from './access_denied_page.js';
 // — JSON API —

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.21.0";
+export declare const VERSION = "0.22.0";
 export type { CacheEntryContent, CacheEventLike, CacheOperation } from './cache_watcher.js';
 export { buildCacheEntry, CACHE_EVENTS, CacheWatcher } from './cache_watcher.js';
 export { nextCronRunMs } from './cron_next_run.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.21.0';
+export const VERSION = '0.22.0';
 // — cache watcher —
 export { buildCacheEntry, CACHE_EVENTS, CacheWatcher } from './cache_watcher.js';
 export { nextCronRunMs } from './cron_next_run.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adonis-agora/telescope",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "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": {
@@ -8,6 +8,23 @@
     "url": "git+https://github.com/DavideCarvalho/adonis-agora-telescope.git",
     "directory": "packages/core"
   },
+  "homepage": "https://davidecarvalho.github.io/agora/docs/telescope",
+  "bugs": {
+    "url": "https://github.com/DavideCarvalho/adonis-agora-telescope/issues"
+  },
+  "keywords": [
+    "adonisjs",
+    "adonis",
+    "telescope",
+    "observability",
+    "diagnostics",
+    "tracing",
+    "agora",
+    "tanstack-intent",
+    "opentelemetry",
+    "otlp",
+    "grafana"
+  ],
   "author": "Davi Carvalho <davi@goflip.ai>",
   "type": "module",
   "main": "./dist/src/index.js",
@@ -160,41 +177,28 @@
     }
   },
   "devDependencies": {
-    "@adonisjs/assembler": "8.5.1",
-    "@adonisjs/core": "7.5.0",
+    "@adonisjs/assembler": "8.5.2",
+    "@adonisjs/core": "7.6.0",
     "@adonisjs/lucid": "22.4.2",
-    "@anthropic-ai/sdk": "0.124.0",
+    "@anthropic-ai/sdk": "0.133.0",
     "@opentelemetry/api": "1.9.1",
-    "@opentelemetry/exporter-logs-otlp-http": "0.222.0",
-    "@opentelemetry/exporter-trace-otlp-http": "0.222.0",
-    "@opentelemetry/resources": "2.11.0",
-    "@opentelemetry/sdk-logs": "0.222.0",
-    "@opentelemetry/sdk-trace-base": "2.11.0",
-    "@tanstack/intent": "^0.4.0",
+    "@opentelemetry/exporter-logs-otlp-http": "0.223.0",
+    "@opentelemetry/exporter-trace-otlp-http": "0.223.0",
+    "@opentelemetry/resources": "2.12.0",
+    "@opentelemetry/sdk-logs": "0.223.0",
+    "@opentelemetry/sdk-trace-base": "2.12.0",
+    "@tanstack/intent": "0.5.5",
     "@types/better-sqlite3": "9.6.0",
-    "@types/node": "26.4.1",
+    "@types/node": "26.6.5",
     "better-sqlite3": "13.0.3",
-    "cron-parser": "5.10.0",
+    "cron-parser": "5.10.2",
     "luxon": "3.7.2",
     "typescript": "7.0.2",
-    "vitest": "5.0.0"
+    "vitest": "5.0.4"
   },
   "engines": {
-    "node": ">=20.6.0"
+    "node": ">=24"
   },
-  "keywords": [
-    "adonisjs",
-    "adonis",
-    "telescope",
-    "observability",
-    "diagnostics",
-    "tracing",
-    "agora",
-    "tanstack-intent",
-    "opentelemetry",
-    "otlp",
-    "grafana"
-  ],
   "scripts": {
     "build": "tsc -p tsconfig.json && pnpm run copy:stubs",
     "copy:stubs": "mkdir -p dist/stubs && cp -R stubs/config dist/stubs/ && cp -R stubs/database dist/stubs/",