Generate Zod protocol documentation at file level with consolidated schemas

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/AIKnowledge.mdx

@@ -1,11 +1,35 @@
 ---
 title: AIKnowledge
 description: AIKnowledge Schema Reference
+category: ai
+zodFile: agent
 ---
 
+
+<Callout type="info">
+**Source:** `packages/spec/src/ai/agent.zod.ts`
+</Callout>
+
 ## Properties
 
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
 | **topics** | `string[]` | ✅ | Topics/Tags to recruit knowledge from |
 | **indexes** | `string[]` | ✅ | Vector Store Indexes |
+
+## TypeScript Usage
+
+```typescript
+import { AIKnowledgeSchema } from '@objectstack/spec/ai';
+import type { AIKnowledge } from '@objectstack/spec/ai';
+
+// Validate data
+const result = AIKnowledgeSchema.parse(data);
+
+// Type-safe usage
+const myAIKnowledge: AIKnowledge = {
+  topics: [],
+  indexes: []
+};
+```
+

content/docs/references/ai/agent/AIModelConfig.mdx

@@ -1,8 +1,15 @@
 ---
 title: AIModelConfig
 description: AIModelConfig Schema Reference
+category: ai
+zodFile: agent
 ---
 
+
+<Callout type="info">
+**Source:** `packages/spec/src/ai/agent.zod.ts`
+</Callout>
+
 ## Properties
 
 | Property | Type | Required | Description |
@@ -12,3 +19,19 @@ description: AIModelConfig Schema Reference
 | **temperature** | `number` | optional |  |
 | **maxTokens** | `number` | optional |  |
 | **topP** | `number` | optional |  |
+
+## TypeScript Usage
+
+```typescript
+import { AIModelConfigSchema } from '@objectstack/spec/ai';
+import type { AIModelConfig } from '@objectstack/spec/ai';
+
+// Validate data
+const result = AIModelConfigSchema.parse(data);
+
+// Type-safe usage
+const myAIModelConfig: AIModelConfig = {
+  model: 'example'
+};
+```
+

content/docs/references/ai/agent/AITool.mdx

@@ -1,12 +1,36 @@
 ---
 title: AITool
 description: AITool Schema Reference
+category: ai
+zodFile: agent
 ---
 
+
+<Callout type="info">
+**Source:** `packages/spec/src/ai/agent.zod.ts`
+</Callout>
+
 ## 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 |
+
+## TypeScript Usage
+
+```typescript
+import { AIToolSchema } from '@objectstack/spec/ai';
+import type { AITool } from '@objectstack/spec/ai';
+
+// Validate data
+const result = AIToolSchema.parse(data);
+
+// Type-safe usage
+const myAITool: AITool = {
+  type: 'action',
+  name: 'name'
+};
+```
+

content/docs/references/ai/agent/Agent.mdx

@@ -1,8 +1,15 @@
 ---
 title: Agent
 description: Agent Schema Reference
+category: ai
+zodFile: agent
 ---
 
+
+<Callout type="info">
+**Source:** `packages/spec/src/ai/agent.zod.ts`
+</Callout>
+
 ## Properties
 
 | Property | Type | Required | Description |
@@ -17,3 +24,22 @@ description: Agent Schema Reference
 | **knowledge** | `object` | optional | RAG access |
 | **active** | `boolean` | optional |  |
 | **access** | `string[]` | optional | Who can chat with this agent |
+
+## TypeScript Usage
+
+```typescript
+import { AgentSchema } from '@objectstack/spec/ai';
+import type { Agent } from '@objectstack/spec/ai';
+
+// Validate data
+const result = AgentSchema.parse(data);
+
+// Type-safe usage
+const myAgent: Agent = {
+  name: 'name',
+  label: 'example',
+  role: 'example',
+  // ... other required fields
+};
+```
+

content/docs/references/ai/conversation/ConversationAnalytics.mdx

@@ -1,8 +1,15 @@
 ---
 title: ConversationAnalytics
 description: ConversationAnalytics Schema Reference
+category: ai
+zodFile: conversation
 ---
 
+
+<Callout type="info">
+**Source:** `packages/spec/src/ai/conversation.zod.ts`
+</Callout>
+
 ## Properties
 
 | Property | Type | Required | Description |
@@ -22,3 +29,22 @@ description: ConversationAnalytics Schema Reference
 | **duration** | `number` | optional | Session duration in seconds |
 | **firstMessageAt** | `string` | optional | ISO 8601 timestamp |
 | **lastMessageAt** | `string` | optional | ISO 8601 timestamp |
+
+## TypeScript Usage
+
+```typescript
+import { ConversationAnalyticsSchema } from '@objectstack/spec/ai';
+import type { ConversationAnalytics } from '@objectstack/spec/ai';
+
+// Validate data
+const result = ConversationAnalyticsSchema.parse(data);
+
+// Type-safe usage
+const myConversationAnalytics: ConversationAnalytics = {
+  sessionId: 'example',
+  totalMessages: null,
+  userMessages: null,
+  // ... other required fields
+};
+```
+

