@xo-cash/utils 0.0.9 → 0.0.10

package/dist/index.mjs

@@ -1,10 +1,26 @@
 import { IdentifierResolutionType, OpcodesBchSpec, bigIntToVmNumber, binToHex, binToUtf8, createCompilerBch, describeExpectedInput, generateBytecodeMap, hexToBin, parseScript, sha256, utf8ToBin, vmNumberToBigInt } from "@bitauth/libauth";
-import { BchVmVersions, XOTemplateLockingTypes, XOTemplateNftCapabilities, XOTemplatePrimitiveTypes } from "@xo-cash/types";
 import { z } from "zod";
+import { BchVmVersions, XOTemplateLockingTypes, XOTemplateNftCapabilities, XOTemplatePrimitiveTypes } from "@xo-cash/types";
 import { FungibleTokenAmount, NFTCommitment, PublicKey, Satoshis, SchnorrSignature, TemplateIdentifier, Timestamp, TokenCategory, TransactionHash } from "@xo-cash/primitives";
 
 //#region source/errors.ts
 /**
+* Formats the Zod validation failures into a single string with one line each: "- <field>: <message>" and top level failures
+* with no field path show as "(root)" for better readability.
+*
+* @param issues The Zod validation failures to format.
+* @returns A human readable error string for better debugging.
+*/
+const buildErrorDescription = (issues) => {
+	const lines = [];
+	for (const issue of issues) {
+		const issuePath = issue.path.length > 0 ? issue.path.join(".") : "(root)";
+		const issueMessage = issue.message.startsWith("Invalid input: ") ? issue.message.slice(15) : issue.message;
+		lines.push(`- ${issuePath}: ${issueMessage}`);
+	}
+	return `\n${lines.join("\n")}`;
+};
+/**
 * Error thrown when a waitFor timeout is reached
 */
 var WaitForTimeoutError = class extends Error {
@@ -34,8 +50,8 @@ var EventEmitter = class {
 	* @returns An off callback that can be called to stop listening for events.
 	*/
 	on(type, listener, debounceMilliseconds = 0) {
-		const { cancel, listener: cancellableListener } = this.cancellable(listener);
-		const wrappedListener = debounceMilliseconds > 0 ? this.debounce(cancellableListener, debounceMilliseconds) : cancellableListener;
+		const { cancel, listener: cancellableListener } = this.#cancellable(listener);
+		const wrappedListener = debounceMilliseconds > 0 ? this.#debounce(cancellableListener, debounceMilliseconds) : cancellableListener;
 		if (!this.#listeners.has(type)) this.#listeners.set(type, /* @__PURE__ */ new Set());
 		const listenerEntry = {
 			listener,
@@ -57,8 +73,8 @@ var EventEmitter = class {
 			this.off(type, listener);
 			listener(detail);
 		};
-		const { cancel, listener: cancellableListener } = this.cancellable(wrappedListener);
-		const debouncedListener = debounceMilliseconds > 0 ? this.debounce(cancellableListener, debounceMilliseconds) : cancellableListener;
+		const { cancel, listener: cancellableListener } = this.#cancellable(wrappedListener);
+		const debouncedListener = debounceMilliseconds > 0 ? this.#debounce(cancellableListener, debounceMilliseconds) : cancellableListener;
 		if (!this.#listeners.has(type)) this.#listeners.set(type, /* @__PURE__ */ new Set());
 		const listenerEntry = {
 			listener,
@@ -156,7 +172,7 @@ var EventEmitter = class {
 	* @param wait - The wait time in milliseconds.
 	* @returns The debounced function.
 	*/
-	debounce(func, wait) {
+	#debounce(func, wait) {
 		let timeout;
 		return (detail) => {
 			if (timeout !== void 0) clearTimeout(timeout);
@@ -170,7 +186,7 @@ var EventEmitter = class {
 	* @param func - The function to make cancelable.
 	* @returns The cancellable function with a cancel method.
 	*/
-	cancellable(func) {
+	#cancellable(func) {
 		let cancelled = false;
 		return {
 			cancel: () => cancelled = true,
@@ -617,876 +633,389 @@ const fromExtendedJson = (serializedObject) => {
 };
 
 //#endregion
-//#region source/script.ts
+//#region source/invitation/errors.ts
 /**
-* Converts a script to a scriptHash.
-* @param {Uint8Array} script - The script to convert.
-* @returns {string} The scriptHash as a reversed hex string.
+* Thrown when a value does not satisfy the XOInvitation schema.
 */
-const scriptToScriptHash = (script) => {
-	return binToHex(sha256.hash(script).reverse());
+var InvitationInvalidError = class extends Error {
+	constructor(details) {
+		const defaultMessage = `Invitation invalid, expected a value matching the XOInvitation type, but got: ${details}`;
+		super(defaultMessage);
+		this.name = "InvitationInvalidError";
+	}
 };
-
-//#endregion
-//#region source/sse-session/async-push-iterator.ts
 /**
-* An async iterable queue that bridges push-based producers and pull-based consumers.
-*
-* Composes an internal {@link ReadableStream} instead of extending it, so producers
-* call {@link push} while consumers use standard async iteration (`for await...of`).
-*
-* ```ts
-* const messages = new AsyncPushIterator<SSEvent>();
-*
-* // Producer (elsewhere)
-* messages.push(event);
-*
-* // Consumer
-* for await (const event of messages) {
-*   handle(event);
-* }
-* ```
-*
-* {@link Symbol.asyncIterator} returns `stream.values({ preventCancel: true })` so
-* breaking out of `for await...of` does not cancel the underlying stream. That
-* matters for long-lived sessions where the producer keeps pushing after a consumer
-* stops reading early (for example, test helpers that only collect a fixed count).
+* Thrown when invitation share JSON cannot be parsed.
 */
-var AsyncPushIterator = class {
-	/** ReadableStream backing the async iterator returned from {@link Symbol.asyncIterator}. */
-	#stream;
-	/** Controller used to enqueue values and close the stream from {@link push} and {@link close}. */
-	#controller;
-	/** When true, no more values are accepted and iteration eventually completes. */
-	#closed = false;
-	constructor() {
-		this.#stream = new ReadableStream({ start: (controller) => {
-			this.#controller = controller;
-		} });
-	}
-	/**
-	* Flag indicating if the iterator is closed.
-	*/
-	get closed() {
-		return this.#closed;
-	}
-	/**
-	* Enqueues a value for the consumer.
-	*
-	* After {@link close}, pushes are silently dropped.
-	*
-	* @param value - The next value to yield from the iterator.
-	*/
-	push(value) {
-		if (this.#closed) return;
-		this.#controller?.enqueue(value);
-	}
-	/**
-	* Causes any future interactions with the associated stream to error with {@link error}.
-	* Calling this will also clear the pending values immediately, so iterators that were listening will not receive them.
-	*
-	* @param error - The error to throw from the stream.
-	*/
-	error(error) {
-		if (this.#closed) return;
-		this.#closed = true;
-		this.#controller?.error(error);
-	}
+var InvitationJsonMalformedError = class extends Error {
 	/**
-	* Ends the stream.
-	*
-	* Marks the iterator closed so future {@link push} calls are ignored.
-	* Buffered values are still yielded before iteration completes.
+	* Parser failure forwarded from JSON parsing.
 	*/
-	close() {
-		this.#closed = true;
-		try {
-			this.#controller?.close();
-		} catch {}
+	reason;
+	constructor(reason) {
+		const defaultMessage = `Invitation JSON malformed: expected a valid JSON string, but got: ${reason}`;
+		super(defaultMessage);
+		this.name = "InvitationJsonMalformedError";
+		this.reason = reason;
 	}
+};
+/**
+* Thrown when invitation serialization fails.
+*/
+var InvitationSerializationFailedError = class extends Error {
 	/**
-	* Returns an async iterator over the composed stream.
-	*
-	* Uses `preventCancel: true` so early `break` from `for await...of` does not
-	* close the stream and block later pushes.
-	*
-	* Because values are discarded after being read, only a single consumer is supported.
-	* Additional consumers will receive a stream lock error. Unread values will be preserved until {@link close} is called.
+	* Serializer failure forwarded from the serialization path.
 	*/
-	[Symbol.asyncIterator]() {
-		return this.#stream.values({ preventCancel: true });
+	reason;
+	constructor(reason) {
+		const defaultMessage = `Invitation serialization failed: ${reason}`;
+		super(defaultMessage);
+		this.name = "InvitationSerializationFailedError";
+		this.reason = reason;
 	}
 };
 
 //#endregion
-//#region source/sse-session/constants.ts
+//#region source/template/schemas.ts
 /**
-* Regex that splits decoded SSE text into lines.
+* Validation schema for a BCH VM version identifier. Defines the set of known BCH VM versions
+* that XO templates declare support for.
 *
-* The SSE wire format is line-oriented (`field: value` per line). Servers may
-* send `\r\n` (HTTP default), `\n` (Unix), or `\r` (legacy Mac). Matching all
-* three keeps parsing correct regardless of platform or server implementation.
+* Uses `BchVmVersions` from `@xo-cash/types` so template validation stays aligned with the
+* `BchVmVersion` type.
+*
+* ```
+* {
+*   "supported": [ "BCH_2025_05" ]  ← each value
+* }
+* ```
 */
-const SSE_LINE_ENDINGS = /\r\n|\r|\n/;
+const bchVmVersionSchema = z.enum(BchVmVersions);
 /**
-* Regex that matches the single optional leading space in an SSE field value.
+* Validation schema for the capability of a non-fungible token. Defines the three capability
+* types supported on BCH: minting tokens can create new NFTs, mutable tokens can update their
+* commitment, and none tokens cannot be changed after creation.
 *
-* Per the SSE spec, `field: value` may include one space immediately after the
-* colon; that space is not part of the value. Used with `.replace()` to strip
-* it when parsing lines such as `data: hello` → `hello`.
+* ```
+* {
+*   "inputs|outputs": {
+*     "[id]": {
+*       "token": {
+*         "nft": {
+*           "capability": "minting"  ← this schema
+*         }
+*       }
+*     }
+*   }
+* }
+* ```
 */
-const SSE_FIELD_VALUE_REGEX = /^ /;
+const xoTemplateNftCapabilitySchema = z.enum(XOTemplateNftCapabilities);
 /**
-* Regex that matches a trailing newline at the end of a string.
+* Validation schema for a BCH locking script type. Defines the standard locking script types
+* supported on BCH.
 *
-* Multiple `data:` lines in one event are joined with `\n`. When the event is
-* completed, this removes any stray trailing newline so callers receive the
-* payload without an extra line break at the end.
+* ```
+* {
+*   "lockingScripts": {
+*     "[id]": {
+*       "lockingType": "p2pkh"  ← this schema
+*     }
+*   }
+* }
+* ```
 */
-const SSE_TRAILING_NEWLINE_REGEX = /\n$/;
+const xoTemplateLockingTypeSchema = z.enum(XOTemplateLockingTypes);
 /**
-* The newline character used when normalizing SSE text internally.
-*
-* Used to join consecutive `data:` lines into one payload and to reassemble
-* buffered partial lines between streamed chunks before the next parse call.
+* Validation schema for a primitive type identifier.
+* Accepts values from XOTemplatePrimitiveTypes for the `hint` field on constants, variables, and data.
 */
-const NEW_LINE = "\n";
+const xoTemplatePrimitiveTypeSchema = z.enum(XOTemplatePrimitiveTypes);
 /**
-* Default exponential backoff options for the SSE session.
+* Validation schema for byte array fields i.e. Uint8Array instance.
 */
-const SSE_SESSION_EXPONENTIAL_BACKOFF_DEFAULTS = {
-	baseDelay: 250,
-	maxDelay: 1e4,
-	maxAttempts: 0,
-	growthRate: 1.3,
-	jitter: .3
-};
+const uint8ArraySchema = z.instanceof(Uint8Array).describe("A sequence of unsigned 8-bit integers expressed as a Uint8Array.");
 /**
-* Default attempt reconnect flag for the SSE session.
-* @default true
+* Validation schema for the Satoshis type i.e. bigint.
 */
-const SSE_SESSION_ATTEMPT_RECONNECT_DEFAULT = true;
+const satoshisSchema = z.bigint().describe("A satoshi amount expressed as a bigint.");
+/** Maximum character length for name fields on view properties. */
+const VIEW_PROPERTIES_NAME_MAX_LENGTH = 1e3;
+/** Maximum character length for description fields on view properties. */
+const VIEW_PROPERTIES_DESCRIPTION_MAX_LENGTH = 5e3;
+/** Maximum character length for icon fields on view properties. */
+const VIEW_PROPERTIES_ICON_MAX_LENGTH = 1e3;
 /**
-* Default persistent flag for the SSE session.
-* @default false
+* Validation schema for view properties shared across many template elements i.e. name, description, icon.
+* Extended by most other schemas in this file.
 */
-const SSE_SESSION_PERSISTENT_DEFAULT = false;
-
-//#endregion
-//#region source/sse-session/sse-event-parser.ts
+const xoTemplateViewPropertiesSchema = z.object({
+	name: z.string().max(VIEW_PROPERTIES_NAME_MAX_LENGTH).describe("A short human-readable label for this element."),
+	description: z.string().max(VIEW_PROPERTIES_DESCRIPTION_MAX_LENGTH).describe("A human-readable explanation of what this element does and when it is relevant."),
+	icon: z.string().max(VIEW_PROPERTIES_ICON_MAX_LENGTH).optional().describe("An optional icon identifier or URL for this element.")
+}).strict();
 /**
-* Incrementally parses Server-Sent Events (SSE) from streamed byte chunks.
-*
-* SSE payloads are line-oriented: each event is a sequence of `field: value`
-* lines terminated by a blank line. This parser accepts arbitrary chunk
-* boundaries from a live HTTP response body and emits only complete events.
+* Validation schema for the base intent structure. Describes the common data parameters shared
+* by all intent types regardless of what they target.
 *
-* Typical usage is one parser instance per connection, calling {@link parseEvents}
-* for each chunk received from the stream:
+* An optional templateIdentifier allows the intent to reference a target defined in a different
+* template, enabling cross-template interaction.
 *
-* ```ts
-* const parser = new SSEEventParser();
+* Extended by: xoTemplateActionIntentSchema, xoTemplateOutputIntentSchema,
+* xoTemplateLockingScriptIntentSchema.
+*/
+const xoTemplateIntentSchema = z.object({
+	templateIdentifier: z.string().optional().describe("Optional identifier for the template used in this intent. If not provided, uses the current template."),
+	role: z.string().optional().describe("Optional identifier for the role used in this intent."),
+	generate: z.array(z.string()).optional().describe("Identifiers for items to generate when this intent is resolved, e.g. keys or secrets."),
+	variables: z.array(z.record(z.string(), z.unknown())).optional().describe("Variable values to apply when this intent is resolved."),
+	constants: z.array(z.record(z.string(), z.unknown())).optional().describe("Constant values to apply when this intent is resolved."),
+	secrets: z.array(z.record(z.string(), z.unknown())).optional().describe("Secret values to apply when this intent is resolved.")
+}).strict();
+/**
+* Validation schema for an action intent. Extends the base intent structure with an action
+* identifier. Used in locking script action lists and in the template's start array.
 *
-* for await (const chunk of response.body) {
-*   for (const event of parser.parseEvents(chunk)) {
-*     // handle event.data, event.event, event.id, event.retry
-*   }
-* }
 * ```
-*
-* Supported fields follow the SSE spec: `data`, `event`, `id`, and `retry`.
-* Multiple `data:` lines in one event are joined with `\n`. An event is only
-* emitted once a blank line is seen and at least one `data` field was collected.
-*/
-var SSEEventParser = class {
-	#textDecoder;
-	/** Bytes from a partial line or incomplete event, carried over to the next chunk. */
-	#messageBuffer = "";
-	/**
-	* Creates a parser for one SSE stream.
-	*
-	* Inject custom encoders in tests or when a non-default character encoding
-	* is required; production callers can rely on the defaults.
-	*
-	* @param options - Optional text encoders for decode/encode of stream bytes.
-	*/
-	constructor(options = {}) {
-		this.#textDecoder = options.textDecoder ?? new TextDecoder();
-	}
-	/**
-	* Clears any buffered bytes from a partial line or incomplete event.
-	*
-	* Call when abandoning a transport so the next connection does not prepend
-	* stale bytes to incoming chunks.
-	*/
-	reset() {
-		this.#messageBuffer = "";
-		this.#textDecoder.decode();
-	}
-	/**
-	* Parses all complete SSE events contained in a newly received chunk.
-	*
-	* The chunk is appended to any bytes buffered from earlier calls. Complete
-	* events (blank-line delimited blocks with at least one `data` field) are
-	* returned immediately; any trailing partial line or in-progress event stays
-	* in the internal buffer until a later chunk completes it.
-	*
-	* @param chunk - Newly received SSE stream bytes.
-	* @returns Zero or more complete parsed SSE events from this chunk.
-	*/
-	parseEvents(chunk) {
-		const lines = this.getBufferedLines(chunk);
-		const eventLines = lines.slice(0, -1);
-		const events = [];
-		let event = {};
-		let processedLineCount = 0;
-		for (const [index, line] of eventLines.entries()) {
-			if (line === "") {
-				if (event.data !== void 0) {
-					events.push(this.completeEvent(event));
-					event = {};
-					processedLineCount = index + 1;
-				}
-				continue;
-			}
-			this.parseLine(line, event);
-		}
-		this.storeRemainingLines(lines, processedLineCount);
-		return events;
-	}
-	/**
-	* Appends a new chunk to the buffered bytes and splits the combined payload
-	* into lines.
-	*
-	* Accepts `\r\n`, `\r`, and `\n` line endings so events parse correctly
-	* regardless of server or platform conventions.
-	*/
-	getBufferedLines(chunk) {
-		this.#messageBuffer += this.#textDecoder.decode(chunk, { stream: true });
-		return this.#messageBuffer.split(SSE_LINE_ENDINGS);
-	}
-	/**
-	* Parses one SSE field line into an in-progress event.
-	*
-	* Lines without a colon are ignored. A single optional space after the colon
-	* is stripped from the field value, per the SSE spec.
-	*/
-	parseLine(line, event) {
-		const colonIndex = line.indexOf(":");
-		if (colonIndex === -1) return;
-		const field = line.slice(0, colonIndex);
-		const value = line.slice(colonIndex + 1).replace(SSE_FIELD_VALUE_REGEX, "");
-		switch (field) {
-			case "data":
-				event.data = event.data ? `${event.data}${NEW_LINE}${value}` : value;
-				return;
-			case "event":
-				event.event = value;
-				return;
-			case "id":
-				event.id = value;
-				return;
-			case "retry":
-				this.parseRetry(value, event);
-				return;
-		}
-	}
-	/**
-	* Applies a numeric `retry:` field to an in-progress event.
-	*
-	* Non-numeric values are ignored rather than failing the parse.
-	*/
-	parseRetry(value, event) {
-		const retry = parseInt(value, 10);
-		if (!isNaN(retry)) event.retry = retry;
-	}
-	/**
-	* Constructs a completed SSE event from accumulated fields.
-	*
-	* Trims a trailing newline from multi-line `data` values so callers receive
-	* the payload without an extra line break at the end.
-	*/
-	completeEvent(event) {
-		return {
-			...event,
-			data: event.data?.replace(SSE_TRAILING_NEWLINE_REGEX, "")
-		};
-	}
-	/**
-	* Preserves incomplete trailing lines for the next received chunk.
-	*
-	* Only lines that were fully processed (through a completed event boundary)
-	* are discarded; the remainder is re-encoded into {@link messageBuffer}.
-	*/
-	storeRemainingLines(lines, processedLineCount) {
-		this.#messageBuffer = lines.slice(processedLineCount).join(NEW_LINE);
-	}
-};
-
-//#endregion
-//#region source/sse-session/errors.ts
-/**
-* Error thrown when a response body is null
+* {
+*   "start": [
+*     { "action": "..." }  ← this schema
+*   ],
+*   "lockingScripts": {
+*     "[id]": {
+*       "actions": [
+*         { "action": "..." }  ← this schema
+*       ],
+*       "roles": {
+*         "[roleId]": {
+*           "actions": [
+*             { "action": "..." }  ← this schema
+*           ]
+*         }
+*       }
+*     }
+*   }
+* }
+* ```
 */
-var ResponseBodyNullError = class extends Error {
-	constructor() {
-		super("Response body is null");
-		this.name = "ResponseBodyNullError";
-	}
-};
+const xoTemplateActionIntentSchema = xoTemplateIntentSchema.extend({ action: z.string().describe("The identifier for the intended action.") }).strict();
 /**
-* Error thrown when an HTTP error occurs
+* Validation schema for an output intent. Extends the base intent structure with an output
+* identifier. Used in the template's defaults block.
+*
+* ```
+* {
+*   "defaults": {
+*     "change": { "output": "..." }  ← this schema
+*   }
+* }
+* ```
 */
-var HTTPError = class extends Error {
-	constructor(status, message) {
-		super(`HTTP error! Status: ${status} - ${message}`);
-		this.name = "HTTPError";
-	}
-};
+const xoTemplateOutputIntentSchema = xoTemplateIntentSchema.extend({ output: z.string().describe("The identifier for the intended output.") }).strict();
 /**
-* Error thrown when a plugin's unsubscribe function is not a function
+* Validation schema for a locking script intent. Extends the base intent structure with
+* a locking script identifier.
+*
+* @todo The location of this schema in the template JSON is not yet determined.
 */
-var SSESessionUnsubscribePluginNotAFunctionError = class extends Error {
-	constructor(pluginName) {
-		super(`${pluginName}'s unsubscribe function is not a function`);
-		this.name = "SSESessionUnsubscribePluginNotAFunctionError";
-	}
-};
-
-//#endregion
-//#region source/sse-session/sse-session.ts
+const xoTemplateLockingScriptIntentSchema = xoTemplateIntentSchema.extend({ lockingScript: z.string().describe("The identifier for the intended locking script.") }).strict();
 /**
-* A fetch-based Server-Sent Events (SSE) client with reconnect and optional
-* browser tab visibility handling.
-*
-* Each session maintains one HTTP streaming connection at a time. Incoming
-* bytes are parsed into {@link SSEvent} objects and delivered through two
-* surfaces:
-*
-* - **Events** — `"connected"`, `"message"`, `"disconnected"`, `"error"`,
-*   and `"closed"` on the session itself (extends {@link EventEmitter}).
-* - **Messages** — {@link messages}, an async iterable for `for await...of`
-*   consumers.
-*
-* Typical usage:
-*
-* ```ts
-* const session = await SSESession.create("/events");
+* Validation schema for the slot count configuration on a role requirement. Declares how many
+* participants of a given role are needed. min sets the lower bound and max sets the upper bound.
+* When max is absent, there is no upper limit.
 *
-* session.on("message", (event) => console.log(event.data));
+* ```
+* {
+*   "actions": {
+*     "[id]": {
+*       "requirements": {
+*         "participants": [
+*           { "slots": { "min": 1, "max": 1 } }  ← this schema
+*         ]
+*       }
+*     }
+*   }
+* }
+* ```
+*/
+const xoTemplateRoleSlotsRequirementsSchema = z.object({
+	min: z.number().describe("Minimum number of participants required for this role."),
+	max: z.number().optional().describe("Maximum number of participants allowed for this role. Undefined means unlimited.")
+}).strict();
+/**
+* Validation schema for the capability requirements declared on a role within an action.
+* Describes what data, secrets, or state the role is responsible for providing when participating in an action.
 *
-* for await (const event of session.messages) {
-*   handle(event);
+* ```
+* {
+*   "actions": {
+*     "[id]": {
+*       "roles": {
+*         "[roleId]": {
+*           "requirements": { "variables": [], "secrets": [] }  ← this schema
+*         }
+*       }
+*     }
+*   }
 * }
 * ```
+*/
+const xoTemplateActionRoleRequirementsSchema = z.object({
+	variables: z.array(z.string()).optional().describe("List of variable identifiers required for this role."),
+	secrets: z.array(z.string()).optional().describe("List of secret identifiers required for this role.")
+}).strict();
+/**
+* Validation schema for a role-specific definition within an action.
+* All view properties are optional.
 *
-* ## Lifecycle
+* ```
+* {
+*   "actions": {
+*     "[id]": {
+*       "roles": {
+*         "[roleId]": { }  ← this schema
+*       }
+*     }
+*   }
+* }
+* ```
+*/
+const xoTemplateActionRoleSchema = xoTemplateViewPropertiesSchema.partial().extend({
+	generate: z.array(z.string()).optional().describe("Identifiers for data items that should be generated for this role when participating in the action."),
+	requirements: xoTemplateActionRoleRequirementsSchema.optional().describe("The requirements for this role within this action.")
+}).strict();
+/**
+* Validation schema for a role participation requirement in an action's requirements block.
 *
-* - {@link connect} opens (or reopens) the transport. It resolves once the
-*   HTTP stream is established; reading continues in the background.
-* - {@link disconnect} stops the in-flight fetch without ending the session.
-*   Used internally for tab visibility. The {@link messages} iterator stays
-*   open so an existing consumer resumes when the tab becomes visible again.
-* - {@link close} aborts the transport, closes {@link messages}, and emits
-*   `"closed"`.
+* ```
+* {
+*   "actions": {
+*     "[id]": {
+*       "requirements": {
+*         "participants": [
+*           { "role": "...", "slots": { } }  ← this schema
+*         ]
+*       }
+*     }
+*   }
+* }
+* ```
+*/
+const xoTemplateRoleSlotSchema = z.object({
+	role: z.string().describe("The role identifier that this requirement applies to."),
+	slots: xoTemplateRoleSlotsRequirementsSchema.describe("Slot configuration specifying how many participants of this role are required.")
+}).strict();
+/**
+* Validation schema for the requirements of an action.
 *
-* Automatic reconnect is controlled by {@link SSESessionOptions.persistent}
-* (server closed the stream) and
-* {@link SSESessionOptions.attemptReconnect} (transport error).
+* ```
+* {
+*   "actions": {
+*     "[id]": {
+*       "requirements": { "variables": [], "participants": [], "secrets": [] }  ← this schema
+*     }
+*   }
+* }
+* ```
+*/
+const xoTemplateActionRequirementsSchema = z.object({
+	variables: z.array(z.string()).optional().describe("List of variable identifiers required for this action."),
+	participants: z.array(xoTemplateRoleSlotSchema).optional().describe("The participants required for this action."),
+	secrets: z.array(z.string()).optional().describe("The secrets required for this action.")
+}).strict();
+/**
+* Validation schema for an action definition.
 *
-* ## Connection supersession
+* ```
+* {
+*   "actions": {
+*     "[id]": { }  ← this schema
+*   }
+* }
+* ```
+*/
+const xoTemplateActionSchema = xoTemplateViewPropertiesSchema.extend({
+	roles: z.record(z.string(), xoTemplateActionRoleSchema).optional().describe("Specific context for each role participating in this action."),
+	requirements: xoTemplateActionRequirementsSchema.optional().describe("The requirements for this action."),
+	conditions: z.array(z.string()).optional().describe("Conditions that must be met for this action to be available."),
+	transaction: z.string().optional().describe("The identifier of the transaction this action produces, referencing an entry in the template's transactions."),
+	data: z.string().optional().describe("The identifier of the data field this action produces, referencing an entry in the template's data.")
+}).strict();
+/**
+* Validation schema for the non-fungible token configuration within a token field.
 *
-* Each {@link connect} will create a new controller if one does not exist. Otherwise,
-* it will return immediately.
+* ```
+* {
+*   "inputs|outputs": {
+*     "[id]": {
+*       "token": {
+*         "nft": { }  ← this schema
+*       }
+*     }
+*   }
+* }
+* ```
 */
-var SSESession = class SSESession extends EventEmitter {
-	/**
-	* Creates a session and waits until the first connection is established.
-	*
-	* @param url - The SSE endpoint URL.
-	* @param options - Configuration merged with instance defaults.
-	* @returns A connected session.
-	* @throws When the initial connection cannot be established.
-	*/
-	static async create(url, options = {}) {
-		const session = new SSESession(url, options);
-		await session.connect();
-		return session;
-	}
-	/**
-	* Enables SSE resume semantics by sending `Last-Event-ID` on reconnect.
-	*
-	* Listens for incoming `"message"` events and remembers the most recent
-	* {@link SSEvent.id}. On every subsequent connect or reconnect, the session's
-	* {@link onRequest} hook is wrapped so that header is attached when an id is
-	* known, allowing the server to replay only events the client has not yet
-	* received.
-	*
-	* The existing {@link onRequest} callback is preserved and runs after the
-	* header is applied, so auth or other header mutations continue to work.
-	*
-	* Since this relies on listening to the `"message"` event, this should ideally
-	* be called before "{@link connect} is called so no messages (and no ids) are missed.
-	*
-	* ```ts
-	* const session = new SSESession(url);
-	* SSESession.addLastEventIdReconnect(session);
-	* await session.connect();
-	* // Reconnects send Last-Event-ID once an event with an id is received.
-	* ```
-	*
-	* @param session - The session to instrument.
-	* @returns The same session, for chaining.
-	*/
-	static addLastEventIdReconnect(session) {
-		if (session.plugins.has(SSESession.addLastEventIdReconnect)) {
-			const removeListener = session.plugins.get(SSESession.addLastEventIdReconnect);
-			if (typeof removeListener !== "function") throw new SSESessionUnsubscribePluginNotAFunctionError("addLastEventIdReconnect");
-			return {
-				session,
-				removeListener
-			};
-		}
-		let lastEventId;
-		const messageListener = (event) => {
-			lastEventId = event.id ?? lastEventId;
-		};
-		session.on("message", messageListener);
-		const originalOnRequest = session.options.onRequest;
-		let enabled = true;
-		session.options.onRequest = async (request) => {
-			if (lastEventId && enabled) request.headers = {
-				...request.headers,
-				"Last-Event-ID": lastEventId
-			};
-			return originalOnRequest(request);
-		};
-		const removeListener = () => {
-			enabled = false;
-			session.off("message", messageListener);
-			if (session.plugins.get(SSESession.addLastEventIdReconnect) === removeListener) session.plugins.delete(SSESession.addLastEventIdReconnect);
-		};
-		session.plugins.set(SSESession.addLastEventIdReconnect, removeListener);
-		return {
-			session,
-			removeListener
-		};
-	}
-	/**
-	* Pauses and resumes a session based on browser tab visibility.
-	*
-	* Uses the Page Visibility API (`document.visibilitychange`):
-	*
-	* - **hidden** — {@link disconnect} stops the active fetch. {@link messages}
-	*   stays open; `"disconnected"` fires but `"closed"` does not.
-	* - **visible** — {@link connect} re-establishes the stream if needed.
-	*
-	* This controller will not re-connect if the session was disconnected by something else.
-	*
-	* No-op in non-browser environments where `document` is undefined.
-	*
-	* @param session - The session to manage.
-	*/
-	static addBrowserVisibilityHandler(session) {
-		if (typeof document === "undefined") return { session };
-		if (session.plugins.has(SSESession.addBrowserVisibilityHandler)) {
-			const removeListener = session.plugins.get(SSESession.addBrowserVisibilityHandler);
-			if (typeof removeListener !== "function") throw new SSESessionUnsubscribePluginNotAFunctionError("addBrowserVisibilityHandler");
-			return {
-				session,
-				removeListener
-			};
-		}
-		const reconnectOnVisible = async () => {
-			if (document.visibilityState === "visible") {
-				document.removeEventListener("visibilitychange", reconnectOnVisible);
-				await session.connect();
-			}
-		};
-		const disableOnExternalDisconnect = ({ source }) => {
-			if (source !== SSESession.addBrowserVisibilityHandler) document.removeEventListener("visibilitychange", reconnectOnVisible);
-		};
-		const handleVisibilityChange = async () => {
-			if (!session.active) return;
-			if (document.visibilityState === "hidden") {
-				document.addEventListener("visibilitychange", reconnectOnVisible);
-				session.disconnect({ source: SSESession.addBrowserVisibilityHandler });
-			}
-		};
-		document.addEventListener("visibilitychange", handleVisibilityChange);
-		session.on("beforeDisconnect", disableOnExternalDisconnect);
-		const removeListener = () => {
-			document.removeEventListener("visibilitychange", handleVisibilityChange);
-			document.removeEventListener("visibilitychange", reconnectOnVisible);
-			session.off("beforeDisconnect", disableOnExternalDisconnect);
-			if (session.plugins.get(SSESession.addBrowserVisibilityHandler) === removeListener) session.plugins.delete(SSESession.addBrowserVisibilityHandler);
-		};
-		session.plugins.set(SSESession.addBrowserVisibilityHandler, removeListener);
-		return {
-			session,
-			removeListener
-		};
-	}
-	/** SSE endpoint URL for this session. */
-	#url;
-	/**
-	* Per-instance configuration.
-	*
-	* Defaults live on the instance field (not a shared static) so each session
-	* gets its own {@link SSEEventParser} and {@link ExponentialBackoff}.
-	*/
-	options = {
-		fetch: (...args) => fetch(...args),
-		method: "GET",
-		headers: {
-			Accept: "text/event-stream",
-			"Cache-Control": "no-cache"
-		},
-		body: new FormData(),
-		onRequest: (request) => Promise.resolve(request),
-		retry: new ExponentialBackoff({ ...SSE_SESSION_EXPONENTIAL_BACKOFF_DEFAULTS }),
-		attemptReconnect: SSE_SESSION_ATTEMPT_RECONNECT_DEFAULT,
-		persistent: SSE_SESSION_PERSISTENT_DEFAULT,
-		eventParser: new SSEEventParser()
-	};
-	/**
-	* Registered plugins for the session.
-	* This can be used to prevent duplicate plugins from being added to the session.
-	* The value for a plugin is arbitrary, for example a function that removes the plugin.
-	*/
-	plugins = /* @__PURE__ */ new Map();
-	/** AbortController for the currently active fetch, if any. */
-	#connectionController = null;
-	/** The server's requested retry interval in milliseconds (per SSE spec) if any */
-	#retryInterval = null;
-	/**
-	* Asynchronous stream of parsed SSE events for the active connection.
-	*
-	* Stays open across {@link disconnect} and automatic reconnects so an existing
-	* `for await` consumer keeps receiving events after visibility resumes.
-	*
-	* Closes when:
-	* - the server ends the stream and {@link SSESessionOptions.persistent}
-	*   is false,
-	* - {@link close} is called, or
-	* - a transport error occurs with
-	*   {@link SSESessionOptions.attemptReconnect} disabled.
-	*
-	* A later {@link connect} replaces this with a new iterator when the
-	* previous one was closed. Consumers should read from `session.messages`
-	* rather than caching a reference across terminal disconnects.
-	*/
-	messages = new AsyncPushIterator();
-	constructor(url, options = {}) {
-		super();
-		const { onConnected, onDisconnected, onError, ...restOptions } = options;
-		this.#url = url;
-		this.options = {
-			...this.options,
-			...restOptions,
-			headers: {
-				...this.options.headers,
-				...options.headers
-			}
-		};
-		if (onConnected) this.on("connected", onConnected);
-		if (onDisconnected) this.on("disconnected", onDisconnected);
-		if (onError) this.on("error", onError);
-	}
-	/**
-	* Returns true if the session is active by checking if the controller is not null.
-	*/
-	get active() {
-		return this.#connectionController !== null;
-	}
-	/**
-	* Connects or reconnects to the SSE endpoint.
-	*
-	* Resolves once the HTTP stream is established and `"connected"` has been
-	* emitted. Body reading continues asynchronously in the background via the
-	* internal `#readStream` method.
-	*
-	* @throws When the fetch retry policy exhausts attempts or the connection
-	*   is superseded before the reader is handed off (in the latter case the
-	*   promise resolves without throwing).
-	*/
-	async connect() {
-		if (this.#connectionController) return;
-		this.#resetEventParser();
-		this.#ensureMessageStreamOpen();
-		const connectionController = new AbortController();
-		this.#connectionController = connectionController;
-		const { method, headers, body } = this.options;
-		const fetchOptions = {
-			method,
-			headers: headers || {},
-			signal: connectionController.signal,
-			cache: "no-store"
-		};
-		if (method === "POST") fetchOptions.body = body || null;
-		let reader;
-		try {
-			reader = await this.options.retry.run(() => this.#createReader(fetchOptions), { signal: connectionController.signal });
-		} catch (error) {
-			if (this.#connectionController !== connectionController) return;
-			this.#connectionController = null;
-			const normalizedError = normalizeError(error);
-			this.emit("disconnected", {
-				reason: "error",
-				error: normalizedError
-			});
-			this.emit("error", normalizedError);
-			this.#closeMessageStream();
-			throw error;
-		}
-		if (this.#connectionController !== connectionController) {
-			await reader.cancel();
-			return;
-		}
-		this.emit("connected", void 0);
-		this.#readStream(reader, connectionController).catch((error) => {
-			this.emit("error", error);
-		});
-	}
-	/**
-	* Disconnects only the currently active transport.
-	*
-	* `beforeDisconnect` is emitted on every invocation, even when no
-	* transport is currently active. This allows observers to react to
-	* an explicit disconnect operation.
-	*
-	* @param context - Context describing the operation initiator.
-	* @emits `beforeDisconnect` with the supplied operation context.
-	* @emits `disconnected` with reason `"disconnect"` when an active
-	* transport is actually disconnected.
-	*/
-	disconnect(context = {}) {
-		this.emit("beforeDisconnect", context);
-		if (this.#connectionController) {
-			const connectionController = this.#connectionController;
-			this.#connectionController = null;
-			connectionController.abort();
-			this.emit("disconnected", {
-				reason: "disconnect",
-				source: context.source
-			});
-		}
-		this.#resetEventParser();
-	}
-	/**
-	* Terminates the session and disables attached visibility handling until
-	* the same instance is manually {@link connect connected} again.
-	*
-	* Closes {@link messages} and emits `"closed"`.
-	*/
-	close() {
-		this.disconnect();
-		this.#closeMessageStream();
-		this.emit("closed", void 0);
-	}
-	/**
-	* Performs the HTTP request and returns a reader for the response body.
-	*
-	* {@link SSESessionOptions.onRequest} may mutate headers (for example auth
-	* tokens or `Last-Event-ID`) before the fetch runs.
-	*/
-	async #createReader(fetchOptions) {
-		const requestOptions = await this.options.onRequest(fetchOptions);
-		const response = await this.options.fetch(this.#url, requestOptions);
-		if (!response.ok) {
-			const responseCode = response.status;
-			const error = new HTTPError(responseCode, await response.text());
-			this.emit("error", error);
-			throw error;
-		}
-		if (!response.body) {
-			const error = new ResponseBodyNullError();
-			this.emit("error", error);
-			throw error;
-		}
-		return response.body.getReader();
-	}
-	/**
-	* Reads bytes from an established stream until it ends, errors, or is
-	* superseded by a newer connection.
-	*/
-	async #readStream(reader, connectionController) {
-		try {
-			while (this.#connectionController === connectionController) {
-				const { done, value } = await reader.read();
-				if (this.#connectionController !== connectionController) return;
-				if (done) {
-					this.#connectionController = null;
-					this.emit("disconnected", { reason: "remote" });
-					if (this.options.persistent) await this.connect();
-					else this.#closeMessageStream();
-					return;
-				}
-				if (!value) continue;
-				for (const event of this.options.eventParser.parseEvents(value)) {
-					if (event.retry) this.#retryInterval = event.retry;
-					this.emit("message", event);
-					this.messages.push(event);
-				}
-			}
-		} catch (error) {
-			if (connectionController !== this.#connectionController) return;
-			this.#connectionController = null;
-			const normalizedError = normalizeError(error);
-			this.emit("disconnected", {
-				reason: "error",
-				error: normalizedError
-			});
-			if (connectionController.signal.aborted) return;
-			this.emit("error", normalizedError);
-			if (this.options.attemptReconnect) {
-				if (this.#retryInterval) await new Promise((resolve) => setTimeout(resolve, this.#retryInterval));
-				await this.connect();
-			} else this.#closeMessageStream();
-		}
-	}
-	/** Clears partial SSE frames left over from an abandoned transport. */
-	#resetEventParser() {
-		this.options.eventParser.reset();
-	}
-	/**
-	* Creates a new {@link messages} iterator when the previous one was closed
-	* by a terminal disconnect or server stream end.
-	*/
-	#ensureMessageStreamOpen() {
-		if (!this.messages.closed) return;
-		this.messages = new AsyncPushIterator();
-	}
-	/** Ends the message iteration loop for the current connection span. */
-	#closeMessageStream() {
-		if (this.messages.closed) return;
-		this.messages.close();
-	}
-};
-
-//#endregion
-//#region source/template/errors.ts
+const xoTemplateNonFungibleTokenDetailsSchema = z.object({
+	capability: z.union([xoTemplateNftCapabilitySchema, z.string()]).optional().describe("The capability of the NFT. May be a known capability value or a CashASM expression resolving to a capability."),
+	commitment: z.string().optional().describe("The commitment data for the NFT, as a string or CashASM expression resolving to a commitment.")
+}).strict();
 /**
-* Formats the Zod validation failures into a single string with one line each: "- <field>: <message>" and top level failures
-* with no field path show as "(root)" for better readability.
+* Validation schema for the token configuration on inputs and outputs.
 *
-* @param issues The Zod validation failures to format.
-* @returns A human readable error string for better debugging.
+* ```
+* {
+*   "inputs|outputs": {
+*     "[id]": {
+*       "token": { }  ← this schema
+*     }
+*   }
+* }
+* ```
 */
-const buildErrorDescription = (issues) => {
-	const lines = [];
-	for (const issue of issues) {
-		const issuePath = issue.path.length > 0 ? issue.path.join(".") : "(root)";
-		const issueMessage = issue.message.startsWith("Invalid input: ") ? issue.message.slice(15) : issue.message;
-		lines.push(`- ${issuePath}: ${issueMessage}`);
-	}
-	return `\n${lines.join("\n")}`;
-};
+const xoTemplateTokenSchema = z.object({
+	category: z.string().optional().describe("The category of the token, as a string or CashASM expression resolving to a category."),
+	amount: z.union([
+		z.bigint(),
+		z.string(),
+		z.null()
+	]).optional().describe("The amount of fungible tokens as a bigint, a CashASM expression resolving to a bigint, or null indicating no FT is present."),
+	nft: xoTemplateNonFungibleTokenDetailsSchema.nullable().optional().describe("Non-fungible token configuration. Null indicates no NFT is present.")
+}).strict();
 /**
-* Thrown when the provided template does not satisfy the XOTemplate schema.
+* Validation schema for the asset amounts configuration. Used by omitChangeAmounts on inputs
+* and by balance on locking scripts, outputs, and their roles.
 */
-var TemplateInvalidError = class extends Error {
-	constructor(details) {
-		const message = `Template invalid: ${details}`;
-		super(message);
-		this.name = "TemplateInvalidError";
-	}
-};
+const xoTemplateAssetAmountsSchema = z.object({
+	satoshis: z.union([
+		satoshisSchema,
+		z.string(),
+		z.literal(true)
+	]).optional().describe("The satoshi amount. Accepts a bigint for a specific value, a CashASM expression, or true for the entire amount."),
+	fungibleTokens: z.union([
+		z.bigint(),
+		z.string(),
+		z.literal(true)
+	]).optional().describe("The fungible token amount. Accepts a bigint for a specific value, a CashASM expression, or true for the entire amount."),
+	nonfungibleTokens: z.union([
+		z.literal(0),
+		z.literal(1),
+		z.string(),
+		z.literal(true)
+	]).optional().describe("Whether an NFT is present: 0 for absent, 1 for present, a CashASM expression evaluating to 0 or 1, or true to estimate the NFT as part of the balance if present, or absent from it if not.")
+}).strict();
 /**
-* Thrown when a string passed to `deserializeTemplate` cannot be parsed as JSON.
-*/
-var TemplateJsonMalformedError = class extends Error {
-	constructor(reason) {
-		super(`Template JSON malformed, expected a valid JSON string: ${reason}`);
-		this.name = "TemplateJsonMalformedError";
-	}
-};
-/**
-* Thrown when `serializeTemplate` fails to produce a JSON string from the template.
-*/
-var TemplateSerializationFailedError = class extends Error {
-	constructor(reason) {
-		super(`Template serialization failed: ${reason}`);
-		this.name = "TemplateSerializationFailedError";
-	}
-};
-
-//#endregion
-//#region source/template/serialization.ts
-/**
-* Serializes an XOTemplate to a JSON string. Encodes `bigint` and `Uint8Array` fields in
-* Extended JSON format so they can be reconstructed by `deserializeTemplate`.
-*
-* @param template The template to serialize.
-* @returns A JSON string representation of the template.
-* @throws {TemplateSerializationFailedError} If the template cannot be serialized to JSON.
-*/
-const serializeTemplate = (template) => {
-	try {
-		return JSON.stringify(template, extendedJsonReplacer);
-	} catch (serializationError) {
-		throw new TemplateSerializationFailedError(serializationError instanceof Error ? serializationError.message : "unknown error while serializing template");
-	}
-};
-/**
-* Deserializes a JSON string back into an XOTemplate object. Restores `bigint` and
-* `Uint8Array` fields encoded in Extended JSON format by `serializeTemplate`.
-*
-* @param serializedTemplate - A JSON string of an XOTemplate object.
-* @returns The reconstructed XOTemplate object.
-* @throws {TemplateJsonMalformedError} If the serialized template is not valid JSON.
-*/
-const deserializeTemplate = (serializedTemplate) => {
-	try {
-		return JSON.parse(serializedTemplate, extendedJsonReviver);
-	} catch (parsingError) {
-		throw new TemplateJsonMalformedError(parsingError instanceof Error ? parsingError.message : "unknown error while deserializing template");
-	}
-};
-
-//#endregion
-//#region source/template/identifier.ts
-/**
-* Generates a deterministic template identifier by hashing the template.
-*
-* Note: This expects a template that has been validated by `parseTemplate`.
-*
-* @param template - The template to generate an identifier for.
-* @returns The sha256 hex identifier for the template.
-*/
-const generateTemplateIdentifier = (template) => {
-	const serializedTemplate = serializeTemplate(template);
-	return binToHex(sha256.hash(utf8ToBin(serializedTemplate)));
-};
-
-//#endregion
-//#region source/template/schemas.ts
-/**
-* Validation schema for a BCH VM version identifier. Defines the set of known BCH VM versions
-* that XO templates declare support for.
-*
-* Uses `BchVmVersions` from `@xo-cash/types` so template validation stays aligned with the
-* `BchVmVersion` type.
-*
-* ```
-* {
-*   "supported": [ "BCH_2025_05" ]  ← each value
-* }
-* ```
-*/
-const bchVmVersionSchema = z.enum(BchVmVersions);
-/**
-* Validation schema for the capability of a non-fungible token. Defines the three capability
-* types supported on BCH: minting tokens can create new NFTs, mutable tokens can update their
-* commitment, and none tokens cannot be changed after creation.
+* Validation schema for the state configuration shared by a locking script and its individual roles.
+* Declares which variables and secrets are tracked in the on-chain state for a given participant.
 *
 * ```
 * {
-*   "inputs|outputs": {
+*   "lockingScripts": {
 *     "[id]": {
-*       "token": {
-*         "nft": {
-*           "capability": "minting"  ← this schema
+*       "state": { "variables": [], "secrets": [] }  ← this schema
+*       "roles": {
+*         "[roleId]": {
+*           "state": { "variables": [], "secrets": [] }  ← this schema
 *         }
 *       }
 *     }
@@ -1494,609 +1023,1356 @@ const bchVmVersionSchema = z.enum(BchVmVersions);
 * }
 * ```
 */
-const xoTemplateNftCapabilitySchema = z.enum(XOTemplateNftCapabilities);
+const xoTemplateStateSchema = z.object({
+	variables: z.array(z.string()).optional().describe("List of variable identifiers to track in state."),
+	secrets: z.array(z.string()).optional().describe("List of secret identifiers to track in state.")
+}).strict();
 /**
-* Validation schema for a BCH locking script type. Defines the standard locking script types
-* supported on BCH.
+* Validation schema for a role definition for a locking script.
 *
 * ```
 * {
 *   "lockingScripts": {
 *     "[id]": {
-*       "lockingType": "p2pkh"  ← this schema
+*       "roles": {
+*         "[roleId]": { }  ← this schema
+*       }
 *     }
 *   }
 * }
 * ```
 */
-const xoTemplateLockingTypeSchema = z.enum(XOTemplateLockingTypes);
-/**
-* Validation schema for a primitive type identifier.
-* Accepts values from XOTemplatePrimitiveTypes for the `hint` field on constants, variables, and data.
-*/
-const xoTemplatePrimitiveTypeSchema = z.enum(XOTemplatePrimitiveTypes);
-/**
-* Validation schema for byte array fields i.e. Uint8Array instance.
-*/
-const uint8ArraySchema = z.instanceof(Uint8Array).describe("A sequence of unsigned 8-bit integers expressed as a Uint8Array.");
-/**
-* Validation schema for the Satoshis type i.e. bigint.
-*/
-const satoshisSchema = z.bigint().describe("A satoshi amount expressed as a bigint.");
-/** Maximum character length for name fields on view properties. */
-const VIEW_PROPERTIES_NAME_MAX_LENGTH = 1e3;
-/** Maximum character length for description fields on view properties. */
-const VIEW_PROPERTIES_DESCRIPTION_MAX_LENGTH = 5e3;
-/** Maximum character length for icon fields on view properties. */
-const VIEW_PROPERTIES_ICON_MAX_LENGTH = 1e3;
-/**
-* Validation schema for view properties shared across many template elements i.e. name, description, icon.
-* Extended by most other schemas in this file.
-*/
-const xoTemplateViewPropertiesSchema = z.object({
-	name: z.string().max(VIEW_PROPERTIES_NAME_MAX_LENGTH).describe("A short human-readable label for this element."),
-	description: z.string().max(VIEW_PROPERTIES_DESCRIPTION_MAX_LENGTH).describe("A human-readable explanation of what this element does and when it is relevant."),
-	icon: z.string().max(VIEW_PROPERTIES_ICON_MAX_LENGTH).optional().describe("An optional icon identifier or URL for this element.")
-}).strict();
-/**
-* Validation schema for the base intent structure. Describes the common data parameters shared
-* by all intent types regardless of what they target.
-*
-* An optional templateIdentifier allows the intent to reference a target defined in a different
-* template, enabling cross-template interaction.
-*
-* Extended by: xoTemplateActionIntentSchema, xoTemplateOutputIntentSchema,
-* xoTemplateLockingScriptIntentSchema.
-*/
-const xoTemplateIntentSchema = z.object({
-	templateIdentifier: z.string().optional().describe("Optional identifier for the template used in this intent. If not provided, uses the current template."),
-	role: z.string().optional().describe("Optional identifier for the role used in this intent."),
-	generate: z.array(z.string()).optional().describe("Identifiers for items to generate when this intent is resolved, e.g. keys or secrets."),
-	variables: z.array(z.record(z.string(), z.unknown())).optional().describe("Variable values to apply when this intent is resolved."),
-	constants: z.array(z.record(z.string(), z.unknown())).optional().describe("Constant values to apply when this intent is resolved."),
-	secrets: z.array(z.record(z.string(), z.unknown())).optional().describe("Secret values to apply when this intent is resolved.")
+const xoTemplateLockingScriptRoleSchema = xoTemplateViewPropertiesSchema.partial().extend({
+	state: xoTemplateStateSchema.optional().describe("List of items to track as state for this role."),
+	actions: z.array(xoTemplateActionIntentSchema).optional().describe("List of action references available to this role."),
+	balance: xoTemplateAssetAmountsSchema.partial().optional().describe("Estimated ownership in the optional set of asset amounts specified."),
+	selectable: z.boolean().optional().describe("Whether outputs locked to this script should be available for coin selection."),
+	relevant: z.union([z.boolean(), z.string()]).optional().describe("Whether this output or locking script should be tracked by the engine, When omitted, the engine treats this field as true.Accepts true, false, or a CashASM expression that evaluates to a boolean relevance value."),
+	privacy: z.union([z.number(), z.string()]).optional().describe("Privacy level for outputs locked to this script. A numeric level or a CashASM expression that evaluates to a privacy level.")
 }).strict();
 /**
-* Validation schema for an action intent. Extends the base intent structure with an action
-* identifier. Used in locking script action lists and in the template's start array.
+* Validation schema for a locking script definition.
 *
 * ```
 * {
-*   "start": [
-*     { "action": "..." }  ← this schema
-*   ],
 *   "lockingScripts": {
-*     "[id]": {
-*       "actions": [
-*         { "action": "..." }  ← this schema
-*       ],
-*       "roles": {
-*         "[roleId]": {
-*           "actions": [
-*             { "action": "..." }  ← this schema
-*           ]
-*         }
-*       }
-*     }
+*     "[id]": { }  ← this schema
 *   }
 * }
 * ```
 */
-const xoTemplateActionIntentSchema = xoTemplateIntentSchema.extend({ action: z.string().describe("The identifier for the intended action.") }).strict();
+const xoTemplateLockingScriptSchema = xoTemplateViewPropertiesSchema.extend({
+	lockingType: xoTemplateLockingTypeSchema.optional().describe("The type of locking mechanism. Defaults to p2s if not specified."),
+	lockingBytecode: z.string().describe("The locking script bytecode."),
+	unlockingBytecode: z.string().optional().describe("Optional default unlocking bytecode when used in automatic coin selection."),
+	actions: z.array(xoTemplateActionIntentSchema).optional().describe("The actions available for this locking script."),
+	state: xoTemplateStateSchema.optional().describe("List of items to track as state for all participants."),
+	balance: xoTemplateAssetAmountsSchema.partial().optional().describe("Estimated ownership in the optional set of asset amounts specified."),
+	selectable: z.boolean().optional().describe("Whether outputs locked to this script should be available for coin selection."),
+	privacy: z.union([z.number(), z.string()]).optional().describe("Privacy level for outputs locked to this script. A numeric level or a CashASM expression that evaluates to a privacy level."),
+	roles: z.record(z.string(), xoTemplateLockingScriptRoleSchema).optional().describe("Specific context for each role participating in this locking script.")
+}).strict();
 /**
-* Validation schema for an output intent. Extends the base intent structure with an output
-* identifier. Used in the template's defaults block.
+* Validation schema for an input definition in the template. Extends view properties with optional
+* satoshi value, token configuration, and other transaction level fields.
 *
 * ```
 * {
-*   "defaults": {
-*     "change": { "output": "..." }  ← this schema
+*   "inputs": {
+*     "[id]": { }  ← this schema
 *   }
 * }
 * ```
 */
-const xoTemplateOutputIntentSchema = xoTemplateIntentSchema.extend({ output: z.string().describe("The identifier for the intended output.") }).strict();
-/**
-* Validation schema for a locking script intent. Extends the base intent structure with
-* a locking script identifier.
-*
-* @todo The location of this schema in the template JSON is not yet determined.
-*/
-const xoTemplateLockingScriptIntentSchema = xoTemplateIntentSchema.extend({ lockingScript: z.string().describe("The identifier for the intended locking script.") }).strict();
+const xoTemplateInputSchema = xoTemplateViewPropertiesSchema.extend({
+	valueSatoshis: z.union([satoshisSchema, z.string()]).optional().describe("The amount of satoshis for this input as a bigint or a CashASM expression resolving to the amount."),
+	token: xoTemplateTokenSchema.nullable().optional().describe("Token configuration for this input."),
+	sequenceNumber: z.union([z.number(), z.string()]).optional().describe("The sequence number of this input as a specific number or a CashASM expression."),
+	unlockingScript: z.string().optional().describe("Identifier of the unlocking script to use for the UTXO provided for this input."),
+	omitChangeAmounts: xoTemplateAssetAmountsSchema.optional().describe("Amount of change that should be omitted from the automatic change handling. WARNING: Setting this can result in loss of funds!")
+}).strict();
 /**
-* Validation schema for the slot count configuration on a role requirement. Declares how many
-* participants of a given role are needed. min sets the lower bound and max sets the upper bound.
-* When max is absent, there is no upper limit.
+* Validation schema for an output definition. Extends the locking script schema so that
+* every output inherits the same locking script fields and adds output-specific fields.
 *
 * ```
 * {
-*   "actions": {
-*     "[id]": {
-*       "requirements": {
-*         "participants": [
-*           { "slots": { "min": 1, "max": 1 } }  ← this schema
-*         ]
-*       }
-*     }
+*   "outputs": {
+*     "[id]": { }  ← this schema
 *   }
 * }
 * ```
 */
-const xoTemplateRoleSlotsRequirementsSchema = z.object({
-	min: z.number().describe("Minimum number of participants required for this role."),
-	max: z.number().optional().describe("Maximum number of participants allowed for this role. Undefined means unlimited.")
+const xoTemplateOutputSchema = xoTemplateLockingScriptSchema.omit({
+	lockingType: true,
+	lockingBytecode: true,
+	unlockingBytecode: true
+}).extend({
+	lockingScript: z.string().describe("Identifier of the locking script to use for this output."),
+	valueSatoshis: z.union([satoshisSchema, z.string()]).optional().describe("The amount of satoshis for this output as a bigint or a CashASM expression resolving to the amount."),
+	token: xoTemplateTokenSchema.nullable().optional().describe("Token configuration for this output.")
 }).strict();
 /**
-* Validation schema for the capability requirements declared on a role within an action.
-* Describes what data, secrets, or state the role is responsible for providing when participating in an action.
+* Validation schema for a transaction input reference for a transaction definition.
 *
 * ```
 * {
-*   "actions": {
+*   "transactions": {
 *     "[id]": {
-*       "roles": {
-*         "[roleId]": {
-*           "requirements": { "variables": [], "secrets": [] }  ← this schema
-*         }
-*       }
+*       "inputs": [
+*         { "input": "..." }  ← this schema
+*       ]
 *     }
 *   }
 * }
 * ```
 */
-const xoTemplateActionRoleRequirementsSchema = z.object({
-	variables: z.array(z.string()).optional().describe("List of variable identifiers required for this role."),
-	secrets: z.array(z.string()).optional().describe("List of secret identifiers required for this role.")
+const xoTemplateTransactionInputSchema = z.object({
+	input: z.string().describe("The input definition identifier."),
+	inputIndex: z.number().optional().describe("Optional index of this input in the transaction.")
 }).strict();
 /**
-* Validation schema for a role-specific definition within an action.
-* All view properties are optional.
+* Validation schema for a transaction output reference for a transaction definition.
 *
 * ```
 * {
-*   "actions": {
+*   "transactions": {
 *     "[id]": {
-*       "roles": {
-*         "[roleId]": { }  ← this schema
-*       }
+*       "outputs": [
+*         { "output": "..." }  ← this schema
+*       ]
 *     }
 *   }
 * }
 * ```
 */
-const xoTemplateActionRoleSchema = xoTemplateViewPropertiesSchema.partial().extend({
-	generate: z.array(z.string()).optional().describe("Identifiers for data items that should be generated for this role when participating in the action."),
-	requirements: xoTemplateActionRoleRequirementsSchema.optional().describe("The requirements for this role within this action.")
+const xoTemplateTransactionOutputSchema = z.object({
+	output: z.string().describe("The output definition identifier."),
+	outputIndex: z.number().optional().describe("Optional index of this output in the transaction.")
 }).strict();
 /**
-* Validation schema for a role participation requirement in an action's requirements block.
+* Validation schema for role-specific data for a transaction definition.
 *
 * ```
 * {
-*   "actions": {
+*   "transactions": {
 *     "[id]": {
-*       "requirements": {
-*         "participants": [
-*           { "role": "...", "slots": { } }  ← this schema
-*         ]
+*       "roles": {
+*         "[roleId]": { }  ← this schema
 *       }
 *     }
 *   }
 * }
 * ```
 */
-const xoTemplateRoleSlotSchema = z.object({
-	role: z.string().describe("The role identifier that this requirement applies to."),
-	slots: xoTemplateRoleSlotsRequirementsSchema.describe("Slot configuration specifying how many participants of this role are required.")
+const xoTemplateTransactionRoleDataSchema = xoTemplateViewPropertiesSchema.partial().extend({
+	inputs: z.array(xoTemplateTransactionInputSchema).optional().describe("The inputs required for this role."),
+	outputs: z.array(xoTemplateTransactionOutputSchema).optional().describe("The outputs required for this role.")
 }).strict();
 /**
-* Validation schema for the requirements of an action.
+* Validation schema for a transaction template definition.
 *
 * ```
 * {
-*   "actions": {
-*     "[id]": {
-*       "requirements": { "variables": [], "participants": [], "secrets": [] }  ← this schema
-*     }
+*   "transactions": {
+*     "[id]": { }  ← this schema
 *   }
 * }
 * ```
 */
-const xoTemplateActionRequirementsSchema = z.object({
-	variables: z.array(z.string()).optional().describe("List of variable identifiers required for this action."),
-	participants: z.array(xoTemplateRoleSlotSchema).optional().describe("The participants required for this action."),
-	secrets: z.array(z.string()).optional().describe("The secrets required for this action.")
+const xoTemplateTransactionSchema = xoTemplateViewPropertiesSchema.extend({
+	version: z.number().optional().describe("The version of the transaction."),
+	locktime: z.union([z.number(), z.string()]).optional().describe("The locktime for this transaction as a specific number or a CashASM expression."),
+	inputs: z.array(xoTemplateTransactionInputSchema).describe("The inputs for this transaction."),
+	outputs: z.array(xoTemplateTransactionOutputSchema).describe("The outputs for this transaction."),
+	roles: z.record(z.string(), xoTemplateTransactionRoleDataSchema).optional().describe("Specific context for each role participating in this transaction."),
+	composable: z.boolean().optional().describe("Whether this transaction can be composed with other transactions.")
 }).strict();
 /**
-* Validation schema for an action definition.
+* Validation schema for a constant value definition.
 *
 * ```
 * {
-*   "actions": {
+*   "constants": {
 *     "[id]": { }  ← this schema
 *   }
 * }
 * ```
 */
-const xoTemplateActionSchema = xoTemplateViewPropertiesSchema.extend({
-	roles: z.record(z.string(), xoTemplateActionRoleSchema).optional().describe("Specific context for each role participating in this action."),
-	requirements: xoTemplateActionRequirementsSchema.optional().describe("The requirements for this action."),
-	conditions: z.array(z.string()).optional().describe("Conditions that must be met for this action to be available."),
-	transaction: z.string().optional().describe("The identifier of the transaction this action produces, referencing an entry in the template's transactions."),
-	data: z.string().optional().describe("The identifier of the data field this action produces, referencing an entry in the template's data.")
+const xoTemplateConstantSchema = xoTemplateViewPropertiesSchema.extend({
+	type: xoTemplatePrimitiveTypeSchema.describe("The data type of this constant."),
+	value: z.unknown().describe("The value of this constant."),
+	hint: z.unknown().optional().describe("An optional hint to help apps and users understand what this constant represents.")
 }).strict();
 /**
-* Validation schema for the non-fungible token configuration within a token field.
+* Validation schema for a data field definition.
 *
 * ```
 * {
-*   "inputs|outputs": {
-*     "[id]": {
-*       "token": {
-*         "nft": { }  ← this schema
-*       }
-*     }
+*   "data": {
+*     "[id]": { }  ← this schema
 *   }
 * }
 * ```
 */
-const xoTemplateNonFungibleTokenDetailsSchema = z.object({
-	capability: z.union([xoTemplateNftCapabilitySchema, z.string()]).optional().describe("The capability of the NFT. May be a known capability value or a CashASM expression resolving to a capability."),
-	commitment: z.string().optional().describe("The commitment data for the NFT, as a string or CashASM expression resolving to a commitment.")
+const xoTemplateDataSchema = z.object({
+	type: xoTemplatePrimitiveTypeSchema.describe("The data type of this data field."),
+	value: z.unknown().describe("The value for this data field."),
+	hint: z.unknown().optional().describe("An optional hint to help apps and users understand this data field.")
 }).strict();
 /**
-* Validation schema for the token configuration on inputs and outputs.
+* Validation schema for an import default value intent. Extends the base intent with optional
+* view properties that the engine evaluates at runtime to produce human-readable output.
 *
 * ```
 * {
-*   "inputs|outputs": {
+*   "variables": {
 *     "[id]": {
-*       "token": { }  ← this schema
+*       "importDefaultValue": { }  ← this schema
 *     }
 *   }
 * }
 * ```
 */
-const xoTemplateTokenSchema = z.object({
-	category: z.string().optional().describe("The category of the token, as a string or CashASM expression resolving to a category."),
-	amount: z.union([
-		z.bigint(),
-		z.string(),
-		z.null()
-	]).optional().describe("The amount of fungible tokens as a bigint, a CashASM expression resolving to a bigint, or null indicating no FT is present."),
-	nft: xoTemplateNonFungibleTokenDetailsSchema.nullable().optional().describe("Non-fungible token configuration. Null indicates no NFT is present.")
-}).strict();
-/**
-* Validation schema for the asset amounts configuration. Used by omitChangeAmounts on inputs
-* and by balance on locking scripts, outputs, and their roles.
-*/
-const xoTemplateAssetAmountsSchema = z.object({
-	satoshis: z.union([
-		satoshisSchema,
-		z.string(),
-		z.literal(true)
-	]).optional().describe("The satoshi amount. Accepts a bigint for a specific value, a CashASM expression, or true for the entire amount."),
-	fungibleTokens: z.union([
-		z.bigint(),
-		z.string(),
-		z.literal(true)
-	]).optional().describe("The fungible token amount. Accepts a bigint for a specific value, a CashASM expression, or true for the entire amount."),
-	nonfungibleTokens: z.union([
-		z.literal(0),
-		z.literal(1),
-		z.string(),
-		z.literal(true)
-	]).optional().describe("Whether an NFT is present: 0 for absent, 1 for present, a CashASM expression evaluating to 0 or 1, or true to estimate the NFT as part of the balance if present, or absent from it if not.")
-}).strict();
+const xoTemplateImportDefaultValueSchema = xoTemplateIntentSchema.extend(xoTemplateViewPropertiesSchema.partial().shape).strict();
 /**
-* Validation schema for the state configuration shared by a locking script and its individual roles.
-* Declares which variables and secrets are tracked in the on-chain state for a given participant.
+* Validation schema for a variable definition.
 *
 * ```
 * {
-*   "lockingScripts": {
-*     "[id]": {
-*       "state": { "variables": [], "secrets": [] }  ← this schema
-*       "roles": {
-*         "[roleId]": {
-*           "state": { "variables": [], "secrets": [] }  ← this schema
-*         }
-*       }
-*     }
+*   "variables": {
+*     "[id]": { }  ← this schema
 *   }
 * }
 * ```
 */
-const xoTemplateStateSchema = z.object({
-	variables: z.array(z.string()).optional().describe("List of variable identifiers to track in state."),
-	secrets: z.array(z.string()).optional().describe("List of secret identifiers to track in state.")
+const xoTemplateVariableSchema = xoTemplateViewPropertiesSchema.extend({
+	type: xoTemplatePrimitiveTypeSchema.optional().describe("The data type of this variable."),
+	hint: z.unknown().optional().describe("A hint to help users understand what value to provide."),
+	importDefaultValue: xoTemplateImportDefaultValueSchema.optional().describe("A neutral intent that the engine uses to populate the default value for this variable.")
 }).strict();
 /**
-* Validation schema for a role definition for a locking script.
+* Validation schema for a resource reference attached to a template element. Extends view
+* properties with a URL pointing to external documentation or tooling.
 *
 * ```
 * {
-*   "lockingScripts": {
-*     "[id]": {
-*       "roles": {
-*         "[roleId]": { }  ← this schema
-*       }
-*     }
-*   }
+*   "resources": [
+*     { "name": "...", "description": "...", "url": "..." }  ← this schema
+*   ]
 * }
 * ```
 */
-const xoTemplateLockingScriptRoleSchema = xoTemplateViewPropertiesSchema.partial().extend({
-	state: xoTemplateStateSchema.optional().describe("List of items to track as state for this role."),
-	actions: z.array(xoTemplateActionIntentSchema).optional().describe("List of action references available to this role."),
-	balance: xoTemplateAssetAmountsSchema.partial().optional().describe("Estimated ownership in the optional set of asset amounts specified."),
-	selectable: z.boolean().optional().describe("Whether outputs locked to this script should be available for coin selection."),
-	relevant: z.union([z.boolean(), z.string()]).optional().describe("Whether this output or locking script should be tracked by the engine, When omitted, the engine treats this field as true.Accepts true, false, or a CashASM expression that evaluates to a boolean relevance value."),
-	privacy: z.union([z.number(), z.string()]).optional().describe("Privacy level for outputs locked to this script. A numeric level or a CashASM expression that evaluates to a privacy level.")
-}).strict();
+const xoTemplateResourceSchema = xoTemplateViewPropertiesSchema.extend({ url: z.string().describe("The URL for this resource.") }).strict();
 /**
-* Validation schema for a locking script definition.
+* Validation schema for an icon reference.
 *
 * ```
 * {
-*   "lockingScripts": {
-*     "[id]": { }  ← this schema
-*   }
+*   "icons": [
+*     { "name": "...", "hash": "..." }  ← this schema
+*   ]
 * }
 * ```
 */
-const xoTemplateLockingScriptSchema = xoTemplateViewPropertiesSchema.extend({
-	lockingType: xoTemplateLockingTypeSchema.optional().describe("The type of locking mechanism. Defaults to p2s if not specified."),
-	lockingBytecode: z.string().describe("The locking script bytecode."),
-	unlockingBytecode: z.string().optional().describe("Optional default unlocking bytecode when used in automatic coin selection."),
-	actions: z.array(xoTemplateActionIntentSchema).optional().describe("The actions available for this locking script."),
-	state: xoTemplateStateSchema.optional().describe("List of items to track as state for all participants."),
-	balance: xoTemplateAssetAmountsSchema.partial().optional().describe("Estimated ownership in the optional set of asset amounts specified."),
-	selectable: z.boolean().optional().describe("Whether outputs locked to this script should be available for coin selection."),
-	privacy: z.union([z.number(), z.string()]).optional().describe("Privacy level for outputs locked to this script. A numeric level or a CashASM expression that evaluates to a privacy level."),
-	roles: z.record(z.string(), xoTemplateLockingScriptRoleSchema).optional().describe("Specific context for each role participating in this locking script.")
-}).strict();
+const xoTemplateIconSchema = xoTemplateViewPropertiesSchema.pick({ name: true }).extend({ hash: z.string().describe("The identifier of the icon.") }).strict();
 /**
-* Validation schema for an input definition in the template. Extends view properties with optional
-* satoshi value, token configuration, and other transaction level fields.
+* Validation schema for the defaults block of a template.
 *
 * ```
 * {
-*   "inputs": {
-*     "[id]": { }  ← this schema
-*   }
+*   "defaults": { }  ← this schema
 * }
 * ```
 */
-const xoTemplateInputSchema = xoTemplateViewPropertiesSchema.extend({
-	valueSatoshis: z.union([satoshisSchema, z.string()]).optional().describe("The amount of satoshis for this input as a bigint or a CashASM expression resolving to the amount."),
-	token: xoTemplateTokenSchema.nullable().optional().describe("Token configuration for this input."),
-	sequenceNumber: z.union([z.number(), z.string()]).optional().describe("The sequence number of this input as a specific number or a CashASM expression."),
-	unlockingScript: z.string().optional().describe("Identifier of the unlocking script to use for the UTXO provided for this input."),
-	omitChangeAmounts: xoTemplateAssetAmountsSchema.optional().describe("Amount of change that should be omitted from the automatic change handling. WARNING: Setting this can result in loss of funds!")
+const xoTemplateDefaultsSchema = z.object({
+	change: xoTemplateOutputIntentSchema.optional().describe("Instructions for how to construct automated change output."),
+	address: xoTemplateLockingScriptIntentSchema.optional().describe("Configure the default intent structure for creating receiving addresses / locking scripts."),
+	receive: xoTemplateOutputIntentSchema.optional().describe("Configure the default intent structure for creating receive outputs.")
 }).strict();
 /**
-* Validation schema for an output definition. Extends the locking script schema so that
-* every output inherits the same locking script fields and adds output-specific fields.
-*
-* ```
-* {
-*   "outputs": {
-*     "[id]": { }  ← this schema
-*   }
-* }
-* ```
+* Validation schema for the full XOTemplate type.
 */
-const xoTemplateOutputSchema = xoTemplateLockingScriptSchema.omit({
-	lockingType: true,
-	lockingBytecode: true,
-	unlockingBytecode: true
-}).extend({
-	lockingScript: z.string().describe("Identifier of the locking script to use for this output."),
-	valueSatoshis: z.union([satoshisSchema, z.string()]).optional().describe("The amount of satoshis for this output as a bigint or a CashASM expression resolving to the amount."),
-	token: xoTemplateTokenSchema.nullable().optional().describe("Token configuration for this output.")
+const xoTemplateSchema = xoTemplateViewPropertiesSchema.extend({
+	$schema: z.string().describe("The URI that identifies the JSON Schema used by this template. This enables documentation, autocompletion, and validation in JSON documents."),
+	version: z.string().optional().describe("A string identifying the version of this template."),
+	supported: z.array(bchVmVersionSchema).min(1).describe("The BCH VM versions that this template supports. At least one version is required."),
+	defaults: xoTemplateDefaultsSchema.optional().describe("Optional default settings used in this template."),
+	roles: z.record(z.string(), xoTemplateViewPropertiesSchema).describe("The roles defined in this template."),
+	start: z.array(xoTemplateActionIntentSchema).describe("A list of entry points defining which actions are available at the start."),
+	actions: z.record(z.string(), xoTemplateActionSchema).describe("The actions defined in this template."),
+	data: z.record(z.string(), xoTemplateDataSchema).optional().describe("The data fields defined in this template."),
+	transactions: z.record(z.string(), xoTemplateTransactionSchema).optional().describe("The transaction templates defined in this template."),
+	inputs: z.record(z.string(), xoTemplateInputSchema).describe("The inputs defined in this template."),
+	outputs: z.record(z.string(), xoTemplateOutputSchema).describe("The outputs defined in this template."),
+	lockingScripts: z.record(z.string(), xoTemplateLockingScriptSchema).describe("The locking script templates defined in this template."),
+	scripts: z.record(z.string(), z.string()).describe("Scripts used in this template. Keys are script identifiers, values are bytecode or CashASM expressions."),
+	constants: z.record(z.string(), xoTemplateConstantSchema).optional().describe("The constants defined in this template."),
+	variables: z.record(z.string(), xoTemplateVariableSchema).optional().describe("The variables that must be provided for use in the template's scripts."),
+	resources: z.array(xoTemplateResourceSchema).optional().describe("Resource references providing external documentation or tooling links."),
+	icons: z.array(xoTemplateIconSchema).optional().describe("The icons available for use throughout the template."),
+	scenarios: z.unknown().optional().describe("The scenarios defined in this template.")
 }).strict();
+
+//#endregion
+//#region source/invitation/schemas.ts
 /**
-* Validation schema for a transaction input reference for a transaction definition.
+* Validation schema for a reference to an input or output in an earlier commit that a later item extends.
 *
 * ```
 * {
-*   "transactions": {
-*     "[id]": {
-*       "inputs": [
-*         { "input": "..." }  ← this schema
-*       ]
+*   "inputs|outputs": [
+*     {
+*       "mergesWith": { "commitIdentifier": "...", "itemIndex": 0 }  ← this schema
 *     }
-*   }
+*   ]
 * }
 * ```
 */
-const xoTemplateTransactionInputSchema = z.object({
-	input: z.string().describe("The input definition identifier."),
-	inputIndex: z.number().optional().describe("Optional index of this input in the transaction.")
+const xoInvitationMergesWithReferenceSchema = z.object({
+	commitIdentifier: z.string().describe("The commit that holds the item being extended."),
+	itemIndex: z.number().int().nonnegative().describe("The position of the extended item inside that commit.")
 }).strict();
 /**
-* Validation schema for a transaction output reference for a transaction definition.
-*
-* ```
-* {
-*   "transactions": {
-*     "[id]": {
-*       "outputs": [
-*         { "output": "..." }  ← this schema
-*       ]
-*     }
-*   }
-* }
-* ```
+* Validation schema for the template action a commit is resolved against when it differs from the invitation root.
 */
-const xoTemplateTransactionOutputSchema = z.object({
-	output: z.string().describe("The output definition identifier."),
-	outputIndex: z.number().optional().describe("Optional index of this output in the transaction.")
+const xoInvitationActionReferenceSchema = z.object({
+	templateIdentifier: z.string().describe("The template that defines the action."),
+	actionIdentifier: z.string().describe("The action inside that template.")
 }).strict();
 /**
-* Validation schema for role-specific data for a transaction definition.
-*
-* ```
-* {
-*   "transactions": {
-*     "[id]": {
-*       "roles": {
-*         "[roleId]": { }  ← this schema
-*       }
-*     }
-*   }
-* }
-* ```
+* Validation schema for a variable value. Matches every value type an invitation variable can hold.
 */
-const xoTemplateTransactionRoleDataSchema = xoTemplateViewPropertiesSchema.partial().extend({
-	inputs: z.array(xoTemplateTransactionInputSchema).optional().describe("The inputs required for this role."),
-	outputs: z.array(xoTemplateTransactionOutputSchema).optional().describe("The outputs required for this role.")
+const xoInvitationVariableValueSchema = z.union([
+	z.bigint(),
+	z.boolean(),
+	z.number(),
+	z.string()
+]).describe("A variable value expressed as a bigint, boolean, number, or string.");
+/**
+* Validation schema for a variable supplied by a commit.
+*/
+const xoInvitationVariableSchema = z.object({
+	variableIdentifier: z.string().describe("The template variable this value is for."),
+	value: xoInvitationVariableValueSchema,
+	roleIdentifier: z.string().exactOptional().describe("The role this variable belongs to."),
+	mergesWith: xoInvitationMergesWithReferenceSchema.exactOptional()
 }).strict();
 /**
-* Validation schema for a transaction template definition.
+* Validation schema for a cashtoken.
+*/
+const outputTokenSchema = z.object({
+	category: uint8ArraySchema.describe("The token category."),
+	amount: z.bigint().describe("The fungible token amount."),
+	nft: z.object({
+		capability: xoTemplateNftCapabilitySchema,
+		commitment: uint8ArraySchema.describe("The NFT commitment.")
+	}).strict().exactOptional()
+}).strict();
+/**
+* Validation schema for a cashtoken supplied by a commit output. Every field is optional because a later commit may
+* supply the fields an earlier commit left unset.
+*/
+const xoInvitationTokenSchema = z.object({
+	amount: z.bigint().exactOptional().describe("The fungible token amount."),
+	category: uint8ArraySchema.exactOptional().describe("The token category."),
+	nft: z.object({
+		capability: xoTemplateNftCapabilitySchema.exactOptional(),
+		commitment: uint8ArraySchema.exactOptional().describe("The NFT commitment.")
+	}).strict().exactOptional()
+}).strict();
+/**
+* Validation schema for a value one participant resolved from its own template key, such as a public key or a signature.
+*/
+const xoInvitationResolutionSchema = z.object({
+	resolutionIdentifier: z.string().describe("The key operation this value resolves, such as someKey.public_key."),
+	value: uint8ArraySchema.describe("The resolved bytes."),
+	roleIdentifier: z.string().exactOptional().describe("The role whose key this value was resolved from.")
+}).strict();
+/**
+* Validation schema for a transaction input supplied by a commit.
+*/
+const xoInvitationInputSchema = z.object({
+	outpointIndex: z.number().int().nonnegative().exactOptional().describe("The index of the spent output in its transaction."),
+	outpointTransactionHash: uint8ArraySchema.exactOptional().describe("The hash of the transaction that holds the spent output."),
+	sequenceNumber: z.number().int().nonnegative().exactOptional().describe("The sequence number of this input."),
+	unlockingBytecode: uint8ArraySchema.exactOptional().describe("The script that unlocks the spent output."),
+	inputIdentifier: z.string().exactOptional().describe("The template input this input fills."),
+	transactionIndex: z.number().int().nonnegative().exactOptional().describe("The position this input must take in the final transaction."),
+	roleIdentifier: z.string().exactOptional().describe("The role this input belongs to."),
+	resolutions: z.array(xoInvitationResolutionSchema).exactOptional(),
+	mergesWith: xoInvitationMergesWithReferenceSchema.exactOptional(),
+	valueSatoshis: satoshisSchema.exactOptional(),
+	token: outputTokenSchema.exactOptional()
+}).strict();
+/**
+* Validation schema for a transaction output supplied by a commit.
+*/
+const xoInvitationOutputSchema = z.object({
+	lockingBytecode: uint8ArraySchema.exactOptional().describe("The locking bytecode of this output."),
+	valueSatoshis: satoshisSchema.exactOptional(),
+	token: xoInvitationTokenSchema.exactOptional(),
+	outputIdentifier: z.string().exactOptional().describe("The template output this output fills."),
+	transactionIndex: z.number().int().nonnegative().exactOptional().describe("The position this output must take in the final transaction."),
+	secretIdentifier: z.string().exactOptional().describe("The secret used to derive this output."),
+	roleIdentifier: z.string().exactOptional().describe("The role this output belongs to."),
+	mergesWith: xoInvitationMergesWithReferenceSchema.exactOptional()
+}).strict();
+/**
+* Validation schema for the data a commit supplies.
+*/
+const xoInvitationCommitDataSchema = z.object({
+	transactionVersion: z.number().int().nonnegative().exactOptional().describe("The transaction version."),
+	transactionLocktime: z.number().int().nonnegative().exactOptional().describe("The transaction locktime."),
+	variables: z.array(xoInvitationVariableSchema).exactOptional(),
+	inputs: z.array(xoInvitationInputSchema).exactOptional(),
+	outputs: z.array(xoInvitationOutputSchema).exactOptional(),
+	resolutions: z.array(xoInvitationResolutionSchema).exactOptional(),
+	roleIdentifier: z.string().exactOptional().describe("The role the committing entity takes in the action with this commit.")
+}).strict();
+/**
+* Validation schema for one signed commit in an invitation.
+*/
+const xoInvitationCommitSchema = z.object({
+	commitIdentifier: z.string().describe("The identifier of this commit."),
+	previousCommitIdentifier: z.string().optional().prefault(void 0).describe("The commit this one follows. Undefined on the first commit."),
+	entityIdentifier: z.string().describe("The entity that made this commit."),
+	createdAtTimestamp: z.number().int().nonnegative().describe("When this commit was created, as a Unix timestamp in milliseconds."),
+	actionReference: xoInvitationActionReferenceSchema.exactOptional(),
+	data: xoInvitationCommitDataSchema,
+	signature: z.string().describe("The signature over this commit."),
+	expiresAtTimestamp: z.number().int().nonnegative().describe("When this commit expires, as a Unix timestamp in milliseconds."),
+	memo: z.string().exactOptional().describe("A free text note attached to this commit.")
+}).strict();
+/**
+* Validation schema for a transaction result that has been created but not broadcast.
+*/
+const xoInvitationTransactionCreatedResultSchema = z.object({
+	transactionHash: z.string().describe("The hash of the created transaction."),
+	createdAtTimestamp: z.number().int().nonnegative().describe("When the transaction was created, as a Unix timestamp in milliseconds."),
+	createdByEntityIdentifier: z.string().describe("The entity that created the transaction."),
+	createdBySignature: z.string().describe("The signature over the created result.")
+}).strict();
+/**
+* Validation schema for a transaction result that has been created and broadcast.
+*/
+const xoInvitationTransactionBroadcastedResultSchema = xoInvitationTransactionCreatedResultSchema.extend({
+	broadcastedAtTimestamp: z.number().int().nonnegative().describe("When the transaction was broadcasted, as a Unix timestamp in milliseconds."),
+	broadcastedByEntityIdentifier: z.string().describe("The entity that broadcasted the transaction."),
+	broadcastedBySignature: z.string().describe("The signature over the broadcasted result.")
+}).strict();
+/**
+* Validation schema for a data result created on an invitation.
+*/
+const xoInvitationCreatedResultSchema = z.object({
+	value: xoInvitationVariableValueSchema,
+	createdAtTimestamp: z.number().int().nonnegative().describe("When the value was created, as a Unix timestamp in milliseconds."),
+	createdByEntityIdentifier: z.string().describe("The entity that created the value."),
+	createdBySignature: z.string().describe("The signature over the created value.")
+}).strict();
+/**
+* Validation schema for the results created on an invitation.
+*/
+const xoInvitationResultSchema = z.object({
+	transactions: z.record(z.string(), z.union([xoInvitationTransactionBroadcastedResultSchema, xoInvitationTransactionCreatedResultSchema])).exactOptional(),
+	data: z.record(z.string(), xoInvitationCreatedResultSchema).exactOptional()
+}).strict();
+/**
+* Validation schema for an invitation.
+*/
+const xoInvitationSchema = z.object({
+	invitationIdentifier: z.string().describe("The identifier of this invitation."),
+	createdAtTimestamp: z.number().int().nonnegative().describe("When this invitation was created, as a Unix timestamp in milliseconds."),
+	templateIdentifier: z.string().describe("The template this invitation uses."),
+	actionIdentifier: z.string().describe("The template action this invitation performs."),
+	commits: z.array(xoInvitationCommitSchema),
+	result: xoInvitationResultSchema.exactOptional()
+}).strict();
+
+//#endregion
+//#region source/invitation/parser.ts
+/**
+* Validates an untyped value against the XOInvitation schema and returns it as a typed invitation.
 *
-* ```
-* {
-*   "transactions": {
-*     "[id]": { }  ← this schema
-*   }
+* The schema parser returns a rebuilt copy whose keys follow the schema order. Commit signatures cover the JSON text of
+* each commit's data, and that text depends on key order, so a rebuilt copy no longer matches its signatures. Only the
+* value that was received keeps the order it was signed with.
+*
+* The received value itself is returned, not a copy, so the key order its commit signatures were made over is kept.
+*
+* @param {unknown} invitationValue - Value to validate, such as the output of Extended JSON parsing.
+* @returns {XOInvitation} - The validated invitation, as the same object that was passed in.
+* @throws {@link InvitationInvalidError} - When any field is missing, has the wrong type, or is not part of the invitation type.
+*/
+const parseInvitation = (invitationValue) => {
+	const parseResult = xoInvitationSchema.safeParse(invitationValue);
+	if (parseResult.success === false) throw new InvitationInvalidError(buildErrorDescription(parseResult.error.issues));
+	return invitationValue;
+};
+
+//#endregion
+//#region source/invitation/serialization.ts
+/**
+* Serializes an invitation for sharing. Encodes bigint and Uint8Array fields using Extended JSON.
+*
+* @param invitation Shared invitation to export.
+* @returns JSON string that {@link deserializeInvitation} can restore.
+* @throws {InvitationSerializationFailedError} When JSON serialization fails.
+*/
+const serializeInvitation = (invitation) => {
+	try {
+		return toExtendedJson(invitation);
+	} catch (serializationError) {
+		throw new InvitationSerializationFailedError(serializationError instanceof Error ? serializationError.message : "unknown error while serializing invitation");
+	}
+};
+/**
+* Deserializes a shared invitation JSON string into an invitation.
+*
+* Every field is checked against its declared type, so the returned invitation can be trusted to match
+* {@link XOInvitation}.
+*
+* @param serializedInvitation JSON produced by {@link serializeInvitation}.
+* @returns Parsed invitation whose fields match their declared types.
+* @throws {InvitationJsonMalformedError} When the string is not valid JSON.
+* @throws {InvitationInvalidError} When the parsed value does not match the XOInvitation type.
+*/
+const deserializeInvitation = (serializedInvitation) => {
+	let parsedValue;
+	try {
+		parsedValue = fromExtendedJson(serializedInvitation);
+	} catch (parsingError) {
+		throw new InvitationJsonMalformedError(parsingError instanceof Error ? parsingError.message : "unknown error while deserializing invitation");
+	}
+	return parseInvitation(parsedValue);
+};
+
+//#endregion
+//#region source/script.ts
+/**
+* Converts a script to a scriptHash.
+* @param {Uint8Array} script - The script to convert.
+* @returns {string} The scriptHash as a reversed hex string.
+*/
+const scriptToScriptHash = (script) => {
+	return binToHex(sha256.hash(script).reverse());
+};
+
+//#endregion
+//#region source/sse-session/async-push-iterator.ts
+/**
+* An async iterable queue that bridges push-based producers and pull-based consumers.
+*
+* Composes an internal {@link ReadableStream} instead of extending it, so producers
+* call {@link push} while consumers use standard async iteration (`for await...of`).
+*
+* ```ts
+* const messages = new AsyncPushIterator<SSEvent>();
+*
+* // Producer (elsewhere)
+* messages.push(event);
+*
+* // Consumer
+* for await (const event of messages) {
+*   handle(event);
 * }
 * ```
+*
+* {@link Symbol.asyncIterator} returns `stream.values({ preventCancel: true })` so
+* breaking out of `for await...of` does not cancel the underlying stream. That
+* matters for long-lived sessions where the producer keeps pushing after a consumer
+* stops reading early (for example, test helpers that only collect a fixed count).
 */
-const xoTemplateTransactionSchema = xoTemplateViewPropertiesSchema.extend({
-	version: z.number().optional().describe("The version of the transaction."),
-	locktime: z.union([z.number(), z.string()]).optional().describe("The locktime for this transaction as a specific number or a CashASM expression."),
-	inputs: z.array(xoTemplateTransactionInputSchema).describe("The inputs for this transaction."),
-	outputs: z.array(xoTemplateTransactionOutputSchema).describe("The outputs for this transaction."),
-	roles: z.record(z.string(), xoTemplateTransactionRoleDataSchema).optional().describe("Specific context for each role participating in this transaction."),
-	composable: z.boolean().optional().describe("Whether this transaction can be composed with other transactions.")
-}).strict();
+var AsyncPushIterator = class {
+	/** ReadableStream backing the async iterator returned from {@link Symbol.asyncIterator}. */
+	#stream;
+	/** Controller used to enqueue values and close the stream from {@link push} and {@link close}. */
+	#controller;
+	/** When true, no more values are accepted and iteration eventually completes. */
+	#closed = false;
+	constructor() {
+		this.#stream = new ReadableStream({ start: (controller) => {
+			this.#controller = controller;
+		} });
+	}
+	/**
+	* Flag indicating if the iterator is closed.
+	*/
+	get closed() {
+		return this.#closed;
+	}
+	/**
+	* Enqueues a value for the consumer.
+	*
+	* After {@link close}, pushes are silently dropped.
+	*
+	* @param value - The next value to yield from the iterator.
+	*/
+	push(value) {
+		if (this.#closed) return;
+		this.#controller?.enqueue(value);
+	}
+	/**
+	* Causes any future interactions with the associated stream to error with {@link error}.
+	* Calling this will also clear the pending values immediately, so iterators that were listening will not receive them.
+	*
+	* @param error - The error to throw from the stream.
+	*/
+	error(error) {
+		if (this.#closed) return;
+		this.#closed = true;
+		this.#controller?.error(error);
+	}
+	/**
+	* Ends the stream.
+	*
+	* Marks the iterator closed so future {@link push} calls are ignored.
+	* Buffered values are still yielded before iteration completes.
+	*/
+	close() {
+		this.#closed = true;
+		try {
+			this.#controller?.close();
+		} catch {}
+	}
+	/**
+	* Returns an async iterator over the composed stream.
+	*
+	* Uses `preventCancel: true` so early `break` from `for await...of` does not
+	* close the stream and block later pushes.
+	*
+	* Because values are discarded after being read, only a single consumer is supported.
+	* Additional consumers will receive a stream lock error. Unread values will be preserved until {@link close} is called.
+	*/
+	[Symbol.asyncIterator]() {
+		return this.#stream.values({ preventCancel: true });
+	}
+};
+
+//#endregion
+//#region source/sse-session/constants.ts
+/**
+* Regex that splits decoded SSE text into lines.
+*
+* The SSE wire format is line-oriented (`field: value` per line). Servers may
+* send `\r\n` (HTTP default), `\n` (Unix), or `\r` (legacy Mac). Matching all
+* three keeps parsing correct regardless of platform or server implementation.
+*/
+const SSE_LINE_ENDINGS = /\r\n|\r|\n/;
+/**
+* Regex that matches the single optional leading space in an SSE field value.
+*
+* Per the SSE spec, `field: value` may include one space immediately after the
+* colon; that space is not part of the value. Used with `.replace()` to strip
+* it when parsing lines such as `data: hello` → `hello`.
+*/
+const SSE_FIELD_VALUE_REGEX = /^ /;
+/**
+* Regex that matches a trailing newline at the end of a string.
+*
+* Multiple `data:` lines in one event are joined with `\n`. When the event is
+* completed, this removes any stray trailing newline so callers receive the
+* payload without an extra line break at the end.
+*/
+const SSE_TRAILING_NEWLINE_REGEX = /\n$/;
+/**
+* The newline character used when normalizing SSE text internally.
+*
+* Used to join consecutive `data:` lines into one payload and to reassemble
+* buffered partial lines between streamed chunks before the next parse call.
+*/
+const NEW_LINE = "\n";
+/**
+* Default exponential backoff options for the SSE session.
+*/
+const SSE_SESSION_EXPONENTIAL_BACKOFF_DEFAULTS = {
+	baseDelay: 250,
+	maxDelay: 1e4,
+	maxAttempts: 0,
+	growthRate: 1.3,
+	jitter: .3
+};
+/**
+* Default attempt reconnect flag for the SSE session.
+* @default true
+*/
+const SSE_SESSION_ATTEMPT_RECONNECT_DEFAULT = true;
+/**
+* Default persistent flag for the SSE session.
+* @default false
+*/
+const SSE_SESSION_PERSISTENT_DEFAULT = false;
+
+//#endregion
+//#region source/sse-session/sse-event-parser.ts
+/**
+* Incrementally parses Server-Sent Events (SSE) from streamed byte chunks.
+*
+* SSE payloads are line-oriented: each event is a sequence of `field: value`
+* lines terminated by a blank line. This parser accepts arbitrary chunk
+* boundaries from a live HTTP response body and emits only complete events.
+*
+* Typical usage is one parser instance per connection, calling {@link parseEvents}
+* for each chunk received from the stream:
+*
+* ```ts
+* const parser = new SSEEventParser();
+*
+* for await (const chunk of response.body) {
+*   for (const event of parser.parseEvents(chunk)) {
+*     // handle event.data, event.event, event.id, event.retry
+*   }
+* }
+* ```
+*
+* Supported fields follow the SSE spec: `data`, `event`, `id`, and `retry`.
+* Multiple `data:` lines in one event are joined with `\n`. An event is only
+* emitted once a blank line is seen and at least one `data` field was collected.
+*/
+var SSEEventParser = class {
+	#textDecoder;
+	/** Bytes from a partial line or incomplete event, carried over to the next chunk. */
+	#messageBuffer = "";
+	/**
+	* Creates a parser for one SSE stream.
+	*
+	* Inject custom encoders in tests or when a non-default character encoding
+	* is required; production callers can rely on the defaults.
+	*
+	* @param options - Optional text encoders for decode/encode of stream bytes.
+	*/
+	constructor(options = {}) {
+		this.#textDecoder = options.textDecoder ?? new TextDecoder();
+	}
+	/**
+	* Clears any buffered bytes from a partial line or incomplete event.
+	*
+	* Call when abandoning a transport so the next connection does not prepend
+	* stale bytes to incoming chunks.
+	*/
+	reset() {
+		this.#messageBuffer = "";
+		this.#textDecoder.decode();
+	}
+	/**
+	* Parses all complete SSE events contained in a newly received chunk.
+	*
+	* The chunk is appended to any bytes buffered from earlier calls. Complete
+	* events (blank-line delimited blocks with at least one `data` field) are
+	* returned immediately; any trailing partial line or in-progress event stays
+	* in the internal buffer until a later chunk completes it.
+	*
+	* @param chunk - Newly received SSE stream bytes.
+	* @returns Zero or more complete parsed SSE events from this chunk.
+	*/
+	parseEvents(chunk) {
+		const lines = this.#getBufferedLines(chunk);
+		const eventLines = lines.slice(0, -1);
+		const events = [];
+		let event = {};
+		let processedLineCount = 0;
+		for (const [index, line] of eventLines.entries()) {
+			if (line === "") {
+				if (event.data !== void 0) {
+					events.push(this.#completeEvent(event));
+					event = {};
+					processedLineCount = index + 1;
+				}
+				continue;
+			}
+			this.#parseLine(line, event);
+		}
+		this.#storeRemainingLines(lines, processedLineCount);
+		return events;
+	}
+	/**
+	* Appends a new chunk to the buffered bytes and splits the combined payload
+	* into lines.
+	*
+	* Accepts `\r\n`, `\r`, and `\n` line endings so events parse correctly
+	* regardless of server or platform conventions.
+	*/
+	#getBufferedLines(chunk) {
+		this.#messageBuffer += this.#textDecoder.decode(chunk, { stream: true });
+		return this.#messageBuffer.split(SSE_LINE_ENDINGS);
+	}
+	/**
+	* Parses one SSE field line into an in-progress event.
+	*
+	* Lines without a colon are ignored. A single optional space after the colon
+	* is stripped from the field value, per the SSE spec.
+	*/
+	#parseLine(line, event) {
+		const colonIndex = line.indexOf(":");
+		if (colonIndex === -1) return;
+		const field = line.slice(0, colonIndex);
+		const value = line.slice(colonIndex + 1).replace(SSE_FIELD_VALUE_REGEX, "");
+		switch (field) {
+			case "data":
+				event.data = event.data ? `${event.data}${NEW_LINE}${value}` : value;
+				return;
+			case "event":
+				event.event = value;
+				return;
+			case "id":
+				event.id = value;
+				return;
+			case "retry":
+				this.#parseRetry(value, event);
+				return;
+		}
+	}
+	/**
+	* Applies a numeric `retry:` field to an in-progress event.
+	*
+	* Non-numeric values are ignored rather than failing the parse.
+	*/
+	#parseRetry(value, event) {
+		const retry = parseInt(value, 10);
+		if (!isNaN(retry)) event.retry = retry;
+	}
+	/**
+	* Constructs a completed SSE event from accumulated fields.
+	*
+	* Trims a trailing newline from multi-line `data` values so callers receive
+	* the payload without an extra line break at the end.
+	*/
+	#completeEvent(event) {
+		return {
+			...event,
+			data: event.data?.replace(SSE_TRAILING_NEWLINE_REGEX, "")
+		};
+	}
+	/**
+	* Preserves incomplete trailing lines for the next received chunk.
+	*
+	* Only lines that were fully processed (through a completed event boundary)
+	* are discarded; the remainder is re-encoded into {@link messageBuffer}.
+	*/
+	#storeRemainingLines(lines, processedLineCount) {
+		this.#messageBuffer = lines.slice(processedLineCount).join(NEW_LINE);
+	}
+};
+
+//#endregion
+//#region source/sse-session/errors.ts
+/**
+* Error thrown when a response body is null
+*/
+var ResponseBodyNullError = class extends Error {
+	constructor() {
+		super("Response body is null");
+		this.name = "ResponseBodyNullError";
+	}
+};
+/**
+* Error thrown when an HTTP error occurs
+*/
+var HTTPError = class extends Error {
+	constructor(status, message) {
+		super(`HTTP error! Status: ${status} - ${message}`);
+		this.name = "HTTPError";
+	}
+};
+/**
+* Error thrown when a plugin's unsubscribe function is not a function
+*/
+var SSESessionUnsubscribePluginNotAFunctionError = class extends Error {
+	constructor(pluginName) {
+		super(`${pluginName}'s unsubscribe function is not a function`);
+		this.name = "SSESessionUnsubscribePluginNotAFunctionError";
+	}
+};
+
+//#endregion
+//#region source/sse-session/sse-session.ts
+/**
+* A fetch-based Server-Sent Events (SSE) client with reconnect and optional
+* browser tab visibility handling.
+*
+* Each session maintains one HTTP streaming connection at a time. Incoming
+* bytes are parsed into {@link SSEvent} objects and delivered through two
+* surfaces:
+*
+* - **Events** — `"connected"`, `"message"`, `"disconnected"`, `"error"`,
+*   and `"closed"` on the session itself (extends {@link EventEmitter}).
+* - **Messages** — {@link messages}, an async iterable for `for await...of`
+*   consumers.
+*
+* Typical usage:
+*
+* ```ts
+* const session = await SSESession.create("/events");
+*
+* session.on("message", (event) => console.log(event.data));
+*
+* for await (const event of session.messages) {
+*   handle(event);
+* }
+* ```
+*
+* ## Lifecycle
+*
+* - {@link connect} opens (or reopens) the transport. It resolves once the
+*   HTTP stream is established; reading continues in the background.
+* - {@link disconnect} stops the in-flight fetch without ending the session.
+*   Used internally for tab visibility. The {@link messages} iterator stays
+*   open so an existing consumer resumes when the tab becomes visible again.
+* - {@link close} aborts the transport, closes {@link messages}, and emits
+*   `"closed"`.
+*
+* Automatic reconnect is controlled by {@link SSESessionOptions.persistent}
+* (server closed the stream) and
+* {@link SSESessionOptions.attemptReconnect} (transport error).
+*
+* ## Connection supersession
+*
+* Each {@link connect} will create a new controller if one does not exist. Otherwise,
+* it will return immediately.
+*/
+var SSESession = class SSESession extends EventEmitter {
+	/**
+	* Creates a session and waits until the first connection is established.
+	*
+	* @param url - The SSE endpoint URL.
+	* @param options - Configuration merged with instance defaults.
+	* @returns A connected session.
+	* @throws When the initial connection cannot be established.
+	*/
+	static async create(url, options = {}) {
+		const session = new SSESession(url, options);
+		await session.connect();
+		return session;
+	}
+	/**
+	* Enables SSE resume semantics by sending `Last-Event-ID` on reconnect.
+	*
+	* Listens for incoming `"message"` events and remembers the most recent
+	* {@link SSEvent.id}. On every subsequent connect or reconnect, the session's
+	* {@link onRequest} hook is wrapped so that header is attached when an id is
+	* known, allowing the server to replay only events the client has not yet
+	* received.
+	*
+	* The existing {@link onRequest} callback is preserved and runs after the
+	* header is applied, so auth or other header mutations continue to work.
+	*
+	* Since this relies on listening to the `"message"` event, this should ideally
+	* be called before "{@link connect} is called so no messages (and no ids) are missed.
+	*
+	* ```ts
+	* const session = new SSESession(url);
+	* SSESession.addLastEventIdReconnect(session);
+	* await session.connect();
+	* // Reconnects send Last-Event-ID once an event with an id is received.
+	* ```
+	*
+	* @param session - The session to instrument.
+	* @returns The same session, for chaining.
+	*/
+	static addLastEventIdReconnect(session) {
+		if (session.plugins.has(SSESession.addLastEventIdReconnect)) {
+			const removeListener = session.plugins.get(SSESession.addLastEventIdReconnect);
+			if (typeof removeListener !== "function") throw new SSESessionUnsubscribePluginNotAFunctionError("addLastEventIdReconnect");
+			return {
+				session,
+				removeListener
+			};
+		}
+		let lastEventId;
+		const messageListener = (event) => {
+			lastEventId = event.id ?? lastEventId;
+		};
+		session.on("message", messageListener);
+		const originalOnRequest = session.options.onRequest;
+		let enabled = true;
+		session.options.onRequest = async (request) => {
+			if (lastEventId && enabled) request.headers = {
+				...request.headers,
+				"Last-Event-ID": lastEventId
+			};
+			return originalOnRequest(request);
+		};
+		const removeListener = () => {
+			enabled = false;
+			session.off("message", messageListener);
+			if (session.plugins.get(SSESession.addLastEventIdReconnect) === removeListener) session.plugins.delete(SSESession.addLastEventIdReconnect);
+		};
+		session.plugins.set(SSESession.addLastEventIdReconnect, removeListener);
+		return {
+			session,
+			removeListener
+		};
+	}
+	/**
+	* Pauses and resumes a session based on browser tab visibility.
+	*
+	* Uses the Page Visibility API (`document.visibilitychange`):
+	*
+	* - **hidden** — {@link disconnect} stops the active fetch. {@link messages}
+	*   stays open; `"disconnected"` fires but `"closed"` does not.
+	* - **visible** — {@link connect} re-establishes the stream if needed.
+	*
+	* This controller will not re-connect if the session was disconnected by something else.
+	*
+	* No-op in non-browser environments where `document` is undefined.
+	*
+	* @param session - The session to manage.
+	*/
+	static addBrowserVisibilityHandler(session) {
+		if (typeof document === "undefined") return { session };
+		if (session.plugins.has(SSESession.addBrowserVisibilityHandler)) {
+			const removeListener = session.plugins.get(SSESession.addBrowserVisibilityHandler);
+			if (typeof removeListener !== "function") throw new SSESessionUnsubscribePluginNotAFunctionError("addBrowserVisibilityHandler");
+			return {
+				session,
+				removeListener
+			};
+		}
+		const reconnectOnVisible = async () => {
+			if (document.visibilityState === "visible") {
+				document.removeEventListener("visibilitychange", reconnectOnVisible);
+				await session.connect();
+			}
+		};
+		const disableOnExternalDisconnect = ({ source }) => {
+			if (source !== SSESession.addBrowserVisibilityHandler) document.removeEventListener("visibilitychange", reconnectOnVisible);
+		};
+		const handleVisibilityChange = async () => {
+			if (!session.active) return;
+			if (document.visibilityState === "hidden") {
+				document.addEventListener("visibilitychange", reconnectOnVisible);
+				session.disconnect({ source: SSESession.addBrowserVisibilityHandler });
+			}
+		};
+		document.addEventListener("visibilitychange", handleVisibilityChange);
+		session.on("beforeDisconnect", disableOnExternalDisconnect);
+		const removeListener = () => {
+			document.removeEventListener("visibilitychange", handleVisibilityChange);
+			document.removeEventListener("visibilitychange", reconnectOnVisible);
+			session.off("beforeDisconnect", disableOnExternalDisconnect);
+			if (session.plugins.get(SSESession.addBrowserVisibilityHandler) === removeListener) session.plugins.delete(SSESession.addBrowserVisibilityHandler);
+		};
+		session.plugins.set(SSESession.addBrowserVisibilityHandler, removeListener);
+		return {
+			session,
+			removeListener
+		};
+	}
+	/** SSE endpoint URL for this session. */
+	#url;
+	/**
+	* Per-instance configuration.
+	*
+	* Defaults live on the instance field (not a shared static) so each session
+	* gets its own {@link SSEEventParser} and {@link ExponentialBackoff}.
+	*/
+	options = {
+		fetch: (...args) => fetch(...args),
+		method: "GET",
+		headers: {
+			Accept: "text/event-stream",
+			"Cache-Control": "no-cache"
+		},
+		body: new FormData(),
+		onRequest: (request) => Promise.resolve(request),
+		retry: new ExponentialBackoff({ ...SSE_SESSION_EXPONENTIAL_BACKOFF_DEFAULTS }),
+		attemptReconnect: SSE_SESSION_ATTEMPT_RECONNECT_DEFAULT,
+		persistent: SSE_SESSION_PERSISTENT_DEFAULT,
+		eventParser: new SSEEventParser()
+	};
+	/**
+	* Registered plugins for the session.
+	* This can be used to prevent duplicate plugins from being added to the session.
+	* The value for a plugin is arbitrary, for example a function that removes the plugin.
+	*/
+	plugins = /* @__PURE__ */ new Map();
+	/** AbortController for the currently active fetch, if any. */
+	#connectionController = null;
+	/** The server's requested retry interval in milliseconds (per SSE spec) if any */
+	#retryInterval = null;
+	/**
+	* Asynchronous stream of parsed SSE events for the active connection.
+	*
+	* Stays open across {@link disconnect} and automatic reconnects so an existing
+	* `for await` consumer keeps receiving events after visibility resumes.
+	*
+	* Closes when:
+	* - the server ends the stream and {@link SSESessionOptions.persistent}
+	*   is false,
+	* - {@link close} is called, or
+	* - a transport error occurs with
+	*   {@link SSESessionOptions.attemptReconnect} disabled.
+	*
+	* A later {@link connect} replaces this with a new iterator when the
+	* previous one was closed. Consumers should read from `session.messages`
+	* rather than caching a reference across terminal disconnects.
+	*/
+	messages = new AsyncPushIterator();
+	constructor(url, options = {}) {
+		super();
+		const { onConnected, onDisconnected, onError, ...restOptions } = options;
+		this.#url = url;
+		this.options = {
+			...this.options,
+			...restOptions,
+			headers: {
+				...this.options.headers,
+				...options.headers
+			}
+		};
+		if (onConnected) this.on("connected", onConnected);
+		if (onDisconnected) this.on("disconnected", onDisconnected);
+		if (onError) this.on("error", onError);
+	}
+	/**
+	* Returns true if the session is active by checking if the controller is not null.
+	*/
+	get active() {
+		return this.#connectionController !== null;
+	}
+	/**
+	* Connects or reconnects to the SSE endpoint.
+	*
+	* Resolves once the HTTP stream is established and `"connected"` has been
+	* emitted. Body reading continues asynchronously in the background via the
+	* internal `#readStream` method.
+	*
+	* @throws When the fetch retry policy exhausts attempts or the connection
+	*   is superseded before the reader is handed off (in the latter case the
+	*   promise resolves without throwing).
+	*/
+	async connect() {
+		if (this.#connectionController) return;
+		this.#resetEventParser();
+		this.#ensureMessageStreamOpen();
+		const connectionController = new AbortController();
+		this.#connectionController = connectionController;
+		const { method, headers, body } = this.options;
+		const fetchOptions = {
+			method,
+			headers: headers || {},
+			signal: connectionController.signal,
+			cache: "no-store"
+		};
+		if (method === "POST") fetchOptions.body = body || null;
+		let reader;
+		try {
+			reader = await this.options.retry.run(() => this.#createReader(fetchOptions), { signal: connectionController.signal });
+		} catch (error) {
+			if (this.#connectionController !== connectionController) return;
+			this.#connectionController = null;
+			const normalizedError = normalizeError(error);
+			this.emit("disconnected", {
+				reason: "error",
+				error: normalizedError
+			});
+			this.emit("error", normalizedError);
+			this.#closeMessageStream();
+			throw error;
+		}
+		if (this.#connectionController !== connectionController) {
+			await reader.cancel();
+			return;
+		}
+		this.emit("connected", void 0);
+		this.#readStream(reader, connectionController).catch((error) => {
+			this.emit("error", error);
+		});
+	}
+	/**
+	* Disconnects only the currently active transport.
+	*
+	* `beforeDisconnect` is emitted on every invocation, even when no
+	* transport is currently active. This allows observers to react to
+	* an explicit disconnect operation.
+	*
+	* @param context - Context describing the operation initiator.
+	* @emits `beforeDisconnect` with the supplied operation context.
+	* @emits `disconnected` with reason `"disconnect"` when an active
+	* transport is actually disconnected.
+	*/
+	disconnect(context = {}) {
+		this.emit("beforeDisconnect", context);
+		if (this.#connectionController) {
+			const connectionController = this.#connectionController;
+			this.#connectionController = null;
+			connectionController.abort();
+			this.emit("disconnected", {
+				reason: "disconnect",
+				source: context.source
+			});
+		}
+		this.#resetEventParser();
+	}
+	/**
+	* Terminates the session and disables attached visibility handling until
+	* the same instance is manually {@link connect connected} again.
+	*
+	* Closes {@link messages} and emits `"closed"`.
+	*/
+	close() {
+		this.disconnect();
+		this.#closeMessageStream();
+		this.emit("closed", void 0);
+	}
+	/**
+	* Performs the HTTP request and returns a reader for the response body.
+	*
+	* {@link SSESessionOptions.onRequest} may mutate headers (for example auth
+	* tokens or `Last-Event-ID`) before the fetch runs.
+	*/
+	async #createReader(fetchOptions) {
+		const requestOptions = await this.options.onRequest(fetchOptions);
+		const response = await this.options.fetch(this.#url, requestOptions);
+		if (!response.ok) {
+			const responseCode = response.status;
+			const error = new HTTPError(responseCode, await response.text());
+			this.emit("error", error);
+			throw error;
+		}
+		if (!response.body) {
+			const error = new ResponseBodyNullError();
+			this.emit("error", error);
+			throw error;
+		}
+		return response.body.getReader();
+	}
+	/**
+	* Reads bytes from an established stream until it ends, errors, or is
+	* superseded by a newer connection.
+	*/
+	async #readStream(reader, connectionController) {
+		try {
+			while (this.#connectionController === connectionController) {
+				const { done, value } = await reader.read();
+				if (this.#connectionController !== connectionController) return;
+				if (done) {
+					this.#connectionController = null;
+					this.emit("disconnected", { reason: "remote" });
+					if (this.options.persistent) await this.connect();
+					else this.#closeMessageStream();
+					return;
+				}
+				if (!value) continue;
+				for (const event of this.options.eventParser.parseEvents(value)) {
+					if (event.retry) this.#retryInterval = event.retry;
+					this.emit("message", event);
+					this.messages.push(event);
+				}
+			}
+		} catch (error) {
+			if (connectionController !== this.#connectionController) return;
+			this.#connectionController = null;
+			const normalizedError = normalizeError(error);
+			this.emit("disconnected", {
+				reason: "error",
+				error: normalizedError
+			});
+			if (connectionController.signal.aborted) return;
+			this.emit("error", normalizedError);
+			if (this.options.attemptReconnect) {
+				if (this.#retryInterval) await new Promise((resolve) => setTimeout(resolve, this.#retryInterval));
+				await this.connect();
+			} else this.#closeMessageStream();
+		}
+	}
+	/** Clears partial SSE frames left over from an abandoned transport. */
+	#resetEventParser() {
+		this.options.eventParser.reset();
+	}
+	/**
+	* Creates a new {@link messages} iterator when the previous one was closed
+	* by a terminal disconnect or server stream end.
+	*/
+	#ensureMessageStreamOpen() {
+		if (!this.messages.closed) return;
+		this.messages = new AsyncPushIterator();
+	}
+	/** Ends the message iteration loop for the current connection span. */
+	#closeMessageStream() {
+		if (this.messages.closed) return;
+		this.messages.close();
+	}
+};
+
+//#endregion
+//#region source/template/errors.ts
 /**
-* Validation schema for a constant value definition.
-*
-* ```
-* {
-*   "constants": {
-*     "[id]": { }  ← this schema
-*   }
-* }
-* ```
+* Thrown when the provided template does not satisfy the XOTemplate schema.
 */
-const xoTemplateConstantSchema = xoTemplateViewPropertiesSchema.extend({
-	type: xoTemplatePrimitiveTypeSchema.describe("The data type of this constant."),
-	value: z.unknown().describe("The value of this constant."),
-	hint: z.unknown().optional().describe("An optional hint to help apps and users understand what this constant represents.")
-}).strict();
+var TemplateInvalidError = class extends Error {
+	constructor(details) {
+		const message = `Template invalid: ${details}`;
+		super(message);
+		this.name = "TemplateInvalidError";
+	}
+};
 /**
-* Validation schema for a data field definition.
-*
-* ```
-* {
-*   "data": {
-*     "[id]": { }  ← this schema
-*   }
-* }
-* ```
+* Thrown when a string passed to `deserializeTemplate` cannot be parsed as JSON.
 */
-const xoTemplateDataSchema = z.object({
-	type: xoTemplatePrimitiveTypeSchema.describe("The data type of this data field."),
-	value: z.unknown().describe("The value for this data field."),
-	hint: z.unknown().optional().describe("An optional hint to help apps and users understand this data field.")
-}).strict();
+var TemplateJsonMalformedError = class extends Error {
+	constructor(reason) {
+		super(`Template JSON malformed, expected a valid JSON string: ${reason}`);
+		this.name = "TemplateJsonMalformedError";
+	}
+};
 /**
-* Validation schema for an import default value intent. Extends the base intent with optional
-* view properties that the engine evaluates at runtime to produce human-readable output.
-*
-* ```
-* {
-*   "variables": {
-*     "[id]": {
-*       "importDefaultValue": { }  ← this schema
-*     }
-*   }
-* }
-* ```
+* Thrown when `serializeTemplate` fails to produce a JSON string from the template.
 */
-const xoTemplateImportDefaultValueSchema = xoTemplateIntentSchema.extend(xoTemplateViewPropertiesSchema.partial().shape).strict();
+var TemplateSerializationFailedError = class extends Error {
+	constructor(reason) {
+		super(`Template serialization failed: ${reason}`);
+		this.name = "TemplateSerializationFailedError";
+	}
+};
+
+//#endregion
+//#region source/template/serialization.ts
 /**
-* Validation schema for a variable definition.
+* Serializes an XOTemplate to a JSON string. Encodes `bigint` and `Uint8Array` fields in
+* Extended JSON format so they can be reconstructed by `deserializeTemplate`.
 *
-* ```
-* {
-*   "variables": {
-*     "[id]": { }  ← this schema
-*   }
-* }
-* ```
+* @param template The template to serialize.
+* @returns A JSON string representation of the template.
+* @throws {TemplateSerializationFailedError} If the template cannot be serialized to JSON.
 */
-const xoTemplateVariableSchema = xoTemplateViewPropertiesSchema.extend({
-	type: xoTemplatePrimitiveTypeSchema.optional().describe("The data type of this variable."),
-	hint: z.unknown().optional().describe("A hint to help users understand what value to provide."),
-	importDefaultValue: xoTemplateImportDefaultValueSchema.optional().describe("A neutral intent that the engine uses to populate the default value for this variable.")
-}).strict();
+const serializeTemplate = (template) => {
+	try {
+		return JSON.stringify(template, extendedJsonReplacer);
+	} catch (serializationError) {
+		throw new TemplateSerializationFailedError(serializationError instanceof Error ? serializationError.message : "unknown error while serializing template");
+	}
+};
 /**
-* Validation schema for a resource reference attached to a template element. Extends view
-* properties with a URL pointing to external documentation or tooling.
+* Deserializes a JSON string back into an XOTemplate object. Restores `bigint` and
+* `Uint8Array` fields encoded in Extended JSON format by `serializeTemplate`.
 *
-* ```
-* {
-*   "resources": [
-*     { "name": "...", "description": "...", "url": "..." }  ← this schema
-*   ]
-* }
-* ```
+* @param serializedTemplate - A JSON string of an XOTemplate object.
+* @returns The reconstructed XOTemplate object.
+* @throws {TemplateJsonMalformedError} If the serialized template is not valid JSON.
 */
-const xoTemplateResourceSchema = xoTemplateViewPropertiesSchema.extend({ url: z.string().describe("The URL for this resource.") }).strict();
+const deserializeTemplate = (serializedTemplate) => {
+	try {
+		return JSON.parse(serializedTemplate, extendedJsonReviver);
+	} catch (parsingError) {
+		throw new TemplateJsonMalformedError(parsingError instanceof Error ? parsingError.message : "unknown error while deserializing template");
+	}
+};
+
+//#endregion
+//#region source/template/identifier.ts
 /**
-* Validation schema for an icon reference.
+* Generates a deterministic template identifier by hashing the template.
 *
-* ```
-* {
-*   "icons": [
-*     { "name": "...", "hash": "..." }  ← this schema
-*   ]
-* }
-* ```
-*/
-const xoTemplateIconSchema = xoTemplateViewPropertiesSchema.pick({ name: true }).extend({ hash: z.string().describe("The identifier of the icon.") }).strict();
-/**
-* Validation schema for the defaults block of a template.
+* Note: This expects a template that has been validated by `parseTemplate`.
 *
-* ```
-* {
-*   "defaults": { }  ← this schema
-* }
-* ```
-*/
-const xoTemplateDefaultsSchema = z.object({
-	change: xoTemplateOutputIntentSchema.optional().describe("Instructions for how to construct automated change output."),
-	address: xoTemplateLockingScriptIntentSchema.optional().describe("Configure the default intent structure for creating receiving addresses / locking scripts."),
-	receive: xoTemplateOutputIntentSchema.optional().describe("Configure the default intent structure for creating receive outputs.")
-}).strict();
-/**
-* Validation schema for the full XOTemplate type.
+* @param template - The template to generate an identifier for.
+* @returns The sha256 hex identifier for the template.
 */
-const xoTemplateSchema = xoTemplateViewPropertiesSchema.extend({
-	$schema: z.string().describe("The URI that identifies the JSON Schema used by this template. This enables documentation, autocompletion, and validation in JSON documents."),
-	version: z.string().optional().describe("A string identifying the version of this template."),
-	supported: z.array(bchVmVersionSchema).min(1).describe("The BCH VM versions that this template supports. At least one version is required."),
-	defaults: xoTemplateDefaultsSchema.optional().describe("Optional default settings used in this template."),
-	roles: z.record(z.string(), xoTemplateViewPropertiesSchema).describe("The roles defined in this template."),
-	start: z.array(xoTemplateActionIntentSchema).describe("A list of entry points defining which actions are available at the start."),
-	actions: z.record(z.string(), xoTemplateActionSchema).describe("The actions defined in this template."),
-	data: z.record(z.string(), xoTemplateDataSchema).optional().describe("The data fields defined in this template."),
-	transactions: z.record(z.string(), xoTemplateTransactionSchema).optional().describe("The transaction templates defined in this template."),
-	inputs: z.record(z.string(), xoTemplateInputSchema).describe("The inputs defined in this template."),
-	outputs: z.record(z.string(), xoTemplateOutputSchema).describe("The outputs defined in this template."),
-	lockingScripts: z.record(z.string(), xoTemplateLockingScriptSchema).describe("The locking script templates defined in this template."),
-	scripts: z.record(z.string(), z.string()).describe("Scripts used in this template. Keys are script identifiers, values are bytecode or CashASM expressions."),
-	constants: z.record(z.string(), xoTemplateConstantSchema).optional().describe("The constants defined in this template."),
-	variables: z.record(z.string(), xoTemplateVariableSchema).optional().describe("The variables that must be provided for use in the template's scripts."),
-	resources: z.array(xoTemplateResourceSchema).optional().describe("Resource references providing external documentation or tooling links."),
-	icons: z.array(xoTemplateIconSchema).optional().describe("The icons available for use throughout the template."),
-	scenarios: z.unknown().optional().describe("The scenarios defined in this template.")
-}).strict();
+const generateTemplateIdentifier = (template) => {
+	const serializedTemplate = serializeTemplate(template);
+	return binToHex(sha256.hash(utf8ToBin(serializedTemplate)));
+};
 
 //#endregion
 //#region source/template/parser.ts
@@ -2384,7 +2660,7 @@ const collectFromParsedScript = (parameters) => {
 * first seen.
 * A visited id is skipped on later encounters. Opcodes and literals are ignored. Unrelated scripts
 * in the map are not visited. An Identifier inside a nested Push is collected from that inner Push,
-* for example `<$(<ownerKey.public_key> OP_HASH160)>` collects `ownerKey.public_key`.
+* for example `<$(<someKey.public_key> OP_HASH160)>` collects `someKey.public_key`.
 *
 * @param {string} evaluation - CashAssembly evaluation or script id text to scan.
 * @param {CashAssemblyTemplateScripts} [templateScripts] - Optional template scripts map used to visit nested script ids.
@@ -3009,5 +3285,5 @@ const compileCashAssemblyString = (parameters) => {
 };
 
 //#endregion
-export { AsyncPushIterator, CashAssemblyBlockCommentUnclosedError, CashAssemblyCompilationFailedError, CashAssemblyEvaluationUnclosedError, CashAssemblyIdentifierCollisionError, CashAssemblyNumberNotSafeIntegerError, CashAssemblyPrimitiveMethodMissingError, CashAssemblyPrimitiveVariableMissingError, CashAssemblyQuotedLiteralUnclosedError, CashAssemblyRequiredVariableMissingError, CashAssemblyUnsupportedValueTypeError, CashAssemblyVariableTypeMismatchError, CashAssemblyVmNumberDecodeError, EventEmitter, ExponentialBackoff, ExponentialBackoffExternallyAbortable, ExponentialBackoffMaxRetriesHitError, ExponentialBackoffNonIntegerError, ExponentialBackoffNumberNotFiniteError, ExponentialBackoffNumberOutOfBoundsError, ExponentialBackoffNumberTooSmallError, ExponentialBackoffStoppedRetriesError, ExternallyAbortedExponentialBackoffExternalSignalAbortedError, ExternallyAbortedExponentialBackoffInternalSignalAbortedError, SSEEventParser, SSESession, TemplateInvalidError, TemplateJsonMalformedError, TemplateSerializationFailedError, VIEW_PROPERTIES_DESCRIPTION_MAX_LENGTH, VIEW_PROPERTIES_ICON_MAX_LENGTH, VIEW_PROPERTIES_NAME_MAX_LENGTH, WaitForTimeoutError, bchVmVersionSchema, buildErrorDescription, collectVariablesUsingParseScript, compileCashAssemblyString, deepFreeze, extendedJsonReplacer, extendedJsonReviver, extractCashAssemblyEvaluations, fromExtendedJson, generateTemplateIdentifier, isCashAssemblyExpression, isWithinBounds, normalizeError, parseTemplate, satoshisSchema, scriptToScriptHash, serializeTemplate, toExtendedJson, uint8ArraySchema, xoTemplateActionIntentSchema, xoTemplateActionRequirementsSchema, xoTemplateActionRoleRequirementsSchema, xoTemplateActionRoleSchema, xoTemplateActionSchema, xoTemplateAssetAmountsSchema, xoTemplateConstantSchema, xoTemplateDataSchema, xoTemplateDefaultsSchema, xoTemplateIconSchema, xoTemplateImportDefaultValueSchema, xoTemplateInputSchema, xoTemplateIntentSchema, xoTemplateLockingScriptIntentSchema, xoTemplateLockingScriptRoleSchema, xoTemplateLockingScriptSchema, xoTemplateLockingTypeSchema, xoTemplateNftCapabilitySchema, xoTemplateNonFungibleTokenDetailsSchema, xoTemplateOutputIntentSchema, xoTemplateOutputSchema, xoTemplatePrimitiveTypeSchema, xoTemplateResourceSchema, xoTemplateRoleSlotSchema, xoTemplateRoleSlotsRequirementsSchema, xoTemplateSchema, xoTemplateStateSchema, xoTemplateTokenSchema, xoTemplateTransactionInputSchema, xoTemplateTransactionOutputSchema, xoTemplateTransactionRoleDataSchema, xoTemplateTransactionSchema, xoTemplateVariableSchema, xoTemplateViewPropertiesSchema };
+export { AsyncPushIterator, CashAssemblyBlockCommentUnclosedError, CashAssemblyCompilationFailedError, CashAssemblyEvaluationUnclosedError, CashAssemblyIdentifierCollisionError, CashAssemblyNumberNotSafeIntegerError, CashAssemblyPrimitiveMethodMissingError, CashAssemblyPrimitiveVariableMissingError, CashAssemblyQuotedLiteralUnclosedError, CashAssemblyRequiredVariableMissingError, CashAssemblyUnsupportedValueTypeError, CashAssemblyVariableTypeMismatchError, CashAssemblyVmNumberDecodeError, EventEmitter, ExponentialBackoff, ExponentialBackoffExternallyAbortable, ExponentialBackoffMaxRetriesHitError, ExponentialBackoffNonIntegerError, ExponentialBackoffNumberNotFiniteError, ExponentialBackoffNumberOutOfBoundsError, ExponentialBackoffNumberTooSmallError, ExponentialBackoffStoppedRetriesError, ExternallyAbortedExponentialBackoffExternalSignalAbortedError, ExternallyAbortedExponentialBackoffInternalSignalAbortedError, InvitationInvalidError, InvitationJsonMalformedError, InvitationSerializationFailedError, SSEEventParser, SSESession, TemplateInvalidError, TemplateJsonMalformedError, TemplateSerializationFailedError, VIEW_PROPERTIES_DESCRIPTION_MAX_LENGTH, VIEW_PROPERTIES_ICON_MAX_LENGTH, VIEW_PROPERTIES_NAME_MAX_LENGTH, WaitForTimeoutError, bchVmVersionSchema, buildErrorDescription, collectVariablesUsingParseScript, compileCashAssemblyString, deepFreeze, deserializeInvitation, extendedJsonReplacer, extendedJsonReviver, extractCashAssemblyEvaluations, fromExtendedJson, generateTemplateIdentifier, isCashAssemblyExpression, isWithinBounds, normalizeError, outputTokenSchema, parseInvitation, parseTemplate, satoshisSchema, scriptToScriptHash, serializeInvitation, serializeTemplate, toExtendedJson, uint8ArraySchema, xoInvitationActionReferenceSchema, xoInvitationCommitDataSchema, xoInvitationCommitSchema, xoInvitationCreatedResultSchema, xoInvitationInputSchema, xoInvitationMergesWithReferenceSchema, xoInvitationOutputSchema, xoInvitationResolutionSchema, xoInvitationResultSchema, xoInvitationSchema, xoInvitationTokenSchema, xoInvitationTransactionBroadcastedResultSchema, xoInvitationTransactionCreatedResultSchema, xoInvitationVariableSchema, xoInvitationVariableValueSchema, xoTemplateActionIntentSchema, xoTemplateActionRequirementsSchema, xoTemplateActionRoleRequirementsSchema, xoTemplateActionRoleSchema, xoTemplateActionSchema, xoTemplateAssetAmountsSchema, xoTemplateConstantSchema, xoTemplateDataSchema, xoTemplateDefaultsSchema, xoTemplateIconSchema, xoTemplateImportDefaultValueSchema, xoTemplateInputSchema, xoTemplateIntentSchema, xoTemplateLockingScriptIntentSchema, xoTemplateLockingScriptRoleSchema, xoTemplateLockingScriptSchema, xoTemplateLockingTypeSchema, xoTemplateNftCapabilitySchema, xoTemplateNonFungibleTokenDetailsSchema, xoTemplateOutputIntentSchema, xoTemplateOutputSchema, xoTemplatePrimitiveTypeSchema, xoTemplateResourceSchema, xoTemplateRoleSlotSchema, xoTemplateRoleSlotsRequirementsSchema, xoTemplateSchema, xoTemplateStateSchema, xoTemplateTokenSchema, xoTemplateTransactionInputSchema, xoTemplateTransactionOutputSchema, xoTemplateTransactionRoleDataSchema, xoTemplateTransactionSchema, xoTemplateVariableSchema, xoTemplateViewPropertiesSchema };
 //# sourceMappingURL=index.mjs.map