@tagma/sdk 0.6.5 → 0.6.7

package/dist/plugin-registry.test.js

@@ -1,188 +0,0 @@
-import { describe, expect, test } from 'bun:test';
-import { PluginRegistry, defaultRegistry } from './registry';
-import { bootstrapBuiltins } from './bootstrap';
-import { runPipeline } from './engine';
-import { mkdtempSync, rmSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-function makeDriver(name, marker) {
-    return {
-        name,
-        capabilities: { sessionResume: false, systemPrompt: false, outputFormat: false },
-        async buildCommand() {
-            marker.push(`buildCommand:${name}`);
-            return { args: ['echo', 'noop'] };
-        },
-    };
-}
-function makeTrigger(name, marker) {
-    return {
-        name,
-        async watch() {
-            marker.push(`watch:${name}`);
-        },
-    };
-}
-describe('PluginRegistry — instance isolation', () => {
-    test('two registries do not share drivers registered under the same type', () => {
-        const regA = new PluginRegistry();
-        const regB = new PluginRegistry();
-        const markerA = [];
-        const markerB = [];
-        regA.registerPlugin('drivers', 'mock', makeDriver('mockA', markerA));
-        regB.registerPlugin('drivers', 'mock', makeDriver('mockB', markerB));
-        expect(regA.getHandler('drivers', 'mock').name).toBe('mockA');
-        expect(regB.getHandler('drivers', 'mock').name).toBe('mockB');
-        expect(regA.hasHandler('drivers', 'mock')).toBe(true);
-        expect(regB.hasHandler('drivers', 'mock')).toBe(true);
-        expect(regA.hasHandler('triggers', 'mock')).toBe(false);
-    });
-    test('unregistering in one registry does not affect the other', () => {
-        const regA = new PluginRegistry();
-        const regB = new PluginRegistry();
-        regA.registerPlugin('drivers', 'mock', makeDriver('mockA', []));
-        regB.registerPlugin('drivers', 'mock', makeDriver('mockB', []));
-        expect(regA.unregisterPlugin('drivers', 'mock')).toBe(true);
-        expect(regA.hasHandler('drivers', 'mock')).toBe(false);
-        expect(regB.hasHandler('drivers', 'mock')).toBe(true);
-    });
-    test('listRegistered is scoped per instance', () => {
-        const regA = new PluginRegistry();
-        const regB = new PluginRegistry();
-        regA.registerPlugin('triggers', 'a-only', makeTrigger('a-only', []));
-        regB.registerPlugin('triggers', 'b-only', makeTrigger('b-only', []));
-        expect(regA.listRegistered('triggers')).toEqual(['a-only']);
-        expect(regB.listRegistered('triggers')).toEqual(['b-only']);
-    });
-    test('registering the same instance twice returns unchanged', () => {
-        const reg = new PluginRegistry();
-        const driver = makeDriver('same', []);
-        expect(reg.registerPlugin('drivers', 'mock', driver)).toBe('registered');
-        expect(reg.registerPlugin('drivers', 'mock', driver)).toBe('unchanged');
-    });
-    test('replacing with a different handler returns replaced', () => {
-        const reg = new PluginRegistry();
-        expect(reg.registerPlugin('drivers', 'mock', makeDriver('one', []))).toBe('registered');
-        expect(reg.registerPlugin('drivers', 'mock', makeDriver('two', []))).toBe('replaced');
-        expect(reg.getHandler('drivers', 'mock').name).toBe('two');
-    });
-    test('bootstrapBuiltins(target) populates a specific instance without touching the default', () => {
-        const fresh = new PluginRegistry();
-        expect(fresh.hasHandler('drivers', 'opencode')).toBe(false);
-        bootstrapBuiltins(fresh);
-        expect(fresh.hasHandler('drivers', 'opencode')).toBe(true);
-        expect(fresh.hasHandler('triggers', 'file')).toBe(true);
-        expect(fresh.hasHandler('triggers', 'manual')).toBe(true);
-        expect(fresh.hasHandler('completions', 'exit_code')).toBe(true);
-        expect(fresh.hasHandler('middlewares', 'static_context')).toBe(true);
-        // Default registry's state is independent of `fresh` — if the default
-        // happens to have opencode (because another test bootstrapped it), that
-        // is fine; the guarantee is that `fresh.unregister` does not leak.
-        fresh.unregisterPlugin('drivers', 'opencode');
-        expect(fresh.hasHandler('drivers', 'opencode')).toBe(false);
-    });
-});
-describe('PluginRegistry — validation', () => {
-    test('rejects unknown category', () => {
-        const reg = new PluginRegistry();
-        expect(() => reg.registerPlugin('nope', 'x', makeDriver('x', []))).toThrow(/Unknown plugin category/);
-    });
-    test('rejects driver missing buildCommand', () => {
-        const reg = new PluginRegistry();
-        expect(() => reg.registerPlugin('drivers', 'broken', 
-        // deliberately bad: no buildCommand
-        { name: 'broken', capabilities: { sessionResume: false, systemPrompt: false, outputFormat: false } })).toThrow(/must export buildCommand/);
-    });
-    test('rejects handler with missing name', () => {
-        const reg = new PluginRegistry();
-        expect(() => reg.registerPlugin('drivers', 'x', 
-        // deliberately bad: no name
-        { capabilities: { sessionResume: false, systemPrompt: false, outputFormat: false }, buildCommand: async () => ({ args: [] }) })).toThrow(/non-empty "name"/);
-    });
-});
-describe('runPipeline — options.registry isolation', () => {
-    test('concurrent runs with different registries see their own drivers', async () => {
-        const regA = new PluginRegistry();
-        const regB = new PluginRegistry();
-        const seenA = [];
-        const seenB = [];
-        bootstrapBuiltins(regA);
-        bootstrapBuiltins(regB);
-        regA.registerPlugin('drivers', 'mock', makeDriver('mockA', seenA));
-        regB.registerPlugin('drivers', 'mock', makeDriver('mockB', seenB));
-        // Command-only pipeline exercises the preflight path (which uses the
-        // registry) plus the run-loop path without requiring a real driver
-        // invocation. We verify isolation by asserting that preflight with a
-        // registry missing `mock` rejects, while the matching registry accepts.
-        const config = {
-            name: 'isolation-test',
-            tracks: [
-                {
-                    id: 't',
-                    name: 'T',
-                    tasks: [{ id: 'only', name: 'only', command: 'echo hi' }],
-                },
-            ],
-        };
-        const tmpA = mkdtempSync(join(tmpdir(), 'tagma-regA-'));
-        const tmpB = mkdtempSync(join(tmpdir(), 'tagma-regB-'));
-        try {
-            const [resA, resB] = await Promise.all([
-                runPipeline(config, tmpA, { registry: regA, skipPluginLoading: true }),
-                runPipeline(config, tmpB, { registry: regB, skipPluginLoading: true }),
-            ]);
-            expect(resA.success).toBe(true);
-            expect(resB.success).toBe(true);
-            expect(resA.runId).not.toBe(resB.runId);
-        }
-        finally {
-            rmSync(tmpA, { recursive: true, force: true });
-            rmSync(tmpB, { recursive: true, force: true });
-        }
-    });
-    test('preflight fails when referenced driver is missing from the passed registry', async () => {
-        const regNoOpencode = new PluginRegistry();
-        // Deliberately do NOT bootstrap builtins — opencode is not registered.
-        const config = {
-            name: 'preflight-miss',
-            tracks: [
-                {
-                    id: 't',
-                    name: 'T',
-                    tasks: [{ id: 'x', name: 'x', prompt: 'hello' }],
-                },
-            ],
-        };
-        const tmp = mkdtempSync(join(tmpdir(), 'tagma-miss-'));
-        try {
-            await expect(runPipeline(config, tmp, { registry: regNoOpencode, skipPluginLoading: true })).rejects.toThrow(/driver "opencode" not registered/);
-        }
-        finally {
-            rmSync(tmp, { recursive: true, force: true });
-        }
-    });
-    test('omitting options.registry falls back to defaultRegistry', async () => {
-        // bootstrapBuiltins into default happens in most host callers; do it
-        // explicitly here so the test is independent of module-load order.
-        bootstrapBuiltins(defaultRegistry);
-        const config = {
-            name: 'default-fallback',
-            tracks: [
-                {
-                    id: 't',
-                    name: 'T',
-                    tasks: [{ id: 'only', name: 'only', command: 'echo hi' }],
-                },
-            ],
-        };
-        const tmp = mkdtempSync(join(tmpdir(), 'tagma-default-'));
-        try {
-            const res = await runPipeline(config, tmp, { skipPluginLoading: true });
-            expect(res.success).toBe(true);
-        }
-        finally {
-            rmSync(tmp, { recursive: true, force: true });
-        }
-    });
-});
-//# sourceMappingURL=plugin-registry.test.js.map

package/dist/plugin-registry.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin-registry.test.js","sourceRoot":"","sources":["../src/plugin-registry.test.ts"],"names":[],"mappings":"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"}

package/dist/ports.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=ports.test.d.ts.map

package/dist/ports.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ports.test.d.ts","sourceRoot":"","sources":["../src/ports.test.ts"],"names":[],"mappings":""}

package/dist/ports.test.js

@@ -1,262 +0,0 @@
-import { describe, expect, test } from 'bun:test';
-import { extractInputReferences, extractTaskOutputs, resolveTaskInputs, substituteInputs, } from './ports';
-const PERMS = { read: true, write: false, execute: false };
-function task(overrides) {
-    return {
-        name: overrides.id,
-        permissions: PERMS,
-        ...overrides,
-    };
-}
-// ─── substituteInputs ────────────────────────────────────────────────
-describe('substituteInputs', () => {
-    test('replaces single placeholder with string value', () => {
-        const { text, unresolved } = substituteInputs('hello {{inputs.name}}', { name: 'world' });
-        expect(text).toBe('hello world');
-        expect(unresolved).toEqual([]);
-    });
-    test('allows optional whitespace inside braces', () => {
-        const { text } = substituteInputs('{{  inputs.name  }} / {{inputs.name}}', { name: 'x' });
-        expect(text).toBe('x / x');
-    });
-    test('stringifies number / boolean values verbatim', () => {
-        const { text } = substituteInputs('n={{inputs.n}} b={{inputs.b}}', { n: 42, b: true });
-        expect(text).toBe('n=42 b=true');
-    });
-    test('JSON-stringifies object values', () => {
-        const { text } = substituteInputs('payload={{inputs.p}}', {
-            p: { a: 1, b: 'x' },
-        });
-        expect(text).toBe('payload={"a":1,"b":"x"}');
-    });
-    test('renders unknown placeholder empty and reports it', () => {
-        const { text, unresolved } = substituteInputs('hello {{inputs.missing}}', {});
-        expect(text).toBe('hello ');
-        expect(unresolved).toEqual(['missing']);
-    });
-    test('renders null / undefined as empty and reports', () => {
-        const { text, unresolved } = substituteInputs('a={{inputs.a}} b={{inputs.b}}', {
-            a: null,
-            b: undefined,
-        });
-        expect(text).toBe('a= b=');
-        expect([...unresolved].sort()).toEqual(['a', 'b']);
-    });
-    test('leaves malformed placeholders alone', () => {
-        const { text } = substituteInputs('{{inputs.a.b}} {{inputs.}}', { a: 'x' });
-        expect(text).toBe('{{inputs.a.b}} {{inputs.}}');
-    });
-    test('handles circular objects without throwing', () => {
-        const obj = { self: null };
-        obj.self = obj;
-        const { text, unresolved } = substituteInputs('{{inputs.x}}', { x: obj });
-        expect(text).toBe('');
-        expect(unresolved).toEqual(['x']);
-    });
-});
-describe('extractInputReferences', () => {
-    test('returns unique referenced names', () => {
-        const refs = extractInputReferences('get {{inputs.city}} for id={{inputs.id}} and {{inputs.city}} again');
-        expect(refs.sort()).toEqual(['city', 'id']);
-    });
-    test('returns empty for text without placeholders', () => {
-        expect(extractInputReferences('no placeholders here')).toEqual([]);
-    });
-});
-// ─── resolveTaskInputs ────────────────────────────────────────────────
-const cityPort = { name: 'city', type: 'string', required: true };
-const idPort = { name: 'id', type: 'number', required: true };
-describe('resolveTaskInputs', () => {
-    test('no declared inputs → ready with empty map', () => {
-        const t = task({ id: 'downstream', command: 'echo' });
-        const res = resolveTaskInputs(t, new Map(), []);
-        expect(res).toEqual({ kind: 'ready', inputs: {}, missingOptional: [] });
-    });
-    test('matches inputs by name across upstream outputs', () => {
-        const t = task({
-            id: 'downstream',
-            command: 'echo',
-            ports: { inputs: [cityPort, idPort] },
-        });
-        const upstream = new Map([
-            ['t.prompt', { city: 'Shanghai' }],
-            ['t.other', { id: 42 }],
-        ]);
-        const res = resolveTaskInputs(t, upstream, ['t.prompt', 't.other']);
-        expect(res.kind).toBe('ready');
-        if (res.kind !== 'ready')
-            return;
-        expect(res.inputs).toEqual({ city: 'Shanghai', id: 42 });
-    });
-    test('required missing blocks with a readable reason', () => {
-        const t = task({
-            id: 'downstream',
-            command: 'echo',
-            ports: { inputs: [cityPort, idPort] },
-        });
-        const res = resolveTaskInputs(t, new Map(), ['t.x']);
-        expect(res.kind).toBe('blocked');
-        if (res.kind !== 'blocked')
-            return;
-        expect([...res.missingRequired].sort()).toEqual(['city', 'id']);
-        expect(res.reason).toMatch(/city.*id|id.*city/);
-    });
-    test('optional missing yields ready but reports missingOptional', () => {
-        const optional = { name: 'note', type: 'string' };
-        const t = task({
-            id: 'downstream',
-            command: 'echo',
-            ports: { inputs: [optional] },
-        });
-        const res = resolveTaskInputs(t, new Map(), []);
-        expect(res.kind).toBe('ready');
-        if (res.kind !== 'ready')
-            return;
-        expect(res.inputs).toEqual({});
-        expect(res.missingOptional).toEqual(['note']);
-    });
-    test('applies default for missing optional', () => {
-        const optional = { name: 'note', type: 'string', default: 'n/a' };
-        const t = task({
-            id: 'd',
-            command: 'echo',
-            ports: { inputs: [optional] },
-        });
-        const res = resolveTaskInputs(t, new Map(), []);
-        expect(res.kind).toBe('ready');
-        if (res.kind !== 'ready')
-            return;
-        expect(res.inputs).toEqual({ note: 'n/a' });
-    });
-    test('ambiguous multi-upstream match blocks unless disambiguated', () => {
-        const t = task({
-            id: 'd',
-            command: 'echo',
-            ports: { inputs: [cityPort] },
-        });
-        const upstream = new Map([
-            ['t.a', { city: 'Shanghai' }],
-            ['t.b', { city: 'Beijing' }],
-        ]);
-        const res = resolveTaskInputs(t, upstream, ['t.a', 't.b']);
-        expect(res.kind).toBe('blocked');
-        if (res.kind !== 'blocked')
-            return;
-        expect(res.ambiguous.length).toBe(1);
-        expect(res.ambiguous[0].port).toBe('city');
-        expect([...res.ambiguous[0].producers].sort()).toEqual(['t.a', 't.b']);
-    });
-    test('explicit fully-qualified "from" wins over name-match ambiguity', () => {
-        const explicit = {
-            name: 'city',
-            type: 'string',
-            required: true,
-            from: 't.b.city',
-        };
-        const t = task({
-            id: 'd',
-            command: 'echo',
-            ports: { inputs: [explicit] },
-        });
-        const upstream = new Map([
-            ['t.a', { city: 'Shanghai' }],
-            ['t.b', { city: 'Beijing' }],
-        ]);
-        const res = resolveTaskInputs(t, upstream, ['t.a', 't.b']);
-        expect(res.kind).toBe('ready');
-        if (res.kind !== 'ready')
-            return;
-        expect(res.inputs).toEqual({ city: 'Beijing' });
-    });
-    test('coerces numeric strings to number type', () => {
-        const t = task({
-            id: 'd',
-            command: 'echo',
-            ports: { inputs: [idPort] },
-        });
-        const upstream = new Map([['t.a', { id: '42' }]]);
-        const res = resolveTaskInputs(t, upstream, ['t.a']);
-        expect(res.kind).toBe('ready');
-        if (res.kind !== 'ready')
-            return;
-        expect(res.inputs.id).toBe(42);
-    });
-    test('flags type-coercion failures as blocked', () => {
-        const t = task({
-            id: 'd',
-            command: 'echo',
-            ports: { inputs: [idPort] },
-        });
-        const upstream = new Map([['t.a', { id: 'nope' }]]);
-        const res = resolveTaskInputs(t, upstream, ['t.a']);
-        expect(res.kind).toBe('blocked');
-        if (res.kind !== 'blocked')
-            return;
-        expect(res.typeErrors.length).toBe(1);
-        expect(res.typeErrors[0].port).toBe('id');
-    });
-    test('enforces enum membership', () => {
-        const colorPort = {
-            name: 'color',
-            type: 'enum',
-            enum: ['red', 'green'],
-            required: true,
-        };
-        const t = task({
-            id: 'd',
-            command: 'echo',
-            ports: { inputs: [colorPort] },
-        });
-        const upstream = new Map([['t.a', { color: 'blue' }]]);
-        const res = resolveTaskInputs(t, upstream, ['t.a']);
-        expect(res.kind).toBe('blocked');
-        if (res.kind !== 'blocked')
-            return;
-        expect(res.typeErrors[0].port).toBe('color');
-    });
-});
-// ─── extractTaskOutputs ──────────────────────────────────────────────
-describe('extractTaskOutputs', () => {
-    const outputs = [
-        { name: 'city', type: 'string' },
-        { name: 'temp', type: 'number' },
-    ];
-    test('no declared outputs → empty map, null diagnostic', () => {
-        const r = extractTaskOutputs(undefined, 'anything', null);
-        expect(r.outputs).toEqual({});
-        expect(r.diagnostic).toBeNull();
-    });
-    test('parses last-line JSON object as source record', () => {
-        const stdout = 'some log\nmore log\n{"city":"Shanghai","temp":23}\n';
-        const r = extractTaskOutputs({ outputs }, stdout, null);
-        expect(r.outputs).toEqual({ city: 'Shanghai', temp: 23 });
-        expect(r.diagnostic).toBeNull();
-    });
-    test('falls back to whole-source JSON when last line is a closing brace', () => {
-        const stdout = '{\n  "city": "Shanghai",\n  "temp": 23\n}\n';
-        const r = extractTaskOutputs({ outputs }, stdout, null);
-        expect(r.outputs).toEqual({ city: 'Shanghai', temp: 23 });
-    });
-    test('prefers normalizedOutput over stdout when provided', () => {
-        const stdout = '{"city":"Wrong","temp":0}';
-        const normalized = '{"city":"Shanghai","temp":23}';
-        const r = extractTaskOutputs({ outputs }, stdout, normalized);
-        expect(r.outputs).toEqual({ city: 'Shanghai', temp: 23 });
-    });
-    test('reports missing keys as diagnostic, keeps resolved keys', () => {
-        const r = extractTaskOutputs({ outputs }, '{"city":"Shanghai"}', null);
-        expect(r.outputs).toEqual({ city: 'Shanghai' });
-        expect(r.diagnostic).toContain('missing key "temp"');
-    });
-    test('reports coercion failure and skips bad port', () => {
-        const r = extractTaskOutputs({ outputs }, '{"city":"Shanghai","temp":"not-a-number"}', null);
-        expect(r.outputs).toEqual({ city: 'Shanghai' });
-        expect(r.diagnostic).toContain('"temp"');
-    });
-    test('reports diagnostic when no JSON can be parsed', () => {
-        const r = extractTaskOutputs({ outputs }, 'plain text output\nnothing json\n', null);
-        expect(r.outputs).toEqual({});
-        expect(r.diagnostic).toContain('could not find a final-line JSON object');
-    });
-});
-//# sourceMappingURL=ports.test.js.map

package/dist/ports.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ports.test.js","sourceRoot":"","sources":["../src/ports.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAGjB,MAAM,KAAK,GAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAExE,SAAS,IAAI,CAAC,SAA+C;IAC3D,OAAO;QACL,IAAI,EAAE,SAAS,CAAC,EAAE;QAClB,WAAW,EAAE,KAAK;QAClB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,wEAAwE;AAExE,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,IAAI,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACzD,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,gBAAgB,CAAC,uBAAuB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1F,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACjC,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,0CAA0C,EAAE,GAAG,EAAE;QACpD,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,uCAAuC,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QAC1F,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACxD,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAC/B,+BAA+B,EAC/B,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,CACnB,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,gCAAgC,EAAE,GAAG,EAAE;QAC1C,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,sBAAsB,EAAE;YACxD,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE;SACpB,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC5D,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,gBAAgB,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;QAC9E,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5B,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACzD,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,gBAAgB,CAAC,+BAA+B,EAAE;YAC7E,CAAC,EAAE,IAAI;YACP,CAAC,EAAE,SAAS;SACb,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,MAAM,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC/C,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,4BAA4B,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QAC5E,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACrD,MAAM,GAAG,GAA4B,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACpD,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC;QACf,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,gBAAgB,CAAC,cAAc,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QAC1E,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtB,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,IAAI,CAAC,iCAAiC,EAAE,GAAG,EAAE;QAC3C,MAAM,IAAI,GAAG,sBAAsB,CACjC,oEAAoE,CACrE,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,sBAAsB,CAAC,sBAAsB,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,yEAAyE;AAEzE,MAAM,QAAQ,GAAY,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC3E,MAAM,MAAM,GAAY,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAEvE,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,IAAI,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,iBAAiB,CAAC,CAAC,EAAE,IAAI,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;QAChD,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,gDAAgD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,GAAG,IAAI,CAAC;YACb,EAAE,EAAE,YAAY;YAChB,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;SACtC,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAkC;YACxD,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;YAClC,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;SACxB,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;QACpE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO;QACjC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,gDAAgD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,GAAG,IAAI,CAAC;YACb,EAAE,EAAE,YAAY;YAChB,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;SACtC,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,iBAAiB,CAAC,CAAC,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QACrD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjC,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO;QACnC,MAAM,CAAC,CAAC,GAAG,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;QAChE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACrE,MAAM,QAAQ,GAAY,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC3D,MAAM,CAAC,GAAG,IAAI,CAAC;YACb,EAAE,EAAE,YAAY;YAChB,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE;SAC9B,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,iBAAiB,CAAC,CAAC,EAAE,IAAI,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;QAChD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO;QACjC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC/B,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAChD,MAAM,QAAQ,GAAY,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC3E,MAAM,CAAC,GAAG,IAAI,CAAC;YACb,EAAE,EAAE,GAAG;YACP,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE;SAC9B,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,iBAAiB,CAAC,CAAC,EAAE,IAAI,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;QAChD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO;QACjC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACtE,MAAM,CAAC,GAAG,IAAI,CAAC;YACb,EAAE,EAAE,GAAG;YACP,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE;SAC9B,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAkC;YACxD,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;YAC7B,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;SAC7B,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QAC3D,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjC,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO;QACnC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,CAAC,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAE,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,gEAAgE,EAAE,GAAG,EAAE;QAC1E,MAAM,QAAQ,GAAY;YACxB,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,UAAU;SACjB,CAAC;QACF,MAAM,CAAC,GAAG,IAAI,CAAC;YACb,EAAE,EAAE,GAAG;YACP,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE;SAC9B,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAkC;YACxD,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;YAC7B,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;SAC7B,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QAC3D,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO;QACjC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,GAAG,IAAI,CAAC;YACb,EAAE,EAAE,GAAG;YACP,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE;SAC5B,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAkC,CAAC,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACnF,MAAM,GAAG,GAAG,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO;QACjC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACnD,MAAM,CAAC,GAAG,IAAI,CAAC;YACb,EAAE,EAAE,GAAG;YACP,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE;SAC5B,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAkC,CAAC,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;QACrF,MAAM,GAAG,GAAG,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjC,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO;QACnC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,0BAA0B,EAAE,GAAG,EAAE;QACpC,MAAM,SAAS,GAAY;YACzB,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC;YACtB,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,MAAM,CAAC,GAAG,IAAI,CAAC;YACb,EAAE,EAAE,GAAG;YACP,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE;SAC/B,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAkC,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;QACxF,MAAM,GAAG,GAAG,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjC,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO;QACnC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,wEAAwE;AAExE,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,MAAM,OAAO,GAAG;QACd,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAiB,EAAE;QACzC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAiB,EAAE;KAC1C,CAAC;IAEF,IAAI,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC5D,MAAM,CAAC,GAAG,kBAAkB,CAAC,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;QAC1D,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACzD,MAAM,MAAM,GAAG,qDAAqD,CAAC;QACrE,MAAM,CAAC,GAAG,kBAAkB,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QACxD,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1D,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC7E,MAAM,MAAM,GAAG,6CAA6C,CAAC;QAC7D,MAAM,CAAC,GAAG,kBAAkB,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QACxD,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC9D,MAAM,MAAM,GAAG,2BAA2B,CAAC;QAC3C,MAAM,UAAU,GAAG,+BAA+B,CAAC;QACnD,MAAM,CAAC,GAAG,kBAAkB,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;QAC9D,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACnE,MAAM,CAAC,GAAG,kBAAkB,CAAC,EAAE,OAAO,EAAE,EAAE,qBAAqB,EAAE,IAAI,CAAC,CAAC;QACvE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QAChD,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,GAAG,kBAAkB,CAC1B,EAAE,OAAO,EAAE,EACX,2CAA2C,EAC3C,IAAI,CACL,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QAChD,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,GAAG,kBAAkB,CAAC,EAAE,OAAO,EAAE,EAAE,mCAAmC,EAAE,IAAI,CAAC,CAAC;QACrF,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,yCAAyC,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/prompt-doc.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=prompt-doc.test.d.ts.map

package/dist/prompt-doc.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"prompt-doc.test.d.ts","sourceRoot":"","sources":["../src/prompt-doc.test.ts"],"names":[],"mappings":""}

