@peac/kernel 0.11.1 → 0.11.2

package/dist/types.d.ts

@@ -37,6 +37,14 @@ export type JsonObject = {
 };
 export { ERROR_CATEGORIES } from './error-categories.generated.js';
 export type { ErrorCategory } from './error-categories.generated.js';
+/**
+ * Agent-actionable recovery hint (DD-132, DD-133).
+ *
+ * Best-effort guidance for agents; servers MAY change mappings between versions
+ * without breaking the protocol. Agents SHOULD NOT build hard dependencies on
+ * specific next_action values for specific error codes.
+ */
+export type NextAction = 'retry_after_delay' | 'retry_with_different_key' | 'retry_with_different_input' | 'refresh_attestation' | 'contact_issuer' | 'abort' | 'none';
 /**
  * Error code definition
  *
@@ -48,7 +56,8 @@ export interface ErrorDefinition {
     http_status: number;
     title: string;
     description: string;
-    retriable: boolean;
+    retryable: boolean;
+    next_action: NextAction;
     category: import('./error-categories.generated.js').ErrorCategory;
 }
 /**

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,EAAE,CAAC;AAEpC;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAOtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,YAAY,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,iCAAiC,EAAE,aAAa,CAAC;CACnE;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,EAAE,CAAC;AAEpC;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAOtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,YAAY,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAClB,mBAAmB,GACnB,0BAA0B,GAC1B,4BAA4B,GAC5B,qBAAqB,GACrB,gBAAgB,GAChB,OAAO,GACP,MAAM,CAAC;AAEX;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,UAAU,CAAC;IACxB,QAAQ,EAAE,OAAO,iCAAiC,EAAE,aAAa,CAAC;CACnE;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/types.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/error-categories.generated.ts"],"names":[],"mappings":";AAaO,IAAM,gBAAA,GAAmB;AAAA,EAC9B,aAAA;AAAA,EACA,QAAA;AAAA,EACA,SAAA;AAAA,EACA,SAAA;AAAA,EACA,UAAA;AAAA,EACA,gBAAA;AAAA,EACA,aAAA;AAAA,EACA,KAAA;AAAA,EACA,YAAA;AAAA,EACA,cAAA;AAAA,EACA,UAAA;AAAA,EACA;AACF","file":"types.mjs","sourcesContent":["/**\n * PEAC Protocol Error Categories\n *\n * AUTO-GENERATED from specs/kernel/errors.json\n * DO NOT EDIT MANUALLY - run: npx tsx scripts/codegen-errors.ts\n * Spec version: 0.11.0\n */\n\n/**\n * Canonical error categories derived from specs/kernel/errors.json.\n * This is the single source of truth for all error category definitions.\n * Sorted alphabetically. This ordering is a codegen invariant.\n */\nexport const ERROR_CATEGORIES = [\n  'attribution',\n  'bundle',\n  'control',\n  'dispute',\n  'identity',\n  'infrastructure',\n  'interaction',\n  'ucp',\n  'validation',\n  'verification',\n  'verifier',\n  'workflow',\n] as const;\n\n/**\n * Error category type - union of all categories in specs/kernel/errors.json\n */\nexport type ErrorCategory = (typeof ERROR_CATEGORIES)[number];\n"]}
+{"version":3,"sources":["../src/error-categories.generated.ts"],"names":[],"mappings":";AAaO,IAAM,gBAAA,GAAmB;AAAA,EAC9B,aAAA;AAAA,EACA,QAAA;AAAA,EACA,SAAA;AAAA,EACA,SAAA;AAAA,EACA,UAAA;AAAA,EACA,gBAAA;AAAA,EACA,aAAA;AAAA,EACA,KAAA;AAAA,EACA,YAAA;AAAA,EACA,cAAA;AAAA,EACA,UAAA;AAAA,EACA;AACF","file":"types.mjs","sourcesContent":["/**\n * PEAC Protocol Error Categories\n *\n * AUTO-GENERATED from specs/kernel/errors.json\n * DO NOT EDIT MANUALLY - run: npx tsx scripts/codegen-errors.ts\n * Spec version: 0.11.2\n */\n\n/**\n * Canonical error categories derived from specs/kernel/errors.json.\n * This is the single source of truth for all error category definitions.\n * Sorted alphabetically. This ordering is a codegen invariant.\n */\nexport const ERROR_CATEGORIES = [\n  'attribution',\n  'bundle',\n  'control',\n  'dispute',\n  'identity',\n  'infrastructure',\n  'interaction',\n  'ucp',\n  'validation',\n  'verification',\n  'verifier',\n  'workflow',\n] as const;\n\n/**\n * Error category type - union of all categories in specs/kernel/errors.json\n */\nexport type ErrorCategory = (typeof ERROR_CATEGORIES)[number];\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peac/kernel",
-  "version": "0.11.1",
+  "version": "0.11.2",
   "description": "PEAC protocol kernel - normative constants, errors, and registries",
   "main": "dist/index.cjs",
   "types": "dist/index.d.ts",