@aparte/runner-ag-ui 0.21.0 → 0.23.0

package/README.md

@@ -25,7 +25,13 @@ client.start();
 - **Approvals.** When the agent pauses on a call that needs a person (an AG-UI interrupt, such
   as TanStack AI's `needsApproval`), the page asks through its usual approval panel, and the
   answer resumes the run on the agent's server.
-- **Its own state** (`STATE_*`, `CUSTOM`, sub-agents) is read and left alone in this version.
+- **Its state** (`STATE_SNAPSHOT`, `STATE_DELTA`) is kept for the thread and sent back as the
+  next run's `state`. `CUSTOM`, activities and sub-agents are checked, not drawn, in this version.
+- **AG-UI 1.0, held to its own corpus.** The runner declares `protocolVersion: "1.0"`, rejects
+  the streams 1.0 tells a client to reject, drops what 1.0 does not describe (reported to
+  `onWarning`), and passes the protocol's 68 conformance streams on every build.
+- **TanStack AI** frames its runs its own way — a `RUN_FINISHED` per model step — so its routes
+  take `createAgUiRunner({ endpoint: '/api/chat', relaxedRunFraming: true })`.
 
 No AG-UI SDK is pulled in: the wire is plain JSON over Server-Sent Events, parsed here, with
 `@aparte/core` as the only peer dependency.

package/dist/enforce.d.ts

@@ -0,0 +1,19 @@
+type AgUiEvent = {
+    type: string;
+} & Record<string, unknown>;
+/**
+ * The properties AG-UI 1.0 describes on each event, beyond `BASE`. Written out rather than
+ * read from `@ag-ui/core`'s schemas, which would ship zod to every page; a test holds this
+ * table to those schemas, so a protocol update that adds a field fails it.
+ */
+export declare const EVENT_KEYS: Record<string, readonly string[]>;
+/**
+ * AG-UI's rule for what a consumer does not recognise: survive it. An unknown event is
+ * dropped, an undescribed property or an unknown member of a closed set is stripped, an
+ * unknown element of a list is removed from it — each told to `warn` by its path, the
+ * event otherwise left intact. A value of the wrong SHAPE is not unknown, it is
+ * malformed, and is left for the verifier to reject.
+ */
+export declare function enforce(event: AgUiEvent, warn: (message: string) => void): AgUiEvent | undefined;
+export {};
+//# sourceMappingURL=enforce.d.ts.map

package/dist/enforce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enforce.d.ts","sourceRoot":"","sources":["../src/enforce.ts"],"names":[],"mappings":"AAAA,KAAK,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAK5D;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAgCxD,CAAC;AAOF;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,SAAS,GAAG,SAAS,CAmChG"}