@company-semantics/contracts 0.78.0 → 0.79.0

package/package.json

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

package/src/index.ts

@@ -477,3 +477,10 @@ export type {
   UsageByUser,
   OrgUsageResponse,
 } from './usage/types'
+
+// Runtime execution telemetry types
+// @see PRD-00200 for design rationale
+export type {
+  ExecutionFailureReason,
+  RuntimeExecutionTelemetry,
+} from './usage/execution-types'

package/src/usage/execution-types.ts

@@ -0,0 +1,37 @@
+/**
+ * Runtime Execution Telemetry Types
+ * One execution = one user message -> full assistant response (including tool loops).
+ * See PRD-00200 for design rationale and invariants.
+ */
+
+import type { ChatRuntimeProfile } from '../chat/runtime-profile'
+
+export type ExecutionFailureReason =
+  | 'tool_error'
+  | 'timeout'
+  | 'model_error'
+  | 'budget_exceeded'
+  | 'client_disconnect'
+  | 'unknown'
+
+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
+}