@clowder-ai/plugin-contract 0.1.0-beta.1 → 0.1.0-beta.3

package/dist/wire/handshake.js

@@ -0,0 +1,70 @@
+/**
+ * Handshake types — CandidateHello, SessionBinding, BrokerReadyParams.
+ * Mechanized verbatim from #1165 frozen shape.
+ *
+ * Handshake flow:
+ *   1. Plugin sends CandidateHello (candidate claims only, no grants/session).
+ *   2. Host validates, mints instance/session ids, replies with SessionBinding.
+ *   3. Plugin sends broker.ready with the bindingNonce to activate.
+ *
+ * CandidateHello and BrokerReadyParams REJECT any additional
+ * identity/instance/grant/session fields (closed surface).
+ */
+// ---------------------------------------------------------------------------
+// Package digest constants (CLOSED — H2)
+// ---------------------------------------------------------------------------
+/** Exact character length of a sha512 SRI digest. */
+export const PACKAGE_DIGEST_LENGTH = 95;
+/**
+ * Pattern for a valid sha512 SRI package digest.
+ * 85 base64 chars + one of [AQgw] + '==' suffix.
+ */
+export const PACKAGE_DIGEST_PATTERN = /^sha512-[A-Za-z0-9+/]{85}[AQgw]==$/;
+/**
+ * Compact-JSON encoded byte count for the digest string.
+ * 95 chars (all ASCII) + 2 surrounding quotes = 97 bytes.
+ */
+export const PACKAGE_DIGEST_ENCODED_BYTES = 97;
+// ---------------------------------------------------------------------------
+// Binding nonce bounds (CLOSED — H9)
+// ---------------------------------------------------------------------------
+/** Minimum code-point length for bindingNonce. */
+export const BINDING_NONCE_MIN_LENGTH = 1;
+/** Maximum code-point length for bindingNonce. */
+export const BINDING_NONCE_MAX_LENGTH = 512;
+/**
+ * Maximum compact-JSON encoded bytes for bindingNonce.
+ * Worst case: every code point is a 6-byte escape (\uXXXX) → 6 * 512 + 2 quotes.
+ */
+export const BINDING_NONCE_MAX_ENCODED_BYTES = 3074;
+// ---------------------------------------------------------------------------
+// Validators
+// ---------------------------------------------------------------------------
+/**
+ * Validate a string as a conformant sha512 SRI package digest.
+ * Checks exact length (95) and pattern match.
+ */
+export function validatePackageDigest(value) {
+    if (value.length !== PACKAGE_DIGEST_LENGTH)
+        return false;
+    return PACKAGE_DIGEST_PATTERN.test(value);
+}
+/**
+ * Validate a string as a conformant binding nonce.
+ * Checks code-point count is within [1, 512].
+ *
+ * Note: uses spread to count code points (not .length, which counts
+ * UTF-16 code units and misreports surrogate pairs).
+ */
+export function validateBindingNonce(value) {
+    // Fast path: empty string
+    if (value.length === 0)
+        return false;
+    // Fast path: if byte length <= max, code-point count <= max
+    if (value.length <= BINDING_NONCE_MAX_LENGTH)
+        return true;
+    // Slow path: count actual code points for strings with surrogates
+    const codePointCount = [...value].length;
+    return codePointCount >= BINDING_NONCE_MIN_LENGTH && codePointCount <= BINDING_NONCE_MAX_LENGTH;
+}
+//# sourceMappingURL=handshake.js.map

package/dist/wire/handshake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handshake.js","sourceRoot":"","sources":["../../src/wire/handshake.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,8EAA8E;AAC9E,yCAAyC;AACzC,8EAA8E;AAE9E,qDAAqD;AACrD,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAW,CAAC;AAEjD;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,oCAAoC,CAAC;AAE3E;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAW,CAAC;AAExD,8EAA8E;AAC9E,qCAAqC;AACrC,8EAA8E;AAE9E,kDAAkD;AAClD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAU,CAAC;AAEnD,kDAAkD;AAClD,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAY,CAAC;AAErD;;;GAGG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,IAAa,CAAC;AAqE7D,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,IAAI,KAAK,CAAC,MAAM,KAAK,qBAAqB;QAAE,OAAO,KAAK,CAAC;IACzD,OAAO,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,0BAA0B;IAC1B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrC,4DAA4D;IAC5D,IAAI,KAAK,CAAC,MAAM,IAAI,wBAAwB;QAAE,OAAO,IAAI,CAAC;IAC1D,kEAAkE;IAClE,MAAM,cAAc,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,cAAc,IAAI,wBAAwB,IAAI,cAAc,IAAI,wBAAwB,CAAC;AAClG,CAAC"}

