@jingyi0605/codingns4dsh 0.2.1-beta.2 → 0.2.1-beta.4

package/data/build/dist/host/avatar/materials.js

@@ -0,0 +1,183 @@
+import { createHash } from 'node:crypto';
+import { copyAssistantAvatarModel, validateAssistantAvatarModel } from '../../shared/assistant-avatar.js';
+import { assistantAvatarInstalledSource } from '../../shared/assistant-avatar-installation.js';
+import { resolveAssistantAvatarSource } from '../../shared/assistant-avatar-adapters.js';
+import { AssistantAvatarRemote } from './remote.js';
+const image = {
+    id: 'image', supports: (renderer) => renderer === 'image' || renderer === 'spritesheet',
+    async install(asset, context) {
+        const source = await context.file(asset.source, 'image');
+        const entries = await Promise.all(Object.entries(asset.stateSources ?? {}).map(async ([state, url]) => [state, await context.file(url, 'image')]));
+        return { ...asset, source, ...(asset.stateSources === undefined ? {} : { stateSources: Object.fromEntries(entries) }) };
+    },
+};
+const live2d = {
+    id: 'live2d', supports: (renderer) => renderer === 'live2d',
+    async install(asset, context) { return { ...asset, source: await context.model(asset.source) }; },
+};
+export const BUILTIN_ASSISTANT_AVATAR_MATERIAL_ADAPTERS = [image, live2d];
+const marker = 'PACK_VERSION';
+const digest = (value) => createHash('sha256').update(value).digest('hex');
+/** 依赖完整下载并重写为本地引用；模型、动作、贴图本体不做裁剪。 */
+export async function installAssistantAvatarMaterials(model, remote, signal, adapters = BUILTIN_ASSISTANT_AVATAR_MATERIAL_ADAPTERS) {
+    validateAssistantAvatarModel(model);
+    const lifetime = new AbortController();
+    const cancellation = signal === undefined ? lifetime.signal : AbortSignal.any([lifetime.signal, signal]);
+    const pending = new Map();
+    const materials = [];
+    let size = 0;
+    let active = 0;
+    const waiters = [];
+    const read = async (source, maxBytes) => {
+        if (active >= 4)
+            await new Promise((resolve) => waiters.push(resolve));
+        else
+            active++;
+        try {
+            cancellation.throwIfAborted();
+            return await remote.read(source, maxBytes, cancellation);
+        }
+        finally {
+            const next = waiters.shift();
+            if (next === undefined)
+                active--;
+            else
+                next();
+        }
+    };
+    const register = (source, contentType, bytes) => {
+        size += bytes.byteLength;
+        if (size > 256 * 1024 * 1024)
+            throw new TypeError('单个形象包超过 256 MiB');
+        const suffix = new URL(source).pathname.match(/(\.model3?\.json|\.[a-z0-9]+)$/iu)?.[1]?.toLowerCase() ?? '.bin';
+        const key = `${digest(source)}${suffix}`;
+        materials.push({ key, contentType, bytes });
+        return assistantAvatarInstalledSource(marker, key);
+    };
+    const once = (source, action) => {
+        const existing = pending.get(source);
+        if (existing !== undefined)
+            return existing;
+        if (pending.size >= 256)
+            throw new TypeError('单个形象包最多包含 256 个资源');
+        const task = action();
+        pending.set(source, task);
+        return task;
+    };
+    const context = {
+        signal: cancellation,
+        file(source, kind) {
+            const contentType = resourceType(source, kind);
+            return once(source, async () => {
+                const result = await read(source, kind === 'json' ? 2 * 1024 * 1024 : 32 * 1024 * 1024);
+                // 对资源 JSON 做语法验证，避免把错误网页作为缓存成功保存。
+                if (kind === 'json')
+                    JSON.parse(new TextDecoder().decode(result.bytes));
+                if (kind === 'image' && !imageSignature(result.bytes))
+                    throw new TypeError('图片资源内容无效');
+                return register(source, contentType, result.bytes);
+            });
+        },
+        model(source) {
+            resourceType(source, 'json');
+            return once(source, async () => {
+                const result = await read(source, 2 * 1024 * 1024);
+                const value = JSON.parse(new TextDecoder().decode(result.bytes));
+                const rewritten = await rewriteAssistantAvatarModel(value, result.url, context);
+                // l2d 通过字符串拼接目录，因此依赖引用须是同目录的相对入口，而非绝对 URL。
+                const bytes = new TextEncoder().encode(JSON.stringify(rewritten));
+                return register(source, 'application/json', bytes);
+            });
+        },
+    };
+    const install = async (asset) => {
+        const adapter = adapters.find((item) => item.supports(asset.renderer));
+        if (adapter === undefined)
+            throw new TypeError(`此渲染器尚无本地素材安装适配器：${asset.renderer}`);
+        return adapter.install(asset, context);
+    };
+    try {
+        // 顺序收集展示位置，共用去重表，不重复下载同一个模型或贴图。
+        const base = await install(model);
+        const surfaces = model.surfaces === undefined ? undefined : Object.fromEntries(await Promise.all(Object.entries(model.surfaces).map(async ([surface, asset]) => [surface, await install(asset)])));
+        await Promise.all(pending.values());
+        cancellation.throwIfAborted();
+        const result = { id: model.id, name: model.name, ...base, package: model.package, ...(surfaces === undefined ? {} : { surfaces }) };
+        const id = digest(JSON.stringify([result, materials.map((file) => [file.key, digest(file.bytes)]).sort(([a], [b]) => a.localeCompare(b))]));
+        const local = JSON.parse(JSON.stringify(result).replaceAll(`pack=${marker}`, `pack=${id}`));
+        const completed = materials.map((file) => file.contentType !== 'application/json' ? file : { ...file,
+            bytes: new TextEncoder().encode(new TextDecoder().decode(file.bytes).replaceAll(`pack=${marker}`, `pack=${id}`)) });
+        return { id, model: copyAssistantAvatarModel({ ...local, package: { ...local.package, adapterId: local.package?.adapterId ?? 'codingns-pack', installationId: id } }), materials: completed };
+    }
+    catch (error) {
+        // 一项失败后取消其余并发下载，再等待它们退出，避免孤立请求跨越安装生命周期。
+        lifetime.abort();
+        await Promise.allSettled(pending.values());
+        throw error;
+    }
+}
+/** Cubism 2/3 的所有文件引用统一走安装上下文，其余布局、参数和扩展数据原样保留。 */
+export async function rewriteAssistantAvatarModel(value, source, context) {
+    if (!record(value))
+        throw new TypeError('Live2D 模型清单无效');
+    const cubism3 = value.FileReferences !== undefined;
+    if (cubism3 && (value.Version !== 3 || !record(value.FileReferences)))
+        throw new TypeError('Live2D 模型版本无效');
+    const refs = { ...(cubism3 ? value.FileReferences : value) };
+    const field = async (input, kind) => {
+        const local = await context.file(resolveAssistantAvatarSource(input, source), kind);
+        return local.slice(local.lastIndexOf('/') + 1);
+    };
+    const mocKey = cubism3 ? 'Moc' : 'model';
+    const textureKey = cubism3 ? 'Textures' : 'textures';
+    const textures = refs[textureKey];
+    if (!Array.isArray(textures) || textures.length === 0 || textures.length > 32)
+        throw new TypeError('Live2D 模型贴图无效');
+    refs[mocKey] = await field(refs[mocKey], 'binary');
+    refs[textureKey] = await Promise.all(textures.map((url) => field(url, 'image')));
+    for (const key of cubism3 ? ['Physics', 'Pose', 'UserData', 'DisplayInfo'] : ['physics', 'pose']) {
+        if (refs[key] !== undefined && refs[key] !== '')
+            refs[key] = await field(refs[key], 'json');
+    }
+    const rewriteEntries = async (entries) => {
+        if (!Array.isArray(entries) || entries.length > 256)
+            throw new TypeError('Live2D 动作或表情列表无效');
+        return Promise.all(entries.map(async (entry) => {
+            if (!record(entry))
+                throw new TypeError('Live2D 动作或表情无效');
+            const key = cubism3 ? 'File' : 'file';
+            const result = { ...entry, [key]: await field(entry[key], cubism3 || new URL(resolveAssistantAvatarSource(entry[key], source)).pathname.endsWith('.json') ? 'json' : 'motion') };
+            const sound = cubism3 ? 'Sound' : 'sound';
+            if (entry[sound] !== undefined && entry[sound] !== '')
+                result[sound] = await field(entry[sound], 'sound');
+            return result;
+        }));
+    };
+    const expressions = cubism3 ? 'Expressions' : 'expressions';
+    if (refs[expressions] !== undefined)
+        refs[expressions] = await rewriteEntries(refs[expressions]);
+    const motionsKey = cubism3 ? 'Motions' : 'motions';
+    if (refs[motionsKey] !== undefined) {
+        if (!record(refs[motionsKey]))
+            throw new TypeError('Live2D 动作映射无效');
+        refs[motionsKey] = Object.fromEntries(await Promise.all(Object.entries(refs[motionsKey]).map(async ([group, entries]) => [group, await rewriteEntries(entries)])));
+    }
+    return cubism3 ? { ...value, FileReferences: refs } : refs;
+}
+function record(value) { return value !== null && typeof value === 'object' && !Array.isArray(value); }
+function resourceType(source, kind) {
+    const ext = new URL(source).pathname.split('.').pop()?.toLowerCase();
+    const types = kind === 'image' ? { png: 'image/png', webp: 'image/webp', jpg: 'image/jpeg', jpeg: 'image/jpeg', gif: 'image/gif' }
+        : kind === 'json' ? { json: 'application/json' } : kind === 'binary' ? { moc: 'application/octet-stream', moc3: 'application/octet-stream' }
+            : kind === 'motion' ? { mtn: 'application/octet-stream' } : { wav: 'audio/wav', mp3: 'audio/mpeg', ogg: 'audio/ogg' };
+    const type = ext === undefined ? undefined : types[ext];
+    if (type === undefined)
+        throw new TypeError('形象资源类型不受支持，请提供 JSON、模型、图片或音频文件地址');
+    return type;
+}
+function imageSignature(bytes) {
+    const head = new TextDecoder().decode(bytes.slice(0, 12));
+    return (bytes[0] === 137 && head.slice(1, 4) === 'PNG') || head.startsWith('GIF8')
+        || (head.startsWith('RIFF') && head.slice(8, 12) === 'WEBP') || (bytes[0] === 255 && bytes[1] === 216 && bytes[2] === 255);
+}
+//# sourceMappingURL=materials.js.map

