humanish 0.105.0 → 0.106.0

package/dist/pricing.js

@@ -1,277 +0,0 @@
-// OPERATOR-EDITABLE ESTIMATES — NOT authoritative prices. Providers change pricing without
-// notice. When they do, update BOTH the number AND the `asOf` date on the affected entry.
-// Every dollar figure humanish derives from this table is surfaced/persisted as an ESTIMATE,
-// labeled "estimated (rates as of <asOf>)", and is NEVER presented as an exact charge.
-//
-// This module is PURE (node builtins only, no deps) and deterministic: the two estimator
-// functions take an OPTIONAL injected rate table/rate so tests drive assertions with a fake
-// sheet and never depend on the live numbers below. An UNKNOWN model/desktop rate yields a
-// DECLARED-ABSENT estimate (estimatedCostUsd: null + a reason), NEVER a guessed or silent-zero
-// cost (invariant 5). A bare `costUsd` elsewhere in the contract means a provider actually
-// billed that amount; the token-derived estimate here always lives under `estimatedCostUsd`
-// so a reader can never confuse an estimate for an authoritative charge (invariant 6).
-export const PRICING_SCHEMA = "humanish.pricing.v1";
-export const ACTOR_ESTIMATED_COST_SCHEMA = "humanish.actor-estimated-cost.v1";
-/** Account lanes must never acquire a price through an aggregate or ambiguous model line. */
-export function contradictsAccountBilling(streams, cost) {
-    const account = (stream) => (stream.liveActor?.executionProfile ?? stream.actor?.executionProfile)?.billing === "account-unknown";
-    if (!cost || !streams.some(account))
-        return false;
-    if (cost.fullyEstimated === true)
-        return true;
-    if (!Array.isArray(cost.breakdown))
-        return true;
-    return cost.breakdown.some((line) => {
-        if (line?.kind !== "model-tokens" || typeof line.estimatedCostUsd !== "number")
-            return false;
-        const owners = typeof line.laneId === "string" ? streams.filter(s => s.id === line.laneId || s.laneId === line.laneId) : streams;
-        return owners.length !== 1 || account(owners[0]);
-    });
-}
-// The gpt-5.6 long-context tier: >272K input tokens re-prices the FULL request at 2x
-// input-side / 1.5x output (developers.openai.com/api/docs/models/gpt-5.6-sol, 2026-08-18).
-const GPT56_LONG_CONTEXT = {
-    thresholdInputTokens: 272_000,
-    inputMultiplier: 2,
-    outputMultiplier: 1.5
-};
-const GPT56_SOURCE = "developers.openai.com/api/docs/pricing (gpt-5.6 family, standard tier)";
-// One 5.6-family entry: rates in USD-per-1M for legibility, converted once. Cache writes bill at
-// 1.25x the uncached input rate on this family (`cache_write_tokens`, prompt-caching guide); the
-// built-in `computer` tool has no per-call fee on the live sheet.
-function gpt56Rate(inPer1M, cachedPer1M, writePer1M, outPer1M, asOf = "2026-08-18") {
-    return {
-        inputUsdPerToken: inPer1M * 1e-6,
-        cachedInputUsdPerToken: cachedPer1M * 1e-6,
-        cacheWriteUsdPerToken: writePer1M * 1e-6,
-        outputUsdPerToken: outPer1M * 1e-6,
-        longContext: { ...GPT56_LONG_CONTEXT },
-        asOf,
-        source: GPT56_SOURCE
-    };
-}
-// gpt-5.6-sol promotional rates (live sheet 2026-09-03: $4 / $0.40 cached / $5 write / $20 out,
-// "available at least through November 21, 2026"). The 2026-08-18 pin of 5 / 0.5 / 6.25 / 30
-// over-estimated every Sol run by 25-33% for two weeks. Re-verify against the sheet after Nov 21.
-const GPT56_SOL_PROMO_AS_OF = "2026-09-03";
-// Per-model rates, keyed on the model id that lands in trace.ids.model (lookup is
-// case-insensitive on a trimmed id). An id NOT present here is DECLARED ABSENT, never guessed.
-export const MODEL_RATES = {
-    // OpenAI computer-use-preview (the classic CUA model). ~$3 / 1M input, ~$12 / 1M output.
-    // source: openai.com/api/pricing (verify — providers change without notice).
-    "computer-use-preview": {
-        inputUsdPerToken: 3e-6,
-        outputUsdPerToken: 12e-6,
-        asOf: "2026-08-01",
-        source: "openai.com/api/pricing (computer-use-preview)"
-    },
-    // gpt-5.5: the PREVIOUS-generation CUA default, kept so pinned labs and old bundles still
-    // price. Pre-5.6 models bill no cache-write fee (prompt-caching guide) and no long-context
-    // tier was published for it.
-    "gpt-5.5": {
-        inputUsdPerToken: 5e-6,
-        outputUsdPerToken: 30e-6,
-        cachedInputUsdPerToken: 0.5e-6,
-        asOf: "2026-08-05",
-        source: "openrouter.ai/openai/gpt-5.5 (gpt-5.5 no longer on openai.com/api/pricing; see #334)"
-    },
-    // The gpt-5.6 family (live sheet 2026-08-18, standard tier, short-context base rates;
-    // the longContext block prices the >272K re-tier when per-request turns are recorded).
-    // sol = flagship (the shipped CUA default), terra = cost-balanced, luna = high-volume,
-    // cyber = the Daybreak frontier tier.
-    "gpt-5.6-sol": gpt56Rate(4, 0.4, 5, 20, GPT56_SOL_PROMO_AS_OF),
-    // "gpt-5.6" is OpenAI's own alias for gpt-5.6-sol (models index); priced identically so a
-    // lab configured with the alias never reads as unpriced.
-    "gpt-5.6": gpt56Rate(4, 0.4, 5, 20, GPT56_SOL_PROMO_AS_OF),
-    "gpt-5.6-terra": gpt56Rate(2, 0.2, 2.5, 12),
-    "gpt-5.6-luna": gpt56Rate(0.2, 0.02, 0.25, 1.2),
-    "gpt-5.6-cyber": gpt56Rate(12.5, 1.25, 15.625, 75),
-    // Daybreak program aliases (blue -> sol, red -> cyber today). OpenAI repoints these as new
-    // frontier models ship, so prefer the explicit tier id in labs; the entries exist so a
-    // configured alias still prices at what the alias bills TODAY.
-    "daybreak-blue-latest": gpt56Rate(4, 0.4, 5, 20, GPT56_SOL_PROMO_AS_OF),
-    "daybreak-red-latest": gpt56Rate(12.5, 1.25, 15.625, 75),
-    // gpt-6-astra (shipped 2026-09-03; API access announced as rolling out). Same two mechanics
-    // as the 5.6 family on the sheet: writes at 1.25x, >272K re-tiers at 2x input-side / 1.5x
-    // output ($20 / $2 / $25 / $75 long-context columns). These rates cover explicit lab
-    // model choices and the study-analysis default; the computer-use default is separate.
-    "gpt-6-astra": gpt56Rate(10, 1, 12.5, 50, GPT56_SOL_PROMO_AS_OF)
-};
-// Current public incremental running-compute rates. Subscription fees/credits, negotiated
-// enterprise prices, and unobserved allocation/startup time are outside this estimate.
-export const DESKTOP_RESOURCE_RATE = {
-    usdPerCpuSecond: 0.000014,
-    usdPerGiBSecond: 0.0000045,
-    asOf: "2026-09-05",
-    // A source label rather than an executable URL; runtime URL redaction protects E2B streams.
-    source: "e2b.dev/pricing"
-};
-// Planning/legacy-helper assumption only: stock desktops observed on 2026-09-05 had 8 vCPU /
-// 8 GiB. This is the largest CPU/RAM combination on that public sheet, not a provider billing
-// ceiling or a claim about custom/enterprise templates. Runtime CUA estimates use observed
-// allocation resources through estimateAllocatedDesktopCost instead of this fallback.
-export const DESKTOP_RATE = {
-    usdPerMinute: 0.00888,
-    asOf: "2026-09-05",
-    source: "e2b.dev/pricing (planning assumption: 8 vCPU / 8 GiB; not an observed allocation)",
-    placeholder: true
-};
-export function isDesktopResources(value) {
-    if (value === null || typeof value !== "object")
-        return false;
-    const resources = value;
-    return Number.isSafeInteger(resources.cpuCount) && resources.cpuCount > 0
-        && Number.isSafeInteger(resources.memoryMiB) && resources.memoryMiB > 0;
-}
-/** Price one observed allocation. Missing quantities/rates stay unknown, never a stock guess. */
-export function estimateAllocatedDesktopCost(minutes, resources, rate = DESKTOP_RESOURCE_RATE) {
-    if (minutes === undefined || !Number.isFinite(minutes) || minutes < 0) {
-        return { estimatedCostUsd: null, reason: "no_duration", ratesAsOf: null, minutes: null };
-    }
-    if (!isDesktopResources(resources)) {
-        return { estimatedCostUsd: null, reason: "no_desktop_resources", ratesAsOf: null, minutes: round6(minutes) };
-    }
-    // The public Hobby/Pro sheet stops at 8 CPU / 8 GiB; larger allocations may have negotiated
-    // prices. Retain the resource evidence without extrapolating a standard rate to them.
-    if (![1, 2, 4, 6, 8].includes(resources.cpuCount) || resources.memoryMiB < 512 || resources.memoryMiB > 8192
-        || !Number.isFinite(rate.usdPerCpuSecond) || rate.usdPerCpuSecond < 0
-        || !Number.isFinite(rate.usdPerGiBSecond) || rate.usdPerGiBSecond < 0) {
-        return { estimatedCostUsd: null, reason: "no_rate_for_desktop", ratesAsOf: null, minutes: round6(minutes), resources };
-    }
-    const usdPerSecond = resources.cpuCount * rate.usdPerCpuSecond + resources.memoryMiB / 1024 * rate.usdPerGiBSecond;
-    return { estimatedCostUsd: round6(minutes * 60 * usdPerSecond), ratesAsOf: rate.asOf,
-        source: rate.source, minutes: round6(minutes), resources, usdPerSecond };
-}
-/** Round a USD figure to 6 decimals so a float-accumulated total never carries spurious
- *  precision. This mirrors the SPIRIT of the terminal ledger's private roundUsd (6dp) without
- *  importing it — pricing stays a standalone pure module. */
-export function round6(n) {
-    return Math.round(n * 1e6) / 1e6;
-}
-/**
- * Estimate one actor lane's model-token cost from its trace tokenUsage + model id. Deterministic;
- * the rate table is injectable (tests pass a fake sheet). Returns a DECLARED-ABSENT estimate
- * (estimatedCostUsd: null + a reason) for a missing rate or missing usage — never a guessed cost.
- */
-export function estimateActorCostForExecution(usage, modelId, profile) {
-    return profile?.billing === "account-unknown"
-        ? { schema: ACTOR_ESTIMATED_COST_SCHEMA, estimatedCostUsd: null, ratesAsOf: null, reason: "account_billing_unknown",
-            ...(modelId === undefined ? {} : { modelId }) }
-        : estimateActorCost(usage, modelId);
-}
-export function estimateActorCost(tokenUsage, modelId, rates = MODEL_RATES) {
-    if (!tokenUsage || (tokenUsage.input === undefined && tokenUsage.output === undefined)) {
-        return { schema: ACTOR_ESTIMATED_COST_SCHEMA, estimatedCostUsd: null, reason: "no_token_usage", ratesAsOf: null };
-    }
-    const rate = modelId ? rates[modelId.trim().toLowerCase()] : undefined;
-    if (!rate) {
-        return {
-            schema: ACTOR_ESTIMATED_COST_SCHEMA,
-            estimatedCostUsd: null,
-            reason: "no_rate_for_model",
-            ratesAsOf: null,
-            ...(modelId ? { modelId } : {})
-        };
-    }
-    const inTok = tokenUsage.input ?? 0;
-    const outTok = tokenUsage.output ?? 0;
-    // Long-context tiering needs to know each REQUEST's input size (the provider re-prices whole
-    // requests past the threshold), so it engages only when per-turn usage records exist AND their
-    // input sums to the reported total — a partial turn ledger must not silently price the missing
-    // remainder at the wrong tier. Otherwise totals price on the base (short-context) rate exactly
-    // as before, which is the under-estimate direction and never trips a cap early.
-    const turns = tokenUsage.turns ?? [];
-    const sumOf = (field) => turns.reduce((sum, turn) => sum + (turn[field] ?? 0), 0);
-    // The ledger is trusted only when it decomposes the totals EXACTLY — all four sums, not just
-    // input/output. A ledger that carries request sizes but not the cache splits would otherwise
-    // price every token at the full rate while the session totals sit ignored (red-team finding:
-    // 3.5-5x overstatement, the #391 false-cap-trip direction). Inconsistent evidence falls back
-    // to the totals path, which honors the declared splits on the base tier.
-    const tiered = rate.longContext !== undefined &&
-        turns.length > 0 &&
-        sumOf("input") === inTok &&
-        sumOf("output") === outTok &&
-        sumOf("cachedInput") === (tokenUsage.cachedInput ?? 0) &&
-        sumOf("cacheWriteInput") === (tokenUsage.cacheWriteInput ?? 0);
-    let inputUsd = 0;
-    let outputUsd = 0;
-    let cachedTotal = 0;
-    let writeTotal = 0;
-    let longContextTurns = 0;
-    // Price one request's usage at one tier. Cached input is billed at a fraction of the full rate,
-    // and on a session that threads provider state it is the MAJORITY of input — pricing it at the
-    // full rate overstated real spend by up to ~10x (#391). Cache WRITES bill at their own rate
-    // (1.25x on OpenAI 5.6+) as the total rate for those tokens; a sheet without a write rate
-    // prices writes as plain input (pre-5.6: writes are free-of-extra-fee, i.e. plain input).
-    // Every piece is honestly absent: no reported split means no discount and no surcharge assumed.
-    const priceRequest = (usage, tierable) => {
-        const reqIn = usage.input ?? 0;
-        const reqOut = usage.output ?? 0;
-        // Tiering applies only to a real per-REQUEST record: session totals crossing the threshold
-        // say nothing about any single request, so totals always price on the base tier.
-        const long = tierable && rate.longContext !== undefined && reqIn > rate.longContext.thresholdInputTokens;
-        const inMul = long ? rate.longContext.inputMultiplier : 1;
-        const outMul = long ? rate.longContext.outputMultiplier : 1;
-        if (long)
-            longContextTurns += 1;
-        const cached = rate.cachedInputUsdPerToken === undefined ? 0 : Math.min(reqIn, Math.max(0, usage.cachedInput ?? 0));
-        const writes = Math.min(reqIn - cached, Math.max(0, usage.cacheWriteInput ?? 0));
-        const full = reqIn - cached - writes;
-        cachedTotal += cached;
-        writeTotal += writes;
-        inputUsd +=
-            full * rate.inputUsdPerToken * inMul +
-                cached * (rate.cachedInputUsdPerToken ?? 0) * inMul +
-                writes * (rate.cacheWriteUsdPerToken ?? rate.inputUsdPerToken) * inMul;
-        outputUsd += reqOut * rate.outputUsdPerToken * outMul;
-    };
-    if (tiered) {
-        for (const turn of turns)
-            priceRequest(turn, true);
-    }
-    else {
-        priceRequest({
-            input: inTok,
-            output: outTok,
-            ...(tokenUsage.cachedInput === undefined ? {} : { cachedInput: tokenUsage.cachedInput }),
-            ...(tokenUsage.cacheWriteInput === undefined ? {} : { cacheWriteInput: tokenUsage.cacheWriteInput })
-        }, false);
-    }
-    inputUsd = round6(inputUsd);
-    outputUsd = round6(outputUsd);
-    return {
-        schema: ACTOR_ESTIMATED_COST_SCHEMA,
-        estimatedCostUsd: round6(inputUsd + outputUsd),
-        ratesAsOf: rate.asOf,
-        source: rate.source,
-        ...(modelId ? { modelId } : {}),
-        ...(rate.placeholder ? { placeholder: true } : {}),
-        breakdown: {
-            inputUsd,
-            outputUsd,
-            inputTokens: inTok,
-            outputTokens: outTok,
-            ...(cachedTotal > 0 ? { cachedInputTokens: cachedTotal } : {}),
-            ...(writeTotal > 0 ? { cacheWriteInputTokens: writeTotal } : {}),
-            ...(longContextTurns > 0 ? { longContextTurns } : {})
-        }
-    };
-}
-/**
- * Estimate the E2B desktop-minute cost from a host-side create->teardown span (minutes). The rate
- * is injectable. Returns a DECLARED-ABSENT estimate (null + "no_duration") when no duration was
- * measured (no sandbox / unmeasurable span) — never a guessed 0.
- */
-export function estimateDesktopCost(minutes, rate = DESKTOP_RATE) {
-    if (minutes === undefined || !Number.isFinite(minutes) || minutes < 0) {
-        return { estimatedCostUsd: null, reason: "no_duration", ratesAsOf: null, minutes: null };
-    }
-    return {
-        estimatedCostUsd: round6(minutes * rate.usdPerMinute),
-        ratesAsOf: rate.asOf,
-        source: rate.source,
-        minutes: round6(minutes),
-        ...(rate.placeholder ? { placeholder: true } : {})
-    };
-}
-//# sourceMappingURL=pricing.js.map

