@adonis-agora/agent 0.72.0 → 0.74.0

package/dist/src/vite/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `@adonis-agora/agent/vite` — `genuiSandboxKit()`, the Vite plugin that puts the app's design
+ * system (its components, its theme, Tailwind) inside the sandbox:
+ *
+ * ```ts
+ * // vite.config.ts
+ * import { genuiSandboxKit } from '@adonis-agora/agent/vite'
+ * export default defineConfig({ plugins: [react(), adonisjs({ … }), genuiSandboxKit({ include: 'inertia/components/ui/*.tsx' })] })
+ * ```
+ *
+ * Then `genui({ sandbox: { kit: true, tailwind: true } })` in `config/agent.ts` finds the bundle and
+ * the docs through Vite (the dev server in dev, the manifest in production).
+ */
+import { type GenuiSandboxKitApi, type GenuiSandboxKitOptions, type GenuiSandboxKitPlugin, SANDBOX_KIT_DEV_PREFIX, SANDBOX_KIT_MANIFEST_KEYS, SANDBOX_KIT_UPDATE_EVENT } from '../genui/kit/plugin.js';
+/** Where the dev descriptor is written in an Adonis app (`.adonisjs` is ignored by git already). */
+export declare const ADONIS_SANDBOX_KIT_DESCRIPTOR = ".adonisjs/agent/genui_sandbox_kit.json";
+/**
+ * The sandbox kit plugin. `entry` (a module exporting the kit) or `include` (a glob of component
+ * files); neither → the first `components/ui` folder (`inertia/components/ui`…). See
+ * {@link GenuiSandboxKitOptions}.
+ */
+export declare function genuiSandboxKit(options?: GenuiSandboxKitOptions): GenuiSandboxKitPlugin;
+export { type GenuiSandboxKitApi, type GenuiSandboxKitOptions, type GenuiSandboxKitPlugin, SANDBOX_KIT_DEV_PREFIX, SANDBOX_KIT_MANIFEST_KEYS, SANDBOX_KIT_UPDATE_EVENT, };
+//# sourceMappingURL=index.d.ts.map

package/dist/src/vite/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/vite/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,wBAAwB,CAAC;AAEhC,oGAAoG;AACpG,eAAO,MAAM,6BAA6B,2CAA2C,CAAC;AAEtF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,qBAAqB,CAK3F;AAED,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,GACzB,CAAC"}

package/dist/src/vite/index.js

@@ -0,0 +1,29 @@
+/**
+ * `@adonis-agora/agent/vite` — `genuiSandboxKit()`, the Vite plugin that puts the app's design
+ * system (its components, its theme, Tailwind) inside the sandbox:
+ *
+ * ```ts
+ * // vite.config.ts
+ * import { genuiSandboxKit } from '@adonis-agora/agent/vite'
+ * export default defineConfig({ plugins: [react(), adonisjs({ … }), genuiSandboxKit({ include: 'inertia/components/ui/*.tsx' })] })
+ * ```
+ *
+ * Then `genui({ sandbox: { kit: true, tailwind: true } })` in `config/agent.ts` finds the bundle and
+ * the docs through Vite (the dev server in dev, the manifest in production).
+ */
+import { createGenuiSandboxKitPlugin, SANDBOX_KIT_DEV_PREFIX, SANDBOX_KIT_MANIFEST_KEYS, SANDBOX_KIT_UPDATE_EVENT, } from '../genui/kit/plugin.js';
+/** Where the dev descriptor is written in an Adonis app (`.adonisjs` is ignored by git already). */
+export const ADONIS_SANDBOX_KIT_DESCRIPTOR = '.adonisjs/agent/genui_sandbox_kit.json';
+/**
+ * The sandbox kit plugin. `entry` (a module exporting the kit) or `include` (a glob of component
+ * files); neither → the first `components/ui` folder (`inertia/components/ui`…). See
+ * {@link GenuiSandboxKitOptions}.
+ */
+export function genuiSandboxKit(options = {}) {
+    return createGenuiSandboxKitPlugin(options, {
+        descriptor: ADONIS_SANDBOX_KIT_DESCRIPTOR,
+        rendererImport: /@adonis-agora\/agent\/react/,
+    });
+}
+export { SANDBOX_KIT_DEV_PREFIX, SANDBOX_KIT_MANIFEST_KEYS, SANDBOX_KIT_UPDATE_EVENT, };
+//# sourceMappingURL=index.js.map

