@zhin.js/agent 0.3.1 → 1.0.2

package/lib/collaboration/inbound-turn-pipeline.js

@@ -0,0 +1,193 @@
+/**
+ * InboundTurnPipeline — Agent Orchestration Plane entry (ADR 0023).
+ *
+ * Stages: enrich → peerPolicy → buildTurnPlan → route/execute → outbound
+ * Turn 路由/执行/出站委托 `inbound-turn-route` / `inbound-turn-outbound-stage`（阶段 4）。
+ */
+import { checkAIAccess } from '@zhin.js/core';
+import { formatCompactLog, truncatePreview } from '@zhin.js/logger';
+import { discoverWorkspaceAgents } from '../discovery/agents.js';
+import { formatAiHandlerCompleteLog } from '../turn/turn-metrics.js';
+import { evaluateCellAtOwnership, evaluatePeerTrigger, isInboundFromCollaborationPeer } from './peer-policy.js';
+import { buildTurnPlan } from './turn-plan-resolver.js';
+import { getCollaborationSceneService } from './scene-service.js';
+import { findCellForInbound } from './collaboration-config.js';
+import { tryHandlePeerInboundHandback } from './inbound-peer-handback.js';
+import { routeInboundTurnExecution } from './inbound-turn-route.js';
+import { executeInboundOutboundStage } from './inbound-turn-outbound-stage.js';
+import { resolveEndpointAtIds, resolveEndpointAiAccess } from './inbound-turn-endpoint.js';
+import { prepareInboundTurnEnrichment } from './inbound-turn-enrich.js';
+import { getAgentRuntimeRegistry } from './runtime-registry.js';
+function logInboundHandlerComplete(logger, t0, zhinAgent, path) {
+    const totalMs = performance.now() - t0;
+    const turnMetrics = zhinAgent.getLastTurnMetrics();
+    if (turnMetrics) {
+        logger.info(formatAiHandlerCompleteLog(turnMetrics, totalMs));
+        return;
+    }
+    logger.info(formatCompactLog('AI Handler', {
+        total_ms: Math.round(totalMs),
+        ...(path ? { path } : { usage: 'n/a' }),
+    }));
+}
+export function createInboundTurnPipeline(deps) {
+    const { root, ai, refs, triggerConfig, peerMode, logger, replyOutbound } = deps;
+    return async (message, content) => {
+        const t0 = performance.now();
+        const endpointId = String(message.$endpoint);
+        if (!ai.isReady()) {
+            logger.warn(formatCompactLog('AI Handler', { skip: 'not_ready', endpoint: endpointId }));
+            await replyOutbound('AI 服务未就绪，请检查 zhin.config.yml 中的 providers 配置。');
+            return;
+        }
+        const registry = getAgentRuntimeRegistry();
+        const zhinAgent = registry.getForEndpoint(endpointId) ?? refs.zhinAgent;
+        if (!zhinAgent) {
+            logger.warn(formatCompactLog('AI Handler', { skip: 'no_zhin_agent', endpoint: endpointId }));
+            await replyOutbound('AI Agent 未初始化，请查看启动日志。');
+            return;
+        }
+        const access = checkAIAccess(message, ai.getAccessConfig?.(), resolveEndpointAiAccess(message, root));
+        if (!access.allowed) {
+            logger.info(formatCompactLog('AI Access', {
+                adapter: message.$adapter,
+                endpoint: endpointId,
+                channel: message.$channel?.type,
+                allowed: false,
+                reason: access.reason,
+            }));
+            if (access.replyMessage)
+                await replyOutbound(access.replyMessage);
+            return;
+        }
+        const endpointAtIds = resolveEndpointAtIds(message, root);
+        const cellService = getCollaborationSceneService();
+        const scope = message.$channel?.type || 'private';
+        const sceneId = message.$channel?.id ?? '';
+        let cell = (scope === 'group' || scope === 'channel') && sceneId !== ''
+            ? findCellForInbound(cellService.listScenes(), String(message.$adapter), String(sceneId), endpointId)
+            : undefined;
+        if (cell) {
+            const fresh = await cellService.getSceneFresh(cell.id);
+            if (fresh)
+                cell = fresh;
+        }
+        const peerResult = evaluatePeerTrigger({
+            message,
+            cell,
+            peerMode,
+            endpointAtIds,
+            root,
+        });
+        if (peerResult.isPeer && !peerResult.shouldTrigger) {
+            logger.debug(formatCompactLog('AI Handler', {
+                skip: 'peer_mention_required',
+                peer: peerResult.peerEndpointId,
+                reason: peerResult.reason,
+            }));
+            return;
+        }
+        const atOwnership = evaluateCellAtOwnership(message, cell, endpointId, root);
+        if (!atOwnership.shouldHandle) {
+            logger.debug(formatCompactLog('AI Handler', {
+                skip: atOwnership.reason ?? 'cell_at_filter',
+                mentioned: atOwnership.mentionedEndpointIds?.join(','),
+                endpoint: endpointId,
+            }));
+            return;
+        }
+        const peerInbound = isInboundFromCollaborationPeer(message, cell, root);
+        const replyAi = (payload) => replyOutbound(payload, { quote: !peerInbound });
+        if (peerInbound && cell && peerResult.peerEndpointId) {
+            const handbackDone = await tryHandlePeerInboundHandback({
+                message,
+                cell,
+                peerEndpointId: peerResult.peerEndpointId,
+                replyAi,
+                logger,
+            });
+            if (handbackDone)
+                return;
+        }
+        if (triggerConfig.thinkingMessage)
+            await replyAi(triggerConfig.thinkingMessage);
+        try {
+            const resolveQuotes = Boolean(triggerConfig.resolveQuotedMessages && !peerInbound);
+            const { commMessage, mediaParts, aiContent, onChunk } = await prepareInboundTurnEnrichment({
+                root,
+                message,
+                content,
+                cell,
+                resolveQuotes,
+                replyOutbound,
+                logger,
+                t0,
+            });
+            const routing = refs.aiService?.getRoutingConfig();
+            const bindingRegistry = refs.aiService?.getBindingRegistry();
+            let discoveredAgentNames = new Set();
+            if (refs.aiService && routing && bindingRegistry) {
+                const agentMetas = await discoverWorkspaceAgents(root);
+                refs.aiService.setDiscoveredAgents(agentMetas);
+                discoveredAgentNames = bindingRegistry.getDiscoveredAgentNames();
+            }
+            const turnPlan = buildTurnPlan({
+                message,
+                contentText: aiContent,
+                endpointId,
+                endpointIds: endpointAtIds,
+                cells: cellService.listScenes(),
+                agents: routing?.agents ?? {},
+                discoveredAgentNames,
+            });
+            logger.debug(formatCompactLog('AI Handler', {
+                turn_plan: turnPlan.handlerProfile,
+                cell: turnPlan.collaborationSceneId,
+                delegation: turnPlan.delegation?.mode,
+            }));
+            const routeResult = await routeInboundTurnExecution({
+                root,
+                ai,
+                zhinAgent,
+                commMessage,
+                message,
+                aiContent,
+                turnPlan,
+                cell,
+                endpointId,
+                refs,
+                bindingRegistry: bindingRegistry ?? undefined,
+                mediaParts,
+                onChunk,
+                replyAi,
+                logger,
+            });
+            if (routeResult.kind === 'done') {
+                logInboundHandlerComplete(logger, t0, zhinAgent, 'routed_done');
+                return;
+            }
+            cell = await executeInboundOutboundStage({
+                root,
+                message,
+                elements: routeResult.elements,
+                aiContent,
+                cell: routeResult.cell,
+                endpointId,
+                peerInbound,
+                replyOutbound,
+                logger,
+            });
+            logInboundHandlerComplete(logger, t0, zhinAgent);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            logger.warn(formatCompactLog('AI Handler', {
+                total_ms: Math.round(performance.now() - t0),
+                ok: false,
+                error: truncatePreview(msg),
+            }));
+            await replyAi((triggerConfig.errorTemplate ?? '❌ AI 处理失败: {error}').replace('{error}', msg));
+        }
+    };
+}
+//# sourceMappingURL=inbound-turn-pipeline.js.map

