{"_id":"@aifrontkit/ag-ui","_rev":"2-0d00b42f6f76b12a4f475f4304cd3993","name":"@aifrontkit/ag-ui","dist-tags":{"next":"0.2.0-next.0","latest":"0.2.0-next.0"},"versions":{"0.2.0-next.0":{"name":"@aifrontkit/ag-ui","version":"0.2.0-next.0","license":"Apache-2.0","_id":"@aifrontkit/ag-ui@0.2.0-next.0","maintainers":[{"name":"msnandhis","email":"hello@msnandhis.com"}],"homepage":"https://github.com/msnandhis/openfrontkit#readme","bugs":{"url":"https://github.com/msnandhis/openfrontkit/issues"},"dist":{"shasum":"dabd2deb58f6b68d1af5b07381f7ccc3571fce6f","tarball":"https://registry.npmjs.org/@aifrontkit/ag-ui/-/ag-ui-0.2.0-next.0.tgz","fileCount":3,"integrity":"sha512-z0tRbMLsJESDsL5dokidD2KYo9MpB25Km4Oh4YicrKZh0yAxyIDaDj9LhVFXlAlJNZEKVkjiariTLg0RtjNZ8g==","signatures":[{"sig":"MEUCIQCVSvibhlRON4UPnFYNo473fLm/9/c/ew+mzg5uqAtVcAIgfRBPZYUlNlFKovQoZOMCO+FBG1ki+kFXaHPA6UazqxI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":13527},"type":"module","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"test":"vitest run","build":"tsc -p tsconfig.build.json","prebuild":"node ../../scripts/clean-package-dist.mjs","typecheck":"tsc -p tsconfig.json --noEmit"},"_npmUser":{"name":"msnandhis","email":"hello@msnandhis.com"},"repository":{"url":"git+https://github.com/msnandhis/openfrontkit.git","type":"git","directory":"packages/ag-ui"},"description":"Structural AG-UI event adapter for AIFrontKit","directories":{},"sideEffects":false,"_nodeVersion":"24.19.0","dependencies":{"@aifrontkit/core":"^0.2.0-next.0"},"publishConfig":{"access":"public","provenance":true},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.2.4","typescript":"^5.9.2"},"_npmOperationalInternal":{"tmp":"tmp/ag-ui_0.2.0-next.0_1788200088049_0.14446703611768164","host":"s3://npm-registry-packages-npm-production"},"deprecated":"This preview package was consolidated into @aifrontkit/adapters. Use @aifrontkit/adapters/ag-ui."}},"time":{"created":"2026-08-31T18:14:47.852Z","modified":"2026-09-01T06:31:58.955Z","0.2.0-next.0":"2026-08-31T18:14:48.198Z"},"bugs":{"url":"https://github.com/msnandhis/openfrontkit/issues"},"license":"Apache-2.0","homepage":"https://github.com/msnandhis/openfrontkit#readme","repository":{"url":"git+https://github.com/msnandhis/openfrontkit.git","type":"git","directory":"packages/ag-ui"},"description":"Structural AG-UI event adapter for AIFrontKit","maintainers":[{"name":"msnandhis","email":"hello@msnandhis.com"}],"readme":"# @aifrontkit/ag-ui\n\nProvider-neutral structural adapters for AG-UI and LangGraph event streams.\nThe package does not install or execute either provider runtime.\n\n## LangGraph reference adapter\n\nCreate one adapter per graph run. Call `start()`, pass `messages`, `updates` and\n`tools` stream-mode tuples to `adapt()` then call `finish()` or `fail()`. Message\nchunks become ordered text parts, node updates become task steps and tool events\nretain their upstream call identity.\n\n`projectLangGraphCheckpointHistory` accepts the structural `StateSnapshot`\nhistory returned by `getStateHistory()` and emits v4 checkpoint events for only\nthe candidates a host deliberately curates. The host must issue every public\ncheckpoint ID and version then explicitly decide compatibility and\nrestorability. Raw values, writes, tasks and LangGraph persistence handles are\nnever projected. Restoring a checkpoint resumes with the latest deployed graph\ncode. It does not restore the original executable.\n\nAG-UI `STATE_SNAPSHOT` and `STATE_DELTA` events are frontend synchronization\nsignals rather than durable checkpoints, so the AG-UI adapter intentionally\nignores them.\n\n## External store bridge\n\n`createExternalStoreBridge` accepts the same `getSnapshot` and `subscribe`\nshape used by React external stores. Its `project` callback converts provider\nsnapshots into AIFrontKit events without mirroring provider state in components.\nThe same bridge can publish the v4 checkpoint events produced by the LangGraph\nhistory projector without installing or executing a provider runtime.\n\nCompatibility snapshots under `compatibility/fixtures/adapters` pin the exact\nupstream release shapes covered by tests.\n","readmeFilename":""}