@company-semantics/contracts 9.0.0 → 9.2.0

package/src/usage/execution-types.ts

@@ -4,105 +4,105 @@
  * See PRD-00200 for design rationale and invariants.
  */
 
-import type { ChatRuntimeProfile } from '../chat/runtime-profile'
+import type { ChatRuntimeProfile } from "../chat/runtime-profile";
 
 export type ExecutionFailureReason =
-  | 'tool_error'
-  | 'timeout'
-  | 'model_error'
-  | 'budget_exceeded'
-  | 'client_disconnect'
-  | 'unknown'
+  | "tool_error"
+  | "timeout"
+  | "model_error"
+  | "budget_exceeded"
+  | "client_disconnect"
+  | "unknown";
 
 // @vocabulary-exempt reason: telemetry row is a single DB-aligned record; splitting risks consumer breakage
 export interface RuntimeExecutionTelemetry {
-  executionId: string
-  orgId: string
-  chatId?: string
-  messageId?: string
-  profile: ChatRuntimeProfile
-  provider: string
-  model: string
-  stepCount: number
-  toolCallCount: number
-  tokensInput: number
-  tokensOutput: number
-  tokensTotal: number
-  costInputUsd: string   // 8 decimal places
-  costOutputUsd: string  // 8 decimal places
-  costTotalUsd: string   // 8 decimal places
-  durationMs: number
-  success: boolean
-  failureReason?: ExecutionFailureReason
-  createdAt: string // ISO 8601
+  executionId: string;
+  orgId: string;
+  chatId?: string;
+  messageId?: string;
+  profile: ChatRuntimeProfile;
+  provider: string;
+  model: string;
+  stepCount: number;
+  toolCallCount: number;
+  tokensInput: number;
+  tokensOutput: number;
+  tokensTotal: number;
+  costInputUsd: string; // 8 decimal places
+  costOutputUsd: string; // 8 decimal places
+  costTotalUsd: string; // 8 decimal places
+  durationMs: number;
+  success: boolean;
+  failureReason?: ExecutionFailureReason;
+  createdAt: string; // ISO 8601
 }
 
 // --- Aggregation response types (PRD-00201) ---
 
 export interface ProfileStats {
-  executions: number
-  percentOfTotal: number
-  avgDurationMs: number
-  totalCostUsd: string
-  avgCostPerExecution: string
-  failureRate: number
-  avgStepCount: number
-  avgToolCallCount: number
+  executions: number;
+  percentOfTotal: number;
+  avgDurationMs: number;
+  totalCostUsd: string;
+  avgCostPerExecution: string;
+  failureRate: number;
+  avgStepCount: number;
+  avgToolCallCount: number;
 }
 
 export interface OrgExecutionSummary {
-  dateRange: { start: string; end: string }
+  dateRange: { start: string; end: string };
   totals: {
-    executions: number
-    tokens: number
-    costUsd: string
-    avgDurationMs: number
-  }
-  byProfile: Record<ChatRuntimeProfile, ProfileStats>
+    executions: number;
+    tokens: number;
+    costUsd: string;
+    avgDurationMs: number;
+  };
+  byProfile: Record<ChatRuntimeProfile, ProfileStats>;
 }
 
 export interface DailyExecutionStats {
-  date: string // YYYY-MM-DD
-  executions: number
-  totalCostUsd: string
-  byProfile: Record<ChatRuntimeProfile, number>
+  date: string; // YYYY-MM-DD
+  executions: number;
+  totalCostUsd: string;
+  byProfile: Record<ChatRuntimeProfile, number>;
 }
 
 export interface ExecutionByUser {
-  userId: string
-  email: string
-  executions: number
-  totalCostUsd: string
-  favoriteProfile: ChatRuntimeProfile
+  userId: string;
+  email: string;
+  executions: number;
+  totalCostUsd: string;
+  favoriteProfile: ChatRuntimeProfile;
 }
 
 export interface ExecutionDetail {
-  execution: RuntimeExecutionTelemetry
+  execution: RuntimeExecutionTelemetry;
   llmCalls: Array<{
-    callId: string
-    model: string
-    provider: string
-    tokensInput: number
-    tokensOutput: number
-    costUsd: string
-    durationMs: number
-    toolCalls: number
-  }>
+    callId: string;
+    model: string;
+    provider: string;
+    tokensInput: number;
+    tokensOutput: number;
+    costUsd: string;
+    durationMs: number;
+    toolCalls: number;
+  }>;
 }
 
 // --- Budget governance types (PRD-00232) ---
 
 export interface BudgetCheck {
-  allowed: boolean
-  reason?: 'monthly_budget_exceeded' | 'approaching_limit'
-  remainingBudgetUsd?: string
-  usedThisMonthUsd?: string
+  allowed: boolean;
+  reason?: "monthly_budget_exceeded" | "approaching_limit";
+  remainingBudgetUsd?: string;
+  usedThisMonthUsd?: string;
 }
 
 export interface OrgBudgetSettings {
-  monthlyBudgetUsd: string | null
-  maxCostPerExecution: string | null
-  agenticMaxSteps: number | null
-  alertThresholdPct: number
-  enabled: boolean
+  monthlyBudgetUsd: string | null;
+  maxCostPerExecution: string | null;
+  agenticMaxSteps: number | null;
+  alertThresholdPct: number;
+  enabled: boolean;
 }

package/src/usage/types.ts

@@ -4,7 +4,12 @@
  * See PRD-00166 for design rationale and invariants.
  */
 
-export type AiFeature = 'chat' | 'chat_title' | 'ingest_summarize' | 'ingest_embedding' | 'company_md_extraction';
+export type AiFeature =
+  | "chat"
+  | "chat_title"
+  | "ingest_summarize"
+  | "ingest_embedding"
+  | "company_md_extraction";
 
 export interface UsageSummary {
   totalTokens: number;
@@ -13,7 +18,7 @@ export interface UsageSummary {
   estimatedCostUsd: string;
   requestCount: number;
   periodStart: string; // UTC ISO8601
-  periodEnd: string;   // UTC ISO8601
+  periodEnd: string; // UTC ISO8601
 }
 
 export interface DailyUsage {
@@ -46,7 +51,6 @@ export interface UsageByUser {
   requestCount: number;
 }
 
-
 // ---------------------------------------------------------------------------
 // Unified Usage Response (PRD-00276/277)
 // ---------------------------------------------------------------------------