content/docs/references/ai/conversation/ConversationContext.mdx

@@ -1,8 +1,15 @@
 ---
 title: ConversationContext
 description: ConversationContext Schema Reference
+category: ai
+zodFile: conversation
 ---
 
+
+<Callout type="info">
+**Source:** `packages/spec/src/ai/conversation.zod.ts`
+</Callout>
+
 ## Properties
 
 | Property | Type | Required | Description |
@@ -15,3 +22,19 @@ description: ConversationContext Schema Reference
 | **scope** | `Record<string, any>` | optional | Additional context scope |
 | **systemMessage** | `string` | optional | System prompt/instructions |
 | **metadata** | `Record<string, any>` | optional |  |
+
+## TypeScript Usage
+
+```typescript
+import { ConversationContextSchema } from '@objectstack/spec/ai';
+import type { ConversationContext } from '@objectstack/spec/ai';
+
+// Validate data
+const result = ConversationContextSchema.parse(data);
+
+// Type-safe usage
+const myConversationContext: ConversationContext = {
+  sessionId: 'example'
+};
+```
+

content/docs/references/ai/conversation/ConversationMessage.mdx

@@ -1,8 +1,15 @@
 ---
 title: ConversationMessage
 description: ConversationMessage Schema Reference
+category: ai
+zodFile: conversation
 ---
 
+
+<Callout type="info">
+**Source:** `packages/spec/src/ai/conversation.zod.ts`
+</Callout>
+
 ## Properties
 
 | Property | Type | Required | Description |
@@ -20,3 +27,22 @@ description: ConversationMessage Schema Reference
 | **importance** | `number` | optional | Importance score for pruning |
 | **embedding** | `number[]` | optional | Vector embedding for semantic search |
 | **metadata** | `Record<string, any>` | optional |  |
+
+## TypeScript Usage
+
+```typescript
+import { ConversationMessageSchema } from '@objectstack/spec/ai';
+import type { ConversationMessage } from '@objectstack/spec/ai';
+
+// Validate data
+const result = ConversationMessageSchema.parse(data);
+
+// Type-safe usage
+const myConversationMessage: ConversationMessage = {
+  id: 'example',
+  timestamp: 'example',
+  role: 'system',
+  // ... other required fields
+};
+```
+

content/docs/references/ai/conversation/ConversationSession.mdx

@@ -1,8 +1,15 @@
 ---
 title: ConversationSession
 description: ConversationSession Schema Reference
+category: ai
+zodFile: conversation
 ---
 
+
+<Callout type="info">
+**Source:** `packages/spec/src/ai/conversation.zod.ts`
+</Callout>
+
 ## Properties
 
 | Property | Type | Required | Description |
@@ -20,3 +27,22 @@ description: ConversationSession Schema Reference
 | **expiresAt** | `string` | optional | ISO 8601 timestamp |
 | **tags** | `string[]` | optional |  |
 | **metadata** | `Record<string, any>` | optional |  |
+
+## TypeScript Usage
+
+```typescript
+import { ConversationSessionSchema } from '@objectstack/spec/ai';
+import type { ConversationSession } from '@objectstack/spec/ai';
+
+// Validate data
+const result = ConversationSessionSchema.parse(data);
+
+// Type-safe usage
+const myConversationSession: ConversationSession = {
+  id: 'example',
+  context: {},
+  tokenBudget: {},
+  // ... other required fields
+};
+```
+

content/docs/references/ai/conversation/ConversationSummary.mdx

@@ -1,8 +1,15 @@
 ---
 title: ConversationSummary
 description: ConversationSummary Schema Reference
+category: ai
+zodFile: conversation
 ---
 
+
+<Callout type="info">
+**Source:** `packages/spec/src/ai/conversation.zod.ts`
+</Callout>
+
 ## Properties
 
 | Property | Type | Required | Description |
@@ -15,3 +22,22 @@ description: ConversationSummary Schema Reference
 | **messageRange** | `object` | ✅ | Range of messages summarized |
 | **generatedAt** | `string` | ✅ | ISO 8601 timestamp |
 | **modelId** | `string` | optional | Model used for summarization |
+
+## TypeScript Usage
+
+```typescript
+import { ConversationSummarySchema } from '@objectstack/spec/ai';
+import type { ConversationSummary } from '@objectstack/spec/ai';
+
+// Validate data
+const result = ConversationSummarySchema.parse(data);
+
+// Type-safe usage
+const myConversationSummary: ConversationSummary = {
+  summary: 'example',
+  originalTokens: null,
+  summaryTokens: null,
+  // ... other required fields
+};
+```
+