@zhin.js/agent 0.3.1 → 1.0.2

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

@@ -0,0 +1,65 @@
+/**
+ * CollaborationSceneService — repository-backed GroupCell access with memory cache.
+ */
+import type { CollaborationScene } from './types.js';
+import { type CollaborationSceneRepository, type UpsertCollaborationSceneInput } from './collaboration-scene-repository.js';
+export interface SceneStoreSnapshot {
+    id: string;
+    adapter: string;
+    sceneId: string;
+    goal?: string;
+    missionRunId?: string;
+    members: CollaborationScene['members'];
+    version: number;
+}
+export declare class CollaborationSceneService {
+    private cache;
+    private repository;
+    constructor(repository?: CollaborationSceneRepository);
+    setRepository(repository: CollaborationSceneRepository): void;
+    /** 从数据库重载（启动后或 REST / /collab 变更后可调用） */
+    reloadFromRepository(): Promise<CollaborationScene[]>;
+    listScenes(): CollaborationScene[];
+    getScene(id: string): CollaborationScene | undefined;
+    findByScene(adapter: string, sceneId: string): CollaborationScene | undefined;
+    getSceneFresh(id: string): Promise<CollaborationScene | null>;
+    upsertScene(input: UpsertCollaborationSceneInput): Promise<CollaborationScene>;
+    setGoal(collaborationSceneId: string, goal: string, expectedVersion?: number): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    getMissionStatus(collaborationSceneId: string): {
+        goal?: string;
+        missionRunId?: string;
+        version?: number;
+    } | undefined;
+    setMissionRunId(collaborationSceneId: string, missionRunId: string): Promise<void>;
+    setPipelineState(collaborationSceneId: string, state: import('./types.js').PipelineState): Promise<void>;
+    patchPipelineState(collaborationSceneId: string, patch: (prev: import('./types.js').PipelineState | undefined, cell: CollaborationScene) => import('./types.js').PipelineState | undefined, maxRetries?: number): Promise<{
+        ok: true;
+        scene: CollaborationScene;
+    } | {
+        ok: false;
+        error: string;
+        conflict?: boolean;
+    }>;
+    deleteScene(collaborationSceneId: string): Promise<boolean>;
+    listMembers(collaborationSceneId: string): Promise<import('./collaboration-db-model.js').CollaborationSceneMemberRecord[]>;
+    findScenesByEndpoint(endpointId: string): Promise<CollaborationScene[]>;
+    addMember(collaborationSceneId: string, input: import('./collaboration-db-model.js').UpsertCollaborationMemberInput): Promise<{
+        ok: boolean;
+        member?: import('./collaboration-db-model.js').CollaborationSceneMemberRecord;
+        error?: string;
+    }>;
+    updateMember(collaborationSceneId: string, endpointId: string, patch: Partial<import('./collaboration-db-model.js').UpsertCollaborationMemberInput>): Promise<{
+        ok: boolean;
+        member?: import('./collaboration-db-model.js').CollaborationSceneMemberRecord;
+        error?: string;
+    }>;
+    removeMember(collaborationSceneId: string, endpointId: string): Promise<boolean>;
+    toSnapshot(cell: CollaborationScene): SceneStoreSnapshot;
+}
+export declare function getCollaborationSceneService(): CollaborationSceneService;
+export declare function initCollaborationSceneService(): Promise<CollaborationSceneService>;
+export declare function resetCollaborationSceneService(): void;
+//# sourceMappingURL=scene-service.d.ts.map

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

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

package/lib/collaboration/scene-service.js

