@zhin.js/agent 0.1.29 → 0.1.30

package/lib/init.js

@@ -25,7 +25,9 @@ import { registerAITrigger } from './init/register-ai-trigger.js';
 import { registerDbUpgrade } from './init/register-db-upgrade.js';
 import { registerManagementTools } from './init/register-management-tools.js';
 import { registerOwnerApproveCommands } from './init/register-owner-approve-commands.js';
+import { registerIntrospectionCommands } from './init/register-introspection-commands.js';
 import { registerBuiltinTools } from './init/register-builtin-tools.js';
+import { registerHomeTools } from './init/register-home-tools.js';
 import { registerTypingIndicator } from './init/register-typing-indicator.js';
 /**
  * 初始化 AI 模块
@@ -49,7 +51,9 @@ export function initAgentModule() {
     registerDbUpgrade(refs);
     registerManagementTools(refs);
     registerOwnerApproveCommands();
+    registerIntrospectionCommands(refs);
     registerBuiltinTools(refs);
+    registerHomeTools();
     registerTypingIndicator(refs);
 }
 //# sourceMappingURL=init.js.map

package/lib/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,4BAA4B,EAAE,MAAM,2CAA2C,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAE9E;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAE1B,oBAAoB,EAAE,CAAC;IACvB,qBAAqB,EAAE,CAAC;IACxB,wBAAwB,EAAE,CAAC;IAC3B,mBAAmB,EAAE,CAAC;IACtB,gBAAgB,EAAE,CAAC;IACnB,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACxB,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC7B,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACxB,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACxB,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAC9B,4BAA4B,EAAE,CAAC;IAC/B,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC3B,uBAAuB,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,iBAAiB,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,4BAA4B,EAAE,MAAM,2CAA2C,CAAC;AACzF,OAAO,EAAE,6BAA6B,EAAE,MAAM,2CAA2C,CAAC;AAC1F,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAE9E;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAE1B,oBAAoB,EAAE,CAAC;IACvB,qBAAqB,EAAE,CAAC;IACxB,wBAAwB,EAAE,CAAC;IAC3B,mBAAmB,EAAE,CAAC;IACtB,gBAAgB,EAAE,CAAC;IACnB,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACxB,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC7B,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACxB,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACxB,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAC9B,4BAA4B,EAAE,CAAC;IAC/B,6BAA6B,CAAC,IAAI,CAAC,CAAC;IACpC,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC3B,iBAAiB,EAAE,CAAC;IACpB,uBAAuB,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC"}

package/lib/media/constants.d.ts

@@ -0,0 +1,3 @@
+/** ToolContext.extra：入站预处理后保留的 vision ContentPart（image_url 等） */
+export declare const INBOUND_MEDIA_PARTS_EXTRA_KEY = "zhin.inboundMediaParts";
+//# sourceMappingURL=constants.d.ts.map

package/lib/media/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/media/constants.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,eAAO,MAAM,6BAA6B,2BAA2B,CAAC"}

package/lib/media/constants.js

@@ -0,0 +1,3 @@
+/** ToolContext.extra：入站预处理后保留的 vision ContentPart（image_url 等） */
+export const INBOUND_MEDIA_PARTS_EXTRA_KEY = 'zhin.inboundMediaParts';
+//# sourceMappingURL=constants.js.map

package/lib/media/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/media/constants.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,CAAC,MAAM,6BAA6B,GAAG,wBAAwB,CAAC"}

package/lib/media/deliver-subagent-result.d.ts

@@ -0,0 +1,15 @@
+import type { SendOptions } from '@zhin.js/core';
+import type { SubagentOrigin } from '../subagent.js';
+import type { ToolCallRecord } from '../zhin-agent/tool-calls-user-format.js';
+export interface SubagentOutboundDelivery {
+    /** 面向用户的说明文本（含任务摘要时由调用方组装） */
+    text: string;
+    toolCalls?: ToolCallRecord[];
+}
+export interface DeliverSubagentResultParams {
+    origin: SubagentOrigin;
+    delivery: SubagentOutboundDelivery;
+    send: (options: SendOptions) => Promise<string>;
+}
+export declare function deliverSubagentResult(params: DeliverSubagentResultParams): Promise<void>;
+//# sourceMappingURL=deliver-subagent-result.d.ts.map

