@zhin.js/agent 0.3.1 → 1.0.2

package/lib/session/session-tree-commands.js

@@ -0,0 +1,32 @@
+import { resolveIMSessionIdFromMessage } from '@zhin.js/core';
+import { beginTurnSession } from '../session/session-io.js';
+function formatBranchList(points) {
+    if (points.length === 0)
+        return '当前会话无 user 分支点';
+    return points
+        .map(p => `${p.index}. ${p.preview}`)
+        .join('\n');
+}
+export async function listSessionTreeForCommMessage(host, commMessage) {
+    const sessionKey = resolveIMSessionIdFromMessage(commMessage);
+    const deps = {
+        imSessionStore: host.imSessionStore,
+        agentSessionStore: host.agentSessionStore,
+        contextRepository: host.contextRepository,
+    };
+    const { sessionId } = await beginTurnSession(deps, sessionKey, commMessage);
+    const points = await host.contextRepository.listBranchPoints(sessionId);
+    return `🌳 会话分支点（/tree N 跳转，/fork N 从该点继续）：\n${formatBranchList(points)}`;
+}
+export async function jumpSessionTreeForCommMessage(host, commMessage, index) {
+    const sessionKey = resolveIMSessionIdFromMessage(commMessage);
+    const deps = {
+        imSessionStore: host.imSessionStore,
+        agentSessionStore: host.agentSessionStore,
+        contextRepository: host.contextRepository,
+    };
+    const { sessionId } = await beginTurnSession(deps, sessionKey, commMessage);
+    const result = await host.contextRepository.jumpToBranchIndex(sessionId, index);
+    return result.ok ? `✅ ${result.message}` : `ℹ️ ${result.message}`;
+}
+//# sourceMappingURL=session-tree-commands.js.map

package/lib/session/session-tree-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-tree-commands.js","sourceRoot":"","sources":["../../src/session/session-tree-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAgB,MAAM,eAAe,CAAC;AAE5E,OAAO,EAAE,gBAAgB,EAAsB,MAAM,0BAA0B,CAAC;AAEhF,SAAS,gBAAgB,CAAC,MAA4B;IACpD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,gBAAgB,CAAC;IACjD,OAAO,MAAM;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;SACpC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,IAAsB,EACtB,WAAoB;IAEpB,MAAM,UAAU,GAAG,6BAA6B,CAAC,WAAW,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAkB;QAC1B,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;KAC1C,CAAC;IACF,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACxE,OAAO,wCAAwC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;AAC5E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,IAAsB,EACtB,WAAoB,EACpB,KAAa;IAEb,MAAM,UAAU,GAAG,6BAA6B,CAAC,WAAW,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAkB;QAC1B,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;KAC1C,CAAC;IACF,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAChF,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;AACpE,CAAC"}

package/lib/session/strategies.d.ts

@@ -0,0 +1,11 @@
+import { type Message } from '@zhin.js/core';
+import type { SessionStrategy } from './contracts.js';
+export declare class CollaborationSessionStrategy implements SessionStrategy {
+    resolveSessionKey(message: Message): string;
+    shouldArchive(message: Message): boolean;
+}
+export declare class SimpleSessionStrategy implements SessionStrategy {
+    resolveSessionKey(message: Message): string;
+    shouldArchive(_message: Message): boolean;
+}
+//# sourceMappingURL=strategies.d.ts.map

package/lib/session/strategies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategies.d.ts","sourceRoot":"","sources":["../../src/session/strategies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAE5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,qBAAa,4BAA6B,YAAW,eAAe;IAClE,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAI3C,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;CAGzC;AAED,qBAAa,qBAAsB,YAAW,eAAe;IAC3D,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAI3C,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO;CAG1C"}

package/lib/session/strategies.js

