@agentguard-run/spend 0.7.0 → 0.8.0

package/dist/outcomes/runtime.js

@@ -0,0 +1,321 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeOutcomeTask = executeOutcomeTask;
+const crypto_1 = require("crypto");
+const policy_1 = require("../policy");
+const cost_table_1 = require("../cost-table");
+const router_1 = require("../router");
+const ledger_1 = require("./ledger");
+const quality_gate_1 = require("./quality-gate");
+const types_1 = require("./types");
+async function executeOutcomeTask(options) {
+    validateTemplate(options.template);
+    validateInputs(options.template, options.inputs);
+    const started = Date.now();
+    const receiptStore = options.receiptStore ?? new types_1.InMemoryOutcomeReceiptStore();
+    const ledger = options.ledger ?? new ledger_1.OutcomeSpendLedger(options.guard.getSpendStore());
+    const posture = options.context.posture ?? 'standard';
+    const budgetTier = options.context.budgetTier ?? 'solo';
+    const route = (0, router_1.recommend)({
+        vertical: options.template.vertical,
+        outcome: options.template.slug,
+        posture,
+        budgetTier,
+        imageCapable: options.context.imageCapable,
+    });
+    const blockedOrigins = [...new Set([...(options.template.blockedOrigins ?? []), ...route.blockedOrigins])];
+    const hold = await ledger.hold({
+        scope: options.context.scope,
+        window: options.template.spendCaps.window ?? 'per_call',
+        amountCents: options.template.spendCaps.maxCostCents,
+        limitCents: options.template.spendCaps.periodCapCents ?? options.template.spendCaps.maxCostCents,
+    });
+    const links = [];
+    let status = 'failed';
+    let drafter = null;
+    let reviewer = null;
+    let fallback = null;
+    let outputText = '';
+    let reviewerOutputText;
+    let gate = { score: 0, riskScore: 0, passed: false, issues: ['not_run'], triggerFired: [] };
+    try {
+        drafter = await runGuardedModel({
+            guard: options.guard,
+            template: options.template,
+            context: options.context,
+            route,
+            role: 'drafter',
+            model: route.drafter,
+            inputs: options.inputs,
+            runner: options.runner,
+        });
+        links.push(linkFor('drafter', drafter));
+        outputText = drafter.response.text;
+        gate = (0, quality_gate_1.scoreOutcomeOutput)(outputText, options.template, drafter.response.qualityScore);
+        if ((0, quality_gate_1.shouldRunReviewer)(gate) && options.context.reviewerCascadeAuto === true) {
+            const reviewerModel = antiCorrelatedReviewer(route, drafter.decision.modelResolved);
+            reviewer = await runGuardedModel({
+                guard: options.guard,
+                template: options.template,
+                context: options.context,
+                route,
+                role: 'reviewer',
+                model: reviewerModel,
+                inputs: { outcome_metadata_only: true, trigger_fired: gate.triggerFired.join(',') },
+                runner: options.runner,
+                priorOutputText: outputText,
+            });
+            links.push(linkFor('reviewer', reviewer));
+            reviewerOutputText = reviewer.response.text;
+            status = 'completed';
+        }
+        else {
+            status = gate.passed ? 'completed' : 'quality_failed';
+        }
+    }
+    catch (err) {
+        if (!drafter) {
+            const fallbackModel = antiCorrelatedFallback(route, route.drafter);
+            if (fallbackModel) {
+                fallback = { model: fallbackModel, reason: errorReason(err) };
+                try {
+                    drafter = await runGuardedModel({
+                        guard: options.guard,
+                        template: options.template,
+                        context: options.context,
+                        route,
+                        role: 'fallback',
+                        model: fallbackModel,
+                        inputs: options.inputs,
+                        runner: options.runner,
+                    });
+                    fallback.decisionId = drafter.decision.decisionId;
+                    links.push(linkFor('fallback', drafter));
+                    outputText = drafter.response.text;
+                    gate = (0, quality_gate_1.scoreOutcomeOutput)(outputText, options.template, drafter.response.qualityScore);
+                    status = gate.passed ? 'completed' : 'quality_failed';
+                }
+                catch {
+                    status = 'failed';
+                }
+            }
+            else {
+                status = 'failed';
+            }
+        }
+        else {
+            status = 'failed';
+        }
+    }
+    const totalCostCents = links.reduce((sum, item) => sum + item.actualCents, 0);
+    if (status === 'completed')
+        await ledger.settle(hold, totalCostCents);
+    else
+        await ledger.refund(hold);
+    const receipt = buildReceipt({
+        template: options.template,
+        context: options.context,
+        hold,
+        route,
+        blockedOrigins,
+        status,
+        drafter,
+        reviewer,
+        fallback,
+        links,
+        gate,
+        totalCostCents,
+        durationMs: Date.now() - started,
+        posture,
+        budgetTier,
+    });
+    await receiptStore.append(receipt);
+    const signedReceipt = await options.guard.recordOutcomeReceipt(receiptToMetadata(receipt));
+    return { receipt, signed: signedReceipt.signed, outputText, reviewerOutputText };
+}
+async function runGuardedModel(args) {
+    const request = buildModelRequest(args);
+    const inputTokens = args.guard.estimateTokens(request.systemPrompt + '\n' + request.userPrompt);
+    const outputTokens = estimatedOutputTokens(args.template);
+    const { decision, signed } = await args.guard.decide({
+        provider: (0, cost_table_1.inferProvider)(args.model),
+        model: args.model,
+        inputTokens,
+        outputTokens,
+        scope: args.context.scope,
+        capabilityClaim: args.template.capability,
+        label: args.template.slug + ':' + args.role,
+    });
+    if (decision.action === 'block')
+        throw new Error('Outcome model call blocked by policy');
+    const started = Date.now();
+    let response;
+    try {
+        response = await args.runner.run({ ...request, model: decision.modelResolved });
+    }
+    catch (err) {
+        await args.guard.settleStreamUsage(decision.decisionId, 0, 0, { partial: true, reason: errorReason(err) });
+        throw err;
+    }
+    const actualInputTokens = validToken(response.inputTokens) ? response.inputTokens : inputTokens;
+    const actualOutputTokens = validToken(response.outputTokens) ? response.outputTokens : args.guard.estimateTokens(response.text);
+    const computed = (0, cost_table_1.computeCallCents)(decision.modelResolved, actualInputTokens, actualOutputTokens);
+    const actualCents = validCents(response.costCents) ? response.costCents : computed ?? decision.projectedCents;
+    await args.guard.settleStreamUsage(decision.decisionId, actualInputTokens, actualOutputTokens, { partial: false });
+    return { response, decision, signed, actualInputTokens, actualOutputTokens, actualCents, durationMs: Date.now() - started };
+}
+function buildModelRequest(args) {
+    const contextLines = (args.template.contextInjection ?? []).map((item) => {
+        const value = args.context.context?.[item.field] ?? item.example ?? '';
+        return item.label + ': ' + value;
+    });
+    const inputLines = Object.entries(args.inputs).map(([key, value]) => key + ': ' + JSON.stringify(value));
+    const userPrompt = [
+        'Outcome: ' + args.template.slug,
+        'Role: ' + args.role,
+        ...contextLines,
+        ...inputLines,
+        args.priorOutputText ? 'Prior drafter output:\n' + args.priorOutputText : '',
+        'Return format: ' + args.template.outputFormat,
+    ].filter(Boolean).join('\n');
+    return {
+        role: args.role,
+        model: args.model,
+        vertical: String(args.template.vertical),
+        outcome: args.template.slug,
+        promptVersion: args.template.promptVersion,
+        systemPrompt: args.template.systemPrompt + (args.template.disclaimer ? '\n' + args.template.disclaimer : ''),
+        userPrompt,
+        outputFormat: args.template.outputFormat,
+        metadata: {
+            vertical: String(args.template.vertical),
+            outcome: args.template.slug,
+            promptVersion: args.template.promptVersion,
+            need: args.route.need,
+            role: args.role,
+        },
+    };
+}
+function buildReceipt(args) {
+    return {
+        receiptId: 'ag_outcome_' + (0, crypto_1.randomUUID)(),
+        timestamp: new Date().toISOString(),
+        vertical: String(args.template.vertical),
+        outcome: args.template.slug,
+        promptVersion: args.template.promptVersion,
+        customerId: args.context.customerId,
+        scopeKey: (0, policy_1.buildScopeKey)(args.context.scope),
+        status: args.status,
+        drafter: modelSummary(args.drafter),
+        reviewer: args.reviewer ? { ...modelSummary(args.reviewer), verdict: args.reviewer.response.verdict ?? 'reviewed' } : null,
+        fallback: args.fallback,
+        triggerFired: args.gate.triggerFired,
+        qualityScore: args.gate.score,
+        pass: args.status === 'completed',
+        totalCostCents: args.totalCostCents,
+        durationMs: args.durationMs,
+        decisionLinks: args.links,
+        metadata: {
+            need: args.route.need,
+            capability: args.template.capability,
+            posture: args.posture,
+            budgetTier: args.budgetTier,
+            blockedOrigins: args.blockedOrigins,
+            provenance: provenanceSummary(args.drafter, args.reviewer),
+        },
+    };
+}
+function modelSummary(run) {
+    if (!run)
+        return { model: 'none', costCents: 0, inputTokens: 0, outputTokens: 0 };
+    return {
+        model: run.decision.modelResolved,
+        decisionId: run.decision.decisionId,
+        costCents: run.actualCents,
+        inputTokens: run.actualInputTokens,
+        outputTokens: run.actualOutputTokens,
+    };
+}
+function provenanceSummary(drafter, reviewer) {
+    const out = {};
+    if (drafter?.response.durationMs)
+        out.drafterDurationMs = drafter.response.durationMs;
+    if (reviewer?.response.durationMs)
+        out.reviewerDurationMs = reviewer.response.durationMs;
+    return out;
+}
+function receiptToMetadata(receipt) {
+    return JSON.parse(JSON.stringify(receipt));
+}
+function linkFor(role, run) {
+    return {
+        role,
+        decisionId: run.decision.decisionId,
+        entryHash: run.signed?.entryHash,
+        modelRequested: run.decision.modelRequested,
+        modelResolved: run.decision.modelResolved,
+        projectedCents: run.decision.projectedCents,
+        actualCents: run.actualCents,
+        inputTokens: run.actualInputTokens,
+        outputTokens: run.actualOutputTokens,
+    };
+}
+function antiCorrelatedReviewer(route, drafterModel) {
+    if (familyOf(route.reviewer) !== familyOf(drafterModel))
+        return route.reviewer;
+    return antiCorrelatedFallback(route, drafterModel) ?? route.reviewer;
+}
+function antiCorrelatedFallback(route, failedModel) {
+    const failedFamily = familyOf(failedModel);
+    return route.allowedModels.find((model) => model !== failedModel && familyOf(model) !== failedFamily && (0, cost_table_1.computeCallCents)(model, 1, 1) !== null) ?? null;
+}
+function familyOf(model) {
+    const id = model.toLowerCase();
+    if (id.includes('opus'))
+        return 'opus';
+    if (id.includes('sonnet'))
+        return 'sonnet';
+    if (id.includes('haiku'))
+        return 'haiku';
+    if (id.includes('gpt-oss'))
+        return 'gpt-oss';
+    if (id.includes('gpt-5'))
+        return 'gpt-5';
+    if (id.includes('gpt-4'))
+        return 'gpt-4';
+    if (id.includes('llama'))
+        return 'llama';
+    if (id.includes('mistral'))
+        return 'mistral';
+    if (id.includes('nova'))
+        return 'nova';
+    return id.split('/')[0] || id.split('.')[0] || 'unknown';
+}
+function estimatedOutputTokens(template) {
+    return Math.max(128, Math.min(4096, Math.ceil(template.spendCaps.maxCostCents * 64)));
+}
+function validateTemplate(template) {
+    if (!template.slug || !template.vertical)
+        throw new Error('Outcome template must include slug and vertical');
+    if (!Number.isSafeInteger(template.spendCaps.maxCostCents) || template.spendCaps.maxCostCents < 0) {
+        throw new Error('Outcome spend cap must be a non-negative safe integer');
+    }
+}
+function validateInputs(template, inputs) {
+    for (const input of template.inputs) {
+        if (input.required && !(input.name in inputs))
+            throw new Error('Missing required outcome input: ' + input.name);
+    }
+}
+function validToken(value) {
+    return Number.isSafeInteger(value) && value >= 0;
+}
+function validCents(value) {
+    return Number.isSafeInteger(value) && value >= 0;
+}
+function errorReason(err) {
+    if (err instanceof Error && err.message)
+        return err.message.slice(0, 120);
+    return 'model_error';
+}
+//# sourceMappingURL=runtime.js.map