package/lib/media/deliver-subagent-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliver-subagent-result.d.ts","sourceRoot":"","sources":["../../src/media/deliver-subagent-result.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAA+B,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAI9E,MAAM,WAAW,wBAAwB;IACvC,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,wBAAwB,CAAC;IACnC,IAAI,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACjD;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CAiC9F"}

package/lib/media/deliver-subagent-result.js

@@ -0,0 +1,35 @@
+/**
+ * 子 agent 完成回告：文本 + 工具媒体（generate_image / voice_tts）走统一出站链。
+ * 日志 preview 中的 `{image}` 表示本条含 image MessageElement（见 core segment.raw），不是未发送的占位符。
+ */
+import { parseOutput } from '@zhin.js/ai';
+import { mergeToolOutboundElements } from './media-tool-bridge.js';
+import { publishOutboundElements } from './media-publisher.js';
+export async function deliverSubagentResult(params) {
+    const { origin, delivery, send } = params;
+    const base = {
+        context: origin.platform,
+        bot: origin.botId,
+        id: origin.sceneId,
+        type: origin.sceneType,
+    };
+    const elements = mergeToolOutboundElements(parseOutput(delivery.text), delivery.toolCalls ?? []);
+    const segments = await publishOutboundElements(elements, origin.platform);
+    if (!segments.length) {
+        await send({ ...base, content: delivery.text });
+        return;
+    }
+    const isMedia = (s) => s.type === 'image' || s.type === 'video' || s.type === 'record' || s.type === 'file';
+    const mediaSegs = segments.filter(isMedia);
+    const textSegs = segments.filter(s => !isMedia(s));
+    for (const seg of mediaSegs) {
+        await send({ ...base, content: seg });
+    }
+    if (textSegs.length > 0) {
+        await send({
+            ...base,
+            content: textSegs.length === 1 ? textSegs[0] : textSegs,
+        });
+    }
+}
+//# sourceMappingURL=deliver-subagent-result.js.map

package/lib/media/deliver-subagent-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliver-subagent-result.js","sourceRoot":"","sources":["../../src/media/deliver-subagent-result.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAc/D,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAAmC;IAC7E,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IAC1C,MAAM,IAAI,GAAiC;QACzC,OAAO,EAAE,MAAM,CAAC,QAAQ;QACxB,GAAG,EAAE,MAAM,CAAC,KAAK;QACjB,EAAE,EAAE,MAAM,CAAC,OAAO;QAClB,IAAI,EAAE,MAAM,CAAC,SAAwB;KACtC,CAAC;IAEF,MAAM,QAAQ,GAAG,yBAAyB,CACxC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,EAC1B,QAAQ,CAAC,SAAS,IAAI,EAAE,CACzB,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,uBAAuB,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1E,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrB,MAAM,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAChD,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,CAAiB,EAAE,EAAE,CACpC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;IACvF,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAEnD,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,CAAC;YACT,GAAG,IAAI;YACP,OAAO,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,QAAQ;SACzD,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/lib/media/index.d.ts

@@ -0,0 +1,14 @@
+export * from './constants.js';
+export * from './media-types.js';
+export * from './resolve-config.js';
+export * from './media-normalize.js';
+export * from './media-spool.js';
+export * from './media-router.js';
+export * from './media-publisher.js';
+export * from './media-capabilities.js';
+export * from './media-tool-bridge.js';
+export * from './deliver-subagent-result.js';
+export * from './subagent-user-delivery.js';
+export * from './vision-capability.js';
+export * from './subagent-inbound.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/media/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}

package/lib/media/index.js

@@ -0,0 +1,14 @@
+export * from './constants.js';
+export * from './media-types.js';
+export * from './resolve-config.js';
+export * from './media-normalize.js';
+export * from './media-spool.js';
+export * from './media-router.js';
+export * from './media-publisher.js';
+export * from './media-capabilities.js';
+export * from './media-tool-bridge.js';
+export * from './deliver-subagent-result.js';
+export * from './subagent-user-delivery.js';
+export * from './vision-capability.js';
+export * from './subagent-inbound.js';
+//# sourceMappingURL=index.js.map

package/lib/media/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/media/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}

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

