humanish 0.104.3 → 0.106.0

package/dist/persona.d.ts

@@ -1,35 +0,0 @@
-export type PersonaLevel = "low" | "medium" | "high";
-export interface ResolvedPersona {
-    id: string;
-    name: string;
-    summary?: string;
-    traits: {
-        patience: PersonaLevel;
-        skill: PersonaLevel;
-        accessibilityNeeds?: string;
-    };
-    constraints: string[];
-}
-export interface PersonaDirectives {
-    frictionTolerance: string;
-    skillBias: string;
-    accessibilityBehavior?: string;
-    constraints: string[];
-    traitsApplied: string[];
-}
-/**
- * Parse a YAML-parsed persona object into a normalized ResolvedPersona. `fallback`
- * supplies id/name when the document omits them (or is not a record at all).
- */
-export declare function parseResolvedPersona(raw: unknown, fallback: {
-    id: string;
-    name: string;
-}): ResolvedPersona;
-export declare function personaToDirectives(persona: ResolvedPersona): PersonaDirectives;
-/**
- * Render the persona section injected into an actor prompt. Replaces the bare
- * `Persona: <name>.` line so the persona's friction tolerance, skill, and
- * accessibility behavior actually shape the run. Returns a single space-joined
- * string to match the existing prompt-builder style.
- */
-export declare function renderPersonaPromptSection(persona: ResolvedPersona): string;

package/dist/persona.js