package/dist/pricing.js.map

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

package/dist/program.d.ts

@@ -1,96 +0,0 @@
-import { type AutomaticAnalysisHooks } from "./automatic-analysis-completion.js";
-import { Command } from "commander";
-import { discoverProviderKeys } from "./key-resolution.js";
-import { checkCommsConnection } from "./comms-setup.js";
-import { promptSecret } from "./secret-prompt.js";
-import { type TelemetryProperties } from "./telemetry.js";
-import type { CuaActorLabResult } from "./cua-actor-lab.js";
-import type { ObserverResult, ObserverServer } from "./observer.js";
-import type { OssMetaLabResult } from "./oss-meta-lab.js";
-import { type TuiModule } from "./tui-contract.js";
-export declare const CLI_RESPONSE_SCHEMA = "humanish.cli-response.v1";
-export interface CliIo {
-    writeOut(text: string): void;
-    writeErr(text: string): void;
-    setExitCode(code: number): void;
-}
-export interface UnexpectedErrorEnvelope {
-    schema: typeof CLI_RESPONSE_SCHEMA;
-    ok: false;
-    error: {
-        /** HUMANISH_PORT_IN_USE (#484): a bind failed because the port is held; every command that
-         *  opens a loopback server (watch, observe, run --open, serve) reports it under one code. */
-        code: "HUMANISH_UNEXPECTED" | "HUMANISH_PORT_IN_USE";
-        message: string;
-    };
-}
-/**
- * Enrich commander's flag rejections with where the flag actually lives. A bare "unknown option"
- * is accurate and unhelpful in the same way `no labs here yet` was: it reports a fact about this
- * command and says nothing the reader can act on. Silence is preserved when no sibling has it —
- * inventing a suggestion would be worse than none.
- */
-export declare function withSiblingFlagHint(text: string, root: Command): string;
-export declare function createProgram(io?: Partial<CliIo> & {
-    keyDiscovery?: typeof discoverProviderKeys;
-    tuiRuntime?: Partial<TuiRuntime>;
-}): Command;
-/**
- * The pieces of the outside world the `tui` command touches. Injectable for the same reason
- * `keyDiscovery` is: the refusals ARE the behavior worth testing, and a test cannot make a real
- * TTY, an old Node, or a missing bundle appear.
- */
-export interface TuiRuntime {
-    checkComms: typeof checkCommsConnection;
-    promptSecret: typeof promptSecret;
-    stdin: NodeJS.ReadStream;
-    stdout: NodeJS.WriteStream;
-    nodeVersion: string;
-    /** Injected so a test can pose as an agent session without touching the real process env. */
-    env: NodeJS.ProcessEnv;
-    /** Resolves the bundle, or null when it is not present. */
-    loadTui(bundle: URL): Promise<TuiModule | null>;
-}
-/**
- * Default browser-open policy for a lab backend run. Mirrors the observe/watch gate:
- * an explicit --open/--no-open wins; --json (machine mode) never auto-opens; otherwise a
- * lab-config `defaults.open` wins, and the final fallback opens only for an interactive
- * `watch` on a real TTY. Extracted so all lab backends share one gate (and one test).
- */
-export declare function resolveBackendShouldOpen(args: {
-    optionOpen: boolean | undefined;
-    defaultsOpen: boolean | undefined;
-    mode: string;
-    wantsMachine: boolean;
-}): boolean;
-export declare function formatCuaLabHuman(result: CuaActorLabResult): string;
-export declare function writeResult<T>(command: Command, io: CliIo, result: T, formatHuman: (result: T) => string): void;
-/** Exported for tests: the facts writeResult read off a command's result document. */
-export declare function studyFactsFor(command: Command): TelemetryProperties;
-type WatchStopSignal = "SIGINT" | "SIGTERM" | "SIGHUP";
-interface WatchSignalTarget {
-    once(event: WatchStopSignal, listener: () => void): unknown;
-    removeListener(event: WatchStopSignal, listener: () => void): unknown;
-}
-export declare function followObserver(io: CliIo, result: ObserverResult, server: ObserverServer, options?: {
-    onStop?: () => Promise<string[]>;
-    signalTarget?: WatchSignalTarget;
-    signals?: WatchStopSignal[];
-}): Promise<void>;
-export declare function shouldForceExitAfterOssMetaLab(output: OssMetaLabResult, options: {
-    detach: boolean;
-    wantsMachine: boolean;
-}): boolean;
-export declare function shouldServeOssMetaLabObserver(output: OssMetaLabResult, options: {
-    wantsFollow: boolean;
-}): output is OssMetaLabResult & {
-    observer: ObserverResult & {
-        ok: true;
-    };
-};
-export declare function exitCodeForOssMetaLab(output: OssMetaLabResult): number;
-/** Listeners exist only while post-run analysis is active; actor signal behavior is unchanged. */
-export declare function cliAutomaticAnalysisHooks(io: Pick<CliIo, "writeErr">): AutomaticAnalysisHooks;
-/** Preserve the run's own result while making requested post-processing failures machine-visible. */
-export declare function automaticAnalysisEnvelope<T>(result: T): T;
-export {};