@studio-foundation/engine 0.3.0-beta.1 → 0.3.0-beta.5

package/dist/__tests__/engine.conditions-group.test.d.ts

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

package/dist/__tests__/engine.conditions-group.test.d.ts.map

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

package/dist/__tests__/engine.conditions-group.test.js

@@ -0,0 +1,222 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { resolve } from 'node:path';
+import { PipelineEngine } from '../engine.js';
+vi.mock('@studio-foundation/runner', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        runScript: vi.fn(),
+    };
+});
+import { runScript } from '@studio-foundation/runner';
+const FIXTURES_DIR = resolve(__dirname, '__fixtures__/script-stage');
+function makeEngine() {
+    return new PipelineEngine({
+        configsDir: FIXTURES_DIR,
+        providerRegistry: {},
+    });
+}
+describe('engine — conditions inside sequential groups', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('skips a conditional stage inside a sequential group', async () => {
+        vi.mocked(runScript).mockResolvedValue({
+            output: { done: true },
+            tool_calls: [],
+            tool_calls_count: 0,
+            duration_ms: 10,
+        });
+        const pipeline = {
+            name: 'test-group-conditions',
+            description: 'test',
+            version: 1,
+            stages: [
+                {
+                    group: 'processing',
+                    max_iterations: 1,
+                    stages: [
+                        {
+                            name: 'always-runs',
+                            executor: 'script',
+                            script: 'scripts/run.py',
+                            runtime: 'shell',
+                        },
+                        {
+                            name: 'conditional-in-group',
+                            executor: 'script',
+                            script: 'scripts/optional.py',
+                            runtime: 'shell',
+                            condition: 'input.optional >= 1',
+                        },
+                    ],
+                },
+            ],
+        };
+        const engine = makeEngine();
+        const result = await engine.run({
+            pipelineDef: pipeline,
+            input: { optional: 0 },
+        });
+        expect(result.status).toBe('success');
+        expect(result.stages[0]?.status).toBe('success');
+        expect(result.stages[1]?.status).toBe('skipped');
+        expect(vi.mocked(runScript)).toHaveBeenCalledTimes(1);
+    });
+    it('marks group as skipped when all stages in sequential group are skipped', async () => {
+        vi.mocked(runScript).mockResolvedValue({
+            output: { done: true },
+            tool_calls: [],
+            tool_calls_count: 0,
+            duration_ms: 10,
+        });
+        // A stage after the group should still run
+        const pipeline = {
+            name: 'test-all-skipped-group',
+            description: 'test',
+            version: 1,
+            stages: [
+                {
+                    group: 'optional-processing',
+                    max_iterations: 1,
+                    stages: [
+                        {
+                            name: 'optional-a',
+                            executor: 'script',
+                            script: 'scripts/a.py',
+                            runtime: 'shell',
+                            condition: 'input.run_optional >= 1',
+                        },
+                        {
+                            name: 'optional-b',
+                            executor: 'script',
+                            script: 'scripts/b.py',
+                            runtime: 'shell',
+                            condition: 'input.run_optional >= 1',
+                        },
+                    ],
+                },
+                {
+                    name: 'post-group-stage',
+                    executor: 'script',
+                    script: 'scripts/final.py',
+                    runtime: 'shell',
+                },
+            ],
+        };
+        const engine = makeEngine();
+        const result = await engine.run({
+            pipelineDef: pipeline,
+            input: { run_optional: 0 },
+        });
+        expect(result.status).toBe('success');
+        // Both group stages skipped
+        expect(result.stages[0]?.status).toBe('skipped');
+        expect(result.stages[1]?.status).toBe('skipped');
+        // Post-group stage ran
+        expect(result.stages[2]?.status).toBe('success');
+        expect(vi.mocked(runScript)).toHaveBeenCalledTimes(1); // only post-group-stage
+    });
+});
+describe('engine — conditions inside parallel groups', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('marks parallel group as skipped when all stages are skipped', async () => {
+        vi.mocked(runScript).mockResolvedValue({
+            output: { done: true },
+            tool_calls: [],
+            tool_calls_count: 0,
+            duration_ms: 10,
+        });
+        const pipeline = {
+            name: 'test-parallel-all-skipped',
+            description: 'test',
+            version: 1,
+            stages: [
+                {
+                    group: 'optional-parallel',
+                    max_iterations: 1,
+                    mode: 'parallel',
+                    stages: [
+                        {
+                            name: 'parallel-a',
+                            executor: 'script',
+                            script: 'scripts/a.py',
+                            runtime: 'shell',
+                            condition: 'input.enabled >= 1',
+                        },
+                        {
+                            name: 'parallel-b',
+                            executor: 'script',
+                            script: 'scripts/b.py',
+                            runtime: 'shell',
+                            condition: 'input.enabled >= 1',
+                        },
+                    ],
+                },
+                {
+                    name: 'post-group',
+                    executor: 'script',
+                    script: 'scripts/final.py',
+                    runtime: 'shell',
+                },
+            ],
+        };
+        const engine = makeEngine();
+        const result = await engine.run({
+            pipelineDef: pipeline,
+            input: { enabled: 0 },
+        });
+        expect(result.status).toBe('success');
+        expect(result.stages[0]?.status).toBe('skipped');
+        expect(result.stages[1]?.status).toBe('skipped');
+        expect(result.stages[2]?.status).toBe('success');
+        expect(vi.mocked(runScript)).toHaveBeenCalledTimes(1); // only post-group
+    });
+    it('runs parallel group normally when at least one stage is not skipped', async () => {
+        vi.mocked(runScript).mockResolvedValue({
+            output: { done: true },
+            tool_calls: [],
+            tool_calls_count: 0,
+            duration_ms: 10,
+        });
+        const pipeline = {
+            name: 'test-parallel-partial-skip',
+            description: 'test',
+            version: 1,
+            stages: [
+                {
+                    group: 'mixed-parallel',
+                    max_iterations: 1,
+                    mode: 'parallel',
+                    stages: [
+                        {
+                            name: 'always-runs',
+                            executor: 'script',
+                            script: 'scripts/a.py',
+                            runtime: 'shell',
+                        },
+                        {
+                            name: 'conditional',
+                            executor: 'script',
+                            script: 'scripts/b.py',
+                            runtime: 'shell',
+                            condition: 'input.enabled >= 1',
+                        },
+                    ],
+                },
+            ],
+        };
+        const engine = makeEngine();
+        const result = await engine.run({
+            pipelineDef: pipeline,
+            input: { enabled: 0 },
+        });
+        expect(result.status).toBe('success');
+        expect(result.stages[0]?.status).toBe('success');
+        expect(result.stages[1]?.status).toBe('skipped');
+        expect(vi.mocked(runScript)).toHaveBeenCalledTimes(1); // only always-runs
+    });
+});
+//# sourceMappingURL=engine.conditions-group.test.js.map

