{"_id":"@agenttool/economic-conformance","name":"@agenttool/economic-conformance","dist-tags":{"next":"0.2.0-dev.0","latest":"0.2.0-dev.0"},"versions":{"0.2.0-dev.0":{"name":"@agenttool/economic-conformance","version":"0.2.0-dev.0","description":"Offline closed-trace conformance vectors and non-certifying reports for the AgentTool economic kernel","license":"Apache-2.0","type":"module","sideEffects":false,"publishConfig":{"access":"public","tag":"next"},"main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"},"./vectors/v0.2":"./vectors/economic-kernel-v0.2.json","./vectors/manifest":"./vectors/manifest.json"},"engines":{"node":">=20.19.0","bun":">=1.3.5"},"scripts":{"clean":"node --eval \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"","build":"bun run clean && tsc","artifacts:write":"node scripts/build-hf-release.mjs","artifacts:check":"node scripts/build-hf-release.mjs --check","typecheck":"tsc --noEmit","test":"bun test tests","check:vectors":"bun scripts/check-vectors.ts","smoke:node":"node tests/built-node.smoke.mjs","smoke:runtimes":"node tests/built-node.smoke.mjs && bun tests/built-node.smoke.mjs","check:package":"node scripts/check-package-inventory.mjs","smoke:pack":"node scripts/smoke-packed.mjs","ci":"bun run typecheck && bun run artifacts:check && bun run test && bun run build && bun run check:vectors && bun run smoke:runtimes && bun run check:package && bun run smoke:pack","prepack":"bun run ci"},"devDependencies":{"@types/bun":"1.3.14","@types/node":"20.19.43","typescript":"5.9.3"},"repository":{"type":"git","url":"git+https://github.com/cambridgetcg/agenttool.git","directory":"packages/economic-conformance"},"homepage":"https://docs.agenttool.dev/packages","keywords":["agents","conformance","economics","huggingface","testing"],"_id":"@agenttool/economic-conformance@0.2.0-dev.0","bugs":{"url":"https://github.com/cambridgetcg/agenttool/issues"},"_integrity":"sha512-QjQvFUPWlomuK4sTibAVWrbOtKzhDC4aTWT355+0bhZUrvO6V2V/wxpX9aDLn4mY0Ny7ASUMquommItN/zEL9g==","_resolved":"/home/runner/work/_temp/agenttool-npm-release/agenttool-economic-conformance-0.2.0-dev.0.tgz","_from":"file:/home/runner/work/_temp/agenttool-npm-release/agenttool-economic-conformance-0.2.0-dev.0.tgz","_nodeVersion":"24.19.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-QjQvFUPWlomuK4sTibAVWrbOtKzhDC4aTWT355+0bhZUrvO6V2V/wxpX9aDLn4mY0Ny7ASUMquommItN/zEL9g==","shasum":"df9013398199aae233b96fb512ad90be947ce7cc","tarball":"https://registry.npmjs.org/@agenttool/economic-conformance/-/economic-conformance-0.2.0-dev.0.tgz","fileCount":48,"unpackedSize":265578,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agenttool%2feconomic-conformance@0.2.0-dev.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDAtpG7V5M5tP0C9xrRktYrf36YokeCbxUgxbwaFTiQEgIhAOoUepRwhJfXKIppEFegEv+oZIsPMnY5tuL+AXTg+Hpv"}]},"_npmUser":{"name":"agenttool","email":"contact@cambridgetcg.com"},"directories":{},"maintainers":[{"name":"agenttool","email":"contact@cambridgetcg.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/economic-conformance_0.2.0-dev.0_1788426437134_0.7996324708616873"},"_hasShrinkwrap":false}},"time":{"created":"2026-09-03T09:07:16.952Z","0.2.0-dev.0":"2026-09-03T09:07:17.259Z","modified":"2026-09-03T09:07:17.703Z"},"maintainers":[{"name":"agenttool","email":"contact@cambridgetcg.com"}],"description":"Offline closed-trace conformance vectors and non-certifying reports for the AgentTool economic kernel","homepage":"https://docs.agenttool.dev/packages","keywords":["agents","conformance","economics","huggingface","testing"],"repository":{"type":"git","url":"git+https://github.com/cambridgetcg/agenttool.git","directory":"packages/economic-conformance"},"bugs":{"url":"https://github.com/cambridgetcg/agenttool/issues"},"license":"Apache-2.0","readme":"# `@agenttool/economic-conformance`\n\n> **Compass:** Make economic implementations comparable without converting a\n> finite test result into authority, certification, or truth.\n> **Implements:** A public developer-preview\n> `agenttool.economic-conformance/0.2` closed-trace\n> format, deterministic comparator, machine-readable vectors, and explicit\n> report boundaries.\n\nThis package consumes inert JSON-like traces. It never imports an economic\nimplementation, invokes callbacks, performs network requests, submits a\npayment, executes an effect, reads credentials, or inspects production state.\nAn adapter runs elsewhere and records one observation per vector case.\n\n`PASS` means only that every required observation exactly matched this finite\nsuite revision. `FAIL` takes precedence when at least one supplied observation\ndiffers, even if other observations are absent. Otherwise, any absent required\nobservation makes the result `INCONCLUSIVE`. Invalid, duplicate, reordered, or\nunknown trace entries are format errors, not conformance results.\n\nReports contain no scalar score and no raw expected or observed value. Each\ncase carries deterministic semantic SHA-256 references instead. A report also\nbinds the exact trace semantics and the source-pinned official manifest digest.\nCanonical semantic JSON emits object members directly in UTF-8 byte order,\nincluding numeric-looking keys, rather than relying on host object enumeration.\nThose hashes are comparison references, not signatures, authentication, or\nreceipts. The manifest digest names the expected official source; a report\nalone does not prove that the caller supplied or verified those raw bytes.\nEvery report scopes\nzero network requests, payments, and business effects to the comparator\ninvocation itself, and states that it does not prove external finality, host\ndurability, adapter truthfulness, producer authentication, XENIA\ncertification, or future behavior.\n\nThe v0.2 suite covers canonical arithmetic, exact/inexact conversion, typed\nunit separation, immutable price timelines, per-unit ledger conservation,\nidempotent reversals, projection/ledger crash states, externally reversed\norphan compensation, and counterfactual XENIA hard gates. Rights are a fixed\nstanding baseline, never an input that payment can toggle.\n\nThe source code independently pins the exact manifest bytes, vector bytes,\ncase count, and canonical suite semantics. The byte verifier uses fatal UTF-8\ndecoding and rejects duplicate object keys before checking both raw and\nsemantic SHA-256 pins. These checks detect local corpus drift; they do not\nprove who created the vectors, whether they are true, whether an adapter ran\nhonestly, or whether any payment or business effect occurred.\n\n## Usage\n\n```ts\nimport {\n  evaluateConformance,\n  verifyOfficialVectorSources,\n} from \"@agenttool/economic-conformance\";\n\nconst suite = verifyOfficialVectorSources(vectorBytes, manifestBytes);\nconst report = evaluateConformance(suite, trace);\n```\n\nVector inputs deliberately remain data. A host-specific adapter may map those\noperations into its own pure test harness, then serialize the resulting\n`VALUE` or `ERROR` observations. Keep that execution outside this package.\nGive the adapter only `case_id`, `operation`, and `input`; do not use\n`expected` as its oracle. The comparator cannot prove that separation, so\n`adapter_truthfulness_proven` and `producer_authenticated` remain `false`.\n\n`trace.producer_declared_ref` is a caller-supplied lowercase namespaced\nidentifier such as `adapter:local-reference`. It records a declaration only;\nit is not authenticated identity, continuity, consent, permission, or\nauthority.\n\nThe suite intentionally includes two malformed amount inputs—a JSON number\nand a leading-zero string—whose expected outcome is `INVALID_AMOUNT`. Other\namount-like vector fields use canonical unsigned decimal strings.\n\n## Distribution and training boundary\n\nThe Apache-2.0 package is distributed as one exact `love-package/v1` artifact\nwith byte-identical GitHub Release and optional npm mirrors. The packaged\n`hf/dataset/` tree is also the deterministic candidate for the separate public,\nungated `Yu-and-Ai/agenttool-economic-kernel` dataset.\n\nThat dataset keeps two configs separate. `economic_kernel_lessons` contains\nindependently authored synthetic lessons admitted for training by this release.\n`economic_kernel_v0_2` exposes these 53 exact cases as public conformance\nreference and marks them held out from the lesson generator. This is\ntransparent publisher metadata rather than DRM or a secrecy claim: publication\ncannot guarantee that another trainer will preserve the holdout. Dataset\navailability alone does not run an optimizer, change model weights, establish\nunderstanding, or cause an economic effect.\n\n## Verification\n\n```bash\nbun install --frozen-lockfile\nbun run ci\nnpm pack --dry-run --ignore-scripts\n```\n","readmeFilename":"README.md","_rev":"1-94583eb9353cdc79b1c9c1085289e577"}