specrails-desktop 2.44.1 → 2.45.0

package/server/dist/loop-run-manager.js

@@ -19,6 +19,7 @@ const ai_invocations_1 = require("./ai-invocations");
 const provider_limit_1 = require("./provider-limit");
 const ids_1 = require("./ids");
 const providers_1 = require("./providers");
+const agent_runtime_accounting_1 = require("./agent-runtime-accounting");
 const runtime_1 = require("./providers/runtime");
 const result_event_1 = require("./result-event");
 const rails_store_1 = require("./rails-store");
@@ -137,6 +138,13 @@ function extractChangeId(text) {
     const m = CHANGE_ID_RE.exec(text);
     return m ? m[1] : undefined;
 }
+function programmaticUsageAvailability(db, runId) {
+    const row = db.prepare(`SELECT COUNT(*) AS count,
+    MAX(total_cost_usd IS NULL) AS cost_unknown,
+    MAX(tokens_in IS NULL) AS input_unknown, MAX(tokens_out IS NULL) AS output_unknown
+    FROM ai_invocations WHERE surface = 'loop' AND loop_run_id = ? AND provider = 'agent-runtime'`).get(runId);
+    return { present: row.count > 0, costUnknown: Boolean(row.cost_unknown), tokensInUnknown: Boolean(row.input_unknown), tokensOutUnknown: Boolean(row.output_unknown) };
+}
 function insertLoopInvocation(db, payload, result, finishedAt) {
     const ticketIds = Array.isArray(payload.ticketIds)
         ? [...new Set(payload.ticketIds)]
@@ -193,14 +201,15 @@ function insertLoopInvocation(db, payload, result, finishedAt) {
       FROM ai_invocations
      WHERE surface = 'loop' AND loop_run_id = ?
   `).get(payload.runId);
-    const usageTelemetryAvailable = (0, providers_1.getAdapter)(payload.provider).capabilities.reportsUsage !== false;
+    const runtimeUsage = programmaticUsageAvailability(db, payload.runId);
+    const usageTelemetryAvailable = runtimeUsage.present || (0, providers_1.getAdapter)(payload.provider).capabilities.reportsUsage !== false;
     db.prepare(`
     UPDATE jobs
        SET total_cost_usd = ?, tokens_in = ?, tokens_out = ?,
            tokens_cache_read = ?, tokens_cache_create = ?,
            duration_ms = ?, num_turns = ?
      WHERE id = ? AND owner = 'loop'
-  `).run(usageTelemetryAvailable ? aggregate.cost : null, usageTelemetryAvailable ? aggregate.tokens_in : null, usageTelemetryAvailable ? aggregate.tokens_out : null, usageTelemetryAvailable ? aggregate.cache_read : null, usageTelemetryAvailable ? aggregate.cache_create : null, aggregate.duration, usageTelemetryAvailable ? aggregate.turns : null, payload.runId);
+  `).run(usageTelemetryAvailable && !runtimeUsage.costUnknown ? aggregate.cost : null, usageTelemetryAvailable && !runtimeUsage.tokensInUnknown ? aggregate.tokens_in : null, usageTelemetryAvailable && !runtimeUsage.tokensOutUnknown ? aggregate.tokens_out : null, usageTelemetryAvailable && !runtimeUsage.present ? aggregate.cache_read : null, usageTelemetryAvailable && !runtimeUsage.present ? aggregate.cache_create : null, aggregate.duration, usageTelemetryAvailable && !runtimeUsage.present ? aggregate.turns : null, payload.runId);
 }
 /** Recover every AI/decider step that was staged before provider spawn but did
  * not atomically land its invocation. Completed interactive turns are the jobs
@@ -266,6 +275,23 @@ function recoverOrphanLoopStepAccounting(db, finishedAt = new Date().toISOString
        WHERE job_id = ? AND seq > ? AND source = 'stdout'
        ORDER BY seq
     `).all(payload.runId, payload.completedEventSeq ?? -1);
+        const programmatic = (0, agent_runtime_accounting_1.parseProgrammaticUsage)(rawRows.map(row => row.payload)) ?? (payload.provider === 'agent-runtime'
+            ? { provider: 'agent-runtime', model: 'per-role', estimated: true, failed: true }
+            : undefined);
+        if (programmatic) {
+            const durationMs = boundedInflightDurationMs(payload, finishedAt);
+            const didRecover = (0, loop_runs_store_1.completeLoopStepRecovery)(db, payload.runId, payload.stepKey, stable => {
+                insertLoopInvocation(db, stable, { ...programmatic, durationMs }, finishedAt);
+                const aggregate = (0, loop_runs_store_1.readLoopJobUsage)(db, payload.runId);
+                const duration = (payload.loopDurationBaseline ?? 0) + durationMs;
+                db.prepare(`UPDATE loop_runs SET total_cost_usd = ?, total_tokens = ?, total_duration_ms = ?, iteration_count = MAX(iteration_count, COALESCE(?, iteration_count)) WHERE id = ?`)
+                    .run(aggregate.totalCostUsd, aggregate.tokensIn + aggregate.tokensOut, duration, stable.iterationCount ?? null, payload.runId);
+                db.prepare(`UPDATE jobs SET duration_ms = ? WHERE id = ? AND owner = 'loop'`).run(duration, payload.runId);
+            });
+            if (didRecover)
+                recovered += 1;
+            continue;
+        }
         const adapter = (0, providers_1.getAdapter)(payload.provider);
         const usageTelemetryAvailable = adapter.capabilities.reportsUsage !== false;
         const events = rawRows
@@ -560,7 +586,7 @@ class LoopRunManager {
         if (req.graph.nodes.some((node) => node.type === 'decider')) {
             (0, providers_1.requireToolPolicy)(adapter, 'read-only');
         }
-        const usageTelemetryAvailable = adapter.capabilities.reportsUsage !== false;
+        let usageTelemetryAvailable = adapter.capabilities.reportsUsage !== false;
         const neverAfterDispose = () => new Promise(() => { });
         const runId = req.runId ?? (0, ids_1.newId)();
         const maxIterations = req.graph.config.maxIterations;
@@ -828,20 +854,20 @@ class LoopRunManager {
         // The REAL turn-start instant, captured before the step/decider await. The
         // row is bucketed/ordered by started_at, so it must be the start, not finish.
         startedAt, stepKey) => {
+            if (r.provider === 'agent-runtime')
+                usageTelemetryAvailable = true;
             if (usageTelemetryAvailable)
                 totalCost += r.cost ?? 0;
-            // A cost-bearing step that produced work (tokens) or hard-failed but reports
-            // no priced cost → its real spend is missing from the total. The common case
-            // is a claude step killed by timeout before its terminal `result` event:
-            // tokens streamed, but cost (and tokens) are dropped, so the step bills $0.
-            // Flag the run total as a lower bound and say so, per occurrence.
+            // Missing pricing does not identify the failure cause or prove zero spend:
+            // providers can omit billing after a successful call or reject a request
+            // before model work starts. Retain known costs and flag the incomplete sum.
             const costBearingButUnpriced = usageTelemetryAvailable
                 && r.cost == null
                 && (r.failed === true || (r.tokens ?? 0) > 0);
             if (costBearingButUnpriced) {
                 costUncertain = true;
                 costUnknownWarned = true; // this line already carries the cap caveat below
-                logLine(`⚠️ Step cost unknown — the process ended before billing (timeout/crash), so it counts as $0. The loop total is a lower bound.${maxCostUsd !== undefined ? ' The cost cap may under-count.' : ''}`, 'stderr');
+                logLine(`⚠️ Step cost unknown — this step did not report a priced cost. The reported loop total includes known costs only.${maxCostUsd !== undefined ? ' The cost cap may under-count.' : ''}`, 'stderr');
             }
             // Honest cost-cap caveat: a cost-bearing step that reports no figure means
             // the cap can't be enforced precisely from here on. Warn once (live).
@@ -1058,6 +1084,8 @@ class LoopRunManager {
                         // --yes`, codex `$implement #<id> --yes`) — then resolve `{{spec.*}}`
                         // data tokens and finally `{{const:*}}` library constants.
                         const rawTemplate = String(node.data?.prompt ?? '');
+                        const requiresCoreCompletion = node.data?.operation === 'core-implementation' || /\{\{\s*cmd:(?:implement|batch)\s*\}\}/.test(rawTemplate)
+                            || /^\s*(?:\/specrails:|\/skill:specrails-|\$)(?:implement|batch-implement)(?:\s|$)/.test(rawTemplate);
                         const expanded = (0, loop_constants_1.resolveConstants)(resolveRunVars((0, loop_graph_1.interpolateSpec)((0, loop_command_catalog_1.expandCommands)(rawTemplate, { provider: nodeProvider, ticketIds: req.spec?.ticketIds, specId: req.spec?.id }), req.spec), runVars), constMap);
                         const base = [(0, multi_repo_execution_store_1.executionManifestPrompt)(req.executionManifest), withReviewContinuationContext(expanded, rawTemplate, req.spec)].filter(Boolean).join('\n\n');
                         // Inject the cross-iteration history only when there's no live session
@@ -1094,7 +1122,7 @@ class LoopRunManager {
                             const effectiveTimeoutMs = Number.isFinite(remainingMs)
                                 ? Math.max(1, Math.min(aiStepTimeoutMs === 0 ? Infinity : (aiStepTimeoutMs ?? 15 * 60_000), remainingMs))
                                 : aiStepTimeoutMs;
-                            const coreRun = { runId, spec: req.spec, goal: req.spec ? undefined : JSON.stringify({ loop: req.loopName, graph: req.graph }), repositoryId: req.repositoryId, verificationStep: node.data?.requireVerificationPass === true || /\{\{\s*cmd:(?:verify|revision-verify|opsx:verify)\s*\}\}/.test(rawTemplate) };
+                            const coreRun = { runId, implementation: requiresCoreCompletion, spec: req.spec, goal: req.spec ? undefined : JSON.stringify({ loop: req.loopName, graph: req.graph }), repositoryId: req.repositoryId, verificationStep: node.data?.requireVerificationPass === true || /\{\{\s*cmd:(?:verify|revision-verify|opsx:verify)\s*\}\}/.test(rawTemplate) };
                             const interactivePlan = this.executors.planInteractiveAiStep?.({
                                 coreRun,
                                 provider: nodeProvider,
@@ -1220,6 +1248,19 @@ class LoopRunManager {
                             settled = true;
                             break;
                         }
+                        if (!res.failed && !zeroWork && !this._cancelled.has(runId)
+                            && requiresCoreCompletion
+                            && this.executors.validateCoreCompletion) {
+                            const completion = this.executors.validateCoreCompletion({
+                                coreRun: { runId, spec: req.spec, goal: req.spec ? undefined : JSON.stringify({ loop: req.loopName, graph: req.graph }), repositoryId: req.repositoryId },
+                                provider: nodeProvider, model: nodeModel, effort: nodeEffort, profileName: req.profileName,
+                                cwd: req.cwd, repoDir: req.repoDir, executionManifest: req.executionManifest,
+                            });
+                            if (!completion.valid) {
+                                res = { ...res, failed: true, errorText: completion.reason ?? 'Core implementation is incomplete' };
+                                logLine(`✖ ${res.errorText}`, 'stderr');
+                            }
+                        }
                         const blockedReason = aiStepBlockedReason(res.text);
                         const requiresVerification = node.data?.requireVerificationPass === true
                             || /\{\{cmd:(?:verify|revision-verify|opsx:verify)\}\}/.test(rawTemplate);
@@ -1233,9 +1274,7 @@ class LoopRunManager {
                                 ? `blocked — ${blockedReason}`
                                 : verificationFailed
                                     ? 'verification did not finish with VERIFICATION: PASS'
-                                    : undefined);
-                        if (verificationFailed && !blockedReason)
-                            logLine(`✖ ${stepErrorText}`, 'stderr');
+                                    : res.failed ? 'provider invocation failed without a reported reason' : undefined);
                         // Make the failure reason land visibly INSIDE the step's log
                         // segment (the interactive session already surfaced its own note at
                         // settle; the Template/Command flat-log lines are gone, so without
@@ -1243,6 +1282,14 @@ class LoopRunManager {
                         if (oneShotZeroWork) {
                             logLine(`✖ Zero work performed — the command never ran${res.text.trim() ? `: ${res.text.trim()}` : ''}`, 'stderr');
                         }
+                        else if (stepFailed && stepErrorText) {
+                            // Executors can return a structured failure without streaming any
+                            // text (configuration rejection, missing CLI, provider startup).
+                            // Persist its reason before the step closes, including early stops.
+                            logLine(`✖ ${stepErrorText}`, 'stderr');
+                        }
+                        record(`loop:${runId}`, { ...res, failed: stepFailed }, aiStepStart, aiRecoveryKey);
+                        this._activeStepRecovery.delete(runId);
                         // Step tail marker — after the step's last streamed output (both the
                         // one-shot and interactive paths have fully persisted their frames by
                         // here: the session resolves inside onSettle, past its final writes).
@@ -1266,8 +1313,6 @@ class LoopRunManager {
                         else if (stepFailed)
                             aiSessionId = undefined;
                         history.push(`AI Step${stepFailed ? ` FAILED (${stepErrorText ?? 'provider invocation failed'})` : ''}: ${truncate(res.text)}`);
-                        record(`loop:${runId}`, { ...res, failed: stepFailed }, aiStepStart, aiRecoveryKey);
-                        this._activeStepRecovery.delete(runId);
                         if (blockedReason) {
                             const decision = await awaitHumanDecision(blockedReason);
                             if (decision.action === 'stop') {
@@ -1564,6 +1609,7 @@ class LoopRunManager {
         // The ONLY way a persisted stream ends with an open step is a mid-flight
         // dispose (shutdown/project removal), where this code never runs.
         emitStepEnd({ status: 'failed' });
+        let runtimeUsage = { present: false, costUnknown: false, tokensInUnknown: false, tokensOutUnknown: false };
         // A traversal exception can bypass record(). Reconcile the staged step
         // BEFORE writing aggregate job totals, while its jobs baseline is still
         // valid. If reconciliation itself fails, finishLoopRunAndJob detects the
@@ -1571,6 +1617,8 @@ class LoopRunManager {
         try {
             const recoveredSteps = recoverOrphanLoopStepAccounting(this.db, new Date(this.now()).toISOString(), runId);
             this._activeStepRecovery.delete(runId);
+            runtimeUsage = programmaticUsageAvailability(this.db, runId);
+            usageTelemetryAvailable ||= runtimeUsage.present;
             const aggregate = this.db.prepare(`
         SELECT COALESCE(SUM(total_cost_usd), 0) AS cost,
                COALESCE(SUM(tokens_in), 0) AS tokens_in,
@@ -1602,19 +1650,17 @@ class LoopRunManager {
             }
             if (usageTelemetryAvailable) {
                 finalJobUsage = {
-                    tokensIn: aggregate.tokens_in,
-                    tokensOut: aggregate.tokens_out,
-                    tokensCacheRead: aggregate.cache_read,
-                    tokensCacheCreate: aggregate.cache_create,
-                    numTurns: aggregate.turns,
+                    tokensIn: runtimeUsage.tokensInUnknown ? null : aggregate.tokens_in,
+                    tokensOut: runtimeUsage.tokensOutUnknown ? null : aggregate.tokens_out,
+                    tokensCacheRead: runtimeUsage.present ? null : aggregate.cache_read,
+                    tokensCacheCreate: runtimeUsage.present ? null : aggregate.cache_create,
+                    numTurns: runtimeUsage.present ? null : aggregate.turns,
                 };
             }
         }
         catch (err) {
             console.error(`[loop] staged accounting reconciliation failed for ${runId}:`, err);
         }
-        console.log(`[loop] settle run=${runId} outcome=${outcome} iterations=${iteration} ` +
-            (usageTelemetryAvailable ? `cost=$${totalCost.toFixed(4)}` : 'usage=unavailable'));
         // Execution and acceptance are separate facts. Persist the runtime's own
         // terminal snapshot alongside counters so history does not depend on prose.
         let coreCompletion = null;
@@ -1625,6 +1671,9 @@ class LoopRunManager {
         const executionOutcome = outcome;
         if (outcome === 'success' && coreCompletion && (coreCompletion.completion.implementation !== 'complete' || !['verified', 'with-exceptions'].includes(coreCompletion.completion.validation)))
             outcome = 'blocked';
+        const costAvailable = usageTelemetryAvailable && !runtimeUsage.costUnknown;
+        console.log(`[loop] settle run=${runId} outcome=${outcome} iterations=${iteration} ` +
+            (costAvailable ? `cost=$${totalCost.toFixed(4)}` : 'cost=unavailable'));
         emitRunEvent('loop_completion', {
             version: 1, execution: executionOutcome, steps: stepNum, deciderEvaluations: iteration,
             turns: finalJobUsage.numTurns, costUsd: usageTelemetryAvailable ? totalCost : null,
@@ -1642,8 +1691,8 @@ class LoopRunManager {
         // `≥` when any cost-bearing step ended unpriced (timeout/crash) — the figure
         // is a lower bound, not exact. Providers without usage telemetry get an
         // explicit unavailable marker, never a fabricated "$0.0000".
-        logLine(`\n■ Loop execution finished: ${executionOutcome} — ${stepNum} step${stepNum === 1 ? '' : 's'}, ${iteration} decider evaluation${iteration === 1 ? '' : 's'}, ${finalJobUsage.numTurns ?? 'unknown'} agent turns, ` +
-            (usageTelemetryAvailable
+        logLine(`\n■ Loop execution finished: ${outcome} — ${stepNum} step${stepNum === 1 ? '' : 's'}, ${iteration} decider evaluation${iteration === 1 ? '' : 's'}, ${finalJobUsage.numTurns ?? 'unknown'} agent turns, ` +
+            (costAvailable
                 ? `${costUncertain ? '≥ ' : ''}$${totalCost.toFixed(4)}`
                 : 'usage/cost unavailable'));
         if (coreCompletion)
@@ -1663,7 +1712,7 @@ class LoopRunManager {
             job: {
                 exitCode: outcome === 'success' ? 0 : 1,
                 status: jobStatus,
-                totalCostUsd: usageTelemetryAvailable ? totalCost : null,
+                totalCostUsd: costAvailable ? totalCost : null,
                 tokensIn: finalJobUsage.tokensIn,
                 tokensOut: finalJobUsage.tokensOut,
                 tokensCacheRead: finalJobUsage.tokensCacheRead,
@@ -1684,7 +1733,7 @@ class LoopRunManager {
                 tokens_out: finalJobUsage.tokensOut,
                 tokens_cache_read: finalJobUsage.tokensCacheRead,
                 tokens_cache_create: finalJobUsage.tokensCacheCreate,
-                total_cost_usd: usageTelemetryAvailable ? totalCost : null,
+                total_cost_usd: costAvailable ? totalCost : null,
                 num_turns: finalJobUsage.numTurns,
             },
             timestamp: new Date(this.now()).toISOString(),
@@ -1701,7 +1750,7 @@ class LoopRunManager {
             runId,
             outcome,
             iterations: iteration,
-            totalCostUsd: usageTelemetryAvailable ? totalCost : null,
+            totalCostUsd: costAvailable ? totalCost : null,
             ...(outcome === 'stalled' && stallReason ? { stallReason } : {}),
             ...(providerLimitHit ? { providerLimit: providerLimitHit } : {}),
         };

package/server/dist/project-registry.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ProjectRegistry = void 0;
 exports.emitRecoveredPrDelivery = emitRecoveredPrDelivery;
 exports.reprojectActivePrDeliveries = reprojectActivePrDeliveries;
+const agent_runtime_controls_router_1 = require("./agent-runtime-controls-router");
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
 const os_1 = __importDefault(require("os"));
@@ -305,6 +306,10 @@ class ProjectRegistry {
             // Loop engine teardown: dispose any resident interactive step sessions
             // (SIGTERM, no settle) + kill in-flight one-shot loop children — BEFORE
             // db.close() so a late close handler can't write to the closed handle.
+            try {
+                (0, agent_runtime_controls_router_1.shutdownAgentRuntimeControls)(ctx);
+            }
+            catch { /* ignore */ }
             try {
                 ctx.loopRunManager.shutdown();
             }