package/dist/__tests__/engine.conditions-group.test.js.map

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

package/dist/__tests__/engine.conditions.test.d.ts

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

package/dist/__tests__/engine.conditions.test.d.ts.map

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

package/dist/__tests__/engine.conditions.test.js

@@ -0,0 +1,164 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { resolve } from 'node:path';
+import { PipelineEngine } from '../engine.js';
+// Mock the runner so we can inspect which stages actually ran
+vi.mock('@studio-foundation/runner', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        runScript: vi.fn(),
+    };
+});
+import { runScript } from '@studio-foundation/runner';
+const FIXTURES_DIR = resolve(__dirname, '__fixtures__/script-stage');
+function makeEngine() {
+    return new PipelineEngine({
+        configsDir: FIXTURES_DIR,
+        providerRegistry: {},
+    });
+}
+function mockScriptSuccess(output = { result: 'ok' }) {
+    vi.mocked(runScript).mockResolvedValue({
+        output,
+        tool_calls: [],
+        tool_calls_count: 0,
+        duration_ms: 10,
+    });
+}
+describe('engine — stage conditions', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('skips a stage when input condition is false', async () => {
+        mockScriptSuccess();
+        const pipeline = {
+            name: 'test-conditions',
+            description: 'test',
+            version: 1,
+            stages: [
+                {
+                    name: 'always-runs',
+                    executor: 'script',
+                    script: 'scripts/parse.py',
+                    runtime: 'shell',
+                },
+                {
+                    name: 'conditional-stage',
+                    executor: 'script',
+                    script: 'scripts/parse.py',
+                    runtime: 'shell',
+                    condition: 'input.meals_count >= 6',
+                },
+            ],
+        };
+        const engine = makeEngine();
+        const result = await engine.run({
+            pipelineDef: pipeline,
+            input: { meals_count: 3 }, // condition is false — stage should skip
+        });
+        expect(result.status).toBe('success');
+        expect(result.stages).toHaveLength(2);
+        expect(result.stages[0]?.status).toBe('success');
+        expect(result.stages[1]?.status).toBe('skipped');
+        // Script was only called once (for always-runs, not conditional-stage)
+        expect(vi.mocked(runScript)).toHaveBeenCalledTimes(1);
+    });
+    it('runs a stage when input condition is true', async () => {
+        mockScriptSuccess();
+        const pipeline = {
+            name: 'test-conditions-true',
+            description: 'test',
+            version: 1,
+            stages: [
+                {
+                    name: 'conditional-stage',
+                    executor: 'script',
+                    script: 'scripts/parse.py',
+                    runtime: 'shell',
+                    condition: 'input.meals_count >= 6',
+                },
+            ],
+        };
+        const engine = makeEngine();
+        const result = await engine.run({
+            pipelineDef: pipeline,
+            input: { meals_count: 7 }, // condition is true — stage should run
+        });
+        expect(result.status).toBe('success');
+        expect(result.stages[0]?.status).toBe('success');
+        expect(vi.mocked(runScript)).toHaveBeenCalledTimes(1);
+    });
+    it('skips a stage based on previous stage output', async () => {
+        // First call returns extraction result, second call would be entity-resolution
+        vi.mocked(runScript).mockResolvedValueOnce({
+            output: { counts: { OTHER: 0, PERSON: 2 } },
+            tool_calls: [],
+            tool_calls_count: 0,
+            duration_ms: 10,
+        });
+        const pipeline = {
+            name: 'test-conditions-stage-output',
+            description: 'test',
+            version: 1,
+            stages: [
+                {
+                    name: 'entity-extraction',
+                    executor: 'script',
+                    script: 'scripts/extract.py',
+                    runtime: 'shell',
+                    context: { include: ['input'] },
+                },
+                {
+                    name: 'entity-resolution-OTHER',
+                    executor: 'script',
+                    script: 'scripts/resolve.py',
+                    runtime: 'shell',
+                    condition: 'stages.entity-extraction.output.counts.OTHER > 0',
+                    context: { include: ['all_stage_outputs'] },
+                },
+            ],
+        };
+        const engine = makeEngine();
+        const result = await engine.run({
+            pipelineDef: pipeline,
+            input: 'extract entities',
+        });
+        expect(result.status).toBe('success');
+        expect(result.stages[0]?.status).toBe('success');
+        expect(result.stages[1]?.status).toBe('skipped'); // counts.OTHER is 0
+        expect(vi.mocked(runScript)).toHaveBeenCalledTimes(1); // only extraction ran
+    });
+    it('pipeline continues after skipped stage', async () => {
+        mockScriptSuccess({ final: 'result' });
+        const pipeline = {
+            name: 'test-skip-continues',
+            description: 'test',
+            version: 1,
+            stages: [
+                {
+                    name: 'skipped-stage',
+                    executor: 'script',
+                    script: 'scripts/parse.py',
+                    runtime: 'shell',
+                    condition: 'input.run_optional >= 1',
+                },
+                {
+                    name: 'final-stage',
+                    executor: 'script',
+                    script: 'scripts/finalize.py',
+                    runtime: 'shell',
+                },
+            ],
+        };
+        const engine = makeEngine();
+        const result = await engine.run({
+            pipelineDef: pipeline,
+            input: { run_optional: 0 },
+        });
+        expect(result.status).toBe('success');
+        expect(result.stages[0]?.status).toBe('skipped');
+        expect(result.stages[1]?.status).toBe('success');
+        expect(vi.mocked(runScript)).toHaveBeenCalledTimes(1); // only final-stage
+    });
+});
+//# sourceMappingURL=engine.conditions.test.js.map

