@ouispec/contract 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Closure Studio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,10 @@
+# @ouispec/contract
+
+The OUI integrator contract (ADR-0226 §3): the JSON Schemas a product builds against, versioned together by `MANIFEST_VERSION`, the TypeScript types generated from them, a validator, and the [integrator guide](INTEGRATOR-GUIDE.md).
+
+- `schemas/*.json` — the authority. Each `$id` is `https://schemas.closurestudio.ai/oui/v<major>/<file>`; the event declarations keep their own `…/agent-sdk/event-declarations/v1.json`. Published as `@ouispec/contract/schemas/<file>`.
+- `@ouispec/contract` — the generated types (`ControlTableFile`, `AgentBinding`, `OuiManifest`, `Approvals`' messages, …), `MANIFEST_VERSION`, and every schema as a value (`CONTRACT_SCHEMAS`).
+- `@ouispec/contract/validate` — `contractProblems(ref, value)`, by file or by type name.
+- `@ouispec/contract/codegen` — the one schema-to-TypeScript renderer, also used for a product's event payload types.
+
+Edit a schema or a `guide/` section, then `pnpm generate`: it rewrites `src/generated/` and `INTEGRATOR-GUIDE.md`. `pnpm build` fails when either is stale.

package/dist/codegen.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @ouispec/contract/codegen — TypeScript from JSON Schema.
+ *
+ * One renderer for every type the platform generates from a schema: the
+ * contract's own types (this package's `src/generated/contract.ts`) and a
+ * product's event payload types (`@ouispec/agent-events/codegen`).
+ * The schema is the authority and the types follow it, never the other way
+ * round.
+ *
+ * It renders the keywords that shape a value (`$ref`, `const`, `enum`,
+ * `type`, `properties`, `required`, `additionalProperties`, `items`, `allOf`,
+ * `anyOf`, `oneOf`) and treats the rest as validation only. Where JSON Schema
+ * cannot say what TypeScript can (a template literal, `keyof`), a schema
+ * states the type in its `$comment` as `ts: <type>`, which every validator
+ * ignores.
+ */
+/** The schema keywords the renderer reads. Any other keyword is validation only. */
+export interface RenderableSchema {
+    $ref?: string;
+    $comment?: string;
+    type?: string | readonly string[];
+    description?: string;
+    const?: unknown;
+    enum?: readonly unknown[];
+    properties?: Readonly<Record<string, RenderableSchema>>;
+    required?: readonly string[];
+    additionalProperties?: boolean | RenderableSchema;
+    items?: RenderableSchema;
+    allOf?: readonly RenderableSchema[];
+    anyOf?: readonly RenderableSchema[];
+    oneOf?: readonly RenderableSchema[];
+    [keyword: string]: unknown;
+}
+export interface RenderOptions {
+    /** The type name a `$ref` names. Throws for one that names nothing. */
+    refName(ref: string): string;
+    /**
+     * How an array renders: `Array<T>`, or `readonly T[]` for a contract whose
+     * values are read, never changed, by whoever receives them. Default `Array`.
+     */
+    arrays?: 'Array' | 'readonly';
+    /**
+     * An object with no properties of its own but a schema for every other key:
+     * as an index signature member (`{ [key: string]: T }`), or as
+     * `Readonly<Record<string, T>>`. Default `index`.
+     */
+    maps?: 'index' | 'Record';
+    /**
+     * The index signature of an object that has both properties and a schema
+     * for every other key: `unknown`, or every type a key can hold (TypeScript
+     * requires each property to fit it). Default `unknown`.
+     */
+    indexSignature?: 'unknown' | 'union';
+}
+/** A property name as TypeScript writes it: bare when it can be, quoted otherwise. */
+export declare const propertyKey: (name: string) => string;
+/** A JSON value as a TypeScript literal type. */
+export declare const literal: (value: unknown) => string;
+/** A doc comment, wrapped to 96 columns, or nothing when there is no text. */
+export declare function doc(text: string | undefined, indent: string): string;
+/** The type a schema states in its `$comment`, if it states one. */
+export declare function statedType(schema: RenderableSchema): string | null;
+/** A schema as a TypeScript type expression. */
+export declare function renderType(schema: RenderableSchema, indent: string, options: RenderOptions): string;
+/** The members of an object schema, one per line. */
+export declare function renderMembers(schema: RenderableSchema, indent: string, options: RenderOptions): string;
+/** An object schema as an object type. */
+export declare function renderObject(schema: RenderableSchema, indent: string, options: RenderOptions): string;
+/** One named type: an alias, an interface, or an interface extending its `$ref`s. */
+export declare function renderNamed(name: string, schema: RenderableSchema, description: string | undefined, options: RenderOptions): string;
+//# sourceMappingURL=codegen.d.ts.map

