@jinn-network/client 0.1.6-canary.fb9c8196 → 0.1.6

package/dist/harnesses/cost-estimates.d.ts

@@ -1,145 +0,0 @@
-/**
- * Per-task cost estimates for paid-API-key harnesses.
- *
- * Background — Issue #331 (Run-mode `feat`, P0 tier under release-feedback
- * umbrella #328). The operator dashboard surfaces a harness/model selection
- * at SolverNet-join time and again in Settings. Operators routing a paid
- * API key (Anthropic, OpenAI, OpenRouter, Nous Portal) through the Hermes
- * harness — or a "raw API key" Claude Code variant if we ever add one —
- * have **no UI nudge** at join-time about per-task cost. The v0.1.6 dogfood
- * surfaced the concrete worry: a first-run operator could pick Opus 4.7 +
- * SWE-rebench v2 and burn $100s/hr before they figure out what Jinn does.
- *
- * This module captures the heuristic the SPA uses to render that estimate
- * and to gate the Save & Join action when the estimate exceeds a
- * configurable per-task threshold (default $1).
- *
- * Heuristic shape per the spec:
- *   per-1k-token rate × typical task length, by model id.
- *
- * Subscription harnesses (Claude Code, Codex) are flagged via
- * `subscriptionPath: true` on the harness; in that case the surface shows
- * "Included in subscription, no per-task API cost" and **does not** trigger
- * the confirmation gate, regardless of the model selected.
- *
- * To add a new model: append an entry to `MODEL_COST_TABLE`. The id is the
- * exact `model` string persisted to `joinedSolverNets[<cid>].model`. To
- * shape a new harness: append to `HARNESS_BILLING`. Keep the units
- * consistent: token counts in tokens, rates in USD-per-1k-tokens.
- *
- * Units note: Anthropic + OpenAI publish prices per million tokens; we
- * convert to per-1k-tokens here so the multiplication reads as
- * `(tokens / 1000) * pricePer1k`. Avoids floating-point surprises when the
- * dashboard renders cents.
- *
- * Pricing references captured at the time of this commit (see PR body):
- *   - Anthropic Claude Opus 4.7: $15/M input, $75/M output (≈ $0.015 / 1k
- *     input, $0.075 / 1k output). Typical SWE-rebench v2 task estimated at
- *     ~50k input + 20k output → ~$2.25/task. Anthropic public pricing.
- *   - Anthropic Claude Sonnet 4.6: $3/M input, $15/M output.
- *   - OpenAI GPT-5.4: $1.25/M input, $10/M output (OpenAI public pricing).
- *   - OpenAI GPT-5.4 Mini: $0.25/M input, $2/M output.
- *
- * These are heuristics. Provider-API reconciliation (actual usage) is
- * deferred to the P1 follow-up tracked in #331.
- */
-export type Provider = 'anthropic' | 'openai' | 'openrouter' | 'nous' | 'other';
-export interface ModelCostEntry {
-    /** Upstream API provider that owns the billing relationship. */
-    provider: Provider;
-    /** USD per 1k input tokens. */
-    inputPer1kTokens: number;
-    /** USD per 1k output tokens. */
-    outputPer1kTokens: number;
-    /** Typical input-token consumption for a single task. Heuristic. */
-    typicalInputTokens: number;
-    /** Typical output-token consumption for a single task. Heuristic. */
-    typicalOutputTokens: number;
-    /**
-     * `true` when this model id is only ever reached via a subscription path
-     * (e.g. a future "Claude Code subscription" pinned model). The default
-     * gate logic prefers the harness-level flag — this exists so an
-     * individual model entry can override it on a per-id basis.
-     */
-    subscriptionPath?: boolean;
-}
-/**
- * Per-model cost entries. Keyed by the exact `model` id persisted to
- * `joinedSolverNets[<cid>].model`. The dashboard model dropdown in
- * `claudeModels.ts` is the source of truth for which ids appear here.
- */
-export declare const MODEL_COST_TABLE: Readonly<Record<string, ModelCostEntry>>;
-/**
- * Harness-level billing classification.
- *
- * `subscriptionPath: true` means the harness shells out to a
- * subscription-billed CLI (Claude Code, Codex) and the operator does NOT
- * incur per-task API charges — the cost surface is suppressed entirely
- * and the confirmation gate is never triggered.
- *
- * `subscriptionPath: false` means the harness routes to a paid API key
- * (Hermes via OpenRouter / Anthropic API / Nous Portal). The cost surface
- * is shown and the gate fires above the configured threshold.
- */
-export declare const HARNESS_BILLING: Readonly<Record<string, {
-    subscriptionPath: boolean;
-}>>;
-/** Default per-task USD threshold above which the confirmation gate fires. */
-export declare const DEFAULT_HIGH_COST_THRESHOLD_USD = 1;
-export interface CostEstimate {
-    /** Estimated per-task cost in USD. */
-    usd: number;
-    /** Computed input cost in USD. */
-    inputUsd: number;
-    /** Computed output cost in USD. */
-    outputUsd: number;
-    /** Heuristic typical input tokens used. */
-    typicalInputTokens: number;
-    /** Heuristic typical output tokens used. */
-    typicalOutputTokens: number;
-    /** Underlying entry consulted. */
-    entry: ModelCostEntry;
-}
-/**
- * Compute the per-task cost estimate for a given model id. Returns `null`
- * when the id has no entry in `MODEL_COST_TABLE` — callers should treat
- * that as "unknown, don't surface a number" rather than rendering $0.
- */
-export declare function estimateModelCost(modelId: string): CostEstimate | null;
-/**
- * `true` when the harness routes through a paid API key. Subscription
- * harnesses (Claude Code, Codex) return `false`; unknown harnesses
- * conservatively return `true` so a misnamed harness doesn't silently
- * skip the cost surface.
- */
-export declare function harnessUsesPaidApiKey(harness: string | undefined): boolean;
-export interface CostSurfaceDecision {
-    /** Whether to show a numeric cost-per-task estimate at all. */
-    showEstimate: boolean;
-    /** Resolved estimate (may be `null` even when `showEstimate` is true if the model id is unknown). */
-    estimate: CostEstimate | null;
-    /** Whether the Save & Join action requires the high-cost confirmation. */
-    requiresConfirmation: boolean;
-    /**
-     * Human-readable reason the surface is suppressed when `showEstimate`
-     * is false — e.g. "Included in subscription, no per-task API cost".
-     * `null` when the surface is shown.
-     */
-    suppressedReason: string | null;
-}
-/**
- * Decide what the cost surface should render for a given harness + model
- * combination, plus whether the confirmation gate fires.
- *
- * Defaults:
- *   - threshold: $1 / task (see DEFAULT_HIGH_COST_THRESHOLD_USD).
- *   - subscription harness → suppress surface + skip gate.
- *   - unknown model on a paid harness → show estimate slot (caller may
- *     render "estimate unavailable") but DO NOT trigger the gate.
- */
-export declare function decideCostSurface(harness: string | undefined, modelId: string | undefined, thresholdUsd?: number): CostSurfaceDecision;
-/**
- * Format a USD amount for compact display in the dashboard. Picks the
- * smallest fraction count that still distinguishes the value from $0.
- */
-export declare function formatUsd(amount: number): string;

