@ouispec/bindings 0.0.0-stage → 0.1.0

package/dist/effect.js

@@ -0,0 +1,88 @@
+import { effectAccess as ouiEffectAccess, OUI_EFFECT_ACCESS, OUI_EFFECT_KINDS, requiresApproval as ouiRequiresApproval, } from 'oui-spec/spec';
+/**
+ * What using an action does (ADR-0226 §2.6): one vocabulary for a
+ * design-system control's binding, a room catalog's entry and a generated API
+ * tool, so a page control, a room action and an API call are told apart by
+ * what they change, never by where they are declared.
+ *
+ * | Effect | What it changes | ADR-0210 access |
+ * |---|---|---|
+ * | `view`, `selection`, `navigate`, `open` | What is shown | read |
+ * | `edit` | The document, one undo step | write |
+ * | `file` | Imports or exports a file | write |
+ * | `mutate` | Backend data, through an API operation | write |
+ * | `job` | Starts work that outlives the call, settled on its outcome | write |
+ * | `transaction` | An irreversible external act: an order, a payment, a send, a publish | write, approved |
+ *
+ * A `transaction`, and any `write` declared `destructive`, runs only on an
+ * approval the person gave, bound to the call (ADR-0228).
+ */
+/** How long an approval for an action lasts at most, in minutes (ADR-0228 §2.3). */
+export const MAX_APPROVAL_MINUTES = 30;
+const everyKindIsOUIs = true;
+void everyKindIsOUIs;
+const theSchemaListsOUIsKinds = true;
+void theSchemaListsOUIsKinds;
+/** Every effect, in the order of the table above. */
+export const ACTION_EFFECT_KINDS = OUI_EFFECT_KINDS;
+/** Whether an effect only changes what is shown, or changes something (ADR-0210 `effect`). */
+export const EFFECT_ACCESS = OUI_EFFECT_ACCESS;
+export function effectKind(effect) {
+    return typeof effect === 'string' ? effect : effect.kind;
+}
+/** `read` or `write`, as ADR-0210 names it. An action that declares no effect is a `write`: nothing says it only shows. */
+export function effectAccess(effect) {
+    return ouiEffectAccess(effect === undefined ? undefined : effectKind(effect));
+}
+/**
+ * Whether running the action needs the person's approval of the exact call
+ * (ADR-0228 §2.1): a `transaction` always, and a `write` declared destructive.
+ * A host's policy may require it of more; it never waives these. OUI's rule.
+ */
+export function requiresApproval(effect, destructive) {
+    return ouiRequiresApproval(effect === undefined ? undefined : effectKind(effect), destructive);
+}
+/**
+ * Why a value is not a valid effect, or null. Checks the shape only: whether a
+ * route, container or operation it names exists is the generator's to check
+ * against the app.
+ */
+export function effectProblem(value) {
+    if (typeof value === 'string') {
+        return ['view', 'selection', 'edit', 'file'].includes(value)
+            ? null
+            : `"${value}" is not an effect: ${ACTION_EFFECT_KINDS.join(', ')}`;
+    }
+    if (!value || typeof value !== 'object' || typeof value.kind !== 'string')
+        return `an effect is one of ${ACTION_EFFECT_KINDS.join(', ')}`;
+    const e = value;
+    const text = (key) => typeof e[key] === 'string' && e[key].trim() !== '';
+    const optionalText = (key) => e[key] === undefined || typeof e[key] === 'string';
+    const positive = (key) => e[key] === undefined || (typeof e[key] === 'number' && e[key] > 0);
+    switch (e.kind) {
+        case 'navigate':
+            return text('to') ? null : 'a navigate effect names the route it goes `to`';
+        case 'open':
+            return text('container') ? null : 'an open effect names the `container` it opens';
+        case 'mutate':
+            return text('operation') ? null : 'a mutate effect names its API `operation`';
+        case 'job':
+            return optionalText('estimatedDuration') && positive('timeoutMs')
+                ? null
+                : 'a job effect’s `timeoutMs` is a positive number and its `estimatedDuration` a literal string';
+        case 'transaction': {
+            if (!optionalText('operation') || e.operation === '')
+                return 'a transaction’s `operation` is an operationId';
+            if (!optionalText('estimatedDuration') || !positive('timeoutMs'))
+                return 'a transaction’s `timeoutMs` is a positive number and its `estimatedDuration` a literal string';
+            const minutes = e.approvalMinutes;
+            if (minutes !== undefined &&
+                !(typeof minutes === 'number' && Number.isInteger(minutes) && minutes >= 1 && minutes <= MAX_APPROVAL_MINUTES))
+                return `a transaction’s \`approvalMinutes\` is a whole number from 1 to ${MAX_APPROVAL_MINUTES}`;
+            return null;
+        }
+        default:
+            return `"${String(e.kind)}" is not an effect: ${ACTION_EFFECT_KINDS.join(', ')}`;
+    }
+}
+//# sourceMappingURL=effect.js.map

