@arke-institute/rhiza 0.1.0

package/README.md

@@ -0,0 +1,106 @@
+# @arke-institute/rhiza
+
+Workflow protocol for Arke - a cascading handoff pattern for distributed actions.
+
+## Naming
+
+- **Rhiza** (Greek: ῥίζα, "root") - A workflow definition, the root structure that branches out
+- **Klados** (Greek: κλάδος, "branch") - An individual action/branch within a workflow
+
+From Romans 11:16: *"εἰ … ἡ ῥίζα ἁγία, καὶ οἱ κλάδοι …"* ("if the root is holy, so are the branches")
+
+## Overview
+
+Rhiza replaces centralized orchestrators with a **cascading handoff pattern** where actions invoke each other directly. Key features:
+
+- **Push-based execution** - Actions invoke next actions (no polling orchestrator)
+- **Log chain as state** - The execution log IS the state machine
+- **Perfect resumability** - Every handoff records the exact request for replay
+- **Runtime-agnostic** - Works with Cloudflare Workers, AWS Lambda, Node.js, etc.
+
+## Installation
+
+```bash
+npm install @arke-institute/rhiza
+```
+
+## Quick Start
+
+Build a klados worker in ~15 lines with `KladosJob`:
+
+```typescript
+import { KladosJob, type KladosRequest } from '@arke-institute/rhiza';
+
+export default {
+  async fetch(request: Request, env: Env, ctx: ExecutionContext) {
+    const req = await request.json<KladosRequest>();
+
+    const job = KladosJob.accept(req, {
+      agentId: env.AGENT_ID,
+      agentVersion: env.AGENT_VERSION,
+      authToken: env.ARKE_AGENT_KEY,
+    });
+
+    ctx.waitUntil(job.run(async () => {
+      job.log.info('Processing');
+      const target = await job.fetchTarget();
+      const outputs = await processEntity(target, job.client);
+      return outputs;  // Job handles handoff + log finalization
+    }));
+
+    return Response.json(job.acceptResponse);
+  }
+};
+```
+
+`KladosJob` handles:
+- Client setup with correct auth
+- Initial log entry creation
+- Workflow handoffs (`interpretThen`)
+- Error handling (log + batch slot updates)
+- Log finalization
+
+See the full [Klados Worker Guide](docs/klados-worker-guide.md) for details.
+
+## Validation
+
+```typescript
+import { validateRhizaProperties, validateKladosProperties } from '@arke-institute/rhiza';
+
+const result = validateRhizaProperties(rhizaEntity.properties);
+if (!result.valid) {
+  console.error('Errors:', result.errors);
+  console.warn('Warnings:', result.warnings);
+}
+```
+
+## Handoff Types
+
+| Type | Description | Example |
+|------|-------------|---------|
+| `pass` | 1:1 direct handoff | `{ pass: 'next-klados' }` |
+| `scatter` | 1:N fan-out (parallel) | `{ scatter: 'worker-klados' }` |
+| `gather` | N:1 fan-in (collect) | `{ gather: 'aggregator-klados' }` |
+| `route` | Conditional routing | `{ route: [{ where: {...}, then: {...} }] }` |
+| `done` | Terminal | `{ done: true }` |
+
+## Documentation
+
+### Guides
+
+- **[Klados Worker Guide](docs/klados-worker-guide.md)** - Building workers with KladosJob
+
+### Design Documents
+
+See the `plan/` directory for detailed design documentation:
+
+- [01-types.md](plan/01-types.md) - Type definitions
+- [02-validation.md](plan/02-validation.md) - Validation rules
+- [03-handoff.md](plan/03-handoff.md) - Handoff logic
+- [04-logging.md](plan/04-logging.md) - Logging and chain
+- [05-resume.md](plan/05-resume.md) - Resumability
+- [14-simplification.md](plan/14-simplification.md) - KladosJob design
+
+## License
+
+MIT

