@tagma/sdk 0.6.3 → 0.6.5

package/dist/ports.test.js

@@ -0,0 +1,262 @@
+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

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

package/dist/prompt-doc.d.ts

@@ -1,4 +1,4 @@
-import type { PromptDocument, PromptContextBlock } from './types';
+import type { PortDef, PromptContextBlock, PromptDocument } from './types';
 /**
  * Build a fresh `PromptDocument` from a raw task string.
  * Middlewares receive this from the engine and push context blocks onto
@@ -33,4 +33,38 @@ export declare function serializePromptDocument(doc: PromptDocument): string;
  * appended to `contexts`, preserving immutability of `doc`.
  */
 export declare function appendContext(doc: PromptDocument, block: PromptContextBlock): PromptDocument;
+/**
+ * Helper: return a new document with the given block PREPENDED. The
+ * engine uses this to place port-related context blocks (`[Inputs]`,
+ * `[Output Format]`) at the top of the document so middlewares that
+ * assemble retrieval context against the task's inputs see them.
+ */
+export declare function prependContext(doc: PromptDocument, block: PromptContextBlock): PromptDocument;
+/**
+ * Build an `[Inputs]` context block from a map of resolved port inputs.
+ * Each input is rendered on its own line as `name: <value>` with an
+ * optional trailing `# <description>` comment so the model has both the
+ * value and the reason it matters.
+ *
+ * The block is *only* useful for AI tasks; command tasks consume inputs
+ * through `{{inputs.X}}` substitution in their command line and do not
+ * need this context.
+ *
+ * Returns null when there are no inputs to render — callers can forward
+ * that nullish value to `prependContext` via an `if (block)` check so
+ * empty-input tasks don't grow a noise block in their prompt.
+ */
+export declare function renderInputsBlock(inputsDecl: readonly PortDef[] | undefined, values: Readonly<Record<string, unknown>>): PromptContextBlock | null;
+/**
+ * Build an `[Output Format]` context block from a task's declared output
+ * ports. The block instructs the model to emit a final-line JSON object
+ * matching the declared schema so `extractTaskOutputs` can pick it up
+ * without fragile heuristics. Returns null when the task declares no
+ * outputs.
+ *
+ * The instruction is deliberately short and explicit — a terse "emit
+ * this object as JSON on the final line" beats a long schema dump
+ * because shorter prompts compose better with downstream middlewares.
+ */
+export declare function renderOutputSchemaBlock(outputsDecl: readonly PortDef[] | undefined): PromptContextBlock | null;
 //# sourceMappingURL=prompt-doc.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"prompt-doc.d.ts","sourceRoot":"","sources":["../src/prompt-doc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElE;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAErE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAInE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,kBAAkB,GACxB,cAAc,CAEhB"}
