{"_id":"@aevatar/kit","_rev":"5-179c24fccd632a7a41e52e7f0c0d4c78","name":"@aevatar/kit","dist-tags":{"latest":"1.2.1"},"versions":{"0.3.0":{"name":"@aevatar/kit","version":"0.3.0","keywords":["aevatar","agent","ai","ag-ui","sdk","react"],"_id":"@aevatar/kit@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":"329cdccb2eb8046267d7e1ec7de91fb543499478","tarball":"https://registry.npmjs.org/@aevatar/kit/-/kit-0.3.0.tgz","fileCount":9,"integrity":"sha512-eoqb982ozMms3e4HI4s7LMbwWt7dQoP5gFR+Sfqrpon7GPcdBBfuv4rCVCVIPhTj8WFQz0cBnxNyAqCTogrQSA==","signatures":[{"sig":"MEYCIQDWCUYQ3IY6RuL2GYtriLeWmXC8ZaLngI8en0EsXjDVQgIhAJHDbgRKzEJ+nkJKe7TdTRNqYVUM5EcF+om/OQK0Wj5M","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":12987203},"main":"./dist/index.js","_from":"file:aevatar-kit-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"},"./styles.css":"./dist/styles.css"},"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/0c0bc40184c65edef6e1c21dd2fe9e87/aevatar-kit-0.3.0.tgz","_integrity":"sha512-eoqb982ozMms3e4HI4s7LMbwWt7dQoP5gFR+Sfqrpon7GPcdBBfuv4rCVCVIPhTj8WFQz0cBnxNyAqCTogrQSA==","repository":{"url":"git+https://github.com/aevatar/aevatarkit-ui.git","type":"git","directory":"packages/kit"},"_npmVersion":"10.7.0","description":"AevatarKit SDK - Complete TypeScript SDK for Aevatar Agent Framework","directories":{},"_nodeVersion":"18.20.3","dependencies":{"@aevatar/kit-a2ui":"0.3.0","@aevatar/kit-core":"0.3.0","@aevatar/kit-react":"0.3.0","@aevatar/kit-types":"0.3.0","@aevatar/kit-protocol":"0.3.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","react":"^18.2.0","typescript":"^5.3.0","@types/react":"^18.2.0"},"peerDependencies":{"react":"^18.0.0","react-dom":"^18.0.0"},"peerDependenciesMeta":{"react":{"optional":true},"react-dom":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/kit_0.3.0_1767689142019_0.9837199497129345","host":"s3://npm-registry-packages-npm-production"}},"1.0.0":{"name":"@aevatar/kit","version":"1.0.0","keywords":["aevatar","agent","ai","ag-ui","sdk","react"],"_id":"@aevatar/kit@1.0.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":"cf704e9ab5182c5b6d39aa4736cc5a14330f17a0","tarball":"https://registry.npmjs.org/@aevatar/kit/-/kit-1.0.0.tgz","fileCount":9,"integrity":"sha512-e44GukO8wgPHm6A5hqzgZItEuelU+oYKOALUDvb1oExujBUTbni15S3gjglqNhFcwpNgJTpU4LC5zyvLh+Qm8A==","signatures":[{"sig":"MEUCIQCx/KK6T7gESXps6uy9rlhmNgaKOxo/8F12GJqRl2wW8gIgJ/n8uK7nRT1HKLMrdl2HTzXTFpViOw1bmjQZvNJiIOg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":12987363},"main":"./dist/index.js","_from":"file:aevatar-kit-1.0.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"},"./styles.css":"./dist/styles.css"},"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/794c8976d93dbd43d054620a0fd57cf4/aevatar-kit-1.0.0.tgz","_integrity":"sha512-e44GukO8wgPHm6A5hqzgZItEuelU+oYKOALUDvb1oExujBUTbni15S3gjglqNhFcwpNgJTpU4LC5zyvLh+Qm8A==","repository":{"url":"git+https://github.com/aevatar/aevatarkit-ui.git","type":"git","directory":"packages/kit"},"_npmVersion":"10.7.0","description":"AevatarKit SDK - Complete TypeScript SDK for Aevatar Agent Framework","directories":{},"_nodeVersion":"18.20.3","dependencies":{"@aevatar/kit-a2ui":"1.0.0","@aevatar/kit-core":"1.0.0","@aevatar/kit-react":"1.0.0","@aevatar/kit-types":"0.3.0","@aevatar/kit-protocol":"1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","react":"^18.2.0","typescript":"^5.3.0","@types/react":"^18.2.0"},"peerDependencies":{"react":"^18.0.0","react-dom":"^18.0.0"},"peerDependenciesMeta":{"react":{"optional":true},"react-dom":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/kit_1.0.0_1767757712134_0.7597613408208528","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@aevatar/kit","version":"1.1.0","keywords":["aevatar","agent","ai","ag-ui","sdk","react"],"_id":"@aevatar/kit@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":"4bdaccb6e3045a65d837a2084bcd1b5bff85331f","tarball":"https://registry.npmjs.org/@aevatar/kit/-/kit-1.1.0.tgz","fileCount":6,"integrity":"sha512-lhQtnSrggvd9wxZ39oJgkkme4A4j4bn0yZM3AgPJ/pTzfCnWIKBA1Hgph0p2GecUm3yRtmCWE01aP1SyJP+1kw==","signatures":[{"sig":"MEYCIQCJm0avkFSztipPujwBpE3m1OTPI7X+zKd5pjd2en35UAIhAPey1ZwNSzpPqKtk1gmWSu4Xir3rdl6lhEHCvtArKKKq","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":165948},"main":"./dist/index.js","type":"module","_from":"file:aevatar-kit-1.1.0.tgz","types":"./dist/index.d.ts","module":"./dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"},"./styles.css":"./dist/styles.css"},"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/9ad66747fca301511631b5916cfbe326/aevatar-kit-1.1.0.tgz","_integrity":"sha512-lhQtnSrggvd9wxZ39oJgkkme4A4j4bn0yZM3AgPJ/pTzfCnWIKBA1Hgph0p2GecUm3yRtmCWE01aP1SyJP+1kw==","repository":{"url":"git+https://github.com/aevatar/aevatarkit-ui.git","type":"git","directory":"packages/kit"},"_npmVersion":"10.7.0","description":"AevatarKit SDK - Complete TypeScript SDK for Aevatar Agent Framework","directories":{},"sideEffects":false,"_nodeVersion":"18.20.3","dependencies":{"@aevatar/kit-a2ui":"1.1.0","@aevatar/kit-core":"1.1.0","@aevatar/kit-react":"1.1.0","@aevatar/kit-types":"1.1.0","@aevatar/kit-protocol":"1.1.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","react":"^18.2.0","typescript":"^5.3.0","@types/react":"^18.2.0"},"peerDependencies":{"react":"^18.0.0","react-dom":"^18.0.0"},"peerDependenciesMeta":{"react":{"optional":true},"react-dom":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/kit_1.1.0_1767769305745_0.7114102628201546","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@aevatar/kit","version":"1.2.0","keywords":["aevatar","agent","ai","ag-ui","sdk","react"],"_id":"@aevatar/kit@1.2.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":"1d3092e2ca9afcde609664d810651823fce6aee7","tarball":"https://registry.npmjs.org/@aevatar/kit/-/kit-1.2.0.tgz","fileCount":6,"integrity":"sha512-9zprljCuD6WC73+SJ0JprROXwFbpj+fC6OyWr5b9gKx2ZnGfi/3xX/7L5OnAN86V4OT6Fgj3Efmzois+OctAaw==","signatures":[{"sig":"MEUCIEnbEuSHc+JLfl2xR5pJYTKE8o0HurXMrUx+W0vGIsrNAiEA+SjoZ3u57q7TLyIcRIP0ZIQs8O4x2otKmpSXBX2+bBk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":212947},"main":"./dist/index.js","type":"module","_from":"file:aevatar-kit-1.2.0.tgz","types":"./dist/index.d.ts","module":"./dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"},"./styles.css":"./dist/styles.css"},"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/723f9258b8305d1fe16bd72807a56149/aevatar-kit-1.2.0.tgz","_integrity":"sha512-9zprljCuD6WC73+SJ0JprROXwFbpj+fC6OyWr5b9gKx2ZnGfi/3xX/7L5OnAN86V4OT6Fgj3Efmzois+OctAaw==","repository":{"url":"git+https://github.com/aevatar/aevatarkit-ui.git","type":"git","directory":"packages/kit"},"_npmVersion":"10.7.0","description":"AevatarKit SDK - Complete TypeScript SDK for Aevatar Agent Framework","directories":{},"sideEffects":false,"_nodeVersion":"18.20.3","dependencies":{"@aevatar/kit-a2ui":"1.2.0","@aevatar/kit-core":"1.2.0","@aevatar/kit-react":"1.2.0","@aevatar/kit-types":"1.1.0","@aevatar/kit-protocol":"1.2.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","react":"^18.2.0","typescript":"^5.3.0","@types/react":"^18.2.0"},"peerDependencies":{"react":"^18.0.0","react-dom":"^18.0.0"},"peerDependenciesMeta":{"react":{"optional":true},"react-dom":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/kit_1.2.0_1768204663448_0.9217760307281131","host":"s3://npm-registry-packages-npm-production"}},"1.2.1":{"name":"@aevatar/kit","version":"1.2.1","description":"AevatarKit SDK - Complete TypeScript SDK for Aevatar Agent Framework","type":"module","main":"./dist/index.js","module":"./dist/index.js","types":"./dist/index.d.ts","sideEffects":false,"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js"},"./styles.css":"./dist/styles.css"},"dependencies":{"@aevatar/kit-types":"1.2.1","@aevatar/kit-protocol":"1.2.1","@aevatar/kit-core":"1.2.1","@aevatar/kit-a2ui":"1.2.1","@aevatar/kit-react":"1.2.1"},"peerDependencies":{"react":"^18.0.0","react-dom":"^18.0.0"},"peerDependenciesMeta":{"react":{"optional":true},"react-dom":{"optional":true}},"devDependencies":{"@types/react":"^18.2.0","react":"^18.2.0","tsup":"^8.0.0","typescript":"^5.3.0"},"repository":{"type":"git","url":"git+https://github.com/aevatar/aevatarkit-ui.git","directory":"packages/kit"},"homepage":"https://github.com/aevatar/aevatarkit-ui#readme","bugs":{"url":"https://github.com/aevatar/aevatarkit-ui/issues"},"publishConfig":{"access":"public"},"keywords":["aevatar","agent","ai","ag-ui","sdk","react"],"scripts":{"build":"tsup","dev":"tsup --watch","typecheck":"tsc --noEmit","clean":"rm -rf dist"},"_id":"@aevatar/kit@1.2.1","_integrity":"sha512-HPowBJa7++FiN2sDMIlfhNW/Ip0Y7jrJIfdxC4lvu73sX52XebOxPzWaTovXKlMFjj2AO+hCxczA++ssFmKj5w==","_resolved":"/private/var/folders/d9/bmbzh5n14v7byzn_zznk3gr80000gn/T/71ed9fa90f8054d6906ca4e10d0da42e/aevatar-kit-1.2.1.tgz","_from":"file:aevatar-kit-1.2.1.tgz","_nodeVersion":"18.20.3","_npmVersion":"10.7.0","dist":{"integrity":"sha512-HPowBJa7++FiN2sDMIlfhNW/Ip0Y7jrJIfdxC4lvu73sX52XebOxPzWaTovXKlMFjj2AO+hCxczA++ssFmKj5w==","shasum":"fab0081ff369a461fbdd9cf6584153ef5e9d441d","tarball":"https://registry.npmjs.org/@aevatar/kit/-/kit-1.2.1.tgz","fileCount":6,"unpackedSize":251059,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCUn5u15McNten63QlTYLDR6KA/yZG3KjaRSdvogDWiOgIhALySKPbc8oX7CTjbbkiOFlraxTFGwfyED9l7u5WRLx9B"}]},"_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_1.2.1_1768983992312_0.591118820722389"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-06T08:45:41.868Z","modified":"2026-01-21T08:26:33.811Z","0.3.0":"2026-01-06T08:45:42.245Z","1.0.0":"2026-01-07T03:48:32.401Z","1.1.0":"2026-01-07T07:01:45.881Z","1.2.0":"2026-01-12T07:57:43.578Z","1.2.1":"2026-01-21T08:26:33.650Z"},"bugs":{"url":"https://github.com/aevatar/aevatarkit-ui/issues"},"homepage":"https://github.com/aevatar/aevatarkit-ui#readme","keywords":["aevatar","agent","ai","ag-ui","sdk","react"],"repository":{"type":"git","url":"git+https://github.com/aevatar/aevatarkit-ui.git","directory":"packages/kit"},"description":"AevatarKit SDK - Complete TypeScript SDK for Aevatar Agent Framework","maintainers":[{"name":"potterf","email":"potter.sun@aelf.io"}],"readme":"# @aevatar/kit\n\n> Complete TypeScript SDK for Aevatar Agent Framework\n\n## Overview\n\nThis is the main package of AevatarKit SDK. It re-exports all sub-packages for convenience, allowing you to import everything from a single entry point.\n\n## Installation\n\n```bash\n# Using pnpm (recommended)\npnpm add @aevatar/kit\n\n# Using npm\nnpm install @aevatar/kit\n\n# Using yarn\nyarn add @aevatar/kit\n```\n\n## Quick Start\n\n### Basic Usage (Vanilla JS/TS)\n\n```typescript\nimport { createAevatarClient } from '@aevatar/kit';\n\nconst client = createAevatarClient({\n  baseUrl: 'http://localhost:5001',\n  apiKey: 'your-api-key',\n});\n\nawait client.connect();\nconst session = await client.createSession();\nawait session.sendMessage('Hello, Aevatar!');\n\nsession.onEvent((event) => {\n  if (event.type === 'TEXT_MESSAGE_CONTENT') {\n    process.stdout.write(event.delta);\n  }\n});\n```\n\n### React Usage\n\n```tsx\nimport {\n  AevatarProvider,\n  useSession,\n  ChatPanel,\n} from '@aevatar/kit';\n\nfunction App() {\n  return (\n    <AevatarProvider client={{ baseUrl: 'http://localhost:5001' }}>\n      <Chat />\n    </AevatarProvider>\n  );\n}\n\nfunction Chat() {\n  const { session, createSession } = useSession();\n  \n  useEffect(() => {\n    createSession();\n  }, []);\n  \n  return <ChatPanel />;\n}\n```\n\n## What's Included\n\nThis package re-exports everything from:\n\n| Sub-package | What it provides |\n|-------------|------------------|\n| [`@aevatar/kit-types`](../kit-types) | TypeScript type definitions |\n| [`@aevatar/kit-protocol`](../kit-protocol) | AG-UI protocol implementation |\n| [`@aevatar/kit-core`](../kit-core) | Client, session, run management |\n| [`@aevatar/kit-react`](../kit-react) | React hooks and components |\n\n## Exports Overview\n\n### Types\n\n```typescript\nimport type {\n  // AG-UI Events\n  AgUiEvent,\n  AgUiEventType,\n  AgUiMessage,\n  RunStartedEvent,\n  TextMessageContentEvent,\n  StateSnapshotEvent,\n  CustomEvent,\n  \n  // Session\n  Session,\n  SessionState,\n  SessionStatus,\n  CreateSessionOptions,\n  \n  // Run\n  Run,\n  RunStatus,\n  RunInput,\n  StepInfo,\n  \n  // Agent\n  AgentInfo,\n  AgentCapability,\n  AgentTool,\n  \n  // Graph\n  GraphDefinition,\n  GraphNode,\n  GraphEdge,\n  \n  // Memory\n  Memory,\n  MemorySearchOptions,\n  MemorySearchResult,\n  \n  // Client\n  ClientOptions,\n  ConnectionStatus,\n  \n  // Utilities\n  Unsubscribe,\n  EventHandler,\n} from '@aevatar/kit';\n```\n\n### Type Guards\n\n```typescript\nimport {\n  isRunStartedEvent,\n  isRunFinishedEvent,\n  isTextMessageContentEvent,\n  isStateSnapshotEvent,\n  isCustomEvent,\n  // ... more\n} from '@aevatar/kit';\n```\n\n### Core Functions\n\n```typescript\nimport {\n  createAevatarClient,\n  createSessionManager,\n  createRunManager,\n  createStateStore,\n  createConnection,\n  createEventStream,\n  createEventRouter,\n  createLogger,\n  createRetryManager,\n} from '@aevatar/kit';\n```\n\n### React Context & Hooks\n\n```typescript\nimport {\n  // Context\n  AevatarProvider,\n  AevatarContext,\n  \n  // Hooks\n  useAevatar,\n  useSession,\n  useRun,\n  useMessages,\n  useEventStream,\n  useProgress,\n  useConnection,\n} from '@aevatar/kit';\n```\n\n### React Components\n\n```typescript\nimport {\n  // Chat\n  ChatPanel,\n  MessageList,\n  MessageBubble,\n  InputArea,\n  \n  // Timeline\n  TimelineView,\n  StepCard,\n  StreamingText,\n  \n  // Common\n  ConnectionStatus,\n  ProgressBar,\n  LoadingSpinner,\n} from '@aevatar/kit';\n```\n\n### Aevatar Extensions\n\n```typescript\nimport type {\n  AevatarCustomEventName,\n  AevatarProgressEvent,\n  AevatarGraphEvent,\n  AevatarVotingEvent,\n  AevatarWorkerStartedEvent,\n  AevatarTaskDecomposedEvent,\n} from '@aevatar/kit';\n```\n\n## Bundle Optimization\n\nFor smaller bundle sizes, import from individual packages:\n\n```typescript\n// Instead of:\nimport { createAevatarClient, useSession } from '@aevatar/kit';\n\n// Do:\nimport { createAevatarClient } from '@aevatar/kit-core';\nimport { useSession } from '@aevatar/kit-react';\n```\n\n### Package Sizes\n\n| Package | Approximate Size |\n|---------|------------------|\n| `@aevatar/kit-types` | ~0KB (types only) |\n| `@aevatar/kit-protocol` | ~5KB |\n| `@aevatar/kit-core` | ~15KB |\n| `@aevatar/kit-react` | ~30KB |\n\n## Peer Dependencies\n\n```json\n{\n  \"react\": \"^18.0.0\",\n  \"react-dom\": \"^18.0.0\"\n}\n```\n\n> Note: React is optional. If not using React, only the core/protocol exports will work.\n\n## Theming\n\nImport styles for pre-built components:\n\n```tsx\nimport '@aevatar/kit/styles.css';\n```\n\nCustomize with CSS variables:\n\n```css\n:root {\n  --aevatar-primary: #6366f1;\n  --aevatar-background: #ffffff;\n  --aevatar-text: #1e293b;\n  --aevatar-radius: 8px;\n}\n```\n\n## Architecture\n\n```\n@aevatar/kit (this package)\n├── Re-exports from:\n│   ├── @aevatar/kit-types      (types only)\n│   ├── @aevatar/kit-protocol   (SSE, parsing, routing)\n│   ├── @aevatar/kit-core       (client, session, run)\n│   └── @aevatar/kit-react      (hooks, components)\n│\n└── Depends on:\n    └── react (peer, optional)\n```\n\n## Related Documentation\n\n- [Main README](../../README.md) - Full documentation\n- [Design Document](../../docs/DESIGN.md) - Architecture details\n- [Examples](../../examples/) - Usage examples\n\n## Sub-packages\n\n- [`@aevatar/kit-types`](../kit-types/README.md) - Type definitions\n- [`@aevatar/kit-protocol`](../kit-protocol/README.md) - Protocol layer\n- [`@aevatar/kit-core`](../kit-core/README.md) - Core logic\n- [`@aevatar/kit-react`](../kit-react/README.md) - React bindings\n\n## License\n\nMIT © [Aevatar Team](https://github.com/aevatar)\n\n","readmeFilename":"README.md"}