package/dist/effect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect.js","sourceRoot":"","sources":["../src/effect.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,IAAI,eAAe,EAC/B,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,IAAI,mBAAmB,GAExC,MAAM,eAAe,CAAC;AAOvB;;;;;;;;;;;;;;;;;GAiBG;AAEH,oFAAoF;AACpF,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAevC,MAAM,eAAe,GAAkD,IAAI,CAAC;AAC5E,KAAK,eAAe,CAAC;AAGrB,MAAM,uBAAuB,GAA8C,IAAI,CAAC;AAChF,KAAK,uBAAuB,CAAC;AAE7B,qDAAqD;AACrD,MAAM,CAAC,MAAM,mBAAmB,GAAgC,gBAAgB,CAAC;AAEjF,8FAA8F;AAC9F,MAAM,CAAC,MAAM,aAAa,GAAyD,iBAAiB,CAAC;AAQrG,MAAM,UAAU,UAAU,CAAC,MAAoB;IAC7C,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;AAC3D,CAAC;AAED,2HAA2H;AAC3H,MAAM,UAAU,YAAY,CAAC,MAAgC;IAC3D,OAAO,eAAe,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AAChF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAgC,EAAE,WAAqB;IACtF,OAAO,mBAAmB,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC;AACjG,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAuB,CAAC,QAAQ,CAAC,KAAK,CAAC;YACjF,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,IAAI,KAAK,uBAAuB,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACvE,CAAC;IACD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAQ,KAA4B,CAAC,IAAI,KAAK,QAAQ;QAC/F,OAAO,uBAAuB,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACjE,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAK,CAAC,CAAC,GAAG,CAAY,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IAC7F,MAAM,YAAY,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC;IACzF,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAK,CAAC,CAAC,GAAG,CAAY,GAAG,CAAC,CAAC,CAAC;IACjH,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,UAAU;YACb,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,gDAAgD,CAAC;QAC9E,KAAK,MAAM;YACT,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,+CAA+C,CAAC;QACpF,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,2CAA2C,CAAC;QAChF,KAAK,KAAK;YACR,OAAO,YAAY,CAAC,mBAAmB,CAAC,IAAI,QAAQ,CAAC,WAAW,CAAC;gBAC/D,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,8FAA8F,CAAC;QACrG,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,SAAS,KAAK,EAAE;gBAAE,OAAO,+CAA+C,CAAC;YAC7G,IAAI,CAAC,YAAY,CAAC,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAC9D,OAAO,+FAA+F,CAAC;YACzG,MAAM,OAAO,GAAG,CAAC,CAAC,eAAe,CAAC;YAClC,IACE,OAAO,KAAK,SAAS;gBACrB,CAAC,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,OAAO,IAAI,oBAAoB,CAAC;gBAE9G,OAAO,mEAAmE,oBAAoB,EAAE,CAAC;YACnG,OAAO,IAAI,CAAC;QACd,CAAC;QACD;YACE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,uBAAuB,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACrF,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @ouispec/bindings — every UI capability declared once, in code
+ * (ADR-0220).
+ *
+ * - The binding a design-system control carries, and the input schema derived
+ *   from its props.
+ * - The room catalog contract a room with its own editing model publishes.
+ * - The generated manifest and knowledge, and how the runtime reads them.
+ * - The registry of what is mounted right now.
+ *
+ * React hooks are in `@ouispec/bindings/react`; the adapter to OUI
+ * surfaces is in `@ouispec/bindings/oui`. This entry has no
+ * dependencies, so the build-time generator reads it in plain Node.
+ */
+export * from './json-schema.js';
+export * from './effect.js';
+export * from './room.js';
+export * from './binding.js';
+export * from './controls.js';
+export * from './manifest.js';
+export * from './registry.js';
+export * from './interactive.js';
+export * from './package-declaration.js';
+export * from './tier2.js';
+export type { OuiConfigFile, OuiPackageDeclaration, Tier2Control, Tier2Mapping, Tier2Part, ValueFrom } from '@ouispec/contract';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,YAAY,CAAC;AAI3B,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+/**
+ * @ouispec/bindings — every UI capability declared once, in code
+ * (ADR-0220).
+ *
+ * - The binding a design-system control carries, and the input schema derived
+ *   from its props.
+ * - The room catalog contract a room with its own editing model publishes.
+ * - The generated manifest and knowledge, and how the runtime reads them.
+ * - The registry of what is mounted right now.
+ *
+ * React hooks are in `@ouispec/bindings/react`; the adapter to OUI
+ * surfaces is in `@ouispec/bindings/oui`. This entry has no
+ * dependencies, so the build-time generator reads it in plain Node.
+ */
+export * from './json-schema.js';
+export * from './effect.js';
+export * from './room.js';
+export * from './binding.js';
+export * from './controls.js';
+export * from './manifest.js';
+export * from './registry.js';
+export * from './interactive.js';
+export * from './package-declaration.js';
+export * from './tier2.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,YAAY,CAAC"}

