@company-semantics/contracts 9.1.0 → 9.2.0

package/src/message-parts/__tests__/confirmation.test.ts

@@ -1,110 +1,124 @@
-import { describe, it, expect } from 'vitest'
-import { WireSurfaceBuilder } from '../wire.js'
-import type { ConfirmationData, ConfirmationRiskLevel } from '../confirmation.js'
-import { CONFIRMATION_LABELS, getConfirmationLabel } from '../confirmation.js'
-import type { ExecutionKind } from '../../execution/kinds.js'
-import { EXECUTION_KINDS } from '../../execution/registry.js'
-
-describe('WireSurfaceBuilder.confirmation', () => {
-  it('creates a confirmation data part with new shape', () => {
+import { describe, it, expect } from "vitest";
+import { WireSurfaceBuilder } from "../wire.js";
+import type {
+  ConfirmationData,
+  ConfirmationRiskLevel,
+} from "../confirmation.js";
+import { CONFIRMATION_LABELS, getConfirmationLabel } from "../confirmation.js";
+import type { ExecutionKind } from "../../execution/kinds.js";
+import { EXECUTION_KINDS } from "../../execution/registry.js";
+
+describe("WireSurfaceBuilder.confirmation", () => {
+  it("creates a confirmation data part with new shape", () => {
     const data: ConfirmationData = {
-      actionId: 'msg-123',
-      executorKind: 'slack.send',
-      risk: 'low',
-      executionId: 'exec-abc-001',
-    }
+      actionId: "msg-123",
+      executorKind: "slack.send",
+      risk: "low",
+      executionId: "exec-abc-001",
+    };
 
-    const result = WireSurfaceBuilder.confirmation(data)
+    const result = WireSurfaceBuilder.confirmation(data);
 
-    expect(result.type).toBe('data-confirmation')
-    expect(result.data).toEqual(data)
-  })
+    expect(result.type).toBe("data-confirmation");
+    expect(result.data).toEqual(data);
+  });
 
-  it('preserves actionId exactly', () => {
+  it("preserves actionId exactly", () => {
     const data: ConfirmationData = {
-      actionId: 'complex-action-id-12345',
-      executorKind: 'integration.connect',
-      risk: 'moderate',
-      executionId: 'exec-xyz-789',
-    }
+      actionId: "complex-action-id-12345",
+      executorKind: "integration.connect",
+      risk: "moderate",
+      executionId: "exec-xyz-789",
+    };
 
-    const result = WireSurfaceBuilder.confirmation(data)
+    const result = WireSurfaceBuilder.confirmation(data);
 
-    expect(result.data.actionId).toBe('complex-action-id-12345')
-  })
+    expect(result.data.actionId).toBe("complex-action-id-12345");
+  });
 
-  it('preserves all ConfirmationRiskLevel values', () => {
-    const risks: ConfirmationRiskLevel[] = ['low', 'moderate', 'high', 'irreversible']
+  it("preserves all ConfirmationRiskLevel values", () => {
+    const risks: ConfirmationRiskLevel[] = [
+      "low",
+      "moderate",
+      "high",
+      "irreversible",
+    ];
 
     for (const risk of risks) {
       const data: ConfirmationData = {
         actionId: `risk-${risk}`,
-        executorKind: 'profile.update',
+        executorKind: "profile.update",
         risk,
         executionId: `exec-risk-${risk}`,
-      }
+      };
 
-      const result = WireSurfaceBuilder.confirmation(data)
+      const result = WireSurfaceBuilder.confirmation(data);
 
-      expect(result.data.risk).toBe(risk)
+      expect(result.data.risk).toBe(risk);
     }
-  })
+  });
 
-  it('preserves executionId and executorKind', () => {
+  it("preserves executionId and executorKind", () => {
     const data: ConfirmationData = {
-      actionId: 'action-001',
-      executorKind: 'integration.disconnect',
-      risk: 'high',
-      executionId: 'exec-lifecycle-001',
-    }
-
-    const result = WireSurfaceBuilder.confirmation(data)
-
-    expect(result.data.executionId).toBe('exec-lifecycle-001')
-    expect(result.data.executorKind).toBe('integration.disconnect')
-  })
-})
-
-describe('getConfirmationLabel', () => {
-  it('returns correct label for known ExecutionKind', () => {
-    expect(getConfirmationLabel('integration.connect')).toBe('Connect Integration')
-    expect(getConfirmationLabel('integration.disconnect')).toBe('Disconnect Integration')
-    expect(getConfirmationLabel('profile.update')).toBe('Update Profile')
-    expect(getConfirmationLabel('slack.send')).toBe('Send Slack Message')
-    expect(getConfirmationLabel('data.ingest')).toBe('Import Channel')
-    expect(getConfirmationLabel('data.scope')).toBe('Update Scope')
-    expect(getConfirmationLabel('system.cleanup')).toBe('Cleanup Connections')
-  })
-
-  it('returns default fallback for undefined', () => {
-    expect(getConfirmationLabel(undefined)).toBe('Confirm Action')
-  })
-
-  it('returns custom fallback title when provided', () => {
-    expect(getConfirmationLabel(undefined, 'Custom Fallback')).toBe('Custom Fallback')
-  })
-})
-
-describe('CONFIRMATION_LABELS', () => {
-  it('has an entry for every ExecutionKind', () => {
-    const executionKinds = Object.keys(EXECUTION_KINDS) as ExecutionKind[]
+      actionId: "action-001",
+      executorKind: "integration.disconnect",
+      risk: "high",
+      executionId: "exec-lifecycle-001",
+    };
+
+    const result = WireSurfaceBuilder.confirmation(data);
+
+    expect(result.data.executionId).toBe("exec-lifecycle-001");
+    expect(result.data.executorKind).toBe("integration.disconnect");
+  });
+});
+
+describe("getConfirmationLabel", () => {
+  it("returns correct label for known ExecutionKind", () => {
+    expect(getConfirmationLabel("integration.connect")).toBe(
+      "Connect Integration",
+    );
+    expect(getConfirmationLabel("integration.disconnect")).toBe(
+      "Disconnect Integration",
+    );
+    expect(getConfirmationLabel("profile.update")).toBe("Update Profile");
+    expect(getConfirmationLabel("slack.send")).toBe("Send Slack Message");
+    expect(getConfirmationLabel("data.ingest")).toBe("Import Channel");
+    expect(getConfirmationLabel("data.scope")).toBe("Update Scope");
+    expect(getConfirmationLabel("system.cleanup")).toBe("Cleanup Connections");
+  });
+
+  it("returns default fallback for undefined", () => {
+    expect(getConfirmationLabel(undefined)).toBe("Confirm Action");
+  });
+
+  it("returns custom fallback title when provided", () => {
+    expect(getConfirmationLabel(undefined, "Custom Fallback")).toBe(
+      "Custom Fallback",
+    );
+  });
+});
+
+describe("CONFIRMATION_LABELS", () => {
+  it("has an entry for every ExecutionKind", () => {
+    const executionKinds = Object.keys(EXECUTION_KINDS) as ExecutionKind[];
 
     for (const kind of executionKinds) {
-      expect(CONFIRMATION_LABELS[kind]).toBeDefined()
-      expect(typeof CONFIRMATION_LABELS[kind]).toBe('string')
-      expect(CONFIRMATION_LABELS[kind].length).toBeGreaterThan(0)
+      expect(CONFIRMATION_LABELS[kind]).toBeDefined();
+      expect(typeof CONFIRMATION_LABELS[kind]).toBe("string");
+      expect(CONFIRMATION_LABELS[kind].length).toBeGreaterThan(0);
     }
-  })
+  });
 
