@adonis-agora/agent 0.31.0 → 0.33.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adonis-agora/agent",
-  "version": "0.31.0",
+  "version": "0.33.1",
   "description": "Governed, durable-backed AI agent (chat + tool-calling + governance) for AdonisJS — part of the Agora ecosystem.",
   "license": "MIT",
   "repository": {
@@ -8,6 +8,23 @@
     "url": "git+https://github.com/DavideCarvalho/adonis-agora-agent.git",
     "directory": "packages/adonis"
   },
+  "homepage": "https://davidecarvalho.github.io/agora/docs/agent",
+  "bugs": {
+    "url": "https://github.com/DavideCarvalho/adonis-agora-agent/issues"
+  },
+  "keywords": [
+    "adonisjs",
+    "adonis",
+    "ai",
+    "agent",
+    "llm",
+    "tool-calling",
+    "governance",
+    "ai-sdk",
+    "durable",
+    "tanstack-intent",
+    "agora"
+  ],
   "author": "Davi Carvalho <davi@goflip.ai>",
   "type": "module",
   "main": "./dist/src/index.js",
@@ -28,6 +45,11 @@
       "import": "./dist/src/mcp/index.js",
       "default": "./dist/src/mcp/index.js"
     },
+    "./mcp-client": {
+      "types": "./dist/src/mcp-client/index.d.ts",
+      "import": "./dist/src/mcp-client/index.js",
+      "default": "./dist/src/mcp-client/index.js"
+    },
     "./mcp_provider": {
       "types": "./dist/providers/mcp_provider.d.ts",
       "import": "./dist/providers/mcp_provider.js",
@@ -78,6 +100,11 @@
       "import": "./dist/src/stores/lucid.js",
       "default": "./dist/src/stores/lucid.js"
     },
+    "./evals": {
+      "types": "./dist/src/evals/index.d.ts",
+      "import": "./dist/src/evals/index.js",
+      "default": "./dist/src/evals/index.js"
+    },
     "./data": {
       "types": "./dist/src/data/index.d.ts",
       "import": "./dist/src/data/index.js",
@@ -177,43 +204,30 @@
     }
   },
   "devDependencies": {
-    "@adonis-agora/authz": "0.13.2",
-    "@adonis-agora/diagnostics": "0.2.8",
-    "@adonis-agora/durable": "0.35.0",
-    "@adonis-agora/telescope": "0.18.0",
+    "@adonis-agora/authz": "0.13.3",
+    "@adonis-agora/diagnostics": "0.2.9",
+    "@adonis-agora/durable": "0.39.1",
+    "@adonis-agora/telescope": "0.21.0",
     "@adonisjs/assembler": "8.5.1",
     "@adonisjs/core": "7.5.0",
     "@adonisjs/lucid": "22.4.2",
     "@adonisjs/redis": "11.0.0",
     "@qdrant/js-client-rest": "1.19.0",
-    "@tanstack/intent": "^0.4.0",
-    "@types/node": "26.4.1",
-    "@types/react": "19.2.18",
-    "ai": "7.0.93",
+    "@tanstack/intent": "0.4.0",
+    "@types/node": "26.5.1",
+    "@types/react": "19.3.0",
+    "ai": "7.0.97",
     "better-sqlite3": "13.0.3",
     "luxon": "3.7.2",
     "node-sql-parser": "5.4.0",
-    "react": "19.2.8",
+    "react": "19.3.0",
     "typescript": "7.0.2",
     "vitest": "5.0.0",
-    "zod": "4.5.4"
+    "zod": "4.6.2"
   },
   "engines": {
     "node": ">=20.6.0"
   },
-  "keywords": [
-    "adonisjs",
-    "adonis",
-    "ai",
-    "agent",
-    "llm",
-    "tool-calling",
-    "governance",
-    "ai-sdk",
-    "durable",
-    "tanstack-intent",
-    "agora"
-  ],
   "scripts": {
     "build": "pnpm run clean && tsc -p tsconfig.build.json && pnpm run copy:stubs && pnpm run check:dist",
     "check:dist": "node ../../scripts/assert-build-output.mjs dist src/index.js",

package/skills/agent-personas-agents/SKILL.md

@@ -179,25 +179,29 @@ completes normally while the delegation quietly never happened.
 Source: `packages/adonis/src/agent-loop.ts` (agent-kind branch), `packages/adonis/docs/
 authoring/personas-and-agents.mdx` ("A denied delegation is recorded, not retried").
 
-### MEDIUM — expecting a delegated sub-agent's action tools to wait for a human
+### MEDIUM — answering a delegated sub-agent's approval against the wrong run
 
 ```ts
-// Wrong assumption — nested researcher asks for approval; the run should pause.
-defaultAgent: { delegatesTo: [{ agent: 'researcher' }] }
-agents: [{ name: 'researcher', tools: ['issueRefund' /* action */] }]
+// Wrong — the nested researcher parked, but this signals the ORCHESTRATOR's run, so the
+// child stays suspended and the delegation never returns.
+const { runId } = await service.chat({ actor, message: 'go', agentName: 'orchestrator' })
+await service.approve(runId, toolCallId)
 ```
 
 ```ts
-// Correct — keep human-approval actions on the TOP-LEVEL agent only.
-agents: [
-  { name: 'researcher', tools: ['searchDocs', 'getInvoice'] }, // read tools only
-]
+// Correct — read the parked run off the frame. It is the CHILD's run, not the stream's.
+for await (const frame of service.subscribe(runId)) {
+  if (frame.t === 'approval') await service.approve(frame.runId, frame.id)
+}
 ```
 
-Mechanism: under the inline runner a sub-agent runs as a nested in-process loop with no
-human attached, so its `action` tools are AUTO-DECLINED rather than left hanging; under
-the durable runner the same delegation maps to a tracked child workflow instead.
-Source: `packages/adonis/docs/authoring/personas-and-agents.mdx` (final paragraph).
+Mechanism: a sub-agent's `action` parks on `tool:<childRunId>:<callId>` on both runners. Its
+frames are forwarded into the top-level ancestor's stream (durable `sinkRunId`; the inline
+nested loop mirrors it), so the stream you subscribed to is NOT the run that is parked — and
+the `approval` / `elicitation` frame carries `runId` for exactly that reason. A sub-agent
+whose approvals nobody answers hangs. Source:
+`packages/adonis/docs/durability/durable-runner.mdx` ("Answering a sub-agent"),
+`packages/adonis/src/spi/token-stream-sink.ts` (`StreamFrame`).
 
 ### LOW — using wall-clock time or randomness inside a PromptBuilder