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

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"}

package/dist/variant.js

@@ -0,0 +1,305 @@
+/**
+ * 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
+ */
+function matchesConstraint(constraint, value) {
+    if (typeof constraint !== 'object' || constraint === null)
+        return false;
+    const candidate = constraint;
+    if ('const' in candidate)
+        return value === candidate['const'];
+    if ('enum' in candidate && Array.isArray(candidate['enum'])) {
+        return candidate['enum'].some((option) => option === value);
+    }
+    return false;
+}
+function branchMatches(branch, discriminator, value) {
+    const properties = branch.when['properties'];
+    if (typeof properties !== 'object' || properties === null)
+        return false;
+    return matchesConstraint(properties[discriminator], value);
+}
+function fieldDefault(field) {
+    return 'default' in field ? field.default : undefined;
+}
+function effectiveFieldValue(field, storedValues) {
+    const stored = Object.hasOwn(storedValues, field.key) ? storedValues[field.key] : undefined;
+    return stored === undefined ? fieldDefault(field) : stored;
+}
+/**
+ * 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 function coerceStoredValues(manifest, values) {
+    const kinds = new Map();
+    for (const field of manifest.configuration ?? []) {
+        if (field.kind !== 'operation')
+            kinds.set(field.key, field.kind);
+    }
+    const coerced = {};
+    for (const [key, value] of Object.entries(values)) {
+        const kind = kinds.get(key);
+        if (typeof value !== 'string' || kind === undefined) {
+            coerced[key] = value;
+            continue;
+        }
+        if (kind === 'boolean') {
+            coerced[key] = value === 'true' ? true : value === 'false' ? false : value;
+            continue;
+        }
+        if (kind === 'number') {
+            const trimmed = value.trim();
+            coerced[key] = trimmed.length > 0 && Number.isFinite(Number(trimmed)) ? Number(trimmed) : value;
+            continue;
+        }
+        coerced[key] = value;
+    }
+    return coerced;
+}
+/**
+ * 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 function resolveConfigurationVariant(manifest, values) {
+    const variants = manifest.configurationVariants;
+    if (variants === undefined)
+        return { status: 'unselected' };
+    const stored = coerceStoredValues(manifest, values);
+    let value = Object.hasOwn(stored, variants.discriminator)
+        ? stored[variants.discriminator]
+        : undefined;
+    if (value === undefined) {
+        const discriminatorField = (manifest.configuration ?? []).find((field) => field.key === variants.discriminator);
+        value = discriminatorField === undefined ? undefined : fieldDefault(discriminatorField);
+    }
+    if (value === undefined)
+        return { status: 'unselected' };
+    for (const branch of variants.branches) {
+        if (branchMatches(branch, variants.discriminator, value)) {
+            return { status: 'selected', branchId: branch.id };
+        }
+    }
+    return { status: 'invalid', value };
+}
+/**
+ * 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 function computeEffectiveConfiguration(manifest, storedValues) {
+    const configuration = manifest.configuration ?? [];
+    const variants = manifest.configurationVariants;
+    const stored = coerceStoredValues(manifest, storedValues);
+    const resolution = resolveConfigurationVariant(manifest, stored);
+    const branchFieldKeys = new Set();
+    if (variants !== undefined) {
+        for (const branch of variants.branches) {
+            for (const key of branch.fields)
+                branchFieldKeys.add(key);
+        }
+    }
+    const activeBranch = resolution.status === 'selected' && variants !== undefined
+        ? variants.branches.find((branch) => branch.id === resolution.branchId)
+        : undefined;
+    const activeKeys = new Set(activeBranch?.fields ?? []);
+    const effectiveValues = {};
+    for (const field of configuration) {
+        if (field.kind === 'operation')
+            continue;
+        const isBranchField = branchFieldKeys.has(field.key);
+        const isActive = activeKeys.has(field.key);
+        if (isBranchField && !isActive)
+            continue;
+        if (resolution.status === 'invalid' &&
+            variants !== undefined &&
+            field.key === variants.discriminator) {
+            effectiveValues[field.key] = stored[field.key];
+            continue;
+        }
+        effectiveValues[field.key] = effectiveFieldValue(field, stored);
+    }
+    return { resolution, effectiveValues };
+}
+/**
+ * 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 function evaluateFieldRequiredness(field, values) {
+    const requiredWhen = field.requiredWhen;
+    if (requiredWhen === undefined)
+        return field.required === true;
+    const conditions = Array.isArray(requiredWhen.value)
+        ? requiredWhen.value
+        : [requiredWhen.value];
+    const actual = Object.hasOwn(values, requiredWhen.key) ? values[requiredWhen.key] : undefined;
+    return conditions.some((condition) => condition === actual);
+}
+function fieldValueConstraint(field) {
+    switch (field.kind) {
+        case 'string':
+        case 'secret':
+            return { type: 'string', minLength: 1, pattern: '\\S' };
+        case 'url':
+            return { type: 'string', minLength: 1, format: 'uri' };
+        case 'select':
+            return { type: 'string', enum: (field.options ?? []).map((option) => option.value) };
+        case 'number':
+            return { type: 'number' };
+        case 'boolean':
+            return { type: 'boolean' };
+        default:
+            return {};
+    }
+}
+function conditionalRequirement(field) {
+    const requiredWhen = field.requiredWhen;
+    if (requiredWhen === undefined)
+        return undefined;
+    const conditions = Array.isArray(requiredWhen.value)
+        ? requiredWhen.value
+        : [requiredWhen.value];
+    const constraint = fieldValueConstraint(field);
+    return {
+        if: {
+            properties: { [requiredWhen.key]: { enum: [...new Set(conditions)] } },
+            required: [requiredWhen.key],
+        },
+        then: {
+            required: [field.key],
+            ...(Object.keys(constraint).length > 0 ? { properties: { [field.key]: constraint } } : {}),
+        },
+    };
+}
+/**
+ * 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 function buildVariantValidationSchema(manifest) {
+    const variants = manifest.configurationVariants;
+    const configuration = manifest.configuration ?? [];
+    const configByKey = new Map();
+    for (const field of configuration)
+        configByKey.set(field.key, field);
+    const branchFieldKeys = new Set();
+    for (const branch of variants?.branches ?? []) {
+        for (const key of branch.fields)
+            branchFieldKeys.add(key);
+    }
+    const properties = {};
+    const required = [];
+    const commonConditionals = [];
+    for (const field of configuration) {
+        if (field.kind === 'operation' || branchFieldKeys.has(field.key))
+            continue;
+        const constraint = fieldValueConstraint(field);
+        if (Object.keys(constraint).length > 0)
+            properties[field.key] = constraint;
+        const conditional = conditionalRequirement(field);
+        if (conditional !== undefined) {
+            commonConditionals.push(conditional);
+        }
+        else if (field.required === true) {
+            required.push(field.key);
+        }
+    }
+    const oneOf = (variants?.branches ?? []).map((branch) => {
+        const memberProperties = structuredClone((branch.when['properties'] ?? {}));
+        const memberRequired = [variants.discriminator];
+        const memberConditionals = [];
+        for (const key of branch.fields) {
+            const field = configByKey.get(key);
+            if (field === undefined || field.kind === 'operation')
+                continue;
+            const constraint = fieldValueConstraint(field);
+            if (Object.keys(constraint).length > 0)
+                memberProperties[key] = constraint;
+            const conditional = conditionalRequirement(field);
+            if (conditional !== undefined) {
+                memberConditionals.push(conditional);
+            }
+            else if (field.required === true) {
+                memberRequired.push(key);
+            }
+        }
+        return {
+            properties: memberProperties,
+            required: memberRequired,
+            ...(memberConditionals.length > 0 ? { allOf: memberConditionals } : {}),
+        };
+    });
+    return {
+        type: 'object',
+        properties,
+        ...(required.length > 0 ? { required } : {}),
+        ...(commonConditionals.length > 0 ? { allOf: commonConditionals } : {}),
+        ...(oneOf.length > 0 ? { oneOf } : {}),
+    };
+}
+//# sourceMappingURL=variant.js.map

package/dist/variant.js.map

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

package/dist/wire/constants.d.ts

@@ -14,7 +14,8 @@ export declare const JSONRPC_VERSION: "2.0";
 /**
  * Maximum payload bytes per element payload (frozen x-clowder-bounds).
  * Open-membered payloads (MediaRefElementPayload, RichBlockElementPayload)
- * are bounded by this ceiling alone — no structural narrowing.
+ * use their contract schemas for structural narrowing. Unknown extension payloads remain
+ * open and are bounded by this ceiling.
  */
 export declare const MAX_ELEMENT_PAYLOAD_BYTES: 65536;
 /**

package/dist/wire/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/wire/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,sEAAsE;AACtE,eAAO,MAAM,eAAe,EAAG,OAAkB,CAAC;AAElD,oCAAoC;AACpC,eAAO,MAAM,YAAY,EAAG,OAAgB,CAAC;AAE7C,uDAAuD;AACvD,eAAO,MAAM,gBAAgB,EAAG,OAAgB,CAAC;AAEjD,gDAAgD;AAChD,eAAO,MAAM,eAAe,EAAG,KAAc,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAG,KAAe,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAG,MAAgB,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAG,EAAW,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAG,GAAY,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAG,EAAW,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/wire/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,sEAAsE;AACtE,eAAO,MAAM,eAAe,EAAG,OAAkB,CAAC;AAElD,oCAAoC;AACpC,eAAO,MAAM,YAAY,EAAG,OAAgB,CAAC;AAE7C,uDAAuD;AACvD,eAAO,MAAM,gBAAgB,EAAG,OAAgB,CAAC;AAEjD,gDAAgD;AAChD,eAAO,MAAM,eAAe,EAAG,KAAc,CAAC;AAE9C;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,EAAG,KAAe,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAG,MAAgB,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAG,EAAW,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAG,GAAY,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAG,EAAW,CAAC"}

package/dist/wire/constants.js

@@ -14,7 +14,8 @@ export const JSONRPC_VERSION = '2.0';
 /**
  * Maximum payload bytes per element payload (frozen x-clowder-bounds).
  * Open-membered payloads (MediaRefElementPayload, RichBlockElementPayload)
- * are bounded by this ceiling alone — no structural narrowing.
+ * use their contract schemas for structural narrowing. Unknown extension payloads remain
+ * open and are bounded by this ceiling.
  */
 export const MAX_ELEMENT_PAYLOAD_BYTES = 65_536;
 /**

package/dist/wire/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/wire/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,sEAAsE;AACtE,MAAM,CAAC,MAAM,eAAe,GAAG,SAAkB,CAAC;AAElD,oCAAoC;AACpC,MAAM,CAAC,MAAM,YAAY,GAAG,OAAgB,CAAC;AAE7C,uDAAuD;AACvD,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAgB,CAAC;AAEjD,gDAAgD;AAChD,MAAM,CAAC,MAAM,eAAe,GAAG,KAAc,CAAC;AAE9C;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAe,CAAC;AAEzD;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAgB,CAAC;AAExD;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAW,CAAC;AAEtD;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAY,CAAC;AAErD;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAW,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/wire/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,sEAAsE;AACtE,MAAM,CAAC,MAAM,eAAe,GAAG,SAAkB,CAAC;AAElD,oCAAoC;AACpC,MAAM,CAAC,MAAM,YAAY,GAAG,OAAgB,CAAC;AAE7C,uDAAuD;AACvD,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAgB,CAAC;AAEjD,gDAAgD;AAChD,MAAM,CAAC,MAAM,eAAe,GAAG,KAAc,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAe,CAAC;AAEzD;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAgB,CAAC;AAExD;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAW,CAAC;AAEtD;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAY,CAAC;AAErD;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAW,CAAC"}

package/dist/wire/dispatch.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Wire dispatch classifier — pre-dispatch frame classification per the
+ * disposition table (T-A through T-M, §3.8-1 plus beta.8 closure).
+ *
+ * This module classifies decoded NDJSON frames into one of the 13
+ * disposition classes. T-A (transport failure) and T-B (JSON parse error)
+ * are handled by the NDJSON frame decoder layer — this classifier covers
+ * T-C through T-M.
+ *
+ * A frame that passes all rejection checks returns disposition=null with
+ * outcome='accept', indicating a valid request that should be dispatched
+ * to a method handler.
+ *
+ * This module lives in @clowder-ai/plugin-contract (F202 C1: the wire
+ * frame classifier was moved here from @clowder-ai/plugin-sdk so the
+ * dependency arrow is 插件 → SDK → contract ← Host). It defines nothing
+ * new — every classification rule traces to the frozen disposition table
+ * in this package, and every key set it uses is co-located with or
+ * generated from the contract types it mirrors.
+ */
+import type { DecodedNdjsonFrame, JsonObject } from '../conformance/stdio-harness/ndjson-frame.js';
+import type { DispositionClass } from './disposition.js';
+import type { RequestSnapshot } from './disposition-fixtures.js';
+import { type WireMethodName } from './registry.js';
+export type { RequestSnapshot } from './disposition-fixtures.js';
+export interface InFlightEntry {
+    readonly method: WireMethodName;
+    readonly requestSnapshot?: RequestSnapshot;
+}
+export interface DispatchResult {
+    /** T-class from the disposition table, or null for valid requests. */
+    readonly disposition: DispositionClass | null;
+    /** Required transport action: close, respond (with error), or accept. */
+    readonly outcome: 'close' | 'respond' | 'accept';
+    /** For 'respond': the error envelope to write back as NDJSON. */
+    readonly response?: JsonObject;
+}
+/**
+ * Classify a decoded NDJSON frame into a disposition class.
+ *
+ * Covers T-C through T-M of the disposition table. T-A and T-B
+ * are handled by the NDJSON frame decoder layer.
+ *
+ * @param frame   Decoded frame with raw bytes and parsed value.
+ * @param inFlight Map of in-flight request IDs to their entry metadata.
+ * @returns The disposition result with class, outcome, and optional error response.
+ */
+export declare function classifyFrame(frame: DecodedNdjsonFrame, inFlight: ReadonlyMap<string, InFlightEntry>): DispatchResult;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/wire/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/wire/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,8CAA8C,CAAC;AAEnG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAwDjE,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AAiBvB,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;CAC5C;AAED,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC9C,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;IACjD,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;CAChC;AAwzBD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,kBAAkB,EACzB,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,GAC3C,cAAc,CAuEhB"}