-  it('values are exact and stable (golden snapshot)', () => {
+  it("values are exact and stable (golden snapshot)", () => {
     expect(CONFIRMATION_LABELS).toStrictEqual({
-      'integration.connect': 'Connect Integration',
-      'integration.disconnect': 'Disconnect Integration',
-      'profile.update': 'Update Profile',
-      'slack.send': 'Send Slack Message',
-      'data.ingest': 'Import Channel',
-      'data.scope': 'Update Scope',
-      'system.cleanup': 'Cleanup Connections',
-    })
-  })
-})
+      "integration.connect": "Connect Integration",
+      "integration.disconnect": "Disconnect Integration",
+      "profile.update": "Update Profile",
+      "slack.send": "Send Slack Message",
+      "data.ingest": "Import Channel",
+      "data.scope": "Update Scope",
+      "system.cleanup": "Cleanup Connections",
+    });
+  });
+});

package/src/message-parts/__tests__/preview.test.ts

@@ -1,97 +1,97 @@
-import { describe, it, expect } from 'vitest'
-import { WireSurfaceBuilder } from '../wire.js'
-import type { PreviewData, PreviewArtifact } from '../preview.js'
+import { describe, it, expect } from "vitest";
+import { WireSurfaceBuilder } from "../wire.js";
+import type { PreviewData, PreviewArtifact } from "../preview.js";
 
