myshell-tools 1.0.0 → 2.0.0

package/dist/commands/cost.d.ts

@@ -0,0 +1,36 @@
+/**
+ * src/commands/cost.ts — `myshell-tools cost` spend-summary command.
+ *
+ * Reads the on-disk ledger, computes real totals, and prints an honest
+ * per-model breakdown together with a counterfactual "what if you had used
+ * the manager-tier flagship for every call?" comparison.
+ *
+ * Counterfactual (apples-to-apples)
+ * ---------------------------------
+ * The "Billed total" is the real amount from the ledger (includes caching and
+ * discounts). The counterfactual compares ONLY like-for-like list prices:
+ *   routed   = sum over entries of listPrice(entry.model) × entry tokens
+ *   flagship = sum over entries of listPrice(manager flagship) × entry tokens
+ *   multiplier = flagship / routed
+ * We never compare the cache-adjusted billed total against a list-price flagship
+ * estimate — that would understate flagship and mislead.
+ *
+ * Honesty contract: every figure comes from the real ledger; no values are
+ * fabricated. If the ledger is empty the command says so and returns 0.
+ */
+import type { LedgerEntry } from '../core/types.js';
+import type { OutputSink } from '../interface/render.js';
+/**
+ * Build the cost-report lines from a (possibly empty) ledger entry array.
+ *
+ * Pure function: no I/O, no process.exit, no Date/Math.random.
+ * Called by runCost after reading the real ledger, and by unit tests.
+ */
+export declare function formatCostReport(entries: LedgerEntry[], color?: boolean): string[];
+/**
+ * Read the ledger for `cwd`, build the cost report, and write it to `out`.
+ *
+ * Returns 0 always (cost reporting is informational, not an error condition).
+ * Never calls process.exit — that is handled exclusively by src/cli.ts.
+ */
+export declare function runCost(cwd: string, out: OutputSink): Promise<number>;

package/dist/commands/cost.js