@@ -0,0 +1,152 @@
+/**
+ * CollaborationSceneService — repository-backed GroupCell access with memory cache.
+ */
+import { getCollaborationSceneRepository, } from './collaboration-scene-repository.js';
+export class CollaborationSceneService {
+    cache = new Map();
+    repository;
+    constructor(repository) {
+        this.repository = repository ?? getCollaborationSceneRepository();
+    }
+    setRepository(repository) {
+        this.repository = repository;
+        this.cache.clear();
+    }
+    /** 从数据库重载（启动后或 REST / /collab 变更后可调用） */
+    async reloadFromRepository() {
+        const cells = await this.repository.listEnabled();
+        this.cache.clear();
+        for (const cell of cells) {
+            this.cache.set(cell.id, cell);
+        }
+        return cells;
+    }
+    listScenes() {
+        return [...this.cache.values()];
+    }
+    getScene(id) {
+        return this.cache.get(id);
+    }
+    findByScene(adapter, sceneId) {
+        const ad = String(adapter);
+        const sid = String(sceneId);
+        return [...this.cache.values()].find((c) => c.adapter === ad && String(c.sceneId) === sid);
+    }
+    async getSceneFresh(id) {
+        const cell = await this.repository.getById(id);
+        if (cell)
+            this.cache.set(id, cell);
+        return cell;
+    }
+    async upsertScene(input) {
+        const cell = await this.repository.upsert(input);
+        this.cache.set(cell.id, cell);
+        return cell;
+    }
+    async setGoal(collaborationSceneId, goal, expectedVersion) {
+        const result = await this.repository.updateGoal(collaborationSceneId, goal, expectedVersion);
+        if (!result.ok)
+            return result;
+        this.cache.set(collaborationSceneId, result.scene);
+        return { ok: true };
+    }
+    getMissionStatus(collaborationSceneId) {
+        const cell = this.getScene(collaborationSceneId);
+        if (!cell)
+            return undefined;
+        return {
+            goal: cell.goal,
+            missionRunId: cell.missionRunId,
+            version: cell.version,
+        };
+    }
+    async setMissionRunId(collaborationSceneId, missionRunId) {
+        await this.repository.setMissionRunId(collaborationSceneId, missionRunId);
+        const cell = await this.repository.getById(collaborationSceneId);
+        if (cell)
+            this.cache.set(collaborationSceneId, cell);
+    }
+    async setPipelineState(collaborationSceneId, state) {
+        await this.repository.setPipelineState(collaborationSceneId, state);
+        const cell = await this.repository.getById(collaborationSceneId);
+        if (cell)
+            this.cache.set(collaborationSceneId, cell);
+    }
+    async patchPipelineState(collaborationSceneId, patch, maxRetries) {
+        const result = await this.repository.patchPipelineState(collaborationSceneId, patch, maxRetries);
+        if (result.ok)
+            this.cache.set(collaborationSceneId, result.scene);
+        return result;
+    }
+    async deleteScene(collaborationSceneId) {
+        const ok = await this.repository.delete(collaborationSceneId);
+        if (ok)
+            this.cache.delete(collaborationSceneId);
+        return ok;
+    }
+    async listMembers(collaborationSceneId) {
+        return this.repository.listMembers(collaborationSceneId);
+    }
+    async findScenesByEndpoint(endpointId) {
+        const cells = await this.repository.findScenesByEndpoint(endpointId);
+        for (const cell of cells)
+            this.cache.set(cell.id, cell);
+        return cells;
+    }
+    async addMember(collaborationSceneId, input) {
+        const result = await this.repository.addMember(collaborationSceneId, input);
+        if (!result.ok)
+            return result;
+        const cell = await this.repository.getById(collaborationSceneId);
+        if (cell)
+            this.cache.set(collaborationSceneId, cell);
+        return { ok: true, member: result.member };
+    }
+    async updateMember(collaborationSceneId, endpointId, patch) {
+        const result = await this.repository.updateMember(collaborationSceneId, endpointId, patch);
+        if (!result.ok)
+            return result;
+        const cell = await this.repository.getById(collaborationSceneId);
+        if (cell)
+            this.cache.set(collaborationSceneId, cell);
+        return { ok: true, member: result.member };
+    }
+    async removeMember(collaborationSceneId, endpointId) {
+        const ok = await this.repository.removeMember(collaborationSceneId, endpointId);
+        if (ok) {
+            const cell = await this.repository.getById(collaborationSceneId);
+            if (cell)
+                this.cache.set(collaborationSceneId, cell);
+            else
+                this.cache.delete(collaborationSceneId);
+        }
+        return ok;
+    }
+    toSnapshot(cell) {
+        return {
+            id: cell.id,
+            adapter: cell.adapter,
+            sceneId: cell.sceneId,
+            goal: cell.goal,
+            missionRunId: cell.missionRunId,
+            members: cell.members,
+            version: cell.version ?? 0,
+        };
+    }
+}
+let globalSceneService = null;
+export function getCollaborationSceneService() {
+    if (!globalSceneService) {
+        globalSceneService = new CollaborationSceneService();
+    }
+    return globalSceneService;
+}
+export async function initCollaborationSceneService() {
+    const svc = getCollaborationSceneService();
+    await svc.reloadFromRepository();
+    return svc;
+}
+export function resetCollaborationSceneService() {
+    globalSceneService = null;
+}
+//# sourceMappingURL=scene-service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scene-service.js","sourceRoot":"","sources":["../../src/collaboration/scene-service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,+BAA+B,GAGhC,MAAM,qCAAqC,CAAC;AAY7C,MAAM,OAAO,yBAAyB;IAC5B,KAAK,GAAG,IAAI,GAAG,EAA8B,CAAC;IAC9C,UAAU,CAA+B;IAEjD,YAAY,UAAyC;QACnD,IAAI,CAAC,UAAU,GAAG,UAAU,IAAI,+BAA+B,EAAE,CAAC;IACpE,CAAC;IAED,aAAa,CAAC,UAAwC;QACpD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,yCAAyC;IACzC,KAAK,CAAC,oBAAoB;QACxB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;QAClD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,QAAQ,CAAC,EAAU;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,WAAW,CAAC,OAAe,EAAE,OAAe;QAC1C,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5B,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAClC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,GAAG,CACrD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,EAAU;QAC5B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC/C,IAAI,IAAI;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAoC;QACpD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,oBAA4B,EAAE,IAAY,EAAE,eAAwB;QAChF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,oBAAoB,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;QAC7F,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,MAAM,CAAC;QAC9B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QACnD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;IAED,gBAAgB,CAAC,oBAA4B;QAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QAC5B,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,oBAA4B,EAAE,YAAoB;QACtE,MAAM,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,oBAAoB,EAAE,YAAY,CAAC,CAAC;QAC1E,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACjE,IAAI,IAAI;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,oBAA4B,EAAE,KAAyC;QAC5F,MAAM,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACjE,IAAI,IAAI;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,kBAAkB,CACtB,oBAA4B,EAC5B,KAGmD,EACnD,UAAmB;QAInB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,oBAAoB,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;QACjG,IAAI,MAAM,CAAC,EAAE;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAClE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,oBAA4B;QAC5C,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAC9D,IAAI,EAAE;YAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAChD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,oBAA4B;QAC5C,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,UAAkB;QAC3C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;QACrE,KAAK,MAAM,IAAI,IAAI,KAAK;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACxD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,SAAS,CACb,oBAA4B,EAC5B,KAA2E;QAE3E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QAC5E,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,MAAM,CAAC;QAC9B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACjE,IAAI,IAAI;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;QACrD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,oBAA4B,EAC5B,UAAkB,EAClB,KAAoF;QAEpF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,oBAAoB,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;QAC3F,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,MAAM,CAAC;QAC9B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QACjE,IAAI,IAAI;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;QACrD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,oBAA4B,EAAE,UAAkB;QACjE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAC;QAChF,IAAI,EAAE,EAAE,CAAC;YACP,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;YACjE,IAAI,IAAI;gBAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;;gBAChD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,UAAU,CAAC,IAAwB;QACjC,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,CAAC;SAC3B,CAAC;IACJ,CAAC;CACF;AAED,IAAI,kBAAkB,GAAqC,IAAI,CAAC;AAEhE,MAAM,UAAU,4BAA4B;IAC1C,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,kBAAkB,GAAG,IAAI,yBAAyB,EAAE,CAAC;IACvD,CAAC;IACD,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B;IACjD,MAAM,GAAG,GAAG,4BAA4B,EAAE,CAAC;IAC3C,MAAM,GAAG,CAAC,oBAAoB,EAAE,CAAC;IACjC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,8BAA8B;IAC5C,kBAAkB,GAAG,IAAI,CAAC;AAC5B,CAAC"}

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

