@songsid/agend 2.2.0 → 2.3.0-beta.2

package/dist/web-effect-service.js

@@ -0,0 +1,314 @@
+import { EFFECT_REGION, WEB_EFFECT_ID, chatCompatible, resolveEffectParams } from "./web-effect.js";
+import { effectRasterAssets } from "./web-effect-bundle.js";
+import { staticEffectPoster, staticEffectCursor } from "./web-effect-poster.js";
+import { decodeEffectFiles } from "./web-effect-upload.js";
+import { isOwnerEffectKey, OWNER_EFFECT_KEYS } from "./web-prefs.js";
+const fail = (error) => ({ error });
+const plain = (x) => !!x && typeof x === "object" && Object.getPrototypeOf(x) === Object.prototype;
+const fields = (x, allowed) => plain(x) && Object.keys(x).every(k => allowed.includes(k));
+/** Host routes provide the authenticated human key. Neither a body nor an agent tool supplies it. */
+export class WebEffectService {
+    deps;
+    reports = new Map();
+    previous = null;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    principal(person) { return { kind: "human", id: person }; }
+    validPerson(person) { return typeof person === "string" && person.length > 0 && person.length <= 256; }
+    readable(person, id) {
+        return this.validPerson(person) && typeof id === "string" && WEB_EFFECT_ID.test(id) ? this.deps.library.read(id, this.principal(person)) : { ok: false, error: "not_found" };
+    }
+    list(person) {
+        if (!this.validPerson(person))
+            return fail("not_found");
+        const result = this.deps.library.managementList(this.principal(person));
+        if (!result.ok)
+            return fail(result.error);
+        const profiles = this.profileSummaries(result.entries.map(e => e.id));
+        return { effects: result.entries.map(e => ({ ...e, profiles: profiles[e.id] })) };
+    }
+    profileSummaries(ids) {
+        if (!ids.length)
+            return {};
+        const r = this.deps.profiles.readSummaries();
+        return Object.fromEntries(ids.map(id => {
+            if (!r.ok)
+                return [id, fail(r.error)];
+            const summary = r.summaries[id];
+            return [id, { status: summary?.status ?? "unmeasured", records: summary?.records ?? [] }];
+        }));
+    }
+    profileSummary(id) {
+        const r = this.deps.profiles.read(id);
+        if (!r.ok)
+            return fail(r.error);
+        return { status: r.status, records: [r.records.filter(p => p.device === "standard").at(-1), r.records.filter(p => p.device === "constrained").at(-1)].filter(Boolean) };
+    }
+    profile(person, id) {
+        return this.readable(person, id).ok ? this.deps.profiles.read(id) : fail("not_found");
+    }
+    upload(person, bytes) {
+        if (!this.validPerson(person))
+            return fail("not_found");
+        const files = decodeEffectFiles(bytes);
+        if (!files)
+            return fail("invalid_effect");
+        const staged = this.deps.library.stage(files, this.principal(person));
+        if (!staged.ok)
+            return fail(staged.error);
+        const committed = this.deps.library.commit(staged.stageId);
+        if (!committed.ok) {
+            this.deps.library.abort(staged.stageId);
+            return fail(committed.error);
+        }
+        this.deps.changed();
+        return { id: committed.ids[0], warnings: staged.entries[0].warnings };
+    }
+    apply(person, args) {
+        if (!fields(args, ["instance", "id", "params"]) || typeof args.instance !== "string" || !this.deps.known(args.instance) || typeof args.id !== "string")
+            return fail("effect_args");
+        const r = this.readable(person, args.id);
+        if (!r.ok)
+            return fail("not_found");
+        if (!chatCompatible(r.entry.manifest))
+            return { ...EFFECT_REGION }; // #2017: the agent's rule, before any write
+        const params = resolveEffectParams(r.entry.manifest, args.params === undefined ? {} : args.params);
+        if (!params.ok)
+            return fail("effect_params");
+        if (!this.deps.themes.readable())
+            return fail("themes_unreadable");
+        const before = this.deps.themes.get(args.instance).placements.effects;
+        const target = { id: args.id, ...(Object.keys(params.overrides).length ? { params: params.overrides } : {}) };
+        const next = before.map(p => p.id === args.id ? target : p.id);
+        if (!before.some(p => p.id === args.id))
+            next.push(target);
+        const written = this.deps.themes.setPlacements(args.instance, { effects: next }, "human", what => {
+            const entry = what.id === args.id ? r : this.deps.library.readReferenced(what.id, `instance:${args.instance}`);
+            if (!entry.ok)
+                return entry.error;
+            return resolveEffectParams(entry.entry.manifest, what.id === args.id ? params.overrides : before.find(p => p.id === what.id)?.params ?? {}).ok ? null : "effect_params";
+        });
+        if (!written.ok)
+            return fail(written.error);
+        this.deps.changed();
+        return { id: args.id, rev: written.rev, params: params.overrides };
+    }
+    remove(person, args) {
+        if (!this.validPerson(person) || !fields(args, ["instance", "id"]) || typeof args.instance !== "string" || !this.deps.known(args.instance) || args.id !== undefined && (typeof args.id !== "string" || !WEB_EFFECT_ID.test(args.id)))
+            return fail("effect_args");
+        if (!this.deps.themes.readable())
+            return fail("themes_unreadable");
+        const before = this.deps.themes.get(args.instance).placements.effects, removed = before.filter(p => args.id === undefined || p.id === args.id).map(p => p.id);
+        if (!removed.length)
+            return { removed: [] };
+        const result = this.deps.themes.setPlacements(args.instance, { effects: before.filter(p => !removed.includes(p.id)).map(p => p.id) }, "human", what => this.deps.library.readReferenced(what.id, `instance:${args.instance}`).ok ? null : "not_found");
+        if (!result.ok)
+            return fail(result.error);
+        this.deps.library.collectUnreferenced(removed);
+        this.deps.changed();
+        return { removed, rev: result.rev };
+    }
+    share(person, args) {
+        if (!fields(args, ["id", "shared"]) || typeof args.id !== "string" || typeof args.shared !== "boolean" || !this.validPerson(person))
+            return fail("effect_args");
+        const r = this.deps.library.setShared(args.id, this.principal(person), args.shared);
+        if (!r.ok)
+            return fail(r.error);
+        this.deps.changed();
+        return { id: args.id, shared: args.shared };
+    }
+    delete(person, id) {
+        if (!this.validPerson(person))
+            return fail("not_found");
+        const r = this.deps.library.deleteClaim(id, this.principal(person));
+        if (!r.ok)
+            return fail(r.error);
+        this.deps.changed();
+        return { deleted: id };
+    }
+    /** A selection never acquires a claim or borrows chat retention. Null clears need no library read. */
+    validateOwnerSelection(person, key, id) {
+        const r = this.readable(person, id);
+        return r.ok && this.ownerCompatible(r.entry, key) ? null : "not_found";
+    }
+    ownerCompatible(entry, key) {
+        if (!isOwnerEffectKey(key))
+            return false;
+        if (key === "fx.cursor")
+            return !!entry.manifest.cursor && entry.files.has("cursor.png");
+        const region = key.slice(3);
+        return entry.manifest.regions.includes(region) && (region !== "box" || !!entry.manifest.box);
+    }
+    collectOwnerReplaced(ids) { this.deps.library.collectUnreferenced(ids); }
+    ownerSelections(person) {
+        if (!this.validPerson(person))
+            return fail("not_found");
+        const view = this.deps.prefs?.readForViewer(person);
+        if (!view || view.unreadable)
+            return fail("prefs_unreadable");
+        return { rev: view.rev, slots: Object.fromEntries(OWNER_EFFECT_KEYS.map(key => {
+                const id = view.values[key];
+                if (id === undefined)
+                    return [key, { status: "none", id: null }];
+                const r = this.readable(person, id);
+                return [key, r.ok && this.ownerCompatible(r.entry, key) ? { status: "available", id, manifest: r.entry.manifest } : { status: "unavailable", id }];
+            })) };
+    }
+    ownerSelected(person, id, slot) {
+        if (!this.validPerson(person) || typeof slot !== "string" || !isOwnerEffectKey(slot))
+            return { ok: false, error: "not_found" };
+        const view = this.deps.prefs?.readForViewer(person);
+        if (!view || view.unreadable || view.values[slot] !== id)
+            return { ok: false, error: "not_found" };
+        const r = this.readable(person, id);
+        return r.ok && this.ownerCompatible(r.entry, slot) ? r : { ok: false, error: "not_found" };
+    }
+    /** Personal runtime authorizations always recheck current own/shared ACL. Cursor selection grants no code read. */
+    ownerResource(person, id, slot) {
+        if (slot === "fx.cursor")
+            return fail("not_found");
+        const r = this.ownerSelected(person, id, slot);
+        if (!r.ok)
+            return fail("not_found");
+        const params = resolveEffectParams(r.entry.manifest);
+        if (!params.ok)
+            return fail("not_found");
+        return this.resourceAnswer(id, r.entry, params.values);
+    }
+    ownerImage(person, id, kind, slot) {
+        const r = this.ownerSelected(person, id, slot), bytes = r.ok ? r.entry.files.get(`${kind}.png`) : undefined;
+        // Runtime images are output copies; stripping animation must not rewrite the stored content id.
+        const image = bytes && (kind === "cursor" ? staticEffectCursor(bytes) : bytes);
+        return image ? { ok: true, bytes: image } : { ok: false, error: "not_found" };
+    }
+    resourceAnswer(id, entry, params) {
+        return { id, manifest: entry.manifest, params, wants: entry.manifest.wants, code: new TextDecoder("utf-8", { fatal: true }).decode(entry.files.get("worker.js")),
+            assets: effectRasterAssets(entry).map(({ name, mime, bytes }) => ({ name, mime, data_b64: Buffer.from(bytes).toString("base64") })) };
+    }
+    /** Host-only trial routes supply a fresh verified actor, never a JSON body actor. No placement/claim writes. */
+    trialStart(offer, instance, viewer) {
+        const t = this.deps.trials?.start(offer, instance, viewer);
+        if (!t?.ok)
+            return fail("not_found");
+        const r = this.deps.trials.read(t.trial, instance, viewer);
+        const params = r.ok ? resolveEffectParams(r.entry.manifest) : null;
+        if (!r.ok || !params?.ok) {
+            this.deps.trials.stop(t.trial, viewer);
+            return fail("not_found");
+        }
+        return { trial: t.trial, offer: t.offer, remainingMs: t.remainingMs, manifest: r.entry.manifest, params: params.values };
+    }
+    trialStop(trial, viewer) {
+        return this.deps.trials?.stop(trial, viewer).ok ? { ok: true } : fail("not_found");
+    }
+    trialResource(trial, instance, viewer) {
+        const r = this.deps.trials?.read(trial, instance, viewer);
+        if (!r?.ok)
+            return fail("not_found");
+        const params = resolveEffectParams(r.entry.manifest);
+        if (!params.ok)
+            return fail("not_found");
+        return this.resourceAnswer(r.id, r.entry, params.values);
+    }
+    trialPoster(trial, instance, viewer) {
+        const r = this.deps.trials?.read(trial, instance, viewer), source = r?.ok ? r.entry.files.get("poster.png") : undefined;
+        const bytes = source ? staticEffectPoster(source) : null;
+        return bytes ? { ok: true, bytes } : { ok: false };
+    }
+    trialProfile(trial, instance, viewer) {
+        const r = this.deps.trials?.read(trial, instance, viewer);
+        return r?.ok ? this.deps.profiles.read(r.id) : fail("not_found");
+    }
+    /** A runtime resource is not an export grant. An exact currently retained placement is independently required. */
+    retained(id, instance) {
+        if (!this.deps.known(instance) || !WEB_EFFECT_ID.test(id) || !this.deps.themes.readable())
+            return { ok: false, error: "not_found" };
+        const placement = this.deps.themes.get(instance).placements.effects.find(p => p.id === id);
+        if (!placement)
+            return { ok: false, error: "not_found" };
+        const r = this.deps.library.readReferenced(id, `instance:${instance}`);
+        if (!r.ok)
+            return r;
+        const params = resolveEffectParams(r.entry.manifest, placement.params ?? {});
+        if (!params.ok)
+            return { ok: false, error: "effect_params" };
+        return { ...r, placement, params: params.values };
+    }
+    /** Public/local visual projection: current chat placements only, no principal, code, params or claim grant. */
+    posterPlacements(instance) {
+        if (!this.deps.known(instance))
+            return fail("not_found");
+        if (!this.deps.themes.readable())
+            return fail("themes_unreadable");
+        return { rev: this.deps.themes.rev(), posters: this.deps.themes.get(instance).placements.effects.flatMap(p => {
+                const r = this.retained(p.id, instance), bytes = r.ok ? r.entry.files.get("poster.png") : undefined;
+                return r.ok && r.entry.manifest.regions.includes("chat") && bytes && staticEffectPoster(bytes)
+                    ? [{ id: p.id, title: r.entry.manifest.title }] : [];
+            }) };
+    }
+    placedPoster(id, instance) {
+        const r = this.retained(id, instance);
+        const source = r.ok && r.entry.manifest.regions.includes("chat") ? r.entry.files.get("poster.png") : undefined;
+        const bytes = source ? staticEffectPoster(source) : null;
+        return bytes ? { ok: true, bytes } : { ok: false, error: "not_found" };
+    }
+    resource(person, id, instance) {
+        if (!this.validPerson(person))
+            return fail("not_found");
+        const binding = instance === undefined ? null : this.retained(id, instance);
+        const r = binding ?? this.readable(person, id);
+        if (!r.ok)
+            return fail("not_found");
+        const defaults = resolveEffectParams(r.entry.manifest);
+        if (!defaults.ok)
+            return fail("not_found");
+        return this.resourceAnswer(id, r.entry, binding?.ok ? binding.params : defaults.values);
+    }
+    image(person, id, kind, instance) {
+        if (!this.validPerson(person))
+            return { ok: false, error: "not_found" };
+        const r = instance === undefined ? this.readable(person, id) : this.retained(id, instance);
+        const bytes = r.ok ? r.entry.files.get(`${kind}.png`) : undefined;
+        return bytes ? { ok: true, bytes } : { ok: false, error: "not_found" };
+    }
+    placements(person, instance) {
+        if (!this.validPerson(person) || !this.deps.known(instance))
+            return fail("not_found");
+        if (!this.deps.themes.readable())
+            return fail("themes_unreadable");
+        return { rev: this.deps.themes.rev(), effects: this.deps.themes.get(instance).placements.effects.flatMap(p => {
+                const r = this.retained(p.id, instance);
+                return r.ok ? [{ ...p, manifest: r.entry.manifest, params: r.params }] : [];
+            }) };
+    }
+    /** Diagnostic writes only: a validated report never changes safety, admission or a placement. */
+    report(person, id, input, instance) {
+        if (!this.validPerson(person) || !(instance === undefined ? this.readable(person, id) : this.retained(id, instance)).ok)
+            return fail("not_found");
+        let now;
+        try {
+            now = (this.deps.monotonic ?? (() => performance.now()))();
+        }
+        catch {
+            return fail("profile_clock");
+        }
+        if (!Number.isFinite(now) || now < 0 || this.previous !== null && now < this.previous)
+            return fail("profile_clock");
+        this.previous = now;
+        for (const [key, t] of this.reports)
+            if (now - t >= 60_000)
+                this.reports.delete(key);
+        const key = JSON.stringify([person, id]), last = this.reports.get(key);
+        if (last !== undefined && now - last < 10_000)
+            return fail("profile_rate_limited");
+        if (last === undefined && this.reports.size >= 1024)
+            return fail("profile_rate_limited");
+        const result = this.deps.profiles.record(id, input);
+        if (!result.ok)
+            return fail(result.error);
+        this.reports.set(key, now);
+        return { ok: true };
+    }
+}
+//# sourceMappingURL=web-effect-service.js.map

