{"_id":"@agent-remote/core","_rev":"2-52fe7ba24045398353893ebb4815daf6","name":"@agent-remote/core","dist-tags":{"latest":"0.0.2"},"versions":{"0.0.1":{"name":"@agent-remote/core","version":"0.0.1","license":"Apache-2.0","_id":"@agent-remote/core@0.0.1","maintainers":[{"name":"loderunnr","email":"charles.francoise@gmail.com"}],"dist":{"shasum":"6d0c91e14fa64ccaedcc00d5a3f844889bfa6c75","tarball":"https://registry.npmjs.org/@agent-remote/core/-/core-0.0.1.tgz","fileCount":33,"integrity":"sha512-2lVzNSPaMfg48A/yWvUlwHWILP8zNSAMCVxmfJ0FpQlbPYPuIxwD/pMm5Gyvh5gzs5pNwCFZ1LpAb289CpAufQ==","signatures":[{"sig":"MEQCIBYxVBlpky2A09iZQCOS8jreKyXXnx9qsnFJfiz4+l62AiBbpE4tZOkd5A++IpDEpXJTMOI+bARMmsdCfOX14X2/TA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":60243},"type":"module","_from":"file:agent-remote-core-0.0.1.tgz","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"build":"tsc --build","clean":"rimraf dist","build:watch":"tsc --build --watch"},"_npmUser":{"name":"loderunnr","email":"charles.francoise@gmail.com"},"_resolved":"/tmp/2bfc0a5679a917fe780f816cfe307c44/agent-remote-core-0.0.1.tgz","_integrity":"sha512-2lVzNSPaMfg48A/yWvUlwHWILP8zNSAMCVxmfJ0FpQlbPYPuIxwD/pMm5Gyvh5gzs5pNwCFZ1LpAb289CpAufQ==","_npmVersion":"11.6.0","description":"Core types and schemas for agent-remote tools","directories":{},"_nodeVersion":"24.9.0","dependencies":{"zod":"^3.25.76"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tslib":"^2.8.1","rimraf":"^6.0.1","typescript":"^5.9.3","@modelcontextprotocol/sdk":"^1.20.0"},"peerDependencies":{"@modelcontextprotocol/sdk":"^1.20.0"},"_npmOperationalInternal":{"tmp":"tmp/core_0.0.1_1761579875787_0.8519614019934549","host":"s3://npm-registry-packages-npm-production"}},"0.0.2":{"name":"@agent-remote/core","version":"0.0.2","description":"Core types and schemas for agent-remote tools","license":"Apache-2.0","type":"module","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"publishConfig":{"access":"public"},"dependencies":{"zod":"^3.25.76"},"peerDependencies":{"@modelcontextprotocol/sdk":"^1.20.0"},"devDependencies":{"@modelcontextprotocol/sdk":"^1.20.0","rimraf":"^6.0.1","typescript":"^5.9.3","tslib":"^2.8.1"},"scripts":{"build":"tsc --build","build:watch":"tsc --build --watch","clean":"rimraf dist"},"_id":"@agent-remote/core@0.0.2","_integrity":"sha512-x4EVbDtR7juqFYsM9vL7CSuZFV5cB0Sh6iRTL89AOELou9TBeNnhfmMF3bFEfLFaCUmO7A73TkoeBuRS1yk8cA==","_resolved":"/tmp/f3cf461539a5eaa98df93ffafb7152b1/agent-remote-core-0.0.2.tgz","_from":"file:agent-remote-core-0.0.2.tgz","_nodeVersion":"24.9.0","_npmVersion":"11.6.0","dist":{"integrity":"sha512-x4EVbDtR7juqFYsM9vL7CSuZFV5cB0Sh6iRTL89AOELou9TBeNnhfmMF3bFEfLFaCUmO7A73TkoeBuRS1yk8cA==","shasum":"e127888405466d32d1c155ef3e089cba4ae2d8f6","tarball":"https://registry.npmjs.org/@agent-remote/core/-/core-0.0.2.tgz","fileCount":33,"unpackedSize":60243,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDaKeUS3fKmQQ0soSR1WWuuXhvVUFWjWE4/cVH45rz+rAIhAMxGkJ6duG5SEOOGuoz12EU7kTlFxlGffvPccKh7cste"}]},"_npmUser":{"name":"loderunnr","email":"charles.francoise@gmail.com"},"directories":{},"maintainers":[{"name":"loderunnr","email":"charles.francoise@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/core_0.0.2_1761580358991_0.21420659438464984"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-27T15:44:35.698Z","modified":"2025-10-27T15:52:39.404Z","0.0.1":"2025-10-27T15:44:35.969Z","0.0.2":"2025-10-27T15:52:39.173Z"},"license":"Apache-2.0","description":"Core types and schemas for agent-remote tools","maintainers":[{"name":"loderunnr","email":"charles.francoise@gmail.com"}],"readme":"# @agent-remote/core\n\nCore types and schemas for agent-remote tools.\n\n## Overview\n\nThis package provides TypeScript types and Zod schemas for remote tool\ndefinitions. It uses TypeScript project references with minimal build\nrequirements - only generating `.d.ts` declaration files needed for type\nchecking.\n\n## Features\n\n- **Pure TypeScript types** - All input/output types with full JSDoc\n  documentation\n- **Zod schemas** - Runtime validation schemas for all inputs\n- **Tool definitions** - Generic tool definition types for MCP integration\n- **Minimal build** - Only generates declaration files for TypeScript project\n  references\n\n## Usage\n\n```typescript\nimport type { BashInput, FileReadInput, GrepOutput } from '@agent-remote/core';\nimport { bashInputSchema, fileReadInputSchema } from '@agent-remote/core';\n\n// Use types for type checking\nconst input: BashInput = {\n  command: 'ls -la',\n  timeout: 5000,\n};\n\n// Use schemas for validation\nconst result = bashInputSchema.parse(input);\n```\n\n## Building Remote Integrations\n\nThis package is designed to be used in two scenarios:\n\n### Internal Usage (Monorepo Packages)\n\nFor packages within this monorepo (like `@agent-remote/ssh`):\n\n**1. Add as dev dependency:**\n\n```json\n{\n  \"devDependencies\": {\n    \"@agent-remote/core\": \"workspace:*\"\n  }\n}\n```\n\n**2. Configure TypeScript project references:**\n\n```json\n{\n  \"extends\": \"../../tsconfig.json\",\n  \"compilerOptions\": {\n    /* ... */\n  },\n  \"references\": [{ \"path\": \"../core\" }]\n}\n```\n\n**3. Bundle core in your build configuration:**\n\nFor tsdown/rolldown:\n\n```typescript\nexport const config: Options = {\n  entry: 'src/index.ts',\n  format: 'esm',\n  noExternal: ['@agent-remote/core'], // Bundle core completely\n  // ...\n};\n```\n\nFor other bundlers, ensure `@agent-remote/core` is not treated as external.\n\n**Why bundle?** This keeps your package standalone with zero runtime\ndependencies on internal packages, avoiding build orchestration complexity.\n\n**Development workflow:**\n\n- Edit core types → changes immediately visible via TypeScript\n- Build your package → core gets bundled automatically at latest version\n- No need to rebuild core separately\n\n### External Usage (3rd-Party Packages)\n\nFor external packages building their own remote integrations:\n\n**1. Install from npm:**\n\n```bash\nnpm install @agent-remote/core\n```\n\n**2. Import types and schemas:**\n\n```typescript\nimport type { BashInput, BashToolDefinition } from '@agent-remote/core';\nimport { bashInputSchema } from '@agent-remote/core';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\n\n// Create a tool definition using core types\nexport const bashTool: BashToolDefinition = {\n  name: 'bash',\n  description: 'Execute bash commands on my remote system',\n  inputSchema: bashInputSchema,\n  handler: async (input: BashInput): Promise<CallToolResult> => {\n    // Validate input\n    bashInputSchema.parse(input);\n\n    // Connect to your remote system and execute the command\n    // (implementation depends on your transport: SSH, Docker, Kubernetes, etc.)\n\n    return {\n      content: [{ type: 'text', text: 'command output here' }],\n    };\n  },\n};\n```\n\n## Building\n\n```bash\npnpm build  # Generates declaration files only\n```\n\nThe build command runs `tsc --build` which generates `.d.ts` files and compiles\nthe source to `.js` for the composite project reference system.\n\n## License\n\nApache-2.0\n","readmeFilename":"README.md"}