@zhin.js/agent 0.3.1 → 1.0.2

package/lib/collaboration/outbound-resolver.js

@@ -0,0 +1,188 @@
+import { readMentionSegmentTarget, extractEmbeddedAiOutboundJson, parseAiOutboundJson, rewritePlainTextMentions, } from '@zhin.js/core';
+import { tryBuildCollaborationOutboundBatches } from './structured-ai-outbound.js';
+import { expandOutboundBatchesForLongText, buildAtMessageContent } from './group-message.js';
+import { publishOutboundElements } from '../media/media-publisher.js';
+import { resolvePeerEndpointInCell } from './collaboration-config.js';
+import { stripPlannerPublicMentionsFromSegments, batchHasAtSegment, segmentsMentionEndpoint, } from './collaboration-outbound.js';
+/** 剥离正文中的假 @token，避免 JSON 解析失败时误触发 peer。 */
+export function stripFakeAtTokens(text) {
+    return text
+        .replace(/@[\w:.-]+/g, '')
+        .replace(/\s{2,}/g, ' ')
+        .trim();
+}
+const PLANNER_PIPELINE_ROLES = ['researcher', 'evaluator', 'executor', 'reviewer'];
+function batchPlainText(batch) {
+    return batch
+        .filter((seg) => seg.type === 'text' && seg.data?.text != null)
+        .map((seg) => String(seg.data.text).trim())
+        .filter(Boolean)
+        .join('\n')
+        .trim();
+}
+/** 批次是否为对 peer 的真实 @ 委派。 */
+export function isPlannerDelegateBatch(batch, cell, selfEndpointId, adapter) {
+    if (!batchHasAtSegment(batch))
+        return false;
+    for (const member of cell.members) {
+        if (member.endpointId === selfEndpointId)
+            continue;
+        if (segmentsMentionEndpoint(batch, member.endpointId, adapter, cell))
+            return true;
+    }
+    return false;
+}
+function resolveRoleCallInProse(text, cell) {
+    for (const role of PLANNER_PIPELINE_ROLES) {
+        const member = cell.members.find((m) => m.pipelineRole === role);
+        if (!member)
+            continue;
+        const bold = new RegExp(`\\*\\*${role}\\*\\*[，,：:\\s]*(.+?)(?:[。！!]|$)`, 'i');
+        const plain = new RegExp(`(?:^|[，。\\s])${role}[，,：]\\s*(?!的)(.+?)(?:[。！!]|$)`, 'i');
+        const hit = text.match(bold) ?? text.match(plain);
+        if (hit) {
+            const task = hit[1]?.trim();
+            return { role, task: task || `请 ${role} 继续处理。` };
+        }
+    }
+    return undefined;
+}
+function buildDelegateBatch(adapter, endpointIds, text) {
+    return buildAtMessageContent(adapter, endpointIds, text.trim() || '请处理。');
+}
+function splitProseIntoDelegateBatches(batch, cell, selfEndpointId, adapter) {
+    if (isPlannerDelegateBatch(batch, cell, selfEndpointId, adapter)) {
+        return [batch];
+    }
+    const plain = batchPlainText(batch);
+    if (!plain)
+        return [batch];
+    const embedded = extractEmbeddedAiOutboundJson(plain);
+    if (embedded?.jsonRaw) {
+        const payload = parseAiOutboundJson(embedded.jsonRaw);
+        if (payload?.mentions?.length && payload.text?.trim()) {
+            const ids = [];
+            for (const ref of payload.mentions) {
+                const ep = resolvePeerEndpointInCell(cell, ref);
+                if (ep && ep !== selfEndpointId && !ids.includes(ep))
+                    ids.push(ep);
+            }
+            if (ids.length) {
+                const out = [];
+                if (embedded.prose.trim()) {
+                    out.push([{ type: 'text', data: { text: ` ${embedded.prose.trim()}` } }]);
+                }
+                out.push(buildDelegateBatch(adapter, ids, payload.text));
+                return out;
+            }
+        }
+    }
+    const rewritten = rewritePlainTextMentions(plain, (ref) => {
+        const ep = resolvePeerEndpointInCell(cell, ref);
+        if (!ep || ep === selfEndpointId)
+            return undefined;
+        return ep;
+    });
+    if (rewritten?.mentions?.length && rewritten.text?.trim()) {
+        const ids = rewritten.mentions
+            .map((ref) => resolvePeerEndpointInCell(cell, ref))
+            .filter((ep) => Boolean(ep && ep !== selfEndpointId));
+        if (ids.length) {
+            const out = [];
+            if (rewritten.text.trim()) {
+                out.push([{ type: 'text', data: { text: ` ${rewritten.text.trim()}` } }]);
+            }
+            out.push(buildDelegateBatch(adapter, ids, rewritten.text));
+            return out;
+        }
+    }
+    const roleCall = resolveRoleCallInProse(plain, cell);
+    if (roleCall) {
+        const ep = cell.members.find((m) => m.pipelineRole === roleCall.role)?.endpointId;
+        if (ep && ep !== selfEndpointId) {
+            const withoutCall = plain
+                .replace(new RegExp(`\\*\\*${roleCall.role}\\*\\*[^。！!]*`, 'i'), '')
+                .trim();
+            const out = [];
+            if (withoutCall) {
+                out.push([{ type: 'text', data: { text: ` ${withoutCall}` } }]);
+            }
+            out.push(buildDelegateBatch(adapter, [ep], roleCall.task));
+            return out;
+        }
+    }
+    return [batch];
+}
+/** Planner 出站 role strategy：拆分委派 @、剥离 self 假 @，不删除真实委派 batch。 */
+export function normalizePlannerOutboundBatches(batches, cell, selfEndpointId, adapter) {
+    const expanded = [];
+    for (const batch of batches) {
+        expanded.push(...splitProseIntoDelegateBatches(batch, cell, selfEndpointId, adapter));
+    }
+    const normalized = [];
+    for (const batch of expanded) {
+        if (isPlannerDelegateBatch(batch, cell, selfEndpointId, adapter)) {
+            normalized.push(batch);
+            continue;
+        }
+        const stripped = stripPlannerPublicMentionsFromSegments(batch, cell, selfEndpointId, adapter);
+        if (stripped.length)
+            normalized.push(stripped);
+    }
+    return normalized;
+}
+function canonicalizeMentionSegments(batch) {
+    return batch.map((seg) => {
+        if (seg.type !== 'at')
+            return seg;
+        const target = readMentionSegmentTarget(seg) ?? seg.data?.id ?? seg.data?.qq;
+        if (!target)
+            return seg;
+        return { type: 'mention', data: { target: String(target) } };
+    });
+}
+function batchHasMention(batch) {
+    return batch.some((seg) => seg.type === 'mention' || seg.type === 'at');
+}
+export async function resolveOutboundBatches(input) {
+    const { message, elements, inboundContent, cell, endpointId, adapterView, selfMember, warn, } = input;
+    const collabBatches = await tryBuildCollaborationOutboundBatches(message, elements, {
+        inboundContent,
+        warn,
+        root: input.root,
+    });
+    let batches = collabBatches ?? [
+        await publishOutboundElements(elements, String(message.$adapter)),
+    ];
+    if (cell && selfMember?.pipelineRole === 'planner' && adapterView) {
+        batches = normalizePlannerOutboundBatches(batches, cell, endpointId, adapterView);
+    }
+    batches = batches
+        .map((batch) => canonicalizeMentionSegments(batch))
+        .filter((batch) => batch.length > 0);
+    const batchMeta = batches.map((batch) => ({
+        peerTriggerExpected: batchHasMention(batch),
+    }));
+    if (!batches.length && elements.length) {
+        const plain = elements
+            .filter((el) => el.type === 'text')
+            .map((el) => (el.type === 'text' ? el.content : ''))
+            .join('\n')
+            .trim();
+        if (plain) {
+            const prose = stripFakeAtTokens(plain);
+            if (prose) {
+                batches = [[{ type: 'text', data: { text: prose } }]];
+                batchMeta.push({ fallback: 'json_parse_failed_strip_at', peerTriggerExpected: false });
+                warn?.(`outbound JSON parse failed; stripped fake @ tokens, prose only`);
+            }
+        }
+    }
+    batches = expandOutboundBatchesForLongText(batches);
+    return {
+        batches,
+        batchMeta,
+        primaryFallback: batchMeta.find((m) => m.fallback)?.fallback,
+    };
+}
+//# sourceMappingURL=outbound-resolver.js.map

