{"_id":"@agentlefs/sdk","_rev":"4-a5606b662c323f87af9bcb1d5a37ca8c","name":"@agentlefs/sdk","dist-tags":{"latest":"0.3.0"},"versions":{"0.1.0":{"name":"@agentlefs/sdk","version":"0.1.0","keywords":["agentlefs","sdk","api-client","openapi"],"license":"MIT","_id":"@agentlefs/sdk@0.1.0","maintainers":[{"name":"rsmets","email":"rayjsmets@gmail.com"}],"homepage":"https://agentlefs.com","bugs":{"url":"https://github.com/ContextHubApps/agentlefs-sdk-typescript/issues"},"dist":{"shasum":"b8271a30632561c11867141dfd7b804d87255c13","tarball":"https://registry.npmjs.org/@agentlefs/sdk/-/sdk-0.1.0.tgz","fileCount":735,"integrity":"sha512-DfpPkKXbbxaPETCzxGemwV2s+sI8bmkSr+AhA8jCreIJxMDZq52SrdEOWRyDgcb5l6cIJ5F5QMPjn04PE42Asg==","signatures":[{"sig":"MEYCIQDBVrpQea9l9d3M/l15A/vt/RugR6LR1OS+yHd9kfJewwIhAKRiBo+0GfQN8OTaEyEyf6JClzxZW6yKcYEUfgSzQYuG","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":720828},"main":"./dist/cjs/index.js","type":"module","types":"./dist/esm/index.d.ts","module":"./dist/esm/index.js","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/esm/index.d.ts","import":"./dist/esm/index.js","require":"./dist/cjs/index.js"}},"gitHead":"b41e7a90bef2cfc51037e8c74d5877a9d2bf534a","scripts":{"build":"tsc -p tsconfig.esm.json && tsc -p tsconfig.cjs.json"},"_npmUser":{"name":"rsmets","email":"rayjsmets@gmail.com"},"repository":{"url":"git+https://github.com/ContextHubApps/agentlefs-sdk-typescript.git","type":"git"},"_npmVersion":"11.19.0","description":"Official TypeScript SDK for the agentleFS REST API.","directories":{},"sideEffects":false,"_nodeVersion":"26.7.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"5.7.2","@types/node":"22"},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.1.0_1787278560417_0.6284939111455832","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@agentlefs/sdk","version":"0.2.0","keywords":["agentlefs","sdk","api-client","openapi"],"license":"MIT","_id":"@agentlefs/sdk@0.2.0","maintainers":[{"name":"rsmets","email":"rayjsmets@gmail.com"}],"homepage":"https://agentlefs.com","bugs":{"url":"https://github.com/ContextHubApps/agentlefs-sdk-typescript/issues"},"dist":{"shasum":"85fab92f3a11491e69fee960b319000a1e54758f","tarball":"https://registry.npmjs.org/@agentlefs/sdk/-/sdk-0.2.0.tgz","fileCount":735,"integrity":"sha512-4558jANmhIrqCVFoBKoaipDEY0FhrhJfmanIizt/nZL74UMeBUuEsg/x4lVi7cabQlX7DElcAG2iiZeGlTWR/Q==","signatures":[{"sig":"MEUCIQDT0vcwSaSjdxrmnOf3R8lIQ8jxD/Zupe01kIVND3CmgwIgPZoyoOJOdhuR+J1c8v6Wdun1I124W4gRK5vmq+6xGPU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQD9NUGsx8rzBEiIW8z7D1eB4S50KUY4VH3jKMLrMoUFEwIhAI9PfzeDmVIFwjIna6jd275J/HXtMQoMzYMiyOoxFJ76","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agentlefs%2fsdk@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":720834},"main":"./dist/cjs/index.js","type":"module","types":"./dist/esm/index.d.ts","module":"./dist/esm/index.js","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/esm/index.d.ts","import":"./dist/esm/index.js","require":"./dist/cjs/index.js"}},"gitHead":"58861417c5b52c401da7cb86c898535a693c40db","scripts":{"build":"tsc -p tsconfig.esm.json && tsc -p tsconfig.cjs.json"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:2b720373-2bc2-4c0e-a704-f8be6769dbcf"}},"repository":{"url":"git+https://github.com/ContextHubApps/agentlefs-sdk-typescript.git","type":"git"},"_npmVersion":"11.5.1","description":"Official TypeScript SDK for the agentleFS REST API.","directories":{},"sideEffects":false,"_nodeVersion":"22.17.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.2.0_1787279727271_0.6162540487166961","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@agentlefs/sdk","version":"0.2.1","keywords":["agentlefs","sdk","api-client","openapi"],"license":"MIT","_id":"@agentlefs/sdk@0.2.1","maintainers":[{"name":"rsmets","email":"rayjsmets@gmail.com"}],"homepage":"https://agentlefs.com","bugs":{"url":"https://github.com/ContextHubApps/agentlefs-sdk-typescript/issues"},"dist":{"shasum":"028faa2e5ebe7136cad0b1f4cf3acc917a3fda7c","tarball":"https://registry.npmjs.org/@agentlefs/sdk/-/sdk-0.2.1.tgz","fileCount":736,"integrity":"sha512-44YWTF91glcPZPt8KqZD5RsnAVVlHznZFcstWSFFCuitF4HaU/oRFaulnEuyFwFqQs81QzyzC/4wnMBVyYs2qQ==","signatures":[{"sig":"MEUCIQDvhm5mNhrbDF8VJ1bh5h8suByEytuDhAE3uvSwCgxgggIgPZZIt+7V0zWGFktA4C3bJPQhJRDVN0TMuo8A2vsTN4o=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIGoxeil/+4jkqxIIG/tbgNB8y9glRRoGl8MLtarOY4IhAiA/6O69By67o0WdrTf5KmVM2xrdIxLXfORivxjtRfhIzw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agentlefs%2fsdk@0.2.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":720965},"main":"./dist/cjs/index.js","type":"module","types":"./dist/esm/index.d.ts","module":"./dist/esm/index.js","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/esm/index.d.ts","import":"./dist/esm/index.js","require":"./dist/cjs/index.js"}},"gitHead":"f5ef6e8cdca05cecf404f9b5916ebd3630c3ab00","scripts":{"build":"tsc -p tsconfig.esm.json && tsc -p tsconfig.cjs.json && node -e \"require('fs').writeFileSync('dist/cjs/package.json', JSON.stringify({type:'commonjs'}) + '\\n')\""},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:2b720373-2bc2-4c0e-a704-f8be6769dbcf"}},"repository":{"url":"git+https://github.com/ContextHubApps/agentlefs-sdk-typescript.git","type":"git"},"_npmVersion":"11.5.1","description":"Official TypeScript SDK for the agentleFS REST API.","directories":{},"sideEffects":false,"_nodeVersion":"22.17.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.2.1_1787282796628_0.2356980578932013","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"_id":"@agentlefs/sdk@0.3.0","bugs":{"url":"https://github.com/ContextHubApps/agentlefs-sdk-typescript/issues"},"dist":{"shasum":"ce7fd621c7242681d39b0ded66a2863a5cc52daf","tarball":"https://registry.npmjs.org/@agentlefs/sdk/-/sdk-0.3.0.tgz","fileCount":736,"integrity":"sha512-RzjoXCK9NbQY+tJkXk7sOQnXRMNc1XsP8havQb2GEzxaLKtqy0eJkf2bhawLP4VJJigwm92b1mtldCmskUlB2g==","signatures":[{"sig":"MEYCIQDOdNuMnoszxQ6Cp21qaFufD8umyVmlJ81RCl6rB+5rjQIhAMrzM6bS04slOJ6ALsoGPOxUBxgfYQGb21AI1QdLccm5","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIGx1zwabD6iPyldl3XeX598YOupV5cTwAJcTB7JxkvzbAiAsxqVB92/kU+4gyTOil1M4aX3bvGJ6qBBmJDS3+hnxew=="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agentlefs%2fsdk@0.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":726267},"main":"./dist/cjs/index.js","name":"@agentlefs/sdk","type":"module","types":"./dist/esm/index.d.ts","module":"./dist/esm/index.js","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/esm/index.d.ts","import":"./dist/esm/index.js","require":"./dist/cjs/index.js"}},"gitHead":"fee1ef96165083f21edbd1abd1d3bf22ebbce9b5","license":"MIT","scripts":{"build":"tsc -p tsconfig.esm.json && tsc -p tsconfig.cjs.json && node -e \"require('fs').writeFileSync('dist/cjs/package.json', JSON.stringify({type:'commonjs'}) + '\\n')\""},"version":"0.3.0","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:2b720373-2bc2-4c0e-a704-f8be6769dbcf"}},"homepage":"https://agentlefs.com","keywords":["agentlefs","sdk","api-client","openapi"],"repository":{"url":"git+https://github.com/ContextHubApps/agentlefs-sdk-typescript.git","type":"git"},"_npmVersion":"11.5.1","description":"Official TypeScript SDK for the agentleFS REST API.","directories":{},"maintainers":[{"name":"rsmets","email":"rayjsmets@gmail.com"}],"sideEffects":false,"_nodeVersion":"22.17.0","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk_0.3.0_1787322662418_0.14647232239235808"}}},"time":{"created":"2026-08-21T02:16:00.210Z","modified":"2026-08-21T14:31:03.057Z","0.1.0":"2026-08-21T02:16:00.577Z","0.2.0":"2026-08-21T02:35:27.368Z","0.2.1":"2026-08-21T03:26:36.709Z","0.3.0":"2026-08-21T14:31:02.574Z"},"bugs":{"url":"https://github.com/ContextHubApps/agentlefs-sdk-typescript/issues"},"license":"MIT","homepage":"https://agentlefs.com","keywords":["agentlefs","sdk","api-client","openapi"],"repository":{"url":"git+https://github.com/ContextHubApps/agentlefs-sdk-typescript.git","type":"git"},"description":"Official TypeScript SDK for the agentleFS REST API.","maintainers":[{"name":"rsmets","email":"rayjsmets@gmail.com"}],"readme":"# @agentlefs/sdk\n\nOfficial TypeScript SDK for the [agentleFS](https://agentlefs.com) REST API.\n\n> Generated from agentleFS's OpenAPI spec. Do not edit by hand: see the\n> [SDK repository](https://github.com/ContextHubApps/agentlefs-sdk-typescript) for how it is\n> produced.\n\n## Install\n\n```bash\nnpm install @agentlefs/sdk\n```\n\n## Usage\n\n```ts\nimport { AgentlefsApiClient } from \"@agentlefs/sdk\";\n\nconst client = new AgentlefsApiClient({ token: process.env.AGENTLEFS_API_KEY! });\n\n// List what your key can reach\nconst folders = await client.folders.listFolders();\n\n// Read a document\nconst doc = await client.documents.retrieveDocument(\"onboarding/day-one.md\", {\n  folder: \"handbook\",\n});\n```\n\nAPI keys are minted in the agentleFS console: **Access**, open a principal, **Tokens**,\n**Mint**, with *enable for the REST API* ticked. Keys are long-lived and do not expire;\nrevoke them in the console when they should stop working.\n\n## A 404 does not mean you got the path wrong\n\nIf your key is not permitted to read something, the API returns `404` with exactly the\nresponse it would give for something that does not exist. The two are byte-identical, on\npurpose: if they differed, any key holder could map content they cannot read by watching\nwhich paths answer differently.\n\nSo there is no `403` on this API and no error meaning \"forbidden\". A surprising `404` is a\nquestion about **grants**, not about your path.\n\n## Writing safely\n\nTwo headers exist so a retry or a race cannot cost you data, and the SDK surfaces both:\n\n- **Creating** takes an idempotency key, so a retry after a network failure cannot produce a\n  duplicate document.\n- **Updating and deleting** take the `ETag` from a read, so a concurrent edit is refused\n  rather than silently overwritten.\n\n## Reference\n\n- Full API reference: [`docs/api.md`](https://github.com/ContextHubApps/agentlefs-sdk-typescript)\n- Machine-readable contract: <https://agentlefs.com/v1/openapi.yaml>\n\n## License\n\nMIT\n","readmeFilename":"README.md"}