package/dist/__tests__/fixtures/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Test Fixtures Index
+ *
+ * Re-exports all fixtures for easy importing in tests
+ */
+export { producerKlados, workerKlados, aggregatorKlados, passthroughKlados, pdfHandlerKlados, imageHandlerKlados, inactiveKlados, developmentKlados, scatterGatherKladoi, linearKladoi, conditionalKladoi, allMockKladoi, invalidKladosProperties, validKladosProperties, } from './kladoi';
+export { linearFlow, linearRhizaProperties, linearRhiza, scatterGatherFlow, scatterGatherRhizaProperties, scatterGatherRhiza, conditionalFlow, conditionalRhizaProperties, conditionalRhiza, complexRoutingFlow, complexRoutingRhizaProperties, invalidRhizaProperties, allMockRhizai, } from './rhizai';
+export { successfulLinearLogs, successfulScatterGatherLogs, partialErrorLogs, allErrorsLogs, mixedErrorLogs, runningWorkflowLogs, singleNodeLogs, } from './logs';
+//# sourceMappingURL=index.d.ts.map

package/dist/__tests__/fixtures/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,UAAU,EACV,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,4BAA4B,EAC5B,kBAAkB,EAClB,eAAe,EACf,0BAA0B,EAC1B,gBAAgB,EAChB,kBAAkB,EAClB,6BAA6B,EAC7B,sBAAsB,EACtB,aAAa,GACd,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,cAAc,GACf,MAAM,QAAQ,CAAC"}

package/dist/__tests__/fixtures/index.js

@@ -0,0 +1,12 @@
+/**
+ * Test Fixtures Index
+ *
+ * Re-exports all fixtures for easy importing in tests
+ */
+// Klados fixtures
+export { producerKlados, workerKlados, aggregatorKlados, passthroughKlados, pdfHandlerKlados, imageHandlerKlados, inactiveKlados, developmentKlados, scatterGatherKladoi, linearKladoi, conditionalKladoi, allMockKladoi, invalidKladosProperties, validKladosProperties, } from './kladoi';
+// Rhiza fixtures
+export { linearFlow, linearRhizaProperties, linearRhiza, scatterGatherFlow, scatterGatherRhizaProperties, scatterGatherRhiza, conditionalFlow, conditionalRhizaProperties, conditionalRhiza, complexRoutingFlow, complexRoutingRhizaProperties, invalidRhizaProperties, allMockRhizai, } from './rhizai';
+// Log fixtures
+export { successfulLinearLogs, successfulScatterGatherLogs, partialErrorLogs, allErrorsLogs, mixedErrorLogs, runningWorkflowLogs, singleNodeLogs, } from './logs';
+//# sourceMappingURL=index.js.map

package/dist/__tests__/fixtures/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/__tests__/fixtures/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,kBAAkB;AAClB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAElB,iBAAiB;AACjB,OAAO,EACL,UAAU,EACV,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,4BAA4B,EAC5B,kBAAkB,EAClB,eAAe,EACf,0BAA0B,EAC1B,gBAAgB,EAChB,kBAAkB,EAClB,6BAA6B,EAC7B,sBAAsB,EACtB,aAAa,GACd,MAAM,UAAU,CAAC;AAElB,eAAe;AACf,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,cAAc,GACf,MAAM,QAAQ,CAAC"}

