deepspace 0.10.1 → 0.10.2

package/features/admin-page/src/admin-schema.ts

@@ -4,7 +4,7 @@
  * Admin-only settings collection for key-value app configuration.
  */
 
-import type { CollectionSchema } from 'deepspace/worker'
+import type { CollectionSchema } from 'deepspace/schema'
 
 export const settingsSchema: CollectionSchema = {
   name: 'settings',

package/features/ai-chat/feature.json

@@ -36,8 +36,8 @@
   ],
   "patterns": [
     "ChatPanel takes `chatId` (or null). Parent owns chat lifecycle (create / select / delete); pass `disabled` while a parent-driven create is in flight so the panel doesn't kick off its own auto-create.",
-    "ChatPanel's DEFAULT_MODELS and worker.ts's ALLOWED_MODELS must stay in sync — add entries to both when introducing a new model.",
+    "ChatPanel and the server agent both consume the SDK's canonical model catalog; never add a second model allowlist in app code.",
     "Compaction summary is stored on the ai-chats row (compactedSummary, compactedThroughId). The summarizer is user-billed by default; pass `makeDefaultSummarizer(c.env)` with no authToken in worker.ts to absorb the cost as the developer instead.",
-    "Tool execution is server-side and per-user RBAC-enforced (records.* tools see only what the caller would see). `stopWhen: stepCountIs(5)` caps tool-use rounds per turn."
+    "Tool execution is server-side and per-user RBAC-enforced (records.* tools see only what the caller would see). The canonical runner enforces at most 20 tool calls per turn."
   ]
 }

package/features/ai-chat/src/ChatPanel.tsx

@@ -20,7 +20,7 @@ import {
   ChevronDown,
   Square,
 } from 'lucide-react'
-import { useQuery } from 'deepspace'
+import { listDeepSpaceAgentModels, useQuery } from 'deepspace'
 import { EmptyState, MessageTurn, ThinkingIndicator } from './ChatPanel.messages'
 import { useStreamingChat } from './ChatPanel.stream'
 
@@ -73,16 +73,11 @@ const DEFAULT_PROMPTS = [
   'List my collections',
 ]
 
