@continuonai/rcan-ts 0.6.0 → 0.8.0

package/dist/index.d.mts

@@ -56,18 +56,18 @@ declare enum MessageType {
     HEARTBEAT = 4,
     CONFIG = 5,
     SAFETY = 6,
-    SENSOR_DATA = 7,
-    AUDIT = 8,
+    AUTH = 7,
+    ERROR = 8,
     DISCOVER = 9,
-    TRAINING_DATA = 10,
-    TRANSPARENCY = 11,
-    FEDERATION_SYNC = 12,
-    ALERT = 13,
-    TELEOP = 14,
-    CHAT = 15,
-    ERROR = 16,
+    PENDING_AUTH = 10,
+    INVOKE = 11,
+    INVOKE_RESULT = 12,
+    INVOKE_CANCEL = 13,
+    REGISTRY_REGISTER = 14,
+    REGISTRY_RESOLVE = 15,
+    TRANSPARENCY = 16,// EU AI Act Art. 13 audit record
     COMMAND_ACK = 17,
-    COMMAND_COMMIT = 18,
+    COMMAND_NACK = 18,
     ROBOT_REVOCATION = 19,
     CONSENT_REQUEST = 20,
     CONSENT_GRANT = 21,
@@ -76,7 +76,22 @@ declare enum MessageType {
     SUBSCRIBE = 24,
     UNSUBSCRIBE = 25,
     FAULT_REPORT = 26,
-    COMMAND_NACK = 27
+    KEY_ROTATION = 27,
+    COMMAND_COMMIT = 28,
+    SENSOR_DATA = 29,
+    TRAINING_CONSENT_REQUEST = 30,
+    TRAINING_CONSENT_GRANT = 31,
+    TRAINING_CONSENT_DENY = 32,
+    CONTRIBUTE_REQUEST = 33,
+    CONTRIBUTE_RESULT = 34,
+    CONTRIBUTE_CANCEL = 35,
+    TRAINING_DATA = 36,
+    /** @deprecated Use FLEET_COMMAND (23) */
+    FEDERATION_SYNC = 23,
+    /** @deprecated Use FAULT_REPORT (26) */
+    ALERT = 26,
+    /** @deprecated Use TRANSPARENCY (16) */
+    AUDIT = 16
 }
 /** §8.5 — Sender Type and Service Identity */
 type SenderType = "robot" | "human" | "cloud_function" | "system";
@@ -726,9 +741,9 @@ declare function makeTransparencyMessage(ruri: string, disclosure: string, deleg
  * §3.5 — Protocol Version Compatibility
  */
 /** The RCAN spec version this SDK implements. */
-declare const SPEC_VERSION = "1.6";
+declare const SPEC_VERSION = "1.9.0";
 /** The SDK release version. */
-declare const SDK_VERSION = "0.6.0";
+declare const SDK_VERSION = "0.8.0";
 /**
  * Validate version compatibility.
  *
@@ -1420,6 +1435,67 @@ declare function makeTrainingDataMessage(media: Array<{
  */
 declare function makeStreamChunk(streamId: string, data: Uint8Array, mimeType: string, chunkIndex: number, isFinal: boolean): Promise<RCANMessage>;
 
+/**
+ * rcan/contribute — Idle Compute Contribution messages and scope.
+ *
+ * Implements the contribute scope and message types for RCAN v1.7+.
+ * Robots can donate idle NPU/GPU/CPU compute to distributed science projects.
+ *
+ * Spec: §3 MessageTypes 33–35, Identity scope level 2.5
+ */
+
+/** Contribute scope level — between chat (2) and control (3). */
+declare const CONTRIBUTE_SCOPE_LEVEL = 2.5;
+type WorkUnitStatus = "pending" | "running" | "completed" | "failed" | "cancelled" | "preempted";
+type ComputeResource = "npu" | "gpu" | "cpu" | "sensor";
+interface ContributeRequest {
+    type: typeof MessageType.CONTRIBUTE_REQUEST;
+    request_id: string;
+    project_id: string;
+    project_name: string;
+    work_unit_id: string;
+    resource_type: ComputeResource;
+    estimated_duration_s: number;
+    priority: number;
+    payload: Record<string, unknown>;
+    timestamp: number;
+}
+interface ContributeResult {
+    type: typeof MessageType.CONTRIBUTE_RESULT;
+    request_id: string;
+    work_unit_id: string;
+    status: WorkUnitStatus;
+    resource_type: ComputeResource;
+    duration_s: number;
+    compute_units: number;
+    result_payload: Record<string, unknown>;
+    error_message?: string;
+    timestamp: number;
+}
+interface ContributeCancel {
+    type: typeof MessageType.CONTRIBUTE_CANCEL;
+    request_id: string;
+    work_unit_id: string;
+    reason: string;
+    timestamp: number;
+}
+declare function makeContributeRequest(params?: Partial<Omit<ContributeRequest, "type">>): ContributeRequest;
+declare function makeContributeResult(params?: Partial<Omit<ContributeResult, "type">>): ContributeResult;
+declare function makeContributeCancel(params?: Partial<Omit<ContributeCancel, "type">>): ContributeCancel;
+/**
+ * Check if the given scope level permits contribute operations.
+ *
+ * Contribute requires scope >= 2.5 (between chat and control).
+ */
+declare function validateContributeScope(scopeLevel: number, action?: "request" | "result" | "cancel"): boolean;
+/**
+ * Check if the given scope level preempts contribution.
+ *
+ * Any scope >= control (3.0) preempts contribute immediately.
+ * This is the P66 safety invariant — non-negotiable.
+ */
+declare function isPreemptedBy(scopeLevel: number): boolean;
+
 /**
  * rcan-ts — Official TypeScript SDK for RCAN v1.6
  * Robot Communication and Accountability Network
@@ -1432,4 +1508,4 @@ declare const VERSION = "0.6.0";
 /** @deprecated Use SPEC_VERSION from ./version instead */
 declare const RCAN_VERSION = "1.6";
 
-export { type ApprovalStatus, AuditChain, AuditError, type AuditExportRequest, type CachedKey, type ChainVerifyResult, ClockDriftError, type ClockSyncStatus, CommitmentRecord, type CommitmentRecordData, type CommitmentRecordJSON, ConfidenceGate, type ConsentRequestParams, type ConsentResponseParams, type ConsentType, DEFAULT_LOA_POLICY, DataCategory, type DelegationHop, FaultCode, type FaultReportParams, type FaultSeverity, type FederationSyncPayload, FederationSyncType, GateError, HiTLGate, type JWKEntry, type JWKSDocument, KeyStore, LevelOfAssurance, type ListResult, type LoaPolicy, type MediaChunk, MediaEncoding, MessageType, NodeClient, type OfflineCommandResult, OfflineModeManager, type OfflineState, PRODUCTION_LOA_POLICY, type PendingApproval, QoSAckTimeoutError, QoSLevel, QoSManager, type QoSResult, type QoSSendOptions, RCANAddressError, type RCANAgentConfig, type RCANConfig, RCANConfigAuthorizationError, RCANDelegationChainError, RCANError, RCANGateError, RCANMessage, type RCANMessageData, type RCANMessageEnvelope, RCANMessageError, type RCANMetadata, RCANNodeError, RCANNodeNotFoundError, RCANNodeSyncError, RCANNodeTrustError, RCANRegistryError, type RCANRegistryNode, RCANReplayAttackError, type RCANResolveResult, RCANSignatureError, RCANValidationError, RCANVersionIncompatibleError, RCAN_VERSION, type RegistrationResult, RegistryClient, type RegistryIdentity, RegistryTier, ReplayCache, type ReplayCheckResult, type ReplayableMessage, RevocationCache, type RevocationStatus, type RevocationStatusValue, type Robot, type RobotRegistration, RobotURI, RobotURIError, type RobotURIOptions, SAFETY_MESSAGE_TYPE, SDK_VERSION, SPEC_VERSION, type SafetyEvent, type SafetyMessage, type SenderType, type SignatureBlock, type StreamChunk, type TrainingConsentRequestParams, type TransparencyMessage, TransportEncoding, TransportError, TrustAnchorCache, VERSION, type ValidationResult, addDelegationHop, addMediaInline, addMediaRef, assertClockSynced, checkClockSync, checkRevocation, decodeBleFrames, decodeCompact, decodeMinimal, encodeBleFrames, encodeCompact, encodeMinimal, extractLoaFromJwt, fetchCanonicalSchema, isSafetyMessage, makeCloudRelayMessage, makeConfigUpdate, makeConsentDeny, makeConsentGrant, makeConsentRequest, makeEstopMessage, makeEstopWithQoS, makeFaultReport, makeFederationSync, makeKeyRotationMessage, makeResumeMessage, makeRevocationBroadcast, makeStopMessage, makeStreamChunk, makeTrainingConsentDeny, makeTrainingConsentGrant, makeTrainingConsentRequest, makeTrainingDataMessage, makeTransparencyMessage, selectTransport, validateConfig, validateConfigAgainstSchema, validateConfigUpdate, validateConsentMessage, validateCrossRegistryCommand, validateDelegationChain, validateLoaForScope, validateMediaChunks, validateMessage, validateNodeAgainstSchema, validateReplay, validateSafetyMessage, validateTrainingDataMessage, validateURI, validateVersionCompat };
+export { type ApprovalStatus, AuditChain, AuditError, type AuditExportRequest, CONTRIBUTE_SCOPE_LEVEL, type CachedKey, type ChainVerifyResult, ClockDriftError, type ClockSyncStatus, CommitmentRecord, type CommitmentRecordData, type CommitmentRecordJSON, type ComputeResource, ConfidenceGate, type ConsentRequestParams, type ConsentResponseParams, type ConsentType, type ContributeCancel, type ContributeRequest, type ContributeResult, DEFAULT_LOA_POLICY, DataCategory, type DelegationHop, FaultCode, type FaultReportParams, type FaultSeverity, type FederationSyncPayload, FederationSyncType, GateError, HiTLGate, type JWKEntry, type JWKSDocument, KeyStore, LevelOfAssurance, type ListResult, type LoaPolicy, type MediaChunk, MediaEncoding, MessageType, NodeClient, type OfflineCommandResult, OfflineModeManager, type OfflineState, PRODUCTION_LOA_POLICY, type PendingApproval, QoSAckTimeoutError, QoSLevel, QoSManager, type QoSResult, type QoSSendOptions, RCANAddressError, type RCANAgentConfig, type RCANConfig, RCANConfigAuthorizationError, RCANDelegationChainError, RCANError, RCANGateError, RCANMessage, type RCANMessageData, type RCANMessageEnvelope, RCANMessageError, type RCANMetadata, RCANNodeError, RCANNodeNotFoundError, RCANNodeSyncError, RCANNodeTrustError, RCANRegistryError, type RCANRegistryNode, RCANReplayAttackError, type RCANResolveResult, RCANSignatureError, RCANValidationError, RCANVersionIncompatibleError, RCAN_VERSION, type RegistrationResult, RegistryClient, type RegistryIdentity, RegistryTier, ReplayCache, type ReplayCheckResult, type ReplayableMessage, RevocationCache, type RevocationStatus, type RevocationStatusValue, type Robot, type RobotRegistration, RobotURI, RobotURIError, type RobotURIOptions, SAFETY_MESSAGE_TYPE, SDK_VERSION, SPEC_VERSION, type SafetyEvent, type SafetyMessage, type SenderType, type SignatureBlock, type StreamChunk, type TrainingConsentRequestParams, type TransparencyMessage, TransportEncoding, TransportError, TrustAnchorCache, VERSION, type ValidationResult, type WorkUnitStatus, addDelegationHop, addMediaInline, addMediaRef, assertClockSynced, checkClockSync, checkRevocation, decodeBleFrames, decodeCompact, decodeMinimal, encodeBleFrames, encodeCompact, encodeMinimal, extractLoaFromJwt, fetchCanonicalSchema, isPreemptedBy, isSafetyMessage, makeCloudRelayMessage, makeConfigUpdate, makeConsentDeny, makeConsentGrant, makeConsentRequest, makeContributeCancel, makeContributeRequest, makeContributeResult, makeEstopMessage, makeEstopWithQoS, makeFaultReport, makeFederationSync, makeKeyRotationMessage, makeResumeMessage, makeRevocationBroadcast, makeStopMessage, makeStreamChunk, makeTrainingConsentDeny, makeTrainingConsentGrant, makeTrainingConsentRequest, makeTrainingDataMessage, makeTransparencyMessage, selectTransport, validateConfig, validateConfigAgainstSchema, validateConfigUpdate, validateConsentMessage, validateContributeScope, validateCrossRegistryCommand, validateDelegationChain, validateLoaForScope, validateMediaChunks, validateMessage, validateNodeAgainstSchema, validateReplay, validateSafetyMessage, validateTrainingDataMessage, validateURI, validateVersionCompat };

package/dist/index.d.ts

@@ -56,18 +56,18 @@ declare enum MessageType {
     HEARTBEAT = 4,
     CONFIG = 5,
     SAFETY = 6,
-    SENSOR_DATA = 7,
-    AUDIT = 8,
+    AUTH = 7,
+    ERROR = 8,
     DISCOVER = 9,
-    TRAINING_DATA = 10,
-    TRANSPARENCY = 11,
-    FEDERATION_SYNC = 12,
-    ALERT = 13,
-    TELEOP = 14,
-    CHAT = 15,
-    ERROR = 16,
+    PENDING_AUTH = 10,
+    INVOKE = 11,
+    INVOKE_RESULT = 12,
+    INVOKE_CANCEL = 13,
+    REGISTRY_REGISTER = 14,
+    REGISTRY_RESOLVE = 15,
+    TRANSPARENCY = 16,// EU AI Act Art. 13 audit record
     COMMAND_ACK = 17,
-    COMMAND_COMMIT = 18,
+    COMMAND_NACK = 18,
     ROBOT_REVOCATION = 19,
     CONSENT_REQUEST = 20,
     CONSENT_GRANT = 21,
@@ -76,7 +76,22 @@ declare enum MessageType {
     SUBSCRIBE = 24,
     UNSUBSCRIBE = 25,
     FAULT_REPORT = 26,
-    COMMAND_NACK = 27
+    KEY_ROTATION = 27,
+    COMMAND_COMMIT = 28,
+    SENSOR_DATA = 29,
+    TRAINING_CONSENT_REQUEST = 30,
+    TRAINING_CONSENT_GRANT = 31,
+    TRAINING_CONSENT_DENY = 32,
+    CONTRIBUTE_REQUEST = 33,
+    CONTRIBUTE_RESULT = 34,
+    CONTRIBUTE_CANCEL = 35,
+    TRAINING_DATA = 36,
+    /** @deprecated Use FLEET_COMMAND (23) */
+    FEDERATION_SYNC = 23,
+    /** @deprecated Use FAULT_REPORT (26) */
+    ALERT = 26,
+    /** @deprecated Use TRANSPARENCY (16) */
+    AUDIT = 16
 }
 /** §8.5 — Sender Type and Service Identity */
 type SenderType = "robot" | "human" | "cloud_function" | "system";
@@ -726,9 +741,9 @@ declare function makeTransparencyMessage(ruri: string, disclosure: string, deleg
  * §3.5 — Protocol Version Compatibility
  */
 /** The RCAN spec version this SDK implements. */
-declare const SPEC_VERSION = "1.6";
+declare const SPEC_VERSION = "1.9.0";
 /** The SDK release version. */
-declare const SDK_VERSION = "0.6.0";
+declare const SDK_VERSION = "0.8.0";
 /**
  * Validate version compatibility.
  *
@@ -1420,6 +1435,67 @@ declare function makeTrainingDataMessage(media: Array<{
  */
 declare function makeStreamChunk(streamId: string, data: Uint8Array, mimeType: string, chunkIndex: number, isFinal: boolean): Promise<RCANMessage>;
 
+/**
+ * rcan/contribute — Idle Compute Contribution messages and scope.
+ *
+ * Implements the contribute scope and message types for RCAN v1.7+.
+ * Robots can donate idle NPU/GPU/CPU compute to distributed science projects.
+ *
+ * Spec: §3 MessageTypes 33–35, Identity scope level 2.5
+ */
+
+/** Contribute scope level — between chat (2) and control (3). */
+declare const CONTRIBUTE_SCOPE_LEVEL = 2.5;
+type WorkUnitStatus = "pending" | "running" | "completed" | "failed" | "cancelled" | "preempted";
+type ComputeResource = "npu" | "gpu" | "cpu" | "sensor";
+interface ContributeRequest {
+    type: typeof MessageType.CONTRIBUTE_REQUEST;
+    request_id: string;
+    project_id: string;
+    project_name: string;
+    work_unit_id: string;
+    resource_type: ComputeResource;
+    estimated_duration_s: number;
+    priority: number;
+    payload: Record<string, unknown>;
+    timestamp: number;
+}
+interface ContributeResult {
+    type: typeof MessageType.CONTRIBUTE_RESULT;
+    request_id: string;
+    work_unit_id: string;
+    status: WorkUnitStatus;
+    resource_type: ComputeResource;
+    duration_s: number;
+    compute_units: number;
+    result_payload: Record<string, unknown>;
+    error_message?: string;
+    timestamp: number;
+}
+interface ContributeCancel {
+    type: typeof MessageType.CONTRIBUTE_CANCEL;
+    request_id: string;
+    work_unit_id: string;
+    reason: string;
+    timestamp: number;
+}
+declare function makeContributeRequest(params?: Partial<Omit<ContributeRequest, "type">>): ContributeRequest;
+declare function makeContributeResult(params?: Partial<Omit<ContributeResult, "type">>): ContributeResult;
+declare function makeContributeCancel(params?: Partial<Omit<ContributeCancel, "type">>): ContributeCancel;
+/**
+ * Check if the given scope level permits contribute operations.
+ *
+ * Contribute requires scope >= 2.5 (between chat and control).
+ */
+declare function validateContributeScope(scopeLevel: number, action?: "request" | "result" | "cancel"): boolean;
+/**
+ * Check if the given scope level preempts contribution.
+ *
+ * Any scope >= control (3.0) preempts contribute immediately.
+ * This is the P66 safety invariant — non-negotiable.
+ */
+declare function isPreemptedBy(scopeLevel: number): boolean;
+
 /**
  * rcan-ts — Official TypeScript SDK for RCAN v1.6
  * Robot Communication and Accountability Network
@@ -1432,4 +1508,4 @@ declare const VERSION = "0.6.0";
 /** @deprecated Use SPEC_VERSION from ./version instead */
 declare const RCAN_VERSION = "1.6";
 
-export { type ApprovalStatus, AuditChain, AuditError, type AuditExportRequest, type CachedKey, type ChainVerifyResult, ClockDriftError, type ClockSyncStatus, CommitmentRecord, type CommitmentRecordData, type CommitmentRecordJSON, ConfidenceGate, type ConsentRequestParams, type ConsentResponseParams, type ConsentType, DEFAULT_LOA_POLICY, DataCategory, type DelegationHop, FaultCode, type FaultReportParams, type FaultSeverity, type FederationSyncPayload, FederationSyncType, GateError, HiTLGate, type JWKEntry, type JWKSDocument, KeyStore, LevelOfAssurance, type ListResult, type LoaPolicy, type MediaChunk, MediaEncoding, MessageType, NodeClient, type OfflineCommandResult, OfflineModeManager, type OfflineState, PRODUCTION_LOA_POLICY, type PendingApproval, QoSAckTimeoutError, QoSLevel, QoSManager, type QoSResult, type QoSSendOptions, RCANAddressError, type RCANAgentConfig, type RCANConfig, RCANConfigAuthorizationError, RCANDelegationChainError, RCANError, RCANGateError, RCANMessage, type RCANMessageData, type RCANMessageEnvelope, RCANMessageError, type RCANMetadata, RCANNodeError, RCANNodeNotFoundError, RCANNodeSyncError, RCANNodeTrustError, RCANRegistryError, type RCANRegistryNode, RCANReplayAttackError, type RCANResolveResult, RCANSignatureError, RCANValidationError, RCANVersionIncompatibleError, RCAN_VERSION, type RegistrationResult, RegistryClient, type RegistryIdentity, RegistryTier, ReplayCache, type ReplayCheckResult, type ReplayableMessage, RevocationCache, type RevocationStatus, type RevocationStatusValue, type Robot, type RobotRegistration, RobotURI, RobotURIError, type RobotURIOptions, SAFETY_MESSAGE_TYPE, SDK_VERSION, SPEC_VERSION, type SafetyEvent, type SafetyMessage, type SenderType, type SignatureBlock, type StreamChunk, type TrainingConsentRequestParams, type TransparencyMessage, TransportEncoding, TransportError, TrustAnchorCache, VERSION, type ValidationResult, addDelegationHop, addMediaInline, addMediaRef, assertClockSynced, checkClockSync, checkRevocation, decodeBleFrames, decodeCompact, decodeMinimal, encodeBleFrames, encodeCompact, encodeMinimal, extractLoaFromJwt, fetchCanonicalSchema, isSafetyMessage, makeCloudRelayMessage, makeConfigUpdate, makeConsentDeny, makeConsentGrant, makeConsentRequest, makeEstopMessage, makeEstopWithQoS, makeFaultReport, makeFederationSync, makeKeyRotationMessage, makeResumeMessage, makeRevocationBroadcast, makeStopMessage, makeStreamChunk, makeTrainingConsentDeny, makeTrainingConsentGrant, makeTrainingConsentRequest, makeTrainingDataMessage, makeTransparencyMessage, selectTransport, validateConfig, validateConfigAgainstSchema, validateConfigUpdate, validateConsentMessage, validateCrossRegistryCommand, validateDelegationChain, validateLoaForScope, validateMediaChunks, validateMessage, validateNodeAgainstSchema, validateReplay, validateSafetyMessage, validateTrainingDataMessage, validateURI, validateVersionCompat };
+export { type ApprovalStatus, AuditChain, AuditError, type AuditExportRequest, CONTRIBUTE_SCOPE_LEVEL, type CachedKey, type ChainVerifyResult, ClockDriftError, type ClockSyncStatus, CommitmentRecord, type CommitmentRecordData, type CommitmentRecordJSON, type ComputeResource, ConfidenceGate, type ConsentRequestParams, type ConsentResponseParams, type ConsentType, type ContributeCancel, type ContributeRequest, type ContributeResult, DEFAULT_LOA_POLICY, DataCategory, type DelegationHop, FaultCode, type FaultReportParams, type FaultSeverity, type FederationSyncPayload, FederationSyncType, GateError, HiTLGate, type JWKEntry, type JWKSDocument, KeyStore, LevelOfAssurance, type ListResult, type LoaPolicy, type MediaChunk, MediaEncoding, MessageType, NodeClient, type OfflineCommandResult, OfflineModeManager, type OfflineState, PRODUCTION_LOA_POLICY, type PendingApproval, QoSAckTimeoutError, QoSLevel, QoSManager, type QoSResult, type QoSSendOptions, RCANAddressError, type RCANAgentConfig, type RCANConfig, RCANConfigAuthorizationError, RCANDelegationChainError, RCANError, RCANGateError, RCANMessage, type RCANMessageData, type RCANMessageEnvelope, RCANMessageError, type RCANMetadata, RCANNodeError, RCANNodeNotFoundError, RCANNodeSyncError, RCANNodeTrustError, RCANRegistryError, type RCANRegistryNode, RCANReplayAttackError, type RCANResolveResult, RCANSignatureError, RCANValidationError, RCANVersionIncompatibleError, RCAN_VERSION, type RegistrationResult, RegistryClient, type RegistryIdentity, RegistryTier, ReplayCache, type ReplayCheckResult, type ReplayableMessage, RevocationCache, type RevocationStatus, type RevocationStatusValue, type Robot, type RobotRegistration, RobotURI, RobotURIError, type RobotURIOptions, SAFETY_MESSAGE_TYPE, SDK_VERSION, SPEC_VERSION, type SafetyEvent, type SafetyMessage, type SenderType, type SignatureBlock, type StreamChunk, type TrainingConsentRequestParams, type TransparencyMessage, TransportEncoding, TransportError, TrustAnchorCache, VERSION, type ValidationResult, type WorkUnitStatus, addDelegationHop, addMediaInline, addMediaRef, assertClockSynced, checkClockSync, checkRevocation, decodeBleFrames, decodeCompact, decodeMinimal, encodeBleFrames, encodeCompact, encodeMinimal, extractLoaFromJwt, fetchCanonicalSchema, isPreemptedBy, isSafetyMessage, makeCloudRelayMessage, makeConfigUpdate, makeConsentDeny, makeConsentGrant, makeConsentRequest, makeContributeCancel, makeContributeRequest, makeContributeResult, makeEstopMessage, makeEstopWithQoS, makeFaultReport, makeFederationSync, makeKeyRotationMessage, makeResumeMessage, makeRevocationBroadcast, makeStopMessage, makeStreamChunk, makeTrainingConsentDeny, makeTrainingConsentGrant, makeTrainingConsentRequest, makeTrainingDataMessage, makeTransparencyMessage, selectTransport, validateConfig, validateConfigAgainstSchema, validateConfigUpdate, validateConsentMessage, validateContributeScope, validateCrossRegistryCommand, validateDelegationChain, validateLoaForScope, validateMediaChunks, validateMessage, validateNodeAgainstSchema, validateReplay, validateSafetyMessage, validateTrainingDataMessage, validateURI, validateVersionCompat };

package/dist/index.js

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
@@ -22,6 +32,7 @@ var index_exports = {};
 __export(index_exports, {
   AuditChain: () => AuditChain,
   AuditError: () => AuditError,
+  CONTRIBUTE_SCOPE_LEVEL: () => CONTRIBUTE_SCOPE_LEVEL,
   ClockDriftError: () => ClockDriftError,
   CommitmentRecord: () => CommitmentRecord,
   ConfidenceGate: () => ConfidenceGate,
@@ -85,12 +96,16 @@ __export(index_exports, {
   encodeMinimal: () => encodeMinimal,
   extractLoaFromJwt: () => extractLoaFromJwt,
   fetchCanonicalSchema: () => fetchCanonicalSchema,
+  isPreemptedBy: () => isPreemptedBy,
   isSafetyMessage: () => isSafetyMessage,
   makeCloudRelayMessage: () => makeCloudRelayMessage,
   makeConfigUpdate: () => makeConfigUpdate,
   makeConsentDeny: () => makeConsentDeny,
   makeConsentGrant: () => makeConsentGrant,
   makeConsentRequest: () => makeConsentRequest,
+  makeContributeCancel: () => makeContributeCancel,
+  makeContributeRequest: () => makeContributeRequest,
+  makeContributeResult: () => makeContributeResult,
   makeEstopMessage: () => makeEstopMessage,
   makeEstopWithQoS: () => makeEstopWithQoS,
   makeFaultReport: () => makeFaultReport,
@@ -110,6 +125,7 @@ __export(index_exports, {
   validateConfigAgainstSchema: () => validateConfigAgainstSchema,
   validateConfigUpdate: () => validateConfigUpdate,
   validateConsentMessage: () => validateConsentMessage,
+  validateContributeScope: () => validateContributeScope,
   validateCrossRegistryCommand: () => validateCrossRegistryCommand,
   validateDelegationChain: () => validateDelegationChain,
   validateLoaForScope: () => validateLoaForScope,
@@ -215,8 +231,8 @@ var RobotURI = class _RobotURI {
 };
 
 // src/version.ts
-var SPEC_VERSION = "1.6";
-var SDK_VERSION = "0.6.0";
+var SPEC_VERSION = "1.9.0";
+var SDK_VERSION = "0.8.0";
 function validateVersionCompat(incomingVersion, localVersion = SPEC_VERSION) {
   const parseParts = (v) => {
     const parts = v.split(".");
@@ -237,18 +253,18 @@ var MessageType = /* @__PURE__ */ ((MessageType2) => {
   MessageType2[MessageType2["HEARTBEAT"] = 4] = "HEARTBEAT";
   MessageType2[MessageType2["CONFIG"] = 5] = "CONFIG";
   MessageType2[MessageType2["SAFETY"] = 6] = "SAFETY";
-  MessageType2[MessageType2["SENSOR_DATA"] = 7] = "SENSOR_DATA";
-  MessageType2[MessageType2["AUDIT"] = 8] = "AUDIT";
+  MessageType2[MessageType2["AUTH"] = 7] = "AUTH";
+  MessageType2[MessageType2["ERROR"] = 8] = "ERROR";
   MessageType2[MessageType2["DISCOVER"] = 9] = "DISCOVER";
-  MessageType2[MessageType2["TRAINING_DATA"] = 10] = "TRAINING_DATA";
-  MessageType2[MessageType2["TRANSPARENCY"] = 11] = "TRANSPARENCY";
-  MessageType2[MessageType2["FEDERATION_SYNC"] = 12] = "FEDERATION_SYNC";
-  MessageType2[MessageType2["ALERT"] = 13] = "ALERT";
-  MessageType2[MessageType2["TELEOP"] = 14] = "TELEOP";
-  MessageType2[MessageType2["CHAT"] = 15] = "CHAT";
-  MessageType2[MessageType2["ERROR"] = 16] = "ERROR";
+  MessageType2[MessageType2["PENDING_AUTH"] = 10] = "PENDING_AUTH";
+  MessageType2[MessageType2["INVOKE"] = 11] = "INVOKE";
+  MessageType2[MessageType2["INVOKE_RESULT"] = 12] = "INVOKE_RESULT";
+  MessageType2[MessageType2["INVOKE_CANCEL"] = 13] = "INVOKE_CANCEL";
+  MessageType2[MessageType2["REGISTRY_REGISTER"] = 14] = "REGISTRY_REGISTER";
+  MessageType2[MessageType2["REGISTRY_RESOLVE"] = 15] = "REGISTRY_RESOLVE";
+  MessageType2[MessageType2["TRANSPARENCY"] = 16] = "TRANSPARENCY";
   MessageType2[MessageType2["COMMAND_ACK"] = 17] = "COMMAND_ACK";
-  MessageType2[MessageType2["COMMAND_COMMIT"] = 18] = "COMMAND_COMMIT";
+  MessageType2[MessageType2["COMMAND_NACK"] = 18] = "COMMAND_NACK";
   MessageType2[MessageType2["ROBOT_REVOCATION"] = 19] = "ROBOT_REVOCATION";
   MessageType2[MessageType2["CONSENT_REQUEST"] = 20] = "CONSENT_REQUEST";
   MessageType2[MessageType2["CONSENT_GRANT"] = 21] = "CONSENT_GRANT";
@@ -257,7 +273,19 @@ var MessageType = /* @__PURE__ */ ((MessageType2) => {
   MessageType2[MessageType2["SUBSCRIBE"] = 24] = "SUBSCRIBE";
   MessageType2[MessageType2["UNSUBSCRIBE"] = 25] = "UNSUBSCRIBE";
   MessageType2[MessageType2["FAULT_REPORT"] = 26] = "FAULT_REPORT";
-  MessageType2[MessageType2["COMMAND_NACK"] = 27] = "COMMAND_NACK";
+  MessageType2[MessageType2["KEY_ROTATION"] = 27] = "KEY_ROTATION";
+  MessageType2[MessageType2["COMMAND_COMMIT"] = 28] = "COMMAND_COMMIT";
+  MessageType2[MessageType2["SENSOR_DATA"] = 29] = "SENSOR_DATA";
+  MessageType2[MessageType2["TRAINING_CONSENT_REQUEST"] = 30] = "TRAINING_CONSENT_REQUEST";
+  MessageType2[MessageType2["TRAINING_CONSENT_GRANT"] = 31] = "TRAINING_CONSENT_GRANT";
+  MessageType2[MessageType2["TRAINING_CONSENT_DENY"] = 32] = "TRAINING_CONSENT_DENY";
+  MessageType2[MessageType2["CONTRIBUTE_REQUEST"] = 33] = "CONTRIBUTE_REQUEST";
+  MessageType2[MessageType2["CONTRIBUTE_RESULT"] = 34] = "CONTRIBUTE_RESULT";
+  MessageType2[MessageType2["CONTRIBUTE_CANCEL"] = 35] = "CONTRIBUTE_CANCEL";
+  MessageType2[MessageType2["TRAINING_DATA"] = 36] = "TRAINING_DATA";
+  MessageType2[MessageType2["FEDERATION_SYNC"] = 23] = "FEDERATION_SYNC";
+  MessageType2[MessageType2["ALERT"] = 26] = "ALERT";
+  MessageType2[MessageType2["AUDIT"] = 16] = "AUDIT";
   return MessageType2;
 })(MessageType || {});
 var RCANMessageError = class extends Error {
@@ -1377,6 +1405,7 @@ async function fetchCanonicalSchema(schemaName) {
   try {
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), 5e3);
+    timer.unref?.();
     const res = await fetch(`${SCHEMA_BASE}/${schemaName}`, { signal: controller.signal });
     clearTimeout(timer);
     if (!res.ok) return null;
@@ -2017,7 +2046,7 @@ function makeTrainingConsentDeny(params) {
   return makeConsentDeny(params);
 }
 function validateTrainingDataMessage(msg) {
-  if (msg.params.message_type !== 10 /* TRAINING_DATA */) {
+  if (msg.params.message_type !== 36 /* TRAINING_DATA */) {
     return { valid: false, reason: "not a TRAINING_DATA message" };
   }
   const token = msg.params.consent_token;
@@ -2207,6 +2236,9 @@ function minLoaForScope(scope, policy) {
       return policy.minLoaStatus;
     case "chat":
       return policy.minLoaChat;
+    case "contribute":
+      return policy.minLoaChat;
+    // v1.7: between chat and control
     case "control":
       return policy.minLoaControl;
     case "safety":
@@ -2356,7 +2388,7 @@ function makeFederationSync(source, target, syncType, payload) {
     cmd: "federation_sync",
     target,
     params: {
-      msg_type: 12 /* FEDERATION_SYNC */,
+      msg_type: 23 /* FEDERATION_SYNC */,
       msg_id: generateId5(),
       source_registry: source,
       target_registry: target,
@@ -2482,7 +2514,8 @@ async function sha256Bytes(input) {
   const encoded = new TextEncoder().encode(input);
   const ab = new ArrayBuffer(encoded.byteLength);
   new Uint8Array(ab).set(encoded);
-  const hashBuffer = await crypto.subtle.digest("SHA-256", ab);
+  const subtle = globalThis.crypto?.subtle ?? (await import("crypto")).webcrypto.subtle;
+  const hashBuffer = await subtle.digest("SHA-256", ab);
   return new Uint8Array(hashBuffer);
 }
 async function encodeMinimal(message) {
@@ -2633,9 +2666,10 @@ function generateId6() {
   return `${hex.slice(0, 4).join("")}-${hex.slice(4, 6).join("")}-${hex.slice(6, 8).join("")}-${hex.slice(8, 10).join("")}-${hex.slice(10).join("")}`;
 }
 async function computeSha256Hex(data) {
+  const subtle = globalThis.crypto?.subtle ?? (await import("crypto")).webcrypto.subtle;
   const ab = new ArrayBuffer(data.byteLength);
   new Uint8Array(ab).set(data);
-  const hashBuffer = await crypto.subtle.digest("SHA-256", ab);
+  const hashBuffer = await subtle.digest("SHA-256", ab);
   const hashArray = new Uint8Array(hashBuffer);
   return Array.from(hashArray).map((b) => b.toString(16).padStart(2, "0")).join("");
 }
@@ -2728,7 +2762,7 @@ async function makeTrainingDataMessage(media) {
     cmd: "training_data",
     target: "rcan://training/data",
     params: {
-      msg_type: 10 /* TRAINING_DATA */,
+      msg_type: 36 /* TRAINING_DATA */,
       msg_id: generateId6()
     },
     timestamp: (/* @__PURE__ */ new Date()).toISOString()
@@ -2761,7 +2795,7 @@ async function makeStreamChunk(streamId, data, mimeType, chunkIndex, isFinal) {
     cmd: "stream_chunk",
     target: "rcan://streaming/chunk",
     params: {
-      msg_type: 7 /* SENSOR_DATA */,
+      msg_type: 29 /* SENSOR_DATA */,
       msg_id: generateId6(),
       stream_chunk: streamChunkMeta
     },
@@ -2771,6 +2805,65 @@ async function makeStreamChunk(streamId, data, mimeType, chunkIndex, isFinal) {
   return msg;
 }
 
+// src/contribute.ts
+var CONTRIBUTE_SCOPE_LEVEL = 2.5;
+var _idCounter = 0;
+function _generateId() {
+  return `cr-${Date.now()}-${++_idCounter}`;
+}
+function makeContributeRequest(params = {}) {
+  return {
+    type: 33 /* CONTRIBUTE_REQUEST */,
+    request_id: params.request_id ?? _generateId(),
+    project_id: params.project_id ?? "",
+    project_name: params.project_name ?? "",
+    work_unit_id: params.work_unit_id ?? "",
+    resource_type: params.resource_type ?? "cpu",
+    estimated_duration_s: params.estimated_duration_s ?? 0,
+    priority: params.priority ?? 0,
+    payload: params.payload ?? {},
+    timestamp: params.timestamp ?? Date.now() / 1e3
+  };
+}
+function makeContributeResult(params = {}) {
+  const result = {
+    type: 34 /* CONTRIBUTE_RESULT */,
+    request_id: params.request_id ?? "",
+    work_unit_id: params.work_unit_id ?? "",
+    status: params.status ?? "completed",
+    resource_type: params.resource_type ?? "cpu",
+    duration_s: params.duration_s ?? 0,
+    compute_units: params.compute_units ?? 0,
+    result_payload: params.result_payload ?? {},
+    timestamp: params.timestamp ?? Date.now() / 1e3
+  };
+  if (params.error_message !== void 0) {
+    result.error_message = params.error_message;
+  }
+  return result;
+}
+function makeContributeCancel(params = {}) {
+  return {
+    type: 35 /* CONTRIBUTE_CANCEL */,
+    request_id: params.request_id ?? "",
+    work_unit_id: params.work_unit_id ?? "",
+    reason: params.reason ?? "",
+    timestamp: params.timestamp ?? Date.now() / 1e3
+  };
+}
+function validateContributeScope(scopeLevel, action = "request") {
+  if (action === "request" || action === "result") {
+    return scopeLevel >= CONTRIBUTE_SCOPE_LEVEL;
+  }
+  if (action === "cancel") {
+    return scopeLevel >= 2;
+  }
+  return false;
+}
+function isPreemptedBy(scopeLevel) {
+  return scopeLevel >= 3;
+}
+
 // src/index.ts
 var VERSION = "0.6.0";
 var RCAN_VERSION = "1.6";
@@ -2778,6 +2871,7 @@ var RCAN_VERSION = "1.6";
 0 && (module.exports = {
   AuditChain,
   AuditError,
+  CONTRIBUTE_SCOPE_LEVEL,
   ClockDriftError,
   CommitmentRecord,
   ConfidenceGate,
@@ -2841,12 +2935,16 @@ var RCAN_VERSION = "1.6";
   encodeMinimal,
   extractLoaFromJwt,
   fetchCanonicalSchema,
+  isPreemptedBy,
   isSafetyMessage,
   makeCloudRelayMessage,
   makeConfigUpdate,
   makeConsentDeny,
   makeConsentGrant,
   makeConsentRequest,
+  makeContributeCancel,
+  makeContributeRequest,
+  makeContributeResult,
   makeEstopMessage,
   makeEstopWithQoS,
   makeFaultReport,
@@ -2866,6 +2964,7 @@ var RCAN_VERSION = "1.6";
   validateConfigAgainstSchema,
   validateConfigUpdate,
   validateConsentMessage,
+  validateContributeScope,
   validateCrossRegistryCommand,
   validateDelegationChain,
   validateLoaForScope,