@@ -0,0 +1,103 @@
+/**
+ * src/commands/cost.ts — `myshell-tools cost` spend-summary command.
+ *
+ * Reads the on-disk ledger, computes real totals, and prints an honest
+ * per-model breakdown together with a counterfactual "what if you had used
+ * the manager-tier flagship for every call?" comparison.
+ *
+ * Counterfactual (apples-to-apples)
+ * ---------------------------------
+ * The "Billed total" is the real amount from the ledger (includes caching and
+ * discounts). The counterfactual compares ONLY like-for-like list prices:
+ *   routed   = sum over entries of listPrice(entry.model) × entry tokens
+ *   flagship = sum over entries of listPrice(manager flagship) × entry tokens
+ *   multiplier = flagship / routed
+ * We never compare the cache-adjusted billed total against a list-price flagship
+ * estimate — that would understate flagship and mislead.
+ *
+ * Honesty contract: every figure comes from the real ledger; no values are
+ * fabricated. If the ledger is empty the command says so and returns 0.
+ */
+import { readLedger, summarizeLedger } from '../infra/ledger.js';
+import { getCheapestForTier, calculateCost, getModelPricing } from '../infra/pricing.js';
+import { bold, dim, cyan, divider, label } from '../ui/theme.js';
+// ---------------------------------------------------------------------------
+// Pure report builder — testable with hand-built LedgerEntry[]
+// ---------------------------------------------------------------------------
+/**
+ * Build the cost-report lines from a (possibly empty) ledger entry array.
+ *
+ * Pure function: no I/O, no process.exit, no Date/Math.random.
+ * Called by runCost after reading the real ledger, and by unit tests.
+ */
+export function formatCostReport(entries, color = false) {
+    if (entries.length === 0) {
+        return ['No usage recorded yet — run a task first.'];
+    }
+    const summary = summarizeLedger(entries);
+    const flagship = getCheapestForTier('manager');
+    // Apples-to-apples: price BOTH the models actually used AND the flagship on the
+    // SAME basis (list price × tokens). We do NOT compare the billed total (which
+    // includes caching/discounts) against a list-price flagship estimate.
+    let routedListUsd = 0;
+    let flagshipListUsd = 0;
+    for (const entry of entries) {
+        const entryPricing = getModelPricing(entry.provider, entry.model);
+        if (entryPricing) {
+            routedListUsd += calculateCost(entry.inputTokens, entry.outputTokens, entryPricing);
+        }
+        flagshipListUsd += calculateCost(entry.inputTokens, entry.outputTokens, flagship);
+    }
+    const lines = [];
+    lines.push(bold('myshell-tools cost', color));
+    lines.push(divider(color));
+    // ---- Summary ---------------------------------------------------------------
+    lines.push(`${label('Billed total', color)}: $${summary.totalUsd.toFixed(4)} ` +
+        `${dim('(as billed, incl. caching/discounts)', color)}`);
+    lines.push(`${label('Total calls', color)}: ${summary.calls}`);
+    lines.push(divider(color));
+    // ---- Per-model breakdown ---------------------------------------------------
+    lines.push(bold('Per-model breakdown', color));
+    for (const [model, ms] of Object.entries(summary.byModel)) {
+        const callStr = ms.calls === 1 ? '1 call' : `${ms.calls} calls`;
+        lines.push(`  ${cyan(model, color)}: ${callStr}, $${ms.usd.toFixed(4)}`);
+    }
+    lines.push(divider(color));
+    // ---- Counterfactual (list-price, token-for-token, apples-to-apples) --------
+    const flagshipLabel = `${flagship.model} (${flagship.tier} tier)`;
+    lines.push(bold('Counterfactual — list price, token-for-token', color));
+    lines.push(`${dim('Flagship model', color)}: ${flagshipLabel}` +
+        `  ${dim(`($${flagship.inputPer1M}/M in, $${flagship.outputPer1M}/M out)`, color)}`);
+    lines.push(`${label('Routed (models used)', color)}: $${routedListUsd.toFixed(4)}`);
+    lines.push(`${label('Always-flagship', color)}:      $${flagshipListUsd.toFixed(4)}`);
+    if (routedListUsd > 0 && flagshipListUsd > routedListUsd) {
+        const multiplier = flagshipListUsd / routedListUsd;
+        lines.push(`Routing saved you money: always-flagship would cost ${multiplier.toFixed(1)}x more ` +
+            `($${flagshipListUsd.toFixed(4)} vs $${routedListUsd.toFixed(4)} at list price).`);
+    }
+    else if (routedListUsd > 0) {
+        lines.push('Every call already used a flagship-tier (or pricier) model — no routing savings to show.');
+    }
+    else {
+        lines.push(dim('No priced models in the ledger — cannot compute a list-price comparison.', color));
+    }
+    return lines;
+}
+// ---------------------------------------------------------------------------
+// I/O runner — called by cli.ts
+// ---------------------------------------------------------------------------
+/**
+ * Read the ledger for `cwd`, build the cost report, and write it to `out`.
+ *
+ * Returns 0 always (cost reporting is informational, not an error condition).
+ * Never calls process.exit — that is handled exclusively by src/cli.ts.
+ */
+export async function runCost(cwd, out) {
+    const entries = await readLedger(cwd);
+    const lines = formatCostReport(entries, out.color);
+    for (const line of lines) {
+        out.write(line + '\n');
+    }
+    return 0;
+}
+//# sourceMappingURL=cost.js.map

package/dist/commands/cost.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,36 @@
+/**
+ * src/commands/doctor.ts — `myshell-tools doctor` health-check command.
+ *
+ * Probes the runtime environment (providers, filesystem, pricing) and prints
+ * an honest, human-readable report to an OutputSink. All displayed data comes
+ * from real detection results — no fabricated values.
+ *
+ * Honesty contract: authentication status for Claude is labelled OPTIMISTIC
+ * because we cannot cheaply probe auth state without spending API quota.
+ */
+import type { OutputSink } from '../interface/render.js';
+import type { EnvironmentStatus } from '../providers/detect.js';
+export interface DoctorExtras {
+    readonly nodeVersion: string;
+    readonly stateWritable: boolean;
+    readonly pricingStale: boolean;
+}
+/**
+ * Build the doctor report lines from pre-collected data.
+ *
+ * Pure function: no I/O, no process.exit, no side effects.
+ * Used by runDoctor after it collects the real data, and by unit tests with
+ * hand-built inputs.
+ *
+ * @param env    - Full environment status (from detectEnvironment or a fake).
+ * @param extras - Supplemental runtime info (node version, write probe, etc.).
+ * @param color  - Whether to emit ANSI colour codes.
+ */
+export declare function buildDoctorReport(env: EnvironmentStatus, extras: DoctorExtras, color: boolean): string[];
+/**
+ * Detect the environment, probe I/O, build the report, and write it to `out`.
+ *
+ * Returns 0 when at least one provider is installed, 1 otherwise.
+ * Never calls process.exit — that is handled exclusively by src/cli.ts.
+ */
+export declare function runDoctor(out: OutputSink): Promise<number>;