package/dist/__tests__/engine.conditions.test.js.map

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

package/dist/__tests__/engine.resume.test.d.ts

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

package/dist/__tests__/engine.resume.test.d.ts.map

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

package/dist/__tests__/engine.resume.test.js

@@ -0,0 +1,93 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { PipelineEngine } from '../engine.js';
+vi.mock('@studio-foundation/runner', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        runScript: vi.fn(),
+    };
+});
+import { runScript } from '@studio-foundation/runner';
+function makeEngine() {
+    return new PipelineEngine({
+        configsDir: '/tmp',
+        providerRegistry: {},
+    });
+}
+function mockScriptSuccess(output = { result: 'ok' }) {
+    vi.mocked(runScript).mockResolvedValue({
+        output,
+        tool_calls: [],
+        tool_calls_count: 0,
+        duration_ms: 10,
+    });
+}
+describe('engine — resume from stage', () => {
+    beforeEach(() => vi.clearAllMocks());
+    const pipeline = {
+        name: 'test-resume',
+        description: 'test',
+        version: 1,
+        stages: [
+            { name: 'stage-a', executor: 'script', script: 'x.py', runtime: 'shell' },
+            { name: 'stage-b', executor: 'script', script: 'x.py', runtime: 'shell' },
+            { name: 'stage-c', executor: 'script', script: 'x.py', runtime: 'shell' },
+        ],
+    };
+    it('skips stages before resumeFromStage and marks them skipped', async () => {
+        mockScriptSuccess({ result: 'c-result' });
+        const engine = makeEngine();
+        const result = await engine.run({
+            pipelineDef: pipeline,
+            input: { x: 1 },
+            resumeFromStage: 'stage-c',
+            priorStageOutputs: new Map([
+                ['stage-a', { result: 'a-cached' }],
+                ['stage-b', { result: 'b-cached' }],
+            ]),
+            originalRunId: 'abc12345',
+        });
+        expect(result.status).toBe('success');
+        expect(result.stages).toHaveLength(3);
+        expect(result.stages[0]?.stage_name).toBe('stage-a');
+        expect(result.stages[0]?.status).toBe('skipped');
+        expect(result.stages[0]?.skipped_reason).toContain('abc12345');
+        expect(result.stages[1]?.stage_name).toBe('stage-b');
+        expect(result.stages[1]?.status).toBe('skipped');
+        expect(result.stages[2]?.stage_name).toBe('stage-c');
+        expect(result.stages[2]?.status).toBe('success');
+        // Only stage-c was actually executed
+        expect(vi.mocked(runScript)).toHaveBeenCalledTimes(1);
+    });
+    it('pre-populates context so resumed stage can access prior outputs', async () => {
+        mockScriptSuccess({ result: 'ok' });
+        const engine = makeEngine();
+        const result = await engine.run({
+            pipelineDef: {
+                ...pipeline,
+                stages: [
+                    { name: 'stage-a', executor: 'script', script: 'x.py', runtime: 'shell' },
+                    { name: 'stage-b', executor: 'script', script: 'x.py', runtime: 'shell' },
+                ],
+            },
+            input: { x: 1 },
+            resumeFromStage: 'stage-b',
+            priorStageOutputs: new Map([['stage-a', { result: 'a-cached' }]]),
+        });
+        // stage-b ran successfully (prior context was pre-populated, no crash)
+        expect(result.status).toBe('success');
+        expect(result.stages).toHaveLength(2);
+        expect(result.stages[0]?.status).toBe('skipped');
+        expect(result.stages[1]?.status).toBe('success');
+    });
+    it('throws if resumeFromStage is not found in pipeline', async () => {
+        const engine = makeEngine();
+        await expect(engine.run({
+            pipelineDef: pipeline,
+            input: {},
+            resumeFromStage: 'nonexistent-stage',
+            priorStageOutputs: new Map(),
+        })).rejects.toThrow(/not found/i);
+    });
+});
+//# sourceMappingURL=engine.resume.test.js.map

