Merge remote-tracking branch 'origin/master' into worktree-fetest

scripts/client-bundle-purity.spec.ts

@@ -1,16 +1,19 @@
 /**
- * Pins the client-bundle purity gate (tsdown preset resolveId classifier),
- * the build-time mirror of the module-edge rules: platform module-table
- * entries stay external, inline-safe wire layers inline, and every other
- * @deepseek-ai value import — including a bare plugin-package name and a
- * cross-plugin /client subpath — must fail the build loudly (cross-plugin
- * collaboration goes through cordis services, never module imports).
+ * Pins shared client-bundle preset contracts: the module-edge purity gate and
+ * the physical watch dependencies hidden behind virtual CSS Modules.
  */
-import { describe, expect, it } from 'vitest'
+import { fileURLToPath } from 'node:url'
+import { describe, expect, it, vi } from 'vitest'
 import { CLIENT_EXTERNALS, clientBundle } from '../packages/client/tsdown.client.ts'
 
 type ResolveId = (source: string) => null | { id: string; external: boolean }
 
+interface CssModulePlugin {
+  name: string
+  resolveId?: (source: string, importer: string | undefined) => null | string
+  load?: (this: { addWatchFile: (id: string) => void }, id: string) => Promise<unknown>
+}
+
 function purityResolveId(): ResolveId {
   // libEntry is spelled at every call site (no default) so the
   // package-invariants text check can see the invariant entry per package.
@@ -21,6 +24,16 @@ function purityResolveId(): ResolveId {
   return gate.resolveId as ResolveId
 }
 
+function cssModulePlugin(): CssModulePlugin {
+  const configs = clientBundle('@deepseek-ai/dsh-client-test', ['lib/types/index.js', 'lib/types/invariant.js'])
+  const plugins = (configs[1] as { plugins: CssModulePlugin[] }).plugins
+  const plugin = plugins.find(candidate => candidate.name === 'dsh-css-modules-inline')
+  if (plugin?.resolveId === undefined || plugin.load === undefined) {
+    throw new Error('CSS Modules plugin missing from client config')
+  }
+  return plugin
+}
+
 describe('client bundle purity gate', () => {
   const resolveId = purityResolveId()
 
@@ -60,3 +73,24 @@ describe('client bundle purity gate', () => {
     expect(dshClientChannels).toEqual(['@deepseek-ai/dsh-client-runtime/client'])
   })
 })
+
+describe('client bundle CSS Modules watch graph', () => {
+  it('registers the physical stylesheet read behind a virtual module', async () => {
+    const plugin = cssModulePlugin()
+    const importer = fileURLToPath(new URL(
+      '../packages/client/ui-conversation/src/client/queue/QueueDock.tsx',
+      import.meta.url,
+    ))
+    const stylesheet = fileURLToPath(new URL(
+      '../packages/client/ui-conversation/src/client/queue/QueueDock.module.css',
+      import.meta.url,
+    ))
+    const virtualId = plugin.resolveId?.('./QueueDock.module.css', importer)
+    if (virtualId === null || virtualId === undefined) throw new Error('CSS Modules import was not resolved')
+    const addWatchFile = vi.fn()
+
+    await plugin.load?.call({ addWatchFile }, virtualId)
+
+    expect(addWatchFile).toHaveBeenCalledExactlyOnceWith(stylesheet)
+  })
+})

scripts/gen-cordis-catalog.ts

@@ -28,6 +28,7 @@ export const LINK_MAP: Readonly<Record<string, string>> = {
   ContinuationDecision: 'core.md',
   ContinuationStop: 'core.md',
   GenerateOptions: 'core.md',
+  InboxItem: 'core.md',
   InboxPlacement: 'core.md',
   MessageId: 'core.md',
   HookContext: 'core.md',

scripts/type-equiv.manifest.json

@@ -96,6 +96,21 @@
       "symbol": "InboxPlacement",
       "source": "packages/core/agent/src/types.ts"
     },
+    {
+      "doc": "docs/core-data-structures/core.md",
+      "symbol": "InboxItem",
+      "source": "packages/core/agent/src/types.ts"
+    },
+    {
+      "doc": "docs/core-data-structures/core.md",
+      "symbol": "InboxAction",
+      "source": "packages/core/agent/src/types.ts"
+    },
+    {
+      "doc": "docs/core-data-structures/core.md",
+      "symbol": "InboxActionResult",
+      "source": "packages/core/agent/src/types.ts"
+    },
     {
       "doc": "docs/core-data-structures/core.md",
       "symbol": "SendOptions",