package/dist/prompt-doc.test.js

@@ -1,145 +0,0 @@
-import { describe, expect, test } from 'bun:test';
-import { appendContext, prependContext, promptDocumentFromString, renderInputsBlock, renderOutputSchemaBlock, serializePromptDocument, } from './prompt-doc';
-// ─── renderInputsBlock ────────────────────────────────────────────────
-describe('renderInputsBlock', () => {
-    test('returns null when no inputs declared', () => {
-        expect(renderInputsBlock(undefined, {})).toBeNull();
-        expect(renderInputsBlock([], { any: 'x' })).toBeNull();
-    });
-    test('returns null when declared inputs have no resolved values', () => {
-        const ports = [{ name: 'city', type: 'string' }];
-        // values missing entirely — block is noise, omit it
-        expect(renderInputsBlock(ports, {})).toBeNull();
-    });
-    test('renders name: value per declared input', () => {
-        const ports = [
-            { name: 'city', type: 'string' },
-            { name: 'id', type: 'number' },
-        ];
-        const block = renderInputsBlock(ports, { city: 'Shanghai', id: 42 });
-        expect(block).not.toBeNull();
-        expect(block.label).toBe('Inputs');
-        expect(block.content).toBe('city: "Shanghai"\nid: 42');
-    });
-    test('appends # description comment when provided', () => {
-        const ports = [
-            { name: 'city', type: 'string', description: 'Target city' },
-        ];
-        const block = renderInputsBlock(ports, { city: 'Shanghai' });
-        expect(block.content).toBe('city: "Shanghai"  # Target city');
-    });
-    test('preserves declaration order, not input-map iteration order', () => {
-        const ports = [
-            { name: 'b', type: 'string' },
-            { name: 'a', type: 'string' },
-        ];
-        // Values object has 'a' first, 'b' second — block should still emit 'b' first.
-        const block = renderInputsBlock(ports, { a: 'x', b: 'y' });
-        expect(block.content).toBe('b: "y"\na: "x"');
-    });
-    test('skips ports whose values were not resolved', () => {
-        const ports = [
-            { name: 'a', type: 'string' },
-            { name: 'b', type: 'string' },
-        ];
-        const block = renderInputsBlock(ports, { a: 'x' });
-        expect(block.content).toBe('a: "x"');
-    });
-    test('JSON-encodes non-primitive values', () => {
-        const ports = [{ name: 'payload', type: 'json' }];
-        const block = renderInputsBlock(ports, { payload: { a: 1, b: [2, 3] } });
-        expect(block.content).toBe('payload: {"a":1,"b":[2,3]}');
-    });
-    test('booleans render verbatim, not quoted', () => {
-        const ports = [{ name: 'flag', type: 'boolean' }];
-        const block = renderInputsBlock(ports, { flag: true });
-        expect(block.content).toBe('flag: true');
-    });
-});
-// ─── renderOutputSchemaBlock ──────────────────────────────────────────
-describe('renderOutputSchemaBlock', () => {
-    test('returns null when no outputs declared', () => {
-        expect(renderOutputSchemaBlock(undefined)).toBeNull();
-        expect(renderOutputSchemaBlock([])).toBeNull();
-    });
-    test('instructs the model to emit final-line JSON', () => {
-        const ports = [{ name: 'city', type: 'string' }];
-        const block = renderOutputSchemaBlock(ports);
-        expect(block.label).toBe('Output Format');
-        expect(block.content).toMatch(/final line/i);
-    });
-    test('lists each port with its type', () => {
-        const ports = [
-            { name: 'city', type: 'string', description: 'Target city' },
-            { name: 'temp', type: 'number' },
-        ];
-        const block = renderOutputSchemaBlock(ports);
-        expect(block.content).toContain('- city (string): Target city');
-        expect(block.content).toContain('- temp (number)');
-    });
-    test('includes enum values in the type hint', () => {
-        const ports = [
-            { name: 'color', type: 'enum', enum: ['red', 'green', 'blue'] },
-        ];
-        const block = renderOutputSchemaBlock(ports);
-        expect(block.content).toContain('color (enum (one of: "red", "green", "blue"))');
-    });
-    test('example object uses declared defaults when present', () => {
-        const ports = [
-            { name: 'score', type: 'number', default: 0.5 },
-            { name: 'note', type: 'string', default: 'n/a' },
-        ];
-        const block = renderOutputSchemaBlock(ports);
-        // The example line is `Example final line: {"score":0.5,"note":"n/a"}`.
-        expect(block.content).toContain('"score":0.5');
-        expect(block.content).toContain('"note":"n/a"');
-    });
-    test('example uses type-appropriate placeholders when no default', () => {
-        const ports = [
-            { name: 's', type: 'string' },
-            { name: 'n', type: 'number' },
-            { name: 'b', type: 'boolean' },
-            { name: 'j', type: 'json' },
-        ];
-        const block = renderOutputSchemaBlock(ports);
-        expect(block.content).toContain('"s":"..."');
-        expect(block.content).toContain('"n":0');
-        expect(block.content).toContain('"b":false');
-        expect(block.content).toContain('"j":null');
-    });
-    test('example uses first enum value when present', () => {
-        const ports = [
-            { name: 'tier', type: 'enum', enum: ['low', 'high'] },
-        ];
-        const block = renderOutputSchemaBlock(ports);
-        expect(block.content).toContain('"tier":"low"');
-    });
-});
-// ─── prependContext / appendContext ──────────────────────────────────
-describe('prependContext / appendContext', () => {
-    const block = { label: 'X', content: 'x' };
-    test('prependContext puts block at front without mutating input', () => {
-        const doc = { contexts: [{ label: 'Y', content: 'y' }], task: 't' };
-        const next = prependContext(doc, block);
-        expect(next.contexts.map((c) => c.label)).toEqual(['X', 'Y']);
-        // Original untouched — immutability is part of the contract for
-        // middleware safety (the engine compares doc identity to detect
-        // changes in some paths).
-        expect(doc.contexts).toHaveLength(1);
-        expect(doc.contexts[0].label).toBe('Y');
-        expect(next.task).toBe('t');
-    });
-    test('appendContext puts block at end without mutating input', () => {
-        const doc = { contexts: [{ label: 'Y', content: 'y' }], task: 't' };
-        const next = appendContext(doc, block);
-        expect(next.contexts.map((c) => c.label)).toEqual(['Y', 'X']);
-        expect(doc.contexts).toHaveLength(1);
-    });
-    test('prepend + serialize produces [X] block above the task', () => {
-        const doc = promptDocumentFromString('do the thing');
-        const next = prependContext(doc, { label: 'Inputs', content: 'city: "Shanghai"' });
-        const text = serializePromptDocument(next);
-        expect(text).toBe('[Inputs]\ncity: "Shanghai"\n\ndo the thing');
-    });
-});
-//# sourceMappingURL=prompt-doc.test.js.map