package/lib/collaboration/inbound-turn-pipeline.js.map

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

package/lib/collaboration/inbound-turn-route.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 入站 turn 路由 — Kernel 委派 / spawn_task / 本地 ZhinAgent（阶段 4）。
+ */
+import type { Plugin, Message, AgentTurnMessage } from '@zhin.js/core';
+import type { ContentPart, OutputElement } from '@zhin.js/ai';
+import type { AIServiceRefs } from '../init/shared-refs.js';
+import { type ResolvedAgentBinding } from '../config/types.js';
+import type { CollaborationScene, TurnPlan } from './types.js';
+import type { ZhinAgent } from '../zhin-agent/index.js';
+import type { AIService } from '../service.js';
+export type InboundTurnRouteResult = {
+    kind: 'done';
+} | {
+    kind: 'local';
+    elements: OutputElement[];
+    cell?: CollaborationScene;
+};
+export interface RouteInboundTurnExecutionInput {
+    root: Plugin;
+    ai: AIService;
+    zhinAgent: ZhinAgent;
+    commMessage: AgentTurnMessage;
+    message: Message;
+    aiContent: string;
+    turnPlan: TurnPlan;
+    cell?: CollaborationScene;
+    endpointId: string;
+    refs: AIServiceRefs;
+    bindingRegistry?: {
+        getBinding(name: string): ResolvedAgentBinding | null | undefined;
+        requireZhinBinding(): ResolvedAgentBinding;
+    };
+    mediaParts: ContentPart[];
+    onChunk?: (chunk: string, full: string) => void;
+    replyAi: (payload: unknown) => Promise<unknown>;
+    logger: {
+        info: (...args: unknown[]) => void;
+        warn: (...args: unknown[]) => void;
+    };
+}
+export declare function routeInboundTurnExecution(input: RouteInboundTurnExecutionInput): Promise<InboundTurnRouteResult>;
+//# sourceMappingURL=inbound-turn-route.d.ts.map