package/dist/interactive.d.ts

@@ -0,0 +1,12 @@
+/**
+ * What makes something a person can use, for the generator's reading of a
+ * page and the conformance kit's reading of a design system's exports: one
+ * definition, so the two never disagree on what must be bound.
+ */
+/** Elements someone can use by their nature. */
+export declare const INTERACTIVE_TAGS: ReadonlySet<string>;
+/** Handlers that make an element someone can use: a press, an edit, a key, a pointer. */
+export declare const INTERACTIVE_HANDLERS: readonly string[];
+/** A prop that takes a callback, by React's naming: `onValueChange`, `onDragEnd`. */
+export declare const CALLBACK_PROP: RegExp;
+//# sourceMappingURL=interactive.d.ts.map

package/dist/interactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../src/interactive.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,gDAAgD;AAChD,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAsD,CAAC;AAExG,yFAAyF;AACzF,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EASjD,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,aAAa,QAAa,CAAC"}

package/dist/interactive.js

@@ -0,0 +1,21 @@
+/**
+ * What makes something a person can use, for the generator's reading of a
+ * page and the conformance kit's reading of a design system's exports: one
+ * definition, so the two never disagree on what must be bound.
+ */
+/** Elements someone can use by their nature. */
+export const INTERACTIVE_TAGS = new Set(['button', 'input', 'select', 'textarea']);
+/** Handlers that make an element someone can use: a press, an edit, a key, a pointer. */
+export const INTERACTIVE_HANDLERS = [
+    'onClick',
+    'onChange',
+    'onInput',
+    'onSubmit',
+    'onDoubleClick',
+    'onPointerDown',
+    'onMouseDown',
+    'onKeyDown',
+];
+/** A prop that takes a callback, by React's naming: `onValueChange`, `onDragEnd`. */
+export const CALLBACK_PROP = /^on[A-Z]/;
+//# sourceMappingURL=interactive.js.map