@@ -0,0 +1,23 @@
+/**
+ * 结构化 AI 出站解析 — JSON DSL + 协作 Cell 假 @ 兜底。
+ */
+import { type OutputElement } from '@zhin.js/ai';
+import { type Message, type MessageElement } from '@zhin.js/core';
+export interface TryResolveStructuredAiOutboundOptions {
+    inboundContent?: string;
+    toolRequiresStructured?: boolean;
+    warn?: (message: string) => void;
+    /** Init-time root plugin; avoids getHostRootPlugin in inbound pipeline path */
+    root?: import('@zhin.js/core').Plugin;
+}
+/**
+ * 解析 AI 结构化出站；若正文与 JSON 混排则拆成两条消息批次（先纯文本，后 @ 段）。
+ */
+export declare function tryBuildCollaborationOutboundBatches(message: Message, elements: OutputElement[], options?: TryResolveStructuredAiOutboundOptions): Promise<MessageElement[][] | null>;
+/**
+ * 解析 AI 结构化出站（JSON 主路径 + 协作 Cell 假 @ 兜底）。
+ * 非结构化场景或无法解析时返回 null。
+ */
+export declare function tryResolveStructuredAiOutbound(message: Message, elements: OutputElement[], options?: TryResolveStructuredAiOutboundOptions): Promise<MessageElement[] | null>;
+export declare function resolveStructuredOutboundRequired(message: Message | undefined, inboundContent?: string, toolRequiresStructured?: boolean): boolean;
+//# sourceMappingURL=structured-ai-outbound.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"structured-ai-outbound.d.ts","sourceRoot":"","sources":["../../src/collaboration/structured-ai-outbound.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAUL,KAAK,OAAO,EACZ,KAAK,cAAc,EAIpB,MAAM,eAAe,CAAC;AAoDvB,MAAM,WAAW,qCAAqC;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,+EAA+E;IAC/E,IAAI,CAAC,EAAE,OAAO,eAAe,EAAE,MAAM,CAAC;CACvC;AA8BD;;GAEG;AACH,wBAAsB,oCAAoC,CACxD,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,aAAa,EAAE,EACzB,OAAO,GAAE,qCAA0C,GAClD,OAAO,CAAC,cAAc,EAAE,EAAE,GAAG,IAAI,CAAC,CAWpC;AAED;;;GAGG;AACH,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,aAAa,EAAE,EACzB,OAAO,GAAE,qCAA0C,GAClD,OAAO,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,CAwElC;AAED,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,cAAc,CAAC,EAAE,MAAM,EACvB,sBAAsB,CAAC,EAAE,OAAO,GAC/B,OAAO,CAcT"}