package/lib/collaboration/outbound-resolver.js.map

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

package/lib/collaboration/peer-policy.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Peer inbound trigger policy — prevent bot-to-bot chat storms.
+ */
+import { type Message, type Plugin } from '@zhin.js/core';
+import type { CollaborationScene, PeerTriggerMode, PeerTriggerResult } from './types.js';
+export interface PeerPolicyInput {
+    message: Message;
+    cell?: CollaborationScene;
+    peerMode: PeerTriggerMode;
+    endpointAtIds: string[];
+    /** 用于 Endpoint 反查 peer 身份（缺省回退 getHostRootPlugin）。 */
+    root?: Plugin;
+}
+export interface CellAtOwnershipResult {
+    /** 当前 Endpoint 是否应处理这条入站（Cell 内仅被 @ 的成员响应） */
+    shouldHandle: boolean;
+    mentionedEndpointIds?: string[];
+    reason?: string;
+}
+/** 按消息顺序收集 @ 到的 Cell 成员 endpointId */
+export declare function resolveCellAtMentionedEndpointIds(message: Message, cell: CollaborationScene, root?: Plugin): string[];
+/** @deprecated 使用 resolveCellAtMentionedEndpointIds；保留首个 @ 以兼容旧调用 */
+export declare function resolveCellAtWinnerEndpointId(message: Message, cell: CollaborationScene): string | undefined;
+/** 同群多 Bot：仅被 @ 的 Cell 成员响应；未 @ 任何成员时不触发 */
+export declare function evaluateCellAtOwnership(message: Message, cell: CollaborationScene | undefined, endpointId: string, root?: Plugin): CellAtOwnershipResult;
+export declare function evaluatePeerTrigger(input: PeerPolicyInput): PeerTriggerResult;
+/** 入站是否来自同 Cell 的另一 Endpoint（Bot↔Bot 协作，非人类用户） */
+export declare function isInboundFromCollaborationPeer(message: Message, cell: CollaborationScene | undefined, root?: Plugin): boolean;
+//# sourceMappingURL=peer-policy.d.ts.map

