@adonis-agora/telescope 0.1.0

package/dist/providers/telescope_watchers_provider.d.ts

@@ -0,0 +1,31 @@
+import type { ApplicationService } from '@adonisjs/core/types';
+/**
+ * Wires `@adonis-agora/telescope/watchers` into the AdonisJS application.
+ *
+ * - `boot()` reads `config/telescope_watchers.ts` (falling back to a `watchers`
+ *   key on `config/telescope.ts`), resolves the application emitter from the
+ *   container, and starts each enabled watcher against it. Each watcher records
+ *   through `@adonis-agora/telescope`'s runtime store handle — no DI required.
+ * - `shutdown()` stops every started watcher (full unsubscribe).
+ *
+ * Watchers never throw into the app: a missing config, a missing emitter, or a
+ * disabled telescope all degrade to recording nothing.
+ */
+export default class TelescopeWatchersProvider {
+    protected app: ApplicationService;
+    private readonly started;
+    constructor(app: ApplicationService);
+    /** Read the watchers config from its own file or the telescope config block. */
+    private resolve;
+    boot(): Promise<void>;
+    /** Start the http-client watcher: it patches the global `fetch`, so it needs
+     *  no emitter and no container resolution. */
+    private startHttpClientWatcher;
+    /** Start the logs watcher: it taps the application logger resolved from the
+     *  container (instance-scoped, reversible method tee — no global patching). */
+    private startLogsWatcher;
+    /** Start one watcher, never letting a watcher's `start` break boot. */
+    private startWatcher;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=telescope_watchers_provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telescope_watchers_provider.d.ts","sourceRoot":"","sources":["../../providers/telescope_watchers_provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAqB/D;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,OAAO,yBAAyB;IAGhC,SAAS,CAAC,GAAG,EAAE,kBAAkB;IAF7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;gBAE3C,GAAG,EAAE,kBAAkB;IAE7C,gFAAgF;IAChF,OAAO,CAAC,OAAO;IAeT,IAAI;IAoBV;kDAC8C;IAC9C,OAAO,CAAC,sBAAsB;IAW9B;mFAC+E;YACjE,gBAAgB;IAmB9B,uEAAuE;IACvE,OAAO,CAAC,YAAY;IAYd,QAAQ;CAUf"}

package/dist/providers/telescope_watchers_provider.js

@@ -0,0 +1,116 @@
+import { CacheWatcher } from '../src/watchers/cache_watcher.js';
+import { resolveConfig, } from '../src/watchers/define_config.js';
+import { HttpClientWatcher } from '../src/watchers/http_client_watcher.js';
+import { LogsWatcher } from '../src/watchers/logs_watcher.js';
+import { LucidQueryWatcher } from '../src/watchers/lucid_query_watcher.js';
+import { MailWatcher } from '../src/watchers/mail_watcher.js';
+/**
+ * Wires `@adonis-agora/telescope/watchers` into the AdonisJS application.
+ *
+ * - `boot()` reads `config/telescope_watchers.ts` (falling back to a `watchers`
+ *   key on `config/telescope.ts`), resolves the application emitter from the
+ *   container, and starts each enabled watcher against it. Each watcher records
+ *   through `@adonis-agora/telescope`'s runtime store handle — no DI required.
+ * - `shutdown()` stops every started watcher (full unsubscribe).
+ *
+ * Watchers never throw into the app: a missing config, a missing emitter, or a
+ * disabled telescope all degrade to recording nothing.
+ */
+export default class TelescopeWatchersProvider {
+    app;
+    started = [];
+    constructor(app) {
+        this.app = app;
+    }
+    /** Read the watchers config from its own file or the telescope config block. */
+    resolve() {
+        const own = this.app.config.get('telescope_watchers', undefined);
+        if (own !== undefined)
+            return resolveConfig(own);
+        // Fall back to a `watchers` block on the main telescope config, if present.
+        const fromTelescope = this.app.config.get('telescope.watchers_config', undefined);
+        return resolveConfig(fromTelescope);
+    }
+    async boot() {
+        const config = this.resolve();
+        if (!config.enabled)
+            return;
+        let emitter;
+        try {
+            emitter = (await this.app.container.make('emitter'));
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(`TelescopeWatchersProvider: could not resolve the emitter: ${message}`);
+            return;
+        }
+        if (config.watchers.has('query'))
+            this.startWatcher(new LucidQueryWatcher(), emitter);
+        if (config.watchers.has('mail'))
+            this.startWatcher(new MailWatcher(), emitter);
+        if (config.watchers.has('cache'))
+            this.startWatcher(new CacheWatcher(), emitter);
+        if (config.watchers.has('http-client'))
+            this.startHttpClientWatcher();
+        if (config.watchers.has('logs'))
+            await this.startLogsWatcher();
+    }
+    /** Start the http-client watcher: it patches the global `fetch`, so it needs
+     *  no emitter and no container resolution. */
+    startHttpClientWatcher() {
+        const watcher = new HttpClientWatcher();
+        try {
+            watcher.start();
+            this.started.push(watcher);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(`TelescopeWatchersProvider: failed to start http-client watcher: ${message}`);
+        }
+    }
+    /** Start the logs watcher: it taps the application logger resolved from the
+     *  container (instance-scoped, reversible method tee — no global patching). */
+    async startLogsWatcher() {
+        let logger;
+        try {
+            logger = (await this.app.container.make('logger'));
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(`TelescopeWatchersProvider: could not resolve the logger: ${message}`);
+            return;
+        }
+        const watcher = new LogsWatcher();
+        try {
+            watcher.start(logger);
+            this.started.push(watcher);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(`TelescopeWatchersProvider: failed to start logs watcher: ${message}`);
+        }
+    }
+    /** Start one watcher, never letting a watcher's `start` break boot. */
+    startWatcher(watcher, emitter) {
+        try {
+            watcher.start(emitter);
+            this.started.push(watcher);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(`TelescopeWatchersProvider: failed to start ${watcher.type} watcher: ${message}`);
+        }
+    }
+    async shutdown() {
+        for (const watcher of this.started) {
+            try {
+                watcher.stop();
+            }
+            catch {
+                // never throw out of shutdown
+            }
+        }
+        this.started.length = 0;
+    }
+}
+//# sourceMappingURL=telescope_watchers_provider.js.map

package/dist/providers/telescope_watchers_provider.js.map

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

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

@@ -0,0 +1,56 @@
+/**
+ * Default Claude model for diagnosis. Sonnet 4.6 is the best speed/intelligence
+ * balance for a short structured triage; override with a more capable model
+ * (`claude-opus-4-8`) or a cheaper one (`claude-haiku-4-5-20251001`) in config.
+ */
+declare const DEFAULT_MODEL = "claude-sonnet-4-6";
+/**
+ * Default cap on generated tokens. The system prompt asks for a bounded JSON
+ * object, but we also cap at the API level so a runaway model can't produce a
+ * huge, expensive response. 1024 tokens comfortably fits cause + fix + confidence.
+ */
+declare const DEFAULT_MAX_TOKENS = 1024;
+/**
+ * The shape of `config/telescope_ai.ts`. The API key is sourced from the
+ * environment via the host's `env.get(...)` — never hardcoded — so it stays out of
+ * source control.
+ */
+export interface TelescopeAiConfig {
+    /**
+     * Master switch. When `false` (or when no `apiKey` resolves), the diagnoser is a
+     * no-op: `diagnose` returns `null` and never calls the API. Default `true`.
+     */
+    enabled?: boolean;
+    /**
+     * The Anthropic API key, e.g. `env.get('ANTHROPIC_API_KEY')`. When absent the
+     * diagnoser is effectively disabled (no-op), so the package degrades safely with
+     * no key configured.
+     */
+    apiKey?: string;
+    /** Claude model id. Default `claude-sonnet-4-6`. */
+    model?: string;
+    /** Hard cap on generated tokens per diagnosis. Default 1024. */
+    maxTokens?: number;
+}
+/** The fully-resolved AI config the diagnoser acts on (no optionals). */
+export interface ResolvedTelescopeAiConfig {
+    enabled: boolean;
+    apiKey: string | null;
+    model: string;
+    maxTokens: number;
+}
+/**
+ * Identity helper giving `config/telescope_ai.ts` full type-checking, mirroring the
+ * AdonisJS `defineConfig` convention.
+ *
+ * ```ts
+ * import env from '#start/env'
+ * import { defineConfig } from '@adonis-agora/telescope/ai'
+ * export default defineConfig({ apiKey: env.get('ANTHROPIC_API_KEY') })
+ * ```
+ */
+export declare function defineConfig(config: TelescopeAiConfig): TelescopeAiConfig;
+/** Apply defaults to a (possibly partial) config. */
+export declare function resolveConfig(config?: TelescopeAiConfig): ResolvedTelescopeAiConfig;
+export { DEFAULT_MODEL, DEFAULT_MAX_TOKENS };
+//# sourceMappingURL=define_config.d.ts.map

package/dist/src/ai/define_config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define_config.d.ts","sourceRoot":"","sources":["../../../src/ai/define_config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,QAAA,MAAM,aAAa,sBAAsB,CAAC;AAE1C;;;;GAIG;AACH,QAAA,MAAM,kBAAkB,OAAO,CAAC;AAEhC;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,yEAAyE;AACzE,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,CAEzE;AAED,qDAAqD;AACrD,wBAAgB,aAAa,CAAC,MAAM,GAAE,iBAAsB,GAAG,yBAAyB,CAWvF;AAED,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/src/ai/define_config.js

@@ -0,0 +1,39 @@
+/**
+ * Default Claude model for diagnosis. Sonnet 4.6 is the best speed/intelligence
+ * balance for a short structured triage; override with a more capable model
+ * (`claude-opus-4-8`) or a cheaper one (`claude-haiku-4-5-20251001`) in config.
+ */
+const DEFAULT_MODEL = 'claude-sonnet-4-6';
+/**
+ * Default cap on generated tokens. The system prompt asks for a bounded JSON
+ * object, but we also cap at the API level so a runaway model can't produce a
+ * huge, expensive response. 1024 tokens comfortably fits cause + fix + confidence.
+ */
+const DEFAULT_MAX_TOKENS = 1024;
+/**
+ * Identity helper giving `config/telescope_ai.ts` full type-checking, mirroring the
+ * AdonisJS `defineConfig` convention.
+ *
+ * ```ts
+ * import env from '#start/env'
+ * import { defineConfig } from '@adonis-agora/telescope/ai'
+ * export default defineConfig({ apiKey: env.get('ANTHROPIC_API_KEY') })
+ * ```
+ */
+export function defineConfig(config) {
+    return config;
+}
+/** Apply defaults to a (possibly partial) config. */
+export function resolveConfig(config = {}) {
+    const apiKey = typeof config.apiKey === 'string' && config.apiKey.trim() !== '' ? config.apiKey : null;
+    return {
+        // A configured-but-keyless install is treated as disabled so nothing ever
+        // calls the API without credentials.
+        enabled: (config.enabled ?? true) && apiKey !== null,
+        apiKey,
+        model: config.model ?? DEFAULT_MODEL,
+        maxTokens: config.maxTokens ?? DEFAULT_MAX_TOKENS,
+    };
+}
+export { DEFAULT_MODEL, DEFAULT_MAX_TOKENS };
+//# sourceMappingURL=define_config.js.map

package/dist/src/ai/define_config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define_config.js","sourceRoot":"","sources":["../../../src/ai/define_config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,aAAa,GAAG,mBAAmB,CAAC;AAE1C;;;;GAIG;AACH,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAiChC;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,MAAyB;IACpD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,aAAa,CAAC,SAA4B,EAAE;IAC1D,MAAM,MAAM,GACV,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1F,OAAO;QACL,0EAA0E;QAC1E,qCAAqC;QACrC,OAAO,EAAE,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,MAAM,KAAK,IAAI;QACpD,MAAM;QACN,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,aAAa;QACpC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,kBAAkB;KAClD,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,CAAC"}

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

@@ -0,0 +1,34 @@
+export type { ExceptionEntryContent } from '../exception_watcher.js';
+/** A diagnosis confidence level, as returned by the model. */
+export type DiagnosisConfidence = 'high' | 'medium' | 'low';
+/**
+ * A structured AI diagnosis of one exception family. Returned by
+ * {@link TelescopeAiDiagnoser.diagnose} and cached by family hash.
+ */
+export interface Diagnosis {
+    /** Likely root cause — what failed and why. */
+    cause: string;
+    /** A concrete, actionable suggested fix. */
+    fix: string;
+    /** The model's confidence in this diagnosis. */
+    confidence: DiagnosisConfidence;
+    /** The model id that produced this diagnosis. */
+    model: string;
+    /** Whether this result was served from the cache (vs a fresh API call). */
+    cached: boolean;
+}
+/** Narrow an arbitrary string to a {@link DiagnosisConfidence}, defaulting to `low`. */
+export declare function normalizeConfidence(value: unknown): DiagnosisConfidence;
+/**
+ * Parse the model's text response into a partial diagnosis ({@link cause} +
+ * {@link fix} + {@link confidence}), defensively. The model is asked for a bare
+ * JSON object, but it may wrap it in markdown fences or add stray prose; we
+ * extract the first balanced `{...}` and tolerate missing fields. Throws only
+ * when no JSON object can be located at all.
+ */
+export declare function parseDiagnosis(text: string): {
+    cause: string;
+    fix: string;
+    confidence: DiagnosisConfidence;
+};
+//# sourceMappingURL=diagnoser.d.ts.map

package/dist/src/ai/diagnoser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnoser.d.ts","sourceRoot":"","sources":["../../../src/ai/diagnoser.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE,8DAA8D;AAC9D,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE5D;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,UAAU,EAAE,mBAAmB,CAAC;IAChC,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAMvE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,mBAAmB,CAAC;CACjC,CAqBA"}

package/dist/src/ai/diagnoser.js

@@ -0,0 +1,74 @@
+/** Narrow an arbitrary string to a {@link DiagnosisConfidence}, defaulting to `low`. */
+export function normalizeConfidence(value) {
+    if (typeof value === 'string') {
+        const v = value.trim().toLowerCase();
+        if (v === 'high' || v === 'medium' || v === 'low')
+            return v;
+    }
+    return 'low';
+}
+/**
+ * Parse the model's text response into a partial diagnosis ({@link cause} +
+ * {@link fix} + {@link confidence}), defensively. The model is asked for a bare
+ * JSON object, but it may wrap it in markdown fences or add stray prose; we
+ * extract the first balanced `{...}` and tolerate missing fields. Throws only
+ * when no JSON object can be located at all.
+ */
+export function parseDiagnosis(text) {
+    const json = extractJsonObject(text);
+    if (json === null) {
+        throw new Error('AI diagnosis response did not contain a JSON object');
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(json);
+    }
+    catch {
+        throw new Error('AI diagnosis response was not valid JSON');
+    }
+    const record = typeof parsed === 'object' && parsed !== null ? parsed : {};
+    return {
+        cause: typeof record.cause === 'string' ? record.cause : '',
+        fix: typeof record.fix === 'string' ? record.fix : '',
+        confidence: normalizeConfidence(record.confidence),
+    };
+}
+/**
+ * Extract the first balanced top-level `{...}` from `text`, ignoring braces inside
+ * strings. Returns `null` when none is found. This survives markdown fences and
+ * leading/trailing prose around the JSON.
+ */
+function extractJsonObject(text) {
+    const start = text.indexOf('{');
+    if (start === -1)
+        return null;
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    for (let i = start; i < text.length; i++) {
+        const char = text[i];
+        if (escaped) {
+            escaped = false;
+            continue;
+        }
+        if (char === '\\') {
+            escaped = true;
+            continue;
+        }
+        if (char === '"') {
+            inString = !inString;
+            continue;
+        }
+        if (inString)
+            continue;
+        if (char === '{')
+            depth++;
+        else if (char === '}') {
+            depth--;
+            if (depth === 0)
+                return text.slice(start, i + 1);
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=diagnoser.js.map

package/dist/src/ai/diagnoser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnoser.js","sourceRoot":"","sources":["../../../src/ai/diagnoser.ts"],"names":[],"mappings":"AAwBA,wFAAwF;AACxF,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,KAAK;YAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IAKzC,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,MAAM,GACV,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,CAAC,CAAC,CAAE,MAAkC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE3F,OAAO;QACL,KAAK,EAAE,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QAC3D,GAAG,EAAE,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QACrD,UAAU,EAAE,mBAAmB,CAAC,MAAM,CAAC,UAAU,CAAC;KACnD,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,iBAAiB,CAAC,IAAY;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAE9B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,GAAG,KAAK,CAAC;YAChB,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO,GAAG,IAAI,CAAC;YACf,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,QAAQ,GAAG,CAAC,QAAQ,CAAC;YACrB,SAAS;QACX,CAAC;QACD,IAAI,QAAQ;YAAE,SAAS;QACvB,IAAI,IAAI,KAAK,GAAG;YAAE,KAAK,EAAE,CAAC;aACrB,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACtB,KAAK,EAAE,CAAC;YACR,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,43 @@
+import type { Diagnosis } from './diagnoser.js';
+/** Default cap on cached diagnoses. Bounds memory regardless of error variety. */
+declare const DEFAULT_MAX_ENTRIES = 500;
+/** Default time a cached diagnosis stays fresh: 24h. */
+declare const DEFAULT_TTL_MS: number;
+/**
+ * The pluggable cache contract a diagnoser reads/writes through, keyed by
+ * exception family hash. A host can swap in a Redis- or DB-backed implementation
+ * for cross-process sharing; the default is the in-memory LRU below.
+ */
+export interface DiagnosisStore {
+    get(familyHash: string): Diagnosis | null;
+    set(familyHash: string, diagnosis: Diagnosis): void;
+}
+/**
+ * Bounded, TTL'd, in-process LRU cache of AI diagnoses keyed by exception
+ * `familyHash`. A family is diagnosed ONCE then served from here, so re-diagnosing
+ * the same error never burns model tokens.
+ *
+ * Eviction is insertion-order (`Map` iteration): at the cap the OLDEST inserted
+ * entry is dropped, and a re-set entry moves to the end (LRU-on-write). TTL is
+ * checked lazily on read (an expired hit is a miss and is deleted), so stale
+ * entries don't linger as false "cached" results.
+ */
+export declare class DiagnosisCache implements DiagnosisStore {
+    private readonly entries;
+    private readonly maxEntries;
+    private readonly ttlMs;
+    private readonly now;
+    constructor(options?: {
+        maxEntries?: number;
+        ttlMs?: number;
+        now?: () => number;
+    });
+    /** The cached diagnosis for `familyHash`, or `null` on a miss / expiry. */
+    get(familyHash: string): Diagnosis | null;
+    /** Store (or refresh) the diagnosis for `familyHash`, evicting if over cap. */
+    set(familyHash: string, diagnosis: Diagnosis): void;
+    /** Number of live entries (test/observability seam; does not evict expired). */
+    get size(): number;
+}
+export { DEFAULT_MAX_ENTRIES as DEFAULT_DIAGNOSIS_CACHE_MAX, DEFAULT_TTL_MS as DEFAULT_DIAGNOSIS_TTL_MS, };
+//# sourceMappingURL=diagnosis_cache.d.ts.map

package/dist/src/ai/diagnosis_cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnosis_cache.d.ts","sourceRoot":"","sources":["../../../src/ai/diagnosis_cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,kFAAkF;AAClF,QAAA,MAAM,mBAAmB,MAAM,CAAC;AAEhC,wDAAwD;AACxD,QAAA,MAAM,cAAc,QAAsB,CAAC;AAO3C;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAC1C,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;CACrD;AAED;;;;;;;;;GASG;AACH,qBAAa,cAAe,YAAW,cAAc;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAEvB,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;KAAE;IAMjF,2EAA2E;IAC3E,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAazC,+EAA+E;IAC/E,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAUnD,gFAAgF;IAChF,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED,OAAO,EACL,mBAAmB,IAAI,2BAA2B,EAClD,cAAc,IAAI,wBAAwB,GAC3C,CAAC"}

package/dist/src/ai/diagnosis_cache.js

@@ -0,0 +1,56 @@
+/** Default cap on cached diagnoses. Bounds memory regardless of error variety. */
+const DEFAULT_MAX_ENTRIES = 500;
+/** Default time a cached diagnosis stays fresh: 24h. */
+const DEFAULT_TTL_MS = 24 * 60 * 60 * 1000;
+/**
+ * Bounded, TTL'd, in-process LRU cache of AI diagnoses keyed by exception
+ * `familyHash`. A family is diagnosed ONCE then served from here, so re-diagnosing
+ * the same error never burns model tokens.
+ *
+ * Eviction is insertion-order (`Map` iteration): at the cap the OLDEST inserted
+ * entry is dropped, and a re-set entry moves to the end (LRU-on-write). TTL is
+ * checked lazily on read (an expired hit is a miss and is deleted), so stale
+ * entries don't linger as false "cached" results.
+ */
+export class DiagnosisCache {
+    entries = new Map();
+    maxEntries;
+    ttlMs;
+    now;
+    constructor(options) {
+        this.maxEntries = options?.maxEntries ?? DEFAULT_MAX_ENTRIES;
+        this.ttlMs = options?.ttlMs ?? DEFAULT_TTL_MS;
+        this.now = options?.now ?? Date.now;
+    }
+    /** The cached diagnosis for `familyHash`, or `null` on a miss / expiry. */
+    get(familyHash) {
+        const entry = this.entries.get(familyHash);
+        if (entry === undefined)
+            return null;
+        if (this.now() - entry.storedAt >= this.ttlMs) {
+            this.entries.delete(familyHash);
+            return null;
+        }
+        // Refresh recency so genuinely-cold entries are the ones evicted at the cap.
+        this.entries.delete(familyHash);
+        this.entries.set(familyHash, entry);
+        return entry.diagnosis;
+    }
+    /** Store (or refresh) the diagnosis for `familyHash`, evicting if over cap. */
+    set(familyHash, diagnosis) {
+        this.entries.delete(familyHash);
+        this.entries.set(familyHash, { diagnosis, storedAt: this.now() });
+        while (this.entries.size > this.maxEntries) {
+            const oldest = this.entries.keys().next().value;
+            if (oldest === undefined)
+                break;
+            this.entries.delete(oldest);
+        }
+    }
+    /** Number of live entries (test/observability seam; does not evict expired). */
+    get size() {
+        return this.entries.size;
+    }
+}
+export { DEFAULT_MAX_ENTRIES as DEFAULT_DIAGNOSIS_CACHE_MAX, DEFAULT_TTL_MS as DEFAULT_DIAGNOSIS_TTL_MS, };
+//# sourceMappingURL=diagnosis_cache.js.map

package/dist/src/ai/diagnosis_cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnosis_cache.js","sourceRoot":"","sources":["../../../src/ai/diagnosis_cache.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC,wDAAwD;AACxD,MAAM,cAAc,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAiB3C;;;;;;;;;GASG;AACH,MAAM,OAAO,cAAc;IACR,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IACxC,UAAU,CAAS;IACnB,KAAK,CAAS;IACd,GAAG,CAAe;IAEnC,YAAY,OAAqE;QAC/E,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,mBAAmB,CAAC;QAC7D,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,cAAc,CAAC;QAC9C,IAAI,CAAC,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACtC,CAAC;IAED,2EAA2E;IAC3E,GAAG,CAAC,UAAkB;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC3C,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACrC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,6EAA6E;QAC7E,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACpC,OAAO,KAAK,CAAC,SAAS,CAAC;IACzB,CAAC;IAED,+EAA+E;IAC/E,GAAG,CAAC,UAAkB,EAAE,SAAoB;QAC1C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAClE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAChD,IAAI,MAAM,KAAK,SAAS;gBAAE,MAAM;YAChC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,gFAAgF;IAChF,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;CACF;AAED,OAAO,EACL,mBAAmB,IAAI,2BAA2B,EAClD,cAAc,IAAI,wBAAwB,GAC3C,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { ResolvedTelescopeAiConfig } from './define_config.js';
+import type { DiagnosisStore } from './diagnosis_cache.js';
+import { TelescopeAiDiagnoser } from './telescope_ai_diagnoser.js';
+/**
+ * Build a {@link TelescopeAiDiagnoser} from a resolved config, constructing the
+ * real Anthropic SDK client from `config.apiKey`. Returns `null` when AI is
+ * disabled or no key resolved — so the provider can wire a no-op without callers
+ * branching. A custom `cache` (e.g. Redis-backed) can be supplied for
+ * cross-process diagnosis sharing.
+ */
+export declare function createDiagnoser(config: ResolvedTelescopeAiConfig, options?: {
+    cache?: DiagnosisStore;
+    logger?: (message: string) => void;
+}): TelescopeAiDiagnoser | null;
+//# sourceMappingURL=factory.d.ts.map

package/dist/src/ai/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/ai/factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAgC,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEjG;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,yBAAyB,EACjC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,cAAc,CAAC;IAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAAO,GAC3E,oBAAoB,GAAG,IAAI,CAc7B"}

package/dist/src/ai/factory.js

@@ -0,0 +1,24 @@
+import Anthropic from '@anthropic-ai/sdk';
+import { TelescopeAiDiagnoser } from './telescope_ai_diagnoser.js';
+/**
+ * Build a {@link TelescopeAiDiagnoser} from a resolved config, constructing the
+ * real Anthropic SDK client from `config.apiKey`. Returns `null` when AI is
+ * disabled or no key resolved — so the provider can wire a no-op without callers
+ * branching. A custom `cache` (e.g. Redis-backed) can be supplied for
+ * cross-process diagnosis sharing.
+ */
+export function createDiagnoser(config, options = {}) {
+    if (!config.enabled || config.apiKey === null)
+        return null;
+    // The SDK's `Anthropic` instance satisfies the structural client contract.
+    const client = new Anthropic({ apiKey: config.apiKey });
+    return new TelescopeAiDiagnoser({
+        client,
+        model: config.model,
+        maxTokens: config.maxTokens,
+        enabled: true,
+        ...(options.cache !== undefined ? { cache: options.cache } : {}),
+        ...(options.logger !== undefined ? { logger: options.logger } : {}),
+    });
+}
+//# sourceMappingURL=factory.js.map

package/dist/src/ai/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/ai/factory.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAG1C,OAAO,EAAgC,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEjG;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAiC,EACjC,UAA0E,EAAE;IAE5E,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAE3D,2EAA2E;IAC3E,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAuC,CAAC;IAE9F,OAAO,IAAI,oBAAoB,CAAC;QAC9B,MAAM;QACN,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,OAAO,EAAE,IAAI;QACb,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpE,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,14 @@
+/** Keep in sync with this package's `version` in package.json. */
+export declare const VERSION = "0.1.0";
+export { TelescopeAiDiagnoser } from './telescope_ai_diagnoser.js';
+export type { AnthropicMessagesClient, DiagnoseOptions, TelescopeAiDiagnoserOptions, } from './telescope_ai_diagnoser.js';
+export { normalizeConfidence, parseDiagnosis } from './diagnoser.js';
+export type { Diagnosis, DiagnosisConfidence, ExceptionEntryContent } from './diagnoser.js';
+export { DEFAULT_DIAGNOSIS_CACHE_MAX, DEFAULT_DIAGNOSIS_TTL_MS, DiagnosisCache, } from './diagnosis_cache.js';
+export type { DiagnosisStore } from './diagnosis_cache.js';
+export { buildUserPrompt, STACK_FRAME_LIMIT, SYSTEM_PROMPT } from './prompt.js';
+export type { RelatedEntrySummary } from './prompt.js';
+export { createDiagnoser } from './factory.js';
+export { DEFAULT_MAX_TOKENS, DEFAULT_MODEL, defineConfig, resolveConfig, } from './define_config.js';
+export type { ResolvedTelescopeAiConfig, TelescopeAiConfig, } from './define_config.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,YAAY,EACV,uBAAuB,EACvB,eAAe,EACf,2BAA2B,GAC5B,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrE,YAAY,EAAE,SAAS,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAG5F,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChF,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGvD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC"}

package/dist/src/ai/index.js

@@ -0,0 +1,15 @@
+/** Keep in sync with this package's `version` in package.json. */
+export const VERSION = '0.1.0';
+// — diagnoser —
+export { TelescopeAiDiagnoser } from './telescope_ai_diagnoser.js';
+// — diagnosis model + parsing —
+export { normalizeConfidence, parseDiagnosis } from './diagnoser.js';
+// — cache —
+export { DEFAULT_DIAGNOSIS_CACHE_MAX, DEFAULT_DIAGNOSIS_TTL_MS, DiagnosisCache, } from './diagnosis_cache.js';
+// — prompt —
+export { buildUserPrompt, STACK_FRAME_LIMIT, SYSTEM_PROMPT } from './prompt.js';
+// — factory (constructs the real Anthropic client) —
+export { createDiagnoser } from './factory.js';
+// — config —
+export { DEFAULT_MAX_TOKENS, DEFAULT_MODEL, defineConfig, resolveConfig, } from './define_config.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,gBAAgB;AAChB,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAOnE,gCAAgC;AAChC,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrE,YAAY;AACZ,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAG9B,aAAa;AACb,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGhF,qDAAqD;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,aAAa;AACb,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,aAAa,GACd,MAAM,oBAAoB,CAAC"}

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

@@ -0,0 +1,31 @@
+import type { Entry } from '../entry.js';
+import type { ExceptionEntryContent } from './diagnoser.js';
+/**
+ * Cap on stack frames sent to the model. The TOP frames carry the throw site and
+ * the immediate callers — the highest-signal part for root-causing — while a deep
+ * tail mostly burns input tokens. Clipping keeps the prompt bounded and cheap.
+ */
+declare const STACK_FRAME_LIMIT = 25;
+/**
+ * The system prompt. Frames the model as a senior engineer triaging a PRODUCTION
+ * exception and pins the OUTPUT CONTRACT to a strict JSON object so the result is
+ * machine-parseable (cause / fix / confidence) for the dashboard and any
+ * downstream alerting. We ask for confidence explicitly so an operator can
+ * calibrate trust — a low-confidence guess is still useful but should be read as
+ * such.
+ */
+export declare const SYSTEM_PROMPT: string;
+/** A related (non-exception) entry summary fed into the prompt. */
+export interface RelatedEntrySummary {
+    type: string;
+    summary: string;
+}
+/**
+ * Assemble the USER message from an exception entry and any related trace entries.
+ * Plain labelled sections (not JSON) read better for an LLM. Absent fields are
+ * omitted rather than rendered as `null`, so the model isn't nudged to comment on
+ * missing data.
+ */
+export declare function buildUserPrompt(entry: Entry<ExceptionEntryContent>, related?: RelatedEntrySummary[]): string;
+export { STACK_FRAME_LIMIT };
+//# sourceMappingURL=prompt.d.ts.map

package/dist/src/ai/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/ai/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D;;;;GAIG;AACH,QAAA,MAAM,iBAAiB,KAAK,CAAC;AAE7B;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,QAgBd,CAAC;AAEb,mEAAmE;AACnE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,KAAK,CAAC,qBAAqB,CAAC,EACnC,OAAO,GAAE,mBAAmB,EAAO,GAClC,MAAM,CAuBR;AAOD,OAAO,EAAE,iBAAiB,EAAE,CAAC"}