package/dist/interactive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.js","sourceRoot":"","sources":["../src/interactive.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,gDAAgD;AAChD,MAAM,CAAC,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;AAExG,yFAAyF;AACzF,MAAM,CAAC,MAAM,oBAAoB,GAAsB;IACrD,SAAS;IACT,UAAU;IACV,SAAS;IACT,UAAU;IACV,eAAe;IACf,eAAe;IACf,aAAa;IACb,WAAW;CACZ,CAAC;AAEF,qFAAqF;AACrF,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC"}

package/dist/jobs.d.ts

@@ -0,0 +1,54 @@
+/**
+ * The app's job tracker, built from the product's event declarations (W9,
+ * ADR-0227 §2.4): the `JobTracker` that `connectBindings({ jobs })` reads a
+ * `{ kind: 'job' }` action's outcome from.
+ *
+ * A job of the declared kind is followed in the room its completion declares
+ * for one job (`generation:{jobId}`), and ends on its declared completion,
+ * with the declared result fields, or its declared failure, with the declared
+ * reason. Work a declared kind cannot describe (work the tab does itself, a
+ * job made of several) plugs in as a `JobTrackerExtension`, which reads
+ * declared events only.
+ *
+ * It records outcomes only for jobs something asked it to track, so traffic
+ * for other jobs cannot grow it. It listens once per event name.
+ */
+import type { EventCatalog } from '@ouispec/agent-events';
+import type { JobOutcome, JobTracker } from './oui.js';
+/** What the tracker needs of a socket: rooms to join and events to hear. */
+export interface JobEventSource {
+    subscribe(rooms: string[]): void;
+    unsubscribe(rooms: string[]): void;
+    on(event: string, handler: (data: unknown) => void): void;
+}
+/**
+ * Jobs the declared kind cannot describe, followed by the product's own code.
+ * The tracker hands it only the declared events it names, and answers for its
+ * jobs only while they are tracked.
+ */
+export interface JobTrackerExtension {
+    /** For errors. */
+    readonly name: string;
+    /** The declared events it reads; each must be declared. */
+    readonly events: readonly string[];
+    /** Whether this extension follows `jobId`. */
+    owns(jobId: string): boolean;
+    /** Start following `jobId`; the rooms to join (none for the tab's own work). */
+    track(jobId: string): readonly string[];
+    /** One of its events arrived. */
+    receive(event: string, payload: unknown): void;
+    /** The job's outcome once it has one. */
+    outcome(jobId: string): JobOutcome | null;
+    /** Stop following `jobId`; the rooms to leave. */
+    forget(jobId: string): readonly string[];
+}
+export interface DeclaredJobTrackerOptions {
+    /** The product's event declarations. */
+    events: EventCatalog;
+    source: JobEventSource;
+    /** The declared job kind a job id names, unless an extension owns it. */
+    kind: string;
+    extensions?: readonly JobTrackerExtension[];
+}
+export declare function createDeclaredJobTracker({ events, source, kind, extensions }: DeclaredJobTrackerOptions): JobTracker;
+//# sourceMappingURL=jobs.d.ts.map

package/dist/jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../src/jobs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEvD,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACjC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACnC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;CAC3D;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,kBAAkB;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,8CAA8C;IAC9C,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,gFAAgF;IAChF,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IACxC,iCAAiC;IACjC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/C,yCAAyC;IACzC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IAC1C,kDAAkD;IAClD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,yBAAyB;IACxC,wCAAwC;IACxC,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,cAAc,CAAC;IACvB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAC7C;AAED,wBAAgB,wBAAwB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAe,EAAE,EAAE,yBAAyB,GAAG,UAAU,CAsEzH"}

