@ddse/acm-examples 0.5.0

package/dist/src/tools/invoices/index.js

@@ -0,0 +1,85 @@
+import { Tool } from '@ddse/acm-sdk';
+import { getInvoice, getPurchaseOrder, compareLineItems, } from '../../data/invoices.js';
+export class FetchInvoiceTool extends Tool {
+    name() {
+        return 'fetch_invoice';
+    }
+    async call(input) {
+        if (!input?.invoiceId) {
+            throw new Error('invoiceId is required');
+        }
+        const invoice = await getInvoice(input.invoiceId);
+        if (!invoice) {
+            throw new Error(`Invoice ${input.invoiceId} not found`);
+        }
+        return { invoice };
+    }
+}
+export class FetchPurchaseOrderTool extends Tool {
+    name() {
+        return 'fetch_purchase_order';
+    }
+    async call(input) {
+        if (!input?.purchaseOrderId) {
+            throw new Error('purchaseOrderId is required');
+        }
+        const purchaseOrder = await getPurchaseOrder(input.purchaseOrderId);
+        if (!purchaseOrder) {
+            throw new Error(`Purchase order ${input.purchaseOrderId} not found`);
+        }
+        return { purchaseOrder };
+    }
+}
+export class CompareLineItemsTool extends Tool {
+    name() {
+        return 'compare_line_items';
+    }
+    async call(input) {
+        if (!input?.invoice || !input?.purchaseOrder) {
+            throw new Error('invoice and purchaseOrder are required');
+        }
+        const discrepancies = compareLineItems(input.invoice, input.purchaseOrder).map(item => ({
+            ...item,
+            varianceAmount: (item.actualQuantity - item.expectedQuantity) * item.expectedPrice ||
+                (item.actualPrice - item.expectedPrice) * item.actualQuantity,
+        }));
+        const matchedLines = input.invoice.lines.length - discrepancies.length;
+        const variance = discrepancies.reduce((sum, item) => sum + item.varianceAmount, 0);
+        return {
+            discrepancies,
+            variance,
+            matchedLines,
+        };
+    }
+}
+export class RecordFindingsTool extends Tool {
+    name() {
+        return 'record_findings';
+    }
+    async call(input) {
+        if (!input?.invoice || !input?.purchaseOrder) {
+            throw new Error('invoice and purchaseOrder are required');
+        }
+        const status = input.discrepancies.length === 0 && Math.abs(input.variance) < 1
+            ? 'clean'
+            : 'needs_remediation';
+        const summary = status === 'clean'
+            ? `Invoice ${input.invoice.id} matches purchase order ${input.purchaseOrder.id}`
+            : `Invoice ${input.invoice.id} has ${input.discrepancies.length} discrepancy(s)`;
+        const nextSteps = status === 'clean'
+            ? ['Archive reconciliation report in AP system']
+            : [
+                'Open remediation ticket with procurement',
+                'Notify accounts payable supervisor',
+                'Schedule supplier follow-up call',
+            ];
+        return {
+            reportId: `recon-${Date.now()}`,
+            status,
+            summary,
+            nextSteps,
+            generatedAt: new Date().toISOString(),
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/src/tools/invoices/index.js.map

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

package/dist/src/tools/knowledge/index.d.ts

@@ -0,0 +1,52 @@
+import { Tool } from '@ddse/acm-sdk';
+import { type KnowledgeSnippetMeta } from '../../data/knowledge.js';
+export type KnowledgeSearchInput = {
+    query: string;
+    limit?: number;
+};
+export type KnowledgeSearchHit = KnowledgeSnippetMeta & {
+    score: number;
+};
+export type KnowledgeSearchOutput = {
+    hits: KnowledgeSearchHit[];
+};
+export declare class SearchKnowledgeTool extends Tool<KnowledgeSearchInput, KnowledgeSearchOutput> {
+    name(): string;
+    call(input: KnowledgeSearchInput): Promise<KnowledgeSearchOutput>;
+}
+export type SummarizeSnippetInput = {
+    docId: string;
+    maxSentences?: number;
+    focus?: string;
+};
+export type SummarizeSnippetOutput = {
+    docId: string;
+    title: string;
+    summary: string;
+    highlights: string[];
+    followups: string[];
+};
+export declare class SummarizeSnippetTool extends Tool<SummarizeSnippetInput, SummarizeSnippetOutput> {
+    name(): string;
+    call(input: SummarizeSnippetInput): Promise<SummarizeSnippetOutput>;
+}
+export type SuggestFollowupsInput = {
+    docId: string;
+    context?: {
+        channel?: string;
+        urgency?: 'low' | 'normal' | 'high';
+    };
+};
+export type SuggestFollowupsOutput = {
+    docId: string;
+    suggestions: Array<{
+        action: string;
+        owner: string;
+        dueInHours: number;
+    }>;
+};
+export declare class SuggestFollowupsTool extends Tool<SuggestFollowupsInput, SuggestFollowupsOutput> {
+    name(): string;
+    call(input: SuggestFollowupsInput): Promise<SuggestFollowupsOutput>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/src/tools/knowledge/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/knowledge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,yBAAyB,CAAC;AAEjC,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,oBAAoB,GAAG;IACtD,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,kBAAkB,EAAE,CAAC;CAC5B,CAAC;AAEF,qBAAa,mBAAoB,SAAQ,IAAI,CAAC,oBAAoB,EAAE,qBAAqB,CAAC;IACxF,IAAI,IAAI,MAAM;IAIR,IAAI,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAgBxE;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AA4DF,qBAAa,oBAAqB,SAAQ,IAAI,CAC5C,qBAAqB,EACrB,sBAAsB,CACvB;IACC,IAAI,IAAI,MAAM;IAIR,IAAI,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;CA2B1E;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;KACrC,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,KAAK,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;CACJ,CAAC;AAEF,qBAAa,oBAAqB,SAAQ,IAAI,CAC5C,qBAAqB,EACrB,sBAAsB,CACvB;IACC,IAAI,IAAI,MAAM;IAIR,IAAI,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;CAwB1E"}

package/dist/src/tools/knowledge/index.js

@@ -0,0 +1,120 @@
+import { Tool } from '@ddse/acm-sdk';
+import { searchSnippets, loadSnippetContent, getSnippetMeta, } from '../../data/knowledge.js';
+export class SearchKnowledgeTool extends Tool {
+    name() {
+        return 'search_knowledge';
+    }
+    async call(input) {
+        const query = input?.query?.trim();
+        if (!query) {
+            throw new Error('query is required');
+        }
+        const limit = Math.max(1, Math.min(input.limit ?? 5, 10));
+        const snippets = await searchSnippets(query);
+        const hits = snippets.slice(0, limit).map((snippet, index) => ({
+            ...snippet,
+            score: Math.max(1, snippets.length - index),
+        }));
+        return { hits };
+    }
+}
+function summarizeContent(content, maxSentences) {
+    const sentences = content
+        .replace(/\s+/g, ' ')
+        .split(/(?<=[.!?])\s+(?=[A-Z0-9])/)
+        .filter(Boolean);
+    if (sentences.length === 0) {
+        return content.trim();
+    }
+    return sentences.slice(0, maxSentences).join(' ');
+}
+function extractHighlights(content, maxHighlights = 3) {
+    const lines = content.split(/\r?\n/).map(line => line.trim()).filter(Boolean);
+    const bulletLines = lines.filter(line => /^[-*]/.test(line));
+    const highlights = [];
+    for (const line of bulletLines) {
+        highlights.push(line.replace(/^[-*]\s*/, ''));
+        if (highlights.length >= maxHighlights) {
+            break;
+        }
+    }
+    if (highlights.length === 0) {
+        highlights.push(...lines.slice(0, maxHighlights));
+    }
+    return highlights.slice(0, maxHighlights);
+}
+function deriveFollowups(meta, focus) {
+    const followups = new Set();
+    for (const tag of meta.tags) {
+        if (tag.toLowerCase().includes('escalation')) {
+            followups.add('Confirm escalation steps with runbook owner');
+        }
+        if (tag.toLowerCase().includes('training')) {
+            followups.add('Share summary with enablement channel for awareness');
+        }
+        if (tag.toLowerCase().includes('automation')) {
+            followups.add('Evaluate automation opportunity with platform team');
+        }
+    }
+    if (focus) {
+        followups.add(`Identify additional knowledge gaps related to "${focus}"`);
+    }
+    if (followups.size === 0) {
+        followups.add('Log follow-up tasks in support queue');
+    }
+    return Array.from(followups);
+}
+export class SummarizeSnippetTool extends Tool {
+    name() {
+        return 'summarize_snippet';
+    }
+    async call(input) {
+        if (!input?.docId) {
+            throw new Error('docId is required');
+        }
+        const [meta, content] = await Promise.all([
+            getSnippetMeta(input.docId),
+            loadSnippetContent(input.docId),
+        ]);
+        if (!meta || !content) {
+            throw new Error(`Snippet ${input.docId} not found`);
+        }
+        const maxSentences = Math.max(1, Math.min(input.maxSentences ?? 3, 6));
+        const summary = summarizeContent(content, maxSentences);
+        const highlights = extractHighlights(content);
+        const followups = deriveFollowups(meta, input.focus);
+        return {
+            docId: input.docId,
+            title: meta.title,
+            summary,
+            highlights,
+            followups,
+        };
+    }
+}
+export class SuggestFollowupsTool extends Tool {
+    name() {
+        return 'suggest_followups';
+    }
+    async call(input) {
+        if (!input?.docId) {
+            throw new Error('docId is required');
+        }
+        const meta = await getSnippetMeta(input.docId);
+        if (!meta) {
+            throw new Error(`Snippet ${input.docId} not found`);
+        }
+        const baseDue = input.context?.urgency === 'high' ? 4 : input.context?.urgency === 'low' ? 24 : 8;
+        const suggestions = deriveFollowups(meta)
+            .map((action, index) => ({
+            action,
+            owner: index === 0 ? 'support.enablement' : 'support.lead',
+            dueInHours: baseDue + index * 4,
+        }));
+        return {
+            docId: input.docId,
+            suggestions,
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/src/tools/knowledge/index.js.map

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

package/dist/tests/bm25.test.d.ts

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

package/dist/tests/bm25.test.d.ts.map

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

package/dist/tests/bm25.test.js

@@ -0,0 +1,98 @@
+// Tests for BM25 search functionality
+import { BM25Search } from '../src/search/bm25.js';
+async function testIndexAndSearch() {
+    console.log('Testing index and search...');
+    const documents = [
+        { id: 'doc1', content: 'The quick brown fox jumps over the lazy dog' },
+        { id: 'doc2', content: 'A fast brown fox leaps over a sleepy dog' },
+        { id: 'doc3', content: 'The cat sits on the mat' },
+    ];
+    const search = new BM25Search();
+    search.index(documents);
+    const results = search.search('brown fox');
+    if (results.length === 0) {
+        throw new Error('Expected results, got none');
+    }
+    if (!['doc1', 'doc2'].includes(results[0].document.id)) {
+        throw new Error(`Expected doc1 or doc2, got ${results[0].document.id}`);
+    }
+    console.log('✅ Index and search test passed');
+}
+async function testEmptyQuery() {
+    console.log('Testing empty query...');
+    const documents = [{ id: 'doc1', content: 'Test document' }];
+    const search = new BM25Search();
+    search.index(documents);
+    const results = search.search('');
+    if (results.length !== 0) {
+        throw new Error('Expected empty results for empty query');
+    }
+    console.log('✅ Empty query test passed');
+}
+async function testRanking() {
+    console.log('Testing ranking...');
+    const documents = [
+        { id: 'doc1', content: 'machine learning algorithms' },
+        { id: 'doc2', content: 'learning machine code' },
+        { id: 'doc3', content: 'deep learning neural networks' },
+    ];
+    const search = new BM25Search();
+    search.index(documents);
+    const results = search.search('machine learning');
+    if (results.length < 2) {
+        throw new Error('Expected at least 2 results');
+    }
+    if (results[0].score < results[1].score) {
+        throw new Error('Results not properly ranked');
+    }
+    console.log('✅ Ranking test passed');
+}
+async function testLimitParameter() {
+    console.log('Testing limit parameter...');
+    const documents = Array.from({ length: 10 }, (_, i) => ({
+        id: `doc${i}`,
+        content: `Document ${i} with test content`,
+    }));
+    const search = new BM25Search();
+    search.index(documents);
+    const results = search.search('test', 3);
+    if (results.length > 3) {
+        throw new Error(`Expected max 3 results, got ${results.length}`);
+    }
+    console.log('✅ Limit parameter test passed');
+}
+async function runTests() {
+    console.log('Running BM25 Search Tests\n');
+    console.log('='.repeat(50));
+    const tests = [
+        testIndexAndSearch,
+        testEmptyQuery,
+        testRanking,
+        testLimitParameter,
+    ];
+    let passed = 0;
+    let failed = 0;
+    for (const test of tests) {
+        try {
+            await test();
+            passed++;
+        }
+        catch (error) {
+            console.error(`❌ Test failed: ${error}`);
+            failed++;
+        }
+    }
+    console.log('\n' + '='.repeat(50));
+    console.log(`Results: ${passed} passed, ${failed} failed\n`);
+    return failed === 0;
+}
+// Run if executed directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    runTests().then(success => {
+        process.exit(success ? 0 : 1);
+    }).catch(error => {
+        console.error('Test runner error:', error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=bm25.test.js.map

package/dist/tests/bm25.test.js.map

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

package/dist/tests/integration.test.d.ts

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

package/dist/tests/integration.test.d.ts.map

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

package/dist/tests/integration.test.js

@@ -0,0 +1,126 @@
+// Integration test for ACM framework
+import { ExternalContextProviderAdapter, } from '@ddse/acm-sdk';
+import { MemoryLedger } from '@ddse/acm-runtime';
+import { ACMFramework } from '@ddse/acm-framework';
+import { SimpleCapabilityRegistry, SimpleToolRegistry } from '../src/registries.js';
+import { registerExampleContextProviders } from '../src/context/index.js';
+import { listScenarioKeys, scenarios } from '../src/examples/scenarios.js';
+const stubLLMCall = async () => ({
+    reasoning: '',
+    toolCalls: [],
+    raw: {},
+});
+function createVerifyFn() {
+    return async (taskId, output, expressions) => {
+        for (const expr of expressions) {
+            try {
+                const fn = new Function('output', `return ${expr};`);
+                const result = fn(output);
+                if (!result) {
+                    console.error(`Verification failed for ${taskId}: ${expr}`);
+                    return false;
+                }
+            }
+            catch (error) {
+                console.error(`Verification error for ${taskId}: ${expr}`, error);
+                return false;
+            }
+        }
+        return true;
+    };
+}
+async function runScenario(definition) {
+    console.log(`\n▶️  Scenario: ${definition.name} (${definition.key})`);
+    const toolRegistry = new SimpleToolRegistry();
+    const capabilityRegistry = new SimpleCapabilityRegistry();
+    definition.registerTools(toolRegistry);
+    definition.registerCapabilities(capabilityRegistry);
+    const adapter = new ExternalContextProviderAdapter();
+    registerExampleContextProviders(adapter);
+    const framework = ACMFramework.create({
+        capabilityRegistry,
+        toolRegistry,
+        nucleus: {
+            call: stubLLMCall,
+            llmConfig: {
+                provider: 'test',
+                model: 'stub',
+                temperature: 0,
+                maxTokens: 0,
+            },
+            hooks: {
+                preflight: false,
+                postcheck: false,
+            },
+        },
+        verify: createVerifyFn(),
+        contextProvider: adapter,
+    });
+    const reference = await definition.buildReferencePlan();
+    const plan = reference.plan;
+    const ledger = new MemoryLedger();
+    const executeResult = await framework.execute({
+        goal: definition.goal,
+        context: definition.context,
+        ledger,
+        existingPlan: {
+            plan,
+            plannerResult: {
+                plans: [plan],
+                contextRef: plan.contextRef,
+                rationale: `${definition.name} reference plan`,
+            },
+        },
+    });
+    definition.assertExecution(executeResult.execution);
+    console.log('   ✅ Execution succeeded');
+    for (const task of plan.tasks) {
+        const record = executeResult.execution.outputsByTask?.[task.id];
+        if (!record?.output) {
+            throw new Error(`Task ${task.id} did not produce an output`);
+        }
+    }
+    if (executeResult.execution.ledger.length === 0) {
+        throw new Error('Ledger is empty after execution');
+    }
+}
+async function runIntegrationSuite() {
+    console.log('Running ACM Scenario Integration Suite');
+    console.log('='.repeat(50));
+    const keys = listScenarioKeys();
+    const results = [];
+    for (const key of keys) {
+        const scenario = scenarios[key];
+        try {
+            await runScenario(scenario);
+            results.push({ scenario, success: true });
+        }
+        catch (error) {
+            console.error(`   ❌ Scenario failed: ${scenario.name}`);
+            console.error(error);
+            results.push({ scenario, success: false, error });
+        }
+    }
+    const passed = results.filter(r => r.success).length;
+    const failed = results.length - passed;
+    console.log('\n' + '='.repeat(50));
+    console.log(`Summary: ${passed} passed, ${failed} failed`);
+    if (failed > 0) {
+        console.log('\nFailed scenarios:');
+        for (const result of results.filter(r => !r.success)) {
+            console.log(` - ${result.scenario.name} (${result.scenario.key})`);
+        }
+    }
+    return failed === 0;
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    runIntegrationSuite()
+        .then(success => {
+        process.exit(success ? 0 : 1);
+    })
+        .catch(error => {
+        console.error('Test runner error:', error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=integration.test.js.map

package/dist/tests/integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.test.js","sourceRoot":"","sources":["../../tests/integration.test.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,OAAO,EACL,8BAA8B,GAa/B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAA2B,MAAM,8BAA8B,CAAC;AAQpG,MAAM,WAAW,GAAc,KAAK,IAAI,EAAE,CAAC,CAAC;IAC1C,SAAS,EAAE,EAAE;IACb,SAAS,EAAE,EAAE;IACb,GAAG,EAAE,EAAE;CACR,CAAC,CAAC;AAEH,SAAS,cAAc;IACrB,OAAO,KAAK,EAAE,MAAc,EAAE,MAAW,EAAE,WAAqB,EAAoB,EAAE;QACpF,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,QAAQ,EAAE,UAAU,IAAI,GAAG,CAAC,CAAC;gBACrD,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC;gBAC1B,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,OAAO,CAAC,KAAK,CAAC,2BAA2B,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;oBAC5D,OAAO,KAAK,CAAC;gBACf,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,0BAA0B,MAAM,KAAK,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;gBAClE,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,UAA8B;IACvD,OAAO,CAAC,GAAG,CAAC,mBAAmB,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC;IAEtE,MAAM,YAAY,GAAG,IAAI,kBAAkB,EAAE,CAAC;IAC9C,MAAM,kBAAkB,GAAG,IAAI,wBAAwB,EAAE,CAAC;IAC1D,UAAU,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IACvC,UAAU,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,CAAC;IAEpD,MAAM,OAAO,GAAG,IAAI,8BAA8B,EAAE,CAAC;IACrD,+BAA+B,CAAC,OAAO,CAAC,CAAC;IAEzC,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC;QACpC,kBAAkB;QAClB,YAAY;QACZ,OAAO,EAAE;YACP,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE;gBACT,QAAQ,EAAE,MAAM;gBAChB,KAAK,EAAE,MAAM;gBACb,WAAW,EAAE,CAAC;gBACd,SAAS,EAAE,CAAC;aACb;YACD,KAAK,EAAE;gBACL,SAAS,EAAE,KAAK;gBAChB,SAAS,EAAE,KAAK;aACjB;SACF;QACD,MAAM,EAAE,cAAc,EAAE;QACxB,eAAe,EAAE,OAAO;KACzB,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,kBAAkB,EAAE,CAAC;IACxD,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;IAElC,MAAM,aAAa,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC;QAC5C,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,MAAM;QACN,YAAY,EAAE;YACZ,IAAI;YACJ,aAAa,EAAE;gBACb,KAAK,EAAE,CAAC,IAAI,CAAC;gBACb,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,SAAS,EAAE,GAAG,UAAU,CAAC,IAAI,iBAAiB;aAC/C;SACF;KACF,CAAC,CAAC;IAEH,UAAU,CAAC,eAAe,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IAEpD,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IAExC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,EAAE,4BAA4B,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,IAAI,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,mBAAmB;IAChC,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAE5B,MAAM,IAAI,GAAG,gBAAgB,EAAE,CAAC;IAChC,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,WAAW,CAAC,QAAQ,CAAC,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;YACxD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACrD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;IAEvC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,YAAY,MAAM,SAAS,CAAC,CAAC;IAE3D,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACnC,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;YACrD,OAAO,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,MAAM,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED,OAAO,MAAM,KAAK,CAAC,CAAC;AACtB,CAAC;AAED,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,mBAAmB,EAAE;SAClB,IAAI,CAAC,OAAO,CAAC,EAAE;QACd,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC;SACD,KAAK,CAAC,KAAK,CAAC,EAAE;QACb,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/tests/plan-hydration.test.d.ts

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

package/dist/tests/plan-hydration.test.d.ts.map

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

package/dist/tests/plan-hydration.test.js

@@ -0,0 +1,28 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { listScenarioKeys, scenarios } from '../src/examples/scenarios.js';
+describe('scenario reference plans', () => {
+    for (const key of listScenarioKeys()) {
+        const scenario = scenarios[key];
+        it(`produces deterministic reference plan for ${scenario.name}`, async () => {
+            const reference = await scenario.buildReferencePlan();
+            const plan = reference.plan;
+            assert.ok(plan, 'Expected a plan to be returned');
+            assert.ok(Array.isArray(plan.tasks) && plan.tasks.length > 0, 'Plan must include at least one task');
+            for (const task of plan.tasks ?? []) {
+                assert.ok(task.id, 'Task must include a stable id');
+                assert.ok(task.capability ?? task.capabilityRef, 'Task must include a capability reference');
+                assert.ok(task.input && Object.keys(task.input).length > 0, 'Task must include deterministic input');
+            }
+            if (Array.isArray(plan.edges)) {
+                for (const edge of plan.edges) {
+                    const fromExists = plan.tasks?.some(task => task.id === edge.from);
+                    const toExists = plan.tasks?.some(task => task.id === edge.to);
+                    assert.ok(fromExists, `Edge from ${edge.from} must reference an existing task`);
+                    assert.ok(toExists, `Edge to ${edge.to} must reference an existing task`);
+                }
+            }
+        });
+    }
+});
+//# sourceMappingURL=plan-hydration.test.js.map

package/dist/tests/plan-hydration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-hydration.test.js","sourceRoot":"","sources":["../../tests/plan-hydration.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAE3E,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAEhC,EAAE,CAAC,6CAA6C,QAAQ,CAAC,IAAI,EAAE,EAAE,KAAK,IAAI,EAAE;YAC1E,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,kBAAkB,EAAE,CAAC;YACtD,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;YAE5B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,gCAAgC,CAAC,CAAC;YAClD,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,qCAAqC,CAAC,CAAC;YAErG,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;gBACpC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,+BAA+B,CAAC,CAAC;gBACpD,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,aAAa,EAAE,0CAA0C,CAAC,CAAC;gBAC7F,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,uCAAuC,CAAC,CAAC;YACvG,CAAC;YAED,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;oBAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;oBACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC;oBAC/D,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,aAAa,IAAI,CAAC,IAAI,kCAAkC,CAAC,CAAC;oBAChF,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,WAAW,IAAI,CAAC,EAAE,kCAAkC,CAAC,CAAC;gBAC5E,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC"}