package/dist/wire/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Wire protocol module barrel export.
+ *
+ * Re-exports all wire-protocol types, constants, validators, and registry
+ * entries mechanized from the #1165 frozen shape (rev11).
+ *
+ * This module defines nothing new — it is a pure re-export surface.
+ */
+export { MAX_FRAME_BYTES, WIRE_VERSION, CONTRACT_VERSION, JSONRPC_VERSION, MAX_ELEMENT_PAYLOAD_BYTES, MAX_TOTAL_PAYLOAD_BYTES, MAX_ELEMENTS_PER_OPERATION, MAX_ELEMENTS_PER_MESSAGE, MAX_WHISPER_TARGETS, } from './constants.js';
+export type { RequestId } from './request-id.js';
+export { REQUEST_ID_PATTERN, REQUEST_ID_MIN_LENGTH, REQUEST_ID_MAX_LENGTH, REQUEST_ID_MIN_ENCODED_BYTES, REQUEST_ID_MAX_ENCODED_BYTES, validateRequestId, isRequestIdShaped, } from './request-id.js';
+export { WIRE_UINT53_MAX, WIRE_UINT53_RAW_PATTERN, WIRE_UINT53_MAX_RAW_LENGTH, isWireUInt53, isCanonicalUInt53Token, } from './wire-uint53.js';
+export { HANDSHAKE_REJECTED_CODE, DELIVERY_REJECTED_CODE, DOMAIN_ERROR_CODE, DEADLINE_EXPIRED_CODE, SNAPSHOT_UNAVAILABLE_CODE, HANDSHAKE_REJECTED_MESSAGE, DELIVERY_REJECTED_MESSAGE, DOMAIN_ERROR_MESSAGE, DEADLINE_EXPIRED_MESSAGE, SNAPSHOT_UNAVAILABLE_MESSAGE, PARSE_ERROR_CODE, INVALID_REQUEST_CODE, METHOD_NOT_FOUND_CODE, INVALID_PARAMS_CODE, INTERNAL_ERROR_CODE, PARSE_ERROR_MESSAGE, INVALID_REQUEST_MESSAGE, METHOD_NOT_FOUND_MESSAGE, INVALID_PARAMS_MESSAGE, INTERNAL_ERROR_MESSAGE, ERROR_CODE_TO_MESSAGE, HANDSHAKE_REJECT_REASONS, DELIVERY_REJECT_REASONS, SNAPSHOT_UNAVAILABLE_REASONS, APPLICATION_ERROR_CODES, STANDARD_ERROR_CODES, ALL_ERROR_CODES, } from './errors.js';
+export type { HandshakeRejectReason, DeliveryRejectReason, SnapshotUnavailableReason, MessagingErrorCode, HandshakeRejectedError, DeliveryRejectedError, DomainError, DeadlineExpiredError, SnapshotUnavailableError, ApplicationWireError, ParseError, InvalidRequestError, MethodNotFoundError, InvalidParamsError, InternalError, StandardWireError, WireError, } from './errors.js';
+export { DISPOSITION_CLASSES, DISPOSITION_TABLE, CLOSE_CLASSES, RESPOND_CLASSES, ACCEPT_CLASSES, } from './disposition.js';
+export type { DispositionClass, DispositionOutcome, DispositionEntry, } from './disposition.js';
+export { PACKAGE_DIGEST_LENGTH, PACKAGE_DIGEST_PATTERN, PACKAGE_DIGEST_ENCODED_BYTES, BINDING_NONCE_MIN_LENGTH, BINDING_NONCE_MAX_LENGTH, BINDING_NONCE_MAX_ENCODED_BYTES, validatePackageDigest, validateBindingNonce, } from './handshake.js';
+export type { CandidateHello, SessionBinding, BrokerReadyParams, } from './handshake.js';
+export { MAX_GRANT_ITEMS, validateEffectiveGrants, VALID_CAPABILITIES, } from './grants.js';
+export type { GrantSnapshot } from './grants.js';
+export type { CallMeta, WireSuccessResponse, HandshakeRejectedEnvelope, DeliveryRejectedEnvelope, DomainErrorEnvelope, DeadlineExpiredEnvelope, SnapshotUnavailableEnvelope, ParseErrorEnvelope, InvalidRequestNullIdEnvelope, InvalidRequestValidIdEnvelope, MethodNotFoundEnvelope, InvalidParamsEnvelope, InternalErrorEnvelope, ClosedWireErrorResponse, WireErrorResponse, WireResponse, } from './envelope.js';
+export { WIRE_METHOD_NAMES, WIRE_METHOD_REGISTRY, WIRE_METHOD_COUNT, PLUGIN_TO_HOST_METHODS, HOST_TO_PLUGIN_METHODS, NOTIFICATION_METHODS, CLOSED_LEAF_ROWS, RESERVED_LEAF_ROWS, getRegistryRow, isWireMethod, getMethodGrant, } from './registry.js';
+export type { MethodDirection, GrantRequirement, LeafClosureStatus, RegistryRow, WireMethodName, } from './registry.js';
+export type { SubscribeInput, SubscribeResult, MessagingAckRequest, MessagingAckResult, GrantsChangedInput, PingInput, PingResult, DrainInput, DrainResult, HelloInput, HelloResult, ReadyInput, ReadyResult, SendInput, SendResult, AppendInput, AppendResult, ReadInput, ReadResult, SnapshotInput, SnapshotResult, DeliverInput, DeliverResult, } from './row-shapes.js';
+export { SUBSCRIBE_HANDLE_MIN_LENGTH, SUBSCRIBE_HANDLE_MAX_LENGTH, SUBSCRIBE_HANDLE_MAX_ENCODED_BYTES, SUBSCRIBE_SUBSCRIPTION_ID_MIN_LENGTH, SUBSCRIBE_SUBSCRIPTION_ID_MAX_LENGTH, SUBSCRIBE_SUBSCRIPTION_ID_MAX_ENCODED_BYTES, ACK_SUBSCRIPTION_ID_MIN_LENGTH, ACK_SUBSCRIPTION_ID_MAX_LENGTH, ACK_SUBSCRIPTION_ID_MAX_ENCODED_BYTES, ACK_TOKEN_MIN_LENGTH, ACK_TOKEN_MAX_LENGTH, ACK_TOKEN_MAX_ENCODED_BYTES, PING_NONCE_MIN_LENGTH, PING_NONCE_MAX_LENGTH, PING_NONCE_MAX_ENCODED_BYTES, } from './row-shapes.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/wire/index.js