package/lib/collaboration/inbound-turn-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-turn-route.d.ts","sourceRoot":"","sources":["../../src/collaboration/inbound-turn-route.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAA2B,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAKxF,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAE5E,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,SAAS,CAAC;IACd,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,aAAa,CAAC;IACpB,eAAe,CAAC,EAAE;QAChB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,GAAG,SAAS,CAAC;QAClE,kBAAkB,IAAI,oBAAoB,CAAC;KAC5C,CAAC;IACF,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;KAAE,CAAC;CACpF;AAED,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CA2GjC"}

package/lib/collaboration/inbound-turn-route.js

@@ -0,0 +1,90 @@
+import { formatCompactLog } from '@zhin.js/logger';
+import { DEFAULT_ZHIN_AGENT_NAME } from '../config/types.js';
+import { dispatchPeerTask } from './collaboration-dispatch.js';
+import { executeInboundSpawnTaskTurn } from './inbound-spawn-task.js';
+import { executeInboundAgentTurn } from './inbound-turn-execute.js';
+import { collectInboundTurnTools } from './inbound-turn-tools.js';
+export async function routeInboundTurnExecution(input) {
+    const { root, ai, zhinAgent, commMessage, message, aiContent, turnPlan, cell: initialCell, endpointId, refs, bindingRegistry, mediaParts, onChunk, replyAi, logger, } = input;
+    const cell = initialCell;
+    const peerTarget = turnPlan.delegation?.delegateToPeer ?? turnPlan.delegation?.targetEndpointId;
+    if (peerTarget && peerTarget !== endpointId && cell) {
+        const delegateText = aiContent.trim() || '请处理上述协作请求。';
+        try {
+            const dispatched = await dispatchPeerTask({
+                cell,
+                fromEndpointId: endpointId,
+                toEndpointId: peerTarget,
+                goal: delegateText,
+                handlerProfile: turnPlan.handlerProfile,
+                message: commMessage,
+            });
+            if (dispatched.task.status === 'completed'
+                || dispatched.task.status === 'waiting_result'
+                || dispatched.task.status === 'running') {
+                logger.info(formatCompactLog('AI Handler', {
+                    path: 'kernel_internal_room',
+                    run: dispatched.runId,
+                    task: dispatched.taskId,
+                    from: endpointId,
+                    to: peerTarget,
+                    agent: turnPlan.handlerProfile,
+                }));
+                return { kind: 'done' };
+            }
+            logger.warn(formatCompactLog('AI Handler', {
+                path: 'kernel_internal_room_failed',
+                task: dispatched.taskId,
+                error: dispatched.task.error,
+                fallback: 'local_process',
+            }));
+        }
+        catch (err) {
+            logger.warn(formatCompactLog('AI Handler', {
+                path: 'kernel_internal_room_failed',
+                error: err instanceof Error ? err.message : String(err),
+                fallback: 'local_process',
+            }));
+        }
+    }
+    if (turnPlan.delegation?.mode === 'spawn_task'
+        && turnPlan.delegation.targetAgentId
+        && turnPlan.delegation.targetAgentId !== DEFAULT_ZHIN_AGENT_NAME) {
+        const spawnResult = await executeInboundSpawnTaskTurn({
+            zhinAgent,
+            commMessage,
+            message,
+            aiContent,
+            delegation: turnPlan.delegation,
+            cell,
+            bindingRegistry,
+            replyAi,
+            logger,
+        });
+        if (spawnResult.handled)
+            return { kind: 'done' };
+    }
+    const handlerBinding = bindingRegistry?.getBinding(turnPlan.handlerProfile)
+        ?? bindingRegistry?.getBinding(DEFAULT_ZHIN_AGENT_NAME)
+        ?? bindingRegistry?.requireZhinBinding();
+    const externalTools = collectInboundTurnTools({ root, ai, commMessage, cell });
+    const localResult = await executeInboundAgentTurn({
+        zhinAgent,
+        commMessage,
+        aiContent,
+        externalTools,
+        mediaParts,
+        handlerBinding: handlerBinding ?? null,
+        refs,
+        cell,
+        endpointId,
+        onChunk,
+        logger,
+    });
+    return {
+        kind: 'local',
+        elements: localResult.elements,
+        cell: localResult.cell,
+    };
+}
+//# sourceMappingURL=inbound-turn-route.js.map

