@clowder-ai/plugin-contract 0.1.0-beta.8 → 0.2.0

package/dist/validation/messaging-wire.d.ts

@@ -0,0 +1,42 @@
+import type { AppendInput, AppendResult, DeliverInput, DeliverResult, MediaReadInput, MediaReadResult, ReadInput, ReadResult, SendInput, SendResult, MessagingAckRequest, MessagingAckResult, SnapshotInput, SnapshotResult, SubscribeInput, SubscribeResult } from '../wire/row-shapes.js';
+export interface MessagingRowValidationError {
+    readonly instancePath: string;
+    readonly schemaPath: string;
+    readonly keyword: string;
+    readonly message: string;
+}
+export type MessagingRowValidationResult<Value> = {
+    readonly valid: true;
+    readonly value: Value;
+    readonly errors: readonly [];
+} | {
+    readonly valid: false;
+    readonly errors: readonly MessagingRowValidationError[];
+};
+export declare const MESSAGING_ROW_METHODS: readonly ["messaging.send", "messaging.appendElements", "messaging.subscribe", "messaging.read", "messaging.ack", "messaging.snapshot", "streams.read", "host.messaging.deliver"];
+export type MessagingRowMethod = (typeof MESSAGING_ROW_METHODS)[number];
+export interface MessagingRowInputByMethod {
+    readonly 'messaging.send': SendInput;
+    readonly 'messaging.appendElements': AppendInput;
+    readonly 'messaging.subscribe': SubscribeInput;
+    readonly 'messaging.read': ReadInput;
+    readonly 'messaging.ack': MessagingAckRequest;
+    readonly 'messaging.snapshot': SnapshotInput;
+    readonly 'streams.read': MediaReadInput;
+    readonly 'host.messaging.deliver': DeliverInput;
+}
+export interface MessagingRowResultByMethod {
+    readonly 'messaging.send': SendResult;
+    readonly 'messaging.appendElements': AppendResult;
+    readonly 'messaging.subscribe': SubscribeResult;
+    readonly 'messaging.read': ReadResult;
+    readonly 'messaging.ack': MessagingAckResult;
+    readonly 'messaging.snapshot': SnapshotResult;
+    readonly 'streams.read': MediaReadResult;
+    readonly 'host.messaging.deliver': DeliverResult;
+}
+export declare function validateMessagingRowInput<Method extends MessagingRowMethod>(method: Method, value: unknown): MessagingRowValidationResult<MessagingRowInputByMethod[Method]>;
+export declare function validateMessagingRowResult<Method extends MessagingRowMethod>(method: Method, value: unknown): MessagingRowValidationResult<MessagingRowResultByMethod[Method]>;
+export declare function isPluginDeliveryInput(value: unknown): value is import('../generated/contract.generated.js').PluginDeliveryInput;
+export declare function isPluginDeliveryReceipt(value: unknown): value is import('../generated/contract.generated.js').PluginDeliveryReceipt;
+//# sourceMappingURL=messaging-wire.d.ts.map

package/dist/validation/messaging-wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging-wire.d.ts","sourceRoot":"","sources":["../../src/validation/messaging-wire.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,EACd,eAAe,EACf,SAAS,EACT,UAAU,EACV,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,cAAc,EACd,eAAe,EAChB,MAAM,uBAAuB,CAAC;AA+B/B,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,4BAA4B,CAAC,KAAK,IAC1C;IAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,CAAA;CAAE,GAC7E;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,2BAA2B,EAAE,CAAA;CAAE,CAAC;AAEvF,eAAO,MAAM,qBAAqB,mLASxB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,CAAC;IACrC,QAAQ,CAAC,0BAA0B,EAAE,WAAW,CAAC;IACjD,QAAQ,CAAC,qBAAqB,EAAE,cAAc,CAAC;IAC/C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,mBAAmB,CAAC;IAC9C,QAAQ,CAAC,oBAAoB,EAAE,aAAa,CAAC;IAC7C,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,wBAAwB,EAAE,YAAY,CAAC;CACjD;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,gBAAgB,EAAE,UAAU,CAAC;IACtC,QAAQ,CAAC,0BAA0B,EAAE,YAAY,CAAC;IAClD,QAAQ,CAAC,qBAAqB,EAAE,eAAe,CAAC;IAChD,QAAQ,CAAC,gBAAgB,EAAE,UAAU,CAAC;IACtC,QAAQ,CAAC,eAAe,EAAE,kBAAkB,CAAC;IAC7C,QAAQ,CAAC,oBAAoB,EAAE,cAAc,CAAC;IAC9C,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAC;IACzC,QAAQ,CAAC,wBAAwB,EAAE,aAAa,CAAC;CAClD;AAwKD,wBAAgB,yBAAyB,CAAC,MAAM,SAAS,kBAAkB,EACzE,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,GACb,4BAA4B,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAEjE;AAED,wBAAgB,0BAA0B,CAAC,MAAM,SAAS,kBAAkB,EAC1E,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,GACb,4BAA4B,CAAC,0BAA0B,CAAC,MAAM,CAAC,CAAC,CAiBlE;AAID,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,oCAAoC,EAAE,mBAAmB,CAI/H;AACD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,oCAAoC,EAAE,qBAAqB,CAEnI"}

