{"_id":"@aria_asi/harness-http-client","_rev":"5-8d933d1eb2507495c5f6d16237a1ee5b","name":"@aria_asi/harness-http-client","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.1":{"name":"@aria_asi/harness-http-client","version":"0.1.1","_id":"@aria_asi/harness-http-client@0.1.1","maintainers":[{"name":"hamzaibrahim1","email":"hibrahimrn@gmail.com"}],"dist":{"shasum":"8a30631bdc2cb7498a78b832656edd61fb8cbb3e","tarball":"https://registry.npmjs.org/@aria_asi/harness-http-client/-/harness-http-client-0.1.1.tgz","fileCount":14,"integrity":"sha512-KXhyKwyPADiaJAT9wp1eIeZL26b2BG7qXJfzVDCsuohvLsbaZ9pRIfi578TCQrI729T7R9cCvMoNR1mkxkhmrg==","signatures":[{"sig":"MEUCIQDRLL+LUif8NJjTCcuFsXk77vJJ1Bi+lj3wgHHQcs6hXwIgRsxqUZ0/VjBeheHAkcHDHiuVa+H0pX+0KcNVyUduD60=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":208940},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"e300c5e801e56902e1e11a4d3374f6fd5456c86a","private":false,"scripts":{"build":"tsc","typecheck":"tsc --noEmit","postinstall":"node scripts/install-skills.cjs"},"_npmUser":{"name":"hamzaibrahim1","email":"hibrahimrn@gmail.com"},"_npmVersion":"10.9.4","description":"HTTP client for Aria's canonical harness — injects live cognitive state + plan context into LLM calls. Full control plane with output validation, pre-action gates, 8-lens cognition, and garden memory.","directories":{},"_nodeVersion":"22.22.1","dependencies":{},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.0","@types/node":"^20.11.0"},"_npmOperationalInternal":{"tmp":"tmp/harness-http-client_0.1.1_1777424768692_0.3857401342255298","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@aria_asi/harness-http-client","version":"0.1.2","_id":"@aria_asi/harness-http-client@0.1.2","maintainers":[{"name":"hamzaibrahim1","email":"hibrahimrn@gmail.com"}],"bin":{"aria-governance-gate":"scripts/aria-governance-gate.mjs","aria-first-class-compliance":"scripts/aria-first-class-compliance.mjs","aria-write-deploy-justification":"scripts/aria-write-deploy-justification.mjs","aria-verify-deploy-justification":"scripts/aria-verify-deploy-justification.mjs"},"dist":{"shasum":"f17bf92094194ad28751c6f23074f637c451846a","tarball":"https://registry.npmjs.org/@aria_asi/harness-http-client/-/harness-http-client-0.1.2.tgz","fileCount":26,"integrity":"sha512-eiS1GyZgmkJyBTMxsaz5KJ4Ldj0ke9/RvyU8qQcjmXukvmSeK9jr6A7IUj1SHd1TvrIgnU7wEW5m+gratq1Sgw==","signatures":[{"sig":"MEQCIAb5bUa72v3FuDl5zz0PY2FWEgBkYya8NQBaA9S4hmPWAiAXWIxGNJZarosPN+nJWVA/iFG8ProM1QuphdR3C25Org==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":272159},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.js"}},"gitHead":"b9701b84e83c0a3f723c9875d2c3bd8fb75b5ddb","private":false,"scripts":{"build":"tsc","typecheck":"tsc --noEmit","postinstall":"node scripts/install-skills.cjs"},"_npmUser":{"name":"hamzaibrahim1","email":"hibrahimrn@gmail.com"},"_npmVersion":"10.9.4","description":"HTTP client for Aria's canonical harness — injects live cognitive state + plan context into LLM calls. Full control plane with output validation, pre-action gates, 8-lens cognition, and garden memory.","directories":{},"_nodeVersion":"22.22.1","dependencies":{},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.0","@types/node":"^20.11.0"},"_npmOperationalInternal":{"tmp":"tmp/harness-http-client_0.1.2_1777777073538_0.22969666559958912","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@aria_asi/harness-http-client","version":"0.1.3","private":false,"description":"HTTP client for Aria's canonical harness — injects live cognitive state + plan context into LLM calls. Full control plane with output validation, pre-action gates, 8-lens cognition, and garden memory.","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"type":"module","engines":{"node":">=20"},"main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.js"}},"bin":{"aria-governance-gate":"scripts/aria-governance-gate.mjs","aria-write-deploy-justification":"scripts/aria-write-deploy-justification.mjs","aria-verify-deploy-justification":"scripts/aria-verify-deploy-justification.mjs","aria-first-class-compliance":"scripts/aria-first-class-compliance.mjs"},"scripts":{"typecheck":"tsc --noEmit","build":"tsc","postinstall":"node scripts/install-skills.cjs"},"dependencies":{},"devDependencies":{"@types/node":"^20.11.0","typescript":"^5.4.0"},"_id":"@aria_asi/harness-http-client@0.1.3","gitHead":"527e643e9e9bdbb50f8b827dbe09bc6a601efb2d","_nodeVersion":"22.22.1","_npmVersion":"10.9.4","dist":{"integrity":"sha512-A4wHZ2/zR/aLofIBIRJiKI0DBpzy0eZ3n3ODW397L3heuVLebDtdXz5FS5vhJUDzJhKz7Ree4W2sGegrvfL08g==","shasum":"b6f2d50d110b74e5da44c913bff60d74605bcbce","tarball":"https://registry.npmjs.org/@aria_asi/harness-http-client/-/harness-http-client-0.1.3.tgz","fileCount":27,"unpackedSize":277786,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDS5OqBpcsTD9jzf4oKxX/9Q+JZi1AiBURQJ3Xxeau0aAiEAw5cH2HqpiZzK2rq2syL58SsZDC+weNdxOBDG0kmz6zE="}]},"_npmUser":{"name":"hamzaibrahim1","email":"hibrahimrn@gmail.com"},"directories":{},"maintainers":[{"name":"hamzaibrahim1","email":"hibrahimrn@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/harness-http-client_0.1.3_1777779736201_0.7983975303630944"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-29T01:06:08.562Z","modified":"2026-05-03T03:42:16.465Z","0.1.1":"2026-04-29T01:06:08.839Z","0.1.2":"2026-05-03T02:57:53.682Z","0.1.3":"2026-05-03T03:42:16.355Z"},"description":"HTTP client for Aria's canonical harness — injects live cognitive state + plan context into LLM calls. Full control plane with output validation, pre-action gates, 8-lens cognition, and garden memory.","maintainers":[{"name":"hamzaibrahim1","email":"hibrahimrn@gmail.com"}],"readme":"# Aria Harness HTTP Client\n\n## What This Is\n\n`@aria_asi/harness-http-client` is the small SDK and runtime discipline pack that binds an LLM, agent, CLI, worker, or app to Aria's harness control plane.\n\nIt is not a prompt template. It gives the model the right context at the start of work, checks risky actions before they run, validates output before completion claims, and writes outcomes back so the next context window learns from what happened.\n\n## Customer Mental Model\n\nThe harness works as a control plane around your model:\n\n1. The model stays the renderer and executor for the current turn.\n2. Aria provides continuity, doctrine, memory, decision rules, and quality gates.\n3. The SDK fetches the live harness packet and injects it into the model's working context.\n4. The SDK checks actions before they mutate state.\n5. The SDK validates outputs before the model claims work is complete.\n6. The SDK writes governance outcomes back to Garden memory so future turns start smarter.\n\nThis lets a short-context model behave like it has persistent memory and operational discipline without pretending the model weights remembered anything.\n\n## LLM Session Learning Contract\n\nEvery harness-bound session should learn this file before the first non-trivial action and after any context reset, compaction, gate block, or repeated drift.\n\nRequired session-start order:\n\n1. Read the surface-specific `ARIA_MUST_READ.md` file if present.\n2. Read this README or the installed copy at `~/.aria/HARNESS_README.md`.\n3. Fetch a live harness packet with `getHarnessPacket()` or `getBoundHarnessAndPrompt()`.\n4. Hydrate Garden continuity with `hydrateGardenContinuity()` or `runWithGovernance()`.\n5. Proceed only after the model can state the current goal, constraints, evidence already known, and next measurable predicate.\n\nRequired context-refresh triggers:\n\n1. A new context window starts.\n2. The assistant is compacted or summarized.\n3. A governance, skill, action, or output gate blocks.\n4. The task crosses from planning into mutation, deploy, publish, or customer-facing reporting.\n5. The assistant discovers a defect, missing evidence, or package/runtime drift.\n6. More than one substantial tool sequence has happened since the last harness packet.\n\nDuring a long turn, refresh learning at phase boundaries instead of relying on stale memory. The safe loop is: read current obligation state, fetch or reuse a fresh-enough harness packet, run the next action, validate the result, then write the outcome.\n\n## Core APIs\n\n```ts\nimport {\n  HTTPHarnessClient,\n  getBoundHarnessAndPrompt,\n  runWithGovernance,\n} from '@aria_asi/harness-http-client';\n```\n\nUse `HTTPHarnessClient` when you need direct control over packet fetches, action checks, output validation, Garden continuity, or governance outcome writes.\n\nUse `runWithGovernance()` when you want one wrapper to hydrate continuity, run a cognition-bound action, validate output, and persist the result.\n\n## Minimum Correct Integration\n\nA consumer is harness-bound only when all of these are true:\n\n1. It fetches and injects a live harness packet before non-trivial model work.\n2. It checks risky actions before executing them.\n3. It validates output before completion claims.\n4. It records discovered obligations until fixed and verified.\n5. It writes outcomes back to Garden or an equivalent durable governance ledger.\n\nPacket injection alone is not enough. A package that only prepends context but never gates actions or validates output is not fully harness-bound.\n\n## Installed Runtime Files\n\nWhen installed, the package writes universal runtime guidance and CLIs under `~/.aria`:\n\n1. `~/.aria/ARIA_MUST_READ.md` gives the shortest mandatory startup contract.\n2. `~/.aria/HARNESS_README.md` is the customer and LLM learning guide copied from this README.\n3. `~/.aria/bin/aria-governance-gate` blocks unresolved obligations and missing doctrine-triggered skills.\n4. `~/.aria/bin/aria-write-deploy-justification` and `~/.aria/bin/aria-verify-deploy-justification` provide runtime-agnostic deploy justification.\n5. `~/.aria/bin/aria-first-class-compliance` checks first-class runtime surface contracts.\n\nSurfaces such as Codex and OpenCode also receive their own `ARIA_MUST_READ.md` copy when their config directories exist.\n\n## Customer Setup\n\n```sh\nnpm install @aria_asi/harness-http-client\n```\n\nSet these environment variables for a private control plane:\n\n```sh\nARIA_RUNTIME_URL=https://harness.yourcompany.com\nARIA_HARNESS_TOKEN=<tenant-or-owner-token>\n```\n\nThen wire the SDK into your agent loop or use the packaged governance CLIs from hooks.\n\n## Operational Rule\n\nTruth beats smoothness. If the harness blocks, the correct response is to load the missing learning, fix the source issue, or record and resolve the obligation. Do not weaken the gate, remove the field, strip the output, or claim readiness without evidence.\n","readmeFilename":"README.md"}