@songsid/agend 2.2.0 → 2.3.0-beta.2

package/dist/web-identity-palette.d.ts

@@ -0,0 +1,113 @@
+/**
+ * #1958: the identity colour's palettes and placements — no imports, so the theme's schema (web-theme.ts) and the
+ * colour's resolution (web-identity-color.ts) both read them without a cycle.
+ *
+ * - The presets a person (or an agent) picks from: 12 clear colours.
+ * - The automatic colours (the user's decision 4): a handful of soft, low-saturation colours like the default avatar
+ *   colours of Telegram and Discord, chosen by a stable hash of the name. Two instances may share one.
+ * Every value reads at 4.5:1 or better on the page's and the sidebar's background, in its mode (a test pins it).
+ */
+/** The presets: each one's value on the light and on the dark page. */
+export declare const IDENTITY_PALETTE: readonly [{
+    readonly id: "red";
+    readonly light: "#cf222e";
+    readonly dark: "#ff7b72";
+}, {
+    readonly id: "orange";
+    readonly light: "#bc4c00";
+    readonly dark: "#ffa657";
+}, {
+    readonly id: "amber";
+    readonly light: "#8a5d00";
+    readonly dark: "#e3b341";
+}, {
+    readonly id: "lime";
+    readonly light: "#4d7c0f";
+    readonly dark: "#a3e635";
+}, {
+    readonly id: "green";
+    readonly light: "#1a7f37";
+    readonly dark: "#56d364";
+}, {
+    readonly id: "teal";
+    readonly light: "#0f766e";
+    readonly dark: "#2dd4bf";
+}, {
+    readonly id: "cyan";
+    readonly light: "#0e7490";
+    readonly dark: "#22d3ee";
+}, {
+    readonly id: "blue";
+    readonly light: "#0a62c2";
+    readonly dark: "#7ab7ff";
+}, {
+    readonly id: "indigo";
+    readonly light: "#4f46e5";
+    readonly dark: "#a5b4fc";
+}, {
+    readonly id: "violet";
+    readonly light: "#8250df";
+    readonly dark: "#d2a8ff";
+}, {
+    readonly id: "pink";
+    readonly light: "#bf3989";
+    readonly dark: "#f778ba";
+}, {
+    readonly id: "slate";
+    readonly light: "#57606a";
+    readonly dark: "#b1bac4";
+}];
+/** The automatic colours: soft, and few on purpose (duplicates are fine). */
+export declare const AUTO_PALETTE: readonly [{
+    readonly id: "sand";
+    readonly light: "#8a6d3b";
+    readonly dark: "#d4b98a";
+}, {
+    readonly id: "clay";
+    readonly light: "#9c5a4a";
+    readonly dark: "#d9a294";
+}, {
+    readonly id: "rose";
+    readonly light: "#9b4f6a";
+    readonly dark: "#d99ab0";
+}, {
+    readonly id: "plum";
+    readonly light: "#7a5a8c";
+    readonly dark: "#c3a6d6";
+}, {
+    readonly id: "dusk";
+    readonly light: "#5a628f";
+    readonly dark: "#a9b0db";
+}, {
+    readonly id: "sea";
+    readonly light: "#3f7286";
+    readonly dark: "#92c2d4";
+}, {
+    readonly id: "moss";
+    readonly light: "#5b7340";
+    readonly dark: "#a9c48d";
+}, {
+    readonly id: "slate";
+    readonly light: "#5f6b78";
+    readonly dark: "#aeb8c4";
+}];
+export type PresetId = (typeof IDENTITY_PALETTE)[number]["id"];
+export type AutoId = (typeof AUTO_PALETTE)[number]["id"];
+/** What is stored and sent: a preset, an automatic colour (never stored), or a custom colour. */
+export type IdentityColor = `preset:${PresetId}` | `auto:${AutoId}` | `#${string}`;
+/**
+ * A colour as a person or an agent gives it — a preset's id ("blue", or "preset:blue") or a hex colour ("#abc",
+ * "#aabbcc", any case) — in the form it is kept; null for anything else (an automatic colour is never picked).
+ */
+export declare function canonicalIdentityColor(v: unknown): IdentityColor | null;
+/** The colour drawn for `c` on a page in `mode`: a preset's or an automatic colour's value for that mode, a custom one as it is. */
+export declare function identityColorValue(c: IdentityColor, mode: "light" | "dark"): string;
+/** The automatic colour: one of AUTO_PALETTE, chosen by the name (32-bit FNV-1a over its UTF-8 bytes), the same on every load. */
+export declare function autoIdentityColor(name: string): IdentityColor;
+/** Where the colour shows (the user's decision 2): the name, a bar at the row's left edge, the avatar's ring. */
+export declare const PLACEMENTS: readonly ["name", "bar", "ring"];
+export type Placement = (typeof PLACEMENTS)[number];
+/** The host's default where nobody chose (decision 1): ring and bar. */
+export declare const DEFAULT_PLACEMENTS: readonly Placement[];
+/** A set of places, in PLACEMENTS order, no repeats; [] is "nowhere". null for anything else. */
+export declare function canonicalPlacements(v: unknown): Placement[] | null;