@@ -0,0 +1,45 @@
+/**
+ * Wire protocol module barrel export.
+ *
+ * Re-exports all wire-protocol types, constants, validators, and registry
+ * entries mechanized from the #1165 frozen shape (rev11).
+ *
+ * This module defines nothing new — it is a pure re-export surface.
+ */
+// Framing constants
+export { MAX_FRAME_BYTES, WIRE_VERSION, CONTRACT_VERSION, JSONRPC_VERSION, MAX_ELEMENT_PAYLOAD_BYTES, MAX_TOTAL_PAYLOAD_BYTES, MAX_ELEMENTS_PER_OPERATION, MAX_ELEMENTS_PER_MESSAGE, MAX_WHISPER_TARGETS, } from './constants.js';
+export { REQUEST_ID_PATTERN, REQUEST_ID_MIN_LENGTH, REQUEST_ID_MAX_LENGTH, REQUEST_ID_MIN_ENCODED_BYTES, REQUEST_ID_MAX_ENCODED_BYTES, validateRequestId, isRequestIdShaped, } from './request-id.js';
+// WireUInt53 — numeric profile
+export { WIRE_UINT53_MAX, WIRE_UINT53_RAW_PATTERN, WIRE_UINT53_MAX_RAW_LENGTH, isWireUInt53, isCanonicalUInt53Token, } from './wire-uint53.js';
+// Error codes, messages, reason taxonomies, and error variant types
+export { 
+// Application error codes
+HANDSHAKE_REJECTED_CODE, DELIVERY_REJECTED_CODE, DOMAIN_ERROR_CODE, DEADLINE_EXPIRED_CODE, SNAPSHOT_UNAVAILABLE_CODE, 
+// Application error messages
+HANDSHAKE_REJECTED_MESSAGE, DELIVERY_REJECTED_MESSAGE, DOMAIN_ERROR_MESSAGE, DEADLINE_EXPIRED_MESSAGE, SNAPSHOT_UNAVAILABLE_MESSAGE, 
+// Standard error codes
+PARSE_ERROR_CODE, INVALID_REQUEST_CODE, METHOD_NOT_FOUND_CODE, INVALID_PARAMS_CODE, INTERNAL_ERROR_CODE, 
+// Standard error messages
+PARSE_ERROR_MESSAGE, INVALID_REQUEST_MESSAGE, METHOD_NOT_FOUND_MESSAGE, INVALID_PARAMS_MESSAGE, INTERNAL_ERROR_MESSAGE, 
+// Code-to-message mapping
+ERROR_CODE_TO_MESSAGE, 
+// Reject-reason taxonomies
+HANDSHAKE_REJECT_REASONS, DELIVERY_REJECT_REASONS, SNAPSHOT_UNAVAILABLE_REASONS, 
+// Collected code arrays
+APPLICATION_ERROR_CODES, STANDARD_ERROR_CODES, ALL_ERROR_CODES, } from './errors.js';
+// Pre-dispatch disposition table
+export { DISPOSITION_CLASSES, DISPOSITION_TABLE, CLOSE_CLASSES, RESPOND_CLASSES, ACCEPT_CLASSES, } from './disposition.js';
+// Handshake types + validators
+export { PACKAGE_DIGEST_LENGTH, PACKAGE_DIGEST_PATTERN, PACKAGE_DIGEST_ENCODED_BYTES, BINDING_NONCE_MIN_LENGTH, BINDING_NONCE_MAX_LENGTH, BINDING_NONCE_MAX_ENCODED_BYTES, validatePackageDigest, validateBindingNonce, } from './handshake.js';
+// Grant snapshot
+export { MAX_GRANT_ITEMS, validateEffectiveGrants, VALID_CAPABILITIES, } from './grants.js';
+// 12-row method registry
+export { WIRE_METHOD_NAMES, WIRE_METHOD_REGISTRY, WIRE_METHOD_COUNT, PLUGIN_TO_HOST_METHODS, HOST_TO_PLUGIN_METHODS, NOTIFICATION_METHODS, CLOSED_LEAF_ROWS, RESERVED_LEAF_ROWS, getRegistryRow, isWireMethod, getMethodGrant, } from './registry.js';
+export { 
+// Row 5 bounds
+SUBSCRIBE_HANDLE_MIN_LENGTH, SUBSCRIBE_HANDLE_MAX_LENGTH, SUBSCRIBE_HANDLE_MAX_ENCODED_BYTES, SUBSCRIBE_SUBSCRIPTION_ID_MIN_LENGTH, SUBSCRIBE_SUBSCRIPTION_ID_MAX_LENGTH, SUBSCRIBE_SUBSCRIPTION_ID_MAX_ENCODED_BYTES, 
+// Row 7 bounds
+ACK_SUBSCRIPTION_ID_MIN_LENGTH, ACK_SUBSCRIPTION_ID_MAX_LENGTH, ACK_SUBSCRIPTION_ID_MAX_ENCODED_BYTES, ACK_TOKEN_MIN_LENGTH, ACK_TOKEN_MAX_LENGTH, ACK_TOKEN_MAX_ENCODED_BYTES, 
+// Row 11 bounds
+PING_NONCE_MIN_LENGTH, PING_NONCE_MAX_LENGTH, PING_NONCE_MAX_ENCODED_BYTES, } from './row-shapes.js';
+//# sourceMappingURL=index.js.map

