@ouispec/bindings 0.0.0-stage → 0.1.1

package/dist/react.d.ts

@@ -0,0 +1,74 @@
+/**
+ * React side of the binding (ADR-0220 §2.2): how a design-system control
+ * registers its real handler, and how a room registers its catalog.
+ *
+ * A control calls `useAgentBinding` with its `agent` prop, its kind, its live
+ * props and the function its own gesture calls. Without a provider (the
+ * showcase, a test, any app with no assistant) nothing registers and the
+ * control behaves exactly as before.
+ */
+import { type ReactNode } from 'react';
+import { type AgentProp } from './binding.js';
+import { type AnyControlKind, type SchemaProps } from './controls.js';
+import type { BindingRegistry } from './registry.js';
+import type { RoomCatalogData, RoomProblem, RoomResult } from './room.js';
+export interface AgentBindingProviderProps {
+    registry: BindingRegistry;
+    children?: ReactNode;
+}
+/** Makes one binding registry available to every bound control below it. */
+export declare function AgentBindingProvider({ registry, children }: AgentBindingProviderProps): import("react").FunctionComponentElement<import("react").ProviderProps<BindingRegistry | null>>;
+/** The registry from the nearest provider, or null when there is none. */
+export declare function useAgentBindingRegistry(): BindingRegistry | null;
+/** What a control's handler may return: nothing (it worked), or a result saying what happened. */
+export type BindingRunResult = RoomResult | void;
+export interface AgentBindingSpec {
+    /** The control's `agent` prop, as the page passed it. */
+    agent: AgentProp | undefined | null;
+    kind: AnyControlKind;
+    /** What the control is called on screen, from its own props. */
+    title: string;
+    /** The live props its schema is derived from. */
+    schemaProps?: SchemaProps;
+    /** Its current value, for the page's observation. */
+    value?: unknown;
+    /** It cannot be used right now. */
+    disabled?: boolean;
+    /** Does what the person's gesture does. */
+    run: (input: {
+        value?: unknown;
+    }) => BindingRunResult | Promise<BindingRunResult>;
+}
+/** Register one bound control for as long as it is mounted. */
+export declare function useAgentBinding(spec: AgentBindingSpec): void;
+/**
+ * Register several bound controls at once: a composite's slots, or the
+ * entries of a toolbar, menu or selection bar. The list may change length
+ * between renders.
+ */
+export declare function useAgentBindings(specs: readonly AgentBindingSpec[]): void;
+export interface UseRoomRegistrationOptions {
+    /** Runs one of the catalog's actions by id, through the room's own entry (the room controller's `run`). */
+    run: (actionId: string, input: Record<string, unknown>) => RoomResult | Promise<RoomResult>;
+    /** The current values of the catalog's observations, by id. */
+    observations: Readonly<Record<string, unknown>>;
+    /** What the room's banners show is wrong. */
+    problems: readonly RoomProblem[];
+    /** Register only while true. Default true. */
+    active?: boolean;
+}
+/** Register a room's catalog for as long as the room is mounted. */
+export declare function useRoomRegistration(catalog: RoomCatalogData, options: UseRoomRegistrationOptions): void;
+/**
+ * Report the problems a page area shows (an asset that failed to load, a
+ * render that failed), under the binding id of the area that shows them.
+ */
+export declare function useAgentProblems(source: string, problems: readonly RoomProblem[]): void;
+/**
+ * Reports what a display shows: its facts, by label, as text. The design
+ * system's displays call this with their `agent` binding; a page reports its
+ * own facts the same way.
+ */
+export declare function useAgentFacts(agent: AgentProp | undefined, title: string, facts: Readonly<Record<string, string | number | boolean | null | undefined>>): void;
+export { boundCompound, boundControl, withMembers, type AgentAttribute } from './tier2-react.js';
+//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAA+D,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEpG,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAqB,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACzF,OAAO,KAAK,EAAE,eAAe,EAA6B,MAAM,eAAe,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAI1E,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,yBAAyB,mGAErF;AAED,0EAA0E;AAC1E,wBAAgB,uBAAuB,IAAI,eAAe,GAAG,IAAI,CAEhE;AAED,kGAAkG;AAClG,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,IAAI,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC;IACpC,IAAI,EAAE,cAAc,CAAC;IACrB,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,qDAAqD;IACrD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2CAA2C;IAC3C,GAAG,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACnF;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,GAAG,IAAI,CAiDzE;AAiBD,MAAM,WAAW,0BAA0B;IACzC,2GAA2G;IAC3G,GAAG,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5F,+DAA+D;IAC/D,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChD,6CAA6C;IAC7C,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IACjC,8CAA8C;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAyBvG;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,IAAI,CAcvF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,GAAG,SAAS,EAC5B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,GAC5E,IAAI,CAyBN;AAGD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/react.js

