@zhin.js/host-http 1.0.13 → 1.0.15

package/lib/console-rest-pages.d.ts

@@ -26,6 +26,8 @@ export interface ConsoleRestCtx {
             get(name: string): unknown;
         };
     };
+    /** Distinguishes a real IM conversation with no Agent turn from a typo key. */
+    readonly isKnownConversationSession?: (sessionKey: string) => boolean | undefined | Promise<boolean | undefined>;
 }
 /** 内省数据门面 — 由 basic/cli 用 agent 包 collectIntrospection* 装配。 */
 export interface ConsoleAgentIntrospection {

package/lib/console-rest-pages.js

@@ -663,9 +663,33 @@ function registerAgentSessionRoutes(route, base, ctx) {
         try {
             const sessionId = await runtime.resolveActiveSessionId(parsed.sessionKey);
             if (!sessionId) {
-                writeJson(response, 404, {
-                    success: false,
-                    error: `未找到活跃会话：${parsed.sessionKey}`,
+                if (!isRuntimeImSessionKey(parsed.sessionKey)) {
+                    writeJson(response, 404, {
+                        success: false,
+                        error: `未找到会话：${parsed.sessionKey}`,
+                    });
+                    return;
+                }
+                const knownConversation = await ctx.isKnownConversationSession?.(parsed.sessionKey);
+                if (knownConversation === false) {
+                    writeJson(response, 404, {
+                        success: false,
+                        error: `未找到会话：${parsed.sessionKey}`,
+                    });
+                    return;
+                }
+                // 渠道会话与 Agent 会话的生命周期不同：用户可以先在 Console
+                // 选中一个真实渠道会话，而该会话尚未触发过 Agent。树查询是只读操作，
+                // 因而将这种正常状态返回为可渲染空态，而不是误报资源不存在。
+                writeJson(response, 200, {
+                    success: true,
+                    data: {
+                        state: 'not_started',
+                        sessionKey: parsed.sessionKey,
+                        sessionId: null,
+                        activeLeafMessageId: null,
+                        points: [],
+                    },
                 });
                 return;
             }
@@ -674,6 +698,7 @@ function registerAgentSessionRoutes(route, base, ctx) {
             writeJson(response, 200, {
                 success: true,
                 data: {
+                    state: 'active',
                     sessionKey: parsed.sessionKey,
                     sessionId,
                     activeLeafMessageId,
@@ -774,6 +799,16 @@ function registerAgentSessionRoutes(route, base, ctx) {
         }
     }, { summary: 'Switch agent session active leaf', tags: ['console', 'agent'] });
 }
+/** Runtime IM session keys are `<platform>:<endpoint>:<scope>:<sceneId>`. */
+function isRuntimeImSessionKey(value) {
+    const first = value.indexOf(':');
+    const second = value.indexOf(':', first + 1);
+    const third = value.indexOf(':', second + 1);
+    return first > 0
+        && second > first + 1
+        && third > second + 1
+        && third < value.length - 1;
+}
 function parseSessionAction(pathname, prefix, action) {
     if (!pathname.startsWith(prefix))
         return null;

package/lib/console-rpc-extended.d.ts

@@ -55,6 +55,18 @@ export interface ConsoleRpcExtendedCtx {
     workroomKnowledgeControl?: ConsoleWorkroomKnowledgeControlPort;
 }
 export interface ConsoleWorkroomProfileControlPort {
+    getPlanningStatus(projectId: string, authenticatedPrincipal?: Readonly<{
+        principalId: string;
+    }>): Promise<unknown>;
+    bootstrapPlanning(command: Readonly<{
+        operationId: string;
+        projectId: string;
+        expectedRegistryRevision: number;
+        includeTools?: readonly string[];
+        includeSkills?: readonly string[];
+    }>, authenticatedPrincipal: Readonly<{
+        principalId: string;
+    }>): Promise<unknown>;
     publishPack(command: Readonly<{
         operationId: string;
         pack: unknown;

package/lib/console-rpc-extended.js

@@ -95,6 +95,8 @@ export async function dispatchExtendedConsoleRpc(type, data, ctx) {
             });
         case 'endpoint.delete_friend':
             return deleteFriend(d, ctx);
+        case 'workroom.profile.status':
+        case 'workroom.profile.bootstrap':
         case 'workroom.profile.pack.publish':
         case 'workroom.profile.publish':
         case 'workroom.profile.rollback':
@@ -118,11 +120,31 @@ async function mutateWorkroomProfile(type, data, ctx) {
         if (forbidden in data)
             return { error: `Console Workroom Profile request cannot carry ${forbidden}` };
     }
+    if (type === 'workroom.profile.status') {
+        try {
+            return { data: await control.getPlanningStatus(requiredRpcText(data.projectId, 'projectId'), ctx.authenticatedPrincipal) };
+        }
+        catch (error) {
+            return { error: errorMessage(error) };
+        }
+    }
     const principal = ctx.authenticatedPrincipal;
     if (!principal)
         return { error: 'Workroom Profile control requires an authenticated principal' };
     try {
         const operationId = requiredRpcText(data.operationId, 'operationId');
+        if (type === 'workroom.profile.bootstrap') {
+            const projectId = requiredRpcText(data.projectId, 'projectId');
+            const includeTools = optionalRpcTextArray(data.includeTools, 'includeTools');
+            const includeSkills = optionalRpcTextArray(data.includeSkills, 'includeSkills');
+            return { data: await control.bootstrapPlanning(Object.freeze({
+                    operationId,
+                    projectId,
+                    expectedRegistryRevision: requiredRpcInteger(data.expectedRegistryRevision, 'expectedRegistryRevision', -1),
+                    ...(includeTools ? { includeTools } : {}),
+                    ...(includeSkills ? { includeSkills } : {}),
+                }), principal) };
+        }
         if (type === 'workroom.profile.pack.publish') {
             return { data: await control.publishPack(Object.freeze({ operationId, pack: requiredRpcValue(data.pack, 'pack') }), principal) };
         }
@@ -205,6 +227,16 @@ function requiredRpcText(value, name) {
 function optionalRpcText(value, name) {
     return value === undefined ? undefined : requiredRpcText(value, name);
 }
+function optionalRpcTextArray(value, name) {
+    if (value === undefined)
+        return undefined;
+    if (!Array.isArray(value))
+        throw new Error(`${name} is invalid`);
+    const result = value.map((item, index) => requiredRpcText(item, `${name}.${index}`));
+    if (new Set(result).size !== result.length)
+        throw new Error(`${name} contains duplicates`);
+    return Object.freeze(result);
+}
 function requiredRpcInteger(value, name, minimum = 1) {
     if (!Number.isSafeInteger(value) || Number(value) < minimum)
         throw new Error(`${name} is invalid`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/host-http",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "description": "Minimal HTTP and WebSocket host for Plugin Runtime (no Koa)",
   "type": "module",
   "main": "./lib/index.js",

package/src/console-rest-pages.ts

@@ -42,6 +42,10 @@ export interface ConsoleRestCtx {
     readonly started: boolean;
     readonly models: { get(name: string): unknown };
   };
+  /** Distinguishes a real IM conversation with no Agent turn from a typo key. */
+  readonly isKnownConversationSession?: (
+    sessionKey: string,
+  ) => boolean | undefined | Promise<boolean | undefined>;
 }
 
 /** 内省数据门面 — 由 basic/cli 用 agent 包 collectIntrospection* 装配。 */
@@ -864,9 +868,33 @@ function registerAgentSessionRoutes(
     try {
       const sessionId = await runtime.resolveActiveSessionId(parsed.sessionKey);
       if (!sessionId) {
-        writeJson(response, 404, {
-          success: false,
-          error: `未找到活跃会话：${parsed.sessionKey}`,
+        if (!isRuntimeImSessionKey(parsed.sessionKey)) {
+          writeJson(response, 404, {
+            success: false,
+            error: `未找到会话：${parsed.sessionKey}`,
+          });
+          return;
+        }
+        const knownConversation = await ctx.isKnownConversationSession?.(parsed.sessionKey);
+        if (knownConversation === false) {
+          writeJson(response, 404, {
+            success: false,
+            error: `未找到会话：${parsed.sessionKey}`,
+          });
+          return;
+        }
+        // 渠道会话与 Agent 会话的生命周期不同：用户可以先在 Console
+        // 选中一个真实渠道会话，而该会话尚未触发过 Agent。树查询是只读操作，
+        // 因而将这种正常状态返回为可渲染空态，而不是误报资源不存在。
+        writeJson(response, 200, {
+          success: true,
+          data: {
+            state: 'not_started',
+            sessionKey: parsed.sessionKey,
+            sessionId: null,
+            activeLeafMessageId: null,
+            points: [],
+          },
         });
         return;
       }
@@ -876,6 +904,7 @@ function registerAgentSessionRoutes(
       writeJson(response, 200, {
         success: true,
         data: {
+          state: 'active',
           sessionKey: parsed.sessionKey,
           sessionId,
           activeLeafMessageId,
@@ -975,6 +1004,17 @@ function registerAgentSessionRoutes(
   }, { summary: 'Switch agent session active leaf', tags: ['console', 'agent'] });
 }
 
+/** Runtime IM session keys are `<platform>:<endpoint>:<scope>:<sceneId>`. */
+function isRuntimeImSessionKey(value: string): boolean {
+  const first = value.indexOf(':');
+  const second = value.indexOf(':', first + 1);
+  const third = value.indexOf(':', second + 1);
+  return first > 0
+    && second > first + 1
+    && third > second + 1
+    && third < value.length - 1;
+}
+
 function parseSessionAction(
   pathname: string,
   prefix: string,

package/src/console-rpc-extended.ts

@@ -66,6 +66,15 @@ export interface ConsoleRpcExtendedCtx {
 }
 
 export interface ConsoleWorkroomProfileControlPort {
+  getPlanningStatus(projectId: string,
+    authenticatedPrincipal?: Readonly<{ principalId: string }>): Promise<unknown>;
+  bootstrapPlanning(command: Readonly<{
+    operationId: string;
+    projectId: string;
+    expectedRegistryRevision: number;
+    includeTools?: readonly string[];
+    includeSkills?: readonly string[];
+  }>, authenticatedPrincipal: Readonly<{ principalId: string }>): Promise<unknown>;
   publishPack(command: Readonly<{ operationId: string; pack: unknown }>,
     authenticatedPrincipal: Readonly<{ principalId: string }>): Promise<unknown>;
   publishProfile(command: Readonly<{
@@ -258,6 +267,8 @@ export async function dispatchExtendedConsoleRpc(
     case 'endpoint.delete_friend':
       return deleteFriend(d, ctx);
 
+    case 'workroom.profile.status':
+    case 'workroom.profile.bootstrap':
     case 'workroom.profile.pack.publish':
     case 'workroom.profile.publish':
     case 'workroom.profile.rollback':
@@ -275,7 +286,8 @@ export async function dispatchExtendedConsoleRpc(
 }
 
 async function mutateWorkroomProfile(
-  type: 'workroom.profile.pack.publish' | 'workroom.profile.publish'
+  type: 'workroom.profile.status' | 'workroom.profile.bootstrap'
+    | 'workroom.profile.pack.publish' | 'workroom.profile.publish'
     | 'workroom.profile.rollback' | 'workroom.profile.policy.publish',
   data: Record<string, unknown>,
   ctx: ConsoleRpcExtendedCtx,
@@ -287,10 +299,36 @@ async function mutateWorkroomProfile(
   ]) {
     if (forbidden in data) return { error: `Console Workroom Profile request cannot carry ${forbidden}` };
   }
+  if (type === 'workroom.profile.status') {
+    try {
+      return { data: await control.getPlanningStatus(
+        requiredRpcText(data.projectId, 'projectId'),
+        ctx.authenticatedPrincipal,
+      ) };
+    } catch (error) {
+      return { error: errorMessage(error) };
+    }
+  }
   const principal = ctx.authenticatedPrincipal;
   if (!principal) return { error: 'Workroom Profile control requires an authenticated principal' };
   try {
     const operationId = requiredRpcText(data.operationId, 'operationId');
+    if (type === 'workroom.profile.bootstrap') {
+      const projectId = requiredRpcText(data.projectId, 'projectId');
+      const includeTools = optionalRpcTextArray(data.includeTools, 'includeTools');
+      const includeSkills = optionalRpcTextArray(data.includeSkills, 'includeSkills');
+      return { data: await control.bootstrapPlanning(Object.freeze({
+        operationId,
+        projectId,
+        expectedRegistryRevision: requiredRpcInteger(
+          data.expectedRegistryRevision,
+          'expectedRegistryRevision',
+          -1,
+        ),
+        ...(includeTools ? { includeTools } : {}),
+        ...(includeSkills ? { includeSkills } : {}),
+      }), principal) };
+    }
     if (type === 'workroom.profile.pack.publish') {
       return { data: await control.publishPack(Object.freeze({ operationId, pack: requiredRpcValue(data.pack, 'pack') }), principal) };
     }
@@ -374,6 +412,14 @@ function optionalRpcText(value: unknown, name: string): string | undefined {
   return value === undefined ? undefined : requiredRpcText(value, name);
 }
 
+function optionalRpcTextArray(value: unknown, name: string): readonly string[] | undefined {
+  if (value === undefined) return undefined;
+  if (!Array.isArray(value)) throw new Error(`${name} is invalid`);
+  const result = value.map((item, index) => requiredRpcText(item, `${name}.${index}`));
+  if (new Set(result).size !== result.length) throw new Error(`${name} contains duplicates`);
+  return Object.freeze(result);
+}
+
 function requiredRpcInteger(value: unknown, name: string, minimum = 1): number {
   if (!Number.isSafeInteger(value) || Number(value) < minimum) throw new Error(`${name} is invalid`);
   return Number(value);