package/dist/src/vite/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/vite/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EACL,2BAA2B,EAI3B,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAEhC,oGAAoG;AACpG,MAAM,CAAC,MAAM,6BAA6B,GAAG,wCAAwC,CAAC;AAEtF;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAAO,GAA2B,EAAE;IAClE,OAAO,2BAA2B,CAAC,OAAO,EAAE;QAC1C,UAAU,EAAE,6BAA6B;QACzC,cAAc,EAAE,6BAA6B;KAC9C,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EAIL,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,GACzB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adonis-agora/agent",
-  "version": "0.72.0",
+  "version": "0.74.0",
   "description": "Governed, durable-backed AI agent (chat + tool-calling + governance) for AdonisJS — part of the Agora ecosystem.",
   "license": "MIT",
   "repository": {
@@ -168,6 +168,11 @@
       "import": "./dist/src/hooks/tools.js",
       "default": "./dist/src/hooks/tools.js"
     },
+    "./hooks/genui_kit": {
+      "types": "./dist/src/hooks/genui_kit.d.ts",
+      "import": "./dist/src/hooks/genui_kit.js",
+      "default": "./dist/src/hooks/genui_kit.js"
+    },
     "./telescope": {
       "types": "./dist/src/telescope/index.d.ts",
       "import": "./dist/src/telescope/index.js",
@@ -213,6 +218,21 @@
       "import": "./dist/src/genui/builtins.js",
       "default": "./dist/src/genui/builtins.js"
     },
+    "./genui/chart-image": {
+      "types": "./dist/src/genui/chart-image.d.ts",
+      "import": "./dist/src/genui/chart-image.js",
+      "default": "./dist/src/genui/chart-image.js"
+    },
+    "./genui/kit": {
+      "types": "./dist/src/genui/kit/index.d.ts",
+      "import": "./dist/src/genui/kit/index.js",
+      "default": "./dist/src/genui/kit/index.js"
+    },
+    "./vite": {
+      "types": "./dist/src/vite/index.d.ts",
+      "import": "./dist/src/vite/index.js",
+      "default": "./dist/src/vite/index.js"
+    },
     "./media": {
       "types": "./dist/src/media/index.d.ts",
       "import": "./dist/src/media/index.js",
@@ -239,7 +259,8 @@
   "sideEffects": false,
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.31.0",
-    "@standard-schema/spec": "1.1.0"
+    "@standard-schema/spec": "1.1.0",
+    "@tailwindcss/browser": "4.3.3"
   },
   "peerDependencies": {
     "@adonis-agora/authz": ">=0.4.2 <1.0.0",
@@ -254,6 +275,7 @@
     "@ai-sdk/react": "^4.0.0",
     "@json-render/react": ">=0.21.0 <1.0.0",
     "@qdrant/js-client-rest": "^1.11.0",
+    "@resvg/resvg-js": "^2.6.0",
     "@streamdown/code": "^1.1.1",
     "@streamdown/math": "^1.0.2",
     "@streamdown/mermaid": "^1.0.2",
@@ -270,7 +292,9 @@
     "remark-gfm": "^4.0.1",
     "remark-math": "^6.0.0",
     "streamdown": "^2.5.0",
+    "typescript": ">=5",
     "unist-util-visit": "^5.1.0",
+    "vite": ">=5",
     "zod": "^4.0.0"
   },
   "peerDependenciesMeta": {
@@ -363,6 +387,15 @@
     },
     "playwright-core": {
       "optional": true
+    },
+    "@resvg/resvg-js": {
+      "optional": true
+    },
+    "vite": {
+      "optional": true
+    },
+    "typescript": {
+      "optional": true
     }
   },
   "devDependencies": {
@@ -383,6 +416,7 @@
     "@json-render/react": "0.21.0",
     "@opencode/client": "2.0.18",
     "@qdrant/js-client-rest": "1.19.0",
+    "@resvg/resvg-js": "^2.6.2",
     "@streamdown/code": "1.1.1",
     "@streamdown/math": "1.0.3",
     "@streamdown/mermaid": "1.0.3",
@@ -420,7 +454,9 @@
     "streamdown": "2.6.0",
     "testcontainers": "12.2.0",
     "typescript": "7.0.2",
+    "typescript5": "npm:typescript@5.9.3",
     "unist-util-visit": "5.1.0",
+    "vite": "8.3.2",
     "vitest": "5.0.3",
     "zod": "4.6.5"
   },

