{"_id":"@aevatar/kit-types","_rev":"3-fb7301bade35c54d06e2ee3d5e791eae","name":"@aevatar/kit-types","dist-tags":{"latest":"1.2.1"},"versions":{"0.3.0":{"name":"@aevatar/kit-types","version":"0.3.0","keywords":["aevatar","types","typescript","ag-ui","a2ui"],"_id":"@aevatar/kit-types@0.3.0","maintainers":[{"name":"potterf","email":"potter.sun@aelf.io"}],"homepage":"https://github.com/aevatar/aevatarkit-ui#readme","bugs":{"url":"https://github.com/aevatar/aevatarkit-ui/issues"},"dist":{"shasum":"5bc46bae88aafd65fccf34e17781ee9e1a7a08e6","tarball":"https://registry.npmjs.org/@aevatar/kit-types/-/kit-types-0.3.0.tgz","fileCount":9,"integrity":"sha512-Z43VPSf3pTvlWjYcc7PcQAtUxNZz41pBvubErPy+B8Te/RIshqYER9c4W4l+8A0kmYc+20t/wsoof9GDgIDlUg==","signatures":[{"sig":"MEYCIQCobsK7vMxiLw7HeK5TKDZvCgVf9E6MWlLDd8paK/LKGAIhAN4AJeZFKhkvr11ZNf9rrNuyaiJWmBQUK6taTk113TRx","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":121511},"main":"./dist/index.js","_from":"file:aevatar-kit-types-0.3.0.tgz","types":"./dist/index.d.ts","module":"./dist/index.mjs","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"}},"scripts":{"dev":"tsup --watch","build":"tsup","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"_npmUser":{"name":"potterf","email":"potter.sun@aelf.io"},"_resolved":"/private/var/folders/d9/bmbzh5n14v7byzn_zznk3gr80000gn/T/bb64000cb4c11b9f44f685eee5e84d69/aevatar-kit-types-0.3.0.tgz","_integrity":"sha512-Z43VPSf3pTvlWjYcc7PcQAtUxNZz41pBvubErPy+B8Te/RIshqYER9c4W4l+8A0kmYc+20t/wsoof9GDgIDlUg==","repository":{"url":"git+https://github.com/aevatar/aevatarkit-ui.git","type":"git","directory":"packages/kit-types"},"_npmVersion":"10.7.0","description":"Type definitions for AevatarKit SDK","directories":{},"_nodeVersion":"18.20.3","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","typescript":"^5.3.0"},"_npmOperationalInternal":{"tmp":"tmp/kit-types_0.3.0_1767687869164_0.9623602117842727","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@aevatar/kit-types","version":"1.1.0","keywords":["aevatar","types","typescript","ag-ui","a2ui"],"_id":"@aevatar/kit-types@1.1.0","maintainers":[{"name":"potterf","email":"potter.sun@aelf.io"}],"homepage":"https://github.com/aevatar/aevatarkit-ui#readme","bugs":{"url":"https://github.com/aevatar/aevatarkit-ui/issues"},"dist":{"shasum":"463090ec4e27a4658d98e3769d4b3616cbbb74e8","tarball":"https://registry.npmjs.org/@aevatar/kit-types/-/kit-types-1.1.0.tgz","fileCount":9,"integrity":"sha512-HdWZ1NTQSPXQHq5FKDONP3WMt89vvusVFppGIQs0KZDVFjV8PzUy2cjbuC/Iwye3o5bnERnAugHB7tGe9lQs2Q==","signatures":[{"sig":"MEUCIFjGh96D+MbMQrDeSwWNYaXjma2t8F63oNZXryYBBVsvAiEAsQqraYp8qRgF9X8Fx+5JuQo6L5G4OuiwAF8ZJSQh8hs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":121511},"main":"./dist/index.js","_from":"file:aevatar-kit-types-1.1.0.tgz","types":"./dist/index.d.ts","module":"./dist/index.mjs","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"}},"scripts":{"dev":"tsup --watch","build":"tsup","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"_npmUser":{"name":"potterf","email":"potter.sun@aelf.io"},"_resolved":"/private/var/folders/d9/bmbzh5n14v7byzn_zznk3gr80000gn/T/de53bd69fd51775688ec957a06363f55/aevatar-kit-types-1.1.0.tgz","_integrity":"sha512-HdWZ1NTQSPXQHq5FKDONP3WMt89vvusVFppGIQs0KZDVFjV8PzUy2cjbuC/Iwye3o5bnERnAugHB7tGe9lQs2Q==","repository":{"url":"git+https://github.com/aevatar/aevatarkit-ui.git","type":"git","directory":"packages/kit-types"},"_npmVersion":"10.7.0","description":"Type definitions for AevatarKit SDK","directories":{},"_nodeVersion":"18.20.3","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","typescript":"^5.3.0"},"_npmOperationalInternal":{"tmp":"tmp/kit-types_1.1.0_1767769285635_0.14352040681284572","host":"s3://npm-registry-packages-npm-production"}},"1.2.1":{"name":"@aevatar/kit-types","version":"1.2.1","description":"Type definitions for AevatarKit SDK","main":"./dist/index.js","module":"./dist/index.mjs","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"}},"devDependencies":{"tsup":"^8.0.0","typescript":"^5.3.0"},"repository":{"type":"git","url":"git+https://github.com/aevatar/aevatarkit-ui.git","directory":"packages/kit-types"},"homepage":"https://github.com/aevatar/aevatarkit-ui#readme","publishConfig":{"access":"public"},"keywords":["aevatar","types","typescript","ag-ui","a2ui"],"scripts":{"build":"tsup","dev":"tsup --watch","typecheck":"tsc --noEmit","clean":"rm -rf dist"},"_id":"@aevatar/kit-types@1.2.1","bugs":{"url":"https://github.com/aevatar/aevatarkit-ui/issues"},"_integrity":"sha512-xMscfzR/r4Op+AGdK6SRnLe+NtSh0Wz2AMTcshWNSQDLSkE3KN4rrvk1CRkNdqJlqUzIfSqMJ/Yr0soQpE0fJQ==","_resolved":"/private/var/folders/d9/bmbzh5n14v7byzn_zznk3gr80000gn/T/7587a7e7c221ef99ae1c61054ee735dd/aevatar-kit-types-1.2.1.tgz","_from":"file:aevatar-kit-types-1.2.1.tgz","_nodeVersion":"18.20.3","_npmVersion":"10.7.0","dist":{"integrity":"sha512-xMscfzR/r4Op+AGdK6SRnLe+NtSh0Wz2AMTcshWNSQDLSkE3KN4rrvk1CRkNdqJlqUzIfSqMJ/Yr0soQpE0fJQ==","shasum":"745e956dae95684328d2b7ab3bbfcbcea4562de0","tarball":"https://registry.npmjs.org/@aevatar/kit-types/-/kit-types-1.2.1.tgz","fileCount":9,"unpackedSize":151180,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIGPekEVm1fD5pAiVBlYKILD0Ai4F1OxlyjFE2E/HuCAXAiBd1Isyg/l172xTGKMuuqUsdIPpAb6Pwu1DlkAbAxZ7RQ=="}]},"_npmUser":{"name":"potterf","email":"potter.sun@aelf.io"},"directories":{},"maintainers":[{"name":"potterf","email":"potter.sun@aelf.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/kit-types_1.2.1_1768983992122_0.22266578263928016"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-06T08:24:29.096Z","modified":"2026-01-21T08:26:32.412Z","0.3.0":"2026-01-06T08:24:29.298Z","1.1.0":"2026-01-07T07:01:25.813Z","1.2.1":"2026-01-21T08:26:32.260Z"},"bugs":{"url":"https://github.com/aevatar/aevatarkit-ui/issues"},"homepage":"https://github.com/aevatar/aevatarkit-ui#readme","keywords":["aevatar","types","typescript","ag-ui","a2ui"],"repository":{"type":"git","url":"git+https://github.com/aevatar/aevatarkit-ui.git","directory":"packages/kit-types"},"description":"Type definitions for AevatarKit SDK","maintainers":[{"name":"potterf","email":"potter.sun@aelf.io"}],"readme":"# @aevatar/kit-types\n\n> Pure TypeScript type definitions for AevatarKit SDK\n\n## Overview\n\nThis package provides all TypeScript type definitions for the AevatarKit SDK. It has **zero runtime dependencies** and is designed for type-only imports.\n\n## Installation\n\n```bash\npnpm add @aevatar/kit-types\n```\n\n## Type Categories\n\n### AG-UI Protocol Types (`agui.ts`)\n\nStandard AG-UI protocol event types:\n\n```typescript\nimport type {\n  AgUiEvent,\n  AgUiEventType,\n  AgUiMessage,\n  AgUiBaseEvent,\n  // Lifecycle\n  RunStartedEvent,\n  RunFinishedEvent,\n  RunErrorEvent,\n  StepStartedEvent,\n  StepFinishedEvent,\n  // Text streaming\n  TextMessageStartEvent,\n  TextMessageContentEvent,\n  TextMessageEndEvent,\n  // Tool calls\n  ToolCallStartEvent,\n  ToolCallArgsEvent,\n  ToolCallEndEvent,\n  ToolCallResultEvent,\n  // State\n  StateSnapshotEvent,\n  StateDeltaEvent,\n  MessagesSnapshotEvent,\n  // Extension\n  CustomEvent,\n} from '@aevatar/kit-types';\n```\n\n### Session Types (`session.ts`)\n\n```typescript\nimport type {\n  Session,\n  SessionSummary,\n  SessionStatus,\n  SessionState,\n  SessionConfig,\n  CreateSessionOptions,\n} from '@aevatar/kit-types';\n\n// Status: 'idle' | 'running' | 'completed' | 'failed' | 'closed'\n```\n\n### Run Types (`run.ts`)\n\n```typescript\nimport type {\n  Run,\n  RunSummary,\n  RunStatus,\n  RunInput,\n  StepInfo,\n} from '@aevatar/kit-types';\n\n// Status: 'pending' | 'running' | 'completed' | 'failed' | 'cancelled'\n```\n\n### Agent Types (`agent.ts`)\n\n```typescript\nimport type {\n  AgentInfo,\n  AgentSummary,\n  AgentCapability,\n  AgentTool,\n  CreateAgentOptions,\n} from '@aevatar/kit-types';\n\n// Capabilities: 'chat' | 'reasoning' | 'tool_calling' | 'code_generation' | ...\n```\n\n### Graph Types (`graph.ts`)\n\n```typescript\nimport type {\n  GraphDefinition,\n  GraphSummary,\n  GraphNode,\n  GraphEdge,\n} from '@aevatar/kit-types';\n```\n\n### Memory Types (`memory.ts`)\n\n```typescript\nimport type {\n  Memory,\n  MemorySearchOptions,\n  MemorySearchResult,\n} from '@aevatar/kit-types';\n```\n\n### Client Configuration (`client.ts`)\n\n```typescript\nimport type {\n  ClientOptions,\n  ConnectionStatus,\n  LogLevel,\n  LoggerOptions,\n} from '@aevatar/kit-types';\n\n// ConnectionStatus: 'disconnected' | 'connecting' | 'connected' | 'reconnecting' | 'error'\n```\n\n### Utility Types (`utils.ts`)\n\n```typescript\nimport type {\n  Unsubscribe,\n  EventHandler,\n  DeepPartial,\n} from '@aevatar/kit-types';\n```\n\n## Type Guards\n\nThe package includes type guards for AG-UI events:\n\n```typescript\nimport {\n  isRunStartedEvent,\n  isRunFinishedEvent,\n  isTextMessageContentEvent,\n  isStateSnapshotEvent,\n  isCustomEvent,\n} from '@aevatar/kit-types';\n\n// Usage\nif (isTextMessageContentEvent(event)) {\n  console.log(event.delta); // TypeScript knows this is TextMessageContentEvent\n}\n```\n\n## File Structure\n\n```\nsrc/\n├── index.ts      # Re-exports all\n├── agui.ts       # AG-UI protocol types\n├── session.ts    # Session types\n├── run.ts        # Run types\n├── agent.ts      # Agent types\n├── graph.ts      # Graph types\n├── memory.ts     # Memory types\n├── client.ts     # Client config types\n└── utils.ts      # Utility types\n```\n\n## Design Principles\n\n1. **Zero Runtime** - Types only, no JavaScript output\n2. **Tree-shakable** - Each module can be imported separately\n3. **AG-UI Aligned** - Follows AG-UI protocol specification\n4. **Strict Types** - No `any`, full type safety\n\n## Related Packages\n\n- [`@aevatar/kit-protocol`](../kit-protocol) - Uses these types\n- [`@aevatar/kit-core`](../kit-core) - Uses these types\n- [`@aevatar/kit-react`](../kit-react) - Uses these types\n\n## License\n\nMIT\n\n","readmeFilename":"README.md"}