@zhin.js/agent 0.3.1 → 1.0.2

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

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

package/lib/collaboration/endpoint-identity.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Endpoint identity — 通过 Adapter Endpoint 注册表反查 peer Bot（ADR 0024 D5）。
+ *
+ * 取代废弃的 `peerSenderId`：群内某条消息的 `$sender.id` 若匹配到 Cell 成员
+ * Endpoint 在平台上的身份（platformUserId / config.name / appid / endpointId），
+ * 则该消息来自 peer Bot；否则视为人类（非 roster sender）。
+ */
+import { type Message, type Plugin } from '@zhin.js/core';
+import type { CollaborationScene, CollaborationSceneMemberRuntime } from './types.js';
+/** 解析某个 Endpoint 在平台上可被识别的 id 集合。 */
+export declare function resolveEndpointIdsForMember(root: Plugin | undefined, adapter: string, endpointId: string): string[];
+/** 在 Cell 成员中按平台 senderId 反查；命中即 peer Bot，未命中为人类。 */
+export declare function resolveMemberBySender(cell: CollaborationScene | undefined, senderId: string, root?: Plugin): CollaborationSceneMemberRuntime | undefined;
+/** 便捷：判断入站消息是否来自同 Cell 的 peer Bot。 */
+export declare function isInboundFromPeerBot(message: Message, cell: CollaborationScene | undefined, root?: Plugin): boolean;
+/**
+ * 出站 @ 解析：用发送方 adapter 的 id 格式解析目标 peer 的 platform id。
+ *
+ * 跨 adapter 场景下（如 icqq bot 发消息 @ 官 Q bot），需要按发送方 adapter
+ * 反查目标在该 adapter 平台上的 id。
+ *
+ * 策略：
+ * 1. 目标 member 的 transport adapter 与发送方相同 → 直接用 endpointId / platformUserId
+ * 2. 不同 adapter → 尝试通过 scenes 表 + 注册表交叉反查平台 id
+ * 3. fallback → 使用 endpointId
+ */
+export declare function resolveOutboundMentionId(cell: CollaborationScene, targetMember: CollaborationSceneMemberRuntime, senderAdapter: string, root?: Plugin): string;
+//# sourceMappingURL=endpoint-identity.d.ts.map

package/lib/collaboration/endpoint-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-identity.d.ts","sourceRoot":"","sources":["../../src/collaboration/endpoint-identity.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,MAAM,EAAqB,MAAM,eAAe,CAAC;AAC7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,+BAA+B,EAAE,MAAM,YAAY,CAAC;AAOtF,qCAAqC;AACrC,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,MAAM,EAAE,CAgBV;AAED,qDAAqD;AACrD,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,kBAAkB,GAAG,SAAS,EACpC,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,GACZ,+BAA+B,GAAG,SAAS,CAY7C;AAED,sCAAsC;AACtC,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,kBAAkB,GAAG,SAAS,EACpC,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAIT;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,kBAAkB,EACxB,YAAY,EAAE,+BAA+B,EAC7C,aAAa,EAAE,MAAM,EACrB,IAAI,CAAC,EAAE,MAAM,GACZ,MAAM,CA4BR"}

package/lib/collaboration/endpoint-identity.js

