apcore-js 0.4.0 → 0.6.0

package/tests/schema/test-annotations.test.ts

@@ -1,137 +0,0 @@
-/**
- * Tests for schema/annotations.ts — annotation conflict resolution.
- */
-
-import { describe, it, expect } from 'vitest';
-import { mergeAnnotations, mergeExamples, mergeMetadata } from '../../src/schema/annotations.js';
-import { DEFAULT_ANNOTATIONS } from '../../src/module.js';
-import type { ModuleAnnotations, ModuleExample } from '../../src/module.js';
-
-describe('mergeAnnotations', () => {
-  it('returns defaults when both inputs are null', () => {
-    const result = mergeAnnotations(null, null);
-    expect(result).toEqual(DEFAULT_ANNOTATIONS);
-  });
-
-  it('returns defaults when both inputs are undefined', () => {
-    const result = mergeAnnotations(undefined, undefined);
-    expect(result).toEqual(DEFAULT_ANNOTATIONS);
-  });
-
-  it('applies code annotations over defaults', () => {
-    const codeAnnotations: ModuleAnnotations = {
-      readonly: true,
-      destructive: false,
-      idempotent: true,
-      requiresApproval: false,
-      openWorld: false,
-      streaming: false,
-    };
-    const result = mergeAnnotations(null, codeAnnotations);
-    expect(result.readonly).toBe(true);
-    expect(result.idempotent).toBe(true);
-    expect(result.openWorld).toBe(false);
-  });
-
-  it('yaml annotations override code annotations', () => {
-    const codeAnnotations: ModuleAnnotations = {
-      readonly: true,
-      destructive: false,
-      idempotent: false,
-      requiresApproval: false,
-      openWorld: true,
-      streaming: false,
-    };
-    const yamlAnnotations = { readonly: false, destructive: true };
-    const result = mergeAnnotations(yamlAnnotations, codeAnnotations);
-    expect(result.readonly).toBe(false);
-    expect(result.destructive).toBe(true);
-    expect(result.idempotent).toBe(false);
-  });
-
-  it('ignores unknown yaml keys', () => {
-    const yamlAnnotations = { unknownKey: 'value', readonly: true };
-    const result = mergeAnnotations(yamlAnnotations, null);
-    expect(result.readonly).toBe(true);
-    expect((result as unknown as Record<string, unknown>)['unknownKey']).toBeUndefined();
-  });
-});
-
-describe('mergeExamples', () => {
-  it('returns empty array when both inputs are null', () => {
-    expect(mergeExamples(null, null)).toEqual([]);
-  });
-
-  it('returns empty array when both inputs are undefined', () => {
-    expect(mergeExamples(undefined, undefined)).toEqual([]);
-  });
-
-  it('returns yaml examples when present', () => {
-    const yamlExamples = [
-      { title: 'Test', inputs: { a: 1 }, output: { b: 2 }, description: 'desc' },
-    ];
-    const result = mergeExamples(yamlExamples, null);
-    expect(result).toHaveLength(1);
-    expect(result[0].title).toBe('Test');
-    expect(result[0].inputs).toEqual({ a: 1 });
-    expect(result[0].output).toEqual({ b: 2 });
-    expect(result[0].description).toBe('desc');
-  });
-
-  it('uses code examples when yaml is null', () => {
-    const codeExamples: ModuleExample[] = [
-      { title: 'Code', inputs: { x: 1 }, output: { y: 2 } },
-    ];
-    const result = mergeExamples(null, codeExamples);
-    expect(result).toEqual(codeExamples);
-  });
-
-  it('yaml examples take precedence over code examples', () => {
-    const yamlExamples = [{ title: 'YAML', inputs: {}, output: {} }];
-    const codeExamples: ModuleExample[] = [
-      { title: 'Code', inputs: {}, output: {} },
-    ];
-    const result = mergeExamples(yamlExamples, codeExamples);
-    expect(result).toHaveLength(1);
-    expect(result[0].title).toBe('YAML');
-  });
-
-  it('handles yaml examples with missing optional fields', () => {
-    const yamlExamples = [{ title: 'Minimal' }];
-    const result = mergeExamples(yamlExamples as Array<Record<string, unknown>>, null);
-    expect(result[0].inputs).toEqual({});
-    expect(result[0].output).toEqual({});
-    expect(result[0].description).toBeUndefined();
-  });
-});
-
-describe('mergeMetadata', () => {
-  it('returns empty object when both inputs are null', () => {
-    expect(mergeMetadata(null, null)).toEqual({});
-  });
-
-  it('returns code metadata when yaml is null', () => {
-    const code = { key: 'value' };
-    expect(mergeMetadata(null, code)).toEqual({ key: 'value' });
-  });
-
-  it('returns yaml metadata when code is null', () => {
-    const yaml = { key: 'value' };
-    expect(mergeMetadata(yaml, null)).toEqual({ key: 'value' });
-  });
-
-  it('yaml overrides code on conflicting keys', () => {
-    const code = { a: 1, b: 2 };
-    const yaml = { b: 3, c: 4 };
-    const result = mergeMetadata(yaml, code);
-    expect(result).toEqual({ a: 1, b: 3, c: 4 });
-  });
-
-  it('does not mutate input objects', () => {
-    const code = { a: 1 };
-    const yaml = { b: 2 };
-    mergeMetadata(yaml, code);
-    expect(code).toEqual({ a: 1 });
-    expect(yaml).toEqual({ b: 2 });
-  });
-});

