@arke-institute/rhiza 0.4.0 → 0.4.1

package/dist/__tests__/unit/handoff/per-item-routing.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Per-Item Routing Tests
+ *
+ * Tests for normalizeOutput and groupOutputsByTarget functions
+ * that enable per-item routing for scatter/pass handoffs.
+ */
+export {};
+//# sourceMappingURL=per-item-routing.test.d.ts.map

package/dist/__tests__/unit/handoff/per-item-routing.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"per-item-routing.test.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/unit/handoff/per-item-routing.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/__tests__/unit/handoff/per-item-routing.test.js

@@ -0,0 +1,209 @@
+/**
+ * Per-Item Routing Tests
+ *
+ * Tests for normalizeOutput and groupOutputsByTarget functions
+ * that enable per-item routing for scatter/pass handoffs.
+ */
+import { describe, it, expect } from 'vitest';
+import { normalizeOutput, groupOutputsByTarget } from '../../../handoff/target';
+describe('Per-Item Routing', () => {
+    describe('normalizeOutput', () => {
+        it('converts string to OutputItem', () => {
+            const output = 'ent_abc123';
+            const result = normalizeOutput(output);
+            expect(result).toEqual({ entity_id: 'ent_abc123' });
+        });
+        it('returns OutputItem unchanged', () => {
+            const output = { entity_id: 'ent_abc123', entity_class: 'canonical' };
+            const result = normalizeOutput(output);
+            expect(result).toEqual({ entity_id: 'ent_abc123', entity_class: 'canonical' });
+        });
+        it('preserves all properties on OutputItem', () => {
+            const output = {
+                entity_id: 'ent_abc123',
+                entity_class: 'canonical',
+                custom_prop: 'value',
+                nested: { data: 1 },
+            };
+            const result = normalizeOutput(output);
+            expect(result).toEqual(output);
+        });
+    });
+    describe('groupOutputsByTarget', () => {
+        describe('without routes', () => {
+            it('groups all outputs to default target', () => {
+                const outputs = ['ent_1', 'ent_2', 'ent_3'];
+                const then = { scatter: 'process' };
+                const groups = groupOutputsByTarget(outputs, then);
+                expect(groups.size).toBe(1);
+                expect(groups.get('process')).toHaveLength(3);
+                expect(groups.get('process')[0].entity_id).toBe('ent_1');
+            });
+            it('handles OutputItem objects', () => {
+                const outputs = [
+                    { entity_id: 'ent_1', type: 'file' },
+                    { entity_id: 'ent_2', type: 'folder' },
+                ];
+                const then = { pass: 'handler' };
+                const groups = groupOutputsByTarget(outputs, then);
+                expect(groups.size).toBe(1);
+                expect(groups.get('handler')).toHaveLength(2);
+            });
+            it('handles done ThenSpec', () => {
+                const outputs = ['ent_1', 'ent_2'];
+                const then = { done: true };
+                const groups = groupOutputsByTarget(outputs, then);
+                // For done ThenSpec, resolveTarget returns null, which becomes 'done'
+                expect(groups.size).toBe(1);
+                expect(groups.get('done')).toHaveLength(2);
+            });
+        });
+        describe('with routes', () => {
+            it('routes items based on properties', () => {
+                const outputs = [
+                    { entity_id: 'ent_1', entity_class: 'canonical' },
+                    { entity_id: 'ent_2', entity_class: 'mention' },
+                    { entity_id: 'ent_3', entity_class: 'canonical' },
+                ];
+                const then = {
+                    scatter: 'default_handler',
+                    route: [
+                        { where: { property: 'entity_class', equals: 'canonical' }, target: 'describe' },
+                    ],
+                };
+                const groups = groupOutputsByTarget(outputs, then);
+                expect(groups.size).toBe(2);
+                expect(groups.get('describe')).toHaveLength(2);
+                expect(groups.get('default_handler')).toHaveLength(1);
+            });
+            it('routes to "done" target', () => {
+                const outputs = [
+                    { entity_id: 'ent_1', entity_class: 'canonical' },
+                    { entity_id: 'ent_2', entity_class: 'mention' },
+                ];
+                const then = {
+                    scatter: 'describe',
+                    route: [
+                        { where: { property: 'entity_class', equals: 'mention' }, target: 'done' },
+                    ],
+                };
+                const groups = groupOutputsByTarget(outputs, then);
+                expect(groups.size).toBe(2);
+                expect(groups.get('describe')).toHaveLength(1);
+                expect(groups.get('describe')[0].entity_id).toBe('ent_1');
+                expect(groups.get('done')).toHaveLength(1);
+                expect(groups.get('done')[0].entity_id).toBe('ent_2');
+            });
+            it('applies first matching rule (if-else-if)', () => {
+                const outputs = [
+                    { entity_id: 'ent_1', type: 'pdf', priority: 'high' },
+                ];
+                const then = {
+                    pass: 'default',
+                    route: [
+                        { where: { property: 'priority', equals: 'high' }, target: 'priority_handler' },
+                        { where: { property: 'type', equals: 'pdf' }, target: 'pdf_handler' },
+                    ],
+                };
+                const groups = groupOutputsByTarget(outputs, then);
+                // First matching rule wins
+                expect(groups.size).toBe(1);
+                expect(groups.get('priority_handler')).toHaveLength(1);
+            });
+            it('routes string outputs to default (no properties for matching)', () => {
+                const outputs = ['ent_1', 'ent_2'];
+                const then = {
+                    scatter: 'default',
+                    route: [
+                        { where: { property: 'entity_class', equals: 'canonical' }, target: 'describe' },
+                    ],
+                };
+                const groups = groupOutputsByTarget(outputs, then);
+                // String outputs have no properties, so no route matches -> default
+                expect(groups.size).toBe(1);
+                expect(groups.get('default')).toHaveLength(2);
+            });
+            it('handles complex AND/OR routing conditions', () => {
+                const outputs = [
+                    { entity_id: 'ent_1', type: 'file', format: 'pdf' },
+                    { entity_id: 'ent_2', type: 'file', format: 'docx' },
+                    { entity_id: 'ent_3', type: 'folder' },
+                ];
+                const then = {
+                    scatter: 'default',
+                    route: [
+                        {
+                            where: {
+                                and: [
+                                    { property: 'type', equals: 'file' },
+                                    { property: 'format', equals: 'pdf' },
+                                ],
+                            },
+                            target: 'pdf_handler',
+                        },
+                    ],
+                };
+                const groups = groupOutputsByTarget(outputs, then);
+                expect(groups.get('pdf_handler')).toHaveLength(1);
+                expect(groups.get('pdf_handler')[0].entity_id).toBe('ent_1');
+                expect(groups.get('default')).toHaveLength(2);
+            });
+        });
+        describe('mixed string and object outputs', () => {
+            it('handles mix of string and OutputItem', () => {
+                const outputs = [
+                    'ent_1',
+                    { entity_id: 'ent_2', entity_class: 'canonical' },
+                    'ent_3',
+                ];
+                const then = {
+                    scatter: 'default',
+                    route: [
+                        { where: { property: 'entity_class', equals: 'canonical' }, target: 'describe' },
+                    ],
+                };
+                const groups = groupOutputsByTarget(outputs, then);
+                expect(groups.get('describe')).toHaveLength(1);
+                expect(groups.get('describe')[0].entity_id).toBe('ent_2');
+                expect(groups.get('default')).toHaveLength(2);
+            });
+        });
+        describe('edge cases', () => {
+            it('handles empty outputs array', () => {
+                const outputs = [];
+                const then = { scatter: 'process' };
+                const groups = groupOutputsByTarget(outputs, then);
+                expect(groups.size).toBe(0);
+            });
+            it('handles all outputs routed to "done"', () => {
+                const outputs = [
+                    { entity_id: 'ent_1', skip: true },
+                    { entity_id: 'ent_2', skip: true },
+                ];
+                const then = {
+                    scatter: 'process',
+                    route: [
+                        { where: { property: 'skip', equals: true }, target: 'done' },
+                    ],
+                };
+                const groups = groupOutputsByTarget(outputs, then);
+                expect(groups.size).toBe(1);
+                expect(groups.get('done')).toHaveLength(2);
+            });
+            it('handles gather handoff type', () => {
+                const outputs = [
+                    { entity_id: 'ent_1', priority: 'high' },
+                ];
+                const then = {
+                    gather: 'aggregator',
+                    route: [
+                        { where: { property: 'priority', equals: 'high' }, target: 'priority_aggregator' },
+                    ],
+                };
+                const groups = groupOutputsByTarget(outputs, then);
+                expect(groups.get('priority_aggregator')).toHaveLength(1);
+            });
+        });
+    });
+});
+//# sourceMappingURL=per-item-routing.test.js.map

