@continuonai/rcan-ts 0.3.0 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -3
- package/dist/browser.d.mts +711 -7
- package/dist/browser.mjs +934 -6
- package/dist/browser.mjs.map +1 -1
- package/dist/index.d.mts +711 -7
- package/dist/index.d.ts +711 -7
- package/dist/index.js +975 -7
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +930 -6
- package/dist/index.mjs.map +1 -1
- package/dist/rcan-validate.js +47 -2
- package/dist/rcan.iife.js +3 -3
- package/package.json +3 -3
package/dist/rcan-validate.js
CHANGED
|
@@ -2943,6 +2943,9 @@ var RobotURI = class _RobotURI {
|
|
|
2943
2943
|
}
|
|
2944
2944
|
};
|
|
2945
2945
|
|
|
2946
|
+
// src/version.ts
|
|
2947
|
+
var SPEC_VERSION = "1.5";
|
|
2948
|
+
|
|
2946
2949
|
// src/message.ts
|
|
2947
2950
|
var RCANMessageError = class extends Error {
|
|
2948
2951
|
constructor(message) {
|
|
@@ -2952,6 +2955,8 @@ var RCANMessageError = class extends Error {
|
|
|
2952
2955
|
};
|
|
2953
2956
|
var RCANMessage = class _RCANMessage {
|
|
2954
2957
|
rcan;
|
|
2958
|
+
/** v1.5: rcanVersion field — defaults to SPEC_VERSION */
|
|
2959
|
+
rcanVersion;
|
|
2955
2960
|
cmd;
|
|
2956
2961
|
target;
|
|
2957
2962
|
params;
|
|
@@ -2959,6 +2964,16 @@ var RCANMessage = class _RCANMessage {
|
|
|
2959
2964
|
modelIdentity;
|
|
2960
2965
|
signature;
|
|
2961
2966
|
timestamp;
|
|
2967
|
+
/** v1.5 fields */
|
|
2968
|
+
senderType;
|
|
2969
|
+
cloudProvider;
|
|
2970
|
+
keyId;
|
|
2971
|
+
delegationChain;
|
|
2972
|
+
groupId;
|
|
2973
|
+
qos;
|
|
2974
|
+
presenceVerified;
|
|
2975
|
+
proximityMeters;
|
|
2976
|
+
readOnly;
|
|
2962
2977
|
constructor(data) {
|
|
2963
2978
|
if (!data.cmd || data.cmd.trim() === "") {
|
|
2964
2979
|
throw new RCANMessageError("'cmd' is required");
|
|
@@ -2966,7 +2981,8 @@ var RCANMessage = class _RCANMessage {
|
|
|
2966
2981
|
if (!data.target) {
|
|
2967
2982
|
throw new RCANMessageError("'target' is required");
|
|
2968
2983
|
}
|
|
2969
|
-
this.rcan = data.rcan ??
|
|
2984
|
+
this.rcan = data.rcan ?? SPEC_VERSION;
|
|
2985
|
+
this.rcanVersion = data.rcanVersion ?? SPEC_VERSION;
|
|
2970
2986
|
this.cmd = data.cmd;
|
|
2971
2987
|
this.target = data.target instanceof RobotURI ? data.target.toString() : String(data.target);
|
|
2972
2988
|
this.params = data.params ?? {};
|
|
@@ -2974,6 +2990,15 @@ var RCANMessage = class _RCANMessage {
|
|
|
2974
2990
|
this.modelIdentity = data.modelIdentity ?? data.model_identity;
|
|
2975
2991
|
this.signature = data.signature;
|
|
2976
2992
|
this.timestamp = data.timestamp ?? (/* @__PURE__ */ new Date()).toISOString();
|
|
2993
|
+
this.senderType = data.senderType;
|
|
2994
|
+
this.cloudProvider = data.cloudProvider;
|
|
2995
|
+
this.keyId = data.keyId;
|
|
2996
|
+
this.delegationChain = data.delegationChain;
|
|
2997
|
+
this.groupId = data.groupId;
|
|
2998
|
+
this.qos = data.qos;
|
|
2999
|
+
this.presenceVerified = data.presenceVerified;
|
|
3000
|
+
this.proximityMeters = data.proximityMeters;
|
|
3001
|
+
this.readOnly = data.readOnly;
|
|
2977
3002
|
if (this.confidence !== void 0) {
|
|
2978
3003
|
if (this.confidence < 0 || this.confidence > 1) {
|
|
2979
3004
|
throw new RCANMessageError(
|
|
@@ -2994,6 +3019,7 @@ var RCANMessage = class _RCANMessage {
|
|
|
2994
3019
|
toJSON() {
|
|
2995
3020
|
const obj = {
|
|
2996
3021
|
rcan: this.rcan,
|
|
3022
|
+
rcanVersion: this.rcanVersion,
|
|
2997
3023
|
cmd: this.cmd,
|
|
2998
3024
|
target: this.target,
|
|
2999
3025
|
timestamp: this.timestamp
|
|
@@ -3002,6 +3028,15 @@ var RCANMessage = class _RCANMessage {
|
|
|
3002
3028
|
if (this.confidence !== void 0) obj.confidence = this.confidence;
|
|
3003
3029
|
if (this.modelIdentity) obj.model_identity = this.modelIdentity;
|
|
3004
3030
|
if (this.signature) obj.signature = this.signature;
|
|
3031
|
+
if (this.senderType !== void 0) obj.senderType = this.senderType;
|
|
3032
|
+
if (this.cloudProvider !== void 0) obj.cloudProvider = this.cloudProvider;
|
|
3033
|
+
if (this.keyId !== void 0) obj.keyId = this.keyId;
|
|
3034
|
+
if (this.delegationChain !== void 0) obj.delegationChain = this.delegationChain;
|
|
3035
|
+
if (this.groupId !== void 0) obj.groupId = this.groupId;
|
|
3036
|
+
if (this.qos !== void 0) obj.qos = this.qos;
|
|
3037
|
+
if (this.presenceVerified !== void 0) obj.presenceVerified = this.presenceVerified;
|
|
3038
|
+
if (this.proximityMeters !== void 0) obj.proximityMeters = this.proximityMeters;
|
|
3039
|
+
if (this.readOnly !== void 0) obj.readOnly = this.readOnly;
|
|
3005
3040
|
return obj;
|
|
3006
3041
|
}
|
|
3007
3042
|
/** Serialize to JSON string */
|
|
@@ -3025,13 +3060,23 @@ var RCANMessage = class _RCANMessage {
|
|
|
3025
3060
|
if (!obj.rcan) throw new RCANMessageError("Missing required field: 'rcan'");
|
|
3026
3061
|
return new _RCANMessage({
|
|
3027
3062
|
rcan: obj.rcan,
|
|
3063
|
+
rcanVersion: obj.rcanVersion,
|
|
3028
3064
|
cmd: obj.cmd,
|
|
3029
3065
|
target: obj.target,
|
|
3030
3066
|
params: obj.params ?? {},
|
|
3031
3067
|
confidence: obj.confidence,
|
|
3032
3068
|
modelIdentity: obj.model_identity ?? obj.modelIdentity,
|
|
3033
3069
|
signature: obj.signature,
|
|
3034
|
-
timestamp: obj.timestamp
|
|
3070
|
+
timestamp: obj.timestamp,
|
|
3071
|
+
senderType: obj.senderType,
|
|
3072
|
+
cloudProvider: obj.cloudProvider,
|
|
3073
|
+
keyId: obj.keyId,
|
|
3074
|
+
delegationChain: obj.delegationChain,
|
|
3075
|
+
groupId: obj.groupId,
|
|
3076
|
+
qos: obj.qos,
|
|
3077
|
+
presenceVerified: obj.presenceVerified,
|
|
3078
|
+
proximityMeters: obj.proximityMeters,
|
|
3079
|
+
readOnly: obj.readOnly
|
|
3035
3080
|
});
|
|
3036
3081
|
}
|
|
3037
3082
|
};
|
package/dist/rcan.iife.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
"use strict";var RCAN=(()=>{var tt=Object.defineProperty;var bt=Object.getOwnPropertyDescriptor;var xt=Object.getOwnPropertyNames;var vt=Object.prototype.hasOwnProperty;var wt=(n=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(n,{get:(t,e)=>(typeof require<"u"?require:t)[e]}):n)(function(n){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+n+'" is not supported')});var Nt=(n,t)=>{for(var e in t)tt(n,e,{get:t[e],enumerable:!0})},At=(n,t,e,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of xt(t))!vt.call(n,s)&&s!==e&&tt(n,s,{get:()=>t[s],enumerable:!(r=bt(t,s))||r.enumerable});return n};var Ct=n=>At(tt({},"__esModule",{value:!0}),n);var Ht={};Nt(Ht,{AuditChain:()=>D,AuditError:()=>q,CommitmentRecord:()=>U,ConfidenceGate:()=>J,GateError:()=>w,HiTLGate:()=>M,NodeClient:()=>G,RCANAddressError:()=>B,RCANError:()=>x,RCANGateError:()=>K,RCANMessage:()=>O,RCANMessageError:()=>h,RCANNodeError:()=>I,RCANNodeNotFoundError:()=>N,RCANNodeSyncError:()=>g,RCANNodeTrustError:()=>E,RCANRegistryError:()=>k,RCANSignatureError:()=>F,RCANValidationError:()=>V,RCAN_VERSION:()=>Tt,RegistryClient:()=>W,RobotURI:()=>_,RobotURIError:()=>S,SPEC_VERSION:()=>Lt,VERSION:()=>Pt,fetchCanonicalSchema:()=>z,validateConfig:()=>lt,validateConfigAgainstSchema:()=>gt,validateMessage:()=>ut,validateNodeAgainstSchema:()=>ft,validateURI:()=>dt});var S=class extends Error{constructor(t){super(t),this.name="RobotURIError"}},_=class n{registry;manufacturer;model;version;deviceId;constructor(t){this.registry=t.registry,this.manufacturer=t.manufacturer,this.model=t.model,this.version=t.version,this.deviceId=t.deviceId}static parse(t){if(!t.startsWith("rcan://"))throw new S(`URI must start with 'rcan://' \u2014 got: ${t}`);let r=t.slice(7).split("/");if(r.length!==5)throw new S(`URI must have exactly 5 path segments (registry/manufacturer/model/version/device-id) \u2014 got ${r.length} in: ${t}`);let[s,o,i,a,l]=r;for(let[d,u]of[["registry",s],["manufacturer",o],["model",i],["version",a],["device-id",l]])if(!u||u.trim()==="")throw new S(`URI segment '${d}' must not be empty`);return new n({registry:s,manufacturer:o,model:i,version:a,deviceId:l})}static build(t){let e=t.registry??"registry.rcan.dev",{manufacturer:r,model:s,version:o,deviceId:i}=t;for(let[a,l]of[["manufacturer",r],["model",s],["version",o],["deviceId",i]])if(!l||l.trim()==="")throw new S(`'${a}' must not be empty`);return new n({registry:e,manufacturer:r,model:s,version:o,deviceId:i})}toString(){return`rcan://${this.registry}/${this.manufacturer}/${this.model}/${this.version}/${this.deviceId}`}get namespace(){return`${this.manufacturer}/${this.model}`}get registryUrl(){return`https://${this.registry}/registry/${this.manufacturer}/${this.model}/${this.version}/${this.deviceId}`}equals(t){return this.toString()===t.toString()}toJSON(){return{uri:this.toString(),registry:this.registry,manufacturer:this.manufacturer,model:this.model,version:this.version,deviceId:this.deviceId}}};var h=class extends Error{constructor(t){super(t),this.name="RCANMessageError"}},O=class n{rcan;cmd;target;params;confidence;modelIdentity;signature;timestamp;constructor(t){if(!t.cmd||t.cmd.trim()==="")throw new h("'cmd' is required");if(!t.target)throw new h("'target' is required");if(this.rcan=t.rcan??"1.2",this.cmd=t.cmd,this.target=t.target instanceof _?t.target.toString():String(t.target),this.params=t.params??{},this.confidence=t.confidence,this.modelIdentity=t.modelIdentity??t.model_identity,this.signature=t.signature,this.timestamp=t.timestamp??new Date().toISOString(),this.confidence!==void 0&&(this.confidence<0||this.confidence>1))throw new h(`confidence must be in [0.0, 1.0] \u2014 got ${this.confidence}`)}get isSigned(){return this.signature!==void 0&&this.signature.sig!==""}get isAiDriven(){return this.confidence!==void 0}toJSON(){let t={rcan:this.rcan,cmd:this.cmd,target:this.target,timestamp:this.timestamp};return Object.keys(this.params).length>0&&(t.params=this.params),this.confidence!==void 0&&(t.confidence=this.confidence),this.modelIdentity&&(t.model_identity=this.modelIdentity),this.signature&&(t.signature=this.signature),t}toJSONString(t){return JSON.stringify(this.toJSON(),null,t)}static fromJSON(t){let e;if(typeof t=="string")try{e=JSON.parse(t)}catch{throw new h("Invalid JSON string")}else e=t;if(!e.cmd)throw new h("Missing required field: 'cmd'");if(!e.target)throw new h("Missing required field: 'target'");if(!e.rcan)throw new h("Missing required field: 'rcan'");return new n({rcan:e.rcan,cmd:e.cmd,target:e.target,params:e.params??{},confidence:e.confidence,modelIdentity:e.model_identity??e.modelIdentity,signature:e.signature,timestamp:e.timestamp})}};function H(){if(typeof globalThis.crypto<"u"&&typeof globalThis.crypto.randomUUID=="function")return globalThis.crypto.randomUUID();try{let{randomUUID:n}=wt("crypto");return n()}catch{return"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,n=>{let t=Math.random()*16|0;return(n==="x"?t:t&3|8).toString(16)})}}function rt(n,t){return typeof process<"u",_t(n,t)}function et(n){let t=[1116352408,1899447441,3049323471,3921009573,961987163,1508970993,2453635748,2870763221,3624381080,310598401,607225278,1426881987,1925078388,2162078206,2614888103,3248222580,3835390401,4022224774,264347078,604807628,770255983,1249150122,1555081692,1996064986,2554220882,2821834349,2952996808,3210313671,3336571891,3584528711,113926993,338241895,666307205,773529912,1294757372,1396182291,1695183700,1986661051,2177026350,2456956037,2730485921,2820302411,3259730800,3345764771,3516065817,3600352804,4094571909,275423344,430227734,506948616,659060556,883997877,958139571,1322822218,1537002063,1747873779,1955562222,2024104815,2227730452,2361852424,2428436474,2756734187,3204031479,3329325298],e=1779033703,r=3144134277,s=1013904242,o=2773480762,i=1359893119,a=2600822924,l=528734635,d=1541459225,pt=n.length*8,v=[...n];for(v.push(128);v.length%64!==56;)v.push(0);for(let m=7;m>=0;m--)v.push(pt/Math.pow(2,m*8)&255);for(let m=0;m<v.length;m+=64){let f=[];for(let c=0;c<16;c++)f[c]=v[m+c*4]<<24|v[m+c*4+1]<<16|v[m+c*4+2]<<8|v[m+c*4+3];for(let c=16;c<64;c++){let Q=R(f[c-15],7)^R(f[c-15],18)^f[c-15]>>>3,X=R(f[c-2],17)^R(f[c-2],19)^f[c-2]>>>10;f[c]=f[c-16]+Q+f[c-7]+X>>>0}let[A,j,P,Y,C,L,T,Z]=[e,r,s,o,i,a,l,d];for(let c=0;c<64;c++){let Q=R(C,6)^R(C,11)^R(C,25),X=C&L^~C&T,it=Z+Q+X+t[c]+f[c]>>>0,ht=R(A,2)^R(A,13)^R(A,22),yt=A&j^A&P^j&P,Rt=ht+yt>>>0;[Z,T,L,C,Y,P,j,A]=[T,L,C,Y+it>>>0,P,j,A,it+Rt>>>0]}e=e+A>>>0,r=r+j>>>0,s=s+P>>>0,o=o+Y>>>0,i=i+C>>>0,a=a+L>>>0,l=l+T>>>0,d=d+Z>>>0}let ot=new Uint8Array(32),mt=new DataView(ot.buffer);return[e,r,s,o,i,a,l,d].forEach((m,f)=>mt.setUint32(f*4,m)),ot}function R(n,t){return n>>>t|n<<32-t}function at(n){if(typeof TextEncoder<"u")return new TextEncoder().encode(n);let t=new Uint8Array(n.length);for(let e=0;e<n.length;e++)t[e]=n.charCodeAt(e)&255;return t}function St(n){return Array.from(n).map(t=>t.toString(16).padStart(2,"0")).join("")}function _t(n,t){let r=at(n);r.length>64&&(r=et(r));let s=new Uint8Array(64),o=new Uint8Array(64);for(let u=0;u<64;u++)s[u]=(r[u]??0)^54,o[u]=(r[u]??0)^92;let i=at(t),a=new Uint8Array(64+i.length);a.set(s),a.set(i,64);let l=et(a),d=new Uint8Array(96);return d.set(o),d.set(l,64),St(et(d))}var w=class extends Error{constructor(t){super(t),this.name="GateError"}},J=class{threshold;constructor(t=.8){if(t<0||t>1)throw new w(`threshold must be in [0.0, 1.0] \u2014 got ${t}`);this.threshold=t}allows(t){return t>=this.threshold}margin(t){return t-this.threshold}assert(t,e){if(!this.allows(t)){let r=e?` for action '${e}'`:"";throw new w(`Confidence ${t}${r} is below threshold ${this.threshold}`)}}},M=class{_pending=new Map;request(t,e={}){let r=H();return this._pending.set(r,{token:r,action:t,context:e,createdAt:new Date().toISOString(),status:"pending"}),r}approve(t){let e=this._pending.get(t);if(!e)throw new w(`Unknown token: ${t}`);e.status="approved"}deny(t,e){let r=this._pending.get(t);if(!r)throw new w(`Unknown token: ${t}`);r.status="denied",e&&(r.reason=e)}check(t){let e=this._pending.get(t);if(!e)throw new w(`Unknown token: ${t}`);return e.status}get pendingApprovals(){return Array.from(this._pending.values()).filter(t=>t.status==="pending")}getApproval(t){return this._pending.get(t)}clearResolved(){for(let[t,e]of this._pending.entries())e.status!=="pending"&&this._pending.delete(t)}};var q=class extends Error{constructor(t){super(t),this.name="AuditError"}};function $t(n,t,e,r,s){let o=JSON.stringify({recordId:n,action:t,robotUri:e,timestamp:r,params:s},Object.keys({recordId:n,action:t,robotUri:e,timestamp:r,params:s}).sort());return rt("rcan-content-hash",o)}function ct(n,t){let{hmac:e,...r}=t,s=JSON.stringify(r,Object.keys(r).sort());return rt(n,s)}var U=class n{recordId;action;robotUri;confidence;modelIdentity;params;safetyApproved;timestamp;contentHash;previousHash;hmac;constructor(t){this.recordId=t.recordId,this.action=t.action,this.robotUri=t.robotUri,this.confidence=t.confidence,this.modelIdentity=t.modelIdentity,this.params=t.params,this.safetyApproved=t.safetyApproved,this.timestamp=t.timestamp,this.contentHash=t.contentHash,this.previousHash=t.previousHash,this.hmac=t.hmac}static create(t,e,r=null){let s=H(),o=new Date().toISOString(),i=t.params??{},a=t.robotUri??"",l=$t(s,t.action,a,o,i),d={recordId:s,action:t.action,robotUri:a,confidence:t.confidence,modelIdentity:t.modelIdentity,params:i,safetyApproved:t.safetyApproved??!0,timestamp:o,contentHash:l,previousHash:r,hmac:""};return d.hmac=ct(e,d),new n(d)}verify(t){return ct(t,this.toJSON())===this.hmac}toJSON(){return{recordId:this.recordId,action:this.action,robotUri:this.robotUri,confidence:this.confidence,modelIdentity:this.modelIdentity,params:this.params,safetyApproved:this.safetyApproved,timestamp:this.timestamp,contentHash:this.contentHash,previousHash:this.previousHash,hmac:this.hmac}}static fromJSON(t){return new n(t)}},D=class n{_records=[];_secret;constructor(t){this._secret=t}get records(){return this._records}append(t){let r=this._records[this._records.length-1]?.contentHash??null,s=U.create(t,this._secret,r);return this._records.push(s),s}verifyAll(){let t=[],e=null;for(let r of this._records)r.verify(this._secret)||t.push(`HMAC invalid for record ${r.recordId.slice(0,8)}`),e!==null&&r.previousHash!==e&&t.push(`Chain broken at ${r.recordId.slice(0,8)}: expected prev=${e.slice(0,12)}`),e=r.contentHash;return{valid:t.length===0,count:this._records.length,errors:t}}toJSONL(){return this._records.map(t=>JSON.stringify(t.toJSON())).join(`
|
|
1
|
+
"use strict";var RCAN=(()=>{var Re=Object.defineProperty;var ft=Object.getOwnPropertyDescriptor;var lt=Object.getOwnPropertyNames;var mt=Object.prototype.hasOwnProperty;var gt=(r=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(r,{get:(e,t)=>(typeof require<"u"?require:e)[t]}):r)(function(r){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+r+'" is not supported')});var pt=(r,e)=>{for(var t in e)Re(r,t,{get:e[t],enumerable:!0})},ht=(r,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of lt(e))!mt.call(r,s)&&s!==t&&Re(r,s,{get:()=>e[s],enumerable:!(n=ft(e,s))||n.enumerable});return r};var yt=r=>ht(Re({},"__esModule",{value:!0}),r);var Pt={};pt(Pt,{AuditChain:()=>B,AuditError:()=>G,ClockDriftError:()=>L,CommitmentRecord:()=>P,ConfidenceGate:()=>J,DataCategory:()=>Ce,FaultCode:()=>Ae,GateError:()=>C,HiTLGate:()=>Y,KeyStore:()=>ue,MessageType:()=>T,NodeClient:()=>se,OfflineModeManager:()=>ge,QoSAckTimeoutError:()=>ie,QoSLevel:()=>xe,QoSManager:()=>ae,RCANAddressError:()=>W,RCANConfigAuthorizationError:()=>re,RCANDelegationChainError:()=>te,RCANError:()=>y,RCANGateError:()=>z,RCANMessage:()=>m,RCANMessageError:()=>v,RCANNodeError:()=>D,RCANNodeNotFoundError:()=>A,RCANNodeSyncError:()=>h,RCANNodeTrustError:()=>$,RCANRegistryError:()=>U,RCANReplayAttackError:()=>ee,RCANSignatureError:()=>X,RCANValidationError:()=>Q,RCANVersionIncompatibleError:()=>Z,RCAN_VERSION:()=>Dt,RegistryClient:()=>ne,ReplayCache:()=>de,RevocationCache:()=>K,RobotURI:()=>I,RobotURIError:()=>k,SAFETY_MESSAGE_TYPE:()=>we,SPEC_VERSION:()=>b,VERSION:()=>Ut,addDelegationHop:()=>Ie,assertClockSynced:()=>Be,checkClockSync:()=>Ee,checkRevocation:()=>Ze,fetchCanonicalSchema:()=>oe,isSafetyMessage:()=>Fe,makeCloudRelayMessage:()=>ke,makeConfigUpdate:()=>We,makeConsentDeny:()=>me,makeConsentGrant:()=>le,makeConsentRequest:()=>fe,makeEstopMessage:()=>Ke,makeEstopWithQoS:()=>Le,makeFaultReport:()=>ot,makeKeyRotationMessage:()=>ze,makeResumeMessage:()=>Ve,makeRevocationBroadcast:()=>et,makeStopMessage:()=>He,makeTrainingConsentDeny:()=>nt,makeTrainingConsentGrant:()=>rt,makeTrainingConsentRequest:()=>tt,makeTransparencyMessage:()=>Ye,validateConfig:()=>$e,validateConfigAgainstSchema:()=>qe,validateConfigUpdate:()=>Qe,validateConsentMessage:()=>Xe,validateDelegationChain:()=>Te,validateMessage:()=>Pe,validateNodeAgainstSchema:()=>je,validateReplay:()=>Ge,validateSafetyMessage:()=>Je,validateTrainingDataMessage:()=>st,validateURI:()=>De,validateVersionCompat:()=>Oe});var k=class extends Error{constructor(e){super(e),this.name="RobotURIError"}},I=class r{registry;manufacturer;model;version;deviceId;constructor(e){this.registry=e.registry,this.manufacturer=e.manufacturer,this.model=e.model,this.version=e.version,this.deviceId=e.deviceId}static parse(e){if(!e.startsWith("rcan://"))throw new k(`URI must start with 'rcan://' \u2014 got: ${e}`);let n=e.slice(7).split("/");if(n.length!==5)throw new k(`URI must have exactly 5 path segments (registry/manufacturer/model/version/device-id) \u2014 got ${n.length} in: ${e}`);let[s,o,i,c,d]=n;for(let[u,g]of[["registry",s],["manufacturer",o],["model",i],["version",c],["device-id",d]])if(!g||g.trim()==="")throw new k(`URI segment '${u}' must not be empty`);return new r({registry:s,manufacturer:o,model:i,version:c,deviceId:d})}static build(e){let t=e.registry??"registry.rcan.dev",{manufacturer:n,model:s,version:o,deviceId:i}=e;for(let[c,d]of[["manufacturer",n],["model",s],["version",o],["deviceId",i]])if(!d||d.trim()==="")throw new k(`'${c}' must not be empty`);return new r({registry:t,manufacturer:n,model:s,version:o,deviceId:i})}toString(){return`rcan://${this.registry}/${this.manufacturer}/${this.model}/${this.version}/${this.deviceId}`}get namespace(){return`${this.manufacturer}/${this.model}`}get registryUrl(){return`https://${this.registry}/registry/${this.manufacturer}/${this.model}/${this.version}/${this.deviceId}`}equals(e){return this.toString()===e.toString()}toJSON(){return{uri:this.toString(),registry:this.registry,manufacturer:this.manufacturer,model:this.model,version:this.version,deviceId:this.deviceId}}};var b="1.5";function Oe(r,e="1.5"){let t=o=>{let i=o.split("."),c=parseInt(i[0]??"0",10),d=parseInt(i[1]??"0",10);return[isNaN(c)?0:c,isNaN(d)?0:d]},[n]=t(r),[s]=t(e);return n===s}var T=(a=>(a[a.COMMAND=1]="COMMAND",a[a.RESPONSE=2]="RESPONSE",a[a.STATUS=3]="STATUS",a[a.HEARTBEAT=4]="HEARTBEAT",a[a.CONFIG=5]="CONFIG",a[a.SAFETY=6]="SAFETY",a[a.SENSOR_DATA=7]="SENSOR_DATA",a[a.AUDIT=8]="AUDIT",a[a.DISCOVER=9]="DISCOVER",a[a.TRAINING_DATA=10]="TRAINING_DATA",a[a.TRANSPARENCY=11]="TRANSPARENCY",a[a.FEDERATION_SYNC=12]="FEDERATION_SYNC",a[a.ALERT=13]="ALERT",a[a.TELEOP=14]="TELEOP",a[a.CHAT=15]="CHAT",a[a.ERROR=16]="ERROR",a[a.COMMAND_ACK=17]="COMMAND_ACK",a[a.COMMAND_COMMIT=18]="COMMAND_COMMIT",a[a.ROBOT_REVOCATION=19]="ROBOT_REVOCATION",a[a.CONSENT_REQUEST=20]="CONSENT_REQUEST",a[a.CONSENT_GRANT=21]="CONSENT_GRANT",a[a.CONSENT_DENY=22]="CONSENT_DENY",a[a.FLEET_COMMAND=23]="FLEET_COMMAND",a[a.SUBSCRIBE=24]="SUBSCRIBE",a[a.UNSUBSCRIBE=25]="UNSUBSCRIBE",a[a.FAULT_REPORT=26]="FAULT_REPORT",a[a.COMMAND_NACK=27]="COMMAND_NACK",a))(T||{}),v=class extends Error{constructor(e){super(e),this.name="RCANMessageError"}},m=class r{rcan;rcanVersion;cmd;target;params;confidence;modelIdentity;signature;timestamp;senderType;cloudProvider;keyId;delegationChain;groupId;qos;presenceVerified;proximityMeters;readOnly;constructor(e){if(!e.cmd||e.cmd.trim()==="")throw new v("'cmd' is required");if(!e.target)throw new v("'target' is required");if(this.rcan=e.rcan??"1.5",this.rcanVersion=e.rcanVersion??"1.5",this.cmd=e.cmd,this.target=e.target instanceof I?e.target.toString():String(e.target),this.params=e.params??{},this.confidence=e.confidence,this.modelIdentity=e.modelIdentity??e.model_identity,this.signature=e.signature,this.timestamp=e.timestamp??new Date().toISOString(),this.senderType=e.senderType,this.cloudProvider=e.cloudProvider,this.keyId=e.keyId,this.delegationChain=e.delegationChain,this.groupId=e.groupId,this.qos=e.qos,this.presenceVerified=e.presenceVerified,this.proximityMeters=e.proximityMeters,this.readOnly=e.readOnly,this.confidence!==void 0&&(this.confidence<0||this.confidence>1))throw new v(`confidence must be in [0.0, 1.0] \u2014 got ${this.confidence}`)}get isSigned(){return this.signature!==void 0&&this.signature.sig!==""}get isAiDriven(){return this.confidence!==void 0}toJSON(){let e={rcan:this.rcan,rcanVersion:this.rcanVersion,cmd:this.cmd,target:this.target,timestamp:this.timestamp};return Object.keys(this.params).length>0&&(e.params=this.params),this.confidence!==void 0&&(e.confidence=this.confidence),this.modelIdentity&&(e.model_identity=this.modelIdentity),this.signature&&(e.signature=this.signature),this.senderType!==void 0&&(e.senderType=this.senderType),this.cloudProvider!==void 0&&(e.cloudProvider=this.cloudProvider),this.keyId!==void 0&&(e.keyId=this.keyId),this.delegationChain!==void 0&&(e.delegationChain=this.delegationChain),this.groupId!==void 0&&(e.groupId=this.groupId),this.qos!==void 0&&(e.qos=this.qos),this.presenceVerified!==void 0&&(e.presenceVerified=this.presenceVerified),this.proximityMeters!==void 0&&(e.proximityMeters=this.proximityMeters),this.readOnly!==void 0&&(e.readOnly=this.readOnly),e}toJSONString(e){return JSON.stringify(this.toJSON(),null,e)}static fromJSON(e){let t;if(typeof e=="string")try{t=JSON.parse(e)}catch{throw new v("Invalid JSON string")}else t=e;if(!t.cmd)throw new v("Missing required field: 'cmd'");if(!t.target)throw new v("Missing required field: 'target'");if(!t.rcan)throw new v("Missing required field: 'rcan'");return new r({rcan:t.rcan,rcanVersion:t.rcanVersion,cmd:t.cmd,target:t.target,params:t.params??{},confidence:t.confidence,modelIdentity:t.model_identity??t.modelIdentity,signature:t.signature,timestamp:t.timestamp,senderType:t.senderType,cloudProvider:t.cloudProvider,keyId:t.keyId,delegationChain:t.delegationChain,groupId:t.groupId,qos:t.qos,presenceVerified:t.presenceVerified,proximityMeters:t.proximityMeters,readOnly:t.readOnly})}};function ke(r,e){let t=r.toJSON();return t.senderType="cloud_function",t.cloudProvider=e,new m(t)}function Ie(r,e){let t=r.delegationChain?[...r.delegationChain,e]:[e],n=r.toJSON();return n.delegationChain=t,new m(n)}function Te(r){if(r.length>4)return{valid:!1,reason:"DELEGATION_CHAIN_EXCEEDED: max depth is 4 hops"};for(let e=0;e<r.length;e++){let t=r[e];if(!t)return{valid:!1,reason:`hop ${e} is undefined`};if(!t.issuerRuri)return{valid:!1,reason:`hop ${e}: missing issuerRuri`};if(!t.humanSubject)return{valid:!1,reason:`hop ${e}: missing humanSubject`};if(!t.timestamp)return{valid:!1,reason:`hop ${e}: missing timestamp`};if(!t.scope)return{valid:!1,reason:`hop ${e}: missing scope`};if(!t.signature)return{valid:!1,reason:`hop ${e}: missing signature`}}return{valid:!0,reason:"ok"}}function F(){if(typeof globalThis.crypto<"u"&&typeof globalThis.crypto.randomUUID=="function")return globalThis.crypto.randomUUID();try{let{randomUUID:r}=gt("crypto");return r()}catch{return"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,r=>{let e=Math.random()*16|0;return(r==="x"?e:e&3|8).toString(16)})}}function Se(r,e){return typeof process<"u",_t(r,e)}function _e(r){let e=[1116352408,1899447441,3049323471,3921009573,961987163,1508970993,2453635748,2870763221,3624381080,310598401,607225278,1426881987,1925078388,2162078206,2614888103,3248222580,3835390401,4022224774,264347078,604807628,770255983,1249150122,1555081692,1996064986,2554220882,2821834349,2952996808,3210313671,3336571891,3584528711,113926993,338241895,666307205,773529912,1294757372,1396182291,1695183700,1986661051,2177026350,2456956037,2730485921,2820302411,3259730800,3345764771,3516065817,3600352804,4094571909,275423344,430227734,506948616,659060556,883997877,958139571,1322822218,1537002063,1747873779,1955562222,2024104815,2227730452,2361852424,2428436474,2756734187,3204031479,3329325298],t=1779033703,n=3144134277,s=1013904242,o=2773480762,i=1359893119,c=2600822924,d=528734635,u=1541459225,it=r.length*8,E=[...r];for(E.push(128);E.length%64!==56;)E.push(0);for(let S=7;S>=0;S--)E.push(it/Math.pow(2,S*8)&255);for(let S=0;S<E.length;S+=64){let R=[];for(let f=0;f<16;f++)R[f]=E[S+f*4]<<24|E[S+f*4+1]<<16|E[S+f*4+2]<<8|E[S+f*4+3];for(let f=16;f<64;f++){let ye=x(R[f-15],7)^x(R[f-15],18)^R[f-15]>>>3,a=x(R[f-2],17)^x(R[f-2],19)^R[f-2]>>>10;R[f]=R[f-16]+ye+R[f-7]+a>>>0}let[N,q,j,pe,O,H,V,he]=[t,n,s,o,i,c,d,u];for(let f=0;f<64;f++){let ye=x(O,6)^x(O,11)^x(O,25),a=O&H^~O&V,Ne=he+ye+a+e[f]+R[f]>>>0,ct=x(N,2)^x(N,13)^x(N,22),dt=N&q^N&j^q&j,ut=ct+dt>>>0;[he,V,H,O,pe,j,q,N]=[V,H,O,pe+Ne>>>0,j,q,N,Ne+ut>>>0]}t=t+N>>>0,n=n+q>>>0,s=s+j>>>0,o=o+pe>>>0,i=i+O>>>0,c=c+H>>>0,d=d+V>>>0,u=u+he>>>0}let p=new Uint8Array(32),at=new DataView(p.buffer);return[t,n,s,o,i,c,d,u].forEach((S,R)=>at.setUint32(R*4,S)),p}function x(r,e){return r>>>e|r<<32-e}function Me(r){if(typeof TextEncoder<"u")return new TextEncoder().encode(r);let e=new Uint8Array(r.length);for(let t=0;t<r.length;t++)e[t]=r.charCodeAt(t)&255;return e}function Rt(r){return Array.from(r).map(e=>e.toString(16).padStart(2,"0")).join("")}function _t(r,e){let n=Me(r);n.length>64&&(n=_e(n));let s=new Uint8Array(64),o=new Uint8Array(64);for(let g=0;g<64;g++)s[g]=(n[g]??0)^54,o[g]=(n[g]??0)^92;let i=Me(e),c=new Uint8Array(64+i.length);c.set(s),c.set(i,64);let d=_e(c),u=new Uint8Array(96);return u.set(o),u.set(d,64),Rt(_e(u))}var C=class extends Error{constructor(e){super(e),this.name="GateError"}},J=class{threshold;constructor(e=.8){if(e<0||e>1)throw new C(`threshold must be in [0.0, 1.0] \u2014 got ${e}`);this.threshold=e}allows(e){return e>=this.threshold}margin(e){return e-this.threshold}assert(e,t){if(!this.allows(e)){let n=t?` for action '${t}'`:"";throw new C(`Confidence ${e}${n} is below threshold ${this.threshold}`)}}},Y=class{_pending=new Map;request(e,t={}){let n=F();return this._pending.set(n,{token:n,action:e,context:t,createdAt:new Date().toISOString(),status:"pending"}),n}approve(e){let t=this._pending.get(e);if(!t)throw new C(`Unknown token: ${e}`);t.status="approved"}deny(e,t){let n=this._pending.get(e);if(!n)throw new C(`Unknown token: ${e}`);n.status="denied",t&&(n.reason=t)}check(e){let t=this._pending.get(e);if(!t)throw new C(`Unknown token: ${e}`);return t.status}get pendingApprovals(){return Array.from(this._pending.values()).filter(e=>e.status==="pending")}getApproval(e){return this._pending.get(e)}clearResolved(){for(let[e,t]of this._pending.entries())t.status!=="pending"&&this._pending.delete(e)}};var G=class extends Error{constructor(e){super(e),this.name="AuditError"}};function St(r,e,t,n,s){let o=JSON.stringify({recordId:r,action:e,robotUri:t,timestamp:n,params:s},Object.keys({recordId:r,action:e,robotUri:t,timestamp:n,params:s}).sort());return Se("rcan-content-hash",o)}function Ue(r,e){let{hmac:t,...n}=e,s=JSON.stringify(n,Object.keys(n).sort());return Se(r,s)}var P=class r{recordId;action;robotUri;confidence;modelIdentity;params;safetyApproved;timestamp;contentHash;previousHash;hmac;constructor(e){this.recordId=e.recordId,this.action=e.action,this.robotUri=e.robotUri,this.confidence=e.confidence,this.modelIdentity=e.modelIdentity,this.params=e.params,this.safetyApproved=e.safetyApproved,this.timestamp=e.timestamp,this.contentHash=e.contentHash,this.previousHash=e.previousHash,this.hmac=e.hmac}static create(e,t,n=null){let s=F(),o=new Date().toISOString(),i=e.params??{},c=e.robotUri??"",d=St(s,e.action,c,o,i),u={recordId:s,action:e.action,robotUri:c,confidence:e.confidence,modelIdentity:e.modelIdentity,params:i,safetyApproved:e.safetyApproved??!0,timestamp:o,contentHash:d,previousHash:n,hmac:""};return u.hmac=Ue(t,u),new r(u)}verify(e){return Ue(e,this.toJSON())===this.hmac}toJSON(){return{recordId:this.recordId,action:this.action,robotUri:this.robotUri,confidence:this.confidence,modelIdentity:this.modelIdentity,params:this.params,safetyApproved:this.safetyApproved,timestamp:this.timestamp,contentHash:this.contentHash,previousHash:this.previousHash,hmac:this.hmac}}static fromJSON(e){return new r(e)}},B=class r{_records=[];_secret;constructor(e){this._secret=e}get records(){return this._records}append(e){let n=this._records[this._records.length-1]?.contentHash??null,s=P.create(e,this._secret,n);return this._records.push(s),s}verifyAll(){let e=[],t=null;for(let n of this._records)n.verify(this._secret)||e.push(`HMAC invalid for record ${n.recordId.slice(0,8)}`),t!==null&&n.previousHash!==t&&e.push(`Chain broken at ${n.recordId.slice(0,8)}: expected prev=${t.slice(0,12)}`),t=n.contentHash;return{valid:e.length===0,count:this._records.length,errors:e}}toJSONL(){return this._records.map(e=>JSON.stringify(e.toJSON())).join(`
|
|
2
2
|
`)+`
|
|
3
|
-
`}static fromJSONL(t
|
|
4
|
-
`).filter(o=>o.trim()!=="");for(let o of s){let i=JSON.parse(o);r._records.push(U.fromJSON(i))}return r}};function nt(){return{ok:!0,issues:[],warnings:[],info:[]}}function b(n,t){n.ok=!1,n.issues.push(t)}function $(n,t){n.warnings.push(t)}function p(n,t){n.info.push(t)}function dt(n){let t=nt();try{let e=_.parse(n);p(t,"\u2705 Valid RCAN URI"),p(t,` Registry: ${e.registry}`),p(t,` Manufacturer: ${e.manufacturer}`),p(t,` Model: ${e.model}`),p(t,` Version: ${e.version}`),p(t,` Device ID: ${e.deviceId}`)}catch(e){b(t,`Invalid RCAN URI: ${e instanceof Error?e.message:e}`)}return t}function ut(n){let t=nt(),e;if(typeof n=="string")try{e=JSON.parse(n)}catch{return b(t,"Invalid JSON string"),t}else if(typeof n=="object"&&n!==null)e=n;else return b(t,"Expected object or JSON string"),t;for(let r of["rcan","cmd","target"])(!(r in e)||!e[r])&&b(t,`Missing required field: '${r}'`);if(!t.ok)return t;try{let r=O.fromJSON(e);p(t,`\u2705 RCAN message valid (v${r.rcan})`),p(t,` cmd: ${r.cmd}`),p(t,` target: ${r.target}`),r.confidence!==void 0?p(t,` confidence: ${r.confidence}`):$(t,"No confidence score \u2014 add for RCAN \xA716 AI accountability"),r.isSigned?p(t,` signature: alg=${r.signature?.alg}, kid=${r.signature?.kid}`):$(t,"Message is unsigned (recommended for production)")}catch(r){b(t,`Message validation failed: ${r instanceof Error?r.message:r}`)}return t}function lt(n){let t=nt(),e=n.metadata??{},r=n.agent??{},s=n.rcan_protocol??{};for(let i of["rcan_version","metadata","agent"])(!(i in n)||n[i]===void 0||n[i]===null)&&b(t,`Missing required key: '${i}'`);let o=n.rcan_version;if(o&&(/^\d+\.\d+$/.test(o)||b(t,`rcan_version '${o}' must match pattern N.N (e.g. '1.2')`)),e.manufacturer||b(t,"L1: metadata.manufacturer is required (\xA72)"),e.model||b(t,"L1: metadata.model is required (\xA72)"),!e.device_id&&!e.robot_name&&b(t,"L1: metadata.device_id (or robot_name) is required (\xA72)"),s.jwt_auth?.enabled||$(t,"L2: jwt_auth not enabled (required for L2 conformance, \xA78)"),(!r.confidence_gates||r.confidence_gates.length===0)&&$(t,"L2: confidence_gates not configured (\xA716)"),(!r.hitl_gates||r.hitl_gates.length===0)&&$(t,"L3: hitl_gates not configured (\xA716)"),r.commitment_chain?.enabled||$(t,"L3: commitment_chain not enabled (\xA716)"),e.rrn?p(t,`\u2705 RRN registered: ${e.rrn}`):$(t,"Robot not registered \u2014 visit rcan.dev/registry/register"),t.ok&&t.issues.length===0){let i=!t.warnings.some(u=>u.startsWith("L1")),a=i&&!t.warnings.some(u=>u.startsWith("L2")),d=a&&!t.warnings.some(u=>u.startsWith("L3"))?"L3":a?"L2":i?"L1":"FAIL";p(t,`\u2705 Config valid \u2014 conformance level: ${d}`)}return t}var x=class extends Error{constructor(t){super(t),this.name="RCANError",Object.setPrototypeOf(this,new.target.prototype)}},B=class extends x{constructor(t){super(t),this.name="RCANAddressError",Object.setPrototypeOf(this,new.target.prototype)}},V=class extends x{constructor(t){super(t),this.name="RCANValidationError",Object.setPrototypeOf(this,new.target.prototype)}},K=class extends x{constructor(e,r,s,o){super(e);this.gateType=r;this.value=s;this.threshold=o;this.name="RCANGateError",Object.setPrototypeOf(this,new.target.prototype)}},F=class extends x{constructor(t){super(t),this.name="RCANSignatureError",Object.setPrototypeOf(this,new.target.prototype)}},k=class extends x{constructor(t){super(t),this.name="RCANRegistryError",Object.setPrototypeOf(this,new.target.prototype)}},I=class n extends x{constructor(e,r){super(e);this.nodeUrl=r;this.name="RCANNodeError",Object.setPrototypeOf(this,n.prototype)}},N=class n extends I{constructor(e,r){super(`RRN not found in federation: ${e}`,r);this.rrn=e;this.name="RCANNodeNotFoundError",Object.setPrototypeOf(this,n.prototype)}},g=class n extends I{constructor(e,r,s){super(e,r);this.cause=s;this.name="RCANNodeSyncError",Object.setPrototypeOf(this,n.prototype)}},E=class n extends I{reason;constructor(t,e){super(`Node trust verification failed: ${t}`,e),this.name="RCANNodeTrustError",this.reason=t,Object.setPrototypeOf(this,n.prototype)}};var kt="https://rcan-spec.pages.dev",W=class{baseUrl;apiKey;timeout;constructor(t){this.baseUrl=(t?.baseUrl??kt).replace(/\/$/,""),this.apiKey=t?.apiKey,this.timeout=t?.timeout??1e4}async _fetch(t,e={}){let r=`${this.baseUrl}${t}`,s=new AbortController,o=setTimeout(()=>s.abort(),this.timeout);try{return await fetch(r,{...e,signal:s.signal,headers:{"Content-Type":"application/json",...e.headers??{}}})}finally{clearTimeout(o)}}_authHeaders(){if(!this.apiKey)throw new k("API key required for write operations. Pass apiKey to RegistryClient.");return{Authorization:`Bearer ${this.apiKey}`}}async _checkResponse(t){if(!t.ok){let e=`Registry API error: ${t.status}`;try{let r=await t.json();r?.error&&(e=r.error)}catch{}throw new k(e)}return await t.json()}async register(t){let e=await this._fetch("/api/v1/robots",{method:"POST",body:JSON.stringify(t)});return this._checkResponse(e)}async get(t){let e=await this._fetch(`/api/v1/robots/${encodeURIComponent(t)}`);return this._checkResponse(e)}async list(t){let e=new URLSearchParams;t?.limit!==void 0&&e.set("limit",String(t.limit)),t?.offset!==void 0&&e.set("offset",String(t.offset)),t?.tier&&e.set("tier",t.tier);let r=e.toString()?`?${e}`:"",s=await this._fetch(`/api/v1/robots${r}`);return this._checkResponse(s)}async patch(t,e){let r=await this._fetch(`/api/v1/robots/${encodeURIComponent(t)}`,{method:"PATCH",headers:this._authHeaders(),body:JSON.stringify(e)});return this._checkResponse(r)}async delete(t){let e=await this._fetch(`/api/v1/robots/${encodeURIComponent(t)}`,{method:"DELETE",headers:this._authHeaders()});e.ok||await this._checkResponse(e)}async search(t){let e=new URLSearchParams;t.q&&e.set("q",t.q),t.manufacturer&&e.set("manufacturer",t.manufacturer),t.model&&e.set("model",t.model),t.tier&&e.set("tier",t.tier);let r=e.toString()?`?${e}`:"",s=await this._fetch(`/api/v1/robots/search${r}`);if(!s.ok){let i=await this._fetch(`/api/v1/robots${r}`),a=await this._checkResponse(i);return"robots"in a?a.robots:"results"in a&&a.results?a.results:[]}let o=await s.json();return Array.isArray(o)?o:"results"in o&&o.results?o.results:"robots"in o?o.robots:[]}};var It="https://rcan.dev",Ot="/.well-known/rcan-node.json",Ut=new Set(["root","authoritative","resolver","cache"]);function Et(n){let t=n.match(/^RRN-([A-Z0-9]{2,8})-(\d{8,16})$/);if(t)return{type:"delegated",prefix:t[1],serial:t[2]};let e=n.match(/^RRN-(\d{8,16})$/);return e?{type:"root",serial:e[1]}:null}var G=class{rootUrl;timeoutMs;constructor(t=It,e=1e4){this.rootUrl=t.replace(/\/$/,""),this.timeoutMs=e}async _fetch(t){let e=new AbortController,r=setTimeout(()=>e.abort(),this.timeoutMs);try{return await globalThis.fetch(t,{signal:e.signal})}catch(s){throw s instanceof Error&&s.name==="AbortError"?new g(`Request timed out: ${t}`,t,s):new g(`Network error fetching ${t}: ${s.message}`,t,s instanceof Error?s:void 0)}finally{clearTimeout(r)}}async getNodeManifest(t){let e=`${t.replace(/\/$/,"")}${Ot}`,r=await this._fetch(e);if(!r.ok)throw r.status===404?new N(e,t):new g(`Failed to fetch node manifest from ${t}: HTTP ${r.status}`,t);let s;try{s=await r.json()}catch(o){throw new g(`Invalid JSON in node manifest from ${t}`,t,o instanceof Error?o:void 0)}if(!this.verifyNode(s))throw new E("missing_pubkey",t);return s}async listNodes(t){let e=t?`?prefix=${encodeURIComponent(t)}`:"",r=`${this.rootUrl}/api/v1/nodes${e}`,s=await this._fetch(r);if(!s.ok)throw new g(`Failed to list nodes from ${r}: HTTP ${s.status}`,r);let o;try{o=await s.json()}catch(i){throw new g(`Invalid JSON in nodes list from ${r}`,r,i instanceof Error?i:void 0)}return Array.isArray(o)?o:o&&typeof o=="object"&&"nodes"in o?o.nodes:[]}async discover(t){let e=Et(t);if(!e)throw new N(t,this.rootUrl);if(e.type==="root")return this.getNodeManifest(this.rootUrl);let r=await this.listNodes(e.prefix);if(r.length===0)throw new N(t,this.rootUrl);return r[0]}async resolve(t){let e=`${this.rootUrl}/api/v1/resolve/${encodeURIComponent(t)}`,r;try{r=await this._fetch(e)}catch(a){throw a}if(r.ok)try{return await r.json()}catch(a){throw new g(`Invalid JSON in resolve response for ${t}`,this.rootUrl,a instanceof Error?a:void 0)}if(r.status!==404)throw new g(`Unexpected HTTP ${r.status} resolving ${t}`,this.rootUrl);let s=await this.discover(t),o=`${s.api_base.replace(/\/$/,"")}/robots/${encodeURIComponent(t)}`,i=await this._fetch(o);if(!i.ok)throw i.status===404?new N(t,s.api_base):new g(`HTTP ${i.status} from authoritative node for ${t}`,s.api_base);try{return await i.json()}catch(a){throw new g(`Invalid JSON in fallback resolve response for ${t}`,s.api_base,a instanceof Error?a:void 0)}}verifyNode(t){if(!t||typeof t!="object")return!1;let e=t;return!(typeof e.rcan_node_version!="string"||!e.rcan_node_version||typeof e.node_type!="string"||!Ut.has(e.node_type)||typeof e.operator!="string"||!e.operator||typeof e.namespace_prefix!="string"||!e.namespace_prefix||typeof e.public_key!="string"||!e.public_key.startsWith("ed25519:")||typeof e.api_base!="string"||!e.api_base.startsWith("https://"))}};var jt="https://rcan.dev/schemas",st=new Map;async function z(n){if(st.has(n))return st.get(n);try{let t=new AbortController,e=setTimeout(()=>t.abort(),5e3),r=await fetch(`${jt}/${n}`,{signal:t.signal});if(clearTimeout(e),!r.ok)return null;let s=await r.json();return st.set(n,s),s}catch{return null}}async function gt(n){let t=await z("rcan-config.schema.json");if(!t)return{valid:!0,skipped:!0};let e=[];if(typeof n!="object"||n===null)return{valid:!1,errors:["Config must be an object"]};let r=n,s=t.required??[];for(let o of s)o in r||e.push(`Missing required field: ${o}`);return e.length===0?{valid:!0}:{valid:!1,errors:e}}async function ft(n){let t=await z("rcan-node.schema.json");if(!t)return{valid:!0,skipped:!0};let e=[];if(typeof n!="object"||n===null)return{valid:!1,errors:["Manifest must be an object"]};let r=n,s=t.required??[];for(let o of s)o in r||e.push(`Missing required field: ${o}`);return e.length===0?{valid:!0}:{valid:!1,errors:e}}var Pt="0.3.0",Lt="1.2",Tt="1.2";return Ct(Ht);})();
|
|
3
|
+
`}static fromJSONL(e,t){let n=new r(t),s=e.trim().split(`
|
|
4
|
+
`).filter(o=>o.trim()!=="");for(let o of s){let i=JSON.parse(o);n._records.push(P.fromJSON(i))}return n}};function be(){return{ok:!0,issues:[],warnings:[],info:[]}}function w(r,e){r.ok=!1,r.issues.push(e)}function M(r,e){r.warnings.push(e)}function _(r,e){r.info.push(e)}function De(r){let e=be();try{let t=I.parse(r);_(e,"\u2705 Valid RCAN URI"),_(e,` Registry: ${t.registry}`),_(e,` Manufacturer: ${t.manufacturer}`),_(e,` Model: ${t.model}`),_(e,` Version: ${t.version}`),_(e,` Device ID: ${t.deviceId}`)}catch(t){w(e,`Invalid RCAN URI: ${t instanceof Error?t.message:t}`)}return e}function Pe(r){let e=be(),t;if(typeof r=="string")try{t=JSON.parse(r)}catch{return w(e,"Invalid JSON string"),e}else if(typeof r=="object"&&r!==null)t=r;else return w(e,"Expected object or JSON string"),e;for(let n of["rcan","cmd","target"])(!(n in t)||!t[n])&&w(e,`Missing required field: '${n}'`);if(!e.ok)return e;try{let n=m.fromJSON(t);_(e,`\u2705 RCAN message valid (v${n.rcan})`),_(e,` cmd: ${n.cmd}`),_(e,` target: ${n.target}`),n.confidence!==void 0?_(e,` confidence: ${n.confidence}`):M(e,"No confidence score \u2014 add for RCAN \xA716 AI accountability"),n.isSigned?_(e,` signature: alg=${n.signature?.alg}, kid=${n.signature?.kid}`):M(e,"Message is unsigned (recommended for production)")}catch(n){w(e,`Message validation failed: ${n instanceof Error?n.message:n}`)}return e}function $e(r){let e=be(),t=r.metadata??{},n=r.agent??{},s=r.rcan_protocol??{};for(let i of["rcan_version","metadata","agent"])(!(i in r)||r[i]===void 0||r[i]===null)&&w(e,`Missing required key: '${i}'`);let o=r.rcan_version;if(o&&(/^\d+\.\d+$/.test(o)||w(e,`rcan_version '${o}' must match pattern N.N (e.g. '1.2')`)),t.manufacturer||w(e,"L1: metadata.manufacturer is required (\xA72)"),t.model||w(e,"L1: metadata.model is required (\xA72)"),!t.device_id&&!t.robot_name&&w(e,"L1: metadata.device_id (or robot_name) is required (\xA72)"),s.jwt_auth?.enabled||M(e,"L2: jwt_auth not enabled (required for L2 conformance, \xA78)"),(!n.confidence_gates||n.confidence_gates.length===0)&&M(e,"L2: confidence_gates not configured (\xA716)"),(!n.hitl_gates||n.hitl_gates.length===0)&&M(e,"L3: hitl_gates not configured (\xA716)"),n.commitment_chain?.enabled||M(e,"L3: commitment_chain not enabled (\xA716)"),t.rrn?_(e,`\u2705 RRN registered: ${t.rrn}`):M(e,"Robot not registered \u2014 visit rcan.dev/registry/register"),e.ok&&e.issues.length===0){let i=!e.warnings.some(g=>g.startsWith("L1")),c=i&&!e.warnings.some(g=>g.startsWith("L2")),u=c&&!e.warnings.some(g=>g.startsWith("L3"))?"L3":c?"L2":i?"L1":"FAIL";_(e,`\u2705 Config valid \u2014 conformance level: ${u}`)}return e}var y=class extends Error{constructor(e){super(e),this.name="RCANError",Object.setPrototypeOf(this,new.target.prototype)}},W=class extends y{constructor(e){super(e),this.name="RCANAddressError",Object.setPrototypeOf(this,new.target.prototype)}},Q=class extends y{constructor(e){super(e),this.name="RCANValidationError",Object.setPrototypeOf(this,new.target.prototype)}},z=class extends y{constructor(t,n,s,o){super(t);this.gateType=n;this.value=s;this.threshold=o;this.name="RCANGateError",Object.setPrototypeOf(this,new.target.prototype)}},X=class extends y{constructor(e){super(e),this.name="RCANSignatureError",Object.setPrototypeOf(this,new.target.prototype)}},U=class extends y{constructor(e){super(e),this.name="RCANRegistryError",Object.setPrototypeOf(this,new.target.prototype)}},D=class r extends y{constructor(t,n){super(t);this.nodeUrl=n;this.name="RCANNodeError",Object.setPrototypeOf(this,r.prototype)}},A=class r extends D{constructor(t,n){super(`RRN not found in federation: ${t}`,n);this.rrn=t;this.name="RCANNodeNotFoundError",Object.setPrototypeOf(this,r.prototype)}},h=class r extends D{constructor(t,n,s){super(t,n);this.cause=s;this.name="RCANNodeSyncError",Object.setPrototypeOf(this,r.prototype)}},$=class r extends D{reason;constructor(e,t){super(`Node trust verification failed: ${e}`,t),this.name="RCANNodeTrustError",this.reason=e,Object.setPrototypeOf(this,r.prototype)}},Z=class r extends y{constructor(e,t){super(`VERSION_INCOMPATIBLE: incoming=${e}, local=${t}`),this.name="RCANVersionIncompatibleError",Object.setPrototypeOf(this,r.prototype)}},ee=class r extends y{constructor(e){super(`REPLAY_DETECTED: ${e}`),this.name="RCANReplayAttackError",Object.setPrototypeOf(this,r.prototype)}},te=class r extends y{constructor(e){super(`DELEGATION_CHAIN_ERROR: ${e}`),this.name="RCANDelegationChainError",Object.setPrototypeOf(this,r.prototype)}},re=class r extends y{constructor(e){super(`CONFIG_AUTH_ERROR: ${e}`),this.name="RCANConfigAuthorizationError",Object.setPrototypeOf(this,r.prototype)}};var bt="https://rcan-spec.pages.dev",ne=class{baseUrl;apiKey;timeout;constructor(e){this.baseUrl=(e?.baseUrl??bt).replace(/\/$/,""),this.apiKey=e?.apiKey,this.timeout=e?.timeout??1e4}async _fetch(e,t={}){let n=`${this.baseUrl}${e}`,s=new AbortController,o=setTimeout(()=>s.abort(),this.timeout);try{return await fetch(n,{...t,signal:s.signal,headers:{"Content-Type":"application/json",...t.headers??{}}})}finally{clearTimeout(o)}}_authHeaders(){if(!this.apiKey)throw new U("API key required for write operations. Pass apiKey to RegistryClient.");return{Authorization:`Bearer ${this.apiKey}`}}async _checkResponse(e){if(!e.ok){let t=`Registry API error: ${e.status}`;try{let n=await e.json();n?.error&&(t=n.error)}catch{}throw new U(t)}return await e.json()}async register(e){let t=await this._fetch("/api/v1/robots",{method:"POST",body:JSON.stringify(e)});return this._checkResponse(t)}async get(e){let t=await this._fetch(`/api/v1/robots/${encodeURIComponent(e)}`);return this._checkResponse(t)}async list(e){let t=new URLSearchParams;e?.limit!==void 0&&t.set("limit",String(e.limit)),e?.offset!==void 0&&t.set("offset",String(e.offset)),e?.tier&&t.set("tier",e.tier);let n=t.toString()?`?${t}`:"",s=await this._fetch(`/api/v1/robots${n}`);return this._checkResponse(s)}async patch(e,t){let n=await this._fetch(`/api/v1/robots/${encodeURIComponent(e)}`,{method:"PATCH",headers:this._authHeaders(),body:JSON.stringify(t)});return this._checkResponse(n)}async delete(e){let t=await this._fetch(`/api/v1/robots/${encodeURIComponent(e)}`,{method:"DELETE",headers:this._authHeaders()});t.ok||await this._checkResponse(t)}async search(e){let t=new URLSearchParams;e.q&&t.set("q",e.q),e.manufacturer&&t.set("manufacturer",e.manufacturer),e.model&&t.set("model",e.model),e.tier&&t.set("tier",e.tier);let n=t.toString()?`?${t}`:"",s=await this._fetch(`/api/v1/robots/search${n}`);if(!s.ok){let i=await this._fetch(`/api/v1/robots${n}`),c=await this._checkResponse(i);return"robots"in c?c.robots:"results"in c&&c.results?c.results:[]}let o=await s.json();return Array.isArray(o)?o:"results"in o&&o.results?o.results:"robots"in o?o.robots:[]}};var vt="https://rcan.dev",xt="/.well-known/rcan-node.json",wt=new Set(["root","authoritative","resolver","cache"]);function Et(r){let e=r.match(/^RRN-([A-Z0-9]{2,8})-(\d{8,16})$/);if(e)return{type:"delegated",prefix:e[1],serial:e[2]};let t=r.match(/^RRN-(\d{8,16})$/);return t?{type:"root",serial:t[1]}:null}var se=class{rootUrl;timeoutMs;constructor(e=vt,t=1e4){this.rootUrl=e.replace(/\/$/,""),this.timeoutMs=t}async _fetch(e){let t=new AbortController,n=setTimeout(()=>t.abort(),this.timeoutMs);try{return await globalThis.fetch(e,{signal:t.signal})}catch(s){throw s instanceof Error&&s.name==="AbortError"?new h(`Request timed out: ${e}`,e,s):new h(`Network error fetching ${e}: ${s.message}`,e,s instanceof Error?s:void 0)}finally{clearTimeout(n)}}async getNodeManifest(e){let t=`${e.replace(/\/$/,"")}${xt}`,n=await this._fetch(t);if(!n.ok)throw n.status===404?new A(t,e):new h(`Failed to fetch node manifest from ${e}: HTTP ${n.status}`,e);let s;try{s=await n.json()}catch(o){throw new h(`Invalid JSON in node manifest from ${e}`,e,o instanceof Error?o:void 0)}if(!this.verifyNode(s))throw new $("missing_pubkey",e);return s}async listNodes(e){let t=e?`?prefix=${encodeURIComponent(e)}`:"",n=`${this.rootUrl}/api/v1/nodes${t}`,s=await this._fetch(n);if(!s.ok)throw new h(`Failed to list nodes from ${n}: HTTP ${s.status}`,n);let o;try{o=await s.json()}catch(i){throw new h(`Invalid JSON in nodes list from ${n}`,n,i instanceof Error?i:void 0)}return Array.isArray(o)?o:o&&typeof o=="object"&&"nodes"in o?o.nodes:[]}async discover(e){let t=Et(e);if(!t)throw new A(e,this.rootUrl);if(t.type==="root")return this.getNodeManifest(this.rootUrl);let n=await this.listNodes(t.prefix);if(n.length===0)throw new A(e,this.rootUrl);return n[0]}async resolve(e){let t=`${this.rootUrl}/api/v1/resolve/${encodeURIComponent(e)}`,n;try{n=await this._fetch(t)}catch(c){throw c}if(n.ok)try{return await n.json()}catch(c){throw new h(`Invalid JSON in resolve response for ${e}`,this.rootUrl,c instanceof Error?c:void 0)}if(n.status!==404)throw new h(`Unexpected HTTP ${n.status} resolving ${e}`,this.rootUrl);let s=await this.discover(e),o=`${s.api_base.replace(/\/$/,"")}/robots/${encodeURIComponent(e)}`,i=await this._fetch(o);if(!i.ok)throw i.status===404?new A(e,s.api_base):new h(`HTTP ${i.status} from authoritative node for ${e}`,s.api_base);try{return await i.json()}catch(c){throw new h(`Invalid JSON in fallback resolve response for ${e}`,s.api_base,c instanceof Error?c:void 0)}}verifyNode(e){if(!e||typeof e!="object")return!1;let t=e;return!(typeof t.rcan_node_version!="string"||!t.rcan_node_version||typeof t.node_type!="string"||!wt.has(t.node_type)||typeof t.operator!="string"||!t.operator||typeof t.namespace_prefix!="string"||!t.namespace_prefix||typeof t.public_key!="string"||!t.public_key.startsWith("ed25519:")||typeof t.api_base!="string"||!t.api_base.startsWith("https://"))}};var Ct="https://rcan.dev/schemas",ve=new Map;async function oe(r){if(ve.has(r))return ve.get(r);try{let e=new AbortController,t=setTimeout(()=>e.abort(),5e3),n=await fetch(`${Ct}/${r}`,{signal:e.signal});if(clearTimeout(t),!n.ok)return null;let s=await n.json();return ve.set(r,s),s}catch{return null}}async function qe(r){let e=await oe("rcan-config.schema.json");if(!e)return{valid:!0,skipped:!0};let t=[];if(typeof r!="object"||r===null)return{valid:!1,errors:["Config must be an object"]};let n=r,s=e.required??[];for(let o of s)o in n||t.push(`Missing required field: ${o}`);return t.length===0?{valid:!0}:{valid:!1,errors:t}}async function je(r){let e=await oe("rcan-node.schema.json");if(!e)return{valid:!0,skipped:!0};let t=[];if(typeof r!="object"||r===null)return{valid:!1,errors:["Manifest must be an object"]};let n=r,s=e.required??[];for(let o of s)o in n||t.push(`Missing required field: ${o}`);return t.length===0?{valid:!0}:{valid:!1,errors:t}}var xe=(n=>(n[n.FIRE_AND_FORGET=0]="FIRE_AND_FORGET",n[n.ACKNOWLEDGED=1]="ACKNOWLEDGED",n[n.EXACTLY_ONCE=2]="EXACTLY_ONCE",n))(xe||{}),ie=class r extends Error{constructor(e){super(`ACK timeout for message ${e} \u2014 safety halt required`),this.name="QoSAckTimeoutError",Object.setPrototypeOf(this,r.prototype)}},ae=class{_send;_waitForAck;constructor(e,t){this._send=e,this._waitForAck=t}async sendWithQoS(e,t={}){let n=t.qos??0,s=t.maxRetries??3,o=t.initialBackoffMs??100,i=t.ackTimeoutMs??500;if(n===0)return await this._send(e),{delivered:!0,attempts:1,reason:"fire-and-forget"};let c=e.message_id??e.msg_id??"unknown",d=0,u=o;for(;d<=s;){if(await this._send(e),d++,await this._waitForAck(c,i))return{delivered:!0,attempts:d,reason:n===2?"exactly-once":"acknowledged"};if(d>s)break;await Nt(u),u=Math.min(u*2,5e3)}return{delivered:!1,attempts:d,reason:`ACK not received after ${s} retries`}}};function Le(r,e){return{message_type:6,ruri:r,safety_event:"ESTOP",reason:e.slice(0,512),timestamp_ms:Date.now(),message_id:At(),qos:2}}function At(){if(typeof crypto<"u"&&typeof crypto.randomUUID=="function")return crypto.randomUUID();let r=Array.from({length:16},()=>Math.floor(Math.random()*256));r[6]=r[6]&15|64,r[8]=r[8]&63|128;let e=r.map(t=>t.toString(16).padStart(2,"0"));return`${e.slice(0,4).join("")}-${e.slice(4,6).join("")}-${e.slice(6,8).join("")}-${e.slice(8,10).join("")}-${e.slice(10).join("")}`}function Nt(r){return new Promise(e=>setTimeout(e,r))}var we=6;function ce(){if(typeof crypto<"u"&&typeof crypto.randomUUID=="function")return crypto.randomUUID();let r=Array.from({length:16},()=>Math.floor(Math.random()*256));r[6]=r[6]&15|64,r[8]=r[8]&63|128;let e=r.map(t=>t.toString(16).padStart(2,"0"));return`${e.slice(0,4).join("")}-${e.slice(4,6).join("")}-${e.slice(6,8).join("")}-${e.slice(8,10).join("")}-${e.slice(10).join("")}`}function Ke(r,e){return{message_type:6,ruri:r,safety_event:"ESTOP",reason:e.slice(0,512),timestamp_ms:Date.now(),message_id:ce(),qos:2}}function He(r,e){return{message_type:6,ruri:r,safety_event:"STOP",reason:e.slice(0,512),timestamp_ms:Date.now(),message_id:ce()}}function Ve(r,e){return{message_type:6,ruri:r,safety_event:"RESUME",reason:e.slice(0,512),timestamp_ms:Date.now(),message_id:ce()}}function Fe(r){return typeof r=="object"&&r!==null&&r.message_type===we}function Je(r){let e=[];return r.message_type!==6&&e.push("message_type must be 6"),r.ruri||e.push("ruri is required"),["ESTOP","STOP","RESUME"].includes(r.safety_event??"")||e.push("safety_event must be ESTOP, STOP, or RESUME"),(!r.reason||r.reason.length===0)&&e.push("reason is required"),r.message_id||e.push("message_id is required"),(!r.timestamp_ms||r.timestamp_ms<=0)&&e.push("timestamp_ms must be positive"),e}function Ye(r,e,t){return{message_type:11,ruri:r,disclosure:e,timestamp_ms:Date.now(),message_id:ce(),delegation_chain:t}}var de=class{windowSeconds;maxSize;_seen;constructor(e=30,t=1e4){this.windowSeconds=e,this.maxSize=t,this._seen=new Map}checkAndRecord(e,t,n=!1){let s=Date.now();this._evict(s);let o=n?Math.min(this.windowSeconds,10):this.windowSeconds,i=Ot(t);if(i===null)return{allowed:!1,reason:`invalid timestamp format: ${t}`};let c=s-i,d=o*1e3;if(c>d)return{allowed:!1,reason:`message too old: age=${Math.round(c/1e3)}s > window=${o}s`};if(i>s+5e3)return{allowed:!1,reason:"message timestamp is in the future"};if(this._seen.has(e))return{allowed:!1,reason:`replay detected: msg_id ${e} already seen`};if(this._seen.size>=this.maxSize){let g=this._seen.keys().next().value;this._seen.delete(g)}let u=s+d;return this._seen.set(e,u),{allowed:!0,reason:"ok"}}_evict(e){for(let[t,n]of this._seen)n<=e&&this._seen.delete(t)}get size(){return this._seen.size}};function Ge(r,e){let t=r,n=t.message_id??t.msg_id;if(!n)return{valid:!1,reason:"missing message_id / msg_id"};let s;if(typeof t.timestamp_ms=="number"?s=String(t.timestamp_ms/1e3):t.timestamp!==void 0&&(s=String(t.timestamp)),!s)return{valid:!1,reason:"missing timestamp"};let o=t.message_type===6||t.message_type===6,i=e.checkAndRecord(n,s,o);return{valid:i.allowed,reason:i.reason}}function Ot(r){if(r.includes("T")||r.includes("-")){let t=new Date(r);if(!isNaN(t.getTime()))return t.getTime()}let e=parseFloat(r);return isNaN(e)?null:e>1e12?e:e*1e3}var L=class r extends Error{offsetSeconds;constructor(e,t){super(`Clock drift too large: offset=${e.toFixed(3)}s > max=${t}s`),this.name="ClockDriftError",this.offsetSeconds=e,Object.setPrototypeOf(this,r.prototype)}};async function Ee(r){let e=r??"https://worldtimeapi.org/api/ip";try{let t=Date.now(),n=await fetch(e,{method:"HEAD",signal:AbortSignal.timeout(3e3)}),s=Date.now(),o=n.headers.get("Date")??n.headers.get("date");if(!o)return{synchronized:!0,offsetSeconds:0,source:"assumed (no Date header)"};let i=new Date(o).getTime();if(isNaN(i))return{synchronized:!0,offsetSeconds:0,source:"assumed (unparseable Date header)"};let d=((t+s)/2-i)/1e3;return{synchronized:Math.abs(d)<=5,offsetSeconds:d,source:e}}catch{return{synchronized:!0,offsetSeconds:0,source:"assumed (network unavailable)"}}}async function Be(r=5){let e=await Ee();if(!e.synchronized||Math.abs(e.offsetSeconds)>r)throw new L(e.offsetSeconds,r)}async function kt(r){let e=JSON.stringify(r,Object.keys(r).sort());if(typeof crypto<"u"&&crypto.subtle){let n=new TextEncoder().encode(e),s=await crypto.subtle.digest("SHA-256",n);return Array.from(new Uint8Array(s)).map(o=>o.toString(16).padStart(2,"0")).join("")}let t=2166136261;for(let n=0;n<e.length;n++)t^=e.charCodeAt(n),t=t*16777619>>>0;return t.toString(16).padStart(8,"0")}async function We(r,e,t,n="rcan://local/config",s=!1){let o=await kt(r);return new m({rcan:"1.5",cmd:"CONFIG_UPDATE",target:n,params:{message_type:5,diff:r,rollback:t,scope:e,config_hash:o,safety_overrides:s}})}function Qe(r){let e=r.params;return!e.diff||typeof e.diff!="object"?{valid:!1,reason:"missing required field: params.diff"}:!e.config_hash||typeof e.config_hash!="string"?{valid:!1,reason:"missing required field: params.config_hash"}:"rollback"in e?e.safety_overrides===!0&&e.scope!=="creator"?{valid:!1,reason:"safety_overrides=true requires scope=creator (owner is insufficient)"}:{valid:!0,reason:"ok"}:{valid:!1,reason:"missing required field: params.rollback"}}function It(){return typeof crypto<"u"&&typeof crypto.randomUUID=="function"?crypto.randomUUID():`${Date.now()}-${Math.random().toString(36).slice(2)}`}var ue=class{_keys=[];addKey(e){this._keys.push(e)}getJWKS(){return{keys:[...this._keys]}}findKey(e){return this._keys.find(t=>t.kid===e)}isKeyValid(e,t){let n=this.findKey(e);if(!n)return!1;let s=(t??Date.now())/1e3;return!(n.revoked_at!==void 0&&n.revoked_at<=s||n.exp!==void 0&&n.exp<s)}expireKey(e,t){let n=this.findKey(e);n&&(n.exp=t??Math.floor(Date.now()/1e3))}revokeKey(e){let t=this.findKey(e);t&&(t.revoked_at=Math.floor(Date.now()/1e3))}validKeys(e){return this._keys.filter(t=>this.isKeyValid(t.kid,e))}};function ze(r,e,t=120,n="rcan://local/keys"){let s=It().slice(0,8);return new m({rcan:"1.5",cmd:"KEY_ROTATION",target:n,params:{message_type:5,new_public_key:r,new_kid:s,old_kid:e,overlap_seconds:t,initiated_at:new Date().toISOString()},keyId:s})}function Tt(){return typeof crypto<"u"&&typeof crypto.randomUUID=="function"?crypto.randomUUID():`${Date.now()}-${Math.random().toString(36).slice(2)}`}function fe(r){let e=r.requestId??Tt();return new m({rcan:"1.5",cmd:"CONSENT_REQUEST",target:r.targetRuri,params:{message_type:20,requester_ruri:r.requesterRuri,requester_owner:r.requesterOwner,target_ruri:r.targetRuri,requested_scopes:r.requestedScopes,duration_hours:r.durationHours,justification:r.justification,request_id:e,consent_type:r.consentType??"cross_robot",data_categories:r.dataCategories??[]}})}function le(r){let e=r.expiresAt??new Date(Date.now()+864e5).toISOString();return new m({rcan:"1.5",cmd:"CONSENT_GRANT",target:"rcan://local/consent",params:{message_type:21,request_id:r.requestId,granted_scopes:r.grantedScopes??[],expires_at:e,reason:r.reason??"approved"}})}function me(r){return new m({rcan:"1.5",cmd:"CONSENT_DENY",target:"rcan://local/consent",params:{message_type:22,request_id:r.requestId,reason:r.reason??"denied"}})}function Xe(r){let e=r.cmd,t=r.params,n=t.message_type;return e==="CONSENT_REQUEST"?n!==20?{valid:!1,reason:"message_type must be CONSENT_REQUEST (20)"}:t.requester_ruri?t.target_ruri?!t.requested_scopes||!Array.isArray(t.requested_scopes)||t.requested_scopes.length===0?{valid:!1,reason:"requested_scopes must be a non-empty array"}:t.request_id?t.justification?{valid:!0,reason:"ok"}:{valid:!1,reason:"missing justification"}:{valid:!1,reason:"missing request_id"}:{valid:!1,reason:"missing target_ruri"}:{valid:!1,reason:"missing requester_ruri"}:e==="CONSENT_GRANT"?n!==21?{valid:!1,reason:"message_type must be CONSENT_GRANT (21)"}:t.request_id?t.expires_at?{valid:!0,reason:"ok"}:{valid:!1,reason:"missing expires_at"}:{valid:!1,reason:"missing request_id"}:e==="CONSENT_DENY"?n!==22?{valid:!1,reason:"message_type must be CONSENT_DENY (22)"}:t.request_id?{valid:!0,reason:"ok"}:{valid:!1,reason:"missing request_id"}:{valid:!1,reason:`unknown consent command: ${e}`}}var Mt=3600*1e3,K=class{_cache=new Map;get(e,t){let n=this._cache.get(e);if(!n)return;let s=t??Date.now();if(n.cachedUntil!==void 0&&n.cachedUntil<s){this._cache.delete(e);return}return n}set(e,t){let n=t??Date.now();this._cache.set(e.rrn,{...e,cachedUntil:n+Mt})}invalidate(e){this._cache.delete(e)}get size(){return this._cache.size}};async function Ze(r,e,t){let n=t??new K,s=n.get(r);if(s)return s;let o=`${e.replace(/\/$/,"")}/api/v1/robots/${encodeURIComponent(r)}/revocation-status`;try{let i=await fetch(o,{signal:AbortSignal.timeout(5e3)});if(!i.ok){let u={rrn:r,status:"active",reason:`registry returned ${i.status}`};return n.set(u),u}let c=await i.json(),d={rrn:r,status:c.status??"active",revokedAt:c.revokedAt,reason:c.reason,authority:c.authority};return n.set(d),d}catch{return{rrn:r,status:"active",reason:"network unavailable"}}}function et(r,e){return new m({rcan:"1.5",cmd:"ROBOT_REVOCATION",target:"rcan://broadcast/revocation",params:{message_type:19,rrn:r,reason:e,revoked_at:new Date().toISOString()}})}var Ce=(o=>(o.VIDEO="video",o.AUDIO="audio",o.LOCATION="location",o.BIOMETRIC="biometric",o.TELEMETRY="telemetry",o))(Ce||{});function tt(r){return fe({requesterRuri:r.requesterRuri,requesterOwner:r.requesterOwner,targetRuri:r.targetRuri,requestedScopes:["training_data"],durationHours:r.durationHours,justification:r.justification,requestId:r.requestId,consentType:"training_data",dataCategories:r.dataCategories})}function rt(r){return le(r)}function nt(r){return me(r)}function st(r){if(r.params.message_type!==10)return{valid:!1,reason:"not a TRAINING_DATA message"};let e=r.params.consent_token;return!e||typeof e!="string"||e.trim()===""?{valid:!1,reason:"TRAINING_DATA message missing consent_token (\xA717)"}:{valid:!0,reason:"ok"}}var ge=class{crossOwnerGraceS;keyTtlS;_cachedKeys=[];constructor(e=3600,t=86400){this.crossOwnerGraceS=e,this.keyTtlS=t}canAcceptCommand(e,t,n,s=!0,o=!1,i,c){if(e&&e.message_type===6&&e.safety_event==="ESTOP")return{allowed:!0,reason:"ESTOP always accepted (Protocol 66)"};if(!t)return{allowed:!0,reason:"online mode"};if(!n)return{allowed:!1,reason:"offline mode: cross-network commands blocked"};if(!s)return{allowed:!1,reason:"offline mode: only owner-role commands accepted from local network"};if(o&&i!==void 0){let u=((c??Date.now())-i)/1e3;if(u>this.crossOwnerGraceS)return{allowed:!1,reason:`offline mode: cross-owner grace period expired (${Math.round(u)}s > ${this.crossOwnerGraceS}s)`}}return{allowed:!0,reason:"offline mode: owner command on local network accepted"}}cacheKey(e,t){let n=t??Date.now();this._cachedKeys=this._cachedKeys.filter(s=>s.kid!==e.kid),this._cachedKeys.push({...e,cachedAtMs:n,ttlSeconds:this.keyTtlS})}getCachedKey(e,t){let n=t??Date.now(),s=this._cachedKeys.find(i=>i.kid===e);if(!s)return;if((n-s.cachedAtMs)/1e3>s.ttlSeconds){this._cachedKeys=this._cachedKeys.filter(i=>i.kid!==e);return}return s}getManifestFields(e,t){if(e===void 0)return{offline_mode:!1,offline_since_s:0};let n=t??Date.now();return{offline_mode:!0,offline_since_s:Math.round((n-e)/1e3)}}};var Ae=(p=>(p.SENSOR_PROXIMITY_FAILURE="SENSOR_PROXIMITY_FAILURE",p.SENSOR_CAMERA_FAILURE="SENSOR_CAMERA_FAILURE",p.SENSOR_IMU_FAILURE="SENSOR_IMU_FAILURE",p.MOTOR_OVERCURRENT="MOTOR_OVERCURRENT",p.MOTOR_OVERTEMP="MOTOR_OVERTEMP",p.MOTOR_STALL="MOTOR_STALL",p.BATTERY_CRITICAL="BATTERY_CRITICAL",p.BATTERY_LOW="BATTERY_LOW",p.NETWORK_TIMEOUT="NETWORK_TIMEOUT",p.NETWORK_REGISTRY_UNREACHABLE="NETWORK_REGISTRY_UNREACHABLE",p.SAFETY_ESTOP_STUCK="SAFETY_ESTOP_STUCK",p.SAFETY_WATCHDOG_TIMEOUT="SAFETY_WATCHDOG_TIMEOUT",p.UNKNOWN="UNKNOWN",p))(Ae||{});function ot(r){return new m({rcan:"1.5",cmd:"FAULT_REPORT",target:r.target??"rcan://local/fault",params:{message_type:26,fault_code:r.faultCode,severity:r.severity,subsystem:r.subsystem,affects_safety:r.affectsSafety,safe_to_continue:r.safeToContinue,description:r.description??"",reported_at:new Date().toISOString()}})}var Ut="0.5.0",Dt="1.5";return yt(Pt);})();
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@continuonai/rcan-ts",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"description": "Official TypeScript SDK for the RCAN v1.
|
|
3
|
+
"version": "0.5.0",
|
|
4
|
+
"description": "Official TypeScript SDK for the RCAN v1.5 robot communication protocol",
|
|
5
5
|
"main": "dist/index.cjs",
|
|
6
6
|
"module": "dist/index.mjs",
|
|
7
7
|
"types": "dist/index.d.ts",
|
|
@@ -66,4 +66,4 @@
|
|
|
66
66
|
"publishConfig": {
|
|
67
67
|
"access": "public"
|
|
68
68
|
}
|
|
69
|
-
}
|
|
69
|
+
}
|