@kya-os/checkpoint-wasm-runtime 1.4.1 → 1.4.3

package/CHANGELOG.md

@@ -1,5 +1,114 @@
 # @kya-os/checkpoint-wasm-runtime
 
+## 1.4.3 — 2026-05-18
+
+**Second recovery release. Do NOT use 1.4.1 OR 1.4.2 — both shipped
+broken tarballs missing `wasm/kya-os-engine/*` (nodejs target) and
+`wasm/kya-os-engine-web/*` (web target). Consumers crash on import
+with `ERR_MODULE_NOT_FOUND` (or `FUNCTION_INVOCATION_FAILED` on
+Vercel).**
+
+### What 1.4.2 got wrong (and 1.4.3 fixes)
+
+The 1.4.2 recovery was supposed to fix the missing-artifact bug from
+1.4.1 by building all three wasm targets before publish. The local
+build DID produce all the artifact files on disk — but the tarball
+still shipped only `README.md` in those subdirs.
+
+Root cause: **`wasm-pack build` writes a `.gitignore` containing `*`
+into every `--out-dir`.** `pnpm pack` (and `npm pack`) honour nested
+`.gitignore` patterns when filtering tarball contents, so every just-
+built `.wasm` + `.js` + `.d.ts` gets filtered OUT of the tarball at
+pack time. Only `README.md` survives because npm has a hardcoded rule
+to always include READMEs. The 1.4.2 publish flow had no gate that
+inspected tarball contents post-pack, so the broken state shipped
+silently for a second time.
+
+### What 1.4.3 ships
+
+Same TS + Rust changes as 1.4.1/1.4.2 (no code regression). New
+defenses:
+
+- `rust/scripts/build-engine-wasm.sh` now `rm -f`s the wasm-pack-
+  generated `.gitignore` from each `--out-dir` post-build. The poison
+  files can't reach `pnpm pack` from a clean local-dev publish.
+- `packages/checkpoint-wasm-runtime` `copy-engine-wasm-bundler` npm
+  script chains a matching `rm -f` for the bundler target.
+- New CI workflow `.github/workflows/publish-wasm-runtime.yml`:
+  builds all three targets in-runner, defuses the `.gitignore` poison
+  before pack, packs the tarball, **asserts the required `.wasm` +
+  `.js` paths are inside the tarball before publish**, and **re-
+  fetches the published tarball from npm post-publish and re-runs the
+  same assertions** to catch registry-side mutations. After a
+  successful publish, the workflow dispatches a `repository_dispatch`
+  event to `checkpoint-customers` so its bench fixture's lockfile can
+  be auto-bumped.
+
+This is the gate 1.4.1 + 1.4.2 would have failed. Future broken
+tarballs can't reach the registry.
+
+### Migration
+
+Upgrade `@kya-os/checkpoint-wasm-runtime` from `1.4.1` or `1.4.2` to
+`1.4.3`. Both poisoned versions will be deprecated on npm with a
+"Broken tarball — upgrade to 1.4.3" message after this release lands.
+
+---
+
+## 1.4.2 — 2026-05-18
+
+**Recovery release. Do NOT use 1.4.1 — it was published with a broken
+tarball that ships only `wasm/kya-os-engine-bundler/*` and is missing
+`wasm/kya-os-engine/*` (nodejs target) + `wasm/kya-os-engine-web/*`
+(web target) entirely. Consumers using the `./engine`,
+`./engine/node`, `./orchestrator`, or `./orchestrator/node` subpaths
+crash on import with `ERR_MODULE_NOT_FOUND` (or
+`FUNCTION_INVOCATION_FAILED` on Vercel).**
+
+### What 1.4.1 should have shipped
+
+1.4.1 was a patch release bundling two fixes on top of 1.4.0:
+
+- **#2659** — split anthropic vendor pattern into 3 per-bot entries
+  (`anthropic_claude_user`, `anthropic_claudebot`,
+  `anthropic_claude_web`). Updates the Tier-3 ruleset hash.
+- **#2663** — `httpStatusForBlockReason` + `blockResponseBody`
+  switches gained `Tier3UAMatch` and `AgentAttribution` cases (were
+  falling through to `undefined` status → Express default 500
+  error page). Adds the matching variants to the TS `BlockReason`
+  union (with snake_case `pattern_id` / `pattern_kind` matching the
+  Rust serde wire format).
+
+### Root cause of the broken 1.4.1 tarball
+
+`prepublishOnly` chains `copy-engine-wasm` (nodejs target) +
+`copy-engine-wasm-web` (web target) + `copy-engine-wasm-bundler`
+(bundler target). Each script `cp`s from `rust/crates/kya-os-engine/
+pkg{,-web,-bundler}/` into `packages/checkpoint-wasm-runtime/wasm/`.
+The publish was invoked from a fresh `git reset --hard origin/main`
+state with **only `wasm-pack build --target bundler`** run before
+publish — `pkg/` (nodejs) and `pkg-web/` (web) were empty. The cp
+commands silently produced empty target dirs (`wasm/kya-os-engine/`
+
+- `wasm/kya-os-engine-web/`) populated only with the git-committed
+  `README.md` placeholders, and the tarball shipped that state.
+
+### What 1.4.2 ships
+
+Identical TS + Rust changes to 1.4.1 (no code regression) but with
+the full wasm artifact set (`wasm/kya-os-engine/`,
+`wasm/kya-os-engine-web/`, `wasm/kya-os-engine-bundler/`) verified
+present before publish.
+
+### Hardening (separate dylan-todo to follow)
+
+`prepublishOnly` should fail-fast when any of the three artifact
+dirs is missing rather than producing an empty-but-existing dir.
+Filing as `Engine-WASM-Publish-Sanity-Gate-1` so the next regen
+can't ship the same shape of partial tarball silently.
+
+---
+
 ## 1.4.0 — 2026-05-18
 
 **Minor release** consolidating SDK-Next.js-Integration-Audit-1