package/data/build/dist/host/avatar/materials.js.map

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

package/data/build/dist/host/avatar/packages.d.ts

@@ -0,0 +1,34 @@
+import type { AssistantAvatarAdapter } from '../../shared/assistant-avatar-adapters.js';
+import type { AssistantAvatarInstallation } from '../../shared/assistant-avatar-installation.js';
+import { AssistantAvatarRemote } from './remote.js';
+import type { AssistantAvatarSourceAdapter } from './sources.js';
+import type { AssistantAvatarMaterialAdapter } from './materials.js';
+import { AssistantAvatarRegistration } from '../../shared/assistant-avatar-registration.js';
+/** 自有素材目录，不复用 DSH 插件安装目录、源码或 Desktop Profile。 */
+export declare function assistantAvatarPackageDirectory(): string;
+/** 原子安装的素材仓库；目录中的有效 record.json 是唯一完成标记。 */
+export declare class AssistantAvatarPackages {
+    readonly directory: string;
+    private readonly remote;
+    private readonly generation;
+    private readonly records;
+    private writes;
+    readonly formats: AssistantAvatarRegistration<AssistantAvatarAdapter>;
+    readonly sources: AssistantAvatarRegistration<AssistantAvatarSourceAdapter>;
+    readonly materials: AssistantAvatarRegistration<AssistantAvatarMaterialAdapter>;
+    constructor(directory?: string, remote?: AssistantAvatarRemote, formats?: readonly AssistantAvatarAdapter[], sources?: readonly AssistantAvatarSourceAdapter[], materials?: readonly AssistantAvatarMaterialAdapter[]);
+    discover(source: string, signal?: AbortSignal): Promise<readonly import("../../shared/assistant-avatar-installation.js").AssistantAvatarCandidate[]>;
+    install(source: string, adapterId?: string, signal?: AbortSignal): Promise<AssistantAvatarInstallation>;
+    /** 受控目录复用同一适配器和原子安装流程，不依赖尚未发布的 GitHub 清单 URL。 */
+    installManifest(value: unknown, manifestUrl: string, adapterId?: string, signal?: AbortSignal): Promise<AssistantAvatarInstallation>;
+    private installModel;
+    /** 临时预览采用时复制已验证完整素材，不再请求上游，也不搬走正在绘制的文件。 */
+    copyFrom(source: AssistantAvatarPackages, id: string, signal?: AbortSignal): Promise<AssistantAvatarInstallation>;
+    private commit;
+    list(): Promise<readonly AssistantAvatarInstallation[]>;
+    remove(id: string): Promise<void>;
+    readonly handle: (request: Request) => Promise<Response>;
+    private record;
+    private mutate;
+}
+//# sourceMappingURL=packages.d.ts.map

