Merge pull request #325 from objectstack-ai/copilot/improve-zod-protocol-display

Author: hotlong

apps/docs/app/[lang]/docs/[[...slug]]/page.tsx

@@ -5,6 +5,7 @@ import { notFound } from 'next/navigation';
 import defaultMdxComponents from 'fumadocs-ui/mdx';
 import { Step, Steps } from 'fumadocs-ui/components/steps';
 import { File, Folder, Files } from 'fumadocs-ui/components/files';
+import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
 
 const components = {
   ...defaultMdxComponents,
@@ -14,6 +15,8 @@ const components = {
   Folder,
   Files,
   FileTree: Files,
+  Tab,
+  Tabs,
 };
 
 export default async function Page(props: {

apps/docs/next.config.mjs

@@ -18,20 +18,16 @@ const config = {
       },
     ],
   },
-  experimental: {
-    turbo: {
-      resolveAlias: {
-        'fumadocs-ui/components/callout': 'fumadocs-ui/dist/components/callout.js',
-      },
-    },
-  },
   webpack: (config, { isServer }) => {
     // Resolve the fumadocs virtual collection import to the local .source directory
     config.resolve = config.resolve || {};
     config.resolve.alias = {
       ...(config.resolve.alias || {}),
       'fumadocs-mdx:collections': path.resolve(__dirname, '.source'),
-      'fumadocs-ui/components/callout$': path.resolve(__dirname, '../../node_modules/fumadocs-ui/dist/components/callout.js'),
+      'fumadocs-ui/components/callout$': path.resolve(__dirname, './node_modules/fumadocs-ui/dist/components/callout.js'),
+      'fumadocs-ui/components/card$': path.resolve(__dirname, './node_modules/fumadocs-ui/dist/components/card.js'),
+      'fumadocs-ui/components/tabs$': path.resolve(__dirname, './node_modules/fumadocs-ui/dist/components/tabs.js'),
+      'lucide-react$': path.resolve(__dirname, './node_modules/lucide-react/dist/cjs/lucide-react.js'),
     };
     return config;
   },

apps/docs/package.json

@@ -5,7 +5,7 @@
   "description": "ObjectStack Protocol Documentation Site",
   "scripts": {
     "dev": "next dev",
-    "build": "NEXT_PRIVATE_BUILD_WORKER=1 next build",
+    "build": "next build",
     "site:start": "next start",
     "site:lint": "next lint"
   },

content/docs/references/ai/agent.mdx

@@ -0,0 +1,77 @@
+---
+title: Agent
+description: Agent protocol schemas
+---
+
+# Agent
+
+<Callout type="info">
+**Source:** `packages/spec/src/ai/agent.zod.ts`
+</Callout>
+
+## TypeScript Usage
+
+```typescript
+import { AIKnowledgeSchema, AIModelConfigSchema, AIToolSchema, AgentSchema } from '@objectstack/spec/ai';
+import type { AIKnowledge, AIModelConfig, AITool, Agent } from '@objectstack/spec/ai';
+
+// Validate data
+const result = AIKnowledgeSchema.parse(data);
+```
+
+---
+
+## AIKnowledge
+
+### Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **topics** | `string[]` | ✅ | Topics/Tags to recruit knowledge from |
+| **indexes** | `string[]` | ✅ | Vector Store Indexes |
+
+---
+
+## AIModelConfig
+
+### Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **provider** | `Enum<'openai' \| 'azure_openai' \| 'anthropic' \| 'local'>` | optional |  |
+| **model** | `string` | ✅ | Model name (e.g. gpt-4, claude-3-opus) |
+| **temperature** | `number` | optional |  |
+| **maxTokens** | `number` | optional |  |
+| **topP** | `number` | optional |  |
+
+---
+
+## AITool
+
+### Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **type** | `Enum<'action' \| 'flow' \| 'query' \| 'vector_search'>` | ✅ |  |
+| **name** | `string` | ✅ | Reference name (Action Name, Flow Name) |
+| **description** | `string` | optional | Override description for the LLM |
+
+---
+
+## Agent
+
+### Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| **name** | `string` | ✅ | Agent unique identifier |
+| **label** | `string` | ✅ | Agent display name |
+| **avatar** | `string` | optional |  |
+| **role** | `string` | ✅ | The persona/role (e.g. "Senior Support Engineer") |
+| **instructions** | `string` | ✅ | System Prompt / Prime Directives |
+| **model** | `object` | optional |  |
+| **tools** | `object[]` | optional | Available tools |
+| **knowledge** | `object` | optional | RAG access |
+| **active** | `boolean` | optional |  |
+| **access** | `string[]` | optional | Who can chat with this agent |
+