@@ -1,141 +0,0 @@
-// Compiles a committed persona (humanish/personas/*.yaml) into actor-neutral
-// behavioral directives so persona traits actually drive how the actor uses the
-// product, instead of being inert metadata. See docs/architecture/actor-contract.md.
-//
-// Patience is modeled as FRICTION TOLERANCE, never a turn/tool-call budget: the
-// directive tells the actor when, in character, to stop and report the friction.
-const LEVELS = ["low", "medium", "high"];
-function normalizeLevel(value, fallback = "medium") {
-    if (typeof value === "string") {
-        const lowered = value.trim().toLowerCase();
-        if (LEVELS.includes(lowered)) {
-            return lowered;
-        }
-    }
-    return fallback;
-}
-// Persona files are committed public-safe source, but they still flow into an
-// actor prompt, so replace control characters with spaces and cap length to
-// limit prompt-injection surface from a hand-authored persona.
-function stripControlChars(value) {
-    let out = "";
-    for (const ch of value) {
-        const code = ch.codePointAt(0) ?? 0;
-        out += code < 0x20 || code === 0x7f ? " " : ch;
-    }
-    return out;
-}
-function sanitizePersonaText(value, maxLength) {
-    if (typeof value !== "string") {
-        return undefined;
-    }
-    const cleaned = stripControlChars(value)
-        // Neutralize the actor verdict/nonce markers so persona text injected into a
-        // prompt cannot forge a verdict line an actor might echo back.
-        .replace(/HUMANISH_ACTOR_(?:VERDICT|NONCE)/gi, "HUMANISH_ACTOR_[neutralized]")
-        .replace(/\s+/g, " ")
-        .trim();
-    if (cleaned.length === 0) {
-        return undefined;
-    }
-    return cleaned.length > maxLength ? `${cleaned.slice(0, maxLength - 1)}…` : cleaned;
-}
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-/**
- * Parse a YAML-parsed persona object into a normalized ResolvedPersona. `fallback`
- * supplies id/name when the document omits them (or is not a record at all).
- */
-export function parseResolvedPersona(raw, fallback) {
-    const record = isRecord(raw) ? raw : {};
-    const traits = isRecord(record.traits) ? record.traits : {};
-    const id = sanitizePersonaText(record.id, 120) ?? fallback.id;
-    const name = sanitizePersonaText(record.name, 120) ?? fallback.name;
-    const summary = sanitizePersonaText(record.summary, 280);
-    const accessibilityNeeds = sanitizePersonaText(traits.accessibility_needs, 80);
-    const constraints = Array.isArray(record.constraints)
-        ? record.constraints
-            .map((entry) => sanitizePersonaText(entry, 160))
-            .filter((entry) => entry !== undefined)
-            .slice(0, 8)
-        : [];
-    return {
-        id,
-        name,
-        ...(summary === undefined ? {} : { summary }),
-        traits: {
-            patience: normalizeLevel(traits.patience),
-            // Persona YAML uses `technical_confidence`; the directive model calls it skill.
-            skill: normalizeLevel(traits.technical_confidence),
-            ...(accessibilityNeeds === undefined ? {} : { accessibilityNeeds })
-        },
-        constraints
-    };
-}
-const FRICTION_TOLERANCE = {
-    low: "You are impatient: if you hit repeated friction (errors, dead-ends, confusing UI) or stop making progress toward your goal, stop and report exactly what blocked you instead of pushing through.",
-    medium: "You have moderate patience: work through some friction, but if you repeatedly fail to make progress toward your goal, stop and report what blocked you.",
-    high: "You are determined: push through friction and try recovery paths, but if you reach an unrecoverable dead-end, stop and report it."
-};
-// Skill describes how COMPETENTLY an actor works the surfaces its population actually uses — it
-// must not name an affordance that escapes those surfaces. The `high` directive used to say
-// "inspect configuration, and try the recovery paths an expert would", which a computer-use actor
-// can honestly read as license to open devtools or type a `javascript:` URL: a human-persona run
-// then routes around the very friction the study exists to measure and still returns green. Skill
-// is now modality-neutral (an expert human uses advanced UI and settings; an expert agent uses the
-// documented API), so which affordances are in scope is a property of the declared population,
-// not a side effect of a trait table.
-const SKILL_BIAS = {
-    low: "You are not technically confident: prefer obvious UI affordances over CLI flags or config, and narrate your confusion whenever the interface is ambiguous.",
-    medium: "You have moderate technical confidence: use straightforward paths and try one recovery step before giving up.",
-    high: "You are technically confident: use keyboard shortcuts, the product's own advanced options and settings, and the recovery paths an expert would try on the surfaces this product gives you."
-};
-function accessibilityBehavior(needs) {
-    const lowered = needs.toLowerCase();
-    if (lowered.includes("keyboard")) {
-        return "Navigate using the keyboard; treat a control that requires a mouse and offers no keyboard path as a defect and report it.";
-    }
-    if (lowered.includes("terminal") || lowered.includes("output")) {
-        return "You rely on clear terminal output; flag noisy, unreadable, or ambiguous output as a defect.";
-    }
-    return `You have the accessibility need "${needs}"; treat violations of it as defects and report them.`;
-}
-export function personaToDirectives(persona) {
-    const traitsApplied = [`patience:${persona.traits.patience}`, `skill:${persona.traits.skill}`];
-    const accessibility = persona.traits.accessibilityNeeds
-        ? accessibilityBehavior(persona.traits.accessibilityNeeds)
-        : undefined;
-    if (persona.traits.accessibilityNeeds) {
-        traitsApplied.push(`accessibility:${persona.traits.accessibilityNeeds}`);
-    }
-    if (persona.constraints.length > 0) {
-        traitsApplied.push(`constraints:${persona.constraints.length}`);
-    }
-    return {
-        frictionTolerance: FRICTION_TOLERANCE[persona.traits.patience],
-        skillBias: SKILL_BIAS[persona.traits.skill],
-        ...(accessibility === undefined ? {} : { accessibilityBehavior: accessibility }),
-        constraints: persona.constraints,
-        traitsApplied
-    };
-}
-/**
- * Render the persona section injected into an actor prompt. Replaces the bare
- * `Persona: <name>.` line so the persona's friction tolerance, skill, and
- * accessibility behavior actually shape the run. Returns a single space-joined
- * string to match the existing prompt-builder style.
- */
-export function renderPersonaPromptSection(persona) {
-    const directives = personaToDirectives(persona);
-    const parts = [
-        `Persona: ${persona.name}.`,
-        ...(persona.summary ? [persona.summary] : []),
-        directives.frictionTolerance,
-        directives.skillBias,
-        ...(directives.accessibilityBehavior ? [directives.accessibilityBehavior] : []),
-        ...(directives.constraints.length > 0 ? [`Honor these constraints: ${directives.constraints.join("; ")}.`] : [])
-    ];
-    return parts.join(" ");
-}
-//# sourceMappingURL=persona.js.map