package/lib/collaboration/structured-ai-outbound.js

@@ -0,0 +1,179 @@
+/**
+ * 结构化 AI 出站解析 — JSON DSL + 协作 Cell 假 @ 兜底。
+ */
+import { renderToPlainText } from '@zhin.js/ai';
+import { getHostRootPlugin, parseAiOutboundJson, extractEmbeddedAiOutboundJson, rewritePlainTextMentions, resolveAiOutboundToMessageElements, isStructuredOutboundRequired, detectInboundHandoffIntent, getAdapterAiOutboundCapabilities, getAdapterAiOutboundExtensions, } from '@zhin.js/core';
+import { formatContentChainLog, CONTENT_CHAIN_STAGE } from '@zhin.js/logger';
+import { resolvePeerEndpointInCell } from './collaboration-config.js';
+import { resolveCollaborationSceneForMessage } from './collaboration-context.js';
+import { resolvePlatformAtId } from './group-message.js';
+function extractPlainTextFromElements(elements) {
+    const parts = [];
+    for (const el of elements) {
+        if (el.type === 'text') {
+            if (el.content?.trim())
+                parts.push(el.content.trim());
+        }
+        else if (el.type === 'card') {
+            const plain = renderToPlainText([el]).trim();
+            if (plain)
+                parts.push(plain);
+        }
+        else {
+            return '';
+        }
+    }
+    return parts.join('\n').trim();
+}
+function resolveAdapterView(message, root) {
+    const plugin = root ?? getHostRootPlugin();
+    if (!plugin)
+        return undefined;
+    return plugin.inject(message.$adapter);
+}
+function buildParseContext(message, root) {
+    const cell = resolveCollaborationSceneForMessage(message);
+    const adapter = resolveAdapterView(message, root);
+    if (!adapter)
+        return null;
+    const plugin = root ?? getHostRootPlugin();
+    const adapterInstance = plugin?.inject(message.$adapter);
+    return {
+        message,
+        mentionResolver: cell
+            ? (ref) => resolvePeerEndpointInCell(cell, ref)
+            : undefined,
+        atIdResolver: (endpointId) => resolvePlatformAtId(adapter, endpointId),
+        extensions: adapterInstance ? getAdapterAiOutboundExtensions(adapterInstance) : [],
+    };
+}
+async function payloadToSegments(payload, ctx) {
+    return resolveAiOutboundToMessageElements(payload, ctx);
+}
+async function trySplitEmbeddedMentionBatches(message, plain, root) {
+    const cell = resolveCollaborationSceneForMessage(message);
+    if (!cell)
+        return null;
+    const embedded = extractEmbeddedAiOutboundJson(plain);
+    if (!embedded)
+        return null;
+    const ctx = buildParseContext(message, root);
+    if (!ctx)
+        return null;
+    const payload = parseAiOutboundJson(embedded.jsonRaw);
+    if (!payload?.mentions?.length)
+        return null;
+    const mentionSegments = await payloadToSegments(payload, ctx);
+    if (!mentionSegments)
+        return null;
+    const batches = [];
+    if (embedded.prose.trim()) {
+        batches.push([{ type: 'text', data: { text: ` ${embedded.prose.trim()}` } }]);
+    }
+    batches.push(mentionSegments);
+    return batches;
+}
+/**
+ * 解析 AI 结构化出站；若正文与 JSON 混排则拆成两条消息批次（先纯文本，后 @ 段）。
+ */
+export async function tryBuildCollaborationOutboundBatches(message, elements, options = {}) {
+    const plain = extractPlainTextFromElements(elements);
+    if (plain) {
+        const split = await trySplitEmbeddedMentionBatches(message, plain, options.root);
+        if (split)
+            return split;
+    }
+    const single = await tryResolveStructuredAiOutbound(message, elements, options);
+    if (single)
+        return [single];
+    return null;
+}
+/**
+ * 解析 AI 结构化出站（JSON 主路径 + 协作 Cell 假 @ 兜底）。
+ * 非结构化场景或无法解析时返回 null。
+ */
+export async function tryResolveStructuredAiOutbound(message, elements, options = {}) {
+    const cell = resolveCollaborationSceneForMessage(message);
+    const plugin = options.root ?? getHostRootPlugin();
+    const adapterInstance = plugin?.inject(message.$adapter);
+    const extensions = adapterInstance ? getAdapterAiOutboundExtensions(adapterInstance) : [];
+    const structuredRequired = isStructuredOutboundRequired({
+        collaborationCell: Boolean(cell),
+        toolRequiresStructured: options.toolRequiresStructured,
+        inboundHandoffIntent: options.inboundContent
+            ? detectInboundHandoffIntent(options.inboundContent)
+            : false,
+        adapterHasExtensions: extensions.length > 0,
+    });
+    if (!structuredRequired && !cell)
+        return null;
+    const plain = extractPlainTextFromElements(elements);
+    if (!plain)
+        return null;
+    // 正文 + 嵌入 JSON 混排：交给 batch 拆分，避免 plain_mention_rewrite 吞掉 JSON 块。
+    const embedded = extractEmbeddedAiOutboundJson(plain);
+    if (embedded?.prose.trim())
+        return null;
+    const ctx = buildParseContext(message, options.root);
+    if (!ctx)
+        return null;
+    let payload = parseAiOutboundJson(plain);
+    let fallback;
+    if (!payload && cell && ctx.mentionResolver) {
+        payload = rewritePlainTextMentions(plain, ctx.mentionResolver);
+        if (payload)
+            fallback = 'plain_mention_rewrite';
+    }
+    if (payload?.mentions?.length && cell) {
+        const selfId = String(message.$endpoint ?? '');
+        const filtered = payload.mentions.filter((ref) => {
+            const resolved = ctx.mentionResolver?.(ref);
+            return ref !== selfId && resolved !== selfId;
+        });
+        if (!filtered.length) {
+            payload = payload.text?.trim() ? { ...payload, mentions: undefined } : null;
+        }
+        else if (filtered.length !== payload.mentions.length) {
+            payload = { ...payload, mentions: filtered };
+        }
+    }
+    if (!payload) {
+        if (structuredRequired && options.warn) {
+            options.warn(formatContentChainLog({
+                stage: CONTENT_CHAIN_STAGE.OUTBOUND,
+                kind: 'ai_outbound',
+                fallback: 'plain_text',
+                adapter: String(message.$adapter),
+            }));
+        }
+        return null;
+    }
+    const segments = await payloadToSegments(payload, ctx);
+    if (!segments)
+        return null;
+    if (fallback && options.warn) {
+        options.warn(formatContentChainLog({
+            stage: CONTENT_CHAIN_STAGE.OUTBOUND,
+            kind: 'ai_outbound',
+            fallback,
+            adapter: String(message.$adapter),
+        }));
+    }
+    return segments;
+}
+export function resolveStructuredOutboundRequired(message, inboundContent, toolRequiresStructured) {
+    if (!message)
+        return false;
+    const cell = resolveCollaborationSceneForMessage(message);
+    const plugin = getHostRootPlugin();
+    const adapterInstance = plugin?.inject(message.$adapter);
+    const extensions = adapterInstance ? getAdapterAiOutboundExtensions(adapterInstance) : [];
+    const caps = adapterInstance ? getAdapterAiOutboundCapabilities(adapterInstance) : undefined;
+    return isStructuredOutboundRequired({
+        collaborationCell: Boolean(cell),
+        toolRequiresStructured,
+        inboundHandoffIntent: inboundContent ? detectInboundHandoffIntent(inboundContent) : false,
+        adapterHasExtensions: (extensions.length > 0) || caps?.interactive === 'native',
+    });
+}
+//# sourceMappingURL=structured-ai-outbound.js.map