@@ -0,0 +1,179 @@
+/**
+ * React side of the binding (ADR-0220 §2.2): how a design-system control
+ * registers its real handler, and how a room registers its catalog.
+ *
+ * A control calls `useAgentBinding` with its `agent` prop, its kind, its live
+ * props and the function its own gesture calls. Without a provider (the
+ * showcase, a test, any app with no assistant) nothing registers and the
+ * control behaves exactly as before.
+ */
+import { createContext, createElement, useContext, useEffect, useRef } from 'react';
+import { isAgentBinding, isNonAgent } from './binding.js';
+import { deriveValueSchema } from './controls.js';
+const RegistryContext = createContext(null);
+/** Makes one binding registry available to every bound control below it. */
+export function AgentBindingProvider({ registry, children }) {
+    return createElement(RegistryContext.Provider, { value: registry }, children);
+}
+/** The registry from the nearest provider, or null when there is none. */
+export function useAgentBindingRegistry() {
+    return useContext(RegistryContext);
+}
+/** Register one bound control for as long as it is mounted. */
+export function useAgentBinding(spec) {
+    useAgentBindings([spec]);
+}
+/**
+ * Register several bound controls at once: a composite's slots, or the
+ * entries of a toolbar, menu or selection bar. The list may change length
+ * between renders.
+ */
+export function useAgentBindings(specs) {
+    const registry = useContext(RegistryContext);
+    const specsRef = useRef(specs);
+    specsRef.current = specs;
+    const signature = specs
+        .map(s => (isAgentBinding(s.agent) ? `${s.agent.id}\u0000${s.agent.item?.key ?? ''}\u0000${s.kind}` : ''))
+        .join('\u0001');
+    const handles = useRef([]);
+    useEffect(() => {
+        if (!registry)
+            return;
+        const current = specsRef.current;
+        handles.current = current.map((spec, index) => {
+            const agent = spec.agent;
+            if (!isAgentBinding(agent))
+                return null;
+            return registry.registerControl({
+                id: agent.id,
+                kind: spec.kind,
+                title: agent.title ?? spec.title,
+                valueSchema: deriveValueSchema(spec.kind, spec.schemaProps),
+                item: agent.item,
+                value: spec.value,
+                disabled: spec.disabled,
+                run: input => runSafely(() => specsRef.current[index].run(input)),
+            });
+        });
+        return () => {
+            for (const h of handles.current)
+                h?.unregister();
+            handles.current = [];
+        };
+    }, [registry, signature]);
+    // Keep what the registry knows about each control current: its title,
+    // schema, row, value and whether it can be used.
+    useEffect(() => {
+        specs.forEach((spec, index) => {
+            const handle = handles.current[index];
+            if (!handle || !isAgentBinding(spec.agent))
+                return;
+            handle.update({
+                title: spec.agent.title ?? spec.title,
+                valueSchema: deriveValueSchema(spec.kind, spec.schemaProps),
+                item: spec.agent.item,
+                value: spec.value,
+                disabled: spec.disabled,
+            });
+        });
+    });
+}
+async function runSafely(run) {
+    try {
+        // A callback typed `() => void` may still return something (an array's
+        // `push` returns its length); only a real result says what happened.
+        const result = await run();
+        return isRoomResult(result) ? result : { ok: true };
+    }
+    catch (err) {
+        return { ok: false, code: 'FAILED', message: err instanceof Error ? err.message : String(err) };
+    }
+}
+function isRoomResult(value) {
+    return !!value && typeof value === 'object' && typeof value.ok === 'boolean';
+}
+/** Register a room's catalog for as long as the room is mounted. */
+export function useRoomRegistration(catalog, options) {
+    const registry = useContext(RegistryContext);
+    const optionsRef = useRef(options);
+    optionsRef.current = options;
+    const handle = useRef(null);
+    const active = options.active ?? true;
+    useEffect(() => {
+        if (!registry || !active)
+            return;
+        handle.current = registry.registerRoom({
+            catalog,
+            run: (id, input) => optionsRef.current.run(id, input),
+        });
+        return () => {
+            handle.current?.unregister();
+            handle.current = null;
+        };
+    }, [registry, catalog, active]);
+    useEffect(() => {
+        const h = handle.current;
+        if (!h)
+            return;
+        for (const [id, value] of Object.entries(options.observations))
+            h.setObservation(id, value);
+        h.setProblems(options.problems);
+    });
+}
+/**
+ * Report the problems a page area shows (an asset that failed to load, a
+ * render that failed), under the binding id of the area that shows them.
+ */
+export function useAgentProblems(source, problems) {
+    const registry = useContext(RegistryContext);
+    const handle = useRef(null);
+    useEffect(() => {
+        if (!registry)
+            return;
+        handle.current = registry.registerProblems(source);
+        return () => {
+            handle.current?.unregister();
+            handle.current = null;
+        };
+    }, [registry, source]);
+    useEffect(() => {
+        handle.current?.set(problems);
+    });
+}
+/**
+ * Reports what a display shows: its facts, by label, as text. The design
+ * system's displays call this with their `agent` binding; a page reports its
+ * own facts the same way.
+ */
+export function useAgentFacts(agent, title, facts) {
+    const registry = useContext(RegistryContext);
+    const handle = useRef(null);
+    const bound = agent && !isNonAgent(agent) && isAgentBinding(agent) ? agent : null;
+    useEffect(() => {
+        if (!registry || !bound)
+            return;
+        handle.current = registry.registerFacts();
+        return () => {
+            handle.current?.unregister();
+            handle.current = null;
+        };
+    }, [registry, !!bound]);
+    useEffect(() => {
+        if (!bound)
+            return;
+        const text = {};
+        for (const [label, value] of Object.entries(facts)) {
+            if (value !== null && value !== undefined && value !== '')
+                text[label] = String(value);
+        }
+        handle.current?.set({
+            id: bound.id,
+            title: bound.title ?? title,
+            facts: text,
+            ...(bound.item ? { item: bound.item } : {}),
+        });
+    });
+}
+// Tier 2 (ADR-0226 §2.3): what the bound wrappers `oui generate` emits are built from.
+export { boundCompound, boundControl, withMembers } from './tier2-react.js';
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,103 @@
+/**
+ * The tab's record of what is mounted right now (ADR-0220 §2.2): every bound
+ * control with its real handler, and every room with its catalog and context.
+ *
+ * Controls register when they mount and leave when they unmount, so the
+ * registry is exactly what a person could use on screen. An adapter
+ * (`./oui`) turns it, with the build's generated manifest, into the tab's OUI
+ * surfaces.
+ *
+ * Plain TypeScript: no React, no OUI runtime.
+ */
+import type { AgentItem } from './binding.js';
+import type { AnyControlKind } from './controls.js';
+import type { JsonSchema } from './json-schema.js';
+import type { RoomCatalogData, RoomProblem, RoomResult } from './room.js';
+/** One mounted bound control. */
+export interface ControlRegistration {
+    /** The binding id. */
+    id: string;
+    kind: AnyControlKind;
+    /** What the control is called on screen. */
+    title: string;
+    /** The live schema of its value (no `item`), derived from its live props; null for a button or dialog. */
+    valueSchema: JsonSchema | null;
+    /** Which row, when it is one of a list's. */
+    item?: AgentItem;
+    /** Its current value, for the page's observation. */
+    value?: unknown;
+    /** It cannot be used right now; its action is not offered. */
+    disabled?: boolean;
+    /** Does what the person's gesture does, with `value` for a field. */
+    run(input: {
+        value?: unknown;
+    }): RoomResult | Promise<RoomResult>;
+}
+/** One mounted room. */
+export interface RoomRegistration {
+    /** The room's catalog (a `RoomCatalog` is one): which room it is, and what it declares. */
+    catalog: RoomCatalogData;
+    /** Runs one of the catalog's actions by id, through the room's own entry — as the room's controller does. */
+    run(actionId: string, input: Record<string, unknown>): RoomResult | Promise<RoomResult>;
+}
+/** What changed: what can be done (`structure`), or only what the page shows (`values`). */
+export type RegistryChange = 'structure' | 'values';
+export interface ControlHandle {
+    /** New live facts about the control. A change of title, schema, row or disabled changes what can be done. */
+    update(patch: Partial<Omit<ControlRegistration, 'id' | 'kind' | 'run'>>): void;
+    unregister(): void;
+}
+export interface RoomHandle {
+    /** The current value of one of the catalog's observations. */
+    setObservation(id: string, value: unknown): void;
+    /** The room's problems, as its banners show them. */
+    setProblems(problems: readonly RoomProblem[]): void;
+    unregister(): void;
+}
+/** Problems a page shows that are not a room's: an asset that failed to load, a render that failed. */
+export interface ProblemHandle {
+    set(problems: readonly RoomProblem[]): void;
+    unregister(): void;
+}
+/**
+ * What a page shows that is not a control: a clip's model and seed, a job's
+ * cost. Read-only facts, by label, reported in the page state so the
+ * assistant reads what the person reads.
+ */
+export interface ShownFacts {
+    /** The binding id of the display that shows them. */
+    id: string;
+    /** Its heading, as the page shows it. */
+    title: string;
+    /** Each fact's value as text, by its label. */
+    facts: Readonly<Record<string, string>>;
+    /** Which row of a list it describes, when it is one of many. */
+    item?: AgentItem;
+}
+export interface FactsHandle {
+    set(value: ShownFacts): void;
+    unregister(): void;
+}
+export interface BindingRegistry {
+    registerControl(registration: ControlRegistration): ControlHandle;
+    registerRoom(registration: RoomRegistration): RoomHandle;
+    /** Problems shown on the page, by the binding id of the page area that shows them. */
+    registerProblems(source: string): ProblemHandle;
+    /** Facts a page shows, by display. */
+    registerFacts(): FactsHandle;
+    /** Every shown display's facts, oldest first. */
+    facts(): readonly ShownFacts[];
+    /** Every mounted control, oldest first. */
+    controls(): readonly ControlRegistration[];
+    /** Every mounted room, with its observation values and problems. */
+    rooms(): readonly {
+        registration: RoomRegistration;
+        observations: Readonly<Record<string, unknown>>;
+        problems: readonly RoomProblem[];
+    }[];
+    /** Every page problem, by source. */
+    problems(): Readonly<Record<string, readonly RoomProblem[]>>;
+    subscribe(listener: (change: RegistryChange) => void): () => void;
+}
+export declare function createBindingRegistry(): BindingRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

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

