@rudderjs/telescope 0.0.1 → 1.0.0

package/README.md

@@ -1,6 +1,6 @@
 # @rudderjs/telescope
 
-Debug assistant for RudderJS — records requests, queries, jobs, exceptions, logs, mail, notifications, events, cache operations, scheduled tasks, and model changes.
+Debug assistant for RudderJS — records requests, queries, jobs, exceptions, logs, mail, notifications, events, cache operations, scheduled tasks, model changes, CLI commands, outgoing HTTP requests, authorization decisions, WebSocket lifecycle, Yjs CRDT events, and `dump()`/`dd()` calls.
 
 ## Installation
 
@@ -10,13 +10,32 @@ pnpm add @rudderjs/telescope
 
 ## Setup
 
+Telescope is auto-discovered via `defaultProviders()`. Just install the package, run `pnpm rudder providers:discover`, and add a config file:
+
 ```ts
-// bootstrap/providers.ts
-import { telescope } from '@rudderjs/telescope'
-import configs from '../config/index.js'
-export default [..., telescope(configs.telescope), ...]
+// config/telescope.ts
+import { Env } from '@rudderjs/core'
+import type { TelescopeConfig } from '@rudderjs/telescope'
+
+export default {
+  enabled: Env.getBool('TELESCOPE_ENABLED', true),
+  path: 'telescope',
+  storage: 'memory',
+} satisfies TelescopeConfig
 ```
 
+## Dashboard
+
+Telescope serves a built-in UI at `/{path}` (default `/telescope`) with:
+
+- **Dashboard** — count cards for all entry types
+- **Per-type list pages** — searchable, paginated tables with tag filtering and auto-refresh (2s polling)
+- **Detail pages** — rich, type-specific views at `/telescope/{type}/{id}` (formatted SQL, mail HTML preview, stack traces, WebSocket timelines, etc.)
+- **Batch grouping** — entries linked by `batchId` (e.g. all queries from one request, all events from one WebSocket connection) viewable at `/telescope/batches/{batchId}`
+- **Sensitive data redaction** — headers and body fields are redacted at collection time, before they reach storage
+
+The UI is vanilla HTML + Alpine.js + Tailwind CDN — no client framework dependency. Works regardless of whether your app uses React, Vue, Solid, or none.
+
 ## Telescope Facade
 
 ```ts
@@ -39,8 +58,6 @@ await Telescope.prune('log')   // prune by type
 await Telescope.prune()        // prune all
 ```
 
-## `Telescope` Methods
-
 | Method | Returns | Description |
 |--------|---------|-------------|
 | `list(options?)` | `TelescopeEntry[]` | List entries with type/tag/search/pagination filters |
@@ -51,21 +68,34 @@ await Telescope.prune()        // prune all
 
 ## Entry Types
 
-Telescope records 11 entry types:
-
-| Type | Collector | Description |
-|------|-----------|-------------|
-| `request` | RequestCollector | HTTP requests and responses |
-| `query` | QueryCollector | Database queries (flags slow queries) |
-| `job` | JobCollector | Queue job dispatch and execution |
-| `exception` | ExceptionCollector | Unhandled exceptions |
-| `log` | LogCollector | Log messages |
-| `mail` | MailCollector | Sent emails |
-| `notification` | NotificationCollector | Dispatched notifications |
-| `event` | EventCollector | Dispatched events |
-| `cache` | CacheCollector | Cache hits, misses, writes |
-| `schedule` | ScheduleCollector | Scheduled task execution |
-| `model` | ModelCollector | Model create/update/delete |
+Telescope records 17 entry types via the observer-registry pattern — each peer package exports a process-wide observer singleton, and the corresponding collector subscribes at boot. If a peer package isn't installed, its collector silently skips.
+
+### Core watchers
+
+| Type | Collector | Source | Description |
+|------|-----------|--------|-------------|
+| `request` | RequestCollector | `@rudderjs/router` | Incoming HTTP requests and responses |
+| `query` | QueryCollector | `@rudderjs/orm` | Database queries (flags slow queries above threshold) |
+| `job` | JobCollector | `@rudderjs/queue` | Queue job dispatch and execution |
+| `exception` | ExceptionCollector | `@rudderjs/core` | Unhandled exceptions |
+| `log` | LogCollector | `@rudderjs/log` | Log messages across all channels |
+| `mail` | MailCollector | `@rudderjs/mail` | Sent emails |
+| `notification` | NotificationCollector | `@rudderjs/notification` | Dispatched notifications |
+| `event` | EventCollector | `@rudderjs/core` | Dispatched events with listener list |
+| `cache` | CacheCollector | `@rudderjs/cache` | Cache hits, misses, writes, forgets |
+| `schedule` | ScheduleCollector | `@rudderjs/schedule` | Scheduled task execution with output |
+| `model` | ModelCollector | `@rudderjs/orm` | Model create/update/delete with dirty attributes diff |
+| `command` | CommandCollector | `@rudderjs/rudder` | CLI command invocations with args, duration, exit code |
+| `http` | HttpCollector | `@rudderjs/http` | Outgoing HTTP requests with timing, headers, response body |
+| `gate` | GateCollector | `@rudderjs/auth` | Authorization decisions — ability, allowed/denied, resolution path (ability/policy/before), timing |
+| `dump` | DumpCollector | `@rudderjs/support` | `dump()` and `dd()` calls with arguments and caller location |
+
+### Real-time watchers (differentiators — Laravel Telescope doesn't have these)
+
+| Type | Collector | Source | Description |
+|------|-----------|--------|-------------|
+| `broadcast` | BroadcastCollector | `@rudderjs/broadcast` | Full WebSocket lifecycle — connections, subscriptions, presence, broadcasts, auth failures. Grouped by `connectionId`. |
+| `live` | LiveCollector | `@rudderjs/live` | Yjs CRDT debugging — document open/close, updates applied, awareness changes (throttled), persistence events, sync errors |
 
 ## Storage Drivers
 
