@zhin.js/agent 1.0.1 → 1.0.3

package/lib/builtin-tools.js

@@ -6,7 +6,7 @@
  * 网络:      web_search, web_fetch（builtin/web-*-tool）
  * 计划:      todo_read, todo_write（builtin/todo-*-tool）
  * 记忆 MCP:  mcp_memory_*（ai.memoryMcp: true 时注册 server-memory）
- * 技能:      activate_skill, install_skill（builtin/activate-skill-tool, install-skill-tool）
+ * 技能:      load_skill, install_skill（builtin/load-skill-tool, install-skill-tool）
  * 交互:      ask_user（builtin/ask-user-tool）
  *
  * 发现逻辑已拆分到 discovery/skills.ts、agents.ts、tools.ts
@@ -23,7 +23,7 @@ import { createWebSearchTool } from './builtin/web-search-tool.js';
 import { createWebFetchTool } from './builtin/web-fetch-tool.js';
 import { createTodoReadTool } from './builtin/todo-read-tool.js';
 import { createTodoWriteTool } from './builtin/todo-write-tool.js';
-import { createActivateSkillTool } from './builtin/activate-skill-tool.js';
+import { createDeferredMetaTools } from './builtin/deferred-tool-meta.js';
 import { createInstallSkillTool } from './builtin/install-skill-tool.js';
 import { createAskUserTool } from './builtin/ask-user-tool.js';
 import { createAnalyzeMediaTool } from './builtin/analyze-media-tool.js';
