@zhin.js/agent 1.1.23 → 1.1.27

package/lib/media/media-router.d.ts

@@ -1,15 +1,12 @@
 import { type ContentChainLogFields } from '@zhin.js/logger';
-import type { MediaBinaryPayload, MultimodalConfig, PreprocessInboundResult } from './media-types.js';
+import type { AudioTranscriptionPort, MediaBinaryPayload, MultimodalConfig, PreprocessInboundResult } from './media-types.js';
 export interface PreprocessInboundMediaDeps {
-    transcribe?: (payload: MediaBinaryPayload) => Promise<string>;
-    getConfig?: () => Record<string, unknown> | undefined;
+    transcriber?: AudioTranscriptionPort;
     warn?: (message: string) => void;
     logContentChain?: (fields: ContentChainLogFields) => void;
 }
-/** 测试用：重置 warn-once 状态 */
-export declare function resetPreprocessInboundMediaForTests(): void;
-/** STT 转写单条音频载荷（deps.transcribe 优先，否则 @zhin.js/speech 可选管线）。 */
-export declare function transcribeAudioPayload(payload: MediaBinaryPayload, deps?: PreprocessInboundMediaDeps): Promise<string | undefined>;
+/** STT 转写单条音频载荷。Speech implementation is supplied by the host. */
+export declare function transcribeAudioPayload(payload: MediaBinaryPayload, transcriber: AudioTranscriptionPort | undefined, signal?: AbortSignal): Promise<string | undefined>;
 /**
  * 入站混合路由：base64 载荷 → 文本补充 + vision image 媒体块
  */

package/lib/media/media-router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"media-router.d.ts","sourceRoot":"","sources":["../../src/media/media-router.ts"],"names":[],"mappings":"AACA,OAAO,EAA8D,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACzH,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAwBtG,MAAM,WAAW,0BAA0B;IACzC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9D,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACtD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAC;CAC3D;AAKD,0BAA0B;AAC1B,wBAAgB,mCAAmC,IAAI,IAAI,CAG1D;AAED,gEAAgE;AAChE,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,kBAAkB,EAC3B,IAAI,CAAC,EAAE,0BAA0B,GAChC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgB7B;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,SAAS,kBAAkB,EAAE,EACpC,MAAM,EAAE,gBAAgB,EACxB,YAAY,CAAC,EAAE,MAAM,EACrB,IAAI,CAAC,EAAE,0BAA0B,GAChC,OAAO,CAAC,uBAAuB,CAAC,CA+ElC"}
+{"version":3,"file":"media-router.d.ts","sourceRoot":"","sources":["../../src/media/media-router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,KAAK,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAwB9H,MAAM,WAAW,0BAA0B;IACzC,WAAW,CAAC,EAAE,sBAAsB,CAAC;IACrC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAC;CAC3D;AAED,kEAAkE;AAClE,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,kBAAkB,EAC3B,WAAW,EAAE,sBAAsB,GAAG,SAAS,EAC/C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAE7B;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,SAAS,kBAAkB,EAAE,EACpC,MAAM,EAAE,gBAAgB,EACxB,YAAY,CAAC,EAAE,MAAM,EACrB,IAAI,CAAC,EAAE,0BAA0B,GAChC,OAAO,CAAC,uBAAuB,CAAC,CAgFlC"}

package/lib/media/media-router.js

@@ -1,5 +1,4 @@
-import { loadSpeechPipeline } from '@zhin.js/core';
-import { createWarnOnce, resetWarnOnceForTests, CONTENT_CHAIN_STAGE } from '@zhin.js/logger';
+import { CONTENT_CHAIN_STAGE } from '@zhin.js/logger';
 import { payloadToVisionPart } from './media-normalize.js';
 import { spoolPayloadToFile } from './media-spool.js';
 import * as path from 'node:path';
@@ -20,28 +19,9 @@ function describePayload(payload) {
             return `[用户发送附件 (${payload.mimeType}, ${kb} KB)]`;
     }
 }