package/dist/web-identity-palette.js

@@ -0,0 +1,84 @@
+/**
+ * #1958: the identity colour's palettes and placements — no imports, so the theme's schema (web-theme.ts) and the
+ * colour's resolution (web-identity-color.ts) both read them without a cycle.
+ *
+ * - The presets a person (or an agent) picks from: 12 clear colours.
+ * - The automatic colours (the user's decision 4): a handful of soft, low-saturation colours like the default avatar
+ *   colours of Telegram and Discord, chosen by a stable hash of the name. Two instances may share one.
+ * Every value reads at 4.5:1 or better on the page's and the sidebar's background, in its mode (a test pins it).
+ */
+/** The presets: each one's value on the light and on the dark page. */
+export const IDENTITY_PALETTE = [
+    { id: "red", light: "#cf222e", dark: "#ff7b72" },
+    { id: "orange", light: "#bc4c00", dark: "#ffa657" },
+    { id: "amber", light: "#8a5d00", dark: "#e3b341" },
+    { id: "lime", light: "#4d7c0f", dark: "#a3e635" },
+    { id: "green", light: "#1a7f37", dark: "#56d364" },
+    { id: "teal", light: "#0f766e", dark: "#2dd4bf" },
+    { id: "cyan", light: "#0e7490", dark: "#22d3ee" },
+    { id: "blue", light: "#0a62c2", dark: "#7ab7ff" },
+    { id: "indigo", light: "#4f46e5", dark: "#a5b4fc" },
+    { id: "violet", light: "#8250df", dark: "#d2a8ff" },
+    { id: "pink", light: "#bf3989", dark: "#f778ba" },
+    { id: "slate", light: "#57606a", dark: "#b1bac4" },
+];
+/** The automatic colours: soft, and few on purpose (duplicates are fine). */
+export const AUTO_PALETTE = [
+    { id: "sand", light: "#8a6d3b", dark: "#d4b98a" },
+    { id: "clay", light: "#9c5a4a", dark: "#d9a294" },
+    { id: "rose", light: "#9b4f6a", dark: "#d99ab0" },
+    { id: "plum", light: "#7a5a8c", dark: "#c3a6d6" },
+    { id: "dusk", light: "#5a628f", dark: "#a9b0db" },
+    { id: "sea", light: "#3f7286", dark: "#92c2d4" },
+    { id: "moss", light: "#5b7340", dark: "#a9c48d" },
+    { id: "slate", light: "#5f6b78", dark: "#aeb8c4" },
+];
+const PRESETS = new Map(IDENTITY_PALETTE.map(p => [p.id, p]));
+const AUTOS = new Map(AUTO_PALETTE.map(p => [p.id, p]));
+/** "#rgb" | "#rrggbb", any case → "#rrggbb" lowercase (web-theme.ts canonicalColor's rule); anything else → null. */
+function hexColor(v) {
+    const m = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/.exec(v);
+    if (!m)
+        return null;
+    const h = m[1].toLowerCase();
+    return h.length === 3 ? `#${h[0]}${h[0]}${h[1]}${h[1]}${h[2]}${h[2]}` : `#${h}`;
+}
+/**
+ * A colour as a person or an agent gives it — a preset's id ("blue", or "preset:blue") or a hex colour ("#abc",
+ * "#aabbcc", any case) — in the form it is kept; null for anything else (an automatic colour is never picked).
+ */
+export function canonicalIdentityColor(v) {
+    if (typeof v !== "string")
+        return null;
+    const id = v.startsWith("preset:") ? v.slice("preset:".length) : v;
+    if (PRESETS.has(id))
+        return `preset:${id}`;
+    return hexColor(v);
+}
+/** The colour drawn for `c` on a page in `mode`: a preset's or an automatic colour's value for that mode, a custom one as it is. */
+export function identityColorValue(c, mode) {
+    const p = c.startsWith("preset:") ? PRESETS.get(c.slice(7)) : c.startsWith("auto:") ? AUTOS.get(c.slice(5)) : undefined;
+    return p ? p[mode] : c;
+}
+/** The automatic colour: one of AUTO_PALETTE, chosen by the name (32-bit FNV-1a over its UTF-8 bytes), the same on every load. */
+export function autoIdentityColor(name) {
+    let h = 0x811c9dc5;
+    for (const unit of new TextEncoder().encode(name)) {
+        h ^= unit;
+        h = Math.imul(h, 0x01000193) >>> 0;
+    }
+    return `auto:${AUTO_PALETTE[h % AUTO_PALETTE.length].id}`;
+}
+/** Where the colour shows (the user's decision 2): the name, a bar at the row's left edge, the avatar's ring. */
+export const PLACEMENTS = ["name", "bar", "ring"];
+/** The host's default where nobody chose (decision 1): ring and bar. */
+export const DEFAULT_PLACEMENTS = ["bar", "ring"];
+/** A set of places, in PLACEMENTS order, no repeats; [] is "nowhere". null for anything else. */
+export function canonicalPlacements(v) {
+    if (!Array.isArray(v) || v.length > PLACEMENTS.length || !v.every(p => PLACEMENTS.includes(p)))
+        return null;
+    if (new Set(v).size !== v.length)
+        return null;
+    return PLACEMENTS.filter(p => v.includes(p));
+}
+//# sourceMappingURL=web-identity-palette.js.map