package/dist/jobs.js

@@ -0,0 +1,74 @@
+export function createDeclaredJobTracker({ events, source, kind, extensions = [] }) {
+    const declared = events.jobKind(kind);
+    if (!declared) {
+        const kinds = events.jobKinds().map((k) => k.kind);
+        throw new Error(`[oui-bindings] the job tracker follows jobs of kind '${kind}', which no declared event settles (declared: ${kinds.join(', ') || 'none'})`);
+    }
+    // Refuses, naming the kind, when no room is keyed by its id alone.
+    events.followRoom(kind, 'probe');
+    for (const extension of extensions) {
+        for (const event of extension.events)
+            events.require(event, `job tracker extension '${extension.name}'`);
+    }
+    const tracked = new Set();
+    const outcomes = new Map();
+    const owner = (jobId) => extensions.find((e) => e.owns(jobId));
+    const followRoom = (jobId) => {
+        try {
+            return [events.followRoom(kind, jobId)];
+        }
+        catch {
+            // An id no room can hold cannot be followed; its action reports it unfinished.
+            return [];
+        }
+    };
+    const settle = (event, payload) => {
+        const settlement = events.settlement(event, payload);
+        if (!settlement || !tracked.has(settlement.id))
+            return;
+        const outcome = events.outcome(settlement);
+        outcomes.set(settlement.id, outcome.status === 'complete'
+            ? { status: 'complete', jobId: settlement.id, ...outcome.result }
+            : { status: 'failed', jobId: settlement.id, error: outcome.reason });
+    };
+    const readers = new Map();
+    const listen = (event, reader) => readers.set(event, [...(readers.get(event) ?? []), reader]);
+    listen(declared.completion.name, (payload) => settle(declared.completion.name, payload));
+    if (declared.failure)
+        listen(declared.failure.name, (payload) => settle(declared.failure.name, payload));
+    for (const extension of extensions) {
+        for (const event of extension.events)
+            listen(event, (payload) => extension.receive(event, payload));
+    }
+    for (const [event, eventReaders] of readers) {
+        source.on(event, (payload) => eventReaders.forEach((read) => read(payload)));
+    }
+    return {
+        track(jobId) {
+            if (!jobId || tracked.has(jobId))
+                return;
+            tracked.add(jobId);
+            const extension = owner(jobId);
+            const rooms = extension ? [...extension.track(jobId)] : followRoom(jobId);
+            if (rooms.length > 0)
+                source.subscribe(rooms);
+        },
+        outcome(jobId) {
+            if (!tracked.has(jobId))
+                return null;
+            const extension = owner(jobId);
+            return extension ? extension.outcome(jobId) : (outcomes.get(jobId) ?? null);
+        },
+        forget(jobId) {
+            if (!tracked.delete(jobId))
+                return;
+            const extension = owner(jobId);
+            if (!extension)
+                outcomes.delete(jobId);
+            const rooms = extension ? [...extension.forget(jobId)] : followRoom(jobId);
+            if (rooms.length > 0)
+                source.unsubscribe(rooms);
+        },
+    };
+}
+//# sourceMappingURL=jobs.js.map

package/dist/jobs.js.map

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

package/dist/json-schema.d.ts

