@company-semantics/contracts 0.63.0 → 0.64.0

package/package.json

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

package/src/index.ts

@@ -414,3 +414,15 @@ export type {
 } from './impersonation'
 
 export { RESTRICTED_IMPERSONATION_ACTIONS } from './impersonation'
+
+// Usage tracking types (internal admin)
+// @see PRD-00166 for design rationale
+export type {
+  AiFeature,
+  UsageSummary,
+  DailyUsage,
+  UsageByModel,
+  UsageByFeature,
+  UsageByUser,
+  OrgUsageResponse,
+} from './usage/types'

package/src/usage/types.ts

@@ -0,0 +1,55 @@
+/**
+ * AI Usage Tracking Types (v1)
+ * Internal admin usage visibility. Not org-facing in v1.
+ * See PRD-00166 for design rationale and invariants.
+ */
+
+export type AiFeature = 'chat' | 'chat_title' | 'ingest_summarize' | 'ingest_embedding';
+
+export interface UsageSummary {
+  totalTokens: number;
+  totalInputTokens: number;
+  totalOutputTokens: number;
+  estimatedCostUsd: string;
+  requestCount: number;
+  periodStart: string; // UTC ISO8601
+  periodEnd: string;   // UTC ISO8601
+}
+
+export interface DailyUsage {
+  date: string; // YYYY-MM-DD
+  totalTokens: number;
+  estimatedCostUsd: string;
+  requestCount: number;
+}
+
+export interface UsageByModel {
+  model: string;
+  provider: string;
+  totalTokens: number;
+  estimatedCostUsd: string;
+  requestCount: number;
+}
+
+export interface UsageByFeature {
+  feature: AiFeature;
+  totalTokens: number;
+  estimatedCostUsd: string;
+  requestCount: number;
+}
+
+export interface UsageByUser {
+  userId: string;
+  email: string;
+  totalTokens: number;
+  estimatedCostUsd: string;
+  requestCount: number;
+}
+
+export interface OrgUsageResponse {
+  summary: UsageSummary;
+  daily: DailyUsage[];
+  byModel: UsageByModel[];
+  byFeature: UsageByFeature[];
+  topUsers: UsageByUser[];
+}