@openclaw/gateway-protocol 2026.8.1 → 2026.8.2

package/README.md

@@ -23,10 +23,18 @@ protocol-version decision and coordinated client follow-through. See
 
 ## Install
 
+Use the verified stable release with an exact pin:
+
 ```bash
-npm install @openclaw/gateway-protocol
+npm install --save-exact @openclaw/gateway-protocol@2026.8.1
 ```
 
+This release declares Node.js `>=22.19.0`. See the canonical
+[installation guide](https://docs.openclaw.ai/gateway/clients#install-the-packages)
+for the matching client package, package/wire-version rules, and recovery from
+reserved `0.0.0` artifacts. Test it with the Gateway version you deploy; the root
+`openclaw` CLI has its own package versions and dist-tags.
+
 ## Entry points
 
 - `@openclaw/gateway-protocol` exports runtime validators, selected schemas, error
@@ -144,9 +152,12 @@ boundary before reading nested values.
 
 ### Machine-readable schema
 
-`protocol.schema.json` ships in the npm tarball as the generated machine-readable
+[`protocol.schema.json`](https://unpkg.com/@openclaw/gateway-protocol@2026.8.1/protocol.schema.json)
+ships in the npm tarball as the generated machine-readable
 contract. It contains the frame union, named schema definitions, and core method
 metadata. It is generated during `prepack` and is not committed to the repository.
+Download it as a file; `@openclaw/gateway-protocol/protocol.schema.json` is not an
+exported package import subpath.
 
 ### Method discovery
 

package/dist/gateway-error-details.mjs

@@ -35,7 +35,8 @@ const LEGACY_MISSING_SCOPE_PATTERN = /\bmissing scope:\s*([a-z0-9._-]+)/i;
 const SHA256_PATTERN = /^[a-fA-F0-9]{64}$/;
 /** Reads a typed cron lookup miss without parsing operator-facing prose. */
 function readCronJobNotFoundError(error) {
-	const details = asNullableRecord(asNullableRecord(error)?.details);
+	const record = asNullableRecord(error);
+	const details = asNullableRecord(record?.details);
 	if (details?.code !== GatewayErrorDetailCodes.CRON_JOB_NOT_FOUND) return null;
 	const jobId = typeof details.jobId === "string" ? details.jobId.trim() : "";
 	return jobId ? {
@@ -53,7 +54,8 @@ function buildSkillProposalRevisionChangedErrorDetails(params) {
 }
 /** Reads a stale Skill Workshop decision without parsing operator-facing prose. */
 function readSkillProposalRevisionChangedError(error) {
-	const details = asNullableRecord(asNullableRecord(error)?.details);
+	const record = asNullableRecord(error);
+	const details = asNullableRecord(record?.details);
 	if (details?.code !== GatewayErrorDetailCodes.SKILL_PROPOSAL_REVISION_CHANGED) return null;
 	const expectedRevisionHash = typeof details.expectedRevisionHash === "string" ? details.expectedRevisionHash : "";
 	const currentRevisionHash = typeof details.currentRevisionHash === "string" ? details.currentRevisionHash : "";
@@ -77,7 +79,8 @@ function readMissingScopeErrorDetails(details) {
 	};
 }
 function isMcpAppViewExpiredError(error) {
-	return asNullableRecord(asNullableRecord(error)?.details)?.code === GatewayErrorDetailCodes.MCP_APP_VIEW_EXPIRED;
+	const record = asNullableRecord(error);
+	return asNullableRecord(record?.details)?.code === GatewayErrorDetailCodes.MCP_APP_VIEW_EXPIRED;
 }
 /**
 * Reads a method-level missing-scope failure, preferring structured details.