docs(copilot): mark the inert @docs plumbing as the seam for a search_docs revival

The 'docs' ChatContext kind stays in the wire schema and the panel union but
resolves to nothing server-side. Comments at all three layers now say why it
is kept: a future @docs mention should be rebuilt on search_docs, not by
reintroducing the kind or reviving the retired whole-message pre-search.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: j15z

apps/sim/lib/copilot/chat/post.ts

@@ -143,6 +143,8 @@ const ChatContextSchema = z.object({
     'logs',
     'workflow_block',
     'knowledge',
+    // Inert today: processContextsServer drops docs contexts. Kept in the
+    // schema so a future @Docs mention can resolve through search_docs.
     'docs',
     'table',
     'file',

apps/sim/lib/copilot/chat/process-contents.ts

@@ -219,9 +219,11 @@ export async function processContextsServer(
           path: result.path,
         }
       }
-      // `docs` contexts are intentionally inert: @docs tagging is disabled while
-      // the docs corpus moves to the `docs/` VFS tree. A tagged context resolves
-      // to nothing and is filtered out below.
+      // `docs` contexts are intentionally inert: @docs tagging is disabled now
+      // that the docs corpus lives in the `docs/` VFS tree. If @Docs returns,
+      // resolve it here through searchDocs (the search_docs backend) rather
+      // than reviving the retired whole-message pre-search. A tagged context
+      // resolves to nothing and is filtered out below.
       return null
     } catch (error) {
       logger.error('Failed processing context (server)', { ctx, error })

apps/sim/stores/panel/types.ts

@@ -28,6 +28,11 @@ export type ChatContext =
   | { kind: 'folder'; folderId: string; label: string }
   | { kind: 'filefolder'; fileFolderId: string; label: string }
   | { kind: 'scheduledtask'; scheduleId: string; label: string }
+  /**
+   * Inert today: the server drops it in processContextsServer. Kept so a
+   * future @Docs mention can be revived on the search_docs backend instead of
+   * reintroducing the kind across the wire schema and this union.
+   */
   | { kind: 'docs'; label: string }
   /**
    * A tab in the desktop browser or terminal panel, dragged into the input to