@zhin.js/agent 0.3.1 → 1.0.2

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":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA8BzC,SAAS,aAAa,CAAC,GAAkC;IACvD,IAAI,OAAO,GAA4B,EAAE,CAAC;IAC1C,IAAI,CAAC;QACH,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAA6B,CAAC,CAAC,CAAC,EAAE,CAAC;IACpF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;IAClC,CAAC;IACD,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,oBAAoB,EAAE,GAAG,CAAC,sBAAsB;QAChD,KAAK,EAAE,GAAG,CAAC,MAAM;QACjB,KAAK,EAAE,GAAG,CAAC,KAAsB;QACjC,IAAI,EAAE,GAAG,CAAC,IAA4B;QACtC,OAAO;QACP,iBAAiB,EAAE,GAAG,CAAC,mBAAmB,IAAI,SAAS;QACvD,SAAS,EAAE,GAAG,CAAC,UAAU;KAC1B,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAA0B;IAC1C,OAAO;QACL,EAAE,EAAE,UAAU,EAAE;QAChB,sBAAsB,EAAE,KAAK,CAAC,oBAAoB;QAClD,MAAM,EAAE,KAAK,CAAC,KAAK;QACnB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;QAC5C,mBAAmB,EAAE,KAAK,CAAC,iBAAiB,IAAI,EAAE;QAClD,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;KACvB,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAClB,IAAwB,EACxB,KAAa,EACb,KAA8B;IAE9B,OAAO,IAAI;SACR,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;SAC9E,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,OAAO,qCAAqC;IACxC,MAAM,GAAG,IAAI,GAAG,EAA8B,CAAC;IAEvD,KAAK,CAAC,MAAM,CAAC,KAA0B;QACrC,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,oBAAoB,CAAC,IAAI,EAAE,CAAC;QAC/D,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;QAClD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,oBAA4B,EAAE,KAAa,EAAE,KAA8B;QACzF,OAAO,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAChF,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,oBAA4B,EAAE,KAAa,EAAE,IAA0B;QAClF,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QACrF,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,oBAA4B;QAC9C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,OAAO,uCAAuC;IACrB;IAA7B,YAA6B,KAAc;QAAd,UAAK,GAAL,KAAK,CAAS;IAAG,CAAC;IAE/C,KAAK,CAAC,MAAM,CAAC,KAA0B;QACrC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC5B,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;QACpC,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,oBAA4B,EAAE,KAAa,EAAE,KAA8B;QACzF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9G,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAA6C,CAAC,CAAC,CAAC;QAChG,OAAO,WAAW,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,oBAA4B,EAAE,KAAa,EAAE,IAA0B;QAClF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,oBAAoB,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,oBAA4B;QAC9C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,OAAO;QAC/B,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,CAAC,CAAC;IACpF,CAAC;CACF;AAED,IAAI,kBAAkB,GAA2C,IAAI,CAAC;AAEtE,MAAM,UAAU,kCAAkC;IAChD,IAAI,CAAC,kBAAkB;QAAE,kBAAkB,GAAG,IAAI,qCAAqC,EAAE,CAAC;IAC1F,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,IAA4C;IAC7F,kBAAkB,GAAG,IAAI,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,qCAAqC,CAAC,KAAe;IACnE,IAAI,KAAK;QAAE,OAAO,IAAI,uCAAuC,CAAC,KAAK,CAAC,CAAC;IACrE,OAAO,IAAI,qCAAqC,EAAE,CAAC;AACrD,CAAC"}

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"}

package/lib/collaboration/collaboration-commands.js

