@getenki/ai-darwin-arm64 0.5.40 → 0.5.41

package/README.md

@@ -36,6 +36,11 @@ The current package surface is:
 - `NativeEnkiAgent.withMemory(...)`
 - `NativeEnkiAgent.withToolsAndMemory(...)`
 
+It also supports two loop customization levels:
+
+- `agenticLoop` constructor arguments for prompt-level loop customization
+- `setAgentLoopHandler(...)` for a JavaScript-defined loop override
+
 `NativeMultiAgentRuntime` supports:
 
 - `new(...)`
@@ -101,9 +106,70 @@ Constructor arguments:
 - `model?: string`
 - `maxIterations?: number`
 - `workspaceHome?: string`
+- `agenticLoop?: string`
 
 If omitted, the runtime falls back to built-in defaults for name, prompt, and max iterations.
 
+## Custom Agentic Loops
+
+Use the optional `agenticLoop` argument when you want to replace the default loop instructions seen by the model but still keep the normal Rust runtime loop:
+
+```js
+const { NativeEnkiAgent } = require('@getenki/ai')
+
+const agent = new NativeEnkiAgent(
+  'Assistant',
+  'Answer clearly and keep responses short.',
+  'ollama::qwen3.5:latest',
+  20,
+  process.cwd(),
+  [
+    '1. Understand the request.',
+    '2. Decide whether a tool is needed.',
+    '3. Summarize observations.',
+    '4. Return the final answer.',
+  ].join('\n'),
+)
+```
+
+Use `setAgentLoopHandler(...)` when you want JavaScript to own the loop itself:
+
+```js
+const { NativeEnkiAgent } = require('@getenki/ai')
+
+const agent = new NativeEnkiAgent(
+  'Assistant',
+  'Answer clearly and keep responses short.',
+  'ollama::qwen3.5:latest',
+  8,
+  process.cwd(),
+)
+
+agent.setAgentLoopHandler((requestJson) => {
+  const request = JSON.parse(requestJson)
+  return JSON.stringify({
+    content: `Handled in JavaScript for: ${request.user_message}`,
+    steps: [
+      {
+        index: 1,
+        phase: 'Custom',
+        kind: 'final',
+        detail: 'Returned a final answer from JavaScript',
+      },
+    ],
+  })
+})
+```
+
+The handler receives a JSON request containing the current transcript, system prompt, tool catalog, model, iteration limit, and workspace paths.
+
+Use `clearAgentLoopHandler()` to restore the default runtime loop.
+
+Repository examples:
+
+- [`example/basic-js/custom-agent-loop.js`](/I:/projects/enki/core-next/example/basic-js/custom-agent-loop.js)
+- [`example/basic-js/react-custom-agent-loop.js`](/I:/projects/enki/core-next/example/basic-js/react-custom-agent-loop.js)
+
 ## Tools
 
 Tools can be attached with `NativeEnkiAgent.withTools(...)`. Each tool object must provide:
@@ -542,6 +608,8 @@ JavaScript example:
 cd example/basic-js
 npm install
 npm start
+npm run start:custom-agent-loop
+npm run start:react-custom-agent-loop
 npm run start:multi-agent-tools-memory
 ```
 

package/package.json

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