deepspace 0.17.0 → 0.19.0

package/features/documentation/feature.json

@@ -59,7 +59,8 @@
     "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."
+    "MDX may import app components directly. documentation.tsx is the single optional shell customization point.",
+    "Agent discovery is available at /docs/llms.txt, /docs/llms-full.txt, /docs/skill.md, /docs/.well-known/mcp, and /docs/mcp."
   ],
   "agentNotes": [
     "Treat documentation.json, documentation/**/*.md, documentation/**/*.mdx, and optional documentation.tsx as one app-owned documentation feature.",

package/features/documents/feature.json

@@ -3,7 +3,7 @@
   "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 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.",
+  "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.",
   "files": [
     {
       "src": "src/DocumentsListPage.tsx",

package/features/documents/src/DocumentsEditorPage.tsx

@@ -6,11 +6,6 @@
  * applied as granular PM transactions (no `innerHTML` swap), the local
  * caret is migrated through concurrent edits by PM's position mapping,
  * and remote cursors are painted by `@tiptap/extension-collaboration-caret`.
- *
- * Legacy documents created with the old editor stored HTML in Y.Text('content').
- * On first open by an editor/owner we migrate that into the new XmlFragment
- * via `editor.commands.setContent(html)` and clear the legacy field. The
- * migration is a single Yjs transaction so all peers converge.
  */
 
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react'
@@ -286,20 +281,12 @@ export default function DocumentsEditorPage() {
 
   const { put } = useMutations<DocumentsDocumentFields>('documents')
 
-  /**
-   * `'content'` is kept as the field name only so legacy-doc migration can
-   * read the old HTML out of Y.Text('content') below. The Tiptap editor
-   * itself binds to a separate Y.XmlFragment('default') inside the same
-   * Y.Doc — they don't collide.
-   */
-  const {
-    doc,
-    text: legacyText,
-    synced,
-    canWrite,
-    writeAuthResolved,
-    awareness,
-  } = useYjsRoom(docId ?? 'noop', 'content')
+  // The text helper remains available to consumers of useYjsRoom; this editor
+  // binds Tiptap directly to Y.XmlFragment('default') on the returned document.
+  const { doc, synced, connected, canWrite, writeAuthResolved, awareness } = useYjsRoom(
+    docId ?? 'noop',
+    'content',
+  )
 
   const presenceAccess = useDocumentsPresenceAccess({
     docId,
@@ -388,37 +375,6 @@ export default function DocumentsEditorPage() {
     placeholder: showReadOnlyDocUx ? 'View only' : 'Start typing — toolbar above for formatting…',
   })
 
-  // Legacy migration: if doc.getXmlFragment('default') is empty but the
-  // legacy Y.Text('content') field has HTML, parse it once into Tiptap.
-  // Only the first writer to open does this; viewers never see partial state
-  // because both the wipe and the parse run inside a single Yjs transaction.
-  const migratedRef = useRef(false)
-  useEffect(() => {
-    if (migratedRef.current) return
-    if (!editor || !synced || !effectiveCanWrite) return
-    const fragment = doc.getXmlFragment('default')
-    if (fragment.length > 0) {
-      migratedRef.current = true
-      return
-    }
-    const yText = doc.getText('content')
-    const legacy = (legacyText ?? yText.toString()).trim()
-    if (!legacy) {
-      migratedRef.current = true
-      return
-    }
-    migratedRef.current = true
-    /**
-     * Tiptap parses the HTML against its schema, then writes the resulting
-     * nodes into the bound Y.XmlFragment. We then clear the legacy field
-     * inside the same transaction so peers see one atomic step.
-     */
-    doc.transact(() => {
-      editor.commands.setContent(legacy, { emitUpdate: true })
-      if (yText.length > 0) yText.delete(0, yText.length)
-    })
-  }, [editor, synced, effectiveCanWrite, doc, legacyText])
-
   const { participants: presenceParticipants, typingNames } = useDocumentsEditorPresence({
     editor,
     document: selectedDoc,
@@ -522,7 +478,7 @@ export default function DocumentsEditorPage() {
               {effectiveRole === 'editor' ? 'Shared editor' : 'Shared viewer'}
             </span>
           ) : null}
-          {synced ? (
+          {connected && synced ? (
             <span
               className="flex items-center gap-1.5 text-xs tabular-nums"
               style={{ color: 'var(--documents-el-muted)' }}
@@ -530,7 +486,7 @@ export default function DocumentsEditorPage() {
               <span className="h-1.5 w-1.5 rounded-full bg-emerald-500" aria-hidden />
               Synced
             </span>
-          ) : (
+          ) : connected ? (
             <span
               className="flex items-center gap-1.5 text-xs tabular-nums"
               style={{ color: 'var(--documents-el-muted)' }}
@@ -538,6 +494,14 @@ export default function DocumentsEditorPage() {
               <span className="h-1.5 w-1.5 animate-pulse rounded-full bg-amber-500" aria-hidden />
               Connecting…
             </span>
+          ) : (
+            <span
+              className="flex items-center gap-1.5 text-xs tabular-nums"
+              style={{ color: 'var(--documents-el-muted)' }}
+            >
+              <span className="h-1.5 w-1.5 rounded-full bg-slate-400" aria-hidden />
+              Offline
+            </span>
           )}
           {effectiveRole === 'owner' ? (
             <Badge variant="success">Owner</Badge>

package/features/documents/src/LibrarySidebar.tsx

@@ -216,16 +216,14 @@ export function LibrarySidebar({
   const onCommitFolderRenameRef = useRef(onCommitRenameFolder)
   onCommitFolderRenameRef.current = onCommitRenameFolder
 
-  useEffect(() => {
-    return () => {
-      // Intentionally read the ref's LATEST value at unmount to clear whatever
-      // blur timer is pending; capturing it at effect-setup time (null) would be
-      // wrong here since this is a timer ref, not a DOM node.
-      // eslint-disable-next-line react-hooks/exhaustive-deps -- must clear the latest pending timer at unmount, not the setup-time value
-      if (folderRenameBlurTimerRef.current) clearTimeout(folderRenameBlurTimerRef.current)
-    }
+  const clearPendingFolderRename = useCallback(() => {
+    if (folderRenameBlurTimerRef.current) clearTimeout(folderRenameBlurTimerRef.current)
   }, [])
 
+  useEffect(() => {
+    return clearPendingFolderRename
+  }, [clearPendingFolderRename])
+
   const submitNewFolder = useCallback(async () => {
     const name = newFolderName.trim()
     if (!name) {

package/features/documents/src/editor/useDocEditor.ts

@@ -14,7 +14,7 @@
  */
 
 import { useEffect, useMemo, useRef } from 'react'
-import { useEditor, type Editor } from '@tiptap/react'
+import { useEditor, type AnyExtension, type Editor } from '@tiptap/react'
 import StarterKit from '@tiptap/starter-kit'
 import Collaboration from '@tiptap/extension-collaboration'
 import { CollaborationCaret } from '@tiptap/extension-collaboration-caret'
@@ -120,14 +120,14 @@ export function useDocEditor({
   canWrite,
   placeholder = 'Start typing — toolbar above for formatting…',
 }: UseDocEditorOptions): Editor | null {
-  /** Structured CRDT field that ProseMirror binds to — distinct from the legacy Y.Text('content'). */
+  /** Structured CRDT field that ProseMirror binds to. */
   const fragment = useMemo(() => doc.getXmlFragment('default'), [doc])
 
   /** CollaborationCaret expects a provider-shaped `{ awareness }` object. */
   const provider = useMemo(() => (awareness ? { awareness } : null), [awareness])
 
   const extensions = useMemo(() => {
-    const exts: unknown[] = [
+    const exts: AnyExtension[] = [
       StarterKit.configure({
         // Yjs has its own undo/redo history via the Collaboration extension; keeping
         // both enabled corrupts the shared document on undo.
@@ -175,12 +175,7 @@ export function useDocEditor({
       // in dev (the editor view is destroyed and re-created, and any subscriber
       // that runs in between throws on `editor.view`). Defer to a useEffect.
       immediatelyRender: false,
-      // Bare directive on purpose: naming @typescript-eslint/no-explicit-any
-      // here is a hard "unknown rule" error under the scaffolded app's
-      // minimal eslint config (which never registers that plugin), while the
-      // SDK monorepo's config does enable the rule and needs the suppression.
-      // eslint-disable-next-line
-      extensions: extensions as any,
+      extensions,
       editorProps: {
         transformPastedHTML: stripCollaborationArtifactsFromHTML,
         attributes: {

package/features/documents/src/use-documents-presence-access.ts

@@ -96,13 +96,11 @@ function peerToDocumentsParticipant(peer: PresencePeerClient): DocumentsPresence
   const participant: DocumentsPresenceParticipant = {
     clientId: 0,
     userId: peer.userId,
-    name: peer.userName?.trim() || peer.userEmail?.trim() || 'Guest',
+    name: peer.userName?.trim() || 'Guest',
     mode,
     typing: state.typing === true,
     isSelf: false,
   }
-  if (peer.userEmail) participant.email = peer.userEmail
-  if (peer.userImageUrl) participant.imageUrl = peer.userImageUrl
   if (lastTypedAt != null) participant.lastTypedAt = lastTypedAt
   return participant
 }

package/features/landing/feature.json

@@ -59,7 +59,7 @@
     "framer-motion": "^12.38.0"
   },
   "instructions": [
-    "Configure APP_NAME, HERO_HEADLINE, HERO_SUBHEADLINE, FAQ_ITEMS etc. in LandingPage.tsx"
+    "Configure APP_NAME, HERO_HEADLINE, HERO_SUBHEADLINE, FAQ_ITEMS, etc. in src/pages/(app)/landing.tsx"
   ],
   "patterns": []
 }

package/features/messaging/src/components/chat/MessageItem.tsx

@@ -14,7 +14,14 @@ import type { GroupedReaction } from 'deepspace'
 import { UserProfilePopover } from './UserProfilePopover'
 import { useLongPress } from '../hooks/useLongPress'
 
-const QUICK_EMOJIS = ['\u{1F44D}', '\u2764\uFE0F', '\u{1F602}', '\u{1F389}', '\u{1F525}', '\u{1F440}']
+const QUICK_EMOJIS = [
+  '\u{1F44D}',
+  '\u2764\uFE0F',
+  '\u{1F602}',
+  '\u{1F389}',
+  '\u{1F525}',
+  '\u{1F440}',
+]
 
 export interface MessageRect {
   top: number
@@ -61,6 +68,8 @@ export function MessageItem({
   const [editContent, setEditContent] = useState(message.data.content)
   const editContainerRef = useRef<HTMLDivElement>(null)
   const contentRef = useRef<HTMLDivElement>(null)
+  const latestMessageContentRef = useRef(message.data.content)
+  latestMessageContentRef.current = message.data.content
 
   const authorId = message.data.authorId || message.createdBy
   const author = getUser(authorId)
@@ -78,27 +87,25 @@ export function MessageItem({
         height: rect.height,
       })
     },
-    { delay: 500, threshold: 10 }
+    { delay: 500, threshold: 10 },
   )
 
   useEffect(() => {
-    if (forceEdit && !isEditing) {
-      setIsEditing(true)
-      setEditContent(message.data.content)
-    }
-    // Deps intentionally limited to [forceEdit]: this reacts only to the
-    // forceEdit trigger. Including isEditing/message.data.content would re-fire
-    // on every keystroke and clobber the in-progress edit buffer.
-    // eslint-disable-next-line react-hooks/exhaustive-deps -- one-shot on forceEdit; adding isEditing/message.data.content would re-fire on keystrokes and clobber the edit buffer
-  }, [forceEdit])
+    if (!forceEdit || isEditing) return
+    setEditContent(latestMessageContentRef.current)
+    setIsEditing(true)
+  }, [forceEdit, isEditing])
 
   const timestamp = new Date(message.createdAt)
   const timeStr = timestamp.toLocaleTimeString([], { hour: 'numeric', minute: '2-digit' })
-  const dateTimeStr = timestamp.toLocaleDateString(undefined, {
-    month: '2-digit',
-    day: '2-digit',
-    year: '2-digit',
-  }) + ', ' + timeStr
+  const dateTimeStr =
+    timestamp.toLocaleDateString(undefined, {
+      month: '2-digit',
+      day: '2-digit',
+      year: '2-digit',
+    }) +
+    ', ' +
+    timeStr
 
   const exitEdit = useCallback(() => {
     setIsEditing(false)
@@ -173,10 +180,7 @@ export function MessageItem({
         }`}
       >
         <div className="shrink-0 w-10" />
-        <p
-          data-testid="deleted-tombstone"
-          className="text-sm italic text-muted-foreground/70"
-        >
+        <p data-testid="deleted-tombstone" className="text-sm italic text-muted-foreground/70">
           This message was deleted.
         </p>
       </div>
@@ -205,10 +209,7 @@ export function MessageItem({
       </div>
 
       {/* Content column */}
-      <div
-        ref={contentRef}
-        className={`flex-1 min-w-0 ${isHighlighted ? 'invisible' : ''}`}
-      >
+      <div ref={contentRef} className={`flex-1 min-w-0 ${isHighlighted ? 'invisible' : ''}`}>
         {isFirstInGroup && (
           <div className="flex items-baseline gap-2 mb-0.5">
             <UserProfilePopover userId={authorId} onStartDM={onStartDM}>
@@ -239,7 +240,13 @@ export function MessageItem({
                   className="p-1.5 rounded-md bg-primary/10 text-primary hover:bg-primary/20 transition-colors"
                   title="Save"
                 >
-                  <svg className="w-4 h-4" fill="none" viewBox="0 0 24 24" stroke="currentColor" strokeWidth={2}>
+                  <svg
+                    className="w-4 h-4"
+                    fill="none"
+                    viewBox="0 0 24 24"
+                    stroke="currentColor"
+                    strokeWidth={2}
+                  >
                     <path strokeLinecap="round" strokeLinejoin="round" d="M5 13l4 4L19 7" />
                   </svg>
                 </button>
@@ -249,7 +256,13 @@ export function MessageItem({
                   className="p-1.5 rounded-md bg-muted text-muted-foreground hover:bg-destructive/10 hover:text-destructive transition-colors"
                   title="Cancel"
                 >
-                  <svg className="w-4 h-4" fill="none" viewBox="0 0 24 24" stroke="currentColor" strokeWidth={2}>
+                  <svg
+                    className="w-4 h-4"
+                    fill="none"
+                    viewBox="0 0 24 24"
+                    stroke="currentColor"
+                    strokeWidth={2}
+                  >
                     <path strokeLinecap="round" strokeLinejoin="round" d="M6 18L18 6M6 6l12 12" />
                   </svg>
                 </button>
@@ -257,7 +270,10 @@ export function MessageItem({
             </div>
           </div>
         ) : (
-          <p className="text-sm text-foreground/90 whitespace-pre-wrap break-words leading-relaxed" data-testid="message-content">
+          <p
+            className="text-sm text-foreground/90 whitespace-pre-wrap break-words leading-relaxed"
+            data-testid="message-content"
+          >
             {message.data.content}
             {message.data.edited ? (
               <span className="text-[10px] ml-1.5 text-muted-foreground italic">(edited)</span>
@@ -300,7 +316,10 @@ export function MessageItem({
 
       {/* Desktop hover toolbar */}
       {!isEditing && (
-        <div data-testid={`hover-toolbar-${message.recordId}`} className="absolute -top-3 right-5 flex items-center gap-0.5 bg-card border border-border/60 rounded-lg shadow-sm p-0.5 transition-all duration-100 opacity-0 pointer-events-none group-hover:opacity-100 group-hover:pointer-events-auto">
+        <div
+          data-testid={`hover-toolbar-${message.recordId}`}
+          className="absolute -top-3 right-5 flex items-center gap-0.5 bg-card border border-border/60 rounded-lg shadow-sm p-0.5 transition-all duration-100 opacity-0 pointer-events-none group-hover:opacity-100 group-hover:pointer-events-auto"
+        >
           {QUICK_EMOJIS.map((emoji) => (
             <button
               key={emoji}
@@ -318,8 +337,18 @@ export function MessageItem({
             className="p-1.5 rounded-md hover:bg-muted text-muted-foreground hover:text-foreground transition-colors"
             title="Reply in thread"
           >
-            <svg className="w-3.5 h-3.5" fill="none" viewBox="0 0 24 24" stroke="currentColor" strokeWidth={1.5}>
-              <path strokeLinecap="round" strokeLinejoin="round" d="M3 10h10a8 8 0 018 8v2M3 10l6 6m-6-6l6-6" />
+            <svg
+              className="w-3.5 h-3.5"
+              fill="none"
+              viewBox="0 0 24 24"
+              stroke="currentColor"
+              strokeWidth={1.5}
+            >
+              <path
+                strokeLinecap="round"
+                strokeLinejoin="round"
+                d="M3 10h10a8 8 0 018 8v2M3 10l6 6m-6-6l6-6"
+              />
             </svg>
           </button>
           {isOwn && (
@@ -333,8 +362,18 @@ export function MessageItem({
                 className="p-1.5 rounded-md hover:bg-muted text-muted-foreground hover:text-foreground transition-colors"
                 title="Edit message"
               >
-                <svg className="w-3.5 h-3.5" fill="none" viewBox="0 0 24 24" stroke="currentColor" strokeWidth={1.5}>
-                  <path strokeLinecap="round" strokeLinejoin="round" d="M11 5H6a2 2 0 00-2 2v11a2 2 0 002 2h11a2 2 0 002-2v-5m-1.414-9.414a2 2 0 112.828 2.828L11.828 15H9v-2.828l8.586-8.586z" />
+                <svg
+                  className="w-3.5 h-3.5"
+                  fill="none"
+                  viewBox="0 0 24 24"
+                  stroke="currentColor"
+                  strokeWidth={1.5}
+                >
+                  <path
+                    strokeLinecap="round"
+                    strokeLinejoin="round"
+                    d="M11 5H6a2 2 0 00-2 2v11a2 2 0 002 2h11a2 2 0 002-2v-5m-1.414-9.414a2 2 0 112.828 2.828L11.828 15H9v-2.828l8.586-8.586z"
+                  />
                 </svg>
               </button>
               <button
@@ -343,8 +382,18 @@ export function MessageItem({
                 className="p-1.5 rounded-md hover:bg-destructive/10 text-muted-foreground hover:text-destructive transition-colors"
                 title="Delete message"
               >
-                <svg className="w-3.5 h-3.5" fill="none" viewBox="0 0 24 24" stroke="currentColor" strokeWidth={1.5}>
-                  <path strokeLinecap="round" strokeLinejoin="round" d="M19 7l-.867 12.142A2 2 0 0116.138 21H7.862a2 2 0 01-1.995-1.858L5 7m5 4v6m4-6v6m1-10V4a1 1 0 00-1-1h-4a1 1 0 00-1 1v3M4 7h16" />
+                <svg
+                  className="w-3.5 h-3.5"
+                  fill="none"
+                  viewBox="0 0 24 24"
+                  stroke="currentColor"
+                  strokeWidth={1.5}
+                >
+                  <path
+                    strokeLinecap="round"
+                    strokeLinejoin="round"
+                    d="M19 7l-.867 12.142A2 2 0 0116.138 21H7.862a2 2 0 01-1.995-1.858L5 7m5 4v6m4-6v6m1-10V4a1 1 0 00-1-1h-4a1 1 0 00-1 1v3M4 7h16"
+                  />
                 </svg>
               </button>
             </>

package/features/messaging/src/hooks/useChatChannel.ts

@@ -36,9 +36,7 @@ export function useChatChannel(channelName: string = DEFAULT_CHANNEL_NAME) {
   const defaultChannel = channels
     .filter(
       (c: RecordData<Channel>) =>
-        c.data.name === channelName &&
-        c.data.type === 'public' &&
-        !c.data.archived,
+        c.data.name === channelName && c.data.type === 'public' && !c.data.archived,
     )
     .sort(
       (a: RecordData<Channel>, b: RecordData<Channel>) =>
@@ -59,11 +57,7 @@ export function useChatChannel(channelName: string = DEFAULT_CHANNEL_NAME) {
         description: 'Default chat channel',
       })
     }
-    // Deps intentionally limited to [user, status]: this is a one-shot init
-    // guarded by hasInitialized. Including defaultChannel/create/channelName
-    // would re-run and defeat the create-once semantics.
-    // eslint-disable-next-line react-hooks/exhaustive-deps -- one-shot init guarded by hasInitialized; adding defaultChannel/create/channelName would defeat create-once
-  }, [user, status])
+  }, [user, status, defaultChannel, create, channelName])
 
   // Wait for the members query to be ready before auto-joining.
   useEffect(() => {

package/features/tasks/src/TasksPage.tsx

@@ -460,7 +460,10 @@ export default function TasksPage({ className }: TasksPageProps) {
   const handleUnclaim = async (challenge: { recordId: string; data: Challenge }) => {
     await put(challenge.recordId, {
       ...challenge.data,
-      claimedById: undefined,
+      // Empty strings are normalized to SQL NULL by the record writer. The
+      // read model omits null database fields, so this also keeps Challenge's
+      // optional-string shape honest.
+      claimedById: '',
     })
   }
 
@@ -469,8 +472,8 @@ export default function TasksPage({ className }: TasksPageProps) {
     await put(submitChallenge.recordId, {
       ...submitChallenge.data,
       submitted: true,
-      submissionUrl: url || undefined,
-      submissionNotes: notes || undefined,
+      submissionUrl: url,
+      submissionNotes: notes,
     })
     setSubmitChallenge(null)
   }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "deepspace",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "engines": {
-    "node": ">=22.15.0"
+    "node": ">=22.15.0 <23 || >=24 <25 || >=26 <27"
   },
   "description": "DeepSpace SDK — build real-time collaborative apps on Cloudflare Workers",
   "type": "module",