@@ -0,0 +1,88 @@
+/**
+ * Endpoint identity — 通过 Adapter Endpoint 注册表反查 peer Bot（ADR 0024 D5）。
+ *
+ * 取代废弃的 `peerSenderId`：群内某条消息的 `$sender.id` 若匹配到 Cell 成员
+ * Endpoint 在平台上的身份（platformUserId / config.name / appid / endpointId），
+ * 则该消息来自 peer Bot；否则视为人类（非 roster sender）。
+ */
+import { getHostRootPlugin } from '@zhin.js/core';
+import { memberTransportAdapter } from './collaboration-config.js';
+/** 解析某个 Endpoint 在平台上可被识别的 id 集合。 */
+export function resolveEndpointIdsForMember(root, adapter, endpointId) {
+    const ids = new Set([endpointId]);
+    if (!root)
+        return [...ids];
+    try {
+        const ad = root.inject(adapter);
+        const endpoint = ad?.endpoints?.get(endpointId);
+        const cfg = endpoint?.$config;
+        if (cfg?.name)
+            ids.add(String(cfg.name));
+        if (cfg?.appid)
+            ids.add(String(cfg.appid));
+        if (endpoint?.$platformUserId)
+            ids.add(String(endpoint.$platformUserId));
+    }
+    catch {
+        // adapter 未就绪：仅用 endpointId
+    }
+    return [...ids];
+}
+/** 在 Cell 成员中按平台 senderId 反查；命中即 peer Bot，未命中为人类。 */
+export function resolveMemberBySender(cell, senderId, root) {
+    if (!cell || !senderId)
+        return undefined;
+    const plugin = root ?? getHostRootPlugin() ?? undefined;
+    for (const member of cell.members) {
+        const ids = resolveEndpointIdsForMember(plugin, memberTransportAdapter(cell, member), member.endpointId);
+        if (ids.includes(senderId))
+            return member;
+    }
+    return undefined;
+}
+/** 便捷：判断入站消息是否来自同 Cell 的 peer Bot。 */
+export function isInboundFromPeerBot(message, cell, root) {
+    const senderId = String(message.$sender?.id ?? '');
+    if (!senderId)
+        return false;
+    return !!resolveMemberBySender(cell, senderId, root);
+}
+/**
+ * 出站 @ 解析：用发送方 adapter 的 id 格式解析目标 peer 的 platform id。
+ *
+ * 跨 adapter 场景下（如 icqq bot 发消息 @ 官 Q bot），需要按发送方 adapter
+ * 反查目标在该 adapter 平台上的 id。
+ *
+ * 策略：
+ * 1. 目标 member 的 transport adapter 与发送方相同 → 直接用 endpointId / platformUserId
+ * 2. 不同 adapter → 尝试通过 scenes 表 + 注册表交叉反查平台 id
+ * 3. fallback → 使用 endpointId
+ */
+export function resolveOutboundMentionId(cell, targetMember, senderAdapter, root) {
+    const plugin = root ?? getHostRootPlugin() ?? undefined;
+    const targetAdapter = memberTransportAdapter(cell, targetMember);
+    if (targetAdapter === senderAdapter) {
+        if (!plugin)
+            return targetMember.endpointId;
+        const ids = resolveEndpointIdsForMember(plugin, targetAdapter, targetMember.endpointId);
+        return ids.find((id) => id !== targetMember.endpointId) ?? targetMember.endpointId;
+    }
+    if (!plugin)
+        return targetMember.endpointId;
+    try {
+        const senderAd = plugin.inject(senderAdapter);
+        if (senderAd?.endpoints) {
+            for (const [, ep] of senderAd.endpoints) {
+                const cfg = ep.$config;
+                if (!cfg)
+                    continue;
+            }
+        }
+    }
+    catch {
+        // adapter not ready
+    }
+    const ids = resolveEndpointIdsForMember(plugin, targetAdapter, targetMember.endpointId);
+    return ids.find((id) => id !== targetMember.endpointId) ?? targetMember.endpointId;
+}
+//# sourceMappingURL=endpoint-identity.js.map

package/lib/collaboration/endpoint-identity.js.map

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

package/lib/collaboration/group-feed.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 群协作可见动态 — ADR 0024 D4「IM @ + 短摘要」的工程化落地。
+ *
+ * 用户在群里应能看到：计划、委派、阶段推进、各角色产出摘要。
+ * 全文仍存 Artifact DB；群 feed 长摘要分段连发，不截断省略。
+ */
+import type { Message } from '@zhin.js/core';
+import { type PipelineArtifactKind, type PipelineRole, type PipelineStage } from './types.js';
+export declare function formatRoleFeedLabel(role?: PipelineRole): string;
+export declare function formatArtifactSubmitFeedHeadline(kind: PipelineArtifactKind): string;
+export declare function formatArtifactFeedSummary(kind: PipelineArtifactKind, payload: Record<string, unknown>): string | undefined;
+export interface PublishGroupFeedInput {
+    message: Message;
+    role?: PipelineRole;
+    emoji?: string;
+    headline: string;
+    detail?: string;
+    /** 单条 IM 分段长度上限（默认 4000）；超长 detail 由 sendGroupMessageFromEndpoint 连发 */
+    maxChars?: number;
+}
+/** 发布一条群可见协作动态（纯文本，无 @）。 */
+export declare function publishCollaborationGroupFeed(input: PublishGroupFeedInput): Promise<{
+    ok: boolean;
+    skipped?: boolean;
+    error?: string;
+}>;
+export declare function formatDelegationFeedText(fromRole: PipelineRole | undefined, toRole: PipelineRole | undefined, task: string): string;
+export declare function formatStageFeedText(from: PipelineStage, to: PipelineStage): string;
+export declare function resolveActorPipelineRole(message: Message): PipelineRole | undefined;
+//# sourceMappingURL=group-feed.d.ts.map