package/lib/collaboration/inbound-turn-route.js.map

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

package/lib/collaboration/inbound-turn-tools.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 入站 turn 外部工具收集（IM 策略层；阶段 4）。
+ */
+import type { Plugin, Tool, AgentTurnMessage } from '@zhin.js/core';
+import type { AIService } from '../service.js';
+import type { CollaborationScene } from './types.js';
+export declare function collectInboundTurnTools(input: {
+    root: Plugin;
+    ai: AIService;
+    commMessage: AgentTurnMessage;
+    cell?: CollaborationScene;
+}): Tool[];
+//# sourceMappingURL=inbound-turn-tools.d.ts.map

package/lib/collaboration/inbound-turn-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-turn-tools.d.ts","sourceRoot":"","sources":["../../src/collaboration/inbound-turn-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,SAAS,CAAC;IACd,WAAW,EAAE,gBAAgB,CAAC;IAC9B,IAAI,CAAC,EAAE,kBAAkB,CAAC;CAC3B,GAAG,IAAI,EAAE,CAcT"}

package/lib/collaboration/inbound-turn-tools.js

@@ -0,0 +1,19 @@
+import { canAccessTool } from '../orchestrator/tool-selection.js';
+import { createOrchestrationTools } from '../builtin/orchestration-tools.js';
+export function collectInboundTurnTools(input) {
+    const { root, ai, commMessage, cell } = input;
+    const toolService = root.inject('tool');
+    let externalTools = [...ai.getResidentToolsAsTools()];
+    if (toolService) {
+        externalTools.push(...toolService.getAll());
+        externalTools = toolService.filterByContext(externalTools, commMessage);
+    }
+    else {
+        externalTools = externalTools.filter((t) => canAccessTool(t, commMessage));
+    }
+    if (cell) {
+        externalTools.push(...createOrchestrationTools(commMessage));
+    }
+    return externalTools;
+}
+//# sourceMappingURL=inbound-turn-tools.js.map

package/lib/collaboration/inbound-turn-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound-turn-tools.js","sourceRoot":"","sources":["../../src/collaboration/inbound-turn-tools.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAI7E,MAAM,UAAU,uBAAuB,CAAC,KAKvC;IACC,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,aAAa,GAAW,CAAC,GAAG,EAAE,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC9D,IAAI,WAAW,EAAE,CAAC;QAChB,aAAa,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5C,aAAa,GAAG,WAAW,CAAC,eAAe,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IAC1E,CAAC;SAAM,CAAC;QACN,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,IAAI,EAAE,CAAC;QACT,aAAa,CAAC,IAAI,CAAC,GAAG,wBAAwB,CAAC,WAAW,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/lib/collaboration/index.d.ts

