{"_id":"@awesome-agent/adapter-filesystem","_rev":"2-d132f6448bdd57628907596ff2b77b41","name":"@awesome-agent/adapter-filesystem","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@awesome-agent/adapter-filesystem","version":"0.1.0","author":{"name":"Kaan Bingol","email":"kaanbingol@outlook.com"},"license":"Apache-2.0","_id":"@awesome-agent/adapter-filesystem@0.1.0","maintainers":[{"name":"kaanbingol","email":"kaanbingol@outlook.com"}],"homepage":"https://github.com/awesome-agent/awesome-agent-sdk#readme","bugs":{"url":"https://github.com/awesome-agent/awesome-agent-sdk/issues"},"dist":{"shasum":"5a09df5fad9085f3bdaae3ce0462459f32c81e4b","tarball":"https://registry.npmjs.org/@awesome-agent/adapter-filesystem/-/adapter-filesystem-0.1.0.tgz","fileCount":11,"integrity":"sha512-oO6pMd4Gx0GQX+BslJundikNX3DY3HgTpPlLaDE+jDv4Q5kjhRwqY0WXoRfzpsouJn4lwz/2SN9WHiHGspbKPw==","signatures":[{"sig":"MEUCIQCiILGDIlUN4f0a7Wb9emOOHe1Z9g7emmdWYPCsWhN1/AIgNMp5wR2ckv/bkjnWmrjnliLw6crmA2EOkj9p+IM8Cts=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22488},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"5253cbc5cd51ec012d1382391cd112c86e19f562","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","clean":"rm -rf dist","prepublishOnly":"npm run build"},"_npmUser":{"name":"kaanbingol","email":"kaanbingol@outlook.com"},"repository":{"url":"git+https://github.com/awesome-agent/awesome-agent-sdk.git","type":"git","directory":"packages/adapter-filesystem"},"_npmVersion":"11.8.0","description":"File system memory store adapter for @awesome-agent/agent-core","directories":{},"sideEffects":false,"_nodeVersion":"25.6.0","_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.0","typescript":"^5.9.3","@awesome-agent/agent-core":"^0.1.0"},"peerDependencies":{"@awesome-agent/agent-core":"*"},"_npmOperationalInternal":{"tmp":"tmp/adapter-filesystem_0.1.0_1773575577672_0.45760351321067994","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@awesome-agent/adapter-filesystem","version":"0.1.1","description":"File system memory store adapter for @awesome-agent/agent-core","type":"module","main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"import":"./dist/index.js","types":"./dist/index.d.ts"}},"scripts":{"build":"tsc","dev":"tsc --watch","test":"vitest run","clean":"rm -rf dist","prepublishOnly":"npm run build"},"author":{"name":"Kaan Bingol","email":"kaanbingol@outlook.com"},"license":"Apache-2.0","repository":{"type":"git","url":"git+https://github.com/awesome-agent/awesome-agent-sdk.git","directory":"packages/adapter-filesystem"},"engines":{"node":">=18.0.0"},"sideEffects":false,"peerDependencies":{"@awesome-agent/agent-core":"*"},"devDependencies":{"@awesome-agent/agent-core":"^0.2.0","typescript":"^5.9.3","vitest":"^4.1.0"},"gitHead":"79b02b7e77911de8451b39041d5e1332b1f5cbd5","_id":"@awesome-agent/adapter-filesystem@0.1.1","bugs":{"url":"https://github.com/awesome-agent/awesome-agent-sdk/issues"},"homepage":"https://github.com/awesome-agent/awesome-agent-sdk#readme","_nodeVersion":"25.6.0","_npmVersion":"11.8.0","dist":{"integrity":"sha512-2LPSuQbiE2fLgtQtY2McE6CoidNTk8tZd+TYFcApPqb6F4d1VdAFe12q+VnA2snP1KMSkLKNDR2xDeld1tXEQA==","shasum":"57201659885c1eec3bb436813705d469f283c5cb","tarball":"https://registry.npmjs.org/@awesome-agent/adapter-filesystem/-/adapter-filesystem-0.1.1.tgz","fileCount":11,"unpackedSize":22488,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDgmyWBFRQ3RZvQppDcv8Z+1SRBbjzBxcCwND95/5U2yAIgCMiZ8NFQ47+QNBJY6TJCqIrJqdP5GdEyANPQiwk48ik="}]},"_npmUser":{"name":"kaanbingol","email":"kaanbingol@outlook.com"},"directories":{},"maintainers":[{"name":"kaanbingol","email":"kaanbingol@outlook.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/adapter-filesystem_0.1.1_1773730930673_0.9837219206778351"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-15T11:52:57.613Z","modified":"2026-03-17T07:02:10.976Z","0.1.0":"2026-03-15T11:52:57.819Z","0.1.1":"2026-03-17T07:02:10.836Z"},"bugs":{"url":"https://github.com/awesome-agent/awesome-agent-sdk/issues"},"author":{"name":"Kaan Bingol","email":"kaanbingol@outlook.com"},"license":"Apache-2.0","homepage":"https://github.com/awesome-agent/awesome-agent-sdk#readme","repository":{"type":"git","url":"git+https://github.com/awesome-agent/awesome-agent-sdk.git","directory":"packages/adapter-filesystem"},"description":"File system memory store adapter for @awesome-agent/agent-core","maintainers":[{"name":"kaanbingol","email":"kaanbingol@outlook.com"}],"readme":"# @awesome-agent/adapter-filesystem\r\n\r\nFile system memory store for [@awesome-agent/agent-core](../core).\r\n\r\nEach memory entry is stored as a JSON file on disk. Zero external dependencies — uses only Node.js built-ins (`fs`, `path`, `crypto`).\r\n\r\nIdeal for **local development**, **CLI tools**, and **debugging** — no database setup required.\r\n\r\n## Installation\r\n\r\n```bash\r\nnpm install @awesome-agent/agent-core @awesome-agent/adapter-filesystem\r\n```\r\n\r\n## Usage\r\n\r\n```typescript\r\nimport { FileSystemMemoryStore } from \"@awesome-agent/adapter-filesystem\";\r\n\r\nconst memory = new FileSystemMemoryStore({\r\n  directory: \"./memories\",\r\n});\r\n\r\n// Save a memory\r\nconst entry = await memory.save({\r\n  type: \"user\",\r\n  name: \"language-pref\",\r\n  content: \"User prefers TypeScript over JavaScript\",\r\n});\r\n\r\n// Search by relevance\r\nconst results = await memory.search(\"TypeScript\");\r\n// [{ entry: { name: \"language-pref\", ... }, relevance: 0.85 }]\r\n\r\n// Get all, optionally filtered by type\r\nconst feedback = await memory.getAll({ types: [\"feedback\"] });\r\n\r\n// Delete\r\nawait memory.delete(entry.id);\r\n```\r\n\r\n## With AgenticLoop\r\n\r\n```typescript\r\nimport { AgenticLoop, DefaultToolRegistry, DefaultToolExecutor,\r\n  DefaultHookManager, DefaultContextBuilder } from \"@awesome-agent/agent-core\";\r\nimport { OpenAIAdapter } from \"@awesome-agent/adapter-openai\";\r\nimport { FileSystemMemoryStore } from \"@awesome-agent/adapter-filesystem\";\r\n\r\nconst memory = new FileSystemMemoryStore({ directory: \"./.agent/memories\" });\r\n\r\nconst loop = new AgenticLoop({\r\n  llm: new OpenAIAdapter({ baseURL: \"...\", apiKey: \"...\" }),\r\n  agent: { id: \"my-agent\", name: \"Agent\", prompt: \"You are helpful.\" },\r\n  tools: new DefaultToolRegistry(),\r\n  executor: new DefaultToolExecutor(new DefaultToolRegistry()),\r\n  hooks: new DefaultHookManager(),\r\n  context: new DefaultContextBuilder(),\r\n  memory, // Memories persist across sessions\r\n});\r\n```\r\n\r\n## File Structure\r\n\r\n```\r\n./memories/\r\n├── a1b2c3d4e5f6g7h8.json    # { id, type, name, content, createdAt, updatedAt }\r\n├── i9j0k1l2m3n4o5p6.json\r\n└── ...\r\n```\r\n\r\nEach file is human-readable JSON — you can inspect, edit, or commit them to git.\r\n\r\n## Configuration\r\n\r\n| Option | Type | Default | Description |\r\n|--------|------|---------|-------------|\r\n| `directory` | `string` | (required) | Path to store memory files |\r\n| `extension` | `string` | `\".json\"` | File extension for memory files |\r\n\r\n## License\r\n\r\nApache-2.0\r\n","readmeFilename":"README.md"}