@company-semantics/contracts 0.79.0 → 0.81.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "0.79.0",
+  "version": "0.81.0",
   "private": false,
   "repository": {
     "type": "git",

package/src/index.ts

@@ -483,4 +483,13 @@ export type {
 export type {
   ExecutionFailureReason,
   RuntimeExecutionTelemetry,
+  // Aggregation response types (PRD-00201)
+  ProfileStats,
+  OrgExecutionSummary,
+  DailyExecutionStats,
+  ExecutionByUser,
+  ExecutionDetail,
+  // Budget governance types (PRD-00232)
+  BudgetCheck,
+  OrgBudgetSettings,
 } from './usage/execution-types'

package/src/usage/execution-types.ts

@@ -14,6 +14,7 @@ export type ExecutionFailureReason =
   | '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
@@ -35,3 +36,73 @@ export interface RuntimeExecutionTelemetry {
   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
+}
+
+export interface OrgExecutionSummary {
+  dateRange: { start: string; end: string }
+  totals: {
+    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>
+}
+
+export interface ExecutionByUser {
+  userId: string
+  email: string
+  executions: number
+  totalCostUsd: string
+  favoriteProfile: ChatRuntimeProfile
+}
+
+export interface ExecutionDetail {
+  execution: RuntimeExecutionTelemetry
+  llmCalls: Array<{
+    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
+}
+
+export interface OrgBudgetSettings {
+  monthlyBudgetUsd: string | null
+  maxCostPerExecution: string | null
+  agenticMaxSteps: number | null
+  alertThresholdPct: number
+  enabled: boolean
+}