package/dist/persona.js.map

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

package/dist/pi-agent-core.d.ts

@@ -1,77 +0,0 @@
-import { type ActorCompletionReason, type ActorPersonaRef, type ActorStatus, type ActorTrace } from "./actor-contract.js";
-export type PiStopReason = "stop" | "toolUse" | "length" | "error" | "aborted";
-export type PiAgentEvent = {
-    type: "agent_start";
-} | {
-    type: "agent_end";
-} | {
-    type: "turn_start";
-} | {
-    type: "turn_end";
-} | {
-    type: "message_start";
-    role?: string;
-} | {
-    type: "message_update";
-    textDelta?: string;
-    thinkingDelta?: string;
-} | {
-    type: "message_end";
-    text?: string;
-    thinking?: string;
-} | {
-    type: "tool_execution_start";
-    toolCallId: string;
-    toolName: string;
-} | {
-    type: "tool_execution_end";
-    toolCallId: string;
-    toolName?: string;
-    isError?: boolean;
-} | {
-    type: "queue_update";
-    summary?: string;
-} | {
-    type: "compaction_start";
-} | {
-    type: "compaction_end";
-} | {
-    type: "auto_retry_start";
-} | {
-    type: "auto_retry_end";
-} | {
-    type: "notice";
-    method?: string;
-    message?: string;
-};
-export interface PiSessionStats {
-    tokens?: {
-        input?: number;
-        output?: number;
-        total?: number;
-        cacheRead?: number;
-        cacheWrite?: number;
-    };
-    cost?: number;
-}
-export interface PiSessionResult {
-    events: PiAgentEvent[];
-    sessionId?: string;
-    model?: string;
-    providerVersion?: string;
-    startedAt: string;
-    completedAt: string;
-    durationMs: number;
-    status: ActorStatus;
-    reason: string;
-    stats?: PiSessionStats;
-}
-export declare function piStopReasonToStatus(stop: PiStopReason): ActorStatus;
-export declare function piStatusToCompletionReason(status: ActorStatus): ActorCompletionReason;
-/**
- * Map a pi-agent-core session into the provider-neutral ActorTrace. Pure and
- * side-effect-free; mirrors codexResultToActorTrace. The persona reference is
- * supplied by the harness. Used by the actorRegistry to prove the contract is
- * provider-neutral ahead of the live SDK shim.
- */
-export declare function piSessionToActorTrace(session: PiSessionResult, persona: ActorPersonaRef): ActorTrace;

package/dist/pi-agent-core.js

