{"_id":"@agentctx/adapter-sdk","name":"@agentctx/adapter-sdk","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@agentctx/adapter-sdk","version":"0.1.0","description":"Public types and helpers for building agentctx adapters and consumers.","license":"MIT","author":{"name":"tasnuva-aif"},"homepage":"https://github.com/tasnuvaleeya/memory-synchronizer/tree/main/packages/adapter-sdk#readme","repository":{"type":"git","url":"git+https://github.com/tasnuvaleeya/memory-synchronizer.git","directory":"packages/adapter-sdk"},"bugs":{"url":"https://github.com/tasnuvaleeya/memory-synchronizer/issues"},"type":"module","publishConfig":{"access":"public"},"main":"./dist/index.js","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"dependencies":{"zod":"^3.23.8"},"devDependencies":{"@types/node":"^20.16.5","tsup":"^8.3.5","typescript":"^5.7.2","vitest":"^2.1.8"},"engines":{"node":">=20"},"scripts":{"build":"tsup","test":"vitest run","typecheck":"tsc --noEmit"},"_id":"@agentctx/adapter-sdk@0.1.0","_integrity":"sha512-9AJ6vkue494XD7yt7K42PLr60wTeqmd6cGoFIWtGUf1sPbU+twZW5Z/13kNpn2IrHw8kB6lkO+r1noaGiPkRXA==","_resolved":"/tmp/1f2a22825557131e913406ff68564d93/agentctx-adapter-sdk-0.1.0.tgz","_from":"file:agentctx-adapter-sdk-0.1.0.tgz","_nodeVersion":"22.22.2","_npmVersion":"10.9.7","dist":{"integrity":"sha512-9AJ6vkue494XD7yt7K42PLr60wTeqmd6cGoFIWtGUf1sPbU+twZW5Z/13kNpn2IrHw8kB6lkO+r1noaGiPkRXA==","shasum":"72e2ee64ecf2d1fbc3c766d76bfd82cb3e5694ec","tarball":"https://registry.npmjs.org/@agentctx/adapter-sdk/-/adapter-sdk-0.1.0.tgz","fileCount":9,"unpackedSize":52097,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIC42+TBN0Ov5IkDoZPUudgML6n65Le2Tjju26joH9Zf+AiAZeKDwwxIoj3AWsIfRnBS7vAWLC+SlmWcIWgMniW2WeQ=="}]},"_npmUser":{"name":"tasnuva.sikder","email":"tasnuva2606@gmail.com"},"directories":{},"maintainers":[{"name":"tasnuva.sikder","email":"tasnuva2606@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/adapter-sdk_0.1.0_1780243469645_0.0938853921866094"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-31T16:04:29.480Z","0.1.0":"2026-05-31T16:04:29.818Z","modified":"2026-05-31T16:04:30.048Z"},"maintainers":[{"name":"tasnuva.sikder","email":"tasnuva2606@gmail.com"}],"description":"Public types and helpers for building agentctx adapters and consumers.","homepage":"https://github.com/tasnuvaleeya/memory-synchronizer/tree/main/packages/adapter-sdk#readme","repository":{"type":"git","url":"git+https://github.com/tasnuvaleeya/memory-synchronizer.git","directory":"packages/adapter-sdk"},"author":{"name":"tasnuva-aif"},"bugs":{"url":"https://github.com/tasnuvaleeya/memory-synchronizer/issues"},"license":"MIT","readme":"# @agentctx/adapter-sdk\n\nPublic types and helpers for building [agentctx](https://github.com/tasnuvaleeya/memory-synchronizer) adapters and SDK consumers.\n\n## Install\n\n```sh\nnpm install @agentctx/adapter-sdk\n```\n\n## Use\n\nWrite a custom adapter for a tool agentctx doesn't ship out of the box:\n\n```ts\nimport {\n  type Adapter,\n  type GeneratedFile,\n  applyTokenBudget,\n  computeSourceSha,\n  injectProvenance,\n  contentChecksum,\n} from \"@agentctx/adapter-sdk\";\n\nexport const aiderAdapter: Adapter = {\n  name: \"aider\",\n  version: \"0.1.0\",\n  outputPaths: [\".aider.conf.yml\"],\n\n  async render(memory, ctx): Promise<GeneratedFile[]> {\n    const { sections } = applyTokenBudget(memory, ctx, \"aider\");\n    const body = sections.map((s) => s.body).join(\"\\n\\n\");\n    const sourceSha = computeSourceSha(memory);\n    const contents = injectProvenance(body, {\n      sourceSha,\n      generator: `aider-adapter@0.1.0`,\n      generatedAt: ctx.now,\n    });\n    return [\n      {\n        path: \".aider.conf.yml\",\n        contents,\n        checksum: contentChecksum(contents),\n        sourceSha,\n      },\n    ];\n  },\n};\n```\n\n## Exported surface\n\n| Name | Purpose |\n|---|---|\n| `Adapter`, `GeneratedFile`, `RenderContext` | Core adapter interface and supporting types |\n| `MemoryFile`, `MemorySet` | Inputs to your `render()` |\n| `Frontmatter`, `SourceType`, `FrontmatterSchema` | Memory file frontmatter shape |\n| `MemoryFileSchema`, `MemorySetSchema` | Zod schemas for validation |\n| `injectProvenance`, `stripProvenance`, `parseProvenance`, `buildProvenanceHeader`, `contentChecksum` | Provenance header helpers — mandatory for any generated file |\n| `applyTokenBudget`, `computeSourceSha` | Deterministic helpers shared with built-in adapters |\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-631e609c30cec34ad1f6fb0997a3f3c5"}