@@ -0,0 +1,19 @@
+import { resolveIMSessionIdFromMessage } from '@zhin.js/core';
+import { resolveAgentTurnSessionKey } from '../collaboration/resolve-agent-session-key.js';
+export class CollaborationSessionStrategy {
+    resolveSessionKey(message) {
+        return resolveAgentTurnSessionKey(message);
+    }
+    shouldArchive(message) {
+        return message.$channel?.type === 'group';
+    }
+}
+export class SimpleSessionStrategy {
+    resolveSessionKey(message) {
+        return resolveIMSessionIdFromMessage(message);
+    }
+    shouldArchive(_message) {
+        return false;
+    }
+}
+//# sourceMappingURL=strategies.js.map

package/lib/session/strategies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategies.js","sourceRoot":"","sources":["../../src/session/strategies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAgB,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC;AAG3F,MAAM,OAAO,4BAA4B;IACvC,iBAAiB,CAAC,OAAgB;QAChC,OAAO,0BAA0B,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,aAAa,CAAC,OAAgB;QAC5B,OAAO,OAAO,CAAC,QAAQ,EAAE,IAAI,KAAK,OAAO,CAAC;IAC5C,CAAC;CACF;AAED,MAAM,OAAO,qBAAqB;IAChC,iBAAiB,CAAC,OAAgB;QAChC,OAAO,6BAA6B,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,aAAa,CAAC,QAAiB;QAC7B,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/lib/session-tree-runtime-registry.d.ts

@@ -2,7 +2,7 @@
  * Session tree runtime — 供 Host API 调用（ADR 0010 D3 Console API）。
  */
 import type { AgentSessionStore, ContextRepository, MemoryAgentSessionStore, SessionBranchPoint } from '@zhin.js/ai';
