create-windy 0.6.11 → 0.6.14

package/template/apps/server/src/agent/{debug-session-facade-provider-failure.test.ts → agent-session-facade-provider-failure.test.ts}

@@ -1,26 +1,22 @@
 import { describe, expect, test } from "bun:test";
 import type { ModuleManifest } from "@southwind-ai/modules";
 import {
-  MODULE_DEBUG_SESSION_SCHEMA_VERSION,
-  type ModuleDebugSessionProviderV1,
+  MODULE_AGENT_SESSION_SCHEMA_VERSION,
+  type ModuleAgentSessionProviderV1,
 } from "@southwind-ai/server-sdk";
 import { featureKey } from "@southwind-ai/shared";
-import {
-  bindModuleUserProjection,
-  createRequestGuardContext,
-  type RequestActor,
-} from "../guards.js";
+import { createRequestGuardContext, type RequestActor } from "../guards.js";
 import type { InitializedModuleHosts } from "../module-host.js";
 import { manifest } from "../module-host/test-fixtures.js";
 import { createServerRuntime } from "../runtime.js";
-import { DebugSessionFacadeV1 } from "./debug-session-facade.js";
-import { DebugSessionIdCodecV1 } from "./debug-session-id.js";
+import { AgentSessionFacadeV1 } from "./agent-session-facade.js";
+import { AgentSessionIdCodecV1 } from "./agent-session-id.js";
 
 const OPERATION_KEY = "known.copilot.global";
 const SOURCE_ID = "conversation-sensitive-42";
 const SECRET_FAILURE = `provider failed for ${SOURCE_ID}`;
 