package/tests/schema/test-exporter.test.ts

@@ -1,172 +0,0 @@
-/**
- * Tests for schema/exporter.ts — SchemaExporter profile exports.
- */
-
-import { describe, it, expect } from 'vitest';
-import { SchemaExporter } from '../../src/schema/exporter.js';
-import { ExportProfile } from '../../src/schema/types.js';
-import type { SchemaDefinition } from '../../src/schema/types.js';
-import type { ModuleAnnotations, ModuleExample } from '../../src/module.js';
-
-function makeSchemaDef(overrides?: Partial<SchemaDefinition>): SchemaDefinition {
-  return {
-    moduleId: 'test.module',
-    description: 'A test module',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        name: { type: 'string', description: 'Name', 'x-llm-description': 'LLM Name' },
-      },
-      required: ['name'],
-    },
-    outputSchema: {
-      type: 'object',
-      properties: {
-        result: { type: 'string' },
-      },
-    },
-    definitions: {},
-    version: '1.0.0',
-    ...overrides,
-  };
-}
-
-describe('SchemaExporter', () => {
-  const exporter = new SchemaExporter();
-
-  describe('exportGeneric', () => {
-    it('returns module_id, description, input/output schemas, and definitions', () => {
-      const sd = makeSchemaDef();
-      const result = exporter.exportGeneric(sd);
-      expect(result['module_id']).toBe('test.module');
-      expect(result['description']).toBe('A test module');
-      expect(result['input_schema']).toEqual(sd.inputSchema);
-      expect(result['output_schema']).toEqual(sd.outputSchema);
-      expect(result['definitions']).toEqual({});
-    });
-  });
-
-  describe('exportMcp', () => {
-    it('returns MCP tool format with annotations', () => {
-      const sd = makeSchemaDef();
-      const annotations: ModuleAnnotations = {
-        readonly: true,
-        destructive: false,
-        idempotent: true,
-        requiresApproval: false,
-        openWorld: false,
-        streaming: false,
-      };
-      const result = exporter.exportMcp(sd, annotations, 'MyTool');
-      expect(result['name']).toBe('MyTool');
-      expect(result['description']).toBe('A test module');
-      expect(result['inputSchema']).toEqual(sd.inputSchema);
-      const annots = result['annotations'] as Record<string, unknown>;
-      expect(annots['readOnlyHint']).toBe(true);
-      expect(annots['destructiveHint']).toBe(false);
-      expect(annots['idempotentHint']).toBe(true);
-      expect(annots['openWorldHint']).toBe(false);
-    });
-
-    it('falls back to moduleId when name is null', () => {
-      const sd = makeSchemaDef();
-      const result = exporter.exportMcp(sd, null, null);
-      expect(result['name']).toBe('test.module');
-    });
-
-    it('uses default annotation values when annotations is null', () => {
-      const sd = makeSchemaDef();
-      const result = exporter.exportMcp(sd, null);
-      const annots = result['annotations'] as Record<string, unknown>;
-      expect(annots['readOnlyHint']).toBe(false);
-      expect(annots['destructiveHint']).toBe(false);
-      expect(annots['idempotentHint']).toBe(false);
-      expect(annots['openWorldHint']).toBe(true);
-    });
-  });
-
-  describe('exportOpenai', () => {
-    it('returns OpenAI function calling format with strict schema', () => {
-      const sd = makeSchemaDef();
-      const result = exporter.exportOpenai(sd);
-      expect(result['type']).toBe('function');
-      const fn = result['function'] as Record<string, unknown>;
-      expect(fn['name']).toBe('test_module');
-      expect(fn['description']).toBe('A test module');
-      expect(fn['strict']).toBe(true);
-      const params = fn['parameters'] as Record<string, unknown>;
-      expect(params['additionalProperties']).toBe(false);
-    });
-
-    it('applies x-llm-description to properties', () => {
-      const sd = makeSchemaDef();
-      const result = exporter.exportOpenai(sd);
-      const fn = result['function'] as Record<string, unknown>;
-      const params = fn['parameters'] as Record<string, unknown>;
-      const props = params['properties'] as Record<string, Record<string, unknown>>;
-      expect(props['name']['description']).toBe('LLM Name');
-    });
-  });
-
-  describe('exportAnthropic', () => {
-    it('returns Anthropic tool format', () => {
-      const sd = makeSchemaDef();
-      const result = exporter.exportAnthropic(sd);
-      expect(result['name']).toBe('test_module');
-      expect(result['description']).toBe('A test module');
-      expect(result['input_schema']).toBeDefined();
-    });
-
-    it('includes input_examples when examples are provided', () => {
-      const sd = makeSchemaDef();
-      const examples: ModuleExample[] = [
-        { title: 'Ex1', inputs: { name: 'Alice' }, output: { result: 'ok' } },
-      ];
-      const result = exporter.exportAnthropic(sd, examples);
-      const inputExamples = result['input_examples'] as Array<Record<string, unknown>>;
-      expect(inputExamples).toHaveLength(1);
-      expect(inputExamples[0]).toEqual({ name: 'Alice' });
-    });
-
-    it('omits input_examples when no examples', () => {
-      const sd = makeSchemaDef();
-      const result = exporter.exportAnthropic(sd, []);
-      expect(result['input_examples']).toBeUndefined();
-    });
-
-    it('strips x- extensions from schema', () => {
-      const sd = makeSchemaDef();
-      const result = exporter.exportAnthropic(sd);
-      const schema = result['input_schema'] as Record<string, unknown>;
-      const props = schema['properties'] as Record<string, Record<string, unknown>>;
-      expect(props['name']['x-llm-description']).toBeUndefined();
-    });
-  });
-
-  describe('export dispatch', () => {
-    it('dispatches to MCP profile', () => {
-      const sd = makeSchemaDef();
-      const result = exporter.export(sd, ExportProfile.MCP);
-      expect(result['name']).toBe('test.module');
-      expect(result['annotations']).toBeDefined();
-    });
-
-    it('dispatches to OpenAI profile', () => {
-      const sd = makeSchemaDef();
-      const result = exporter.export(sd, ExportProfile.OpenAI);
-      expect(result['type']).toBe('function');
-    });
-
-    it('dispatches to Anthropic profile', () => {
-      const sd = makeSchemaDef();
-      const result = exporter.export(sd, ExportProfile.Anthropic);
-      expect(result['input_schema']).toBeDefined();
-    });
-
-    it('dispatches to Generic profile', () => {
-      const sd = makeSchemaDef();
-      const result = exporter.export(sd, ExportProfile.Generic);
-      expect(result['module_id']).toBe('test.module');
-    });
-  });
-});