-describe('WireSurfaceBuilder.preview', () => {
-  it('creates a preview data part', () => {
+describe("WireSurfaceBuilder.preview", () => {
+  it("creates a preview data part", () => {
     const data: PreviewData = {
-      actionId: 'msg-123',
-      title: 'Send Slack message to #sales',
-      description: 'This will notify the sales team about the new pricing.',
+      actionId: "msg-123",
+      title: "Send Slack message to #sales",
+      description: "This will notify the sales team about the new pricing.",
       artifacts: [
         {
-          kind: 'message',
-          label: '#sales',
+          kind: "message",
+          label: "#sales",
           content: {
-            channel: 'C123456',
-            text: 'New pricing is live!',
+            channel: "C123456",
+            text: "New pricing is live!",
           },
         },
       ],
-    }
+    };
 
-    const result = WireSurfaceBuilder.preview(data)
+    const result = WireSurfaceBuilder.preview(data);
 
-    expect(result.type).toBe('data-preview')
-    expect(result.data).toEqual(data)
-  })
+    expect(result.type).toBe("data-preview");
+    expect(result.data).toEqual(data);
+  });
 
-  it('preserves artifact structure exactly', () => {
+  it("preserves artifact structure exactly", () => {
     const artifacts: PreviewArtifact[] = [
       {
-        kind: 'api_call',
-        label: 'POST /api/notify',
-        content: { method: 'POST', body: { message: 'test' } },
-        metadata: { target: 'internal-api', impact: 'low' },
+        kind: "api_call",
+        label: "POST /api/notify",
+        content: { method: "POST", body: { message: "test" } },
+        metadata: { target: "internal-api", impact: "low" },
       },
       {
-        kind: 'notification',
-        label: 'Email to team@example.com',
-        content: { to: 'team@example.com', subject: 'Update' },
+        kind: "notification",
+        label: "Email to team@example.com",
+        content: { to: "team@example.com", subject: "Update" },
       },
-    ]
+    ];
 
     const data: PreviewData = {
-      actionId: 'multi-123',
-      title: 'Multi-step action',
+      actionId: "multi-123",
+      title: "Multi-step action",
       artifacts,
-    }
+    };
 
-    const result = WireSurfaceBuilder.preview(data)
+    const result = WireSurfaceBuilder.preview(data);
 
-    expect(result.data.artifacts).toEqual(artifacts)
-    expect(result.data.artifacts[0].metadata?.impact).toBe('low')
-  })
+    expect(result.data.artifacts).toEqual(artifacts);
+    expect(result.data.artifacts[0].metadata?.impact).toBe("low");
+  });
 
-  it('handles empty artifacts array', () => {
+  it("handles empty artifacts array", () => {
     const data: PreviewData = {
-      actionId: 'empty-preview',
-      title: 'No actions preview',
+      actionId: "empty-preview",
+      title: "No actions preview",
       artifacts: [],
-    }
+    };
 
-    const result = WireSurfaceBuilder.preview(data)
+    const result = WireSurfaceBuilder.preview(data);
 
-    expect(result.type).toBe('data-preview')
-    expect(result.data.artifacts).toEqual([])
-  })
+    expect(result.type).toBe("data-preview");
+    expect(result.data.artifacts).toEqual([]);
+  });
 