package/dist/harnesses/cost-estimates.js

@@ -1,297 +0,0 @@
-/**
- * Per-task cost estimates for paid-API-key harnesses.
- *
- * Background — Issue #331 (Run-mode `feat`, P0 tier under release-feedback
- * umbrella #328). The operator dashboard surfaces a harness/model selection
- * at SolverNet-join time and again in Settings. Operators routing a paid
- * API key (Anthropic, OpenAI, OpenRouter, Nous Portal) through the Hermes
- * harness — or a "raw API key" Claude Code variant if we ever add one —
- * have **no UI nudge** at join-time about per-task cost. The v0.1.6 dogfood
- * surfaced the concrete worry: a first-run operator could pick Opus 4.7 +
- * SWE-rebench v2 and burn $100s/hr before they figure out what Jinn does.
- *
- * This module captures the heuristic the SPA uses to render that estimate
- * and to gate the Save & Join action when the estimate exceeds a
- * configurable per-task threshold (default $1).
- *
- * Heuristic shape per the spec:
- *   per-1k-token rate × typical task length, by model id.
- *
- * Subscription harnesses (Claude Code, Codex) are flagged via
- * `subscriptionPath: true` on the harness; in that case the surface shows
- * "Included in subscription, no per-task API cost" and **does not** trigger
- * the confirmation gate, regardless of the model selected.
- *
- * To add a new model: append an entry to `MODEL_COST_TABLE`. The id is the
- * exact `model` string persisted to `joinedSolverNets[<cid>].model`. To
- * shape a new harness: append to `HARNESS_BILLING`. Keep the units
- * consistent: token counts in tokens, rates in USD-per-1k-tokens.
- *
- * Units note: Anthropic + OpenAI publish prices per million tokens; we
- * convert to per-1k-tokens here so the multiplication reads as
- * `(tokens / 1000) * pricePer1k`. Avoids floating-point surprises when the
- * dashboard renders cents.
- *
- * Pricing references captured at the time of this commit (see PR body):
- *   - Anthropic Claude Opus 4.7: $15/M input, $75/M output (≈ $0.015 / 1k
- *     input, $0.075 / 1k output). Typical SWE-rebench v2 task estimated at
- *     ~50k input + 20k output → ~$2.25/task. Anthropic public pricing.
- *   - Anthropic Claude Sonnet 4.6: $3/M input, $15/M output.
- *   - OpenAI GPT-5.4: $1.25/M input, $10/M output (OpenAI public pricing).
- *   - OpenAI GPT-5.4 Mini: $0.25/M input, $2/M output.
- *
- * These are heuristics. Provider-API reconciliation (actual usage) is
- * deferred to the P1 follow-up tracked in #331.
- */
-import { CLAUDE_CODE_HARNESS, CODEX_HARNESS, HERMES_AGENT_HARNESS, canonicalHarnessName, } from './names.js';
-/**
- * Per-model cost entries. Keyed by the exact `model` id persisted to
- * `joinedSolverNets[<cid>].model`. The dashboard model dropdown in
- * `claudeModels.ts` is the source of truth for which ids appear here.
- */
-export const MODEL_COST_TABLE = {
-    // ---------- Anthropic family (direct + via OpenRouter) ----------
-    'claude-opus-4-7': {
-        provider: 'anthropic',
-        inputPer1kTokens: 0.015,
-        outputPer1kTokens: 0.075,
-        typicalInputTokens: 50_000,
-        typicalOutputTokens: 20_000,
-    },
-    'claude-sonnet-4-6': {
-        provider: 'anthropic',
-        inputPer1kTokens: 0.003,
-        outputPer1kTokens: 0.015,
-        typicalInputTokens: 50_000,
-        typicalOutputTokens: 20_000,
-    },
-    'claude-haiku-4-5-20251001': {
-        provider: 'anthropic',
-        inputPer1kTokens: 0.001,
-        outputPer1kTokens: 0.005,
-        typicalInputTokens: 50_000,
-        typicalOutputTokens: 20_000,
-    },
-    // OpenRouter routing of the same families (Hermes harness uses these).
-    'anthropic/claude-opus-4.7': {
-        provider: 'openrouter',
-        inputPer1kTokens: 0.015,
-        outputPer1kTokens: 0.075,
-        typicalInputTokens: 50_000,
-        typicalOutputTokens: 20_000,
-    },
-    'anthropic/claude-sonnet-4.6': {
-        provider: 'openrouter',
-        inputPer1kTokens: 0.003,
-        outputPer1kTokens: 0.015,
-        typicalInputTokens: 50_000,
-        typicalOutputTokens: 20_000,
-    },
-    // ---------- OpenAI family ----------
-    'gpt-5.4': {
-        provider: 'openai',
-        inputPer1kTokens: 0.00125,
-        outputPer1kTokens: 0.01,
-        typicalInputTokens: 50_000,
-        typicalOutputTokens: 20_000,
-    },
-    'gpt-5.4-mini': {
-        provider: 'openai',
-        inputPer1kTokens: 0.00025,
-        outputPer1kTokens: 0.002,
-        typicalInputTokens: 50_000,
-        typicalOutputTokens: 20_000,
-    },
-    'gpt-5.5': {
-        provider: 'openai',
-        // Newer flagship; public pricing not confirmed at heuristic-capture
-        // time, so use Opus-4.7-class rates as a conservative upper bound
-        // until we get a verified figure.
-        inputPer1kTokens: 0.015,
-        outputPer1kTokens: 0.06,
-        typicalInputTokens: 50_000,
-        typicalOutputTokens: 20_000,
-    },
-    'gpt-5.3-codex': {
-        provider: 'openai',
-        inputPer1kTokens: 0.00125,
-        outputPer1kTokens: 0.01,
-        typicalInputTokens: 50_000,
-        typicalOutputTokens: 20_000,
-    },
-    'gpt-5.3-codex-spark': {
-        provider: 'openai',
-        inputPer1kTokens: 0.00125,
-        outputPer1kTokens: 0.01,
-        typicalInputTokens: 50_000,
-        typicalOutputTokens: 20_000,
-    },
-    // ---------- OpenRouter long-tail (Hermes) ----------
-    // These rates are coarse — OpenRouter's effective price depends on the
-    // route picked. We pick the published list-price upper bound so the
-    // estimate biases toward over-warning rather than under-warning.
-    'tencent/hy3-preview': {
-        provider: 'openrouter',
-        inputPer1kTokens: 0.003,
-        outputPer1kTokens: 0.015,
-        typicalInputTokens: 50_000,
-        typicalOutputTokens: 20_000,
-    },
-    'deepseek/deepseek-v4-pro': {
-        provider: 'openrouter',
-        inputPer1kTokens: 0.0014,
-        outputPer1kTokens: 0.0028,
-        typicalInputTokens: 50_000,
-        typicalOutputTokens: 20_000,
-    },
-    'deepseek/deepseek-v4-flash': {
-        provider: 'openrouter',
-        inputPer1kTokens: 0.0001,
-        outputPer1kTokens: 0.0004,
-        typicalInputTokens: 50_000,
-        typicalOutputTokens: 20_000,
-    },
-    'google/gemini-3.1-flash-lite': {
-        provider: 'openrouter',
-        inputPer1kTokens: 0.0001,
-        outputPer1kTokens: 0.0004,
-        typicalInputTokens: 50_000,
-        typicalOutputTokens: 20_000,
-    },
-    'moonshotai/kimi-k2.6': {
-        provider: 'openrouter',
-        inputPer1kTokens: 0.0006,
-        outputPer1kTokens: 0.0025,
-        typicalInputTokens: 50_000,
-        typicalOutputTokens: 20_000,
-    },
-    'openrouter/owl-alpha': {
-        provider: 'openrouter',
-        inputPer1kTokens: 0.002,
-        outputPer1kTokens: 0.008,
-        typicalInputTokens: 50_000,
-        typicalOutputTokens: 20_000,
-    },
-    'minimax/minimax-m2.7': {
-        provider: 'openrouter',
-        inputPer1kTokens: 0.0008,
-        outputPer1kTokens: 0.0032,
-        typicalInputTokens: 50_000,
-        typicalOutputTokens: 20_000,
-    },
-    'nousresearch/hermes-4-405b': {
-        provider: 'nous',
-        inputPer1kTokens: 0.0009,
-        outputPer1kTokens: 0.0009,
-        typicalInputTokens: 50_000,
-        typicalOutputTokens: 20_000,
-    },
-};
-/**
- * Harness-level billing classification.
- *
- * `subscriptionPath: true` means the harness shells out to a
- * subscription-billed CLI (Claude Code, Codex) and the operator does NOT
- * incur per-task API charges — the cost surface is suppressed entirely
- * and the confirmation gate is never triggered.
- *
- * `subscriptionPath: false` means the harness routes to a paid API key
- * (Hermes via OpenRouter / Anthropic API / Nous Portal). The cost surface
- * is shown and the gate fires above the configured threshold.
- */
-export const HARNESS_BILLING = {
-    [CLAUDE_CODE_HARNESS]: { subscriptionPath: true },
-    [CODEX_HARNESS]: { subscriptionPath: true },
-    [HERMES_AGENT_HARNESS]: { subscriptionPath: false },
-};
-/** Default per-task USD threshold above which the confirmation gate fires. */
-export const DEFAULT_HIGH_COST_THRESHOLD_USD = 1;
-/**
- * Compute the per-task cost estimate for a given model id. Returns `null`
- * when the id has no entry in `MODEL_COST_TABLE` — callers should treat
- * that as "unknown, don't surface a number" rather than rendering $0.
- */
-export function estimateModelCost(modelId) {
-    const entry = MODEL_COST_TABLE[modelId];
-    if (!entry)
-        return null;
-    const inputUsd = (entry.typicalInputTokens / 1000) * entry.inputPer1kTokens;
-    const outputUsd = (entry.typicalOutputTokens / 1000) * entry.outputPer1kTokens;
-    return {
-        usd: inputUsd + outputUsd,
-        inputUsd,
-        outputUsd,
-        typicalInputTokens: entry.typicalInputTokens,
-        typicalOutputTokens: entry.typicalOutputTokens,
-        entry,
-    };
-}
-/**
- * `true` when the harness routes through a paid API key. Subscription
- * harnesses (Claude Code, Codex) return `false`; unknown harnesses
- * conservatively return `true` so a misnamed harness doesn't silently
- * skip the cost surface.
- */
-export function harnessUsesPaidApiKey(harness) {
-    if (!harness)
-        return false;
-    const canonical = canonicalHarnessName(harness);
-    const billing = HARNESS_BILLING[canonical];
-    if (!billing)
-        return true;
-    return !billing.subscriptionPath;
-}
-/**
- * Decide what the cost surface should render for a given harness + model
- * combination, plus whether the confirmation gate fires.
- *
- * Defaults:
- *   - threshold: $1 / task (see DEFAULT_HIGH_COST_THRESHOLD_USD).
- *   - subscription harness → suppress surface + skip gate.
- *   - unknown model on a paid harness → show estimate slot (caller may
- *     render "estimate unavailable") but DO NOT trigger the gate.
- */
-export function decideCostSurface(harness, modelId, thresholdUsd = DEFAULT_HIGH_COST_THRESHOLD_USD) {
-    if (!harnessUsesPaidApiKey(harness)) {
-        return {
-            showEstimate: false,
-            estimate: null,
-            requiresConfirmation: false,
-            suppressedReason: 'Included in subscription, no per-task API cost.',
-        };
-    }
-    const estimate = modelId ? estimateModelCost(modelId) : null;
-    const modelOverridesSubscription = estimate?.entry.subscriptionPath === true;
-    if (modelOverridesSubscription) {
-        return {
-            showEstimate: false,
-            estimate: null,
-            requiresConfirmation: false,
-            suppressedReason: 'Included in subscription, no per-task API cost.',
-        };
-    }
-    return {
-        showEstimate: true,
-        estimate,
-        requiresConfirmation: estimate !== null && estimate.usd > thresholdUsd,
-        suppressedReason: null,
-    };
-}
-/**
- * Format a USD amount for compact display in the dashboard. Picks the
- * smallest fraction count that still distinguishes the value from $0.
- */
-export function formatUsd(amount) {
-    if (!Number.isFinite(amount))
-        return '—';
-    if (amount === 0)
-        return '$0';
-    if (amount < 0.01)
-        return `<$0.01`;
-    if (amount < 1)
-        return `$${amount.toFixed(2)}`;
-    if (amount < 10)
-        return `$${amount.toFixed(2)}`;
-    return `$${amount.toFixed(2)}`;
-}
-//# sourceMappingURL=cost-estimates.js.map

