@nocobase/portal-template-default 1.0.0 → 1.0.1

package/registry/nocobase-ai/tests/form-filler-regression.mjs

@@ -0,0 +1,129 @@
+import assert from "node:assert/strict";
+import { createServer } from "vite";
+
+const server = await createServer({
+  appType: "custom",
+  logLevel: "silent",
+  server: { middlewareMode: true },
+});
+
+try {
+  const { AIFormRegistry, createFormFillerInvoker } =
+    await server.ssrLoadModule(
+      "/registry/nocobase-ai/providers/form-registry.tsx"
+    );
+
+  const registry = new AIFormRegistry();
+  const applied = [];
+  const unregister = registry.register({
+    id: "lead-form",
+    title: "Lead form",
+    fields: [
+      { name: "company", type: "string" },
+      {
+        name: "priority",
+        type: "string",
+        enum: ["normal", "high"],
+      },
+      { name: "owner", type: "string", readonly: true },
+    ],
+    getValues: () => ({}),
+    setValues: (values) => applied.push(values),
+  });
+  const invoke = createFormFillerInvoker(registry);
+
+  const allowedContext = { allowedFormIds: ["lead-form"] };
+  assert.deepEqual(
+    await invoke(
+      {
+        form: "lead-form",
+        data: { company: "Acme", priority: "high" },
+      },
+      allowedContext
+    ),
+    {
+      status: "success",
+      content:
+        'Filled "Lead form". Please review the values and submit the form manually.',
+      appliedFields: ["company", "priority"],
+      skippedFields: [],
+    }
+  );
+  assert.deepEqual(applied, [{ company: "Acme", priority: "high" }]);
+
+  assert.deepEqual(
+    await invoke(
+      {
+        form: "lead-form",
+        data: { company: 42, owner: "Ada", unknown: true },
+      },
+      allowedContext
+    ),
+    {
+      status: "error",
+      content: 'No valid editable fields were provided for "Lead form".',
+      appliedFields: [],
+      skippedFields: [
+        {
+          name: "company",
+          reason: "invalid",
+          message: "Expected a string.",
+        },
+        {
+          name: "owner",
+          reason: "readonly",
+          message: "This field is read-only.",
+        },
+        {
+          name: "unknown",
+          reason: "undeclared",
+          message: "This field is not declared by the target form.",
+        },
+      ],
+    }
+  );
+
+  assert.throws(
+    () =>
+      registry.register({
+        id: "lead-form",
+        title: "Duplicate lead form",
+        fields: [],
+        getValues: () => ({}),
+        setValues: () => undefined,
+      }),
+    /already registered/
+  );
+
+  unregister();
+  assert.deepEqual(
+    await invoke(
+      { form: "lead-form", data: { company: "Acme" } },
+      allowedContext
+    ),
+    {
+      status: "error",
+      content: 'The target form "lead-form" is not available on this page.',
+      appliedFields: [],
+      skippedFields: [],
+    }
+  );
+
+  assert.deepEqual(
+    await invoke(
+      { form: "lead-form", data: { company: "Acme" } },
+      { allowedFormIds: [] }
+    ),
+    {
+      status: "error",
+      content:
+        'The target form "lead-form" is not available in this conversation context.',
+      appliedFields: [],
+      skippedFields: [],
+    }
+  );
+
+  console.log("AI Form filler regression tests passed");
+} finally {
+  await server.close();
+}

package/registry/nocobase-ai/tests/frontend-tool-regression.mjs

