@agentlensai/server 0.10.0 → 0.13.0

package/dist/lib/diagnostics/context-builder.js

@@ -0,0 +1,135 @@
+/**
+ * Diagnostic Context Builders (Stories 18.3, 18.4)
+ *
+ * Collects and sanitizes data for LLM-powered diagnostics.
+ */
+import { HealthComputer } from '../health/computer.js';
+import { DEFAULT_HEALTH_WEIGHTS } from '@agentlensai/core';
+import { runAnalysis } from '../analysis/index.js';
+import { sanitizeForLLM } from '../error-sanitizer.js';
+/**
+ * Build agent-level diagnostic context.
+ * Collects health + 4 analyses in parallel, applies sanitization and limits.
+ */
+export async function buildAgentContext(store, agentId, windowDays) {
+    const now = new Date();
+    const from = new Date(now.getTime() - windowDays * 86400000).toISOString();
+    const to = now.toISOString();
+    const computer = new HealthComputer(DEFAULT_HEALTH_WEIGHTS);
+    const analysisOpts = { agentId, from, to };
+    const [health, errorPatterns, toolSequences, costAnalysis, performanceTrends] = await Promise.all([
+        computer.compute(store, agentId, windowDays),
+        runAnalysis('error_patterns', store, analysisOpts),
+        runAnalysis('tool_sequences', store, analysisOpts),
+        runAnalysis('cost_analysis', store, analysisOpts),
+        runAnalysis('performance_trends', store, analysisOpts),
+    ]);
+    if (!health) {
+        throw Object.assign(new Error('No session data for agent in the specified window'), {
+            status: 404,
+        });
+    }
+    // Apply limits (architecture §6.4)
+    const limitInsights = (result, max) => ({
+        ...result,
+        insights: result.insights.slice(0, max).map((insight) => ({
+            ...insight,
+            summary: sanitizeForLLM(insight.summary),
+            data: truncateData(insight.data),
+        })),
+    });
+    return {
+        agentId,
+        windowDays,
+        health,
+        errorPatterns: limitInsights(errorPatterns, 10),
+        toolSequences: limitInsights(toolSequences, 10),
+        costAnalysis: limitInsights(costAnalysis, 10),
+        performanceTrends: limitInsights(performanceTrends, 10),
+    };
+}
+/**
+ * Build session-level diagnostic context.
+ */
+export async function buildSessionContext(store, sessionId) {
+    const session = await store.getSession(sessionId);
+    if (!session) {
+        throw Object.assign(new Error('Session not found'), { status: 404 });
+    }
+    let timeline = await store.getSessionTimeline(sessionId);
+    // Limit to last 200 events
+    if (timeline.length > 200) {
+        timeline = timeline.slice(-200);
+    }
+    // Extract error events
+    const errorEvents = timeline.filter((e) => e.eventType === 'error' || e.eventType === 'tool_error');
+    // Build tool call chain
+    const toolCallChain = [];
+    for (const event of timeline) {
+        if (event.eventType === 'tool_call') {
+            const payload = event.payload;
+            toolCallChain.push({
+                tool: payload.toolName ?? payload.name ?? 'unknown',
+                success: true, // updated by subsequent response/error
+                duration: undefined,
+            });
+        }
+        else if (event.eventType === 'tool_response' || event.eventType === 'tool_error') {
+            const last = toolCallChain[toolCallChain.length - 1];
+            if (last) {
+                const payload = event.payload;
+                last.success = event.eventType === 'tool_response' && payload.isError !== true;
+                if (payload.durationMs)
+                    last.duration = payload.durationMs;
+            }
+        }
+    }
+    // Build cost breakdown from llm_response events
+    const costMap = new Map();
+    for (const event of timeline) {
+        if (event.eventType === 'llm_response') {
+            const payload = event.payload;
+            const model = payload.model ?? 'unknown';
+            const cost = payload.costUsd ?? 0;
+            const tokens = (payload.inputTokens ?? 0) + (payload.outputTokens ?? 0);
+            const existing = costMap.get(model) ?? { cost: 0, tokens: 0 };
+            costMap.set(model, { cost: existing.cost + cost, tokens: existing.tokens + tokens });
+        }
+    }
+    // Sanitize error messages in timeline
+    const sanitizedTimeline = timeline.map((e) => {
+        if (e.eventType === 'error' || e.eventType === 'tool_error') {
+            const payload = e.payload;
+            if (payload.message && typeof payload.message === 'string') {
+                return { ...e, payload: { ...payload, message: sanitizeForLLM(payload.message) } };
+            }
+        }
+        return e;
+    });
+    return {
+        sessionId,
+        session,
+        timeline: sanitizedTimeline,
+        errorEvents,
+        toolCallChain,
+        costBreakdown: Array.from(costMap.entries()).map(([model, data]) => ({
+            model,
+            ...data,
+        })),
+    };
+}
+// ─── Helpers ─────────────────────────────────────────────
+/** Truncate data blob values to 500 chars */
+function truncateData(data) {
+    const result = {};
+    for (const [key, value] of Object.entries(data)) {
+        if (typeof value === 'string' && value.length > 500) {
+            result[key] = value.slice(0, 497) + '...';
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=context-builder.js.map

package/dist/lib/diagnostics/context-builder.js.map

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

package/dist/lib/diagnostics/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Diagnostic Engine (Story 18.7)
+ *
+ * Orchestrates the full diagnostic flow:
+ * cache check → context building → prompt generation → LLM call → parsing → caching
+ */
+import type { IEventStore } from '@agentlensai/core';
+import type { LLMProvider } from './providers/types.js';
+import type { DiagnosticReport } from './types.js';
+import { DiagnosticCache } from './cache.js';
+export declare class DiagnosticEngine {
+    private readonly store;
+    private readonly llmProvider;
+    private readonly cache;
+    private readonly inflight;
+    private readonly cacheTtlMs;
+    constructor(store: IEventStore, llmProvider: LLMProvider | null, cache: DiagnosticCache, cacheTtlMs?: number, inflight?: Map<string, Promise<DiagnosticReport>>);
+    diagnoseAgent(agentId: string, windowDays?: number, opts?: {
+        refresh?: boolean;
+    }): Promise<DiagnosticReport>;
+    diagnoseSession(sessionId: string, opts?: {
+        refresh?: boolean;
+    }): Promise<DiagnosticReport>;
+    private runAgentDiagnosis;
+    private runSessionDiagnosis;
+    private callLLMAndParse;
+    private buildFallbackReport;
+    private countDataPoints;
+}
+export { DiagnosticCache } from './cache.js';
+export { createLLMProvider, getLLMConfigFromEnv } from './llm-client.js';
+export type { DiagnosticReport, DiagnosticRequest } from './types.js';
+export type { LLMProvider } from './providers/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/diagnostics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/diagnostics/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAU7C,qBAAa,gBAAgB;IAKzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IANxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyC;IAClE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAGjB,KAAK,EAAE,WAAW,EAClB,WAAW,EAAE,WAAW,GAAG,IAAI,EAC/B,KAAK,EAAE,eAAe,EACvC,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAM7C,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,UAAU,GAAE,MAAU,EACtB,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAC3B,OAAO,CAAC,gBAAgB,CAAC;IA6BtB,eAAe,CACnB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAC3B,OAAO,CAAC,gBAAgB,CAAC;YA8Bd,iBAAiB;YAgCjB,mBAAmB;YA4BnB,eAAe;IA4E7B,OAAO,CAAC,mBAAmB;IAmD3B,OAAO,CAAC,eAAe;CAQxB;AAGD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACzE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACtE,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/lib/diagnostics/index.js

@@ -0,0 +1,223 @@
+/**
+ * Diagnostic Engine (Story 18.7)
+ *
+ * Orchestrates the full diagnostic flow:
+ * cache check → context building → prompt generation → LLM call → parsing → caching
+ */
+import { createHash } from 'node:crypto';
+import { DiagnosticCache } from './cache.js';
+import { buildAgentContext, buildSessionContext } from './context-builder.js';
+import { buildAgentDiagnosticPrompt, buildSessionDiagnosticPrompt, DIAGNOSTIC_JSON_SCHEMA, CORRECTION_PROMPT, } from './prompt-templates.js';
+import { parseLLMResponse } from './response-parser.js';
+export class DiagnosticEngine {
+    store;
+    llmProvider;
+    cache;
+    inflight;
+    cacheTtlMs;
+    constructor(store, llmProvider, cache, cacheTtlMs, inflight) {
+        this.store = store;
+        this.llmProvider = llmProvider;
+        this.cache = cache;
+        this.cacheTtlMs = cacheTtlMs ?? 15 * 60 * 1000;
+        this.inflight = inflight ?? new Map();
+    }
+    async diagnoseAgent(agentId, windowDays = 7, opts) {
+        const context = await buildAgentContext(this.store, agentId, windowDays);
+        const dataHash = DiagnosticCache.hashData({
+            health: context.health.overallScore,
+            errors: context.errorPatterns.insights.length,
+            sessions: context.health.sessionCount,
+        });
+        const cacheKey = DiagnosticCache.buildKey('agent', agentId, windowDays, dataHash);
+        if (!opts?.refresh) {
+            const cached = this.cache.get(cacheKey);
+            if (cached)
+                return cached;
+        }
+        // Singleflight: deduplicate concurrent requests for same key
+        const existing = this.inflight.get(cacheKey);
+        if (existing && !opts?.refresh)
+            return existing;
+        const promise = this.runAgentDiagnosis(agentId, windowDays, context, cacheKey);
+        this.inflight.set(cacheKey, promise);
+        try {
+            return await promise;
+        }
+        finally {
+            this.inflight.delete(cacheKey);
+        }
+    }
+    async diagnoseSession(sessionId, opts) {
+        const context = await buildSessionContext(this.store, sessionId);
+        const dataHash = DiagnosticCache.hashData({
+            status: context.session.status,
+            errors: context.errorEvents.length,
+            events: context.timeline.length,
+        });
+        const cacheKey = DiagnosticCache.buildKey('session', sessionId, 0, dataHash);
+        if (!opts?.refresh) {
+            const cached = this.cache.get(cacheKey);
+            if (cached)
+                return cached;
+        }
+        const existing = this.inflight.get(cacheKey);
+        if (existing && !opts?.refresh)
+            return existing;
+        const promise = this.runSessionDiagnosis(sessionId, context, cacheKey);
+        this.inflight.set(cacheKey, promise);
+        try {
+            return await promise;
+        }
+        finally {
+            this.inflight.delete(cacheKey);
+        }
+    }
+    // ─── Private ───────────────────────────────────────────
+    async runAgentDiagnosis(agentId, windowDays, context, cacheKey) {
+        if (!this.llmProvider) {
+            return this.buildFallbackReport('agent', agentId, windowDays, {
+                healthScore: context.health.overallScore,
+                sessionCount: context.health.sessionCount,
+                dataPoints: this.countDataPoints(context),
+            });
+        }
+        const { system, user } = buildAgentDiagnosticPrompt(context);
+        const report = await this.callLLMAndParse('agent', agentId, system, user, {
+            windowDays,
+            healthScore: context.health.overallScore,
+            sessionCount: context.health.sessionCount,
+            dataPoints: this.countDataPoints(context),
+        });
+        this.cache.set(cacheKey, report);
+        return report;
+    }
+    async runSessionDiagnosis(sessionId, context, cacheKey) {
+        if (!this.llmProvider) {
+            return this.buildFallbackReport('session', sessionId, undefined, {
+                sessionCount: 1,
+                dataPoints: context.timeline.length,
+            });
+        }
+        const { system, user } = buildSessionDiagnosticPrompt(context);
+        const report = await this.callLLMAndParse('session', sessionId, system, user, {
+            sessionCount: 1,
+            dataPoints: context.timeline.length,
+        });
+        this.cache.set(cacheKey, report);
+        return report;
+    }
+    async callLLMAndParse(type, targetId, system, user, meta) {
+        const provider = this.llmProvider;
+        let attempts = 0;
+        let lastError = '';
+        while (attempts < 2) {
+            try {
+                const prompt = attempts === 0 ? user : `${user}\n\n${CORRECTION_PROMPT}`;
+                const response = await provider.complete({
+                    systemPrompt: system,
+                    userPrompt: prompt,
+                    jsonSchema: DIAGNOSTIC_JSON_SCHEMA,
+                    temperature: 0.2,
+                    maxTokens: 4096,
+                });
+                const parsed = parseLLMResponse(response.content);
+                if (parsed.success) {
+                    const now = new Date();
+                    return {
+                        id: createHash('sha256').update(`${type}:${targetId}:${now.toISOString()}`).digest('hex').slice(0, 16),
+                        type,
+                        targetId,
+                        severity: parsed.data.severity,
+                        summary: parsed.data.summary,
+                        rootCauses: parsed.data.rootCauses.map((rc) => ({
+                            ...rc,
+                            evidence: rc.evidence.map((e) => ({ ...e, data: {} })),
+                        })),
+                        recommendations: parsed.data.recommendations,
+                        healthScore: meta.healthScore,
+                        analysisContext: {
+                            windowDays: meta.windowDays,
+                            sessionCount: meta.sessionCount,
+                            dataPoints: meta.dataPoints,
+                        },
+                        llmMeta: {
+                            provider: provider.name,
+                            model: response.model,
+                            inputTokens: response.inputTokens,
+                            outputTokens: response.outputTokens,
+                            estimatedCostUsd: provider.estimateCost(response.inputTokens, response.outputTokens),
+                            latencyMs: response.latencyMs,
+                        },
+                        createdAt: now.toISOString(),
+                        expiresAt: new Date(now.getTime() + this.cacheTtlMs).toISOString(),
+                        source: 'llm',
+                    };
+                }
+                lastError = parsed.error;
+                attempts++;
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err.message : String(err);
+                attempts++;
+                if (attempts >= 2)
+                    break;
+            }
+        }
+        // All retries exhausted — return fallback
+        return this.buildFallbackReport(type, targetId, meta.windowDays, {
+            healthScore: meta.healthScore,
+            sessionCount: meta.sessionCount,
+            dataPoints: meta.dataPoints,
+            llmError: lastError,
+        });
+    }
+    buildFallbackReport(type, targetId, windowDays, meta) {
+        const now = new Date();
+        const severity = meta.healthScore !== undefined
+            ? meta.healthScore < 40
+                ? 'critical'
+                : meta.healthScore < 70
+                    ? 'warning'
+                    : meta.healthScore < 85
+                        ? 'info'
+                        : 'healthy'
+            : 'info';
+        return {
+            id: createHash('sha256').update(`fallback:${type}:${targetId}:${now.toISOString()}`).digest('hex').slice(0, 16),
+            type,
+            targetId,
+            severity,
+            summary: 'AI diagnostics unavailable — showing raw analysis data',
+            rootCauses: [],
+            recommendations: [],
+            healthScore: meta.healthScore,
+            analysisContext: {
+                windowDays,
+                sessionCount: meta.sessionCount,
+                dataPoints: meta.dataPoints,
+            },
+            llmMeta: {
+                provider: 'none',
+                model: 'none',
+                inputTokens: 0,
+                outputTokens: 0,
+                estimatedCostUsd: 0,
+                latencyMs: 0,
+            },
+            createdAt: now.toISOString(),
+            expiresAt: new Date(now.getTime() + this.cacheTtlMs).toISOString(),
+            source: 'fallback',
+        };
+    }
+    countDataPoints(context) {
+        return (context.errorPatterns.insights.length +
+            context.toolSequences.insights.length +
+            context.costAnalysis.insights.length +
+            context.performanceTrends.insights.length);
+    }
+}
+// Re-export public API
+export { DiagnosticCache } from './cache.js';
+export { createLLMProvider, getLLMConfigFromEnv } from './llm-client.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/diagnostics/index.js.map

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

package/dist/lib/diagnostics/llm-client.d.ts

@@ -0,0 +1,24 @@
+/**
+ * LLM Client Factory (Story 18.1)
+ *
+ * Creates the appropriate LLM provider based on configuration.
+ */
+import type { LLMProvider } from './providers/types.js';
+export interface LLMConfig {
+    provider: 'openai' | 'anthropic';
+    apiKey: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    baseUrl?: string;
+}
+/**
+ * Create an LLM provider from configuration.
+ */
+export declare function createLLMProvider(config: LLMConfig): LLMProvider;
+/**
+ * Read LLM configuration from environment variables.
+ * Returns null if AGENTLENS_LLM_API_KEY is not set (feature disabled gracefully).
+ */
+export declare function getLLMConfigFromEnv(): LLMConfig | null;
+//# sourceMappingURL=llm-client.d.ts.map

package/dist/lib/diagnostics/llm-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-client.d.ts","sourceRoot":"","sources":["../../../src/lib/diagnostics/llm-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAIxD,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,QAAQ,GAAG,WAAW,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,WAAW,CAShE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,GAAG,IAAI,CAgBtD"}

package/dist/lib/diagnostics/llm-client.js

@@ -0,0 +1,42 @@
+/**
+ * LLM Client Factory (Story 18.1)
+ *
+ * Creates the appropriate LLM provider based on configuration.
+ */
+import { createOpenAIProvider } from './providers/openai.js';
+import { createAnthropicProvider } from './providers/anthropic.js';
+/**
+ * Create an LLM provider from configuration.
+ */
+export function createLLMProvider(config) {
+    switch (config.provider) {
+        case 'openai':
+            return createOpenAIProvider(config.apiKey, config.model, config.baseUrl);
+        case 'anthropic':
+            return createAnthropicProvider(config.apiKey, config.model, config.baseUrl);
+        default:
+            throw new Error(`Unknown LLM provider: ${config.provider}`);
+    }
+}
+/**
+ * Read LLM configuration from environment variables.
+ * Returns null if AGENTLENS_LLM_API_KEY is not set (feature disabled gracefully).
+ */
+export function getLLMConfigFromEnv() {
+    const apiKey = process.env['AGENTLENS_LLM_API_KEY'];
+    if (!apiKey)
+        return null;
+    return {
+        provider: process.env['AGENTLENS_LLM_PROVIDER'] ?? 'openai',
+        apiKey,
+        model: process.env['AGENTLENS_LLM_MODEL'] || undefined,
+        temperature: process.env['AGENTLENS_LLM_TEMPERATURE']
+            ? parseFloat(process.env['AGENTLENS_LLM_TEMPERATURE'])
+            : undefined,
+        maxTokens: process.env['AGENTLENS_LLM_MAX_TOKENS']
+            ? parseInt(process.env['AGENTLENS_LLM_MAX_TOKENS'], 10)
+            : undefined,
+        baseUrl: process.env['AGENTLENS_LLM_BASE_URL'] || undefined,
+    };
+}
+//# sourceMappingURL=llm-client.js.map

package/dist/lib/diagnostics/llm-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-client.js","sourceRoot":"","sources":["../../../src/lib/diagnostics/llm-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAWnE;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,QAAQ;YACX,OAAO,oBAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3E,KAAK,WAAW;YACd,OAAO,uBAAuB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAC9E;YACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACpD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,OAAO;QACL,QAAQ,EAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAA4B,IAAI,QAAQ;QACvF,MAAM;QACN,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,SAAS;QACtD,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC;YACnD,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;YACtD,CAAC,CAAC,SAAS;QACb,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;YAChD,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,EAAE,EAAE,CAAC;YACvD,CAAC,CAAC,SAAS;QACb,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,IAAI,SAAS;KAC5D,CAAC;AACJ,CAAC"}

package/dist/lib/diagnostics/prompt-templates.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Diagnostic Prompt Templates (Story 18.5)
+ */
+import type { AgentDiagnosticContext, SessionDiagnosticContext } from './context-builder.js';
+/**
+ * JSON schema for structured output (used with OpenAI response_format and Anthropic tool-use).
+ */
+export declare const DIAGNOSTIC_JSON_SCHEMA: Record<string, unknown>;
+export declare const CORRECTION_PROMPT = "Your previous response was not valid JSON matching the required schema. Please respond ONLY with valid JSON matching the schema. Do not include any text outside the JSON object.";
+export declare function buildAgentDiagnosticPrompt(context: AgentDiagnosticContext): {
+    system: string;
+    user: string;
+};
+export declare function buildSessionDiagnosticPrompt(context: SessionDiagnosticContext): {
+    system: string;
+    user: string;
+};
+//# sourceMappingURL=prompt-templates.d.ts.map

package/dist/lib/diagnostics/prompt-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-templates.d.ts","sourceRoot":"","sources":["../../../src/lib/diagnostics/prompt-templates.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAY7F;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAkD1D,CAAC;AAEF,eAAO,MAAM,iBAAiB,sLACuJ,CAAC;AAEtL,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,sBAAsB,GAC9B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAyClC;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,wBAAwB,GAChC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA8ClC"}