package/dist/harnesses/cost-estimates.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cost-estimates.js","sourceRoot":"","sources":["../../src/harnesses/cost-estimates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAwBpB;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA6C;IACxE,mEAAmE;IACnE,iBAAiB,EAAE;QACjB,QAAQ,EAAE,WAAW;QACrB,gBAAgB,EAAE,KAAK;QACvB,iBAAiB,EAAE,KAAK;QACxB,kBAAkB,EAAE,MAAM;QAC1B,mBAAmB,EAAE,MAAM;KAC5B;IACD,mBAAmB,EAAE;QACnB,QAAQ,EAAE,WAAW;QACrB,gBAAgB,EAAE,KAAK;QACvB,iBAAiB,EAAE,KAAK;QACxB,kBAAkB,EAAE,MAAM;QAC1B,mBAAmB,EAAE,MAAM;KAC5B;IACD,2BAA2B,EAAE;QAC3B,QAAQ,EAAE,WAAW;QACrB,gBAAgB,EAAE,KAAK;QACvB,iBAAiB,EAAE,KAAK;QACxB,kBAAkB,EAAE,MAAM;QAC1B,mBAAmB,EAAE,MAAM;KAC5B;IACD,uEAAuE;IACvE,2BAA2B,EAAE;QAC3B,QAAQ,EAAE,YAAY;QACtB,gBAAgB,EAAE,KAAK;QACvB,iBAAiB,EAAE,KAAK;QACxB,kBAAkB,EAAE,MAAM;QAC1B,mBAAmB,EAAE,MAAM;KAC5B;IACD,6BAA6B,EAAE;QAC7B,QAAQ,EAAE,YAAY;QACtB,gBAAgB,EAAE,KAAK;QACvB,iBAAiB,EAAE,KAAK;QACxB,kBAAkB,EAAE,MAAM;QAC1B,mBAAmB,EAAE,MAAM;KAC5B;IAED,sCAAsC;IACtC,SAAS,EAAE;QACT,QAAQ,EAAE,QAAQ;QAClB,gBAAgB,EAAE,OAAO;QACzB,iBAAiB,EAAE,IAAI;QACvB,kBAAkB,EAAE,MAAM;QAC1B,mBAAmB,EAAE,MAAM;KAC5B;IACD,cAAc,EAAE;QACd,QAAQ,EAAE,QAAQ;QAClB,gBAAgB,EAAE,OAAO;QACzB,iBAAiB,EAAE,KAAK;QACxB,kBAAkB,EAAE,MAAM;QAC1B,mBAAmB,EAAE,MAAM;KAC5B;IACD,SAAS,EAAE;QACT,QAAQ,EAAE,QAAQ;QAClB,oEAAoE;QACpE,kEAAkE;QAClE,kCAAkC;QAClC,gBAAgB,EAAE,KAAK;QACvB,iBAAiB,EAAE,IAAI;QACvB,kBAAkB,EAAE,MAAM;QAC1B,mBAAmB,EAAE,MAAM;KAC5B;IACD,eAAe,EAAE;QACf,QAAQ,EAAE,QAAQ;QAClB,gBAAgB,EAAE,OAAO;QACzB,iBAAiB,EAAE,IAAI;QACvB,kBAAkB,EAAE,MAAM;QAC1B,mBAAmB,EAAE,MAAM;KAC5B;IACD,qBAAqB,EAAE;QACrB,QAAQ,EAAE,QAAQ;QAClB,gBAAgB,EAAE,OAAO;QACzB,iBAAiB,EAAE,IAAI;QACvB,kBAAkB,EAAE,MAAM;QAC1B,mBAAmB,EAAE,MAAM;KAC5B;IAED,sDAAsD;IACtD,uEAAuE;IACvE,oEAAoE;IACpE,iEAAiE;IACjE,qBAAqB,EAAE;QACrB,QAAQ,EAAE,YAAY;QACtB,gBAAgB,EAAE,KAAK;QACvB,iBAAiB,EAAE,KAAK;QACxB,kBAAkB,EAAE,MAAM;QAC1B,mBAAmB,EAAE,MAAM;KAC5B;IACD,0BAA0B,EAAE;QAC1B,QAAQ,EAAE,YAAY;QACtB,gBAAgB,EAAE,MAAM;QACxB,iBAAiB,EAAE,MAAM;QACzB,kBAAkB,EAAE,MAAM;QAC1B,mBAAmB,EAAE,MAAM;KAC5B;IACD,4BAA4B,EAAE;QAC5B,QAAQ,EAAE,YAAY;QACtB,gBAAgB,EAAE,MAAM;QACxB,iBAAiB,EAAE,MAAM;QACzB,kBAAkB,EAAE,MAAM;QAC1B,mBAAmB,EAAE,MAAM;KAC5B;IACD,8BAA8B,EAAE;QAC9B,QAAQ,EAAE,YAAY;QACtB,gBAAgB,EAAE,MAAM;QACxB,iBAAiB,EAAE,MAAM;QACzB,kBAAkB,EAAE,MAAM;QAC1B,mBAAmB,EAAE,MAAM;KAC5B;IACD,sBAAsB,EAAE;QACtB,QAAQ,EAAE,YAAY;QACtB,gBAAgB,EAAE,MAAM;QACxB,iBAAiB,EAAE,MAAM;QACzB,kBAAkB,EAAE,MAAM;QAC1B,mBAAmB,EAAE,MAAM;KAC5B;IACD,sBAAsB,EAAE;QACtB,QAAQ,EAAE,YAAY;QACtB,gBAAgB,EAAE,KAAK;QACvB,iBAAiB,EAAE,KAAK;QACxB,kBAAkB,EAAE,MAAM;QAC1B,mBAAmB,EAAE,MAAM;KAC5B;IACD,sBAAsB,EAAE;QACtB,QAAQ,EAAE,YAAY;QACtB,gBAAgB,EAAE,MAAM;QACxB,iBAAiB,EAAE,MAAM;QACzB,kBAAkB,EAAE,MAAM;QAC1B,mBAAmB,EAAE,MAAM;KAC5B;IACD,4BAA4B,EAAE;QAC5B,QAAQ,EAAE,MAAM;QAChB,gBAAgB,EAAE,MAAM;QACxB,iBAAiB,EAAE,MAAM;QACzB,kBAAkB,EAAE,MAAM;QAC1B,mBAAmB,EAAE,MAAM;KAC5B;CACF,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,eAAe,GAA4D;IACtF,CAAC,mBAAmB,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE;IACjD,CAAC,aAAa,CAAC,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE;IAC3C,CAAC,oBAAoB,CAAC,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE;CACpD,CAAC;AAEF,8EAA8E;AAC9E,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC;AAiBjD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,kBAAkB,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC,gBAAgB,CAAC;IAC5E,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,mBAAmB,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC,iBAAiB,CAAC;IAC/E,OAAO;QACL,GAAG,EAAE,QAAQ,GAAG,SAAS;QACzB,QAAQ;QACR,SAAS;QACT,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;QAC9C,KAAK;KACN,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA2B;IAC/D,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,MAAM,SAAS,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;IAC3C,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC;AACnC,CAAC;AAiBD;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAA2B,EAC3B,OAA2B,EAC3B,eAAuB,+BAA+B;IAEtD,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,EAAE,CAAC;QACpC,OAAO;YACL,YAAY,EAAE,KAAK;YACnB,QAAQ,EAAE,IAAI;YACd,oBAAoB,EAAE,KAAK;YAC3B,gBAAgB,EAAE,iDAAiD;SACpE,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7D,MAAM,0BAA0B,GAC9B,QAAQ,EAAE,KAAK,CAAC,gBAAgB,KAAK,IAAI,CAAC;IAC5C,IAAI,0BAA0B,EAAE,CAAC;QAC/B,OAAO;YACL,YAAY,EAAE,KAAK;YACnB,QAAQ,EAAE,IAAI;YACd,oBAAoB,EAAE,KAAK;YAC3B,gBAAgB,EAAE,iDAAiD;SACpE,CAAC;IACJ,CAAC;IACD,OAAO;QACL,YAAY,EAAE,IAAI;QAClB,QAAQ;QACR,oBAAoB,EAAE,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,GAAG,GAAG,YAAY;QACtE,gBAAgB,EAAE,IAAI;KACvB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,GAAG,CAAC;IACzC,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,MAAM,GAAG,IAAI;QAAE,OAAO,QAAQ,CAAC;IACnC,IAAI,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/C,IAAI,MAAM,GAAG,EAAE;QAAE,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AACjC,CAAC"}