-describe("ADK 调试会话 Provider 故障隔离", () => {
+describe("Agent 会话 Provider 故障隔离", () => {
   test("一个 Provider 故障时 fail closed，避免把 partial 伪装成完整列表", async () => {
     const failing = provider("known.failing-history", {
       list: async () => {
@@ -53,11 +49,10 @@ describe("ADK 调试会话 Provider 故障隔离", () => {
       action: "known.copilot.history.read",
       outcome: "failure",
       target: {
-        type: "agent-debug-session-provider",
+        type: "agent-session-provider",
         id: "known.failing-history",
       },
       metadata: {
-        debugDataActorId: "user_dev_admin",
         mode: "list",
         phase: "list",
         failureCode: "PROVIDER_UNAVAILABLE",
@@ -130,7 +125,7 @@ describe("ADK 调试会话 Provider 故障隔离", () => {
   });
 });
 
-function failingProvider(key: string): ModuleDebugSessionProviderV1 {
+function failingProvider(key: string): ModuleAgentSessionProviderV1 {
   return provider(key, {
     list: async () => {
       throw new Error(SECRET_FAILURE);
@@ -141,10 +136,10 @@ function failingProvider(key: string): ModuleDebugSessionProviderV1 {
 
 function provider(
   key: string,
-  methods: Pick<ModuleDebugSessionProviderV1, "list" | "get">,
-): ModuleDebugSessionProviderV1 {
+  methods: Pick<ModuleAgentSessionProviderV1, "list" | "get">,
+): ModuleAgentSessionProviderV1 {
   return {
-    schemaVersion: MODULE_DEBUG_SESSION_SCHEMA_VERSION,
+    schemaVersion: MODULE_AGENT_SESSION_SCHEMA_VERSION,
     key,
     operationKeys: [OPERATION_KEY],
     featureKey: "known.copilot",
@@ -154,10 +149,10 @@ function provider(
   };
 }
 
-function createFixture(providers: readonly ModuleDebugSessionProviderV1[]) {
-  const module = debugManifest();
+function createFixture(providers: readonly ModuleAgentSessionProviderV1[]) {
+  const module = agentManifest();
   const hosts = {
-    debugSessionProviders: providers.map((provider) => ({
+    agentSessionProviders: providers.map((provider) => ({
       moduleName: "known",
       provider,
     })),
@@ -173,25 +168,21 @@ function createFixture(providers: readonly ModuleDebugSessionProviderV1[]) {
       licenseResolver: { resolve: () => ({ status: "valid" }) },
     },
   );
-  const runtime = {
-    ...base,
-    agentDebugOperationForActor: (actorId: string) =>
-      actorId === "service_adk_debug" ? OPERATION_KEY : undefined,
-  };
+  const runtime = base;
   const context = createRequestGuardContext(
-    new Request("http://localhost/api/agent/debug/sessions/v1"),
+    new Request("http://localhost/api/agent/sessions/v1"),
     {
-      resolveActor: () => bindModuleUserProjection(actor(), "user_dev_admin"),
+      resolveActor: () => actor(),
       resolveLicense: () => ({ status: "valid" }),
       licenseEnforced: false,
     },
   );
   return {
     context,
-    facade: new DebugSessionFacadeV1(
+    facade: new AgentSessionFacadeV1(
       hosts,
       runtime,
-      new DebugSessionIdCodecV1("test-secret-012345678901234567890123456789"),
+      new AgentSessionIdCodecV1("test-secret-012345678901234567890123456789"),
     ),
     runtime,
   };
@@ -199,10 +190,10 @@ function createFixture(providers: readonly ModuleDebugSessionProviderV1[]) {
 
 function actor(): RequestActor {
   return {
-    id: "service_adk_debug",
-    type: "service",
-    name: "ADK Debug",
-    roleCodes: ["adk-debug"],
+    id: "user_dev_admin",
+    type: "user",
+    name: "开发管理员",
+    roleCodes: ["analyst"],
     permissionKeys: ["known.copilot.execute"],
   };
 }
@@ -221,7 +212,7 @@ function signal(): AbortSignal {
   return new AbortController().signal;
 }
 
-function debugManifest(): ModuleManifest {
+function agentManifest(): ModuleManifest {
   return manifest("known", {
     features: [
       {

package/template/apps/server/src/agent/{debug-session-facade.test.ts → agent-session-facade.test.ts}

@@ -1,29 +1,25 @@
 import { describe, expect, test } from "bun:test";
 import type { ModuleManifest } from "@southwind-ai/modules";
 import {
-  MODULE_DEBUG_SESSION_SCHEMA_VERSION,
-  type ModuleDebugSessionProviderV1,
+  MODULE_AGENT_SESSION_SCHEMA_VERSION,
+  type ModuleAgentSessionProviderV1,
 } from "@southwind-ai/server-sdk";
 import { featureKey } from "@southwind-ai/shared";
-import {
-  bindModuleUserProjection,
-  createRequestGuardContext,
-  type RequestActor,
-} from "../guards.js";
+import { createRequestGuardContext, type RequestActor } from "../guards.js";
 import { initializeModuleHosts } from "../module-host.js";
 import { manifest } from "../module-host/test-fixtures.js";
 import { createServerRuntime } from "../runtime.js";
 import {
-  DebugSessionFacadeError,
-  DebugSessionFacadeV1,
-} from "./debug-session-facade.js";
-import { DebugSessionIdCodecV1 } from "./debug-session-id.js";
+  AgentSessionFacadeError,
+  AgentSessionFacadeV1,
+} from "./agent-session-facade.js";
+import { AgentSessionIdCodecV1 } from "./agent-session-id.js";
 
 const OPERATION_KEY = "known.copilot.global";
 const SOURCE_ID = "conversation-private-42";
 
-describe("ADK 调试会话 V1 facade", () => {
-  test("投影真实业务用户并只返回不透明 ID 与有界通用 DTO", async () => {
+describe("Agent 会话 V1 facade", () => {
+  test("使用当前登录用户并只返回不透明 ID 与有界通用 DTO", async () => {
     const seenActors: string[] = [];
     const fixture = await createFixture({
       list: async ({ actor }) => {
@@ -54,7 +50,7 @@ describe("ADK 调试会话 V1 facade", () => {
 
     const listed = await fixture.facade.list(fixture.context, signal());
     const id = listed.sessions[0]?.id;
-    expect(id).toMatch(/^wdbg1_/);
+    expect(id).toMatch(/^wags1_/);
     expect(JSON.stringify(listed)).not.toContain(SOURCE_ID);
     expect(listed.sessions[0]).toMatchObject({
       title: "历史研判",
@@ -81,9 +77,9 @@ describe("ADK 调试会话 V1 facade", () => {
       .filter(({ action }) => action === "known.copilot.history.read");
     expect(audits).toHaveLength(2);
     expect(audits[0]?.metadata).toMatchObject({
-      debugDataActorId: "user_dev_admin",
       mode: "list",
     });
+    expect(audits[0]?.actor.id).toBe("user_dev_admin");
   });
 
   test("每次详情读取重新 list 授权，未知和非法 ID 同形安全失败", async () => {
@@ -154,7 +150,7 @@ describe("ADK 调试会话 V1 facade", () => {
     });
   });
 
-  test("非调试身份、缺少权限与 Provider 越界响应均 fail closed", async () => {
+  test("缺少权限与 Provider 越界响应均 fail closed", async () => {
     const fixture = await createFixture({
       list: async () => ({ sessions: [summary()], truncated: false }),
       get: async () => ({
@@ -186,12 +182,12 @@ describe("ADK 调试会话 V1 facade", () => {
     );
     await expect(
       forbidden.facade.list(forbidden.context, signal()),
-    ).rejects.toBeInstanceOf(DebugSessionFacadeError);
+    ).rejects.toBeInstanceOf(AgentSessionFacadeError);
 
-    const ordinaryContext = createContext(
-      { ...actor(), id: "user_ordinary", type: "user" },
-      false,
-    );
+    const ordinaryContext = createContext({
+      ...actor([]),
+      id: "user_ordinary",
+    });
     await expect(
       fixture.facade.list(ordinaryContext, signal()),
     ).rejects.toMatchObject({ code: "FORBIDDEN", status: 403 });
@@ -199,12 +195,12 @@ describe("ADK 调试会话 V1 facade", () => {
 });
 
 async function createFixture(
-  methods: Pick<ModuleDebugSessionProviderV1, "list" | "get">,
+  methods: Pick<ModuleAgentSessionProviderV1, "list" | "get">,
   permissionKeys = ["known.copilot.execute"],
 ) {
-  const module = debugManifest();
-  const provider: ModuleDebugSessionProviderV1 = {
-    schemaVersion: MODULE_DEBUG_SESSION_SCHEMA_VERSION,
+  const module = agentManifest();
+  const provider: ModuleAgentSessionProviderV1 = {
+    schemaVersion: MODULE_AGENT_SESSION_SCHEMA_VERSION,
     key: "known.copilot.history",
     operationKeys: [OPERATION_KEY],
     featureKey: "known.copilot",
@@ -218,7 +214,7 @@ async function createFixture(
       {
         manifest: module,
         setup(host) {
-          host.registerDebugSessionProviders([provider]);
+          host.registerAgentSessionProviders([provider]);
         },
       },
     ],
@@ -230,31 +226,24 @@ async function createFixture(
       licenseResolver: { resolve: () => ({ status: "valid" }) },
     },
   );
-  const runtime = {
-    ...base,
-    agentDebugOperationForActor: (actorId: string) =>
-      actorId === "service_adk_debug" ? OPERATION_KEY : undefined,
-  };
-  const context = createContext(actor(permissionKeys), true);
+  const runtime = base;
+  const context = createContext(actor(permissionKeys));
   return {
     context,
-    facade: new DebugSessionFacadeV1(
+    facade: new AgentSessionFacadeV1(
       hosts,
       runtime,
-      new DebugSessionIdCodecV1("test-secret-012345678901234567890123456789"),
+      new AgentSessionIdCodecV1("test-secret-012345678901234567890123456789"),
     ),
     runtime,
   };
 }
 
-function createContext(value: RequestActor, projected: boolean) {
-  const actorValue = projected
-    ? bindModuleUserProjection(value, "user_dev_admin")
-    : value;
+function createContext(value: RequestActor) {
   return createRequestGuardContext(
-    new Request("http://localhost/api/agent/debug/sessions/v1"),
+    new Request("http://localhost/api/agent/sessions/v1"),
     {
-      resolveActor: () => actorValue,
+      resolveActor: () => value,
       resolveLicense: () => ({ status: "valid" }),
       licenseEnforced: false,
     },
@@ -265,10 +254,10 @@ function actor(
   permissionKeys: string[] = ["known.copilot.execute"],
 ): RequestActor {
   return {
-    id: "service_adk_debug",
-    type: "service",
-    name: "ADK Debug",
-    roleCodes: ["adk-debug"],
+    id: "user_dev_admin",
+    type: "user",
+    name: "开发管理员",
+    roleCodes: ["analyst"],
     permissionKeys,
   };
 }
@@ -287,7 +276,7 @@ function signal(): AbortSignal {
   return new AbortController().signal;
 }
 
-function debugManifest(): ModuleManifest {
+function agentManifest(): ModuleManifest {
   return manifest("known", {
     features: [
       {

package/template/apps/server/src/agent/{debug-session-facade.ts → agent-session-facade.ts}

@@ -1,41 +1,38 @@
 import { randomUUIDv7 } from "bun";
 import {
-  MODULE_DEBUG_SESSION_SCHEMA_VERSION,
-  type ModuleDebugSessionSummaryV1,
+  MODULE_AGENT_SESSION_SCHEMA_VERSION,
+  type ModuleAgentSessionSummaryV1,
 } from "@southwind-ai/server-sdk";
 import { evaluateAccessGuards } from "../access-guards.js";
 import { auditActor, type RequestGuardContext } from "../guards.js";
 import type {
   InitializedModuleHosts,
-  RegisteredModuleDebugSessionProvider,
+  RegisteredModuleAgentSessionProvider,
 } from "../module-host.js";
 import { toModuleActor } from "../module-host.js";
 import type { createServerRuntime } from "../runtime.js";
-import { debugActorAuditMetadata } from "./run-debug-authorization.js";
-import { DebugSessionIdCodecV1 } from "./debug-session-id.js";
-import { readAllDebugSessionSummaries } from "./debug-session-provider-reader.js";
+import { AgentSessionIdCodecV1 } from "./agent-session-id.js";
+import { readAllAgentSessionSummaries } from "./agent-session-provider-reader.js";
 import {
-  DebugSessionProviderContractError,
-  validateDebugSessionDetail,
-} from "./debug-session-validation.js";
+  AgentSessionProviderContractError,
+  validateAgentSessionDetail,
+} from "./agent-session-validation.js";
 
 type ServerRuntime = Pick<
   ReturnType<typeof createServerRuntime>,
-  | "agentDebugOperationForActor"
-  | "auditSink"
-  | "recordDecisions"
-  | "resolveFeature"
+  "auditSink" | "recordDecisions" | "resolveFeature"
 >;
 
-export interface DebugSessionSummaryDtoV1 {
+export interface AgentSessionSummaryDtoV1 {
   readonly id: string;
+  readonly operationKey: string;
   readonly title: string;
   readonly scopeLabel?: string;
   readonly updatedAt: string;
   readonly revision: string;
 }
 
-export interface DebugSessionDetailDtoV1 extends DebugSessionSummaryDtoV1 {
+export interface AgentSessionDetailDtoV1 extends AgentSessionSummaryDtoV1 {
   readonly messages: readonly {
     sequence: number;
     role: "user" | "assistant";
@@ -44,7 +41,7 @@ export interface DebugSessionDetailDtoV1 extends DebugSessionSummaryDtoV1 {
   }[];
 }
 
-export class DebugSessionFacadeError extends Error {
+export class AgentSessionFacadeError extends Error {
   constructor(
     readonly code:
       | "FORBIDDEN"
@@ -59,11 +56,11 @@ export class DebugSessionFacadeError extends Error {
   }
 }
 
-export class DebugSessionFacadeV1 {
+export class AgentSessionFacadeV1 {
   constructor(
     private readonly hosts: InitializedModuleHosts,
     private readonly runtime: ServerRuntime,
-    private readonly ids: DebugSessionIdCodecV1,
+    private readonly ids: AgentSessionIdCodecV1,
   ) {}
 
   async list(context: RequestGuardContext, signal: AbortSignal) {
@@ -72,7 +69,7 @@ export class DebugSessionFacadeV1 {
     const results = await Promise.all(
       authorized.map(async (entry) => {
         try {
-          const sessions = await readAllDebugSessionSummaries({
+          const sessions = await readAllAgentSessionSummaries({
             provider: entry.provider,
             actor,
             operationKey: entry.operationKey,
@@ -97,7 +94,7 @@ export class DebugSessionFacadeV1 {
           Date.parse(right.updatedAt) - Date.parse(left.updatedAt),
       );
     return {
-      schemaVersion: MODULE_DEBUG_SESSION_SCHEMA_VERSION,
+      schemaVersion: MODULE_AGENT_SESSION_SCHEMA_VERSION,
       sessions: projected,
       truncated: false,
     };
@@ -109,9 +106,9 @@ export class DebugSessionFacadeV1 {
     signal: AbortSignal,
   ) {
     if (!this.ids.isWellFormed(sessionId)) {
-      throw new DebugSessionFacadeError(
+      throw new AgentSessionFacadeError(
         "INVALID_SESSION_ID",
-        "调试会话 ID 无效",
+        "Agent 会话 ID 无效",
         400,
       );
     }
@@ -119,9 +116,9 @@ export class DebugSessionFacadeV1 {
     const actor = toModuleActor(context.actor);
     let providerFailed = false;
     for (const entry of authorized) {
-      let summaries: readonly ModuleDebugSessionSummaryV1[];
+      let summaries: readonly ModuleAgentSessionSummaryV1[];
       try {
-        summaries = await readAllDebugSessionSummaries({
+        summaries = await readAllAgentSessionSummaries({
           provider: entry.provider,
           actor,
           operationKey: entry.operationKey,
@@ -143,7 +140,7 @@ export class DebugSessionFacadeV1 {
             signal,
           });
           if (!detail) break;
-          const validated = validateDebugSessionDetail(
+          const validated = validateAgentSessionDetail(
             detail,
             summary.sourceId,
           );
@@ -155,11 +152,11 @@ export class DebugSessionFacadeV1 {
             validated.messages.length,
           );
           return {
-            schemaVersion: MODULE_DEBUG_SESSION_SCHEMA_VERSION,
+            schemaVersion: MODULE_AGENT_SESSION_SCHEMA_VERSION,
             session: {
               ...this.project(entry, actor.id, validated),
               messages: validated.messages,
-            } satisfies DebugSessionDetailDtoV1,
+            } satisfies AgentSessionDetailDtoV1,
           };
         } catch (error) {
           providerFailed = true;
@@ -169,24 +166,17 @@ export class DebugSessionFacadeV1 {
       }
     }
     if (providerFailed) throw providerUnavailable();
-    throw new DebugSessionFacadeError(
+    throw new AgentSessionFacadeError(
       "SESSION_NOT_FOUND",
-      "调试会话不存在或不可访问",
+      "Agent 会话不存在或不可访问",
       404,
     );
   }
 
   private async authorizedProviders(context: RequestGuardContext) {
-    const operationKey = this.runtime.agentDebugOperationForActor(
-      context.actor.id,
-    );
-    if (!operationKey) {
-      throw new DebugSessionFacadeError("FORBIDDEN", "调试会话访问被拒绝", 403);
-    }
-    const candidates = this.hosts.debugSessionProviders.filter(({ provider }) =>
-      provider.operationKeys.includes(operationKey),
-    );
-    for (const { moduleName, provider } of candidates) {
+    const authorized: AuthorizedProvider[] = [];
+    for (const entry of this.hosts.agentSessionProviders) {
+      const { moduleName, provider } = entry;
       const manifest = this.hosts.manifestOf(moduleName);
       const feature = manifest.features.find(
         ({ key }) => key === provider.featureKey,
@@ -195,22 +185,26 @@ export class DebugSessionFacadeV1 {
         permission: { permissionKey: provider.permissionKey },
         feature,
       });
-      if (!access.decision.allowed) {
-        throw new DebugSessionFacadeError(
-          "FORBIDDEN",
-          "调试会话访问被拒绝",
-          403,
-        );
+      if (!access.decision.allowed) continue;
+      for (const operationKey of provider.operationKeys) {
+        authorized.push({ ...entry, operationKey });
       }
     }
-    return candidates.map((entry) => ({ ...entry, operationKey }));
+    if (!authorized.length) {
+      throw new AgentSessionFacadeError(
+        "FORBIDDEN",
+        "Agent 会话访问被拒绝",
+        403,
+      );
+    }
+    return authorized;
   }
 
   private project(
     entry: AuthorizedProvider,
     actorId: string,
-    summary: ModuleDebugSessionSummaryV1,
-  ): DebugSessionSummaryDtoV1 {
+    summary: ModuleAgentSessionSummaryV1,
+  ): AgentSessionSummaryDtoV1 {
     return {
       id: this.ids.issue({
         actorId,
@@ -218,6 +212,7 @@ export class DebugSessionFacadeV1 {
         providerKey: entry.provider.key,
         sourceId: summary.sourceId,
       }),
+      operationKey: entry.operationKey,
       title: summary.title,
       ...(summary.scopeLabel ? { scopeLabel: summary.scopeLabel } : {}),
       updatedAt: summary.updatedAt,
@@ -238,13 +233,12 @@ export class DebugSessionFacadeV1 {
       outcome: "success",
       actor: auditActor(context),
       target: {
-        type: "agent-debug-session",
+        type: "agent-session",
         id: sessionId ?? entry.provider.key,
       },
       module: entry.moduleName,
       requestId: context.requestId,
       metadata: {
-        ...debugActorAuditMetadata(context.actor),
         mode,
         resultCount,
       },
@@ -265,13 +259,12 @@ export class DebugSessionFacadeV1 {
       outcome: "failure",
       actor: auditActor(context),
       target: {
-        type: "agent-debug-session-provider",
+        type: "agent-session-provider",
         id: entry.provider.key,
       },
       module: entry.moduleName,
       requestId: context.requestId,
       metadata: {
-        ...debugActorAuditMetadata(context.actor),
         mode,
         phase,
         failureCode: providerFailureCode(error),
@@ -281,22 +274,22 @@ export class DebugSessionFacadeV1 {
   }
 }
 
-type AuthorizedProvider = RegisteredModuleDebugSessionProvider & {
+type AuthorizedProvider = RegisteredModuleAgentSessionProvider & {
   readonly operationKey: string;
 };
 
 function providerFailureCode(
   error: unknown,
 ): "PROVIDER_INVALID" | "PROVIDER_UNAVAILABLE" {
-  return error instanceof DebugSessionProviderContractError
+  return error instanceof AgentSessionProviderContractError
     ? "PROVIDER_INVALID"
     : "PROVIDER_UNAVAILABLE";
 }
 
-function providerUnavailable(): DebugSessionFacadeError {
-  return new DebugSessionFacadeError(
+function providerUnavailable(): AgentSessionFacadeError {
+  return new AgentSessionFacadeError(
     "PROVIDER_UNAVAILABLE",
-    "调试会话 Provider 暂不可用",
+    "Agent 会话 Provider 暂不可用",
     503,
   );
 }

package/template/apps/server/src/agent/{debug-session-id.test.ts → agent-session-id.test.ts}

@@ -1,9 +1,9 @@
 import { describe, expect, test } from "bun:test";
-import { DebugSessionIdCodecV1 } from "./debug-session-id.js";
+import { AgentSessionIdCodecV1 } from "./agent-session-id.js";
 
-describe("ADK 调试会话不透明 ID", () => {
+describe("Agent 会话不透明 ID", () => {
   test("稳定绑定业务用户、Operation、Provider 与 sourceId", () => {
-    const codec = new DebugSessionIdCodecV1(
+    const codec = new AgentSessionIdCodecV1(
       "test-secret-012345678901234567890123456789",
     );
     const identity = {
@@ -28,8 +28,8 @@ describe("ADK 调试会话不透明 ID", () => {
   });
 
   test("短 Secret 与可逆业务 ID fail closed", () => {
-    expect(() => new DebugSessionIdCodecV1("short")).toThrow("至少 32");
-    const codec = new DebugSessionIdCodecV1(
+    expect(() => new AgentSessionIdCodecV1("short")).toThrow("至少 32");
+    const codec = new AgentSessionIdCodecV1(
       "test-secret-012345678901234567890123456789",
     );
     expect(codec.isWellFormed("private-conversation-id")).toBeFalse();

package/template/apps/server/src/agent/{debug-session-id.ts → agent-session-id.ts}

@@ -1,22 +1,22 @@
 import { createHmac } from "node:crypto";
 
-export const DEBUG_SESSION_ID_PREFIX = "wdbg1_";
+export const AGENT_SESSION_ID_PREFIX = "wags1_";
 
-export interface DebugSessionIdentityV1 {
+export interface AgentSessionIdentityV1 {
   readonly actorId: string;
   readonly operationKey: string;
   readonly providerKey: string;
   readonly sourceId: string;
 }
 
-export class DebugSessionIdCodecV1 {
+export class AgentSessionIdCodecV1 {
   constructor(private readonly secret: string) {
     if (Buffer.byteLength(secret) < 32) {
-      throw new Error("调试会话 ID Secret 必须至少 32 字节");
+      throw new Error("Agent 会话 ID Secret 必须至少 32 字节");
     }
   }
 
-  issue(identity: DebugSessionIdentityV1): string {
+  issue(identity: AgentSessionIdentityV1): string {
     const digest = createHmac("sha256", this.secret)
       .update(
         JSON.stringify([
@@ -28,10 +28,10 @@ export class DebugSessionIdCodecV1 {
         ]),
       )
       .digest("base64url");
-    return `${DEBUG_SESSION_ID_PREFIX}${digest}`;
+    return `${AGENT_SESSION_ID_PREFIX}${digest}`;
   }
 
   isWellFormed(value: string): boolean {
-    return /^wdbg1_[A-Za-z0-9_-]{43}$/.test(value);
+    return /^wags1_[A-Za-z0-9_-]{43}$/.test(value);
   }
 }