@@ -0,0 +1,128 @@
+import assert from "node:assert/strict";
+import { createServer } from "vite";
+
+const server = await createServer({
+  appType: "custom",
+  logLevel: "silent",
+  server: { middlewareMode: true },
+});
+
+try {
+  const { AIFrontendToolRegistry, createFrontendToolInvokers } =
+    await server.ssrLoadModule(
+      "/registry/nocobase-ai/providers/frontend-tool-registry.tsx"
+    );
+
+  const registry = new AIFrontendToolRegistry();
+  const calls = [];
+  const unregister = registry.register("quote-card", {
+    name: "update_quote_discount",
+    description: "Update the quote discount preview.",
+    permission: "ASK",
+    inputSchema: {
+      type: "object",
+      properties: { discountPercent: { type: "number" } },
+    },
+    execute: (args) => {
+      calls.push(args);
+      return { updated: true };
+    },
+  });
+  const [manifest] = registry.list("quote-card");
+  assert.deepEqual(manifest, {
+    id: "quote-card:update_quote_discount",
+    blockUid: "quote-card",
+    name: "update_quote_discount",
+    title: undefined,
+    description: "Update the quote discount preview.",
+    permission: "ASK",
+    inputSchema: {
+      type: "object",
+      properties: { discountPercent: { type: "number" } },
+    },
+  });
+
+  const invokers = createFrontendToolInvokers(registry);
+  const allowedContext = { allowedFrontendToolIds: [manifest.id] };
+  assert.deepEqual(
+    await invokers.loadFrontendTool({ toolId: manifest.id }, allowedContext),
+    manifest
+  );
+  assert.deepEqual(
+    await invokers.executeFrontendTool(
+      { toolId: manifest.id, args: { discountPercent: 12 } },
+      allowedContext
+    ),
+    { updated: true }
+  );
+  assert.deepEqual(calls, [{ discountPercent: 12 }]);
+
+  assert.throws(
+    () =>
+      registry.register("quote-card", {
+        name: "update_quote_discount",
+        description: "Duplicate Tool",
+        execute: () => undefined,
+      }),
+    /already registered/
+  );
+  assert.throws(
+    () =>
+      registry.register("quote-card", {
+        name: "invalid_schema",
+        description: "Invalid schema",
+        inputSchema: [],
+        execute: () => undefined,
+      }),
+    /inputSchema must be an object/
+  );
+
+  const unregisterInvalidResult = registry.register("quote-card", {
+    name: "invalid_result",
+    description: "Return an invalid result.",
+    execute: () => ({ value: 1n }),
+  });
+  assert.deepEqual(
+    await invokers.executeFrontendTool(
+      { toolId: "quote-card:invalid_result", args: {} },
+      {
+        allowedFrontendToolIds: ["quote-card:invalid_result"],
+      }
+    ),
+    {
+      status: "error",
+      content:
+        'Frontend Tool "quote-card:invalid_result" returned a non-serializable result',
+    }
+  );
+  unregisterInvalidResult();
+
+  unregister();
+  assert.deepEqual(
+    await invokers.executeFrontendTool(
+      { toolId: manifest.id, args: {} },
+      allowedContext
+    ),
+    {
+      status: "error",
+      content:
+        'Frontend Tool "quote-card:update_quote_discount" is unavailable',
+    }
+  );
+
+  assert.deepEqual(
+    await invokers.executeFrontendTool(
+      { toolId: manifest.id, args: {} },
+      { allowedFrontendToolIds: [] }
+    ),
+    {
+      status: "error",
+      content:
+        'Frontend Tool "quote-card:update_quote_discount" is not available in this conversation context',
+    }
+  );
+
+  console.log("AI frontend Tool regression tests passed");
+} finally {
+  await server.close();
+}

package/registry/nocobase-ai/tests/page-context-regression.mjs