package/lib/collaboration/peer-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-policy.d.ts","sourceRoot":"","sources":["../../src/collaboration/peer-policy.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,MAAM,EAAmD,MAAM,eAAe,CAAC;AAC3G,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEzF,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,eAAe,CAAC;IAC1B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,8CAA8C;IAC9C,YAAY,EAAE,OAAO,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD,sCAAsC;AACtC,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,kBAAkB,EACxB,IAAI,CAAC,EAAE,MAAM,GACZ,MAAM,EAAE,CAqBV;AAED,qEAAqE;AACrE,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,kBAAkB,GACvB,MAAM,GAAG,SAAS,CAEpB;AAED,4CAA4C;AAC5C,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,kBAAkB,GAAG,SAAS,EACpC,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,GACZ,qBAAqB,CAuCvB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,iBAAiB,CAuC7E;AAED,kDAAkD;AAClD,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,kBAAkB,GAAG,SAAS,EACpC,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAKT"}

package/lib/collaboration/peer-policy.js

@@ -0,0 +1,118 @@
+/**
+ * Peer inbound trigger policy — prevent bot-to-bot chat storms.
+ */
+import { isAtEndpoint, readMentionSegmentTarget, segment } from '@zhin.js/core';
+import { resolveMemberBySender } from './endpoint-identity.js';
+function segmentAtUserId(seg) {
+    return readMentionSegmentTarget(seg);
+}
+/** 按消息顺序收集 @ 到的 Cell 成员 endpointId */
+export function resolveCellAtMentionedEndpointIds(message, cell, root) {
+    const memberIds = new Set(cell.members.map((m) => m.endpointId));
+    const ordered = [];
+    const fromPeer = isInboundFromCollaborationPeer(message, cell, root);
+    for (const seg of message.$content) {
+        const uid = segmentAtUserId(seg);
+        if (uid && memberIds.has(uid) && !ordered.includes(uid)) {
+            ordered.push(uid);
+            continue;
+        }
+        // Bot 纯文本里的 @endpoint 是「假 @」，不能触发 peer；仅人类入站才做文本兜底。
+        if (!fromPeer && seg.type === 'text' && seg.data?.text) {
+            const text = String(seg.data.text);
+            for (const id of memberIds) {
+                const re = new RegExp(`@${id.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}(?:\\s|$)`);
+                if (re.test(text) && !ordered.includes(id))
+                    ordered.push(id);
+            }
+        }
+    }
+    return ordered;
+}
+/** @deprecated 使用 resolveCellAtMentionedEndpointIds；保留首个 @ 以兼容旧调用 */
+export function resolveCellAtWinnerEndpointId(message, cell) {
+    return resolveCellAtMentionedEndpointIds(message, cell)[0];
+}
+/** 同群多 Bot：仅被 @ 的 Cell 成员响应；未 @ 任何成员时不触发 */
+export function evaluateCellAtOwnership(message, cell, endpointId, root) {
+    if (!cell)
+        return { shouldHandle: true };
+    const mentioned = resolveCellAtMentionedEndpointIds(message, cell, root);
+    // Delegation ownership is owned by the OrchestrationKernel (ADR 0027):
+    // active group_mention tasks, not cell.pipelineState. The inbound pipeline
+    // resolves handback against kernel tasks directly, so this gate is purely
+    // mention-based.
+    if (mentioned.length === 0) {
+        return {
+            shouldHandle: false,
+            mentionedEndpointIds: mentioned,
+            reason: 'cell_mention_required',
+        };
+    }
+    // Bot 编排消息 @ 多个成员时，只认消息序第一个（防 Planner @all 引发全员响应）
+    if (mentioned.length > 1 && isInboundFromCollaborationPeer(message, cell, root)) {
+        const winner = mentioned[0];
+        if (endpointId !== winner) {
+            return {
+                shouldHandle: false,
+                mentionedEndpointIds: mentioned,
+                reason: 'peer_multi_mention_first_only',
+            };
+        }
+        return { shouldHandle: true, mentionedEndpointIds: mentioned };
+    }
+    if (mentioned.includes(endpointId)) {
+        return { shouldHandle: true, mentionedEndpointIds: mentioned };
+    }
+    return {
+        shouldHandle: false,
+        mentionedEndpointIds: mentioned,
+        reason: 'cell_not_mentioned',
+    };
+}
+export function evaluatePeerTrigger(input) {
+    const { message, cell, peerMode, endpointAtIds, root } = input;
+    if (!cell) {
+        return { isPeer: false, shouldTrigger: true };
+    }
+    const senderId = String(message.$sender?.id ?? '');
+    const member = resolveMemberBySender(cell, senderId, root);
+    if (!member) {
+        return { isPeer: false, shouldTrigger: true };
+    }
+    if (peerMode === 'off') {
+        return { isPeer: true, peerEndpointId: member.endpointId, shouldTrigger: true };
+    }
+    if (peerMode === 'mention-only') {
+        const atSelf = isAtEndpoint(message, endpointAtIds);
+        // 协作 Cell：peer 仅认真实 at segment，正文假 @ 不触发（与 harness 委派一致）。
+        if (cell) {
+            return {
+                isPeer: true,
+                peerEndpointId: member.endpointId,
+                shouldTrigger: atSelf,
+                reason: atSelf ? 'peer_mentioned' : 'peer_mention_required',
+            };
+        }
+        const raw = segment.raw(message.$content).trim();
+        const atInText = endpointAtIds.some((id) => raw.includes(`@${id}`));
+        const shouldTrigger = atSelf || atInText;
+        return {
+            isPeer: true,
+            peerEndpointId: member.endpointId,
+            shouldTrigger,
+            reason: shouldTrigger ? 'peer_mentioned' : 'peer_mention_required',
+        };
+    }
+    return { isPeer: true, peerEndpointId: member.endpointId, shouldTrigger: true };
+}
+/** 入站是否来自同 Cell 的另一 Endpoint（Bot↔Bot 协作，非人类用户） */
+export function isInboundFromCollaborationPeer(message, cell, root) {
+    if (!cell)
+        return false;
+    const senderId = String(message.$sender?.id ?? '');
+    if (!senderId)
+        return false;
+    return !!resolveMemberBySender(cell, senderId, root);
+}
+//# sourceMappingURL=peer-policy.js.map

