@kya-os/checkpoint-shared 1.9.0 → 1.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (59) hide show
  1. package/CHANGELOG.md +24 -0
  2. package/README.md +1 -1
  3. package/dist/browser-posture-5fPrsxx7.d.mts.map +1 -1
  4. package/dist/browser-posture-CCR1kh5e.d.ts.map +1 -1
  5. package/dist/browser-posture.js +35 -4
  6. package/dist/browser-posture.mjs +35 -4
  7. package/dist/browser-posture.mjs.map +1 -1
  8. package/dist/deploy/index.d.mts +1 -0
  9. package/dist/deploy/index.d.mts.map +1 -1
  10. package/dist/deploy/index.d.ts +1 -0
  11. package/dist/deploy/index.d.ts.map +1 -1
  12. package/dist/deploy/index.js +9 -1
  13. package/dist/deploy/index.mjs +9 -1
  14. package/dist/deploy/index.mjs.map +1 -1
  15. package/dist/{fetcher-C8qvwdnA.d.ts → fetcher-CCw4Q95g.d.ts} +2 -2
  16. package/dist/{fetcher-C8qvwdnA.d.ts.map → fetcher-CCw4Q95g.d.ts.map} +1 -1
  17. package/dist/{fetcher-D2vjr7jB.d.mts → fetcher-CZfLcbRZ.d.mts} +2 -2
  18. package/dist/{fetcher-D2vjr7jB.d.mts.map → fetcher-CZfLcbRZ.d.mts.map} +1 -1
  19. package/dist/host-adapter/index.d.mts +1 -1
  20. package/dist/host-adapter/index.d.ts +1 -1
  21. package/dist/{index-DnFsmr_o.d.ts → index-Cdv_FH0H.d.ts} +2 -2
  22. package/dist/{index-DnFsmr_o.d.ts.map → index-Cdv_FH0H.d.ts.map} +1 -1
  23. package/dist/{index-rvw5Bz-r.d.mts → index-DL_dmQBY.d.mts} +2 -2
  24. package/dist/{index-rvw5Bz-r.d.mts.map → index-DL_dmQBY.d.mts.map} +1 -1
  25. package/dist/index.d.mts +68 -52
  26. package/dist/index.d.mts.map +1 -1
  27. package/dist/index.d.ts +68 -52
  28. package/dist/index.d.ts.map +1 -1
  29. package/dist/index.js +27 -13
  30. package/dist/index.mjs +24 -14
  31. package/dist/index.mjs.map +1 -1
  32. package/dist/kya-http.d.mts +2 -2
  33. package/dist/kya-http.d.ts +2 -2
  34. package/dist/kya-http.js +6 -2
  35. package/dist/kya-http.mjs +2 -2
  36. package/dist/policy/fetcher.d.mts +1 -1
  37. package/dist/policy/fetcher.d.ts +1 -1
  38. package/dist/policy/schemas.d.mts +1 -1
  39. package/dist/policy/schemas.d.ts +1 -1
  40. package/dist/{registered-sid-DVGTSH0L.js → registered-sid-BZfDOfXy.js} +107 -4
  41. package/dist/{registered-sid-26hNxp6t.mjs → registered-sid-CS9V8nPr.mjs} +85 -6
  42. package/dist/registered-sid-CS9V8nPr.mjs.map +1 -0
  43. package/dist/{registered-sid-D6KCaT1E.d.ts → registered-sid-CnWIU_l1.d.mts} +13 -2
  44. package/dist/registered-sid-CnWIU_l1.d.mts.map +1 -0
  45. package/dist/{registered-sid-D6KCaT1E.d.mts → registered-sid-CnWIU_l1.d.ts} +13 -2
  46. package/dist/registered-sid-CnWIU_l1.d.ts.map +1 -0
  47. package/dist/{schemas-m-GqyfyO.d.mts → schemas-BhC88D1-.d.mts} +5 -5
  48. package/dist/{schemas-m-GqyfyO.d.mts.map → schemas-BhC88D1-.d.mts.map} +1 -1
  49. package/dist/{schemas-CGKHzcMV.d.ts → schemas-DZa1ouGs.d.ts} +5 -5
  50. package/dist/{schemas-CGKHzcMV.d.ts.map → schemas-DZa1ouGs.d.ts.map} +1 -1
  51. package/dist/signals/index.d.mts.map +1 -1
  52. package/dist/signals/index.d.ts.map +1 -1
  53. package/dist/signals/index.js +4 -0
  54. package/dist/signals/index.mjs +4 -0
  55. package/dist/signals/index.mjs.map +1 -1
  56. package/package.json +1 -1
  57. package/dist/registered-sid-26hNxp6t.mjs.map +0 -1
  58. package/dist/registered-sid-D6KCaT1E.d.mts.map +0 -1
  59. package/dist/registered-sid-D6KCaT1E.d.ts.map +0 -1
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kya-os/checkpoint-shared",
3
- "version": "1.9.0",
3
+ "version": "1.10.0",
4
4
  "description": "Checkpoint shared types and schemas (formerly @kya-os/agentshield-shared)",