@@ -0,0 +1,48 @@
+import assert from "node:assert/strict";
+import { createServer } from "vite";
+
+const server = await createServer({
+  appType: "custom",
+  logLevel: "silent",
+  server: { middlewareMode: true },
+});
+
+try {
+  const {
+    createAIPageContextReference,
+    getAIWorkContextRequiredTools,
+    mergeAIRequiredTools,
+  } = await server.ssrLoadModule(
+    "/registry/nocobase-ai/providers/page-context.tsx"
+  );
+
+  const formContext = createAIPageContextReference({
+    id: "lead-form",
+    title: "Lead form",
+    kind: "form",
+  });
+  assert.deepEqual(formContext, {
+    type: "page-element",
+    id: "lead-form",
+    title: "Lead form",
+    kind: "form",
+  });
+  assert.deepEqual(getAIWorkContextRequiredTools([formContext]), [
+    "formFiller",
+  ]);
+  assert.deepEqual(
+    mergeAIRequiredTools(
+      { skills: ["lead-review"], tools: ["inspect-record"] },
+      ["formFiller", "inspect-record"]
+    ),
+    {
+      skills: ["lead-review"],
+      tools: ["inspect-record", "formFiller"],
+    }
+  );
+  assert.equal(mergeAIRequiredTools(undefined, []), undefined);
+
+  console.log("AI page context regression tests passed");
+} finally {
+  await server.close();
+}

package/registry/nocobase-ai/tests/stream-regression.mjs

@@ -0,0 +1,207 @@
+import assert from "node:assert/strict";
+import { createServer } from "vite";
+
+const wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+
+const encodeSSE = (events) => {
+  const encoder = new TextEncoder();
+  return new ReadableStream({
+    start(controller) {
+      controller.enqueue(
+        encoder.encode(
+          events.map((event) => `data: ${JSON.stringify(event)}\n\n`).join("")
+        )
+      );
+      controller.close();
+    },
+  });
+};
+
+const collectStream = async (stream) => {
+  const result = [];
+  for await (const chunk of stream) result.push(chunk);
+  return result;
+};
+
+const server = await createServer({
+  appType: "custom",
+  logLevel: "silent",
+  server: { middlewareMode: true },
+});
+
+try {
+  const { StreamCoalescer } = await server.ssrLoadModule(
+    "/registry/nocobase-ai/providers/stream-coalescer.ts"
+  );
+  const { NocoBaseChatTransport } = await server.ssrLoadModule(
+    "/registry/nocobase-ai/providers/chat-transport.ts"
+  );
+  const { SubAgentStreamAccumulator } = await server.ssrLoadModule(
+    "/registry/nocobase-ai/providers/sub-agent-stream.ts"
+  );
+  const { NocoBaseClient } = await server.ssrLoadModule(
+    "/src/lib/nocobase/client.ts"
+  );
+
+  {
+    const client = new NocoBaseClient("http://localhost:13001/api");
+    assert.equal(
+      client.resolveUrl("/files/main/main/aiFiles/5.png?preview=1"),
+      "http://localhost:13001/files/main/main/aiFiles/5.png?preview=1"
+    );
+    assert.equal(
+      client.resolveUrl("https://cdn.example.com/file.png"),
+      "https://cdn.example.com/file.png"
+    );
+  }
+
+  {
+    const flushed = [];
+    const coalescer = new StreamCoalescer({
+      interval: 20,
+      maxSize: 100,
+      getSize: (value) => value.length,
+      merge: (current, incoming) => current + incoming,
+      onFlush: (key, value) => flushed.push([key, value]),
+    });
+    coalescer.push("message", "hello ");
+    coalescer.push("message", "world");
+    await wait(35);
+    assert.deepEqual(flushed, [["message", "hello world"]]);
+  }
+
+  {
+    const seedMessage = {
+      id: "assistant-existing",
+      role: "assistant",
+      parts: [
+        {
+          type: "data-subAgent",
+          id: "sub-1",
+          data: {
+            sessionId: "sub-1",
+            username: "viz",
+            status: "pending",
+            messages: [
+              {
+                id: "sub-message",
+                role: "assistant",
+                parts: [{ type: "text", text: "saved ", state: "done" }],
+              },
+            ],
+          },
+        },
+      ],
+    };
+    const accumulator = new SubAgentStreamAccumulator(seedMessage);
+    const [chunk] = accumulator.process({
+      type: "content",
+      body: "tail",
+      from: "sub-agent",
+      sessionId: "sub-1",
+      username: "viz",
+    });
+    assert.equal(chunk.data.messages.length, 1);
+    assert.equal(chunk.data.messages[0].parts[0].text, "saved tail");
+  }
+
+  {
+    const toolCallId = "report-tool";
+    const events = [
+      ...Array.from({ length: 100 }, (_, index) => ({
+        type: "tool_call_chunks",
+        from: "main-agent",
+        sessionId: "conversation-1",
+        body: [
+          index === 0
+            ? {
+                id: toolCallId,
+                name: "businessReportGenerator",
+                args: "{",
+              }
+            : { id: toolCallId, args: "x" },
+        ],
+      })),
+      { type: "stream_end", from: "main-agent", sessionId: "conversation-1" },
+    ];
+    const service = {
+      resumeConversationStream: async () => encodeSSE(events),
+    };
+    const transport = new NocoBaseChatTransport({
+      service,
+      getContext: () => ({
+        sessionId: "conversation-1",
+        employee: { username: "atlas", nickname: "Atlas" },
+        model: { value: "test", label: "Test" },
+      }),
+    });
+    transport.prepareConversationResume([
+      { id: "assistant-existing", role: "assistant", parts: [] },
+    ]);
+    const chunks = await collectStream(await transport.reconnectToStream());
+    const start = chunks.find((chunk) => chunk.type === "start");
+    const toolDeltas = chunks.filter(
+      (chunk) => chunk.type === "tool-input-delta"
+    );
+    assert.equal(start.messageId, undefined);
+    assert.ok(toolDeltas.length < 10, `received ${toolDeltas.length} deltas`);
+    assert.equal(
+      toolDeltas.reduce((size, chunk) => size + chunk.inputTextDelta.length, 0),
+      100
+    );
+  }
+
+  {
+    let request;
+    const service = {
+      sendMessagesStream: async (input) => {
+        request = input;
+        return encodeSSE([
+          { type: "content", body: "ok", from: "main-agent" },
+          { type: "stream_end", from: "main-agent" },
+        ]);
+      },
+    };
+    const transport = new NocoBaseChatTransport({
+      service,
+      getContext: () => ({
+        sessionId: "conversation-context",
+        employee: { username: "mira", nickname: "Mira" },
+        model: { value: "test", label: "Test" },
+      }),
+    });
+    await collectStream(
+      await transport.sendMessages({
+        messages: [
+          {
+            id: "user-context",
+            role: "user",
+            metadata: {
+              workContext: [
+                {
+                  type: "page-element",
+                  id: "customer-form",
+                  title: "Customer form",
+                  content: { values: { name: "Northwind" } },
+                },
+              ],
+            },
+            parts: [{ type: "text", text: "Review this form" }],
+          },
+        ],
+      })
+    );
+    assert.deepEqual(request.messages[0].workContext, [
+      {
+        type: "page-element",
+        id: "customer-form",
+        title: "Customer form",
+        content: { values: { name: "Northwind" } },
+      },
+    ]);
+  }
+
+  console.log("AI stream regression tests passed");
+} finally {
+  await server.close();
+}