package/dist/web-identity-palette.js.map

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

package/dist/web-image-meta.d.ts

@@ -0,0 +1,25 @@
+/**
+ * #1629 r4 §1: what an uploaded picture or font is, how large it is, and the same file without its metadata — all
+ * from the bytes, never decoding an image. Used by owner-CSS assets (r4 §3) and the identity card (r4 §1).
+ *
+ * Metadata is removed by byte surgery:
+ * - JPEG: the APP1–APP15 and COM segments go (EXIF, GPS, XMP, ICC, comments) wherever they are — before the first
+ *   scan or between the scans of a progressive file; APP0 (JFIF) and the image stay. Every scan's entropy-coded data
+ *   is walked to its end, and the file must end with EOI (what follows it is dropped).
+ * - PNG: the tEXt, zTXt, iTXt, eXIf and tIME chunks go.
+ * - WebP: the EXIF and "XMP " chunks go, and VP8X's EXIF/XMP flags are cleared to match. A file shorter than its
+ *   RIFF header says is refused; bytes after the RIFF end are dropped.
+ * A file this module cannot walk to its end is refused, never passed through.
+ */
+export type MediaKind = "png" | "jpeg" | "webp" | "gif" | "woff2";
+export declare const MEDIA_MIME: Record<MediaKind, string>;
+export declare const MEDIA_EXT: Record<MediaKind, string>;
+/** The kind by magic bytes, or null. */
+export declare function sniffMedia(b: Uint8Array): MediaKind | null;
+/** Width and height from the headers, or null when the file does not say (or is not an image). */
+export declare function imageSize(b: Uint8Array, kind: MediaKind): {
+    width: number;
+    height: number;
+} | null;
+/** The file without its metadata (see the module comment), or null when it cannot be walked safely. */
+export declare function stripMetadata(b: Uint8Array, kind: MediaKind): Uint8Array | null;