package/dist/outcomes/runtime.js.map

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

package/dist/outcomes/types.d.ts

@@ -0,0 +1,147 @@
+import type { CapabilityTier, SpendScope, SpendWindow } from '../types';
+export type OutcomeVertical = 'law' | 'accounting' | 'insurance' | 'realestate' | 'ecommerce' | string;
+export type OutcomeRole = 'drafter' | 'reviewer' | 'fallback';
+export type OutcomeStatus = 'completed' | 'blocked' | 'failed' | 'quality_failed';
+export interface OutcomeInputDefinition {
+    name: string;
+    type: 'string' | 'number' | 'boolean' | 'json' | 'date';
+    required?: boolean;
+    description?: string;
+}
+export interface OutcomeSpendCaps {
+    maxCostCents: number;
+    window?: SpendWindow;
+    periodCapCents?: number;
+}
+export interface OutcomeQualityGateRubric {
+    name: string;
+    weight?: number;
+    passThreshold?: number;
+}
+export interface OutcomeQualityGateConfig {
+    passThreshold?: number;
+    reviewerTriggerScore?: number;
+    riskKeywords?: string[];
+    rubrics?: OutcomeQualityGateRubric[];
+}
+export interface OutcomeContextInjection {
+    field: string;
+    label: string;
+    required?: boolean;
+    example?: string;
+}
+export interface OutcomeTemplate {
+    slug: string;
+    vertical: OutcomeVertical;
+    systemPrompt: string;
+    inputs: OutcomeInputDefinition[];
+    outputFormat: string;
+    need: string;
+    capability: CapabilityTier;
+    spendCaps: OutcomeSpendCaps;
+    promptVersion: string;
+    contextInjection?: OutcomeContextInjection[];
+    blockedOrigins?: string[];
+    premiumAgent?: string;
+    disclaimer?: string;
+    qualityGate?: OutcomeQualityGateConfig;
+}
+export interface OutcomeExecutionContext {
+    scope: SpendScope;
+    customerId?: string;
+    posture?: string;
+    budgetTier?: string;
+    imageCapable?: boolean;
+    context?: Record<string, string>;
+    reviewerCascadeAuto?: boolean;
+}
+export interface OutcomeModelRequest {
+    role: OutcomeRole;
+    model: string;
+    vertical: string;
+    outcome: string;
+    promptVersion: string;
+    systemPrompt: string;
+    userPrompt: string;
+    outputFormat: string;
+    metadata: Record<string, string | number | boolean>;
+}
+export interface OutcomeModelResponse {
+    text: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    costCents?: number;
+    qualityScore?: number;
+    confidence?: number;
+    verdict?: string;
+    durationMs?: number;
+    provenance?: Record<string, string | number | boolean>;
+}
+export interface OutcomeModelRunner {
+    run(request: OutcomeModelRequest): Promise<OutcomeModelResponse>;
+}
+export interface OutcomeDecisionLink {
+    role: OutcomeRole;
+    decisionId: string;
+    entryHash?: string;
+    modelRequested: string;
+    modelResolved: string;
+    projectedCents: number;
+    actualCents: number;
+    inputTokens: number;
+    outputTokens: number;
+}
+export interface OutcomeRuntimeReceipt {
+    receiptId: string;
+    timestamp: string;
+    vertical: string;
+    outcome: string;
+    promptVersion: string;
+    customerId?: string;
+    scopeKey: string;
+    status: OutcomeStatus;
+    drafter: {
+        model: string;
+        decisionId?: string;
+        costCents: number;
+        inputTokens: number;
+        outputTokens: number;
+    };
+    reviewer: {
+        model: string;
+        decisionId?: string;
+        costCents: number;
+        inputTokens: number;
+        outputTokens: number;
+        verdict: string;
+    } | null;
+    fallback: {
+        model: string;
+        decisionId?: string;
+        reason: string;
+    } | null;
+    triggerFired: string[];
+    qualityScore: number;
+    pass: boolean;
+    totalCostCents: number;
+    durationMs: number;
+    decisionLinks: OutcomeDecisionLink[];
+    metadata: {
+        need: string;
+        capability: CapabilityTier;
+        posture: string;
+        budgetTier: string;
+        blockedOrigins: string[];
+        provenance: Record<string, string | number | boolean>;
+    };
+}
+export interface OutcomeReceiptStore {
+    append(receipt: OutcomeRuntimeReceipt): Promise<void>;
+    readAll(): Promise<OutcomeRuntimeReceipt[]>;
+}
+export declare class InMemoryOutcomeReceiptStore implements OutcomeReceiptStore {
+    private readonly receipts;
+    append(receipt: OutcomeRuntimeReceipt): Promise<void>;
+    readAll(): Promise<OutcomeRuntimeReceipt[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/outcomes/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/outcomes/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAExE,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,MAAM,CAAC;AACvG,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAC9D,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,gBAAgB,CAAC;AAElF,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,wBAAwB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,cAAc,CAAC;IAC3B,SAAS,EAAE,gBAAgB,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAC7C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,wBAAwB,CAAC;CACxC;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,IAAI,CAAC;IACT,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,IAAI,CAAC;IACT,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,cAAc,CAAC;QAC3B,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;KACvD,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC;CAC7C;AAED,qBAAa,2BAA4B,YAAW,mBAAmB;IACrE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;IAElD,MAAM,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD,OAAO,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;CAGlD"}

package/dist/outcomes/types.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryOutcomeReceiptStore = void 0;
+class InMemoryOutcomeReceiptStore {
+    receipts = [];
+    async append(receipt) {
+        this.receipts.push(receipt);
+    }
+    async readAll() {
+        return [...this.receipts];
+    }
+}
+exports.InMemoryOutcomeReceiptStore = InMemoryOutcomeReceiptStore;
+//# sourceMappingURL=types.js.map

package/dist/outcomes/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/outcomes/types.ts"],"names":[],"mappings":";;;AA4JA,MAAa,2BAA2B;IACrB,QAAQ,GAA4B,EAAE,CAAC;IAExD,KAAK,CAAC,MAAM,CAAC,OAA8B;QACzC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,OAAO;QACX,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;CACF;AAVD,kEAUC"}

package/dist/spend-guard.d.ts

@@ -129,6 +129,10 @@ export declare class SpendGuard {
     private signAndAppendDecision;
     private rememberReservation;
     private buildSettlementDecision;
+    recordOutcomeReceipt(outcomeReceipt: Record<string, unknown>): Promise<{
+        decision: SpendDecision;
+        signed: SignedDecisionLogEntry | null;
+    }>;
     private getSignerFingerprint;
     private refreshChainHead;
     private withDecisionLock;

package/dist/spend-guard.d.ts.map

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

package/dist/spend-guard.js

@@ -203,6 +203,36 @@ class SpendGuard {
             partial: args.partial,
         };
     }
+    async recordOutcomeReceipt(outcomeReceipt) {
+        const projectedCents = safeReceiptNumber(outcomeReceipt.totalCostCents);
+        const decision = {
+            decisionId: (0, crypto_1.randomUUID)(),
+            timestamp: new Date().toISOString(),
+            action: 'allow',
+            triggeredCap: null,
+            triggeredScopeKey: null,
+            projectedCents,
+            windowSpendBefore: 0,
+            windowSpendAfter: projectedCents,
+            provider: 'unknown',
+            modelRequested: 'outcome-runtime',
+            modelResolved: 'outcome-runtime',
+            policyId: this.config.policy.id,
+            policyVersion: this.config.policy.version,
+            enforcementMode: this.config.policy.mode,
+            reasons: ['Outcome runtime metadata receipt recorded locally'],
+            entryType: 'outcome',
+            outcomeReceipt: sanitizeOutcomeReceipt(outcomeReceipt),
+        };
+        const result = await this.withDecisionLock(async () => {
+            const signed = await this.signAndAppendDecision(decision);
+            return { decision, signed };
+        });
+        if (this.config.onDecision) {
+            await this.config.onDecision(result.decision, result.signed);
+        }
+        return result;
+    }
     getSignerFingerprint() {
         return this.config.signingKeys
             ? (0, decision_log_1.computeSignerFingerprint)(this.config.signingKeys.publicKey)
@@ -439,6 +469,29 @@ async function withManagedOpenRouterAuth(params, guard, client) {
         },
     };
 }
+function safeReceiptNumber(value) {
+    return Number.isSafeInteger(value) && value >= 0 ? value : 0;
+}
+function sanitizeOutcomeReceipt(value) {
+    assertNoOutcomeContent(value);
+    return JSON.parse(JSON.stringify(value));
+}
+function assertNoOutcomeContent(value, path = 'outcomeReceipt') {
+    if (value == null)
+        return;
+    if (Array.isArray(value)) {
+        value.forEach((child, index) => assertNoOutcomeContent(child, path + '[' + index + ']'));
+        return;
+    }
+    if (typeof value !== 'object')
+        return;
+    for (const [key, child] of Object.entries(value)) {
+        if (/^(prompt|completion|content|messages|input|output|text|raw)$/i.test(key)) {
+            throw new Error('Outcome receipt metadata cannot include data-plane field: ' + path + '.' + key);
+        }
+        assertNoOutcomeContent(child, path + '.' + key);
+    }
+}
 function resolveClientBaseUrl(client) {
     const obj = client;
     const direct = obj?.baseURL ?? obj?.baseUrl;