@@ -540,6 +545,10 @@ class ProjectRegistry {
             catch { /* ignore */ }
             // Loop engine: dispose resident interactive step sessions + kill in-flight
             // one-shot loop children so a quit mid-run doesn't orphan claude processes.
+            try {
+                (0, agent_runtime_controls_router_1.shutdownAgentRuntimeControls)(ctx);
+            }
+            catch { /* ignore */ }
             try {
                 ctx.loopRunManager.shutdown();
             }

package/server/dist/project-router-settings.js

@@ -19,7 +19,11 @@ const terminal_settings_1 = require("./terminal-settings");
 const terminal_marks_store_1 = require("./terminal-marks-store");
 const project_router_helpers_1 = require("./project-router-helpers");
 const install_config_path_1 = require("./install-config-path");
+const agent_runtime_settings_router_1 = require("./agent-runtime-settings-router");
+const agent_runtime_controls_router_1 = require("./agent-runtime-controls-router");
 function registerSettingsRoutes(deps) {
+    (0, agent_runtime_settings_router_1.registerAgentRuntimeSettingsRoutes)(deps);
+    (0, agent_runtime_controls_router_1.registerAgentRuntimeControlRoutes)(deps);
     const { router, registry, ctx, ticketPath } = deps;
     // ─── Project settings (pipeline telemetry) ───────────────────────────────────
     router.get('/:projectId/settings', (req, res) => {

package/server/dist/rail-isolated-launch.js

@@ -67,6 +67,7 @@ const artifact_registry_1 = require("./artifact-registry");
 const ids_1 = require("./ids");
 const loop_constants_1 = require("./loop-constants");
 const worktree_manager_1 = require("./worktree-manager");
+const agent_runtime_paths_1 = require("./agent-runtime-paths");
 const rail_worktrees_store_1 = require("./rail-worktrees-store");
 const pr_naming_1 = require("./pr-naming");
 const jira_db_1 = require("./jira/jira-db");
@@ -1015,6 +1016,19 @@ async function launchIsolatedRail(input, io = {}) {
             callbackFailure = errorDetail(err);
             console.error(`[rail-isolated] terminal callback failed for ${a.runId}: ${callbackFailure}`);
         }
+        // A paused/interrupted programmatic workflow owns unfinished changes and
+        // verification evidence in this exact mount. Keep them available for
+        // explicit Core recovery, including a currently clean worktree.
+        if (implementationOutcome === 'failed' && (0, agent_runtime_paths_1.hasAgentRuntimeRequest)(ctx.project, a.runId)) {
+            markWorktree(a, 'needs-review');
+            return {
+                run: a, implementationOutcome, deliveryOutcome: 'blocked',
+                initialSha: a.initialSha, finalSha: await readHeadSha(git, a.handle.worktreePath),
+                failureCode: 'settlement_interrupted',
+                failureDetail: 'Programmatic workflow needs attention. Resume it from Agent Runtime settings in its original worktree.',
+                safeToRelease: false,
+            };
+        }
         // The engine may have edited a copied overlay file. Re-authenticate only
         // automatic-cleanup authority. Allocation-time paths remain conservative
         // NEVER-COMMIT exclusions, while a modified copy is preserved in the
@@ -1828,6 +1842,10 @@ async function reconcileRailWorktrees(db, repoDir, io = {}) {
             const run = row.run_id
                 ? db.prepare('SELECT status, final_outcome FROM loop_runs WHERE id = ?').get(row.run_id)
                 : undefined;
+            if (row.run_id && run?.final_outcome !== 'success' && (0, agent_runtime_paths_1.hasAgentRuntimeRequest)({ path: io.primaryRepoDir ?? repoDir }, row.run_id)) {
+                (0, rail_worktrees_store_1.updateRailWorktreeState)(db, row.id, 'needs-review');
+                continue;
+            }
             const inspection = await inspectRecoveryWorktree(git, repoDir, row);
             if (run?.status === 'completed' && run.final_outcome === 'success') {
                 if (inspection.safe && inspection.sha) {

package/server/dist/rails-router.js

@@ -1020,6 +1020,7 @@ function createRailsRouter() {
                         loopName,
                         graph: loopGraph,
                         projectId: c.project.id,
+                        repositoryId: primaryRepository.id,
                         cwd: loopExec.cwd,
                         repoDir: loopExec.relocated ? loopExec.repoDir : undefined,
                         railIndex,

package/server/dist/schemas/agent-runtime.schema.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://specrails.dev/schemas/agent-runtime.schema.json",
+  "title": "Specrails programmatic agent runtime",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "enabled", "providers", "agents", "verification"],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "enabled": { "type": "boolean" },
+    "providers": { "type": "array", "items": { "oneOf": [
+      { "type": "object", "additionalProperties": false, "required": ["id", "kind", "cli"], "properties": {
+        "id": { "$ref": "#/definitions/id" }, "kind": { "const": "cli" }, "cli": { "enum": ["claude", "codex", "gemini", "kimi"] }
+      } },
+      { "type": "object", "additionalProperties": false, "required": ["id", "kind", "baseUrl"], "properties": {
+        "id": { "$ref": "#/definitions/id" }, "kind": { "const": "openai-compatible" },
+        "baseUrl": { "type": "string", "pattern": "^https?://[^/?#@]+(?:/[^?#]*)?$" },
+        "apiKeyEnv": { "type": "string", "pattern": "^[A-Za-z_][A-Za-z0-9_]*$" }
+      } }
+    ] } },
+    "agents": { "type": "object", "additionalProperties": false, "required": ["architect", "developer", "reviewer"], "properties": {
+      "architect": { "$ref": "#/definitions/agent" }, "developer": { "$ref": "#/definitions/agent" }, "reviewer": { "$ref": "#/definitions/agent" }
+    } },
+    "limits": { "type": "object", "additionalProperties": false, "properties": {
+      "maxAttempts": { "$ref": "#/definitions/positiveInteger" }, "maxTokens": { "$ref": "#/definitions/positiveInteger" },
+      "maxCostUsd": { "type": "number", "exclusiveMinimum": 0 }, "timeoutMs": { "$ref": "#/definitions/positiveInteger" }
+    } },
+    "verification": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["repositoryId", "command", "args"], "properties": {
+      "repositoryId": { "$ref": "#/definitions/id" }, "command": { "type": "string", "minLength": 1 },
+      "args": { "type": "array", "items": { "type": "string" } }, "cwd": { "type": "string", "minLength": 1 },
+      "env": { "type": "object", "propertyNames": { "pattern": "^[A-Za-z_][A-Za-z0-9_]*$" }, "additionalProperties": { "type": "string" } },
+      "timeoutMs": { "$ref": "#/definitions/positiveInteger" }
+    } } },
+    "approvalBeforeArchive": { "type": "boolean" },
+    "review": { "type": "object", "additionalProperties": false, "description": "Review gate thresholds; unset fields keep Core's defaults (score 70, security 75, other aspects 60).", "properties": {
+      "minScore": { "$ref": "#/definitions/score" },
+      "aspects": { "type": "object", "additionalProperties": false, "properties": {
+        "type_correctness": { "$ref": "#/definitions/score" }, "pattern_adherence": { "$ref": "#/definitions/score" }, "test_coverage": { "$ref": "#/definitions/score" },
+        "security": { "$ref": "#/definitions/score" }, "architectural_alignment": { "$ref": "#/definitions/score" }
+      } }
+    } },
+    "architect": { "type": "object", "additionalProperties": false, "properties": {
+      "onLowConfidence": { "enum": ["ask", "proceed"], "description": "After one autonomous investigation pass, a still-low design either pauses with its question (ask, default) or proceeds on stated assumptions (proceed)." }
+    } }
+  },
+  "definitions": {
+    "id": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$" },
+    "positiveInteger": { "type": "integer", "minimum": 1 },
+    "score": { "type": "number", "minimum": 0, "maximum": 100 },
+    "agent": { "type": "object", "additionalProperties": false, "required": ["provider"], "properties": {
+      "provider": { "$ref": "#/definitions/id" }, "model": { "type": "string", "minLength": 1, "maxLength": 256, "pattern": "^[^-\\r\\n\\u0000][^\\r\\n\\u0000]*$" },
+      "maxTurns": { "$ref": "#/definitions/positiveInteger" }
+    } }
+  }
+}

package/client/dist/assets/AgentBrowserCapture-BQem50z4.js

@@ -1 +0,0 @@
-import{a as e}from"./rolldown-runtime-CNC7AqOf.js";import{n as t,t as n}from"./jsx-runtime-zu2_FqZY.js";import{d as r,f as i,m as a,u as o}from"./TicketDetailModalContext-BbRA6cb7.js";import{n as s}from"./createLucideIcon-Bjbbp_KS.js";import{s as c}from"./useDesktop-gVGoWWiY.js";import{$ as l,Bt as u,Ht as d,P as f,W as p,X as m,v as h}from"./index-UnaJTMIy.js";var g=e(t(),1),_=n();function v({projectId:e,conversationId:t}){let{t:n}=s(`agent`),{error:v}=d(),y=l(t??`__new-mission__`),{closeBrowser:b,queueCapture:x,browserOwnerId:S,browserUrl:C,setBrowserUrl:w}=p(),{materializeDraftConversation:T}=f(),[E,D]=(0,g.useState)(!1),[O,k]=(0,g.useState)(!1),[A,j]=(0,g.useState)(`probing`);(0,g.useEffect)(()=>{if(t&&(E||O||A===`screencast`))return m(t)},[t,E,O,A]);let M=(0,g.useMemo)(()=>{if(C)return C;try{return i(localStorage.getItem(`specrails-desktop:agent-browser-url:${e}`)??``)??`about:blank`}catch{return`about:blank`}},[e]);(0,g.useEffect)(()=>{let e=!0;return r().then(t=>{e&&j(t?`native`:`screencast`)}),()=>{e=!1}},[]);let N=(0,g.useMemo)(()=>`agent-${t??`home`}-${Math.round(performance.now())}`,[t]),P=async e=>{k(!0);try{let r=await u(t??(await T()).id,a(e.screenshotDataUrl,`capture-${Date.now()}.png`));x(r),c.success(n(`workspace.browserCaptured`)),b()}catch(e){throw c.error(n(`workspace.uploadFailed`),{description:e instanceof Error?e.message:void 0}),e}finally{k(!1)}};return A===`probing`?null:A===`native`?(0,_.jsx)(o,{ownerId:S??void 0,leaseRevision:y,onBusyChange:D,transferError:v,url:M,onClose:b,onFallback:()=>j(`screencast`),onUrlChange:t=>{if(w(t),i(t)&&t!==`about:blank`)try{localStorage.setItem(`specrails-desktop:agent-browser-url:${e}`,t)}catch{}},confirmLabel:n(`workspace.browserConfirm`),selectLabel:n(`workspace.browserSelectStart`),onCaptured:P}):(0,_.jsx)(h,{open:!0,onClose:b,projectId:e,pendingSpecId:N,confirmLabel:n(`workspace.browserConfirm`),selectLabel:n(`workspace.browserSelectStart`),onCaptured:P})}export{v as AgentBrowserCapture};

package/client/dist/assets/AgentModeAnalyticsPane-BC_xbT_l.js

@@ -1,2 +0,0 @@
-const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/AnalyticsPage-DTsg-N5z.js","assets/rolldown-runtime-CNC7AqOf.js","assets/jsx-runtime-zu2_FqZY.js","assets/chunk-KS7C4IRE-DEKu087k.js","assets/preload-helper-Czpn1I53.js","assets/useSharedWebSocket-DbGL_YOt.js","assets/activity-DiyjsgQV.js","assets/addspec-D2YIQ0GU.js","assets/agent-Bh9K7iEt.js","assets/agents-ms7TwG16.js","assets/agentstudio-CN2pokQu.js","assets/aiedit-iIjz2_Qk.js","assets/analytics-BMzCvrCU.js","assets/attachments-B53PG733.js","assets/browser-CG0PE1j_.js","assets/builder-BTiGnPT0.js","assets/chat-BGD7MXAy.js","assets/code-DaZ-ZwCT.js","assets/commands-BAWSYHjQ.js","assets/common-BrlwEnL7.js","assets/dashboard-BfBir_6o.js","assets/explore-DgBACn39.js","assets/integrations-mB-7zoyT.js","assets/jira-CKJg3HZd.js","assets/jobs-DMPU64ms.js","assets/loops-B7YpGizO.js","assets/mcp-CUAN6ORK.js","assets/narration-B-ynWTpn.js","assets/nav-Ch-zHBG5.js","assets/packet-Cx-zRuWn.js","assets/settings-CCNZN5Q-.js","assets/setup-Ba11l2JA.js","assets/specs-DII0C8gw.js","assets/terminal-BAzpHtpY.js","assets/tickets-W6pBmbrX.js","assets/createLucideIcon-Bjbbp_KS.js","assets/Trans-mjFZpHw1.js","assets/useDesktop-gVGoWWiY.js","assets/react-dom-DiWzBDP9.js","assets/spending-DXOcv1tn.js","assets/clsx-CjueKrWZ.js","assets/formatDistanceToNow-BIL-HxGy.js","assets/getTimezoneOffsetInMilliseconds-Cs9z2sdO.js","assets/provider-capabilities-B-wOHfLP.js","assets/index-UnaJTMIy.js","assets/TicketDetailModalContext-BbRA6cb7.js","assets/save-B6wGWwBR.js","assets/MinimizedChatsContext-C843Y13h.js","assets/sparkles-DrY8hb0X.js","assets/x-CBMI9ejn.js","assets/file-text-BcLCfcWZ.js","assets/circle-x-CMYsN4ZH.js","assets/download-CFHyyHcw.js","assets/git-branch-BRM0F5GN.js","assets/loader-circle-DcygOQpC.js","assets/pencil-C9RkrIPZ.js","assets/square-Ci-PFcFe.js","assets/plus-CsnjfkmX.js","assets/search-Cq_gE3Ik.js","assets/trash-2-BOU3WdZZ.js","assets/triangle-alert-H9T4jAmh.js","assets/jira-api-B2BBZQTx.js","assets/zap-CHo3aCD1.js","assets/dialog-xXB2q5HJ.js","assets/utils-BC4DHlz2.js","assets/lib-CGdyxIWg.js","assets/button-Ccc9Dc-D.js","assets/RepositoryScopeSelector-CZ_U_R3U.js","assets/project-repositories-xSqimlaj.js","assets/core-B3mKBIh5.js","assets/RepositoryDeliveries-bgIHE8ep.js","assets/event-Bt7f3wXe.js","assets/index-Bfj8HvX1.css","assets/ExportDropdown-DczgU4at.js","assets/BarChart-nBOMNfiy.js","assets/value-s-gzBeyF.js"])))=>i.map(i=>d[i]);
-import{a as e}from"./rolldown-runtime-CNC7AqOf.js";import{n as t,t as n}from"./jsx-runtime-zu2_FqZY.js";import{t as r}from"./preload-helper-Czpn1I53.js";import{n as i}from"./createLucideIcon-Bjbbp_KS.js";import{t as a}from"./loader-circle-DcygOQpC.js";import{t as o}from"./x-CBMI9ejn.js";import{t as s}from"./utils-BC4DHlz2.js";import{W as c,_t as l,gt as u}from"./index-UnaJTMIy.js";var d=e(t(),1),f=n(),p=(0,d.lazy)(()=>r(()=>import(`./AnalyticsPage-DTsg-N5z.js`),__vite__mapDeps([0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75]))),m=420,h=560;function g(){let{t:e}=i(`agent`),{closeAnalyticsPane:t}=c(),[n,r]=(0,d.useState)(h),[g,_]=(0,d.useState)(!1),v=(0,d.useCallback)(e=>{let t=e.clientX,i=n,a=window.innerWidth-m;try{e.currentTarget.setPointerCapture(e.pointerId)}catch{}let o=e=>{let n=Math.min(Math.max(i+(t-e.clientX),m),a);r(n)},s=()=>{window.removeEventListener(`pointermove`,o),window.removeEventListener(`pointerup`,s),window.removeEventListener(`pointercancel`,s)};window.addEventListener(`pointermove`,o),window.addEventListener(`pointerup`,s),window.addEventListener(`pointercancel`,s)},[n]);return(0,f.jsxs)(`div`,{className:s(`flex h-full flex-col overflow-hidden border-l border-border bg-background`,g&&`absolute inset-0 z-30 border-l-0`),style:g?void 0:{width:n,flexShrink:0},"data-testid":`agent-analytics-pane`,children:[(0,f.jsx)(`div`,{className:`relative flex items-center`,children:!g&&(0,f.jsx)(`div`,{role:`separator`,"aria-orientation":`vertical`,onPointerDown:v,className:`absolute left-0 top-0 h-full w-1.5 -translate-x-full cursor-col-resize select-none touch-none hover:bg-accent-primary/20`,title:e(`workspace.resizeAnalytics`)})}),(0,f.jsxs)(`div`,{className:`flex items-center gap-2 border-b border-border/60 bg-surface/40 px-3 py-1.5`,children:[(0,f.jsx)(`span`,{className:`text-xs font-medium text-foreground/70`,children:e(`workspace.analytics`)}),(0,f.jsxs)(`div`,{className:`ml-auto flex items-center gap-1`,children:[(0,f.jsx)(`button`,{type:`button`,onClick:()=>_(e=>!e),"aria-label":e(g?`restore`:`maximize`),title:e(g?`restore`:`maximize`),className:`rounded-md p-1 text-foreground/60 hover:bg-surface hover:text-foreground`,children:g?(0,f.jsx)(u,{className:`h-4 w-4`}):(0,f.jsx)(l,{className:`h-4 w-4`})}),(0,f.jsx)(`button`,{type:`button`,onClick:t,"aria-label":e(`workspace.closeAnalytics`),title:e(`workspace.closeAnalytics`),className:`rounded-md p-1 text-foreground/60 hover:bg-surface hover:text-foreground`,children:(0,f.jsx)(o,{className:`h-4 w-4`})})]})]}),(0,f.jsx)(`div`,{className:`min-h-0 flex-1 overflow-y-auto`,children:(0,f.jsx)(d.Suspense,{fallback:(0,f.jsx)(`div`,{className:`flex h-24 items-center justify-center text-muted-foreground`,children:(0,f.jsx)(a,{className:`h-4 w-4 animate-spin`})}),children:(0,f.jsx)(p,{})})})]})}export{g as AgentModeAnalyticsPane};

package/client/dist/assets/AgentModeCodePane-DK-q3K6Y.js

@@ -1,2 +0,0 @@
-const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/CodePage-DwgbeqQ_.js","assets/rolldown-runtime-CNC7AqOf.js","assets/jsx-runtime-zu2_FqZY.js","assets/react-dom-DiWzBDP9.js","assets/preload-helper-Czpn1I53.js","assets/chunk-KS7C4IRE-DEKu087k.js","assets/TicketDetailModalContext-BbRA6cb7.js","assets/useSharedWebSocket-DbGL_YOt.js","assets/activity-DiyjsgQV.js","assets/addspec-D2YIQ0GU.js","assets/agent-Bh9K7iEt.js","assets/agents-ms7TwG16.js","assets/agentstudio-CN2pokQu.js","assets/aiedit-iIjz2_Qk.js","assets/analytics-BMzCvrCU.js","assets/attachments-B53PG733.js","assets/browser-CG0PE1j_.js","assets/builder-BTiGnPT0.js","assets/chat-BGD7MXAy.js","assets/code-DaZ-ZwCT.js","assets/commands-BAWSYHjQ.js","assets/common-BrlwEnL7.js","assets/dashboard-BfBir_6o.js","assets/explore-DgBACn39.js","assets/integrations-mB-7zoyT.js","assets/jira-CKJg3HZd.js","assets/jobs-DMPU64ms.js","assets/loops-B7YpGizO.js","assets/mcp-CUAN6ORK.js","assets/narration-B-ynWTpn.js","assets/nav-Ch-zHBG5.js","assets/packet-Cx-zRuWn.js","assets/settings-CCNZN5Q-.js","assets/setup-Ba11l2JA.js","assets/specs-DII0C8gw.js","assets/terminal-BAzpHtpY.js","assets/tickets-W6pBmbrX.js","assets/createLucideIcon-Bjbbp_KS.js","assets/Trans-mjFZpHw1.js","assets/useDesktop-gVGoWWiY.js","assets/save-B6wGWwBR.js","assets/spending-DXOcv1tn.js","assets/MinimizedChatsContext-C843Y13h.js","assets/sparkles-DrY8hb0X.js","assets/x-CBMI9ejn.js","assets/file-text-BcLCfcWZ.js","assets/circle-x-CMYsN4ZH.js","assets/download-CFHyyHcw.js","assets/git-branch-BRM0F5GN.js","assets/loader-circle-DcygOQpC.js","assets/pencil-C9RkrIPZ.js","assets/square-Ci-PFcFe.js","assets/plus-CsnjfkmX.js","assets/search-Cq_gE3Ik.js","assets/trash-2-BOU3WdZZ.js","assets/triangle-alert-H9T4jAmh.js","assets/jira-api-B2BBZQTx.js","assets/zap-CHo3aCD1.js","assets/dialog-xXB2q5HJ.js","assets/utils-BC4DHlz2.js","assets/clsx-CjueKrWZ.js","assets/lib-CGdyxIWg.js","assets/formatDistanceToNow-BIL-HxGy.js","assets/getTimezoneOffsetInMilliseconds-Cs9z2sdO.js","assets/button-Ccc9Dc-D.js","assets/RepositoryScopeSelector-CZ_U_R3U.js","assets/project-repositories-xSqimlaj.js","assets/provider-capabilities-B-wOHfLP.js","assets/index-UnaJTMIy.js","assets/core-B3mKBIh5.js","assets/RepositoryDeliveries-bgIHE8ep.js","assets/event-Bt7f3wXe.js","assets/index-Bfj8HvX1.css"])))=>i.map(i=>d[i]);
-import{a as e}from"./rolldown-runtime-CNC7AqOf.js";import{n as t,t as n}from"./jsx-runtime-zu2_FqZY.js";import{t as r}from"./preload-helper-Czpn1I53.js";import{n as i}from"./createLucideIcon-Bjbbp_KS.js";import{t as a}from"./x-CBMI9ejn.js";import{Q as o,W as s,Z as c,_t as l,gt as u}from"./index-UnaJTMIy.js";var d=e(t(),1),f=n(),p=(0,d.lazy)(()=>r(()=>import(`./CodePage-DwgbeqQ_.js`),__vite__mapDeps([0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72]))),m=420,h=560;function g({projectId:e,conversationId:t}){let{t:n}=i(`agent`),{closeCodePane:r}=s(),[g,_]=(0,d.useState)(h),[v,y]=(0,d.useState)(()=>window.innerWidth),[b,x]=(0,d.useState)(!1),S=(0,d.useRef)(null),C=(0,d.useRef)(null),w=Math.max(0,v-Math.min(m,v/2)),T=Math.min(m,w),E=Math.min(w,Math.max(T,g)),D=(0,d.useCallback)(e=>Math.min(w,Math.max(T,e)),[w,T]),O=`${e}:${t}`,k=(0,d.useCallback)(n=>{o(e,t,{path:n})},[e,t]);(0,d.useLayoutEffect)(()=>{let e=S.current,t=e?.parentElement;if(!e||!t)return;let n=()=>{let n=t.getBoundingClientRect().width||t.clientWidth||window.innerWidth,r=0;for(let n of t.children){if(n===e||!(n instanceof HTMLElement))continue;let t=getComputedStyle(n);t.display===`none`||t.position===`absolute`||t.position===`fixed`||Number(t.flexGrow)>0||(r+=n.getBoundingClientRect().width)}y(Math.max(0,n-r))},r=new ResizeObserver(n),i=()=>{r.disconnect(),r.observe(t);for(let n of t.children)n!==e&&r.observe(n);n()},a=new MutationObserver(i);return a.observe(t,{childList:!0}),i(),window.addEventListener(`resize`,n),()=>{r.disconnect(),a.disconnect(),window.removeEventListener(`resize`,n)}},[O]),(0,d.useEffect)(()=>()=>{C.current?.()},[O,b,w]);let A=(0,d.useCallback)(e=>{if(e.button!==0)return;e.preventDefault(),C.current?.();let t=e.clientX,n=E,r=e.pointerId,i=e.currentTarget;try{i.setPointerCapture(r)}catch{}let a=e=>{e.pointerId===r&&_(D(n+t-e.clientX))},o=()=>{window.removeEventListener(`pointermove`,a),window.removeEventListener(`pointerup`,s),window.removeEventListener(`pointercancel`,s),window.removeEventListener(`blur`,o),i.removeEventListener(`lostpointercapture`,o);try{i.hasPointerCapture(r)&&i.releasePointerCapture(r)}catch{}C.current=null},s=e=>{e.pointerId===r&&o()};C.current=o,window.addEventListener(`pointermove`,a),window.addEventListener(`pointerup`,s),window.addEventListener(`pointercancel`,s),window.addEventListener(`blur`,o),i.addEventListener(`lostpointercapture`,o)},[E,D]);return(0,f.jsxs)(`div`,{ref:S,className:`flex h-full min-w-0 flex-col overflow-hidden border-l border-border bg-background${b?` absolute inset-0 z-30 border-l-0`:` relative`}`,style:b?void 0:{width:E,maxWidth:`100%`,flexShrink:0},"data-testid":`agent-code-pane`,children:[!b&&(0,f.jsx)(`div`,{role:`separator`,"aria-orientation":`vertical`,onPointerDown:A,tabIndex:0,"aria-label":n(`workspace.resizeCode`),"aria-valuemin":Math.round(T),"aria-valuemax":Math.round(w),"aria-valuenow":Math.round(E),onKeyDown:e=>{let t=e.key===`ArrowLeft`?E+32:e.key===`ArrowRight`?E-32:e.key===`Home`?T:e.key===`End`?w:null;t!==null&&(e.preventDefault(),_(D(t)))},className:`absolute inset-y-0 left-0 z-20 w-1.5 cursor-col-resize select-none touch-none hover:bg-accent-primary/20 focus-visible:bg-accent-primary/30 focus-visible:outline-none`,title:n(`workspace.resizeCode`)}),(0,f.jsxs)(`div`,{className:`flex items-center gap-2 border-b border-border/60 bg-surface/40 px-3 py-1.5`,children:[(0,f.jsx)(`span`,{className:`text-xs font-medium text-foreground/70`,children:n(`workspace.files`)}),(0,f.jsxs)(`div`,{className:`ml-auto flex items-center gap-1`,children:[(0,f.jsx)(`button`,{type:`button`,onClick:()=>{C.current?.(),x(e=>!e)},"aria-label":n(b?`restore`:`maximize`),title:n(b?`restore`:`maximize`),className:`rounded-md p-1 text-foreground/60 hover:bg-surface hover:text-foreground`,children:b?(0,f.jsx)(u,{className:`h-4 w-4`}):(0,f.jsx)(l,{className:`h-4 w-4`})}),(0,f.jsx)(`button`,{type:`button`,onClick:()=>{C.current?.(),r()},"aria-label":n(`workspace.closeFiles`),title:n(`workspace.closeFiles`),className:`rounded-md p-1 text-foreground/60 hover:bg-surface hover:text-foreground`,children:(0,f.jsx)(a,{className:`h-4 w-4`})})]})]}),(0,f.jsx)(`div`,{className:`min-h-0 flex-1 overflow-hidden`,children:(0,f.jsx)(d.Suspense,{fallback:(0,f.jsx)(`div`,{className:`flex h-full items-center justify-center text-sm text-muted-foreground`,children:`…`}),children:(0,f.jsx)(p,{embedded:!0,initialRepositoryId:c(e,t).repositoryId,onRepositoryChange:n=>o(e,t,{repositoryId:n}),initialPath:c(e,t).path,onSelectedPathChange:k},O)})})]},O)}export{g as AgentModeCodePane};