package/dist/web-effect-service.js.map

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

package/dist/web-effect-tools.d.ts

@@ -0,0 +1,47 @@
+import { WebEffectLibrary } from "./web-effect-library.js";
+import type { AppearanceBucket, AppearanceLimiter } from "./web-appearance-policy.js";
+type Answer = Record<string, unknown>;
+export interface EffectPlacementInput {
+    id: string;
+    params?: Record<string, unknown>;
+}
+export interface EffectToolDeps {
+    library: WebEffectLibrary;
+    limiter: AppearanceLimiter;
+    /** The SAME switch/lock/limiter helper used by theme writes, run synchronously. */
+    authorize(instance: string, buckets: readonly AppearanceBucket[]): Answer | null;
+    placed(instance: string): Array<{
+        id: string;
+        params?: Record<string, unknown>;
+    }>;
+    place(instance: string, effects: Array<string | EffectPlacementInput>): {
+        ok: true;
+        rev: number;
+    } | {
+        ok: false;
+        error: string;
+    };
+    changed(): void;
+    preview(instance: string, id: string, title: string): Promise<Answer>;
+    profiles(id: string): Answer;
+    profileSummary?(id: string): Answer;
+    profileSummaries?(ids: readonly string[]): Record<string, Answer>;
+    clock?: () => number;
+}
+export declare const WEB_EFFECT_TOOLS: ReadonlySet<string>;
+export declare class WebEffectTools {
+    private readonly deps;
+    private readonly uploads;
+    constructor(deps: EffectToolDeps);
+    private principal;
+    upload(instance: string, args: Answer): Answer;
+    list(instance: string): Answer;
+    apply(instance: string, args: Answer): Answer;
+    remove(instance: string, args: Answer): Answer;
+    delete(instance: string, args: Answer): Answer;
+    profile(instance: string, args: Answer): Answer;
+    preview(instance: string, args: Answer): Promise<Answer>;
+    handle(instance: string, tool: string, args: Answer): Answer | Promise<Answer>;
+    forget(instance: string): void;
+}
+export {};