package/dist/__tests__/fixtures/kladoi/index.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Mock Klados Fixtures
+ *
+ * Pre-configured klados entities for testing various scenarios:
+ * - producer: outputs many items (for scatter source)
+ * - worker: processes one item, outputs one (for scatter target)
+ * - aggregator: accepts many items (for gather target)
+ * - passthrough: simple 1:1 processing
+ * - inactive: disabled klados for error testing
+ * - invalid: various invalid configurations
+ */
+import type { KladosProperties } from '../../../types';
+/** Simple fixture type for tests */
+interface MockKlados {
+    properties: KladosProperties;
+    cid: string;
+}
+/**
+ * Producer - Produces many outputs from one input
+ * Use case: PDF splitter that creates multiple page entities
+ */
+export declare const producerKlados: MockKlados;
+/**
+ * Worker - Processes one item at a time
+ * Use case: OCR processor for individual pages
+ */
+export declare const workerKlados: MockKlados;
+/**
+ * Aggregator - Accepts many inputs (gather target)
+ * Use case: Assembles processed pages back into document
+ */
+export declare const aggregatorKlados: MockKlados;
+/**
+ * Passthrough - Simple 1:1 processor
+ * Use case: Validator, transformer, enricher
+ */
+export declare const passthroughKlados: MockKlados;
+/**
+ * PDF Handler - Processes PDF files specifically
+ * Use case: Conditional routing target
+ */
+export declare const pdfHandlerKlados: MockKlados;
+/**
+ * Image Handler - Processes image files
+ * Use case: Conditional routing target
+ */
+export declare const imageHandlerKlados: MockKlados;
+/**
+ * Inactive - Disabled klados for testing status checks
+ */
+export declare const inactiveKlados: MockKlados;
+/**
+ * Development - Klados in development status
+ */
+export declare const developmentKlados: MockKlados;
+/**
+ * Standard kladoi map for scatter-gather tests
+ */
+export declare const scatterGatherKladoi: Record<string, MockKlados>;
+/**
+ * Standard kladoi map for linear flow tests
+ */
+export declare const linearKladoi: Record<string, MockKlados>;
+/**
+ * Standard kladoi map for conditional routing tests
+ */
+export declare const conditionalKladoi: Record<string, MockKlados>;
+/**
+ * All mock kladoi combined
+ */
+export declare const allMockKladoi: Record<string, MockKlados>;
+export declare const invalidKladosProperties: {
+    /** Missing endpoint */
+    missingEndpoint: {
+        label: string;
+        actions_required: string[];
+        accepts: {
+            types: string[];
+            cardinality: "one";
+        };
+        produces: {
+            types: string[];
+            cardinality: "one";
+        };
+        status: "active";
+    };
+    /** Invalid endpoint URL */
+    invalidEndpoint: {
+        label: string;
+        endpoint: string;
+        actions_required: string[];
+        accepts: {
+            types: string[];
+            cardinality: "one";
+        };
+        produces: {
+            types: string[];
+            cardinality: "one";
+        };
+        status: "active";
+    };
+    /** Empty accepts types */
+    emptyAcceptsTypes: {
+        label: string;
+        endpoint: string;
+        actions_required: string[];
+        accepts: {
+            types: never[];
+            cardinality: "one";
+        };
+        produces: {
+            types: string[];
+            cardinality: "one";
+        };
+        status: "active";
+    };
+    /** Empty produces types */
+    emptyProducesTypes: {
+        label: string;
+        endpoint: string;
+        actions_required: string[];
+        accepts: {
+            types: string[];
+            cardinality: "one";
+        };
+        produces: {
+            types: never[];
+            cardinality: "one";
+        };
+        status: "active";
+    };
+    /** Invalid cardinality */
+    invalidCardinality: {
+        label: string;
+        endpoint: string;
+        actions_required: string[];
+        accepts: {
+            types: string[];
+            cardinality: "one";
+        };
+        produces: {
+            types: string[];
+            cardinality: "one";
+        };
+        status: "active";
+    };
+    /** Empty actions required */
+    emptyActionsRequired: {
+        label: string;
+        endpoint: string;
+        actions_required: never[];
+        accepts: {
+            types: string[];
+            cardinality: "one";
+        };
+        produces: {
+            types: string[];
+            cardinality: "one";
+        };
+        status: "active";
+    };
+};
+export declare const validKladosProperties: KladosProperties;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/__tests__/fixtures/kladoi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/fixtures/kladoi/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,oCAAoC;AACpC,UAAU,UAAU;IAClB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,GAAG,EAAE,MAAM,CAAC;CACb;AAMD;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,UAa5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,UAa1B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,UAa9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,UAa/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,UAa9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,UAahC,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,UAa5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,UAa/B,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAI1D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAInD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAKxD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAMpD,CAAC;AAMF,eAAO,MAAM,uBAAuB;IAClC,uBAAuB;;;;;;;;;;;;;;IASvB,2BAA2B;;;;;;;;;;;;;;;IAU3B,0BAA0B;;;;;;;;;;;;;;;IAU1B,2BAA2B;;;;;;;;;;;;;;;IAU3B,0BAA0B;;;;;;;yBAKsC,KAAK;;;;;;;;IAKrE,6BAA6B;;;;;;;;;;;;;;;CAS9B,CAAC;AAMF,eAAO,MAAM,qBAAqB,EAAE,gBAUnC,CAAC"}