package/lib/collaboration/group-feed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-feed.d.ts","sourceRoot":"","sources":["../../src/collaboration/group-feed.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AAyCpB,wBAAgB,mBAAmB,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM,CAG/D;AA2BD,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAEnF;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,GAAG,SAAS,CAgCpB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,4BAA4B;AAC5B,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgB7D;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,YAAY,GAAG,SAAS,EAClC,MAAM,EAAE,YAAY,GAAG,SAAS,EAChC,IAAI,EAAE,MAAM,GACX,MAAM,CAIR;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,aAAa,GAAG,MAAM,CAIlF;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAYnF"}

package/lib/collaboration/group-feed.js

@@ -0,0 +1,150 @@
+import { resolveCellForScene, findCellMemberByEndpoint } from './collaboration-config.js';
+import { sendGroupMessageFromEndpoint } from './group-message.js';
+import { isPipelineRole, } from './types.js';
+/** 群 feed 用中文角色名（与 binding nickname 解耦）。 */
+const ROLE_FEED_LABELS_ZH = {
+    planner: '规划员',
+    researcher: '调研员',
+    evaluator: '评估员',
+    executor: '执行员',
+    reviewer: '评审员',
+};
+const ARTIFACT_KIND_LABELS_ZH = {
+    report: '调研报告',
+    blueprint: '决策蓝图',
+    deliverable: '交付物',
+    review: '评审结论',
+    citations: '引用清单',
+};
+const STAGE_LABELS_ZH = {
+    planner: '规划',
+    researcher: '调研',
+    evaluator: '评估',
+    executor: '执行',
+    reviewer: '评审',
+    done: '完成',
+    failed: '失败',
+};
+function isMultiBotGroupScene(message) {
+    const scope = message.$channel?.type;
+    if (scope !== 'group' && scope !== 'channel')
+        return false;
+    const sceneId = message.$channel?.id;
+    if (!sceneId)
+        return false;
+    const cell = resolveCellForScene(String(message.$adapter ?? ''), sceneId);
+    return !!cell && cell.members.length >= 2;
+}
+export function formatRoleFeedLabel(role) {
+    if (role && isPipelineRole(role))
+        return ROLE_FEED_LABELS_ZH[role];
+    return '协作者';
+}
+function payloadHasContent(payload) {
+    return Object.values(payload).some((v) => {
+        if (v == null)
+            return false;
+        if (typeof v === 'string')
+            return v.trim().length > 0;
+        if (Array.isArray(v))
+            return v.length > 0;
+        if (typeof v === 'object')
+            return Object.keys(v).length > 0;
+        return true;
+    });
+}
+function isMeaninglessFeedDetail(detail) {
+    if (!detail?.trim())
+        return true;
+    const t = detail.trim();
+    if (t === '{}' || t === '[]')
+        return true;
+    if (t.startsWith('{') && t.endsWith('}')) {
+        try {
+            const o = JSON.parse(t);
+            return !payloadHasContent(o);
+        }
+        catch {
+            return false;
+        }
+    }
+    return false;
+}
+export function formatArtifactSubmitFeedHeadline(kind) {
+    return `已提交${ARTIFACT_KIND_LABELS_ZH[kind]}`;
+}
+export function formatArtifactFeedSummary(kind, payload) {
+    const pick = (...keys) => {
+        for (const key of keys) {
+            const v = payload[key];
+            if (typeof v === 'string' && v.trim())
+                return v.trim();
+        }
+        return undefined;
+    };
+    if (!payloadHasContent(payload))
+        return undefined;
+    switch (kind) {
+        case 'report':
+            return pick('summary', 'title', 'headline', 'text');
+        case 'blueprint':
+            return pick('decision', 'summary', 'recommendation');
+        case 'deliverable':
+            return pick('summary', 'title', 'path', 'description');
+        case 'review': {
+            const approved = payload.approved === true;
+            const feedback = pick('feedback', 'comments', 'reason', 'summary');
+            if (feedback)
+                return approved ? `通过：${feedback}` : `需修改：${feedback}`;
+            return approved ? '评审通过' : '评审未通过';
+        }
+        case 'citations': {
+            const items = payload.items ?? payload.citations;
+            const count = Array.isArray(items) ? items.length : undefined;
+            return count != null ? `${count} 条引用` : pick('summary');
+        }
+        default:
+            return undefined;
+    }
+}
+/** 发布一条群可见协作动态（纯文本，无 @）。 */
+export async function publishCollaborationGroupFeed(input) {
+    if (!isMultiBotGroupScene(input.message)) {
+        return { ok: true, skipped: true };
+    }
+    const label = formatRoleFeedLabel(input.role);
+    const prefix = input.emoji ? `${input.emoji} ` : '';
+    const detail = isMeaninglessFeedDetail(input.detail) ? undefined : input.detail.trim();
+    const body = detail
+        ? `${prefix}${label}${input.headline}：${detail}`
+        : `${prefix}${label}${input.headline}`;
+    const sent = await sendGroupMessageFromEndpoint({
+        message: input.message,
+        text: body,
+        maxChars: input.maxChars,
+    });
+    return sent.ok ? { ok: true } : { ok: false, error: sent.error };
+}
+export function formatDelegationFeedText(fromRole, toRole, task) {
+    const from = formatRoleFeedLabel(fromRole);
+    const to = formatRoleFeedLabel(toRole);
+    return `${from} → ${to}：${task.trim()}`;
+}
+export function formatStageFeedText(from, to) {
+    const fromLabel = STAGE_LABELS_ZH[from] ?? from;
+    const toLabel = STAGE_LABELS_ZH[to] ?? to;
+    return `阶段推进：${fromLabel} → ${toLabel}`;
+}
+export function resolveActorPipelineRole(message) {
+    const sceneId = message.$channel?.id;
+    if (!sceneId)
+        return undefined;
+    const cell = resolveCellForScene(String(message.$adapter ?? ''), sceneId);
+    if (!cell)
+        return undefined;
+    const member = findCellMemberByEndpoint(cell, String(message.$endpoint ?? ''));
+    return member?.pipelineRole && isPipelineRole(member.pipelineRole)
+        ? member.pipelineRole
+        : undefined;
+}
+//# sourceMappingURL=group-feed.js.map

