@company-semantics/contracts 9.1.0 → 9.2.0

package/src/message-parts/types.ts

@@ -13,9 +13,9 @@
  * @see decisions/ADR-CONT-026.md for design rationale
  */
 
-import type { ToolListMessagePart } from '../mcp/index'
-import type { PreviewPart } from './preview'
-import type { ConfirmationPart } from './confirmation'
+import type { ToolListMessagePart } from "../mcp/index";
+import type { PreviewPart } from "./preview";
+import type { ConfirmationPart } from "./confirmation";
 
 // =============================================================================
 // Narrative Parts (Streamable)
@@ -28,9 +28,9 @@ import type { ConfirmationPart } from './confirmation'
  * Design: Aligns with AI SDK's TextPart for interoperability.
  */
 export interface TextPart {
-  type: 'text'
+  type: "text";
   /** The text content (may be partial during streaming) */
-  text: string
+  text: string;
 }
 
 // =============================================================================
@@ -40,18 +40,18 @@ export interface TextPart {
 /**
  * Re-export ToolListMessagePart as ToolListPart for consistency.
  */
-export type ToolListPart = ToolListMessagePart
+export type ToolListPart = ToolListMessagePart;
 
 /**
  * Status panel surface part.
  * Displays system status, connection states, or progress indicators.
  */
 export interface StatusPanelPart {
-  type: 'status-panel'
+  type: "status-panel";
   /** Panel title */
-  title: string
+  title: string;
   /** Status entries */
-  entries: StatusPanelEntry[]
+  entries: StatusPanelEntry[];
 }
 
 /**
@@ -59,11 +59,11 @@ export interface StatusPanelPart {
  */
 export interface StatusPanelEntry {
   /** Entry label */
-  label: string
+  label: string;
   /** Current status */
-  status: 'ok' | 'warning' | 'error' | 'pending'
+  status: "ok" | "warning" | "error" | "pending";
   /** Optional detail text */
-  detail?: string
+  detail?: string;
 }
 
 /**
@@ -71,23 +71,23 @@ export interface StatusPanelEntry {
  * Renders a data visualization.
  */
 export interface ChartPart {
-  type: 'chart'
+  type: "chart";
   /** Chart type */
-  chartType: 'bar' | 'line' | 'pie' | 'area'
+  chartType: "bar" | "line" | "pie" | "area";
   /** Chart title */
-  title?: string
+  title?: string;
   /** Data points */
-  data: ChartDataPoint[]
+  data: ChartDataPoint[];
 }
 
 /**
  * Single data point for charts.
  */
 export interface ChartDataPoint {
-  label: string
-  value: number
+  label: string;
+  value: number;
   /** Optional color (CSS color string) */
-  color?: string
+  color?: string;
 }
 
 /**
@@ -95,13 +95,13 @@ export interface ChartDataPoint {
  * Renders tabular data.
  */
 export interface TablePart {
-  type: 'table'
+  type: "table";
   /** Table title */
-  title?: string
+  title?: string;
   /** Column headers */
-  headers: string[]
+  headers: string[];
   /** Row data (each row is an array of cell values) */
-  rows: string[][]
+  rows: string[][];
 }
 
 // =============================================================================
@@ -118,13 +118,13 @@ export type SurfacePart =
   | ChartPart
   | TablePart
   | ConfirmationPart
-  | PreviewPart
+  | PreviewPart;
 
 /**
  * All assistant message part types.
  * Union of narrative (text) and surface parts.
  */
-export type AssistantMessagePart = TextPart | SurfacePart
+export type AssistantMessagePart = TextPart | SurfacePart;
 
 // =============================================================================
 // Type Guards
@@ -134,12 +134,12 @@ export type AssistantMessagePart = TextPart | SurfacePart
  * Type guard for TextPart.
  */
 export function isTextPart(part: AssistantMessagePart): part is TextPart {
-  return part.type === 'text'
+  return part.type === "text";
 }
 
 /**
  * Type guard for SurfacePart.
  */
 export function isSurfacePart(part: AssistantMessagePart): part is SurfacePart {
-  return part.type !== 'text'
+  return part.type !== "text";
 }

package/src/message-parts/wire.ts

@@ -10,22 +10,19 @@
  * @see decisions/ADR-CONT-026.md for design rationale
  */
 
-import type { MCPToolDescriptor, ToolListDataPart } from '../mcp/index'
-import type { PreviewDataPart, PreviewData } from './preview'
-import type {
-  ConfirmationData,
-  ConfirmationDataPart,
-} from './confirmation'
+import type { MCPToolDescriptor, ToolListDataPart } from "../mcp/index";
+import type { PreviewDataPart, PreviewData } from "./preview";
+import type { ConfirmationData, ConfirmationDataPart } from "./confirmation";
 import type {
   ExecutionResultData,
   ExecutionResultDataPart,
   UndoResultData,
   UndoResultDataPart,
-} from './execution'
+} from "./execution";
 import type {
   MessageStartDataPart,
   MessageCompleteDataPart,
-} from './lifecycle'
+} from "./lifecycle";
 
 /**
  * Factory for creating wire-format surface parts.
@@ -48,9 +45,9 @@ export const WireSurfaceBuilder = {
    */
   toolList(tools: MCPToolDescriptor[]): ToolListDataPart {
     return {
-      type: 'data-tool-list',
+      type: "data-tool-list",
       data: { tools },
-    }
+    };
   },
 
   /**
@@ -67,9 +64,9 @@ export const WireSurfaceBuilder = {
    */
   preview(data: PreviewData): PreviewDataPart {
     return {
-      type: 'data-preview',
+      type: "data-preview",
       data,
-    }
+    };
   },
 
   /**
@@ -85,9 +82,9 @@ export const WireSurfaceBuilder = {
    */
   confirmation(data: ConfirmationData): ConfirmationDataPart {
     return {
-      type: 'data-confirmation',
+      type: "data-confirmation",
       data,
-    }
+    };
   },
 
   /**
@@ -104,9 +101,9 @@ export const WireSurfaceBuilder = {
    */
   executionResult(data: ExecutionResultData): ExecutionResultDataPart {
     return {
-      type: 'data-execution-result',
+      type: "data-execution-result",
       data,
-    }
+    };
   },
 
   /**
@@ -123,9 +120,9 @@ export const WireSurfaceBuilder = {
    */
   undoResult(data: UndoResultData): UndoResultDataPart {
     return {
-      type: 'data-undo-result',
+      type: "data-undo-result",
       data,
-    }
+    };
   },
 
   // =========================================================================