package/dist/registry.js

@@ -0,0 +1,146 @@
+/**
+ * The tab's record of what is mounted right now (ADR-0220 §2.2): every bound
+ * control with its real handler, and every room with its catalog and context.
+ *
+ * Controls register when they mount and leave when they unmount, so the
+ * registry is exactly what a person could use on screen. An adapter
+ * (`./oui`) turns it, with the build's generated manifest, into the tab's OUI
+ * surfaces.
+ *
+ * Plain TypeScript: no React, no OUI runtime.
+ */
+export function createBindingRegistry() {
+    const controls = [];
+    const rooms = [];
+    const pageProblems = new Map();
+    const shown = [];
+    const listeners = new Set();
+    // Changes arrive in bursts (a page mounting fifty controls); listeners hear
+    // one notification per burst, the strongest change in it.
+    let pending = null;
+    const notify = (change) => {
+        const flush = pending === null;
+        if (pending !== 'structure')
+            pending = change;
+        if (!flush)
+            return;
+        queueMicrotask(() => {
+            const c = pending;
+            pending = null;
+            for (const l of [...listeners])
+                l(c);
+        });
+    };
+    return {
+        registerControl(registration) {
+            const entry = { ...registration };
+            controls.push(entry);
+            notify('structure');
+            return {
+                update(patch) {
+                    if (!controls.includes(entry))
+                        return;
+                    const structural = ('title' in patch && patch.title !== entry.title) ||
+                        ('disabled' in patch && !!patch.disabled !== !!entry.disabled) ||
+                        ('item' in patch && !sameItem(patch.item, entry.item)) ||
+                        ('valueSchema' in patch &&
+                            JSON.stringify(patch.valueSchema) !== JSON.stringify(entry.valueSchema));
+                    const valueChanged = 'value' in patch && !Object.is(patch.value, entry.value);
+                    Object.assign(entry, patch);
+                    if (structural)
+                        notify('structure');
+                    else if (valueChanged)
+                        notify('values');
+                },
+                unregister() {
+                    const i = controls.indexOf(entry);
+                    if (i === -1)
+                        return;
+                    controls.splice(i, 1);
+                    notify('structure');
+                },
+            };
+        },
+        registerRoom(registration) {
+            const entry = {
+                registration,
+                observations: {},
+                problems: [],
+            };
+            rooms.push(entry);
+            notify('structure');
+            return {
+                setObservation(id, value) {
+                    if (Object.is(entry.observations[id], value))
+                        return;
+                    entry.observations[id] = value;
+                    notify('values');
+                },
+                setProblems(problems) {
+                    if (JSON.stringify(problems) === JSON.stringify(entry.problems))
+                        return;
+                    entry.problems = problems;
+                    notify('values');
+                },
+                unregister() {
+                    const i = rooms.indexOf(entry);
+                    if (i === -1)
+                        return;
+                    rooms.splice(i, 1);
+                    notify('structure');
+                },
+            };
+        },
+        registerProblems(source) {
+            return {
+                set(problems) {
+                    // Nothing changed, none before and none now included: a banner with nothing wrong says nothing.
+                    const before = pageProblems.get(source) ?? [];
+                    if (JSON.stringify(before) === JSON.stringify(problems))
+                        return;
+                    if (problems.length)
+                        pageProblems.set(source, problems);
+                    else
+                        pageProblems.delete(source);
+                    notify('values');
+                },
+                unregister() {
+                    if (pageProblems.delete(source))
+                        notify('values');
+                },
+            };
+        },
+        registerFacts() {
+            const entry = { value: null };
+            shown.push(entry);
+            return {
+                set(value) {
+                    if (JSON.stringify(value) === JSON.stringify(entry.value))
+                        return;
+                    entry.value = value;
+                    notify('values');
+                },
+                unregister() {
+                    const i = shown.indexOf(entry);
+                    if (i === -1)
+                        return;
+                    shown.splice(i, 1);
+                    if (entry.value)
+                        notify('values');
+                },
+            };
+        },
+        controls: () => controls,
+        facts: () => shown.flatMap(e => (e.value ? [e.value] : [])),
+        rooms: () => rooms,
+        problems: () => Object.fromEntries(pageProblems),
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+    };
+}
+function sameItem(a, b) {
+    return a?.key === b?.key && a?.title === b?.title;
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/room.d.ts

@@ -0,0 +1,79 @@
+/**
+ * The room catalog contract (ADR-0220 §2.3): what a room with its own editing
+ * model — the vector studio, the video editor — declares about everything a
+ * person can do in it, so the assistant's actions and knowledge are generated
+ * from the room's code rather than written by hand.
+ *
+ * The declarations are the contract's (`room-catalog-data.json`), generated
+ * from its schema: what `agent-catalog.json` holds and a generator reads. This
+ * module adds what a room runs — each action's `run`, each field's `read` and
+ * `write` — and the catalog's two derived pieces: its `problems` schema and
+ * its data.
+ *
+ * - **actions**: its operations, each carried out through the room's own
+ *   reducer and commands, with a JSON schema for the input;
+ * - **fields**: its inspector's fields, from the same definitions the
+ *   inspector renders, each with its value's schema, unit, range, its
+ *   animation and which kinds of thing it applies to;
+ * - **commands**: its keymap, each command with its keys and what it does;
+ * - **observations**: what a host reports about the room's state, including
+ *   the problems it has drawing it.
+ */
+import type { JsonSchema, RoomActionData, RoomCatalogData, RoomCommand, RoomFieldData, RoomObservation, RoomProblemKind, RoomRecipe, RoomResult } from '@ouispec/contract';
+export type { AgentCatalogManifestEntry, RoomActionData, RoomCatalogData, RoomCommand, RoomEntryInfo, RoomFieldAnimation, RoomFieldData, RoomObservation, RoomProblem, RoomProblemKind, RoomRecipe, RoomResult, RoomSection, } from '@ouispec/contract';
+/**
+ * What a room action changes.
+ * @deprecated Since 0.8: a room action's effect is an `ActionEffect` (ADR-0226 §2.6), of which these are four. Kept for one minor.
+ */
+export type RoomEffect = 'edit' | 'selection' | 'view' | 'file';
+/** One operation of the room. `Ctx` is the room's runtime: what `run` edits through. */
+export interface RoomAction<Ctx, Input = Record<string, unknown>> extends RoomActionData {
+    /** Carries the action out through the room's own reducer and commands, as the person's control does. */
+    run(ctx: Ctx, input: Input): RoomResult | Promise<RoomResult>;
+}
+/** One inspector field: what it shows for the selection, and what setting it does. */
+export interface RoomField<Ctx, Value = unknown> extends RoomFieldData {
+    /** The value for what is selected; `undefined` when the field does not apply to it. */
+    read(ctx: Ctx): Value | undefined;
+    /** Set it on what is selected, as typing into the field does. */
+    write(ctx: Ctx, value: Value): RoomResult | Promise<RoomResult>;
+}
+/** Whether a field animates: its `animation`, or the `keyframeable` of a catalog written before it. */
+export declare function isKeyframeable(field: Pick<RoomFieldData, 'animation' | 'keyframeable'>): boolean;
+/** Everything a room declares. */
+export interface RoomCatalog<Ctx> {
+    /** The room's id: the surface id its assistant surface is published under. */
+    room: string;
+    title: string;
+    /** What the room is for, in one or two sentences. */
+    description: string;
+    actions: readonly RoomAction<Ctx, never>[];
+    fields: readonly RoomField<Ctx, unknown>[];
+    commands: readonly RoomCommand[];
+    observations: readonly RoomObservation[];
+    /** The kinds of problem it reports, in its own vocabulary. Default: the generic `problems` schema. */
+    problems?: readonly RoomProblemKind[];
+    /** Tasks its tools carry out together, which only the room knows. */
+    recipes?: readonly RoomRecipe[];
+}
+/**
+ * The ids of a room's two generic actions, built from the rest of its
+ * catalog so they cannot fall behind it: one sets any of its fields (its
+ * input has one property per field, under `values`), one runs any available
+ * command. A room with fields declares the first; a room with available
+ * commands declares the second.
+ */
+export declare const ROOM_SET_PROPERTIES_ID = "set-properties";
+export declare const ROOM_RUN_COMMAND_ID = "run-command";
+/** The id every room and page reports its problems under. */
+export declare const PROBLEMS_OBSERVATION_ID = "problems";
+/**
+ * The schema of a `problems` observation: a list of `RoomProblem`. Its kinds
+ * are the room's own when it declares them (`RoomCatalog.problems`).
+ */
+export declare function problemsSchema(kinds?: readonly RoomProblemKind[]): JsonSchema;
+/** The schema of a `problems` observation whose kinds are not declared: every page's. */
+export declare const PROBLEMS_SCHEMA: JsonSchema;
+/** The catalog's declarations, as `agent-catalog.json` holds them. Deterministic: entries keep the catalog's order. */
+export declare function catalogData<Ctx>(catalog: RoomCatalog<Ctx>): RoomCatalogData;
+//# sourceMappingURL=room.d.ts.map

package/dist/room.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room.d.ts","sourceRoot":"","sources":["../src/room.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,eAAe,EACf,WAAW,EACX,aAAa,EACb,eAAe,EACf,eAAe,EACf,UAAU,EACV,UAAU,EACX,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,yBAAyB,EACzB,cAAc,EACd,eAAe,EACf,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,WAAW,EACX,eAAe,EACf,UAAU,EACV,UAAU,EACV,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAE3B;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAEhE,wFAAwF;AACxF,MAAM,WAAW,UAAU,CAAC,GAAG,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAE,SAAQ,cAAc;IACtF,wGAAwG;IACxG,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,GAAG,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC/D;AAED,sFAAsF;AACtF,MAAM,WAAW,SAAS,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAE,SAAQ,aAAa;IACpE,uFAAuF;IACvF,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,KAAK,GAAG,SAAS,CAAC;IAClC,iEAAiE;IACjE,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,GAAG,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACjE;AAED,uGAAuG;AACvG,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,cAAc,CAAC,GAAG,OAAO,CAEhG;AAED,kCAAkC;AAClC,MAAM,WAAW,WAAW,CAAC,GAAG;IAC9B,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,SAAS,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;IAC3C,MAAM,EAAE,SAAS,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC;IAC3C,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IACjC,YAAY,EAAE,SAAS,eAAe,EAAE,CAAC;IACzC,sGAAsG;IACtG,QAAQ,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACtC,qEAAqE;IACrE,OAAO,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;CACjC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,mBAAmB,CAAC;AACvD,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AAEjD,6DAA6D;AAC7D,eAAO,MAAM,uBAAuB,aAAa,CAAC;AAMlD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,GAAE,SAAS,eAAe,EAAO,GAAG,UAAU,CA6BjF;AAED,yFAAyF;AACzF,eAAO,MAAM,eAAe,EAAE,UAA6B,CAAC;AAE5D,uHAAuH;AACvH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,CAAC,GAAG,CAAC,GAAG,eAAe,CAkC3E"}