@agentguard-run/spend 0.6.1 → 0.8.0

package/src/outcomes/types.ts

@@ -0,0 +1,167 @@
+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 class InMemoryOutcomeReceiptStore implements OutcomeReceiptStore {
+  private readonly receipts: OutcomeRuntimeReceipt[] = [];
+
+  async append(receipt: OutcomeRuntimeReceipt): Promise<void> {
+    this.receipts.push(receipt);
+  }
+
+  async readAll(): Promise<OutcomeRuntimeReceipt[]> {
+    return [...this.receipts];
+  }
+}