@orangecheck/agent-signer 0.5.1 → 0.6.0

package/README.md

@@ -89,7 +89,7 @@ interface CreateDelegationInput {
     nonce?: string;                    // default: random 32-hex
     revocationHolders?: ('principal' | 'agent')[]; // default: ['principal']
     revocationRef?: string | null;
-    scopeMode?: 'strict' | 'permissive'; // default: 'strict'
+    // Scopes are checked strictly, as a strict verifier checks them; 'permissive' is refused.
 }
 ```
 
@@ -118,7 +118,7 @@ Returns an `ActionEnvelope` — a strict extension of an [OC Stamp](https://gith
 interface RevokeInput {
     signer: SignerRef;                 // the delegation's principal or agent
     delegation: DelegationEnvelope;
-    reason?: string;                   // ASCII, <=128 bytes
+    reason?: string;                   // printable ASCII, <=128 bytes
     signedAt?: Date;
     ots?: ActionOts | null;
 }

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { DelegationBond, RevocationHolder, ValidationOptions, DelegationEnvelope, ActionOts, RevocationEnvelope, ActionEnvelope } from '@orangecheck/agent-core';
-export { ActionEnvelope, ActionOts, AgentErrorCode, DEFAULT_MAX_SKEW_MS, DelegationBond, DelegationEnvelope, REGISTERED_SCOPES, RevocationEnvelope, Scope, ScopeConstraint, VerifyActionAsOfSignedAtInput, VerifyActionInput, canonicalizeScope, canonicalizeScopes, computeActionId, computeDelegationId, computeRevocationId, createReplayGuard, isSubScope, parseScope, verifyAction, verifyActionAsOfSignedAt, verifyDelegation, verifyRevocation } from '@orangecheck/agent-core';
+import { DelegationBond, RevocationHolder, DelegationEnvelope, ActionOts, RevocationEnvelope, ActionEnvelope } from '@orangecheck/agent-core';
+export { ActionEnvelope, ActionOts, AgentErrorCode, DEFAULT_MAX_SKEW_MS, DelegationBond, DelegationEnvelope, REGISTERED_SCOPES, REVOCATION_REASON_MAX_BYTES, RevocationEnvelope, Scope, ScopeConstraint, VerifyActionAsOfSignedAtInput, VerifyActionInput, authoredReasonProblem, canonicalizeScope, canonicalizeScopes, computeActionId, computeDelegationId, computeRevocationId, createReplayGuard, isSubScope, parseScope, shownReason, verifyAction, verifyActionAsOfSignedAt, verifyDelegation, verifyRevocation } from '@orangecheck/agent-core';
 
 interface SignerRef {
     address: string;
@@ -16,7 +16,7 @@ interface CreateDelegationInput {
     nonce?: string;
     revocationHolders?: RevocationHolder[];
     revocationRef?: string | null;
-    scopeMode?: ValidationOptions['mode'];
+    scopeMode?: 'strict';
     privateScopes?: {
         recipients: PrivateScopeRecipient[];
         hint?: string;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { DelegationBond, RevocationHolder, ValidationOptions, DelegationEnvelope, ActionOts, RevocationEnvelope, ActionEnvelope } from '@orangecheck/agent-core';
-export { ActionEnvelope, ActionOts, AgentErrorCode, DEFAULT_MAX_SKEW_MS, DelegationBond, DelegationEnvelope, REGISTERED_SCOPES, RevocationEnvelope, Scope, ScopeConstraint, VerifyActionAsOfSignedAtInput, VerifyActionInput, canonicalizeScope, canonicalizeScopes, computeActionId, computeDelegationId, computeRevocationId, createReplayGuard, isSubScope, parseScope, verifyAction, verifyActionAsOfSignedAt, verifyDelegation, verifyRevocation } from '@orangecheck/agent-core';
+import { DelegationBond, RevocationHolder, DelegationEnvelope, ActionOts, RevocationEnvelope, ActionEnvelope } from '@orangecheck/agent-core';
+export { ActionEnvelope, ActionOts, AgentErrorCode, DEFAULT_MAX_SKEW_MS, DelegationBond, DelegationEnvelope, REGISTERED_SCOPES, REVOCATION_REASON_MAX_BYTES, RevocationEnvelope, Scope, ScopeConstraint, VerifyActionAsOfSignedAtInput, VerifyActionInput, authoredReasonProblem, canonicalizeScope, canonicalizeScopes, computeActionId, computeDelegationId, computeRevocationId, createReplayGuard, isSubScope, parseScope, shownReason, verifyAction, verifyActionAsOfSignedAt, verifyDelegation, verifyRevocation } from '@orangecheck/agent-core';
 
 interface SignerRef {
     address: string;
@@ -16,7 +16,7 @@ interface CreateDelegationInput {
     nonce?: string;
     revocationHolders?: RevocationHolder[];
     revocationRef?: string | null;
-    scopeMode?: ValidationOptions['mode'];
+    scopeMode?: 'strict';
     privateScopes?: {
         recipients: PrivateScopeRecipient[];
         hint?: string;

package/dist/index.js

@@ -8,8 +8,10 @@ async function createDelegation(input) {
   if (!input.scopes || input.scopes.length === 0) {
     throw new Error("createDelegation: at least one scope is required");
   }
-  const mode = input.scopeMode ?? "strict";
-  for (const s of input.scopes) agentCore.validateScope(agentCore.parseScope(s), { mode });
+  if (input.scopeMode !== void 0 && input.scopeMode !== "strict") {
+    throw new Error('createDelegation: a signer is strict; scopeMode "permissive" is not offered');
+  }
+  for (const s of input.scopes) agentCore.validateScope(agentCore.parseScope(s), { mode: "strict" });
   const scopes = agentCore.canonicalizeScopes(input.scopes);
   const issuedAt = isoUtcSeconds(input.issuedAt ?? /* @__PURE__ */ new Date());
   let expiresAtDate;
@@ -115,6 +117,17 @@ async function signAsAgent(input) {
       throw new Error("signAsAgent: content.length must be a non-negative integer");
     }
   }
+  const exercised = agentCore.parseScope(input.scopeExercised);
+  const fromContent = agentCore.contentBoundScope(exercised, {
+    hash: contentHash,
+    length: contentLength,
+    mime: input.mime
+  });
+  if (!agentCore.isSubScope(fromContent, exercised)) {
+    throw new Error(
+      `signAsAgent: the content (${input.mime}, ${contentLength} bytes, ${contentHash}) is outside scope_exercised ${input.scopeExercised}`
+    );
+  }
   const signedAt = isoUtcSeconds(input.signedAt ?? /* @__PURE__ */ new Date());
   const canonInput = {
     address: input.agent.address,
@@ -154,7 +167,18 @@ async function revoke(input) {
     );
   }
   const reason = input.reason ?? "";
-  if (reason.length > 128) throw new Error("revoke: reason must be <=128 bytes");
+  switch (agentCore.authoredReasonProblem(reason)) {
+    case null:
+      break;
+    case "too_long":
+      throw new Error(`revoke: reason must be at most ${agentCore.REVOCATION_REASON_MAX_BYTES} bytes`);
+    case "not_ascii":
+      throw new Error("revoke: reason must be ASCII");
+    case "control_character":
+      throw new Error("revoke: reason must have no line break or other control character");
+    case "not_text":
+      throw new Error("revoke: reason must be text");
+  }
   const signedAt = isoUtcSeconds(input.signedAt ?? /* @__PURE__ */ new Date());
   const canonInput = {
     address: input.signer.address,
@@ -204,6 +228,14 @@ Object.defineProperty(exports, "REGISTERED_SCOPES", {
   enumerable: true,
   get: function () { return agentCore.REGISTERED_SCOPES; }
 });
+Object.defineProperty(exports, "REVOCATION_REASON_MAX_BYTES", {
+  enumerable: true,
+  get: function () { return agentCore.REVOCATION_REASON_MAX_BYTES; }
+});
+Object.defineProperty(exports, "authoredReasonProblem", {
+  enumerable: true,
+  get: function () { return agentCore.authoredReasonProblem; }
+});
 Object.defineProperty(exports, "canonicalizeScope", {
   enumerable: true,
   get: function () { return agentCore.canonicalizeScope; }
@@ -236,6 +268,10 @@ Object.defineProperty(exports, "parseScope", {
   enumerable: true,
   get: function () { return agentCore.parseScope; }
 });
+Object.defineProperty(exports, "shownReason", {
+  enumerable: true,
+  get: function () { return agentCore.shownReason; }
+});
 Object.defineProperty(exports, "verifyAction", {
   enumerable: true,
   get: function () { return agentCore.verifyAction; }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["validateScope","parseScope","canonicalizeScopes","computeDelegationId","sealScopes","ENVELOPE_VERSION","hexEncode","sha256","computeActionId","computeRevocationId"],"mappings":";;;;;;AAuGA,eAAsB,iBAAiB,KAAA,EAA2D;AAC9F,EAAA,IAAI,CAAC,KAAA,CAAM,MAAA,IAAU,KAAA,CAAM,MAAA,CAAO,WAAW,CAAA,EAAG;AAC5C,IAAA,MAAM,IAAI,MAAM,kDAAkD,CAAA;AAAA,EACtE;AACA,EAAA,MAAM,IAAA,GAAO,MAAM,SAAA,IAAa,QAAA;AAChC,EAAA,KAAA,MAAW,CAAA,IAAK,MAAM,MAAA,EAAQA,uBAAA,CAAcC,qBAAW,CAAC,CAAA,EAAG,EAAE,IAAA,EAAM,CAAA;AACnE,EAAA,MAAM,MAAA,GAASC,4BAAA,CAAmB,KAAA,CAAM,MAAM,CAAA;AAE9C,EAAA,MAAM,WAAW,aAAA,CAAc,KAAA,CAAM,QAAA,oBAAY,IAAI,MAAM,CAAA;AAC3D,EAAA,IAAI,aAAA;AACJ,EAAA,IAAI,MAAM,SAAA,EAAW;AACjB,IAAA,aAAA,GAAgB,KAAA,CAAM,SAAA;AAAA,EAC1B,CAAA,MAAO;AACH,IAAA,MAAM,MAAM,KAAA,CAAM,KAAA,IAAS,CAAA,GAAI,EAAA,GAAK,KAAK,EAAA,GAAK,GAAA;AAC9C,IAAA,aAAA,GAAgB,IAAI,KAAK,IAAI,IAAA,CAAK,QAAQ,CAAA,CAAE,OAAA,KAAY,GAAG,CAAA;AAAA,EAC/D;AACA,EAAA,MAAM,SAAA,GAAY,cAAc,aAAa,CAAA;AAE7C,EAAA,MAAM,UAAA,GAAa,IAAI,IAAA,CAAK,SAAS,CAAA,CAAE,OAAA,EAAQ,GAAI,IAAI,IAAA,CAAK,QAAQ,CAAA,CAAE,OAAA,EAAQ;AAC9E,EAAA,IAAI,UAAA,IAAc,CAAA,EAAG,MAAM,IAAI,MAAM,sDAAsD,CAAA;AAC3F,EAAA,IAAI,UAAA,GAAa,GAAA,GAAM,EAAA,GAAK,EAAA,GAAK,KAAK,GAAA,EAAM;AACxC,IAAA,MAAM,IAAI,MAAM,gEAAgE,CAAA;AAAA,EACpF;AAEA,EAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,KAAA,IAAS,SAAA,CAAU,EAAE,CAAA;AACzC,EAAA,IAAI,CAAC,gBAAA,CAAiB,IAAA,CAAK,KAAK,CAAA,EAAG;AAC/B,IAAA,MAAM,IAAI,MAAM,wDAAwD,CAAA;AAAA,EAC5E;AAEA,EAAA,MAAM,IAAA,GAAO,MAAM,IAAA,IAAQ,IAAA;AAC3B,EAAA,IAAI,IAAA,EAAM;AACN,IAAA,IAAI,CAAC,OAAO,SAAA,CAAU,IAAA,CAAK,IAAI,CAAA,IAAK,IAAA,CAAK,OAAO,CAAA,EAAG;AAC/C,MAAA,MAAM,IAAI,MAAM,4DAA4D,CAAA;AAAA,IAChF;AACA,IAAA,IAAI,CAAC,gBAAA,CAAiB,IAAA,CAAK,IAAA,CAAK,cAAc,CAAA,EAAG;AAC7C,MAAA,MAAM,IAAI,MAAM,sEAAsE,CAAA;AAAA,IAC1F;AAAA,EACJ;AAEA,EAAA,MAAM,UAAA,GAAa;AAAA,IACf,SAAA,EAAW,MAAM,SAAA,CAAU,OAAA;AAAA,IAC3B,OAAO,KAAA,CAAM,YAAA;AAAA,IACb,MAAA;AAAA,IACA,SAAA,EAAW,MAAM,IAAA,IAAQ,CAAA;AAAA,IACzB,gBAAA,EAAkB,MAAM,cAAA,IAAkB,MAAA;AAAA,IAC1C,SAAA,EAAW,QAAA;AAAA,IACX,UAAA,EAAY,SAAA;AAAA,IACZ;AAAA,GACJ;AACA,EAAA,MAAM,EAAA,GAAKC,8BAAoB,UAAU,CAAA;AAKzC,EAAA,IAAI,eAAA;AACJ,EAAA,IAAI,MAAM,aAAA,EAAe;AACrB,IAAA,IAAI,CAAC,MAAM,aAAA,CAAc,UAAA,IAAc,MAAM,aAAA,CAAc,UAAA,CAAW,WAAW,CAAA,EAAG;AAChF,MAAA,MAAM,IAAI,KAAA;AAAA,QACN;AAAA,OACJ;AAAA,IACJ;AACA,IAAA,eAAA,GAAkB,MAAMC,oBAAA,CAAW;AAAA,MAC/B,MAAA;AAAA,MACA,MAAA,EAAQ;AAAA,QACJ,OAAA,EAAS,MAAM,SAAA,CAAU,OAAA;AAAA,QACzB,WAAA,EAAa,MAAM,SAAA,CAAU;AAAA,OACjC;AAAA,MACA,UAAA,EAAY,MAAM,aAAA,CAAc,UAAA;AAAA,MAChC,GAAI,KAAA,CAAM,aAAA,CAAc,IAAA,KAAS,MAAA,IAAa;AAAA,QAC1C,IAAA,EAAM,MAAM,aAAA,CAAc;AAAA,OAC9B;AAAA,MACA,GAAI,KAAA,CAAM,aAAA,CAAc,iBAAA,KAAsB,MAAA,IAAa;AAAA,QACvD,SAAA,EAAW,MAAM,aAAA,CAAc;AAAA;AACnC,KACH,CAAA;AAAA,EACL;AAEA,EAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,SAAA,CAAU,YAAY,EAAE,CAAA;AAErD,EAAA,MAAM,QAAA,GAA+B;AAAA,IACjC,CAAA,EAAGC,0BAAA;AAAA,IACH,IAAA,EAAM,kBAAA;AAAA,IACN,EAAA;AAAA,IACA,WAAW,EAAE,OAAA,EAAS,MAAM,SAAA,CAAU,OAAA,EAAS,KAAK,QAAA,EAAS;AAAA,IAC7D,OAAO,EAAE,OAAA,EAAS,KAAA,CAAM,YAAA,EAAc,KAAK,QAAA,EAAS;AAAA;AAAA,IAEpD,GAAI,eAAA,GAAkB,EAAE,kBAAkB,eAAA,EAAgB,GAAI,EAAE,MAAA,EAAO;AAAA,IACvE,IAAA;AAAA,IACA,SAAA,EAAW,QAAA;AAAA,IACX,UAAA,EAAY,SAAA;AAAA,IACZ,KAAA;AAAA,IACA,UAAA,EAAY;AAAA,MACR,OAAA,EAAS,KAAA,CAAM,iBAAA,IAAqB,CAAC,WAAW,CAAA;AAAA,MAChD,GAAA,EAAK,MAAM,aAAA,IAAiB;AAAA,KAChC;AAAA,IACA,GAAA,EAAK;AAAA,MACD,GAAA,EAAK,QAAA;AAAA,MACL,MAAA,EAAQ,MAAM,SAAA,CAAU,OAAA;AAAA,MACxB,KAAA,EAAO;AAAA;AACX,GACJ;AACA,EAAA,OAAO,QAAA;AACX;AAoBA,eAAsB,YAAY,KAAA,EAAkD;AAChF,EAAA,IAAI,MAAM,KAAA,CAAM,OAAA,KAAY,KAAA,CAAM,UAAA,CAAW,MAAM,OAAA,EAAS;AACxD,IAAA,MAAM,IAAI,MAAM,qEAAqE,CAAA;AAAA,EACzF;AAEA,EAAA,IAAI,WAAA;AACJ,EAAA,IAAI,aAAA;AACJ,EAAA,IAAI,KAAA,CAAM,mBAAmB,UAAA,EAAY;AACrC,IAAA,WAAA,GAAc,SAAA,GAAYC,mBAAA,CAAUC,aAAA,CAAO,KAAA,CAAM,OAAO,CAAC,CAAA;AACzD,IAAA,aAAA,GAAgB,MAAM,OAAA,CAAQ,UAAA;AAAA,EAClC,CAAA,MAAO;AACH,IAAA,IAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,IAAA,CAAK,UAAA,CAAW,SAAS,CAAA,IAAK,KAAA,CAAM,OAAA,CAAQ,IAAA,CAAK,MAAA,KAAW,SAAA,CAAU,SAAS,EAAA,EAAI;AAClG,MAAA,MAAM,IAAI,MAAM,sEAAsE,CAAA;AAAA,IAC1F;AACA,IAAA,WAAA,GAAc,MAAM,OAAA,CAAQ,IAAA;AAC5B,IAAA,aAAA,GAAgB,MAAM,OAAA,CAAQ,MAAA;AAC9B,IAAA,IAAI,CAAC,MAAA,CAAO,SAAA,CAAU,aAAa,CAAA,IAAK,gBAAgB,CAAA,EAAG;AACvD,MAAA,MAAM,IAAI,MAAM,4DAA4D,CAAA;AAAA,IAChF;AAAA,EACJ;AAEA,EAAA,MAAM,WAAW,aAAA,CAAc,KAAA,CAAM,QAAA,oBAAY,IAAI,MAAM,CAAA;AAE3D,EAAA,MAAM,UAAA,GAAa;AAAA,IACf,OAAA,EAAS,MAAM,KAAA,CAAM,OAAA;AAAA,IACrB,YAAA,EAAc,WAAA;AAAA,IACd,cAAA,EAAgB,aAAA;AAAA,IAChB,cAAc,KAAA,CAAM,IAAA;AAAA,IACpB,SAAA,EAAW,QAAA;AAAA,IACX,aAAA,EAAe,MAAM,UAAA,CAAW,EAAA;AAAA,IAChC,iBAAiB,KAAA,CAAM;AAAA,GAC3B;AACA,EAAA,MAAM,EAAA,GAAKC,0BAAgB,UAAU,CAAA;AAErC,EAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,KAAA,CAAM,YAAY,EAAE,CAAA;AAEjD,EAAA,MAAM,QAAA,GAA2B;AAAA,IAC7B,CAAA,EAAGH,0BAAA;AAAA,IACH,IAAA,EAAM,cAAA;AAAA,IACN,EAAA;AAAA,IACA,OAAA,EAAS;AAAA,MACL,IAAA,EAAM,WAAA;AAAA,MACN,MAAA,EAAQ,aAAA;AAAA,MACR,MAAM,KAAA,CAAM,IAAA;AAAA,MACZ,GAAA,EAAK,MAAM,GAAA,IAAO;AAAA,KACtB;AAAA,IACA,QAAQ,EAAE,OAAA,EAAS,MAAM,KAAA,CAAM,OAAA,EAAS,KAAK,QAAA,EAAS;AAAA,IACtD,SAAA,EAAW,QAAA;AAAA,IACX,aAAA,EAAe,MAAM,UAAA,CAAW,EAAA;AAAA,IAChC,iBAAiB,KAAA,CAAM,cAAA;AAAA,IACvB,GAAA,EAAK,MAAM,GAAA,IAAO,IAAA;AAAA,IAClB,GAAA,EAAK,EAAE,GAAA,EAAK,QAAA,EAAU,QAAQ,KAAA,CAAM,KAAA,CAAM,OAAA,EAAS,KAAA,EAAO,QAAA;AAAS,GACvE;AACA,EAAA,OAAO,QAAA;AACX;AAgBA,eAAsB,OAAO,KAAA,EAAiD;AAE1E,EAAA,MAAM,EAAE,SAAA,EAAW,KAAA,EAAM,GAAI,KAAA,CAAM,UAAA;AACnC,EAAA,IAAI,KAAA,CAAM,OAAO,OAAA,KAAY,SAAA,CAAU,WAAW,KAAA,CAAM,MAAA,CAAO,OAAA,KAAY,KAAA,CAAM,OAAA,EAAS;AACtF,IAAA,MAAM,IAAI,KAAA;AAAA,MACN,CAAA,eAAA,EAAkB,KAAA,CAAM,MAAA,CAAO,OAAO,CAAA,yCAAA;AAAA,KAC1C;AAAA,EACJ;AAEA,EAAA,MAAM,MAAA,GAAS,MAAM,MAAA,IAAU,EAAA;AAC/B,EAAA,IAAI,OAAO,MAAA,GAAS,GAAA,EAAK,MAAM,IAAI,MAAM,oCAAoC,CAAA;AAE7E,EAAA,MAAM,WAAW,aAAA,CAAc,KAAA,CAAM,QAAA,oBAAY,IAAI,MAAM,CAAA;AAC3D,EAAA,MAAM,UAAA,GAAa;AAAA,IACf,OAAA,EAAS,MAAM,MAAA,CAAO,OAAA;AAAA,IACtB,aAAA,EAAe,MAAM,UAAA,CAAW,EAAA;AAAA,IAChC,MAAA;AAAA,IACA,SAAA,EAAW;AAAA,GACf;AACA,EAAA,MAAM,EAAA,GAAKI,8BAAoB,UAAU,CAAA;AAEzC,EAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,MAAA,CAAO,YAAY,EAAE,CAAA;AAElD,EAAA,MAAM,QAAA,GAA+B;AAAA,IACjC,CAAA,EAAGJ,0BAAA;AAAA,IACH,IAAA,EAAM,kBAAA;AAAA,IACN,EAAA;AAAA,IACA,aAAA,EAAe,MAAM,UAAA,CAAW,EAAA;AAAA,IAChC,QAAQ,EAAE,OAAA,EAAS,MAAM,MAAA,CAAO,OAAA,EAAS,KAAK,QAAA,EAAS;AAAA,IACvD,MAAA;AAAA,IACA,SAAA,EAAW,QAAA;AAAA,IACX,GAAA,EAAK,MAAM,GAAA,IAAO,IAAA;AAAA,IAClB,GAAA,EAAK,EAAE,GAAA,EAAK,QAAA,EAAU,QAAQ,KAAA,CAAM,MAAA,CAAO,OAAA,EAAS,KAAA,EAAO,QAAA;AAAS,GACxE;AACA,EAAA,OAAO,QAAA;AACX;AAuCA,SAAS,cAAc,CAAA,EAAiB;AACpC,EAAA,OAAO,CAAA,CAAE,WAAA,EAAY,CAAE,OAAA,CAAQ,WAAW,GAAG,CAAA;AACjD;AAEA,SAAS,UAAU,KAAA,EAAuB;AACtC,EAAA,MAAM,GAAA,GAAM,IAAI,UAAA,CAAW,KAAK,CAAA;AAChC,EAAA,MAAM,IAAyB,UAAA,CAA8C,MAAA;AAC7E,EAAA,IAAI,CAAA,IAAK,OAAO,CAAA,CAAE,eAAA,KAAoB,UAAA,EAAY;AAC9C,IAAA,CAAA,CAAE,gBAAgB,GAAG,CAAA;AAAA,EACzB,CAAA,MAAO;AAEH,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,KAAA,EAAO,CAAA,EAAA,EAAK,GAAA,CAAI,CAAC,CAAA,GAAI,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,MAAA,KAAW,GAAG,CAAA;AAAA,EAC3E;AACA,EAAA,IAAI,GAAA,GAAM,EAAA;AACV,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,KAAA,EAAO,CAAA,EAAA,EAAK;AAC5B,IAAA,MAAM,CAAA,GAAI,IAAI,CAAC,CAAA;AACf,IAAA,GAAA,IAAO,EAAE,QAAA,CAAS,EAAE,CAAA,CAAE,QAAA,CAAS,GAAG,GAAG,CAAA;AAAA,EACzC;AACA,EAAA,OAAO,GAAA;AACX","file":"index.js","sourcesContent":["// @orangecheck/agent-signer — high-level API for producing OC Agent envelopes.\n//\n//   createDelegation  — principal signs a scoped grant to an agent address.\n//   signAsAgent       — agent produces an agent-action envelope over content.\n//   revoke            — principal (or agent, if authorized) burns a delegation.\n//\n// Each function wraps @orangecheck/agent-core's canonical-message + id\n// computation with a caller-supplied `signMessage` wallet adapter. Nothing here\n// touches the network — OTS anchoring and Nostr publication are separate steps\n// the caller wires up.\n\nimport { sha256 } from '@noble/hashes/sha256';\nimport {\n    canonicalizeScopes,\n    computeActionId,\n    computeDelegationId,\n    computeRevocationId,\n    ENVELOPE_VERSION,\n    hexEncode,\n    parseScope,\n    sealScopes,\n    validateScope,\n} from '@orangecheck/agent-core';\nimport type {\n    ScopesEncryptedEnvelope,\n    ValidationOptions,\n} from '@orangecheck/agent-core';\nimport type {\n    ActionEnvelope,\n    ActionOts,\n    DelegationBond,\n    DelegationEnvelope,\n    RevocationEnvelope,\n    RevocationHolder,\n} from '@orangecheck/agent-core';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Shared wallet-adapter shape (matches `@orangecheck/stamp-core` StampInput).\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface SignerRef {\n    address: string;\n    /** Returns a base64 BIP-322 signature over the given message as UTF-8 bytes. */\n    signMessage: (msg: string) => Promise<string>;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// createDelegation\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface CreateDelegationInput {\n    principal: SignerRef;\n    agentAddress: string;\n    scopes: string[];\n    bond?: DelegationBond | null;\n    issuedAt?: Date;\n    /** Duration from issuedAt in ms. Default 7 days. MAX 365 days per SPEC §4.4. */\n    ttlMs?: number;\n    /** Explicit expires_at overrides ttlMs. */\n    expiresAt?: Date;\n    /** 32-hex. Defaults to crypto.getRandomValues(16-byte) rendered as hex. */\n    nonce?: string;\n    /** Default ['principal']. */\n    revocationHolders?: RevocationHolder[];\n    /** Optional Nostr pointer to a revocation event. Non-cryptographic. */\n    revocationRef?: string | null;\n    /** Default 'strict'. 'permissive' allows unregistered scopes / constraint keys. */\n    scopeMode?: ValidationOptions['mode'];\n    /**\n     * v1.2 private-scope (PRIVATE-SCOPE.md). When supplied, the resulting\n     * delegation envelope omits the public `scopes` field and instead carries\n     * `scopes_encrypted` — an OC Lock envelope wrapping the canonical scope\n     * list, sealed to one or more recipient device keys. The principal signs\n     * BOTH the inner OC Lock envelope (via the `signMessage` callback already\n     * provided on `principal`) AND the outer OC Agent canonical message.\n     *\n     * Recipients MUST include at least the agent's device. Additional\n     * recipients (compliance auditors, third-party verifiers) are optional.\n     */\n    privateScopes?: {\n        /**\n         * Devices authorized to read the scope set. Each is `{ address,\n         * device_id, device_pk }` matching OC Lock's `DeviceRecord` shape.\n         * The same `signMessage` callback on `principal` is used to sign the\n         * inner OC Lock envelope.\n         */\n        recipients: PrivateScopeRecipient[];\n        /** Optional human hint stored in the OC Lock envelope. */\n        hint?: string;\n        /** Optional expiry on the OC Lock envelope. Independent of the\n         *  delegation's expires_at; usually left unset. */\n        envelopeExpiresAt?: Date | null;\n    };\n}\n\n/** Mirror of @orangecheck/lock-core's DeviceRecord. */\nexport interface PrivateScopeRecipient {\n    address: string;\n    device_id: string;\n    /** 32-byte hex X25519 public key. */\n    device_pk: string;\n}\n\nexport async function createDelegation(input: CreateDelegationInput): Promise<DelegationEnvelope> {\n    if (!input.scopes || input.scopes.length === 0) {\n        throw new Error('createDelegation: at least one scope is required');\n    }\n    const mode = input.scopeMode ?? 'strict';\n    for (const s of input.scopes) validateScope(parseScope(s), { mode });\n    const scopes = canonicalizeScopes(input.scopes);\n\n    const issuedAt = isoUtcSeconds(input.issuedAt ?? new Date());\n    let expiresAtDate: Date;\n    if (input.expiresAt) {\n        expiresAtDate = input.expiresAt;\n    } else {\n        const ttl = input.ttlMs ?? 7 * 24 * 60 * 60 * 1000;\n        expiresAtDate = new Date(new Date(issuedAt).getTime() + ttl);\n    }\n    const expiresAt = isoUtcSeconds(expiresAtDate);\n\n    const durationMs = new Date(expiresAt).getTime() - new Date(issuedAt).getTime();\n    if (durationMs <= 0) throw new Error('createDelegation: expires_at must be after issued_at');\n    if (durationMs > 365 * 24 * 60 * 60 * 1000) {\n        throw new Error('createDelegation: delegation duration must not exceed 365 days');\n    }\n\n    const nonce = input.nonce ?? randomHex(16);\n    if (!/^[0-9a-f]{32}$/.test(nonce)) {\n        throw new Error('createDelegation: nonce must be 32 lowercase hex chars');\n    }\n\n    const bond = input.bond ?? null;\n    if (bond) {\n        if (!Number.isInteger(bond.sats) || bond.sats < 0) {\n            throw new Error('createDelegation: bond.sats must be a non-negative integer');\n        }\n        if (!/^[0-9a-f]{64}$/.test(bond.attestation_id)) {\n            throw new Error('createDelegation: bond.attestation_id must be 64 lowercase hex chars');\n        }\n    }\n\n    const canonInput = {\n        principal: input.principal.address,\n        agent: input.agentAddress,\n        scopes,\n        bond_sats: bond?.sats ?? 0,\n        bond_attestation: bond?.attestation_id ?? 'none',\n        issued_at: issuedAt,\n        expires_at: expiresAt,\n        nonce,\n    };\n    const id = computeDelegationId(canonInput);\n\n    // v1.2 private-scope: seal BEFORE the principal's outer signature so the\n    // user's wallet sees both prompts in a deterministic order (inner Lock\n    // sig first, outer OC Agent sig second).\n    let scopesEncrypted: ScopesEncryptedEnvelope | undefined;\n    if (input.privateScopes) {\n        if (!input.privateScopes.recipients || input.privateScopes.recipients.length === 0) {\n            throw new Error(\n                'createDelegation: privateScopes.recipients must contain at least the agent device'\n            );\n        }\n        scopesEncrypted = await sealScopes({\n            scopes,\n            sender: {\n                address: input.principal.address,\n                signMessage: input.principal.signMessage,\n            },\n            recipients: input.privateScopes.recipients,\n            ...(input.privateScopes.hint !== undefined && {\n                hint: input.privateScopes.hint,\n            }),\n            ...(input.privateScopes.envelopeExpiresAt !== undefined && {\n                expiresAt: input.privateScopes.envelopeExpiresAt,\n            }),\n        });\n    }\n\n    const sigValue = await input.principal.signMessage(id);\n\n    const envelope: DelegationEnvelope = {\n        v: ENVELOPE_VERSION,\n        kind: 'agent-delegation',\n        id,\n        principal: { address: input.principal.address, alg: 'bip322' },\n        agent: { address: input.agentAddress, alg: 'bip322' },\n        // Public OR private mode — never both. PRIVATE-SCOPE.md §1.1.\n        ...(scopesEncrypted ? { scopes_encrypted: scopesEncrypted } : { scopes }),\n        bond,\n        issued_at: issuedAt,\n        expires_at: expiresAt,\n        nonce,\n        revocation: {\n            holders: input.revocationHolders ?? ['principal'],\n            ref: input.revocationRef ?? null,\n        },\n        sig: {\n            alg: 'bip322',\n            pubkey: input.principal.address,\n            value: sigValue,\n        },\n    };\n    return envelope;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// signAsAgent\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface SignAsAgentInput {\n    agent: SignerRef;\n    delegation: DelegationEnvelope;\n    /** Raw bytes to stamp, or a pre-computed { hash, length } pair. */\n    content: Uint8Array | { hash: string; length: number };\n    mime: string;\n    /** Which scope from delegation.scopes is being exercised (or a narrower sub-scope). */\n    scopeExercised: string;\n    ref?: string | null;\n    signedAt?: Date;\n    /** OTS proof / anchor data if the caller has already submitted; otherwise null. */\n    ots?: ActionOts | null;\n}\n\nexport async function signAsAgent(input: SignAsAgentInput): Promise<ActionEnvelope> {\n    if (input.agent.address !== input.delegation.agent.address) {\n        throw new Error('signAsAgent: signer address does not match delegation.agent.address');\n    }\n\n    let contentHash: string;\n    let contentLength: number;\n    if (input.content instanceof Uint8Array) {\n        contentHash = 'sha256:' + hexEncode(sha256(input.content));\n        contentLength = input.content.byteLength;\n    } else {\n        if (!input.content.hash.startsWith('sha256:') || input.content.hash.length !== 'sha256:'.length + 64) {\n            throw new Error('signAsAgent: content.hash must be \"sha256:\" + 64 lowercase hex chars');\n        }\n        contentHash = input.content.hash;\n        contentLength = input.content.length;\n        if (!Number.isInteger(contentLength) || contentLength < 0) {\n            throw new Error('signAsAgent: content.length must be a non-negative integer');\n        }\n    }\n\n    const signedAt = isoUtcSeconds(input.signedAt ?? new Date());\n\n    const canonInput = {\n        address: input.agent.address,\n        content_hash: contentHash,\n        content_length: contentLength,\n        content_mime: input.mime,\n        signed_at: signedAt,\n        delegation_id: input.delegation.id,\n        scope_exercised: input.scopeExercised,\n    };\n    const id = computeActionId(canonInput);\n\n    const sigValue = await input.agent.signMessage(id);\n\n    const envelope: ActionEnvelope = {\n        v: ENVELOPE_VERSION,\n        kind: 'agent-action',\n        id,\n        content: {\n            hash: contentHash,\n            length: contentLength,\n            mime: input.mime,\n            ref: input.ref ?? null,\n        },\n        signer: { address: input.agent.address, alg: 'bip322' },\n        signed_at: signedAt,\n        delegation_id: input.delegation.id,\n        scope_exercised: input.scopeExercised,\n        ots: input.ots ?? null,\n        sig: { alg: 'bip322', pubkey: input.agent.address, value: sigValue },\n    };\n    return envelope;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// revoke\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface RevokeInput {\n    signer: SignerRef;\n    delegation: DelegationEnvelope;\n    /** Short ASCII rationale. Defaults to empty string. */\n    reason?: string;\n    signedAt?: Date;\n    /** OTS proof / anchor data if the caller has already submitted; otherwise null. */\n    ots?: ActionOts | null;\n}\n\nexport async function revoke(input: RevokeInput): Promise<RevocationEnvelope> {\n    // The principal and the agent may always revoke (SPEC §9.5).\n    const { principal, agent } = input.delegation;\n    if (input.signer.address !== principal.address && input.signer.address !== agent.address) {\n        throw new Error(\n            `revoke: signer ${input.signer.address} not authorized to revoke this delegation`\n        );\n    }\n\n    const reason = input.reason ?? '';\n    if (reason.length > 128) throw new Error('revoke: reason must be <=128 bytes');\n\n    const signedAt = isoUtcSeconds(input.signedAt ?? new Date());\n    const canonInput = {\n        address: input.signer.address,\n        delegation_id: input.delegation.id,\n        reason,\n        signed_at: signedAt,\n    };\n    const id = computeRevocationId(canonInput);\n\n    const sigValue = await input.signer.signMessage(id);\n\n    const envelope: RevocationEnvelope = {\n        v: ENVELOPE_VERSION,\n        kind: 'agent-revocation',\n        id,\n        delegation_id: input.delegation.id,\n        signer: { address: input.signer.address, alg: 'bip322' },\n        reason,\n        signed_at: signedAt,\n        ots: input.ots ?? null,\n        sig: { alg: 'bip322', pubkey: input.signer.address, value: sigValue },\n    };\n    return envelope;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Re-exports for convenience\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport {\n    canonicalizeScopes,\n    computeActionId,\n    computeDelegationId,\n    computeRevocationId,\n    verifyAction,\n    verifyActionAsOfSignedAt,\n    createReplayGuard,\n    DEFAULT_MAX_SKEW_MS,\n    verifyDelegation,\n    verifyRevocation,\n    parseScope,\n    isSubScope,\n    canonicalizeScope,\n    REGISTERED_SCOPES,\n} from '@orangecheck/agent-core';\nexport type {\n    ActionEnvelope,\n    ActionOts,\n    DelegationBond,\n    DelegationEnvelope,\n    RevocationEnvelope,\n    Scope,\n    ScopeConstraint,\n    AgentErrorCode,\n    VerifyActionInput,\n    VerifyActionAsOfSignedAtInput,\n} from '@orangecheck/agent-core';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\nfunction isoUtcSeconds(d: Date): string {\n    return d.toISOString().replace(/\\.\\d+Z$/, 'Z');\n}\n\nfunction randomHex(bytes: number): string {\n    const buf = new Uint8Array(bytes);\n    const c: Crypto | undefined = (globalThis as unknown as { crypto?: Crypto }).crypto;\n    if (c && typeof c.getRandomValues === 'function') {\n        c.getRandomValues(buf);\n    } else {\n        // Non-browser fallback. Node ≥18 exposes globalThis.crypto, so this is unlikely to fire.\n        for (let i = 0; i < bytes; i++) buf[i] = Math.floor(Math.random() * 256);\n    }\n    let out = '';\n    for (let i = 0; i < bytes; i++) {\n        const b = buf[i]!;\n        out += b.toString(16).padStart(2, '0');\n    }\n    return out;\n}\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":["validateScope","parseScope","canonicalizeScopes","computeDelegationId","sealScopes","ENVELOPE_VERSION","hexEncode","sha256","contentBoundScope","isSubScope","computeActionId","authoredReasonProblem","REVOCATION_REASON_MAX_BYTES","computeRevocationId"],"mappings":"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","file":"index.js","sourcesContent":["// @orangecheck/agent-signer — high-level API for producing OC Agent envelopes.\n//\n//   createDelegation  — principal signs a scoped grant to an agent address.\n//   signAsAgent       — agent produces an agent-action envelope over content.\n//   revoke            — principal (or agent, if authorized) burns a delegation.\n//\n// Each function wraps @orangecheck/agent-core's canonical-message + id\n// computation with a caller-supplied `signMessage` wallet adapter. Nothing here\n// touches the network — OTS anchoring and Nostr publication are separate steps\n// the caller wires up.\n\nimport { sha256 } from '@noble/hashes/sha256';\nimport {\n    canonicalizeScopes,\n    computeActionId,\n    computeDelegationId,\n    computeRevocationId,\n    contentBoundScope,\n    ENVELOPE_VERSION,\n    hexEncode,\n    authoredReasonProblem,\n    isSubScope,\n    parseScope,\n    REVOCATION_REASON_MAX_BYTES,\n    sealScopes,\n    validateScope,\n} from '@orangecheck/agent-core';\nimport type { ScopesEncryptedEnvelope } from '@orangecheck/agent-core';\nimport type {\n    ActionEnvelope,\n    ActionOts,\n    DelegationBond,\n    DelegationEnvelope,\n    RevocationEnvelope,\n    RevocationHolder,\n} from '@orangecheck/agent-core';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Shared wallet-adapter shape (matches `@orangecheck/stamp-core` StampInput).\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface SignerRef {\n    address: string;\n    /** Returns a base64 BIP-322 signature over the given message as UTF-8 bytes. */\n    signMessage: (msg: string) => Promise<string>;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// createDelegation\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface CreateDelegationInput {\n    principal: SignerRef;\n    agentAddress: string;\n    scopes: string[];\n    bond?: DelegationBond | null;\n    issuedAt?: Date;\n    /** Duration from issuedAt in ms. Default 7 days. MAX 365 days per SPEC §4.4. */\n    ttlMs?: number;\n    /** Explicit expires_at overrides ttlMs. */\n    expiresAt?: Date;\n    /** 32-hex. Defaults to crypto.getRandomValues(16-byte) rendered as hex. */\n    nonce?: string;\n    /** Default ['principal']. */\n    revocationHolders?: RevocationHolder[];\n    /** Optional Nostr pointer to a revocation event. Non-cryptographic. */\n    revocationRef?: string | null;\n    /** A signer is strict (SPEC §7.6): scopes are always checked as a strict verifier checks them. */\n    scopeMode?: 'strict';\n    /**\n     * v1.2 private-scope (PRIVATE-SCOPE.md). When supplied, the resulting\n     * delegation envelope omits the public `scopes` field and instead carries\n     * `scopes_encrypted` — an OC Lock envelope wrapping the canonical scope\n     * list, sealed to one or more recipient device keys. The principal signs\n     * BOTH the inner OC Lock envelope (via the `signMessage` callback already\n     * provided on `principal`) AND the outer OC Agent canonical message.\n     *\n     * Recipients MUST include at least the agent's device. Additional\n     * recipients (compliance auditors, third-party verifiers) are optional.\n     */\n    privateScopes?: {\n        /**\n         * Devices authorized to read the scope set. Each is `{ address,\n         * device_id, device_pk }` matching OC Lock's `DeviceRecord` shape.\n         * The same `signMessage` callback on `principal` is used to sign the\n         * inner OC Lock envelope.\n         */\n        recipients: PrivateScopeRecipient[];\n        /** Optional human hint stored in the OC Lock envelope. */\n        hint?: string;\n        /** Optional expiry on the OC Lock envelope. Independent of the\n         *  delegation's expires_at; usually left unset. */\n        envelopeExpiresAt?: Date | null;\n    };\n}\n\n/** Mirror of @orangecheck/lock-core's DeviceRecord. */\nexport interface PrivateScopeRecipient {\n    address: string;\n    device_id: string;\n    /** 32-byte hex X25519 public key. */\n    device_pk: string;\n}\n\nexport async function createDelegation(input: CreateDelegationInput): Promise<DelegationEnvelope> {\n    if (!input.scopes || input.scopes.length === 0) {\n        throw new Error('createDelegation: at least one scope is required');\n    }\n    if (input.scopeMode !== undefined && input.scopeMode !== 'strict') {\n        throw new Error('createDelegation: a signer is strict; scopeMode \"permissive\" is not offered');\n    }\n    for (const s of input.scopes) validateScope(parseScope(s), { mode: 'strict' });\n    const scopes = canonicalizeScopes(input.scopes);\n\n    const issuedAt = isoUtcSeconds(input.issuedAt ?? new Date());\n    let expiresAtDate: Date;\n    if (input.expiresAt) {\n        expiresAtDate = input.expiresAt;\n    } else {\n        const ttl = input.ttlMs ?? 7 * 24 * 60 * 60 * 1000;\n        expiresAtDate = new Date(new Date(issuedAt).getTime() + ttl);\n    }\n    const expiresAt = isoUtcSeconds(expiresAtDate);\n\n    const durationMs = new Date(expiresAt).getTime() - new Date(issuedAt).getTime();\n    if (durationMs <= 0) throw new Error('createDelegation: expires_at must be after issued_at');\n    if (durationMs > 365 * 24 * 60 * 60 * 1000) {\n        throw new Error('createDelegation: delegation duration must not exceed 365 days');\n    }\n\n    const nonce = input.nonce ?? randomHex(16);\n    if (!/^[0-9a-f]{32}$/.test(nonce)) {\n        throw new Error('createDelegation: nonce must be 32 lowercase hex chars');\n    }\n\n    const bond = input.bond ?? null;\n    if (bond) {\n        if (!Number.isInteger(bond.sats) || bond.sats < 0) {\n            throw new Error('createDelegation: bond.sats must be a non-negative integer');\n        }\n        if (!/^[0-9a-f]{64}$/.test(bond.attestation_id)) {\n            throw new Error('createDelegation: bond.attestation_id must be 64 lowercase hex chars');\n        }\n    }\n\n    const canonInput = {\n        principal: input.principal.address,\n        agent: input.agentAddress,\n        scopes,\n        bond_sats: bond?.sats ?? 0,\n        bond_attestation: bond?.attestation_id ?? 'none',\n        issued_at: issuedAt,\n        expires_at: expiresAt,\n        nonce,\n    };\n    const id = computeDelegationId(canonInput);\n\n    // v1.2 private-scope: seal BEFORE the principal's outer signature so the\n    // user's wallet sees both prompts in a deterministic order (inner Lock\n    // sig first, outer OC Agent sig second).\n    let scopesEncrypted: ScopesEncryptedEnvelope | undefined;\n    if (input.privateScopes) {\n        if (!input.privateScopes.recipients || input.privateScopes.recipients.length === 0) {\n            throw new Error(\n                'createDelegation: privateScopes.recipients must contain at least the agent device'\n            );\n        }\n        scopesEncrypted = await sealScopes({\n            scopes,\n            sender: {\n                address: input.principal.address,\n                signMessage: input.principal.signMessage,\n            },\n            recipients: input.privateScopes.recipients,\n            ...(input.privateScopes.hint !== undefined && {\n                hint: input.privateScopes.hint,\n            }),\n            ...(input.privateScopes.envelopeExpiresAt !== undefined && {\n                expiresAt: input.privateScopes.envelopeExpiresAt,\n            }),\n        });\n    }\n\n    const sigValue = await input.principal.signMessage(id);\n\n    const envelope: DelegationEnvelope = {\n        v: ENVELOPE_VERSION,\n        kind: 'agent-delegation',\n        id,\n        principal: { address: input.principal.address, alg: 'bip322' },\n        agent: { address: input.agentAddress, alg: 'bip322' },\n        // Public OR private mode — never both. PRIVATE-SCOPE.md §1.1.\n        ...(scopesEncrypted ? { scopes_encrypted: scopesEncrypted } : { scopes }),\n        bond,\n        issued_at: issuedAt,\n        expires_at: expiresAt,\n        nonce,\n        revocation: {\n            holders: input.revocationHolders ?? ['principal'],\n            ref: input.revocationRef ?? null,\n        },\n        sig: {\n            alg: 'bip322',\n            pubkey: input.principal.address,\n            value: sigValue,\n        },\n    };\n    return envelope;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// signAsAgent\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface SignAsAgentInput {\n    agent: SignerRef;\n    delegation: DelegationEnvelope;\n    /** Raw bytes to stamp, or a pre-computed { hash, length } pair. */\n    content: Uint8Array | { hash: string; length: number };\n    mime: string;\n    /** Which scope from delegation.scopes is being exercised (or a narrower sub-scope). */\n    scopeExercised: string;\n    ref?: string | null;\n    signedAt?: Date;\n    /** OTS proof / anchor data if the caller has already submitted; otherwise null. */\n    ots?: ActionOts | null;\n}\n\nexport async function signAsAgent(input: SignAsAgentInput): Promise<ActionEnvelope> {\n    if (input.agent.address !== input.delegation.agent.address) {\n        throw new Error('signAsAgent: signer address does not match delegation.agent.address');\n    }\n\n    let contentHash: string;\n    let contentLength: number;\n    if (input.content instanceof Uint8Array) {\n        contentHash = 'sha256:' + hexEncode(sha256(input.content));\n        contentLength = input.content.byteLength;\n    } else {\n        if (!input.content.hash.startsWith('sha256:') || input.content.hash.length !== 'sha256:'.length + 64) {\n            throw new Error('signAsAgent: content.hash must be \"sha256:\" + 64 lowercase hex chars');\n        }\n        contentHash = input.content.hash;\n        contentLength = input.content.length;\n        if (!Number.isInteger(contentLength) || contentLength < 0) {\n            throw new Error('signAsAgent: content.length must be a non-negative integer');\n        }\n    }\n\n    // A verifier reads content-bound keys from the content (SPEC §8.3 step 12a);\n    // sign nothing whose content falls outside the scope it claims.\n    const exercised = parseScope(input.scopeExercised);\n    const fromContent = contentBoundScope(exercised, {\n        hash: contentHash,\n        length: contentLength,\n        mime: input.mime,\n    });\n    if (!isSubScope(fromContent, exercised)) {\n        throw new Error(\n            `signAsAgent: the content (${input.mime}, ${contentLength} bytes, ${contentHash}) is outside ` +\n                `scope_exercised ${input.scopeExercised}`\n        );\n    }\n\n    const signedAt = isoUtcSeconds(input.signedAt ?? new Date());\n\n    const canonInput = {\n        address: input.agent.address,\n        content_hash: contentHash,\n        content_length: contentLength,\n        content_mime: input.mime,\n        signed_at: signedAt,\n        delegation_id: input.delegation.id,\n        scope_exercised: input.scopeExercised,\n    };\n    const id = computeActionId(canonInput);\n\n    const sigValue = await input.agent.signMessage(id);\n\n    const envelope: ActionEnvelope = {\n        v: ENVELOPE_VERSION,\n        kind: 'agent-action',\n        id,\n        content: {\n            hash: contentHash,\n            length: contentLength,\n            mime: input.mime,\n            ref: input.ref ?? null,\n        },\n        signer: { address: input.agent.address, alg: 'bip322' },\n        signed_at: signedAt,\n        delegation_id: input.delegation.id,\n        scope_exercised: input.scopeExercised,\n        ots: input.ots ?? null,\n        sig: { alg: 'bip322', pubkey: input.agent.address, value: sigValue },\n    };\n    return envelope;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// revoke\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface RevokeInput {\n    signer: SignerRef;\n    delegation: DelegationEnvelope;\n    /** Printable ASCII, at most 128 bytes: SPEC §9.1 allows any ASCII; we write no control character. Defaults to \"\". */\n    reason?: string;\n    signedAt?: Date;\n    /** OTS proof / anchor data if the caller has already submitted; otherwise null. */\n    ots?: ActionOts | null;\n}\n\nexport async function revoke(input: RevokeInput): Promise<RevocationEnvelope> {\n    // The principal and the agent may always revoke (SPEC §9.5).\n    const { principal, agent } = input.delegation;\n    if (input.signer.address !== principal.address && input.signer.address !== agent.address) {\n        throw new Error(\n            `revoke: signer ${input.signer.address} not authorized to revoke this delegation`\n        );\n    }\n\n    const reason = input.reason ?? '';\n    // SPEC §9.1: a signer writes printable ASCII of at most 128 bytes.\n    switch (authoredReasonProblem(reason)) {\n        case null:\n            break;\n        case 'too_long':\n            throw new Error(`revoke: reason must be at most ${REVOCATION_REASON_MAX_BYTES} bytes`);\n        case 'not_ascii':\n            throw new Error('revoke: reason must be ASCII');\n        case 'control_character':\n            throw new Error('revoke: reason must have no line break or other control character');\n        case 'not_text':\n            throw new Error('revoke: reason must be text');\n    }\n\n    const signedAt = isoUtcSeconds(input.signedAt ?? new Date());\n    const canonInput = {\n        address: input.signer.address,\n        delegation_id: input.delegation.id,\n        reason,\n        signed_at: signedAt,\n    };\n    const id = computeRevocationId(canonInput);\n\n    const sigValue = await input.signer.signMessage(id);\n\n    const envelope: RevocationEnvelope = {\n        v: ENVELOPE_VERSION,\n        kind: 'agent-revocation',\n        id,\n        delegation_id: input.delegation.id,\n        signer: { address: input.signer.address, alg: 'bip322' },\n        reason,\n        signed_at: signedAt,\n        ots: input.ots ?? null,\n        sig: { alg: 'bip322', pubkey: input.signer.address, value: sigValue },\n    };\n    return envelope;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Re-exports for convenience\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport {\n    canonicalizeScopes,\n    computeActionId,\n    computeDelegationId,\n    computeRevocationId,\n    verifyAction,\n    verifyActionAsOfSignedAt,\n    createReplayGuard,\n    DEFAULT_MAX_SKEW_MS,\n    verifyDelegation,\n    verifyRevocation,\n    parseScope,\n    isSubScope,\n    canonicalizeScope,\n    REGISTERED_SCOPES,\n    authoredReasonProblem,\n    REVOCATION_REASON_MAX_BYTES,\n    shownReason,\n} from '@orangecheck/agent-core';\nexport type {\n    ActionEnvelope,\n    ActionOts,\n    DelegationBond,\n    DelegationEnvelope,\n    RevocationEnvelope,\n    Scope,\n    ScopeConstraint,\n    AgentErrorCode,\n    VerifyActionInput,\n    VerifyActionAsOfSignedAtInput,\n} from '@orangecheck/agent-core';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\nfunction isoUtcSeconds(d: Date): string {\n    return d.toISOString().replace(/\\.\\d+Z$/, 'Z');\n}\n\nfunction randomHex(bytes: number): string {\n    const buf = new Uint8Array(bytes);\n    const c: Crypto | undefined = (globalThis as unknown as { crypto?: Crypto }).crypto;\n    if (c && typeof c.getRandomValues === 'function') {\n        c.getRandomValues(buf);\n    } else {\n        // Non-browser fallback. Node ≥18 exposes globalThis.crypto, so this is unlikely to fire.\n        for (let i = 0; i < bytes; i++) buf[i] = Math.floor(Math.random() * 256);\n    }\n    let out = '';\n    for (let i = 0; i < bytes; i++) {\n        const b = buf[i]!;\n        out += b.toString(16).padStart(2, '0');\n    }\n    return out;\n}\n"]}

package/dist/index.mjs

@@ -1,14 +1,16 @@
 import { sha256 } from '@noble/hashes/sha256';
-import { validateScope, parseScope, canonicalizeScopes, computeDelegationId, sealScopes, ENVELOPE_VERSION, hexEncode, computeActionId, computeRevocationId } from '@orangecheck/agent-core';
-export { DEFAULT_MAX_SKEW_MS, REGISTERED_SCOPES, canonicalizeScope, canonicalizeScopes, computeActionId, computeDelegationId, computeRevocationId, createReplayGuard, isSubScope, parseScope, verifyAction, verifyActionAsOfSignedAt, verifyDelegation, verifyRevocation } from '@orangecheck/agent-core';
+import { validateScope, parseScope, canonicalizeScopes, computeDelegationId, sealScopes, ENVELOPE_VERSION, hexEncode, contentBoundScope, isSubScope, computeActionId, authoredReasonProblem, REVOCATION_REASON_MAX_BYTES, computeRevocationId } from '@orangecheck/agent-core';
+export { DEFAULT_MAX_SKEW_MS, REGISTERED_SCOPES, REVOCATION_REASON_MAX_BYTES, authoredReasonProblem, canonicalizeScope, canonicalizeScopes, computeActionId, computeDelegationId, computeRevocationId, createReplayGuard, isSubScope, parseScope, shownReason, verifyAction, verifyActionAsOfSignedAt, verifyDelegation, verifyRevocation } from '@orangecheck/agent-core';
 
 // src/index.ts
 async function createDelegation(input) {
   if (!input.scopes || input.scopes.length === 0) {
     throw new Error("createDelegation: at least one scope is required");
   }
-  const mode = input.scopeMode ?? "strict";
-  for (const s of input.scopes) validateScope(parseScope(s), { mode });
+  if (input.scopeMode !== void 0 && input.scopeMode !== "strict") {
+    throw new Error('createDelegation: a signer is strict; scopeMode "permissive" is not offered');
+  }
+  for (const s of input.scopes) validateScope(parseScope(s), { mode: "strict" });
   const scopes = canonicalizeScopes(input.scopes);
   const issuedAt = isoUtcSeconds(input.issuedAt ?? /* @__PURE__ */ new Date());
   let expiresAtDate;
@@ -114,6 +116,17 @@ async function signAsAgent(input) {
       throw new Error("signAsAgent: content.length must be a non-negative integer");
     }
   }
+  const exercised = parseScope(input.scopeExercised);
+  const fromContent = contentBoundScope(exercised, {
+    hash: contentHash,
+    length: contentLength,
+    mime: input.mime
+  });
+  if (!isSubScope(fromContent, exercised)) {
+    throw new Error(
+      `signAsAgent: the content (${input.mime}, ${contentLength} bytes, ${contentHash}) is outside scope_exercised ${input.scopeExercised}`
+    );
+  }
   const signedAt = isoUtcSeconds(input.signedAt ?? /* @__PURE__ */ new Date());
   const canonInput = {
     address: input.agent.address,
@@ -153,7 +166,18 @@ async function revoke(input) {
     );
   }
   const reason = input.reason ?? "";
-  if (reason.length > 128) throw new Error("revoke: reason must be <=128 bytes");
+  switch (authoredReasonProblem(reason)) {
+    case null:
+      break;
+    case "too_long":
+      throw new Error(`revoke: reason must be at most ${REVOCATION_REASON_MAX_BYTES} bytes`);
+    case "not_ascii":
+      throw new Error("revoke: reason must be ASCII");
+    case "control_character":
+      throw new Error("revoke: reason must have no line break or other control character");
+    case "not_text":
+      throw new Error("revoke: reason must be text");
+  }
   const signedAt = isoUtcSeconds(input.signedAt ?? /* @__PURE__ */ new Date());
   const canonInput = {
     address: input.signer.address,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["// @orangecheck/agent-signer — high-level API for producing OC Agent envelopes.\n//\n//   createDelegation  — principal signs a scoped grant to an agent address.\n//   signAsAgent       — agent produces an agent-action envelope over content.\n//   revoke            — principal (or agent, if authorized) burns a delegation.\n//\n// Each function wraps @orangecheck/agent-core's canonical-message + id\n// computation with a caller-supplied `signMessage` wallet adapter. Nothing here\n// touches the network — OTS anchoring and Nostr publication are separate steps\n// the caller wires up.\n\nimport { sha256 } from '@noble/hashes/sha256';\nimport {\n    canonicalizeScopes,\n    computeActionId,\n    computeDelegationId,\n    computeRevocationId,\n    ENVELOPE_VERSION,\n    hexEncode,\n    parseScope,\n    sealScopes,\n    validateScope,\n} from '@orangecheck/agent-core';\nimport type {\n    ScopesEncryptedEnvelope,\n    ValidationOptions,\n} from '@orangecheck/agent-core';\nimport type {\n    ActionEnvelope,\n    ActionOts,\n    DelegationBond,\n    DelegationEnvelope,\n    RevocationEnvelope,\n    RevocationHolder,\n} from '@orangecheck/agent-core';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Shared wallet-adapter shape (matches `@orangecheck/stamp-core` StampInput).\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface SignerRef {\n    address: string;\n    /** Returns a base64 BIP-322 signature over the given message as UTF-8 bytes. */\n    signMessage: (msg: string) => Promise<string>;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// createDelegation\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface CreateDelegationInput {\n    principal: SignerRef;\n    agentAddress: string;\n    scopes: string[];\n    bond?: DelegationBond | null;\n    issuedAt?: Date;\n    /** Duration from issuedAt in ms. Default 7 days. MAX 365 days per SPEC §4.4. */\n    ttlMs?: number;\n    /** Explicit expires_at overrides ttlMs. */\n    expiresAt?: Date;\n    /** 32-hex. Defaults to crypto.getRandomValues(16-byte) rendered as hex. */\n    nonce?: string;\n    /** Default ['principal']. */\n    revocationHolders?: RevocationHolder[];\n    /** Optional Nostr pointer to a revocation event. Non-cryptographic. */\n    revocationRef?: string | null;\n    /** Default 'strict'. 'permissive' allows unregistered scopes / constraint keys. */\n    scopeMode?: ValidationOptions['mode'];\n    /**\n     * v1.2 private-scope (PRIVATE-SCOPE.md). When supplied, the resulting\n     * delegation envelope omits the public `scopes` field and instead carries\n     * `scopes_encrypted` — an OC Lock envelope wrapping the canonical scope\n     * list, sealed to one or more recipient device keys. The principal signs\n     * BOTH the inner OC Lock envelope (via the `signMessage` callback already\n     * provided on `principal`) AND the outer OC Agent canonical message.\n     *\n     * Recipients MUST include at least the agent's device. Additional\n     * recipients (compliance auditors, third-party verifiers) are optional.\n     */\n    privateScopes?: {\n        /**\n         * Devices authorized to read the scope set. Each is `{ address,\n         * device_id, device_pk }` matching OC Lock's `DeviceRecord` shape.\n         * The same `signMessage` callback on `principal` is used to sign the\n         * inner OC Lock envelope.\n         */\n        recipients: PrivateScopeRecipient[];\n        /** Optional human hint stored in the OC Lock envelope. */\n        hint?: string;\n        /** Optional expiry on the OC Lock envelope. Independent of the\n         *  delegation's expires_at; usually left unset. */\n        envelopeExpiresAt?: Date | null;\n    };\n}\n\n/** Mirror of @orangecheck/lock-core's DeviceRecord. */\nexport interface PrivateScopeRecipient {\n    address: string;\n    device_id: string;\n    /** 32-byte hex X25519 public key. */\n    device_pk: string;\n}\n\nexport async function createDelegation(input: CreateDelegationInput): Promise<DelegationEnvelope> {\n    if (!input.scopes || input.scopes.length === 0) {\n        throw new Error('createDelegation: at least one scope is required');\n    }\n    const mode = input.scopeMode ?? 'strict';\n    for (const s of input.scopes) validateScope(parseScope(s), { mode });\n    const scopes = canonicalizeScopes(input.scopes);\n\n    const issuedAt = isoUtcSeconds(input.issuedAt ?? new Date());\n    let expiresAtDate: Date;\n    if (input.expiresAt) {\n        expiresAtDate = input.expiresAt;\n    } else {\n        const ttl = input.ttlMs ?? 7 * 24 * 60 * 60 * 1000;\n        expiresAtDate = new Date(new Date(issuedAt).getTime() + ttl);\n    }\n    const expiresAt = isoUtcSeconds(expiresAtDate);\n\n    const durationMs = new Date(expiresAt).getTime() - new Date(issuedAt).getTime();\n    if (durationMs <= 0) throw new Error('createDelegation: expires_at must be after issued_at');\n    if (durationMs > 365 * 24 * 60 * 60 * 1000) {\n        throw new Error('createDelegation: delegation duration must not exceed 365 days');\n    }\n\n    const nonce = input.nonce ?? randomHex(16);\n    if (!/^[0-9a-f]{32}$/.test(nonce)) {\n        throw new Error('createDelegation: nonce must be 32 lowercase hex chars');\n    }\n\n    const bond = input.bond ?? null;\n    if (bond) {\n        if (!Number.isInteger(bond.sats) || bond.sats < 0) {\n            throw new Error('createDelegation: bond.sats must be a non-negative integer');\n        }\n        if (!/^[0-9a-f]{64}$/.test(bond.attestation_id)) {\n            throw new Error('createDelegation: bond.attestation_id must be 64 lowercase hex chars');\n        }\n    }\n\n    const canonInput = {\n        principal: input.principal.address,\n        agent: input.agentAddress,\n        scopes,\n        bond_sats: bond?.sats ?? 0,\n        bond_attestation: bond?.attestation_id ?? 'none',\n        issued_at: issuedAt,\n        expires_at: expiresAt,\n        nonce,\n    };\n    const id = computeDelegationId(canonInput);\n\n    // v1.2 private-scope: seal BEFORE the principal's outer signature so the\n    // user's wallet sees both prompts in a deterministic order (inner Lock\n    // sig first, outer OC Agent sig second).\n    let scopesEncrypted: ScopesEncryptedEnvelope | undefined;\n    if (input.privateScopes) {\n        if (!input.privateScopes.recipients || input.privateScopes.recipients.length === 0) {\n            throw new Error(\n                'createDelegation: privateScopes.recipients must contain at least the agent device'\n            );\n        }\n        scopesEncrypted = await sealScopes({\n            scopes,\n            sender: {\n                address: input.principal.address,\n                signMessage: input.principal.signMessage,\n            },\n            recipients: input.privateScopes.recipients,\n            ...(input.privateScopes.hint !== undefined && {\n                hint: input.privateScopes.hint,\n            }),\n            ...(input.privateScopes.envelopeExpiresAt !== undefined && {\n                expiresAt: input.privateScopes.envelopeExpiresAt,\n            }),\n        });\n    }\n\n    const sigValue = await input.principal.signMessage(id);\n\n    const envelope: DelegationEnvelope = {\n        v: ENVELOPE_VERSION,\n        kind: 'agent-delegation',\n        id,\n        principal: { address: input.principal.address, alg: 'bip322' },\n        agent: { address: input.agentAddress, alg: 'bip322' },\n        // Public OR private mode — never both. PRIVATE-SCOPE.md §1.1.\n        ...(scopesEncrypted ? { scopes_encrypted: scopesEncrypted } : { scopes }),\n        bond,\n        issued_at: issuedAt,\n        expires_at: expiresAt,\n        nonce,\n        revocation: {\n            holders: input.revocationHolders ?? ['principal'],\n            ref: input.revocationRef ?? null,\n        },\n        sig: {\n            alg: 'bip322',\n            pubkey: input.principal.address,\n            value: sigValue,\n        },\n    };\n    return envelope;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// signAsAgent\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface SignAsAgentInput {\n    agent: SignerRef;\n    delegation: DelegationEnvelope;\n    /** Raw bytes to stamp, or a pre-computed { hash, length } pair. */\n    content: Uint8Array | { hash: string; length: number };\n    mime: string;\n    /** Which scope from delegation.scopes is being exercised (or a narrower sub-scope). */\n    scopeExercised: string;\n    ref?: string | null;\n    signedAt?: Date;\n    /** OTS proof / anchor data if the caller has already submitted; otherwise null. */\n    ots?: ActionOts | null;\n}\n\nexport async function signAsAgent(input: SignAsAgentInput): Promise<ActionEnvelope> {\n    if (input.agent.address !== input.delegation.agent.address) {\n        throw new Error('signAsAgent: signer address does not match delegation.agent.address');\n    }\n\n    let contentHash: string;\n    let contentLength: number;\n    if (input.content instanceof Uint8Array) {\n        contentHash = 'sha256:' + hexEncode(sha256(input.content));\n        contentLength = input.content.byteLength;\n    } else {\n        if (!input.content.hash.startsWith('sha256:') || input.content.hash.length !== 'sha256:'.length + 64) {\n            throw new Error('signAsAgent: content.hash must be \"sha256:\" + 64 lowercase hex chars');\n        }\n        contentHash = input.content.hash;\n        contentLength = input.content.length;\n        if (!Number.isInteger(contentLength) || contentLength < 0) {\n            throw new Error('signAsAgent: content.length must be a non-negative integer');\n        }\n    }\n\n    const signedAt = isoUtcSeconds(input.signedAt ?? new Date());\n\n    const canonInput = {\n        address: input.agent.address,\n        content_hash: contentHash,\n        content_length: contentLength,\n        content_mime: input.mime,\n        signed_at: signedAt,\n        delegation_id: input.delegation.id,\n        scope_exercised: input.scopeExercised,\n    };\n    const id = computeActionId(canonInput);\n\n    const sigValue = await input.agent.signMessage(id);\n\n    const envelope: ActionEnvelope = {\n        v: ENVELOPE_VERSION,\n        kind: 'agent-action',\n        id,\n        content: {\n            hash: contentHash,\n            length: contentLength,\n            mime: input.mime,\n            ref: input.ref ?? null,\n        },\n        signer: { address: input.agent.address, alg: 'bip322' },\n        signed_at: signedAt,\n        delegation_id: input.delegation.id,\n        scope_exercised: input.scopeExercised,\n        ots: input.ots ?? null,\n        sig: { alg: 'bip322', pubkey: input.agent.address, value: sigValue },\n    };\n    return envelope;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// revoke\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface RevokeInput {\n    signer: SignerRef;\n    delegation: DelegationEnvelope;\n    /** Short ASCII rationale. Defaults to empty string. */\n    reason?: string;\n    signedAt?: Date;\n    /** OTS proof / anchor data if the caller has already submitted; otherwise null. */\n    ots?: ActionOts | null;\n}\n\nexport async function revoke(input: RevokeInput): Promise<RevocationEnvelope> {\n    // The principal and the agent may always revoke (SPEC §9.5).\n    const { principal, agent } = input.delegation;\n    if (input.signer.address !== principal.address && input.signer.address !== agent.address) {\n        throw new Error(\n            `revoke: signer ${input.signer.address} not authorized to revoke this delegation`\n        );\n    }\n\n    const reason = input.reason ?? '';\n    if (reason.length > 128) throw new Error('revoke: reason must be <=128 bytes');\n\n    const signedAt = isoUtcSeconds(input.signedAt ?? new Date());\n    const canonInput = {\n        address: input.signer.address,\n        delegation_id: input.delegation.id,\n        reason,\n        signed_at: signedAt,\n    };\n    const id = computeRevocationId(canonInput);\n\n    const sigValue = await input.signer.signMessage(id);\n\n    const envelope: RevocationEnvelope = {\n        v: ENVELOPE_VERSION,\n        kind: 'agent-revocation',\n        id,\n        delegation_id: input.delegation.id,\n        signer: { address: input.signer.address, alg: 'bip322' },\n        reason,\n        signed_at: signedAt,\n        ots: input.ots ?? null,\n        sig: { alg: 'bip322', pubkey: input.signer.address, value: sigValue },\n    };\n    return envelope;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Re-exports for convenience\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport {\n    canonicalizeScopes,\n    computeActionId,\n    computeDelegationId,\n    computeRevocationId,\n    verifyAction,\n    verifyActionAsOfSignedAt,\n    createReplayGuard,\n    DEFAULT_MAX_SKEW_MS,\n    verifyDelegation,\n    verifyRevocation,\n    parseScope,\n    isSubScope,\n    canonicalizeScope,\n    REGISTERED_SCOPES,\n} from '@orangecheck/agent-core';\nexport type {\n    ActionEnvelope,\n    ActionOts,\n    DelegationBond,\n    DelegationEnvelope,\n    RevocationEnvelope,\n    Scope,\n    ScopeConstraint,\n    AgentErrorCode,\n    VerifyActionInput,\n    VerifyActionAsOfSignedAtInput,\n} from '@orangecheck/agent-core';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\nfunction isoUtcSeconds(d: Date): string {\n    return d.toISOString().replace(/\\.\\d+Z$/, 'Z');\n}\n\nfunction randomHex(bytes: number): string {\n    const buf = new Uint8Array(bytes);\n    const c: Crypto | undefined = (globalThis as unknown as { crypto?: Crypto }).crypto;\n    if (c && typeof c.getRandomValues === 'function') {\n        c.getRandomValues(buf);\n    } else {\n        // Non-browser fallback. Node ≥18 exposes globalThis.crypto, so this is unlikely to fire.\n        for (let i = 0; i < bytes; i++) buf[i] = Math.floor(Math.random() * 256);\n    }\n    let out = '';\n    for (let i = 0; i < bytes; i++) {\n        const b = buf[i]!;\n        out += b.toString(16).padStart(2, '0');\n    }\n    return out;\n}\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["// @orangecheck/agent-signer — high-level API for producing OC Agent envelopes.\n//\n//   createDelegation  — principal signs a scoped grant to an agent address.\n//   signAsAgent       — agent produces an agent-action envelope over content.\n//   revoke            — principal (or agent, if authorized) burns a delegation.\n//\n// Each function wraps @orangecheck/agent-core's canonical-message + id\n// computation with a caller-supplied `signMessage` wallet adapter. Nothing here\n// touches the network — OTS anchoring and Nostr publication are separate steps\n// the caller wires up.\n\nimport { sha256 } from '@noble/hashes/sha256';\nimport {\n    canonicalizeScopes,\n    computeActionId,\n    computeDelegationId,\n    computeRevocationId,\n    contentBoundScope,\n    ENVELOPE_VERSION,\n    hexEncode,\n    authoredReasonProblem,\n    isSubScope,\n    parseScope,\n    REVOCATION_REASON_MAX_BYTES,\n    sealScopes,\n    validateScope,\n} from '@orangecheck/agent-core';\nimport type { ScopesEncryptedEnvelope } from '@orangecheck/agent-core';\nimport type {\n    ActionEnvelope,\n    ActionOts,\n    DelegationBond,\n    DelegationEnvelope,\n    RevocationEnvelope,\n    RevocationHolder,\n} from '@orangecheck/agent-core';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Shared wallet-adapter shape (matches `@orangecheck/stamp-core` StampInput).\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface SignerRef {\n    address: string;\n    /** Returns a base64 BIP-322 signature over the given message as UTF-8 bytes. */\n    signMessage: (msg: string) => Promise<string>;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// createDelegation\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface CreateDelegationInput {\n    principal: SignerRef;\n    agentAddress: string;\n    scopes: string[];\n    bond?: DelegationBond | null;\n    issuedAt?: Date;\n    /** Duration from issuedAt in ms. Default 7 days. MAX 365 days per SPEC §4.4. */\n    ttlMs?: number;\n    /** Explicit expires_at overrides ttlMs. */\n    expiresAt?: Date;\n    /** 32-hex. Defaults to crypto.getRandomValues(16-byte) rendered as hex. */\n    nonce?: string;\n    /** Default ['principal']. */\n    revocationHolders?: RevocationHolder[];\n    /** Optional Nostr pointer to a revocation event. Non-cryptographic. */\n    revocationRef?: string | null;\n    /** A signer is strict (SPEC §7.6): scopes are always checked as a strict verifier checks them. */\n    scopeMode?: 'strict';\n    /**\n     * v1.2 private-scope (PRIVATE-SCOPE.md). When supplied, the resulting\n     * delegation envelope omits the public `scopes` field and instead carries\n     * `scopes_encrypted` — an OC Lock envelope wrapping the canonical scope\n     * list, sealed to one or more recipient device keys. The principal signs\n     * BOTH the inner OC Lock envelope (via the `signMessage` callback already\n     * provided on `principal`) AND the outer OC Agent canonical message.\n     *\n     * Recipients MUST include at least the agent's device. Additional\n     * recipients (compliance auditors, third-party verifiers) are optional.\n     */\n    privateScopes?: {\n        /**\n         * Devices authorized to read the scope set. Each is `{ address,\n         * device_id, device_pk }` matching OC Lock's `DeviceRecord` shape.\n         * The same `signMessage` callback on `principal` is used to sign the\n         * inner OC Lock envelope.\n         */\n        recipients: PrivateScopeRecipient[];\n        /** Optional human hint stored in the OC Lock envelope. */\n        hint?: string;\n        /** Optional expiry on the OC Lock envelope. Independent of the\n         *  delegation's expires_at; usually left unset. */\n        envelopeExpiresAt?: Date | null;\n    };\n}\n\n/** Mirror of @orangecheck/lock-core's DeviceRecord. */\nexport interface PrivateScopeRecipient {\n    address: string;\n    device_id: string;\n    /** 32-byte hex X25519 public key. */\n    device_pk: string;\n}\n\nexport async function createDelegation(input: CreateDelegationInput): Promise<DelegationEnvelope> {\n    if (!input.scopes || input.scopes.length === 0) {\n        throw new Error('createDelegation: at least one scope is required');\n    }\n    if (input.scopeMode !== undefined && input.scopeMode !== 'strict') {\n        throw new Error('createDelegation: a signer is strict; scopeMode \"permissive\" is not offered');\n    }\n    for (const s of input.scopes) validateScope(parseScope(s), { mode: 'strict' });\n    const scopes = canonicalizeScopes(input.scopes);\n\n    const issuedAt = isoUtcSeconds(input.issuedAt ?? new Date());\n    let expiresAtDate: Date;\n    if (input.expiresAt) {\n        expiresAtDate = input.expiresAt;\n    } else {\n        const ttl = input.ttlMs ?? 7 * 24 * 60 * 60 * 1000;\n        expiresAtDate = new Date(new Date(issuedAt).getTime() + ttl);\n    }\n    const expiresAt = isoUtcSeconds(expiresAtDate);\n\n    const durationMs = new Date(expiresAt).getTime() - new Date(issuedAt).getTime();\n    if (durationMs <= 0) throw new Error('createDelegation: expires_at must be after issued_at');\n    if (durationMs > 365 * 24 * 60 * 60 * 1000) {\n        throw new Error('createDelegation: delegation duration must not exceed 365 days');\n    }\n\n    const nonce = input.nonce ?? randomHex(16);\n    if (!/^[0-9a-f]{32}$/.test(nonce)) {\n        throw new Error('createDelegation: nonce must be 32 lowercase hex chars');\n    }\n\n    const bond = input.bond ?? null;\n    if (bond) {\n        if (!Number.isInteger(bond.sats) || bond.sats < 0) {\n            throw new Error('createDelegation: bond.sats must be a non-negative integer');\n        }\n        if (!/^[0-9a-f]{64}$/.test(bond.attestation_id)) {\n            throw new Error('createDelegation: bond.attestation_id must be 64 lowercase hex chars');\n        }\n    }\n\n    const canonInput = {\n        principal: input.principal.address,\n        agent: input.agentAddress,\n        scopes,\n        bond_sats: bond?.sats ?? 0,\n        bond_attestation: bond?.attestation_id ?? 'none',\n        issued_at: issuedAt,\n        expires_at: expiresAt,\n        nonce,\n    };\n    const id = computeDelegationId(canonInput);\n\n    // v1.2 private-scope: seal BEFORE the principal's outer signature so the\n    // user's wallet sees both prompts in a deterministic order (inner Lock\n    // sig first, outer OC Agent sig second).\n    let scopesEncrypted: ScopesEncryptedEnvelope | undefined;\n    if (input.privateScopes) {\n        if (!input.privateScopes.recipients || input.privateScopes.recipients.length === 0) {\n            throw new Error(\n                'createDelegation: privateScopes.recipients must contain at least the agent device'\n            );\n        }\n        scopesEncrypted = await sealScopes({\n            scopes,\n            sender: {\n                address: input.principal.address,\n                signMessage: input.principal.signMessage,\n            },\n            recipients: input.privateScopes.recipients,\n            ...(input.privateScopes.hint !== undefined && {\n                hint: input.privateScopes.hint,\n            }),\n            ...(input.privateScopes.envelopeExpiresAt !== undefined && {\n                expiresAt: input.privateScopes.envelopeExpiresAt,\n            }),\n        });\n    }\n\n    const sigValue = await input.principal.signMessage(id);\n\n    const envelope: DelegationEnvelope = {\n        v: ENVELOPE_VERSION,\n        kind: 'agent-delegation',\n        id,\n        principal: { address: input.principal.address, alg: 'bip322' },\n        agent: { address: input.agentAddress, alg: 'bip322' },\n        // Public OR private mode — never both. PRIVATE-SCOPE.md §1.1.\n        ...(scopesEncrypted ? { scopes_encrypted: scopesEncrypted } : { scopes }),\n        bond,\n        issued_at: issuedAt,\n        expires_at: expiresAt,\n        nonce,\n        revocation: {\n            holders: input.revocationHolders ?? ['principal'],\n            ref: input.revocationRef ?? null,\n        },\n        sig: {\n            alg: 'bip322',\n            pubkey: input.principal.address,\n            value: sigValue,\n        },\n    };\n    return envelope;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// signAsAgent\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface SignAsAgentInput {\n    agent: SignerRef;\n    delegation: DelegationEnvelope;\n    /** Raw bytes to stamp, or a pre-computed { hash, length } pair. */\n    content: Uint8Array | { hash: string; length: number };\n    mime: string;\n    /** Which scope from delegation.scopes is being exercised (or a narrower sub-scope). */\n    scopeExercised: string;\n    ref?: string | null;\n    signedAt?: Date;\n    /** OTS proof / anchor data if the caller has already submitted; otherwise null. */\n    ots?: ActionOts | null;\n}\n\nexport async function signAsAgent(input: SignAsAgentInput): Promise<ActionEnvelope> {\n    if (input.agent.address !== input.delegation.agent.address) {\n        throw new Error('signAsAgent: signer address does not match delegation.agent.address');\n    }\n\n    let contentHash: string;\n    let contentLength: number;\n    if (input.content instanceof Uint8Array) {\n        contentHash = 'sha256:' + hexEncode(sha256(input.content));\n        contentLength = input.content.byteLength;\n    } else {\n        if (!input.content.hash.startsWith('sha256:') || input.content.hash.length !== 'sha256:'.length + 64) {\n            throw new Error('signAsAgent: content.hash must be \"sha256:\" + 64 lowercase hex chars');\n        }\n        contentHash = input.content.hash;\n        contentLength = input.content.length;\n        if (!Number.isInteger(contentLength) || contentLength < 0) {\n            throw new Error('signAsAgent: content.length must be a non-negative integer');\n        }\n    }\n\n    // A verifier reads content-bound keys from the content (SPEC §8.3 step 12a);\n    // sign nothing whose content falls outside the scope it claims.\n    const exercised = parseScope(input.scopeExercised);\n    const fromContent = contentBoundScope(exercised, {\n        hash: contentHash,\n        length: contentLength,\n        mime: input.mime,\n    });\n    if (!isSubScope(fromContent, exercised)) {\n        throw new Error(\n            `signAsAgent: the content (${input.mime}, ${contentLength} bytes, ${contentHash}) is outside ` +\n                `scope_exercised ${input.scopeExercised}`\n        );\n    }\n\n    const signedAt = isoUtcSeconds(input.signedAt ?? new Date());\n\n    const canonInput = {\n        address: input.agent.address,\n        content_hash: contentHash,\n        content_length: contentLength,\n        content_mime: input.mime,\n        signed_at: signedAt,\n        delegation_id: input.delegation.id,\n        scope_exercised: input.scopeExercised,\n    };\n    const id = computeActionId(canonInput);\n\n    const sigValue = await input.agent.signMessage(id);\n\n    const envelope: ActionEnvelope = {\n        v: ENVELOPE_VERSION,\n        kind: 'agent-action',\n        id,\n        content: {\n            hash: contentHash,\n            length: contentLength,\n            mime: input.mime,\n            ref: input.ref ?? null,\n        },\n        signer: { address: input.agent.address, alg: 'bip322' },\n        signed_at: signedAt,\n        delegation_id: input.delegation.id,\n        scope_exercised: input.scopeExercised,\n        ots: input.ots ?? null,\n        sig: { alg: 'bip322', pubkey: input.agent.address, value: sigValue },\n    };\n    return envelope;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// revoke\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface RevokeInput {\n    signer: SignerRef;\n    delegation: DelegationEnvelope;\n    /** Printable ASCII, at most 128 bytes: SPEC §9.1 allows any ASCII; we write no control character. Defaults to \"\". */\n    reason?: string;\n    signedAt?: Date;\n    /** OTS proof / anchor data if the caller has already submitted; otherwise null. */\n    ots?: ActionOts | null;\n}\n\nexport async function revoke(input: RevokeInput): Promise<RevocationEnvelope> {\n    // The principal and the agent may always revoke (SPEC §9.5).\n    const { principal, agent } = input.delegation;\n    if (input.signer.address !== principal.address && input.signer.address !== agent.address) {\n        throw new Error(\n            `revoke: signer ${input.signer.address} not authorized to revoke this delegation`\n        );\n    }\n\n    const reason = input.reason ?? '';\n    // SPEC §9.1: a signer writes printable ASCII of at most 128 bytes.\n    switch (authoredReasonProblem(reason)) {\n        case null:\n            break;\n        case 'too_long':\n            throw new Error(`revoke: reason must be at most ${REVOCATION_REASON_MAX_BYTES} bytes`);\n        case 'not_ascii':\n            throw new Error('revoke: reason must be ASCII');\n        case 'control_character':\n            throw new Error('revoke: reason must have no line break or other control character');\n        case 'not_text':\n            throw new Error('revoke: reason must be text');\n    }\n\n    const signedAt = isoUtcSeconds(input.signedAt ?? new Date());\n    const canonInput = {\n        address: input.signer.address,\n        delegation_id: input.delegation.id,\n        reason,\n        signed_at: signedAt,\n    };\n    const id = computeRevocationId(canonInput);\n\n    const sigValue = await input.signer.signMessage(id);\n\n    const envelope: RevocationEnvelope = {\n        v: ENVELOPE_VERSION,\n        kind: 'agent-revocation',\n        id,\n        delegation_id: input.delegation.id,\n        signer: { address: input.signer.address, alg: 'bip322' },\n        reason,\n        signed_at: signedAt,\n        ots: input.ots ?? null,\n        sig: { alg: 'bip322', pubkey: input.signer.address, value: sigValue },\n    };\n    return envelope;\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Re-exports for convenience\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport {\n    canonicalizeScopes,\n    computeActionId,\n    computeDelegationId,\n    computeRevocationId,\n    verifyAction,\n    verifyActionAsOfSignedAt,\n    createReplayGuard,\n    DEFAULT_MAX_SKEW_MS,\n    verifyDelegation,\n    verifyRevocation,\n    parseScope,\n    isSubScope,\n    canonicalizeScope,\n    REGISTERED_SCOPES,\n    authoredReasonProblem,\n    REVOCATION_REASON_MAX_BYTES,\n    shownReason,\n} from '@orangecheck/agent-core';\nexport type {\n    ActionEnvelope,\n    ActionOts,\n    DelegationBond,\n    DelegationEnvelope,\n    RevocationEnvelope,\n    Scope,\n    ScopeConstraint,\n    AgentErrorCode,\n    VerifyActionInput,\n    VerifyActionAsOfSignedAtInput,\n} from '@orangecheck/agent-core';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\nfunction isoUtcSeconds(d: Date): string {\n    return d.toISOString().replace(/\\.\\d+Z$/, 'Z');\n}\n\nfunction randomHex(bytes: number): string {\n    const buf = new Uint8Array(bytes);\n    const c: Crypto | undefined = (globalThis as unknown as { crypto?: Crypto }).crypto;\n    if (c && typeof c.getRandomValues === 'function') {\n        c.getRandomValues(buf);\n    } else {\n        // Non-browser fallback. Node ≥18 exposes globalThis.crypto, so this is unlikely to fire.\n        for (let i = 0; i < bytes; i++) buf[i] = Math.floor(Math.random() * 256);\n    }\n    let out = '';\n    for (let i = 0; i < bytes; i++) {\n        const b = buf[i]!;\n        out += b.toString(16).padStart(2, '0');\n    }\n    return out;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orangecheck/agent-signer",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "OC Agent signer: createDelegation(), signAsAgent(), revoke(). Composes @orangecheck/agent-core with a wallet-adapter signing function and optional OTS anchoring.",
   "keywords": [
     "bitcoin",
@@ -49,7 +49,7 @@
   },
   "dependencies": {
     "@noble/hashes": "^1.5.0",
-    "@orangecheck/agent-core": "^2.7.1"
+    "@orangecheck/agent-core": "^2.10.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.2",

package/src/index.test.ts

@@ -160,6 +160,35 @@ describe('revoke', () => {
         expect(r.ok).toBe(true);
     });
 
+    it('refuses a reason the spec refuses, before it asks for a signature', async () => {
+        const delegation = await createDelegation({
+            principal: { address: PRINCIPAL, signMessage: fakeSign(PRINCIPAL) },
+            agentAddress: AGENT,
+            scopes: ['stamp:sign(mime=text/markdown)'],
+            ttlMs: 60_000,
+        });
+        let asked = 0;
+        const signer = {
+            address: PRINCIPAL,
+            signMessage: async (m: string) => {
+                asked++;
+                return fakeSign(PRINCIPAL)(m);
+            },
+        };
+        for (const [reason, why] of [
+            ['x'.repeat(129), /at most 128 bytes/],
+            ['\u00e9'.repeat(128), /must be ASCII/],
+            ['key lost\nsigned_at: 2020-01-01T00:00:00Z', /control character/],
+            ['tab\there', /control character/],
+        ] as const) {
+            await expect(revoke({ signer, delegation, reason })).rejects.toThrow(why);
+        }
+        expect(asked).toBe(0);
+        const rev = await revoke({ signer, delegation, reason: 'x'.repeat(128) });
+        expect(rev.reason).toHaveLength(128);
+        expect(asked).toBe(1);
+    });
+
     it('rejects a revocation from a signer who is neither principal nor agent', async () => {
         const OTHER = 'bc1qother0000000000000000000000000000000000';
         const delegation = await createDelegation({
@@ -261,3 +290,64 @@ describe('re-exported verifiers', () => {
         expect(guard.firstUse(action, at)).toBe(false);
     });
 });
+
+// SPEC §8.3 step 12a: a verifier reads content-bound keys from the content, so the
+// signer refuses content its own claim, or the grant, does not cover.
+describe('signAsAgent and content-bound keys', () => {
+    const GRANT = 'stamp:sign(content_hash_prefix=ab,max_bytes<=10,mime=text/plain)';
+    const grant = () =>
+        createDelegation({
+            principal: { address: PRINCIPAL, signMessage: fakeSign(PRINCIPAL) },
+            agentAddress: AGENT,
+            scopes: [GRANT],
+            ttlMs: 60 * 60 * 1000,
+        });
+    const sign = async (content: { hash: string; length: number }, mime: string, scopeExercised = GRANT) =>
+        signAsAgent({
+            agent: { address: AGENT, signMessage: fakeSign(AGENT) },
+            delegation: await grant(),
+            content,
+            mime,
+            scopeExercised,
+        });
+    const AB = 'sha256:ab' + 'e'.repeat(62);
+
+    it('signs content the claim and the grant cover, and it verifies', async () => {
+        const delegation = await grant();
+        const action = await signAsAgent({
+            agent: { address: AGENT, signMessage: fakeSign(AGENT) },
+            delegation,
+            content: { hash: AB, length: 5 },
+            mime: 'text/plain',
+            scopeExercised: GRANT,
+        });
+        const r = await verifyAction({ action, delegation, verifyBip322: fakeVerify, skipRevocationCheck: true });
+        expect(r.ok).toBe(true);
+    });
+
+    it('refuses oversize content, another mime, or a hash outside the prefix', async () => {
+        await expect(sign({ hash: AB, length: 999999 }, 'text/plain')).rejects.toThrow(/outside/);
+        await expect(sign({ hash: AB, length: 5 }, 'text/html')).rejects.toThrow(/outside/);
+        await expect(sign({ hash: 'sha256:' + '9'.repeat(64), length: 5 }, 'text/plain')).rejects.toThrow(/outside/);
+    });
+
+    it('refuses content outside a narrower claim it makes', async () => {
+        await expect(
+            sign({ hash: AB, length: 8 }, 'text/plain', 'stamp:sign(content_hash_prefix=abe,max_bytes<=5,mime=text/plain)')
+        ).rejects.toThrow(/outside/);
+    });
+});
+
+describe('createDelegation is strict', () => {
+    it('refuses scopeMode "permissive"', async () => {
+        await expect(
+            createDelegation({
+                principal: { address: PRINCIPAL, signMessage: fakeSign(PRINCIPAL) },
+                agentAddress: AGENT,
+                scopes: ['acme:deploy(region=eu)'],
+                ttlMs: 60_000,
+                scopeMode: 'permissive' as never,
+            })
+        ).rejects.toThrow(/strict/);
+    });
+});

package/src/index.ts

@@ -15,16 +15,17 @@ import {
     computeActionId,
     computeDelegationId,
     computeRevocationId,
+    contentBoundScope,
     ENVELOPE_VERSION,
     hexEncode,
+    authoredReasonProblem,
+    isSubScope,
     parseScope,
+    REVOCATION_REASON_MAX_BYTES,
     sealScopes,
     validateScope,
 } from '@orangecheck/agent-core';
-import type {
-    ScopesEncryptedEnvelope,
-    ValidationOptions,
-} from '@orangecheck/agent-core';
+import type { ScopesEncryptedEnvelope } from '@orangecheck/agent-core';
 import type {
     ActionEnvelope,
     ActionOts,
@@ -64,8 +65,8 @@ export interface CreateDelegationInput {
     revocationHolders?: RevocationHolder[];
     /** Optional Nostr pointer to a revocation event. Non-cryptographic. */
     revocationRef?: string | null;
-    /** Default 'strict'. 'permissive' allows unregistered scopes / constraint keys. */
-    scopeMode?: ValidationOptions['mode'];
+    /** A signer is strict (SPEC §7.6): scopes are always checked as a strict verifier checks them. */
+    scopeMode?: 'strict';
     /**
      * v1.2 private-scope (PRIVATE-SCOPE.md). When supplied, the resulting
      * delegation envelope omits the public `scopes` field and instead carries
@@ -105,8 +106,10 @@ export async function createDelegation(input: CreateDelegationInput): Promise<De
     if (!input.scopes || input.scopes.length === 0) {
         throw new Error('createDelegation: at least one scope is required');
     }
-    const mode = input.scopeMode ?? 'strict';
-    for (const s of input.scopes) validateScope(parseScope(s), { mode });
+    if (input.scopeMode !== undefined && input.scopeMode !== 'strict') {
+        throw new Error('createDelegation: a signer is strict; scopeMode "permissive" is not offered');
+    }
+    for (const s of input.scopes) validateScope(parseScope(s), { mode: 'strict' });
     const scopes = canonicalizeScopes(input.scopes);
 
     const issuedAt = isoUtcSeconds(input.issuedAt ?? new Date());
@@ -244,6 +247,21 @@ export async function signAsAgent(input: SignAsAgentInput): Promise<ActionEnvelo
         }
     }
 
+    // A verifier reads content-bound keys from the content (SPEC §8.3 step 12a);
+    // sign nothing whose content falls outside the scope it claims.
+    const exercised = parseScope(input.scopeExercised);
+    const fromContent = contentBoundScope(exercised, {
+        hash: contentHash,
+        length: contentLength,
+        mime: input.mime,
+    });
+    if (!isSubScope(fromContent, exercised)) {
+        throw new Error(
+            `signAsAgent: the content (${input.mime}, ${contentLength} bytes, ${contentHash}) is outside ` +
+                `scope_exercised ${input.scopeExercised}`
+        );
+    }
+
     const signedAt = isoUtcSeconds(input.signedAt ?? new Date());
 
     const canonInput = {
@@ -286,7 +304,7 @@ export async function signAsAgent(input: SignAsAgentInput): Promise<ActionEnvelo
 export interface RevokeInput {
     signer: SignerRef;
     delegation: DelegationEnvelope;
-    /** Short ASCII rationale. Defaults to empty string. */
+    /** Printable ASCII, at most 128 bytes: SPEC §9.1 allows any ASCII; we write no control character. Defaults to "". */
     reason?: string;
     signedAt?: Date;
     /** OTS proof / anchor data if the caller has already submitted; otherwise null. */
@@ -303,7 +321,19 @@ export async function revoke(input: RevokeInput): Promise<RevocationEnvelope> {
     }
 
     const reason = input.reason ?? '';
-    if (reason.length > 128) throw new Error('revoke: reason must be <=128 bytes');
+    // SPEC §9.1: a signer writes printable ASCII of at most 128 bytes.
+    switch (authoredReasonProblem(reason)) {
+        case null:
+            break;
+        case 'too_long':
+            throw new Error(`revoke: reason must be at most ${REVOCATION_REASON_MAX_BYTES} bytes`);
+        case 'not_ascii':
+            throw new Error('revoke: reason must be ASCII');
+        case 'control_character':
+            throw new Error('revoke: reason must have no line break or other control character');
+        case 'not_text':
+            throw new Error('revoke: reason must be text');
+    }
 
     const signedAt = isoUtcSeconds(input.signedAt ?? new Date());
     const canonInput = {
@@ -349,6 +379,9 @@ export {
     isSubScope,
     canonicalizeScope,
     REGISTERED_SCOPES,
+    authoredReasonProblem,
+    REVOCATION_REASON_MAX_BYTES,
+    shownReason,
 } from '@orangecheck/agent-core';
 export type {
     ActionEnvelope,