@@ -0,0 +1,26 @@
+export * from './types.js';
+export * from './scene-context.js';
+export * from './collaboration-config.js';
+export * from './peer-policy.js';
+export * from './turn-plan-resolver.js';
+export * from './runtime-registry.js';
+export * from './scene-service.js';
+export * from './bootstrap-agent-runtimes.js';
+export * from './endpoint-identity.js';
+export { wireCollaborationStorage } from './wire-collaboration-storage.js';
+export { getSceneIdentityService, setSceneIdentityService, createSceneIdentityService, } from './scene-identity-service.js';
+export type { MemberChannelRecord, GroupView, GroupViewAgent, } from './scene-identity-service.js';
+export { checkCollabAdminGate } from './collab-admin-gate.js';
+export { observeAtForInitWizard, extractAtTargets, buildRegisteredEndpointMap } from './init-observe-hook.js';
+export { startInitWizard, aggregateAndActivate, cancelInitWizard } from './init-wizard-service.js';
+export { COLLABORATION_SCENE_MODEL, COLLABORATION_SCENE_MEMBER_MODEL, COLLABORATION_SCENE_ARTIFACT_MODEL, COLLABORATION_SCENE_ALIAS_MODEL, COLLABORATION_INIT_SESSION_MODEL, COLLABORATION_INIT_OBSERVATION_MODEL, COLLABORATION_SCENE_MEMBER_CHANNEL_MODEL, } from './collaboration-db-model.js';
+export { getCollaborationSceneRepository, setCollaborationSceneRepository, MemoryCollaborationSceneRepository, DatabaseCollaborationSceneRepository, } from './collaboration-scene-repository.js';
+export { getCollaborationArtifactRepository, setCollaborationArtifactRepository, createCollaborationArtifactRepository, MemoryCollaborationArtifactRepository, DatabaseCollaborationArtifactRepository, } from './collaboration-artifact-repository.js';
+export { createInboundTurnPipeline } from './inbound-turn-pipeline.js';
+export { routeInboundTurnExecution } from './inbound-turn-route.js';
+export { executeInboundOutboundStage } from './inbound-turn-outbound-stage.js';
+export { prepareInboundTurnEnrichment } from './inbound-turn-enrich.js';
+export { resolveEndpointConfig, resolveEndpointAtIds, resolveEndpointAiAccess } from './inbound-turn-endpoint.js';
+export { resolvePlannerEndpointId } from './collaboration-delegation.js';
+export type { InboundTurnPipeline, InboundTurnPipelineDeps, } from './inbound-turn-pipeline.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/collaboration/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collaboration/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,mBAAmB,EACnB,SAAS,EACT,cAAc,GACf,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAC9G,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACnG,OAAO,EACL,yBAAyB,EACzB,gCAAgC,EAChC,kCAAkC,EAClC,+BAA+B,EAC/B,gCAAgC,EAChC,oCAAoC,EACpC,wCAAwC,GACzC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,+BAA+B,EAC/B,+BAA+B,EAC/B,kCAAkC,EAClC,oCAAoC,GACrC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,kCAAkC,EAClC,kCAAkC,EAClC,qCAAqC,EACrC,qCAAqC,EACrC,uCAAuC,GACxC,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAClH,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,YAAY,EACV,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,4BAA4B,CAAC"}

package/lib/collaboration/index.js

@@ -0,0 +1,24 @@
+export * from './types.js';
+export * from './scene-context.js';
+export * from './collaboration-config.js';
+export * from './peer-policy.js';
+export * from './turn-plan-resolver.js';
+export * from './runtime-registry.js';
+export * from './scene-service.js';
+export * from './bootstrap-agent-runtimes.js';
+export * from './endpoint-identity.js';
+export { wireCollaborationStorage } from './wire-collaboration-storage.js';
+export { getSceneIdentityService, setSceneIdentityService, createSceneIdentityService, } from './scene-identity-service.js';
+export { checkCollabAdminGate } from './collab-admin-gate.js';
+export { observeAtForInitWizard, extractAtTargets, buildRegisteredEndpointMap } from './init-observe-hook.js';
+export { startInitWizard, aggregateAndActivate, cancelInitWizard } from './init-wizard-service.js';
+export { COLLABORATION_SCENE_MODEL, COLLABORATION_SCENE_MEMBER_MODEL, COLLABORATION_SCENE_ARTIFACT_MODEL, COLLABORATION_SCENE_ALIAS_MODEL, COLLABORATION_INIT_SESSION_MODEL, COLLABORATION_INIT_OBSERVATION_MODEL, COLLABORATION_SCENE_MEMBER_CHANNEL_MODEL, } from './collaboration-db-model.js';
+export { getCollaborationSceneRepository, setCollaborationSceneRepository, MemoryCollaborationSceneRepository, DatabaseCollaborationSceneRepository, } from './collaboration-scene-repository.js';
+export { getCollaborationArtifactRepository, setCollaborationArtifactRepository, createCollaborationArtifactRepository, MemoryCollaborationArtifactRepository, DatabaseCollaborationArtifactRepository, } from './collaboration-artifact-repository.js';
+export { createInboundTurnPipeline } from './inbound-turn-pipeline.js';
+export { routeInboundTurnExecution } from './inbound-turn-route.js';
+export { executeInboundOutboundStage } from './inbound-turn-outbound-stage.js';
+export { prepareInboundTurnEnrichment } from './inbound-turn-enrich.js';
+export { resolveEndpointConfig, resolveEndpointAtIds, resolveEndpointAiAccess } from './inbound-turn-endpoint.js';
+export { resolvePlannerEndpointId } from './collaboration-delegation.js';
+//# sourceMappingURL=index.js.map