package/lib/collaboration/peer-policy.js.map

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

package/lib/collaboration/resolve-agent-session-key.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 协作群 Agent 会话 key：按 pipeline run 隔离，避免 reset 后旧 IM 上下文污染新 run。
+ */
+import { type Message } from '@zhin.js/core';
+import type { CollaborationScene } from './types.js';
+/**
+ * Agent turn 级 session key SSOT（IM transport + 可选 pipeline run 隔离）。
+ * passive write / @ drain / auto-continue depth / persist 须共用此函数。
+ */
+export declare function resolveAgentTurnSessionKey(message: Message, cell?: CollaborationScene): string;
+/** transport session + 可选 pipeline run 前缀（同 endpoint 不同 run 独立 agent_messages）。 */
+export declare function resolveAgentSessionKeyForTurn(message: Message, cell?: CollaborationScene): string;
+/** legacy pipeline run 解析（支持前缀）；新编排请用 missionRunId / orchestration_status。 */
+export declare function resolveArtifactRunId(runRef: string | undefined, cell: CollaborationScene): {
+    ok: true;
+    runId: string;
+} | {
+    ok: false;
+    error: string;
+};
+//# sourceMappingURL=resolve-agent-session-key.d.ts.map

package/lib/collaboration/resolve-agent-session-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-agent-session-key.d.ts","sourceRoot":"","sources":["../../src/collaboration/resolve-agent-session-key.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAiC,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAgBrD;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,kBAAkB,GACxB,MAAM,CAYR;AAED,mFAAmF;AACnF,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,kBAAkB,GACxB,MAAM,CAER;AAED,8EAA8E;AAC9E,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,EAAE,kBAAkB,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAc5D"}