package/dist/__tests__/fixtures/kladoi/index.js

@@ -0,0 +1,270 @@
+/**
+ * Mock Klados Fixtures
+ *
+ * Pre-configured klados entities for testing various scenarios:
+ * - producer: outputs many items (for scatter source)
+ * - worker: processes one item, outputs one (for scatter target)
+ * - aggregator: accepts many items (for gather target)
+ * - passthrough: simple 1:1 processing
+ * - inactive: disabled klados for error testing
+ * - invalid: various invalid configurations
+ */
+// ============================================================================
+// Valid Kladoi
+// ============================================================================
+/**
+ * Producer - Produces many outputs from one input
+ * Use case: PDF splitter that creates multiple page entities
+ */
+export const producerKlados = {
+    properties: {
+        label: 'Producer',
+        description: 'Produces multiple outputs from a single input',
+        endpoint: 'https://producer.test/invoke',
+        actions_required: ['file:view'],
+        accepts: { types: ['*'], cardinality: 'one' },
+        produces: { types: ['item/*'], cardinality: 'many' },
+        status: 'active',
+        created_at: '2025-01-01T00:00:00Z',
+        updated_at: '2025-01-01T00:00:00Z',
+    },
+    cid: 'cid_producer_v1',
+};
+/**
+ * Worker - Processes one item at a time
+ * Use case: OCR processor for individual pages
+ */
+export const workerKlados = {
+    properties: {
+        label: 'Worker',
+        description: 'Processes a single item and produces a single result',
+        endpoint: 'https://worker.test/invoke',
+        actions_required: ['file:view', 'entity:update'],
+        accepts: { types: ['item/*'], cardinality: 'one' },
+        produces: { types: ['result/*'], cardinality: 'one' },
+        status: 'active',
+        created_at: '2025-01-01T00:00:00Z',
+        updated_at: '2025-01-01T00:00:00Z',
+    },
+    cid: 'cid_worker_v1',
+};
+/**
+ * Aggregator - Accepts many inputs (gather target)
+ * Use case: Assembles processed pages back into document
+ */
+export const aggregatorKlados = {
+    properties: {
+        label: 'Aggregator',
+        description: 'Combines multiple inputs into a single output',
+        endpoint: 'https://aggregator.test/invoke',
+        actions_required: ['file:create'],
+        accepts: { types: ['result/*'], cardinality: 'many' },
+        produces: { types: ['final/*'], cardinality: 'one' },
+        status: 'active',
+        created_at: '2025-01-01T00:00:00Z',
+        updated_at: '2025-01-01T00:00:00Z',
+    },
+    cid: 'cid_aggregator_v1',
+};
+/**
+ * Passthrough - Simple 1:1 processor
+ * Use case: Validator, transformer, enricher
+ */
+export const passthroughKlados = {
+    properties: {
+        label: 'Passthrough',
+        description: 'Simple 1:1 processing',
+        endpoint: 'https://passthrough.test/invoke',
+        actions_required: ['file:view', 'entity:update'],
+        accepts: { types: ['*'], cardinality: 'one' },
+        produces: { types: ['*'], cardinality: 'one' },
+        status: 'active',
+        created_at: '2025-01-01T00:00:00Z',
+        updated_at: '2025-01-01T00:00:00Z',
+    },
+    cid: 'cid_passthrough_v1',
+};
+/**
+ * PDF Handler - Processes PDF files specifically
+ * Use case: Conditional routing target
+ */
+export const pdfHandlerKlados = {
+    properties: {
+        label: 'PDF Handler',
+        description: 'Specialized handler for PDF files',
+        endpoint: 'https://pdf-handler.test/invoke',
+        actions_required: ['file:view', 'file:create'],
+        accepts: { types: ['file/pdf'], cardinality: 'one' },
+        produces: { types: ['text/extracted'], cardinality: 'one' },
+        status: 'active',
+        created_at: '2025-01-01T00:00:00Z',
+        updated_at: '2025-01-01T00:00:00Z',
+    },
+    cid: 'cid_pdf_handler_v1',
+};
+/**
+ * Image Handler - Processes image files
+ * Use case: Conditional routing target
+ */
+export const imageHandlerKlados = {
+    properties: {
+        label: 'Image Handler',
+        description: 'Specialized handler for image files',
+        endpoint: 'https://image-handler.test/invoke',
+        actions_required: ['file:view', 'file:create'],
+        accepts: { types: ['file/jpeg', 'file/png', 'file/webp'], cardinality: 'one' },
+        produces: { types: ['text/extracted'], cardinality: 'one' },
+        status: 'active',
+        created_at: '2025-01-01T00:00:00Z',
+        updated_at: '2025-01-01T00:00:00Z',
+    },
+    cid: 'cid_image_handler_v1',
+};
+// ============================================================================
+// Error Testing Kladoi
+// ============================================================================
+/**
+ * Inactive - Disabled klados for testing status checks
+ */
+export const inactiveKlados = {
+    properties: {
+        label: 'Inactive Klados',
+        description: 'Disabled klados for testing',
+        endpoint: 'https://inactive.test/invoke',
+        actions_required: ['file:view'],
+        accepts: { types: ['*'], cardinality: 'one' },
+        produces: { types: ['*'], cardinality: 'one' },
+        status: 'disabled',
+        created_at: '2025-01-01T00:00:00Z',
+        updated_at: '2025-01-01T00:00:00Z',
+    },
+    cid: 'cid_inactive_v1',
+};
+/**
+ * Development - Klados in development status
+ */
+export const developmentKlados = {
+    properties: {
+        label: 'Development Klados',
+        description: 'Klados in development for testing',
+        endpoint: 'https://development.test/invoke',
+        actions_required: ['file:view'],
+        accepts: { types: ['*'], cardinality: 'one' },
+        produces: { types: ['*'], cardinality: 'one' },
+        status: 'development',
+        created_at: '2025-01-01T00:00:00Z',
+        updated_at: '2025-01-01T00:00:00Z',
+    },
+    cid: 'cid_development_v1',
+};
+// ============================================================================
+// Pre-configured Maps
+// ============================================================================
+/**
+ * Standard kladoi map for scatter-gather tests
+ */
+export const scatterGatherKladoi = {
+    'II01klados_producer': producerKlados,
+    'II01klados_worker': workerKlados,
+    'II01klados_aggregator': aggregatorKlados,
+};
+/**
+ * Standard kladoi map for linear flow tests
+ */
+export const linearKladoi = {
+    'II01klados_a': passthroughKlados,
+    'II01klados_b': passthroughKlados,
+    'II01klados_c': passthroughKlados,
+};
+/**
+ * Standard kladoi map for conditional routing tests
+ */
+export const conditionalKladoi = {
+    'II01klados_classifier': passthroughKlados,
+    'II01klados_pdf_handler': pdfHandlerKlados,
+    'II01klados_image_handler': imageHandlerKlados,
+    'II01klados_default_handler': passthroughKlados,
+};
+/**
+ * All mock kladoi combined
+ */
+export const allMockKladoi = {
+    ...scatterGatherKladoi,
+    ...linearKladoi,
+    ...conditionalKladoi,
+    'II01klados_inactive': inactiveKlados,
+    'II01klados_development': developmentKlados,
+};
+// ============================================================================
+// Invalid Klados Properties (for validation tests)
+// ============================================================================
+export const invalidKladosProperties = {
+    /** Missing endpoint */
+    missingEndpoint: {
+        label: 'Missing Endpoint',
+        actions_required: ['file:view'],
+        accepts: { types: ['*'], cardinality: 'one' },
+        produces: { types: ['*'], cardinality: 'one' },
+        status: 'active',
+    },
+    /** Invalid endpoint URL */
+    invalidEndpoint: {
+        label: 'Invalid Endpoint',
+        endpoint: 'not-a-valid-url',
+        actions_required: ['file:view'],
+        accepts: { types: ['*'], cardinality: 'one' },
+        produces: { types: ['*'], cardinality: 'one' },
+        status: 'active',
+    },
+    /** Empty accepts types */
+    emptyAcceptsTypes: {
+        label: 'Empty Accepts',
+        endpoint: 'https://test.test/invoke',
+        actions_required: ['file:view'],
+        accepts: { types: [], cardinality: 'one' },
+        produces: { types: ['*'], cardinality: 'one' },
+        status: 'active',
+    },
+    /** Empty produces types */
+    emptyProducesTypes: {
+        label: 'Empty Produces',
+        endpoint: 'https://test.test/invoke',
+        actions_required: ['file:view'],
+        accepts: { types: ['*'], cardinality: 'one' },
+        produces: { types: [], cardinality: 'one' },
+        status: 'active',
+    },
+    /** Invalid cardinality */
+    invalidCardinality: {
+        label: 'Invalid Cardinality',
+        endpoint: 'https://test.test/invoke',
+        actions_required: ['file:view'],
+        accepts: { types: ['*'], cardinality: 'invalid' },
+        produces: { types: ['*'], cardinality: 'one' },
+        status: 'active',
+    },
+    /** Empty actions required */
+    emptyActionsRequired: {
+        label: 'Empty Actions',
+        endpoint: 'https://test.test/invoke',
+        actions_required: [],
+        accepts: { types: ['*'], cardinality: 'one' },
+        produces: { types: ['*'], cardinality: 'one' },
+        status: 'active',
+    },
+};
+// ============================================================================
+// Valid Klados Properties (for validation tests)
+// ============================================================================
+export const validKladosProperties = {
+    label: 'Valid Klados',
+    description: 'A fully valid klados for testing',
+    endpoint: 'https://valid.test/invoke',
+    actions_required: ['file:view', 'entity:update'],
+    accepts: { types: ['file/pdf'], cardinality: 'one' },
+    produces: { types: ['text/extracted'], cardinality: 'one' },
+    status: 'active',
+    created_at: '2025-01-01T00:00:00Z',
+    updated_at: '2025-01-01T00:00:00Z',
+};
+//# sourceMappingURL=index.js.map

