@songsid/agend 2.2.0 → 2.2.5

package/dist/web-appearance.js

@@ -0,0 +1,373 @@
+/**
+ * #1629 (first design §4, §6; r2 (a)–(c); r4-4): the agent's own theme tools — get_web_theme, set_web_theme,
+ * set_web_theme_asset, reset_web_theme, set_web_widget, remove_web_widget, set_web_ambient, clear_web_ambient (#2117) — and a person's reset, lock, widget removal and ambient. None takes a target: the caller is the
+ * instance its IPC connection or agent token belongs to, and only that instance's record is ever read or written.
+ *
+ * Every agent write: the fleet-wide switch (web.themes.agent_edit), then the person's lock, then the shared limiter's
+ * check, then validation and the write, then — only once it is on disk — the limiter's record. A refused, invalid or
+ * failed call costs nothing. A person's reset and lock are never limited.
+ */
+import { AppearanceLimiter, agentAppearanceEditAllowed } from "./web-appearance-policy.js";
+import { applyThemePatch, THEME_DEFAULTS } from "./web-theme.js";
+import { createHash, randomBytes } from "node:crypto";
+import { slotLimit, THEME_ASSET_SLOTS } from "./web-theme-store.js";
+import { ASSET_PART_BYTES, ASSET_UPLOAD_MAX_BYTES } from "./web-asset-parts.js";
+import { AMBIENT_KINDS, ambientKind, ambientProblems, checkAmbient } from "./web-ambient.js";
+import { AGENT_WIDGET_SLOTS, carryWidgetData, checkWidgetData, checkWidgetSpec, mergeWidgetData, WIDGET_SLOTS } from "./web-widget.js";
+/** An upload in parts with no new part for this long is dropped (monotonic clock). */
+export const ASSET_UPLOAD_IDLE_MS = 60_000;
+export class WebAppearance {
+    store;
+    webConfig;
+    changed;
+    clock;
+    limiter;
+    /** At most one upload in parts per instance (a new part 0 replaces it). */
+    uploads = new Map();
+    constructor(store, webConfig, changed = () => { }, limiter, clock = () => performance.now()) {
+        this.store = store;
+        this.webConfig = webConfig;
+        this.changed = changed;
+        this.clock = clock;
+        this.limiter = limiter ?? new AppearanceLimiter();
+    }
+    /** Why an agent may not write now, or null. */
+    refusal(instance, buckets) {
+        if (!agentAppearanceEditAllowed(this.webConfig()))
+            return { error: "theme_editing_off", message: "Agent theme and effect changes are turned off for this fleet (web.themes.agent_edit: false)." };
+        if (!this.store.readable())
+            return { error: "themes_unreadable", message: "The fleet's theme file cannot be read; nothing can be changed until it is fixed." };
+        if (this.store.get(instance).locked)
+            return { error: "locked", message: "Theme and effects are locked by a person." };
+        const limit = this.limiter.check(instance, buckets);
+        return limit.ok ? null : { ...limit, message: `Too many changes; try again in ${limit.retry_after_s} s.` };
+    }
+    /** The effect tools share this exact switch/lock/limiter policy; no parallel gate or bucket. */
+    authorizeEffect(instance, buckets) { return this.refusal(instance, buckets); }
+    /** get_web_theme: the caller's theme and everything an agent needs to write a good one. */
+    getTheme(instance) {
+        const r = this.store.get(instance);
+        return {
+            effects: r.placements.effects,
+            theme: r.theme, by: r.by, locked: r.locked, agent_edit: agentAppearanceEditAllowed(this.webConfig()),
+            defaults: THEME_DEFAULTS,
+            assets: r.assets.map(a => ({ id: a.id, slot: a.slot, bytes: a.bytes })),
+            widgets: Object.fromEntries(AGENT_WIDGET_SLOTS.flatMap(slot => { const w = r.placements.widgets[slot]; return w ? [[slot, { spec: w.spec, data: w.data, by: w.by }]] : []; })),
+            ambient: Object.fromEntries(AMBIENT_KINDS.flatMap(k => { const a = r.placements.ambient[k]; return a ? [[k, { spec: a.spec, by: a.by }]] : []; })),
+            limits: { ...this.limiter.remaining(instance), ...this.assetLimits() },
+        };
+    }
+    /** The upload limits in force now (r4.1 Q3 (b): the card's come from web.appearance), so an agent can size its files. */
+    assetLimits() {
+        const limits = this.store.limits();
+        const asset_slots = {};
+        for (const slot of THEME_ASSET_SLOTS) {
+            const l = slotLimit(slot, limits);
+            asset_slots[slot] = { max_width: l.maxWidth, max_height: l.maxHeight, max_bytes: l.maxBytes };
+        }
+        return { asset_slots, asset_quota: { ...limits.quota } };
+    }
+    /** set_web_theme { set?, clear? }: all or nothing. `{}` is a no-op (and counts as nothing). */
+    setTheme(instance, patch) {
+        const isNoop = !!patch && typeof patch === "object" && !Array.isArray(patch) && Object.keys(patch).length === 0;
+        if (isNoop)
+            return { theme: this.store.get(instance).theme, rev: this.store.rev() };
+        const refused = this.refusal(instance, ["change"]);
+        if (refused)
+            return refused;
+        const current = this.store.get(instance);
+        const next = applyThemePatch(current.theme, patch, { assets: new Set(current.assets.map(a => a.id)), slotOf: id => current.assets.find(a => a.id === id)?.slot });
+        if (!next.ok)
+            return { errors: next.errors };
+        const w = this.store.setTheme(instance, next.theme, "agent");
+        if (!w.ok)
+            return { error: w.error, ...(w.detail ? { detail: w.detail } : {}) };
+        this.limiter.record(instance, ["change"]);
+        this.changed();
+        return { theme: w.theme, rev: w.rev };
+    }
+    /**
+     * set_web_theme_asset { slot, data_b64, part? }: the bytes the daemon or the CLI read on the agent's side — whole, or
+     * in parts (web-asset-parts.ts). The switch and the lock are asked at the first part and again before the picture is
+     * stored; uploads are not counted (the user's decision) — the slot's size limits and the picture quota still apply.
+     */
+    setAsset(instance, args) {
+        if (typeof args.data_b64 !== "string" || !/^[A-Za-z0-9+/]*={0,2}$/.test(args.data_b64))
+            return { error: "data", message: "The picture's bytes are missing." };
+        if (args.part !== undefined)
+            return this.setAssetPart(instance, args.slot, args.data_b64, args.part);
+        const refused = this.refusal(instance, []);
+        if (refused)
+            return refused;
+        return this.storeAsset(instance, args.slot, Buffer.from(args.data_b64, "base64"));
+    }
+    storeAsset(instance, slot, bytes) {
+        const w = this.store.addAsset(instance, slot, bytes);
+        if (!w.ok)
+            return { error: w.error, ...(w.detail ? { detail: w.detail } : {}) };
+        return { id: w.id };
+    }
+    setAssetPart(instance, slot, data, raw) {
+        const fail = (error, message) => { this.uploads.delete(instance); return { error, message }; };
+        const p = raw;
+        if (!p || typeof p !== "object" || Array.isArray(p))
+            return fail("part", "part: { index, count, bytes, sha256, upload? }");
+        const { index, count, bytes, sha256 } = p;
+        if (!Number.isSafeInteger(index) || !Number.isSafeInteger(count) || !Number.isSafeInteger(bytes) || typeof sha256 !== "string" || !/^[0-9a-f]{64}$/.test(sha256))
+            return fail("part", "part: { index, count, bytes, sha256, upload? }");
+        const chunk = Buffer.from(data, "base64");
+        if (chunk.length < 1 || chunk.length > ASSET_PART_BYTES)
+            return fail("part", `each part is 1..${ASSET_PART_BYTES} bytes`);
+        const now = this.clock();
+        // Uploads left idle by any instance go, so at most one picture's parts per active upload stay in memory.
+        for (const [name, u] of this.uploads)
+            if (now - u.last > ASSET_UPLOAD_IDLE_MS && name !== instance)
+                this.uploads.delete(name);
+        if (index === 0) {
+            const refused = this.refusal(instance, []);
+            if (refused) {
+                this.uploads.delete(instance);
+                return refused;
+            }
+            if (!THEME_ASSET_SLOTS.includes(slot))
+                return fail("slot", THEME_ASSET_SLOTS.join(", "));
+            const max = Math.min(ASSET_UPLOAD_MAX_BYTES, slotLimit(slot, this.store.limits()).maxBytes);
+            if (bytes < 1 || bytes > max)
+                return fail("asset_too_large", `at most ${max / 1024} KiB for ${String(slot)}`);
+            if (count !== Math.ceil(bytes / ASSET_PART_BYTES))
+                return fail("part", "count does not match bytes");
+            this.uploads.set(instance, { id: randomBytes(8).toString("hex"), slot: slot, count: count, next: 0, bytes: bytes, sha256, parts: [], received: 0, last: now });
+        }
+        const up = this.uploads.get(instance);
+        if (!up || (index !== 0 && p.upload !== up.id))
+            return fail("upload", "No such upload in progress: start again from part 0.");
+        if (now - up.last > ASSET_UPLOAD_IDLE_MS)
+            return fail("upload", "The upload waited too long between parts: start again from part 0.");
+        if (index !== up.next || count !== up.count || bytes !== up.bytes || sha256 !== up.sha256 || slot !== up.slot)
+            return fail("part", `expected part ${up.next} of the same upload`);
+        if (up.received + chunk.length > up.bytes)
+            return fail("part", "more bytes than declared");
+        up.parts.push(chunk);
+        up.received += chunk.length;
+        up.next += 1;
+        up.last = now;
+        if (up.next < up.count)
+            return { upload: up.id, received: up.received };
+        this.uploads.delete(instance);
+        const all = Buffer.concat(up.parts);
+        if (all.length !== up.bytes || createHash("sha256").update(all).digest("hex") !== up.sha256)
+            return { error: "part", message: "The parts do not add up to the declared picture." };
+        const refused = this.refusal(instance, []);
+        if (refused)
+            return refused;
+        return this.storeAsset(instance, up.slot, all);
+    }
+    /** reset_web_theme: the agent can always undo itself (a change for the limit). */
+    resetTheme(instance) {
+        const refused = this.refusal(instance, ["change"]);
+        if (refused)
+            return refused;
+        const w = this.store.reset(instance, "agent");
+        if (!w.ok)
+            return { error: w.error };
+        this.limiter.record(instance, ["change"]);
+        this.changed();
+        return { theme: { v: 1 } };
+    }
+    /** A person's reset (Details, the chat menu): theme, placements and pictures go; the lock stays. Not limited. */
+    humanReset(instance) {
+        this.uploads.delete(instance);
+        const w = this.store.reset(instance, "human");
+        if (!w.ok)
+            return { error: w.error, status: w.status };
+        this.changed();
+        return { ok: true, rev: w.rev };
+    }
+    /** A person's lock (r2 (a)). Not limited. */
+    humanLock(instance, locked) {
+        const w = this.store.setLocked(instance, locked);
+        if (!w.ok)
+            return { error: w.error, status: w.status };
+        this.changed();
+        return { ok: true, locked, rev: w.rev };
+    }
+    /**
+     * set_web_widget { slot, spec?, data? } (r4-4): place a widget in one of its own slots (`spec`, a change), or give
+     * the one there new values (`data` alone: merged, null removes a key — its own budget, 10 s apart). A widget a person
+     * placed takes the agent's values but is never replaced by it. `sidebar` is the person's: owner_slot.
+     */
+    setWidget(instance, args) {
+        const slot = this.agentSlot(args.slot);
+        if (typeof slot !== "string")
+            return slot;
+        if (args.spec === undefined && args.data === undefined)
+            return { error: "args", message: "Give spec (to place a widget) or data (new values for the one placed)." };
+        const current = this.store.get(instance).placements.widgets[slot];
+        if (args.spec === undefined) {
+            const refused = this.refusal(instance, ["data"]);
+            if (refused)
+                return refused;
+            if (!current)
+                return { error: "no_widget", message: `Nothing is placed in ${slot}: give a spec first.` };
+            const data = mergeWidgetData(current.data, args.data, current.spec);
+            if (!data.ok)
+                return { errors: data.errors };
+            const w = this.store.setWidgetData(instance, slot, data.value, "agent");
+            if (!w.ok)
+                return { error: w.error, ...(w.detail ? { detail: w.detail } : {}) };
+            this.limiter.record(instance, ["data"]);
+            this.changed();
+            return { slot, widget: { spec: w.widget.spec, data: w.widget.data, by: w.widget.by }, rev: w.rev };
+        }
+        const refused = this.refusal(instance, ["change"]);
+        if (refused)
+            return refused;
+        if (current?.by === "human")
+            return { error: "person_placed", message: `A person placed the widget in ${slot}: you can give it values (data), but not replace or remove it.` };
+        const spec = checkWidgetSpec(args.spec, slot);
+        if (!spec.ok)
+            return { errors: spec.errors };
+        const data = args.data === undefined ? { ok: true, value: carryWidgetData(current?.data ?? {}, spec.value) } : checkWidgetData(args.data, spec.value);
+        if (!data.ok)
+            return { errors: data.errors };
+        const w = this.store.setWidget(instance, slot, spec.value, data.value, "agent");
+        if (!w.ok)
+            return { error: w.error, ...(w.detail ? { detail: w.detail } : {}) };
+        this.limiter.record(instance, ["change"]);
+        this.changed();
+        return { slot, widget: { spec: w.widget.spec, data: w.widget.data, by: w.widget.by }, rev: w.rev };
+    }
+    /** remove_web_widget { slot? } (r4-4): its own widgets, from one slot or both; a person's placement stays (a change). */
+    removeWidget(instance, args) {
+        let slots = [...AGENT_WIDGET_SLOTS];
+        if (args.slot !== undefined) {
+            const slot = this.agentSlot(args.slot);
+            if (typeof slot !== "string")
+                return slot;
+            slots = [slot];
+        }
+        const refused = this.refusal(instance, ["change"]);
+        if (refused)
+            return refused;
+        const placed = this.store.get(instance).placements.widgets;
+        const kept = slots.filter(s => placed[s]?.by === "human");
+        if (args.slot !== undefined && kept.length)
+            return { error: "person_placed", message: `A person placed the widget in ${kept[0]}; only a person removes it.` };
+        const mine = slots.filter(s => placed[s]?.by === "agent");
+        if (!mine.length)
+            return { removed: [], ...(kept.length ? { kept } : {}) };
+        const w = this.store.removeWidgets(instance, mine, "agent");
+        if (!w.ok)
+            return { error: w.error, ...(w.detail ? { detail: w.detail } : {}) };
+        this.limiter.record(instance, ["change"]);
+        this.changed();
+        return { removed: w.removed, ...(kept.length ? { kept } : {}), rev: w.rev };
+    }
+    agentSlot(raw) {
+        if (raw === "sidebar")
+            return { error: "owner_slot", message: "The sidebar is a person's; place your widget in chat_header or details." };
+        if (!WIDGET_SLOTS.includes(raw))
+            return { error: "slot", message: AGENT_WIDGET_SLOTS.join(" or ") };
+        return raw;
+    }
+    /**
+     * set_web_ambient { preset, glyphs, … } (#2117): its own ambient, in the place its preset goes (one looping, one
+     * click), placed or replaced (a change). One a person set is never replaced by the agent.
+     */
+    setAmbient(instance, args) {
+        const refused = this.refusal(instance, ["change"]);
+        if (refused)
+            return refused;
+        const r = this.store.get(instance);
+        const spec = checkAmbient(args, { glyphAsset: id => r.assets.some(a => a.id === id && a.slot === "glyph") });
+        if (!spec.ok)
+            return { errors: spec.errors };
+        const kind = ambientKind(spec.value.preset);
+        if (r.placements.ambient[kind]?.by === "human")
+            return { error: "person_placed", message: `A person set the ${kind === "click" ? "click" : "looping"} ambient; only a person changes or clears it.` };
+        const w = this.store.setAmbient(instance, spec.value, "agent");
+        if (!w.ok)
+            return { error: w.error, ...(w.detail ? { detail: w.detail } : {}) };
+        this.limiter.record(instance, ["change"]);
+        this.changed();
+        return { kind: w.kind, ambient: { spec: w.ambient.spec, by: w.ambient.by }, rev: w.rev };
+    }
+    /** clear_web_ambient { which? } (#2117): its own ambients, one kind or both; a person's stays (a change). */
+    clearAmbient(instance, args) {
+        let kinds = [...AMBIENT_KINDS];
+        if (args.which !== undefined) {
+            if (!AMBIENT_KINDS.includes(args.which))
+                return { error: "which", message: AMBIENT_KINDS.join(" or ") };
+            kinds = [args.which];
+        }
+        const refused = this.refusal(instance, ["change"]);
+        if (refused)
+            return refused;
+        const placed = this.store.get(instance).placements.ambient;
+        const kept = kinds.filter(k => placed[k]?.by === "human");
+        if (args.which !== undefined && kept.length)
+            return { error: "person_placed", message: `A person set the ${kept[0]} ambient; only a person clears it.` };
+        const mine = kinds.filter(k => placed[k]?.by === "agent");
+        if (!mine.length)
+            return { removed: [], ...(kept.length ? { kept } : {}) };
+        const w = this.store.clearAmbient(instance, mine, "agent");
+        if (!w.ok)
+            return { error: w.error, ...(w.detail ? { detail: w.detail } : {}) };
+        this.limiter.record(instance, ["change"]);
+        this.changed();
+        return { removed: w.removed, ...(kept.length ? { kept } : {}), rev: w.rev };
+    }
+    /**
+     * A person's ambient for an agent (General's set_web_settings, an admin session): a spec sets the place its preset
+     * goes, null with `which` clears that one (both without). Not limited; the lock is not needed (it binds agents).
+     */
+    humanSetAmbient(instance, spec, which) {
+        if (spec === null) {
+            if (which !== undefined && !AMBIENT_KINDS.includes(which))
+                return { error: "which", status: 400, message: AMBIENT_KINDS.join(" or ") };
+            const w = this.store.clearAmbient(instance, which === undefined ? AMBIENT_KINDS : [which], "human");
+            if (!w.ok)
+                return { error: w.error, status: w.status };
+            if (w.removed.length)
+                this.changed();
+            return { ok: true, removed: w.removed, rev: w.rev };
+        }
+        const r = this.store.get(instance);
+        const checked = checkAmbient(spec, { glyphAsset: id => r.assets.some(a => a.id === id && a.slot === "glyph") });
+        if (!checked.ok)
+            return { error: "ambient", status: 400, message: ambientProblems(checked.errors) };
+        const w = this.store.setAmbient(instance, checked.value, "human");
+        if (!w.ok)
+            return { error: w.error, status: w.status };
+        this.changed();
+        return { ok: true, kind: w.kind, ambient: { spec: w.ambient.spec, by: w.ambient.by }, rev: w.rev };
+    }
+    /** A person's removal of an agent's widget (Details, an admin session). Not limited; the lock is not needed. */
+    humanRemoveWidget(instance, slot) {
+        if (!AGENT_WIDGET_SLOTS.includes(slot))
+            return { error: "slot", status: 400 };
+        const w = this.store.removeWidgets(instance, [slot], "human");
+        if (!w.ok)
+            return { error: w.error, status: w.status };
+        if (w.removed.length)
+            this.changed(); // nothing placed there: nothing written, nothing announced
+        return { ok: true, removed: w.removed, rev: w.rev };
+    }
+    /** An instance was removed: its counters and any upload in progress go. */
+    forget(instance) { this.uploads.delete(instance); this.limiter.forget(instance); }
+    /** The tool dispatcher both doors share (typed IPC from the daemon, the agent endpoint for agend-agent). */
+    handleTool(instance, tool, args) {
+        switch (tool) {
+            case "get_web_theme": return this.getTheme(instance);
+            case "set_web_theme": return this.setTheme(instance, args);
+            case "set_web_theme_asset": return this.setAsset(instance, args);
+            case "reset_web_theme": return this.resetTheme(instance);
+            case "set_web_widget": return this.setWidget(instance, args);
+            case "remove_web_widget": return this.removeWidget(instance, args);
+            case "set_web_ambient": return this.setAmbient(instance, args);
+            case "clear_web_ambient": return this.clearAmbient(instance, args);
+            default: return { error: "unknown_tool" };
+        }
+    }
+}
+//# sourceMappingURL=web-appearance.js.map