package/lib/collaboration/resolve-agent-session-key.js

@@ -0,0 +1,61 @@
+/**
+ * 协作群 Agent 会话 key：按 pipeline run 隔离，避免 reset 后旧 IM 上下文污染新 run。
+ */
+import { resolveIMSessionIdFromMessage } from '@zhin.js/core';
+import { resolveRunIdRef } from '../aop/pipeline/pipeline-flow.js';
+import { readCollaborationTurnSnapshot } from './collaboration-turn-snapshot.js';
+import { resolveCollaborationSceneForMessage } from './collaboration-context.js';
+import { findActiveDelegation } from './delegation-state.js';
+function pipelinePrefixedSessionKey(transport, bindRun) {
+    return `pipeline:${bindRun.slice(0, 8)}:${transport}`;
+}
+function resolveBindRunFromCell(cell, endpointId) {
+    const runId = cell.pipelineState?.runId;
+    if (!runId)
+        return undefined;
+    const delegation = findActiveDelegation(cell, endpointId);
+    return delegation?.runId ?? runId;
+}
+/**
+ * Agent turn 级 session key SSOT（IM transport + 可选 pipeline run 隔离）。
+ * passive write / @ drain / auto-continue depth / persist 须共用此函数。
+ */
+export function resolveAgentTurnSessionKey(message, cell) {
+    const transport = resolveIMSessionIdFromMessage(message);
+    const snap = readCollaborationTurnSnapshot(message);
+    if (snap?.runId) {
+        const bindRun = snap.delegationRunId ?? snap.runId;
+        return pipelinePrefixedSessionKey(transport, bindRun);
+    }
+    const resolvedCell = cell ?? resolveCollaborationSceneForMessage(message);
+    if (!resolvedCell)
+        return transport;
+    const bindRun = resolveBindRunFromCell(resolvedCell, String(message.$endpoint ?? ''));
+    if (!bindRun)
+        return transport;
+    return pipelinePrefixedSessionKey(transport, bindRun);
+}
+/** transport session + 可选 pipeline run 前缀（同 endpoint 不同 run 独立 agent_messages）。 */
+export function resolveAgentSessionKeyForTurn(message, cell) {
+    return resolveAgentTurnSessionKey(message, cell);
+}
+/** legacy pipeline run 解析（支持前缀）；新编排请用 missionRunId / orchestration_status。 */
+export function resolveArtifactRunId(runRef, cell) {
+    const state = cell.pipelineState;
+    if (!state)
+        return { ok: false, error: 'pipeline 未初始化' };
+    if (!runRef?.trim())
+        return { ok: true, runId: state.runId };
+    const resolved = resolveRunIdRef(runRef.trim(), state);
+    if (resolved)
+        return { ok: true, runId: resolved };
+    if (state.runHistory?.some((h) => h.runId === runRef || h.runId.startsWith(runRef))) {
+        const match = state.runHistory.find((h) => h.runId === runRef || h.runId.startsWith(runRef));
+        return { ok: true, runId: match.runId };
+    }
+    return {
+        ok: false,
+        error: `runId ${runRef} 未找到；legacy pipeline 已弃用，请用 orchestration_status`,
+    };
+}
+//# sourceMappingURL=resolve-agent-session-key.js.map