5
5
  "keywords": [
6
6
  "ai",
@@ -1 +0,0 @@
1
- {"version":3,"file":"registered-sid-26hNxp6t.mjs","names":[],"sources":["../src/mcpi/delegation-headers.ts","../src/mcpi/anonymous-principal.ts","../src/mcpi/registered-sid.ts"],"sourcesContent":["/**\n * Delegation-proof request detection (P2 / DR-1).\n *\n * The engine's L2 delegation-root pinning (`ContextSpec.trustedDelegationRoots`)\n * is consulted for every credential the engine verifies: the delegation-proof\n * headers below AND an `Authorization: Bearer` VC-JWT. Consumers gate root\n * resolution on `requestPresentedCredential`, so the human / no-credential hot\n * path stays a precise no-op.\n *\n * Keeping the header set here (rather than re-listing the literals at each site)\n * is the whole point: a new delegation transport header is added in one place\n * and every verifier surface agrees.\n */\n\n/**\n * Lowercased delegation-proof header names. `kya-os-delegation-credential` is the\n * canonical KYA-OS transport; `kya-delegation` is the legacy envelope form still\n * accepted via `legacyEnvelopeFallback`.\n */\nexport const DELEGATION_PROOF_HEADERS = ['kya-os-delegation-credential', 'kya-delegation'] as const;\n\n/** A header value is \"present\" when it is a non-empty string (or non-empty list). */\nfunction isPresent(value: unknown): boolean {\n if (Array.isArray(value)) return value.length > 0;\n return typeof value === 'string' && value.length > 0;\n}\n\n/**\n * Does the request carry a KYA-OS delegation-proof header?\n *\n * Accepts either a `Headers` instance (Next.js / fetch — case-insensitive\n * lookup) or a plain header record (raw Node/Express headers, gateway worker's\n * lowercased map). Record keys are matched case-insensitively, so callers do not\n * need to pre-normalize. Returns `false` for `null`/`undefined`.\n */\nexport function requestCarriesDelegationProof(\n headers: Headers | Record<string, unknown> | null | undefined\n): boolean {\n if (!headers) return false;\n\n if (typeof (headers as Headers).get === 'function') {\n const h = headers as Headers;\n return DELEGATION_PROOF_HEADERS.some((name) => isPresent(h.get(name)));\n }\n\n const record = headers as Record<string, unknown>;\n const lowerKeyed = new Map<string, unknown>();\n for (const key of Object.keys(record)) {\n lowerKeyed.set(key.toLowerCase(), record[key]);\n }\n return DELEGATION_PROOF_HEADERS.some((name) => isPresent(lowerKeyed.get(name)));\n}\n\nconst MAX_VC_JWT_PAYLOAD_CHARS = 16 * 1024;\n\nfunction headerText(headers: Headers | Record<string, unknown>, name: string): string | undefined {\n if (typeof (headers as Headers).get === 'function') {\n return (headers as Headers).get(name) ?? undefined;\n }\n for (const [key, value] of Object.entries(headers as Record<string, unknown>)) {\n if (key.toLowerCase() !== name) continue;\n if (Array.isArray(value)) return value.join(', ');\n return typeof value === 'string' ? value : undefined;\n }\n return undefined;\n}\n\nfunction isMemberDelimiter(c: string): boolean {\n return c === '=' || c === ';' || c === ',' || c === ' ' || c === '\\t';\n}\n\n// Quote-aware member scan; the engine owns the authoritative parse.\nfunction hasKyaMember(value: string): boolean {\n let memberStart = true;\n let quoted = false;\n let escaped = false;\n for (let i = 0; i < value.length; i++) {\n const c = value[i];\n if (quoted) {\n if (escaped) escaped = false;\n else if (c === '\\\\') escaped = true;\n else if (c === '\"') quoted = false;\n continue;\n }\n if (memberStart) {\n if (c === ' ' || c === '\\t') continue;\n if (\n value.startsWith('kya', i) &&\n (i + 3 === value.length || isMemberDelimiter(value[i + 3]))\n ) {\n return true;\n }\n memberStart = false;\n }\n if (c === '\"') quoted = true;\n else if (c === ',') memberStart = true;\n }\n return false;\n}\n\nfunction decodeBase64UrlJson(segment: string): unknown {\n const padded = segment.replace(/-/g, '+').replace(/_/g, '/');\n const binary = atob(padded + '='.repeat((4 - (padded.length % 4)) % 4));\n const bytes = Uint8Array.from(binary, (ch) => ch.charCodeAt(0));\n return JSON.parse(new TextDecoder().decode(bytes));\n}\n\nfunction isDelegationCredentialPayload(payload: unknown): boolean {\n if (typeof payload !== 'object' || payload === null) return false;\n if ('vc' in payload) return true;\n const type = (payload as { type?: unknown }).type;\n return Array.isArray(type) && type.includes('DelegationCredential');\n}\n\n// Must equal the orchestrator's delegation routing (`vc` claim OR flat `type`\n// DelegationCredential); an oversized payload counts as presented.\nfunction looksLikeVcJwt(token: string): boolean {\n const parts = token.split('.');\n if (parts.length !== 3 || parts.some((part) => part.length === 0)) return false;\n if (parts[1].length > MAX_VC_JWT_PAYLOAD_CHARS) return true;\n try {\n return isDelegationCredentialPayload(decodeBase64UrlJson(parts[1]));\n } catch {\n return false;\n }\n}\n\n/** Same definition as the .NET / Java `IsCredentialPresented`. */\nexport function requestPresentedCredential(\n headers: Headers | Record<string, unknown> | null | undefined\n): boolean {\n if (!headers) return false;\n for (const name of ['signature-input', 'signature']) {\n const value = headerText(headers, name);\n if (value && hasKyaMember(value)) return true;\n }\n if (requestCarriesDelegationProof(headers)) return true;\n const authorization = headerText(headers, 'authorization');\n const bearer = authorization?.match(/^bearer\\s+(\\S+)/i);\n return bearer !== null && bearer !== undefined && looksLikeVcJwt(bearer[1]);\n}\n","/**\n * Canonical did:web for the anonymous-principal sentinel (see `./principal.ts`).\n * Kept apart from the client DID derivation, which loads `@noble/hashes`, so\n * request-path code can take it from the `./kya-http` lean entry.\n */\nexport const ANONYMOUS_PRINCIPAL_DID = 'did:web:kya.vouched.id:principals:anonymous';\n","/**\n * The registered session anchor (`sid`) contract between a reporter and\n * Checkpoint ingest. Kept apart from `reported-identity.ts`, which builds Zod\n * schemas when it loads, so the runtime and the `./kya-http` entry can read\n * these values without loading Zod.\n */\n\n/**\n * Max length of a registered session anchor (`sid`) accepted on the wire and\n * enforced again at the customer route. The join partner\n * `bouncer_sessions.id` is `varchar(100)`; `detections.registered_sid` stays\n * `text` (converting a live column to `varchar` would take an ACCESS EXCLUSIVE\n * rewrite of the hottest table), so this constant is the width contract\n * instead of the column type.\n */\nexport const REGISTERED_SID_MAX_LENGTH = 100;\n\n/**\n * The one delegation result that may attribute a `sid` to a session timeline.\n * A rejected presentation carries no engine-emitted sid, and a sid on a\n * `failed` / `not_presented` report is attacker-shaped, so ingest stamps\n * `registered_sid` only for this result and nulls it otherwise (D4 / D15).\n * One member on purpose: Section 13 of the plan records how an explicitly\n * unverified-labeled `failed` could join it later.\n */\nexport const SID_ATTRIBUTABLE_RESULT = 'verified' as const;\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,MAAa,2BAA2B,CAAC,gCAAgC,gBAAgB;;AAGzF,SAAS,UAAU,OAAyB;CAC1C,IAAI,MAAM,QAAQ,KAAK,GAAG,OAAO,MAAM,SAAS;CAChD,OAAO,OAAO,UAAU,YAAY,MAAM,SAAS;AACrD;;;;;;;;;AAUA,SAAgB,8BACd,SACS;CACT,IAAI,CAAC,SAAS,OAAO;CAErB,IAAI,OAAQ,QAAoB,QAAQ,YAAY;EAClD,MAAM,IAAI;EACV,OAAO,yBAAyB,MAAM,SAAS,UAAU,EAAE,IAAI,IAAI,CAAC,CAAC;CACvE;CAEA,MAAM,SAAS;CACf,MAAM,6BAAa,IAAI,IAAqB;CAC5C,KAAK,MAAM,OAAO,OAAO,KAAK,MAAM,GAClC,WAAW,IAAI,IAAI,YAAY,GAAG,OAAO,IAAI;CAE/C,OAAO,yBAAyB,MAAM,SAAS,UAAU,WAAW,IAAI,IAAI,CAAC,CAAC;AAChF;AAEA,MAAM,2BAA2B;AAEjC,SAAS,WAAW,SAA4C,MAAkC;CAChG,IAAI,OAAQ,QAAoB,QAAQ,YACtC,OAAQ,QAAoB,IAAI,IAAI,KAAK;CAE3C,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAkC,GAAG;EAC7E,IAAI,IAAI,YAAY,MAAM,MAAM;EAChC,IAAI,MAAM,QAAQ,KAAK,GAAG,OAAO,MAAM,KAAK,IAAI;EAChD,OAAO,OAAO,UAAU,WAAW,QAAQ;CAC7C;AAEF;AAEA,SAAS,kBAAkB,GAAoB;CAC7C,OAAO,MAAM,OAAO,MAAM,OAAO,MAAM,OAAO,MAAM,OAAO,MAAM;AACnE;AAGA,SAAS,aAAa,OAAwB;CAC5C,IAAI,cAAc;CAClB,IAAI,SAAS;CACb,IAAI,UAAU;CACd,KAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;EACrC,MAAM,IAAI,MAAM;EAChB,IAAI,QAAQ;GACV,IAAI,SAAS,UAAU;QAClB,IAAI,MAAM,MAAM,UAAU;QAC1B,IAAI,MAAM,MAAK,SAAS;GAC7B;EACF;EACA,IAAI,aAAa;GACf,IAAI,MAAM,OAAO,MAAM,KAAM;GAC7B,IACE,MAAM,WAAW,OAAO,CAAC,MACxB,IAAI,MAAM,MAAM,UAAU,kBAAkB,MAAM,IAAI,EAAE,IAEzD,OAAO;GAET,cAAc;EAChB;EACA,IAAI,MAAM,MAAK,SAAS;OACnB,IAAI,MAAM,KAAK,cAAc;CACpC;CACA,OAAO;AACT;AAEA,SAAS,oBAAoB,SAA0B;CACrD,MAAM,SAAS,QAAQ,QAAQ,MAAM,GAAG,CAAC,CAAC,QAAQ,MAAM,GAAG;CAC3D,MAAM,SAAS,KAAK,SAAS,IAAI,QAAQ,IAAK,OAAO,SAAS,KAAM,CAAC,CAAC;CACtE,MAAM,QAAQ,WAAW,KAAK,SAAS,OAAO,GAAG,WAAW,CAAC,CAAC;CAC9D,OAAO,KAAK,MAAM,IAAI,YAAY,CAAC,CAAC,OAAO,KAAK,CAAC;AACnD;AAEA,SAAS,8BAA8B,SAA2B;CAChE,IAAI,OAAO,YAAY,YAAY,YAAY,MAAM,OAAO;CAC5D,IAAI,QAAQ,SAAS,OAAO;CAC5B,MAAM,OAAQ,QAA+B;CAC7C,OAAO,MAAM,QAAQ,IAAI,KAAK,KAAK,SAAS,sBAAsB;AACpE;AAIA,SAAS,eAAe,OAAwB;CAC9C,MAAM,QAAQ,MAAM,MAAM,GAAG;CAC7B,IAAI,MAAM,WAAW,KAAK,MAAM,MAAM,SAAS,KAAK,WAAW,CAAC,GAAG,OAAO;CAC1E,IAAI,MAAM,EAAE,CAAC,SAAS,0BAA0B,OAAO;CACvD,IAAI;EACF,OAAO,8BAA8B,oBAAoB,MAAM,EAAE,CAAC;CACpE,QAAQ;EACN,OAAO;CACT;AACF;;AAGA,SAAgB,2BACd,SACS;CACT,IAAI,CAAC,SAAS,OAAO;CACrB,KAAK,MAAM,QAAQ,CAAC,mBAAmB,WAAW,GAAG;EACnD,MAAM,QAAQ,WAAW,SAAS,IAAI;EACtC,IAAI,SAAS,aAAa,KAAK,GAAG,OAAO;CAC3C;CACA,IAAI,8BAA8B,OAAO,GAAG,OAAO;CAEnD,MAAM,SADgB,WAAW,SAAS,eACf,CAAC,EAAE,MAAM,kBAAkB;CACtD,OAAO,WAAW,QAAQ,WAAW,UAAa,eAAe,OAAO,EAAE;AAC5E;;;;;;;;;ACvIA,MAAa,0BAA0B;;;;;;;;;;;;;;;;;;ACUvC,MAAa,4BAA4B;;;;;;;;;AAUzC,MAAa,0BAA0B"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"registered-sid-D6KCaT1E.d.mts","names":[],"sources":["../src/utils/verification.ts","../src/mcpi/delegation-headers.ts","../src/mcpi/anonymous-principal.ts","../src/mcpi/registered-sid.ts"],"mappings":";KAIY;cA8BC;WAAA;WAAA;;cAOA;WAAA;WAAA;;iBAQG,uBAAuB;iBAKvB,kBAAkB;iBAsBlB,yBAAyB,qCACvC,OAAO,IACN,WAAW,yBAAyB;iBAavB,oBAAoB,qCAClC,OAAO,IACN,WAAW,oBAAoB;iBAOlB,iCAAiC,QAAQ;iBA2BzC,2BAA2B,QAAQ;iBAwBnC,6BAA6B,QAAQ;iBAQrC,yBACd,QAAQ,oBACR;;;cC9IW;iBAgBG,8BACd,SAAS,UAAU;iBA4FL,2BACd,SAAS,UAAU;;;cC5HR;;;cCUA;cAUA"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"registered-sid-D6KCaT1E.d.ts","names":[],"sources":["../src/utils/verification.ts","../src/mcpi/delegation-headers.ts","../src/mcpi/anonymous-principal.ts","../src/mcpi/registered-sid.ts"],"mappings":";KAIY;cA8BC;WAAA;WAAA;;cAOA;WAAA;WAAA;;iBAQG,uBAAuB;iBAKvB,kBAAkB;iBAsBlB,yBAAyB,qCACvC,OAAO,IACN,WAAW,yBAAyB;iBAavB,oBAAoB,qCAClC,OAAO,IACN,WAAW,oBAAoB;iBAOlB,iCAAiC,QAAQ;iBA2BzC,2BAA2B,QAAQ;iBAwBnC,6BAA6B,QAAQ;iBAQrC,yBACd,QAAQ,oBACR;;;cC9IW;iBAgBG,8BACd,SAAS,UAAU;iBA4FL,2BACd,SAAS,UAAU;;;cC5HR;;;cCUA;cAUA"}