package/lib/collaboration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/collaboration/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,6BAA6B,CAAC;AAMrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAC9G,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACnG,OAAO,EACL,yBAAyB,EACzB,gCAAgC,EAChC,kCAAkC,EAClC,+BAA+B,EAC/B,gCAAgC,EAChC,oCAAoC,EACpC,wCAAwC,GACzC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,+BAA+B,EAC/B,+BAA+B,EAC/B,kCAAkC,EAClC,oCAAoC,GACrC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,kCAAkC,EAClC,kCAAkC,EAClC,qCAAqC,EACrC,qCAAqC,EACrC,uCAAuC,GACxC,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAClH,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC"}

package/lib/collaboration/init-observe-hook.d.ts

@@ -0,0 +1,59 @@
+/**
+ * InitObservationHook — waiting 态 endpoint 被动记录 master @ 事件。
+ *
+ * 在 init 向导阶段，所有 collaboration.enabled 的 endpoint 观测入站消息：
+ * 若消息含 at segment 且指向已注册的系统 Bot → 写 init_observation。
+ * Planner 在 advance 时读取 observations 推进步骤。
+ */
+import type { Message, Plugin } from '@zhin.js/core';
+/**
+ * 从 at 消息段提取平台 id（兼容 qq / user_id / id）。
+ */
+export declare function atSegmentPlatformId(data: Record<string, unknown> | undefined): string | undefined;
+/**
+ * 提取消息中 at segment 的 target id 列表。
+ */
+export declare function extractAtTargets(message: Message): string[];
+/**
+ * 判断当前 endpoint 是否是已注册的系统 Bot。
+ */
+export declare function isRegisteredEndpoint(root: Plugin, platformId: string): {
+    adapter: string;
+    endpointId: string;
+} | undefined;
+/**
+ * 列出所有已注册的系统 Bot 的 (platformId → adapter, endpointId) 映射。
+ */
+export declare function buildRegisteredEndpointMap(root: Plugin): Map<string, {
+    adapter: string;
+    endpointId: string;
+}>;
+export interface ObserveAtResult {
+    observed: boolean;
+    advanceResult?: {
+        nextPrompt: string;
+        done: boolean;
+        advanced: boolean;
+    };
+}
+export type InitWizardInboundGateResult = {
+    action: 'continue';
+} | {
+    action: 'block';
+    replied?: boolean;
+};
+/**
+ * init 向导收集阶段入站门控：
+ * - 非 Planner bot：只 stash，不搭话（block）
+ * - Planner：@ 分配角色后回复下一步 prompt（block）
+ * - /collab 命令：放行给 command 分支（continue）
+ */
+export declare function handleInitWizardInboundGate(message: Message, endpointId: string, root: Plugin): Promise<InitWizardInboundGateResult>;
+/**
+ * 入站消息观测：若当前有 active init session 且消息含 @ 到系统 Bot → 写 observation。
+ *
+ * 由 Planner endpoint 调用 advanceWizardStep 推进步骤；
+ * 非 Planner endpoint 仅记录 observation。
+ */
+export declare function observeAtForInitWizard(message: Message, endpointId: string, root: Plugin): Promise<ObserveAtResult>;
+//# sourceMappingURL=init-observe-hook.d.ts.map

package/lib/collaboration/init-observe-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-observe-hook.d.ts","sourceRoot":"","sources":["../../src/collaboration/init-observe-hook.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAKrD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACxC,MAAM,GAAG,SAAS,CASpB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAQ3D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAsBrD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,GACX,GAAG,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAqBtD;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;CAC1E;AAKD,MAAM,MAAM,2BAA2B,GACnC;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,GACtB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE3C;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,2BAA2B,CAAC,CA4BtC;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,eAAe,CAAC,CAyD1B"}