-import type { ZhinAgentPrivate } from './zhin-agent/zhin-agent-private.js';
+import type { ZhinAgentPrivate } from './internal/agent-host.js';
 export interface SessionTreeRuntimeHandle {
     contextRepository: ContextRepository;
     agentSessionStore: AgentSessionStore | MemoryAgentSessionStore;

package/lib/session-tree-runtime-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-tree-runtime-registry.d.ts","sourceRoot":"","sources":["../src/session-tree-runtime-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAKrB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAE3E,MAAM,WAAW,wBAAwB;IACvC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,iBAAiB,EAAE,iBAAiB,GAAG,uBAAuB,CAAC;IAC/D,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzE,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/F,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACnE,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACpE;AAID,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,wBAAwB,GAAG,IAAI,GAAG,IAAI,CAEnF;AAED,wBAAgB,qBAAqB,IAAI,wBAAwB,GAAG,IAAI,CAEvE;AAED,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,gBAAgB,GACrB,wBAAwB,CAc1B"}
+{"version":3,"file":"session-tree-runtime-registry.d.ts","sourceRoot":"","sources":["../src/session-tree-runtime-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAKrB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,MAAM,WAAW,wBAAwB;IACvC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,iBAAiB,EAAE,iBAAiB,GAAG,uBAAuB,CAAC;IAC/D,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzE,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/F,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACnE,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACpE;AAID,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,wBAAwB,GAAG,IAAI,GAAG,IAAI,CAEnF;AAED,wBAAgB,qBAAqB,IAAI,wBAAwB,GAAG,IAAI,CAEvE;AAED,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,gBAAgB,GACrB,wBAAwB,CAc1B"}

package/lib/session-tree-runtime-registry.js

@@ -1,7 +1,7 @@
 /**
  * Session tree runtime — 供 Host API 调用（ADR 0010 D3 Console API）。
  */
-import { jumpToBranchIndexWithSummarization, switchActiveLeafWithBranchSummarization, } from './zhin-agent/branch-summarization-runtime.js';
+import { jumpToBranchIndexWithSummarization, switchActiveLeafWithBranchSummarization, } from './session/branch-summarization-runtime.js';
 let runtime = null;
 export function setSessionTreeRuntime(handle) {
     runtime = handle;

package/lib/session-tree-runtime-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-tree-runtime-registry.js","sourceRoot":"","sources":["../src/session-tree-runtime-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,EACL,kCAAkC,EAClC,uCAAuC,GACxC,MAAM,8CAA8C,CAAC;AAYtD,IAAI,OAAO,GAAoC,IAAI,CAAC;AAEpD,MAAM,UAAU,qBAAqB,CAAC,MAAuC;IAC3E,OAAO,GAAG,MAAM,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,IAAsB;IAEtB,OAAO;QACL,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,gBAAgB,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,CACzC,uCAAuC,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC;QACrE,iBAAiB,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CACtC,kCAAkC,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC;QAC5D,gBAAgB,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,SAAS,CAAC;QACnF,sBAAsB,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;YAC3C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YACnE,OAAO,MAAM,EAAE,UAAU,IAAI,IAAI,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"session-tree-runtime-registry.js","sourceRoot":"","sources":["../src/session-tree-runtime-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,EACL,kCAAkC,EAClC,uCAAuC,GACxC,MAAM,2CAA2C,CAAC;AAYnD,IAAI,OAAO,GAAoC,IAAI,CAAC;AAEpD,MAAM,UAAU,qBAAqB,CAAC,MAAuC;IAC3E,OAAO,GAAG,MAAM,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,IAAsB;IAEtB,OAAO;QACL,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,gBAAgB,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,CACzC,uCAAuC,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC;QACrE,iBAAiB,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CACtC,kCAAkC,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC;QAC5D,gBAAgB,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,SAAS,CAAC;QACnF,sBAAsB,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;YAC3C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YACnE,OAAO,MAAM,EAAE,UAAU,IAAI,IAAI,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/lib/skill/contracts.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Skill System — 模块契约（与实现同步）。
+ *
+ * 实现：包装 `SkillRegistry`；`search` 使用 registry TF-IDF 真实 score。
+ */
+import type { AgentTool } from '@zhin.js/ai';
+import type { Message } from '@zhin.js/core';
+export interface Skill {
+    name: string;
+    description: string;
+    tools: AgentTool[];
+    keywords: string[];
+    tags: string[];
+    platforms?: string[];
+}
+export interface SkillSearchResult {
+    skill: Skill;
+    score: number;
+}
+export interface SkillSearchOptions {
+    maxResults?: number;
+    platform?: string;
+}
+export interface SkillSystemConfig {
+}
+export interface TurnContext {
+    message: Message;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/lib/skill/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/skill/contracts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;CAEjC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/lib/skill/contracts.js

@@ -0,0 +1,7 @@
+/**
+ * Skill System — 模块契约（与实现同步）。
+ *
+ * 实现：包装 `SkillRegistry`；`search` 使用 registry TF-IDF 真实 score。
+ */
+export {};
+//# sourceMappingURL=contracts.js.map

package/lib/skill/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/skill/contracts.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/lib/skill/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Skill System — SkillRegistry 统一出口（契约见 contracts.ts）。
+ */
+export type { Skill, SkillSearchResult, SkillSearchOptions, SkillSystemConfig, TurnContext, } from './contracts.js';
+export { SkillSystem, createSkillSystem, defaultSkillSystem, } from './skill-system.js';
+export { SkillRegistry } from '../orchestrator/skill-registry.js';
+export type { Skill as OrchestratorSkill, SkillMetadata } from '../orchestrator/types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skill/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,KAAK,EACL,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,YAAY,EAAE,KAAK,IAAI,iBAAiB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC"}

package/lib/skill/index.js

@@ -0,0 +1,6 @@
+/**
+ * Skill System — SkillRegistry 统一出口（契约见 contracts.ts）。
+ */
+export { SkillSystem, createSkillSystem, defaultSkillSystem, } from './skill-system.js';
+export { SkillRegistry } from '../orchestrator/skill-registry.js';
+//# sourceMappingURL=index.js.map

package/lib/skill/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skill/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC"}

package/lib/skill/skill-load-opts.d.ts

@@ -0,0 +1,5 @@
+import type { LoadSkillToolOptions } from '../builtin/load-skill-tool.js';
+import type { ZhinAgentPrivate } from '../internal/agent-host.js';
+/** 构建 readSkillInstructions 所需选项（hostPlugin 须在 configure 时经 emitter 注入） */
+export declare function buildSkillLoadOptsForAgent(host: ZhinAgentPrivate): LoadSkillToolOptions;
+//# sourceMappingURL=skill-load-opts.d.ts.map

package/lib/skill/skill-load-opts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-load-opts.d.ts","sourceRoot":"","sources":["../../src/skill/skill-load-opts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAG1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,2EAA2E;AAC3E,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,gBAAgB,GAAG,oBAAoB,CASvF"}

package/lib/skill/skill-load-opts.js

@@ -0,0 +1,14 @@
+import { mergeSkillDirsWithResolver, collectPluginSkillSearchRoots } from '../discovery/utils.js';
+import { resolveSkillInstructionMaxChars } from '../config/index.js';
+/** 构建 readSkillInstructions 所需选项（hostPlugin 须在 configure 时经 emitter 注入） */
+export function buildSkillLoadOptsForAgent(host) {
+    const modelId = host.getTurnProvider().models[0] || host.config.chatModel || 'gpt-4o-mini';
+    const skillMaxChars = resolveSkillInstructionMaxChars(host.config, modelId);
+    const root = host.emitter.getHostPlugin();
+    const skillDirList = root
+        ? () => mergeSkillDirsWithResolver(() => collectPluginSkillSearchRoots(root))
+        : () => [];
+    const skillFileLookup = (name) => host.skillRegistry?.getByName(name)?.filePath;
+    return { skillDirList, skillMaxChars, skillFileLookup };
+}
+//# sourceMappingURL=skill-load-opts.js.map

package/lib/skill/skill-load-opts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-load-opts.js","sourceRoot":"","sources":["../../src/skill/skill-load-opts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAClG,OAAO,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AAGrE,2EAA2E;AAC3E,MAAM,UAAU,0BAA0B,CAAC,IAAsB;IAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,aAAa,CAAC;IAC3F,MAAM,aAAa,GAAG,+BAA+B,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;IAC1C,MAAM,YAAY,GAAG,IAAI;QACvB,CAAC,CAAC,GAAG,EAAE,CAAC,0BAA0B,CAAC,GAAG,EAAE,CAAC,6BAA6B,CAAC,IAAI,CAAC,CAAC;QAC7E,CAAC,CAAC,GAAG,EAAE,CAAC,EAAc,CAAC;IACzB,MAAM,eAAe,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;IACxF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC;AAC1D,CAAC"}

package/lib/skill/skill-system.d.ts

@@ -0,0 +1,17 @@
+import type { AgentTool } from '@zhin.js/ai';
+import type { Skill as OrchestratorSkill } from '../orchestrator/types.js';
+import { SkillRegistry } from '../orchestrator/skill-registry.js';
+import type { SkillSearchOptions, SkillSearchResult, SkillSystemConfig, TurnContext } from './contracts.js';
+export declare class SkillSystem {
+    private readonly _config;
+    private readonly registry;
+    constructor(registry?: SkillRegistry, _config?: SkillSystemConfig);
+    getRegistry(): SkillRegistry;
+    addSkill(skill: OrchestratorSkill, scope?: import('../orchestrator/types.js').ResourceScope, source?: string): () => void;
+    search(query: string, options?: SkillSearchOptions): SkillSearchResult[];
+    collectTools(context: TurnContext, agentId?: string): AgentTool[];
+    getAlwaysSkills(agentId?: string): OrchestratorSkill[];
+}
+export declare function createSkillSystem(registry?: SkillRegistry): SkillSystem;
+export declare const defaultSkillSystem: SkillSystem;
+//# sourceMappingURL=skill-system.d.ts.map

package/lib/skill/skill-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-system.d.ts","sourceRoot":"","sources":["../../src/skill/skill-system.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,KAAK,IAAI,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,KAAK,EAEV,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACZ,MAAM,gBAAgB,CAAC;AAaxB,qBAAa,WAAW;IAKpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;gBAGvC,QAAQ,CAAC,EAAE,aAAa,EACP,OAAO,GAAE,iBAAsB;IAKlD,WAAW,IAAI,aAAa;IAI5B,QAAQ,CAAC,KAAK,EAAE,iBAAiB,EAAE,KAAK,CAAC,EAAE,OAAO,0BAA0B,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI;IAIzH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,iBAAiB,EAAE;IAYxE,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE;IAKjE,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,iBAAiB,EAAE;CAIvD;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,aAAa,GAAG,WAAW,CAEvE;AAED,eAAO,MAAM,kBAAkB,aAAoB,CAAC"}

package/lib/skill/skill-system.js

@@ -0,0 +1,51 @@
+import { sharedToolSelection } from '../orchestrator/tool-selection.js';
+import { SkillRegistry } from '../orchestrator/skill-registry.js';
+function toBlueprintSkill(skill) {
+    return {
+        name: skill.name,
+        description: skill.description,
+        tools: skill.tools.map((tool) => sharedToolSelection.normalize(tool)),
+        keywords: skill.keywords ?? [],
+        tags: skill.tags ?? [],
+        platforms: skill.platforms,
+    };
+}
+export class SkillSystem {
+    _config;
+    registry;
+    constructor(registry, _config = {}) {
+        this._config = _config;
+        this.registry = registry ?? new SkillRegistry();
+    }
+    getRegistry() {
+        return this.registry;
+    }
+    addSkill(skill, scope, source) {
+        return this.registry.add(skill, scope, source);
+    }
+    search(query, options) {
+        const maxResults = options?.maxResults ?? 5;
+        const scored = this.registry.searchScored(query, {
+            maxResults,
+            platform: options?.platform,
+        });
+        return scored.map(({ skill, score }) => ({
+            skill: toBlueprintSkill(skill),
+            score,
+        }));
+    }
+    collectTools(context, agentId) {
+        const tools = this.registry.collectAllTools(agentId);
+        return tools.map((tool) => sharedToolSelection.normalize(tool, context.message));
+    }
+    getAlwaysSkills(agentId) {
+        if (typeof this.registry.getAlwaysSkills !== 'function')
+            return [];
+        return this.registry.getAlwaysSkills(agentId);
+    }
+}
+export function createSkillSystem(registry) {
+    return new SkillSystem(registry);
+}
+export const defaultSkillSystem = new SkillSystem();
+//# sourceMappingURL=skill-system.js.map

package/lib/skill/skill-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-system.js","sourceRoot":"","sources":["../../src/skill/skill-system.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAExE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AASlE,SAAS,gBAAgB,CAAC,KAAwB;IAChD,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,SAAS,CAAC,IAAI,CAAc,CAAC;QAClF,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;QAC9B,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,WAAW;IAKH;IAJF,QAAQ,CAAgB;IAEzC,YACE,QAAwB,EACP,UAA6B,EAAE;QAA/B,YAAO,GAAP,OAAO,CAAwB;QAEhD,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,IAAI,aAAa,EAAE,CAAC;IAClD,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,QAAQ,CAAC,KAAwB,EAAE,KAAwD,EAAE,MAAe;QAC1G,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,CAAC,KAAa,EAAE,OAA4B;QAChD,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,KAAK,EAAE;YAC/C,UAAU;YACV,QAAQ,EAAE,OAAO,EAAE,QAAQ;SAC5B,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YACvC,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC;YAC9B,KAAK;SACN,CAAC,CAAC,CAAC;IACN,CAAC;IAED,YAAY,CAAC,OAAoB,EAAE,OAAgB;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACrD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,eAAe,CAAC,OAAgB;QAC9B,IAAI,OAAO,IAAI,CAAC,QAAQ,CAAC,eAAe,KAAK,UAAU;YAAE,OAAO,EAAE,CAAC;QACnE,OAAO,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;CACF;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAwB;IACxD,OAAO,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,WAAW,EAAE,CAAC"}

package/lib/spawn/permission-task.d.ts

@@ -0,0 +1,9 @@
+/** ADR 0030 — permission.task glob rules for spawn_task agent visibility. */
+export type PermissionTaskAction = 'allow' | 'deny';
+export type PermissionTaskRules = Record<string, PermissionTaskAction>;
+export declare function matchesPermissionTaskPattern(pattern: string, agentName: string): boolean;
+/** Last matching rule wins; default deny when rules are configured. */
+export declare function evaluatePermissionTask(rules: PermissionTaskRules | undefined, agentName: string): PermissionTaskAction;
+export declare function filterAgentsForSpawnDescription(agentNames: string[], rules: PermissionTaskRules | undefined): string[];
+export declare function assertSpawnAgentAllowed(agentName: string | undefined, rules: PermissionTaskRules | undefined): string | undefined;
+//# sourceMappingURL=permission-task.d.ts.map

package/lib/spawn/permission-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-task.d.ts","sourceRoot":"","sources":["../../src/spawn/permission-task.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAE7E,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,MAAM,CAAC;AAEpD,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;AAUvE,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAGxF;AAED,uEAAuE;AACvE,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,mBAAmB,GAAG,SAAS,EACtC,SAAS,EAAE,MAAM,GAChB,oBAAoB,CAStB;AAED,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,MAAM,EAAE,EACpB,KAAK,EAAE,mBAAmB,GAAG,SAAS,GACrC,MAAM,EAAE,CAEV;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,KAAK,EAAE,mBAAmB,GAAG,SAAS,GACrC,MAAM,GAAG,SAAS,CAMpB"}

package/lib/spawn/permission-task.js

@@ -0,0 +1,37 @@
+/** ADR 0030 — permission.task glob rules for spawn_task agent visibility. */
+function globToRegExp(pattern) {
+    const escaped = pattern
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+        .replace(/\*/g, '.*')
+        .replace(/\?/g, '.');
+    return new RegExp(`^${escaped}$`, 'i');
+}
+export function matchesPermissionTaskPattern(pattern, agentName) {
+    if (pattern === '*')
+        return true;
+    return globToRegExp(pattern).test(agentName);
+}
+/** Last matching rule wins; default deny when rules are configured. */
+export function evaluatePermissionTask(rules, agentName) {
+    if (!rules || Object.keys(rules).length === 0)
+        return 'allow';
+    let action = 'deny';
+    for (const [pattern, rule] of Object.entries(rules)) {
+        if (matchesPermissionTaskPattern(pattern, agentName)) {
+            action = rule;
+        }
+    }
+    return action;
+}
+export function filterAgentsForSpawnDescription(agentNames, rules) {
+    return agentNames.filter((name) => evaluatePermissionTask(rules, name) !== 'deny');
+}
+export function assertSpawnAgentAllowed(agentName, rules) {
+    if (!agentName?.trim())
+        return undefined;
+    if (evaluatePermissionTask(rules, agentName.trim()) === 'deny') {
+        return `Sub-agent type "${agentName.trim()}" is not allowed (permission.task).`;
+    }
+    return undefined;
+}
+//# sourceMappingURL=permission-task.js.map

package/lib/spawn/permission-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-task.js","sourceRoot":"","sources":["../../src/spawn/permission-task.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAM7E,SAAS,YAAY,CAAC,OAAe;IACnC,MAAM,OAAO,GAAG,OAAO;SACpB,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC;SACpC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvB,OAAO,IAAI,MAAM,CAAC,IAAI,OAAO,GAAG,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,OAAe,EAAE,SAAiB;IAC7E,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACjC,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAC/C,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,sBAAsB,CACpC,KAAsC,EACtC,SAAiB;IAEjB,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IAC9D,IAAI,MAAM,GAAyB,MAAM,CAAC;IAC1C,KAAK,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,IAAI,4BAA4B,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;YACrD,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,UAAoB,EACpB,KAAsC;IAEtC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,sBAAsB,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,MAAM,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,SAA6B,EAC7B,KAAsC;IAEtC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,sBAAsB,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAAE,CAAC;QAC/D,OAAO,mBAAmB,SAAS,CAAC,IAAI,EAAE,qCAAqC,CAAC;IAClF,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/lib/stability/memory-pressure.js

@@ -2,7 +2,7 @@
  * ADR 0014 P2-1 — 关键全局 Map / RSS 内存压力监控
  */
 import { formatCompact, Logger } from '@zhin.js/logger';
-import { getCompactionStateCount, evictCompactionStatesIfOverPressure } from '../zhin-agent/compaction-runtime.js';
+import { getCompactionStateCount, evictCompactionStatesIfOverPressure } from '../memory/compaction-runtime.js';
 import { getPendingOrchestrationCount, evictPendingOrchestrationIfOverPressure, } from '../security/owner-approve-always-store.js';
 const defaultLogger = new Logger(null, 'StabilityMonitor');
 const DEFAULT_COLLECTORS = [

package/lib/stability/memory-pressure.js.map

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

package/lib/subagent/contracts.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Subagent System — 模块契约（与实现同步）。
+ *
+ * 实现：`SubagentSystem.register` / `spawn` / `spawnSync` / `cancel`；
+ * `addResultSink` / `composeSender` 对接 IM outbound。
+ */
+import type { SpawnOptions } from './subagent-runtime.js';
+export interface SubagentDefinition {
+    name: string;
+    description: string;
+    systemPrompt: string;
+    tools: string[];
+    model?: string;
+    provider?: string;
+}
+export interface SubagentResult {
+    taskId: string;
+    status: 'completed' | 'failed';
+    result: string;
+    artifacts?: Artifact[];
+}
+export interface Artifact {
+    kind: string;
+    content: unknown;
+}
+export interface ResultSink {
+    deliver(result: SubagentResult): Promise<void>;
+}
+export interface SubagentSystemConfig {
+}
+export interface SubagentSystemSpawn {
+    register(definition: SubagentDefinition): void;
+    spawn(options: SpawnOptions): Promise<string>;
+    spawnSync(options: SpawnOptions): Promise<string>;
+    cancel(taskId: string): boolean;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/lib/subagent/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/subagent/contracts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,oBAAoB;CAEpC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC/C,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC"}

package/lib/subagent/contracts.js

@@ -0,0 +1,8 @@
+/**
+ * Subagent System — 模块契约（与实现同步）。
+ *
+ * 实现：`SubagentSystem.register` / `spawn` / `spawnSync` / `cancel`；
+ * `addResultSink` / `composeSender` 对接 IM outbound。
+ */
+export {};
+//# sourceMappingURL=contracts.js.map

package/lib/subagent/contracts.js.map

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

package/lib/subagent/im-result-sink.d.ts

@@ -0,0 +1,15 @@
+import type { SubagentResultSender } from '../subagent/index.js';
+import type { ProactiveOutboundService } from '../outbound/send-proactive.js';
+import type { ResultSink, SubagentResult } from './contracts.js';
+export interface ImResultSinkDeps {
+    proactiveOutbound: ProactiveOutboundService;
+}
+export declare class ImResultSink implements ResultSink {
+    private readonly deps;
+    constructor(deps: ImResultSinkDeps);
+    asResultSender(): SubagentResultSender;
+    deliver(result: SubagentResult): Promise<void>;
+    private deliverToIm;
+}
+export declare function createImResultSender(deps: ImResultSinkDeps): SubagentResultSender;
+//# sourceMappingURL=im-result-sink.d.ts.map

package/lib/subagent/im-result-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"im-result-sink.d.ts","sourceRoot":"","sources":["../../src/subagent/im-result-sink.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAA0C,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACzG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEjE,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB,EAAE,wBAAwB,CAAC;CAC7C;AAED,qBAAa,YAAa,YAAW,UAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,gBAAgB;IAEnD,cAAc,IAAI,oBAAoB;IAIhC,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;YAatC,WAAW;CAkB1B;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,GAAG,oBAAoB,CAEjF"}

package/lib/subagent/im-result-sink.js

@@ -0,0 +1,47 @@
+/**
+ * ImResultSink — 子代理结果经 proactive 出站链投递（ADR 0004）。
+ */
+import { sceneRefFromMessage } from '@zhin.js/core';
+import { deliverSubagentResult } from '../media/deliver-subagent-result.js';
+import { buildSubagentUserDelivery } from '../media/subagent-user-delivery.js';
+export class ImResultSink {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    asResultSender() {
+        return (origin, delivery) => this.deliverToIm(origin, delivery);
+    }
+    async deliver(result) {
+        const origin = result.origin;
+        if (!origin)
+            return;
+        const status = result.status === 'completed' ? 'ok' : 'error';
+        const delivery = buildSubagentUserDelivery({
+            label: result.taskId,
+            status,
+            result: result.result,
+            toolCalls: [],
+        });
+        await this.deliverToIm(origin, delivery);
+    }
+    async deliverToIm(origin, delivery) {
+        const scene = sceneRefFromMessage(origin.message);
+        if (!scene)
+            return;
+        await deliverSubagentResult({
+            origin,
+            delivery,
+            send: (opts) => this.deps.proactiveOutbound.send({
+                scene,
+                source: 'subagent',
+                originMessage: origin.message,
+                quoteMessageId: opts.quoteId,
+            }, opts.content),
+        });
+    }
+}
+export function createImResultSender(deps) {
+    return new ImResultSink(deps).asResultSender();
+}
+//# sourceMappingURL=im-result-sink.js.map

package/lib/subagent/im-result-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"im-result-sink.js","sourceRoot":"","sources":["../../src/subagent/im-result-sink.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,mBAAmB,EAAkC,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAS/E,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,IAAsB;QAAtB,SAAI,GAAJ,IAAI,CAAkB;IAAG,CAAC;IAEvD,cAAc;QACZ,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAsB;QAClC,MAAM,MAAM,GAAI,MAAuD,CAAC,MAAM,CAAC;QAC/E,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;QAC9D,MAAM,QAAQ,GAAG,yBAAyB,CAAC;YACzC,KAAK,EAAE,MAAM,CAAC,MAAM;YACpB,MAAM;YACN,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,EAAE;SACd,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAEO,KAAK,CAAC,WAAW,CACvB,MAAsB,EACtB,QAAgC;QAEhC,MAAM,KAAK,GAAG,mBAAmB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,MAAM,qBAAqB,CAAC;YAC1B,MAAM;YACN,QAAQ;YACR,IAAI,EAAE,CAAC,IAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC;gBAC5D,KAAK;gBACL,MAAM,EAAE,UAAU;gBAClB,aAAa,EAAE,MAAM,CAAC,OAAO;gBAC7B,cAAc,EAAE,IAAI,CAAC,OAAO;aAC7B,EAAE,IAAI,CAAC,OAAO,CAAC;SACjB,CAAC,CAAC;IACL,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAsB;IACzD,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,CAAC;AACjD,CAAC"}

package/lib/subagent/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Subagent System — SubagentSystem + ImResultSink（契约见 contracts.ts）。
+ */
+export type { SubagentDefinition, SubagentResult, Artifact, ResultSink, SubagentSystemConfig, } from './contracts.js';
+export { SubagentSystem, defaultSubagentSystem, } from './subagent-system.js';
+export type { SpawnOptions, SubagentCompletePayload, SubagentLifecycleEvent, SubagentOrigin, SubagentResultDelivery, SubagentResultSender, SubagentRuntimeOptions, } from './subagent-system.js';
+export { ImResultSink, createImResultSender, } from './im-result-sink.js';
+export type { ImResultSinkDeps } from './im-result-sink.js';
+export { createSubagentSystem } from './subagent-system-init.js';
+export type { SubagentSystemInitOptions } from './subagent-system-init.js';
+export { SubagentRuntime } from './subagent-runtime.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/subagent/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,QAAQ,EACR,UAAU,EACV,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,cAAc,EACd,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,YAAY,EACZ,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,YAAY,EACZ,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAE3E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/lib/subagent/index.js

@@ -0,0 +1,8 @@
+/**
+ * Subagent System — SubagentSystem + ImResultSink（契约见 contracts.ts）。
+ */
+export { SubagentSystem, defaultSubagentSystem, } from './subagent-system.js';
+export { ImResultSink, createImResultSender, } from './im-result-sink.js';
+export { createSubagentSystem } from './subagent-system-init.js';
+export { SubagentRuntime } from './subagent-runtime.js';
+//# sourceMappingURL=index.js.map

package/lib/subagent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/subagent/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,EACL,cAAc,EACd,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAY9B,OAAO,EACL,YAAY,EACZ,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGjE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}