{"_id":"@dexwox-labs/a2a-core","name":"@dexwox-labs/a2a-core","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@dexwox-labs/a2a-core","version":"0.1.0","description":"Core types, validation and telemetry for Google's Agent-to-Agent (A2A) protocol - shared foundation for client and server implementations","homepage":"https://dexwox-innovations-org.github.io/a2a-node-sdk/","repository":{"type":"git","url":"git+https://github.com/Dexwox-Innovations-Org/a2a-node-sdk.git"},"bugs":{"url":"https://github.com/Dexwox-Innovations-Org/a2a-node-sdk/issues"},"keywords":["a2a","agent-to-agent","google","protocol","typescript","core","types","validation","telemetry","zod","opentelemetry"],"main":"dist/index.js","types":"dist/index.d.ts","private":false,"scripts":{"clean":"rm -rf dist tsconfig.tsbuildinfo","build":"npm run clean && tsc --project tsconfig.json --outDir dist --declaration --declarationMap --emitDeclarationOnly && tsc --project tsconfig.json --outDir dist --skipLibCheck","test":"vitest","coverage":"vitest run --coverage","typecheck":"tsc --noEmit"},"dependencies":{"@opentelemetry/api":"^1.9.0","@opentelemetry/resources":"^2.0.1","@opentelemetry/sdk-node":"^0.201.1","@opentelemetry/semantic-conventions":"^1.33.0","json-schema-to-zod":"^2.6.1","zod":"^3.22.4"},"devDependencies":{"@types/node":"^20.11.0","@vitest/coverage-v8":"^3.1.3","typescript":"^5.8.3","vitest":"^3.1.3"},"license":"Apache-2.0","_id":"@dexwox-labs/a2a-core@0.1.0","gitHead":"2963afc9b336bedb260a2b8f2822d3202c7d6381","_nodeVersion":"22.3.0","_npmVersion":"10.8.1","dist":{"integrity":"sha512-EeV8hvg/ADPxtn+E7GMjreckaYEyXTDJxggxeh6gJzZsTlFeiNCFZkRIPyY1B/v5EPHKzedk/l1x4YnchBAAYA==","shasum":"8a6dc1e66ab4af0a8934ec3b4496bc33f8ba78c6","tarball":"https://registry.npmjs.org/@dexwox-labs/a2a-core/-/a2a-core-0.1.0.tgz","fileCount":88,"unpackedSize":304026,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCeL6ynUJtYEkuDM5gq7ZDPjMsdJc7KLAkCacxxPTl1nAIhAPU6MlW71Xkg/riMUJ4dXPpYtCyf+qdyHkUl97pF6cd+"}]},"_npmUser":{"name":"dexwoxinnovations","email":"developer@dexwox.com"},"directories":{},"maintainers":[{"name":"dexwoxinnovations","email":"developer@dexwox.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/a2a-core_0.1.0_1748460236081_0.4670671478831472"},"_hasShrinkwrap":false}},"time":{"created":"2025-05-28T19:23:56.021Z","0.1.0":"2025-05-28T19:23:56.279Z","modified":"2025-05-28T19:23:56.527Z"},"maintainers":[{"name":"dexwoxinnovations","email":"developer@dexwox.com"}],"description":"Core types, validation and telemetry for Google's Agent-to-Agent (A2A) protocol - shared foundation for client and server implementations","homepage":"https://dexwox-innovations-org.github.io/a2a-node-sdk/","keywords":["a2a","agent-to-agent","google","protocol","typescript","core","types","validation","telemetry","zod","opentelemetry"],"repository":{"type":"git","url":"git+https://github.com/Dexwox-Innovations-Org/a2a-node-sdk.git"},"bugs":{"url":"https://github.com/Dexwox-Innovations-Org/a2a-node-sdk/issues"},"license":"Apache-2.0","readme":"# @dexwox-labs/a2a-core\n\nShared types, utilities and protocols for implementing the Agent-to-Agent (A2A) communication protocol.\n\nThis package provides the foundation for the A2A protocol implementation, delivering essential types and utilities. Developed by [Dexwox Innovations Pvt Ltd](https://dexwox.com) to offer a comprehensive TypeScript implementation of the protocol standard.\n\n## Features\n\n- Common type definitions\n- Protocol specifications (A2A, JSON-RPC)\n- Validation decorators\n- Utility functions\n- Error classes\n- Message and task utilities\n\n## Installation\n\n```bash\nnpm install @dexwox-labs/a2a-core\n# or\npnpm add @dexwox-labs/a2a-core\n# or use the unified package\nnpm install @dexwox-labs/a2a-node\n```\n\n## Core Components\n\n### Types\n- `AgentCard`: Agent metadata definition\n- `Task`: Task lifecycle structure  \n- `Message`: Communication protocol\n- `ErrorResponse`: Standard error format\n\n### Protocols\n- Google A2A Protocol definitions and interfaces\n- JSON-RPC 2.0 types\n- WebSocket message formats\n\n### Decorators\n- `@ValidateParams`: Parameter validation\n- `@ValidateResponse`: Response validation\n- `@Trace` and `@TraceClass`: Telemetry and metrics collection\n\n### Utilities\n- Type converters\n- Schema validation\n- Message serialization\n- Task state management\n\n## Usage Examples\n\n### Using Core Types\n```typescript\nimport { AgentCard } from '@dexwox-labs/a2a-core';\n\nconst agent: AgentCard = {\n  id: 'weather-agent',\n  name: 'Weather Agent',\n  capabilities: ['weather-forecast'],\n  endpoint: 'http://weather-agent.example.com'\n};\n```\n\n### Validation Decorators\n```typescript\nimport { ValidateParams } from '@dexwox-labs/a2a-core';\n\nclass WeatherService {\n  @ValidateParams(weatherSchema)\n  async getForecast(location: string) {\n    // implementation\n  }\n}\n```\n\n### Protocol Utilities\n```typescript\nimport { parseMessage, serializeMessage } from '@dexwox-labs/a2a-core';\n\nconst message = parseMessage(rawMessage);\nconst wireFormat = serializeMessage(message);\n```\n\n## Testing\n\nRun tests with:\n```bash\ncd packages/core\npnpm test\n```\n\nGenerate coverage report:\n```bash\npnpm test -- --coverage\n```\n\n## Contributing\n\nSee [CONTRIBUTING.md](../CONTRIBUTING.md) for development guidelines.\n\n## Versioning\n\nFollows [Semantic Versioning](https://semver.org/). Breaking changes will result in major version bumps.\n","readmeFilename":"README.md","_rev":"1-95b1b214ace84fd9c85a547b4797a072"}