@qjp88995/agent-runtime 0.0.0-stage → 0.1.0

package/dist/images/byte-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"byte-cache.d.ts","sourceRoot":"","sources":["../../src/images/byte-cache.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,8BAA8B;AAC9B,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,oBAAoB;AACpB,eAAO,MAAM,wBAAwB,QAAoB,CAAC;AAE1D;;;GAGG;AACH,qBAAa,cAAc;IAMvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAN7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2C;IACpE,OAAO,CAAC,KAAK,CAAK;gBAGC,MAAM,EAAE,WAAW,EACnB,UAAU,SAA2B;IAGxD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;YAczB,IAAI;CAkBnB"}

package/dist/images/byte-cache.js

@@ -0,0 +1,51 @@
+import { createHash } from 'node:crypto';
+/** 进程内字节缓存的缺省上限。 */
+export const DEFAULT_BYTE_CACHE_LIMIT = 256 * 1024 * 1024;
+/**
+ * 按 `src` 缓存字节的 LRU：同一条会话每一步都要重发同一批图。`src` 内容不可变，所以永不
+ * 失效，只按体积淘汰（至少留一张）。同一 `src` 的并发读合流成一次。
+ */
+export class ImageByteCache {
+    source;
+    limitBytes;
+    entries = new Map();
+    inflight = new Map();
+    total = 0;
+    constructor(source, limitBytes = DEFAULT_BYTE_CACHE_LIMIT) {
+        this.source = source;
+        this.limitBytes = limitBytes;
+    }
+    load(src) {
+        const hit = this.entries.get(src);
+        if (hit) {
+            this.entries.delete(src);
+            this.entries.set(src, hit);
+            return Promise.resolve(hit);
+        }
+        const pending = this.inflight.get(src);
+        if (pending)
+            return pending;
+        const p = this.read(src).finally(() => this.inflight.delete(src));
+        this.inflight.set(src, p);
+        return p;
+    }
+    async read(src) {
+        const raw = await this.source.read(src);
+        const entry = {
+            data: raw.data,
+            contentType: raw.contentType,
+            contentHash: raw.contentHash ?? createHash('sha256').update(raw.data).digest('hex'),
+        };
+        this.entries.set(src, entry);
+        this.total += entry.data.byteLength;
+        while (this.total > this.limitBytes && this.entries.size > 1) {
+            const oldest = this.entries.keys().next().value;
+            const evicted = this.entries.get(oldest);
+            this.entries.delete(oldest);
+            if (evicted)
+                this.total -= evicted.data.byteLength;
+        }
+        return entry;
+    }
+}
+//# sourceMappingURL=byte-cache.js.map