package/dist/web-image-meta.js

@@ -0,0 +1,200 @@
+/**
+ * #1629 r4 §1: what an uploaded picture or font is, how large it is, and the same file without its metadata — all
+ * from the bytes, never decoding an image. Used by owner-CSS assets (r4 §3) and the identity card (r4 §1).
+ *
+ * Metadata is removed by byte surgery:
+ * - JPEG: the APP1–APP15 and COM segments go (EXIF, GPS, XMP, ICC, comments) wherever they are — before the first
+ *   scan or between the scans of a progressive file; APP0 (JFIF) and the image stay. Every scan's entropy-coded data
+ *   is walked to its end, and the file must end with EOI (what follows it is dropped).
+ * - PNG: the tEXt, zTXt, iTXt, eXIf and tIME chunks go.
+ * - WebP: the EXIF and "XMP " chunks go, and VP8X's EXIF/XMP flags are cleared to match. A file shorter than its
+ *   RIFF header says is refused; bytes after the RIFF end are dropped.
+ * A file this module cannot walk to its end is refused, never passed through.
+ */
+export const MEDIA_MIME = { png: "image/png", jpeg: "image/jpeg", webp: "image/webp", gif: "image/gif", woff2: "font/woff2" };
+export const MEDIA_EXT = { png: "png", jpeg: "jpg", webp: "webp", gif: "gif", woff2: "woff2" };
+/** The kind by magic bytes, or null. */
+export function sniffMedia(b) {
+    const at = (k, ...v) => v.every((x, j) => b[k + j] === x);
+    if (b.length >= 8 && at(0, 0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a))
+        return "png";
+    if (b.length >= 3 && at(0, 0xff, 0xd8, 0xff))
+        return "jpeg";
+    if (b.length >= 12 && at(0, 0x52, 0x49, 0x46, 0x46) && at(8, 0x57, 0x45, 0x42, 0x50))
+        return "webp";
+    if (b.length >= 6 && (at(0, 0x47, 0x49, 0x46, 0x38, 0x37, 0x61) || at(0, 0x47, 0x49, 0x46, 0x38, 0x39, 0x61)))
+        return "gif";
+    if (b.length >= 4 && at(0, 0x77, 0x4f, 0x46, 0x32))
+        return "woff2";
+    return null;
+}
+const u16be = (b, k) => (b[k] << 8) | b[k + 1];
+const u32be = (b, k) => ((b[k] << 24) >>> 0) + (b[k + 1] << 16) + (b[k + 2] << 8) + b[k + 3];
+const u16le = (b, k) => b[k] | (b[k + 1] << 8);
+const u24le = (b, k) => b[k] | (b[k + 1] << 8) | (b[k + 2] << 16);
+const u32le = (b, k) => (b[k] | (b[k + 1] << 8) | (b[k + 2] << 16) | (b[k + 3] << 24)) >>> 0;
+/** Width and height from the headers, or null when the file does not say (or is not an image). */
+export function imageSize(b, kind) {
+    if (kind === "png")
+        return b.length >= 24 && String.fromCharCode(...b.subarray(12, 16)) === "IHDR" ? { width: u32be(b, 16), height: u32be(b, 20) } : null;
+    if (kind === "gif")
+        return b.length >= 10 ? { width: u16le(b, 6), height: u16le(b, 8) } : null;
+    if (kind === "jpeg") {
+        let k = 2;
+        while (k + 4 <= b.length) {
+            if (b[k] !== 0xff)
+                return null;
+            const m = b[k + 1];
+            if (m === 0xff) {
+                k++;
+                continue;
+            }
+            if (m === 0xd8 || m === 0x01 || (m >= 0xd0 && m <= 0xd7)) {
+                k += 2;
+                continue;
+            }
+            const len = u16be(b, k + 2);
+            // SOF0–SOF15 except DHT (C4), JPG (C8) and DAC (CC).
+            if (m >= 0xc0 && m <= 0xcf && m !== 0xc4 && m !== 0xc8 && m !== 0xcc)
+                return k + 9 <= b.length ? { height: u16be(b, k + 5), width: u16be(b, k + 7) } : null;
+            if (m === 0xda || m === 0xd9)
+                return null;
+            k += 2 + len;
+        }
+        return null;
+    }
+    if (kind === "webp") {
+        if (b.length < 30)
+            return null;
+        const fourcc = String.fromCharCode(...b.subarray(12, 16));
+        if (fourcc === "VP8X")
+            return { width: u24le(b, 24) + 1, height: u24le(b, 27) + 1 };
+        if (fourcc === "VP8 " && b[23] === 0x9d && b[24] === 0x01 && b[25] === 0x2a)
+            return { width: u16le(b, 26) & 0x3fff, height: u16le(b, 28) & 0x3fff };
+        if (fourcc === "VP8L" && b[20] === 0x2f) {
+            const bits = u32le(b, 21);
+            return { width: (bits & 0x3fff) + 1, height: ((bits >>> 14) & 0x3fff) + 1 };
+        }
+        return null;
+    }
+    return null;
+}
+const PNG_DROP = new Set(["tEXt", "zTXt", "iTXt", "eXIf", "tIME"]);
+const WEBP_DROP = new Set(["EXIF", "XMP "]);
+/** The file without its metadata (see the module comment), or null when it cannot be walked safely. */
+export function stripMetadata(b, kind) {
+    if (kind === "png") {
+        const parts = [b.subarray(0, 8)];
+        let k = 8, sawEnd = false;
+        while (k + 12 <= b.length) {
+            const len = u32be(b, k), type = String.fromCharCode(...b.subarray(k + 4, k + 8)), end = k + 12 + len;
+            if (end > b.length)
+                return null;
+            if (!PNG_DROP.has(type))
+                parts.push(b.subarray(k, end));
+            k = end;
+            if (type === "IEND") {
+                sawEnd = true;
+                break;
+            }
+        }
+        return sawEnd ? concat(parts) : null;
+    }
+    if (kind === "jpeg") {
+        const parts = [b.subarray(0, 2)];
+        let k = 2;
+        for (;;) {
+            if (k + 2 > b.length || b[k] !== 0xff)
+                return null; // no EOI: truncated, or not a marker
+            const m = b[k + 1];
+            if (m === 0xff) {
+                k++;
+                continue;
+            } // fill byte before a marker
+            if (m === 0xd9) {
+                parts.push(b.subarray(k, k + 2));
+                return concat(parts);
+            }
+            if (m === 0x01 || (m >= 0xd0 && m <= 0xd7)) {
+                parts.push(b.subarray(k, k + 2));
+                k += 2;
+                continue;
+            } // standalone
+            if (k + 4 > b.length)
+                return null;
+            const len = u16be(b, k + 2), end = k + 2 + len;
+            if (len < 2 || end > b.length)
+                return null;
+            const drop = (m >= 0xe1 && m <= 0xef) || m === 0xfe;
+            if (!drop)
+                parts.push(b.subarray(k, end));
+            k = end;
+            if (m !== 0xda)
+                continue;
+            // A scan: its entropy-coded data runs to the next marker that is neither a stuffed 0xFF00 nor a restart marker.
+            let j = k;
+            for (;;) {
+                if (j + 1 >= b.length)
+                    return null; // the data never ends: truncated
+                if (b[j] === 0xff) {
+                    const n = b[j + 1];
+                    if (n === 0x00 || (n >= 0xd0 && n <= 0xd7)) {
+                        j += 2;
+                        continue;
+                    }
+                    if (n === 0xff) {
+                        j++;
+                        continue;
+                    }
+                    break;
+                }
+                j++;
+            }
+            parts.push(b.subarray(k, j));
+            k = j;
+        }
+    }
+    if (kind === "webp") {
+        const parts = [];
+        let k = 12;
+        const riffEnd = 8 + u32le(b, 4);
+        if (riffEnd > b.length || riffEnd < 12)
+            return null; // shorter than it says: truncated
+        while (k + 8 <= riffEnd) {
+            const type = String.fromCharCode(...b.subarray(k, k + 4)), len = u32le(b, k + 4), end = k + 8 + len + (len & 1);
+            if (k + 8 + len > riffEnd)
+                return null;
+            if (!WEBP_DROP.has(type)) {
+                const chunk = Uint8Array.from(b.subarray(k, Math.min(end, riffEnd)));
+                if (type === "VP8X" && chunk.length >= 9)
+                    chunk[8] = chunk[8] & ~0x0c; // its EXIF (0x08) and XMP (0x04) flags
+                parts.push(chunk);
+            }
+            k = end;
+        }
+        if (k < riffEnd)
+            return null;
+        const body = concat(parts);
+        const out = new Uint8Array(12 + body.length);
+        out.set(b.subarray(0, 4), 0);
+        const size = 4 + body.length;
+        out[4] = size & 0xff;
+        out[5] = (size >>> 8) & 0xff;
+        out[6] = (size >>> 16) & 0xff;
+        out[7] = (size >>> 24) & 0xff;
+        out.set(b.subarray(8, 12), 8);
+        out.set(body, 12);
+        return out;
+    }
+    return b; // gif, woff2: carried as they are
+}
+function concat(parts) {
+    const out = new Uint8Array(parts.reduce((n, p) => n + p.length, 0));
+    let k = 0;
+    for (const p of parts) {
+        out.set(p, k);
+        k += p.length;
+    }
+    return out;
+}
+//# sourceMappingURL=web-image-meta.js.map