-  it('preserves all artifact kinds', () => {
+  it("preserves all artifact kinds", () => {
     const allKinds: PreviewArtifact[] = [
-      { kind: 'message', label: 'Slack message', content: {} },
-      { kind: 'api_call', label: 'API call', content: {} },
-      { kind: 'diff', label: 'File change', content: {} },
-      { kind: 'notification', label: 'Notification', content: {} },
-      { kind: 'task', label: 'Task creation', content: {} },
-      { kind: 'calendar', label: 'Calendar event', content: {} },
-    ]
+      { kind: "message", label: "Slack message", content: {} },
+      { kind: "api_call", label: "API call", content: {} },
+      { kind: "diff", label: "File change", content: {} },
+      { kind: "notification", label: "Notification", content: {} },
+      { kind: "task", label: "Task creation", content: {} },
+      { kind: "calendar", label: "Calendar event", content: {} },
+    ];
 
     const data: PreviewData = {
-      actionId: 'all-kinds',
-      title: 'All artifact kinds',
+      actionId: "all-kinds",
+      title: "All artifact kinds",
       artifacts: allKinds,
-    }
+    };
 
-    const result = WireSurfaceBuilder.preview(data)
+    const result = WireSurfaceBuilder.preview(data);
 
-    expect(result.data.artifacts).toHaveLength(6)
+    expect(result.data.artifacts).toHaveLength(6);
     expect(result.data.artifacts.map((a) => a.kind)).toEqual([
-      'message',
-      'api_call',
-      'diff',
-      'notification',
-      'task',
-      'calendar',
-    ])
-  })
-})
+      "message",
+      "api_call",
+      "diff",
+      "notification",
+      "task",
+      "calendar",
+    ]);
+  });
+});

package/src/message-parts/__tests__/wire.test.ts