package/data/build/dist/host/avatar/packages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packages.d.ts","sourceRoot":"","sources":["../../../../../src/host/avatar/packages.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAA;AAIvF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+CAA+C,CAAA;AAChG,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAEnD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAA;AAEhE,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAA;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,+CAA+C,CAAA;AAQ3F,iDAAiD;AACjD,wBAAgB,+BAA+B,IAAI,MAAM,CAExD;AAED,4CAA4C;AAC5C,qBAAa,uBAAuB;IAOtB,QAAQ,CAAC,SAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAe;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,MAAM,CAAsC;IACpD,QAAQ,CAAC,OAAO,EAAE,2BAA2B,CAAC,sBAAsB,CAAC,CAAA;IACrE,QAAQ,CAAC,OAAO,EAAE,2BAA2B,CAAC,4BAA4B,CAAC,CAAA;IAC3E,QAAQ,CAAC,SAAS,EAAE,2BAA2B,CAAC,8BAA8B,CAAC,CAAA;gBAC1D,SAAS,SAAoC,EAC/C,MAAM,wBAA8B,EACrD,OAAO,GAAE,SAAS,sBAAsB,EAAsC,EAC9E,OAAO,GAAE,SAAS,4BAA4B,EAA6C,EAC3F,SAAS,GAAE,SAAS,8BAA8B,EAA+C;IAMnG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW;IACvC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,SAAS,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAa7G,iDAAiD;IACjD,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,SAAS,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,2BAA2B,CAAC;YAQtH,YAAY;IAK1B,2CAA2C;IACrC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAWvH,OAAO,CAAC,MAAM;IAwBR,IAAI,IAAI,OAAO,CAAC,SAAS,2BAA2B,EAAE,CAAC;IAM7D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjC,QAAQ,CAAC,MAAM,GAAU,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CAsB5D;YACa,MAAM;IAiBpB,OAAO,CAAC,MAAM;CAKf"}