package/dist/engine.d.mts

@@ -35,9 +35,9 @@ export { DetectionDetail, McpIPayload } from '@kya-os/checkpoint-shared';
  *      detection probes — bundler entry runs the same JS in every
  *      runtime; no detection needed.
  *
- * Consumers that don't use a bundler (raw Node + ESM, no transpile)
- * should use the explicit `./node` subpath which keeps the
- * `--target nodejs` artifact and its band-aids.
+ * Node consumers are routed to the Node-safe bridge via the package
+ * exports `"node"` condition on `./engine`; the generic bundler bridge
+ * remains the default for bundlers that do not request Node resolution.
  */
 
 /**

package/dist/engine.d.ts

@@ -35,9 +35,9 @@ export { DetectionDetail, McpIPayload } from '@kya-os/checkpoint-shared';
  *      detection probes — bundler entry runs the same JS in every
  *      runtime; no detection needed.
  *
- * Consumers that don't use a bundler (raw Node + ESM, no transpile)
- * should use the explicit `./node` subpath which keeps the
- * `--target nodejs` artifact and its band-aids.
+ * Node consumers are routed to the Node-safe bridge via the package
+ * exports `"node"` condition on `./engine`; the generic bundler bridge
+ * remains the default for bundlers that do not request Node resolution.
  */
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kya-os/checkpoint-wasm-runtime",
-  "version": "1.4.1",
+  "version": "1.4.3",
   "description": "Checkpoint WASM runtime for AI agent detection across all environments (formerly @kya-os/agentshield-wasm-runtime)",
   "keywords": [
     "ai",
@@ -55,6 +55,11 @@
         "types": "./dist/engine-edge.d.ts",
         "import": "./dist/engine-edge.mjs"
       },
+      "node": {
+        "types": "./dist/engine-node.d.ts",
+        "import": "./dist/engine-node.mjs",
+        "require": "./dist/engine-node.js"
+      },
       "types": "./dist/engine.d.ts",
       "import": "./dist/engine.mjs",
       "require": "./dist/engine.js"
@@ -122,26 +127,6 @@
   "engines": {
     "node": ">=18.0.0"
   },