package/registry.config.json

@@ -0,0 +1,143 @@
+{
+  "name": "nocobase-ai",
+  "homepage": "https://www.nocobase.com",
+  "items": [
+    {
+      "name": "ai-runtime",
+      "type": "registry:lib",
+      "title": "NocoBase AI Runtime",
+      "description": "NocoBase AI services, providers, transports, controllers, and avatars.",
+      "dependencies": [
+        "@ai-sdk/react@2.0.0",
+        "ai@5.0.0",
+        "@dicebear/core@^9.4.3",
+        "@nocobase/ai-employee-avatars@^1.0.2",
+        "eventsource-parser@3.1.0"
+      ],
+      "source": {
+        "root": "registry/nocobase-ai",
+        "target": "src/extensions/nocobase-ai",
+        "include": ["providers", "services"]
+      }
+    },
+    {
+      "name": "ai-chat",
+      "type": "registry:block",
+      "title": "NocoBase AI Chat Components",
+      "description": "Reusable NocoBase AI chat window, containers, floating trigger, and employee shortcut.",
+      "dependencies": [
+        "echarts@^5.5.0",
+        "echarts-for-react@3.0.2",
+        "lucide-react@^0.487.0",
+        "next-themes@^0.4.6",
+        "react-markdown@^10.1.0",
+        "remark-gfm@^4.0.1"
+      ],
+      "registryDependencies": [
+        "@nocobase/ai-runtime",
+        "badge",
+        "button",
+        "collapsible",
+        "dialog",
+        "dropdown-menu",
+        "hover-card",
+        "input",
+        "input-group",
+        "label",
+        "popover",
+        "select",
+        "tabs",
+        "textarea",
+        "tooltip"
+      ],
+      "source": {
+        "root": "registry/nocobase-ai",
+        "target": "src/extensions/nocobase-ai",
+        "include": ["components", "assets", "index.ts", "README.md"]
+      }
+    },
+    {
+      "name": "ai-react-hook-form",
+      "type": "registry:lib",
+      "title": "NocoBase AI React Hook Form Adapter",
+      "description": "Optional React Hook Form adapter for the built-in AI Form filler.",
+      "dependencies": ["react-hook-form@^7.57.0"],
+      "registryDependencies": ["@nocobase/ai-chat"],
+      "source": {
+        "root": "registry/nocobase-ai",
+        "target": "src/extensions/nocobase-ai",
+        "include": ["adapters/react-hook-form.ts"]
+      }
+    },
+    {
+      "name": "ai",
+      "type": "registry:block",
+      "title": "NocoBase AI Components and Demo",
+      "description": "Complete NocoBase AI component runtime with Refine resources, routes, and component showcase pages.",
+      "dependencies": ["@refinedev/core@^5.0.8", "react-router@^7.0.2"],
+      "registryDependencies": [
+        "@nocobase/ai-chat",
+        "@nocobase/ai-react-hook-form",
+        "accordion",
+        "alert",
+        "badge",
+        "card",
+        "checkbox",
+        "input",
+        "switch",
+        "table",
+        "textarea"
+      ],
+      "docs": "This item includes the AI extension integration and Demo pages. It is designed for a compatible starter with the AppExtension host enabled. After installation, src/extensions/nocobase-ai/extension.tsx is discovered automatically and contributes its Refine resources and routes without AI-specific App.tsx edits.",
+      "source": {
+        "root": "registry/nocobase-ai",
+        "target": "src/extensions/nocobase-ai",
+        "include": ["demo", "extension.tsx", "global-ai-chat.tsx"]
+      }
+    },
+    {
+      "name": "acl-ui",
+      "type": "registry:block",
+      "title": "NocoBase ACL UI",
+      "description": "Page, region, field, and role-switching components backed by the Starter's NocoBase accessControlProvider.",
+      "dependencies": [
+        "@refinedev/core@^5.0.8",
+        "lucide-react@^0.487.0"
+      ],
+      "registryDependencies": [
+        "badge",
+        "select"
+      ],
+      "docs": "Requires a compatible NocoBase Starter with the built-in accessControlProvider and ACL store.",
+      "source": {
+        "root": "registry/nocobase-acl",
+        "target": "src/extensions/nocobase-acl",
+        "include": ["components", "index.ts", "README.md"]
+      }
+    },
+    {
+      "name": "acl",
+      "type": "registry:block",
+      "title": "NocoBase ACL Components and Demo",
+      "description": "Complete ACL composition demo with live role switching, action matrix, multi-collection regions, and field permissions.",
+      "dependencies": [
+        "@refinedev/core@^5.0.8",
+        "react-router@^7.0.2"
+      ],
+      "registryDependencies": [
+        "@nocobase/acl-ui",
+        "button",
+        "card",
+        "input",
+        "label",
+        "table",
+        "textarea"
+      ],
+      "source": {
+        "root": "registry/nocobase-acl",
+        "target": "src/extensions/nocobase-acl",
+        "include": ["demo", "extension.tsx"]
+      }
+    }
+  ]
+}