@@ -0,0 +1,36 @@
+import type { JsonSchema, JsonSchemaType } from '@ouispec/contract';
+/**
+ * The subset of JSON Schema (draft 2020-12) every capability declares its
+ * input and values in: the contract's (`json-schema.json`).
+ */
+export type { JsonSchema, JsonSchemaType };
+/**
+ * Whether `live` asks for no more than `declared` does: the same type, a range
+ * inside the declared one, options drawn from the declared options, and the
+ * same properties. A live control may narrow what the build declared (the
+ * options loaded from the API today) but never widen it or change its type,
+ * because the build's declaration is what was reviewed.
+ */
+export declare function isNarrowing(live: JsonSchema, declared: JsonSchema): boolean;
+/** The keywords that combine schemas, which a tool's input may not have at its top level. */
+export declare const TOOL_INPUT_COMBINERS: readonly ["oneOf", "anyOf", "allOf"];
+/**
+ * Why `schema` cannot be a tool's input, or none. A tool's input is one JSON
+ * object schema: its type is `"object"` and only that, and it is not a union
+ * or an intersection of schemas. A model provider refuses the whole request
+ * when one tool's input is otherwise (Bedrock and the Anthropic API: "input_schema
+ * does not support oneOf, allOf, or anyOf at the top level"), so one such action
+ * takes down every turn its surface is offered in. Alternatives belong inside a
+ * property, and a value's own form is checked when the action runs.
+ */
+export declare function toolInputProblems(schema: unknown): string[];
+/** Deterministic JSON: object keys sorted, so the same value always gives the same bytes. */
+export declare function stableStringify(value: unknown, indent?: number): string;
+/**
+ * Why `value` does not satisfy `schema`, or null. Covers what controls and
+ * room fields declare: type, enum, const, range, length, pattern, required
+ * properties, array items (and their uniqueness), dates, and `anyOf`/`oneOf`
+ * alternatives.
+ */
+export declare function validateValue(schema: JsonSchema, value: unknown, path?: string): string | null;
+//# sourceMappingURL=json-schema.d.ts.map

package/dist/json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../src/json-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEpE;;;GAGG;AACH,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC;AAK3C;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CA4B3E;AAED,6FAA6F;AAC7F,eAAO,MAAM,oBAAoB,sCAAuC,CAAC;AAEzE;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,CAmB3D;AAED,6FAA6F;AAC7F,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,SAAI,GAAG,MAAM,CAElE;AAeD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,SAAU,GAAG,MAAM,GAAG,IAAI,CAoE/F"}

package/dist/json-schema.js

