{"_id":"@aerograph/contracts","_rev":"4-bf68c5476db70221cf8a7b40a19b49df","name":"@aerograph/contracts","dist-tags":{"latest":"0.3.0"},"versions":{"0.1.0":{"name":"@aerograph/contracts","version":"0.1.0","keywords":["ai","agent","contracts","trace","zod"],"license":"Apache-2.0","_id":"@aerograph/contracts@0.1.0","maintainers":[{"name":"sgcpu","email":"sian.frcrce.stuco@gmail.com"}],"homepage":"https://github.com/SGcpu/AeroGraph#readme","bugs":{"url":"https://github.com/SGcpu/AeroGraph/issues"},"dist":{"shasum":"87d6c1832da9f5c90c39f20c11bd4d797075ce0d","tarball":"https://registry.npmjs.org/@aerograph/contracts/-/contracts-0.1.0.tgz","fileCount":9,"integrity":"sha512-j40/beRUAv2CFhMbz6aB+Tvsh1h4zJZhChH+u4iGffXPA3zMl2zuVpWxsK8Mnd5+cbnqWA5g+08+eiLMNsCYqQ==","signatures":[{"sig":"MEQCIGxQghl672+Nh7IVVBLVktaIwNvWtNLwtTncZ/6xwBbkAiAK1pmcPKl2/1cG1TJCOAPtfbQtikgW67hfibuc8FXUfg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":159070},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"78b10bff882d92a0e04cb1b777b5dd7579105ca5","private":false,"scripts":{"dev":"tsc -p tsconfig.json --watch","lint":"eslint .","test":"vitest run","build":"tsc -p tsconfig.json","prebuild":"node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\""},"_npmUser":{"name":"sgcpu","email":"sian.frcrce.stuco@gmail.com"},"repository":{"url":"git+https://github.com/SGcpu/AeroGraph.git","type":"git"},"_npmVersion":"11.5.2","description":"Shared Zod contracts for AeroGraph trace events and APIs.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"zod":"^3.25.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.9.0","vitest":"^2.1.0","@eslint/js":"^9.9.0","typescript":"^5.6.0","typescript-eslint":"^8.0.0"},"_npmOperationalInternal":{"tmp":"tmp/contracts_0.1.0_1779656865712_0.3423456547259356","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@aerograph/contracts","version":"0.2.0","keywords":["ai","agent","contracts","trace","zod"],"license":"Apache-2.0","_id":"@aerograph/contracts@0.2.0","maintainers":[{"name":"sgcpu","email":"sian.frcrce.stuco@gmail.com"}],"homepage":"https://github.com/SGcpu/AeroGraph#readme","bugs":{"url":"https://github.com/SGcpu/AeroGraph/issues"},"dist":{"shasum":"5a6fa99c2fe9dda9708c26889b209799b4c270f3","tarball":"https://registry.npmjs.org/@aerograph/contracts/-/contracts-0.2.0.tgz","fileCount":9,"integrity":"sha512-uA0gf/KmAE26qatM03KAfJ+C77WNnbHNUUmZJEIn7mCOAPEPWqDqaDW1qQVt47tJRXG5UCIRdeNAAI4u5NwN3w==","signatures":[{"sig":"MEUCIQCwpPwdnJnQvlSmlEtTyB//yAbwaeeljUVdKZ/3WvRCngIgc+s1C66RSo3a32aFvLiWvDK8hR00Xq+E6/nRzSwmzUg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":195807},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"f4f3747cd6026d768e7f6f4d1b43de22f10b0d30","private":false,"scripts":{"dev":"tsc -p tsconfig.json --watch","lint":"eslint .","test":"vitest run","build":"tsc -p tsconfig.json","prebuild":"node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\""},"_npmUser":{"name":"sgcpu","email":"sian.frcrce.stuco@gmail.com"},"repository":{"url":"git+https://github.com/SGcpu/AeroGraph.git","type":"git"},"_npmVersion":"11.5.2","description":"Shared Zod contracts for AeroGraph trace events and APIs.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"zod":"^3.25.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.9.0","vitest":"^2.1.0","@eslint/js":"^9.9.0","typescript":"^5.6.0","typescript-eslint":"^8.0.0"},"_npmOperationalInternal":{"tmp":"tmp/contracts_0.2.0_1780467747870_0.9194799509893683","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@aerograph/contracts","version":"0.2.1","keywords":["ai","agent","contracts","trace","zod"],"license":"Apache-2.0","_id":"@aerograph/contracts@0.2.1","maintainers":[{"name":"sgcpu","email":"sian.frcrce.stuco@gmail.com"}],"homepage":"https://github.com/SGcpu/AeroGraph#readme","bugs":{"url":"https://github.com/SGcpu/AeroGraph/issues"},"dist":{"shasum":"c5e73665390403fc808c3dd1f8eb45719c3ccf33","tarball":"https://registry.npmjs.org/@aerograph/contracts/-/contracts-0.2.1.tgz","fileCount":10,"integrity":"sha512-bzUsDKP8JesxvKfFtdug6I/Ywz/079aHcu1FrR7XVjBPojOBDhVv9Gs5CxztehuetntpoHOAOvXWDi7tFjHOMQ==","signatures":[{"sig":"MEUCIDCMr5uUznBtk5ThXdRo7Zp6mogkN/Bin7qyxQSSdr8XAiEA7pqte9qLNP4XWoDq2BEceuPGi+n3LaCohcwsqsO60Ag=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":197164},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"73ae8bebcf941d8f9abd0649da761cca15d19794","private":false,"scripts":{"dev":"tsc -p tsconfig.json --watch","lint":"eslint .","test":"vitest run","build":"tsc -p tsconfig.json","prebuild":"node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\""},"_npmUser":{"name":"sgcpu","email":"sian.frcrce.stuco@gmail.com"},"repository":{"url":"git+https://github.com/SGcpu/AeroGraph.git","type":"git"},"_npmVersion":"11.5.2","description":"Shared Zod contracts for AeroGraph trace events and APIs.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"zod":"^3.25.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.9.0","vitest":"^2.1.0","@eslint/js":"^9.9.0","typescript":"^5.6.0","typescript-eslint":"^8.0.0"},"_npmOperationalInternal":{"tmp":"tmp/contracts_0.2.1_1781117154941_0.9178544317363884","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@aerograph/contracts","version":"0.3.0","private":false,"description":"Shared Zod contracts for AeroGraph trace events and APIs.","type":"module","main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"license":"Apache-2.0","repository":{"type":"git","url":"git+https://github.com/SGcpu/AeroGraph.git"},"bugs":{"url":"https://github.com/SGcpu/AeroGraph/issues"},"homepage":"https://github.com/SGcpu/AeroGraph#readme","publishConfig":{"access":"public"},"keywords":["ai","agent","contracts","trace","zod"],"scripts":{"prebuild":"node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\"","build":"tsc -p tsconfig.json","dev":"tsc -p tsconfig.json --watch","test":"vitest run","lint":"eslint ."},"dependencies":{"zod":"^3.25.0"},"devDependencies":{"typescript":"^5.6.0","vitest":"^2.1.0","eslint":"^9.9.0","@eslint/js":"^9.9.0","typescript-eslint":"^8.0.0"},"_id":"@aerograph/contracts@0.3.0","gitHead":"9504b907ff5e3c49d3ec8c6e8f47fb2f46d1436f","_nodeVersion":"22.17.1","_npmVersion":"11.5.2","dist":{"integrity":"sha512-hzBzk1IPNc7MKeLAsn1KzgoKObuF7EELP0pt7w2MbwE76gpqwEfkxihN2wYvyGDpJBckF4CAda0VmfzfdW5eRw==","shasum":"1886bab8dba68773d352a43b752f05e19bec30f5","tarball":"https://registry.npmjs.org/@aerograph/contracts/-/contracts-0.3.0.tgz","fileCount":10,"unpackedSize":273401,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCSUgHI+xuXGyvc1PcbsQqrJcdE/i5G+4Ir4MSmiShgvwIgb0J+q+eD120udRmmuEZq6K9Q6o7DUqJizDmdy9t3VUM="}]},"_npmUser":{"name":"sgcpu","email":"sian.frcrce.stuco@gmail.com"},"directories":{},"maintainers":[{"name":"sgcpu","email":"sian.frcrce.stuco@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/contracts_0.3.0_1782813445344_0.20636062042395986"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-24T21:07:45.543Z","modified":"2026-06-30T09:57:25.665Z","0.1.0":"2026-05-24T21:07:45.907Z","0.2.0":"2026-06-03T06:22:28.047Z","0.2.1":"2026-06-10T18:45:55.099Z","0.3.0":"2026-06-30T09:57:25.555Z"},"bugs":{"url":"https://github.com/SGcpu/AeroGraph/issues"},"license":"Apache-2.0","homepage":"https://github.com/SGcpu/AeroGraph#readme","keywords":["ai","agent","contracts","trace","zod"],"repository":{"type":"git","url":"git+https://github.com/SGcpu/AeroGraph.git"},"description":"Shared Zod contracts for AeroGraph trace events and APIs.","maintainers":[{"name":"sgcpu","email":"sian.frcrce.stuco@gmail.com"}],"readme":"# @aerograph/contracts\r\n\r\nThe single source of truth for all AeroGraph Event schemas using Zod.\r\n\r\n## Overview\r\n\r\nAeroGraph employs a strict contract-first architecture. This package defines the canonical `TraceEvent` schemas, lineage graph types, and topological structures using Zod. It ensures deterministic validation on both ingress and egress at the collector.\r\n\r\n## Installation\r\n\r\n```bash\r\nnpm install @aerograph/contracts\r\n```\r\n\r\n*(Requires Node.js >= 18.18.0)*\r\n\r\n## Usage\r\n\r\nUse this package if you are building custom ingestion tools, backend extensions, or parsing scripts that need to validate AeroGraph schemas natively in TypeScript.\r\n\r\n```typescript\r\nimport { validateTraceEvent, TraceEvent } from \"@aerograph/contracts\";\r\n\r\nconst rawEvent = {\r\n  schemaVersion: \"1.0.0\",\r\n  traceId: \"some-trace-id\",\r\n  spanId: \"some-span-id\",\r\n  parentSpanId: null,\r\n  occurredAt: \"2026-06-10T12:00:00.000Z\",\r\n  actor: { kind: \"system\", id: \"app\" },\r\n  kind: \"note\",\r\n  status: \"ok\",\r\n  links: [],\r\n  payload: { key: \"value\" }\r\n};\r\n\r\n// Validates the shape and returns a typed TraceEvent, or throws a ZodError\r\nconst event: TraceEvent = validateTraceEvent(rawEvent);\r\n```\r\n\r\n## Available Schemas\r\n\r\n- `traceEventSchema` (Supports v1.1.0 with canonical `model`, `usage`, `projectId`, and `environment`)\r\n- `traceLineageGraphSchema`\r\n- `traceForkRequestSchema`\r\n- `traceAnalysisSchema`\r\n- `traceDiffResultSchema`\r\n- `traceStatsSchema`\r\n\r\n## License\r\nApache-2.0\r\n","readmeFilename":"README.md"}