@@ -0,0 +1,3 @@
+import { type OutboundMediaCapabilities } from './media-types.js';
+export declare function resolveOutboundCapabilities(platform?: string): OutboundMediaCapabilities;
+//# sourceMappingURL=media-capabilities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"media-capabilities.d.ts","sourceRoot":"","sources":["../../src/media/media-capabilities.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,kBAAkB,CAAC;AAE1B,wBAAgB,2BAA2B,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,yBAAyB,CAWxF"}

package/lib/media/media-capabilities.js

@@ -0,0 +1,15 @@
+import { getPlugin } from '@zhin.js/core';
+import { DEFAULT_OUTBOUND_CAPABILITIES, } from './media-types.js';
+export function resolveOutboundCapabilities(platform) {
+    if (!platform)
+        return { ...DEFAULT_OUTBOUND_CAPABILITIES };
+    try {
+        const plugin = getPlugin();
+        const adapter = plugin.root?.inject?.(platform);
+        return adapter?.getOutboundMediaCapabilities?.() ?? { ...DEFAULT_OUTBOUND_CAPABILITIES };
+    }
+    catch {
+        return { ...DEFAULT_OUTBOUND_CAPABILITIES };
+    }
+}
+//# sourceMappingURL=media-capabilities.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"media-capabilities.js","sourceRoot":"","sources":["../../src/media/media-capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EACL,6BAA6B,GAE9B,MAAM,kBAAkB,CAAC;AAE1B,MAAM,UAAU,2BAA2B,CAAC,QAAiB;IAC3D,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,GAAG,6BAA6B,EAAE,CAAC;IAC3D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,QAAQ,CAEjC,CAAC;QACd,OAAO,OAAO,EAAE,4BAA4B,EAAE,EAAE,IAAI,EAAE,GAAG,6BAA6B,EAAE,CAAC;IAC3F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,6BAA6B,EAAE,CAAC;IAC9C,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,10 @@
+import type { ContentPart } from '@zhin.js/ai';
+import type { MediaBinaryPayload } from './media-types.js';
+export declare function fetchUrlAsBase64(url: string, maxBytes: number): Promise<MediaBinaryPayload | null>;
+/**
+ * ContentPart[] → MediaBinaryPayload[]（优先已有 base64；URL 按需 fetch）
+ */
+export declare function normalizeContentPartsToPayloads(parts: ContentPart[], maxFileBytes: number): Promise<MediaBinaryPayload[]>;
+export declare function payloadToDataUri(payload: MediaBinaryPayload): string;
+export declare function payloadToVisionPart(payload: MediaBinaryPayload): ContentPart | null;
+//# sourceMappingURL=media-normalize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"media-normalize.d.ts","sourceRoot":"","sources":["../../src/media/media-normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAa,MAAM,kBAAkB,CAAC;AA2BtE,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAexG;AAED;;GAEG;AACH,wBAAsB,+BAA+B,CACnD,KAAK,EAAE,WAAW,EAAE,EACpB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA+C/B;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAEpE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,GAAG,IAAI,CAMnF"}

package/lib/media/media-normalize.js