@@ -0,0 +1,196 @@
+const typesOf = (schema) => schema.type === undefined ? [] : typeof schema.type === 'string' ? [schema.type] : schema.type;
+/**
+ * Whether `live` asks for no more than `declared` does: the same type, a range
+ * inside the declared one, options drawn from the declared options, and the
+ * same properties. A live control may narrow what the build declared (the
+ * options loaded from the API today) but never widen it or change its type,
+ * because the build's declaration is what was reviewed.
+ */
+export function isNarrowing(live, declared) {
+    const liveTypes = typesOf(live);
+    const declaredTypes = typesOf(declared);
+    if (declaredTypes.length > 0 && !liveTypes.every(t => declaredTypes.includes(t)))
+        return false;
+    if (declaredTypes.length > 0 && liveTypes.length === 0)
+        return false;
+    if (declared.minimum !== undefined && (live.minimum === undefined || live.minimum < declared.minimum))
+        return false;
+    if (declared.maximum !== undefined && (live.maximum === undefined || live.maximum > declared.maximum))
+        return false;
+    if (declared.enum !== undefined) {
+        if (live.enum === undefined || !live.enum.every(v => declared.enum.includes(v)))
+            return false;
+    }
+    if (declared.const !== undefined && live.const !== declared.const)
+        return false;
+    if (declared.properties || live.properties) {
+        const declaredProps = declared.properties ?? {};
+        const liveProps = live.properties ?? {};
+        for (const key of Object.keys(liveProps)) {
+            if (!(key in declaredProps))
+                return false;
+            if (!isNarrowing(liveProps[key], declaredProps[key]))
+                return false;
+        }
+        for (const key of declared.required ?? []) {
+            if (!(key in liveProps))
+                return false;
+        }
+    }
+    if (declared.items && live.items && !isNarrowing(live.items, declared.items))
+        return false;
+    return true;
+}
+/** The keywords that combine schemas, which a tool's input may not have at its top level. */
+export const TOOL_INPUT_COMBINERS = ['oneOf', 'anyOf', 'allOf'];
+/**
+ * Why `schema` cannot be a tool's input, or none. A tool's input is one JSON
+ * object schema: its type is `"object"` and only that, and it is not a union
+ * or an intersection of schemas. A model provider refuses the whole request
+ * when one tool's input is otherwise (Bedrock and the Anthropic API: "input_schema
+ * does not support oneOf, allOf, or anyOf at the top level"), so one such action
+ * takes down every turn its surface is offered in. Alternatives belong inside a
+ * property, and a value's own form is checked when the action runs.
+ */
+export function toolInputProblems(schema) {
+    if (!schema || typeof schema !== 'object' || Array.isArray(schema))
+        return ['its input is not a JSON schema object'];
+    const record = schema;
+    const problems = [];
+    if (record.type !== 'object') {
+        problems.push(record.type === undefined
+            ? 'its input has no type; a tool’s input must be "type": "object"'
+            : `its input's type is ${JSON.stringify(record.type)}; a tool’s input must be "type": "object"`);
+    }
+    for (const keyword of TOOL_INPUT_COMBINERS) {
+        if (keyword in record) {
+            problems.push(`its input has ${keyword} at the top level, which model providers refuse; put the alternatives inside a property and check them when it runs`);
+        }
+    }
+    return problems;
+}
+/** Deterministic JSON: object keys sorted, so the same value always gives the same bytes. */
+export function stableStringify(value, indent = 2) {
+    return JSON.stringify(sortKeys(value), null, indent);
+}
+function sortKeys(value) {
+    if (Array.isArray(value))
+        return value.map(sortKeys);
+    if (value && typeof value === 'object') {
+        const out = {};
+        for (const key of Object.keys(value).sort()) {
+            const v = value[key];
+            if (v !== undefined)
+                out[key] = sortKeys(v);
+        }
+        return out;
+    }
+    return value;
+}
+/**
+ * Why `value` does not satisfy `schema`, or null. Covers what controls and
+ * room fields declare: type, enum, const, range, length, pattern, required
+ * properties, array items (and their uniqueness), dates, and `anyOf`/`oneOf`
+ * alternatives.
+ */
+export function validateValue(schema, value, path = 'value') {
+    const alternatives = schema.anyOf ?? schema.oneOf;
+    if (alternatives) {
+        const problems = alternatives.map(s => validateValue(s, value, path));
+        return problems.some(p => p === null)
+            ? null
+            : `${path} matches none of the accepted forms (${problems.join('; ')})`;
+    }
+    const types = typesOf(schema);
+    if (types.length > 0 && !types.some(t => isType(t, value))) {
+        return `${path} must be ${types.join(' or ')}`;
+    }
+    if (schema.enum && !schema.enum.includes(value)) {
+        return `${path} must be one of ${schema.enum.map(v => JSON.stringify(v)).join(', ')}`;
+    }
+    if (schema.const !== undefined && value !== schema.const)
+        return `${path} must be ${JSON.stringify(schema.const)}`;
+    if (typeof value === 'number') {
+        if (schema.minimum !== undefined && value < schema.minimum)
+            return `${path} must be at least ${schema.minimum}`;
+        if (schema.maximum !== undefined && value > schema.maximum)
+            return `${path} must be at most ${schema.maximum}`;
+    }
+    if (typeof value === 'string') {
+        if (schema.minLength !== undefined && value.length < schema.minLength) {
+            return `${path} must be at least ${schema.minLength} characters`;
+        }
+        if (schema.maxLength !== undefined && value.length > schema.maxLength) {
+            return `${path} must be at most ${schema.maxLength} characters`;
+        }
+        if (schema.pattern !== undefined && !new RegExp(schema.pattern).test(value)) {
+            return `${path} must match ${schema.pattern}`;
+        }
+        if (schema.format === 'date' && !isCalendarDate(value))
+            return `${path} must be a date, YYYY-MM-DD`;
+    }
+    if (Array.isArray(value)) {
+        if (schema.minItems !== undefined && value.length < schema.minItems)
+            return `${path} needs at least ${schema.minItems} items`;
+        if (schema.maxItems !== undefined && value.length > schema.maxItems)
+            return `${path} takes at most ${schema.maxItems} items`;
+        if (schema.uniqueItems && new Set(value.map(v => JSON.stringify(v))).size !== value.length)
+            return `${path} lists an item twice`;
+        if (schema.items) {
+            for (const [i, item] of value.entries()) {
+                const problem = validateValue(schema.items, item, `${path}[${i}]`);
+                if (problem)
+                    return problem;
+            }
+        }
+    }
+    if (value && typeof value === 'object' && !Array.isArray(value)) {
+        const record = value;
+        for (const key of schema.required ?? []) {
+            if (record[key] === undefined)
+                return `${path}.${key} is required`;
+        }
+        for (const [key, v] of Object.entries(record)) {
+            const prop = schema.properties?.[key];
+            if (prop) {
+                const problem = validateValue(prop, v, `${path}.${key}`);
+                if (problem)
+                    return problem;
+            }
+            else if (schema.additionalProperties === false) {
+                return `${path} has no property "${key}"`;
+            }
+            else if (schema.additionalProperties && typeof schema.additionalProperties === 'object') {
+                const problem = validateValue(schema.additionalProperties, v, `${path}.${key}`);
+                if (problem)
+                    return problem;
+            }
+        }
+    }
+    return null;
+}
+/** A real day written YYYY-MM-DD: 2026-02-30 is not one. */
+function isCalendarDate(value) {
+    const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value);
+    if (!m)
+        return false;
+    const date = new Date(Date.UTC(Number(m[1]), Number(m[2]) - 1, Number(m[3])));
+    return date.toISOString().slice(0, 10) === value;
+}
+function isType(type, value) {
+    switch (type) {
+        case 'null':
+            return value === null;
+        case 'array':
+            return Array.isArray(value);
+        case 'object':
+            return !!value && typeof value === 'object' && !Array.isArray(value);
+        case 'integer':
+            return typeof value === 'number' && Number.isInteger(value);
+        case 'number':
+            return typeof value === 'number' && Number.isFinite(value);
+        default:
+            return typeof value === type;
+    }
+}
+//# sourceMappingURL=json-schema.js.map