-// Keep this picker aligned with ALLOWED_MODELS in src/ai/chat-routes.ts.
-const DEFAULT_MODELS: ModelOption[] = [
-  { id: 'claude-sonnet-5', label: 'Claude Sonnet 5', provider: 'Anthropic' },
-  { id: 'claude-opus-4-8', label: 'Claude Opus 4.8', provider: 'Anthropic' },
-  { id: 'claude-haiku-4-5', label: 'Claude Haiku 4.5', provider: 'Anthropic' },
-  { id: 'gpt-5.6-terra', label: 'GPT-5.6 Terra', provider: 'OpenAI' },
-  { id: 'gpt-5.6-sol', label: 'GPT-5.6 Sol', provider: 'OpenAI' },
-  { id: 'gpt-5.6-luna', label: 'GPT-5.6 Luna', provider: 'OpenAI' },
-  { id: 'gpt-oss-120b', label: 'GPT-OSS 120B', provider: 'Cerebras' },
-]
+const DEFAULT_MODELS: ModelOption[] = listDeepSpaceAgentModels('application').map((model) => ({
+  id: model.id,
+  label: model.label,
+  provider: model.providerLabel,
+}))
 
 export function ChatPanel({
   chatId,

package/features/ai-chat/src/ai-chat-schema.ts

@@ -5,7 +5,6 @@
  * Spread into the app's schemas array: ...aiChatSchemas
  */
 
-import type { CollectionSchema } from 'deepspace/worker'
-import { AI_CHATS_SCHEMA, AI_MESSAGES_SCHEMA } from 'deepspace/worker'
+import { AI_CHATS_SCHEMA, AI_MESSAGES_SCHEMA, type CollectionSchema } from 'deepspace/schema'
 
 export const aiChatSchemas: CollectionSchema[] = [AI_CHATS_SCHEMA, AI_MESSAGES_SCHEMA]

package/features/canvas/src/canvas-schema.ts

@@ -6,7 +6,7 @@
  * not in RecordRoom. This schema is just for document metadata.
  */
 
-import type { CollectionSchema } from 'deepspace/worker'
+import type { CollectionSchema } from 'deepspace/schema'
 
 export const canvasSchema: CollectionSchema = {
   name: 'canvases',

package/features/documentation/content/index.mdx

@@ -0,0 +1,14 @@
+---
+title: Introduction
+description: Start writing documentation for your DeepSpace app.
+---
+
+This site is compiled from Markdown and MDX in the same repository as your
+DeepSpace app. It is available at `/docs` whenever you run or deploy the app.
+
+## Edit this page
+
+Update `documentation/index.mdx`, then use your ordinary development workflow to
+preview the result.
+
+MDX can import your app's React components directly when prose is not enough.

package/features/documentation/content/quickstart.mdx

@@ -0,0 +1,12 @@
+---
+title: Quickstart
+description: Configure and expand your documentation.
+---
+
+1. Set your name, navigation, colors, links, and assistant access in `documentation.json`.
+2. Add `.md` or `.mdx` files under `documentation/`.
+3. Run the app normally and open `/docs`.
+4. Deploy the app normally when the documentation is ready.
+
+For a custom React shell, add one root `documentation.tsx` file. The default surface
+remains available as a component, so customization can be incremental.

package/features/documentation/documentation.json

@@ -0,0 +1,18 @@
+{
+  "name": "Documentation",
+  "description": "Documentation for this DeepSpace app",
+  "domains": [],
+  "navigation": [
+    {
+      "group": "Get started",
+      "pages": ["index", "quickstart"]
+    }
+  ],
+  "assistant": {
+    "access": "authenticated",
+    "suggestions": [
+      "How do I get started?",
+      "What can I build?"
+    ]
+  }
+}

package/features/documentation/feature.json

@@ -0,0 +1,68 @@
+{
+  "id": "documentation",
+  "name": "Documentation",
+  "category": "publishing",
+  "description": "Publish Markdown and MDX documentation with search, API references, and an AI assistant",
+  "details": "Adds public documentation at /docs to this app's normal development and deployment lifecycle. Markdown is the default; MDX and an optional root documentation.tsx can import arbitrary app code without a plugin layer.",
+  "files": [
+    {
+      "src": "documentation.json",
+      "dest": "documentation.json"
+    },
+    {
+      "src": "content/index.mdx",
+      "dest": "documentation/index.mdx"
+    },
+    {
+      "src": "content/quickstart.mdx",
+      "dest": "documentation/quickstart.mdx"
+    }
+  ],
+  "ignore": ["public/_documentation", "public/_documentation-root"],
+  "wrangler": {
+    "runWorkerFirst": true,
+    "rateLimits": [
+      {
+        "name": "DOCUMENTATION_CLIENT_RATE_LIMITER",
+        "namespaceId": "2001",
+        "limit": 12,
+        "period": 60
+      },
+      {
+        "name": "DOCUMENTATION_APP_RATE_LIMITER",
+        "namespaceId": "2002",
+        "limit": 120,
+        "period": 60
+      }
+    ]
+  },
+  "code": [
+    {
+      "file": "vite.config.ts",
+      "import": "import { deepSpaceDocumentation } from 'deepspace/documentation'",
+      "marker": "  plugins: [",
+      "insert": "    deepSpaceDocumentation(),"
+    },
+    {
+      "file": "worker.ts",
+      "import": "import documentationConfig from './documentation.json'\nimport { registerDeepSpaceDocumentation } from 'deepspace/worker'",
+      "marker": "registerPlatformProxyRoutes(app)",
+      "placement": "before",
+      "insert": "registerDeepSpaceDocumentation(app, { resolveAuth, config: documentationConfig })"
+    }
+  ],
+  "instructions": [
+    "Edit documentation.json to set your name, navigation, branding, assistant access, and optional custom documentation domains.",
+    "Write Markdown or MDX in documentation/. Add a root documentation.tsx only when you want to wrap or replace the default React surface."
+  ],
+  "patterns": [
+    "The feature is served at /docs on the app's existing hostname.",
+    "A hostname listed in documentation.json domains serves the same release at that hostname's root after you explicitly attach it to the app.",
+    "Documentation builds only when documentation.json exists; apps without this feature are unaffected.",
+    "MDX may import app components directly. documentation.tsx is the single optional shell customization point."
+  ],
+  "agentNotes": [
+    "Treat documentation.json, documentation/**/*.md, documentation/**/*.mdx, and optional documentation.tsx as one app-owned documentation feature.",
+    "Use ordinary deepspace dev start and deepspace deploy commands; there is no separate documentation command namespace."
+  ]
+}

package/features/{docs → documents}/feature.json

@@ -1,70 +1,70 @@
 {
-  "id": "docs",
+  "id": "documents",
   "name": "Documents",
   "category": "data",
   "description": "Real-time collaborative document editing with Tiptap + Yjs",
-  "details": "Document library with folders & favorites. Collaborative editor built on Tiptap (ProseMirror) with Y.XmlFragment via @tiptap/extension-collaboration and live remote cursors via @tiptap/extension-collaboration-caret — buttery typing, no innerHTML rebuilds, no contenteditable quirks. Invite-only docs with viewer/editor roles: owner shares via an in-app dialog that resolves an email to a DeepSpace user. RBAC is enforced by the documents schema and the starter template's built-in Yjs route. Includes a one-shot migration shim that converts docs created with the legacy contenteditable editor (HTML stored in Y.Text('content')) into Tiptap on first open.",
+  "details": "Document library with folders & favorites. Collaborative editor built on Tiptap (ProseMirror) with Y.XmlFragment via @tiptap/extension-collaboration and live remote cursors via @tiptap/extension-collaboration-caret — buttery typing, no innerHTML rebuilds, no contenteditable quirks. Invite-only documents with viewer/editor roles: owner shares via an in-app dialog that resolves an email to a DeepSpace user. RBAC is enforced by the documents schema and the starter template's built-in Yjs route. Includes a one-shot migration shim that converts documents created with the legacy contenteditable editor (HTML stored in Y.Text('content')) into Tiptap on first open.",
   "files": [
     {
-      "src": "src/DocsListPage.tsx",
-      "dest": "src/pages/docs/index.tsx"
+      "src": "src/DocumentsListPage.tsx",
+      "dest": "src/pages/documents/index.tsx"
     },
     {
-      "src": "src/DocsEditorPage.tsx",
-      "dest": "src/pages/docs/[docId].tsx"
+      "src": "src/DocumentsEditorPage.tsx",
+      "dest": "src/pages/documents/[docId].tsx"
     },
     {
-      "src": "src/use-docs-presence-access.ts",
-      "dest": "src/pages/docs/use-docs-presence-access.ts"
+      "src": "src/use-documents-presence-access.ts",
+      "dest": "src/pages/documents/use-documents-presence-access.ts"
     },
     {
       "src": "src/InviteDialog.tsx",
-      "dest": "src/pages/docs/InviteDialog.tsx"
+      "dest": "src/pages/documents/InviteDialog.tsx"
     },
     {
-      "src": "src/docs-ui.css",
-      "dest": "src/pages/docs/docs-ui.css"
+      "src": "src/documents-ui.css",
+      "dest": "src/pages/documents/documents-ui.css"
     },
     {
-      "src": "src/docs-schema.ts",
-      "dest": "src/schemas/docs-schema.ts"
+      "src": "src/documents-schema.ts",
+      "dest": "src/schemas/documents-schema.ts"
     },
     {
-      "src": "src/docs-library-types.ts",
-      "dest": "src/pages/docs/docs-library-types.ts"
+      "src": "src/documents-library-types.ts",
+      "dest": "src/pages/documents/documents-library-types.ts"
     },
     {
       "src": "src/LibrarySidebar.tsx",
-      "dest": "src/pages/docs/LibrarySidebar.tsx"
+      "dest": "src/pages/documents/LibrarySidebar.tsx"
     },
     {
-      "src": "src/DocsPresence.tsx",
-      "dest": "src/pages/docs/DocsPresence.tsx"
+      "src": "src/DocumentsPresence.tsx",
+      "dest": "src/pages/documents/DocumentsPresence.tsx"
     },
     {
-      "src": "src/DocsOutlinePanel.tsx",
-      "dest": "src/pages/docs/DocsOutlinePanel.tsx"
+      "src": "src/DocumentsOutlinePanel.tsx",
+      "dest": "src/pages/documents/DocumentsOutlinePanel.tsx"
     },
     {
       "src": "src/editor/useDocEditor.ts",
-      "dest": "src/pages/docs/editor/useDocEditor.ts"
+      "dest": "src/pages/documents/editor/useDocEditor.ts"
     },
     {
       "src": "src/editor/DocEditorSurface.tsx",
-      "dest": "src/pages/docs/editor/DocEditorSurface.tsx"
+      "dest": "src/pages/documents/editor/DocEditorSurface.tsx"
     },
     {
-      "src": "src/editor/DocsTiptapToolbar.tsx",
-      "dest": "src/pages/docs/editor/DocsTiptapToolbar.tsx"
+      "src": "src/editor/DocumentsTiptapToolbar.tsx",
+      "dest": "src/pages/documents/editor/DocumentsTiptapToolbar.tsx"
     }
   ],
   "schema": {
-    "exportName": "docsCollections",
-    "importPath": "./schemas/docs-schema",
+    "exportName": "documentsCollections",
+    "importPath": "./schemas/documents-schema",
     "spreadOperator": true
   },
   "route": {
-    "path": "/docs",
+    "path": "/documents",
     "protected": true
   },
   "requires": [],