@@ -1,207 +0,0 @@
-import { ACTOR_TRACE_SCHEMA, PI_AGENT_CORE_CAPABILITIES } from "./actor-contract.js";
-import { redactText } from "./redaction.js";
-export function piStopReasonToStatus(stop) {
-    switch (stop) {
-        case "stop":
-        case "toolUse":
-            return "passed";
-        case "length":
-            return "timed_out";
-        case "aborted":
-            return "blocked";
-        case "error":
-            return "failed";
-    }
-}
-export function piStatusToCompletionReason(status) {
-    switch (status) {
-        case "passed":
-            return "turn_completed";
-        case "timed_out":
-            return "timed_out";
-        case "blocked":
-            return "blocked_approval";
-        case "abandoned":
-            return "gave_up";
-        case "incomplete":
-            return "budget_reached";
-        case "failed":
-            return "actor_error";
-    }
-}
-function pickPiTokenUsage(stats) {
-    if (!stats) {
-        return undefined;
-    }
-    const num = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
-    const input = num(stats.tokens?.input);
-    const output = num(stats.tokens?.output);
-    const total = num(stats.tokens?.total);
-    const costUsd = num(stats.cost);
-    const usage = {
-        ...(input === undefined ? {} : { input }),
-        ...(output === undefined ? {} : { output }),
-        ...(total === undefined ? {} : { total }),
-        ...(costUsd === undefined ? {} : { costUsd })
-    };
-    return Object.keys(usage).length > 0 ? usage : undefined;
-}
-// Project the pi event stream into provider-neutral ActorTraceItems. pi has no
-// native file_change / screenshot / ui_action / approval events today, so none
-// are fabricated (intentional, not incomplete). Bash runs surface as tool_call,
-// not command, until the live shim can inspect tool results.
-function piEventsToActorItems(events) {
-    const items = [];
-    const toolNames = new Map();
-    let messageOrdinal = 0;
-    let noticeOrdinal = 0;
-    let textBuffer = "";
-    let thinkingBuffer = "";
-    const flushMessage = (endText, endThinking) => {
-        const text = (endText ?? textBuffer).trim();
-        const thinking = (endThinking ?? thinkingBuffer).trim();
-        messageOrdinal += 1;
-        if (thinking.length > 0) {
-            items.push({
-                id: `reasoning-${messageOrdinal}`,
-                kind: "reasoning",
-                lifecycle: "completed",
-                title: "Reasoning",
-                text: redactText(thinking)
-            });
-        }
-        items.push({
-            id: `message-${messageOrdinal}`,
-            kind: "message",
-            lifecycle: "completed",
-            title: "Assistant message",
-            ...(text.length > 0 ? { text: redactText(text) } : {})
-        });
-        textBuffer = "";
-        thinkingBuffer = "";
-    };
-    for (const event of events) {
-        switch (event.type) {
-            case "message_start":
-                items.push({ id: `message-start-${messageOrdinal + 1}`, kind: "message", lifecycle: "started", title: "Assistant message" });
-                break;
-            case "message_update":
-                if (event.textDelta) {
-                    textBuffer += event.textDelta;
-                }
-                if (event.thinkingDelta) {
-                    thinkingBuffer += event.thinkingDelta;
-                }
-                break;
-            case "message_end":
-                flushMessage(event.text, event.thinking);
-                break;
-            case "tool_execution_start": {
-                toolNames.set(event.toolCallId, event.toolName);
-                const name = redactText(event.toolName);
-                items.push({
-                    id: event.toolCallId,
-                    kind: "tool_call",
-                    lifecycle: "started",
-                    title: name,
-                    tool: { name }
-                });
-                break;
-            }
-            case "tool_execution_end": {
-                const name = redactText(event.toolName ?? toolNames.get(event.toolCallId) ?? "tool");
-                items.push({
-                    id: `${event.toolCallId}-end`,
-                    kind: "tool_call",
-                    lifecycle: "completed",
-                    ...(event.isError ? { status: "error" } : {}),
-                    title: name,
-                    tool: { name }
-                });
-                break;
-            }
-            case "queue_update":
-                noticeOrdinal += 1;
-                items.push({
-                    id: `plan-${noticeOrdinal}`,
-                    kind: "plan",
-                    lifecycle: "completed",
-                    title: "Queue update",
-                    ...(event.summary ? { text: redactText(event.summary) } : {})
-                });
-                break;
-            case "compaction_start":
-            case "compaction_end":
-            case "auto_retry_start":
-            case "auto_retry_end":
-                noticeOrdinal += 1;
-                items.push({
-                    id: `notice-${noticeOrdinal}`,
-                    kind: "notice",
-                    lifecycle: event.type.endsWith("_start") ? "started" : "completed",
-                    title: event.type
-                });
-                break;
-            case "notice":
-                noticeOrdinal += 1;
-                items.push({
-                    id: `notice-${noticeOrdinal}`,
-                    kind: "notice",
-                    lifecycle: "completed",
-                    title: event.method ?? "notice",
-                    ...(event.message ? { text: redactText(event.message) } : {})
-                });
-                break;
-            default:
-                // agent_start / agent_end / turn_start / turn_end carry no item evidence.
-                break;
-        }
-    }
-    // Terminal flush: if the stream ended mid-message (abnormal termination such as
-    // an error/abort/length cutoff), preserve the partial assistant text/reasoning.
-    if (textBuffer.length > 0 || thinkingBuffer.length > 0) {
-        flushMessage(undefined, undefined);
-    }
-    return items;
-}
-/**
- * Map a pi-agent-core session into the provider-neutral ActorTrace. Pure and
- * side-effect-free; mirrors codexResultToActorTrace. The persona reference is
- * supplied by the harness. Used by the actorRegistry to prove the contract is
- * provider-neutral ahead of the live SDK shim.
- */
-export function piSessionToActorTrace(session, persona) {
-    const tokenUsage = pickPiTokenUsage(session.stats);
-    const items = piEventsToActorItems(session.events);
-    return {
-        schema: ACTOR_TRACE_SCHEMA,
-        provider: "pi-agent-core",
-        ...(session.providerVersion === undefined ? {} : { providerVersion: session.providerVersion }),
-        protocol: "in-process-sdk",
-        lane: "code",
-        persona,
-        redaction: {
-            status: "passed",
-            screenshots: "n/a",
-            notes: "pi event stream projected to actor trace; secret-like text is rejected by verify."
-        },
-        startedAt: session.startedAt,
-        completedAt: session.completedAt,
-        durationMs: session.durationMs,
-        status: session.status,
-        completionReason: piStatusToCompletionReason(session.status),
-        reason: redactText(session.reason),
-        ids: {
-            ...(session.sessionId === undefined ? {} : { sessionId: session.sessionId }),
-            ...(session.model === undefined ? {} : { model: session.model })
-        },
-        counts: {
-            events: session.events.length,
-            items: items.length
-        },
-        items,
-        ...(tokenUsage === undefined ? {} : { tokenUsage }),
-        capabilities: PI_AGENT_CORE_CAPABILITIES
-    };
-}
-//# sourceMappingURL=pi-agent-core.js.map

