@zhin.js/agent 0.3.1 → 1.0.2

package/lib/collaboration/collaboration-delegation.js

@@ -0,0 +1,194 @@
+/**
+ * Pipeline 协作委派识别与 handback 摘要（传输层 harness）。
+ */
+import { extractEmbeddedAiOutboundJson } from '@zhin.js/core';
+import { findActiveDelegation } from './delegation-state.js';
+export function messageTextContent(message) {
+    const parts = [];
+    for (const seg of message.$content) {
+        if (seg.type === 'text' && seg.data?.text) {
+            parts.push(String(seg.data.text).trim());
+        }
+    }
+    return parts.join(' ').trim();
+}
+export function resolvePlannerEndpointId(cell) {
+    return cell.members.find((m) => m.pipelineRole === 'planner')?.endpointId;
+}
+/** 模型把 cell_* 工具返回值原样贴到群里的 JSON blob。 */
+export function isCellToolResultJson(text) {
+    const t = text.trim();
+    if (!t.startsWith('{') || !t.endsWith('}'))
+        return false;
+    try {
+        const o = JSON.parse(t);
+        if (o.ok !== true)
+            return false;
+        if (typeof o.collaborationSceneId === 'string')
+            return true;
+        if (o.pipelineState != null)
+            return true;
+        if (typeof o.artifactId === 'string')
+            return true;
+        if (Array.isArray(o.artifacts))
+            return true;
+        if (Array.isArray(o.runs))
+            return true;
+        if (o.reviewerSlice != null)
+            return true;
+        if (typeof o.stage === 'string' && Array.isArray(o.allowedNextStages))
+            return true;
+        if (typeof o.kind === 'string'
+            && typeof o.runId === 'string'
+            && ['report', 'blueprint', 'deliverable', 'review', 'citations'].includes(o.kind)) {
+            return true;
+        }
+        if (typeof o.action === 'string'
+            && ['create', 'reset', 'update', 'activate', 'list'].includes(o.action)) {
+            return true;
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+/** 从混合正文中剥离内嵌的 legacy cell_* 工具 JSON（保留其余可读文本）。 */
+export function removeEmbeddedCellToolJsonFromText(text) {
+    const result = text.replace(/```(?:json)?\s*([\s\S]*?)```/gi, (full, inner) => {
+        if (isCellToolResultJson(String(inner).trim()))
+            return ' ';
+        return full;
+    });
+    let out = '';
+    let i = 0;
+    while (i < result.length) {
+        const start = result.indexOf('{', i);
+        if (start === -1) {
+            out += result.slice(i);
+            break;
+        }
+        out += result.slice(i, start);
+        let depth = 0;
+        let end = -1;
+        for (let j = start; j < result.length; j++) {
+            if (result[j] === '{')
+                depth++;
+            else if (result[j] === '}') {
+                depth--;
+                if (depth === 0) {
+                    end = j;
+                    break;
+                }
+            }
+        }
+        if (end === -1) {
+            out += result.slice(start);
+            break;
+        }
+        const candidate = result.slice(start, end + 1);
+        if (isCellToolResultJson(candidate.trim())) {
+            i = end + 1;
+        }
+        else {
+            out += candidate;
+            i = end + 1;
+        }
+    }
+    return out.replace(/\s{2,}/g, ' ').trim();
+}
+/** 从被委派方出站正文提取公开回复摘要（剥离 JSON handback / markdown 围栏 / 工具 JSON）。 */
+export function summarizeDelegateeReply(text) {
+    let t = removeEmbeddedCellToolJsonFromText(text.trim());
+    if (!t)
+        return '已完成。';
+    if (isCellToolResultJson(t))
+        return '已完成。';
+    t = t.replace(/```(?:json)?\s*[\s\S]*?```/gi, ' ').replace(/\s+/g, ' ').trim();
+    const embedded = extractEmbeddedAiOutboundJson(t);
+    if (embedded?.prose)
+        t = embedded.prose.trim();
+    t = removeEmbeddedCellToolJsonFromText(t);
+    if (isCellToolResultJson(t))
+        return '已完成。';
+    t = t.replace(/(?:已通过公开回复完成|交还给\s*Planner|hand\s*back\s*to\s*planner)[^.!?。！？]*[.!?。！？]?/gi, '').trim();
+    if (!t)
+        return '已完成。';
+    return t;
+}
+/** Kernel / 群协作 handback：须为实质公开内容，不能只有「已完成」。 */
+export function isSubstantiveGroupTaskReply(text) {
+    const t = summarizeDelegateeReply(text).trim();
+    if (!t || t === '已完成。')
+        return false;
+    if (/^已完成[。.!！?？\s✅✓]*$/u.test(t))
+        return false;
+    if (/^已完成/u.test(t) && t.length < 40)
+        return false;
+    return t.length >= 12;
+}
+/** 剥离模型贴到回复里的 cell_* 工具 JSON（勿发到群）。 */
+export function stripCellToolJsonFromOutputElements(elements) {
+    const kept = [];
+    for (const el of elements) {
+        if (el.type !== 'text' || !el.content?.trim()) {
+            kept.push(el);
+            continue;
+        }
+        const trimmed = el.content.trim();
+        if (isCellToolResultJson(trimmed))
+            continue;
+        const cleaned = removeEmbeddedCellToolJsonFromText(el.content);
+        if (!cleaned.trim())
+            continue;
+        kept.push(cleaned === el.content ? el : { ...el, content: cleaned });
+    }
+    return kept;
+}
+/** 被委派方 turn hint：上一棒角色与委派期望（legacy activeDelegations；kernel 路径见 formatPlannerHandbackHint）。 */
+function artifactSubmitInstructions(kinds) {
+    const brief = {
+        report: 'report:{summary,findings[]}',
+        citations: 'citations:{sources:[{title,url,snippet}]}',
+        blueprint: 'blueprint:{decision,steps[]}',
+        deliverable: 'deliverable:{summary,changes[]}',
+        review: 'review:{approved,feedback}',
+    };
+    const kindsLine = kinds.map((k) => brief[k] ?? k).join('; ');
+    return [
+        `Required artifact kinds (legacy): ${kindsLine}`,
+        'Public reply = short summary only; use orchestration_status for kernel tasks.',
+    ];
+}
+export function formatActiveDelegationHint(cell, endpointId) {
+    const delegation = findActiveDelegation(cell, endpointId);
+    if (!delegation)
+        return undefined;
+    const lines = [
+        `[Active delegation] From Planner; mode=${delegation.mode ?? 'pipeline'}.`,
+        `Task: ${delegation.delegateText.trim() || '(see group history)'}`,
+    ];
+    if (delegation.requireArtifact) {
+        const kinds = delegation.artifactKinds ?? [];
+        lines.push(`Required artifacts: ${kinds.join(', ') || '(kinds missing — handback blocked)'}`);
+        if (kinds.length) {
+            lines.push(...artifactSubmitInstructions(kinds));
+        }
+        lines.push('Legacy pipeline artifacts are deprecated; prefer orchestration_status + internal_room handback.');
+    }
+    else {
+        lines.push('No artifact required; brief public summary is enough.');
+    }
+    lines.push('Complete only YOUR part. Hand back via separate JSON {"mentions":["planner"],"text":"已完成。"}');
+    return lines.join('\n');
+}
+/** Planner 收到成员 handback @ 时的 turn 指引。 */
+export function formatPlannerHandbackHint(_cell) {
+    return [
+        '[Kernel handback] A peer task completed (internal_room) or an im_projection handback arrived.',
+        'Check orchestration_status for results; #taskId in group text applies only to im_projection.',
+        'Dispatch the next peer with orchestration_add_task(executor="internal_room", assigned_to="<endpointId>").',
+        'Add project_to_im: true when humans should see an @ in the group.',
+    ].join('\n');
+}
+//# sourceMappingURL=collaboration-delegation.js.map

package/lib/collaboration/collaboration-delegation.js.map

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

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

@@ -0,0 +1,32 @@
+/**
+ * CollaborationDispatch — deep module for peer delegation within a CollaborationScene.
+ * @see docs/adr/0036-internal-room-collaboration.md
+ */
+import { type Message } from '@zhin.js/core';
+import type { OrchestrationTask } from '../orchestrator/orchestration-types.js';
+import type { CollaborationScene } from './types.js';
+export interface DispatchPeerTaskInput {
+    cell: CollaborationScene;
+    fromEndpointId: string;
+    toEndpointId: string;
+    goal: string;
+    handlerProfile?: string;
+    message?: Message;
+    projectToIm?: boolean;
+}
+export interface DispatchPeerTaskResult {
+    runId: string;
+    taskId: string;
+    task: OrchestrationTask;
+    projectionTaskId?: string;
+}
+export declare function assertPeerMember(cell: CollaborationScene, endpointId: string): void;
+export declare function projectInternalRoomTaskToIm(input: {
+    runId: string;
+    taskId: string;
+    message: Message;
+    toEndpointId: string;
+    goal: string;
+}): Promise<string>;
+export declare function dispatchPeerTask(input: DispatchPeerTaskInput): Promise<DispatchPeerTaskResult>;
+//# sourceMappingURL=collaboration-dispatch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collaboration-dispatch.d.ts","sourceRoot":"","sources":["../../src/collaboration/collaboration-dispatch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,KAAK,OAAO,EAAiC,MAAM,eAAe,CAAC;AAE5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAEhF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,kBAAkB,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,iBAAiB,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAInF;AAED,wBAAsB,2BAA2B,CAAC,KAAK,EAAE;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBlB;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAiEpG"}

package/lib/collaboration/collaboration-dispatch.js

@@ -0,0 +1,93 @@
+/**
+ * CollaborationDispatch — deep module for peer delegation within a CollaborationScene.
+ * @see docs/adr/0036-internal-room-collaboration.md
+ */
+import { resolveIMSessionIdFromMessage } from '@zhin.js/core';
+import { getOrchestrationService } from '../orchestrator/orchestration-service.js';
+import { orchestrationSourceFromMessage } from './collaboration-kernel-bridge.js';
+import { findCellMemberByEndpoint } from './collaboration-config.js';
+export function assertPeerMember(cell, endpointId) {
+    if (!findCellMemberByEndpoint(cell, endpointId)) {
+        throw new Error(`endpoint "${endpointId}" is not a member of collaboration scene "${cell.id}"`);
+    }
+}
+export async function projectInternalRoomTaskToIm(input) {
+    const orch = getOrchestrationService();
+    if (!orch)
+        throw new Error('OrchestrationService is not initialized');
+    const delegateText = input.goal.trim() || '请处理上述协作请求。';
+    const projection = await orch.dispatchTask({
+        runId: input.runId,
+        name: `project:${input.toEndpointId}`,
+        description: delegateText,
+        role: 'worker',
+        goal: `#${input.taskId}\n${delegateText}`,
+        executorKind: 'im_projection',
+        assignedTo: input.toEndpointId,
+        context: { parentTaskId: input.taskId },
+        message: input.message,
+        autoStart: true,
+    });
+    return projection.task.id;
+}
+export async function dispatchPeerTask(input) {
+    const orch = getOrchestrationService();
+    if (!orch)
+        throw new Error('OrchestrationService is not initialized');
+    assertPeerMember(input.cell, input.fromEndpointId);
+    assertPeerMember(input.cell, input.toEndpointId);
+    const delegateText = input.goal.trim() || '请处理上述协作请求。';
+    const message = input.message;
+    const sessionKey = message ? resolveIMSessionIdFromMessage(message) : `collab:${input.cell.id}`;
+    const run = await orch.findOrCreateRun({
+        sessionKey,
+        title: delegateText.slice(0, 80) || 'Collaboration peer delegation',
+        source: message
+            ? orchestrationSourceFromMessage(message, input.cell.id)
+            : {
+                kind: 'im_scene',
+                collaborationSceneId: input.cell.id,
+                scene: {
+                    platform: input.cell.adapter,
+                    endpointId: input.fromEndpointId,
+                    sceneId: input.cell.sceneId,
+                    kind: 'group',
+                },
+            },
+    });
+    const dispatched = await orch.dispatchTask({
+        runId: run.id,
+        name: `@${input.toEndpointId}`,
+        description: delegateText,
+        role: 'worker',
+        goal: delegateText,
+        executorKind: 'internal_room',
+        assignedTo: input.toEndpointId,
+        context: {
+            collaborationSceneId: input.cell.id,
+            fromEndpointId: input.fromEndpointId,
+            handlerProfile: input.handlerProfile,
+            projectToIm: input.projectToIm === true,
+        },
+        message,
+        autoStart: false,
+    });
+    let projectionTaskId;
+    if (input.projectToIm && message) {
+        projectionTaskId = await projectInternalRoomTaskToIm({
+            runId: run.id,
+            taskId: dispatched.task.id,
+            message,
+            toEndpointId: input.toEndpointId,
+            goal: delegateText,
+        });
+    }
+    const task = await orch.runTask(dispatched.task.id, message);
+    return {
+        runId: run.id,
+        taskId: dispatched.task.id,
+        task,
+        projectionTaskId,
+    };
+}
+//# sourceMappingURL=collaboration-dispatch.js.map

package/lib/collaboration/collaboration-dispatch.js.map

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

package/lib/collaboration/collaboration-kernel-bridge.d.ts

@@ -0,0 +1,23 @@
+import { type Message, type MessageElement } from '@zhin.js/core';
+import type { CollaborationScene } from './types.js';
+import type { OrchestrationRunSource, OrchestrationTaskRecord } from '@zhin.js/ai';
+export declare function isOrchestrationKernelReady(): boolean;
+/** Legacy pipelineState.activeDelegations harness — kernel 就绪时停用。 */
+export declare function shouldUseLegacyCellDelegationHarness(cell?: CollaborationScene): boolean;
+export declare function orchestrationSourceFromMessage(message: Message, collaborationSceneId?: string): OrchestrationRunSource;
+export declare function findActiveImProjectionTasksForEndpoint(tasks: OrchestrationTaskRecord[], endpointId: string): OrchestrationTaskRecord[];
+export declare function listActiveImProjectionTasks(message: Message, endpointId: string): Promise<OrchestrationTaskRecord[]>;
+/**
+ * 被委派方 AI 出站后：实质公开回复 → completeTask + 可选 handback @Planner（含 #taskId）。
+ * 仅适用于 im_projection 任务；internal_room 走 kernel 直完成。
+ */
+export declare function tryCompleteKernelImProjectionFromOutbound(input: {
+    message: Message;
+    cell: CollaborationScene;
+    endpointId: string;
+    outboundBatches: MessageElement[][];
+    logger: {
+        info: (...args: unknown[]) => void;
+    };
+}): Promise<void>;
+//# sourceMappingURL=collaboration-kernel-bridge.d.ts.map

package/lib/collaboration/collaboration-kernel-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collaboration-kernel-bridge.d.ts","sourceRoot":"","sources":["../../src/collaboration/collaboration-kernel-bridge.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,cAAc,EAAsD,MAAM,eAAe,CAAC;AACtH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,sBAAsB,EAAyB,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAS1G,wBAAgB,0BAA0B,IAAI,OAAO,CAEpD;AAED,qEAAqE;AACrE,wBAAgB,oCAAoC,CAAC,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAGvF;AAkBD,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,OAAO,EAChB,oBAAoB,CAAC,EAAE,MAAM,GAC5B,sBAAsB,CAuBxB;AAED,wBAAgB,sCAAsC,CACpD,KAAK,EAAE,uBAAuB,EAAE,EAChC,UAAU,EAAE,MAAM,GACjB,uBAAuB,EAAE,CAM3B;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAMpC;AAED;;;GAGG;AACH,wBAAsB,yCAAyC,CAAC,KAAK,EAAE;IACrE,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,kBAAkB,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,cAAc,EAAE,EAAE,CAAC;IACpC,MAAM,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;KAAE,CAAC;CAChD,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BhB"}

package/lib/collaboration/collaboration-kernel-bridge.js

@@ -0,0 +1,106 @@
+/**
+ * Collaboration ↔ OrchestrationKernel 桥接（ADR 0027）。
+ * Kernel 就绪时 Cell 不再写入 activeDelegations；handback 走 task 完成。
+ */
+import { formatCompactLog } from '@zhin.js/logger';
+import { sceneRefFromMessage, resolveIMSessionIdFromMessage } from '@zhin.js/core';
+import { getOrchestrationService } from '../orchestrator/orchestration-service.js';
+import { normalizeExecutorKind } from '../orchestrator/orchestration-mappers.js';
+import { isSubstantiveGroupTaskReply, resolvePlannerEndpointId, summarizeDelegateeReply, } from './collaboration-delegation.js';
+import { sendGroupPeerMention } from './im-mention-delegate.js';
+export function isOrchestrationKernelReady() {
+    return getOrchestrationService() != null;
+}
+/** Legacy pipelineState.activeDelegations harness — kernel 就绪时停用。 */
+export function shouldUseLegacyCellDelegationHarness(cell) {
+    if (isOrchestrationKernelReady())
+        return false;
+    return Boolean(cell?.pipelineState?.activeDelegations?.length);
+}
+const ACTIVE_GROUP_TASK_STATUSES = new Set([
+    'assigned',
+    'running',
+    'waiting_result',
+    'pending',
+]);
+function flattenOutboundText(batches) {
+    return batches
+        .flat()
+        .filter((seg) => seg.type === 'text' && seg.data?.text != null)
+        .map((seg) => String(seg.data.text))
+        .join(' ')
+        .trim();
+}
+export function orchestrationSourceFromMessage(message, collaborationSceneId) {
+    const scene = sceneRefFromMessage(message);
+    if (!scene) {
+        return { kind: 'manual', label: 'orchestration' };
+    }
+    const orchestrationScene = {
+        platform: scene.platform,
+        endpointId: scene.endpointId,
+        sceneId: scene.sceneId,
+        kind: scene.kind,
+        ...(scene.senderId ? { senderId: scene.senderId } : {}),
+        ...(scene.parent ? {
+            parent: {
+                kind: scene.parent.kind === 'guild' ? 'channel' : scene.parent.kind,
+                sceneId: scene.parent.sceneId,
+            },
+        } : {}),
+    };
+    return {
+        kind: 'im_scene',
+        scene: orchestrationScene,
+        ...(collaborationSceneId ? { collaborationSceneId } : {}),
+    };
+}
+export function findActiveImProjectionTasksForEndpoint(tasks, endpointId) {
+    return tasks.filter((task) => normalizeExecutorKind(task.executor_kind) === 'im_projection'
+        && task.assigned_to === endpointId
+        && ACTIVE_GROUP_TASK_STATUSES.has(task.status));
+}
+export async function listActiveImProjectionTasks(message, endpointId) {
+    const orch = getOrchestrationService();
+    if (!orch)
+        return [];
+    const sessionKey = resolveIMSessionIdFromMessage(message);
+    const runs = await orch.listRuns(sessionKey);
+    return runs.flatMap((run) => findActiveImProjectionTasksForEndpoint(run.tasks, endpointId));
+}
+/**
+ * 被委派方 AI 出站后：实质公开回复 → completeTask + 可选 handback @Planner（含 #taskId）。
+ * 仅适用于 im_projection 任务；internal_room 走 kernel 直完成。
+ */
+export async function tryCompleteKernelImProjectionFromOutbound(input) {
+    const orch = getOrchestrationService();
+    if (!orch)
+        return;
+    const publicText = flattenOutboundText(input.outboundBatches);
+    if (!isSubstantiveGroupTaskReply(publicText))
+        return;
+    const active = await listActiveImProjectionTasks(input.message, input.endpointId);
+    if (active.length !== 1)
+        return;
+    const task = active[0];
+    const summary = summarizeDelegateeReply(publicText);
+    if (!isSubstantiveGroupTaskReply(summary))
+        return;
+    await orch.completeTask(task.id, summary);
+    input.logger.info(formatCompactLog('OrchestrationKernel', {
+        action: 'kernel_group_task_complete',
+        task: task.id,
+        cell: input.cell.id,
+        endpoint: input.endpointId,
+    }));
+    const plannerId = resolvePlannerEndpointId(input.cell);
+    if (!plannerId || plannerId === input.endpointId)
+        return;
+    const handbackText = `#${task.id} 已完成：${summary}`;
+    await sendGroupPeerMention({
+        message: { ...input.message, $endpoint: input.endpointId },
+        targetEndpointId: plannerId,
+        text: handbackText,
+    });
+}
+//# sourceMappingURL=collaboration-kernel-bridge.js.map

package/lib/collaboration/collaboration-kernel-bridge.js.map

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

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

@@ -0,0 +1,64 @@
+/**
+ * 协作群出站解析 — 委托 core ZhinAiOutboundPayload；cell roster 语义保留在此。
+ */
+import type { OutputElement } from '@zhin.js/ai';
+import { type Message, type MessageElement, type ZhinAiOutboundPayload } from '@zhin.js/core';
+import type { CollaborationScene } from './types.js';
+import { type GroupMessageAdapterView } from './group-message.js';
+import { type TryResolveStructuredAiOutboundOptions } from './structured-ai-outbound.js';
+/** @deprecated 使用 ZhinAiOutboundPayload */
+export type CollaborationReplyPayload = ZhinAiOutboundPayload & {
+    text: string;
+};
+export declare const COLLABORATION_MENTION_JSON_EXAMPLE = "{\"mentions\":[\"researcher\",\"210723495\"],\"text\":\"\u6B63\u6587\"}";
+export declare const COLLABORATION_REPLY_JSON_HINT: string;
+export declare function resolveMentionEndpointIds(cell: import('./types.js').CollaborationScene, mentions: string[] | undefined): {
+    ok: true;
+    endpointIds: string[];
+} | {
+    ok: false;
+    error: string;
+};
+export declare function buildCollaborationMentionSegmentsFromPayload(message: Message, payload: ZhinAiOutboundPayload): MessageElement[] | null;
+/** 发送协作 JSON @ 消息（普通回复解析与 group_delegate 共用）。 */
+export declare function sendCollaborationMentionPayload(message: Message, payload: ZhinAiOutboundPayload): Promise<{
+    ok: boolean;
+    error?: string;
+    endpointIds?: string[];
+}>;
+/**
+ * 剥离出站消息里对 Cell peer 的 @（假 @ 与 at segment）。
+ * Pipeline harness 等场景下委派由 harness 代发，Planner 正文不应携带 peer @。
+ */
+export declare function stripCellPeerMentionsFromSegments(segments: MessageElement[], cell: CollaborationScene, selfEndpointId: string, adapter?: GroupMessageAdapterView): MessageElement[];
+/** 剥离出站里对自身的 @（模型误 @ 自己的 endpoint/QQ）。 */
+export declare function stripCellSelfMentionsFromSegments(segments: MessageElement[], cell: CollaborationScene, selfEndpointId: string, adapter?: GroupMessageAdapterView): MessageElement[];
+/** Planner 公开正文：剥离 peer 假 @ 与 self @。 */
+export declare function stripPlannerPublicMentionsFromSegments(segments: MessageElement[], cell: CollaborationScene, selfEndpointId: string, adapter?: GroupMessageAdapterView): MessageElement[];
+export declare function batchHasAtSegment(batch: MessageElement[]): boolean;
+/** 协作群内模型「不回应/内心独白」类出站 — 不应广播到 IM。 */
+export declare function isCollaborationNoOpReasoningOutbound(batches: MessageElement[][]): boolean;
+/** 出站 segments 是否包含对指定 endpoint 的真实 @ segment。 */
+export declare function segmentsMentionEndpoint(segments: MessageElement[], endpointId: string, adapter?: GroupMessageAdapterView, cell?: CollaborationScene): boolean;
+/**
+ * Pipeline 被委派方出站：只保留公开正文，剥离模型 JSON handback（post-turn harness 代发 @）。
+ */
+export declare function sanitizeCellToolJsonInOutboundBatches(batches: MessageElement[][]): MessageElement[][];
+export declare function parseCollaborationReplyJson(raw: string): CollaborationReplyPayload | null;
+/** group_delegate 扩展 JSON（requireArtifact / artifactKinds / mode）。 */
+export interface GroupDelegatePayload extends CollaborationReplyPayload {
+    requireArtifact: boolean;
+    artifactKinds?: import('./types.js').PipelineArtifactKind[];
+    mode?: string;
+}
+export declare function parseGroupDelegatePayload(raw: string): GroupDelegatePayload | null;
+/**
+ * 兼容 LLM 工具调用：message=JSON 字符串 | message=对象 | 顶层扁平字段。
+ */
+export declare function coerceGroupDelegateArgs(args: Record<string, unknown>): GroupDelegatePayload | null;
+/**
+ * 将协作 JSON / 假 @ 回复转为带真实 @ segment 的 MessageElement[]。
+ */
+export declare function tryBuildCollaborationMentionSegments(message: Message, elements: OutputElement[], options?: TryResolveStructuredAiOutboundOptions): Promise<MessageElement[] | null>;
+export { tryBuildCollaborationOutboundBatches } from './structured-ai-outbound.js';
+//# sourceMappingURL=collaboration-outbound.d.ts.map

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

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