package/dist/wire/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/wire/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,oBAAoB;AACpB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,yBAAyB,EACzB,uBAAuB,EACvB,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,4BAA4B,EAC5B,4BAA4B,EAC5B,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,+BAA+B;AAC/B,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,0BAA0B,EAC1B,YAAY,EACZ,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,oEAAoE;AACpE,OAAO;AACL,0BAA0B;AAC1B,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,yBAAyB;AACzB,6BAA6B;AAC7B,0BAA0B,EAC1B,yBAAyB,EACzB,oBAAoB,EACpB,wBAAwB,EACxB,4BAA4B;AAC5B,uBAAuB;AACvB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB;AACnB,0BAA0B;AAC1B,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB;AACtB,0BAA0B;AAC1B,qBAAqB;AACrB,2BAA2B;AAC3B,wBAAwB,EACxB,uBAAuB,EACvB,4BAA4B;AAC5B,wBAAwB;AACxB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,GAChB,MAAM,aAAa,CAAC;AAyBrB,iCAAiC;AACjC,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,kBAAkB,CAAC;AAQ1B,+BAA+B;AAC/B,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,4BAA4B,EAC5B,wBAAwB,EACxB,wBAAwB,EACxB,+BAA+B,EAC/B,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAQxB,iBAAiB;AACjB,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAkCrB,yBAAyB;AACzB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,cAAc,GACf,MAAM,eAAe,CAAC;AAuCvB,OAAO;AACL,eAAe;AACf,2BAA2B,EAC3B,2BAA2B,EAC3B,kCAAkC,EAClC,oCAAoC,EACpC,oCAAoC,EACpC,2CAA2C;AAC3C,eAAe;AACf,8BAA8B,EAC9B,8BAA8B,EAC9B,qCAAqC,EACrC,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B;AAC3B,gBAAgB;AAChB,qBAAqB,EACrB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,iBAAiB,CAAC"}

package/dist/wire/registry.d.ts