package/dist/restart-daemon.d.ts

@@ -1,71 +0,0 @@
-/**
- * In-process respawn helper for operator-triggered daemon restarts.
- *
- * Issue #289: clicking "Restart node" in the operator panel previously called
- * `process.exit(0)`, which killed the daemon and stranded the operator outside
- * the app (the panel went 502, the terminal got a shell prompt). Every
- * restart-required config change funnelled through the same handler:
- *
- *   - POST /v1/setup/network              — RPC URL change
- *   - POST /v1/setup/change-password      — keystore password rotation
- *   - POST /v1/setup/solvernets/:name     — SolverNet enable/disable
- *   - POST /v1/operator/join/:cid         — SolverNet join
- *
- * The fix is the smallest thing that makes the button mean what it says:
- * before the parent exits, spawn a detached copy of the current process,
- * inheriting argv (sans node binary), env, and stdio. The child takes over
- * the port; the panel reconnects within a couple of seconds.
- *
- * Headless gate: `JINN_NO_UI=1` (already the established headless flag in
- * main.ts) skips the respawn — operators running `jinn run --no-ui` from a
- * supervisor / systemd unit / docker entrypoint want the supervisor to
- * decide whether to restart, not the daemon.
- *
- * The helper is split out from main.ts so it's unit-testable without
- * touching the entry-point bootstrap path.
- */
-import { spawn } from 'node:child_process';
-/**
- * Options for `requestDaemonRestart`. All optional in production; the helper
- * defaults to `process` / `node:child_process`. Tests inject doubles.
- */
-export interface RequestDaemonRestartOptions {
-    /** Defaults to `process.env`. */
-    env?: NodeJS.ProcessEnv;
-    /** Defaults to `process.argv` (`[node, scriptPath, ...args]`). */
-    argv?: readonly string[];
-    /** Defaults to `process.execPath` (the node binary). */
-    execPath?: string;
-    /**
-     * Defaults to `node:child_process.spawn`. Injected for tests so we can
-     * assert what was spawned without actually forking node.
-     */
-    spawnFn?: typeof spawn;
-    /** Defaults to `(code) => process.exit(code)`. Injected for tests. */
-    exitFn?: (code: number) => void;
-    /** Defaults to `console.log`. Injected for tests to capture output. */
-    log?: (message: string) => void;
-    /**
-     * Delay (ms) between spawning the child and exiting the parent. Gives the
-     * child a moment to bind the API port before the parent vacates it.
-     * Defaults to 250ms per the issue body. Tests can pass 0 for synchrony.
-     */
-    exitDelayMs?: number;
-}
-/**
- * Pure predicate: true when the current env is headless and respawn should
- * be skipped. Exposed so callers and tests can share the same check.
- */
-export declare function isHeadless(env?: NodeJS.ProcessEnv): boolean;
-/**
- * Handle an operator-triggered restart request.
- *
- * - In **interactive** mode (default), spawn a detached child that re-runs
- *   the current node invocation, then exit after a short delay so the child
- *   can bind the API port.
- * - In **headless** mode (`JINN_NO_UI=1`), exit without respawning. The
- *   supervisor is responsible for relaunching the daemon if it wants to.
- *
- * Returns the action taken (for tests). Production callers ignore the return.
- */
-export declare function requestDaemonRestart(opts?: RequestDaemonRestartOptions): 'respawned' | 'headless-exit';