package/dist/web-appearance.js.map

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

package/dist/web-asset-parts.d.ts

@@ -0,0 +1,93 @@
+import { type AgentFileContext } from "./agent-file-read.js";
+/** Every picture slot an agent uploads for (the theme's two, the card's two and an ambient's glyphs, #2117). Here so agend-agent stays small. */
+export declare const THEME_ASSET_SLOTS: readonly ["background", "avatar", "portrait", "banner", "glyph"];
+export type ThemeAssetSlot = typeof THEME_ASSET_SLOTS[number];
+/** Raw bytes per part: base64 of this (480 KiB) plus the envelope fits both the IPC line and the endpoint body. */
+export declare const ASSET_PART_BYTES: number;
+/** The most an upload may declare: the largest card slot's ceiling (web-appearance-limits.ts). */
+export declare const ASSET_UPLOAD_MAX_BYTES: number;
+export interface AssetPart {
+    index: number;
+    count: number;
+    bytes: number;
+    sha256: string;
+    upload?: string;
+}
+/**
+ * Send `bytes` for `slot` through `send` (one tool call each), in parts when it does not fit one. Returns the last
+ * answer: { id } on success, or the first error any part got.
+ */
+export declare function sendAssetInParts(slot: unknown, bytes: Uint8Array, send: (args: Record<string, unknown>) => Promise<Record<string, unknown>>): Promise<Record<string, unknown>>;
+/** Every file a preview may carry: an SVG per mode, and the pictures it names (web-appearance-view.ts PREVIEW_FILE). */
+export declare const PREVIEW_FILE: RegExp;
+/** The most parts one preview file may come in (its largest picture, a 4 MiB portrait, is 12). */
+export declare const PREVIEW_MAX_PARTS = 64;
+/**
+ * #1629 r4 §1: preview_web_appearance's answer on the agent's side (the daemon, agend-agent): its files — an SVG per
+ * mode and the pictures they name — whole, or (larger than one message) fetched part by part with
+ * `send({ part: { preview, name, index } })`, each checked against the declared bytes and sha256. Returns the files,
+ * or the first error. Only the names above are taken.
+ */
+export declare function receivePreview(first: Record<string, unknown>, send: (args: Record<string, unknown>) => Promise<Record<string, unknown>>): Promise<{
+    files: Array<{
+        name: string;
+        data: Buffer;
+    }>;
+} | {
+    error: string;
+    message?: string;
+}>;
+/**
+ * Files the fleet built for the agent's side (a preview, an exported mod): sent whole, or — when larger than one
+ * message — fetched here part by part with `{ part: { <idKey>: id, name, index } }`, each file checked against its
+ * declared bytes and sha256. `name`: the only file names accepted (nothing else is ever written).
+ */
+export declare function receiveFiles(first: Record<string, unknown>, send: (args: Record<string, unknown>) => Promise<Record<string, unknown>>, opts: {
+    name: RegExp;
+    idKey: string;
+    what: string;
+    maxParts?: number;
+}): Promise<{
+    files: Array<{
+        name: string;
+        data: Buffer;
+    }>;
+} | {
+    error: string;
+    message?: string;
+}>;
+/** #1629 r4-5b: the one file name an exported mod is written under (in `.agend/mods/`). */
+export declare const MOD_FILE: RegExp;
+/** An exported mod is at most 8 MiB: 24 parts of 360 KiB. */
+export declare const MOD_MAX_PARTS = 24;
+/** The largest mod the agent's side reads to propose (the fleet checks it again): 8 MiB. */
+export declare const MOD_UPLOAD_MAX_BYTES: number;
+/** Write a received mod into `.agend/mods/` of the working directory (on the agent's side), and say where. */
+export declare function writeModFile(files: Array<{
+    name: string;
+    data: Buffer;
+}>, opts: AgentFileContext): Promise<{
+    path: string;
+    bytes: number;
+} | {
+    error: string;
+}>;
+/**
+ * Write a received preview into `.agend/appearance/` of the working directory (on the agent's side), and say where:
+ * the SVG per mode, and the pictures they name (Read those as images).
+ */
+export declare function writePreview(files: Array<{
+    name: string;
+    data: Buffer;
+}>, opts: AgentFileContext): Promise<{
+    files: Array<{
+        mode: string;
+        path: string;
+    }>;
+    pictures: Array<{
+        role: string;
+        path: string;
+    }>;
+} | {
+    error: string;
+}>;

