{"_id":"@ap3x/cadence","_rev":"2-64d6ca01edbce98699a80ce12514efaa","name":"@ap3x/cadence","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@ap3x/cadence","version":"0.1.0","license":"MIT","_id":"@ap3x/cadence@0.1.0","maintainers":[{"name":"botstack","email":"GuerrillaMedia702@gmail.com"}],"homepage":"https://github.com/AP3X-Dev/AP3X#readme","bugs":{"url":"https://github.com/AP3X-Dev/AP3X/issues"},"dist":{"shasum":"1bec1e4f547ee04d169ca0fd350c2ab3c5a398ec","tarball":"https://registry.npmjs.org/@ap3x/cadence/-/cadence-0.1.0.tgz","fileCount":24,"integrity":"sha512-t0uHtSUGhj5ORIGssSAc0Yy4Y7FJ+Kqr3ZKxYevtUQst1Vd04JZkFfO10Kb3YOjw7mmPoyyNX+YrQyadyoIMNA==","signatures":[{"sig":"MEQCIG/Vg2JTJn02H9LXr92KSkCpt1J6btXvAqTMer7P3u6XAiA5Q3zR51uhfUQgGfmX/kgSuyivLx/KsGnfyfc1WAHLTg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":61433},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"572dcf9cfde958270d2c9b5404aa5bc1dc2cbeea","scripts":{"test":"vitest run","build":"tsup src/index.ts --format esm --clean --tsconfig tsconfig.build.json && tsc -p tsconfig.build.json","prepublishOnly":"node ../../scripts/publish-gate.mjs"},"_npmUser":{"name":"botstack","email":"GuerrillaMedia702@gmail.com"},"repository":{"url":"git+https://github.com/AP3X-Dev/AP3X.git","type":"git","directory":"packages/cadence"},"_npmVersion":"11.5.1","description":"Durable scheduler — cron, interval, and one-shot jobs with exactly-once firing","directories":{},"_nodeVersion":"20.18.2","dependencies":{"cron-parser":"^4.9.0","@sinclair/typebox":"^0.34.49"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cadence_0.1.0_1785554973149_0.5118014713027048","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@ap3x/cadence","version":"0.1.1","description":"Durable scheduler — cron, interval, and one-shot jobs with exactly-once slot advance","repository":{"type":"git","url":"git+https://github.com/AP3X-Dev/AP3X.git","directory":"packages/cadence"},"license":"MIT","publishConfig":{"access":"public"},"type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"scripts":{"build":"tsup src/index.ts --format esm --clean --tsconfig tsconfig.build.json && tsc -p tsconfig.build.json","prepublishOnly":"node ../../scripts/publish-gate.mjs","test":"vitest run"},"dependencies":{"@sinclair/typebox":"^0.34.49","cron-parser":"^4.9.0"},"_id":"@ap3x/cadence@0.1.1","gitHead":"572dcf9cfde958270d2c9b5404aa5bc1dc2cbeea","bugs":{"url":"https://github.com/AP3X-Dev/AP3X/issues"},"homepage":"https://github.com/AP3X-Dev/AP3X#readme","_nodeVersion":"20.18.2","_npmVersion":"11.5.1","dist":{"integrity":"sha512-KTuM/V6arj4j2L5BwxZGiiTOOBo41zUrnNoA7rVOrmMGsld5VqCCWJAU0+lFYxgKG2QYBVhpGzcBjbK07F0UPQ==","shasum":"cbcd188a0ce3f659acfbca05e559b9991f126b35","tarball":"https://registry.npmjs.org/@ap3x/cadence/-/cadence-0.1.1.tgz","fileCount":24,"unpackedSize":62573,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCt5UQ9auNeesPjl/EwamqQ2h5ady5x0a10FpZMP2jpKgIhAOAoADCB1m9pSlLV4xH8dWdsE3tqmXw83srsVh77Qeln"}]},"_npmUser":{"name":"botstack","email":"GuerrillaMedia702@gmail.com"},"directories":{},"maintainers":[{"name":"botstack","email":"GuerrillaMedia702@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cadence_0.1.1_1785556973835_0.8295538840469061"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-01T03:29:32.996Z","modified":"2026-08-01T04:02:54.142Z","0.1.0":"2026-08-01T03:29:33.310Z","0.1.1":"2026-08-01T04:02:53.980Z"},"bugs":{"url":"https://github.com/AP3X-Dev/AP3X/issues"},"license":"MIT","homepage":"https://github.com/AP3X-Dev/AP3X#readme","repository":{"type":"git","url":"git+https://github.com/AP3X-Dev/AP3X.git","directory":"packages/cadence"},"description":"Durable scheduler — cron, interval, and one-shot jobs with exactly-once slot advance","maintainers":[{"name":"botstack","email":"GuerrillaMedia702@gmail.com"}],"readme":"# @ap3x/cadence\n\nA standalone durable scheduler: cron, interval, and one-shot jobs with exactly-once firing semantics and pluggable storage.\n\nPart of [AP3X](https://github.com/AP3X-Dev/AP3X) — a TypeScript multi-agent framework.\n\n## Install\n\n```bash\nnpm install @ap3x/cadence\n```\n\n## What's inside\n\n- **Schedules** — cron expressions, fixed intervals, and one-shot timers.\n- **Exactly-once slot advance** — claiming a due occurrence and advancing its slot happen in one\n  critical section, so a given occurrence is never fired twice by the running engine. A crash\n  *between* the two releases the claim, and the occurrence fires again on restart — the design\n  prefers re-firing over silently dropping a scheduled run.\n- **Durable across restarts** — state reloads from the store; in-flight attempts abandoned by a\n  crashed process are reclaimed and routed through the retry ladder.\n- **Overlap + misfire policies** — choose what happens when an occurrence comes due while the\n  previous attempt is still running (`allow`, `queue`, `skip_if_running`), and what to do with\n  occurrences missed while the engine was down.\n- **Pluggable stores** — in-memory and file-backed stores ship with the package, behind a store\n  interface with a conformance suite.\n- **Injectable clock** — no wall-clock reads in core, so schedules are testable deterministically.\n\n## Concurrency scope\n\nThe bundled stores hold their claim in process memory and rely on JavaScript's run-to-completion\nas the critical section. **Run one engine process per store directory** — multi-process exclusion\nis out of scope for the in-memory and file stores.\n\nThe `Store` interface is designed for it: a backend that can claim and advance in one transaction\n(a Postgres row lock, say) extends the same guarantee across processes. No such adapter ships here.\n\nDepends on no other `@ap3x` package.\n\n## Documentation\n\nSee the [AP3X repository](https://github.com/AP3X-Dev/AP3X) for architecture notes, the full package map, and examples.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}