{"_id":"@agentpulselabs/platform-sdk","name":"@agentpulselabs/platform-sdk","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@agentpulselabs/platform-sdk","version":"0.1.0","description":"Thin, PUBLIC host SDK for AgentPulse feature apps — the Platform.* type contract (generated from platform/appHost.js JSDoc) + the §11A promote-list re-exports. The REAL Platform instance is injected at runtime by the host (register(Platform)); this packag","type":"module","license":"MIT","main":"./index.js","types":"./index.d.ts","exports":{".":{"types":"./index.d.ts","default":"./index.js"}},"publishConfig":{"access":"public"},"peerDependencies":{"@agentpulse/platform":"*"},"peerDependenciesMeta":{"@agentpulse/platform":{"optional":true}},"devDependencies":{"@agentpulse/platform":"*"},"_id":"@agentpulselabs/platform-sdk@0.1.0","_nodeVersion":"24.18.0","_npmVersion":"11.16.0","dist":{"integrity":"sha512-EXxlpx2C0l5W4+S3GZEQPE56bHXkDG3qRfrOqQ1JU8wgjt3gQcMVixgfS/hW6Rgi8e/gjfZOlgwapHSymE32HA==","shasum":"5830d4d0cef134617bc61e45f21fa6fe43b267cb","tarball":"https://registry.npmjs.org/@agentpulselabs/platform-sdk/-/platform-sdk-0.1.0.tgz","fileCount":4,"unpackedSize":13741,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCID7ctQolYhKg0XNgHwMYRnmxIN/J/H4K3F1GUghuYpYSAiB2FrpiaObz8VWBdwmOFKN4ca/mN/iJngWPr7i1vj7rRg=="}]},"_npmUser":{"name":"ashishcloud","email":"ashishsujaka@gmail.com"},"directories":{},"maintainers":[{"name":"ashishcloud","email":"ashishsujaka@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/platform-sdk_0.1.0_1787034112527_0.5119098134314517"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-18T06:21:52.345Z","0.1.0":"2026-08-18T06:21:52.665Z","modified":"2026-08-18T06:21:52.929Z"},"maintainers":[{"name":"ashishcloud","email":"ashishsujaka@gmail.com"}],"description":"Thin, PUBLIC host SDK for AgentPulse feature apps — the Platform.* type contract (generated from platform/appHost.js JSDoc) + the §11A promote-list re-exports. The REAL Platform instance is injected at runtime by the host (register(Platform)); this packag","license":"MIT","readme":"# @agentpulselabs/platform-sdk\n\nThe thin, public AgentPulse platform SDK for feature apps.\n\nThis package ships **types only + pure forwarding re-exports** — it contains **no platform runtime\nimplementation**. It is:\n\n- `index.d.ts` — the `Platform.*` type contract (generated from `platform/appHost.js`'s JSDoc) that\n  describes the object every app's `register(Platform)` receives at boot.\n- `index.js` — a handful of pure `export { X } from '@agentpulse/platform/...'` re-exports (the §11A\n  promote-list): base classes / capabilities / route-middleware / helpers apps call directly, so an\n  app never has to deep-import `@agentpulse/platform/<internal-path>` itself.\n\n## How apps consume it\n\n```json\n{\n  \"peerDependencies\": { \"@agentpulselabs/platform-sdk\": \"^0\" },\n  \"devDependencies\":  { \"@agentpulselabs/platform-sdk\": \"^0\" }\n}\n```\n\n- **peerDependency** — the real `Platform` instance is **host-provided**: the AgentPulse platform\n  injects it at runtime via `register(Platform)`. Nothing in this package is bundled into an app;\n  installing it only gets you types + the thin re-export shims.\n- **devDependency** — for IDE autocomplete / type-checking during local development. Apps never run\n  the platform locally (local = tools; the runtime is the hosted dev-org/staging/prod platform).\n\n```js\nimport { JobHandler, requireScope, decorateActors } from '@agentpulselabs/platform-sdk';\n```\n\n## What this is NOT\n\n- **Not a runtime.** The underlying `@agentpulse/platform` package that backs every re-export here is\n  **host-provided and never published** — it is not a dependency an app installs to get working code;\n  the host supplies the implementation at boot.\n- **Not a bundle of platform internals.** Only the deliberate §11A promote-list surface is re-exported\n  (see `scripts/lib/appHostSurface.mjs` `PROMOTE_LIST` in the platform monorepo) — a small, reviewed\n  set of symbols apps legitimately call, not the whole `@agentpulse/platform` tree.\n\nRegenerate with `npm run sdk:generate:app-sdk` from the platform monorepo; see\n`docs/DESIGN_app-sdk-thin-package.md` there for the full design.\n","readmeFilename":"README.md","_rev":"1-69aa423232b5900421c7fce8aa8691a9"}