@getenki/ai-darwin-arm64 0.4.15 → 0.5.2

package/README.md

@@ -20,6 +20,7 @@ The current package surface is:
 
 - `NativeEnkiAgent`
 - `NativeMultiAgentRuntime`
+- `NativeWorkflowRuntime`
 - `JsAgentStatus`
 - `JsMemoryKind`
 - `JsMemoryModule`
@@ -43,6 +44,16 @@ The current package surface is:
 - `registry(...)`
 - `discover(...)`
 
+`NativeWorkflowRuntime` supports:
+
+- `new(...)`
+- `listWorkflowsJson(...)`
+- `listRunsJson(...)`
+- `inspectJson(...)`
+- `startJson(...)`
+- `resumeJson(...)`
+- `submitInterventionJson(...)`
+
 ## Basic Agent
 
 Use the constructor when you only need a session-based agent backed by the native runtime.
@@ -292,6 +303,107 @@ const recordHandler = (
 }
 ```
 
+## Workflow Runtime
+
+Use `NativeWorkflowRuntime` when you want to register workflow agents plus JSON task and workflow definitions directly from Node.js.
+
+```js
+const { NativeEnkiAgent, NativeWorkflowRuntime } = require('@getenki/ai')
+
+const researcher = new NativeEnkiAgent(
+  'Researcher',
+  'Return short factual notes.',
+  'ollama::qwen3.5:latest',
+  4,
+  './.enki',
+)
+researcher.configureWorkflow('researcher', ['research'])
+
+const writer = new NativeEnkiAgent(
+  'Writer',
+  'Turn notes into a concise summary.',
+  'ollama::qwen3.5:latest',
+  4,
+  './.enki',
+)
+writer.configureWorkflow('writer', ['writing'])
+
+const runtime = new NativeWorkflowRuntime(
+  [researcher, writer],
+  [
+    JSON.stringify({
+      id: 'research_topic',
+      target: { type: 'capabilities', value: ['research'] },
+      prompt: 'Research {{topic}} and return 3 concise bullet points.',
+      input_bindings: { topic: 'input.topic' },
+    }),
+    JSON.stringify({
+      id: 'write_summary',
+      target: { type: 'agent_id', value: 'writer' },
+      prompt: 'Write a short summary for {{topic}} using {{research.content}}',
+      input_bindings: {
+        topic: 'input.topic',
+        research: 'research',
+      },
+    }),
+  ],
+  [
+    JSON.stringify({
+      id: 'research-to-summary',
+      name: 'Research To Summary',
+      nodes: [
+        { id: 'research', kind: 'task', task_id: 'research_topic', output_key: 'research' },
+        { id: 'summary', kind: 'task', task_id: 'write_summary', output_key: 'summary' },
+      ],
+      edges: [{ from: 'research', to: 'summary', transition: { type: 'always' } }],
+    }),
+  ],
+  './.enki',
+)
+
+const response = JSON.parse(
+  await runtime.startJson(
+    JSON.stringify({
+      workflow_id: 'research-to-summary',
+      input: { topic: 'workflow bindings in enki-js' },
+    }),
+  ),
+)
+
+const persisted = JSON.parse(await runtime.inspectJson(response.run_id))
+console.log(persisted.status)
+```
+
+## Human Intervention
+
+Workflow runs persist pending interventions as part of the run state, so approvals and failure escalations can pause and resume without moving state into a separate coordinator service.
+
+Each pending intervention includes:
+
+- `workflow_id`
+- `run_id`
+- `node_id`
+- `prompt`
+- `reason`
+- `response`
+- `created_at` and `resolved_at`
+
+Two built-in patterns are supported:
+
+- `human_gate` nodes pause immediately and wait for a human response
+- task nodes with `failure_policy: "pause_for_intervention"` convert a terminal failure into an intervention asking the human to `retry`, `skip`, `continue`, or `fail`
+
+The runnable TypeScript example is [`example/basic-ts/human-intervention-workflow.ts`](/I:/projects/enki/core-next/example/basic-ts/human-intervention-workflow.ts). It demonstrates:
+
+- a `human_gate` approval flow that pauses, resolves, and resumes to `approval.approved = true`
+- a missing-agent failure that pauses for intervention and resumes after a `skip` response
+
+The runtime interaction loop is:
+
+1. `startJson(...)` returns a paused workflow response
+2. `inspectJson(runId)` exposes `pending_interventions`
+3. `submitInterventionJson(runId, interventionId, response)` resolves the intervention
+4. `resumeJson(runId)` continues the persisted run
 ## Tools And Memory Example
 
 The repository examples in [`example/basic-js/index.js`](/I:/projects/enki/core-next/example/basic-js/index.js) and [`example/basic-ts/index.ts`](/I:/projects/enki/core-next/example/basic-ts/index.ts) use `NativeEnkiAgent.withToolsAndMemory(...)` with:
@@ -461,3 +573,5 @@ Useful scripts:
 - `npm test`: run the AVA test suite
 - `npm run lint`: run `oxlint`
 - `npm run format`: run Prettier, `cargo fmt`, and `taplo format`
+
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getenki/ai-darwin-arm64",
-  "version": "0.4.15",
+  "version": "0.5.2",
   "cpu": [
     "arm64"
   ],