-const speechWarnOnce = createWarnOnce('speech');
-const sttFailWarnOnce = createWarnOnce('stt-fail');
-/** 测试用：重置 warn-once 状态 */
-export function resetPreprocessInboundMediaForTests() {
-    resetWarnOnceForTests('speech');
-    resetWarnOnceForTests('stt-fail');
-}
-/** STT 转写单条音频载荷（deps.transcribe 优先，否则 @zhin.js/speech 可选管线）。 */
-export async function transcribeAudioPayload(payload, deps) {
-    const transcribeFn = deps?.transcribe;
-    if (transcribeFn) {
-        return transcribeFn(payload);
-    }
-    const pipeline = await loadSpeechPipeline({
-        getConfig: deps?.getConfig,
-        warn: (msg) => speechWarnOnce(deps?.warn, msg),
-    });
-    if (!pipeline) {
-        return undefined;
-    }
-    const data = Buffer.from(payload.base64, 'base64');
-    return pipeline.transcribe({ data, mimeType: payload.mimeType });
+/** STT 转写单条音频载荷。Speech implementation is supplied by the host. */
+export async function transcribeAudioPayload(payload, transcriber, signal) {
+    return transcriber?.transcribe(payload, signal);
 }
 /**
  * 入站混合路由：base64 载荷 → 文本补充 + vision image 媒体块
@@ -50,6 +30,7 @@ export async function preprocessInboundMedia(input, config, workspaceDir, deps)
     const payloads = [...input];
     const lines = [];
     const visionParts = [];
+    let sttFallbackWarned = false;
     const inboundRoot = path.join(workspaceDir || process.cwd(), config.inboundDir);
     for (const p of payloads) {
         if (byteLengthFromBase64(p.base64) > config.maxFileBytes) {
@@ -75,7 +56,7 @@ export async function preprocessInboundMedia(input, config, workspaceDir, deps)
             }
             if (config.audio.strategy === 'transcribe') {
                 try {
-                    const text = await transcribeAudioPayload(p, deps);
+                    const text = await transcribeAudioPayload(p, deps?.transcriber);
                     if (text?.trim()) {
                         deps?.logContentChain?.({
                             stage: CONTENT_CHAIN_STAGE.STT,
@@ -95,7 +76,10 @@ export async function preprocessInboundMedia(input, config, workspaceDir, deps)
                     });
                     // fall through to placeholder
                 }
-                sttFailWarnOnce(deps?.warn, '语音转写失败或未安装 @zhin.js/speech，已降级为文本占位。安装: pnpm add @zhin.js/speech');
+                if (!sttFallbackWarned) {
+                    deps?.warn?.('语音转写失败或未配置 Speech Host，已降级为文本占位。');
+                    sttFallbackWarned = true;
+                }
                 lines.push(describePayload(p));
                 continue;
             }

package/lib/media/media-router.js.map

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

package/lib/media/media-types.d.ts

@@ -13,6 +13,10 @@ export interface MediaBinaryPayload {
         format?: 'wav' | 'mp3';
     };
 }
+/** Host-owned speech boundary used by media consumers that need STT. */
+export interface AudioTranscriptionPort {
+    transcribe(payload: MediaBinaryPayload, signal?: AbortSignal): Promise<string | undefined>;
+}
 export interface MultimodalConfig {
     enabled: boolean;
     maxFileBytes: number;

package/lib/media/media-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"media-types.d.ts","sourceRoot":"","sources":["../../src/media/media-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE;QACL,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;KACxB,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7D,KAAK,EAAE;QAAE,QAAQ,EAAE,YAAY,GAAG,KAAK,GAAG,WAAW,CAAA;KAAE,CAAC;IACxD,KAAK,EAAE;QAAE,QAAQ,EAAE,KAAK,GAAG,WAAW,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,QAAQ,EAAE;QAAE,aAAa,EAAE,MAAM,GAAG,QAAQ,GAAG,cAAc,CAAA;KAAE,CAAC;CACjE;AAED,eAAO,MAAM,yBAAyB,EAAE,gBASvC,CAAC;AAEF,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAED,6EAA6E;AAC7E,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,CAAC;AACnF,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,iBAAiB,EAAE,CAAC;AAEzD,MAAM,WAAW,yBAAyB;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,6BAA6B,EAAE,yBAM3C,CAAC"}
+{"version":3,"file":"media-types.d.ts","sourceRoot":"","sources":["../../src/media/media-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE;QACL,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;KACxB,CAAC;CACH;AAED,wEAAwE;AACxE,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,OAAO,EAAE,kBAAkB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAC5F;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7D,KAAK,EAAE;QAAE,QAAQ,EAAE,YAAY,GAAG,KAAK,GAAG,WAAW,CAAA;KAAE,CAAC;IACxD,KAAK,EAAE;QAAE,QAAQ,EAAE,KAAK,GAAG,WAAW,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,QAAQ,EAAE;QAAE,aAAa,EAAE,MAAM,GAAG,QAAQ,GAAG,cAAc,CAAA;KAAE,CAAC;CACjE;AAED,eAAO,MAAM,yBAAyB,EAAE,gBASvC,CAAC;AAEF,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAED,6EAA6E;AAC7E,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,CAAC;AACnF,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,iBAAiB,EAAE,CAAC;AAEzD,MAAM,WAAW,yBAAyB;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,6BAA6B,EAAE,yBAM3C,CAAC"}

package/lib/media/media-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"media-types.js","sourceRoot":"","sources":["../../src/media/media-types.ts"],"names":[],"mappings":"AA6BA,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACzD,OAAO,EAAE,IAAI;IACb,YAAY,EAAE,UAAU;IACxB,UAAU,EAAE,oBAAoB;IAChC,WAAW,EAAE,qBAAqB;IAClC,KAAK,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE;IACvD,KAAK,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE;IACjC,KAAK,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,EAAE;IAC9C,QAAQ,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE;CACpC,CAAC;AAoBF,MAAM,CAAC,MAAM,6BAA6B,GAA8B;IACtE,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,IAAI;IACX,IAAI,EAAE,IAAI;IACV,kBAAkB,EAAE,UAAU;CAC/B,CAAC"}
+{"version":3,"file":"media-types.js","sourceRoot":"","sources":["../../src/media/media-types.ts"],"names":[],"mappings":"AAkCA,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACzD,OAAO,EAAE,IAAI;IACb,YAAY,EAAE,UAAU;IACxB,UAAU,EAAE,oBAAoB;IAChC,WAAW,EAAE,qBAAqB;IAClC,KAAK,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE;IACvD,KAAK,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE;IACjC,KAAK,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,EAAE;IAC9C,QAAQ,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE;CACpC,CAAC;AAoBF,MAAM,CAAC,MAAM,6BAA6B,GAA8B;IACtE,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,IAAI;IACX,IAAI,EAAE,IAAI;IACV,kBAAkB,EAAE,UAAU;CAC/B,CAAC"}

package/lib/media/resolve-config.d.ts

@@ -1,4 +1,3 @@
 import { type MultimodalConfig } from './media-types.js';
-export declare function getPrimaryAppConfig(): Record<string, unknown> | undefined;
 export declare function resolveMultimodalConfig(): MultimodalConfig;
 //# sourceMappingURL=resolve-config.d.ts.map

package/lib/media/resolve-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-config.d.ts","sourceRoot":"","sources":["../../src/media/resolve-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpF,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAEzE;AAED,wBAAgB,uBAAuB,IAAI,gBAAgB,CAE1D"}
+{"version":3,"file":"resolve-config.d.ts","sourceRoot":"","sources":["../../src/media/resolve-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpF,wBAAgB,uBAAuB,IAAI,gBAAgB,CAE1D"}

package/lib/media/resolve-config.js

@@ -1,7 +1,4 @@
 import { DEFAULT_MULTIMODAL_CONFIG } from './media-types.js';
-export function getPrimaryAppConfig() {
-    return undefined;
-}
 export function resolveMultimodalConfig() {
     return { ...DEFAULT_MULTIMODAL_CONFIG };
 }

package/lib/media/resolve-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-config.js","sourceRoot":"","sources":["../../src/media/resolve-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAyB,MAAM,kBAAkB,CAAC;AAEpF,MAAM,UAAU,mBAAmB;IACjC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,EAAE,GAAG,yBAAyB,EAAE,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"resolve-config.js","sourceRoot":"","sources":["../../src/media/resolve-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAyB,MAAM,kBAAkB,CAAC;AAEpF,MAAM,UAAU,uBAAuB;IACrC,OAAO,EAAE,GAAG,yBAAyB,EAAE,CAAC;AAC1C,CAAC"}

package/lib/media/subagent-inbound.d.ts

@@ -1,6 +1,6 @@
-import { type SegmentMediaRef } from '@zhin.js/core';
+import type { SegmentMediaRef } from '@zhin.js/core';
 import type { AIProvider } from '@zhin.js/ai';
-import type { AgentRunInput, MultimodalConfig } from './media-types.js';
+import type { AgentRunInput, AudioTranscriptionPort, MultimodalConfig } from './media-types.js';
 export interface SubagentInboundTask {
     /** 传给 Agent.run 的首条 user content */
     runInput: AgentRunInput;
@@ -17,5 +17,6 @@ export declare function buildSubagentInboundTask(aiContent: string, mediaRefs: r
     workspaceDir?: string;
     provider?: AIProvider;
     config?: MultimodalConfig;
+    transcriber?: AudioTranscriptionPort;
 }): Promise<SubagentInboundTask>;
 //# sourceMappingURL=subagent-inbound.d.ts.map

package/lib/media/subagent-inbound.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-inbound.d.ts","sourceRoot":"","sources":["../../src/media/subagent-inbound.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAqB,MAAM,aAAa,CAAC;AAMjE,OAAO,KAAK,EAAE,aAAa,EAAyC,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAuB/G,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,QAAQ,EAAE,aAAa,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,SAAS,eAAe,EAAE,EACrC,IAAI,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;IAAC,MAAM,CAAC,EAAE,gBAAgB,CAAA;CAAE,GACjF,OAAO,CAAC,mBAAmB,CAAC,CAuG9B"}
+{"version":3,"file":"subagent-inbound.d.ts","sourceRoot":"","sources":["../../src/media/subagent-inbound.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAqB,MAAM,aAAa,CAAC;AAMjE,OAAO,KAAK,EAAE,aAAa,EAAqB,sBAAsB,EAAsB,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAuBvI,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,QAAQ,EAAE,aAAa,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,SAAS,eAAe,EAAE,EACrC,IAAI,CAAC,EAAE;IACL,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,WAAW,CAAC,EAAE,sBAAsB,CAAC;CACtC,GACA,OAAO,CAAC,mBAAmB,CAAC,CAqG9B"}

package/lib/media/subagent-inbound.js

@@ -1,5 +1,4 @@
 import * as path from 'node:path';
-import { loadSpeechPipeline } from '@zhin.js/core';
 import { normalizeMediaRefsToPayloads, payloadToVisionPart, } from './media-normalize.js';
 import { spoolPayloadToFile } from './media-spool.js';
 import { resolveMultimodalConfig } from './resolve-config.js';
@@ -43,7 +42,9 @@ export async function buildSubagentInboundTask(aiContent, mediaRefs, opts) {
         if (p.kind === 'image') {
             const filePath = spoolPayloadToFile(p, inboundRoot, 'image');
             spooledPaths.push(filePath);
-            lines.push(`${describePayload(p)}\n(已落盘: ${filePath}；请用 analyze_media，file_path 填该绝对路径)`);
+            lines.push(useNativeVision
+                ? `${describePayload(p)}\n(已作为当前视觉模型输入；落盘路径: ${filePath})`
+                : `${describePayload(p)}\n(当前模型不支持图片输入；已落盘: ${filePath})`);
             if (useNativeVision) {
                 const vp = payloadToVisionPart(p);
                 if (vp)
@@ -60,12 +61,8 @@ export async function buildSubagentInboundTask(aiContent, mediaRefs, opts) {
             }
             if (config.audio.strategy === 'transcribe') {
                 try {
-                    const pipeline = await loadSpeechPipeline();
-                    if (pipeline) {
-                        const text = await pipeline.transcribe({
-                            data: Buffer.from(p.base64, 'base64'),
-                            mimeType: p.mimeType,
-                        });
+                    if (opts?.transcriber) {
+                        const text = await opts.transcriber.transcribe(p);
                         if (text?.trim()) {
                             lines.push(`[语音转写] ${text.trim()}`);
                             continue;

package/lib/media/subagent-inbound.js.map

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

package/lib/memory/ai-compaction-strategy.d.ts

@@ -1,13 +1,14 @@
 /**
  * 压缩策略 — 委托 @zhin.js/ai autoCompactAgentMessagesIfNeeded（禁止双实现）。
  */
-import { type AgentCompactionConfig, type Model } from '@zhin.js/ai';
+import { type AgentCompactionConfig, type Model, type LlmCompletionPort } from '@zhin.js/ai';
 import type { CompactionStrategy, MemoryContext } from './contracts.js';
 export declare class AiCompactionStrategy implements CompactionStrategy {
+    private readonly transport;
     private readonly model;
     private readonly config;
     private readonly state;
-    constructor(model: Model, config: AgentCompactionConfig);
+    constructor(transport: LlmCompletionPort, model: Model, config: AgentCompactionConfig);
     shouldCompact(context: MemoryContext): boolean;
     compact(context: MemoryContext): Promise<MemoryContext>;
 }

package/lib/memory/ai-compaction-strategy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-compaction-strategy.d.ts","sourceRoot":"","sources":["../../src/memory/ai-compaction-strategy.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAIL,KAAK,qBAAqB,EAC1B,KAAK,KAAK,EACX,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAExE,qBAAa,oBAAqB,YAAW,kBAAkB;IAI3D,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;gBAGnC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,qBAAqB;IAGhD,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO;IAKxC,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;CAa9D"}
+{"version":3,"file":"ai-compaction-strategy.d.ts","sourceRoot":"","sources":["../../src/memory/ai-compaction-strategy.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAIL,KAAK,qBAAqB,EAC1B,KAAK,KAAK,EACV,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAExE,qBAAa,oBAAqB,YAAW,kBAAkB;IAI3D,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;gBAGnC,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,qBAAqB;IAGhD,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO;IAKxC,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;CAc9D"}

package/lib/memory/ai-compaction-strategy.js

@@ -3,10 +3,12 @@
  */
 import { autoCompactAgentMessagesIfNeeded, createAgentCompactionState, estimateAgentMessagesTokens, } from '@zhin.js/ai';
 export class AiCompactionStrategy {
+    transport;
     model;
     config;
     state = createAgentCompactionState();
-    constructor(model, config) {
+    constructor(transport, model, config) {
+        this.transport = transport;
         this.model = model;
         this.config = config;
     }
@@ -16,6 +18,7 @@ export class AiCompactionStrategy {
     }
     async compact(context) {
         const result = await autoCompactAgentMessagesIfNeeded({
+            transport: this.transport,
             model: this.model,
             messages: context.messages,
             config: this.config,

package/lib/memory/ai-compaction-strategy.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-compaction-strategy.js","sourceRoot":"","sources":["../../src/memory/ai-compaction-strategy.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,gCAAgC,EAChC,0BAA0B,EAC1B,2BAA2B,GAG5B,MAAM,aAAa,CAAC;AAGrB,MAAM,OAAO,oBAAoB;IAIZ;IACA;IAJF,KAAK,GAAG,0BAA0B,EAAE,CAAC;IAEtD,YACmB,KAAY,EACZ,MAA6B;QAD7B,UAAK,GAAL,KAAK,CAAO;QACZ,WAAM,GAAN,MAAM,CAAuB;IAC7C,CAAC;IAEJ,aAAa,CAAC,OAAsB;QAClC,MAAM,UAAU,GAAG,2BAA2B,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjE,OAAO,UAAU,GAAG,OAAO,CAAC,aAAa,GAAG,GAAG,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAsB;QAClC,MAAM,MAAM,GAAG,MAAM,gCAAgC,CAAC;YACpD,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;QACH,OAAO;YACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,aAAa,EAAE,OAAO,CAAC,aAAa;SACrC,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"ai-compaction-strategy.js","sourceRoot":"","sources":["../../src/memory/ai-compaction-strategy.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,gCAAgC,EAChC,0BAA0B,EAC1B,2BAA2B,GAI5B,MAAM,aAAa,CAAC;AAGrB,MAAM,OAAO,oBAAoB;IAIZ;IACA;IACA;IALF,KAAK,GAAG,0BAA0B,EAAE,CAAC;IAEtD,YACmB,SAA4B,EAC5B,KAAY,EACZ,MAA6B;QAF7B,cAAS,GAAT,SAAS,CAAmB;QAC5B,UAAK,GAAL,KAAK,CAAO;QACZ,WAAM,GAAN,MAAM,CAAuB;IAC7C,CAAC;IAEJ,aAAa,CAAC,OAAsB;QAClC,MAAM,UAAU,GAAG,2BAA2B,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjE,OAAO,UAAU,GAAG,OAAO,CAAC,aAAa,GAAG,GAAG,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAsB;QAClC,MAAM,MAAM,GAAG,MAAM,gCAAgC,CAAC;YACpD,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;QACH,OAAO;YACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,aAAa,EAAE,OAAO,CAAC,aAAa;SACrC,CAAC;IACJ,CAAC;CACF"}

package/lib/memory/compaction-runtime.d.ts

@@ -1,11 +1,14 @@
-import { type ContextRepository, type Model, type AgentMessage } from '@zhin.js/ai';
+import { type ContextRepository, type Model, type AgentMessage, type LlmCompletionPort } from '@zhin.js/ai';
 import type { CompactionConfig } from '../config/zhin-agent-config.js';
 import type { PluginAILoopHookRegistry } from '../plugin-loop-hooks.js';
-import type { AgentSessionHost } from '../internal/agent-host.js';
+export interface CompactionContextHost {
+    readonly contextRepository: ContextRepository;
+}
 export interface CompactionRuntimeOptions {
-    host: AgentSessionHost;
+    host: CompactionContextHost;
     sessionId: string;
     model: Model;
+    transport: LlmCompletionPort;
     compactionConfig?: CompactionConfig;
     contextWindow: number;
     mode?: 'text' | 'multimodal';
@@ -13,15 +16,21 @@ export interface CompactionRuntimeOptions {
     force?: boolean;
     loopHooks?: PluginAILoopHookRegistry | null;
 }
-export declare function getCompactionStateCount(): number;
-export declare function evictCompactionStatesIfOverPressure(): number;
-export declare function clearCompactionStates(): void;
-export declare function touchCompactionState(sessionId: string): void;
-export declare function transformContextWithCompaction(messages: AgentMessage[], signal: AbortSignal | undefined, options: CompactionRuntimeOptions): Promise<AgentMessage[]>;
-export declare function manualCompactSession(repo: ContextRepository, options: Omit<CompactionRuntimeOptions, 'host'> & {
-    host: AgentSessionHost;
-}): Promise<{
-    ok: boolean;
-    message: string;
-}>;
+/** One Agent host's compaction state and operations. */
+export declare class AgentCompactionRuntime {
+    #private;
+    private readonly maxSessions;
+    constructor(maxSessions?: number);
+    get stateCount(): number;
+    clear(): void;
+    touch(sessionId: string): void;
+    evictIfOverPressure(): number;
+    transformContext(messages: AgentMessage[], signal: AbortSignal | undefined, options: CompactionRuntimeOptions): Promise<AgentMessage[]>;
+    compactSession(repo: ContextRepository, options: Omit<CompactionRuntimeOptions, 'host'> & {
+        host: CompactionContextHost;
+    }): Promise<{
+        ok: boolean;
+        message: string;
+    }>;
+}
 //# sourceMappingURL=compaction-runtime.d.ts.map

package/lib/memory/compaction-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compaction-runtime.d.ts","sourceRoot":"","sources":["../../src/memory/compaction-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoJ,KAAK,iBAAiB,EAAE,KAAK,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACtO,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,gBAAgB,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;IACb,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAC;CAC7C;AA2BD,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED,wBAAgB,mCAAmC,IAAI,MAAM,CAW5D;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAI5D;AAED,wBAAsB,8BAA8B,CAClD,QAAQ,EAAE,YAAY,EAAE,EACxB,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,YAAY,EAAE,CAAC,CA2CzB;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,IAAI,CAAC,wBAAwB,EAAE,MAAM,CAAC,GAAG;IAChD,IAAI,EAAE,gBAAgB,CAAC;CACxB,GACA,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAsB3C"}
+{"version":3,"file":"compaction-runtime.d.ts","sourceRoot":"","sources":["../../src/memory/compaction-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoJ,KAAK,iBAAiB,EAAE,KAAK,KAAK,EAAE,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC9P,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAGxE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;CAC/C;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,iBAAiB,CAAC;IAC7B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAC;CAC7C;AAiBD,wDAAwD;AACxD,qBAAa,sBAAsB;;IAGrB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,GAAE,MAAgC;IAM1E,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,KAAK,IAAI,IAAI;IAIb,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAO9B,mBAAmB,IAAI,MAAM;IAYvB,gBAAgB,CACpB,QAAQ,EAAE,YAAY,EAAE,EACxB,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,YAAY,EAAE,CAAC;IA8CpB,cAAc,CAClB,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,IAAI,CAAC,wBAAwB,EAAE,MAAM,CAAC,GAAG;QAAE,IAAI,EAAE,qBAAqB,CAAA;KAAE,GAChF,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAkC7C"}

package/lib/memory/compaction-runtime.js

@@ -9,90 +9,106 @@ function resolveAgentCompactionConfig(compaction, contextWindow) {
         contextWindow,
     };
 }
-const compactionStateBySession = new Map();
 const MAX_COMPACTION_SESSIONS = 5000;
-function getCompactionState(sessionId) {
-    let state = compactionStateBySession.get(sessionId);
-    if (!state) {
-        state = createAgentCompactionState();
-        compactionStateBySession.set(sessionId, state);
-    }
-    return state;
-}
-export function getCompactionStateCount() {
-    return compactionStateBySession.size;
-}
-export function evictCompactionStatesIfOverPressure() {
-    let removed = 0;
-    if (compactionStateBySession.size > MAX_COMPACTION_SESSIONS * 0.8) {
-        const keys = [...compactionStateBySession.keys()];
-        const excess = compactionStateBySession.size - Math.floor(MAX_COMPACTION_SESSIONS * 0.6);
-        for (let i = 0; i < excess && i < keys.length; i++) {
-            compactionStateBySession.delete(keys[i]);
-            removed++;
+/** One Agent host's compaction state and operations. */
+export class AgentCompactionRuntime {
+    maxSessions;
+    #states = new Map();
+    constructor(maxSessions = MAX_COMPACTION_SESSIONS) {
+        this.maxSessions = maxSessions;
+        if (!Number.isInteger(maxSessions) || maxSessions < 1) {
+            throw new TypeError('AgentCompactionRuntime maxSessions must be a positive integer');
         }
     }
-    return removed;
-}
-export function clearCompactionStates() {
-    compactionStateBySession.clear();
-}
-export function touchCompactionState(sessionId) {
-    if (compactionStateBySession.has(sessionId)) {
-        getCompactionState(sessionId);
+    get stateCount() {
+        return this.#states.size;
     }
-}
-export async function transformContextWithCompaction(messages, signal, options) {
-    if (signal?.aborted)
-        return messages;
-    const cfg = resolveAgentCompactionConfig(options.compactionConfig, options.contextWindow);
-    if (cfg.enabled === false)
-        return messages;
-    const state = getCompactionState(options.sessionId);
-    const compactionPrompt = resolveWorkspacePrompt('compaction', options.model.sdk);
-    const customInstructions = [
-        compactionPrompt?.trim(),
-        options.customInstructions?.trim(),
-    ].filter(Boolean).join('\n\n') || undefined;
-    const result = await autoCompactAgentMessagesIfNeeded({
-        model: options.model,
-        messages,
-        config: cfg,
-        state,
-        force: options.force,
-        customInstructions,
-    });
-    if (result.summary?.trim()) {
-        const anchorId = await options.host.contextRepository.resolveCompactionAnchorId(options.sessionId, cfg.keepRecentTokens ?? 20_000, cfg.minKeepCount ?? 2);
-        await options.host.contextRepository.saveSummary(options.sessionId, result.summary, anchorId);
+    clear() {
+        this.#states.clear();
+    }
+    touch(sessionId) {
+        const state = this.#states.get(sessionId);
+        if (!state)
+            return;
+        this.#states.delete(sessionId);
+        this.#states.set(sessionId, state);
+    }
+    evictIfOverPressure() {
+        if (this.#states.size <= this.maxSessions * 0.8)
+            return 0;
+        const targetSize = Math.floor(this.maxSessions * 0.6);
+        let removed = 0;
+        for (const sessionId of this.#states.keys()) {
+            if (this.#states.size <= targetSize)
+                break;
+            this.#states.delete(sessionId);
+            removed += 1;
+        }
+        return removed;
     }
-    let out = result.messages;
-    if (options.loopHooks) {
-        out = await options.loopHooks.runTransformContext(out, {
-            sessionId: options.sessionId,
-            signal,
+    async transformContext(messages, signal, options) {
+        if (signal?.aborted)
+            return messages;
+        const cfg = resolveAgentCompactionConfig(options.compactionConfig, options.contextWindow);
+        if (cfg.enabled === false)
+            return messages;
+        const state = this.#getState(options.sessionId);
+        const compactionPrompt = resolveWorkspacePrompt('compaction', options.model.sdk);
+        const customInstructions = [
+            compactionPrompt?.trim(),
+            options.customInstructions?.trim(),
+        ].filter(Boolean).join('\n\n') || undefined;
+        const result = await autoCompactAgentMessagesIfNeeded({
+            transport: options.transport,
+            model: options.model,
+            messages,
+            config: cfg,
+            state,
+            force: options.force,
+            customInstructions,
         });
+        if (result.summary?.trim()) {
+            const anchorId = await options.host.contextRepository.resolveCompactionAnchorId(options.sessionId, cfg.keepRecentTokens ?? 20_000, cfg.minKeepCount ?? 2);
+            await options.host.contextRepository.saveSummary(options.sessionId, result.summary, anchorId);
+        }
+        let out = result.messages;
+        if (options.loopHooks) {
+            out = await options.loopHooks.runTransformContext(out, {
+                sessionId: options.sessionId,
+                signal,
+            });
+        }
+        return out;
     }
-    return out;
-}
-export async function manualCompactSession(repo, options) {
-    const cfg = resolveAgentCompactionConfig(options.compactionConfig, options.contextWindow);
-    if (cfg.enabled === false) {
-        return { ok: false, message: 'compaction 已禁用（ai.agent.compaction.enabled=false）' };
+    async compactSession(repo, options) {
+        const cfg = resolveAgentCompactionConfig(options.compactionConfig, options.contextWindow);
+        if (cfg.enabled === false) {
+            return { ok: false, message: 'compaction 已禁用（ai.agent.compaction.enabled=false）' };
+        }
+        const loaded = await repo.loadContext(options.sessionId);
+        const messages = loaded.messages;
+        if (messages.length < 2) {
+            return { ok: false, message: '消息过少，无需压缩' };
+        }
+        const compacted = await this.transformContext(messages, undefined, {
+            ...options,
+            force: true,
+        });
+        const saved = estimateAgentMessagesTokens(messages) - estimateAgentMessagesTokens(compacted);
+        return {
+            ok: true,
+            message: `已压缩会话，约节省 ${Math.max(0, saved)} tokens（保留最近 ~${cfg.keepRecentTokens ?? 20_000} tokens）`,
+        };
     }
-    const loaded = await repo.loadContext(options.sessionId);
-    const messages = loaded.messages;
-    if (messages.length < 2) {
-        return { ok: false, message: '消息过少，无需压缩' };
+    #getState(sessionId) {
+        const existing = this.#states.get(sessionId);
+        if (existing) {
+            this.touch(sessionId);
+            return existing;
+        }
+        const state = createAgentCompactionState();
+        this.#states.set(sessionId, state);
+        return state;
     }
-    const compacted = await transformContextWithCompaction(messages, undefined, {
-        ...options,
-        force: true,
-    });
-    const saved = estimateAgentMessagesTokens(messages) - estimateAgentMessagesTokens(compacted);
-    return {
-        ok: true,
-        message: `已压缩会话，约节省 ${Math.max(0, saved)} tokens（保留最近 ~${cfg.keepRecentTokens ?? 20_000} tokens）`,
-    };
 }
 //# sourceMappingURL=compaction-runtime.js.map

package/lib/memory/compaction-runtime.js.map

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

package/lib/memory/context-repository-store.js

@@ -16,7 +16,7 @@ export class ContextRepositoryMemoryStore {
         // Port：消息追加/压缩由 ContextRepository.appendMessages 与 compaction-runtime 负责。
     }
     async compact(_sessionId) {
-        // Port：手动/自动压缩经 MemorySystem.compactSession → manualCompactSession。
+        // Port：手动/自动压缩经 MemorySystem.compactSession → AgentCompactionRuntime。
     }
 }
 //# sourceMappingURL=context-repository-store.js.map

package/lib/memory/context-repository-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-repository-store.js","sourceRoot":"","sources":["../../src/memory/context-repository-store.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,4BAA4B;IAEpB;IACA;IAFnB,YACmB,UAA6B,EAC7B,oBAA4B;QAD5B,eAAU,GAAV,UAAU,CAAmB;QAC7B,yBAAoB,GAApB,oBAAoB,CAAQ;IAC5C,CAAC;IAEJ,KAAK,CAAC,IAAI,CAAC,SAAiB;QAC1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAC5D,OAAO;YACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,aAAa,EAAE,IAAI,CAAC,oBAAoB;SACzC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAAkB,EAAE,QAAuB;QACpD,0EAA0E;IAC5E,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAAkB;QAC9B,oEAAoE;IACtE,CAAC;CACF"}
+{"version":3,"file":"context-repository-store.js","sourceRoot":"","sources":["../../src/memory/context-repository-store.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,4BAA4B;IAEpB;IACA;IAFnB,YACmB,UAA6B,EAC7B,oBAA4B;QAD5B,eAAU,GAAV,UAAU,CAAmB;QAC7B,yBAAoB,GAApB,oBAAoB,CAAQ;IAC5C,CAAC;IAEJ,KAAK,CAAC,IAAI,CAAC,SAAiB;QAC1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAC5D,OAAO;YACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,aAAa,EAAE,IAAI,CAAC,oBAAoB;SACzC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAAkB,EAAE,QAAuB;QACpD,0EAA0E;IAC5E,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAAkB;QAC9B,sEAAsE;IACxE,CAAC;CACF"}

package/lib/memory/index.d.ts

@@ -5,7 +5,7 @@ export type { MemoryContext, MemoryStore, CompactionStrategy, MemorySystemConfig
 export { ContextRepositoryMemoryStore } from './context-repository-store.js';
 export { AiCompactionStrategy } from './ai-compaction-strategy.js';
 export { MemorySystem, createMemorySystemForHost, defaultMemorySystem, } from './memory-system.js';
-export type { CompactionRuntimeOptions } from './compaction-runtime.js';
-export { getCompactionStateCount, evictCompactionStatesIfOverPressure, clearCompactionStates, touchCompactionState, transformContextWithCompaction, manualCompactSession, } from './compaction-runtime.js';
+export type { CompactionContextHost, CompactionRuntimeOptions } from './compaction-runtime.js';
+export { AgentCompactionRuntime } from './compaction-runtime.js';
 export type { ContextRepository } from '@zhin.js/ai';
 //# sourceMappingURL=index.d.ts.map