package/lib/collaboration/group-feed.js.map

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

package/lib/collaboration/group-message.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 群消息发送 — 经统一 Adapter.sendMessage 从当前 Endpoint 出站（ADR 0023 identity follows outbound）。
+ */
+import { type Message, type MessageElement } from '@zhin.js/core';
+/** IM 单条文本上限（QQ 等约 4k；超长则分段连发，不截断省略）。 */
+export declare const DEFAULT_IM_TEXT_CHUNK_CHARS = 4000;
+export interface GroupMessageAdapterView {
+    endpoints?: Map<string, {
+        $config?: Record<string, unknown>;
+        $platformUserId?: string;
+    }>;
+    sendMessage?: (opts: {
+        context: string;
+        endpoint: string;
+        id: string;
+        type: string;
+        parent?: {
+            type: 'group' | 'guild';
+            id: string;
+        };
+        content: unknown;
+    }) => Promise<string>;
+}
+export declare function resolvePlatformAtId(adapter: GroupMessageAdapterView, endpointId: string): string;
+/** 构建带一个或多个 platform @ segment 的消息内容。 */
+export declare function buildAtMessageContent(adapter: GroupMessageAdapterView, atEndpointIds: string[], text: string): MessageElement[];
+/** 将长文本按段落/换行/句读切分为多条 IM 可发长度，不省略内容。 */
+export declare function splitLongTextForIm(text: string, maxChars?: number): string[];
+/**
+ * 出站 batch 中文本过长时拆成多条消息；@ 等非文本 segment 保留在首条。
+ */
+export declare function expandOutboundBatchesForLongText(batches: MessageElement[][], maxChars?: number): MessageElement[][];
+export interface SendGroupMessageContentInput {
+    message: Message;
+    content: unknown;
+}
+export declare function sendGroupMessageContent(input: SendGroupMessageContentInput): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+export interface SendGroupMessageInput {
+    message: Message;
+    text: string;
+    /** 可选：在正文前 @ 目标 Endpoint（platform at segment） */
+    atTargetEndpointId?: string;
+    /** 单条 IM 分段长度上限（默认 4000） */
+    maxChars?: number;
+}
+export declare function sendGroupMessageFromEndpoint(input: SendGroupMessageInput): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+//# sourceMappingURL=group-message.d.ts.map