package/data/build/dist/host/avatar/packages.js

@@ -0,0 +1,200 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { mkdir, readFile, readdir, rename, rm, stat, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { BUILTIN_ASSISTANT_AVATAR_ADAPTERS } from '../../shared/assistant-avatar-adapters.js';
+import { copyAssistantAvatarModel, validateAssistantAvatarModel } from '../../shared/assistant-avatar.js';
+import { ASSISTANT_AVATAR_ASSET_PATH, ASSISTANT_AVATAR_STATUS_PATH } from '../../shared/assistant-avatar-installation.js';
+import { AssistantAvatarRemote } from './remote.js';
+import { discoverAssistantAvatarSource, BUILTIN_ASSISTANT_AVATAR_SOURCE_ADAPTERS } from './sources.js';
+import { installAssistantAvatarMaterials, BUILTIN_ASSISTANT_AVATAR_MATERIAL_ADAPTERS } from './materials.js';
+import { AssistantAvatarRegistration } from '../../shared/assistant-avatar-registration.js';
+/** 自有素材目录，不复用 DSH 插件安装目录、源码或 Desktop Profile。 */
+export function assistantAvatarPackageDirectory() {
+    return join(process.env.CODINGNS4DSH_STATE_DIR?.trim() || join(homedir(), '.config', 'codingns4dsh'), 'assistant-avatar-packages');
+}
+/** 原子安装的素材仓库；目录中的有效 record.json 是唯一完成标记。 */
+export class AssistantAvatarPackages {
+    directory;
+    remote;
+    generation = randomUUID();
+    records = new Map();
+    writes = Promise.resolve();
+    formats;
+    sources;
+    materials;
+    constructor(directory = assistantAvatarPackageDirectory(), remote = new AssistantAvatarRemote(), formats = BUILTIN_ASSISTANT_AVATAR_ADAPTERS, sources = BUILTIN_ASSISTANT_AVATAR_SOURCE_ADAPTERS, materials = BUILTIN_ASSISTANT_AVATAR_MATERIAL_ADAPTERS) {
+        this.directory = directory;
+        this.remote = remote;
+        this.formats = new AssistantAvatarRegistration(formats);
+        this.sources = new AssistantAvatarRegistration(sources);
+        this.materials = new AssistantAvatarRegistration(materials);
+    }
+    discover(source, signal) { return discoverAssistantAvatarSource(source, this.remote, signal, this.sources.getSnapshot()); }
+    async install(source, adapterId = 'auto', signal) {
+        signal?.throwIfAborted();
+        let model;
+        if (/\.(png|webp|jpe?g|gif)$/iu.test(new URL(source).pathname)) {
+            const id = createHash('sha256').update(source).digest('hex').slice(0, 16);
+            model = { id: `image-${id}`, name: decodeURIComponent(new URL(source).pathname.split('/').pop() || '形象').slice(0, 80),
+                renderer: 'image', source, spriteVersion: 2, package: { adapterId: 'codingns-pack', manifestUrl: source } };
+        }
+        else {
+            const manifest = await this.remote.json(source, signal);
+            return this.installManifest(manifest.value, manifest.url, adapterId, signal);
+        }
+        return this.installModel(model, signal);
+    }
+    /** 受控目录复用同一适配器和原子安装流程，不依赖尚未发布的 GitHub 清单 URL。 */
+    installManifest(value, manifestUrl, adapterId = 'auto', signal) {
+        signal?.throwIfAborted();
+        const adapter = adapterId === 'auto' ? this.formats.getSnapshot().find((item) => item.matches(value)) : this.formats.get(adapterId);
+        if (adapter === undefined || !adapter.matches(value))
+            throw new TypeError('无法识别形象包，或所选适配器未注册');
+        const parsed = adapter.parse(value, { manifestUrl });
+        const model = copyAssistantAvatarModel({ ...parsed, package: { ...parsed.package, adapterId: adapter.id, manifestUrl } });
+        return this.installModel(model, signal);
+    }
+    async installModel(model, signal) {
+        validateAssistantAvatarModel(model);
+        const installed = await installAssistantAvatarMaterials(model, this.remote, signal, this.materials.getSnapshot());
+        return this.commit(installed, signal);
+    }
+    /** 临时预览采用时复制已验证完整素材，不再请求上游，也不搬走正在绘制的文件。 */
+    async copyFrom(source, id, signal) {
+        signal?.throwIfAborted();
+        const record = await source.record(id);
+        if (record === undefined)
+            throw new TypeError('临时形象素材已清理，请重新预览');
+        const materials = await Promise.all(record.files.map(async (file) => {
+            const bytes = await readFile(join(source.directory, id, file.key));
+            if (bytes.byteLength !== file.bytes)
+                throw new TypeError('临时形象素材不完整');
+            return { key: file.key, contentType: file.contentType, bytes };
+        }));
+        return this.commit({ id, model: record.model, materials }, signal);
+    }
+    commit(installed, signal) {
+        // 只有素材完整且未取消才写入；与删除串行，避免旧安装结果复活已卸载记录。
+        return this.mutate(async () => {
+            signal?.throwIfAborted();
+            const previous = await this.record(installed.id);
+            if (previous !== undefined)
+                return summary(previous, false);
+            await mkdir(this.directory, { recursive: true });
+            const staging = join(this.directory, `.install-${randomUUID()}`);
+            await mkdir(staging);
+            try {
+                for (const material of installed.materials) {
+                    signal?.throwIfAborted();
+                    await writeFile(join(staging, material.key), material.bytes, { flag: 'wx' });
+                }
+                const record = { version: 1, id: installed.id, model: installed.model,
+                    files: installed.materials.map(({ key, contentType, bytes }) => ({ key, contentType, bytes: bytes.byteLength })) };
+                await writeFile(join(staging, 'record.json'), JSON.stringify(record), { flag: 'wx' });
+                signal?.throwIfAborted();
+                await rename(staging, join(this.directory, record.id));
+                this.records.set(record.id, record);
+                return summary(record, true);
+            }
+            finally {
+                await rm(staging, { recursive: true, force: true });
+            }
+        });
+    }
+    async list() {
+        let names;
+        try {
+            names = await readdir(this.directory);
+        }
+        catch (error) {
+            if (missing(error))
+                return [];
+            throw error;
+        }
+        const records = await Promise.all(names.filter(validPackId).map((name) => this.record(name)));
+        return records.filter((value) => value !== undefined).map((record) => summary(record, false));
+    }
+    remove(id) {
+        if (!validPackId(id))
+            throw new TypeError('形象安装版本无效');
+        return this.mutate(async () => {
+            await rm(join(this.directory, id), { recursive: true, force: true });
+            this.records.delete(id);
+        });
+    }
+    handle = async (request) => {
+        const url = new URL(request.url);
+        if (![ASSISTANT_AVATAR_ASSET_PATH, ASSISTANT_AVATAR_STATUS_PATH].includes(url.pathname))
+            return new Response(null, { status: 404 });
+        if (request.method !== 'GET')
+            return new Response(null, { status: 405, headers: { Allow: 'GET' } });
+        const id = url.searchParams.get('pack') ?? '';
+        const record = await this.record(id);
+        if (record === undefined)
+            return new Response(null, { status: 404 });
+        if (url.pathname === ASSISTANT_AVATAR_STATUS_PATH) {
+            const present = await Promise.all(record.files.map(async (file) => {
+                try {
+                    const info = await stat(join(this.directory, id, file.key));
+                    return info.isFile() && info.size === file.bytes;
+                }
+                catch {
+                    return false;
+                }
+            }));
+            return Response.json({ version: 1, generation: this.generation, pack: id, total: record.files.length,
+                cached: present.filter(Boolean).length, pending: 0, downloads: 0 }, { headers: { 'Cache-Control': 'no-store' } });
+        }
+        const file = record.files.find((entry) => entry.key === url.searchParams.get('file'));
+        if (file === undefined)
+            return new Response(null, { status: 404 });
+        try {
+            const bytes = await readFile(join(this.directory, id, file.key));
+            if (bytes.byteLength !== file.bytes)
+                throw new Error('avatar_local_resource_changed');
+            return new Response(bytes, { headers: { 'Content-Type': file.contentType, 'Cache-Control': 'private, max-age=31536000, immutable',
+                    'X-Content-Type-Options': 'nosniff', 'X-CodingNS-Avatar-Cache': 'disk' } });
+        }
+        catch {
+            return Response.json({ error: 'avatar_local_resource_unavailable' }, { status: 503, headers: { 'Cache-Control': 'no-store' } });
+        }
+    };
+    async record(id) {
+        if (!validPackId(id))
+            return undefined;
+        const cached = this.records.get(id);
+        if (cached !== undefined)
+            return cached;
+        try {
+            const bytes = await readFile(join(this.directory, id, 'record.json'));
+            if (bytes.byteLength > 256 * 1024)
+                return undefined;
+            const record = JSON.parse(bytes.toString('utf8'));
+            if (record.version !== 1 || record.id !== id || record.model?.package?.installationId !== id || !Array.isArray(record.files)
+                || record.files.length === 0 || record.files.length > 256 || record.files.some((file) => !/^[a-f0-9]{64}\.[a-z0-9.]+$/u.test(file.key)
+                || !Number.isSafeInteger(file.bytes) || file.bytes < 1 || file.bytes > 32 * 1024 * 1024
+                || !['application/json', 'application/octet-stream', 'image/png', 'image/webp', 'image/jpeg', 'image/gif', 'audio/wav', 'audio/mpeg', 'audio/ogg'].includes(file.contentType)))
+                return undefined;
+            validateAssistantAvatarModel(record.model);
+            this.records.set(id, record);
+            return record;
+        }
+        catch (error) {
+            if (missing(error) || error instanceof SyntaxError || error instanceof TypeError)
+                return undefined;
+            throw error;
+        }
+    }
+    mutate(action) {
+        const task = this.writes.then(action);
+        this.writes = task.catch(() => undefined);
+        return task;
+    }
+}
+function validPackId(value) { return /^[a-f0-9]{64}$/u.test(value); }
+function missing(error) { return error?.code === 'ENOENT'; }
+function summary(record, created) {
+    return { id: record.id, model: copyAssistantAvatarModel(record.model), created, files: record.files.length, bytes: record.files.reduce((total, file) => total + file.bytes, 0) };
+}
+//# sourceMappingURL=packages.js.map

package/data/build/dist/host/avatar/packages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packages.js","sourceRoot":"","sources":["../../../../../src/host/avatar/packages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACxF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,iCAAiC,EAAE,MAAM,2CAA2C,CAAA;AAE7F,OAAO,EAAE,wBAAwB,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAA;AAEzG,OAAO,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,+CAA+C,CAAA;AAEzH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,EAAE,6BAA6B,EAAE,wCAAwC,EAAE,MAAM,cAAc,CAAA;AAEtG,OAAO,EAAE,+BAA+B,EAAE,0CAA0C,EAAE,MAAM,gBAAgB,CAAA;AAE5G,OAAO,EAAE,2BAA2B,EAAE,MAAM,+CAA+C,CAAA;AAQ3F,iDAAiD;AACjD,MAAM,UAAU,+BAA+B;IAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,cAAc,CAAC,EAAE,2BAA2B,CAAC,CAAA;AACpI,CAAC;AAED,4CAA4C;AAC5C,MAAM,OAAO,uBAAuB;IAOb;IACF;IAPF,UAAU,GAAG,UAAU,EAAE,CAAA;IACzB,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAA;IACnD,MAAM,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAA;IAC3C,OAAO,CAAqD;IAC5D,OAAO,CAA2D;IAClE,SAAS,CAA6D;IAC/E,YAAqB,YAAY,+BAA+B,EAAE,EAC/C,SAAS,IAAI,qBAAqB,EAAE,EACrD,UAA6C,iCAAiC,EAC9E,UAAmD,wCAAwC,EAC3F,YAAuD,0CAA0C;QAJ9E,cAAS,GAAT,SAAS,CAAoC;QAC/C,WAAM,GAAN,MAAM,CAA8B;QAIrD,IAAI,CAAC,OAAO,GAAG,IAAI,2BAA2B,CAAC,OAAO,CAAC,CAAA;QACvD,IAAI,CAAC,OAAO,GAAG,IAAI,2BAA2B,CAAC,OAAO,CAAC,CAAA;QACvD,IAAI,CAAC,SAAS,GAAG,IAAI,2BAA2B,CAAC,SAAS,CAAC,CAAA;IAC7D,CAAC;IAED,QAAQ,CAAC,MAAc,EAAE,MAAoB,IAAI,OAAO,6BAA6B,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA,CAAC,CAAC;IAChJ,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,SAAS,GAAG,MAAM,EAAE,MAAoB;QACpE,MAAM,EAAE,cAAc,EAAE,CAAA;QACxB,IAAI,KAA2B,CAAA;QAC/B,IAAI,2BAA2B,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/D,MAAM,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;YACzE,KAAK,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,kBAAkB,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;gBACnH,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,CAAA;QAC/G,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;YACvD,OAAO,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,CAAC,CAAA;QAC9E,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACzC,CAAC;IACD,iDAAiD;IACjD,eAAe,CAAC,KAAc,EAAE,WAAmB,EAAE,SAAS,GAAG,MAAM,EAAE,MAAoB;QAC3F,MAAM,EAAE,cAAc,EAAE,CAAA;QACxB,MAAM,OAAO,GAAG,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QACnI,IAAI,OAAO,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,mBAAmB,CAAC,CAAA;QAC9F,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC,CAAA;QACpD,MAAM,KAAK,GAAG,wBAAwB,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,WAAW,EAAE,EAAE,CAAC,CAAA;QACzH,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACzC,CAAC;IACO,KAAK,CAAC,YAAY,CAAC,KAA2B,EAAE,MAAoB;QAC1E,4BAA4B,CAAC,KAAK,CAAC,CAAA;QACnC,MAAM,SAAS,GAAG,MAAM,+BAA+B,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAA;QACjH,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;IACvC,CAAC;IACD,2CAA2C;IAC3C,KAAK,CAAC,QAAQ,CAAC,MAA+B,EAAE,EAAU,EAAE,MAAoB;QAC9E,MAAM,EAAE,cAAc,EAAE,CAAA;QACxB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QACtC,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM,IAAI,SAAS,CAAC,iBAAiB,CAAC,CAAA;QAChE,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YAClE,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;YAClE,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,SAAS,CAAC,WAAW,CAAC,CAAA;YACrE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,CAAA;QAChE,CAAC,CAAC,CAAC,CAAA;QACH,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC,CAAA;IACpE,CAAC;IACO,MAAM,CAAC,SAAsE,EAAE,MAAoB;QACzG,sCAAsC;QACtC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE;YAC5B,MAAM,EAAE,cAAc,EAAE,CAAA;YACxB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;YAChD,IAAI,QAAQ,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;YAC3D,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YAChD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,UAAU,EAAE,EAAE,CAAC,CAAA;YAChE,MAAM,KAAK,CAAC,OAAO,CAAC,CAAA;YACpB,IAAI,CAAC;gBACH,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;oBAC3C,MAAM,EAAE,cAAc,EAAE,CAAA;oBACxB,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;gBAC9E,CAAC;gBACD,MAAM,MAAM,GAAkB,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK;oBAClF,KAAK,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAA;gBACpH,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;gBACrF,MAAM,EAAE,cAAc,EAAE,CAAA;gBACxB,MAAM,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;gBACtD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;gBACnC,OAAO,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;YAC9B,CAAC;oBAAS,CAAC;gBAAC,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;YAAC,CAAC;QACnE,CAAC,CAAC,CAAA;IACJ,CAAC;IACD,KAAK,CAAC,IAAI;QACR,IAAI,KAAe,CAAA;QACnB,IAAI,CAAC;YAAC,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAAC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAAC,IAAI,OAAO,CAAC,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAAC,MAAM,KAAK,CAAA;QAAC,CAAC;QAC1G,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC7F,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;IAC/F,CAAC;IACD,MAAM,CAAC,EAAU;QACf,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,UAAU,CAAC,CAAA;QACrD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE;YAC5B,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;YACpE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QACzB,CAAC,CAAC,CAAA;IACJ,CAAC;IACQ,MAAM,GAAG,KAAK,EAAE,OAAgB,EAAqB,EAAE;QAC9D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAChC,IAAI,CAAC,CAAC,2BAA2B,EAAE,4BAA4B,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;QACnI,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK;YAAE,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAA;QACnG,MAAM,EAAE,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;QAC7C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QACpC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;QACpE,IAAI,GAAG,CAAC,QAAQ,KAAK,4BAA4B,EAAE,CAAC;YAClD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;gBAChE,IAAI,CAAC;oBAAC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;oBAAC,OAAO,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,CAAA;gBAAC,CAAC;gBAAC,MAAM,CAAC;oBAAC,OAAO,KAAK,CAAA;gBAAC,CAAC;YAC9I,CAAC,CAAC,CAAC,CAAA;YACH,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;gBAClG,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,eAAe,EAAE,UAAU,EAAE,EAAE,CAAC,CAAA;QACrH,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;QACrF,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;QAClE,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;YAChE,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;YACrF,OAAO,IAAI,QAAQ,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,WAAW,EAAE,eAAe,EAAE,sCAAsC;oBAC/H,wBAAwB,EAAE,SAAS,EAAE,yBAAyB,EAAE,MAAM,EAAE,EAAE,CAAC,CAAA;QAC/E,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,mCAAmC,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,eAAe,EAAE,UAAU,EAAE,EAAE,CAAC,CAAA;QAAC,CAAC;IAC7I,CAAC,CAAA;IACO,KAAK,CAAC,MAAM,CAAC,EAAU;QAC7B,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YAAE,OAAO,SAAS,CAAA;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACnC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAA;QACvC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,aAAa,CAAC,CAAC,CAAA;YACrE,IAAI,KAAK,CAAC,UAAU,GAAG,GAAG,GAAG,IAAI;gBAAE,OAAO,SAAS,CAAA;YACnD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAkB,CAAA;YAClE,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,IAAI,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;mBACvH,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;mBACjI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI;mBACpF,CAAC,CAAC,kBAAkB,EAAE,0BAA0B,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBAAE,OAAO,SAAS,CAAA;YACpM,4BAA4B,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAC1C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;YAC5B,OAAO,MAAM,CAAA;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAAC,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,WAAW,IAAI,KAAK,YAAY,SAAS;gBAAE,OAAO,SAAS,CAAC;YAAC,MAAM,KAAK,CAAA;QAAC,CAAC;IACrI,CAAC;IACO,MAAM,CAAI,MAAwB;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACrC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QACzC,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AACD,SAAS,WAAW,CAAC,KAAa,IAAa,OAAO,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA,CAAC,CAAC;AACrF,SAAS,OAAO,CAAC,KAAc,IAAa,OAAQ,KAA2B,EAAE,IAAI,KAAK,QAAQ,CAAA,CAAC,CAAC;AACpG,SAAS,OAAO,CAAC,MAAqB,EAAE,OAAgB;IACtD,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,wBAAwB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAA;AAClL,CAAC"}

package/data/build/dist/host/avatar/registry.d.ts

@@ -0,0 +1,12 @@
+import type { CodingNsHostServices } from '../features/types.js';
+import type { AssistantAvatarAdapter } from '../../shared/assistant-avatar-adapters.js';
+import type { AssistantAvatarSourceAdapter } from './sources.js';
+import type { AssistantAvatarMaterialAdapter } from './materials.js';
+import { AssistantAvatarPackages } from './packages.js';
+/** Host 启停与扩展消费同一仓库；运行期注册不改源码目录或已安装记录。 */
+export declare function getAssistantAvatarPackages(services: CodingNsHostServices): AssistantAvatarPackages;
+/** 调用方把注销句柄加入 context.resources；格式注销不删除已经安装的素材。 */
+export declare function registerAssistantAvatarFormatAdapter(services: CodingNsHostServices, adapter: AssistantAvatarAdapter): () => void;
+export declare function registerAssistantAvatarSourceAdapter(services: CodingNsHostServices, adapter: AssistantAvatarSourceAdapter): () => void;
+export declare function registerAssistantAvatarMaterialAdapter(services: CodingNsHostServices, adapter: AssistantAvatarMaterialAdapter): () => void;
+//# sourceMappingURL=registry.d.ts.map

package/data/build/dist/host/avatar/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../../src/host/avatar/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAA;AACvF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAA;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAGvD,0CAA0C;AAC1C,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,oBAAoB,GAAG,uBAAuB,CAIlG;AACD,mDAAmD;AACnD,wBAAgB,oCAAoC,CAAC,QAAQ,EAAE,oBAAoB,EAAE,OAAO,EAAE,sBAAsB,GAAG,MAAM,IAAI,CAEhI;AACD,wBAAgB,oCAAoC,CAAC,QAAQ,EAAE,oBAAoB,EAAE,OAAO,EAAE,4BAA4B,GAAG,MAAM,IAAI,CAEtI;AACD,wBAAgB,sCAAsC,CAAC,QAAQ,EAAE,oBAAoB,EAAE,OAAO,EAAE,8BAA8B,GAAG,MAAM,IAAI,CAE1I"}

package/data/build/dist/host/avatar/registry.js

@@ -0,0 +1,22 @@
+import { AssistantAvatarPackages } from './packages.js';
+const repositories = new WeakMap();
+/** Host 启停与扩展消费同一仓库；运行期注册不改源码目录或已安装记录。 */
+export function getAssistantAvatarPackages(services) {
+    let packages = repositories.get(services);
+    if (packages === undefined) {
+        packages = new AssistantAvatarPackages();
+        repositories.set(services, packages);
+    }
+    return packages;
+}
+/** 调用方把注销句柄加入 context.resources；格式注销不删除已经安装的素材。 */
+export function registerAssistantAvatarFormatAdapter(services, adapter) {
+    return getAssistantAvatarPackages(services).formats.register(adapter);
+}
+export function registerAssistantAvatarSourceAdapter(services, adapter) {
+    return getAssistantAvatarPackages(services).sources.register(adapter);
+}
+export function registerAssistantAvatarMaterialAdapter(services, adapter) {
+    return getAssistantAvatarPackages(services).materials.register(adapter);
+}
+//# sourceMappingURL=registry.js.map

package/data/build/dist/host/avatar/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../../src/host/avatar/registry.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAEvD,MAAM,YAAY,GAAG,IAAI,OAAO,EAAiD,CAAA;AACjF,0CAA0C;AAC1C,MAAM,UAAU,0BAA0B,CAAC,QAA8B;IACvE,IAAI,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACzC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAAC,QAAQ,GAAG,IAAI,uBAAuB,EAAE,CAAC;QAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAAC,CAAC;IAC9G,OAAO,QAAQ,CAAA;AACjB,CAAC;AACD,mDAAmD;AACnD,MAAM,UAAU,oCAAoC,CAAC,QAA8B,EAAE,OAA+B;IAClH,OAAO,0BAA0B,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;AACvE,CAAC;AACD,MAAM,UAAU,oCAAoC,CAAC,QAA8B,EAAE,OAAqC;IACxH,OAAO,0BAA0B,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;AACvE,CAAC;AACD,MAAM,UAAU,sCAAsC,CAAC,QAA8B,EAAE,OAAuC;IAC5H,OAAO,0BAA0B,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;AACzE,CAAC"}

package/data/build/dist/host/avatar/remote.d.ts

@@ -0,0 +1,18 @@
+/** 下载器只获取公开 HTTP(S) 数据；每次重定向重新校验，不携带宿主凭据。 */
+export declare class AssistantAvatarRemote {
+    private readonly fetchRemote;
+    private readonly resolveAddresses;
+    constructor(fetchRemote?: typeof fetch, resolveAddresses?: (host: string) => Promise<readonly {
+        address: string;
+    }[]>);
+    read(source: string, maxBytes: number, signal?: AbortSignal): Promise<{
+        url: string;
+        bytes: Uint8Array;
+    }>;
+    json(source: string, signal?: AbortSignal): Promise<{
+        url: string;
+        value: unknown;
+    }>;
+}
+export declare function remoteUrl(source: string): URL;
+//# sourceMappingURL=remote.d.ts.map

package/data/build/dist/host/avatar/remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../../../../src/host/avatar/remote.ts"],"names":[],"mappings":"AAGA,6CAA6C;AAC7C,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,WAAW;IACtC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBADN,WAAW,GAAE,OAAO,KAAmC,EACjE,gBAAgB,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAyC;IAEhI,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,CAAC;IA+CzG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;CAI3F;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAM7C"}