package/lib/collaboration/resolve-agent-session-key.js.map

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

package/lib/collaboration/runtime-registry.d.ts

@@ -0,0 +1,18 @@
+/**
+ * AgentRuntimeRegistry — endpoint-scoped ZhinAgent lookup.
+ * Replaces direct refs.zhinAgent for inbound AI turns.
+ */
+import type { ZhinAgent } from '../zhin-agent/index.js';
+export declare class AgentRuntimeRegistry {
+    private defaultRuntime;
+    private byEndpoint;
+    registerDefault(agent: ZhinAgent): void;
+    registerForEndpoint(endpointId: string, agent: ZhinAgent): void;
+    getDefault(): ZhinAgent | null;
+    getForEndpoint(endpointId: string): ZhinAgent | null;
+    listEndpointIds(): string[];
+    clear(): void;
+}
+export declare function getAgentRuntimeRegistry(): AgentRuntimeRegistry;
+export declare function resetAgentRuntimeRegistry(): void;
+//# sourceMappingURL=runtime-registry.d.ts.map

package/lib/collaboration/runtime-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-registry.d.ts","sourceRoot":"","sources":["../../src/collaboration/runtime-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,UAAU,CAAgC;IAElD,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAIvC,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAK/D,UAAU,IAAI,SAAS,GAAG,IAAI;IAI9B,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIpD,eAAe,IAAI,MAAM,EAAE;IAI3B,KAAK,IAAI,IAAI;CAId;AAID,wBAAgB,uBAAuB,IAAI,oBAAoB,CAG9D;AAED,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD"}

package/lib/collaboration/runtime-registry.js

@@ -0,0 +1,40 @@
+/**
+ * AgentRuntimeRegistry — endpoint-scoped ZhinAgent lookup.
+ * Replaces direct refs.zhinAgent for inbound AI turns.
+ */
+export class AgentRuntimeRegistry {
+    defaultRuntime = null;
+    byEndpoint = new Map();
+    registerDefault(agent) {
+        this.defaultRuntime = agent;
+    }
+    registerForEndpoint(endpointId, agent) {
+        this.byEndpoint.set(endpointId, agent);
+        if (!this.defaultRuntime)
+            this.defaultRuntime = agent;
+    }
+    getDefault() {
+        return this.defaultRuntime;
+    }
+    getForEndpoint(endpointId) {
+        return this.byEndpoint.get(endpointId) ?? this.defaultRuntime;
+    }
+    listEndpointIds() {
+        return [...this.byEndpoint.keys()];
+    }
+    clear() {
+        this.defaultRuntime = null;
+        this.byEndpoint.clear();
+    }
+}
+let globalRegistry = null;
+export function getAgentRuntimeRegistry() {
+    if (!globalRegistry)
+        globalRegistry = new AgentRuntimeRegistry();
+    return globalRegistry;
+}
+export function resetAgentRuntimeRegistry() {
+    globalRegistry?.clear();
+    globalRegistry = null;
+}
+//# sourceMappingURL=runtime-registry.js.map

