@zhin.js/agent 0.3.1 → 1.0.2

package/lib/collaboration/types.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Collaboration domain types — GroupCell multi-endpoint agent orchestration.
+ * @see docs/adr/0023-group-cell-multi-endpoint-agents.md
+ */
+export type DelegationMode = 'local_process' | 'spawn_task' | 'mesh_remote';
+export type PeerTriggerMode = 'mention-only' | 'off';
+/** Five-Agent 企业管理矩阵角色（ADR 0024）。 */
+export type PipelineRole = 'planner' | 'researcher' | 'evaluator' | 'executor' | 'reviewer';
+export declare const PIPELINE_ROLES: readonly PipelineRole[];
+export declare function isPipelineRole(value: unknown): value is PipelineRole;
+/** Pipeline 阶段；与角色一一对应 + done/failed 终态。 */
+export type PipelineStage = PipelineRole | 'done' | 'failed';
+/** Artifact 种类：阶段产物的结构化类型。 */
+export type PipelineArtifactKind = 'report' | 'blueprint' | 'deliverable' | 'review' | 'citations';
+export interface PipelineArtifact {
+    id: string;
+    collaborationSceneId: string;
+    runId: string;
+    stage: PipelineStage;
+    kind: PipelineArtifactKind;
+    payload: Record<string, unknown>;
+    createdByEndpoint?: string;
+    createdAt: number;
+}
+export interface PipelineTodoItem {
+    id: string;
+    text: string;
+    done?: boolean;
+}
+/** 归档的 pipeline run 快照（Planner 可 activate 恢复）。 */
+export interface PipelineRunArchive {
+    runId: string;
+    label?: string;
+    userGoal?: string;
+    stage: PipelineStage;
+    reviewCycles: number;
+    todo: PipelineTodoItem[];
+    /** 归档时刻未完成的委派（供 in-flight 产物路由回原 run） */
+    activeDelegationsAtArchive?: ActiveDelegation[];
+    createdAt: number;
+    archivedAt: number;
+}
+export type PipelineManageAction = 'create' | 'reset' | 'update' | 'activate' | 'list';
+export interface ActiveDelegation {
+    targetEndpointId: string;
+    targetRole: PipelineRole;
+    /** 委派创建时的 pipeline runId（产物提交 SSOT，防 reset 竞态） */
+    runId: string;
+    requireArtifact: boolean;
+    artifactKinds?: PipelineArtifactKind[];
+    /** @deprecated Legacy planner metadata; OrchestrationKernel tasks carry executor/workflow state. */
+    mode?: string;
+    delegateText: string;
+    updatedAt: number;
+}
+/** 挂在 Cell 上的流水线状态机（SSOT，ADR 0024 D4）。 */
+export interface PipelineState {
+    runId: string;
+    /** 人类可读流程名（legacy pipelineState.runLabel） */
+    runLabel?: string;
+    runCreatedAt?: number;
+    stage: PipelineStage;
+    reviewCycles: number;
+    maxReviewCycles: number;
+    allowedNextStages: PipelineStage[];
+    todo: PipelineTodoItem[];
+    userGoal?: string;
+    /** 已归档 run（不含当前 active runId） */
+    runHistory?: PipelineRunArchive[];
+    /** @deprecated ADR 0027: 委派状态由 kernel task 管理，不再写入 cell.pipelineState.activeDelegations。 */
+    activeDelegations?: ActiveDelegation[];
+    /** @deprecated 使用 activeDelegations */
+    pendingDelegateTarget?: string;
+    /** @deprecated 使用 activeDelegations[].delegateText */
+    taskBrief?: string;
+    updatedAt: number;
+}
+export declare const DEFAULT_MAX_REVIEW_CYCLES = 3;
+export interface CollaborationSceneMember {
+    endpoint: string;
+    primary: string;
+    role?: string;
+    pipelineRole?: PipelineRole;
+}
+export interface CollaborationSceneConfig {
+    id: string;
+    adapter: string;
+    sceneId: string;
+    goal?: string;
+    missionRunId?: string;
+    members: CollaborationSceneMember[];
+}
+export interface CollaborationConfig {
+    /** 启用协作平面（单元数据存数据库） */
+    enabled?: boolean;
+    /** /collab init 默认协作目标 */
+    defaultGoal?: string;
+    /**
+     * 按 adapter 的默认成员模板；仅在使用 /collab init 时挂载，不自动导入。
+     * 示例：roster.icqq[].endpoint / primary / pipelineRole
+     */
+    roster?: Record<string, CollaborationSceneMember[]>;
+}
+export interface CollaborationSceneMemberRuntime {
+    endpointId: string;
+    /** 成员所属 adapter；缺省与 Cell.adapter 相同（跨 adapter 同群协作时显式填写）。 */
+    adapter?: string;
+    primary: string;
+    role?: string;
+    pipelineRole?: PipelineRole;
+}
+export interface CollaborationScene {
+    id: string;
+    adapter: string;
+    sceneId: string;
+    goal?: string;
+    missionRunId?: string;
+    members: CollaborationSceneMemberRuntime[];
+    pipelineState?: PipelineState;
+    version?: number;
+}
+export interface TurnPlanDelegation {
+    mode: DelegationMode;
+    /** Cross-endpoint peer in the same CollaborationScene (default delivery: internal_room). */
+    delegateToPeer?: string;
+    /** @deprecated use delegateToPeer */
+    targetEndpointId?: string;
+    targetAgentId?: string;
+}
+export interface TurnPlan {
+    inboundEndpointId: string;
+    handlerProfile: string;
+    outboundEndpointId: string;
+    collaborationSceneId?: string;
+    sessionKeys: {
+        transport: string;
+        collaborationScene?: string;
+    };
+    delegation?: TurnPlanDelegation;
+}
+export interface PeerTriggerResult {
+    isPeer: boolean;
+    peerEndpointId?: string;
+    shouldTrigger: boolean;
+    reason?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/lib/collaboration/types.js

@@ -0,0 +1,16 @@
+/**
+ * Collaboration domain types — GroupCell multi-endpoint agent orchestration.
+ * @see docs/adr/0023-group-cell-multi-endpoint-agents.md
+ */
+export const PIPELINE_ROLES = [
+    'planner',
+    'researcher',
+    'evaluator',
+    'executor',
+    'reviewer',
+];
+export function isPipelineRole(value) {
+    return typeof value === 'string' && PIPELINE_ROLES.includes(value);
+}
+export const DEFAULT_MAX_REVIEW_CYCLES = 3;
+//# sourceMappingURL=types.js.map

package/lib/collaboration/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/collaboration/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,CAAC,MAAM,cAAc,GAA4B;IACrD,SAAS;IACT,YAAY;IACZ,WAAW;IACX,UAAU;IACV,UAAU;CACX,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,cAAoC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC5F,CAAC;AAkFD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC"}

package/lib/collaboration/wire-collaboration-storage.d.ts

@@ -0,0 +1,4 @@
+export declare function wireCollaborationStorage(db: {
+    models?: Map<string, unknown>;
+} | undefined, collaborationRaw?: unknown): Promise<void>;
+//# sourceMappingURL=wire-collaboration-storage.d.ts.map

package/lib/collaboration/wire-collaboration-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-collaboration-storage.d.ts","sourceRoot":"","sources":["../../src/collaboration/wire-collaboration-storage.ts"],"names":[],"mappings":"AAkBA,wBAAsB,wBAAwB,CAC5C,EAAE,EAAE;IAAE,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,SAAS,EACjD,gBAAgB,CAAC,EAAE,OAAO,GACzB,OAAO,CAAC,IAAI,CAAC,CAkCf"}

package/lib/collaboration/wire-collaboration-storage.js

@@ -0,0 +1,28 @@
+/**
+ * Wire collaboration_scenes + collaboration_scene_members after database is ready.
+ */
+import { createCollaborationSceneRepository, setCollaborationSceneRepository, } from './collaboration-scene-repository.js';
+import { createCollaborationArtifactRepository, setCollaborationArtifactRepository, } from './collaboration-artifact-repository.js';
+import { getCollaborationSceneService, initCollaborationSceneService } from './scene-service.js';
+import { rebootstrapEndpointRuntimes } from './bootstrap-agent-runtimes.js';
+import { createSceneIdentityService, setSceneIdentityService, } from './scene-identity-service.js';
+export async function wireCollaborationStorage(db, collaborationRaw) {
+    void collaborationRaw;
+    const sceneModel = db?.models?.get('collaboration_scenes');
+    const memberModel = db?.models?.get('collaboration_scene_members');
+    const artifactModel = db?.models?.get('collaboration_scene_artifacts');
+    const repo = createCollaborationSceneRepository(sceneModel, memberModel);
+    setCollaborationSceneRepository(repo);
+    setCollaborationArtifactRepository(createCollaborationArtifactRepository(artifactModel));
+    getCollaborationSceneService().setRepository(repo);
+    const aliasModel = db?.models?.get('collaboration_scene_aliases');
+    const sessionModel = db?.models?.get('collaboration_init_sessions');
+    const observationModel = db?.models?.get('collaboration_init_observations');
+    const channelModel = db?.models?.get('collaboration_scene_member_channels');
+    const sceneSvc = createSceneIdentityService(aliasModel, sessionModel, observationModel, channelModel);
+    setSceneIdentityService(sceneSvc);
+    await sceneSvc.loadSceneIndex();
+    await initCollaborationSceneService();
+    await rebootstrapEndpointRuntimes();
+}
+//# sourceMappingURL=wire-collaboration-storage.js.map

package/lib/collaboration/wire-collaboration-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-collaboration-storage.js","sourceRoot":"","sources":["../../src/collaboration/wire-collaboration-storage.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,kCAAkC,EAClC,+BAA+B,GAChC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,qCAAqC,EACrC,kCAAkC,GACnC,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AACjG,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,6BAA6B,CAAC;AAErC,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,EAAiD,EACjD,gBAA0B;IAE1B,KAAK,gBAAgB,CAAC;IACtB,MAAM,UAAU,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,sBAAsB,CAE5C,CAAC;IACd,MAAM,WAAW,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,6BAA6B,CAEpD,CAAC;IACd,MAAM,aAAa,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,+BAA+B,CAExD,CAAC;IACd,MAAM,IAAI,GAAG,kCAAkC,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACzE,+BAA+B,CAAC,IAAI,CAAC,CAAC;IACtC,kCAAkC,CAAC,qCAAqC,CAAC,aAAa,CAAC,CAAC,CAAC;IACzF,4BAA4B,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAEnD,MAAM,UAAU,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,6BAA6B,CAEnD,CAAC;IACd,MAAM,YAAY,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,6BAA6B,CAErD,CAAC;IACd,MAAM,gBAAgB,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,iCAAiC,CAE7D,CAAC;IACd,MAAM,YAAY,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,qCAAqC,CAE7D,CAAC;IACd,MAAM,QAAQ,GAAG,0BAA0B,CAAC,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,CAAC,CAAC;IACtG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,QAAQ,CAAC,cAAc,EAAE,CAAC;IAEhC,MAAM,6BAA6B,EAAE,CAAC;IACtC,MAAM,2BAA2B,EAAE,CAAC;AACtC,CAAC"}

package/lib/common-adapter-tools.d.ts

@@ -1,13 +1,12 @@
 /**
- * Agent-side group management tool creation.
+ * Agent-side scene management tool creation.
  *
- * Delegates interface, specs, constants, and buildMethodArgs to @zhin.js/core,
+ * Delegates interface, specs, constants, and buildSceneMethodArgs to @zhin.js/core,
  * then adapts the result to the agent Tool type.
  */
-import { buildMethodArgs, GROUP_METHOD_SPECS, GROUP_MANAGEMENT_SKILL_KEYWORDS, GROUP_MANAGEMENT_SKILL_TAGS } from '@zhin.js/core';
-import type { IGroupManagement, GroupMethodSpec } from '@zhin.js/core';
+import { buildSceneMethodArgs, SCENE_MANAGEMENT_METHOD_SPECS, SCENE_MANAGEMENT_SKILL_KEYWORDS, SCENE_MANAGEMENT_SKILL_TAGS, type ISceneManagement, type SceneManagementMethodSpec } from '@zhin.js/core';
 import type { Tool } from './orchestrator/types.js';
-export type { IGroupManagement, GroupMethodSpec };
-export { GROUP_METHOD_SPECS, GROUP_MANAGEMENT_SKILL_KEYWORDS, GROUP_MANAGEMENT_SKILL_TAGS, buildMethodArgs };
-export declare function createGroupManagementTools(adapter: IGroupManagement, prefix: string): Tool[];
+export type { ISceneManagement, SceneManagementMethodSpec };
+export { SCENE_MANAGEMENT_METHOD_SPECS, SCENE_MANAGEMENT_SKILL_KEYWORDS, SCENE_MANAGEMENT_SKILL_TAGS, buildSceneMethodArgs };
+export declare function createSceneManagementTools(adapter: ISceneManagement, prefix: string): Tool[];
 //# sourceMappingURL=common-adapter-tools.d.ts.map

package/lib/common-adapter-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common-adapter-tools.d.ts","sourceRoot":"","sources":["../src/common-adapter-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,eAAe,EACf,kBAAkB,EAClB,+BAA+B,EAC/B,2BAA2B,EAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,KAAK,EAAE,IAAI,EAAa,MAAM,yBAAyB,CAAC;AAE/D,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,+BAA+B,EAAE,2BAA2B,EAAE,eAAe,EAAE,CAAC;AAE7G,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,GACb,IAAI,EAAE,CAoBR"}
+{"version":3,"file":"common-adapter-tools.d.ts","sourceRoot":"","sources":["../src/common-adapter-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAiC,oBAAoB,EAAE,6BAA6B,EAAE,+BAA+B,EAAE,2BAA2B,EAAE,KAAK,gBAAgB,EAAE,KAAK,yBAAyB,EAAE,MAAM,eAAe,CAAC;AACxO,OAAO,KAAK,EAAE,IAAI,EAAa,MAAM,yBAAyB,CAAC;AAC/D,YAAY,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,CAAC;AAC5D,OAAO,EAAE,6BAA6B,EAAE,+BAA+B,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,CAAC;AAE7H,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,GACb,IAAI,EAAE,CAoBR"}

package/lib/common-adapter-tools.js

@@ -1,29 +1,29 @@
 /**
- * Agent-side group management tool creation.
+ * Agent-side scene management tool creation.
  *
- * Delegates interface, specs, constants, and buildMethodArgs to @zhin.js/core,
+ * Delegates interface, specs, constants, and buildSceneMethodArgs to @zhin.js/core,
  * then adapts the result to the agent Tool type.
  */
-import { createGroupManagementToolsRaw, buildMethodArgs, GROUP_METHOD_SPECS, GROUP_MANAGEMENT_SKILL_KEYWORDS, GROUP_MANAGEMENT_SKILL_TAGS, } from '@zhin.js/core';
-export { GROUP_METHOD_SPECS, GROUP_MANAGEMENT_SKILL_KEYWORDS, GROUP_MANAGEMENT_SKILL_TAGS, buildMethodArgs };
-export function createGroupManagementTools(adapter, prefix) {
-    return createGroupManagementToolsRaw(adapter, prefix, (spec, prefix, execute) => ({
+import { createSceneManagementToolsRaw, buildSceneMethodArgs, SCENE_MANAGEMENT_METHOD_SPECS, SCENE_MANAGEMENT_SKILL_KEYWORDS, SCENE_MANAGEMENT_SKILL_TAGS } from '@zhin.js/core';
+export { SCENE_MANAGEMENT_METHOD_SPECS, SCENE_MANAGEMENT_SKILL_KEYWORDS, SCENE_MANAGEMENT_SKILL_TAGS, buildSceneMethodArgs };
+export function createSceneManagementTools(adapter, prefix) {
+    return createSceneManagementToolsRaw(adapter, prefix, (spec, prefix, execute) => ({
         name: `${prefix}_${spec.toolSuffix}`,
         description: `${spec.description} (${prefix})`,
         parameters: {
             type: 'object',
             properties: {
                 endpoint_id: { type: 'string', description: 'Endpoint ID', contextKey: 'endpointId' },
-                scene_id: { type: 'string', description: '群/服务器 ID', contextKey: 'sceneId' },
+                scene_id: { type: 'string', description: 'IM 场景 ID', contextKey: 'sceneId' },
                 ...Object.fromEntries(Object.entries(spec.extraParams)),
             },
             required: ['endpoint_id', 'scene_id', ...(spec.extraRequired ?? [])],
         },
         execute,
-        tags: ['group', 'management', prefix],
+        tags: ['scene', 'management', prefix],
         keywords: spec.keywords,
         ...(spec.permit ? { permissions: [spec.permit] } : {}),
-        scopes: ['group'],
+        scopes: ['group', 'channel'],
         preExecutable: spec.preExecutable,
     }));
 }

package/lib/common-adapter-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"common-adapter-tools.js","sourceRoot":"","sources":["../src/common-adapter-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,6BAA6B,EAC7B,eAAe,EACf,kBAAkB,EAClB,+BAA+B,EAC/B,2BAA2B,GAC5B,MAAM,eAAe,CAAC;AAKvB,OAAO,EAAE,kBAAkB,EAAE,+BAA+B,EAAE,2BAA2B,EAAE,eAAe,EAAE,CAAC;AAE7G,MAAM,UAAU,0BAA0B,CACxC,OAAyB,EACzB,MAAc;IAEd,OAAO,6BAA6B,CAAO,OAAO,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QACtF,IAAI,EAAE,GAAG,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE;QACpC,WAAW,EAAE,GAAG,IAAI,CAAC,WAAW,KAAK,MAAM,GAAG;QAC9C,UAAU,EAAE;YACV,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE;gBACrF,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE;gBAC5E,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;aACxD;YACD,QAAQ,EAAE,CAAC,aAAa,EAAE,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;SACrE;QACD,OAAO;QACP,IAAI,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC;QACrC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,MAAM,EAAE,CAAC,OAAO,CAAgB;QAChC,aAAa,EAAE,IAAI,CAAC,aAAa;KAClC,CAAC,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"common-adapter-tools.js","sourceRoot":"","sources":["../src/common-adapter-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,6BAA6B,EAAE,oBAAoB,EAAE,6BAA6B,EAAE,+BAA+B,EAAE,2BAA2B,EAAyD,MAAM,eAAe,CAAC;AAGxO,OAAO,EAAE,6BAA6B,EAAE,+BAA+B,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,CAAC;AAE7H,MAAM,UAAU,0BAA0B,CACxC,OAAyB,EACzB,MAAc;IAEd,OAAO,6BAA6B,CAAO,OAAO,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QACtF,IAAI,EAAE,GAAG,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE;QACpC,WAAW,EAAE,GAAG,IAAI,CAAC,WAAW,KAAK,MAAM,GAAG;QAC9C,UAAU,EAAE;YACV,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE;gBACrF,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE;gBAC5E,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;aACxD;YACD,QAAQ,EAAE,CAAC,aAAa,EAAE,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;SACrE;QACD,OAAO;QACP,IAAI,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC;QACrC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,MAAM,EAAE,CAAC,OAAO,EAAE,SAAS,CAAgB;QAC3C,aAAa,EAAE,IAAI,CAAC,aAAa;KAClC,CAAC,CAAC,CAAC;AACN,CAAC"}

package/lib/config/agent-binding-registry.d.ts

@@ -1,5 +1,5 @@
 import type { AgentMeta } from '../discovery/agents.js';
-import type { AgentBindingConfig, ResolvedAgentBinding } from './types.js';
+import { type AgentBindingConfig, type ResolvedAgentBinding } from './types.js';
 export declare class AgentBindingRegistry {
     private readonly agents;
     private readonly fileNames;

package/lib/config/agent-binding-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-binding-registry.d.ts","sourceRoot":"","sources":["../../src/config/agent-binding-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAG3E,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;gBAGtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAC1C,SAAS,GAAE,SAAS,EAAO;IAM7B,uBAAuB,IAAI,GAAG,CAAC,MAAM,CAAC;IAItC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;IAIrD,kBAAkB,IAAI,oBAAoB;IAM1C,8BAA8B;IAC9B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAInC,cAAc,IAAI,MAAM,EAAE;CAG3B"}
+{"version":3,"file":"agent-binding-registry.d.ts","sourceRoot":"","sources":["../../src/config/agent-binding-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,oBAAoB,EAA2B,MAAM,YAAY,CAAC;AACzG,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;gBAGtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAC1C,SAAS,GAAE,SAAS,EAAO;IAM7B,uBAAuB,IAAI,GAAG,CAAC,MAAM,CAAC;IAItC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;IAIrD,kBAAkB,IAAI,oBAAoB;IAM1C,8BAA8B;IAC9B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAInC,cAAc,IAAI,MAAM,EAAE;CAG3B"}

package/lib/config/agent-binding-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-binding-registry.js","sourceRoot":"","sources":["../../src/config/agent-binding-registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,OAAO,oBAAoB;IACd,MAAM,CAAqC;IAC3C,SAAS,CAAc;IAExC,YACE,MAA0C,EAC1C,YAAyB,EAAE;QAE3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,uBAAuB;QACrB,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,OAAO,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,kBAAkB;QAChB,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC;QACnD,IAAI,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,aAAa,uBAAuB,cAAc,CAAC,CAAC;QAC5E,OAAO,CAAC,CAAC;IACX,CAAC;IAED,8BAA8B;IAC9B,YAAY,CAAC,IAAY;QACvB,OAAO,IAAI,KAAK,uBAAuB,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC;IAED,cAAc;QACZ,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;CACF"}
+{"version":3,"file":"agent-binding-registry.js","sourceRoot":"","sources":["../../src/config/agent-binding-registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAsD,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACzG,MAAM,OAAO,oBAAoB;IACd,MAAM,CAAqC;IAC3C,SAAS,CAAc;IAExC,YACE,MAA0C,EAC1C,YAAyB,EAAE;QAE3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,uBAAuB;QACrB,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,OAAO,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,kBAAkB;QAChB,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC;QACnD,IAAI,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,aAAa,uBAAuB,cAAc,CAAC,CAAC;QAC5E,OAAO,CAAC,CAAC;IACX,CAAC;IAED,8BAA8B;IAC9B,YAAY,CAAC,IAAY;QACvB,OAAO,IAAI,KAAK,uBAAuB,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC;IAED,cAAc;QACZ,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;CACF"}

package/lib/config/agent-bindings.d.ts

@@ -1,4 +1,4 @@
-import type { AgentBindingConfig, ResolvedAgentBinding } from './types.js';
+import { type AgentBindingConfig, type ResolvedAgentBinding } from './types.js';
 export declare function resolveAgentBinding(name: string, agents: Record<string, AgentBindingConfig>): ResolvedAgentBinding | null;
 export declare function getZhinBinding(agents: Record<string, AgentBindingConfig>): ResolvedAgentBinding;
 //# sourceMappingURL=agent-bindings.d.ts.map

package/lib/config/agent-bindings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-bindings.d.ts","sourceRoot":"","sources":["../../src/config/agent-bindings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAG3E,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GACzC,oBAAoB,GAAG,IAAI,CAS7B;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GACzC,oBAAoB,CAEtB"}
+{"version":3,"file":"agent-bindings.d.ts","sourceRoot":"","sources":["../../src/config/agent-bindings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,oBAAoB,EAA2B,MAAM,YAAY,CAAC;AACzG,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GACzC,oBAAoB,GAAG,IAAI,CAW7B;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GACzC,oBAAoB,CAEtB"}

package/lib/config/agent-bindings.js

@@ -8,6 +8,8 @@ export function resolveAgentBinding(name, agents) {
         providerAlias: raw.provider,
         model: raw.model,
         mcpServers: raw.mcpServers ?? [],
+        nickname: raw.nickname,
+        permission: raw.permission,
     };
 }
 export function getZhinBinding(agents) {

package/lib/config/agent-bindings.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-bindings.js","sourceRoot":"","sources":["../../src/config/agent-bindings.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,MAA0C;IAE1C,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IACzB,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO;QACL,IAAI;QACJ,aAAa,EAAE,GAAG,CAAC,QAAQ;QAC3B,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,EAAE;KACjC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,MAA0C;IAE1C,OAAO,mBAAmB,CAAC,uBAAuB,EAAE,MAAM,CAAE,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"agent-bindings.js","sourceRoot":"","sources":["../../src/config/agent-bindings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsD,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACzG,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,MAA0C;IAE1C,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IACzB,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO;QACL,IAAI;QACJ,aAAa,EAAE,GAAG,CAAC,QAAQ;QAC3B,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,EAAE;QAChC,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,UAAU,EAAE,GAAG,CAAC,UAAU;KAC3B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,MAA0C;IAE1C,OAAO,mBAAmB,CAAC,uBAAuB,EAAE,MAAM,CAAE,CAAC;AAC/D,CAAC"}

package/lib/config/agent-interfaces.d.ts

@@ -0,0 +1,58 @@
+/**
+ * ZhinAgent 公共 API 接口定义
+ *
+ * 按职责拆分为 4 个接口，便于测试 mock 和依赖注入。
+ * ZhinAgent 类实现所有接口；外部消费方按需使用具体接口而非完整类。
+ */
+import type { AgentMessage, AgentEvent, ImageContent, OutputElement } from '@zhin.js/ai';
+import type { Message, Tool } from '../orchestrator/types.js';
+import type { SubagentSystem } from '../subagent/index.js';
+import type { ZhinAgentEventEmitter } from '../event/event-emitter.js';
+import type { ZhinAgentTurnMetrics } from '../turn/turn-metrics.js';
+import type { OnChunkCallback } from './zhin-agent-config.js';
+/**
+ * Turn 处理 —— 核心 AI 交互入口
+ */
+export interface IAgentTurnProcessor {
+    process(content: string, commMessage: Message, externalTools?: Tool[], onChunk?: OnChunkCallback): Promise<OutputElement[]>;
+    processMultimodal(parts: import('@zhin.js/ai').ContentPart[], commMessage: Message, onChunk?: OnChunkCallback): Promise<OutputElement[]>;
+    prompt(input: string | AgentMessage | AgentMessage[], commMessage: Message, options?: {
+        images?: ImageContent[];
+        onChunk?: OnChunkCallback;
+    }): Promise<OutputElement[]>;
+    steer(message: AgentMessage, commMessage: Message): void;
+    followUp(message: AgentMessage, commMessage: Message): void;
+    subscribe(listener: (event: AgentEvent, signal: AbortSignal) => void | Promise<void>): () => void;
+    abort(): void;
+    waitForIdle(): Promise<void>;
+    isPromptBusy(): boolean;
+    clearSteeringQueue(sessionKey?: string): void;
+    clearFollowUpQueue(sessionKey?: string): void;
+}
+/**
+ * 会话管理 —— 压缩、归档、持久化
+ */
+export interface IAgentSessionManager {
+    compactSessionForCommMessage(commMessage: Message): Promise<{
+        ok: boolean;
+        message: string;
+    }>;
+    archiveSessionForCommMessage(commMessage: Message): Promise<boolean>;
+    getLastTurnMetrics(): ZhinAgentTurnMetrics | null;
+    upgradeProfilesToDatabase(model: any): void;
+}
+/**
+ * 诊断与内省 —— 子 agent、事件发射器、内部状态
+ */
+export interface IAgentDiagnostics {
+    getSubagentSystem(): SubagentSystem | null;
+    getEventEmitter(): ZhinAgentEventEmitter;
+    getLastTurnMetrics(): ZhinAgentTurnMetrics | null;
+}
+/**
+ * 运行时配置 —— 上下文注入、绑定
+ */
+export interface IAgentConfigurator {
+    configure(deps: Partial<import('./zhin-agent-dependencies.js').ZhinAgentDependencies>): void;
+}
+//# sourceMappingURL=agent-interfaces.d.ts.map

package/lib/config/agent-interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-interfaces.d.ts","sourceRoot":"","sources":["../../src/config/agent-interfaces.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAI9D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CACL,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,OAAO,EACpB,aAAa,CAAC,EAAE,IAAI,EAAE,EACtB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAE5B,iBAAiB,CACf,KAAK,EAAE,OAAO,aAAa,EAAE,WAAW,EAAE,EAC1C,WAAW,EAAE,OAAO,EACpB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAE5B,MAAM,CACJ,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,YAAY,EAAE,EAC7C,WAAW,EAAE,OAAO,EACpB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,eAAe,CAAA;KAAE,GAC/D,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAE5B,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;IACzD,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5D,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC;IAClG,KAAK,IAAI,IAAI,CAAC;IACd,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,YAAY,IAAI,OAAO,CAAC;IACxB,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4BAA4B,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9F,4BAA4B,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrE,kBAAkB,IAAI,oBAAoB,GAAG,IAAI,CAAC;IAClD,yBAAyB,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,IAAI,cAAc,GAAG,IAAI,CAAC;IAC3C,eAAe,IAAI,qBAAqB,CAAC;IACzC,kBAAkB,IAAI,oBAAoB,GAAG,IAAI,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,8BAA8B,EAAE,qBAAqB,CAAC,GAAG,IAAI,CAAC;CAC9F"}

package/lib/config/agent-interfaces.js

@@ -0,0 +1,8 @@
+/**
+ * ZhinAgent 公共 API 接口定义
+ *
+ * 按职责拆分为 4 个接口，便于测试 mock 和依赖注入。
+ * ZhinAgent 类实现所有接口；外部消费方按需使用具体接口而非完整类。
+ */
+export {};
+//# sourceMappingURL=agent-interfaces.js.map

package/lib/config/agent-interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-interfaces.js","sourceRoot":"","sources":["../../src/config/agent-interfaces.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/lib/config/fix-ai-config.d.ts

@@ -1,6 +1,7 @@
 import type { AIConfig } from '@zhin.js/ai';
 /**
  * 将旧版 ai 段归一化为当前 schema，并返回已应用的修复说明。
+ * 仅用于 `zhin setup` 一次性升级；运行时 `normalizeAiRoutingConfig` 拒绝未迁移字段。
  */
 export declare function applyAiConfigFixes(ai: AIConfig | Record<string, unknown> | undefined): {
     ai: Record<string, unknown> | undefined;

package/lib/config/fix-ai-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fix-ai-config.d.ts","sourceRoot":"","sources":["../../src/config/fix-ai-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAI5C;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACjD;IAAE,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CA0E9D"}
+{"version":3,"file":"fix-ai-config.d.ts","sourceRoot":"","sources":["../../src/config/fix-ai-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,aAAa,CAAC;AAoD5D;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACjD;IAAE,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CA6H9D"}