package/dist/commands/doctor.js

@@ -0,0 +1,115 @@
+/**
+ * src/commands/doctor.ts — `myshell-tools doctor` health-check command.
+ *
+ * Probes the runtime environment (providers, filesystem, pricing) and prints
+ * an honest, human-readable report to an OutputSink. All displayed data comes
+ * from real detection results — no fabricated values.
+ *
+ * Honesty contract: authentication status for Claude is labelled OPTIMISTIC
+ * because we cannot cheaply probe auth state without spending API quota.
+ */
+import { access, mkdir, writeFile, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { detectEnvironment, getInstallCommand } from '../providers/detect.js';
+import { isPricingStale } from '../infra/pricing.js';
+import { bold, green, red, yellow, dim, divider, label } from '../ui/theme.js';
+/**
+ * Build the doctor report lines from pre-collected data.
+ *
+ * Pure function: no I/O, no process.exit, no side effects.
+ * Used by runDoctor after it collects the real data, and by unit tests with
+ * hand-built inputs.
+ *
+ * @param env    - Full environment status (from detectEnvironment or a fake).
+ * @param extras - Supplemental runtime info (node version, write probe, etc.).
+ * @param color  - Whether to emit ANSI colour codes.
+ */
+export function buildDoctorReport(env, extras, color) {
+    const lines = [];
+    lines.push(bold('myshell-tools doctor', color));
+    lines.push(divider(color));
+    // ---- Platform & Node -------------------------------------------------------
+    lines.push(`${label('Platform', color)}: ${env.platform}`);
+    lines.push(`${label('Node', color)}:     ${extras.nodeVersion}`);
+    // ---- .myshell-tools writability ---------------------------------------------------
+    const writableText = extras.stateWritable
+        ? green('writable', color)
+        : red('not writable', color);
+    lines.push(`${label('.myshell-tools dir', color)}: ${writableText}`);
+    // ---- Pricing staleness -----------------------------------------------------
+    const pricingText = extras.pricingStale
+        ? yellow('stale — consider updating myshell-tools', color)
+        : green('up to date', color);
+    lines.push(`${label('Pricing table', color)}: ${pricingText}`);
+    lines.push(divider(color));
+    // ---- Providers -------------------------------------------------------------
+    lines.push(bold('Providers', color));
+    for (const ps of [env.claude, env.codex]) {
+        if (ps.installed) {
+            const versionStr = ps.version !== null ? ps.version : 'unknown';
+            lines.push(`  ${green('✓', color)} ${bold(ps.id, color)} — installed, version: ${versionStr}`);
+            // Auth is optimistic for Claude; codex is always not-installed for now
+            if (ps.id === 'claude') {
+                lines.push(`    ${label('auth', color)}: ${dim('assumed; verified on first run', color)}`);
+            }
+        }
+        else {
+            lines.push(`  ${red('✗', color)} ${bold(ps.id, color)} — ${red('not installed', color)}`);
+            lines.push(`    ${dim(`Install: ${getInstallCommand(ps.id)}`, color)}`);
+        }
+    }
+    lines.push(divider(color));
+    // ---- Overall status --------------------------------------------------------
+    if (env.hasAnyProvider) {
+        lines.push(green('Ready — at least one provider is available.', color));
+    }
+    else {
+        lines.push(red('No providers found.', color) +
+            ' Install claude or codex to use myshell-tools.');
+    }
+    return lines;
+}
+// ---------------------------------------------------------------------------
+// I/O runner — called by cli.ts
+// ---------------------------------------------------------------------------
+/**
+ * Probe the .myshell-tools directory for writability.
+ *
+ * Creates .myshell-tools/ if needed, writes a temp file, then removes it.
+ * Returns true when successful, false on any I/O error.
+ */
+async function probestateWritable(cwd) {
+    const stateDir = join(cwd, '.myshell-tools');
+    const probe = join(stateDir, '.doctor-probe');
+    try {
+        await mkdir(stateDir, { recursive: true });
+        await writeFile(probe, '');
+        await rm(probe, { force: true });
+        await access(stateDir);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Detect the environment, probe I/O, build the report, and write it to `out`.
+ *
+ * Returns 0 when at least one provider is installed, 1 otherwise.
+ * Never calls process.exit — that is handled exclusively by src/cli.ts.
+ */
+export async function runDoctor(out) {
+    const env = await detectEnvironment();
+    const stateWritable = await probestateWritable(process.cwd());
+    const extras = {
+        nodeVersion: process.version,
+        stateWritable,
+        pricingStale: isPricingStale(),
+    };
+    const lines = buildDoctorReport(env, extras, out.color);
+    for (const line of lines) {
+        out.write(line + '\n');
+    }
+    return env.hasAnyProvider ? 0 : 1;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/login.d.ts

@@ -0,0 +1,20 @@
+/**
+ * src/commands/login.ts — `myshell-tools login [claude|codex]`.
+ *
+ * Frictionless authentication: rather than make the user remember each vendor's
+ * CLI auth command, we delegate to the provider's OWN OAuth flow and inherit the
+ * terminal so the browser/device sign-in works in place.
+ *
+ * Security: myshell-tools never sees, handles, or stores raw credentials. Each
+ * CLI manages its own tokens; we only trigger its login. (This is what keeps the
+ * "use your subscription, no API keys" model honest.)
+ */
+import type { OutputSink } from '../interface/render.js';
+import type { ProviderId } from '../providers/port.js';
+export declare function isProviderId(value: string): value is ProviderId;
+/**
+ * Run the interactive sign-in flow for one provider (or all installed providers
+ * when no argument is given). Returns 0 on success, 1 only for an invalid
+ * argument — individual sign-in failures are reported but do not fail the command.
+ */
+export declare function runLogin(out: OutputSink, providerArg?: string): Promise<number>;

package/dist/commands/login.js

@@ -0,0 +1,60 @@
+/**
+ * src/commands/login.ts — `myshell-tools login [claude|codex]`.
+ *
+ * Frictionless authentication: rather than make the user remember each vendor's
+ * CLI auth command, we delegate to the provider's OWN OAuth flow and inherit the
+ * terminal so the browser/device sign-in works in place.
+ *
+ * Security: myshell-tools never sees, handles, or stores raw credentials. Each
+ * CLI manages its own tokens; we only trigger its login. (This is what keeps the
+ * "use your subscription, no API keys" model honest.)
+ */
+import { execa } from 'execa';
+import { detectProvider, getInstallCommand } from '../providers/detect.js';
+import { bold, dim, green, red } from '../ui/theme.js';
+/** Each provider's interactive sign-in command. */
+const LOGIN_COMMAND = {
+    claude: { bin: 'claude', args: ['auth', 'login'] },
+    codex: { bin: 'codex', args: ['login'] },
+};
+export function isProviderId(value) {
+    return value === 'claude' || value === 'codex';
+}
+/**
+ * Run the interactive sign-in flow for one provider (or all installed providers
+ * when no argument is given). Returns 0 on success, 1 only for an invalid
+ * argument — individual sign-in failures are reported but do not fail the command.
+ */
+export async function runLogin(out, providerArg) {
+    let targets;
+    if (providerArg !== undefined) {
+        if (!isProviderId(providerArg)) {
+            out.write(red(`Unknown provider "${providerArg}". Use: claude or codex.\n`, out.color));
+            return 1;
+        }
+        targets = [providerArg];
+    }
+    else {
+        targets = ['claude', 'codex'];
+    }
+    for (const id of targets) {
+        const status = await detectProvider(id);
+        if (!status.installed) {
+            out.write(dim(`${id}: not installed — skipping. Install with: ${getInstallCommand(id)}\n`, out.color));
+            continue;
+        }
+        out.write(bold(`\nSigning in to ${id} — a browser window may open…\n`, out.color));
+        const { bin, args } = LOGIN_COMMAND[id];
+        // stdio:'inherit' hands the terminal to the provider CLI so its OAuth/device
+        // flow runs in place. reject:false so we report rather than throw.
+        const result = await execa(bin, [...args], { stdio: 'inherit', reject: false });
+        if (result.exitCode === 0) {
+            out.write(green(`✓ ${id} sign-in complete.\n`, out.color));
+        }
+        else {
+            out.write(red(`✗ ${id} sign-in did not complete (exit ${result.exitCode ?? 'unknown'}).\n`, out.color));
+        }
+    }
+    return 0;
+}
+//# sourceMappingURL=login.js.map

package/dist/commands/login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAG9B,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAEvD,mDAAmD;AACnD,MAAM,aAAa,GAAmF;IACpG,MAAM,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;IAClD,KAAK,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE;CACzC,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,OAAO,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAe,EAAE,WAAoB;IAClE,IAAI,OAAqB,CAAC;IAC1B,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,CAAC;YAC/B,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,qBAAqB,WAAW,4BAA4B,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;YACxF,OAAO,CAAC,CAAC;QACX,CAAC;QACD,OAAO,GAAG,CAAC,WAAW,CAAC,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YACtB,GAAG,CAAC,KAAK,CACP,GAAG,CAAC,GAAG,EAAE,6CAA6C,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,CAC5F,CAAC;YACF,SAAS;QACX,CAAC;QAED,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB,EAAE,iCAAiC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QACnF,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC;QACxC,6EAA6E;QAC7E,mEAAmE;QACnE,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAEhF,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YAC1B,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,sBAAsB,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,KAAK,CACP,GAAG,CAAC,KAAK,EAAE,mCAAmC,MAAM,CAAC,QAAQ,IAAI,SAAS,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,CAC7F,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/core/assess.d.ts

@@ -0,0 +1,25 @@
+/**
+ * src/core/assess.ts — parse real confidence signals from model output.
+ *
+ * The model is instructed (via prompt.ts) to end its response with a JSON
+ * envelope on its own line:
+ *   {"confidence": 0.0-1.0, "escalate": true|false, "reason": "...", "needs_review": true|false}
+ *
+ * Honesty Contract: if the envelope is absent, truncated, or malformed we
+ * return confidence=null. We NEVER guess or fabricate a confidence number from
+ * keywords or heuristics (that was the v1 sin). This function must never throw
+ * on any input — it degrades gracefully on all malformed/garbage data.
+ *
+ * Pure module: no I/O, no time, no randomness.
+ */
+import type { Assessment } from './types.js';
+/**
+ * Parse a trailing JSON confidence envelope from `output`.
+ *
+ * Returns real parsed values when the envelope is present and valid.
+ * Returns `{ confidence: null, escalate: false, reason: 'no confidence envelope', needsReview: false }`
+ * when the envelope is absent or unparseable.
+ *
+ * @param output - The full text output from the model.
+ */
+export declare function assess(output: string): Assessment;

package/dist/core/assess.js

@@ -0,0 +1,142 @@
+/**
+ * src/core/assess.ts — parse real confidence signals from model output.
+ *
+ * The model is instructed (via prompt.ts) to end its response with a JSON
+ * envelope on its own line:
+ *   {"confidence": 0.0-1.0, "escalate": true|false, "reason": "...", "needs_review": true|false}
+ *
+ * Honesty Contract: if the envelope is absent, truncated, or malformed we
+ * return confidence=null. We NEVER guess or fabricate a confidence number from
+ * keywords or heuristics (that was the v1 sin). This function must never throw
+ * on any input — it degrades gracefully on all malformed/garbage data.
+ *
+ * Pure module: no I/O, no time, no randomness.
+ */
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Attempt to extract the last JSON object from `text` that looks like a
+ * confidence envelope.  Returns the raw parsed object or null.
+ *
+ * Strategy: scan backwards for the last `{...}` block that contains at least
+ * the `confidence` key, then try to parse it.  This is robust to:
+ *  - trailing whitespace / newlines
+ *  - the model emitting extra text after the envelope (we pick the LAST match)
+ *  - duplicate envelopes (last one wins — the model may have regenerated it)
+ *  - garbage / truncated JSON elsewhere in the output
+ */
+function extractEnvelope(text) {
+    // Find all candidates: substrings that start with '{' and end with '}'
+    // We do this by iterating over all '{' positions and trying to match the
+    // closing '}', handling depth.  We collect all valid JSON objects and
+    // return the last one that has a 'confidence' key.
+    const candidates = [];
+    let i = 0;
+    while (i < text.length) {
+        const start = text.indexOf('{', i);
+        if (start === -1)
+            break;
+        // Walk forward tracking brace depth to find the matching '}'
+        let depth = 0;
+        let j = start;
+        let foundClose = false;
+        while (j < text.length) {
+            if (text[j] === '{') {
+                depth++;
+            }
+            else if (text[j] === '}') {
+                depth--;
+                if (depth === 0) {
+                    foundClose = true;
+                    break;
+                }
+            }
+            j++;
+        }
+        if (foundClose) {
+            const candidate = text.slice(start, j + 1);
+            try {
+                const parsed = JSON.parse(candidate);
+                if (parsed !== null &&
+                    typeof parsed === 'object' &&
+                    !Array.isArray(parsed) &&
+                    'confidence' in parsed) {
+                    candidates.push(parsed);
+                }
+            }
+            catch {
+                // Not valid JSON — skip
+            }
+        }
+        i = start + 1;
+    }
+    if (candidates.length === 0)
+        return null;
+    // Return the last valid envelope (handles duplicate/regenerated envelopes)
+    return candidates[candidates.length - 1] ?? null;
+}
+/**
+ * Clamp a number to [0, 1].
+ */
+function clamp01(n) {
+    return Math.min(1, Math.max(0, n));
+}
+/**
+ * Coerce an unknown value to boolean — any truthy value maps to true.
+ */
+function coerceBool(v) {
+    if (typeof v === 'boolean')
+        return v;
+    if (typeof v === 'number')
+        return v !== 0;
+    if (typeof v === 'string')
+        return v === 'true' || v === '1';
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Parse a trailing JSON confidence envelope from `output`.
+ *
+ * Returns real parsed values when the envelope is present and valid.
+ * Returns `{ confidence: null, escalate: false, reason: 'no confidence envelope', needsReview: false }`
+ * when the envelope is absent or unparseable.
+ *
+ * @param output - The full text output from the model.
+ */
+export function assess(output) {
+    const NULL_RESULT = {
+        confidence: null,
+        escalate: false,
+        reason: 'no confidence envelope',
+        needsReview: false,
+    };
+    // Guard: never throw on any input
+    if (typeof output !== 'string' || output.length === 0) {
+        return NULL_RESULT;
+    }
+    let envelope;
+    try {
+        envelope = extractEnvelope(output);
+    }
+    catch {
+        return NULL_RESULT;
+    }
+    if (envelope === null) {
+        return NULL_RESULT;
+    }
+    // Validate confidence: must be a finite number
+    if (typeof envelope.confidence !== 'number' || !isFinite(envelope.confidence)) {
+        return NULL_RESULT;
+    }
+    const confidence = clamp01(envelope.confidence);
+    const escalate = coerceBool(envelope.escalate);
+    const needsReview = coerceBool(envelope.needs_review);
+    const reason = typeof envelope.reason === 'string' && envelope.reason.trim().length > 0
+        ? envelope.reason.trim()
+        : 'model provided no reason';
+    return { confidence, escalate, reason, needsReview };
+}
+//# sourceMappingURL=assess.js.map

package/dist/core/assess.js.map

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

package/dist/core/classify.d.ts

@@ -0,0 +1,19 @@
+/**
+ * src/core/classify.ts — pure task classification.
+ *
+ * Determines the orchestration tier and security risk level from a free-text
+ * task description using keyword/regex signals. No I/O, no time, no randomness.
+ *
+ * Honesty Contract: no fabricated confidence numbers are produced here.
+ * The rationale field names the matched signal so callers can audit decisions.
+ */
+import type { Classification } from './types.js';
+/**
+ * Classify a free-text `task` string into a {@link Classification}.
+ *
+ * Tier priority: manager > worker > ic (ic is the default).
+ * Risk priority: critical > high > medium > low (low is the default).
+ *
+ * @param task - The raw task description from the user.
+ */
+export declare function classify(task: string): Classification;