package/dist/web-image-meta.js.map

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

package/dist/web-mod-agent.d.ts

@@ -0,0 +1,50 @@
+import { type AppearanceLimiter } from "./web-appearance-policy.js";
+import { type ModContext } from "./web-mod-bundle.js";
+import type { ModStore } from "./web-mod-store.js";
+import type { ThemeStore } from "./web-theme-store.js";
+/** An exported mod that fits one message is sent whole; a larger one is fetched in parts (as a preview is). */
+export declare const MOD_INLINE_BYTES: number;
+export declare const MOD_IDLE_MS = 60000;
+type Answer = Record<string, unknown>;
+export interface AgentModsDeps {
+    themes: ThemeStore;
+    mods: ModStore;
+    limiter: AppearanceLimiter;
+    webConfig: () => {
+        themes?: {
+            agent_edit?: boolean;
+        };
+    } | undefined | null;
+    context: () => ModContext;
+    /**
+     * r4-5c: an effect as this agent may read it (its own, or one a person shared) — never a person's private effect,
+     * even one placed on its instance: that is not the agent's to carry away. Null: not readable by it (or no library).
+     */
+    readOwnEffect?: (instance: string, id: string) => {
+        name: string;
+        files: ReadonlyMap<string, Uint8Array>;
+    } | null;
+    /** A muted status line in the agent's own web chat (#1672's notice lane). */
+    notice: (instance: string, text: string) => void;
+    changed: () => void;
+    clock?: () => number;
+}
+export declare class AgentMods {
+    private readonly deps;
+    private readonly built;
+    private readonly uploads;
+    constructor(deps: AgentModsDeps);
+    private now;
+    handle(instance: string, tool: string, args: Answer): Answer;
+    /** export_web_mod: the caller's own look, as a bundle file. */
+    private exportMod;
+    private exportPart;
+    /** Why the caller may not propose now, or null: the fleet switch, a person's lock, the upload limit. */
+    private refusal;
+    /** propose_web_mod: the bytes the daemon or agend-agent read on the agent's side — whole, or in parts. */
+    private propose;
+    private finish;
+    /** An instance was removed. */
+    forget(instance: string): void;
+}
+export {};