package/dist/__tests__/unit/handoff/per-item-routing.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"per-item-routing.test.js","sourceRoot":"","sources":["../../../../src/__tests__/unit/handoff/per-item-routing.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAGhF,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;QAC/B,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,MAAM,MAAM,GAAG,YAAY,CAAC;YAC5B,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;YAEvC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,MAAM,MAAM,GAAG,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC;YACtE,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;YAEvC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC;QACjF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,MAAM,MAAM,GAAG;gBACb,SAAS,EAAE,YAAY;gBACvB,YAAY,EAAE,WAAW;gBACzB,WAAW,EAAE,OAAO;gBACpB,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE;aACpB,CAAC;YACF,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;YAEvC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;QACpC,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;YAC9B,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;gBAC9C,MAAM,OAAO,GAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;gBACtD,MAAM,IAAI,GAAa,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;gBAE9C,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAEnD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC5B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;gBAC9C,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC5D,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;gBACpC,MAAM,OAAO,GAAa;oBACxB,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE;oBACpC,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;iBACvC,CAAC;gBACF,MAAM,IAAI,GAAa,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;gBAE3C,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAEnD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC5B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAChD,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;gBAC/B,MAAM,OAAO,GAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC7C,MAAM,IAAI,GAAa,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;gBAEtC,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAEnD,sEAAsE;gBACtE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC5B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC7C,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;YAC3B,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;gBAC1C,MAAM,OAAO,GAAa;oBACxB,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE;oBACjD,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE;oBAC/C,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE;iBAClD,CAAC;gBACF,MAAM,IAAI,GAAa;oBACrB,OAAO,EAAE,iBAAiB;oBAC1B,KAAK,EAAE;wBACL,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE;qBACjF;iBACF,CAAC;gBAEF,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAEnD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC5B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;gBAC/C,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACxD,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;gBACjC,MAAM,OAAO,GAAa;oBACxB,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE;oBACjD,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE;iBAChD,CAAC;gBACF,MAAM,IAAI,GAAa;oBACrB,OAAO,EAAE,UAAU;oBACnB,KAAK,EAAE;wBACL,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;qBAC3E;iBACF,CAAC;gBAEF,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAEnD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC5B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;gBAC/C,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC3D,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;gBAC3C,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzD,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;gBAClD,MAAM,OAAO,GAAa;oBACxB,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE;iBACtD,CAAC;gBACF,MAAM,IAAI,GAAa;oBACrB,IAAI,EAAE,SAAS;oBACf,KAAK,EAAE;wBACL,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;wBAC/E,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE;qBACtE;iBACF,CAAC;gBAEF,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAEnD,2BAA2B;gBAC3B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC5B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACzD,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;gBACvE,MAAM,OAAO,GAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC7C,MAAM,IAAI,GAAa;oBACrB,OAAO,EAAE,SAAS;oBAClB,KAAK,EAAE;wBACL,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE;qBACjF;iBACF,CAAC;gBAEF,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAEnD,oEAAoE;gBACpE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC5B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAChD,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;gBACnD,MAAM,OAAO,GAAa;oBACxB,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE;oBACnD,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;oBACpD,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;iBACvC,CAAC;gBACF,MAAM,IAAI,GAAa;oBACrB,OAAO,EAAE,SAAS;oBAClB,KAAK,EAAE;wBACL;4BACE,KAAK,EAAE;gCACL,GAAG,EAAE;oCACH,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;oCACpC,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE;iCACtC;6BACF;4BACD,MAAM,EAAE,aAAa;yBACtB;qBACF;iBACF,CAAC;gBAEF,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAEnD,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;gBAClD,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC9D,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAChD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;YAC/C,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;gBAC9C,MAAM,OAAO,GAAa;oBACxB,OAAO;oBACP,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE;oBACjD,OAAO;iBACR,CAAC;gBACF,MAAM,IAAI,GAAa;oBACrB,OAAO,EAAE,SAAS;oBAClB,KAAK,EAAE;wBACL,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE;qBACjF;iBACF,CAAC;gBAEF,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAEnD,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;gBAC/C,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC3D,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAChD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;YAC1B,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;gBACrC,MAAM,OAAO,GAAa,EAAE,CAAC;gBAC7B,MAAM,IAAI,GAAa,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;gBAE9C,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAEnD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC9B,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;gBAC9C,MAAM,OAAO,GAAa;oBACxB,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE;oBAClC,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE;iBACnC,CAAC;gBACF,MAAM,IAAI,GAAa;oBACrB,OAAO,EAAE,SAAS;oBAClB,KAAK,EAAE;wBACL,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;qBAC9D;iBACF,CAAC;gBAEF,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAEnD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC5B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC7C,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;gBACrC,MAAM,OAAO,GAAa;oBACxB,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE;iBACzC,CAAC;gBACF,MAAM,IAAI,GAAa;oBACrB,MAAM,EAAE,YAAY;oBACpB,KAAK,EAAE;wBACL,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,qBAAqB,EAAE;qBACnF;iBACF,CAAC;gBAEF,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAEnD,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC5D,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/handoff/interpret.d.ts

@@ -5,7 +5,8 @@
  * Combines pure logic (routing, target resolution) with SDK utilities (invocation).
  */
 import type { ArkeClient } from '@arke-institute/sdk';
-import type { ThenSpec, FlowStep, BatchContext, BatchEntity, HandoffRecord, InvocationRecord } from '../types';
+import type { ThenSpec, FlowStep, BatchContext, BatchEntity, HandoffRecord, InvocationRecord, Output } from '../types';
+import { type RhizaRuntimeConfig } from '../types/config';
 /**
  * Handoff action types
  */
@@ -28,9 +29,12 @@ export interface InterpretContext {
     jobCollectionId: string;
     /** The rhiza flow definition */
     flow: Record<string, FlowStep>;
-    /** Output entity IDs from current klados */
-    outputs: string[];
-    /** Properties of the primary output (for routing) */
+    /** Output entities from current klados (string IDs or OutputItem objects) */
+    outputs: Output[];
+    /**
+     * Properties of the primary output (for routing)
+     * @deprecated Use OutputItem objects in outputs array for per-item routing
+     */
     outputProperties?: Record<string, unknown>;
     /** Current log entry ID (for chain building) */
     fromLogId: string;
@@ -44,6 +48,8 @@ export interface InterpretContext {
     network: 'test' | 'main';
     /** Batch context if part of scatter/gather */
     batchContext?: BatchContext;
+    /** Auth token for scatter-utility delegation (optional - needed for automatic delegation) */
+    authToken?: string;
 }
 /**
  * Result of interpreting a handoff
@@ -75,7 +81,8 @@ export interface InterpretResult {
  *
  * @param then - The ThenSpec to interpret
  * @param context - The interpretation context
+ * @param config - Optional rhiza runtime configuration (for scatter utility delegation)
  * @returns The interpretation result
  */
-export declare function interpretThen(then: ThenSpec, context: InterpretContext): Promise<InterpretResult>;
+export declare function interpretThen(then: ThenSpec, context: InterpretContext, config?: RhizaRuntimeConfig): Promise<InterpretResult>;
 //# sourceMappingURL=interpret.d.ts.map

package/dist/handoff/interpret.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interpret.d.ts","sourceRoot":"","sources":["../../src/handoff/interpret.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EACV,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,aAAa,EACb,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAOlB;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,MAAM,GACN,SAAS,GACT,aAAa,GACb,gBAAgB,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB;IAClB,MAAM,EAAE,UAAU,CAAC;IAEnB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAEhB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IAEjB,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IAEd,sCAAsC;IACtC,gBAAgB,EAAE,MAAM,CAAC;IAEzB,yCAAyC;IACzC,eAAe,EAAE,MAAM,CAAC;IAExB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAE/B,4CAA4C;IAC5C,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE3C,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAElB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,EAAE,CAAC;IAEf,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAEhB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAEzB,8CAA8C;IAC9C,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,MAAM,EAAE,aAAa,CAAC;IAEtB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gEAAgE;IAChE,UAAU,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAEhC,qCAAqC;IACrC,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAEjC,sCAAsC;IACtC,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IAExB,iCAAiC;IACjC,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CA8B1B"}
+{"version":3,"file":"interpret.d.ts","sourceRoot":"","sources":["../../src/handoff/interpret.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EACV,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,MAAM,EACP,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,KAAK,kBAAkB,EAGxB,MAAM,iBAAiB,CAAC;AAQzB;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,MAAM,GACN,SAAS,GACT,aAAa,GACb,gBAAgB,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB;IAClB,MAAM,EAAE,UAAU,CAAC;IAEnB,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAEhB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IAEjB,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IAEd,sCAAsC;IACtC,gBAAgB,EAAE,MAAM,CAAC;IAEzB,yCAAyC;IACzC,eAAe,EAAE,MAAM,CAAC;IAExB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAE/B,6EAA6E;IAC7E,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE3C,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAElB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,EAAE,CAAC;IAEf,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAEhB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAEzB,8CAA8C;IAC9C,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B,6FAA6F;IAC7F,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,MAAM,EAAE,aAAa,CAAC;IAEtB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gEAAgE;IAChE,UAAU,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAEhC,qCAAqC;IACrC,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAEjC,sCAAsC;IACtC,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IAExB,iCAAiC;IACjC,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,eAAe,CAAC,CA8B1B"}