@@ -74,6 +104,8 @@ Telescope records 11 entry types:
 
 ## Configuration
 
+Every collector can be toggled independently:
+
 ```ts
 // config/telescope.ts
 export default {
@@ -83,6 +115,8 @@ export default {
   sqlitePath: '.telescope.db',
   maxEntries: 1000,
   pruneAfterHours: 24,
+
+  // Core watchers
   recordRequests: true,
   recordQueries: true,
   recordJobs: true,
@@ -94,18 +128,58 @@ export default {
   recordCache: true,
   recordSchedule: true,
   recordModels: true,
+  recordCommands: true,
+  recordHttp: true,
+  recordGate: true,
+  recordDumps: true,
+
+  // Real-time watchers
+  recordBroadcasts: true,
+  recordLive: true,
+  liveAwarenessSampleMs: 500,  // throttle Yjs awareness events
+
+  // Filtering
   ignoreRequests: ['/telescope*', '/health'],
-  slowQueryThreshold: 100,
+  slowQueryThreshold: 100,     // ms
+
+  // Sensitive data redaction (at collection time, never stored)
+  hideRequestHeaders: ['authorization', 'cookie', 'set-cookie', 'x-csrf-token', 'x-api-key'],
+  hideRequestFields: ['password', 'password_confirmation', 'token', 'secret'],
+
+  // Auth gate for the dashboard
   auth: null,
 } satisfies TelescopeConfig
 ```
 
-## Dashboard
+## Custom routes registration
+
+For packages or apps that need manual control over telescope routes:
+
+```ts
+import { registerTelescopeRoutes } from '@rudderjs/telescope'
+
+await registerTelescopeRoutes(storage, {
+  path: 'telescope',
+  auth: (req) => req.user?.isAdmin ?? false,
+  middleware: [myCustomMiddleware],
+})
+```
+
+## API
+
+The dashboard UI is built on a JSON API that you can use directly to build custom UIs:
 
-Telescope serves a built-in UI at `/{path}` with dedicated pages for each entry type, detail views, and a search interface.
+| Endpoint | Description |
+|----------|-------------|
+| `GET /telescope/api/overview` | Count per entry type |
+| `GET /telescope/api/{type}s` | List entries (supports `?page`, `?tag`, `?search`) |
+| `GET /telescope/api/{type}s/:id` | Single entry |
+| `GET /telescope/api/batches/:batchId` | All entries in a batch |
+| `DELETE /telescope/api/entries` | Prune entries (supports `?type`) |
 
 ## Notes
 
-- Auto-prune runs on a background interval.
-- Optional peers: `@rudderjs/log`, `@rudderjs/orm`, `@rudderjs/cache`, `@rudderjs/queue`, `@rudderjs/mail`, `@rudderjs/notification`, `@rudderjs/schedule`.
+- Auto-prune runs on a background interval based on `pruneAfterHours`.
+- All peer packages are optional — install only the ones you use, and only those collectors activate.
 - `createEntry()` helper is exported for manually constructing entries.
+- The observer-registry pattern means collectors never break the build if a peer package is absent — they fail gracefully via try/catch on dynamic import.

package/dist/api/routes.d.ts