@@ -0,0 +1,90 @@
+/**
+ * 12-row production method registry.
+ * Mechanized verbatim from the #1165 frozen shape (rev11).
+ *
+ * Every row carries machine-readable metadata:
+ *   - method name, direction, grant requirement
+ *   - notification flag (only row 10)
+ *   - ready status (ALL false — reservation-only lifecycle, D0 = A)
+ *   - leaf closure status and which matrix entries cause reservation
+ *   - settlement key source
+ *
+ * A row may be marked `ready` only when its matrix entries all reach
+ * CLOSED + generated byte proofs + N/N+1 conformance pass.
+ * This module defines nothing new.
+ *
+ * ## Reserved matrix entry in-flight coordinates
+ *
+ * M7 — future-write admission half in review at clowder-ai#1185
+ *      (exact 05ad80c6, gate PASS, Fable APPROVE current HEAD);
+ *      stored-data attestation/migration half outstanding.
+ *      Affects rows 6, 8, 9. M7 remains RESERVED.
+ */
+import type { Capability } from '../generated/contract.generated.js';
+/** Message direction on the wire. */
+export type MethodDirection = 'plugin-to-host' | 'host-to-plugin';
+/** Grant required to invoke a method, or protocol-intrinsic for handshake/lifecycle. */
+export type GrantRequirement = Capability | 'protocol-intrinsic';
+/** Leaf closure status from the variable-width leaf matrix. */
+export type LeafClosureStatus = 'CLOSED' | 'RESERVED';
+/**
+ * A single row of the production method registry.
+ * ready is typed as `false` — the reservation-only lifecycle means
+ * every row is unpublished and unadvertised.
+ */
+export interface RegistryRow {
+    readonly rowNumber: number;
+    readonly method: string;
+    readonly direction: MethodDirection;
+    readonly grant: GrantRequirement;
+    readonly isNotification: boolean;
+    readonly ready: false;
+    readonly leafClosure: LeafClosureStatus;
+    readonly reservedEntries: readonly string[];
+    readonly settlementKeySource: string;
+}
+/**
+ * The exact 12 production method names, in registry order.
+ * No production method exists for fixture setup/observe, grant presets,
+ * revocation, permission-matrix inspection, or replay deletion.
+ */
+export declare const WIRE_METHOD_NAMES: readonly ["broker.hello", "broker.ready", "messaging.send", "messaging.appendElements", "messaging.subscribe", "messaging.read", "messaging.ack", "messaging.snapshot", "host.messaging.deliver", "host.grants.changed", "host.lifecycle.ping", "host.lifecycle.drain"];
+/** Union of all 12 production method names. */
+export type WireMethodName = (typeof WIRE_METHOD_NAMES)[number];
+/**
+ * Machine-readable registry of all 12 production methods.
+ *
+ * Every value traces to the #1165 frozen shape. Row metadata includes
+ * the exact matrix entry IDs that block leaf closure. Settlement key
+ * sources follow the canonical per-row specification.
+ *
+ * All 12 rows have ready=false (reservation-only lifecycle, D0 = A).
+ */
+export declare const WIRE_METHOD_REGISTRY: Readonly<Record<WireMethodName, RegistryRow>>;
+/** Plugin-to-host method names. */
+export declare const PLUGIN_TO_HOST_METHODS: readonly WireMethodName[];
+/** Host-to-plugin method names. */
+export declare const HOST_TO_PLUGIN_METHODS: readonly WireMethodName[];
+/** Notification method names (only row 10 in v0). */
+export declare const NOTIFICATION_METHODS: readonly WireMethodName[];
+/** Method names with CLOSED leaf shapes (frozen). */
+export declare const CLOSED_LEAF_ROWS: readonly WireMethodName[];
+/** Method names with RESERVED leaf shapes (may change). */
+export declare const RESERVED_LEAF_ROWS: readonly WireMethodName[];
+/** Total number of production methods. */
+export declare const WIRE_METHOD_COUNT: 12;
+/**
+ * Look up a registry row by method name.
+ * Returns undefined for unknown method names.
+ */
+export declare function getRegistryRow(method: string): RegistryRow | undefined;
+/**
+ * Check whether a method name is a valid wire method.
+ */
+export declare function isWireMethod(method: string): method is WireMethodName;
+/**
+ * Get the grant requirement for a method.
+ * Returns undefined for unknown method names.
+ */
+export declare function getMethodGrant(method: string): GrantRequirement | undefined;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/wire/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAMrE,qCAAqC;AACrC,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAElE,wFAAwF;AACxF,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,oBAAoB,CAAC;AAEjE,+DAA+D;AAC/D,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,UAAU,CAAC;AAMtD;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAMD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,yQAapB,CAAC;AAEX,+CAA+C;AAC/C,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAMhE;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,WAAW,CAAC,CAwIrE,CAAC;AAMX,mCAAmC;AACnC,eAAO,MAAM,sBAAsB,EAAE,SAAS,cAAc,EAC2B,CAAC;AAExF,mCAAmC;AACnC,eAAO,MAAM,sBAAsB,EAAE,SAAS,cAAc,EAC2B,CAAC;AAExF,qDAAqD;AACrD,eAAO,MAAM,oBAAoB,EAAE,SAAS,cAAc,EACa,CAAC;AAExE,qDAAqD;AACrD,eAAO,MAAM,gBAAgB,EAAE,SAAS,cAAc,EAC2B,CAAC;AAElF,2DAA2D;AAC3D,eAAO,MAAM,kBAAkB,EAAE,SAAS,cAAc,EAC2B,CAAC;AAEpF,0CAA0C;AAC1C,eAAO,MAAM,iBAAiB,EAAG,EAAW,CAAC;AAM7C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEtE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,cAAc,CAErE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE3E"}

package/dist/wire/registry.js