@@ -145,13 +142,13 @@ export const WireSurfaceBuilder = {
    */
   messageStart(messageId: string): MessageStartDataPart {
     return {
-      type: 'data-message-start',
+      type: "data-message-start",
       data: {
         version: 1,
         messageId,
         timestamp: new Date().toISOString(),
       },
-    }
+    };
   },
 
   /**
@@ -167,15 +164,18 @@ export const WireSurfaceBuilder = {
    * @param narrativeLength - Total length of streamed narrative text
    * @returns Wire-format message complete event
    */
-  messageComplete(messageId: string, narrativeLength: number): MessageCompleteDataPart {
+  messageComplete(
+    messageId: string,
+    narrativeLength: number,
+  ): MessageCompleteDataPart {
     return {
-      type: 'data-message-complete',
+      type: "data-message-complete",
       data: {
         version: 1,
         messageId,
         narrativeLength,
         timestamp: new Date().toISOString(),
       },
-    }
+    };
   },
-} as const
+} as const;

package/src/mutations.ts

@@ -1,4 +1,4 @@
-export type { MutationBehavior } from './requests';
+export type { MutationBehavior } from "./requests";
 
 export type MutationPolicy = {
   /**
@@ -9,5 +9,5 @@ export type MutationPolicy = {
    * parallel — independent mutations on different resourceIds may run concurrently;
    *            same-resource requests still serialize to avoid lost writes.
    */
-  behavior: 'collapse' | 'queue' | 'parallel';
+  behavior: "collapse" | "queue" | "parallel";
 };

package/src/observability.ts

@@ -1,16 +1,28 @@
-export const REQUEST_ID_HEADER = 'x-request-id';
+export const REQUEST_ID_HEADER = "x-request-id";
 
 export type Labels = Record<string, string>;
 export type MetricEnvelope =
-  | { kind: 'counter'; name: string; value: number; labels?: Labels; ts: number }
-  | { kind: 'gauge'; name: string; value: number; labels?: Labels; ts: number }
-  | { kind: 'histogram'; name: string; value: number; labels?: Labels; ts: number };
+  | {
+      kind: "counter";
+      name: string;
+      value: number;
+      labels?: Labels;
+      ts: number;
+    }
+  | { kind: "gauge"; name: string; value: number; labels?: Labels; ts: number }
+  | {
+      kind: "histogram";
+      name: string;
+      value: number;
+      labels?: Labels;
+      ts: number;
+    };
 
 export type SchedulerMetricName =
-  | 'scheduler.inflight_requests'
-  | 'scheduler.queue_depth'
-  | 'scheduler.queue_wait_ms'
-  | 'scheduler.dedupe_hits'
-  | 'scheduler.heap_used_bytes'
-  | 'scheduler.rss_bytes'
-  | 'scheduler.fetch_latency_ms';
+  | "scheduler.inflight_requests"
+  | "scheduler.queue_depth"
+  | "scheduler.queue_wait_ms"
+  | "scheduler.dedupe_hits"
+  | "scheduler.heap_used_bytes"
+  | "scheduler.rss_bytes"
+  | "scheduler.fetch_latency_ms";