@@ -1,7 +1,11 @@
-import type { TelescopeStorage, TelescopeConfig } from '../types.js';
-/**
- * Register all Telescope API routes on the router.
- * Called during the service provider's boot phase.
- */
-export declare function registerRoutes(storage: TelescopeStorage, config: TelescopeConfig): Promise<void>;
+import type { AppRequest, AppResponse, MiddlewareHandler } from '@rudderjs/contracts';
+import type { TelescopeStorage, TelescopeConfig, EntryType } from '../types.js';
+export declare function listEntries(storage: TelescopeStorage, type: EntryType, req: AppRequest, res: AppResponse): Promise<void>;
+export declare function showEntry(storage: TelescopeStorage, req: AppRequest, res: AppResponse): Promise<void>;
+export declare function listBatch(storage: TelescopeStorage, req: AppRequest, res: AppResponse): Promise<void>;
+export declare function overview(storage: TelescopeStorage, res: AppResponse): Promise<void>;
+export declare function prune(storage: TelescopeStorage, req: AppRequest, res: AppResponse): Promise<void>;
+export declare function getRecording(res: AppResponse): void;
+export declare function toggleRecording(res: AppResponse): void;
+export declare function authMiddleware(config: Pick<TelescopeConfig, 'auth'>): MiddlewareHandler;
 //# sourceMappingURL=routes.d.ts.map

package/dist/api/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/api/routes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAa,MAAM,aAAa,CAAA;AAW/E;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAG,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CA0Df"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/api/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACrF,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAa/E,wBAAsB,WAAW,CAC/B,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAK,SAAS,EAClB,GAAG,EAAM,UAAU,EACnB,GAAG,EAAM,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,wBAAsB,SAAS,CAC7B,OAAO,EAAE,gBAAgB,EACzB,GAAG,EAAM,UAAU,EACnB,GAAG,EAAM,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAsB,SAAS,CAC7B,OAAO,EAAE,gBAAgB,EACzB,GAAG,EAAM,UAAU,EACnB,GAAG,EAAM,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,gBAAgB,EACzB,GAAG,EAAM,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,KAAK,CACzB,OAAO,EAAE,gBAAgB,EACzB,GAAG,EAAM,UAAU,EACnB,GAAG,EAAM,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAQf;AAOD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,WAAW,GACf,IAAI,CAEN;AAED,wBAAgB,eAAe,CAC7B,GAAG,EAAE,WAAW,GACf,IAAI,CAIN;AAID,wBAAgB,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,GAAG,iBAAiB,CAWvF"}

package/dist/api/routes.js

@@ -1,58 +1,13 @@
-import { dashboardPage, requestsPage, queriesPage, jobsPage, exceptionsPage, logsPage, mailPage, notificationsPage, eventsPage, cachePage, schedulePage, modelsPage, } from '../ui/pages.js';
 const ENTRY_TYPES = [
     'request', 'query', 'job', 'exception', 'log',
-    'mail', 'notification', 'event', 'cache', 'schedule', 'model',
+    'mail', 'notification', 'event', 'cache', 'schedule', 'model', 'command', 'broadcast', 'live',
 ];
-/**
- * Register all Telescope API routes on the router.
- * Called during the service provider's boot phase.
- */
-export async function registerRoutes(storage, config) {
-    const { router } = await import('@rudderjs/router');
-    const basePath = `/${config.path ?? 'telescope'}`;
-    const prefix = `${basePath}/api`;
-    const middleware = config.auth ? [authMiddleware(config)] : [];
-    // ── UI Pages ─────────────────────────────────────────────
-    const html = (_req, res, content) => res.header('Content-Type', 'text/html').send(content);
-    router.get(basePath, (r, s) => html(r, s, dashboardPage(basePath, prefix)), middleware);
-    router.get(`${basePath}/requests`, (r, s) => html(r, s, requestsPage(basePath, prefix)), middleware);
-    router.get(`${basePath}/queries`, (r, s) => html(r, s, queriesPage(basePath, prefix)), middleware);
-    router.get(`${basePath}/jobs`, (r, s) => html(r, s, jobsPage(basePath, prefix)), middleware);
-    router.get(`${basePath}/exceptions`, (r, s) => html(r, s, exceptionsPage(basePath, prefix)), middleware);
-    router.get(`${basePath}/logs`, (r, s) => html(r, s, logsPage(basePath, prefix)), middleware);
-    router.get(`${basePath}/mail`, (r, s) => html(r, s, mailPage(basePath, prefix)), middleware);
-    router.get(`${basePath}/notifications`, (r, s) => html(r, s, notificationsPage(basePath, prefix)), middleware);
-    router.get(`${basePath}/events`, (r, s) => html(r, s, eventsPage(basePath, prefix)), middleware);
-    router.get(`${basePath}/cache`, (r, s) => html(r, s, cachePage(basePath, prefix)), middleware);
-    router.get(`${basePath}/schedule`, (r, s) => html(r, s, schedulePage(basePath, prefix)), middleware);
-    router.get(`${basePath}/models`, (r, s) => html(r, s, modelsPage(basePath, prefix)), middleware);
-    // ── List routes for each entry type ──────────────────────
-    for (const type of ENTRY_TYPES) {
-        router.get(`${prefix}/${type === 'query' ? 'queries' : `${type}s`}`, (req, res) => listEntries(storage, type, req, res), middleware);
-        router.get(`${prefix}/${type === 'query' ? 'queries' : `${type}s`}/:id`, (req, res) => showEntry(storage, req, res), middleware);
-    }
-    // ── Overview ─────────────────────────────────────────────
-    router.get(`${prefix}/overview`, async (_req, res) => {
-        const counts = {};
-        for (const type of ENTRY_TYPES) {
-            counts[type] = await storage.count(type);
-        }
-        res.json({ counts, total: await storage.count() });
-    }, middleware);
-    // ── Prune ────────────────────────────────────────────────
-    router.delete(`${prefix}/entries`, async (req, res) => {
-        const type = req.query['type'];
-        if (type && ENTRY_TYPES.includes(type)) {
-            await storage.prune(type);
-        }
-        else {
-            await storage.prune();
-        }
-        res.json({ message: 'Entries pruned.' });
-    }, middleware);
-}
 // ─── Handlers ──────────────────────────────────────────────