package/dist/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,oFAAoF;AACpF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,oBAAoB,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;IAClD,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,KAAK,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACpC,KAAK,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACpC,KAAK,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACpC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC9B;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B;;;;OAIG;IACH,cAAc,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;CACtC;AAKD,sFAAsF;AACtF,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,MAAsD,CAAC;AAElG,iDAAiD;AACjD,eAAO,MAAM,OAAO,GAAI,OAAO,OAAO,KAAG,MACqE,CAAC;AAe/G,8EAA8E;AAC9E,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAapE;AAED,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAElE;AAmBD,gDAAgD;AAChD,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAoCnG;AAKD,qDAAqD;AACrD,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAuBtG;AAED,0CAA0C;AAC1C,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAarG;AAED,qFAAqF;AACrF,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,gBAAgB,EACxB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,OAAO,EAAE,aAAa,GACrB,MAAM,CAyBR"}

package/dist/codegen.js

@@ -0,0 +1,195 @@
+/**
+ * @ouispec/contract/codegen — TypeScript from JSON Schema.
+ *
+ * One renderer for every type the platform generates from a schema: the
+ * contract's own types (this package's `src/generated/contract.ts`) and a
+ * product's event payload types (`@ouispec/agent-events/codegen`).
+ * The schema is the authority and the types follow it, never the other way
+ * round.
+ *
+ * It renders the keywords that shape a value (`$ref`, `const`, `enum`,
+ * `type`, `properties`, `required`, `additionalProperties`, `items`, `allOf`,
+ * `anyOf`, `oneOf`) and treats the rest as validation only. Where JSON Schema
+ * cannot say what TypeScript can (a template literal, `keyof`), a schema
+ * states the type in its `$comment` as `ts: <type>`, which every validator
+ * ignores.
+ */
+const IDENTIFIER = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+const TS_COMMENT = /^ts:\s*(.+)$/s;
+/** A property name as TypeScript writes it: bare when it can be, quoted otherwise. */
+export const propertyKey = (name) => (IDENTIFIER.test(name) ? name : `'${name}'`);
+/** A JSON value as a TypeScript literal type. */
+export const literal = (value) => typeof value === 'string' ? `'${value.replace(/\\/g, '\\\\').replace(/'/g, "\\'")}'` : JSON.stringify(value);
+/** Break a paragraph into lines of at most `width` characters, at spaces. */
+function wrap(paragraph, width) {
+    const lines = [];
+    let line = '';
+    for (const word of paragraph.split(' ')) {
+        if (line && line.length + 1 + word.length > width) {
+            lines.push(line);
+            line = word;
+        }
+        else
+            line = line ? `${line} ${word}` : word;
+    }
+    return [...lines, line];
+}
+/** A doc comment, wrapped to 96 columns, or nothing when there is no text. */
+export function doc(text, indent) {
+    if (!text)
+        return '';
+    const width = 96 - indent.length;
+    const safe = text.replace(/\*\//g, '*\\/');
+    if (!safe.includes('\n') && safe.length <= width - 7)
+        return `${indent}/** ${safe} */\n`;
+    // Tables and fenced code keep their lines; prose wraps.
+    let fenced = false;
+    const lines = safe.split('\n').flatMap((p) => {
+        if (p.startsWith('```'))
+            fenced = !fenced;
+        if (fenced || p.startsWith('```') || p.startsWith('|'))
+            return [p];
+        return p ? wrap(p, width - 3) : [''];
+    });
+    return `${indent}/**\n${lines.map((l) => `${indent} *${l ? ` ${l}` : ''}`).join('\n')}\n${indent} */\n`;
+}
+/** The type a schema states in its `$comment`, if it states one. */
+export function statedType(schema) {
+    return typeof schema.$comment === 'string' ? (TS_COMMENT.exec(schema.$comment.trim())?.[1].trim() ?? null) : null;
+}
+/** Whether a type expression has a `|` or `&` outside any brackets, so it needs parentheses as an element type. */
+function isCompound(type) {
+    let depth = 0;
+    for (let i = 0; i < type.length; i++) {
+        const c = type[i];
+        if (c === '{' || c === '(' || c === '<' || c === '[')
+            depth++;
+        else if (c === '}' || c === ')' || c === '>' || c === ']')
+            depth--;
+        else if (depth === 0 && (c === '|' || c === '&') && type[i - 1] === ' ')
+            return true;
+    }
+    return false;
+}
+function arrayOf(element, options) {
+    if ((options.arrays ?? 'Array') === 'Array')
+        return `Array<${element}>`;
+    return `readonly ${isCompound(element) ? `(${element})` : element}[]`;
+}
+/** A schema as a TypeScript type expression. */
+export function renderType(schema, indent, options) {
+    const stated = statedType(schema);
+    if (stated)
+        return stated;
+    if (typeof schema.$ref === 'string')
+        return options.refName(schema.$ref);
+    if ('const' in schema)
+        return literal(schema.const);
+    if (schema.enum)
+        return schema.enum.map(literal).join(' | ');
+    if (schema.allOf?.length) {
+        const parts = schema.allOf.map((s) => renderType(s, indent, options));
+        const own = schema.properties ? [renderObject(schema, indent, options)] : [];
+        return [...parts, ...own].join(' & ');
+    }
+    const union = schema.anyOf ?? schema.oneOf;
+    if (union)
+        return union.map((s) => renderType(s, indent, options)).join(' | ');
+    const types = schema.type === undefined ? [] : Array.isArray(schema.type) ? schema.type : [schema.type];
+    if (types.length === 0)
+        return schema.properties ? renderObject(schema, indent, options) : 'unknown';
+    return types
+        .map((type) => {
+        switch (type) {
+            case 'string':
+                return 'string';
+            case 'number':
+            case 'integer':
+                return 'number';
+            case 'boolean':
+                return 'boolean';
+            case 'null':
+                return 'null';
+            case 'array':
+                return schema.items ? arrayOf(renderType(schema.items, indent, options), options) : arrayOf('unknown', options).replace('Array<unknown>', 'unknown[]');
+            case 'object':
+                return schema.properties || schema.additionalProperties ? renderObject(schema, indent, options) : 'Record<string, unknown>';
+            default:
+                return 'unknown';
+        }
+    })
+        .join(' | ');
+}
+const isOpen = (extra) => extra === true || (!!extra && typeof extra === 'object' && Object.keys(extra).length === 0);
+/** The members of an object schema, one per line. */
+export function renderMembers(schema, indent, options) {
+    const required = new Set(schema.required ?? []);
+    let out = '';
+    const held = [];
+    let optional = false;
+    for (const [name, prop] of Object.entries(schema.properties ?? {})) {
+        const type = renderType(prop, indent, options);
+        held.push(type);
+        if (!required.has(name))
+            optional = true;
+        out += doc(prop.description, indent);
+        out += `${indent}${propertyKey(name)}${required.has(name) ? '' : '?'}: ${type};\n`;
+    }
+    const extra = schema.additionalProperties;
+    if (isOpen(extra)) {
+        out += `${indent}[key: string]: unknown;\n`;
+    }
+    else if (extra && typeof extra === 'object') {
+        let index;
+        if (!schema.properties)
+            index = renderType(extra, indent, options);
+        else if ((options.indexSignature ?? 'unknown') === 'unknown')
+            index = 'unknown';
+        else
+            index = [...new Set([renderType(extra, indent, options), ...held, ...(optional ? ['undefined'] : [])])].join(' | ');
+        out += `${indent}[key: string]: ${index};\n`;
+    }
+    return out;
+}
+/** An object schema as an object type. */
+export function renderObject(schema, indent, options) {
+    const extra = schema.additionalProperties;
+    if (options.maps === 'Record' &&
+        !schema.properties &&
+        extra !== undefined &&
+        extra !== false) {
+        return `Readonly<Record<string, ${isOpen(extra) ? 'unknown' : renderType(extra, indent, options)}>>`;
+    }
+    const inner = `${indent}  `;
+    const members = renderMembers(schema, inner, options);
+    return members ? `{\n${members}${indent}}` : 'Record<string, never>';
+}
+/** One named type: an alias, an interface, or an interface extending its `$ref`s. */
+export function renderNamed(name, schema, description, options) {
+    const head = doc(description ?? schema.description, '');
+    const stated = statedType(schema);
+    if (stated)
+        return `${head}export type ${name} = ${stated};\n`;
+    const onlyRef = typeof schema.$ref === 'string' && !schema.properties && !schema.allOf;
+    if (onlyRef)
+        return `${head}export type ${name} = ${options.refName(schema.$ref)};\n`;
+    const parts = schema.allOf ?? [];
+    const isRefPart = (p) => typeof p.$ref === 'string' && Object.keys(p).every((k) => k === '$ref' || k === 'description');
+    const refs = parts.filter(isRefPart).map((p) => options.refName(p.$ref));
+    const rest = parts.filter((p) => !isRefPart(p));
+    const own = {
+        properties: { ...Object.assign({}, ...rest.map((p) => p.properties ?? {})), ...schema.properties },
+        required: [...rest.flatMap((p) => p.required ?? []), ...(schema.required ?? [])],
+        additionalProperties: schema.additionalProperties ?? rest.find((p) => p.additionalProperties !== undefined)?.additionalProperties,
+    };
+    const isObject = schema.type === 'object' || refs.length > 0 || rest.length > 0 || !!schema.properties;
+    if (!isObject || schema.anyOf || schema.oneOf || rest.some((p) => p.anyOf || p.oneOf || p.$ref)) {
+        return `${head}export type ${name} = ${renderType(schema, '', options)};\n`;
+    }
+    if (options.maps === 'Record' && !schema.properties && refs.length === 0 && rest.length === 0) {
+        return `${head}export type ${name} = ${renderObject(schema, '', options)};\n`;
+    }
+    const members = renderMembers(own, '  ', options);
+    return `${head}export interface ${name}${refs.length ? ` extends ${refs.join(', ')}` : ''} {\n${members}}\n`;
+}
+//# sourceMappingURL=codegen.js.map

package/dist/codegen.js.map

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