@@ -0,0 +1,108 @@
+function guessMimeFromFormat(fmt) {
+    if (fmt === 'wav')
+        return 'audio/wav';
+    if (fmt === 'mp3')
+        return 'audio/mpeg';
+    return 'application/octet-stream';
+}
+function kindFromContentPart(part) {
+    switch (part.type) {
+        case 'image_url':
+            return 'image';
+        case 'audio':
+            return 'audio';
+        case 'video_url':
+            return 'video';
+        default:
+            return null;
+    }
+}
+function parseDataUri(dataUri) {
+    const m = /^data:([^;]+);base64,(.+)$/i.exec(dataUri.trim());
+    if (!m)
+        return null;
+    return { mime: m[1], base64: m[2] };
+}
+export async function fetchUrlAsBase64(url, maxBytes) {
+    try {
+        const res = await fetch(url, { signal: AbortSignal.timeout(30_000) });
+        if (!res.ok)
+            return null;
+        const buf = Buffer.from(await res.arrayBuffer());
+        if (buf.length > maxBytes)
+            return null;
+        const mime = res.headers.get('content-type')?.split(';')[0]?.trim() || 'application/octet-stream';
+        let kind = 'file';
+        if (mime.startsWith('image/'))
+            kind = 'image';
+        else if (mime.startsWith('audio/'))
+            kind = 'audio';
+        else if (mime.startsWith('video/'))
+            kind = 'video';
+        return { kind, base64: buf.toString('base64'), mimeType: mime };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * ContentPart[] → MediaBinaryPayload[]（优先已有 base64；URL 按需 fetch）
+ */
+export async function normalizeContentPartsToPayloads(parts, maxFileBytes) {
+    const out = [];
+    for (const part of parts) {
+        if (part.type === 'face')
+            continue;
+        const kind = kindFromContentPart(part);
+        if (!kind)
+            continue;
+        if (part.type === 'audio') {
+            const b64 = part.audio.data;
+            if (b64) {
+                out.push({
+                    kind: 'audio',
+                    base64: b64,
+                    mimeType: guessMimeFromFormat(part.audio.format),
+                    meta: { format: part.audio.format },
+                });
+            }
+            continue;
+        }
+        if (part.type === 'image_url') {
+            const url = part.image_url.url;
+            const parsed = parseDataUri(url);
+            if (parsed) {
+                out.push({ kind: 'image', base64: parsed.base64, mimeType: parsed.mime });
+                continue;
+            }
+            const fetched = await fetchUrlAsBase64(url, maxFileBytes);
+            if (fetched)
+                out.push(fetched);
+            continue;
+        }
+        if (part.type === 'video_url') {
+            const url = part.video_url.url;
+            const parsed = parseDataUri(url);
+            if (parsed) {
+                out.push({ kind: 'video', base64: parsed.base64, mimeType: parsed.mime });
+                continue;
+            }
+            const fetched = await fetchUrlAsBase64(url, maxFileBytes);
+            if (fetched)
+                out.push({ ...fetched, kind: 'video' });
+        }
+    }
+    return out;
+}
+export function payloadToDataUri(payload) {
+    return `data:${payload.mimeType};base64,${payload.base64}`;
+}
+export function payloadToVisionPart(payload) {
+    if (payload.kind !== 'image')
+        return null;
+    return {
+        type: 'image_url',
+        image_url: { url: payloadToDataUri(payload), detail: 'auto' },
+    };
+}
+//# sourceMappingURL=media-normalize.js.map

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

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

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

@@ -0,0 +1,8 @@
+import type { OutputElement } from '@zhin.js/ai';
+import type { MessageElement } from '@zhin.js/core';
+import type { OutboundMediaCapabilities } from './media-types.js';
+/**
+ * OutputElement[] → MessageElement[]（base64 契约，平台 adapter 决定如何发送）
+ */
+export declare function publishOutboundElements(elements: OutputElement[], platform?: string, capsOverride?: OutboundMediaCapabilities): Promise<MessageElement[]>;
+//# sourceMappingURL=media-publisher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"media-publisher.d.ts","sourceRoot":"","sources":["../../src/media/media-publisher.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AA+OlE;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,aAAa,EAAE,EACzB,QAAQ,CAAC,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,yBAAyB,GACvC,OAAO,CAAC,cAAc,EAAE,CAAC,CAqB3B"}

package/lib/media/media-publisher.js

@@ -0,0 +1,254 @@
+import * as crypto from 'node:crypto';
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { renderToPlainText } from '@zhin.js/ai';
+import { resolveOutboundCapabilities } from './media-capabilities.js';
+import { fetchUrlAsBase64 } from './media-normalize.js';
+/** 超过此长度的 base64 先落盘，避免出站 segment.toString→from 模板超 400KB */
+const OUTBOUND_SPOOL_B64_CHARS = 32_000;
+function extForMime(mime, kind) {
+    const map = {
+        'image/jpeg': '.jpg',
+        'image/png': '.png',
+        'image/gif': '.gif',
+        'image/webp': '.webp',
+        'audio/mpeg': '.mp3',
+        'audio/wav': '.wav',
+        'video/mp4': '.mp4',
+    };
+    if (map[mime])
+        return map[mime];
+    if (kind === 'audio')
+        return '.mp3';
+    if (kind === 'video')
+        return '.mp4';
+    if (kind === 'image')
+        return '.png';
+    return '.bin';
+}
+async function spoolBase64ToTempFile(base64, mimeType, kind) {
+    const dir = path.join(os.tmpdir(), 'zhin-outbound-media');
+    await fs.mkdir(dir, { recursive: true });
+    const ext = extForMime(mimeType, kind);
+    const filePath = path.join(dir, `${kind}-${crypto.randomBytes(6).toString('hex')}${ext}`);
+    await fs.writeFile(filePath, Buffer.from(base64, 'base64'));
+    return filePath;
+}
+async function readFileAsBase64(filePath, maxBytes) {
+    try {
+        const stat = await fs.stat(filePath);
+        if (stat.size > maxBytes)
+            return null;
+        const buf = await fs.readFile(filePath);
+        const ext = path.extname(filePath).toLowerCase();
+        let mime = 'application/octet-stream';
+        let kind = 'file';
+        if (['.png', '.jpg', '.jpeg', '.gif', '.webp'].includes(ext)) {
+            kind = 'image';
+            mime = ext === '.png' ? 'image/png' : ext === '.gif' ? 'image/gif' : ext === '.webp' ? 'image/webp' : 'image/jpeg';
+        }
+        else if (['.mp3', '.wav', '.ogg'].includes(ext)) {
+            kind = 'audio';
+            mime = ext === '.wav' ? 'audio/wav' : 'audio/mpeg';
+        }
+        else if (['.mp4', '.webm', '.mov'].includes(ext)) {
+            kind = 'video';
+            mime = 'video/mp4';
+        }
+        return { kind, base64: buf.toString('base64'), mimeType: mime, fileName: path.basename(filePath) };
+    }
+    catch {
+        return null;
+    }
+}
+async function elementToPayload(el, maxBytes) {
+    if (el.type === 'text')
+        return null;
+    if (el.type === 'image') {
+        if (el.base64) {
+            return { kind: 'image', base64: el.base64, mimeType: 'image/jpeg', meta: { alt: el.alt } };
+        }
+        if (el.url.startsWith('data:')) {
+            const m = /^data:([^;]+);base64,(.+)$/i.exec(el.url);
+            if (m)
+                return { kind: 'image', base64: m[2], mimeType: m[1], meta: { alt: el.alt } };
+        }
+        if (el.url && !el.url.startsWith('http')) {
+            return readFileAsBase64(el.url, maxBytes);
+        }
+        if (el.url?.startsWith('http')) {
+            return fetchUrlAsBase64(el.url, maxBytes);
+        }
+    }
+    if (el.type === 'audio') {
+        if (el.base64) {
+            return { kind: 'audio', base64: el.base64, mimeType: 'audio/mpeg' };
+        }
+        if (el.url.startsWith('data:')) {
+            const m = /^data:([^;]+);base64,(.+)$/i.exec(el.url);
+            if (m)
+                return { kind: 'audio', base64: m[2], mimeType: m[1] };
+        }
+        if (el.url)
+            return readFileAsBase64(el.url, maxBytes);
+    }
+    if (el.type === 'video') {
+        if (el.base64) {
+            return { kind: 'video', base64: el.base64, mimeType: 'video/mp4' };
+        }
+        if (el.url)
+            return readFileAsBase64(el.url, maxBytes);
+    }
+    if (el.type === 'file' && el.url) {
+        return readFileAsBase64(el.url, maxBytes);
+    }
+    return null;
+}
+async function payloadToMessageElement(payload, caps, platform) {
+    const max = caps.maxAttachmentBytes ?? 26_214_400;
+    if (!payload.base64 || payload.base64.length === 0) {
+        if (payload.kind === 'image' && caps.image) {
+            return { type: 'text', data: { text: `[图片: ${payload.meta?.alt || 'image'}]` } };
+        }
+        return null;
+    }
+    const bytes = Math.floor((payload.base64.length * 3) / 4);
+    if (bytes > max) {
+        return { type: 'text', data: { text: `[附件过大 (${(bytes / 1024 / 1024).toFixed(1)} MB)，无法发送]` } };
+    }
+    /** icqq 常与守护进程异机；落盘路径对端不可读，保留 base64 由适配器编码为 CQ base64:// */
+    const spool = payload.base64.length > OUTBOUND_SPOOL_B64_CHARS && platform !== 'icqq';
+    const filePath = spool
+        ? await spoolBase64ToTempFile(payload.base64, payload.mimeType, payload.kind)
+        : undefined;
+    switch (payload.kind) {
+        case 'image':
+            if (!caps.image) {
+                return { type: 'text', data: { text: `[图片: ${payload.meta?.alt || 'image'}]` } };
+            }
+            if (filePath) {
+                return {
+                    type: 'image',
+                    data: { file: filePath, url: filePath, mime: payload.mimeType },
+                };
+            }
+            return {
+                type: 'image',
+                data: {
+                    base64: payload.base64,
+                    mime: payload.mimeType,
+                },
+            };
+        case 'audio':
+            if (!caps.audio) {
+                return { type: 'text', data: { text: elAudioFallback(payload) } };
+            }
+            if (filePath) {
+                return {
+                    type: 'record',
+                    data: {
+                        file: filePath,
+                        url: filePath,
+                        format: payload.mimeType.includes('wav') ? 'wav' : 'mp3',
+                        mime: payload.mimeType,
+                    },
+                };
+            }
+            return {
+                type: 'record',
+                data: {
+                    base64: payload.base64,
+                    data: payload.base64,
+                    format: payload.mimeType.includes('wav') ? 'wav' : 'mp3',
+                    mime: payload.mimeType,
+                },
+            };
+        case 'video':
+            if (!caps.video) {
+                return { type: 'text', data: { text: `[视频]` } };
+            }
+            if (filePath) {
+                return {
+                    type: 'video',
+                    data: { file: filePath, url: filePath, mime: payload.mimeType },
+                };
+            }
+            return {
+                type: 'video',
+                data: {
+                    base64: payload.base64,
+                    mime: payload.mimeType,
+                },
+            };
+        case 'file':
+            if (!caps.file) {
+                return { type: 'text', data: { text: `📎 ${payload.fileName || 'file'}` } };
+            }
+            if (filePath) {
+                return {
+                    type: 'file',
+                    data: {
+                        file: filePath,
+                        url: filePath,
+                        name: payload.fileName || 'file',
+                        mime: payload.mimeType,
+                    },
+                };
+            }
+            return {
+                type: 'file',
+                data: {
+                    base64: payload.base64,
+                    name: payload.fileName || 'file',
+                    mime: payload.mimeType,
+                },
+            };
+        default:
+            return null;
+    }
+}
+function elAudioFallback(payload) {
+    return payload.meta?.alt ? `[语音: ${payload.meta.alt}]` : '[语音消息]';
+}
+function elementToTextSegment(el) {
+    if (el.type === 'text') {
+        return { type: 'text', data: { text: el.content } };
+    }
+    if (el.type === 'card') {
+        const lines = [`📋 ${el.title}`];
+        if (el.description)
+            lines.push(el.description);
+        if (el.fields?.length) {
+            for (const f of el.fields)
+                lines.push(`  ${f.label}: ${f.value}`);
+        }
+        return { type: 'text', data: { text: lines.join('\n') } };
+    }
+    return { type: 'text', data: { text: renderToPlainText([el]) } };
+}
+/**
+ * OutputElement[] → MessageElement[]（base64 契约，平台 adapter 决定如何发送）
+ */
+export async function publishOutboundElements(elements, platform, capsOverride) {
+    const caps = capsOverride ?? resolveOutboundCapabilities(platform);
+    const segments = [];
+    for (const el of elements) {
+        if (el.type === 'text' || el.type === 'card') {
+            if (el.type === 'text' && !el.content?.trim())
+                continue;
+            segments.push(elementToTextSegment(el));
+            continue;
+        }
+        const payload = await elementToPayload(el, caps.maxAttachmentBytes ?? 26_214_400);
+        if (!payload) {
+            segments.push(elementToTextSegment(el));
+            continue;
+        }
+        const seg = await payloadToMessageElement(payload, caps, platform);
+        if (seg)
+            segments.push(seg);
+    }
+    return segments;
+}
+//# sourceMappingURL=media-publisher.js.map

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

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

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

@@ -0,0 +1,7 @@
+import type { ContentPart } from '@zhin.js/ai';
+import type { MultimodalConfig, PreprocessInboundResult } from './media-types.js';
+/**
+ * 入站混合路由：base64 载荷 → 文本补充 + vision image parts
+ */
+export declare function preprocessInboundMedia(parts: ContentPart[], config: MultimodalConfig, workspaceDir?: string): Promise<PreprocessInboundResult>;
+//# sourceMappingURL=media-router.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"media-router.d.ts","sourceRoot":"","sources":["../../src/media/media-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AA2BlF;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,WAAW,EAAE,EACpB,MAAM,EAAE,gBAAgB,EACxB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,uBAAuB,CAAC,CAwClC"}