@@ -1,127 +1,133 @@
-import { describe, it, expect } from 'vitest'
-import { WireSurfaceBuilder } from '../wire.js'
-import type { ExecutionResultData } from '../execution.js'
-import type { UndoResultData } from '../execution.js'
-
-describe('WireSurfaceBuilder.toolList', () => {
-  it('returns data part with type data-tool-list', () => {
-    const tools = [{ name: 'search', description: 'Search tool', inputSchema: {} }] as any
-    const result = WireSurfaceBuilder.toolList(tools)
-    expect(result.type).toBe('data-tool-list')
-  })
-
-  it('data.tools matches input array exactly', () => {
+import { describe, it, expect } from "vitest";
+import { WireSurfaceBuilder } from "../wire.js";
+import type { ExecutionResultData } from "../execution.js";
+import type { UndoResultData } from "../execution.js";
+
+describe("WireSurfaceBuilder.toolList", () => {
+  it("returns data part with type data-tool-list", () => {
+    const tools = [
+      { name: "search", description: "Search tool", inputSchema: {} },
+    ] as any;
+    const result = WireSurfaceBuilder.toolList(tools);
+    expect(result.type).toBe("data-tool-list");
+  });
+
+  it("data.tools matches input array exactly", () => {
     const tools = [
-      { name: 'search', description: 'Search tool', inputSchema: {} },
-      { name: 'fetch', description: 'Fetch tool', inputSchema: { type: 'object' } },
-    ] as any
-    const result = WireSurfaceBuilder.toolList(tools)
-    expect(result.data.tools).toEqual(tools)
-  })
-
-  it('works with empty tools array', () => {
-    const result = WireSurfaceBuilder.toolList([])
-    expect(result.type).toBe('data-tool-list')
-    expect(result.data.tools).toEqual([])
-  })
-})
-
-describe('WireSurfaceBuilder.executionResult', () => {
+      { name: "search", description: "Search tool", inputSchema: {} },
+      {
+        name: "fetch",
+        description: "Fetch tool",
+        inputSchema: { type: "object" },
+      },
+    ] as any;
+    const result = WireSurfaceBuilder.toolList(tools);
+    expect(result.data.tools).toEqual(tools);
+  });
+
+  it("works with empty tools array", () => {
+    const result = WireSurfaceBuilder.toolList([]);
+    expect(result.type).toBe("data-tool-list");
+    expect(result.data.tools).toEqual([]);
+  });
+});
+
+describe("WireSurfaceBuilder.executionResult", () => {
   const data: ExecutionResultData = {
-    actionId: 'act-1',
-    executionId: 'exec-001',
-    state: 'completed',
-    artifacts: [{ kind: 'profile_name', label: 'Name', status: 'success' }],
-    summary: { title: 'Profile Updated' },
-  }
-
-  it('returns data part with type data-execution-result', () => {
-    const result = WireSurfaceBuilder.executionResult(data)
-    expect(result.type).toBe('data-execution-result')
-  })
-
-  it('data matches input ExecutionResultData exactly', () => {
-    const result = WireSurfaceBuilder.executionResult(data)
-    expect(result.data).toEqual(data)
-  })
-
-  it('preserves actionId from input', () => {
-    const result = WireSurfaceBuilder.executionResult(data)
-    expect(result.data.actionId).toBe('act-1')
-  })
-})
-
-describe('WireSurfaceBuilder.undoResult', () => {
+    actionId: "act-1",
+    executionId: "exec-001",
+    state: "completed",
+    artifacts: [{ kind: "profile_name", label: "Name", status: "success" }],
+    summary: { title: "Profile Updated" },
+  };
+
+  it("returns data part with type data-execution-result", () => {
+    const result = WireSurfaceBuilder.executionResult(data);
+    expect(result.type).toBe("data-execution-result");
+  });
+
+  it("data matches input ExecutionResultData exactly", () => {
+    const result = WireSurfaceBuilder.executionResult(data);
+    expect(result.data).toEqual(data);
+  });
+
+  it("preserves actionId from input", () => {
+    const result = WireSurfaceBuilder.executionResult(data);
+    expect(result.data.actionId).toBe("act-1");
+  });
+});
+
+describe("WireSurfaceBuilder.undoResult", () => {
   const data: UndoResultData = {
-    actionId: 'act-1',
-    executionId: 'exec-001',
-    undoExecutionId: 'undo-exec-002',
-    status: 'success',
-  }
-
-  it('returns data part with type data-undo-result', () => {
-    const result = WireSurfaceBuilder.undoResult(data)
-    expect(result.type).toBe('data-undo-result')
-  })
-
-  it('data matches input UndoResultData exactly', () => {
-    const result = WireSurfaceBuilder.undoResult(data)
-    expect(result.data).toEqual(data)
-  })
-
-  it('preserves undoExecutionId from input', () => {
-    const result = WireSurfaceBuilder.undoResult(data)
-    expect(result.data.undoExecutionId).toBe('undo-exec-002')
-  })
-})
-
-describe('WireSurfaceBuilder.messageStart', () => {
-  it('returns data part with type data-message-start', () => {
-    const result = WireSurfaceBuilder.messageStart('msg-123')
-    expect(result.type).toBe('data-message-start')
-  })
-
-  it('data.messageId matches input', () => {
-    const result = WireSurfaceBuilder.messageStart('msg-456')
-    expect(result.data.messageId).toBe('msg-456')
-  })
-
-  it('data.version is 1', () => {
-    const result = WireSurfaceBuilder.messageStart('msg-789')
-    expect(result.data.version).toBe(1)
-  })
-
-  it('data.timestamp is a valid ISO 8601 string', () => {
-    const result = WireSurfaceBuilder.messageStart('msg-ts')
-    const parsed = new Date(result.data.timestamp)
-    expect(parsed.toISOString()).toBe(result.data.timestamp)
-  })
-})
-
-describe('WireSurfaceBuilder.messageComplete', () => {
-  it('returns data part with type data-message-complete', () => {
-    const result = WireSurfaceBuilder.messageComplete('msg-123', 500)
-    expect(result.type).toBe('data-message-complete')
-  })
-
-  it('data.messageId matches input', () => {
-    const result = WireSurfaceBuilder.messageComplete('msg-456', 200)
-    expect(result.data.messageId).toBe('msg-456')
-  })
-
-  it('data.narrativeLength matches input', () => {
-    const result = WireSurfaceBuilder.messageComplete('msg-789', 1234)
-    expect(result.data.narrativeLength).toBe(1234)
-  })
-
-  it('data.version is 1', () => {
-    const result = WireSurfaceBuilder.messageComplete('msg-v', 100)
-    expect(result.data.version).toBe(1)
-  })
-
-  it('data.timestamp is a valid ISO 8601 string', () => {
-    const result = WireSurfaceBuilder.messageComplete('msg-ts', 300)
-    const parsed = new Date(result.data.timestamp)
-    expect(parsed.toISOString()).toBe(result.data.timestamp)
-  })
-})
+    actionId: "act-1",
+    executionId: "exec-001",
+    undoExecutionId: "undo-exec-002",
+    status: "success",
+  };
+
+  it("returns data part with type data-undo-result", () => {
+    const result = WireSurfaceBuilder.undoResult(data);
+    expect(result.type).toBe("data-undo-result");
+  });
+
+  it("data matches input UndoResultData exactly", () => {
+    const result = WireSurfaceBuilder.undoResult(data);
+    expect(result.data).toEqual(data);
+  });
+
+  it("preserves undoExecutionId from input", () => {
+    const result = WireSurfaceBuilder.undoResult(data);
+    expect(result.data.undoExecutionId).toBe("undo-exec-002");
+  });
+});
+
+describe("WireSurfaceBuilder.messageStart", () => {
+  it("returns data part with type data-message-start", () => {
+    const result = WireSurfaceBuilder.messageStart("msg-123");
+    expect(result.type).toBe("data-message-start");
+  });
+
+  it("data.messageId matches input", () => {
+    const result = WireSurfaceBuilder.messageStart("msg-456");
+    expect(result.data.messageId).toBe("msg-456");
+  });
+
+  it("data.version is 1", () => {
+    const result = WireSurfaceBuilder.messageStart("msg-789");
+    expect(result.data.version).toBe(1);
+  });
+
+  it("data.timestamp is a valid ISO 8601 string", () => {
+    const result = WireSurfaceBuilder.messageStart("msg-ts");
+    const parsed = new Date(result.data.timestamp);
+    expect(parsed.toISOString()).toBe(result.data.timestamp);
+  });
+});
+
+describe("WireSurfaceBuilder.messageComplete", () => {
+  it("returns data part with type data-message-complete", () => {
+    const result = WireSurfaceBuilder.messageComplete("msg-123", 500);
+    expect(result.type).toBe("data-message-complete");
+  });
+
+  it("data.messageId matches input", () => {
+    const result = WireSurfaceBuilder.messageComplete("msg-456", 200);
+    expect(result.data.messageId).toBe("msg-456");
+  });
+
+  it("data.narrativeLength matches input", () => {
+    const result = WireSurfaceBuilder.messageComplete("msg-789", 1234);
+    expect(result.data.narrativeLength).toBe(1234);
+  });
+
+  it("data.version is 1", () => {
+    const result = WireSurfaceBuilder.messageComplete("msg-v", 100);
+    expect(result.data.version).toBe(1);
+  });
+
+  it("data.timestamp is a valid ISO 8601 string", () => {
+    const result = WireSurfaceBuilder.messageComplete("msg-ts", 300);
+    const parsed = new Date(result.data.timestamp);
+    expect(parsed.toISOString()).toBe(result.data.timestamp);
+  });
+});