package/lib/collaboration/structured-ai-outbound.js.map

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

package/lib/collaboration/turn-plan-resolver.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Turn plan resolution — endpoint primary, route overlay, delegation rules.
+ */
+import { type Message } from '@zhin.js/core';
+import { type AgentBindingConfig } from '../config/types.js';
+import type { CollaborationScene, TurnPlan } from './types.js';
+export interface TurnPlanResolverInput {
+    message: Message;
+    contentText: string;
+    endpointId: string;
+    endpointIds?: string[];
+    cells: CollaborationScene[];
+    agents: Record<string, AgentBindingConfig>;
+    discoveredAgentNames: Set<string>;
+}
+export declare function buildTurnPlan(input: TurnPlanResolverInput): TurnPlan;
+//# sourceMappingURL=turn-plan-resolver.d.ts.map

package/lib/collaboration/turn-plan-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-plan-resolver.d.ts","sourceRoot":"","sources":["../../src/collaboration/turn-plan-resolver.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAiC,MAAM,eAAe,CAAC;AAE5E,OAAO,EAA2B,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAOtF,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC/D,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC3C,oBAAoB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACnC;AAMD,wBAAgB,aAAa,CAAC,KAAK,EAAE,qBAAqB,GAAG,QAAQ,CAgEpE"}