@@ -0,0 +1,504 @@
+/**
+ * /collab 协作群管理指令（仅 master；ADR 0023 Cell 注册 SSOT）。
+ */
+import { Adapter, getHostRootPlugin } from '@zhin.js/core';
+import { getCollaborationSceneService } from './scene-service.js';
+import { findCellForMessage, memberTransportAdapter, resolvePeerEndpointInCell, } from './collaboration-config.js';
+import { rebootstrapEndpointRuntimes } from './bootstrap-agent-runtimes.js';
+import { getPipelineService } from '../aop/pipeline/pipeline-service.js';
+import { isPipelineRole, PIPELINE_ROLES, } from './types.js';
+import { getSceneIdentityService } from './scene-identity-service.js';
+import { startInitWizard, aggregateAndActivate, cancelInitWizard } from './init-wizard-service.js';
+import { buildRegisteredEndpointMap } from './init-observe-hook.js';
+import { checkCollabAdminGate } from './collab-admin-gate.js';
+import { getOrchestrationService } from '../orchestrator/orchestration-service.js';
+const PIPELINE_ROLE_LABELS_ZH = {
+    planner: '规划员',
+    researcher: '调研员',
+    evaluator: '评估员',
+    executor: '执行员',
+    reviewer: '评审员',
+};
+function isKnownAdapter(adapterName) {
+    const root = getHostRootPlugin();
+    if (!root || !adapterName)
+        return false;
+    const adapter = root.inject(adapterName);
+    return adapter instanceof Adapter;
+}
+function listAdapterEndpoints(adapterName) {
+    const root = getHostRootPlugin();
+    if (!root)
+        return [];
+    const adapter = root.inject(adapterName);
+    if (!(adapter instanceof Adapter))
+        return [];
+    return [...adapter.endpoints.entries()].map(([id, endpoint]) => ({
+        id,
+        online: !!endpoint.$connected,
+    }));
+}
+function memberBindKey(cell, member) {
+    return `${memberTransportAdapter(cell, member)}:${member.endpointId}`;
+}
+function listAllBindableEndpoints(cell) {
+    const root = getHostRootPlugin();
+    if (!root)
+        return [];
+    const bound = new Set(cell.members.map((m) => memberBindKey(cell, m)));
+    const out = [];
+    for (const adapterName of root.adapters) {
+        const name = String(adapterName);
+        for (const ep of listAdapterEndpoints(name)) {
+            const key = `${name}:${ep.id}`;
+            if (bound.has(key))
+                continue;
+            out.push({ adapter: name, id: ep.id, online: ep.online });
+        }
+    }
+    return out;
+}
+function listBindableEndpointsForAdapter(adapterName, cell) {
+    return listAllBindableEndpoints(cell).filter((ep) => ep.adapter === adapterName);
+}
+function resolveEndpointAcrossAdapters(endpointId, preferAdapter) {
+    const root = getHostRootPlugin();
+    if (!root)
+        return undefined;
+    const matches = [];
+    for (const adapterName of root.adapters) {
+        const name = String(adapterName);
+        for (const ep of listAdapterEndpoints(name)) {
+            if (ep.id === endpointId) {
+                matches.push({ adapter: name, id: ep.id, online: ep.online });
+            }
+        }
+    }
+    if (matches.length === 0)
+        return undefined;
+    if (preferAdapter) {
+        const preferred = matches.find((m) => m.adapter === preferAdapter);
+        if (preferred)
+            return preferred;
+    }
+    return matches[0];
+}
+function listProvisionableAdapterNames() {
+    const root = getHostRootPlugin();
+    if (!root)
+        return [];
+    return root.adapters
+        .map((name) => String(name))
+        .filter((name) => listAdapterEndpoints(name).length > 0);
+}
+function formatEndpointRefLabel(ref) {
+    return `${ref.adapter}/${ref.id}`;
+}
+function formatBindCommand(ref, role) {
+    const roleSuffix = role ? ` ${role}` : ' <pipelineRole>';
+    return `/collab bind ${ref.adapter} ${ref.id}${roleSuffix}`;
+}
+function availablePipelineRoles(cell) {
+    const taken = new Set(cell.members.map((m) => m.pipelineRole).filter((r) => !!r));
+    return PIPELINE_ROLES.filter((r) => !taken.has(r));
+}
+function formatAdapterBindPrompt(cell) {
+    const adapters = listProvisionableAdapterNames();
+    if (adapters.length === 0) {
+        return '当前没有可绑定的适配器 Endpoint。可用 /endpoints 查看。';
+    }
+    return [
+        '可选适配器：',
+        ...adapters.map((a) => `  • ${a} — /collab bind ${a}`),
+    ].join('\n');
+}
+function formatEndpointBindPrompt(cell, role, adapterFilter) {
+    const endpoints = adapterFilter
+        ? listBindableEndpointsForAdapter(adapterFilter, cell)
+        : listAllBindableEndpoints(cell);
+    if (endpoints.length === 0) {
+        if (adapterFilter) {
+            return `适配器 ${adapterFilter} 下没有可绑定的 Endpoint（可能已全部绑定）。`;
+        }
+        return '当前没有可绑定的 Endpoint（已全部绑定或系统无 Bot）。可用 /endpoints 查看。';
+    }
+    return [
+        adapterFilter ? `可选 Endpoint（${adapterFilter}）：` : '可选 Endpoint（adapter/endpoint）：',
+        ...endpoints.map((ep) => {
+            const status = ep.online ? '在线' : '离线';
+            return `  • ${formatEndpointRefLabel(ep)} (${status}) — ${formatBindCommand(ep, role)}`;
+        }),
+    ].join('\n');
+}
+function formatRoleBindPrompt(cell, endpointRef) {
+    const roles = availablePipelineRoles(cell);
+    if (roles.length === 0) {
+        return '所有 pipeline 角色已占用。请先用 /collab unbind 移除成员。';
+    }
+    return [
+        '可选 pipeline 角色：',
+        ...roles.map((r) => {
+            const cmd = endpointRef
+                ? formatBindCommand(endpointRef, r)
+                : `/collab bind <adapter> <endpoint> ${r}`;
+            return `  • ${r} (${PIPELINE_ROLE_LABELS_ZH[r]}) — ${cmd}`;
+        }),
+    ].join('\n');
+}
+function formatMemberEndpointLabel(cell, member) {
+    const adapter = memberTransportAdapter(cell, member);
+    return adapter === cell.adapter ? member.endpointId : `${adapter}/${member.endpointId}`;
+}
+function parseBindArgs(cell, adapterArg, endpointArg, roleArg) {
+    let adapter = adapterArg.trim();
+    let endpoint = endpointArg.trim();
+    let role = roleArg.trim();
+    if (adapter && !endpoint && !role && isPipelineRole(adapter)) {
+        role = adapter;
+        adapter = '';
+    }
+    if (adapter && !endpoint && !role && isKnownAdapter(adapter)) {
+        return { adapter, endpoint: '', role: '' };
+    }
+    if (adapter && endpoint && !role && isPipelineRole(endpoint)) {
+        role = endpoint;
+        endpoint = adapter;
+        adapter = '';
+    }
+    if (adapter && !endpoint && !role && !isKnownAdapter(adapter)) {
+        endpoint = adapter;
+        adapter = '';
+    }
+    if (adapter && endpoint && !role && isKnownAdapter(adapter)) {
+        return { adapter, endpoint, role: '' };
+    }
+    if (endpoint && !adapter) {
+        const resolved = resolveEndpointAcrossAdapters(endpoint, cell.adapter);
+        adapter = resolved?.adapter ?? cell.adapter;
+    }
+    return { adapter, endpoint, role };
+}
+export function defaultCellId(adapter, sceneId) {
+    const slug = `${adapter}-${sceneId}`.replace(/[^a-zA-Z0-9_-]+/g, '-').replace(/-+/g, '-').slice(0, 80);
+    return slug || `${adapter}-cell`;
+}
+export function resolveSceneFromMessage(message) {
+    const scope = message.$channel?.type;
+    if (scope !== 'group' && scope !== 'channel') {
+        return { ok: false, error: '仅支持群/频道内使用 /collab 指令。' };
+    }
+    const sceneId = message.$channel?.id;
+    if (!sceneId)
+        return { ok: false, error: '无法解析当前群号。' };
+    const adapter = String(message.$adapter ?? '');
+    if (!adapter)
+        return { ok: false, error: '无法解析当前适配器。' };
+    return { ok: true, adapter, sceneId: String(sceneId) };
+}
+function formatMemberLine(cell) {
+    return cell.members
+        .map((m) => {
+        const role = m.pipelineRole ?? m.primary;
+        return `  • ${formatMemberEndpointLabel(cell, m)} (${role})`;
+    })
+        .join('\n');
+}
+async function formatStatus(cell) {
+    const lines = [
+        `协作群 ${cell.id}`,
+        `  adapter: ${cell.adapter}`,
+        `  scene: ${cell.sceneId}`,
+        `  goal: ${cell.goal?.trim() || '(未设置)'}`,
+        `  members (${cell.members.length}):`,
+        formatMemberLine(cell) || '  (无成员 — 使用 /collab bind)',
+    ];
+    const runId = cell.missionRunId?.trim();
+    if (runId) {
+        lines.push(`  kernel run: ${runId}`);
+        const orch = getOrchestrationService();
+        if (orch) {
+            const snapshot = await orch.getStatus(runId);
+            if (snapshot) {
+                const active = snapshot.tasks.filter((t) => ['pending', 'assigned', 'running', 'waiting_result'].includes(t.status)).length;
+                lines.push(`  run status: ${snapshot.run.status}; tasks: ${snapshot.tasks.length} (${active} active)`);
+            }
+        }
+    }
+    else {
+        lines.push('  kernel run: (none — Planner 使用 orchestration_start 或群内 @Planner 启动)');
+    }
+    const pipeline = cell.pipelineState;
+    if (pipeline?.activeDelegations?.length) {
+        lines.push(`  legacy delegations: ${pipeline.activeDelegations.length} (deprecated — 见 kernel run / orchestration_status)`);
+    }
+    if (pipeline && !runId) {
+        lines.push(`  legacy pipeline: ${pipeline.stage} (run ${pipeline.runId.slice(0, 8)}…) — ADR 0026 起请用 kernel`);
+    }
+    return lines.join('\n');
+}
+function collabAdminBlocked(message) {
+    const root = getHostRootPlugin();
+    if (!root)
+        return true;
+    const gate = checkCollabAdminGate(message, String(message.$endpoint), root);
+    return !gate.allowed;
+}
+export async function handleCollabStatus(message) {
+    const scene = resolveSceneFromMessage(message);
+    if (!scene.ok)
+        return `ℹ️ ${scene.error}`;
+    if (collabAdminBlocked(message))
+        return '';
+    const svc = getCollaborationSceneService();
+    await svc.reloadFromRepository();
+    const cell = findCellForMessage(svc.listScenes(), scene.adapter, scene.sceneId);
+    if (!cell) {
+        return [
+            '当前群尚未注册为协作 Cell。',
+            '用法：/collab init [协作目标]',
+            '      /collab bind <endpoint> <pipelineRole>',
+        ].join('\n');
+    }
+    return await formatStatus(cell);
+}
+export async function handleCollabBindPrompt(message, adapterRef, endpointRef, pipelineRoleRaw, primaryArg) {
+    const scene = resolveSceneFromMessage(message);
+    if (!scene.ok)
+        return `⚠️ ${scene.error}`;
+    if (collabAdminBlocked(message))
+        return '';
+    const svc = getCollaborationSceneService();
+    await svc.reloadFromRepository();
+    const cell = findCellForMessage(svc.listScenes(), scene.adapter, scene.sceneId);
+    if (!cell)
+        return '⚠️ 当前群未注册协作 Cell。请先 /collab init';
+    const { adapter, endpoint, role } = parseBindArgs(cell, adapterRef ?? '', endpointRef ?? '', pipelineRoleRaw ?? '');
+    if (!adapter && !endpoint && !role) {
+        return [
+            '请指定 adapter、Endpoint 与 pipeline 角色：',
+            '',
+            formatAdapterBindPrompt(cell),
+            '',
+            formatEndpointBindPrompt(cell),
+            '',
+            formatRoleBindPrompt(cell),
+        ].join('\n');
+    }
+    if (adapter && isKnownAdapter(adapter) && !endpoint && !role) {
+        return [
+            `已选适配器：${adapter}`,
+            '请选择 Endpoint：',
+            '',
+            formatEndpointBindPrompt(cell, undefined, adapter),
+            '',
+            '也可换适配器：',
+            formatAdapterBindPrompt(cell),
+        ].join('\n');
+    }
+    if (endpoint && !role) {
+        const endpointRefResolved = resolveEndpointAcrossAdapters(endpoint, adapter || cell.adapter);
+        const label = endpointRefResolved ? formatEndpointRefLabel(endpointRefResolved) : endpoint;
+        return [
+            `已选 Endpoint：${label}`,
+            '请选择 pipeline 角色：',
+            '',
+            formatRoleBindPrompt(cell, endpointRefResolved),
+        ].join('\n');
+    }
+    if (!endpoint && role) {
+        if (!isPipelineRole(role)) {
+            return `⚠️ pipelineRole 须为：${PIPELINE_ROLES.join(' | ')}`;
+        }
+        const roleLabel = PIPELINE_ROLE_LABELS_ZH[role];
+        const adapterFilter = adapter && isKnownAdapter(adapter) ? adapter : undefined;
+        return [
+            `已选角色：${role} (${roleLabel})`,
+            '请选择 Endpoint：',
+            '',
+            formatEndpointBindPrompt(cell, role, adapterFilter),
+        ].join('\n');
+    }
+    if (!endpoint) {
+        return formatEndpointBindPrompt(cell, isPipelineRole(role) ? role : undefined, adapter || undefined);
+    }
+    return handleCollabBind(message, endpoint, role, primaryArg, adapter && isKnownAdapter(adapter) ? adapter : undefined);
+}
+export async function handleCollabBind(message, endpointRef, pipelineRoleRaw, primaryArg, memberAdapter) {
+    const scene = resolveSceneFromMessage(message);
+    if (!scene.ok)
+        return `⚠️ ${scene.error}`;
+    if (collabAdminBlocked(message))
+        return '';
+    if (!isPipelineRole(pipelineRoleRaw)) {
+        return `⚠️ pipelineRole 须为：${PIPELINE_ROLES.join(' | ')}`;
+    }
+    const svc = getCollaborationSceneService();
+    await svc.reloadFromRepository();
+    let cell = findCellForMessage(svc.listScenes(), scene.adapter, scene.sceneId);
+    if (!cell) {
+        return '⚠️ 当前群未注册协作 Cell。请先 /collab init';
+    }
+    const ref = endpointRef.trim();
+    const endpointId = resolvePeerEndpointInCell(cell, ref) ?? ref;
+    const primary = primaryArg?.trim() || pipelineRoleRaw;
+    const transportAdapter = memberAdapter?.trim()
+        || resolveEndpointAcrossAdapters(endpointId, cell.adapter)?.adapter
+        || cell.adapter;
+    const added = await svc.addMember(cell.id, {
+        endpointId,
+        adapter: transportAdapter !== cell.adapter ? transportAdapter : undefined,
+        primary,
+        pipelineRole: pipelineRoleRaw,
+    });
+    if (!added.ok)
+        return `⚠️ 绑定失败：${added.error ?? 'unknown'}`;
+    cell = (await svc.getSceneFresh(cell.id)) ?? cell;
+    await rebootstrapEndpointRuntimes();
+    const label = transportAdapter === cell.adapter
+        ? endpointId
+        : `${transportAdapter}/${endpointId}`;
+    return `✅ 已绑定 ${label} → ${pipelineRoleRaw}\n${await formatStatus(cell)}`;
+}
+export async function handleCollabUnbind(message, endpointRef) {
+    const scene = resolveSceneFromMessage(message);
+    if (!scene.ok)
+        return `⚠️ ${scene.error}`;
+    if (collabAdminBlocked(message))
+        return '';
+    const svc = getCollaborationSceneService();
+    await svc.reloadFromRepository();
+    const cell = findCellForMessage(svc.listScenes(), scene.adapter, scene.sceneId);
+    if (!cell)
+        return '⚠️ 当前群未注册协作 Cell。';
+    const ref = endpointRef.trim();
+    const endpointId = resolvePeerEndpointInCell(cell, ref) ?? ref;
+    const ok = await svc.removeMember(cell.id, endpointId);
+    if (!ok)
+        return `⚠️ 未找到成员 ${endpointId}`;
+    const fresh = (await svc.getSceneFresh(cell.id)) ?? cell;
+    await rebootstrapEndpointRuntimes();
+    return `✅ 已移除 ${endpointId}\n${await formatStatus(fresh)}`;
+}
+export async function handleCollabReset(message, force = true) {
+    const scene = resolveSceneFromMessage(message);
+    if (!scene.ok)
+        return `⚠️ ${scene.error}`;
+    if (collabAdminBlocked(message))
+        return '';
+    const svc = getCollaborationSceneService();
+    await svc.reloadFromRepository();
+    const cell = findCellForMessage(svc.listScenes(), scene.adapter, scene.sceneId);
+    if (!cell)
+        return '⚠️ 当前群未注册协作 Cell。请先 /collab init';
+    if (!cell.pipelineState) {
+        return `ℹ️ 协作群已注册，无 legacy pipeline 状态。\n${await formatStatus(cell)}`;
+    }
+    const result = await getPipelineService().resetRun(cell.id, { force });
+    if (!result.ok)
+        return `⚠️ 重置失败：${result.error}`;
+    const fresh = (await svc.getSceneFresh(cell.id)) ?? cell;
+    return (`✅ 已重置 legacy pipeline（run ${result.previousRunId?.slice(0, 8) ?? '?'} → ${result.state.runId.slice(0, 8)}）\n`
+        + `新编排请用 orchestration_start / orchestration_status。\n`
+        + `${await formatStatus(fresh)}`);
+}
+/**
+ * /collab init @Planner — 启动 init 向导。
+ * 被 @ 的 Bot 成为 Planner，开始程序化逐步提问。
+ */
+export async function handleCollabInitWizard(message, plannerAtId) {
+    const scene = resolveSceneFromMessage(message);
+    if (!scene.ok)
+        return `⚠️ ${scene.error}`;
+    const root = getHostRootPlugin();
+    if (!root)
+        return '⚠️ 系统未就绪。';
+    const gate = checkCollabAdminGate(message, String(message.$endpoint), root);
+    if (!gate.allowed)
+        return '';
+    const endpointId = String(message.$endpoint);
+    const registeredMap = buildRegisteredEndpointMap(root);
+    const plannerRef = registeredMap.get(plannerAtId);
+    if (!plannerRef) {
+        return `⚠️ 被 @ 的 Bot（${plannerAtId}）不是已注册的系统 Endpoint。`;
+    }
+    if (plannerRef.endpointId !== endpointId) {
+        return '';
+    }
+    const result = await startInitWizard({
+        plannerEndpointId: plannerRef.endpointId,
+        plannerAdapter: scene.adapter,
+        plannerSceneId: scene.sceneId,
+    });
+    if (!result.ok)
+        return `⚠️ ${result.error}`;
+    return result.prompt ?? '✅ Init 向导已启动。';
+}
+/**
+ * /collab inited — 结束向导，Planner 汇聚观测并激活 Cell。
+ */
+export async function handleCollabInited(message, plannerPrimary) {
+    const scene = resolveSceneFromMessage(message);
+    if (!scene.ok)
+        return `⚠️ ${scene.error}`;
+    const root = getHostRootPlugin();
+    if (!root)
+        return '⚠️ 系统未就绪。';
+    const gate = checkCollabAdminGate(message, String(message.$endpoint), root);
+    if (!gate.allowed)
+        return '';
+    const sceneSvc = getSceneIdentityService();
+    const session = await sceneSvc.getActiveInitSession(scene.adapter, scene.sceneId);
+    if (!session) {
+        return '⚠️ 当前群没有进行中的 init 向导。请先 /collab init @Planner';
+    }
+    const endpointId = String(message.$endpoint);
+    if (session.plannerEndpointId !== endpointId) {
+        return '';
+    }
+    const registeredMap = buildRegisteredEndpointMap(root);
+    const result = await aggregateAndActivate(session, registeredMap, plannerPrimary || 'planner');
+    if (!result.ok) {
+        return '⚠️ 汇聚失败。';
+    }
+    const lines = [
+        `✅ 协作群已激活（${result.memberCount} 个成员，${result.sceneCount} 个场景别名）`,
+    ];
+    if (result.warnings.length > 0) {
+        lines.push(...result.warnings.map((w) => `⚠️ ${w}`));
+    }
+    if (result.scene) {
+        lines.push(await formatStatus(result.scene));
+    }
+    return lines.join('\n');
+}
+/**
+ * /collab init-cancel — 取消进行中的 init 向导。
+ */
+export async function handleCollabInitCancel(message) {
+    const scene = resolveSceneFromMessage(message);
+    if (!scene.ok)
+        return `⚠️ ${scene.error}`;
+    const root = getHostRootPlugin();
+    if (root) {
+        const gate = checkCollabAdminGate(message, String(message.$endpoint), root);
+        if (!gate.allowed)
+            return '';
+    }
+    const result = await cancelInitWizard(scene.adapter, scene.sceneId);
+    if (!result.ok)
+        return `ℹ️ ${result.error}`;
+    return '✅ Init 向导已取消。';
+}
+export function collabCommandUsage() {
+    return [
+        '协作群管理（仅 master）：',
+        '  /collab — 查看状态',
+        '  /collab init @Planner — 启动 init 向导（收集阶段：各 bot stash 观测）',
+        '  /collab inited @Planner — 汇聚 stash，一次性创建协作 Cell',
+        '  /collab init-cancel — 取消进行中的 init 向导',
+        '  /collab bind [adapter] [endpoint] [pipelineRole] [primary] — 添加 Bot（缺参时列出可选项）',
+        '  /collab unbind <endpoint> — 移除 Bot',
+        '  /collab reset — 重置 pipeline（保留 Cell 绑定）',
+    ].join('\n');
+}
+//# sourceMappingURL=collaboration-commands.js.map