package/dist/pi-agent-core.js.map

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

package/dist/pricing.d.ts

@@ -1,145 +0,0 @@
-import type { ActorTokenUsage } from "./actor-contract.js";
-export declare const PRICING_SCHEMA = "humanish.pricing.v1";
-export declare 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 declare function contradictsAccountBilling(streams: readonly {
-    id?: string;
-    laneId?: string;
-    actor?: {
-        executionProfile?: {
-            billing?: unknown;
-        } | undefined;
-    };
-    liveActor?: {
-        executionProfile?: {
-            billing?: unknown;
-        } | undefined;
-    };
-}[], cost: {
-    fullyEstimated?: unknown;
-    breakdown?: unknown;
-} | undefined): boolean;
-export interface ModelRate {
-    /** USD per input token (the per-1M equivalent is noted in the comment beside each entry). */
-    inputUsdPerToken: number;
-    /** USD per output token. */
-    outputUsdPerToken: number;
-    /** USD per input token served from the provider's prompt cache, when the provider bills those at
-     *  a reduced rate. Optional: absent means we do not model a discount and every input token is
-     *  billed at `inputUsdPerToken` — the previous behavior, kept as the fallback so a rate sheet
-     *  without this field prices exactly as it did before (#391). */
-    cachedInputUsdPerToken?: number;
-    /** USD per input token newly WRITTEN to the provider's prompt cache, when the provider bills
-     *  writes (OpenAI: GPT-5.6+ bills `cache_write_tokens` at 1.25x the uncached input rate, as the
-     *  TOTAL rate for those tokens — not an extra charge on top). Absent = writes are free (every
-     *  pre-5.6 model) and any reported write tokens price at the plain input rate. */
-    cacheWriteUsdPerToken?: number;
-    /** Long-context tier, when the provider re-prices the WHOLE request past an input-size
-     *  threshold (OpenAI GPT-5.6: >272K input tokens => 2x input-side, 1.5x output, full request).
-     *  Priced exactly only when the usage carries per-request `turns` records; totals alone cannot
-     *  say which requests crossed, so without turns the estimate stays on the short-context rate
-     *  (the historical behavior, and the under-estimate direction is called out in #334's fix). */
-    longContext?: {
-        thresholdInputTokens: number;
-        inputMultiplier: number;
-        outputMultiplier: number;
-    };
-    /** "YYYY-MM-DD" the entry was last checked against `source`. */
-    asOf: string;
-    /** Public pricing page the number came from (a comment/URL, never a secret). */
-    source: string;
-    /** true = a stand-in NOT copied from a live sheet; the estimate carries this flag so a
-     *  placeholder rate is never mistaken for a confirmed one. */
-    placeholder?: boolean;
-}
-export interface DesktopRate {
-    usdPerMinute: number;
-    asOf: string;
-    source: string;
-    placeholder?: boolean;
-}
-/** Resource quantities reported by the owned E2B allocation, not its template label. */
-export interface DesktopResources {
-    cpuCount: number;
-    /** E2B's `memoryMB` field is in MiB; normalize the unit before pricing GiB. */
-    memoryMiB: number;
-}
-export interface DesktopResourceRate {
-    usdPerCpuSecond: number;
-    usdPerGiBSecond: number;
-    asOf: string;
-    source: string;
-}
-/**
- * The token-derived cost ESTIMATE for one actor lane. `estimatedCostUsd: null` = DECLARED ABSENT
- * (unknown rate or no token usage) — never coerced to 0. A non-null figure ALWAYS carries its
- * pricing provenance (`ratesAsOf` + `source`) so the mechanism (a rate-table multiply) matches
- * the claim (an estimate, not a charge). Defined here so the rate table and the field that
- * consumes it live together; `ActorTrace` imports it type-only.
- */
-export interface ActorEstimatedCost {
-    schema: typeof ACTOR_ESTIMATED_COST_SCHEMA;
-    /** null = declared absent (no rate for the model / no token usage). */
-    estimatedCostUsd: number | null;
-    reason?: "no_rate_for_model" | "no_token_usage" | "account_billing_unknown";
-    /** Pricing provenance date; null iff estimatedCostUsd is null. */
-    ratesAsOf: string | null;
-    /** The pricing-page URL/comment that produced the rate. */
-    source?: string;
-    /** The model id the estimate was keyed on. */
-    modelId?: string;
-    /** true when the rate is a stand-in, not a live sheet. */
-    placeholder?: boolean;
-    breakdown?: {
-        inputUsd: number;
-        outputUsd: number;
-        inputTokens: number;
-        outputTokens: number;
-        /** Of `inputTokens`, how many were billed at the reduced cached rate. Present only when the
-         *  provider reported cache hits AND the rate sheet models a cached rate. */
-        cachedInputTokens?: number;
-        /** Of `inputTokens`, how many were billed at the cache-WRITE rate (OpenAI 5.6+). */
-        cacheWriteInputTokens?: number;
-        /** How many requests crossed the long-context threshold and were re-tiered. Present only
-         *  when per-request `turns` records made exact tiering possible. */
-        longContextTurns?: number;
-    };
-}
-/** The desktop-minute cost ESTIMATE (host-side create->teardown span * a per-minute rate). Same
- *  null-discipline as ActorEstimatedCost: `estimatedCostUsd: null` = not measured (no duration). */
-export interface DesktopCostEstimate {
-    estimatedCostUsd: number | null;
-    reason?: "no_duration" | "no_desktop_resources" | "no_rate_for_desktop";
-    ratesAsOf: string | null;
-    source?: string;
-    /** The billed minutes the estimate was keyed on; null when no duration was measured. */
-    minutes: number | null;
-    placeholder?: boolean;
-    resources?: DesktopResources;
-    usdPerSecond?: number;
-}
-export declare const MODEL_RATES: Record<string, ModelRate>;
-export declare const DESKTOP_RESOURCE_RATE: DesktopResourceRate;
-export declare const DESKTOP_RATE: DesktopRate;
-export declare function isDesktopResources(value: unknown): value is DesktopResources;
-/** Price one observed allocation. Missing quantities/rates stay unknown, never a stock guess. */
-export declare function estimateAllocatedDesktopCost(minutes: number | undefined, resources: DesktopResources | undefined, rate?: DesktopResourceRate): DesktopCostEstimate;
-/** 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 declare function round6(n: number): number;
-/**
- * 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 declare function estimateActorCostForExecution(usage: ActorTokenUsage | undefined, modelId: string | undefined, profile?: {
-    billing?: unknown;
-}): ActorEstimatedCost;
-export declare function estimateActorCost(tokenUsage: ActorTokenUsage | undefined, modelId: string | undefined, rates?: Record<string, ModelRate>): ActorEstimatedCost;
-/**
- * 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 declare function estimateDesktopCost(minutes: number | undefined, rate?: DesktopRate): DesktopCostEstimate;