package/dist/__tests__/engine.resume.test.js.map

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

package/dist/__tests__/engine.script-stage.test.d.ts

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

package/dist/__tests__/engine.script-stage.test.d.ts.map

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

package/dist/__tests__/engine.script-stage.test.js

@@ -0,0 +1,108 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { resolve } from 'node:path';
+import { PipelineEngine } from '../engine.js';
+// Mock runScript from runner to avoid real subprocess spawning
+vi.mock('@studio-foundation/runner', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        runScript: vi.fn(),
+    };
+});
+import { runScript } from '@studio-foundation/runner';
+const FIXTURES_DIR = resolve(__dirname, '__fixtures__/script-stage');
+const SCRIPT_PIPELINE = {
+    name: 'test-script-pipeline',
+    description: 'Test pipeline with script stage',
+    version: 1,
+    stages: [
+        {
+            name: 'epub-ingestion',
+            executor: 'script',
+            script: 'scripts/parse.py',
+            runtime: 'python',
+            contract: 'book-context',
+        },
+    ],
+};
+function makeEngine() {
+    return new PipelineEngine({
+        configsDir: FIXTURES_DIR,
+        providerRegistry: {},
+    });
+}
+describe('engine — script stage execution', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('executes a script stage and returns success when output matches contract', async () => {
+        vi.mocked(runScript).mockResolvedValue({
+            output: { title: 'My Book', chapters: 3 },
+            tool_calls: [],
+            tool_calls_count: 0,
+            duration_ms: 50,
+        });
+        const engine = makeEngine();
+        const result = await engine.run({
+            pipelineDef: SCRIPT_PIPELINE,
+            userInput: 'parse book.epub',
+        });
+        expect(result.status).toBe('success');
+        expect(result.stages[0]?.status).toBe('success');
+        expect(result.stages[0]?.output).toEqual({ title: 'My Book', chapters: 3 });
+        expect(vi.mocked(runScript)).toHaveBeenCalledTimes(1);
+        expect(vi.mocked(runScript)).toHaveBeenCalledWith(expect.objectContaining({
+            scriptPath: 'scripts/parse.py',
+            runtime: 'python',
+        }));
+    });
+    it('retries on script error (runScript returns error field)', async () => {
+        const scriptError = {
+            output: null,
+            tool_calls: [],
+            tool_calls_count: 0,
+            duration_ms: 10,
+            error: 'Script exited with code 1: parse error',
+        };
+        vi.mocked(runScript)
+            .mockResolvedValueOnce(scriptError)
+            .mockResolvedValueOnce(scriptError)
+            .mockResolvedValue({
+            output: { title: 'My Book', chapters: 3 },
+            tool_calls: [],
+            tool_calls_count: 0,
+            duration_ms: 50,
+        });
+        const engine = makeEngine();
+        const result = await engine.run({
+            pipelineDef: {
+                ...SCRIPT_PIPELINE,
+                stages: [{ ...SCRIPT_PIPELINE.stages[0], ralph: { max_attempts: 3, retry_strategy: 'none' } }],
+            },
+            userInput: 'parse book.epub',
+        });
+        expect(result.status).toBe('success');
+        expect(vi.mocked(runScript)).toHaveBeenCalledTimes(3);
+    });
+    it('fails stage after exhausting max_attempts', async () => {
+        vi.mocked(runScript).mockResolvedValue({
+            output: null,
+            tool_calls: [],
+            tool_calls_count: 0,
+            duration_ms: 10,
+            error: 'Script exited with code 1: always failing',
+        });
+        const engine = makeEngine();
+        const result = await engine.run({
+            pipelineDef: {
+                ...SCRIPT_PIPELINE,
+                stages: [{ ...SCRIPT_PIPELINE.stages[0], ralph: { max_attempts: 2, retry_strategy: 'none' } }],
+            },
+            userInput: 'parse book.epub',
+        });
+        expect(result.status).toBe('failed');
+        expect(result.stages[0]?.status).toBe('failed');
+        expect(vi.mocked(runScript)).toHaveBeenCalledTimes(2);
+    });
+});
+//# sourceMappingURL=engine.script-stage.test.js.map

package/dist/__tests__/engine.script-stage.test.js.map

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