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

package/dist/wire/registry.d.ts

@@ -0,0 +1,294 @@
+/**
+ * Complete 13-row beta.11 standalone 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 rows through the beta.11 M0-C closure)
+ *   - 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.
+ *
+ */
+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 schema field that must exist before or with a method's leaf closure. */
+export interface SchemaClosurePrerequisite {
+    readonly schemaPath: string;
+    readonly timing: 'before-or-with-closure';
+}
+/**
+ * A single row of the production method registry.
+ * Most rows remain unpublished and unadvertised. beta.8 closes the two
+ * handshake rows; beta.9 appends the C-2 events.publish row.
+ */
+export interface RegistryRow {
+    readonly rowNumber: number;
+    readonly method: string;
+    readonly direction: MethodDirection;
+    readonly grant: GrantRequirement;
+    readonly isNotification: boolean;
+    readonly ready: boolean;
+    readonly leafClosure: LeafClosureStatus;
+    readonly reservedEntries: readonly string[];
+    readonly settlementKeySource: string;
+    /** Derived compact-frame maxima, present only for rows with closed wire shapes. */
+    readonly maxEncodedRequestBytes?: number;
+    readonly maxEncodedResultBytes?: number;
+    readonly maxEncodedErrorBytes?: number;
+    /** Schema fields required before this row may change from RESERVED to CLOSED. */
+    readonly schemaClosurePrerequisites?: readonly SchemaClosurePrerequisite[];
+}
+/** A registry row whose input is publicly ready for dispatch. */
+export interface ReadyRegistryRow extends RegistryRow {
+    readonly ready: true;
+}
+/** A registry row that remains unready, whether its leaves are CLOSED or RESERVED. */
+export interface UnreadyRegistryRow extends RegistryRow {
+    readonly ready: false;
+}
+/**
+ * The exact 13 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", "events.publish"];
+/** Union of all 13 production method names. */
+export type WireMethodName = (typeof WIRE_METHOD_NAMES)[number];
+/**
+ * Literal readiness partition. This prevents a registry edit from widening a
+ * newly closed row back to `boolean` or accidentally advertising another row.
+ */
+export type WireMethodRegistry = {
+    readonly [Method in WireMethodName]: ReadyRegistryRow;
+};
+/**
+ * Machine-readable registry of all 13 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.
+ *
+ * Rows 1–2 closed in beta.8, row 13 in beta.9, rows 10–12 in beta.10,
+ * and rows 3–9 in beta.11.
+ */
+export declare const WIRE_METHOD_REGISTRY: {
+    readonly 'broker.hello': {
+        readonly maxEncodedRequestBytes: number;
+        readonly maxEncodedResultBytes: number;
+        readonly maxEncodedErrorBytes: number;
+        readonly rowNumber: 1;
+        readonly method: "broker.hello";
+        readonly direction: "plugin-to-host";
+        readonly grant: "protocol-intrinsic";
+        readonly isNotification: false;
+        readonly ready: true;
+        readonly leafClosure: "CLOSED";
+        readonly reservedEntries: readonly [];
+        readonly settlementKeySource: "—";
+    };
+    readonly 'broker.ready': {
+        readonly maxEncodedRequestBytes: number;
+        readonly maxEncodedResultBytes: number;
+        readonly maxEncodedErrorBytes: number;
+        readonly rowNumber: 2;
+        readonly method: "broker.ready";
+        readonly direction: "plugin-to-host";
+        readonly grant: "protocol-intrinsic";
+        readonly isNotification: false;
+        readonly ready: true;
+        readonly leafClosure: "CLOSED";
+        readonly reservedEntries: readonly [];
+        readonly settlementKeySource: "—";
+    };
+    readonly 'messaging.send': {
+        readonly maxEncodedRequestBytes: number;
+        readonly maxEncodedResultBytes: number;
+        readonly maxEncodedErrorBytes: number;
+        readonly rowNumber: 3;
+        readonly method: "messaging.send";
+        readonly direction: "plugin-to-host";
+        readonly grant: "messaging.send";
+        readonly isNotification: false;
+        readonly ready: true;
+        readonly leafClosure: "CLOSED";
+        readonly reservedEntries: readonly [];
+        readonly settlementKeySource: "input.idempotencyKey";
+    };
+    readonly 'messaging.appendElements': {
+        readonly maxEncodedRequestBytes: number;
+        readonly maxEncodedResultBytes: number;
+        readonly maxEncodedErrorBytes: number;
+        readonly rowNumber: 4;
+        readonly method: "messaging.appendElements";
+        readonly direction: "plugin-to-host";
+        readonly grant: "messaging.appendElements";
+        readonly isNotification: false;
+        readonly ready: true;
+        readonly leafClosure: "CLOSED";
+        readonly reservedEntries: readonly [];
+        readonly settlementKeySource: "(Host-resolved messageId from input.handle, input.operationId)";
+    };
+    readonly 'messaging.subscribe': {
+        readonly maxEncodedRequestBytes: number;
+        readonly maxEncodedResultBytes: number;
+        readonly maxEncodedErrorBytes: number;
+        readonly rowNumber: 5;
+        readonly method: "messaging.subscribe";
+        readonly direction: "plugin-to-host";
+        readonly grant: "message.event.subscribe";
+        readonly isNotification: false;
+        readonly ready: true;
+        readonly leafClosure: "CLOSED";
+        readonly reservedEntries: readonly [];
+        readonly settlementKeySource: "Host-resolved input.handle identity (K-1 create-or-get authoritative)";
+    };
+    readonly 'messaging.read': {
+        readonly maxEncodedRequestBytes: number;
+        readonly maxEncodedResultBytes: number;
+        readonly maxEncodedErrorBytes: number;
+        readonly rowNumber: 6;
+        readonly method: "messaging.read";
+        readonly direction: "plugin-to-host";
+        readonly grant: "message.event.subscribe";
+        readonly isNotification: false;
+        readonly ready: true;
+        readonly leafClosure: "CLOSED";
+        readonly reservedEntries: readonly [];
+        readonly settlementKeySource: "none (at-least-once; bounded page assembly)";
+    };
+    readonly 'messaging.ack': {
+        readonly maxEncodedRequestBytes: number;
+        readonly maxEncodedResultBytes: number;
+        readonly maxEncodedErrorBytes: number;
+        readonly rowNumber: 7;
+        readonly method: "messaging.ack";
+        readonly direction: "plugin-to-host";
+        readonly grant: "message.event.subscribe";
+        readonly isNotification: false;
+        readonly ready: true;
+        readonly leafClosure: "CLOSED";
+        readonly reservedEntries: readonly [];
+        readonly settlementKeySource: "(input.subscriptionId, input.ackToken)";
+    };
+    readonly 'messaging.snapshot': {
+        readonly maxEncodedRequestBytes: number;
+        readonly maxEncodedResultBytes: number;
+        readonly maxEncodedErrorBytes: number;
+        readonly rowNumber: 8;
+        readonly method: "messaging.snapshot";
+        readonly direction: "plugin-to-host";
+        readonly grant: "message.event.subscribe";
+        readonly isNotification: false;
+        readonly ready: true;
+        readonly leafClosure: "CLOSED";
+        readonly reservedEntries: readonly [];
+        readonly settlementKeySource: "none for traversal; completion = D1b Host entitlement through messaging.ack";
+    };
+    readonly 'host.messaging.deliver': {
+        readonly maxEncodedRequestBytes: number;
+        readonly maxEncodedResultBytes: number;
+        readonly maxEncodedErrorBytes: number;
+        readonly rowNumber: 9;
+        readonly method: "host.messaging.deliver";
+        readonly direction: "host-to-plugin";
+        readonly grant: "onMessage";
+        readonly isNotification: false;
+        readonly ready: true;
+        readonly leafClosure: "CLOSED";
+        readonly reservedEntries: readonly [];
+        readonly settlementKeySource: "input.deliveryId (Host-side authoritative)";
+    };
+    readonly 'host.grants.changed': {
+        readonly maxEncodedRequestBytes: number;
+        readonly rowNumber: 10;
+        readonly method: "host.grants.changed";
+        readonly direction: "host-to-plugin";
+        readonly grant: "protocol-intrinsic";
+        readonly isNotification: true;
+        readonly ready: true;
+        readonly leafClosure: "CLOSED";
+        readonly reservedEntries: readonly [];
+        readonly settlementKeySource: "(grantRevision monotonic)";
+    };
+    readonly 'host.lifecycle.ping': {
+        readonly maxEncodedRequestBytes: number;
+        readonly maxEncodedResultBytes: number;
+        readonly maxEncodedErrorBytes: number;
+        readonly rowNumber: 11;
+        readonly method: "host.lifecycle.ping";
+        readonly direction: "host-to-plugin";
+        readonly grant: "protocol-intrinsic";
+        readonly isNotification: false;
+        readonly ready: true;
+        readonly leafClosure: "CLOSED";
+        readonly reservedEntries: readonly [];
+        readonly settlementKeySource: "—";
+    };
+    readonly 'host.lifecycle.drain': {
+        readonly maxEncodedRequestBytes: number;
+        readonly maxEncodedResultBytes: number;
+        readonly maxEncodedErrorBytes: number;
+        readonly rowNumber: 12;
+        readonly method: "host.lifecycle.drain";
+        readonly direction: "host-to-plugin";
+        readonly grant: "protocol-intrinsic";
+        readonly isNotification: false;
+        readonly ready: true;
+        readonly leafClosure: "CLOSED";
+        readonly reservedEntries: readonly [];
+        readonly settlementKeySource: "—";
+    };
+    readonly 'events.publish': {
+        readonly maxEncodedRequestBytes: number;
+        readonly maxEncodedResultBytes: number;
+        readonly maxEncodedErrorBytes: number;
+        readonly rowNumber: 13;
+        readonly method: "events.publish";
+        readonly direction: "plugin-to-host";
+        readonly grant: "events.publish";
+        readonly isNotification: false;
+        readonly ready: true;
+        readonly leafClosure: "CLOSED";
+        readonly reservedEntries: readonly [];
+        readonly settlementKeySource: "(Host-bound producer instance, input.signalType, input.idempotencyKey)";
+    };
+};
+/** 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[];
+/** Method names that are legal for wire advertisement in beta.11. */
+export declare const READY_ROWS: readonly WireMethodName[];
+/** Total number of production methods. */
+export declare const WIRE_METHOD_COUNT: 13;
+/**
+ * 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":"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"}

package/dist/wire/registry.js

@@ -0,0 +1,256 @@
+/**
+ * Complete 13-row beta.11 standalone 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 rows through the beta.11 M0-C closure)
+ *   - 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.
+ *
+ */
+import { HANDSHAKE_ROW_ENCODED_BYTE_BOUNDS } from './handshake-byte-bounds.js';
+import { LIFECYCLE_ROW_ENCODED_BYTE_BOUNDS } from './lifecycle-byte-bounds.js';
+import { MESSAGING_ROW_ENCODED_BYTE_BOUNDS } from './messaging-byte-bounds.js';
+import { EVENTS_PUBLISH_ROW_ENCODED_BYTE_BOUNDS } from './signal-byte-bounds.js';
+// ---------------------------------------------------------------------------
+// Method name enum
+// ---------------------------------------------------------------------------
+/**
+ * The exact 13 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',
+    'events.publish',
+];
+// ---------------------------------------------------------------------------
+// The complete registry (frozen)
+// ---------------------------------------------------------------------------
+/**
+ * Machine-readable registry of all 13 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.
+ *
+ * Rows 1–2 closed in beta.8, row 13 in beta.9, rows 10–12 in beta.10,
+ * and rows 3–9 in beta.11.
+ */
+export const WIRE_METHOD_REGISTRY = {
+    'broker.hello': {
+        rowNumber: 1,
+        method: 'broker.hello',
+        direction: 'plugin-to-host',
+        grant: 'protocol-intrinsic',
+        isNotification: false,
+        ready: true,
+        leafClosure: 'CLOSED',
+        reservedEntries: [],
+        settlementKeySource: '—',
+        ...HANDSHAKE_ROW_ENCODED_BYTE_BOUNDS['broker.hello'],
+    },
+    'broker.ready': {
+        rowNumber: 2,
+        method: 'broker.ready',
+        direction: 'plugin-to-host',
+        grant: 'protocol-intrinsic',
+        isNotification: false,
+        ready: true,
+        leafClosure: 'CLOSED',
+        reservedEntries: [],
+        settlementKeySource: '—',
+        ...HANDSHAKE_ROW_ENCODED_BYTE_BOUNDS['broker.ready'],
+    },
+    'messaging.send': {
+        rowNumber: 3,
+        method: 'messaging.send',
+        direction: 'plugin-to-host',
+        grant: 'messaging.send',
+        isNotification: false,
+        ready: true,
+        leafClosure: 'CLOSED',
+        reservedEntries: [],
+        settlementKeySource: 'input.idempotencyKey',
+        ...MESSAGING_ROW_ENCODED_BYTE_BOUNDS['messaging.send'],
+    },
+    'messaging.appendElements': {
+        rowNumber: 4,
+        method: 'messaging.appendElements',
+        direction: 'plugin-to-host',
+        grant: 'messaging.appendElements',
+        isNotification: false,
+        ready: true,
+        leafClosure: 'CLOSED',
+        reservedEntries: [],
+        settlementKeySource: '(Host-resolved messageId from input.handle, input.operationId)',
+        ...MESSAGING_ROW_ENCODED_BYTE_BOUNDS['messaging.appendElements'],
+    },
+    'messaging.subscribe': {
+        rowNumber: 5,
+        method: 'messaging.subscribe',
+        direction: 'plugin-to-host',
+        grant: 'message.event.subscribe',
+        isNotification: false,
+        ready: true,
+        leafClosure: 'CLOSED',
+        reservedEntries: [],
+        settlementKeySource: 'Host-resolved input.handle identity (K-1 create-or-get authoritative)',
+        ...MESSAGING_ROW_ENCODED_BYTE_BOUNDS['messaging.subscribe'],
+    },
+    'messaging.read': {
+        rowNumber: 6,
+        method: 'messaging.read',
+        direction: 'plugin-to-host',
+        grant: 'message.event.subscribe',
+        isNotification: false,
+        ready: true,
+        leafClosure: 'CLOSED',
+        reservedEntries: [],
+        settlementKeySource: 'none (at-least-once; bounded page assembly)',
+        ...MESSAGING_ROW_ENCODED_BYTE_BOUNDS['messaging.read'],
+    },
+    'messaging.ack': {
+        rowNumber: 7,
+        method: 'messaging.ack',
+        direction: 'plugin-to-host',
+        grant: 'message.event.subscribe',
+        isNotification: false,
+        ready: true,
+        leafClosure: 'CLOSED',
+        reservedEntries: [],
+        settlementKeySource: '(input.subscriptionId, input.ackToken)',
+        ...MESSAGING_ROW_ENCODED_BYTE_BOUNDS['messaging.ack'],
+    },
+    'messaging.snapshot': {
+        rowNumber: 8,
+        method: 'messaging.snapshot',
+        direction: 'plugin-to-host',
+        grant: 'message.event.subscribe',
+        isNotification: false,
+        ready: true,
+        leafClosure: 'CLOSED',
+        reservedEntries: [],
+        settlementKeySource: 'none for traversal; completion = D1b Host entitlement through messaging.ack',
+        ...MESSAGING_ROW_ENCODED_BYTE_BOUNDS['messaging.snapshot'],
+    },
+    'host.messaging.deliver': {
+        rowNumber: 9,
+        method: 'host.messaging.deliver',
+        direction: 'host-to-plugin',
+        grant: 'onMessage',
+        isNotification: false,
+        ready: true,
+        leafClosure: 'CLOSED',
+        reservedEntries: [],
+        settlementKeySource: 'input.deliveryId (Host-side authoritative)',
+        ...MESSAGING_ROW_ENCODED_BYTE_BOUNDS['host.messaging.deliver'],
+    },
+    'host.grants.changed': {
+        rowNumber: 10,
+        method: 'host.grants.changed',
+        direction: 'host-to-plugin',
+        grant: 'protocol-intrinsic',
+        isNotification: true,
+        ready: true,
+        leafClosure: 'CLOSED',
+        reservedEntries: [],
+        settlementKeySource: '(grantRevision monotonic)',
+        ...LIFECYCLE_ROW_ENCODED_BYTE_BOUNDS['host.grants.changed'],
+    },
+    'host.lifecycle.ping': {
+        rowNumber: 11,
+        method: 'host.lifecycle.ping',
+        direction: 'host-to-plugin',
+        grant: 'protocol-intrinsic',
+        isNotification: false,
+        ready: true,
+        leafClosure: 'CLOSED',
+        reservedEntries: [],
+        settlementKeySource: '—',
+        ...LIFECYCLE_ROW_ENCODED_BYTE_BOUNDS['host.lifecycle.ping'],
+    },
+    'host.lifecycle.drain': {
+        rowNumber: 12,
+        method: 'host.lifecycle.drain',
+        direction: 'host-to-plugin',
+        grant: 'protocol-intrinsic',
+        isNotification: false,
+        ready: true,
+        leafClosure: 'CLOSED',
+        reservedEntries: [],
+        settlementKeySource: '—',
+        ...LIFECYCLE_ROW_ENCODED_BYTE_BOUNDS['host.lifecycle.drain'],
+    },
+    'events.publish': {
+        rowNumber: 13,
+        method: 'events.publish',
+        direction: 'plugin-to-host',
+        grant: 'events.publish',
+        isNotification: false,
+        ready: true,
+        leafClosure: 'CLOSED',
+        reservedEntries: [],
+        settlementKeySource: '(Host-bound producer instance, input.signalType, input.idempotencyKey)',
+        ...EVENTS_PUBLISH_ROW_ENCODED_BYTE_BOUNDS,
+    },
+};
+// ---------------------------------------------------------------------------
+// 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');
+/** Method names that are legal for wire advertisement in beta.11. */
+export const READY_ROWS = WIRE_METHOD_NAMES.filter(m => WIRE_METHOD_REGISTRY[m].ready);
+/** Total number of production methods. */
+export const WIRE_METHOD_COUNT = 13;
+// ---------------------------------------------------------------------------
+// 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"}