{"_id":"@agent-arc-status/emitter","_rev":"3-44f92f22d84cfafa23f7a8e066f6e336","name":"@agent-arc-status/emitter","dist-tags":{"latest":"0.3.2"},"versions":{"0.3.0":{"name":"@agent-arc-status/emitter","version":"0.3.0","keywords":["agent","agents","ai","llm","observability","progress","arc-status"],"author":{"name":"Joe Fisher"},"license":"MIT","_id":"@agent-arc-status/emitter@0.3.0","maintainers":[{"name":"joethefisher","email":"joefisherpersonal@gmail.com"}],"homepage":"https://github.com/joethefisher/agent-arc-status#readme","bugs":{"url":"https://github.com/joethefisher/agent-arc-status/issues"},"dist":{"shasum":"2a3a8b6f4f1deb0019272eeec5f09c7c5368c5e7","tarball":"https://registry.npmjs.org/@agent-arc-status/emitter/-/emitter-0.3.0.tgz","fileCount":23,"integrity":"sha512-7vfalKfn84YSILAie2tlK/kZWeI6V+2jM4HhLpZ9zeBPUsnwoikRTFwfELafb0RZbLgh0VLKczEqETfPqcxzyg==","signatures":[{"sig":"MEUCIQCMDB9BHmSvLwR65LY/cTvhJoFHvNxE67zV8u8ThgP7OAIgASUWUtuWg4pORVpF5Dg6lzdR1SNtV116YCuLBAQ+z2Y=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agent-arc-status%2femitter@0.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":27277},"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":"421bf5c6179c005c98824c92cf49b065b1445e59","scripts":{"build":"tsc","typecheck":"tsc --noEmit"},"_npmUser":{"name":"joethefisher","email":"joefisherpersonal@gmail.com"},"repository":{"url":"git+https://github.com/joethefisher/agent-arc-status.git","type":"git","directory":"packages/emitter"},"_npmVersion":"10.9.8","description":"Batteries-included producer for the Agent Arc Status Protocol: guarantees started-first, done/blocked-on-exit, and an automatic silence backstop. Zero runtime dependencies.","directories":{},"_nodeVersion":"22.23.1","dependencies":{"@agent-arc-status/reference":"^0.3.0"},"publishConfig":{"access":"public","provenance":true},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/emitter_0.3.0_1783738319987_0.10120808920767166","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@agent-arc-status/emitter","version":"0.3.1","keywords":["agent","agents","ai","llm","observability","progress","arc-status"],"author":{"name":"Joe Fisher"},"license":"MIT","_id":"@agent-arc-status/emitter@0.3.1","maintainers":[{"name":"joethefisher","email":"joefisherpersonal@gmail.com"}],"homepage":"https://github.com/joethefisher/agent-arc-status#readme","bugs":{"url":"https://github.com/joethefisher/agent-arc-status/issues"},"dist":{"shasum":"84722e5fde8ac9a4ec10173b64fa59698e06e8c2","tarball":"https://registry.npmjs.org/@agent-arc-status/emitter/-/emitter-0.3.1.tgz","fileCount":23,"integrity":"sha512-rgnOalmkdA/7pu6xtVA1zJbi4IiCJrJBkycegAWJCBJ7JcVgxtAkd0kpzwMFUjEtvs6KE4mmFDXaFSkpP+iReA==","signatures":[{"sig":"MEUCIHVNs0RmZVRGJMo+DN8PqPvQvdJEecLAVLbMjbMM13jkAiEA0JXDc0I32NY0P8OnyAEtT4j2g3GLGn/OT8bQcoPK+54=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agent-arc-status%2femitter@0.3.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":27277},"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":"cff6c28c805bba4f15e9bea0ce43dcdc515ecf66","scripts":{"build":"tsc","typecheck":"tsc --noEmit"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:fda5994b-783b-4833-983e-8cd88f9f5e9e"}},"repository":{"url":"git+https://github.com/joethefisher/agent-arc-status.git","type":"git","directory":"packages/emitter"},"_npmVersion":"12.0.1","description":"Batteries-included producer for the Agent Arc Status Protocol: guarantees started-first, done/blocked-on-exit, and an automatic silence backstop. Zero runtime dependencies.","directories":{},"_nodeVersion":"22.23.1","dependencies":{"@agent-arc-status/reference":"^0.3.0"},"publishConfig":{"access":"public","provenance":true},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/emitter_0.3.1_1783740631881_0.3594209040520242","host":"s3://npm-registry-packages-npm-production"}},"0.3.2":{"name":"@agent-arc-status/emitter","version":"0.3.2","description":"Batteries-included producer for the Agent Arc Status Protocol: guarantees started-first, done/blocked-on-exit, and an automatic silence backstop. Zero runtime dependencies.","license":"MIT","author":{"name":"Joe Fisher"},"repository":{"type":"git","url":"git+https://github.com/joethefisher/agent-arc-status.git","directory":"packages/emitter"},"homepage":"https://github.com/joethefisher/agent-arc-status#readme","bugs":{"url":"https://github.com/joethefisher/agent-arc-status/issues"},"keywords":["agent","agents","ai","llm","observability","progress","arc-status"],"type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"publishConfig":{"access":"public","provenance":true},"scripts":{"build":"tsc","typecheck":"tsc --noEmit"},"engines":{"node":">=20"},"dependencies":{"@agent-arc-status/reference":"^0.3.0"},"gitHead":"541a2a2c6ea3a031354c5ecc744bce9a6fe5d75b","_id":"@agent-arc-status/emitter@0.3.2","_nodeVersion":"22.23.1","_npmVersion":"12.0.1","dist":{"integrity":"sha512-+NCCBuVmoVEjPuY98eXu5sE3fU3Ip0/fF8RwXWNuCZw9IOBt6qTRK9e5R85X5uFneM3tA6kATL2rwBoLzFuunw==","shasum":"8b5580e63af54af2837943801d87ac437972ad8d","tarball":"https://registry.npmjs.org/@agent-arc-status/emitter/-/emitter-0.3.2.tgz","fileCount":23,"unpackedSize":27277,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agent-arc-status%2femitter@0.3.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGIWpvgw9qFLm1E8Zc6PbtZvJK2JQqUbe2GEQfNjhgt2AiEAu4cSlrzSh+yytwCh5CNb4dKW0bUrl/2JLhqQh8XLJm0="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:fda5994b-783b-4833-983e-8cd88f9f5e9e"}},"directories":{},"maintainers":[{"name":"joethefisher","email":"joefisherpersonal@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/emitter_0.3.2_1783741380995_0.0331832193812327"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-11T02:51:59.836Z","modified":"2026-07-11T03:43:01.482Z","0.3.0":"2026-07-11T02:52:00.124Z","0.3.1":"2026-07-11T03:30:32.012Z","0.3.2":"2026-07-11T03:43:01.151Z"},"bugs":{"url":"https://github.com/joethefisher/agent-arc-status/issues"},"author":{"name":"Joe Fisher"},"license":"MIT","homepage":"https://github.com/joethefisher/agent-arc-status#readme","keywords":["agent","agents","ai","llm","observability","progress","arc-status"],"repository":{"type":"git","url":"git+https://github.com/joethefisher/agent-arc-status.git","directory":"packages/emitter"},"description":"Batteries-included producer for the Agent Arc Status Protocol: guarantees started-first, done/blocked-on-exit, and an automatic silence backstop. Zero runtime dependencies.","maintainers":[{"name":"joethefisher","email":"joefisherpersonal@gmail.com"}],"readme":"# @agent-arc-status/emitter\n\nA batteries-included **producer** for the [Agent Arc Status\nProtocol](https://github.com/joethefisher/agent-arc-status). It wraps the reference\n`CadenceController` and makes correct emission the default:\n\n- **`started` first, terminal last** — `run(fn)` emits `started` on entry and `done` on success or\n  terminal `blocked` on throw, so every stream it produces is `validateSequence`-clean.\n- **Automatic silence backstop** — a timer independent of the work loop (§5.2) fires a `heartbeat`\n  when the silence window would otherwise elapse.\n- **Best-effort transport** — a failed send goes to `onError`; status reporting never crashes the work.\n- **Zero runtime dependencies** — Node stdlib only.\n\n```ts\nimport { ArcEmitter, httpTransport } from \"@agent-arc-status/emitter\";\n\nconst arc = new ArcEmitter({\n  title: \"nightly: refresh customer health scores\",\n  arcKind: \"batch\",\n  transport: httpTransport({ url: process.env.ARC_STATUS_URL!, secret: process.env.ARC_STATUS_SECRET }),\n});\n\nawait arc.run(async (arc) => {\n  await arc.milestone(\"ingested 12k account records\", { step: 1, total: 4 });\n  // ... work ...\n  await arc.milestone(\"scored and persisted\", { step: 4, total: 4 });\n});\n// -> started, milestone, milestone, done  (all validated, heartbeats auto-filled)\n```\n\n## API\n\n- `new ArcEmitter(config)` — `{ title, transport, arcId?, arcKind?, cadence?, heartbeatActivity?,\n  tickIntervalMs?, onError? }`.\n- `start()`, `milestone(title, opts?)`, `heartbeat(title?, opts?)`, `blocked(title, opts?)`,\n  `done(title?, opts?)`, `isTerminal()`, `run(fn)`.\n- Transports: `httpTransport({ url, secret?, headers?, fetch? })` (webhook binding §8.1, optional\n  HMAC-SHA256) and `stdoutTransport({ write? })` (JSON Lines, §8.3). Implement `Transport` for others.\n\nEverything is injectable (`cadence.now`, `timer`, `transport`, `fetch`) for deterministic tests.\n","readmeFilename":"README.md"}