@studio-foundation/contracts 0.3.0-beta.1

package/tests/types.test.ts

@@ -0,0 +1,101 @@
+// Type-level tests for @studio/contracts
+// These tests verify that types compile correctly
+
+import { describe, it, expect } from 'vitest';
+import type {
+  PipelineDefinition,
+  StageDefinition,
+  StageStatus,
+  AgentConfig,
+  ValidationResult,
+  ToolCallRequirements,
+  OutputContract,
+} from '../src/index.js';
+
+describe('contracts types', () => {
+  it('can create valid pipeline definition', () => {
+    const pipeline: PipelineDefinition = {
+      name: 'test-pipeline',
+      description: 'Test pipeline',
+      version: 1,
+      stages: [],
+    };
+    expect(pipeline.name).toBe('test-pipeline');
+  });
+
+  it('can create valid stage definition', () => {
+    const stage: StageDefinition = {
+      name: 'test-stage',
+      kind: 'analysis',
+      agent: 'test-agent',
+    };
+    expect(stage.kind).toBe('analysis');
+  });
+
+  it('status types are correct', () => {
+    const status: StageStatus = 'success';
+    expect(status).toBe('success');
+  });
+
+  it('can create agent config', () => {
+    const agent: AgentConfig = {
+      name: 'test-agent',
+      provider: 'openai',
+      model: 'gpt-4',
+    };
+    expect(agent.provider).toBe('openai');
+  });
+
+  it('can create pipeline with repo config', () => {
+    const pipeline: PipelineDefinition = {
+      name: 'test',
+      description: 'Test',
+      version: 1,
+      repo: {
+        url: 'https://github.com/test/repo',
+        branch: 'main',
+      },
+      stages: [],
+    };
+    expect(pipeline.repo?.url).toBe('https://github.com/test/repo');
+  });
+
+  it('validation result structure', () => {
+    const validation: ValidationResult = {
+      valid: true,
+      errors: [],
+      warnings: [],
+    };
+    expect(validation.valid).toBe(true);
+    expect(validation.errors).toEqual([]);
+  });
+
+  it('ToolCallRequirements supports required_tool_groups for OR semantics', () => {
+    const req: ToolCallRequirements = {
+      minimum: 1,
+      required_tools: ['repo_manager-read_file'],
+      required_tool_groups: [
+        ['repo_manager-write_file', 'repo_manager-apply_patch'],
+      ],
+    };
+    expect(req.required_tool_groups).toHaveLength(1);
+    expect(req.required_tool_groups![0]).toEqual([
+      'repo_manager-write_file',
+      'repo_manager-apply_patch',
+    ]);
+  });
+
+  it('OutputContract.tool_calls accepts required_tool_groups', () => {
+    const contract: OutputContract = {
+      name: 'code-generation',
+      version: 1,
+      tool_calls: {
+        minimum: 1,
+        required_tool_groups: [
+          ['repo_manager-write_file', 'repo_manager-apply_patch'],
+        ],
+      },
+    };
+    expect(contract.tool_calls?.required_tool_groups).toBeDefined();
+  });
+});

package/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "moduleResolution": "bundler",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "tests"]
+}

package/tsconfig.test.json

@@ -0,0 +1,8 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "noEmit": true,
+    "rootDir": "."
+  },
+  "include": ["src/**/*", "tests/**/*"]
+}