package/dist/json-schema.js.map

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

package/dist/jsx.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `agent` on JSX, for an app with tier 2 bound modules (ADR-0226 §2.3). A
+ * bound export keeps the third-party component's own type, generics and
+ * polymorphism included, so `agent` cannot be one of its props; every bound
+ * module imports this entry instead, the way a styling library adds `css`.
+ * Only apps with a bound module import it. The generator holds every `agent`
+ * to the control it is on.
+ */
+import type { AgentAttribute } from './tier2-react.js';
+declare module 'react' {
+    namespace JSX {
+        interface IntrinsicAttributes {
+            /** The assistant's binding of a bound control (ADR-0226 §2.3). */
+            agent?: AgentAttribute;
+        }
+    }
+}
+export {};
+//# sourceMappingURL=jsx.d.ts.map

package/dist/jsx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx.d.ts","sourceRoot":"","sources":["../src/jsx.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,QAAQ,OAAO,CAAC;IAGrB,UAAU,GAAG,CAAC;QACZ,UAAU,mBAAmB;YAC3B,kEAAkE;YAClE,KAAK,CAAC,EAAE,cAAc,CAAC;SACxB;KACF;CACF;AAED,OAAO,EAAE,CAAC"}

package/dist/jsx.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=jsx.js.map

package/dist/jsx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx.js","sourceRoot":"","sources":["../src/jsx.ts"],"names":[],"mappings":""}