package/dist/images/byte-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"byte-cache.js","sourceRoot":"","sources":["../../src/images/byte-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAWzC,oBAAoB;AACpB,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1D;;;GAGG;AACH,MAAM,OAAO,cAAc;IAMN;IACA;IANF,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IACzC,QAAQ,GAAG,IAAI,GAAG,EAAgC,CAAC;IAC5D,KAAK,GAAG,CAAC,CAAC;IAElB,YACmB,MAAmB,EACnB,aAAa,wBAAwB;QADrC,WAAM,GAAN,MAAM,CAAa;QACnB,eAAU,GAAV,UAAU,CAA2B;IACrD,CAAC;IAEJ,IAAI,CAAC,GAAW;QACd,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,GAAG,EAAE,CAAC;YACR,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC3B,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;QAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC1B,OAAO,CAAC,CAAC;IACX,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,GAAW;QAC5B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,KAAK,GAAgB;YACzB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,WAAW,EACT,GAAG,CAAC,WAAW,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SACzE,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;QACpC,OAAO,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAe,CAAC;YAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC5B,IAAI,OAAO;gBAAE,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;QACrD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/images/delivery.d.ts

@@ -0,0 +1,115 @@
+import { type LanguageModel } from 'ai';
+import type { ImageSource } from '../ports/image-source.js';
+import { type Logger } from '../ports/logger.js';
+import type { VendorFileCache } from '../ports/vendor-file-cache.js';
+import type { LlmHandles, LlmProviderOptions } from '../turn/turn-run.js';
+import { type DeliveryTexts } from './prompt.js';
+import { VendorFiles, type VendorFileStoreLike } from './vendor-files.js';
+/**
+ * 递送要的那一点模型句柄（provider-client `ModelHandle` 的结构子集；runtime 不依赖那个包，
+ * 兼容性由 `tools/live-images` 的类型检查钉住）。
+ */
+export interface ModelHandleLike {
+    model: LanguageModel;
+    providerOptions?: LlmProviderOptions | undefined;
+    replayedMetadataKeys?: readonly string[];
+    /** 厂商 Files API；没有为 null（只走公网 URL / base64）。 */
+    fileStore: VendorFileStoreLike | null;
+}
+export interface ResolveModelOptions {
+    reasoningEffort?: string;
+    affinity?: string;
+    pin?: string;
+}
+/** provider-client `ModelResolver` 的结构子集（`ProviderClient` / `DirectModelResolver` 都满足）。 */
+export interface ModelResolverLike<H extends ModelHandleLike> {
+    resolve(ref: {
+        vendor: string;
+        modelId: string;
+    }, options?: ResolveModelOptions): Promise<H>;
+}
+export interface ImageDeliveryOptions {
+    /** 字节从哪来。 */
+    source: ImageSource;
+    /** Files API 的上传缓存。缺省进程内（`InMemoryVendorFileCache`），多实例换宿主的库实现。 */
+    cache?: VendorFileCache;
+    /** 上传时的 TTL（秒）；省略 = 厂商默认。每次上传读一次，宿主可接系统参数。 */
+    ttlSeconds?: () => number | undefined;
+    /** 进程内字节缓存上限（缺省 256 MiB）。 */
+    byteCacheLimit?: number;
+    texts?: Partial<DeliveryTexts>;
+    logger?: Logger;
+    now?: () => number;
+}
+/**
+ * 图片递送（agent-base `llm/image-delivery` + `ImageDeliveryService`）。进程级单例：字节缓存与
+ * 上传合流跨会话共享；每一轮用 `wrap` 把那一轮的模型句柄包起来。
+ *
+ * ## 三档（用户拍板，2026-08-27）
+ *
+ * 1. **厂商 Files API**（句柄有 `fileStore` 时；按 `(厂商, 账号, 字节)` 缓存 file id）；
+ * 2. **公网 URL**：`ImageSource.publicUrl` 给了、且承载包 `supportedUrls` 认这个地址与媒体类型；
+ * 3. **base64**——全线公约数。
+ *
+ * 每一档失败都退到下一档，**绝不抛**：一张图递不出去要变成一句给模型看的话，不能让这个会话从此
+ * 发不出请求。
+ *
+ * ## pin（中心模式，2026-11-11 定）
+ *
+ * 厂商文件绑账号，中心又会替我们换 key，所以引用旧文件的请求得 pin 到文件所在的那把。判据在
+ * **每次请求时**按这次 prompt 里的图定（prompt 就是完整历史）：
+ *
+ * - 历史里的图在某个账号上有新鲜的 file id → 选覆盖张数最多的那个账号（平手取最近用过的），
+ *   用 `resolve(…, { pin })` 造一个钉住它的句柄发这次请求；缺的图也传到这个账号上（上传同样 pin）。
+ * - 一个都没有 → 先不 pin 地传第一张（落在中心按粘性选的那把上），拿到 `credentialRef` 后**再 pin
+ *   到它**发请求——这样上传与请求一定在同一个账号上，不靠粘性碰运气。
+ * - 直连模式（`credentialRef` 为 null）只有一把 key，不 pin。
+ *
+ * 两种失败各重做一次递送：厂商说 file id 不存在（错误里点名了这次的 id）→ 忘掉它们、重传；
+ * 中心说钉住的 key 不可用（409 `pinned_credential_unavailable`）→ 这次请求排除那个账号再挑
+ * （多半落到「一个都没有」，重传到新 key 上）。
+ */
+export declare class ImageDelivery {
+    private readonly options;
+    readonly files: VendorFiles;
+    private readonly bytes;
+    private readonly texts;
+    private readonly logger;
+    constructor(options: ImageDeliveryOptions);
+    /**
+     * 把一轮的模型句柄包成会递送图片的模型。
+     *
+     * @param vendor 厂商 slug（缓存键的一段）。
+     * @param base 不 pin 解析出的句柄（带会话粘性）。没有图的请求原样走它，一个对象都不重建。
+     * @param pinned 按 ref 造钉住的句柄（同一个 wrap 内按 ref 记忆）。缺席 = 不 pin（直连）。
+     */
+    wrap(args: {
+        vendor: string;
+        base: ModelHandleLike;
+        pinned?: (credentialRef: string) => Promise<ModelHandleLike>;
+    }): LanguageModel;
+    private run;
+    private prepare;
+    /** 第一档：在本次请求的账号上取（或传）这张图，拿不到给 null。 */
+    private vendorFile;
+}
+/**
+ * 解析一轮要用的模型并接上图片递送。`affinity` 传**根会话 id**（子 Agent 与根共用一把 key：
+ * 前缀缓存与厂商文件都绑账号）。`images` 缺席 = 不递送（prompt 里出现图片引用时承载包会响亮地抛）。
+ *
+ * 返回解析出的完整句柄（宿主要它的能力、上限、单价）与交给 `runTurn` 的 `llm`。
+ */
+export declare function resolveTurnModel<H extends ModelHandleLike>(args: {
+    resolver: ModelResolverLike<H>;
+    ref: {
+        vendor: string;
+        modelId: string;
+    };
+    reasoningEffort?: string;
+    affinity?: string;
+    images?: ImageDelivery | null;
+}): Promise<{
+    handle: H;
+    llm: LlmHandles;
+}>;
+//# sourceMappingURL=delivery.d.ts.map

package/dist/images/delivery.d.ts.map

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

package/dist/images/delivery.js

@@ -0,0 +1,321 @@
+import { wrapLanguageModel, } from 'ai';
+import { InMemoryVendorFileCache } from '../in-process/vendor-file-cache.js';
+import { silentLogger } from '../ports/logger.js';
+import { DEFAULT_BYTE_CACHE_LIMIT, ImageByteCache, } from './byte-cache.js';
+import { collectPendingImages, DEFAULT_DELIVERY_TEXTS, deliverImages, isPinnedCredentialUnavailable, rejectedVendorFiles, urlSupported, } from './prompt.js';
+import { DIRECT_ACCOUNT, VendorFiles, } from './vendor-files.js';
+function callable(model) {
+    if (typeof model === 'string') {
+        throw new Error('image delivery needs a model object, not a gateway model id string');
+    }
+    return model;
+}
+function basenameOf(path) {
+    const i = path.lastIndexOf('/');
+    return i >= 0 ? path.slice(i + 1) : path;
+}
+/**
+ * 图片递送（agent-base `llm/image-delivery` + `ImageDeliveryService`）。进程级单例：字节缓存与
+ * 上传合流跨会话共享；每一轮用 `wrap` 把那一轮的模型句柄包起来。
+ *
+ * ## 三档（用户拍板，2026-08-27）
+ *
+ * 1. **厂商 Files API**（句柄有 `fileStore` 时；按 `(厂商, 账号, 字节)` 缓存 file id）；
+ * 2. **公网 URL**：`ImageSource.publicUrl` 给了、且承载包 `supportedUrls` 认这个地址与媒体类型；
+ * 3. **base64**——全线公约数。
+ *
+ * 每一档失败都退到下一档，**绝不抛**：一张图递不出去要变成一句给模型看的话，不能让这个会话从此
+ * 发不出请求。
+ *
+ * ## pin（中心模式，2026-11-11 定）
+ *
+ * 厂商文件绑账号，中心又会替我们换 key，所以引用旧文件的请求得 pin 到文件所在的那把。判据在
+ * **每次请求时**按这次 prompt 里的图定（prompt 就是完整历史）：
+ *
+ * - 历史里的图在某个账号上有新鲜的 file id → 选覆盖张数最多的那个账号（平手取最近用过的），
+ *   用 `resolve(…, { pin })` 造一个钉住它的句柄发这次请求；缺的图也传到这个账号上（上传同样 pin）。
+ * - 一个都没有 → 先不 pin 地传第一张（落在中心按粘性选的那把上），拿到 `credentialRef` 后**再 pin
+ *   到它**发请求——这样上传与请求一定在同一个账号上，不靠粘性碰运气。
+ * - 直连模式（`credentialRef` 为 null）只有一把 key，不 pin。
+ *
+ * 两种失败各重做一次递送：厂商说 file id 不存在（错误里点名了这次的 id）→ 忘掉它们、重传；
+ * 中心说钉住的 key 不可用（409 `pinned_credential_unavailable`）→ 这次请求排除那个账号再挑
+ * （多半落到「一个都没有」，重传到新 key 上）。
+ */
+export class ImageDelivery {
+    options;
+    files;
+    bytes;
+    texts;
+    logger;
+    constructor(options) {
+        this.options = options;
+        this.logger = options.logger ?? silentLogger('ImageDelivery');
+        this.files = new VendorFiles({
+            cache: options.cache ?? new InMemoryVendorFileCache(),
+            ttlSeconds: options.ttlSeconds,
+            logger: this.logger,
+            now: options.now,
+        });
+        this.bytes = new ImageByteCache(options.source, options.byteCacheLimit ?? DEFAULT_BYTE_CACHE_LIMIT);
+        this.texts = { ...DEFAULT_DELIVERY_TEXTS, ...options.texts };
+    }
+    /**
+     * 把一轮的模型句柄包成会递送图片的模型。
+     *
+     * @param vendor 厂商 slug（缓存键的一段）。
+     * @param base 不 pin 解析出的句柄（带会话粘性）。没有图的请求原样走它，一个对象都不重建。
+     * @param pinned 按 ref 造钉住的句柄（同一个 wrap 内按 ref 记忆）。缺席 = 不 pin（直连）。
+     */
+    wrap(args) {
+        const memo = new Map();
+        const pinnedHandle = args.pinned
+            ? (ref) => {
+                let p = memo.get(ref);
+                if (!p) {
+                    p = args.pinned(ref);
+                    memo.set(ref, p);
+                    p.catch(() => memo.delete(ref));
+                }
+                return p;
+            }
+            : undefined;
+        const run = (params, passthrough, call) => this.run(args.vendor, args.base, pinnedHandle, params, passthrough, call);
+        const middleware = {
+            specificationVersion: 'v4',
+            wrapGenerate: ({ doGenerate, params }) => run(params, doGenerate, (m, p) => m.doGenerate(p)),
+            wrapStream: ({ doStream, params }) => run(params, doStream, (m, p) => m.doStream(p)),
+        };
+        return wrapLanguageModel({
+            model: callable(args.base.model),
+            middleware,
+        });
+    }
+    async run(vendor, base, pinnedHandle, params, passthrough, call) {
+        const prompt = params.prompt;
+        const pending = collectPendingImages(prompt);
+        // 快路径：一张我们的图都没有就原样放行。
+        if (pending.length === 0)
+            return passthrough();
+        const excluded = new Set();
+        let staleRetried = false;
+        let pinRetried = false;
+        for (;;) {
+            const attempt = await this.prepare(vendor, base, pinnedHandle, prompt, pending, excluded);
+            try {
+                return await call(callable(attempt.handle.model), {
+                    ...params,
+                    prompt: attempt.prompt,
+                });
+            }
+            catch (err) {
+                const rejected = rejectedVendorFiles(err, attempt.fileIds);
+                if (!staleRetried &&
+                    attempt.account !== undefined &&
+                    rejected.length > 0) {
+                    staleRetried = true;
+                    await this.files.forget(vendor, attempt.account, rejected);
+                    continue;
+                }
+                if (!pinRetried &&
+                    attempt.pinned !== undefined &&
+                    isPinnedCredentialUnavailable(err)) {
+                    pinRetried = true;
+                    this.logger.warn(`pinned credential ${attempt.pinned} of ${vendor} unavailable; re-delivering without it`);
+                    excluded.add(attempt.pinned);
+                    continue;
+                }
+                throw err;
+            }
+        }
+    }
+    async prepare(vendor, base, pinnedHandle, prompt, pending, excluded) {
+        const loaded = new Map();
+        for (const { src } of pending) {
+            if (loaded.has(src))
+                continue;
+            try {
+                loaded.set(src, await this.bytes.load(src));
+            }
+            catch (err) {
+                // 对象被删 / 存储不可达：给模型一句话而不是抛——抛了这个会话每次发言都会死在这里。
+                this.logger.warn(`image ${src} unavailable for delivery: ${String(err)}`);
+                loaded.set(src, null);
+            }
+        }
+        const state = {
+            prompt: [],
+            handle: base,
+            pinned: undefined,
+            account: undefined,
+            fileIds: [],
+        };
+        const usePin = async (account) => {
+            state.account = account;
+            if (account === DIRECT_ACCOUNT || !pinnedHandle)
+                return;
+            try {
+                state.handle = await pinnedHandle(account);
+                state.pinned = account;
+            }
+            catch (err) {
+                // 造不出钉住的句柄（目录刷新失败之类）：这次不 pin，交给粘性。
+                this.logger.warn(`cannot pin ${vendor} to ${account}: ${String(err)}`);
+            }
+        };
+        let records = [];
+        if (base.fileStore) {
+            const hashes = [
+                ...new Set([...loaded.values()].flatMap(l => (l ? [l.contentHash] : []))),
+            ];
+            records = (await this.files.lookup(vendor, hashes)).filter(r => !excluded.has(r.account));
+            const account = pickAccount(records.filter(r => this.files.isFresh(r)));
+            if (account !== undefined)
+                await usePin(account);
+        }
+        const resolve = async (img) => {
+            const bytes = loaded.get(img.src);
+            if (!bytes) {
+                return { kind: 'unavailable', reason: this.texts.unavailable };
+            }
+            const mediaType = img.mediaType || bytes.contentType;
+            // 1. 厂商 Files API
+            const store = state.handle.fileStore;
+            if (store) {
+                const fileId = await this.vendorFile(vendor, store, img, bytes, mediaType, records, state, usePin);
+                if (fileId) {
+                    state.fileIds.push(fileId);
+                    return {
+                        kind: 'file',
+                        vendorFileId: fileId,
+                        part: {
+                            type: 'file',
+                            mediaType,
+                            data: {
+                                type: 'reference',
+                                reference: { [store.referenceKey]: fileId },
+                            },
+                        },
+                    };
+                }
+            }
+            // 2. 公网 URL
+            const url = this.options.source.publicUrl?.(img.src) ?? null;
+            if (url && /^https?:\/\//.test(url)) {
+                const supported = (await callable(state.handle.model).supportedUrls) ?? {};
+                if (urlSupported(supported, mediaType, url)) {
+                    return {
+                        kind: 'file',
+                        part: {
+                            type: 'file',
+                            mediaType,
+                            data: { type: 'url', url: new URL(url) },
+                        },
+                    };
+                }
+            }
+            // 3. base64
+            return {
+                kind: 'file',
+                part: {
+                    type: 'file',
+                    mediaType,
+                    data: { type: 'data', data: bytes.data },
+                },
+            };
+        };
+        state.prompt = await deliverImages(prompt, resolve, this.texts);
+        return state;
+    }
+    /** 第一档：在本次请求的账号上取（或传）这张图，拿不到给 null。 */
+    async vendorFile(vendor, store, img, bytes, mediaType, records, state, usePin) {
+        const same = (r) => r.account === state.account && r.contentHash === bytes.contentHash;
+        if (state.account !== undefined) {
+            const hit = records.find(r => same(r) && this.files.isFresh(r));
+            if (hit) {
+                this.files.touch(hit);
+                return hit.fileId;
+            }
+        }
+        const uploaded = await this.files.upload({
+            vendor,
+            store,
+            contentHash: bytes.contentHash,
+            src: img.src,
+            data: bytes.data,
+            mediaType,
+            ...(img.path ? { filename: basenameOf(img.path) } : {}),
+            previous: records.filter(r => r.contentHash === bytes.contentHash),
+        }, state.pinned);
+        if (!uploaded)
+            return null;
+        if (state.account === undefined) {
+            // 第一张上传定账号：之后的图与这次请求都钉到它上面。
+            await usePin(uploaded.account);
+        }
+        else if (uploaded.account !== state.account) {
+            // 钉住了却落到别的账号（不该发生）：这个 id 这次请求用不了，记下的账留给以后。
+            this.logger.warn(`upload for ${vendor} landed on ${uploaded.account}, expected ${state.account}`);
+            records.push(uploaded);
+            return null;
+        }
+        records.push(uploaded);
+        return uploaded.fileId;
+    }
+}
+/** 覆盖张数最多的账号；平手取最近用过的。 */
+function pickAccount(records) {
+    const score = new Map();
+    for (const r of records) {
+        const s = score.get(r.account) ?? { hashes: new Set(), last: 0 };
+        s.hashes.add(r.contentHash);
+        s.last = Math.max(s.last, r.lastUsedAt.getTime());
+        score.set(r.account, s);
+    }
+    let best;
+    let bestScore;
+    for (const [account, s] of score) {
+        if (!bestScore ||
+            s.hashes.size > bestScore.hashes.size ||
+            (s.hashes.size === bestScore.hashes.size && s.last > bestScore.last)) {
+            best = account;
+            bestScore = s;
+        }
+    }
+    return best;
+}
+/**
+ * 解析一轮要用的模型并接上图片递送。`affinity` 传**根会话 id**（子 Agent 与根共用一把 key：
+ * 前缀缓存与厂商文件都绑账号）。`images` 缺席 = 不递送（prompt 里出现图片引用时承载包会响亮地抛）。
+ *
+ * 返回解析出的完整句柄（宿主要它的能力、上限、单价）与交给 `runTurn` 的 `llm`。
+ */
+export async function resolveTurnModel(args) {
+    const options = {
+        ...(args.reasoningEffort !== undefined
+            ? { reasoningEffort: args.reasoningEffort }
+            : {}),
+        ...(args.affinity !== undefined ? { affinity: args.affinity } : {}),
+    };
+    const handle = await args.resolver.resolve(args.ref, options);
+    const model = args.images
+        ? args.images.wrap({
+            vendor: args.ref.vendor,
+            base: handle,
+            pinned: pin => args.resolver.resolve(args.ref, { ...options, pin }),
+        })
+        : handle.model;
+    return {
+        handle,
+        llm: {
+            model,
+            ...(handle.providerOptions !== undefined
+                ? { providerOptions: handle.providerOptions }
+                : {}),
+            ...(handle.replayedMetadataKeys !== undefined
+                ? { replayedMetadataKeys: handle.replayedMetadataKeys }
+                : {}),
+        },
+    };
+}
+//# sourceMappingURL=delivery.js.map

package/dist/images/delivery.js.map

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

package/dist/images/index.d.ts

@@ -0,0 +1,5 @@
+export { DEFAULT_BYTE_CACHE_LIMIT, ImageByteCache, type LoadedImage, } from './byte-cache.js';
+export { ImageDelivery, type ImageDeliveryOptions, type ModelHandleLike, type ModelResolverLike, type ResolveModelOptions, resolveTurnModel, } from './delivery.js';
+export { collectPendingImages, DEFAULT_DELIVERY_TEXTS, type DeliveredImage, deliverImages, type DeliveryTexts, errorText, type ImageResolver, isPinnedCredentialUnavailable, mentionsVendorFile, type PendingImage, rejectedVendorFiles, urlSupported, } from './prompt.js';
+export { DIRECT_ACCOUNT, MIN_VENDOR_FILE_TTL_SECONDS, VENDOR_FILE_EXPIRY_MARGIN_MS, VendorFiles, type VendorFilesOptions, type VendorFileStoreLike, } from './vendor-files.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/images/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/images/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,cAAc,EACd,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,KAAK,cAAc,EACnB,aAAa,EACb,KAAK,aAAa,EAClB,SAAS,EACT,KAAK,aAAa,EAClB,6BAA6B,EAC7B,kBAAkB,EAClB,KAAK,YAAY,EACjB,mBAAmB,EACnB,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,2BAA2B,EAC3B,4BAA4B,EAC5B,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAC"}

package/dist/images/index.js

@@ -0,0 +1,5 @@
+export { DEFAULT_BYTE_CACHE_LIMIT, ImageByteCache, } from './byte-cache.js';
+export { ImageDelivery, resolveTurnModel, } from './delivery.js';
+export { collectPendingImages, DEFAULT_DELIVERY_TEXTS, deliverImages, errorText, isPinnedCredentialUnavailable, mentionsVendorFile, rejectedVendorFiles, urlSupported, } from './prompt.js';
+export { DIRECT_ACCOUNT, MIN_VENDOR_FILE_TTL_SECONDS, VENDOR_FILE_EXPIRY_MARGIN_MS, VendorFiles, } from './vendor-files.js';
+//# sourceMappingURL=index.js.map

package/dist/images/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/images/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,cAAc,GAEf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,aAAa,EAKb,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EAEtB,aAAa,EAEb,SAAS,EAET,6BAA6B,EAC7B,kBAAkB,EAElB,mBAAmB,EACnB,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,2BAA2B,EAC3B,4BAA4B,EAC5B,WAAW,GAGZ,MAAM,mBAAmB,CAAC"}