{"_id":"@autonomys/agent-os","_rev":"11-350ed4ff12131008bcf5acb1c5a2e708","name":"@autonomys/agent-os","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.0":{"name":"@autonomys/agent-os","version":"0.1.0","keywords":["autonomys","agent","package-manager","cli","tools"],"author":{"url":"https://www.autonomys.xyz","name":"Autonomys"},"license":"MIT","_id":"@autonomys/agent-os@0.1.0","maintainers":[{"name":"clostao","email":"hastro1990@gmail.com"},{"name":"jeremy-subspace","email":"jeremy@subspace.network"},{"name":"marcaurelebesner","email":"marcaurele.desk@gmail.com"},{"name":"xm0on","email":"saeid@subspace.network"}],"homepage":"https://github.com/autonomys/autonomys-agents/tree/main/agent-package-manager#readme","bugs":{"url":"https://github.com/autonomys/autonomys-agents/issues"},"bin":{"autoOS":"dist/index.js"},"dist":{"shasum":"fb8278399e89eb610951e3d9bf2222c6414c0a1f","tarball":"https://registry.npmjs.org/@autonomys/agent-os/-/agent-os-0.1.0.tgz","fileCount":90,"integrity":"sha512-rGBRoWRli+ad/u3LDxgwVsWSsLjBfe7Iq6rZhZF3Nri+uY2Lmfci17NGPmx3wVFDmFsMAMocSNTZCdzsfrKKhA==","signatures":[{"sig":"MEUCIHBcfYKZcb1gFvJxSqxXiv20KD0lIOXS2dBuBi+q7BTcAiEA6nhjkFfHHWtNlvi3+36rcTri7O52yedKZp2Jr1npS+4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":212704},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20.18.1"},"gitHead":"cec3aa81e510c05f66f808c795db69a490fc850a","scripts":{"dev":"ts-node src/index.ts","lint":"eslint \"src/**/*.{js,ts}\"","build":"tsc","start":"node dist/index.js","format":"prettier --write \"src/**/*.{js,ts}\"","lint:fix":"eslint \"src/**/*.{js,ts}\" --fix","format:check":"prettier --check \"src/**/*.{js,ts}\"","prepublishOnly":"yarn build"},"_npmUser":{"name":"xm0on","email":"saeid@subspace.network"},"repository":{"url":"git+https://github.com/autonomys/autonomys-agents.git","type":"git","directory":"agent-package-manager"},"_npmVersion":"10.8.2","description":"Package manager for Autonomys agent tools","directories":{},"_nodeVersion":"20.18.3","dependencies":{"ora":"^6.3.0","axios":"^1.8.4","chalk":"^5.2.0","dotenv":"^16.4.7","ethers":"^6.11.1","keytar":"^7.9.0","archiver":"^5.3.1","inquirer":"^9.2.0","prettier":"^3.5.3","commander":"^10.0.0","extract-zip":"^2.0.1","@autonomys/auto-drive":"^1.4.17"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.23.0","globals":"^16.0.0","ts-node":"^10.9.1","typescript":"^5.0.0","@types/node":"^18.15.0","@types/archiver":"^5.3.2","@types/inquirer":"^9.0.3","typescript-eslint":"^8.27.0","eslint-config-prettier":"^10.1.1","eslint-plugin-prettier":"^5.2.3"},"_npmOperationalInternal":{"tmp":"tmp/agent-os_0.1.0_1745362936575_0.1509171040654973","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@autonomys/agent-os","version":"0.1.1","keywords":["autonomys","agent","package-manager","cli","tools"],"author":{"url":"https://www.autonomys.xyz","name":"Autonomys"},"license":"MIT","_id":"@autonomys/agent-os@0.1.1","maintainers":[{"name":"clostao","email":"hastro1990@gmail.com"},{"name":"jeremy-subspace","email":"jeremy@subspace.network"},{"name":"marcaurelebesner","email":"marcaurele.desk@gmail.com"},{"name":"xm0on","email":"saeid@subspace.network"}],"homepage":"https://github.com/autonomys/autonomys-agents/tree/main/agent-package-manager#readme","bugs":{"url":"https://github.com/autonomys/autonomys-agents/issues"},"bin":{"agent-os":"dist/index.js"},"dist":{"shasum":"7fa9281e8ddc7a2ec315662e7ab92c2a3bf8176b","tarball":"https://registry.npmjs.org/@autonomys/agent-os/-/agent-os-0.1.1.tgz","fileCount":90,"integrity":"sha512-kjNGHMd9UMVr8wCGrxFx7+pkrPrzAf28tmm6Opm0M48Z6uXaBAx8L6gbmVVsXtPYpFWUSpzr1tkWX1jaYyx99A==","signatures":[{"sig":"MEQCIDWIAcp6McZ1as6oPd7J12BrmOi1EBIm2RLHNcDYoMuDAiA78SAyzpkIHdatWX1FDbDfvcCXMHePKE6IiaaGAUSKLQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":212875},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20.18.1"},"gitHead":"5ddd2b2aee0e62dc5747262ba8cf87659665aa60","scripts":{"dev":"ts-node src/index.ts","lint":"eslint \"src/**/*.{js,ts}\"","build":"tsc","start":"node dist/index.js","format":"prettier --write \"src/**/*.{js,ts}\"","lint:fix":"eslint \"src/**/*.{js,ts}\" --fix","format:check":"prettier --check \"src/**/*.{js,ts}\"","prepublishOnly":"yarn build"},"_npmUser":{"name":"xm0on","email":"saeid@subspace.network"},"repository":{"url":"git+https://github.com/autonomys/autonomys-agents.git","type":"git","directory":"agent-package-manager"},"_npmVersion":"10.8.2","description":"Package manager for Autonomys agent tools","directories":{},"_nodeVersion":"20.18.3","dependencies":{"ora":"^6.3.0","axios":"^1.8.4","chalk":"^5.2.0","dotenv":"^16.4.7","ethers":"^6.11.1","keytar":"^7.9.0","archiver":"^5.3.1","inquirer":"^9.2.0","prettier":"^3.5.3","commander":"^10.0.0","extract-zip":"^2.0.1","@autonomys/auto-drive":"^1.4.17"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.23.0","globals":"^16.0.0","ts-node":"^10.9.1","typescript":"^5.0.0","@types/node":"^18.15.0","@types/archiver":"^5.3.2","@types/inquirer":"^9.0.3","typescript-eslint":"^8.27.0","eslint-config-prettier":"^10.1.1","eslint-plugin-prettier":"^5.2.3"},"_npmOperationalInternal":{"tmp":"tmp/agent-os_0.1.1_1745452165903_0.4783563921739489","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@autonomys/agent-os","version":"0.1.2","keywords":["autonomys","agent","package-manager","cli","tools"],"author":{"url":"https://www.autonomys.xyz","name":"Autonomys"},"license":"MIT","_id":"@autonomys/agent-os@0.1.2","maintainers":[{"name":"clostao","email":"hastro1990@gmail.com"},{"name":"jeremy-subspace","email":"jeremy@subspace.network"},{"name":"marcaurelebesner","email":"marcaurele.desk@gmail.com"},{"name":"xm0on","email":"saeid@subspace.network"}],"homepage":"https://github.com/autonomys/autonomys-agents/tree/main/agent-package-manager#readme","bugs":{"url":"https://github.com/autonomys/autonomys-agents/issues"},"bin":{"agent-os":"dist/index.js"},"dist":{"shasum":"a47b02e6d2f011bbb0c3ad4263cae6d78e98ea88","tarball":"https://registry.npmjs.org/@autonomys/agent-os/-/agent-os-0.1.2.tgz","fileCount":114,"integrity":"sha512-jR7ejsXzjY3CMgXkUu97JbvKVhuY/awkkE/Rc/LJ2zZaZIz5ZT+PFJH91muwd+CT98ZYpntVrro7fIEVEXmR/Q==","signatures":[{"sig":"MEUCIBhOEAJcYw5SRlJLxcWldy8jIxbwNEcNwLOVjgkQZ47KAiEAk6N14DjTJ+lnEsf1Bbky4VhvZRKVqBMLltb1ZrbmeBA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":258399},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20.18.1"},"gitHead":"58ffd913f5ef010d499d869eab1717fae433a876","scripts":{"dev":"ts-node src/index.ts","lint":"eslint \"src/**/*.{js,ts}\"","build":"tsc","start":"node dist/index.js","format":"prettier --write \"src/**/*.{js,ts}\"","lint:fix":"eslint \"src/**/*.{js,ts}\" --fix","format:check":"prettier --check \"src/**/*.{js,ts}\"","prepublishOnly":"yarn build"},"_npmUser":{"name":"xm0on","email":"saeid@subspace.network"},"repository":{"url":"git+https://github.com/autonomys/autonomys-agents.git","type":"git","directory":"agent-package-manager"},"_npmVersion":"10.8.2","description":"Package manager for Autonomys agent tools","directories":{},"_nodeVersion":"20.18.3","dependencies":{"ora":"^6.3.0","axios":"^1.8.4","chalk":"^5.2.0","dotenv":"^16.4.7","ethers":"^6.11.1","keytar":"^7.9.0","archiver":"^5.3.1","inquirer":"^9.2.0","prettier":"^3.5.3","commander":"^10.0.0","extract-zip":"^2.0.1","@autonomys/auto-drive":"^1.4.17"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.23.0","globals":"^16.0.0","ts-node":"^10.9.1","typescript":"^5.0.0","@types/node":"^18.15.0","@types/archiver":"^5.3.2","@types/inquirer":"^9.0.3","typescript-eslint":"^8.27.0","eslint-config-prettier":"^10.1.1","eslint-plugin-prettier":"^5.2.3"},"_npmOperationalInternal":{"tmp":"tmp/agent-os_0.1.2_1745971962633_0.6959802254946663","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@autonomys/agent-os","version":"0.1.3","keywords":["autonomys","agent","package-manager","cli","tools"],"author":{"url":"https://www.autonomys.xyz","name":"Autonomys"},"license":"MIT","_id":"@autonomys/agent-os@0.1.3","maintainers":[{"name":"clostao","email":"hastro1990@gmail.com"},{"name":"jeremy-subspace","email":"jeremy@subspace.network"},{"name":"marcaurelebesner","email":"marcaurele.desk@gmail.com"},{"name":"xm0on","email":"saeid@subspace.network"}],"homepage":"https://github.com/autonomys/autonomys-agents/tree/main/agent-package-manager#readme","bugs":{"url":"https://github.com/autonomys/autonomys-agents/issues"},"bin":{"agent-os":"dist/index.js"},"dist":{"shasum":"8a86776abb9fa855bf1a940a83e870278fae8e94","tarball":"https://registry.npmjs.org/@autonomys/agent-os/-/agent-os-0.1.3.tgz","fileCount":99,"integrity":"sha512-VFU+pbEA5068mI6K4I5xwFdQ97+nTVNXXqeIeAPFj5PaVxSmdaD0wdoc6z2caQK+j234uYbU0jd31B+N6CQtYQ==","signatures":[{"sig":"MEUCIDjofKtJkppR26KSiDPXPqF0iBvk8K/PzwmoG/Vj6RGSAiEAvTXHw19p71tnOa+6Y0V4B26zRdNk5llUdDy9UsNhzBk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":222696},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20.18.1"},"gitHead":"6049aa4243e9e08e4c7657ae24cee9546dc3ee09","scripts":{"dev":"ts-node src/index.ts","lint":"eslint \"src/**/*.{js,ts}\"","build":"tsc","start":"node dist/index.js","format":"prettier --write \"src/**/*.{js,ts}\"","lint:fix":"eslint \"src/**/*.{js,ts}\" --fix","format:check":"prettier --check \"src/**/*.{js,ts}\"","prepublishOnly":"yarn build"},"_npmUser":{"name":"xm0on","email":"saeid@subspace.network"},"repository":{"url":"git+https://github.com/autonomys/autonomys-agents.git","type":"git","directory":"agent-package-manager"},"_npmVersion":"10.8.2","description":"Package manager for Autonomys agent tools","directories":{},"_nodeVersion":"20.18.3","dependencies":{"ora":"^6.3.0","axios":"^1.8.4","chalk":"^5.2.0","dotenv":"^16.4.7","ethers":"^6.11.1","keytar":"^7.9.0","archiver":"^5.3.1","inquirer":"^9.2.0","prettier":"^3.5.3","commander":"^10.0.0","extract-zip":"^2.0.1","@autonomys/auto-drive":"^1.4.17"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.23.0","globals":"^16.0.0","ts-node":"^10.9.1","typescript":"^5.0.0","@types/node":"^18.15.0","@types/archiver":"^5.3.2","@types/inquirer":"^9.0.3","typescript-eslint":"^8.27.0","eslint-config-prettier":"^10.1.1","eslint-plugin-prettier":"^5.2.3"},"_npmOperationalInternal":{"tmp":"tmp/agent-os_0.1.3_1746131483149_0.5985780397195046","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2025-04-22T23:02:16.485Z","modified":"2025-12-17T01:46:10.445Z","0.1.0":"2025-04-22T23:02:16.787Z","0.1.1":"2025-04-23T23:49:26.118Z","0.1.2":"2025-04-30T00:12:42.856Z","0.1.3":"2025-05-01T20:31:23.335Z"},"bugs":{"url":"https://github.com/autonomys/autonomys-agents/issues"},"author":{"url":"https://www.autonomys.xyz","name":"Autonomys"},"license":"MIT","homepage":"https://github.com/autonomys/autonomys-agents/tree/main/agent-package-manager#readme","keywords":["autonomys","agent","package-manager","cli","tools"],"repository":{"url":"git+https://github.com/autonomys/autonomys-agents.git","type":"git","directory":"agent-package-manager"},"description":"Package manager for Autonomys agent tools","maintainers":[{"email":"jeremy@subspace.network","name":"jeremy-subspace"},{"email":"emil@autonomys.xyz","name":"emilautonomys"},{"email":"jim@autonomys.xyz","name":"jim-autonomys"}],"readme":"# agent-os CLI\n\nA package manager and toolkit for Autonomys agent tools.\n\n## Overview\n\nagent-os CLI is a command-line interface for managing Autonomys agent tools. It allows developers to:\n\n- Create new agent projects\n- Install agent tools from the registry\n- Publish new tools to the registry\n- Search for registered tools\n- Configure tool settings\n- Securely manage credentials\n\n> **Note:** Credentials are only required for publishing tools to the registry. You can freely install, search, and use tools without setting up credentials.\n\n## Installation\n\n### Prerequisites\n\n- Node.js 20.x or higher\n- npm or yarn\n\n### Global Installation\n\n```bash\n# Using npm\nnpm install -g @autonomys/agent-os\n\n# Using Yarn 2.x\nyarn dlx @autonomys/agent-os\n```\n\n### Local Installation\n\n```bash\n# Using npm\nnpm install @autonomys/agent-os\n\n# Using yarn\nyarn add @autonomys/agent-os\n```\n\n## Getting Started\n\nAfter installation, you can start using basic commands like `search` and `install` without any configuration.\n\nTo publish tools or perform operations that require blockchain interaction, set up your credentials:\n\n```bash\nagent-os config --credentials\n```\n\nThis interactive wizard will guide you through:\n- Setting up your Auto Drive API key\n- Configuring your Auto Drive encryption password (optional)\n- Setting up your Auto-EVM private key\n- Choosing your preferred network (mainnet or Taurus)\n\n## Core Commands\n\n### Help\n```bash\nagent-os -h\n```\n\n### Create a New Agent Project\n\n```bash\n# Create a basic project\nagent-os init my-agent-project\n\n# Create a project, install dependencies, and create a character\nagent-os init my-agent-project --install --character=my-character --api\n```\n\nOptions:\n- `--install`: Automatically install dependencies after project creation\n- `--character <name>`: Create a character with the specified name\n- `--api`: Generate API certificates for the project (default: true)\n\n### Install a Tool\n\n```bash\n# Install the latest version\nagent-os install <tool-name>\n\n# Install a specific version\nagent-os install <tool-name> -v <version>\n\n# Install using a Content ID (CID)\nagent-os install <tool-name> --cid <cid>\n```\n\n### Publish a Tool\n\n```bash\n# Publish a tool to the registry\nagent-os publish <tool-path>\n\n# Upload to Auto Drive without updating the registry\nagent-os publish <tool-path> --no-registry\n```\n\n### Search for Tools\n\n```bash\n# Search for tools in the registry\nagent-os search <search-term>\n\n# Show detailed information in search results\nagent-os search <search-term> -d\n```\n\n### Tool Inquiry\n\n```bash\n# Get information about a tool\nagent-os tool -n <tool-name>\n\n# Get information about a specific version\nagent-os tool -n <tool-name> -v <version>\n\n# Perform a specific action on a tool\nagent-os tool -n <tool-name> -a <action>\n\n# Example: Get metadata for a specific version\nagent-os tool -n slack-tool -v 1.0.0 -a metadata\n```\n\n### Configure Settings\n\n```bash\n# Configure all settings\nagent-os config\n\n# Configure only credentials\nagent-os config --credentials\n\n# General Config\nagent-os config --settings\n```\n\n\n### Clean Cached Files\n\n```bash\n# Clean with confirmation\nagent-os clean\n\n# Force clean without confirmation\nagent-os clean --force\n```\n\n## Secure Credential Management\n\nagent-os CLI securely manages all your credentials through your system's native keychain. Note that credentials are **only required for publishing tools** - you can freely install and search for tools without setting up credentials.\n\n### System Keychain Integration\n\nYour credentials are automatically stored in your system's secure keychain:\n- macOS: Keychain Access\n- Windows: Credential Manager \n- Linux: Secret Service API (GNOME Keyring, KWallet, etc.)\n\nThis approach provides several security benefits:\n- OS-level security with encryption at rest\n- No need for environment variables\n- Credentials are never stored in plaintext\n- Automatic authentication without re-entering passwords\n- Separation from application code\n\n### Credential Types\n\nThe following credentials are securely managed:\n- Auto Drive API key\n- Auto Drive encryption password\n- Auto-EVM private key\n\nAll credentials are encrypted and accessible only through the agent-os CLI with proper authentication.\n\n## Tool Structure\n\nTo create a publishable tool, your tool directory should have the following structure:\n\n```\ntool-directory/\n├── manifest.json         # Tool metadata\n├── index.js              # Main entry point\n└── ... (other files)     # Additional files\n```\n\nThe manifest.json should contain:\n\n```json\n{\n  \"name\": \"tool-name\",\n  \"version\": \"1.0.0\",\n  \"description\": \"Tool description\",\n  \"author\": \"Your Name\",\n  \"main\": \"index.js\",\n  \"dependencies\": {\n    \"dependency\": \"^1.0.0\"\n  }\n}\n```\n\n## Sample Tool Example\n\nBelow is a complete example of how to create, use, and publish a simple tool for Autonomys agents.\n\n### Tool Implementation\n\nFirst, create a new directory for your tool:\n\n```bash\nmkdir weather-tool\ncd weather-tool\n```\n\nCreate a `manifest.json` file:\n\n```json\n{\n  \"name\": \"weather-tool\",\n  \"version\": \"1.0.0\",\n  \"description\": \"A tool for fetching weather data\",\n  \"author\": \"Your Name\",\n  \"main\": \"index.ts\",\n  \"dependencies\": {\n    \"@langchain/core\": \"^0.1.0\",\n    \"zod\": \"^3.22.4\",\n    \"axios\": \"^1.6.0\"\n  },\n  \"keywords\": [\"weather\", \"forecast\", \"api\"]\n}\n```\n\nThen create the main `index.ts` file:\n\n```typescript\nimport { DynamicStructuredTool } from \"@langchain/core/tools\";\nimport { z } from \"zod\";\nimport axios from \"axios\";\n\n/**\n * A tool that fetches current weather data for a given location\n */\nexport const createWeatherTool = (apiKey: string) => new DynamicStructuredTool({\n  name: \"get_weather\",\n  description: \"Get current weather for a location\",\n  schema: z.object({\n    location: z.string().describe(\"The city and country, e.g., 'London, UK'\"),\n    units: z.enum([\"metric\", \"imperial\"]).optional()\n      .describe(\"Temperature units (metric or imperial). Default: metric\")\n  }),\n  func: async ({ location, units = \"metric\" }) => {\n    try {\n      // API key is now passed as a parameter to the tool creator function\n      const url = `https://api.example.com/weather?q=${encodeURIComponent(location)}&units=${units}&appid=${apiKey}`;\n      \n      const response = await axios.get(url);\n      const data = response.data;\n      \n      return JSON.stringify({\n        location: location,\n        temperature: data.main.temp,\n        description: data.weather[0].description,\n        humidity: data.main.humidity,\n        windSpeed: data.wind.speed\n      });\n    } catch (error) {\n      return `Error fetching weather: ${error.message}`;\n    }\n  }\n});\n\n// Export the tools creation function for the Autonomys agent system\nexport const createTools = (apiKey: string) => {\n  return [createWeatherTool(apiKey)];\n};\n\n// Default export\nexport default { createTools };\n```\n\n### Publishing Your Tool\n\nWhen you're ready to publish:\n\n```bash\n# Navigate to your tool directory\ncd weather-tool\n\n# Publish to the registry\nagent-os publish .\n```\n\n### Installing and Using Your Tool\n\nAfter publishing your tool, you can install it using:\n\n```bash\nagent-os install weather-tool\n```\n\nThen, in your agent code, you can import and use the tool:\n\n```typescript\nimport { createWeatherTool } from './tools/weather-tool';\n\n// Get the weather tool with your API key\nconst weatherTool = createWeatherTool('your-api-key-here');\n\n// Add it to your agent's tools\nconst agent = new <Agent-Instantiation>({\n  tools: [weatherTool, ...otherTools],\n  // other agent configuration\n});\n```\n\n## Troubleshooting\n\n### Common Issues\n\n#### \"Failed to decrypt credentials\" or \"No credentials found\"\n\n- This error usually appears when trying to publish a tool without configuring credentials\n- Run `agent-os config --credentials` to set up your credentials for publishing\n- Remember that credentials are only required for publishing tools, not for installing or searching\n\n#### API Key Issues\n\n- Verify your API key at https://ai3.storage\n- Ensure your network settings match your API key (mainnet or Taurus)\n\n## Privacy and Security\n\n- All credentials are securely stored in your system's native keychain\n- The Auto-EVM private key is required for blockchain operations\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.","readmeFilename":"README.md"}