@gracker/smartperfetto 1.0.13

package/dist/agent/llmAdapter.js

@@ -0,0 +1,257 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMConfigurationError = void 0;
+exports.createDeepSeekLLMClient = createDeepSeekLLMClient;
+exports.createOpenAILLMClient = createOpenAILLMClient;
+exports.createLLMClient = createLLMClient;
+/**
+ * LLM Client Adapter for Agent System
+ *
+ * Bridges the agent's LLMClient interface with existing AI services (DeepSeek, OpenAI, etc.)
+ */
+const openai_1 = __importDefault(require("openai"));
+const llmJson_1 = require("../utils/llmJson");
+const envCredentialSources_1 = require("../agentRuntime/envCredentialSources");
+const DEFAULT_TIMEOUT_MS = Number.parseInt(process.env.LLM_REQUEST_TIMEOUT_MS || '', 10) || 45000;
+const DEFAULT_MAX_RETRIES = Number.parseInt(process.env.LLM_MAX_RETRIES || '', 10) || 2;
+const DEFAULT_RETRY_BASE_DELAY_MS = Number.parseInt(process.env.LLM_RETRY_BASE_DELAY_MS || '', 10) || 600;
+const DEFAULT_MAX_RETRY_DELAY_MS = Number.parseInt(process.env.LLM_MAX_RETRY_DELAY_MS || '', 10) || 5000;
+/**
+ * Error thrown when LLM API key is not configured
+ */
+class LLMConfigurationError extends Error {
+    constructor(provider) {
+        super(`LLM API key not configured${provider ? ` for provider '${provider}'` : ''}. ` +
+            `Please set the appropriate environment variable:\n` +
+            `  - OpenAI: OPENAI_API_KEY\n` +
+            `  - DeepSeek: DEEPSEEK_API_KEY\n` +
+            `Or specify the API key in the configuration.`);
+        this.name = 'LLMConfigurationError';
+    }
+}
+exports.LLMConfigurationError = LLMConfigurationError;
+function resolveRetryPolicy(config) {
+    const timeoutMs = Number.isFinite(config?.timeoutMs)
+        ? Math.max(1000, Math.floor(config.timeoutMs))
+        : DEFAULT_TIMEOUT_MS;
+    const maxRetries = Number.isFinite(config?.maxRetries)
+        ? Math.max(0, Math.floor(config.maxRetries))
+        : DEFAULT_MAX_RETRIES;
+    const retryBaseDelayMs = Number.isFinite(config?.retryBaseDelayMs)
+        ? Math.max(50, Math.floor(config.retryBaseDelayMs))
+        : DEFAULT_RETRY_BASE_DELAY_MS;
+    const maxRetryDelayMs = Number.isFinite(config?.maxRetryDelayMs)
+        ? Math.max(retryBaseDelayMs, Math.floor(config.maxRetryDelayMs))
+        : DEFAULT_MAX_RETRY_DELAY_MS;
+    return {
+        timeoutMs,
+        maxRetries,
+        retryBaseDelayMs,
+        maxRetryDelayMs,
+    };
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+function getRetryDelayMs(attempt, policy) {
+    const exp = Math.max(0, attempt - 1);
+    const delay = policy.retryBaseDelayMs * Math.pow(2, exp);
+    return Math.min(policy.maxRetryDelayMs, delay);
+}
+function extractStatusCode(error) {
+    const status = error?.status ?? error?.response?.status;
+    return Number.isFinite(status) ? Number(status) : undefined;
+}
+function isRetryableError(error) {
+    const status = extractStatusCode(error);
+    if (status !== undefined && [408, 409, 429, 500, 502, 503, 504].includes(status)) {
+        return true;
+    }
+    const code = String(error?.code || '');
+    if (['ECONNRESET', 'ETIMEDOUT', 'ECONNABORTED', 'ENOTFOUND', 'EPIPE', 'ECONNREFUSED'].includes(code)) {
+        return true;
+    }
+    const name = String(error?.name || '').toLowerCase();
+    const message = String(error?.message || '').toLowerCase();
+    if (name.includes('timeout') || message.includes('timeout') || message.includes('timed out')) {
+        return true;
+    }
+    if (name.includes('connection') || message.includes('connection') || message.includes('network')) {
+        return true;
+    }
+    return false;
+}
+function summarizeError(error) {
+    const status = extractStatusCode(error);
+    const code = error?.code ? ` code=${String(error.code)}` : '';
+    const message = error?.message ? String(error.message) : 'Unknown error';
+    return `${status ? `status=${status} ` : ''}${message}${code}`.trim();
+}
+async function withRetries(operationLabel, policy, operation) {
+    const maxAttempts = policy.maxRetries + 1;
+    let attempt = 0;
+    while (attempt < maxAttempts) {
+        attempt += 1;
+        try {
+            return await operation();
+        }
+        catch (error) {
+            const retryable = isRetryableError(error);
+            if (!retryable || attempt >= maxAttempts) {
+                throw error;
+            }
+            const delayMs = getRetryDelayMs(attempt, policy);
+            console.warn(`[LLMAdapter] ${operationLabel} failed on attempt ${attempt}/${maxAttempts}: ${summarizeError(error)}; retrying in ${delayMs}ms`);
+            await sleep(delayMs);
+        }
+    }
+    throw new Error(`[LLMAdapter] ${operationLabel} failed after retries`);
+}
+/**
+ * Creates an LLMClient that uses the DeepSeek API
+ */
+function createDeepSeekLLMClient(config) {
+    const apiKey = config?.apiKey || process.env.DEEPSEEK_API_KEY;
+    const baseUrl = String(config?.baseUrl || process.env.DEEPSEEK_BASE_URL || 'https://api.deepseek.com').replace(/\/+$/, '');
+    const model = config?.model || process.env.DEEPSEEK_MODEL || 'deepseek-chat';
+    const temperature = config?.temperature ?? 0.3;
+    const maxTokens = config?.maxTokens ?? 4000;
+    const retryPolicy = resolveRetryPolicy(config);
+    if (!apiKey) {
+        throw new LLMConfigurationError('deepseek');
+    }
+    const client = new openai_1.default({
+        apiKey,
+        baseURL: baseUrl,
+        timeout: retryPolicy.timeoutMs,
+        maxRetries: 0,
+    });
+    return {
+        async complete(prompt) {
+            try {
+                const completion = await withRetries('deepseek.complete', retryPolicy, async () => client.chat.completions.create({
+                    model,
+                    messages: [{ role: 'user', content: prompt }],
+                    temperature,
+                    max_tokens: maxTokens,
+                }));
+                return completion.choices[0]?.message?.content || '';
+            }
+            catch (error) {
+                console.error('[LLMAdapter] DeepSeek API error:', summarizeError(error));
+                throw new Error(`LLM completion failed: ${error.message}`);
+            }
+        },
+        async completeJSON(prompt) {
+            const jsonPrompt = `${prompt}\n\nIMPORTANT: Respond ONLY with valid JSON. No markdown, no explanation, just the JSON object.`;
+            try {
+                const completion = await withRetries('deepseek.completeJSON', retryPolicy, async () => client.chat.completions.create({
+                    model,
+                    messages: [{ role: 'user', content: jsonPrompt }],
+                    temperature: 0.1,
+                    max_tokens: maxTokens,
+                }));
+                const content = completion.choices[0]?.message?.content || '{}';
+                return parseJSONResponse(content);
+            }
+            catch (error) {
+                console.error('[LLMAdapter] DeepSeek JSON completion error:', summarizeError(error));
+                throw new Error(`LLM JSON completion failed: ${error.message}`);
+            }
+        },
+    };
+}
+/**
+ * Creates an LLMClient that uses the OpenAI API
+ */
+function createOpenAILLMClient(config) {
+    const apiKey = config?.apiKey || process.env.OPENAI_API_KEY;
+    const model = config?.model || process.env.OPENAI_MODEL || 'gpt-4';
+    const temperature = config?.temperature ?? 0.3;
+    const maxTokens = config?.maxTokens ?? 4000;
+    const retryPolicy = resolveRetryPolicy(config);
+    if (!apiKey) {
+        throw new LLMConfigurationError('openai');
+    }
+    const client = new openai_1.default({
+        apiKey,
+        timeout: retryPolicy.timeoutMs,
+        maxRetries: 0,
+    });
+    return {
+        async complete(prompt) {
+            try {
+                const completion = await withRetries('openai.complete', retryPolicy, async () => client.chat.completions.create({
+                    model,
+                    messages: [{ role: 'user', content: prompt }],
+                    temperature,
+                    max_tokens: maxTokens,
+                }));
+                return completion.choices[0]?.message?.content || '';
+            }
+            catch (error) {
+                console.error('[LLMAdapter] OpenAI API error:', summarizeError(error));
+                throw new Error(`LLM completion failed: ${error.message}`);
+            }
+        },
+        async completeJSON(prompt) {
+            const jsonPrompt = `${prompt}\n\nIMPORTANT: Respond ONLY with valid JSON. No markdown, no explanation, just the JSON object.`;
+            try {
+                const completion = await withRetries('openai.completeJSON', retryPolicy, async () => client.chat.completions.create({
+                    model,
+                    messages: [{ role: 'user', content: jsonPrompt }],
+                    temperature: 0.1,
+                    max_tokens: maxTokens,
+                    response_format: { type: 'json_object' },
+                }));
+                const content = completion.choices[0]?.message?.content || '{}';
+                return JSON.parse(content);
+            }
+            catch (error) {
+                console.error('[LLMAdapter] OpenAI JSON completion error:', summarizeError(error));
+                throw new Error(`LLM JSON completion failed: ${error.message}`);
+            }
+        },
+    };
+}
+/**
+ * Creates the appropriate LLMClient based on configuration or environment
+ */
+function createLLMClient(config) {
+    const provider = resolveLLMClientProvider(config);
+    if (!provider) {
+        throw new LLMConfigurationError();
+    }
+    switch (provider) {
+        case 'deepseek':
+            return createDeepSeekLLMClient(config);
+        case 'openai':
+            return createOpenAILLMClient(config);
+        default:
+            throw new LLMConfigurationError(provider);
+    }
+}
+function resolveLLMClientProvider(config) {
+    if (config?.provider)
+        return config.provider;
+    const envProvider = process.env.SMARTPERFETTO_LLM_PROVIDER;
+    if (envProvider === 'deepseek' || envProvider === 'openai') {
+        return envProvider;
+    }
+    if ((0, envCredentialSources_1.hasConcreteEnvValue)(process.env.OPENAI_API_KEY))
+        return 'openai';
+    if ((0, envCredentialSources_1.hasConcreteEnvValue)(process.env.DEEPSEEK_API_KEY))
+        return 'deepseek';
+    return undefined;
+}
+function parseJSONResponse(content) {
+    return (0, llmJson_1.parseLlmJson)(content);
+}
+exports.default = createLLMClient;
+//# sourceMappingURL=llmAdapter.js.map

package/dist/agent/llmAdapter.js.map

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

package/dist/agent/scene/sceneAnalysisJobRunner.d.ts

@@ -0,0 +1,106 @@
+/**
+ * SceneAnalysisJobRunner — concurrent per-scene analysis runner.
+ *
+ * Drives the Stage 2 portion of the Scene Story pipeline: takes the
+ * AnalysisInterval[] selected by buildAnalysisIntervals() and runs each one
+ * through a SkillExecutor with bounded concurrency and single-retry semantics.
+ *
+ * Concurrency: global, not per-trace. trace_processor_shell serializes SQL
+ * queries internally; adding a per-trace lock on top would silently reduce
+ * the effective concurrency to 1 for a single trace's jobs, defeating the
+ * product decision of "3-way parallel analysis".
+ *
+ * Cancel semantics: cancel() drains the queued jobs to 'cancelled' state
+ * immediately, but running jobs keep executing (SkillExecutor has no abort
+ * hook). When they finish after cancel, their result is marked 'dropped'
+ * rather than 'completed' — callers can still inspect it via getJobs() for
+ * telemetry, but it is not emitted as a real completion.
+ */
+import { AnalysisInterval, SceneAnalysisJob, SceneJobResult } from './types';
+export interface SceneSkillExecutor {
+    execute(skillId: string, traceId: string, params: Record<string, any>, inherited?: Record<string, any>): Promise<SceneSkillExecutionResult>;
+}
+export interface SceneSkillExecutionResult {
+    success: boolean;
+    displayResults?: any[];
+    executionTimeMs?: number;
+    error?: string;
+}
+export type JobRunnerEvent = {
+    type: 'job_queued';
+    job: SceneAnalysisJob;
+} | {
+    type: 'job_started';
+    job: SceneAnalysisJob;
+} | {
+    type: 'job_retrying';
+    job: SceneAnalysisJob;
+    error: string;
+} | {
+    type: 'job_completed';
+    job: SceneAnalysisJob;
+    result: SceneJobResult;
+} | {
+    type: 'job_failed';
+    job: SceneAnalysisJob;
+    error: string;
+} | {
+    type: 'job_cancelled';
+    job: SceneAnalysisJob;
+} | {
+    type: 'job_dropped';
+    job: SceneAnalysisJob;
+    reason: 'late_after_cancel';
+} | {
+    type: 'all_done';
+    jobs: SceneAnalysisJob[];
+};
+export interface SceneAnalysisJobRunnerOptions {
+    /** Max jobs running concurrently. Product decision: 3. */
+    concurrency: number;
+    /** Retries after initial failure. Product decision: 1. */
+    maxRetries: number;
+    /** Trace id shared by every job produced by this runner. */
+    traceId: string;
+    /** Analysis id used to scope job ids. */
+    analysisId: string;
+    /** Skill executor used to run the per-interval skill. */
+    skillExecutor: SceneSkillExecutor;
+    /** Receives every state transition for SSE fanout and telemetry. */
+    onEvent: (event: JobRunnerEvent) => void;
+}
+export declare class SceneAnalysisJobRunner {
+    private readonly opts;
+    private readonly jobs;
+    private readonly queue;
+    private readonly running;
+    private cancelled;
+    private allDoneResolvers;
+    private allDoneEmitted;
+    constructor(opts: SceneAnalysisJobRunnerOptions);
+    /** Wraps onEvent so a misbehaving listener cannot break the runner state. */
+    private emit;
+    /**
+     * Add a batch of analysis intervals as jobs and start executing.
+     * Safe to call multiple times; each call appends to the queue.
+     */
+    enqueue(intervals: AnalysisInterval[]): void;
+    /**
+     * Request cancellation. Queued jobs transition to 'cancelled' immediately;
+     * running jobs are left to finish but their results will be dropped.
+     */
+    cancel(): void;
+    /**
+     * Resolves when every job has reached a terminal state (completed / failed /
+     * cancelled / dropped). Safe to await after cancel(); will resolve once any
+     * in-flight jobs finish.
+     */
+    waitForAllDone(): Promise<void>;
+    getJobs(): SceneAnalysisJob[];
+    isCancelled(): boolean;
+    private pump;
+    private runJob;
+    private transitionJob;
+    private maybeSignalAllDone;
+}
+//# sourceMappingURL=sceneAnalysisJobRunner.d.ts.map

package/dist/agent/scene/sceneAnalysisJobRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneAnalysisJobRunner.d.ts","sourceRoot":"","sources":["../../../src/agent/scene/sceneAnalysisJobRunner.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAEhB,cAAc,EACf,MAAM,SAAS,CAAC;AAMjB,MAAM,WAAW,kBAAkB;IACjC,OAAO,CACL,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC9B,OAAO,CAAC,yBAAyB,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,GAAG,EAAE,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,GAAG,EAAE,gBAAgB,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,GAAG,EAAE,gBAAgB,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,GAAG,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,GAAG,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,GAAG,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,GAAG,EAAE,gBAAgB,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,GAAG,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAAC;AAEnD,MAAM,WAAW,6BAA6B;IAC5C,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,aAAa,EAAE,kBAAkB,CAAC;IAClC,oEAAoE;IACpE,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CAC1C;AAMD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgC;IACrD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4C;IACjE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,gBAAgB,CAAyB;IACjD,OAAO,CAAC,cAAc,CAAS;gBAEnB,IAAI,EAAE,6BAA6B;IAU/C,6EAA6E;IAC7E,OAAO,CAAC,IAAI;IAWZ;;;OAGG;IACH,OAAO,CAAC,SAAS,EAAE,gBAAgB,EAAE,GAAG,IAAI;IA6B5C;;;OAGG;IACH,MAAM,IAAI,IAAI;IAiBd;;;;OAIG;IACH,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAS/B,OAAO,IAAI,gBAAgB,EAAE;IAI7B,WAAW,IAAI,OAAO;IAQtB,OAAO,CAAC,IAAI;YAsBE,MAAM;IAiEpB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,kBAAkB;CAW3B"}

package/dist/agent/scene/sceneAnalysisJobRunner.js

@@ -0,0 +1,201 @@
+"use strict";
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2024-2026 Gracker (Chris)
+// This file is part of SmartPerfetto. See LICENSE for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SceneAnalysisJobRunner = void 0;
+// ---------------------------------------------------------------------------
+// Runner
+// ---------------------------------------------------------------------------
+class SceneAnalysisJobRunner {
+    constructor(opts) {
+        this.jobs = new Map();
+        this.queue = [];
+        this.running = new Set();
+        this.cancelled = false;
+        this.allDoneResolvers = [];
+        this.allDoneEmitted = false;
+        if (opts.concurrency < 1) {
+            throw new Error('concurrency must be >= 1');
+        }
+        if (opts.maxRetries < 0) {
+            throw new Error('maxRetries must be >= 0');
+        }
+        this.opts = opts;
+    }
+    /** Wraps onEvent so a misbehaving listener cannot break the runner state. */
+    emit(event) {
+        try {
+            this.opts.onEvent(event);
+        }
+        catch (err) {
+            console.warn('[SceneAnalysisJobRunner] onEvent listener threw, continuing:', err?.message ?? err);
+        }
+    }
+    /**
+     * Add a batch of analysis intervals as jobs and start executing.
+     * Safe to call multiple times; each call appends to the queue.
+     */
+    enqueue(intervals) {
+        if (this.cancelled) {
+            // Discard silently: post-cancel enqueue is a caller mistake but not
+            // worth throwing for.
+            return;
+        }
+        for (let i = 0; i < intervals.length; i++) {
+            const interval = intervals[i];
+            const jobId = `${this.opts.analysisId}-job-${this.jobs.size}`;
+            const job = {
+                jobId,
+                analysisId: this.opts.analysisId,
+                interval,
+                attempt: 0,
+                state: 'queued',
+            };
+            this.jobs.set(jobId, job);
+            this.queue.push(jobId);
+            this.emit({ type: 'job_queued', job });
+        }
+        this.pump();
+        // No intervals were enqueued and nothing is running — resolve immediately.
+        if (intervals.length === 0 && this.running.size === 0) {
+            this.maybeSignalAllDone();
+        }
+    }
+    /**
+     * Request cancellation. Queued jobs transition to 'cancelled' immediately;
+     * running jobs are left to finish but their results will be dropped.
+     */
+    cancel() {
+        if (this.cancelled)
+            return;
+        this.cancelled = true;
+        // Drain queue → cancelled.
+        while (this.queue.length > 0) {
+            const jobId = this.queue.shift();
+            const job = this.jobs.get(jobId);
+            if (!job)
+                continue;
+            this.transitionJob(job, 'cancelled');
+            this.emit({ type: 'job_cancelled', job });
+        }
+        // If nothing is running either, we're immediately done.
+        this.maybeSignalAllDone();
+    }
+    /**
+     * Resolves when every job has reached a terminal state (completed / failed /
+     * cancelled / dropped). Safe to await after cancel(); will resolve once any
+     * in-flight jobs finish.
+     */
+    waitForAllDone() {
+        if (this.allDoneEmitted) {
+            return Promise.resolve();
+        }
+        return new Promise((resolve) => {
+            this.allDoneResolvers.push(resolve);
+        });
+    }
+    getJobs() {
+        return Array.from(this.jobs.values());
+    }
+    isCancelled() {
+        return this.cancelled;
+    }
+    // -------------------------------------------------------------------------
+    // Internal
+    // -------------------------------------------------------------------------
+    pump() {
+        while (!this.cancelled &&
+            this.running.size < this.opts.concurrency &&
+            this.queue.length > 0) {
+            const jobId = this.queue.shift();
+            this.running.add(jobId);
+            this.runJob(jobId)
+                .catch((err) => {
+                // runJob already handles failures internally; a throw here would
+                // only surface a bug in the runner itself.
+                console.error('[SceneAnalysisJobRunner] unexpected runJob error:', err);
+            })
+                .finally(() => {
+                this.running.delete(jobId);
+                if (!this.cancelled)
+                    this.pump();
+                this.maybeSignalAllDone();
+            });
+        }
+    }
+    async runJob(jobId) {
+        const job = this.jobs.get(jobId);
+        if (!job)
+            return;
+        job.state = 'running';
+        job.startedAt = Date.now();
+        this.emit({ type: 'job_started', job });
+        let skillResult;
+        let thrown;
+        try {
+            skillResult = await this.opts.skillExecutor.execute(job.interval.skillId, this.opts.traceId, job.interval.params);
+        }
+        catch (err) {
+            thrown = err;
+        }
+        // Cancelled while we were running: drop whatever came back.
+        if (this.cancelled) {
+            this.transitionJob(job, 'dropped');
+            this.emit({ type: 'job_dropped', job, reason: 'late_after_cancel' });
+            return;
+        }
+        // Skill execution failed synchronously (throw) or returned success:false.
+        const failureMessage = thrown != null
+            ? thrown?.message ?? String(thrown)
+            : skillResult && !skillResult.success
+                ? skillResult.error ?? 'skill execution returned success=false'
+                : null;
+        if (failureMessage != null) {
+            if (job.attempt < this.opts.maxRetries) {
+                job.attempt += 1;
+                this.emit({ type: 'job_retrying', job, error: failureMessage });
+                // Put back at the front so retries run before newly enqueued work.
+                this.queue.unshift(jobId);
+                return;
+            }
+            job.endedAt = Date.now();
+            job.error = { message: failureMessage };
+            this.transitionJob(job, 'failed');
+            this.emit({ type: 'job_failed', job, error: failureMessage });
+            return;
+        }
+        // Success path.
+        job.endedAt = Date.now();
+        const result = {
+            jobId: job.jobId,
+            displayedSceneId: job.interval.displayedSceneId,
+            skillId: job.interval.skillId,
+            displayResults: skillResult.displayResults ?? [],
+            dataEnvelopes: [], // populated by the caller via toDataEnvelopes()
+            durationMs: skillResult.executionTimeMs ?? (job.endedAt - (job.startedAt ?? job.endedAt)),
+        };
+        job.result = result;
+        this.transitionJob(job, 'completed');
+        this.emit({ type: 'job_completed', job, result });
+    }
+    transitionJob(job, next) {
+        job.state = next;
+    }
+    maybeSignalAllDone() {
+        if (this.allDoneEmitted)
+            return;
+        if (this.running.size > 0)
+            return;
+        if (!this.cancelled && this.queue.length > 0)
+            return;
+        this.allDoneEmitted = true;
+        this.emit({ type: 'all_done', jobs: this.getJobs() });
+        const resolvers = this.allDoneResolvers;
+        this.allDoneResolvers = [];
+        for (const r of resolvers)
+            r();
+    }
+}
+exports.SceneAnalysisJobRunner = SceneAnalysisJobRunner;
+//# sourceMappingURL=sceneAnalysisJobRunner.js.map

package/dist/agent/scene/sceneAnalysisJobRunner.js.map

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

package/dist/agent/scene/sceneCostEstimator.d.ts

@@ -0,0 +1,33 @@
+/**
+ * sceneCostEstimator — pure heuristic for the Scene Story preview endpoint.
+ *
+ * Given a trace duration (seconds) and the configured concurrency, predicts
+ * how many AnalysisIntervals we will likely create, how long the pipeline
+ * will take end-to-end, and the rough Claude spend.
+ *
+ * v1 is intentionally formula-only. `confidence: 'low'` is the honest
+ * signal that there is no telemetry feedback loop yet — a later PR can
+ * replace the fixed per-batch / per-scene constants with values derived
+ * from historical jobs.
+ */
+export interface CostEstimateInput {
+    /** Trace duration in seconds. Values <= 0 or non-finite are clamped to 0. */
+    traceDurationSec: number;
+    /** Override the configured JobRunner concurrency. Defaults to 3. */
+    concurrency?: number;
+}
+export interface CostEstimate {
+    /** Number of AnalysisIntervals we expect to schedule. */
+    expectedScenes: number;
+    /** Total end-to-end wall-clock estimate in seconds. */
+    etaSec: number;
+    /** Rough Claude spend estimate in USD. */
+    estimatedUsd: number;
+    /**
+     * Always 'low' in v1 because the formula is pure heuristic. A future
+     * telemetry-backed estimator may promote this to 'medium'/'high'.
+     */
+    confidence: 'low' | 'medium' | 'high';
+}
+export declare function estimateSceneStoryCost(input: CostEstimateInput): CostEstimate;
+//# sourceMappingURL=sceneCostEstimator.d.ts.map

package/dist/agent/scene/sceneCostEstimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneCostEstimator.d.ts","sourceRoot":"","sources":["../../../src/agent/scene/sceneCostEstimator.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AAMH,MAAM,WAAW,iBAAiB;IAChC,6EAA6E;IAC7E,gBAAgB,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,yDAAyD;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACvC;AAuBD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CA8B7E"}