-  "dependencies": {
-    "multiformats": "^13",
-    "@kya-os/checkpoint-shared": "1.1.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.11.24",
-    "@vitest/coverage-v8": "^1.3.1",
-    "rimraf": "^5.0.5",
-    "tsup": "^8.0.2",
-    "typescript": "^5.4.2",
-    "vite-plugin-top-level-await": "^1.6.0",
-    "vite-plugin-wasm": "^3.6.0",
-    "vitest": "^1.3.1"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "sideEffects": [
-    "./wasm/**/*.js"
-  ],
   "scripts": {
     "build": "tsup",
     "build:watch": "tsup --watch",
@@ -155,10 +140,31 @@
     "lint:fix": "eslint src --ext .ts,.tsx --fix",
     "format": "prettier --write \"src/**/*.{ts,tsx,json,md}\"",
     "format:check": "prettier --check \"src/**/*.{ts,tsx,json,md}\"",
+    "prepublishOnly": "pnpm copy-wasm && pnpm copy-engine-wasm && pnpm copy-engine-wasm-web && pnpm copy-engine-wasm-bundler && pnpm build && pnpm test",
     "copy-wasm": "mkdir -p ./wasm && cp ../../rust/crates/agentshield-wasm/pkg/agentshield_wasm_bg.wasm ./wasm/",
     "copy-engine-wasm": "mkdir -p ./wasm/kya-os-engine && cp ../../rust/crates/kya-os-engine/pkg/kya_os_engine_bg.wasm ../../rust/crates/kya-os-engine/pkg/kya_os_engine_bg.wasm.d.ts ../../rust/crates/kya-os-engine/pkg/kya_os_engine.d.ts ../../rust/crates/kya-os-engine/pkg/kya_os_engine.js ./wasm/kya-os-engine/",
     "copy-engine-wasm-web": "mkdir -p ./wasm/kya-os-engine-web && cp ../../rust/crates/kya-os-engine/pkg-web/kya_os_engine_bg.wasm ../../rust/crates/kya-os-engine/pkg-web/kya_os_engine_bg.wasm.d.ts ../../rust/crates/kya-os-engine/pkg-web/kya_os_engine.d.ts ../../rust/crates/kya-os-engine/pkg-web/kya_os_engine.js ./wasm/kya-os-engine-web/",
-    "copy-engine-wasm-bundler": "mkdir -p ./wasm/kya-os-engine-bundler && cp ../../rust/crates/kya-os-engine/pkg-bundler/kya_os_engine_bg.wasm ../../rust/crates/kya-os-engine/pkg-bundler/kya_os_engine_bg.wasm.d.ts ../../rust/crates/kya-os-engine/pkg-bundler/kya_os_engine_bg.js ../../rust/crates/kya-os-engine/pkg-bundler/kya_os_engine.d.ts ../../rust/crates/kya-os-engine/pkg-bundler/kya_os_engine.js ./wasm/kya-os-engine-bundler/",
+    "copy-engine-wasm-bundler": "mkdir -p ./wasm/kya-os-engine-bundler && cp ../../rust/crates/kya-os-engine/pkg-bundler/kya_os_engine_bg.wasm ../../rust/crates/kya-os-engine/pkg-bundler/kya_os_engine_bg.wasm.d.ts ../../rust/crates/kya-os-engine/pkg-bundler/kya_os_engine_bg.js ../../rust/crates/kya-os-engine/pkg-bundler/kya_os_engine.d.ts ../../rust/crates/kya-os-engine/pkg-bundler/kya_os_engine.js ./wasm/kya-os-engine-bundler/ && rm -f ./wasm/kya-os-engine-bundler/.gitignore",
     "wasm:rebuild": "bash ../../rust/scripts/build-engine-wasm.sh"
-  }
-}
+  },
+  "dependencies": {
+    "@kya-os/checkpoint-shared": "workspace:*",
+    "multiformats": "^13"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.24",
+    "@vitest/coverage-v8": "^1.3.1",
+    "rimraf": "^5.0.5",
+    "tsup": "^8.0.2",
+    "typescript": "^5.4.2",
+    "vite-plugin-top-level-await": "^1.6.0",
+    "vite-plugin-wasm": "^3.6.0",
+    "vitest": "^1.3.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": [
+    "./wasm/**/*.js"
+  ]
+}

package/wasm/kya-os-engine/kya_os_engine.d.ts

@@ -0,0 +1,24 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Cross-boundary `verify` wrapper. The JS host calls `engine.verify(input,
+ * ctxSpec)`; on success it gets a [`VerifyResult`] JSON object; on
+ * infrastructure failure (or malformed input) it gets a thrown JS error
+ * whose message names the failure mode.
+ *
+ * **Error semantics**:
+ *
+ * - Verification *verdicts* (Block/Challenge/etc.) surface inside the
+ *   returned `VerifyResult` — they are not thrown.
+ * - Engine [`VerifyError`][crate::error::VerifyError] (resolver / cache /
+ *   reputation / policy infra failures) surface as thrown JS errors.
+ * - Serde deserialisation failures (malformed JS input) surface as thrown
+ *   JS errors too, mirroring the typed-vs-thrown split.
+ *
+ * # JS signature
+ *
+ * ```ts
+ * function verify(input: AgentRequest, ctx: ContextSpec): VerifyResult;
+ * ```
+ */
+export function verify(input_js: any, ctx_js: any): any;