package/dist/restart-daemon.js

@@ -1,82 +0,0 @@
-/**
- * In-process respawn helper for operator-triggered daemon restarts.
- *
- * Issue #289: clicking "Restart node" in the operator panel previously called
- * `process.exit(0)`, which killed the daemon and stranded the operator outside
- * the app (the panel went 502, the terminal got a shell prompt). Every
- * restart-required config change funnelled through the same handler:
- *
- *   - POST /v1/setup/network              — RPC URL change
- *   - POST /v1/setup/change-password      — keystore password rotation
- *   - POST /v1/setup/solvernets/:name     — SolverNet enable/disable
- *   - POST /v1/operator/join/:cid         — SolverNet join
- *
- * The fix is the smallest thing that makes the button mean what it says:
- * before the parent exits, spawn a detached copy of the current process,
- * inheriting argv (sans node binary), env, and stdio. The child takes over
- * the port; the panel reconnects within a couple of seconds.
- *
- * Headless gate: `JINN_NO_UI=1` (already the established headless flag in
- * main.ts) skips the respawn — operators running `jinn run --no-ui` from a
- * supervisor / systemd unit / docker entrypoint want the supervisor to
- * decide whether to restart, not the daemon.
- *
- * The helper is split out from main.ts so it's unit-testable without
- * touching the entry-point bootstrap path.
- */
-import { spawn } from 'node:child_process';
-/**
- * Pure predicate: true when the current env is headless and respawn should
- * be skipped. Exposed so callers and tests can share the same check.
- */
-export function isHeadless(env = process.env) {
-    return env['JINN_NO_UI'] === '1';
-}
-/**
- * Handle an operator-triggered restart request.
- *
- * - In **interactive** mode (default), spawn a detached child that re-runs
- *   the current node invocation, then exit after a short delay so the child
- *   can bind the API port.
- * - In **headless** mode (`JINN_NO_UI=1`), exit without respawning. The
- *   supervisor is responsible for relaunching the daemon if it wants to.
- *
- * Returns the action taken (for tests). Production callers ignore the return.
- */
-export function requestDaemonRestart(opts = {}) {
-    const env = opts.env ?? process.env;
-    const argv = opts.argv ?? process.argv;
-    const execPath = opts.execPath ?? process.execPath;
-    const spawnFn = opts.spawnFn ?? spawn;
-    const exitFn = opts.exitFn ?? ((code) => process.exit(code));
-    const log = opts.log ?? ((message) => console.log(message));
-    const exitDelayMs = opts.exitDelayMs ?? 250;
-    if (isHeadless(env)) {
-        log('[main] Restart requested via operator MCP, but JINN_NO_UI=1 — exiting without respawn (let the supervisor decide).');
-        exitFn(0);
-        return 'headless-exit';
-    }
-    log('[main] Restart requested via operator MCP. Spawning replacement and exiting...');
-    // argv[0] is the node binary; argv[1..] are the script + flags. The child
-    // re-runs the same script with the same flags, under the same node binary.
-    const childArgs = argv.slice(1);
-    const spawnOptions = {
-        detached: true,
-        stdio: 'inherit',
-        env,
-    };
-    const child = spawnFn(execPath, childArgs, spawnOptions);
-    // Detach so the parent can exit without taking the child with it.
-    child.unref();
-    // Give the child a moment to bind the API port before we vacate it.
-    // The 250ms default matches the issue body's empirical measurement; tests
-    // pass 0 for synchrony.
-    if (exitDelayMs <= 0) {
-        exitFn(0);
-    }
-    else {
-        setTimeout(() => exitFn(0), exitDelayMs);
-    }
-    return 'respawned';
-}
-//# sourceMappingURL=restart-daemon.js.map