-async function listEntries(storage, type, req, res) {
+//
+// Pure handler functions invoked from `../routes.ts`. Kept separate from
+// route registration so they can be reused or unit-tested without spinning
+// up a router.
+export async function listEntries(storage, type, req, res) {
     const page = parseInt(req.query['page'] ?? '1', 10);
     const perPage = parseInt(req.query['per_page'] ?? '50', 10);
     const tag = req.query['tag'];
@@ -70,7 +25,7 @@ async function listEntries(storage, type, req, res) {
         },
     });
 }
-async function showEntry(storage, req, res) {
+export async function showEntry(storage, req, res) {
     const entry = await storage.find(req.params['id'] ?? '');
     if (!entry) {
         res.status(404).json({ message: 'Entry not found.' });
@@ -83,8 +38,41 @@ async function showEntry(storage, req, res) {
     }
     res.json({ data: entry, related });
 }
-// ─── Auth Middleware ────────────────────────────────────────
-function authMiddleware(config) {
+export async function listBatch(storage, req, res) {
+    const batchId = req.params['batchId'] ?? '';
+    const entries = await storage.list({ batchId, perPage: 500 });
+    res.json({ data: entries });
+}
+export async function overview(storage, res) {
+    const counts = {};
+    for (const type of ENTRY_TYPES) {
+        counts[type] = await storage.count(type);
+    }
+    res.json({ counts, total: await storage.count() });
+}
+export async function prune(storage, req, res) {
+    const type = req.query['type'];
+    if (type && ENTRY_TYPES.includes(type)) {
+        await storage.prune(type);
+    }
+    else {
+        await storage.prune();
+    }
+    res.json({ message: 'Entries pruned.' });
+}
+// ─── Recording Toggle ─────────────────────────────────────
+const _g = globalThis;
+const _recKey = '__rudderjs_telescope_recording__';
+export function getRecording(res) {
+    res.json({ recording: _g[_recKey] ?? true });
+}
+export function toggleRecording(res) {
+    const recording = !(_g[_recKey] ?? true);
+    _g[_recKey] = recording;
+    res.json({ recording });
+}
+// ─── Auth Middleware ───────────────────────────────────────
+export function authMiddleware(config) {
     return async (req, res, next) => {
         if (config.auth) {
             const allowed = await config.auth(req);

package/dist/api/routes.js.map

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

package/dist/batch-context.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Lightweight request-scoped batchId propagation. Uses a simple global
+ * variable — works because Prisma's `$on('query')` callback fires
+ * synchronously during the query, within the same call stack as the
+ * request handler.
+ *
+ * The RequestCollector sets the batchId before `next()` and clears it
+ * after. Any collector that fires during the request (query, cache,
+ * model) can read it via `currentBatchId()`.
+ */
+/** Set the current batchId for the duration of a request. */
+export declare function setBatchId(id: string | null): void;
+/** Returns the current request's batchId, or `null` if not inside a request. */
+export declare function currentBatchId(): string | null;
+/** Returns `{ batchId }` if inside a request, or `{}` if not. Safe to spread into createEntry options. */
+export declare function batchOpts(): {
+    batchId?: string;
+};
+//# sourceMappingURL=batch-context.d.ts.map

package/dist/batch-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-context.d.ts","sourceRoot":"","sources":["../src/batch-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAElD;AAED,gFAAgF;AAChF,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAE9C;AAED,0GAA0G;AAC1G,wBAAgB,SAAS,IAAI;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAEhD"}

package/dist/batch-context.js

@@ -0,0 +1,24 @@
+/**
+ * Lightweight request-scoped batchId propagation. Uses a simple global
+ * variable — works because Prisma's `$on('query')` callback fires
+ * synchronously during the query, within the same call stack as the
+ * request handler.
+ *
+ * The RequestCollector sets the batchId before `next()` and clears it
+ * after. Any collector that fires during the request (query, cache,
+ * model) can read it via `currentBatchId()`.
+ */
+let _currentBatchId = null;
+/** Set the current batchId for the duration of a request. */
+export function setBatchId(id) {
+    _currentBatchId = id;
+}
+/** Returns the current request's batchId, or `null` if not inside a request. */
+export function currentBatchId() {
+    return _currentBatchId;
+}
+/** Returns `{ batchId }` if inside a request, or `{}` if not. Safe to spread into createEntry options. */
+export function batchOpts() {
+    return _currentBatchId ? { batchId: _currentBatchId } : {};
+}
+//# sourceMappingURL=batch-context.js.map

package/dist/batch-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-context.js","sourceRoot":"","sources":["../src/batch-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,IAAI,eAAe,GAAkB,IAAI,CAAA;AAEzC,6DAA6D;AAC7D,MAAM,UAAU,UAAU,CAAC,EAAiB;IAC1C,eAAe,GAAG,EAAE,CAAA;AACtB,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,cAAc;IAC5B,OAAO,eAAe,CAAA;AACxB,CAAC;AAED,0GAA0G;AAC1G,MAAM,UAAU,SAAS;IACvB,OAAO,eAAe,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;AAC5D,CAAC"}

package/dist/collectors/ai.d.ts

@@ -0,0 +1,13 @@
+import type { Collector, TelescopeStorage, TelescopeConfig } from '../types.js';
+/**
+ * Records AI agent executions by hooking into @rudderjs/ai's observer registry.
+ */
+export declare class AiCollector implements Collector {
+    private readonly storage;
+    private readonly config;
+    readonly name = "AI Collector";
+    readonly type: "ai";
+    constructor(storage: TelescopeStorage, config: TelescopeConfig);
+    register(): Promise<void>;
+}
+//# sourceMappingURL=ai.d.ts.map

package/dist/collectors/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/collectors/ai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAI/E;;GAEG;AACH,qBAAa,WAAY,YAAW,SAAS;IAKzC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,QAAQ,CAAC,IAAI,kBAAiB;IAC9B,QAAQ,CAAC,IAAI,EAAG,IAAI,CAAS;gBAGV,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAG,eAAe;IAGrC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA+ChC"}

package/dist/collectors/ai.js

@@ -0,0 +1,61 @@
+import { createEntry } from '../storage.js';
+import { batchOpts } from '../batch-context.js';
+/**
+ * Records AI agent executions by hooking into @rudderjs/ai's observer registry.
+ */
+export class AiCollector {
+    storage;
+    config;
+    name = 'AI Collector';
+    type = 'ai';
+    constructor(storage, config) {
+        this.storage = storage;
+        this.config = config;
+    }
+    async register() {
+        try {
+            const mod = await import('@rudderjs/ai/observers');
+            const { aiObservers } = mod;
+            const storage = this.storage;
+            const threshold = this.config.slowAiThreshold ?? 5000;
+            aiObservers.subscribe((event) => {
+                const tags = [
+                    `model:${event.model}`,
+                    `provider:${event.provider}`,
+                    `agent:${event.agentName}`,
+                ];
+                if (event.kind === 'agent.failed')
+                    tags.push('error');
+                if (event.duration > threshold)
+                    tags.push('slow');
+                if (event.streaming)
+                    tags.push('streaming');
+                const toolCalls = event.steps.flatMap(s => s.toolCalls);
+                if (toolCalls.length > 0)
+                    tags.push('has_tools');
+                storage.store(createEntry('ai', {
+                    kind: event.kind,
+                    agentName: event.agentName,
+                    model: event.model,
+                    provider: event.provider,
+                    input: event.input,
+                    output: event.output,
+                    steps: event.steps,
+                    tokens: event.tokens,
+                    duration: event.duration,
+                    finishReason: event.finishReason,
+                    streaming: event.streaming,
+                    conversationId: event.conversationId,
+                    failoverAttempts: event.failoverAttempts,
+                    toolCallCount: toolCalls.length,
+                    toolCalls,
+                    error: event.kind === 'agent.failed' ? event.error : undefined,
+                }, { tags, ...batchOpts() }));
+            });
+        }
+        catch {
+            // @rudderjs/ai not installed — skip
+        }
+    }
+}
+//# sourceMappingURL=ai.js.map

package/dist/collectors/ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../../src/collectors/ai.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAE/C;;GAEG;AACH,MAAM,OAAO,WAAW;IAKH;IACA;IALV,IAAI,GAAG,cAAc,CAAA;IACrB,IAAI,GAAG,IAAa,CAAA;IAE7B,YACmB,OAAyB,EACzB,MAAwB;QADxB,YAAO,GAAP,OAAO,CAAkB;QACzB,WAAM,GAAN,MAAM,CAAkB;IACxC,CAAC;IAEJ,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAEhD,CAAA;YACD,MAAM,EAAE,WAAW,EAAE,GAAG,GAAG,CAAA;YAE3B,MAAM,OAAO,GAAK,IAAI,CAAC,OAAO,CAAA;YAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,IAAI,CAAA;YAErD,WAAW,CAAC,SAAS,CAAC,CAAC,KAAc,EAAE,EAAE;gBACvC,MAAM,IAAI,GAAa;oBACrB,SAAS,KAAK,CAAC,KAAK,EAAE;oBACtB,YAAY,KAAK,CAAC,QAAQ,EAAE;oBAC5B,SAAS,KAAK,CAAC,SAAS,EAAE;iBAC3B,CAAA;gBAED,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;oBAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;gBACrD,IAAI,KAAK,CAAC,QAAQ,GAAG,SAAS;oBAAK,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;gBACpD,IAAI,KAAK,CAAC,SAAS;oBAAgB,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;gBAEzD,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;gBACvD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;oBAAE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;gBAEhD,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE;oBAC9B,IAAI,EAAc,KAAK,CAAC,IAAI;oBAC5B,SAAS,EAAS,KAAK,CAAC,SAAS;oBACjC,KAAK,EAAa,KAAK,CAAC,KAAK;oBAC7B,QAAQ,EAAU,KAAK,CAAC,QAAQ;oBAChC,KAAK,EAAa,KAAK,CAAC,KAAK;oBAC7B,MAAM,EAAY,KAAK,CAAC,MAAM;oBAC9B,KAAK,EAAa,KAAK,CAAC,KAAK;oBAC7B,MAAM,EAAY,KAAK,CAAC,MAAM;oBAC9B,QAAQ,EAAU,KAAK,CAAC,QAAQ;oBAChC,YAAY,EAAM,KAAK,CAAC,YAAY;oBACpC,SAAS,EAAS,KAAK,CAAC,SAAS;oBACjC,cAAc,EAAI,KAAK,CAAC,cAAc;oBACtC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;oBACxC,aAAa,EAAK,SAAS,CAAC,MAAM;oBAClC,SAAS;oBACT,KAAK,EAAa,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;iBAC1E,EAAE,EAAE,IAAI,EAAE,GAAG,SAAS,EAAE,EAAE,CAAC,CAAC,CAAA;YAC/B,CAAC,CAAC,CAAA;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,oCAAoC;QACtC,CAAC;IACH,CAAC;CACF"}

package/dist/collectors/broadcast.d.ts

@@ -0,0 +1,10 @@
+import type { Collector, TelescopeStorage } from '../types.js';
+export declare class BroadcastCollector implements Collector {
+    private readonly storage;
+    readonly name = "Broadcast Collector";
+    readonly type: "broadcast";
+    constructor(storage: TelescopeStorage);
+    register(): Promise<void>;
+    private record;
+}
+//# sourceMappingURL=broadcast.d.ts.map

package/dist/collectors/broadcast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast.d.ts","sourceRoot":"","sources":["../../src/collectors/broadcast.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AA0B9D,qBAAa,kBAAmB,YAAW,SAAS;IAItC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,IAAI,yBAAwB;IACrC,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAS;gBAEP,OAAO,EAAE,gBAAgB;IAEhD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAW/B,OAAO,CAAC,MAAM;CA4Bf"}

package/dist/collectors/broadcast.js

@@ -0,0 +1,46 @@
+import { createEntry } from '../storage.js';
+export class BroadcastCollector {
+    storage;
+    name = 'Broadcast Collector';
+    type = 'broadcast';
+    constructor(storage) {
+        this.storage = storage;
+    }
+    async register() {
+        try {
+            const { broadcastObservers } = await import('@rudderjs/broadcast');
+            broadcastObservers.subscribe((event) => this.record(event));
+        }
+        catch {
+            // @rudderjs/broadcast not installed — skip
+        }
+    }
+    record(event) {
+        const tags = [`kind:${event.kind}`];
+        // Subscribe events get extra status tags so the dashboard can
+        // distinguish allowed/denied at a glance.
+        if (event.kind === 'subscribe') {
+            tags.push(event['allowed'] ? 'allowed' : 'denied');
+            if (event['channelType'])
+                tags.push(`channel:${event['channelType']}`);
+        }
+        if (event.kind === 'broadcast' && event['source']) {
+            tags.push(`source:${event['source']}`);
+        }
+        if (event.kind === 'connection.opened' || event.kind === 'connection.closed') {
+            tags.push(event.kind === 'connection.opened' ? 'opened' : 'closed');
+        }
+        // Use connectionId as the batchId so the existing batch grouping UI
+        // (Phase 2b) works for WebSocket connections too — clicking through
+        // a connection.opened entry shows every event from that socket.
+        const opts = { tags };
+        const connectionId = event['connectionId'];
+        if (connectionId)
+            opts.batchId = connectionId;
+        // Strip the kind from content (it's already in the entry-type metadata)
+        // but keep everything else verbatim.
+        const { kind: _kind, ...content } = event;
+        this.storage.store(createEntry('broadcast', { kind: event.kind, ...content }, opts));
+    }
+}
+//# sourceMappingURL=broadcast.js.map

package/dist/collectors/broadcast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast.js","sourceRoot":"","sources":["../../src/collectors/broadcast.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAyB3C,MAAM,OAAO,kBAAkB;IAIA;IAHpB,IAAI,GAAG,qBAAqB,CAAA;IAC5B,IAAI,GAAG,WAAoB,CAAA;IAEpC,YAA6B,OAAyB;QAAzB,YAAO,GAAP,OAAO,CAAkB;IAAG,CAAC;IAE1D,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC;YACH,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAEhE,CAAA;YACD,kBAAkB,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QAC7D,CAAC;QAAC,MAAM,CAAC;YACP,2CAA2C;QAC7C,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,KAAqB;QAClC,MAAM,IAAI,GAAa,CAAC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;QAE7C,8DAA8D;QAC9D,0CAA0C;QAC1C,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;YAClD,IAAI,KAAK,CAAC,aAAa,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC,CAAA;QACxE,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;QACxC,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;YAC7E,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;QACrE,CAAC;QAED,oEAAoE;QACpE,oEAAoE;QACpE,gEAAgE;QAChE,MAAM,IAAI,GAAyC,EAAE,IAAI,EAAE,CAAA;QAC3D,MAAM,YAAY,GAAG,KAAK,CAAC,cAAc,CAAuB,CAAA;QAChE,IAAI,YAAY;YAAE,IAAI,CAAC,OAAO,GAAG,YAAY,CAAA;QAE7C,wEAAwE;QACxE,qCAAqC;QACrC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,CAAA;QACzC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC,CAAA;IACtF,CAAC;CACF"}

package/dist/collectors/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/collectors/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAG9D;;;GAGG;AACH,qBAAa,cAAe,YAAW,SAAS;IAIlC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,IAAI,qBAAoB;IACjC,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAS;gBAEH,OAAO,EAAE,gBAAgB;IAEhD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAsChC"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/collectors/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAI9D;;;GAGG;AACH,qBAAa,cAAe,YAAW,SAAS;IAIlC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,IAAI,qBAAoB;IACjC,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAS;gBAEH,OAAO,EAAE,gBAAgB;IAEhD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAsChC"}

package/dist/collectors/cache.js

@@ -1,4 +1,5 @@
 import { createEntry } from '../storage.js';
+import { batchOpts } from '../batch-context.js';
 /**
  * Records cache operations by wrapping the CacheRegistry adapter methods.
  * Intercepts get/set/forget/flush and records hit/miss/set/forget ops.
@@ -24,20 +25,20 @@ export class CacheCollector {
             original.get = async (key) => {
                 const value = await origGet(key);
                 const op = value !== null ? 'hit' : 'miss';
-                storage.store(createEntry('cache', { key, operation: op }, { tags: [`cache:${op}`] }));
+                storage.store(createEntry('cache', { key, operation: op }, { tags: [`cache:${op}`], ...batchOpts() }));
                 return value;
             };
             original.set = async (key, value, ttl) => {
                 await origSet(key, value, ttl);
-                storage.store(createEntry('cache', { key, operation: 'set', ttl }, { tags: ['cache:set'] }));
+                storage.store(createEntry('cache', { key, operation: 'set', ttl }, { tags: ['cache:set'], ...batchOpts() }));
             };
             original.forget = async (key) => {
                 await origForget(key);
-                storage.store(createEntry('cache', { key, operation: 'forget' }, { tags: ['cache:forget'] }));
+                storage.store(createEntry('cache', { key, operation: 'forget' }, { tags: ['cache:forget'], ...batchOpts() }));
             };
             original.flush = async () => {
                 await origFlush();
-                storage.store(createEntry('cache', { operation: 'flush' }, { tags: ['cache:flush'] }));
+                storage.store(createEntry('cache', { operation: 'flush' }, { tags: ['cache:flush'], ...batchOpts() }));
             };
         }
         catch {

package/dist/collectors/cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/collectors/cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C;;;GAGG;AACH,MAAM,OAAO,cAAc;IAII;IAHpB,IAAI,GAAG,iBAAiB,CAAA;IACxB,IAAI,GAAG,OAAgB,CAAA;IAEhC,YAA6B,OAAyB;QAAzB,YAAO,GAAP,OAAO,CAAkB;IAAG,CAAC;IAE1D,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC;YACH,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAA;YACzD,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,EAAE,CAAA;YACpC,IAAI,CAAC,QAAQ;gBAAE,OAAM;YAErB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;YAE5B,MAAM,OAAO,GAAM,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAC9C,MAAM,OAAO,GAAM,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAC9C,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YACjD,MAAM,SAAS,GAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAEhD,QAAQ,CAAC,GAAG,GAAG,KAAK,EAAe,GAAW,EAAqB,EAAE;gBACnE,MAAM,KAAK,GAAG,MAAO,OAA8C,CAAC,GAAG,CAAC,CAAA;gBACxE,MAAM,EAAE,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAA;gBAC1C,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;gBACtF,OAAO,KAAK,CAAA;YACd,CAAC,CAAA;YAED,QAAQ,CAAC,GAAG,GAAG,KAAK,EAAE,GAAW,EAAE,KAAc,EAAE,GAAY,EAAiB,EAAE;gBAChF,MAAO,OAAwE,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,CAAA;gBAChG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAA;YAC9F,CAAC,CAAA;YAED,QAAQ,CAAC,MAAM,GAAG,KAAK,EAAE,GAAW,EAAiB,EAAE;gBACrD,MAAO,UAA6C,CAAC,GAAG,CAAC,CAAA;gBACzD,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAA;YAC/F,CAAC,CAAA;YAED,QAAQ,CAAC,KAAK,GAAG,KAAK,IAAmB,EAAE;gBACzC,MAAO,SAAiC,EAAE,CAAA;gBAC1C,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAA;YACxF,CAAC,CAAA;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/collectors/cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAE/C;;;GAGG;AACH,MAAM,OAAO,cAAc;IAII;IAHpB,IAAI,GAAG,iBAAiB,CAAA;IACxB,IAAI,GAAG,OAAgB,CAAA;IAEhC,YAA6B,OAAyB;QAAzB,YAAO,GAAP,OAAO,CAAkB;IAAG,CAAC;IAE1D,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC;YACH,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAA;YACzD,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,EAAE,CAAA;YACpC,IAAI,CAAC,QAAQ;gBAAE,OAAM;YAErB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;YAE5B,MAAM,OAAO,GAAM,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAC9C,MAAM,OAAO,GAAM,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAC9C,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YACjD,MAAM,SAAS,GAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAEhD,QAAQ,CAAC,GAAG,GAAG,KAAK,EAAe,GAAW,EAAqB,EAAE;gBACnE,MAAM,KAAK,GAAG,MAAO,OAA8C,CAAC,GAAG,CAAC,CAAA;gBACxE,MAAM,EAAE,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAA;gBAC1C,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,GAAG,SAAS,EAAE,EAAE,CAAC,CAAC,CAAA;gBACtG,OAAO,KAAK,CAAA;YACd,CAAC,CAAA;YAED,QAAQ,CAAC,GAAG,GAAG,KAAK,EAAE,GAAW,EAAE,KAAc,EAAE,GAAY,EAAiB,EAAE;gBAChF,MAAO,OAAwE,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,CAAA;gBAChG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE,GAAG,SAAS,EAAE,EAAE,CAAC,CAAC,CAAA;YAC9G,CAAC,CAAA;YAED,QAAQ,CAAC,MAAM,GAAG,KAAK,EAAE,GAAW,EAAiB,EAAE;gBACrD,MAAO,UAA6C,CAAC,GAAG,CAAC,CAAA;gBACzD,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,cAAc,CAAC,EAAE,GAAG,SAAS,EAAE,EAAE,CAAC,CAAC,CAAA;YAC/G,CAAC,CAAA;YAED,QAAQ,CAAC,KAAK,GAAG,KAAK,IAAmB,EAAE;gBACzC,MAAO,SAAiC,EAAE,CAAA;gBAC1C,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,aAAa,CAAC,EAAE,GAAG,SAAS,EAAE,EAAE,CAAC,CAAC,CAAA;YACxG,CAAC,CAAA;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;IACH,CAAC;CACF"}