@@ -0,0 +1,232 @@
+/**
+ * 12-row production method registry.
+ * Mechanized verbatim from the #1165 frozen shape (rev11).
+ *
+ * Every row carries machine-readable metadata:
+ *   - method name, direction, grant requirement
+ *   - notification flag (only row 10)
+ *   - ready status (ALL false — reservation-only lifecycle, D0 = A)
+ *   - leaf closure status and which matrix entries cause reservation
+ *   - settlement key source
+ *
+ * A row may be marked `ready` only when its matrix entries all reach
+ * CLOSED + generated byte proofs + N/N+1 conformance pass.
+ * This module defines nothing new.
+ *
+ * ## Reserved matrix entry in-flight coordinates
+ *
+ * M7 — future-write admission half in review at clowder-ai#1185
+ *      (exact 05ad80c6, gate PASS, Fable APPROVE current HEAD);
+ *      stored-data attestation/migration half outstanding.
+ *      Affects rows 6, 8, 9. M7 remains RESERVED.
+ */
+// ---------------------------------------------------------------------------
+// Method name enum
+// ---------------------------------------------------------------------------
+/**
+ * The exact 12 production method names, in registry order.
+ * No production method exists for fixture setup/observe, grant presets,
+ * revocation, permission-matrix inspection, or replay deletion.
+ */
+export const WIRE_METHOD_NAMES = [
+    'broker.hello',
+    'broker.ready',
+    'messaging.send',
+    'messaging.appendElements',
+    'messaging.subscribe',
+    'messaging.read',
+    'messaging.ack',
+    'messaging.snapshot',
+    'host.messaging.deliver',
+    'host.grants.changed',
+    'host.lifecycle.ping',
+    'host.lifecycle.drain',
+];
+// ---------------------------------------------------------------------------
+// The complete registry (frozen)
+// ---------------------------------------------------------------------------
+/**
+ * Machine-readable registry of all 12 production methods.
+ *
+ * Every value traces to the #1165 frozen shape. Row metadata includes
+ * the exact matrix entry IDs that block leaf closure. Settlement key
+ * sources follow the canonical per-row specification.
+ *
+ * All 12 rows have ready=false (reservation-only lifecycle, D0 = A).
+ */
+export const WIRE_METHOD_REGISTRY = {
+    'broker.hello': {
+        rowNumber: 1,
+        method: 'broker.hello',
+        direction: 'plugin-to-host',
+        grant: 'protocol-intrinsic',
+        isNotification: false,
+        ready: false,
+        leafClosure: 'RESERVED',
+        reservedEntries: ['H1', 'H3', 'H4', 'H5', 'H6'],
+        settlementKeySource: '—',
+    },
+    // Row 2 own entries (H9 via W0/W1/W2/W3) are all CLOSED.
+    // RESERVED because activation cannot be advertised without a closed
+    // row-1 SessionBinding — H1/H3/H4/H5/H6 block through protocol dependency.
+    'broker.ready': {
+        rowNumber: 2,
+        method: 'broker.ready',
+        direction: 'plugin-to-host',
+        grant: 'protocol-intrinsic',
+        isNotification: false,
+        ready: false,
+        leafClosure: 'RESERVED',
+        reservedEntries: ['H1', 'H3', 'H4', 'H5', 'H6'],
+        settlementKeySource: '—',
+    },
+    'messaging.send': {
+        rowNumber: 3,
+        method: 'messaging.send',
+        direction: 'plugin-to-host',
+        grant: 'messaging.send',
+        isNotification: false,
+        ready: false,
+        leafClosure: 'RESERVED',
+        reservedEntries: ['M1', 'M2', 'M5', 'I1'],
+        settlementKeySource: 'input.idempotencyKey',
+    },
+    'messaging.appendElements': {
+        rowNumber: 4,
+        method: 'messaging.appendElements',
+        direction: 'plugin-to-host',
+        grant: 'messaging.appendElements',
+        isNotification: false,
+        ready: false,
+        leafClosure: 'RESERVED',
+        reservedEntries: ['M1', 'M2', 'M5', 'I1'],
+        settlementKeySource: '(Host-resolved messageId from input.handle, input.operationId)',
+    },
+    'messaging.subscribe': {
+        rowNumber: 5,
+        method: 'messaging.subscribe',
+        direction: 'plugin-to-host',
+        grant: 'message.event.subscribe',
+        isNotification: false,
+        ready: false,
+        leafClosure: 'CLOSED',
+        reservedEntries: [],
+        settlementKeySource: 'Host-resolved input.handle identity (K-1 create-or-get authoritative)',
+    },
+    'messaging.read': {
+        rowNumber: 6,
+        method: 'messaging.read',
+        direction: 'plugin-to-host',
+        grant: 'message.event.subscribe',
+        isNotification: false,
+        ready: false,
+        leafClosure: 'RESERVED',
+        reservedEntries: ['M1', 'M2', 'M5', 'M6', 'M7', 'I1'],
+        settlementKeySource: 'none (at-least-once; bounded page assembly)',
+    },
+    'messaging.ack': {
+        rowNumber: 7,
+        method: 'messaging.ack',
+        direction: 'plugin-to-host',
+        grant: 'message.event.subscribe',
+        isNotification: false,
+        ready: false,
+        leafClosure: 'CLOSED',
+        reservedEntries: [],
+        settlementKeySource: '(input.subscriptionId, input.ackToken)',
+    },
+    'messaging.snapshot': {
+        rowNumber: 8,
+        method: 'messaging.snapshot',
+        direction: 'plugin-to-host',
+        grant: 'message.event.subscribe',
+        isNotification: false,
+        ready: false,
+        leafClosure: 'RESERVED',
+        reservedEntries: ['M1', 'M2', 'M5', 'M7', 'I1'],
+        settlementKeySource: 'none for traversal; completion = D1b Host entitlement through messaging.ack',
+    },
+    'host.messaging.deliver': {
+        rowNumber: 9,
+        method: 'host.messaging.deliver',
+        direction: 'host-to-plugin',
+        grant: 'onMessage',
+        isNotification: false,
+        ready: false,
+        leafClosure: 'RESERVED',
+        reservedEntries: ['M1', 'M2', 'M5', 'M7', 'I1'],
+        settlementKeySource: 'input.deliveryId (Host-side authoritative)',
+    },
+    'host.grants.changed': {
+        rowNumber: 10,
+        method: 'host.grants.changed',
+        direction: 'host-to-plugin',
+        grant: 'protocol-intrinsic',
+        isNotification: true,
+        ready: false,
+        leafClosure: 'CLOSED',
+        reservedEntries: [],
+        settlementKeySource: '(grantRevision monotonic)',
+    },
+    'host.lifecycle.ping': {
+        rowNumber: 11,
+        method: 'host.lifecycle.ping',
+        direction: 'host-to-plugin',
+        grant: 'protocol-intrinsic',
+        isNotification: false,
+        ready: false,
+        leafClosure: 'CLOSED',
+        reservedEntries: [],
+        settlementKeySource: '—',
+    },
+    'host.lifecycle.drain': {
+        rowNumber: 12,
+        method: 'host.lifecycle.drain',
+        direction: 'host-to-plugin',
+        grant: 'protocol-intrinsic',
+        isNotification: false,
+        ready: false,
+        leafClosure: 'CLOSED',
+        reservedEntries: [],
+        settlementKeySource: '—',
+    },
+};
+// ---------------------------------------------------------------------------
+// Derived helpers
+// ---------------------------------------------------------------------------
+/** Plugin-to-host method names. */
+export const PLUGIN_TO_HOST_METHODS = WIRE_METHOD_NAMES.filter(m => WIRE_METHOD_REGISTRY[m].direction === 'plugin-to-host');
+/** Host-to-plugin method names. */
+export const HOST_TO_PLUGIN_METHODS = WIRE_METHOD_NAMES.filter(m => WIRE_METHOD_REGISTRY[m].direction === 'host-to-plugin');
+/** Notification method names (only row 10 in v0). */
+export const NOTIFICATION_METHODS = WIRE_METHOD_NAMES.filter(m => WIRE_METHOD_REGISTRY[m].isNotification);
+/** Method names with CLOSED leaf shapes (frozen). */
+export const CLOSED_LEAF_ROWS = WIRE_METHOD_NAMES.filter(m => WIRE_METHOD_REGISTRY[m].leafClosure === 'CLOSED');
+/** Method names with RESERVED leaf shapes (may change). */
+export const RESERVED_LEAF_ROWS = WIRE_METHOD_NAMES.filter(m => WIRE_METHOD_REGISTRY[m].leafClosure === 'RESERVED');
+/** Total number of production methods. */
+export const WIRE_METHOD_COUNT = 12;
+// ---------------------------------------------------------------------------
+// Lookup helpers
+// ---------------------------------------------------------------------------
+/**
+ * Look up a registry row by method name.
+ * Returns undefined for unknown method names.
+ */
+export function getRegistryRow(method) {
+    return WIRE_METHOD_REGISTRY[method];
+}
+/**
+ * Check whether a method name is a valid wire method.
+ */
+export function isWireMethod(method) {
+    return WIRE_METHOD_NAMES.includes(method);
+}
+/**
+ * Get the grant requirement for a method.
+ * Returns undefined for unknown method names.
+ */
+export function getMethodGrant(method) {
+    return getRegistryRow(method)?.grant;
+}
+//# sourceMappingURL=registry.js.map