package/skills/agent-setup/SKILL.md

@@ -330,12 +330,14 @@ Agora owns its catalog (`@adonis-agora/agent/genui`), browser rendering
 (`@adonis-agora/agent/react/media`). Protocol compatibility does not require installing
 Aviary packages.
 
-`genui({ catalog })` in `config/agent.ts` registers ONE model tool, `ui__render`, taking a
+`genui({ catalog })` in `config/agent.ts` registers a model tool, `ui__render`, taking a
 component tree (`{ type, props, children? }`; a single node is a valid tree and is pushed as
 that component). Its input schema is exact per component. Put `LAYOUT_COMPONENTS` (`Stack`,
 `Card`, …) in the catalog next to `BUILTIN_COMPONENTS` and register a React renderer for each
 layout you use. `mode: 'per-component'` instead registers one `ui__show_<component>` tool per
 standalone component — for small models or when each tool should carry its own exact schema.
+In tree mode, `componentTools: ['Sandbox']` also registers a flat `ui__sandbox` tool per named
+standalone component whose input IS that component's props (prefix `componentToolPrefix`, default `ui__`).
 `streaming: 'partial'` draws the tree while the model writes it; renderers then read
 `useGenuiNode()?.incomplete` and must tolerate half-written props. Source:
 `packages/adonis/docs/generative-ui.mdx`.

package/skills/agent-tools/SKILL.md

@@ -241,13 +241,15 @@ export const listRecords = defineTool({
 `table` and `chart` present the builtin `DataTable` and `Chart` definitions: put them in the
 genui catalog (`BUILTIN_COMPONENTS` from `@adonis-agora/agent/genui/builtins`, or the two
 definitions) and register app renderers under those names. Builtins carry no visuals.
-`genui({ catalog })` also offers the model one `ui__render` tree tool over that catalog (the
-default mode; `mode: 'per-component'` gives `ui__show_*` tools instead).
+`genui({ catalog })` also offers the model a `ui__render` tree tool over that catalog (the
+default mode; `mode: 'per-component'` gives `ui__show_*` tools instead). In tree mode,
+`componentTools: ['Sandbox']` also registers a flat `ui__sandbox` tool per named standalone
+component whose input IS that component's props (prefix `componentToolPrefix`, default `ui__`).
 A tool that knows its component before it reads can push a skeleton first: `ctx.emitUi(name,
 { state: 'loading', … })`, then the data with `{ id }` from that push (the component's props
 schema must accept the placeholder variant; mark it `internal: true`). Always end on that id
 (data, `empty` or `error`), and only push the skeleton when the component is declared in
-`ctx.uiCapabilities` and `ctx.pageContext.channel` is unset. A tool that throws persists none
+`ctx.uiCapabilities` and the turn's channel (`ctx.channel`) is not a messaging channel. A tool that throws persists none
 of its pushes. See `packages/adonis/docs/genui-loading-states.mdx`.
 Use `createComponent` for custom definitions and one `createComponentRegistry` per app
 or tenant. Input `props` may transform; if the transform changes shape or is not