+{"version":3,"file":"prompt-doc.d.ts","sourceRoot":"","sources":["../src/prompt-doc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE3E;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAErE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAInE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,kBAAkB,GACxB,cAAc,CAEhB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,kBAAkB,GACxB,cAAc,CAEhB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,EAC1C,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACxC,kBAAkB,GAAG,IAAI,CAY3B;AAaD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,GAC1C,kBAAkB,GAAG,IAAI,CAsB3B"}

package/dist/prompt-doc.js

@@ -41,4 +41,114 @@ export function serializePromptDocument(doc) {
 export function appendContext(doc, block) {
     return { contexts: [...doc.contexts, block], task: doc.task };
 }
+/**
+ * Helper: return a new document with the given block PREPENDED. The
+ * engine uses this to place port-related context blocks (`[Inputs]`,
+ * `[Output Format]`) at the top of the document so middlewares that
+ * assemble retrieval context against the task's inputs see them.
+ */
+export function prependContext(doc, block) {
+    return { contexts: [block, ...doc.contexts], task: doc.task };
+}
+/**
+ * Build an `[Inputs]` context block from a map of resolved port inputs.
+ * Each input is rendered on its own line as `name: <value>` with an
+ * optional trailing `# <description>` comment so the model has both the
+ * value and the reason it matters.
+ *
+ * The block is *only* useful for AI tasks; command tasks consume inputs
+ * through `{{inputs.X}}` substitution in their command line and do not
+ * need this context.
+ *
+ * Returns null when there are no inputs to render — callers can forward
+ * that nullish value to `prependContext` via an `if (block)` check so
+ * empty-input tasks don't grow a noise block in their prompt.
+ */
+export function renderInputsBlock(inputsDecl, values) {
+    if (!inputsDecl || inputsDecl.length === 0)
+        return null;
+    const lines = [];
+    for (const port of inputsDecl) {
+        if (!(port.name in values))
+            continue;
+        const raw = values[port.name];
+        const rendered = renderInputValue(raw);
+        const descr = port.description?.trim();
+        lines.push(descr ? `${port.name}: ${rendered}  # ${descr}` : `${port.name}: ${rendered}`);
+    }
+    if (lines.length === 0)
+        return null;
+    return { label: 'Inputs', content: lines.join('\n') };
+}
+function renderInputValue(value) {
+    if (value === null || value === undefined)
+        return '';
+    if (typeof value === 'string')
+        return JSON.stringify(value);
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+/**
+ * Build an `[Output Format]` context block from a task's declared output
+ * ports. The block instructs the model to emit a final-line JSON object
+ * matching the declared schema so `extractTaskOutputs` can pick it up
+ * without fragile heuristics. Returns null when the task declares no
+ * outputs.
+ *
+ * The instruction is deliberately short and explicit — a terse "emit
+ * this object as JSON on the final line" beats a long schema dump
+ * because shorter prompts compose better with downstream middlewares.
+ */
+export function renderOutputSchemaBlock(outputsDecl) {
+    if (!outputsDecl || outputsDecl.length === 0)
+        return null;
+    const lines = [];
+    lines.push('After your response, emit a single JSON object on the FINAL line with these keys:');
+    for (const port of outputsDecl) {
+        const descr = port.description?.trim();
+        const enumHint = port.type === 'enum' && port.enum?.length
+            ? ` (one of: ${port.enum.map((v) => JSON.stringify(v)).join(', ')})`
+            : '';
+        lines.push(descr
+            ? `  - ${port.name} (${port.type}${enumHint}): ${descr}`
+            : `  - ${port.name} (${port.type}${enumHint})`);
+    }
+    const example = buildExampleObject(outputsDecl);
+    lines.push('');
+    lines.push(`Example final line: ${JSON.stringify(example)}`);
+    return { label: 'Output Format', content: lines.join('\n') };
+}
+function buildExampleObject(outputsDecl) {
+    const example = {};
+    for (const port of outputsDecl) {
+        if (port.default !== undefined) {
+            example[port.name] = port.default;
+            continue;
+        }
+        switch (port.type) {
+            case 'string':
+                example[port.name] = '...';
+                break;
+            case 'number':
+                example[port.name] = 0;
+                break;
+            case 'boolean':
+                example[port.name] = false;
+                break;
+            case 'enum':
+                example[port.name] = port.enum?.[0] ?? '...';
+                break;
+            case 'json':
+            default:
+                example[port.name] = null;
+        }
+    }
+    return example;
+}
 //# sourceMappingURL=prompt-doc.js.map

package/dist/prompt-doc.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-doc.js","sourceRoot":"","sources":["../src/prompt-doc.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AAChC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAmB;IACzD,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC,IAAI,CAAC;IAC/C,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IACrE,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAmB,EACnB,KAAyB;IAEzB,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;AAChE,CAAC"}
+{"version":3,"file":"prompt-doc.js","sourceRoot":"","sources":["../src/prompt-doc.ts"],"names":[],"mappings":"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"}

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

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

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

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

package/dist/prompt-doc.test.js

@@ -0,0 +1,145 @@
+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

package/dist/prompt-doc.test.js.map

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