package/dist/wire/registry.js.map

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

package/dist/wire/request-id.d.ts

@@ -0,0 +1,34 @@
+/**
+ * RequestId — wire-protocol request correlation identifier.
+ * Mechanized verbatim from #1165 maintainer R4-intake (5005069362).
+ *
+ * String-only, ASCII, attempt correlation only (not authoritative for settlement).
+ * Response echo must be byte-for-byte equal.
+ */
+/** Branded RequestId type. */
+export type RequestId = string & {
+    readonly __brand: 'RequestId';
+};
+/** ASCII grammar pattern for RequestId values. */
+export declare const REQUEST_ID_PATTERN: RegExp;
+/** Minimum length in characters/bytes (ASCII). */
+export declare const REQUEST_ID_MIN_LENGTH: 1;
+/** Maximum length in characters/bytes (ASCII). */
+export declare const REQUEST_ID_MAX_LENGTH: 128;
+/** Minimum compact-JSON encoded bytes (including quotes). */
+export declare const REQUEST_ID_MIN_ENCODED_BYTES: 3;
+/** Maximum compact-JSON encoded bytes (including quotes). */
+export declare const REQUEST_ID_MAX_ENCODED_BYTES: 130;
+/**
+ * Validate a value as a RequestId.
+ * Returns the validated RequestId or null if invalid.
+ * Does NOT check in-flight uniqueness (that is a runtime concern).
+ */
+export declare function validateRequestId(value: unknown): RequestId | null;
+/**
+ * Check if a raw JSON token could be a RequestId.
+ * Used in pre-dispatch: detects string tokens with valid grammar.
+ * Non-string types (numeric, null, boolean, object, array) return false.
+ */
+export declare function isRequestIdShaped(value: unknown): value is string;
+//# sourceMappingURL=request-id.d.ts.map

