@adonis-agora/agent 0.55.0 → 0.56.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adonis-agora/agent",
-  "version": "0.55.0",
+  "version": "0.56.0",
   "description": "Governed, durable-backed AI agent (chat + tool-calling + governance) for AdonisJS — part of the Agora ecosystem.",
   "license": "MIT",
   "repository": {
@@ -156,6 +156,11 @@
       "import": "./dist/src/react/genui/json-render.js",
       "default": "./dist/src/react/genui/json-render.js"
     },
+    "./react/media": {
+      "types": "./dist/src/react/media.d.ts",
+      "import": "./dist/src/react/media.js",
+      "default": "./dist/src/react/media.js"
+    },
     "./react/markdown": {
       "types": "./dist/src/react/markdown.d.ts",
       "import": "./dist/src/react/markdown.js",
@@ -200,7 +205,8 @@
     "@adonisjs/lucid": "^22.4.0",
     "@adonisjs/redis": "^9.2.0 || ^10.0.0 || ^11.0.0",
     "@dudousxd/nestjs-agent-core": ">=0.26.0 <1.0.0",
-    "@dudousxd/nestjs-agent-react": ">=0.28.0 <1.0.0",
+    "@dudousxd/nestjs-agent-react": ">=0.30.0 <1.0.0",
+    "@dudousxd/nestjs-media-client": ">=0.3.0 <1.0.0",
     "@qdrant/js-client-rest": "^1.11.0",
     "ai": "^7.0.0",
     "node-sql-parser": "^5.3.0",
@@ -253,6 +259,9 @@
     "@dudousxd/nestjs-agent-react": {
       "optional": true
     },
+    "@dudousxd/nestjs-media-client": {
+      "optional": true
+    },
     "@adonis-agora/media": {
       "optional": true
     }
@@ -270,7 +279,8 @@
     "@ag-ui/core": "1.0.1",
     "@ai-sdk/react": "^4.0.125",
     "@dudousxd/nestjs-agent-core": "0.33.0",
-    "@dudousxd/nestjs-agent-react": "0.28.0",
+    "@dudousxd/nestjs-agent-react": "0.31.0",
+    "@dudousxd/nestjs-media-client": "0.3.0",
     "@qdrant/js-client-rest": "1.19.0",
     "@tanstack/intent": "0.4.0",
     "@testing-library/dom": "10.4.2",

package/skills/agent-tools/SKILL.md

@@ -50,7 +50,7 @@ export default class GetWeather extends ReadTool<Input, { tempC: number }> {
     name: 'get_weather',
     description: 'Current weather for a city.',
     input,
-    roles: ['MEMBER'], // omit → config.defaultRoles (['ADMIN'] by default)
+    roles: ['MEMBER'], // omit → config.defaultRoles ([] — open — by default)
   }
 
   async execute({ city }: Input, _ctx: AiToolCtx) {
@@ -209,6 +209,24 @@ arguments and expires (`ttlMs`, default 15 min).
 Source: `packages/adonis/docs/mcp.mdx` ("Writes with a human gate"),
 `packages/adonis/src/confirmed-tool.ts`.
 
+## Feature flags and per-user gates — `enabled`, `isEnabled()`, `canUse(actor)`
+
+```ts
+// A flag with no service behind it: on the options (boolean, or a predicate re-read every turn).
+static tool = { name: 'search_docs', description: '...', input, enabled: () => env.get('DOCS') === true }
+
+// A flag or entitlement that needs a service: methods on the (container-resolved) class.
+isEnabled() { return this.flags.on('docs') }
+canUse(actor: Actor) { return this.plans.includesDocs(actor.tenantRef) }
+```
+
+`defineTool` / `defineConfirmedTool` take `enabled` and `canUse` as options; `mcpServers[]`
+takes both per server. Order on the offered list AND on invoke: allow-list → `enabled` →
+`RolesPolicy` → `canUse`; none can widen. A disabled tool is never shown to the model and
+invoking one throws `ToolDisabledError` (not `ToolForbiddenError`). Prefer these to registering a
+tool conditionally, and to refusing inside `execute` (which costs the model a turn).
+Source: `packages/adonis/docs/authoring/tools.mdx`, `packages/adonis/src/tool-filters.ts`.
+
 ## Common mistakes
 
 ### CRITICAL — shipping a privileged tool without `roles`