package/dist/web-effect-tools.js

@@ -0,0 +1,129 @@
+/** #1629: caller-scoped effect operations. Host ingress supplies identity; no tool takes a target or holder. */
+import { EFFECT_REGION, chatCompatible, resolveEffectParams } from "./web-effect.js";
+import { EffectUploads } from "./web-effect-upload.js";
+export const WEB_EFFECT_TOOLS = new Set(["upload_web_effect", "list_web_effects", "preview_web_effect", "profile_web_effect", "apply_web_effect", "remove_web_effect", "delete_web_effect"]);
+const ID = /^[0-9a-f]{32}$/;
+export class WebEffectTools {
+    deps;
+    uploads;
+    constructor(deps) {
+        this.deps = deps;
+        this.uploads = new EffectUploads(deps.clock);
+    }
+    principal(instance) { return { kind: "agent", id: instance }; }
+    upload(instance, args) {
+        const refused = this.deps.authorize(instance, ["upload"]);
+        if (refused) {
+            this.uploads.forget(instance);
+            return refused;
+        }
+        return this.uploads.accept(instance, args, files => {
+            const last = this.deps.authorize(instance, ["upload"]);
+            if (last)
+                return last;
+            const stage = this.deps.library.stage(files, this.principal(instance));
+            if (!stage.ok)
+                return { error: stage.error };
+            const committed = this.deps.library.commit(stage.stageId);
+            if (!committed.ok) {
+                this.deps.library.abort(stage.stageId);
+                return { error: committed.error };
+            }
+            this.deps.limiter.record(instance, ["upload"]);
+            this.deps.changed();
+            return { id: committed.ids[0], warnings: stage.entries[0].warnings };
+        });
+    }
+    list(instance) {
+        const result = this.deps.library.list(this.principal(instance));
+        if (!result.ok)
+            return { error: result.error };
+        const profiles = this.deps.profileSummaries?.(result.entries.map(e => e.id));
+        return { effects: result.entries.map(e => ({ id: e.id, name: e.manifest.name, title: e.manifest.title, regions: e.manifest.regions, layer: e.manifest.layer, bytes: e.bytes, latest_profile: profiles ? profiles[e.id] : this.deps.profileSummary ? this.deps.profileSummary(e.id) : this.deps.profiles(e.id) })) };
+    }
+    apply(instance, args) {
+        const refused = this.deps.authorize(instance, ["change"]);
+        if (refused)
+            return refused;
+        if (Object.keys(args).some(k => k !== "id" && k !== "params") || typeof args.id !== "string" || !ID.test(args.id))
+            return { error: "effect_args" };
+        const entry = this.deps.library.read(args.id, this.principal(instance));
+        if (!entry.ok)
+            return { error: entry.error };
+        // #2017: a chat placement needs an effect that plays in chat — refused before anything is placed, written or counted.
+        if (!chatCompatible(entry.entry.manifest))
+            return { ...EFFECT_REGION };
+        const params = resolveEffectParams(entry.entry.manifest, args.params === undefined ? {} : args.params);
+        if (!params.ok)
+            return { error: "effect_params" };
+        const previous = this.deps.placed(instance);
+        const target = { id: args.id, ...(Object.keys(params.overrides).length ? { params: params.overrides } : {}) };
+        const next = previous.map(e => e.id === args.id ? target : e.id);
+        if (!previous.some(e => e.id === args.id))
+            next.push(target);
+        if (next.length > 2)
+            return { error: "effects", message: "At most two effects in your own chat; remove one first." };
+        // Retained string entries keep the host's provenance; the explicit target is always restamped agent-side.
+        const result = this.deps.place(instance, next);
+        if (!result.ok)
+            return { error: result.error };
+        this.deps.limiter.record(instance, ["change"]);
+        this.deps.changed();
+        return { id: args.id, region: "chat", params: params.overrides, rev: result.rev };
+    }
+    remove(instance, args) {
+        const refused = this.deps.authorize(instance, ["change"]);
+        if (refused)
+            return refused;
+        if (Object.keys(args).some(k => k !== "id") || args.id !== undefined && (typeof args.id !== "string" || !ID.test(args.id)))
+            return { error: "effect_args" };
+        const before = this.deps.placed(instance), removed = before.filter(e => args.id === undefined || e.id === args.id).map(e => e.id);
+        if (!removed.length)
+            return { removed: [] };
+        const result = this.deps.place(instance, before.filter(e => !removed.includes(e.id)).map(e => e.id));
+        if (!result.ok)
+            return { error: result.error };
+        this.deps.limiter.record(instance, ["change"]);
+        this.deps.library.collectUnreferenced(removed);
+        this.deps.changed();
+        return { removed, rev: result.rev };
+    }
+    delete(instance, args) {
+        const refused = this.deps.authorize(instance, []);
+        if (refused)
+            return refused;
+        if (Object.keys(args).some(k => k !== "id") || typeof args.id !== "string" || !ID.test(args.id))
+            return { error: "effect_args" };
+        const result = this.deps.library.deleteClaim(args.id, this.principal(instance));
+        return result.ok ? { deleted: args.id } : { error: result.error };
+    }
+    profile(instance, args) {
+        if (Object.keys(args).some(k => k !== "id") || typeof args.id !== "string" || !ID.test(args.id) || !this.deps.library.read(args.id, this.principal(instance)).ok)
+            return { error: "not_found" };
+        return this.deps.profiles(args.id);
+    }
+    async preview(instance, args) {
+        if (Object.keys(args).some(k => k !== "id") || typeof args.id !== "string" || !ID.test(args.id))
+            return { error: "effect_args" };
+        const entry = this.deps.library.read(args.id, this.principal(instance));
+        if (!entry.ok)
+            return { error: "not_found" };
+        return this.deps.preview(instance, args.id, entry.entry.manifest.title);
+    }
+    handle(instance, tool, args) {
+        if (!args || typeof args !== "object" || Array.isArray(args))
+            return { error: "effect_args" };
+        switch (tool) {
+            case "upload_web_effect": return this.upload(instance, args);
+            case "list_web_effects": return Object.keys(args).length ? { error: "effect_args" } : this.list(instance);
+            case "apply_web_effect": return this.apply(instance, args);
+            case "remove_web_effect": return this.remove(instance, args);
+            case "delete_web_effect": return this.delete(instance, args);
+            case "profile_web_effect": return this.profile(instance, args);
+            case "preview_web_effect": return this.preview(instance, args);
+            default: return { error: "unknown_tool" };
+        }
+    }
+    forget(instance) { this.uploads.forget(instance); }
+}
+//# sourceMappingURL=web-effect-tools.js.map