package/dist/wire/request-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-id.d.ts","sourceRoot":"","sources":["../../src/wire/request-id.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,8BAA8B;AAC9B,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC;AAEnE,kDAAkD;AAClD,eAAO,MAAM,kBAAkB,QAAwC,CAAC;AAExE,kDAAkD;AAClD,eAAO,MAAM,qBAAqB,EAAG,CAAU,CAAC;AAEhD,kDAAkD;AAClD,eAAO,MAAM,qBAAqB,EAAG,GAAY,CAAC;AAElD,6DAA6D;AAC7D,eAAO,MAAM,4BAA4B,EAAG,CAAU,CAAC;AAEvD,6DAA6D;AAC7D,eAAO,MAAM,4BAA4B,EAAG,GAAY,CAAC;AAEzD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAKlE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEjE"}

package/dist/wire/request-id.js

@@ -0,0 +1,40 @@
+/**
+ * RequestId — wire-protocol request correlation identifier.
+ * Mechanized verbatim from #1165 maintainer R4-intake (5005069362).
+ *
+ * String-only, ASCII, attempt correlation only (not authoritative for settlement).
+ * Response echo must be byte-for-byte equal.
+ */
+/** ASCII grammar pattern for RequestId values. */
+export const REQUEST_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/;
+/** Minimum length in characters/bytes (ASCII). */
+export const REQUEST_ID_MIN_LENGTH = 1;
+/** Maximum length in characters/bytes (ASCII). */
+export const REQUEST_ID_MAX_LENGTH = 128;
+/** Minimum compact-JSON encoded bytes (including quotes). */
+export const REQUEST_ID_MIN_ENCODED_BYTES = 3; // 1 + 2 quotes
+/** Maximum compact-JSON encoded bytes (including quotes). */
+export const REQUEST_ID_MAX_ENCODED_BYTES = 130; // 128 + 2 quotes
+/**
+ * Validate a value as a RequestId.
+ * Returns the validated RequestId or null if invalid.
+ * Does NOT check in-flight uniqueness (that is a runtime concern).
+ */
+export function validateRequestId(value) {
+    if (typeof value !== 'string')
+        return null;
+    if (value.length < REQUEST_ID_MIN_LENGTH || value.length > REQUEST_ID_MAX_LENGTH)
+        return null;
+    if (!REQUEST_ID_PATTERN.test(value))
+        return null;
+    return value;
+}
+/**
+ * Check if a raw JSON token could be a RequestId.
+ * Used in pre-dispatch: detects string tokens with valid grammar.
+ * Non-string types (numeric, null, boolean, object, array) return false.
+ */
+export function isRequestIdShaped(value) {
+    return typeof value === 'string';
+}
+//# sourceMappingURL=request-id.js.map

package/dist/wire/request-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-id.js","sourceRoot":"","sources":["../../src/wire/request-id.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,kDAAkD;AAClD,MAAM,CAAC,MAAM,kBAAkB,GAAG,qCAAqC,CAAC;AAExE,kDAAkD;AAClD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAU,CAAC;AAEhD,kDAAkD;AAClD,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAY,CAAC;AAElD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAU,CAAC,CAAC,eAAe;AAEvE,6DAA6D;AAC7D,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAY,CAAC,CAAC,iBAAiB;AAE3E;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,KAAK,CAAC,MAAM,GAAG,qBAAqB,IAAI,KAAK,CAAC,MAAM,GAAG,qBAAqB;QAAE,OAAO,IAAI,CAAC;IAC9F,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACjD,OAAO,KAAkB,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC"}