package/dist/web-asset-parts.js

@@ -0,0 +1,133 @@
+/**
+ * #1629 r4 §1: a picture larger than one message carries (the fleet IPC's 1 MiB line, the agent endpoint's 512 KiB
+ * body) goes up in parts — a card portrait may be 1.5 MiB by default and up to 4 MiB by configuration. Both doors use
+ * this: the daemon (set_web_theme_asset, after reading the file on the agent's side) and `agend-agent theme asset`.
+ *
+ * Protocol (args of set_web_theme_asset, in order, each answered before the next is sent):
+ *   part 0:   { slot, data_b64, part: { index: 0, count, bytes, sha256 } }   → { upload: <id> }   (or { id } when count is 1)
+ *   part k:   { slot, data_b64, part: { index: k, count, bytes, sha256, upload } }
+ *   last:     → { id }  (the asset), or an error
+ * The fleet keeps one upload per instance and drops it after a minute without a part (web-appearance.ts).
+ */
+import { createHash } from "node:crypto";
+import { writeAgentFile } from "./agent-file-read.js";
+/** Every picture slot an agent uploads for (the theme's two, the card's two and an ambient's glyphs, #2117). Here so agend-agent stays small. */
+export const THEME_ASSET_SLOTS = ["background", "avatar", "portrait", "banner", "glyph"];
+/** Raw bytes per part: base64 of this (480 KiB) plus the envelope fits both the IPC line and the endpoint body. */
+export const ASSET_PART_BYTES = 360 * 1024;
+/** The most an upload may declare: the largest card slot's ceiling (web-appearance-limits.ts). */
+export const ASSET_UPLOAD_MAX_BYTES = 4 * 1024 * 1024;
+/**
+ * Send `bytes` for `slot` through `send` (one tool call each), in parts when it does not fit one. Returns the last
+ * answer: { id } on success, or the first error any part got.
+ */
+export async function sendAssetInParts(slot, bytes, send) {
+    if (bytes.length <= ASSET_PART_BYTES)
+        return send({ slot, data_b64: Buffer.from(bytes).toString("base64") });
+    const count = Math.ceil(bytes.length / ASSET_PART_BYTES);
+    const sha256 = createHash("sha256").update(bytes).digest("hex");
+    let upload;
+    let answer = {};
+    for (let index = 0; index < count; index++) {
+        const chunk = bytes.subarray(index * ASSET_PART_BYTES, (index + 1) * ASSET_PART_BYTES);
+        const part = { index, count, bytes: bytes.length, sha256, ...(upload ? { upload } : {}) };
+        answer = await send({ slot, data_b64: Buffer.from(chunk).toString("base64"), part });
+        if (typeof answer.error === "string" || Array.isArray(answer.errors))
+            return answer;
+        if (index === 0) {
+            if (typeof answer.upload !== "string")
+                return { error: "upload", message: "The fleet did not start the upload." };
+            upload = answer.upload;
+        }
+    }
+    return answer;
+}
+/** Every file a preview may carry: an SVG per mode, and the pictures it names (web-appearance-view.ts PREVIEW_FILE). */
+export const PREVIEW_FILE = /^(?:(?:light|dark)\.svg|(?:avatar|portrait|banner|background)\.(?:png|jpg|webp|gif)|glyph[1-4]\.(?:png|webp|gif))$/;
+/** The most parts one preview file may come in (its largest picture, a 4 MiB portrait, is 12). */
+export const PREVIEW_MAX_PARTS = 64;
+/**
+ * #1629 r4 §1: preview_web_appearance's answer on the agent's side (the daemon, agend-agent): its files — an SVG per
+ * mode and the pictures they name — whole, or (larger than one message) fetched part by part with
+ * `send({ part: { preview, name, index } })`, each checked against the declared bytes and sha256. Returns the files,
+ * or the first error. Only the names above are taken.
+ */
+export async function receivePreview(first, send) {
+    return receiveFiles(first, send, { name: PREVIEW_FILE, idKey: "preview", what: "preview" });
+}
+/**
+ * Files the fleet built for the agent's side (a preview, an exported mod): sent whole, or — when larger than one
+ * message — fetched here part by part with `{ part: { <idKey>: id, name, index } }`, each file checked against its
+ * declared bytes and sha256. `name`: the only file names accepted (nothing else is ever written).
+ */
+export async function receiveFiles(first, send, opts) {
+    const { what } = opts;
+    const maxParts = opts.maxParts ?? PREVIEW_MAX_PARTS;
+    if (typeof first.error === "string")
+        return first;
+    const files = Array.isArray(first.files) ? first.files : [];
+    if (!files.length || !files.every(f => typeof f.name === "string" && opts.name.test(f.name)) || new Set(files.map(f => f.name)).size !== files.length) {
+        return { error: what, message: `The fleet sent no ${what}.` };
+    }
+    const id = first[opts.idKey];
+    if (typeof id !== "string") {
+        if (!files.every(f => typeof f.data_b64 === "string"))
+            return { error: what, message: `The fleet sent no ${what}.` };
+        return { files: files.map(f => ({ name: f.name, data: Buffer.from(f.data_b64, "base64") })) };
+    }
+    const out = [];
+    for (const f of files) {
+        const bytes = f.bytes, count = f.parts;
+        if (!Number.isSafeInteger(bytes) || !Number.isSafeInteger(count) || count < 1 || count > maxParts || typeof f.sha256 !== "string")
+            return { error: what, message: `The fleet sent an unreadable ${what}.` };
+        const chunks = [];
+        for (let index = 0; index < count; index++) {
+            const a = await send({ part: { [opts.idKey]: id, name: f.name, index } });
+            if (typeof a.error === "string")
+                return a;
+            if (typeof a.data_b64 !== "string")
+                return { error: what, message: `A part of the ${what} is missing.` };
+            chunks.push(Buffer.from(a.data_b64, "base64"));
+        }
+        const data = Buffer.concat(chunks);
+        if (data.length !== bytes || createHash("sha256").update(data).digest("hex") !== f.sha256)
+            return { error: what, message: `The ${what}'s parts do not add up.` };
+        out.push({ name: f.name, data });
+    }
+    return { files: out };
+}
+/** #1629 r4-5b: the one file name an exported mod is written under (in `.agend/mods/`). */
+export const MOD_FILE = /^[a-z0-9][a-z0-9-]{0,63}-(0|[1-9]\d{0,5})\.(0|[1-9]\d{0,5})\.(0|[1-9]\d{0,5})\.agendmod\.json$/;
+/** An exported mod is at most 8 MiB: 24 parts of 360 KiB. */
+export const MOD_MAX_PARTS = 24;
+/** The largest mod the agent's side reads to propose (the fleet checks it again): 8 MiB. */
+export const MOD_UPLOAD_MAX_BYTES = 8 * 1024 * 1024;
+/** Write a received mod into `.agend/mods/` of the working directory (on the agent's side), and say where. */
+export async function writeModFile(files, opts) {
+    const f = files.length === 1 ? files[0] : null;
+    if (!f || !MOD_FILE.test(f.name))
+        return { error: ".agend/mods — not one mod file" };
+    const w = await writeAgentFile(".agend/mods", f.name, f.data, opts);
+    return w.ok ? { path: w.path, bytes: f.data.length } : { error: `.agend/mods/${f.name} — ${w.reason}` };
+}
+/**
+ * Write a received preview into `.agend/appearance/` of the working directory (on the agent's side), and say where:
+ * the SVG per mode, and the pictures they name (Read those as images).
+ */
+export async function writePreview(files, opts) {
+    const out = { files: [], pictures: [] };
+    for (const f of files) {
+        if (!PREVIEW_FILE.test(f.name))
+            return { error: `.agend/appearance/${f.name.slice(0, 40)} — not a preview file` };
+        const w = await writeAgentFile(".agend/appearance", f.name, f.data, opts);
+        if (!w.ok)
+            return { error: `.agend/appearance/${f.name} — ${w.reason}` };
+        const [base] = f.name.split(".");
+        if (f.name.endsWith(".svg"))
+            out.files.push({ mode: base, path: w.path });
+        else
+            out.pictures.push({ role: base, path: w.path });
+    }
+    return out;
+}
+//# sourceMappingURL=web-asset-parts.js.map