package/dist/__tests__/fixtures/kladoi/index.js.map

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

package/dist/__tests__/fixtures/logs/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Mock Log Fixtures
+ *
+ * Pre-configured log entries for testing:
+ * - successfulLinear: Complete linear workflow execution
+ * - successfulScatterGather: Complete scatter-gather execution
+ * - partialError: Workflow with some failed branches
+ * - allErrors: Workflow where everything failed
+ */
+import type { KladosLogEntry } from '../../../types';
+export declare const successfulLinearLogs: KladosLogEntry[];
+export declare const successfulScatterGatherLogs: KladosLogEntry[];
+export declare const partialErrorLogs: KladosLogEntry[];
+export declare const allErrorsLogs: KladosLogEntry[];
+export declare const allErrorLogs: KladosLogEntry[];
+export declare const mixedErrorLogs: KladosLogEntry[];
+export declare const runningWorkflowLogs: KladosLogEntry[];
+export declare const singleNodeLogs: KladosLogEntry[];
+//# sourceMappingURL=index.d.ts.map

package/dist/__tests__/fixtures/logs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/fixtures/logs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,gBAAgB,CAAC;AAsBpE,eAAO,MAAM,oBAAoB,EAAE,cAAc,EA8DhD,CAAC;AAMF,eAAO,MAAM,2BAA2B,EAAE,cAAc,EAuHvD,CAAC;AAMF,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAmF5C,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,cAAc,EAiBzC,CAAC;AAGF,eAAO,MAAM,YAAY,EAAE,cAAc,EA2FxC,CAAC;AAMF,eAAO,MAAM,cAAc,EAAE,cAAc,EAoE1C,CAAC;AAMF,eAAO,MAAM,mBAAmB,EAAE,cAAc,EAqC/C,CAAC;AAMF,eAAO,MAAM,cAAc,EAAE,cAAc,EAc1C,CAAC"}