package/lib/collaboration/group-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-message.d.ts","sourceRoot":"","sources":["../../src/collaboration/group-message.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,cAAc,EAA8B,MAAM,eAAe,CAAC;AAC9F,yCAAyC;AACzC,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAEhD,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzF,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE;YAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;QACjD,OAAO,EAAE,OAAO,CAAC;KAClB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACvB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,uBAAuB,EAChC,UAAU,EAAE,MAAM,GACjB,MAAM,CAOR;AAED,yCAAyC;AACzC,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,uBAAuB,EAChC,aAAa,EAAE,MAAM,EAAE,EACvB,IAAI,EAAE,MAAM,GACX,cAAc,EAAE,CASlB;AAED,wCAAwC;AACxC,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,QAAQ,SAA8B,GACrC,MAAM,EAAE,CAkCV;AAUD;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,cAAc,EAAE,EAAE,EAC3B,QAAQ,SAA8B,GACrC,cAAc,EAAE,EAAE,CAqCpB;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgC1C;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgC1C"}

package/lib/collaboration/group-message.js

@@ -0,0 +1,162 @@
+/**
+ * 群消息发送 — 经统一 Adapter.sendMessage 从当前 Endpoint 出站（ADR 0023 identity follows outbound）。
+ */
+import { getHostRootPlugin, segment } from '@zhin.js/core';
+/** IM 单条文本上限（QQ 等约 4k；超长则分段连发，不截断省略）。 */
+export const DEFAULT_IM_TEXT_CHUNK_CHARS = 4000;
+export function resolvePlatformAtId(adapter, endpointId) {
+    const peer = adapter.endpoints?.get(endpointId);
+    return (peer?.$platformUserId
+        ?? peer?.$config?.name
+        ?? endpointId);
+}
+/** 构建带一个或多个 platform @ segment 的消息内容。 */
+export function buildAtMessageContent(adapter, atEndpointIds, text) {
+    const trimmed = text.trim();
+    const segments = [];
+    for (const endpointId of atEndpointIds) {
+        const atId = resolvePlatformAtId(adapter, endpointId);
+        segments.push({ type: 'at', data: { id: atId, qq: atId } });
+    }
+    segments.push({ type: 'text', data: { text: trimmed.startsWith(' ') ? trimmed : ` ${trimmed}` } });
+    return segments;
+}
+/** 将长文本按段落/换行/句读切分为多条 IM 可发长度，不省略内容。 */
+export function splitLongTextForIm(text, maxChars = DEFAULT_IM_TEXT_CHUNK_CHARS) {
+    const normalized = text.replace(/\r\n/g, '\n').trim();
+    if (!normalized)
+        return [];
+    if (normalized.length <= maxChars)
+        return [normalized];
+    const chunks = [];
+    let remaining = normalized;
+    while (remaining.length > maxChars) {
+        let splitAt = remaining.lastIndexOf('\n\n', maxChars);
+        if (splitAt < maxChars * 0.5) {
+            splitAt = remaining.lastIndexOf('\n', maxChars);
+        }
+        if (splitAt < maxChars * 0.5) {
+            splitAt = Math.max(remaining.lastIndexOf('。', maxChars), remaining.lastIndexOf('！', maxChars), remaining.lastIndexOf('？', maxChars), remaining.lastIndexOf('. ', maxChars), remaining.lastIndexOf('! ', maxChars), remaining.lastIndexOf('? ', maxChars));
+        }
+        if (splitAt < maxChars * 0.3) {
+            splitAt = maxChars;
+        }
+        else {
+            splitAt += 1;
+        }
+        const chunk = remaining.slice(0, splitAt).trim();
+        if (chunk)
+            chunks.push(chunk);
+        remaining = remaining.slice(splitAt).trim();
+    }
+    if (remaining)
+        chunks.push(remaining);
+    return chunks;
+}
+function formatOutboundTextSegment(text) {
+    const trimmed = text.trim();
+    return {
+        type: 'text',
+        data: { text: trimmed.startsWith(' ') ? trimmed : ` ${trimmed}` },
+    };
+}
+/**
+ * 出站 batch 中文本过长时拆成多条消息；@ 等非文本 segment 保留在首条。
+ */
+export function expandOutboundBatchesForLongText(batches, maxChars = DEFAULT_IM_TEXT_CHUNK_CHARS) {
+    const expanded = [];
+    for (const batch of batches) {
+        const nonText = batch.filter((seg) => seg.type !== 'text');
+        const textParts = batch
+            .filter((seg) => seg.type === 'text' && seg.data?.text != null)
+            .map((seg) => String(seg.data.text).trim())
+            .filter(Boolean);
+        const fullText = textParts.join('\n').trim();
+        if (!fullText) {
+            expanded.push(batch);
+            continue;
+        }
+        if (fullText.length <= maxChars) {
+            expanded.push(batch);
+            continue;
+        }
+        if (nonText.length === 0) {
+            for (const chunk of splitLongTextForIm(fullText, maxChars)) {
+                expanded.push([formatOutboundTextSegment(chunk)]);
+            }
+            continue;
+        }
+        const chunks = splitLongTextForIm(fullText, maxChars);
+        for (let i = 0; i < chunks.length; i++) {
+            expanded.push([
+                ...(i === 0 ? nonText : []),
+                formatOutboundTextSegment(chunks[i]),
+            ]);
+        }
+    }
+    return expanded.filter((batch) => batch.length > 0);
+}
+export async function sendGroupMessageContent(input) {
+    const { message, content } = input;
+    const plugin = getHostRootPlugin();
+    if (!plugin)
+        return { ok: false, error: 'Host plugin 未就绪' };
+    const adapter = plugin.inject(message.$adapter);
+    if (!adapter?.sendMessage) {
+        return { ok: false, error: `adapter ${message.$adapter} 不支持 sendMessage` };
+    }
+    const channel = message.$channel;
+    if (!channel?.id || !channel.type) {
+        return { ok: false, error: '仅支持群/频道内发送' };
+    }
+    if (channel.type !== 'group' && channel.type !== 'channel') {
+        return { ok: false, error: `不支持的频道类型: ${channel.type}` };
+    }
+    await adapter.sendMessage({
+        context: message.$adapter,
+        endpoint: String(message.$endpoint),
+        id: channel.id,
+        type: channel.type,
+        parent: channel.parent
+            ? {
+                type: channel.parent.type === 'channel' ? 'guild' : channel.parent.type,
+                id: channel.parent.id,
+            }
+            : undefined,
+        content,
+    });
+    return { ok: true };
+}
+export async function sendGroupMessageFromEndpoint(input) {
+    const { message, text, atTargetEndpointId, maxChars } = input;
+    const plugin = getHostRootPlugin();
+    if (!plugin)
+        return { ok: false, error: 'Host plugin 未就绪' };
+    const adapter = plugin.inject(message.$adapter);
+    if (!adapter?.sendMessage) {
+        return { ok: false, error: `adapter ${message.$adapter} 不支持 sendMessage` };
+    }
+    const channel = message.$channel;
+    if (!channel?.id || !channel.type) {
+        return { ok: false, error: '仅支持群/频道内发送' };
+    }
+    if (channel.type !== 'group' && channel.type !== 'channel') {
+        return { ok: false, error: `不支持的频道类型: ${channel.type}` };
+    }
+    const trimmed = text.trim();
+    if (!trimmed)
+        return { ok: false, error: '消息正文为空' };
+    const chunks = splitLongTextForIm(trimmed, maxChars ?? DEFAULT_IM_TEXT_CHUNK_CHARS);
+    for (let i = 0; i < chunks.length; i++) {
+        const chunk = chunks[i];
+        const attachAt = i === 0 && atTargetEndpointId;
+        const content = attachAt
+            ? buildAtMessageContent(adapter, [atTargetEndpointId], chunk)
+            : segment.text(chunk);
+        const sent = await sendGroupMessageContent({ message, content });
+        if (!sent.ok)
+            return sent;
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=group-message.js.map

package/lib/collaboration/group-message.js.map

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

package/lib/collaboration/im-mention-delegate.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 向 peer Endpoint 发送真实 IM @ 消息段（统一发送链）。
+ */
+import type { Message } from '@zhin.js/core';
+export interface GroupPeerMentionInput {
+    message: Message;
+    targetEndpointId: string;
+    text: string;
+}
+/** 发送带 platform @ segment 的群消息，触发 peer bot 入站。 */
+export declare function sendGroupPeerMention(input: GroupPeerMentionInput): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+/** @deprecated 使用 sendGroupPeerMention */
+export declare function sendImMentionDelegation(input: GroupPeerMentionInput & {
+    cell?: unknown;
+}): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+//# sourceMappingURL=im-mention-delegate.d.ts.map

package/lib/collaboration/im-mention-delegate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"im-mention-delegate.d.ts","sourceRoot":"","sources":["../../src/collaboration/im-mention-delegate.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,kDAAkD;AAClD,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAO1C;AAED,0CAA0C;AAC1C,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,qBAAqB,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAChD,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAE1C"}

package/lib/collaboration/im-mention-delegate.js

@@ -0,0 +1,15 @@
+import { sendGroupMessageFromEndpoint } from './group-message.js';
+/** 发送带 platform @ segment 的群消息，触发 peer bot 入站。 */
+export async function sendGroupPeerMention(input) {
+    const { message, targetEndpointId, text } = input;
+    return sendGroupMessageFromEndpoint({
+        message,
+        text,
+        atTargetEndpointId: targetEndpointId,
+    });
+}
+/** @deprecated 使用 sendGroupPeerMention */
+export async function sendImMentionDelegation(input) {
+    return sendGroupPeerMention(input);
+}
+//# sourceMappingURL=im-mention-delegate.js.map

package/lib/collaboration/im-mention-delegate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"im-mention-delegate.js","sourceRoot":"","sources":["../../src/collaboration/im-mention-delegate.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAQlE,kDAAkD;AAClD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAA4B;IAE5B,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IAClD,OAAO,4BAA4B,CAAC;QAClC,OAAO;QACP,IAAI;QACJ,kBAAkB,EAAE,gBAAgB;KACrC,CAAC,CAAC;AACL,CAAC;AAED,0CAA0C;AAC1C,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,KAAiD;IAEjD,OAAO,oBAAoB,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC"}

package/lib/collaboration/inbound-peer-handback.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Peer 入站 handback（OrchestrationKernel SSOT；阶段 4）。
+ */
+import { type Message } from '@zhin.js/core';
+import type { CollaborationScene } from './types.js';
+export interface PeerInboundHandbackInput {
+    message: Message;
+    cell: CollaborationScene;
+    peerEndpointId: string;
+    replyAi: (payload: unknown) => Promise<unknown>;
+    logger: {
+        debug: (...args: unknown[]) => void;
+        info: (...args: unknown[]) => void;
+    };
+}
+/** @returns true 表示 pipeline 应提前结束（如 ambiguous handback 已回复） */
+export declare function tryHandlePeerInboundHandback(input: PeerInboundHandbackInput): Promise<boolean>;
+//# sourceMappingURL=inbound-peer-handback.d.ts.map

package/lib/collaboration/inbound-peer-handback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-peer-handback.d.ts","sourceRoot":"","sources":["../../src/collaboration/inbound-peer-handback.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,KAAK,OAAO,EAAiC,MAAM,eAAe,CAAC;AAY5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,kBAAkB,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,EAAE;QAAE,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;KAAE,CAAC;CACrF;AAED,gEAAgE;AAChE,wBAAsB,4BAA4B,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,OAAO,CAAC,CA8DpG"}