package/dist/validation/messaging-wire.js

@@ -0,0 +1,184 @@
+import { createRequire } from 'node:module';
+import { validateMessagingSemantics } from './messaging-semantic.js';
+const require = createRequire(import.meta.url);
+const Ajv2020 = require('ajv/dist/2020');
+const addFormats = require('ajv-formats');
+const messagingSchema = require('@clowder-ai/plugin-contract/schemas/messaging');
+export const MESSAGING_ROW_METHODS = [
+    'messaging.send',
+    'messaging.appendElements',
+    'messaging.subscribe',
+    'messaging.read',
+    'messaging.ack',
+    'messaging.snapshot',
+    'streams.read',
+    'host.messaging.deliver',
+];
+const ajv = new Ajv2020({ allErrors: true, strict: false });
+addFormats(ajv);
+ajv.addSchema(messagingSchema, messagingSchema['$id']);
+function validator(definition) {
+    const validate = ajv.getSchema(`${String(messagingSchema['$id'])}#/$defs/${definition}`);
+    if (!validate)
+        throw new Error(`missing messaging schema definition: ${definition}`);
+    return { definition, validate };
+}
+const INPUT_VALIDATORS = {
+    'messaging.send': validator('MessageDraft'),
+    'messaging.appendElements': validator('AppendElementsRequest'),
+    'messaging.subscribe': validator('M0CSubscribeInput'),
+    'messaging.read': validator('M0CReadInput'),
+    'messaging.ack': validator('M0CAckInput'),
+    'messaging.snapshot': validator('M0CSnapshotInput'),
+    'streams.read': validator('MediaReadInput'),
+    'host.messaging.deliver': validator('PluginDeliveryInput'),
+};
+const RESULT_VALIDATORS = {
+    'messaging.send': validator('SendReceipt'),
+    'messaging.appendElements': validator('AppendReceipt'),
+    'messaging.subscribe': validator('M0CSubscribeResult'),
+    'messaging.read': validator('M0CReadResult'),
+    'messaging.ack': validator('M0CAckResult'),
+    'messaging.snapshot': validator('M0CSnapshotResult'),
+    'streams.read': validator('MediaReadResult'),
+    'host.messaging.deliver': validator('PluginDeliveryReceipt'),
+};
+function hasOnlyUnicodeScalars(value) {
+    for (let index = 0; index < value.length; index += 1) {
+        const unit = value.charCodeAt(index);
+        if (unit >= 0xd800 && unit <= 0xdbff) {
+            const next = value.charCodeAt(index + 1);
+            if (!(next >= 0xdc00 && next <= 0xdfff))
+                return false;
+            index += 1;
+        }
+        else if (unit >= 0xdc00 && unit <= 0xdfff) {
+            return false;
+        }
+    }
+    return true;
+}
+function isJsonScalarTree(value, ancestors = new Set()) {
+    if (value === null || typeof value === 'boolean')
+        return true;
+    if (typeof value === 'string')
+        return hasOnlyUnicodeScalars(value);
+    if (typeof value === 'number')
+        return Number.isFinite(value);
+    if (typeof value !== 'object')
+        return false;
+    if (ancestors.has(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    if (!Array.isArray(value) && prototype !== Object.prototype && prototype !== null) {
+        return false;
+    }
+    if (Object.getOwnPropertySymbols(value).length > 0)
+        return false;
+    ancestors.add(value);
+    let valid = true;
+    if (Array.isArray(value)) {
+        for (let index = 0; index < value.length; index += 1) {
+            if (!Object.hasOwn(value, index) || !isJsonScalarTree(value[index], ancestors)) {
+                valid = false;
+                break;
+            }
+        }
+        if (valid) {
+            valid = Object.keys(value).every((key) => /^(0|[1-9][0-9]*)$/.test(key));
+        }
+    }
+    else {
+        for (const [key, child] of Object.entries(value)) {
+            if (!hasOnlyUnicodeScalars(key) || !isJsonScalarTree(child, ancestors)) {
+                valid = false;
+                break;
+            }
+        }
+    }
+    ancestors.delete(value);
+    return valid;
+}
+function errorsOf(validate) {
+    return (validate.errors ?? []).map((error) => ({
+        instancePath: error.instancePath,
+        schemaPath: error.schemaPath,
+        keyword: error.keyword,
+        message: error.message ?? 'messaging row validation failed',
+    }));
+}
+function invalid(instancePath, schemaPath, keyword, message) {
+    return {
+        valid: false,
+        errors: [{ instancePath, schemaPath, keyword, message }],
+    };
+}
+function validateWith(entry, value) {
+    let jsonSafe = false;
+    try {
+        jsonSafe = isJsonScalarTree(value);
+    }
+    catch {
+        jsonSafe = false;
+    }
+    if (!jsonSafe) {
+        return invalid('', `#/$defs/${entry.definition}`, 'jsonScalarTree', 'value must contain only finite JSON values and Unicode scalar strings without cycles');
+    }
+    let structurallyValid = false;
+    try {
+        structurallyValid = entry.validate(value);
+    }
+    catch {
+        structurallyValid = false;
+    }
+    if (!structurallyValid) {
+        const errors = errorsOf(entry.validate);
+        return errors.length > 0
+            ? { valid: false, errors }
+            : invalid('', `#/$defs/${entry.definition}`, 'schema', 'schema validation failed');
+    }
+    if (entry.definition === 'PluginDeliveryInput') {
+        const delivery = value;
+        if (delivery.kind === 'message' && delivery.threadId !== delivery.envelope.threadId) {
+            return invalid('/threadId', '#/$defs/PluginDeliveryInput', 'threadIdentity', 'delivery thread must match the envelope');
+        }
+    }
+    const semantic = validateMessagingSemantics(entry.definition, value);
+    if (!semantic.valid) {
+        return {
+            valid: false,
+            errors: semantic.errors.map((error) => ({
+                instancePath: error.path,
+                schemaPath: `#/$defs/${entry.definition}`,
+                keyword: 'maxEncodedBytes',
+                message: error.message,
+            })),
+        };
+    }
+    return { valid: true, value: value, errors: [] };
+}
+export function validateMessagingRowInput(method, value) {
+    return validateWith(INPUT_VALIDATORS[method], value);
+}
+export function validateMessagingRowResult(method, value) {
+    const structural = validateWith(RESULT_VALIDATORS[method], value);
+    if (!structural.valid || method !== 'messaging.send')
+        return structural;
+    const receipt = structural.value;
+    if (receipt.messageHandle.token === receipt.messageId) {
+        return invalid('/messageHandle/token', '#/$defs/SendReceipt', 'messageHandleIdentity', 'messageHandle.token must not equal messageId');
+    }
+    return structural;
+}
+const PLUGIN_DELIVERY = validator('PluginDeliveryInput');
+const PLUGIN_RECEIPT = validator('PluginDeliveryReceipt');
+export function isPluginDeliveryInput(value) {
+    if (!validateWith(PLUGIN_DELIVERY, value).valid)
+        return false;
+    const input = value;
+    return input.kind !== 'message' || input.envelope.threadId === input.threadId;
+}
+export function isPluginDeliveryReceipt(value) {
+    return PLUGIN_RECEIPT.validate(value);
+}
+//# sourceMappingURL=messaging-wire.js.map

package/dist/validation/messaging-wire.js.map

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

package/dist/validation/operation-rows.d.ts

@@ -0,0 +1,25 @@
+import type { ActionDef, OperationRows } from '../generated/contract.generated.js';
+export interface OperationRowsValidationError {
+    readonly instancePath: string;
+    readonly schemaPath: string;
+    readonly keyword: string;
+    readonly message: string;
+}
+export type OperationRowsValidationResult = {
+    readonly valid: true;
+    readonly value: OperationRows;
+    readonly errors: readonly [];
+} | {
+    readonly valid: false;
+    readonly errors: readonly OperationRowsValidationError[];
+};
+/**
+ * Validates an `OperationActionResult` with `render: 'rows'` against the manifest's
+ * row declarations of the same operation. Host fail-closed: an undeclared or
+ * non-row action reference, a duplicate row key, or any schema violation makes the
+ * whole result invalid.
+ */
+export declare function validateOperationRowsResult(operation: {
+    readonly actions: readonly ActionDef[];
+}, value: unknown): OperationRowsValidationResult;
+//# sourceMappingURL=operation-rows.d.ts.map

package/dist/validation/operation-rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-rows.d.ts","sourceRoot":"","sources":["../../src/validation/operation-rows.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAgCnF,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,6BAA6B,GACrC;IAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,CAAA;CAAE,GACrF;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,4BAA4B,EAAE,CAAA;CAAE,CAAC;AA6ExF;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAA;CAAE,EACrD,KAAK,EAAE,OAAO,GACb,6BAA6B,CAmE/B"}

package/dist/validation/operation-rows.js

@@ -0,0 +1,135 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const Ajv2020 = require('ajv/dist/2020');
+const addFormats = require('ajv-formats');
+const manifestSchema = require('@clowder-ai/plugin-contract/schemas/manifest');
+const messagingSchema = require('@clowder-ai/plugin-contract/schemas/messaging');
+const pluginMetadataSchema = require('@clowder-ai/plugin-contract/schemas/plugin-metadata');
+const signalSchema = require('@clowder-ai/plugin-contract/schemas/signals');
+const ajv = new Ajv2020({ allErrors: true, strict: false });
+addFormats(ajv);
+const schemaId = manifestSchema['$id'];
+ajv.addSchema(pluginMetadataSchema, pluginMetadataSchema['$id']);
+ajv.addSchema(signalSchema, signalSchema['$id']);
+ajv.addSchema(messagingSchema, messagingSchema['$id']);
+ajv.addSchema(manifestSchema, schemaId);
+const validateRowsShape = ajv.compile({
+    $ref: `${schemaId}#/$defs/OperationRows`,
+});
+function hasOnlyUnicodeScalars(value) {
+    for (let index = 0; index < value.length; index += 1) {
+        const unit = value.charCodeAt(index);
+        if (unit >= 0xd800 && unit <= 0xdbff) {
+            const next = value.charCodeAt(index + 1);
+            if (!(next >= 0xdc00 && next <= 0xdfff))
+                return false;
+            index += 1;
+        }
+        else if (unit >= 0xdc00 && unit <= 0xdfff) {
+            return false;
+        }
+    }
+    return true;
+}
+function isJsonScalarTree(value, ancestors = new Set()) {
+    if (value === null || typeof value === 'boolean')
+        return true;
+    if (typeof value === 'string')
+        return hasOnlyUnicodeScalars(value);
+    if (typeof value === 'number')
+        return Number.isFinite(value);
+    if (typeof value !== 'object')
+        return false;
+    if (ancestors.has(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    if (!Array.isArray(value) && prototype !== Object.prototype && prototype !== null) {
+        return false;
+    }
+    if (Object.getOwnPropertySymbols(value).length > 0)
+        return false;
+    ancestors.add(value);
+    let valid = true;
+    if (Array.isArray(value)) {
+        for (let index = 0; index < value.length; index += 1) {
+            if (!Object.hasOwn(value, index) || !isJsonScalarTree(value[index], ancestors)) {
+                valid = false;
+                break;
+            }
+        }
+        if (valid) {
+            valid = Object.keys(value).every((key) => /^(0|[1-9][0-9]*)$/.test(key));
+        }
+    }
+    else {
+        for (const [key, child] of Object.entries(value)) {
+            if (!hasOnlyUnicodeScalars(key) || !isJsonScalarTree(child, ancestors)) {
+                valid = false;
+                break;
+            }
+        }
+    }
+    ancestors.delete(value);
+    return valid;
+}
+function invalid(instancePath, schemaPath, keyword, message) {
+    return {
+        valid: false,
+        errors: [{ instancePath, schemaPath, keyword, message }],
+    };
+}
+/**
+ * Validates an `OperationActionResult` with `render: 'rows'` against the manifest's
+ * row declarations of the same operation. Host fail-closed: an undeclared or
+ * non-row action reference, a duplicate row key, or any schema violation makes the
+ * whole result invalid.
+ */
+export function validateOperationRowsResult(operation, value) {
+    let jsonSafe = false;
+    try {
+        jsonSafe = isJsonScalarTree(value);
+    }
+    catch {
+        jsonSafe = false;
+    }
+    if (!jsonSafe) {
+        return invalid('', '#/$defs/OperationRows', 'jsonScalarTree', 'value must contain only finite JSON values and Unicode scalar strings without cycles');
+    }
+    let structurallyValid = false;
+    try {
+        structurallyValid = validateRowsShape(value);
+    }
+    catch {
+        structurallyValid = false;
+    }
+    if (!structurallyValid) {
+        const errors = (validateRowsShape.errors ?? []).map((error) => ({
+            instancePath: error.instancePath,
+            schemaPath: error.schemaPath,
+            keyword: error.keyword,
+            message: error.message ?? 'operation rows validation failed',
+        }));
+        return errors.length > 0
+            ? { valid: false, errors }
+            : invalid('', '#/$defs/OperationRows', 'schema', 'schema validation failed');
+    }
+    const rows = value;
+    const rowActionIds = new Set(operation.actions.filter((action) => action.render === 'row').map((action) => action.id));
+    const seenKeys = new Set();
+    for (let rowIndex = 0; rowIndex < rows.rows.length; rowIndex += 1) {
+        const row = rows.rows[rowIndex];
+        if (seenKeys.has(row.key)) {
+            return invalid(`/rows/${rowIndex}/key`, '#/$defs/OperationRow', 'uniqueKeys', `row key must be unique within the result: ${row.key}`);
+        }
+        seenKeys.add(row.key);
+        const actions = row.actions ?? [];
+        for (let actionIndex = 0; actionIndex < actions.length; actionIndex += 1) {
+            const reference = actions[actionIndex].action;
+            if (!rowActionIds.has(reference)) {
+                return invalid(`/rows/${rowIndex}/actions/${actionIndex}/action`, '#/$defs/OperationRowAction', 'rowActionReference', `row action must reference an ActionDef with render 'row' declared in the same operation: ${reference}`);
+            }
+        }
+    }
+    return { valid: true, value: rows, errors: [] };
+}
+//# sourceMappingURL=operation-rows.js.map

package/dist/validation/operation-rows.js.map

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

package/dist/validation/signals.d.ts

@@ -0,0 +1,17 @@
+import type { SignalDeclaration } from '../generated/contract.generated.js';
+export interface SignalValidationError {
+    readonly instancePath: string;
+    readonly schemaPath: string;
+    readonly keyword: string;
+    readonly message: string;
+}
+export type SignalValidationResult<Value> = {
+    readonly valid: true;
+    readonly value: Value;
+    readonly errors: readonly [];
+} | {
+    readonly valid: false;
+    readonly errors: readonly SignalValidationError[];
+};
+export declare function validateSignalDeclaration(value: unknown): SignalValidationResult<SignalDeclaration>;
+//# sourceMappingURL=signals.d.ts.map

package/dist/validation/signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../src/validation/signals.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,iBAAiB,EAClB,MAAM,oCAAoC,CAAC;AA+B5C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,sBAAsB,CAAC,KAAK,IACpC;IAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,CAAA;CAAE,GAC7E;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,qBAAqB,EAAE,CAAA;CAAE,CAAC;AAiCjF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,GACb,sBAAsB,CAAC,iBAAiB,CAAC,CAE3C"}

package/dist/validation/signals.js

@@ -0,0 +1,32 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const Ajv2020 = require('ajv/dist/2020');
+const addFormats = require('ajv-formats');
+const signalSchema = require('@clowder-ai/plugin-contract/schemas/signals');
+const ajv = new Ajv2020({ allErrors: true, strict: false });
+addFormats(ajv);
+ajv.addSchema(signalSchema, signalSchema['$id']);
+function validator(definition) {
+    const validate = ajv.getSchema(`${String(signalSchema['$id'])}#/$defs/${definition}`);
+    if (!validate)
+        throw new Error(`missing signal schema definition: ${definition}`);
+    return validate;
+}
+const validateDeclarationSchema = validator('SignalDeclaration');
+function errorsOf(validate) {
+    return (validate.errors ?? []).map((error) => ({
+        instancePath: error.instancePath,
+        schemaPath: error.schemaPath,
+        keyword: error.keyword,
+        message: error.message ?? 'signal validation failed',
+    }));
+}
+function validateWith(validate, value) {
+    if (!validate(value))
+        return { valid: false, errors: errorsOf(validate) };
+    return { valid: true, value: value, errors: [] };
+}
+export function validateSignalDeclaration(value) {
+    return validateWith(validateDeclarationSchema, value);
+}
+//# sourceMappingURL=signals.js.map

package/dist/validation/signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.js","sourceRoot":"","sources":["../../src/validation/signals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAM5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,OAAO,GAGO,OAAO,CAAC,eAAe,CAAC,CAAC;AAC7C,MAAM,UAAU,GAA+B,OAAO,CAAC,aAAa,CAAC,CAAC;AACtE,MAAM,YAAY,GAAG,OAAO,CAAC,6CAA6C,CAGzE,CAAC;AA+BF,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5D,UAAU,CAAC,GAAG,CAAC,CAAC;AAChB,GAAG,CAAC,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC,KAAK,CAAW,CAAC,CAAC;AAE3D,SAAS,SAAS,CAAC,UAAkB;IACnC,MAAM,QAAQ,GAAG,GAAG,CAAC,SAAS,CAC5B,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,WAAW,UAAU,EAAE,CACtD,CAAC;IACF,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,UAAU,EAAE,CAAC,CAAC;IAClF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,yBAAyB,GAAG,SAAS,CAAC,mBAAmB,CAAC,CAAC;AAEjE,SAAS,QAAQ,CAAC,QAA6B;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC7C,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,0BAA0B;KACrD,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,YAAY,CACnB,QAA6B,EAC7B,KAAc;IAEd,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC1E,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAc,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,KAAc;IAEd,OAAO,YAAY,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;AACxD,CAAC"}

package/dist/variant.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Browser-safe configuration-variant resolution (configurationVariants,
+ * contractVersion 0.2.0).
+ *
+ * This module is intentionally free of any `node:` or ajv import so the same
+ * code runs in the browser (settings form) and on the server (save/readiness/
+ * runtime projection). Value matching is strict `===` against `const`/`enum`
+ * declared in each branch's constrained `when` fragment.
+ *
+ * @packageDocumentation
+ */
+import type { ConfigurationField, PluginManifest } from './generated/contract.generated.js';
+export type VariantResolution = {
+    readonly status: 'selected';
+    readonly branchId: string;
+} | {
+    readonly status: 'unselected';
+} | {
+    readonly status: 'invalid';
+    readonly value: unknown;
+};
+export interface EffectiveConfiguration {
+    readonly resolution: VariantResolution;
+    readonly effectiveValues: Record<string, unknown>;
+}
+type StoredValues = Readonly<Record<string, unknown>>;
+/**
+ * The single string→type coercion boundary (round-three review P1).
+ *
+ * Host storage and web drafts transport every scalar as a string, while the
+ * contract's requiredness (`===` against declared `const`/`enum`), branch
+ * matching, and validation schema (`type: 'boolean'` / `type: 'number'`)
+ * are strictly typed. Consumers feed raw stored/drafted strings through this
+ * function before calling any other entry point in this module, so both sides
+ * evaluate identical values without stringifying the contract's predicates.
+ *
+ * Rules, per declared non-operation field:
+ * - `boolean`: `'true'`/`'false'` become the real booleans; any other string
+ *   stays a string, so downstream validation fails closed instead of
+ *   silently coercing garbage.
+ * - `number`: a string that trims non-empty and parses to a finite number
+ *   becomes that number; anything else stays a string (same fail-closed).
+ * - every other kind (and every non-string input, which passes through
+ *   untouched) keeps its value as-is.
+ *
+ * Keys that no declared field owns are passed through unchanged.
+ */
+export declare function coerceStoredValues(manifest: PluginManifest, values: StoredValues): Record<string, unknown>;
+/**
+ * Three-state variant resolution for a stored (or drafted) configuration.
+ *
+ * - `unselected`: no discriminator value present — neither stored nor declared
+ *   as the discriminator field's `default` (or the manifest declares no
+ *   variants, preserving pre-0.2.0 behavior).
+ * - `invalid`: a discriminator value is present (stored, or a declared default)
+ *   but no branch `when` matches.
+ * - `selected`: exactly one branch matches; the first match wins if a
+ *   non-conformant manifest makes branches overlap.
+ */
+export declare function resolveConfigurationVariant(manifest: PluginManifest, values: StoredValues): VariantResolution;
+/**
+ * Computes the effective configuration: common fields (not claimed by any
+ * branch) plus, when a branch is selected, that branch's fields. Missing
+ * stored values fall back to the declared field default — consumers never
+ * depend on save-time materialization. On `unselected`/`invalid` only common
+ * fields are returned; an invalid discriminator value is kept as stored (no
+ * silent fallback to the declared default).
+ */
+export declare function computeEffectiveConfiguration(manifest: PluginManifest, storedValues: StoredValues): EffectiveConfiguration;
+/**
+ * The single source of truth for whether a field is required, given an
+ * effective (or drafted) configuration object.
+ *
+ * When `requiredWhen` is present it fully replaces the `required` flag: the
+ * field is required iff the referenced field's current value strictly
+ * (`===`, no stringification) equals one of the declared conditions. When
+ * `requiredWhen` is absent, the plain `required` flag decides. Branch
+ * membership never influences requiredness — it only decides whether a field
+ * is active at all.
+ *
+ * `values` must already be typed: pass the product of
+ * {@link computeEffectiveConfiguration} or run raw string storage/drafts
+ * through {@link coerceStoredValues} first. This function does not coerce —
+ * a string `"true"` against a declared `true` condition is *not* a match.
+ */
+export declare function evaluateFieldRequiredness(field: ConfigurationField, values: StoredValues): boolean;
+/**
+ * Compiles the manifest into a standard JSON Schema for validating the
+ * *effective* configuration object (see {@link computeEffectiveConfiguration}),
+ * not the raw stored object. Consumers must enable standard URI format validation
+ * (for Ajv, register ajv-formats before compiling).
+ * Operation controls have no scalar value and are omitted; their target-based
+ * configured state remains the responsibility of the operation consumer.
+ *
+ * - Common fields (not claimed by any branch) are constrained at the top
+ *   level: unconditionally required fields land in `required` and get a kind
+ *   constraint (e.g. `{type:'string', minLength:1}` for string-likes, so a
+ *   present `null` or empty string does not count as configured);
+ *   `requiredWhen` fields become top-level `if/then` clauses keyed on the
+ *   referenced field's runtime value.
+ * - Each branch compiles to one `oneOf` member containing the cloned `when`
+ *   fragment, the discriminator in `required`, and its active fields handled
+ *   the same way (static `required` for plain `required: true`, `if/then` for
+ *   `requiredWhen`). A field that is `requiredWhen`-gated against the
+ *   discriminator therefore stays optional in a member whose discriminator
+ *   values do not satisfy the condition — enum branches covering several
+ *   options keep working without merging values.
+ *
+ * Requiredness semantics are exactly {@link evaluateFieldRequiredness}; this
+ * schema is the ajv-executable form of that function plus kind constraints.
+ */
+export declare function buildVariantValidationSchema(manifest: PluginManifest): Record<string, unknown>;
+export {};
+//# sourceMappingURL=variant.d.ts.map

package/dist/variant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variant.d.ts","sourceRoot":"","sources":["../src/variant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAE5F,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GACjC;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAE5D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnD;AAID,KAAK,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AA8BtD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,YAAY,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBzB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,YAAY,GACnB,iBAAiB,CAsBnB;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,cAAc,EACxB,YAAY,EAAE,YAAY,GACzB,sBAAsB,CAsCxB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,YAAY,GACnB,OAAO,CAQT;AAyCD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,cAAc,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4DzB"}