package/lib/collaboration/runtime-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-registry.js","sourceRoot":"","sources":["../../src/collaboration/runtime-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,OAAO,oBAAoB;IACvB,cAAc,GAAqB,IAAI,CAAC;IACxC,UAAU,GAAG,IAAI,GAAG,EAAqB,CAAC;IAElD,eAAe,CAAC,KAAgB;QAC9B,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;IAC9B,CAAC;IAED,mBAAmB,CAAC,UAAkB,EAAE,KAAgB;QACtD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,cAAc;YAAE,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;IACxD,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,cAAc,CAAC,UAAkB;QAC/B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC;IAChE,CAAC;IAED,eAAe;QACb,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC3B,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;CACF;AAED,IAAI,cAAc,GAAgC,IAAI,CAAC;AAEvD,MAAM,UAAU,uBAAuB;IACrC,IAAI,CAAC,cAAc;QAAE,cAAc,GAAG,IAAI,oBAAoB,EAAE,CAAC;IACjE,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,cAAc,EAAE,KAAK,EAAE,CAAC;IACxB,cAAc,GAAG,IAAI,CAAC;AACxB,CAAC"}

package/lib/collaboration/scene-context.d.ts

@@ -0,0 +1,17 @@
+/**
+ * CellContext session key — cross-endpoint coordination projection layer.
+ * Does not replace transport session keys (per ADR 0023 D4).
+ */
+import type { IMSceneKind } from '@zhin.js/core';
+export declare function resolveCollaborationSceneContextKey(adapter: string, sceneId: string): string;
+export declare function resolveCollaborationSceneContextKeyFromMessage(message: {
+    $adapter?: string;
+    $channel?: {
+        type?: IMSceneKind;
+        id?: string;
+    };
+    $sender?: {
+        id?: string;
+    };
+}): string | undefined;
+//# sourceMappingURL=scene-context.d.ts.map

package/lib/collaboration/scene-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-context.d.ts","sourceRoot":"","sources":["../../src/collaboration/scene-context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAK5F;AAED,wBAAgB,8CAA8C,CAAC,OAAO,EAAE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,WAAW,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,OAAO,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3B,GAAG,MAAM,GAAG,SAAS,CAMrB"}

package/lib/collaboration/scene-context.js

@@ -0,0 +1,22 @@
+/**
+ * CellContext session key — cross-endpoint coordination projection layer.
+ * Does not replace transport session keys (per ADR 0023 D4).
+ */
+import { getSceneIdentityService } from './scene-identity-service.js';
+export function resolveCollaborationSceneContextKey(adapter, sceneId) {
+    const svc = getSceneIdentityService();
+    const cell = svc.resolveLogicalScene(adapter, sceneId);
+    if (cell)
+        return `collab-scene:${cell.id}`;
+    return `collab-scene:${String(adapter || 'unknown')}:${String(sceneId || 'unknown')}`;
+}
+export function resolveCollaborationSceneContextKeyFromMessage(message) {
+    const scope = message.$channel?.type || 'private';
+    if (scope !== 'group' && scope !== 'channel')
+        return undefined;
+    const sceneId = message.$channel?.id;
+    if (!sceneId)
+        return undefined;
+    return resolveCollaborationSceneContextKey(String(message.$adapter || ''), sceneId);
+}
+//# sourceMappingURL=scene-context.js.map

package/lib/collaboration/scene-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-context.js","sourceRoot":"","sources":["../../src/collaboration/scene-context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,MAAM,UAAU,mCAAmC,CAAC,OAAe,EAAE,OAAe;IAClF,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAC;IACtC,MAAM,IAAI,GAAG,GAAG,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACvD,IAAI,IAAI;QAAE,OAAO,gBAAgB,IAAI,CAAC,EAAE,EAAE,CAAC;IAC3C,OAAO,gBAAgB,MAAM,CAAC,OAAO,IAAI,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,IAAI,SAAS,CAAC,EAAE,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,8CAA8C,CAAC,OAI9D;IACC,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,IAAI,IAAI,SAAS,CAAC;IAClD,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC/D,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;IACrC,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,OAAO,mCAAmC,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;AACtF,CAAC"}