{"_id":"@6digit/satellite-core","_rev":"5-6608d31942bd49e46e787111ea90f233","name":"@6digit/satellite-core","dist-tags":{"latest":"0.3.1"},"versions":{"0.1.0":{"name":"@6digit/satellite-core","version":"0.1.0","keywords":["satellite","ai","coding-assistant","convex","tools","6digit"],"author":{"name":"6digit"},"license":"MIT","_id":"@6digit/satellite-core@0.1.0","maintainers":[{"name":"cocporn","email":"cocporn@gmail.com"}],"homepage":"https://6digit.studio","bugs":{"url":"https://github.com/6digit/satellite-core/issues"},"dist":{"shasum":"3de5448b570cc69f0a447945b08daac1c2328a9b","tarball":"https://registry.npmjs.org/@6digit/satellite-core/-/satellite-core-0.1.0.tgz","fileCount":17,"integrity":"sha512-8sypLzZaVHtW/qW7DfTyJosHZMa6Pyr5baVl6Anwf+EaqKP05h/BFc6eQG9jzQgmy4bRw6RGX3ZEijIzUPh0Bg==","signatures":[{"sig":"MEYCIQDMqvAkdMreBGRLH/hb8bA9krIri5QbeOcTHVqBeJ1hFgIhANuhqJQPiagrn6WcW/vTZqAIfypQ4g5SIYyEx9Lwwx9Q","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":26922},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"30ce3b3655a845cd3383abaf209a1a475ccaf061","scripts":{"dev":"tsx src/index.ts","test":"echo \"Error: no test specified\" && exit 1","build":"tsc","clean":"rm -rf dist","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"cocporn","email":"cocporn@gmail.com"},"repository":{"url":"git+https://github.com/6digit/satellite-core.git","type":"git"},"_npmVersion":"11.4.2","description":"Core satellite application with tool registry and Convex integration for 6digit AI coding assistants","directories":{},"_nodeVersion":"23.2.0","dependencies":{"zod":"^3.22.0","convex":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/satellite-core_0.1.0_1753558372321_0.29307830584747374","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@6digit/satellite-core","version":"0.2.0","keywords":["satellite","ai","coding-assistant","convex","tools","6digit"],"author":{"name":"6digit"},"license":"MIT","_id":"@6digit/satellite-core@0.2.0","maintainers":[{"name":"cocporn","email":"cocporn@gmail.com"}],"homepage":"https://6digit.studio","bugs":{"url":"https://github.com/6digit/satellite-core/issues"},"dist":{"shasum":"8f061be09ce21448abdedcabfc1bc2a859bad2a5","tarball":"https://registry.npmjs.org/@6digit/satellite-core/-/satellite-core-0.2.0.tgz","fileCount":17,"integrity":"sha512-+p0kJXoWAVLz/y3rmue/PAf1mlEYbhscTajxi9c9MMy6avTi3KnPUFA5COduWR6wfOqCGt+kxTIo6CONI1co/w==","signatures":[{"sig":"MEYCIQCvqAzG2qH88k4y/JAhLYK5cUSs9URQztAKiOKN/D3B2QIhAKFCGWZqDaQE0HYHb00nsrJkB9LKJssV/5/6R+ARYdFY","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28154},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"7eded2d6e65d0948521b23ae9c91901f3bd6034d","scripts":{"dev":"tsx src/index.ts","test":"echo \"Error: no test specified\" && exit 1","build":"tsc","clean":"rm -rf dist","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"cocporn","email":"cocporn@gmail.com"},"repository":{"url":"git+https://github.com/6digit/satellite-core.git","type":"git"},"_npmVersion":"11.4.2","description":"Core satellite application with tool registry and Convex integration for 6digit AI coding assistants","directories":{},"_nodeVersion":"23.2.0","dependencies":{"zod":"^3.22.0","convex":"^1.0.0","zod-subset-parser":"^0.2.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/satellite-core_0.2.0_1753653055079_0.013166879074760773","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@6digit/satellite-core","version":"0.2.1","keywords":["satellite","ai","coding-assistant","convex","tools","6digit"],"author":{"name":"6digit"},"license":"MIT","_id":"@6digit/satellite-core@0.2.1","maintainers":[{"name":"cocporn","email":"cocporn@gmail.com"}],"homepage":"https://6digit.studio","bugs":{"url":"https://github.com/6digit/satellite-core/issues"},"dist":{"shasum":"631b72332f2fb05ec6f31b0b5ead45a910047178","tarball":"https://registry.npmjs.org/@6digit/satellite-core/-/satellite-core-0.2.1.tgz","fileCount":19,"integrity":"sha512-z1xmzYARd55HNAUMyxvCVijRaOcjHd+7vEK+1LwBkNfCleLWywP+NG8jXktxaa8fCfqI6L5g0wE3jcYM1mMdqQ==","signatures":[{"sig":"MEUCIC/dv9NP8WwbiZt2dM1CXP1TnKB8GiHXfLDS1pe66Kr9AiEA5rVFnydQcV7uaS15yh8Vm15YmfIqZAVBhQ51WRO8s4M=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35735},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"38aff339f89dd670978d8a4fc90e63723d093e29","scripts":{"dev":"tsx src/index.ts","test":"echo \"Error: no test specified\" && exit 1","build":"tsc","clean":"rm -rf dist","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"cocporn","email":"cocporn@gmail.com"},"repository":{"url":"git+https://github.com/6digit/satellite-core.git","type":"git"},"_npmVersion":"11.4.2","description":"Core satellite application with tool registry and Convex integration for 6digit AI coding assistants","directories":{},"_nodeVersion":"23.2.0","dependencies":{"zod":"^3.22.0","convex":"^1.0.0","zod-subset-parser":"^0.2.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/satellite-core_0.2.1_1754162537477_0.053561794127237494","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@6digit/satellite-core","version":"0.3.0","keywords":["satellite","ai","coding-assistant","convex","tools","6digit"],"author":{"name":"6digit"},"license":"MIT","_id":"@6digit/satellite-core@0.3.0","maintainers":[{"name":"cocporn","email":"cocporn@gmail.com"}],"homepage":"https://6digit.studio","bugs":{"url":"https://github.com/6digit/satellite-core/issues"},"dist":{"shasum":"3b984e0e57ac0fc207a714ae54920d8deb23baa3","tarball":"https://registry.npmjs.org/@6digit/satellite-core/-/satellite-core-0.3.0.tgz","fileCount":19,"integrity":"sha512-yf2HfY7EIGmnyt2rpBAq0/+lsHfq3pM+EbvMHzPBwv37/oy3mmY+ZCQXDnV7r4kNXe5f4vsWMQA8l+S+RDfJeQ==","signatures":[{"sig":"MEYCIQD7tnZjtiSUXl3gyVOeRjHWwxVb+Nw0aWW6H1cGjeCnFgIhAKzP9JYT9Bx2gkbKRYWehAGer06gf1085xj46bzyP2IV","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35815},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"c4bd4434d271b919cc5c1121f4c855ccb768cf22","scripts":{"dev":"tsx src/index.ts","test":"echo \"Error: no test specified\" && exit 1","build":"tsc","clean":"rm -rf dist","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"cocporn","email":"cocporn@gmail.com"},"repository":{"url":"git+https://github.com/6digit/satellite-core.git","type":"git"},"_npmVersion":"11.4.2","description":"Core satellite application with tool registry and Convex integration for 6digit AI coding assistants","directories":{},"_nodeVersion":"23.2.0","dependencies":{"zod":"^3.22.0","convex":"^1.0.0","zod-subset-parser":"^0.2.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/satellite-core_0.3.0_1754164421861_0.7743094385497742","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@6digit/satellite-core","version":"0.3.1","description":"Core satellite application with tool registry and Convex integration for 6digit AI coding assistants","main":"dist/index.js","types":"dist/index.d.ts","keywords":["satellite","ai","coding-assistant","convex","tools","6digit"],"author":{"name":"6digit"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/6digit/satellite-core.git"},"homepage":"https://6digit.studio","bugs":{"url":"https://github.com/6digit/satellite-core/issues"},"scripts":{"build":"tsc","prepublishOnly":"npm run clean && npm run build","dev":"tsx src/index.ts","clean":"rm -rf dist","test":"echo \"Error: no test specified\" && exit 1"},"dependencies":{"convex":"^1.0.0","zod":"^3.22.0","zod-subset-parser":"^0.2.2"},"devDependencies":{"@types/node":"^20.0.0","tsx":"^4.0.0","typescript":"^5.0.0"},"publishConfig":{"access":"public"},"engines":{"node":">=18.0.0"},"_id":"@6digit/satellite-core@0.3.1","gitHead":"ff036ec2d5d722ac2ddfd4ee9f960e487527f349","_nodeVersion":"23.2.0","_npmVersion":"11.4.2","dist":{"integrity":"sha512-3S8Yh0pwYKdhAROLoSLi/sffs1L2tepUG+tipMaJC/2flXQN0K1qJBAPmcDd19NNxA59GkXkKsSs+CJP6ub+OA==","shasum":"78d6d2b60de2e5f4db15ae9827749649eedc424d","tarball":"https://registry.npmjs.org/@6digit/satellite-core/-/satellite-core-0.3.1.tgz","fileCount":19,"unpackedSize":37886,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCKdhEmJN5LXvhfF+rfEZbGrbi5eDhriI+6yV9l/OmWSgIhAPW5bivqwfZRcV8/4piudzVaCDwOYQu4VBgG+x3kJ9Zo"}]},"_npmUser":{"name":"cocporn","email":"cocporn@gmail.com"},"directories":{},"maintainers":[{"name":"cocporn","email":"cocporn@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/satellite-core_0.3.1_1755170118878_0.2856196642074442"},"_hasShrinkwrap":false}},"time":{"created":"2025-07-26T19:32:52.227Z","modified":"2025-08-14T11:15:19.230Z","0.1.0":"2025-07-26T19:32:52.529Z","0.2.0":"2025-07-27T21:50:55.266Z","0.2.1":"2025-08-02T19:22:17.671Z","0.3.0":"2025-08-02T19:53:42.099Z","0.3.1":"2025-08-14T11:15:19.032Z"},"bugs":{"url":"https://github.com/6digit/satellite-core/issues"},"author":{"name":"6digit"},"license":"MIT","homepage":"https://6digit.studio","keywords":["satellite","ai","coding-assistant","convex","tools","6digit"],"repository":{"type":"git","url":"git+https://github.com/6digit/satellite-core.git"},"description":"Core satellite application with tool registry and Convex integration for 6digit AI coding assistants","maintainers":[{"name":"cocporn","email":"cocporn@gmail.com"}],"readme":"# @6digit/satellite-core\n\nCore satellite application with tool registry and Convex integration for 6digit AI coding assistants.\n\n## Overview\n\nThe 6digit Satellite Core provides the foundational framework for creating AI-powered coding satellites that can execute tools and commands on behalf of AI assistants. It handles persistent pairing, heartbeat monitoring, tool registration, and real-time communication with Convex backends.\n\n## Features\n\n- 🔗 **Persistent Pairing** - Satellites pair once and automatically reconnect\n- 💓 **Heartbeat Monitoring** - Keeps satellite sessions alive with server updates\n- 🛠️ **Tool Registry** - Register and execute custom tools with Zod validation\n- 📡 **Real-time Communication** - Convex integration for live tool invocations\n- 🆔 **Project-specific Identity** - Satellite identity stored per project\n- 🔧 **Built-in Tools** - Includes ping tool for connectivity testing\n\n## Installation\n\n```bash\nnpm install @6digit/satellite-core\n```\n\n## Quick Start\n\n```typescript\nimport { Satellite, pingTool } from '@6digit/satellite-core';\n\n// Create satellite instance\nconst satellite = new Satellite({\n  studioUrl: process.env.CONVEX_URL!,\n  authToken: process.env.STUDIO_API_KEY,\n  type: 'devour',\n  name: 'my-coding-satellite'\n});\n\n// Register tools\nconst toolRegistry = satellite.getToolRegistry();\ntoolRegistry.registerTool(pingTool);\n\n// Start satellite\nawait satellite.start();\n\n// The satellite will display a pairing code for first-time setup\n// After pairing, it automatically reconnects on subsequent starts\n```\n\n## Creating Custom Tools\n\n```typescript\nimport { SatelliteTool } from '@6digit/satellite-core';\nimport { z } from 'zod';\n\nexport const myCustomTool: SatelliteTool = {\n  name: 'myTool',\n  description: 'Does something useful',\n  parameters: z.object({\n    input: z.string().describe('Input parameter')\n  }),\n  execute: async (parameters) => {\n    // Your tool logic here\n    return { success: true, result: parameters.input };\n  }\n};\n\n// Register with satellite\ntoolRegistry.registerTool(myCustomTool);\n```\n\n## Environment Variables\n\n- `CONVEX_URL` - Your Convex deployment URL\n- `STUDIO_API_KEY` - Authentication token for 6digit Studio\n- `SATELLITE_NAME` - Optional satellite name (defaults to hostname)\n- `SATELLITE_CWD` - Optional working directory (defaults to process.cwd())\n\n## Architecture\n\nThe satellite system consists of:\n\n1. **Satellite Core** - Main application framework (this package)\n2. **Tool Registry** - Manages available tools and their execution\n3. **Convex Client** - Handles communication with backend\n4. **Persistent Identity** - Project-specific satellite identification\n\n## API Reference\n\n### Satellite Class\n\n```typescript\nclass Satellite {\n  constructor(config: SatelliteConfig)\n  start(): Promise<void>\n  stop(): Promise<void>\n  getToolRegistry(): ToolRegistry\n  sendHeartbeat(): Promise<void>\n  getMetadata(): SatelliteMetadata\n}\n```\n\n### SatelliteTool Interface\n\n```typescript\ninterface SatelliteTool {\n  name: string\n  description: string\n  parameters: z.ZodSchema<any>\n  execute: (parameters: any) => Promise<any>\n}\n```\n\n## License\n\nMIT\n\n## Contributing\n\nSee [CONTRIBUTING.md](../../CONTRIBUTING.md) for development guidelines.\n\n## Support\n\n- 🌐 Website: [6digit.studio](https://6digit.studio)\n- 📧 Issues: [GitHub Issues](https://github.com/6digit/satellite-core/issues)\n","readmeFilename":"README.md"}