package/dist/web-effect-tools.js.map

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

package/dist/web-effect-trials.d.ts

@@ -0,0 +1,86 @@
+import { WebEffectLibrary } from "./web-effect-library.js";
+import type { CheckedWebEffect } from "./web-effect-bundle.js";
+export declare const EFFECT_TRIAL_TTL_MS: number;
+type Failure = {
+    ok: false;
+    error: "trial_unavailable" | "trial_busy" | "trial_capacity";
+};
+/** Display metadata only. Neither the id nor this object grants a resource read. */
+export interface EffectTrialOffer {
+    readonly v: 1;
+    readonly offer: string;
+    readonly id: string;
+    readonly title: string;
+    readonly expiresAt: number;
+}
+/** Independent history/card codec: a card read back from chat history is display metadata, never a grant. */
+export declare function effectTrialOffer(value: unknown): Readonly<EffectTrialOffer> | null;
+/** HOST INPUT ONLY: build afresh from the route's verified session verdict, never from JSON.
+ * sessionHash is SessionRecord.idHash, not the cookie; epoch is its handle. Header tokens
+ * have no actor. Owner CSS must be authoritatively off, including at each resource read.
+ */
+export interface EffectTrialActor {
+    readonly via: "session";
+    readonly surface: "local";
+    readonly tier: "admin";
+    readonly sessionHash: string;
+    readonly epoch: string;
+    readonly person: string;
+    readonly ownerCss: "off";
+}
+export interface EffectTrialDeps {
+    library: WebEffectLibrary;
+    known(instance: string): boolean;
+    monotonic?: () => number;
+    now?: () => number;
+}
+/** One owner per library. Register before publishing the library or doing any collection.
+ * No claims, preferences, files, exports or placements are written. Offers retain bytes
+ * only; read() always rechecks the origin agent's CURRENT own/shared ACL.
+ */
+export declare class WebEffectTrials {
+    private readonly deps;
+    private readonly offers;
+    private readonly trials;
+    private readonly unregister;
+    private busy;
+    private clockBusy;
+    private dead;
+    private brokenClock;
+    private previous;
+    constructor(deps: EffectTrialDeps);
+    private clock;
+    private references;
+    private prune;
+    private run;
+    private readable;
+    /** Agent may OFFER only, using its current own/shared read rights. No appearance write or rate-limit record.
+     * A repeat active offer is idempotent, never extends TTL, and needs no second card.
+     */
+    offer(instance: string, id: string): {
+        ok: true;
+        offer: Readonly<EffectTrialOffer>;
+        created: boolean;
+    } | Failure;
+    /** The CSRF-protected POST /ui/effect-trials/start only, after an explicit local-admin click. Never a tool or GET. */
+    start(offer: string, instance: string, viewer: unknown): {
+        ok: true;
+        trial: string;
+        offer: Readonly<EffectTrialOffer>;
+        remainingMs: number;
+    } | Failure;
+    /** Each image/code/profile authorization supplies a FRESH verified viewer. Knowing a token is insufficient. */
+    read(trial: string, instance: string, viewer: unknown): {
+        ok: true;
+        id: string;
+        instance: string;
+        entry: CheckedWebEffect;
+    } | Failure;
+    /** An authenticated owner can stop even after CSS becomes on/unknown; never stops another session. */
+    stop(trial: string, viewer: unknown): {
+        ok: true;
+    } | Failure;
+    /** Call only when this library owner ends. No collection here; the caller owns GC ordering. */
+    dispose(): void;
+}
+export {};