package/dist/restart-daemon.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"restart-daemon.js","sourceRoot":"","sources":["../src/restart-daemon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AA8B9D;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC7D,OAAO,GAAG,CAAC,YAAY,CAAC,KAAK,GAAG,CAAC;AACnC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAoC,EAAE;IAEtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC;IACtC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACrE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,OAAe,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IACpE,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,GAAG,CAAC;IAE5C,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACpB,GAAG,CACD,oHAAoH,CACrH,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,CAAC;QACV,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,GAAG,CAAC,gFAAgF,CAAC,CAAC;IAEtF,0EAA0E;IAC1E,2EAA2E;IAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,YAAY,GAAiB;QACjC,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,SAAS;QAChB,GAAG;KACJ,CAAC;IACF,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;IACzD,kEAAkE;IAClE,KAAK,CAAC,KAAK,EAAE,CAAC;IAEd,oEAAoE;IACpE,0EAA0E;IAC1E,wBAAwB;IACxB,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;QACrB,MAAM,CAAC,CAAC,CAAC,CAAC;IACZ,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/setup/halt-mode.d.ts

@@ -1,14 +0,0 @@
-/**
- * Halt-and-resume gate (jinn-mono-hjex.6).
- *
- * When bootstrap fails after the setup API has come up, we want the dashboard
- * to stay alive so the operator can click Retry from `BootstrapErrorCard`
- * (see `main.ts` halt-and-resume loop). That mode is only safe when there is
- * actually a human (or watcher) on the other side; in CI / agent-driven flows
- * driven with `JINN_NO_UI=1` or `JINN_NO_DAEMON=1` no Retry click is coming,
- * so a halt must surface as a fatal exit immediately rather than suspending
- * in the retry loop forever.
- *
- * This predicate is the single source of truth for that gate.
- */
-export declare function keepSetupUiOnBootstrapError(env?: NodeJS.ProcessEnv): boolean;

package/dist/setup/halt-mode.js

@@ -1,17 +0,0 @@
-/**
- * Halt-and-resume gate (jinn-mono-hjex.6).
- *
- * When bootstrap fails after the setup API has come up, we want the dashboard
- * to stay alive so the operator can click Retry from `BootstrapErrorCard`
- * (see `main.ts` halt-and-resume loop). That mode is only safe when there is
- * actually a human (or watcher) on the other side; in CI / agent-driven flows
- * driven with `JINN_NO_UI=1` or `JINN_NO_DAEMON=1` no Retry click is coming,
- * so a halt must surface as a fatal exit immediately rather than suspending
- * in the retry loop forever.
- *
- * This predicate is the single source of truth for that gate.
- */
-export function keepSetupUiOnBootstrapError(env = process.env) {
-    return env['JINN_NO_UI'] !== '1' && env['JINN_NO_DAEMON'] !== '1';
-}
-//# sourceMappingURL=halt-mode.js.map

package/dist/setup/halt-mode.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"halt-mode.js","sourceRoot":"","sources":["../../src/setup/halt-mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC9E,OAAO,GAAG,CAAC,YAAY,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,KAAK,GAAG,CAAC;AACpE,CAAC"}