create-windy 0.6.12 → 0.6.15

package/template/apps/server/src/module-host/{debug-session-provider-registration.test.ts → agent-session-provider-registration.test.ts}

@@ -1,30 +1,32 @@
 import { describe, expect, test } from "bun:test";
 import type { ModuleManifest } from "@southwind-ai/modules";
 import {
+  MODULE_AGENT_SESSION_SCHEMA_VERSION,
   MODULE_DEBUG_SESSION_SCHEMA_VERSION,
+  type ModuleAgentSessionProviderV1,
   type ModuleDebugSessionProviderV1,
 } from "@southwind-ai/server-sdk";
 import { featureKey } from "@southwind-ai/shared";
 import { initializeModuleHosts } from "./initialize.js";
 import { manifest } from "./test-fixtures.js";
 
-describe("ADK 调试会话 Provider 注册", () => {
+describe("Agent 会话 Provider 注册", () => {
   test("只接受同模块 Agent Operation 的 Feature 与权限绑定", async () => {
-    const module = debugManifest();
-    const provider = debugProvider();
+    const module = agentManifest();
+    const provider = agentProvider();
     const hosts = await initializeModuleHosts({
       modules: [module],
       installations: [
         {
           manifest: module,
           setup(host) {
-            host.registerDebugSessionProviders([provider]);
+            host.registerAgentSessionProviders([provider]);
           },
         },
       ],
     });
 
-    expect(hosts.debugSessionProviders).toEqual([
+    expect(hosts.agentSessionProviders).toEqual([
       { moduleName: "known", provider },
     ]);
 
@@ -45,25 +47,25 @@ describe("ADK 调试会话 Provider 注册", () => {
   test("协议版本、Manifest 审计动作、命名空间与重复 Key fail closed", async () => {
     await expect(
       initializeWith({
-        ...debugProvider(),
+        ...agentProvider(),
         key: "other.history",
       }),
     ).rejects.toThrow("不属于模块 known");
     await expect(
       initializeWith({
-        ...debugProvider(),
+        ...agentProvider(),
         auditAction: "known.missing",
       }),
     ).rejects.toThrow("审计动作未在 Manifest 声明");
     await expect(
       initializeWith({
-        ...debugProvider(),
+        ...agentProvider(),
         schemaVersion: 2 as 1,
       }),
     ).rejects.toThrow("协议版本不受支持");
 
-    const module = debugManifest();
-    const provider = debugProvider();
+    const module = agentManifest();
+    const provider = agentProvider();
     await expect(
       initializeModuleHosts({
         modules: [module],
@@ -71,33 +73,56 @@ describe("ADK 调试会话 Provider 注册", () => {
           {
             manifest: module,
             setup(host) {
-              host.registerDebugSessionProviders([provider, provider]);
+              host.registerAgentSessionProviders([provider, provider]);
             },
           },
         ],
       }),
     ).rejects.toThrow("重复注册");
   });
+
+  test("旧 Debug Session 名称只作为同一注册表的兼容 alias", async () => {
+    const module = agentManifest();
+    const provider: ModuleDebugSessionProviderV1 = {
+      ...agentProvider(),
+      schemaVersion: MODULE_DEBUG_SESSION_SCHEMA_VERSION,
+    };
+    const hosts = await initializeModuleHosts({
+      modules: [module],
+      installations: [
+        {
+          manifest: module,
+          setup(host) {
+            host.registerDebugSessionProviders([provider]);
+          },
+        },
+      ],
+    });
+
+    expect(hosts.agentSessionProviders).toEqual([
+      { moduleName: "known", provider },
+    ]);
+  });
 });
 
-async function initializeWith(provider: ModuleDebugSessionProviderV1) {
-  const module = debugManifest();
+async function initializeWith(provider: ModuleAgentSessionProviderV1) {
+  const module = agentManifest();
   return initializeModuleHosts({
     modules: [module],
     installations: [
       {
         manifest: module,
         setup(host) {
-          host.registerDebugSessionProviders([provider]);
+          host.registerAgentSessionProviders([provider]);
         },
       },
     ],
   });
 }
 
-function debugProvider(): ModuleDebugSessionProviderV1 {
+function agentProvider(): ModuleAgentSessionProviderV1 {
   return {
-    schemaVersion: MODULE_DEBUG_SESSION_SCHEMA_VERSION,
+    schemaVersion: MODULE_AGENT_SESSION_SCHEMA_VERSION,
     key: "known.copilot.history",
     operationKeys: ["known.copilot.global"],
     featureKey: "known.copilot",
@@ -108,7 +133,7 @@ function debugProvider(): ModuleDebugSessionProviderV1 {
   };
 }
 
-function debugManifest(): ModuleManifest {
+function agentManifest(): ModuleManifest {
   return manifest("known", {
     features: [
       {

package/template/apps/server/src/module-host/{debug-session-provider-registration.ts → agent-session-provider-registration.ts}

@@ -1,59 +1,59 @@
 import type { ModuleManifest } from "@southwind-ai/modules";
 import {
-  MODULE_DEBUG_SESSION_SCHEMA_VERSION,
+  MODULE_AGENT_SESSION_SCHEMA_VERSION,
   requireModuleNamespace,
-  type ModuleDebugSessionProviderV1,
+  type ModuleAgentSessionProviderV1,
 } from "@southwind-ai/server-sdk";
 
-export function validateDebugSessionProviderRegistration(
+export function validateAgentSessionProviderRegistration(
   manifest: ModuleManifest,
-  provider: ModuleDebugSessionProviderV1,
+  provider: ModuleAgentSessionProviderV1,
 ): void {
   const moduleName = manifest.name;
-  requireModuleNamespace("调试会话 Provider", provider.key, moduleName);
+  requireModuleNamespace("Agent 会话 Provider", provider.key, moduleName);
   requireModuleNamespace(
-    "调试会话 Provider Feature",
+    "Agent 会话 Provider Feature",
     provider.featureKey,
     moduleName,
   );
   requireModuleNamespace(
-    "调试会话 Provider 权限",
+    "Agent 会话 Provider 权限",
     provider.permissionKey,
     moduleName,
   );
   requireModuleNamespace(
-    "调试会话 Provider 审计动作",
+    "Agent 会话 Provider 审计动作",
     provider.auditAction,
     moduleName,
   );
-  if (provider.schemaVersion !== MODULE_DEBUG_SESSION_SCHEMA_VERSION) {
-    throw new Error(`调试会话 Provider 协议版本不受支持：${provider.key}`);
+  if (provider.schemaVersion !== MODULE_AGENT_SESSION_SCHEMA_VERSION) {
+    throw new Error(`Agent 会话 Provider 协议版本不受支持：${provider.key}`);
   }
   if (!manifest.features.some(({ key }) => key === provider.featureKey)) {
     throw new Error(
-      `调试会话 Provider Feature 未在 Manifest 声明：${provider.featureKey}`,
+      `Agent 会话 Provider Feature 未在 Manifest 声明：${provider.featureKey}`,
     );
   }
   if (!manifest.permissions.some(({ key }) => key === provider.permissionKey)) {
     throw new Error(
-      `调试会话 Provider 权限未在 Manifest 声明：${provider.permissionKey}`,
+      `Agent 会话 Provider 权限未在 Manifest 声明：${provider.permissionKey}`,
     );
   }
   if (!manifestAuditActions(manifest).has(provider.auditAction)) {
     throw new Error(
-      `调试会话 Provider 审计动作未在 Manifest 声明：${provider.auditAction}`,
+      `Agent 会话 Provider 审计动作未在 Manifest 声明：${provider.auditAction}`,
     );
   }
   if (provider.operationKeys.length === 0) {
     throw new Error(
-      `调试会话 Provider 必须绑定至少一个 Operation：${provider.key}`,
+      `Agent 会话 Provider 必须绑定至少一个 Operation：${provider.key}`,
     );
   }
   const operationKeys = new Set<string>();
   for (const operationKey of provider.operationKeys) {
-    requireModuleNamespace("调试会话 Operation", operationKey, moduleName);
+    requireModuleNamespace("Agent 会话 Operation", operationKey, moduleName);
     if (operationKeys.has(operationKey)) {
-      throw new Error(`调试会话 Provider Operation 重复：${operationKey}`);
+      throw new Error(`Agent 会话 Provider Operation 重复：${operationKey}`);
     }
     operationKeys.add(operationKey);
     const operation = manifest.aiOperations?.find(
@@ -61,7 +61,7 @@ export function validateDebugSessionProviderRegistration(
     );
     if (!operation || operation.kind !== "agent") {
       throw new Error(
-        `调试会话 Provider Operation 未声明为 Agent：${operationKey}`,
+        `Agent 会话 Provider Operation 未声明为 Agent：${operationKey}`,
       );
     }
     if (
@@ -69,7 +69,7 @@ export function validateDebugSessionProviderRegistration(
       operation.permissionKey !== provider.permissionKey
     ) {
       throw new Error(
-        `调试会话 Provider 必须复用 Operation 的 Feature 与权限：${operationKey}`,
+        `Agent 会话 Provider 必须复用 Operation 的 Feature 与权限：${operationKey}`,
       );
     }
   }

package/template/apps/server/src/module-host/agent-source-invalidation-port.ts

@@ -0,0 +1,53 @@
+import {
+  ModuleAuthoritativeSourceInvalidationUnavailableError,
+  type ModuleAuthoritativeSourceInvalidationPortV1,
+} from "@southwind-ai/server-sdk";
+import type { RequestGuardContext } from "../guards.js";
+import type { ModuleAuthoritativeSourceAccessRegistry } from "../agent/context-memory/authoritative-source-registry.js";
+import type { ModuleAuthoritativeInvalidationProducerPort } from "../agent/session-invalidation/module-authoritative-producer.js";
+import type { DrizzleSessionInvalidationOutbox } from "../agent/session-persistence/drizzle-invalidation-outbox.js";
+import { authorizationCoordinateForActor } from "../agent/session-projection-access.js";
+
+export function createModuleAuthoritativeSourceInvalidationPort(
+  moduleName: string,
+  context: RequestGuardContext,
+  signal: AbortSignal,
+  sources: ModuleAuthoritativeSourceAccessRegistry,
+  outbox: DrizzleSessionInvalidationOutbox,
+): ModuleAuthoritativeSourceInvalidationPortV1 {
+  let producer: ModuleAuthoritativeInvalidationProducerPort;
+  try {
+    producer = sources.bindTransactionalInvalidationProducer({
+      moduleKey: moduleName,
+      authorization: authorizationCoordinateForActor(context.actor),
+      appendInTransaction: (db, envelope) =>
+        outbox.appendInTransaction(db, envelope),
+    });
+  } catch {
+    return unavailablePort();
+  }
+  return {
+    sourceDeleted: (input) => invoke(() => producer.sourceDeleted(input), signal),
+    sourceExpired: (input) => invoke(() => producer.sourceExpired(input), signal),
+    sourceSuperseded: (input) =>
+      invoke(() => producer.sourceSuperseded(input), signal),
+    authorizationRevoked: (input) =>
+      invoke(() => producer.authorizationRevoked(input), signal),
+  };
+}
+
+function unavailablePort(): ModuleAuthoritativeSourceInvalidationPortV1 {
+  const unavailable = () =>
+    Promise.reject(new ModuleAuthoritativeSourceInvalidationUnavailableError());
+  return {
+    sourceDeleted: unavailable,
+    sourceExpired: unavailable,
+    sourceSuperseded: unavailable,
+    authorizationRevoked: unavailable,
+  };
+}
+
+function invoke<T>(operation: () => Promise<T>, signal: AbortSignal) {
+  if (signal.aborted) throw new Error("权威来源失效写入暂不可用");
+  return operation();
+}

package/template/apps/server/src/module-host/background-ai-unavailable.ts

@@ -0,0 +1,18 @@
+import {
+  ModuleBackgroundAiError,
+  type ModuleBackgroundAiPort,
+} from "@southwind-ai/server-sdk";
+
+export function unavailableModuleBackgroundAiPort(
+  moduleName: string,
+): ModuleBackgroundAiPort {
+  return {
+    async enqueueOperation() {
+      throw new ModuleBackgroundAiError(
+        "AI_OPERATION_UNAVAILABLE",
+        `模块 ${moduleName} 的后台 AI Operation Port 未挂载`,
+        true,
+      );
+    },
+  };
+}

package/template/apps/server/src/module-host/durable-context.ts

@@ -14,17 +14,14 @@ import type {
 // @windy-module system.storage begin
 import type { ModuleReportStagingPortV1 } from "@southwind-ai/server-sdk";
 // @windy-module system.storage end
-import { ModuleBackgroundAiError } from "@southwind-ai/server-sdk";
 // @windy-module system.storage begin
 import { ModuleReportStagingError } from "@southwind-ai/server-sdk";
 // @windy-module system.storage end
 import { evaluateAccessGuards } from "../access-guards.js";
-import {
-  captureAuthorizationScope,
-  hashAuthorizationScope,
-} from "../data-access/scope-snapshot.js";
+import * as scopeSnapshot from "../data-access/scope-snapshot.js";
 import type { RequestActor, RequestGuardContext } from "../guards.js";
 import type { createServerRuntime } from "../runtime.js";
+import { unavailableModuleBackgroundAiPort } from "./background-ai-unavailable.js";
 import type { InitializedModuleHosts } from "./initialize.js";
 import {
   createModuleStoragePort,
@@ -36,6 +33,9 @@ import { createModuleStorageWritePort } from "./storage-write-port.js";
 import { unavailableModuleStorageWritePort } from "./storage-write-unavailable.js";
 import { toModuleActor } from "./request-context.js";
 import { createModuleSecretPort } from "./module-secret-port.js";
+// @windy-module system.agent begin
+import { moduleWorkflowInputArtifactContext } from "./workflow-input-artifact-port.js";
+// @windy-module system.agent end
 // @windy-module system.storage begin
 import type { ReportStagingService } from "../report-staging/service.js";
 import { createModuleReportStagingPort } from "./report-staging-port.js";
@@ -87,8 +87,8 @@ export function createModuleDurableContextualizer(
     ) {
       throw denied("MODULE_ACTOR_UNAVAILABLE");
     }
-    const current = captureAuthorizationScope(actor.scopeContext);
-    if (current.hash !== hashAuthorizationScope(snapshot)) {
+    const current = scopeSnapshot.captureAuthorizationScope(actor.scopeContext);
+    if (current.hash !== scopeSnapshot.hashAuthorizationScope(snapshot)) {
       throw denied("MODULE_AUTHORIZATION_SCOPE_CHANGED");
     }
     const request = new Request(
@@ -216,6 +216,15 @@ export function createModuleDurableContextualizer(
       }),
       storage,
       storageWriter,
+      // @windy-module system.agent begin
+      ...moduleWorkflowInputArtifactContext(
+        input.moduleName,
+        actor.id,
+        storage,
+        services.storage?.blobStore,
+        input.context,
+      ),
+      // @windy-module system.agent end
       // @windy-module system.storage begin
       reportStaging,
       // @windy-module system.storage end
@@ -224,7 +233,7 @@ export function createModuleDurableContextualizer(
           input.moduleName,
           guardContext,
           input.context.signal,
-        ) ?? unavailableBackgroundAi(input.moduleName),
+        ) ?? unavailableModuleBackgroundAiPort(input.moduleName),
     };
     return moduleContext;
   };
@@ -249,8 +258,8 @@ async function resolveDurableReportAccess(
   const snapshot = input.claim.job.authorizationScope;
   if (
     !snapshot ||
-    captureAuthorizationScope(actor.scopeContext).hash !==
-      hashAuthorizationScope(snapshot)
+    scopeSnapshot.captureAuthorizationScope(actor.scopeContext).hash !==
+      scopeSnapshot.hashAuthorizationScope(snapshot)
   ) {
     return false;
   }
@@ -322,18 +331,6 @@ function unavailableDurableStoragePort(
   };
 }
 
-function unavailableBackgroundAi(moduleName: string): ModuleBackgroundAiPort {
-  return {
-    async enqueueOperation() {
-      throw new ModuleBackgroundAiError(
-        "AI_OPERATION_UNAVAILABLE",
-        `模块 ${moduleName} 的后台 AI Operation Port 未挂载`,
-        true,
-      );
-    },
-  };
-}
-
 function denied(code: string, details?: Record<string, unknown>) {
   return new DurableHandlerError(
     code,

package/template/apps/server/src/module-host/http-runtime.ts

@@ -16,6 +16,8 @@ import type { AiArtifactRuntime } from "../ai-artifact/runtime.js";
 import type { ModuleAiOperationPort } from "@southwind-ai/server-sdk";
 import type { ModuleAiOperationReadinessPortV1 } from "@southwind-ai/server-sdk";
 import type { ModuleAiScreenshotIntakePortV1 } from "@southwind-ai/server-sdk";
+import type { ModuleAgentSessionMemoryPortV1 } from "@southwind-ai/server-sdk";
+import type { ModuleAuthoritativeSourceInvalidationPortV1 } from "@southwind-ai/server-sdk";
 // @windy-module system.agent end
 import { installModuleRoutes } from "./route-installer.js";
 import type { InitializedModuleHosts } from "./initialize.js";
@@ -59,6 +61,16 @@ export function installModuleHttpRuntime(
       guardContext: RequestGuardContext,
       signal: AbortSignal,
     ) => ModuleAiScreenshotIntakePortV1;
+    sessionMemory?: (
+      moduleName: string,
+      guardContext: RequestGuardContext,
+      signal: AbortSignal,
+    ) => ModuleAgentSessionMemoryPortV1;
+    sourceInvalidation?: (
+      moduleName: string,
+      guardContext: RequestGuardContext,
+      signal: AbortSignal,
+    ) => ModuleAuthoritativeSourceInvalidationPortV1;
     // @windy-module system.agent end
     // @windy-module system.data-governance begin
     reauthenticate(actorId: string, password: string): Promise<boolean>;
@@ -103,6 +115,8 @@ export function installModuleHttpRuntime(
     aiOperations: context.aiOperations,
     aiReadiness: context.aiReadiness,
     screenshots: context.screenshots,
+    sessionMemory: context.sessionMemory,
+    sourceInvalidation: context.sourceInvalidation,
     // @windy-module system.agent end
   });
   // @windy-module system.data-governance begin

package/template/apps/server/src/module-host/implementation-completeness.test.ts

@@ -1,5 +1,10 @@
 import { describe, expect, test } from "bun:test";
-import type { ModuleHost } from "@southwind-ai/server-sdk";
+import {
+  // @windy-module system.agent begin
+  defineModuleWorkflowInputMaterializationHandlerV1,
+  // @windy-module system.agent end
+  type ModuleHost,
+} from "@southwind-ai/server-sdk";
 import { featureKey } from "@southwind-ai/shared";
 import { initializeModuleHosts } from "./initialize.js";
 import {
@@ -130,6 +135,80 @@ describe("Server Module 实现完整性", () => {
       });
     }
   });
+
+  // @windy-module system.agent begin
+  test("固定 materialization task 由同 capability Durable Handler 完整实现", async () => {
+    const moduleManifest = manifest("case", {
+      features: [
+        {
+          key: featureKey("case.materialize"),
+          label: "案件输入物化",
+          module: "case",
+          visible: "hidden",
+          enabled: true,
+          stage: "stable",
+        },
+      ],
+      permissions: [
+        {
+          key: "case.materialize.execute",
+          label: "物化案件输入",
+          module: "case",
+          moduleLabel: "案件",
+          resource: "materialization",
+          resourceLabel: "输入物化",
+          action: "execute",
+        },
+      ],
+      tasks: [
+        {
+          key: "case.workflow-input-materialize",
+          label: "案件输入物化",
+          description: "物化受治理 Workflow 输入。",
+          featureKey: "case.materialize",
+          permissionKey: "case.materialize.execute",
+          auditAction: "case.materialize.execute",
+          intervalSeconds: 60,
+          maxAttempts: 3,
+          retryDelaySeconds: 5,
+        },
+      ],
+      auditActions: ["case.materialize.execute"],
+    });
+    const installation = {
+      manifest: moduleManifest,
+      setup(host: ModuleHost) {
+        host.registerDurableHandler(
+          defineModuleWorkflowInputMaterializationHandlerV1({
+            moduleName: "case",
+            featureKey: "case.materialize",
+            permissionKey: "case.materialize.execute",
+            auditAction: "case.materialize.execute",
+          }),
+        );
+      },
+    };
+    const hosts = await initializeModuleHosts({
+      modules: [moduleManifest],
+      installations: [installation],
+    });
+    expect(() =>
+      validateHostedModuleImplementations([installation], hosts),
+    ).not.toThrow();
+    expect(() =>
+      validateHostedModuleImplementations([installation], {
+        ...hosts,
+        durableHandlers: hosts.durableHandlers.map((entry) => ({
+          ...entry,
+          definition: {
+            ...entry.definition,
+            auditAction: "case.materialize.drifted",
+          },
+        })),
+      }),
+    ).toThrow("定时任务 case.workflow-input-materialize 缺少 Handler");
+  });
+  // @windy-module system.agent end
 });
 
 function completeRouteModule() {

package/template/apps/server/src/module-host/implementation-completeness.ts

@@ -4,6 +4,9 @@ import type {
   InstallableServerModule,
   ModuleGovernedResourceRegistration,
 } from "@southwind-ai/server-sdk";
+// @windy-module system.agent begin
+import { moduleWorkflowInputMaterializationHandlerKey } from "@southwind-ai/server-sdk";
+// @windy-module system.agent end
 import type { InitializedModuleHosts } from "./initialize-contracts.js";
 
 /**
@@ -42,7 +45,10 @@ export function validateHostedModuleImplementations(
       installation.manifest.tasks.map(({ key }) => key),
       hosts.taskHandlers
         .filter((entry) => entry.moduleName === moduleName)
-        .map(({ registration }) => registration.taskKey),
+        .map(({ registration }) => registration.taskKey)
+        // @windy-module system.agent begin
+        .concat(materializationDurableTaskKeys(installation.manifest, hosts)),
+      // @windy-module system.agent end
     );
     assertComplete(
       "Agent Tool",
@@ -69,6 +75,27 @@ export function validateHostedModuleImplementations(
   validateDurableHandlerInstallations(hosts);
 }
 
+// @windy-module system.agent begin
+function materializationDurableTaskKeys(
+  manifest: ModuleManifest,
+  hosts: InitializedModuleHosts,
+) {
+  const key = moduleWorkflowInputMaterializationHandlerKey(manifest.name);
+  const task = manifest.tasks.find((candidate) => candidate.key === key);
+  if (!task) return [];
+  return hosts.durableHandlers
+    .filter(
+      ({ moduleName, definition }) =>
+        moduleName === manifest.name &&
+        definition.key === key &&
+        definition.featureKey === task.featureKey &&
+        definition.permissionKey === task.permissionKey &&
+        definition.auditAction === task.auditAction,
+    )
+    .map(({ definition }) => definition.key);
+}
+// @windy-module system.agent end
+
 export function governedResourceRouteKeys(
   registration: Pick<
     ModuleGovernedResourceRegistration,

package/template/apps/server/src/module-host/initialize-contracts.ts

@@ -6,7 +6,7 @@ import type {
 import type {
   InstallableServerModule,
   ModuleAiOperationHandlerRegistration,
-  ModuleDebugSessionProviderV1,
+  ModuleAgentSessionProviderV1,
   ModuleDurableHandlerDefinition,
   ModuleInitializer,
   ModuleGovernedResourceRegistration,
@@ -70,11 +70,10 @@ export interface RegisteredModuleSearchProvider {
   readonly provider: ModuleSearchProvider;
 }
 
-export interface RegisteredModuleDebugSessionProvider {
+export interface RegisteredModuleAgentSessionProvider {
   readonly moduleName: string;
-  readonly provider: ModuleDebugSessionProviderV1;
+  readonly provider: ModuleAgentSessionProviderV1;
 }
-
 export interface InitializeModuleHostsInput {
   modules: readonly ModuleManifest[];
   /** Manifest 与 setup 由同一业务模块安装单元贡献。 */
@@ -101,7 +100,7 @@ export interface InitializedModuleHosts {
   readonly governedResources: readonly RegisteredModuleGovernedResource[];
   readonly rolePresets: readonly RegisteredModuleRolePreset[];
   readonly searchProviders: readonly RegisteredModuleSearchProvider[];
-  readonly debugSessionProviders: readonly RegisteredModuleDebugSessionProvider[];
+  readonly agentSessionProviders: readonly RegisteredModuleAgentSessionProvider[];
   manifestOf(moduleName: string): ModuleManifest;
   /** 该模块经 Host 注册的上传用途集合（不含平台基础用途）。 */
   uploadPurposesOf(moduleName: string): ReadonlySet<string>;

package/template/apps/server/src/module-host/initialize.ts

@@ -19,7 +19,7 @@ export type {
   InitializedModuleHosts,
   InitializeModuleHostsInput,
   RegisteredModuleAiOperationHandler,
-  RegisteredModuleDebugSessionProvider,
+  RegisteredModuleAgentSessionProvider,
   RegisteredModuleDurableHandler,
   RegisteredModuleGovernedResource,
   RegisteredModuleRolePreset,
@@ -94,8 +94,8 @@ export async function initializeModuleHosts(
     rolePresetKeys: new Set<string>(),
     searchProviders: [],
     searchProviderKeys: new Set<string>(),
-    debugSessionProviders: [],
-    debugSessionProviderKeys: new Set<string>(),
+    agentSessionProviders: [],
+    agentSessionProviderKeys: new Set<string>(),
   };
 
   const installations = [
@@ -155,7 +155,7 @@ export async function initializeModuleHosts(
     governedResources: [...state.governedResources],
     rolePresets: [...state.rolePresets],
     searchProviders: [...state.searchProviders],
-    debugSessionProviders: [...state.debugSessionProviders],
+    agentSessionProviders: [...state.agentSessionProviders],
     manifestOf(moduleName) {
       const manifest = manifests.get(moduleName);
       if (!manifest) throw new Error(`模块未安装：${moduleName}`);

package/template/apps/server/src/module-host/request-context.test.ts

@@ -79,13 +79,13 @@ describe("模块 Actor 运行时边界", () => {
   });
 
   // @windy-module system.agent begin
-  test("开发调试委托只向业务 Module 投影真实用户，核心主体保持不变", () => {
+  test("客户端 Agent 委托只向业务 Module 投影真实用户，核心主体保持不变", () => {
     const requestActor = bindModuleUserProjection(
       {
-        id: "service_adk_debug",
+        id: "service_page_agent",
         type: "service",
-        name: "ADK 开发调试",
-        roleCodes: ["adk-debug"],
+        name: "PageAgent 客户端",
+        roleCodes: ["client-agent"],
         permissionKeys: ["analysis.copilot.execute"],
       },
       "user_dev_admin",
@@ -96,7 +96,7 @@ describe("模块 Actor 运行时边界", () => {
     expect(actor).toMatchObject({
       id: "user_dev_admin",
       type: "user",
-      name: "ADK 开发调试",
+      name: "PageAgent 客户端",
     });
     expect(requestActorFromModule(actor)).toBe(requestActor);
   });