package/lib/collaboration/turn-plan-resolver.js

@@ -0,0 +1,63 @@
+/**
+ * Turn plan resolution — endpoint primary, route overlay, delegation rules.
+ */
+import { resolveIMSessionIdFromMessage } from '@zhin.js/core';
+import { resolveRoutedAgentName } from '../routing/route-matcher.js';
+import { DEFAULT_ZHIN_AGENT_NAME } from '../config/types.js';
+import { resolveCollaborationSceneContextKeyFromMessage } from './scene-context.js';
+import { findCellForMessage, resolveCellForScene, resolvePrimaryForEndpoint, } from './collaboration-config.js';
+function findEndpointIdForAgent(cell, agentName) {
+    return cell.members.find((m) => m.primary === agentName)?.endpointId;
+}
+export function buildTurnPlan(input) {
+    const { message, contentText, endpointId, endpointIds, cells, agents, discoveredAgentNames } = input;
+    const scope = message.$channel?.type || 'private';
+    const sceneId = message.$channel?.id ?? '';
+    const adapter = String(message.$adapter || '');
+    const cell = (scope === 'group' || scope === 'channel') && sceneId
+        ? (resolveCellForScene(adapter, sceneId, endpointId) ?? findCellForMessage(cells, adapter, sceneId))
+        : undefined;
+    const primary = resolvePrimaryForEndpoint(cell, endpointId, DEFAULT_ZHIN_AGENT_NAME);
+    const routedAgent = resolveRoutedAgentName(agents, {
+        message,
+        contentText,
+        discoveredAgentNames,
+        endpointIds,
+    });
+    const handlerProfile = routedAgent !== DEFAULT_ZHIN_AGENT_NAME ? routedAgent : primary;
+    const transport = resolveIMSessionIdFromMessage(message);
+    const cellKey = resolveCollaborationSceneContextKeyFromMessage(message);
+    const plan = {
+        inboundEndpointId: endpointId,
+        handlerProfile,
+        outboundEndpointId: endpointId,
+        collaborationSceneId: cell?.id,
+        sessionKeys: {
+            transport,
+            collaborationScene: cellKey,
+        },
+        delegation: { mode: 'local_process' },
+    };
+    const handlerEndpointId = cell ? findEndpointIdForAgent(cell, handlerProfile) : undefined;
+    const isOwnEndpointHandler = !handlerEndpointId || handlerEndpointId === endpointId;
+    const isRouteOverlay = routedAgent !== DEFAULT_ZHIN_AGENT_NAME && routedAgent !== primary;
+    if (isOwnEndpointHandler) {
+        if (isRouteOverlay) {
+            plan.delegation = { mode: 'spawn_task', targetAgentId: handlerProfile };
+        }
+        return plan;
+    }
+    if (handlerEndpointId) {
+        plan.delegation = {
+            mode: 'local_process',
+            delegateToPeer: handlerEndpointId,
+            targetAgentId: handlerProfile,
+        };
+        return plan;
+    }
+    if (handlerProfile !== DEFAULT_ZHIN_AGENT_NAME) {
+        plan.delegation = { mode: 'spawn_task', targetAgentId: handlerProfile };
+    }
+    return plan;
+}
+//# sourceMappingURL=turn-plan-resolver.js.map

package/lib/collaboration/turn-plan-resolver.js.map

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