@@ -52,7 +52,7 @@ export function createBuiltinTools(options) {
     tools.push(createWebFetchTool());
     tools.push(createTodoReadTool(DATA_DIR));
     tools.push(createTodoWriteTool(DATA_DIR));
-    tools.push(createActivateSkillTool({
+    tools.push(...createDeferredMetaTools({
         skillFileLookup,
         skillDirList,
         skillMaxChars,

package/lib/builtin-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"builtin-tools.js","sourceRoot":"","sources":["../src/builtin-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,UAAU,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAsB/E;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC7D,MAAM,QAAQ,GAAG,UAAU,EAAE,CAAC;IAC9B,MAAM,aAAa,GAAG,OAAO,EAAE,wBAAwB,IAAI,IAAI,CAAC;IAChE,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,0BAA0B,CAAC,OAAO,EAAE,wBAAwB,CAAC,CAAC;IACzF,MAAM,eAAe,GAAG,OAAO,EAAE,eAAe,CAAC;IACjD,MAAM,SAAS,GAAG,OAAO,EAAE,MAAM,CAAC;IAElC,MAAM,KAAK,GAAgB,EAAE,CAAC;IAE9B,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC;IACxD,KAAK,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE1C,KAAK,CAAC,IAAI,CACR,uBAAuB,CAAC;QACtB,eAAe;QACf,YAAY;QACZ,aAAa;KACd,CAAC,CACH,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAErC,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC;IAEzC,IAAI,OAAO,EAAE,cAAc,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,OAAO,EAAE,YAAY,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAChF,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"builtin-tools.js","sourceRoot":"","sources":["../src/builtin-tools.ts"],"names":[],"mappings":"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"}

package/lib/collaboration/ask-user-bridge.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 群协作场景下 ask_user 与 kernel 委派的衔接。
+ */
+import type { Message } from '@zhin.js/core';
+/** 群内禁止用 ask_user 向 Owner 申请「委派授权」——应走 OrchestrationKernel / spawn_task。 */
+export declare function shouldBlockDelegationAskUser(commMessage: Message, question: string, questionType: string): string | undefined;
+export declare function buildGroupAskUserFollowUp(commMessage: Message, answer: string): string;
+export declare function notifyGroupOwnerAskUserResolved(commMessage: Message, answer: string): Promise<void>;
+//# sourceMappingURL=ask-user-bridge.d.ts.map

package/lib/collaboration/ask-user-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user-bridge.d.ts","sourceRoot":"","sources":["../../src/collaboration/ask-user-bridge.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAO7C,4EAA4E;AAC5E,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,OAAO,EACpB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,MAAM,GAAG,SAAS,CAmBpB;AAiBD,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAuBtF;AAED,wBAAsB,+BAA+B,CACnD,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/lib/collaboration/ask-user-bridge.js

@@ -0,0 +1,73 @@
+import { resolveCellForScene } from './collaboration-config.js';
+import { publishCollaborationGroupFeed, resolveActorPipelineRole, } from './group-feed.js';
+/** 群内禁止用 ask_user 向 Owner 申请「委派授权」——应走 OrchestrationKernel / spawn_task。 */
+export function shouldBlockDelegationAskUser(commMessage, question, questionType) {
+    const scope = commMessage.$channel?.type;
+    if (scope !== 'group' && scope !== 'channel')
+        return undefined;
+    const sceneId = commMessage.$channel?.id;
+    if (!sceneId)
+        return undefined;
+    const cell = resolveCellForScene(String(commMessage.$adapter ?? ''), sceneId);
+    if (!cell || cell.members.length < 2)
+        return undefined;
+    const q = question.trim();
+    if (questionType !== 'confirm')
+        return undefined;
+    if (looksLikeDelegationAuthorization(q)) {
+        return 'Error: In group collaboration, do not ask_owner to authorize delegation. Use orchestration_add_task (internal_room) or spawn_task with the peer endpoint.';
+    }
+    if (mentionsPipelineRole(q) && containsAny(q.toLowerCase(), ['是否', 'authorize', '授权', '调用'])) {
+        return 'Error: In group collaboration, dispatch peers via OrchestrationKernel (internal_room task) — do not ask_owner for role authorization.';
+    }
+    return undefined;
+}
+function looksLikeDelegationAuthorization(text) {
+    const lower = text.toLowerCase();
+    if (text.includes('授权') || lower.includes('authorize'))
+        return true;
+    if (text.includes('是否') && containsAny(text, ['调用', '使用', '委派', '派遣']))
+        return true;
+    return lower.includes('allow') && containsAny(lower, ['researcher', 'executor', 'delegate', 'agent']);
+}
+function mentionsPipelineRole(text) {
+    return containsAny(text.toLowerCase(), ['researcher', 'evaluator', 'executor', 'reviewer']);
+}
+function containsAny(text, needles) {
+    return needles.some((needle) => text.includes(needle));
+}
+export function buildGroupAskUserFollowUp(commMessage, answer) {
+    const scope = commMessage.$channel?.type;
+    if (scope !== 'group' && scope !== 'channel')
+        return answer;
+    const sceneId = commMessage.$channel?.id;
+    if (!sceneId)
+        return answer;
+    const cell = resolveCellForScene(String(commMessage.$adapter ?? ''), sceneId);
+    if (!cell || cell.members.length < 2)
+        return answer;
+    const peer = cell.members.find((m) => m.endpointId !== String(commMessage.$endpoint));
+    const peerEp = peer?.endpointId ?? '<peerEndpoint>';
+    const roleLabel = peer?.pipelineRole ?? peer?.primary ?? 'next peer';
+    return [
+        answer,
+        '',
+        `[Collaboration] Owner replied via private. Active scene: group ${sceneId}.`,
+        `Next: orchestration_add_task with executor internal_room assigned_to ${peerEp}, or spawn_task for local work (${roleLabel}).`,
+        'Optional group visibility: project_to_im true or a separate im_projection task; #taskId is only required for im_projection handback.',
+        'Do NOT answer from memory or skip kernel task dispatch.',
+    ].join('\n');
+}
+export async function notifyGroupOwnerAskUserResolved(commMessage, answer) {
+    const scope = commMessage.$channel?.type;
+    if (scope !== 'group' && scope !== 'channel')
+        return;
+    await publishCollaborationGroupFeed({
+        message: commMessage,
+        role: resolveActorPipelineRole(commMessage),
+        emoji: '✅',
+        headline: 'Owner 已确认',
+        detail: answer,
+    });
+}
+//# sourceMappingURL=ask-user-bridge.js.map

package/lib/collaboration/ask-user-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-user-bridge.js","sourceRoot":"","sources":["../../src/collaboration/ask-user-bridge.ts"],"names":[],"mappings":"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"}

package/lib/collaboration/bootstrap-agent-runtimes.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Bootstrap per-endpoint ZhinAgent runtimes for multi-bot collaboration cells.
+ */
+import type { Plugin } from '@zhin.js/core';
+import { ZhinAgent } from '../zhin-agent/index.js';
+import type { AIService } from '../service.js';
+import type { AIServiceRefs } from '../init/shared-refs.js';
+import type { ZhinAgentConfig } from '../config/index.js';
+export interface BootstrapRuntimesOptions {
+    refs: AIServiceRefs;
+    plugin: Plugin;
+    ai: AIService;
+    primaryAgent: ZhinAgent;
+    agentConfig?: ZhinAgentConfig;
+}
+/** DB 就绪后，将持久化层同步到协作 Cell 内各 Endpoint Runtime */
+export declare function syncCollaborationRuntimePersistence(primary: ZhinAgent): void;
+export declare function markAllRuntimesPersistenceReady(primary: ZhinAgent): void;
+export declare function bootstrapEndpointRuntimes(options: BootstrapRuntimesOptions): void;
+/** DB 加载协作单元后重新绑定 Endpoint Runtime */
+export declare function rebootstrapEndpointRuntimes(): Promise<void>;
+//# sourceMappingURL=bootstrap-agent-runtimes.d.ts.map

package/lib/collaboration/bootstrap-agent-runtimes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-agent-runtimes.d.ts","sourceRoot":"","sources":["../../src/collaboration/bootstrap-agent-runtimes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAO1D,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,SAAS,CAAC;IACd,YAAY,EAAE,SAAS,CAAC;IACxB,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAyFD,iDAAiD;AACjD,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,CAQ5E;AAED,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,CAGxE;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAGjF;AAED,sCAAsC;AACtC,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAGjE"}

package/lib/collaboration/bootstrap-agent-runtimes.js

@@ -0,0 +1,106 @@
+/**
+ * Bootstrap per-endpoint ZhinAgent runtimes for multi-bot collaboration cells.
+ */
+import { ZhinAgent } from '../zhin-agent/index.js';
+import { DEFAULT_ZHIN_AGENT_NAME } from '../config/types.js';
+import { getAgentRuntimeRegistry } from './runtime-registry.js';
+import { getCollaborationSceneService } from './scene-service.js';
+import { findCellMemberByEndpoint } from './collaboration-config.js';
+import { resolvePipelineRoleBinding } from '../config/resolve-pipeline-binding.js';
+import { isPipelineRole } from './types.js';
+import { COLLABORATION_CONTEXT_TAIL_MESSAGE_LIMIT } from '../context/context-tail-limit.js';
+let lastBootstrapOptions = null;
+function resolveMemberForEndpoint(cells, endpointId) {
+    for (const cell of cells) {
+        const member = findCellMemberByEndpoint(cell, endpointId);
+        if (member)
+            return { primary: member.primary, pipelineRole: member.pipelineRole };
+    }
+    return { primary: DEFAULT_ZHIN_AGENT_NAME };
+}
+/** 解析 Endpoint 绑定：优先 pipelineRole（继承 zhin），否则按 primary 名 / zhin 回退。 */
+function resolveEndpointBinding(ai, member) {
+    if (isPipelineRole(member.pipelineRole)) {
+        const routing = ai.getRoutingConfig();
+        return resolvePipelineRoleBinding(member.pipelineRole, {
+            agents: routing.agents,
+        });
+    }
+    return (ai.getBindingRegistry().getBinding(member.primary)
+        ?? ai.getBindingRegistry().requireZhinBinding());
+}
+function applyEndpointRuntimes(options) {
+    const { refs, plugin, ai, primaryAgent, agentConfig } = options;
+    const registry = getAgentRuntimeRegistry();
+    registry.registerDefault(primaryAgent);
+    refs.zhinAgent = primaryAgent;
+    const cellList = getCollaborationSceneService().listScenes();
+    if (cellList.length === 0)
+        return;
+    const endpointIds = [...new Set(cellList.flatMap((c) => c.members.map((m) => m.endpointId)))].sort();
+    if (endpointIds.length === 1) {
+        const endpointId = endpointIds[0];
+        const member = resolveMemberForEndpoint(cellList, endpointId);
+        const binding = resolveEndpointBinding(ai, member);
+        primaryAgent.configure({ activeBinding: binding });
+        registry.registerForEndpoint(endpointId, primaryAgent);
+        return;
+    }
+    const orchestrator = plugin.root.inject('agent');
+    const modelRegistry = ai.getModelRegistry();
+    const primaryEndpointId = endpointIds[0];
+    const collabTail = agentConfig?.contextTailMessageLimit ?? COLLABORATION_CONTEXT_TAIL_MESSAGE_LIMIT;
+    const runtimeConfig = {
+        ...(agentConfig ?? {}),
+        contextTailMessageLimit: collabTail,
+    };
+    for (const endpointId of endpointIds) {
+        const member = resolveMemberForEndpoint(cellList, endpointId);
+        const binding = resolveEndpointBinding(ai, member);
+        if (endpointId === primaryEndpointId) {
+            primaryAgent.configure({ activeBinding: binding });
+            registry.registerForEndpoint(endpointId, primaryAgent);
+            continue;
+        }
+        const provider = ai.getProvider(binding.providerAlias);
+        const runtime = new ZhinAgent(provider, {
+            ...runtimeConfig,
+            chatModel: binding.model,
+        });
+        runtime.configure({
+            hostPlugin: plugin.root,
+            providerResolver: (alias) => ai.getProvider(alias),
+            activeBinding: binding,
+            modelRegistry: modelRegistry ?? undefined,
+            skillRegistry: orchestrator?.skills,
+            orchestrator: orchestrator ?? undefined,
+        });
+        registry.registerForEndpoint(endpointId, runtime);
+        primaryAgent.sharePersistenceWith(runtime);
+    }
+}
+/** DB 就绪后，将持久化层同步到协作 Cell 内各 Endpoint Runtime */
+export function syncCollaborationRuntimePersistence(primary) {
+    const registry = getAgentRuntimeRegistry();
+    for (const endpointId of registry.listEndpointIds()) {
+        const runtime = registry.getForEndpoint(endpointId);
+        if (runtime && runtime !== primary) {
+            primary.sharePersistenceWith(runtime);
+        }
+    }
+}
+export function markAllRuntimesPersistenceReady(primary) {
+    primary.markMemoryPersistenceReady();
+    syncCollaborationRuntimePersistence(primary);
+}
+export function bootstrapEndpointRuntimes(options) {
+    lastBootstrapOptions = options;
+    applyEndpointRuntimes(options);
+}
+/** DB 加载协作单元后重新绑定 Endpoint Runtime */
+export async function rebootstrapEndpointRuntimes() {
+    if (!lastBootstrapOptions)
+        return;
+    applyEndpointRuntimes(lastBootstrapOptions);
+}
+//# sourceMappingURL=bootstrap-agent-runtimes.js.map

package/lib/collaboration/bootstrap-agent-runtimes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-agent-runtimes.js","sourceRoot":"","sources":["../../src/collaboration/bootstrap-agent-runtimes.ts"],"names":[],"mappings":"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"}

package/lib/collaboration/collab-admin-gate.d.ts

@@ -0,0 +1,21 @@
+/**
+ * CollabAdminGate — 多 Bot 群 /collab 管理指令门控。
+ *
+ * 当群内有多个 Bot 同时在线时，/collab init|bind|unbind|reset 等管理指令
+ * 仅由被 @-mention 的 endpoint 执行并回复，其余 endpoint 静默忽略。
+ *
+ * 规则：
+ * 1. 消息含 at segment 且目标是本 endpoint → 放行
+ * 2. 消息不含任何 at segment 且群内只有 1 个 Bot → 放行
+ * 3. 其余情况 → 拦截
+ */
+import type { Message, Plugin } from '@zhin.js/core';
+export interface AdminGateResult {
+    allowed: boolean;
+    reason?: string;
+}
+/**
+ * 检查当前 endpoint 是否应处理 /collab 管理指令。
+ */
+export declare function checkCollabAdminGate(message: Message, endpointId: string, root: Plugin): AdminGateResult;
+//# sourceMappingURL=collab-admin-gate.d.ts.map

package/lib/collaboration/collab-admin-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collab-admin-gate.d.ts","sourceRoot":"","sources":["../../src/collaboration/collab-admin-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAoDrD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,eAAe,CAmBjB"}

package/lib/collaboration/collab-admin-gate.js

@@ -0,0 +1,74 @@
+/**
+ * CollabAdminGate — 多 Bot 群 /collab 管理指令门控。
+ *
+ * 当群内有多个 Bot 同时在线时，/collab init|bind|unbind|reset 等管理指令
+ * 仅由被 @-mention 的 endpoint 执行并回复，其余 endpoint 静默忽略。
+ *
+ * 规则：
+ * 1. 消息含 at segment 且目标是本 endpoint → 放行
+ * 2. 消息不含任何 at segment 且群内只有 1 个 Bot → 放行
+ * 3. 其余情况 → 拦截
+ */
+import { extractAtTargets } from './init-observe-hook.js';
+/**
+ * 获取当前 endpoint 在平台上可被 @ 到的所有 id。
+ */
+function resolveLocalEndpointIds(root, adapter, endpointId) {
+    const ids = new Set([endpointId]);
+    try {
+        const ad = root.inject(adapter);
+        const ep = ad?.endpoints?.get(endpointId);
+        if (ep?.$config?.name)
+            ids.add(String(ep.$config.name));
+        if (ep?.$config?.appid)
+            ids.add(String(ep.$config.appid));
+        if (ep?.$platformUserId)
+            ids.add(String(ep.$platformUserId));
+    }
+    catch {
+        // adapter not ready
+    }
+    return ids;
+}
+/**
+ * 统计群内在线 Bot 数量（跨 adapter）。
+ */
+function countOnlineBotsInGroup(root) {
+    let count = 0;
+    for (const adapterName of root.adapters) {
+        try {
+            const adapter = root.inject(String(adapterName));
+            if (!adapter?.endpoints)
+                continue;
+            for (const ep of adapter.endpoints.values()) {
+                if (ep.$connected)
+                    count++;
+            }
+        }
+        catch {
+            // skip
+        }
+    }
+    return count;
+}
+/**
+ * 检查当前 endpoint 是否应处理 /collab 管理指令。
+ */
+export function checkCollabAdminGate(message, endpointId, root) {
+    const adapter = String(message.$adapter ?? '');
+    const atTargets = extractAtTargets(message);
+    if (atTargets.length > 0) {
+        const myIds = resolveLocalEndpointIds(root, adapter, endpointId);
+        const isMentioned = atTargets.some((t) => myIds.has(t));
+        if (isMentioned) {
+            return { allowed: true };
+        }
+        return { allowed: false, reason: 'at_other_endpoint' };
+    }
+    const botCount = countOnlineBotsInGroup(root);
+    if (botCount <= 1) {
+        return { allowed: true };
+    }
+    return { allowed: false, reason: 'multi_bot_no_mention' };
+}
+//# sourceMappingURL=collab-admin-gate.js.map

package/lib/collaboration/collab-admin-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collab-admin-gate.js","sourceRoot":"","sources":["../../src/collaboration/collab-admin-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAO1D;;GAEG;AACH,SAAS,uBAAuB,CAC9B,IAAY,EACZ,OAAe,EACf,UAAkB;IAElB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAS,CAAC,UAAU,CAAC,CAAC,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAEjB,CAAC;QACd,MAAM,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;QAC1C,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI;YAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACxD,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK;YAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1D,IAAI,EAAE,EAAE,eAAe;YAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,oBAAoB;IACtB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAAC,IAAY;IAC1C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAElC,CAAC;YACd,IAAI,CAAC,OAAO,EAAE,SAAS;gBAAE,SAAS;YAClC,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC5C,IAAI,EAAE,CAAC,UAAU;oBAAE,KAAK,EAAE,CAAC;YAC7B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAOD;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAgB,EAChB,UAAkB,EAClB,IAAY;IAEZ,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAE5C,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,uBAAuB,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QACjE,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IACzD,CAAC;IAED,MAAM,QAAQ,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QAClB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;AAC5D,CAAC"}

package/lib/collaboration/collaboration-artifact-repository.d.ts

@@ -0,0 +1,46 @@
+import type { PipelineArtifact, PipelineArtifactKind, PipelineStage } from './types.js';
+export interface SubmitArtifactInput {
+    collaborationSceneId: string;
+    runId: string;
+    stage: PipelineStage;
+    kind: PipelineArtifactKind;
+    payload: Record<string, unknown>;
+    createdByEndpoint?: string;
+}
+export interface CollaborationArtifactRepository {
+    submit(input: SubmitArtifactInput): Promise<PipelineArtifact>;
+    /** 列出某 run 的产物，可选按 kind 过滤。 */
+    listByRun(collaborationSceneId: string, runId: string, kinds?: PipelineArtifactKind[]): Promise<PipelineArtifact[]>;
+    /** 取某 run + kind 的最新一条。 */
+    latest(collaborationSceneId: string, runId: string, kind: PipelineArtifactKind): Promise<PipelineArtifact | null>;
+    deleteByScene(collaborationSceneId: string): Promise<void>;
+}
+type DbModel = {
+    select(...fields: string[]): {
+        where(condition: Record<string, unknown>): Promise<Record<string, unknown>[]>;
+    };
+    create(data: Record<string, unknown>): Promise<unknown>;
+    delete?(): {
+        where(condition: Record<string, unknown>): Promise<unknown>;
+    };
+};
+export declare class MemoryCollaborationArtifactRepository implements CollaborationArtifactRepository {
+    private byCell;
+    submit(input: SubmitArtifactInput): Promise<PipelineArtifact>;
+    listByRun(collaborationSceneId: string, runId: string, kinds?: PipelineArtifactKind[]): Promise<PipelineArtifact[]>;
+    latest(collaborationSceneId: string, runId: string, kind: PipelineArtifactKind): Promise<PipelineArtifact | null>;
+    deleteByScene(collaborationSceneId: string): Promise<void>;
+}
+export declare class DatabaseCollaborationArtifactRepository implements CollaborationArtifactRepository {
+    private readonly model;
+    constructor(model: DbModel);
+    submit(input: SubmitArtifactInput): Promise<PipelineArtifact>;
+    listByRun(collaborationSceneId: string, runId: string, kinds?: PipelineArtifactKind[]): Promise<PipelineArtifact[]>;
+    latest(collaborationSceneId: string, runId: string, kind: PipelineArtifactKind): Promise<PipelineArtifact | null>;
+    deleteByScene(collaborationSceneId: string): Promise<void>;
+}
+export declare function getCollaborationArtifactRepository(): CollaborationArtifactRepository;
+export declare function setCollaborationArtifactRepository(repo: CollaborationArtifactRepository | null): void;
+export declare function createCollaborationArtifactRepository(model?: DbModel): CollaborationArtifactRepository;
+export {};
+//# sourceMappingURL=collaboration-artifact-repository.d.ts.map

package/lib/collaboration/collaboration-artifact-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collaboration-artifact-repository.d.ts","sourceRoot":"","sources":["../../src/collaboration/collaboration-artifact-repository.ts"],"names":[],"mappings":"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"}

package/lib/collaboration/collaboration-artifact-repository.js

@@ -0,0 +1,102 @@
+/**
+ * CollaborationArtifactRepository — pipeline 阶段产物持久化（ADR 0024 D4）。
+ *
+ * Artifact 是跨角色数据的唯一通道；Reviewer 记忆切片只读取白名单 kind。
+ */
+import { randomUUID } from 'node:crypto';
+function rowToArtifact(row) {
+    let payload = {};
+    try {
+        payload = row.payload ? JSON.parse(row.payload) : {};
+    }
+    catch {
+        payload = { _raw: row.payload };
+    }
+    return {
+        id: row.id,
+        collaborationSceneId: row.collaboration_scene_id,
+        runId: row.run_id,
+        stage: row.stage,
+        kind: row.kind,
+        payload,
+        createdByEndpoint: row.created_by_endpoint || undefined,
+        createdAt: row.created_at,
+    };
+}
+function buildRow(input) {
+    return {
+        id: randomUUID(),
+        collaboration_scene_id: input.collaborationSceneId,
+        run_id: input.runId,
+        stage: input.stage,
+        kind: input.kind,
+        payload: JSON.stringify(input.payload ?? {}),
+        created_by_endpoint: input.createdByEndpoint ?? '',
+        created_at: Date.now(),
+    };
+}
+function applyFilter(rows, runId, kinds) {
+    return rows
+        .filter((a) => a.runId === runId && (!kinds?.length || kinds.includes(a.kind)))
+        .sort((a, b) => a.createdAt - b.createdAt);
+}
+export class MemoryCollaborationArtifactRepository {
+    byCell = new Map();
+    async submit(input) {
+        const artifact = rowToArtifact(buildRow(input));
+        const list = this.byCell.get(input.collaborationSceneId) ?? [];
+        list.push(artifact);
+        this.byCell.set(input.collaborationSceneId, list);
+        return artifact;
+    }
+    async listByRun(collaborationSceneId, runId, kinds) {
+        return applyFilter(this.byCell.get(collaborationSceneId) ?? [], runId, kinds);
+    }
+    async latest(collaborationSceneId, runId, kind) {
+        const list = applyFilter(this.byCell.get(collaborationSceneId) ?? [], runId, [kind]);
+        return list.length ? list[list.length - 1] : null;
+    }
+    async deleteByScene(collaborationSceneId) {
+        this.byCell.delete(collaborationSceneId);
+    }
+}
+export class DatabaseCollaborationArtifactRepository {
+    model;
+    constructor(model) {
+        this.model = model;
+    }
+    async submit(input) {
+        const row = buildRow(input);
+        await this.model.create({ ...row });
+        return rowToArtifact(row);
+    }
+    async listByRun(collaborationSceneId, runId, kinds) {
+        const rows = await this.model.select().where({ collaboration_scene_id: collaborationSceneId, run_id: runId });
+        const artifacts = rows.map((r) => rowToArtifact(r));
+        return applyFilter(artifacts, runId, kinds);
+    }
+    async latest(collaborationSceneId, runId, kind) {
+        const list = await this.listByRun(collaborationSceneId, runId, [kind]);
+        return list.length ? list[list.length - 1] : null;
+    }
+    async deleteByScene(collaborationSceneId) {
+        if (!this.model.delete)
+            return;
+        await this.model.delete().where({ collaboration_scene_id: collaborationSceneId });
+    }
+}
+let globalArtifactRepo = null;
+export function getCollaborationArtifactRepository() {
+    if (!globalArtifactRepo)
+        globalArtifactRepo = new MemoryCollaborationArtifactRepository();
+    return globalArtifactRepo;
+}
+export function setCollaborationArtifactRepository(repo) {
+    globalArtifactRepo = repo;
+}
+export function createCollaborationArtifactRepository(model) {
+    if (model)
+        return new DatabaseCollaborationArtifactRepository(model);
+    return new MemoryCollaborationArtifactRepository();
+}
+//# sourceMappingURL=collaboration-artifact-repository.js.map

package/lib/collaboration/collaboration-artifact-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collaboration-artifact-repository.js","sourceRoot":"","sources":["../../src/collaboration/collaboration-artifact-repository.ts"],"names":[],"mappings":"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"}

package/lib/collaboration/collaboration-commands.d.ts

@@ -0,0 +1,38 @@
+/**
+ * /collab 协作群管理指令（仅 master；ADR 0023 Cell 注册 SSOT）。
+ */
+import { type Message } from '@zhin.js/core';
+export interface BindableEndpointRef {
+    adapter: string;
+    id: string;
+    online: boolean;
+}
+export declare function defaultCellId(adapter: string, sceneId: string): string;
+export declare function resolveSceneFromMessage(message: Message): {
+    ok: true;
+    adapter: string;
+    sceneId: string;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function handleCollabStatus(message: Message): Promise<string>;
+export declare function handleCollabBindPrompt(message: Message, adapterRef?: string, endpointRef?: string, pipelineRoleRaw?: string, primaryArg?: string): Promise<string>;
+export declare function handleCollabBind(message: Message, endpointRef: string, pipelineRoleRaw: string, primaryArg?: string, memberAdapter?: string): Promise<string>;
+export declare function handleCollabUnbind(message: Message, endpointRef: string): Promise<string>;
+export declare function handleCollabReset(message: Message, force?: boolean): Promise<string>;
+/**
+ * /collab init @Planner — 启动 init 向导。
+ * 被 @ 的 Bot 成为 Planner，开始程序化逐步提问。
+ */
+export declare function handleCollabInitWizard(message: Message, plannerAtId: string): Promise<string>;
+/**
+ * /collab inited — 结束向导，Planner 汇聚观测并激活 Cell。
+ */
+export declare function handleCollabInited(message: Message, plannerPrimary?: string): Promise<string>;
+/**
+ * /collab init-cancel — 取消进行中的 init 向导。
+ */
+export declare function handleCollabInitCancel(message: Message): Promise<string>;
+export declare function collabCommandUsage(): string;
+//# sourceMappingURL=collaboration-commands.d.ts.map

package/lib/collaboration/collaboration-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collaboration-commands.d.ts","sourceRoot":"","sources":["../../src/collaboration/collaboration-commands.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAA8B,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AA8BzE,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;CACjB;AAkMD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGtE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GACpD;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAU/B;AA+DD,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAe1E;AAGD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,OAAO,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,EACpB,eAAe,CAAC,EAAE,MAAM,EACxB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CA6EjB;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,UAAU,CAAC,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC,CAoCjB;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB/F;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,UAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAuBvF;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CA8BjB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,OAAO,EAChB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC,CA0CjB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,MAAM,CAAC,CAajB;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAW3C"}