@starcite/react 0.0.7

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,86 @@
+# @starcite/react
+
+React-first chat hook for a single durable Starcite session.
+
+This package replaces AI SDK `useChat` wiring for Starcite-backed chats while
+keeping a familiar surface:
+
+- `messages`
+- `sendMessage`
+- `status`
+
+## Install
+
+```bash
+npm install @starcite/react @starcite/sdk ai react
+```
+
+## Usage
+
+```tsx
+import { Starcite } from "@starcite/sdk";
+import { useStarciteChat } from "@starcite/react";
+
+const starcite = new Starcite({
+  baseUrl: process.env.NEXT_PUBLIC_STARCITE_BASE_URL,
+});
+
+export function Chat({ token }: { token: string }) {
+  const session = starcite.session({ token });
+
+  const { messages, sendMessage, status } = useStarciteChat({
+    session,
+    id: session.id,
+  });
+
+  return (
+    <form
+      onSubmit={(event) => {
+        event.preventDefault();
+        void sendMessage({ text: "hello" });
+      }}
+    >
+      <button type="submit">Send</button>
+      <p>Status: {status}</p>
+      <pre>{JSON.stringify(messages, null, 2)}</pre>
+    </form>
+  );
+}
+```
+
+## Hook Options
+
+- `session` (required): session scoped to the active session token.
+- `id` (optional): reset key for when you swap sessions; defaults to `session.id`.
+- `userMessageSource` (optional, default `"use-chat"`): source string for user append events.
+- `onError` (optional): callback for append/projection/subscription failures.
+
+## Behavior
+
+- Uses `session.events()` as the durable source of truth for chat state.
+- Subscribes with `session.on("event", ...)` and only consumes:
+  - `chat.user.message`
+  - `chat.assistant.chunk`
+- Appends outgoing user messages as strict chat envelopes.
+- Rebuilds `UIMessage[]` from durable events whenever new chat events arrive.
+
+## Exports
+
+- `useStarciteChat`
+- `UseStarciteChatOptions`
+- `UseStarciteChatResult`
+- `SendMessageInput`
+- `StarciteChatSession`
+
+### Chat Protocol Helpers
+
+Import from `@starcite/react/chat-protocol` when you need chat envelope helpers
+for server agents or custom transports:
+
+- `chatUserMessageEventType`
+- `chatAssistantChunkEventType`
+- `createUserMessageEnvelope(...)`
+- `createAssistantChunkEnvelope(...)`
+- `parseChatPayloadEnvelope(...)`
+- `appendUserMessageEvent(...)`
+- `appendAssistantChunkEvent(...)`

package/dist/chat-protocol.cjs

@@ -0,0 +1,202 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/chat-protocol.ts
+var chat_protocol_exports = {};
+__export(chat_protocol_exports, {
+  appendAssistantChunkEvent: () => appendAssistantChunkEvent,
+  appendUserMessageEvent: () => appendUserMessageEvent,
+  chatAssistantChunkEventType: () => chatAssistantChunkEventType,
+  chatUserMessageEventType: () => chatUserMessageEventType,
+  createAssistantChunkEnvelope: () => createAssistantChunkEnvelope,
+  createUserMessageEnvelope: () => createUserMessageEnvelope,
+  parseChatPayloadEnvelope: () => parseChatPayloadEnvelope,
+  toUIMessagesFromEvents: () => toUIMessagesFromEvents
+});
+module.exports = __toCommonJS(chat_protocol_exports);
+var import_ai = require("ai");
+var chatUserMessageEventType = "chat.user.message";
+var chatAssistantChunkEventType = "chat.assistant.chunk";
+function isChatEventType(type) {
+  return type === chatUserMessageEventType || type === chatAssistantChunkEventType;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function parseUserEnvelope(payload) {
+  const message = payload.message;
+  if (!isRecord(message)) {
+    throw new Error("Invalid chat payload envelope: missing message");
+  }
+  const role = message.role;
+  const parts = message.parts;
+  if (role !== "system" && role !== "user" && role !== "assistant") {
+    throw new Error("Invalid chat payload envelope: invalid message role");
+  }
+  if (!Array.isArray(parts)) {
+    throw new Error("Invalid chat payload envelope: invalid message parts");
+  }
+  return {
+    ...payload,
+    kind: chatUserMessageEventType,
+    message: {
+      ...message,
+      role,
+      parts
+    }
+  };
+}
+function parseAssistantEnvelope(payload) {
+  const chunk = payload.chunk;
+  if (!isRecord(chunk)) {
+    throw new Error("Invalid chat payload envelope: missing chunk");
+  }
+  const type = chunk.type;
+  if (typeof type !== "string" || type.length === 0) {
+    throw new Error("Invalid chat payload envelope: invalid chunk type");
+  }
+  return {
+    ...payload,
+    kind: chatAssistantChunkEventType,
+    chunk: {
+      ...chunk,
+      type
+    }
+  };
+}
+function createUserMessageEnvelope(message) {
+  return {
+    kind: chatUserMessageEventType,
+    message
+  };
+}
+function createAssistantChunkEnvelope(chunk) {
+  return {
+    kind: chatAssistantChunkEventType,
+    chunk
+  };
+}
+function parseChatPayloadEnvelope(payload) {
+  if (!isRecord(payload)) {
+    throw new Error("Invalid chat payload envelope: payload must be an object");
+  }
+  const kind = payload.kind;
+  if (kind === chatUserMessageEventType) {
+    return parseUserEnvelope(payload);
+  }
+  if (kind === chatAssistantChunkEventType) {
+    return parseAssistantEnvelope(payload);
+  }
+  throw new Error("Invalid chat payload envelope: unknown kind");
+}
+function appendUserMessageEvent(session, message, options = {}) {
+  return session.append({
+    type: chatUserMessageEventType,
+    source: options.source ?? "use-chat",
+    payload: createUserMessageEnvelope(message)
+  });
+}
+function appendAssistantChunkEvent(session, chunk, options = {}) {
+  return session.append({
+    type: chatAssistantChunkEventType,
+    source: options.source ?? "openai",
+    payload: createAssistantChunkEnvelope(chunk)
+  });
+}
+async function buildChunkMessages(chunks) {
+  if (chunks.length === 0) {
+    return [];
+  }
+  const messageIds = [];
+  const latestById = /* @__PURE__ */ new Map();
+  let index = 0;
+  const stream = new ReadableStream({
+    pull(controller) {
+      const chunk = chunks[index];
+      if (!chunk) {
+        controller.close();
+        return;
+      }
+      controller.enqueue(chunk);
+      index += 1;
+    }
+  });
+  try {
+    for await (const message of (0, import_ai.readUIMessageStream)({
+      stream,
+      terminateOnError: false
+    })) {
+      if (!latestById.has(message.id)) {
+        messageIds.push(message.id);
+      }
+      latestById.set(message.id, message);
+    }
+  } catch {
+  }
+  const messages = [];
+  for (const messageId of messageIds) {
+    const message = latestById.get(messageId);
+    if (message) {
+      messages.push(message);
+    }
+  }
+  return messages;
+}
+async function toUIMessagesFromEvents(events) {
+  const messages = [];
+  const bufferedChunks = [];
+  const flushBufferedChunks = async () => {
+    if (bufferedChunks.length === 0) {
+      return;
+    }
+    messages.push(...await buildChunkMessages(bufferedChunks));
+    bufferedChunks.length = 0;
+  };
+  for (const event of events) {
+    if (!isChatEventType(event.type)) {
+      continue;
+    }
+    let envelope;
+    try {
+      envelope = parseChatPayloadEnvelope(event.payload);
+    } catch {
+      continue;
+    }
+    if (envelope.kind === chatUserMessageEventType) {
+      await flushBufferedChunks();
+      messages.push(envelope.message);
+      continue;
+    }
+    bufferedChunks.push(envelope.chunk);
+  }
+  await flushBufferedChunks();
+  return messages;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  appendAssistantChunkEvent,
+  appendUserMessageEvent,
+  chatAssistantChunkEventType,
+  chatUserMessageEventType,
+  createAssistantChunkEnvelope,
+  createUserMessageEnvelope,
+  parseChatPayloadEnvelope,
+  toUIMessagesFromEvents
+});
+//# sourceMappingURL=chat-protocol.cjs.map

package/dist/chat-protocol.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/chat-protocol.ts"],"sourcesContent":["import type { AppendResult, SessionAppendInput } from \"@starcite/sdk\";\nimport { readUIMessageStream, type UIMessage, type UIMessageChunk } from \"ai\";\n\nexport const chatUserMessageEventType = \"chat.user.message\";\nexport const chatAssistantChunkEventType = \"chat.assistant.chunk\";\n\ntype ChatRole = \"system\" | \"user\" | \"assistant\";\n\ninterface ChatUserMessagePayload {\n  role: ChatRole;\n  parts: unknown[];\n  [key: string]: unknown;\n}\n\ninterface ChatAssistantChunkPayload {\n  type: string;\n  [key: string]: unknown;\n}\n\nexport type ChatPayloadEnvelope =\n  | {\n      kind: typeof chatUserMessageEventType;\n      message: ChatUserMessagePayload;\n      [key: string]: unknown;\n    }\n  | {\n      kind: typeof chatAssistantChunkEventType;\n      chunk: ChatAssistantChunkPayload;\n      [key: string]: unknown;\n    };\n\ninterface SessionAppender {\n  append: (input: SessionAppendInput) => Promise<AppendResult>;\n}\n\nfunction isChatEventType(type: string): boolean {\n  return (\n    type === chatUserMessageEventType || type === chatAssistantChunkEventType\n  );\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction parseUserEnvelope(\n  payload: Record<string, unknown>\n): ChatPayloadEnvelope {\n  const message = payload.message;\n  if (!isRecord(message)) {\n    throw new Error(\"Invalid chat payload envelope: missing message\");\n  }\n\n  const role = message.role;\n  const parts = message.parts;\n\n  if (role !== \"system\" && role !== \"user\" && role !== \"assistant\") {\n    throw new Error(\"Invalid chat payload envelope: invalid message role\");\n  }\n\n  if (!Array.isArray(parts)) {\n    throw new Error(\"Invalid chat payload envelope: invalid message parts\");\n  }\n\n  return {\n    ...payload,\n    kind: chatUserMessageEventType,\n    message: {\n      ...message,\n      role,\n      parts,\n    },\n  };\n}\n\nfunction parseAssistantEnvelope(\n  payload: Record<string, unknown>\n): ChatPayloadEnvelope {\n  const chunk = payload.chunk;\n  if (!isRecord(chunk)) {\n    throw new Error(\"Invalid chat payload envelope: missing chunk\");\n  }\n\n  const type = chunk.type;\n  if (typeof type !== \"string\" || type.length === 0) {\n    throw new Error(\"Invalid chat payload envelope: invalid chunk type\");\n  }\n\n  return {\n    ...payload,\n    kind: chatAssistantChunkEventType,\n    chunk: {\n      ...chunk,\n      type,\n    },\n  };\n}\n\nexport function createUserMessageEnvelope<\n  TMessage extends Record<string, unknown>,\n>(\n  message: TMessage\n): {\n  kind: typeof chatUserMessageEventType;\n  message: TMessage;\n} {\n  return {\n    kind: chatUserMessageEventType,\n    message,\n  };\n}\n\nexport function createAssistantChunkEnvelope<\n  TChunk extends Record<string, unknown>,\n>(\n  chunk: TChunk\n): {\n  kind: typeof chatAssistantChunkEventType;\n  chunk: TChunk;\n} {\n  return {\n    kind: chatAssistantChunkEventType,\n    chunk,\n  };\n}\n\nexport function parseChatPayloadEnvelope(\n  payload: unknown\n): ChatPayloadEnvelope {\n  if (!isRecord(payload)) {\n    throw new Error(\"Invalid chat payload envelope: payload must be an object\");\n  }\n\n  const kind = payload.kind;\n  if (kind === chatUserMessageEventType) {\n    return parseUserEnvelope(payload);\n  }\n\n  if (kind === chatAssistantChunkEventType) {\n    return parseAssistantEnvelope(payload);\n  }\n\n  throw new Error(\"Invalid chat payload envelope: unknown kind\");\n}\n\nexport function appendUserMessageEvent(\n  session: SessionAppender,\n  message: Record<string, unknown>,\n  options: { source?: string } = {}\n): Promise<AppendResult> {\n  return session.append({\n    type: chatUserMessageEventType,\n    source: options.source ?? \"use-chat\",\n    payload: createUserMessageEnvelope(message),\n  });\n}\n\nexport function appendAssistantChunkEvent(\n  session: SessionAppender,\n  chunk: Record<string, unknown>,\n  options: { source?: string } = {}\n): Promise<AppendResult> {\n  return session.append({\n    type: chatAssistantChunkEventType,\n    source: options.source ?? \"openai\",\n    payload: createAssistantChunkEnvelope(chunk),\n  });\n}\n\nasync function buildChunkMessages(\n  chunks: readonly UIMessageChunk[]\n): Promise<UIMessage[]> {\n  if (chunks.length === 0) {\n    return [];\n  }\n\n  const messageIds: string[] = [];\n  const latestById = new Map<string, UIMessage>();\n  let index = 0;\n\n  const stream = new ReadableStream<UIMessageChunk>({\n    pull(controller) {\n      const chunk = chunks[index];\n      if (!chunk) {\n        controller.close();\n        return;\n      }\n\n      controller.enqueue(chunk);\n      index += 1;\n    },\n  });\n\n  try {\n    for await (const message of readUIMessageStream({\n      stream,\n      terminateOnError: false,\n    })) {\n      if (!latestById.has(message.id)) {\n        messageIds.push(message.id);\n      }\n\n      latestById.set(message.id, message);\n    }\n  } catch {\n    // Best effort: keep messages emitted before malformed chunk sequences.\n  }\n\n  const messages: UIMessage[] = [];\n  for (const messageId of messageIds) {\n    const message = latestById.get(messageId);\n    if (message) {\n      messages.push(message);\n    }\n  }\n\n  return messages;\n}\n\nexport async function toUIMessagesFromEvents(\n  events: readonly { type: string; payload: unknown }[]\n): Promise<UIMessage[]> {\n  const messages: UIMessage[] = [];\n  const bufferedChunks: UIMessageChunk[] = [];\n\n  const flushBufferedChunks = async (): Promise<void> => {\n    if (bufferedChunks.length === 0) {\n      return;\n    }\n\n    messages.push(...(await buildChunkMessages(bufferedChunks)));\n    bufferedChunks.length = 0;\n  };\n\n  for (const event of events) {\n    if (!isChatEventType(event.type)) {\n      continue;\n    }\n\n    let envelope: ChatPayloadEnvelope;\n    try {\n      envelope = parseChatPayloadEnvelope(event.payload);\n    } catch {\n      // Skip malformed chat payloads and continue projecting the rest.\n      continue;\n    }\n\n    if (envelope.kind === chatUserMessageEventType) {\n      await flushBufferedChunks();\n      messages.push(envelope.message as unknown as UIMessage);\n      continue;\n    }\n\n    bufferedChunks.push(envelope.chunk as unknown as UIMessageChunk);\n  }\n\n  await flushBufferedChunks();\n  return messages;\n}\n"],"mappings":"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","names":[]}

package/dist/chat-protocol.d.cts

@@ -0,0 +1,48 @@
+import { SessionAppendInput, AppendResult } from '@starcite/sdk';
+import { UIMessage } from 'ai';
+
+declare const chatUserMessageEventType = "chat.user.message";
+declare const chatAssistantChunkEventType = "chat.assistant.chunk";
+type ChatRole = "system" | "user" | "assistant";
+interface ChatUserMessagePayload {
+    role: ChatRole;
+    parts: unknown[];
+    [key: string]: unknown;
+}
+interface ChatAssistantChunkPayload {
+    type: string;
+    [key: string]: unknown;
+}
+type ChatPayloadEnvelope = {
+    kind: typeof chatUserMessageEventType;
+    message: ChatUserMessagePayload;
+    [key: string]: unknown;
+} | {
+    kind: typeof chatAssistantChunkEventType;
+    chunk: ChatAssistantChunkPayload;
+    [key: string]: unknown;
+};
+interface SessionAppender {
+    append: (input: SessionAppendInput) => Promise<AppendResult>;
+}
+declare function createUserMessageEnvelope<TMessage extends Record<string, unknown>>(message: TMessage): {
+    kind: typeof chatUserMessageEventType;
+    message: TMessage;
+};
+declare function createAssistantChunkEnvelope<TChunk extends Record<string, unknown>>(chunk: TChunk): {
+    kind: typeof chatAssistantChunkEventType;
+    chunk: TChunk;
+};
+declare function parseChatPayloadEnvelope(payload: unknown): ChatPayloadEnvelope;
+declare function appendUserMessageEvent(session: SessionAppender, message: Record<string, unknown>, options?: {
+    source?: string;
+}): Promise<AppendResult>;
+declare function appendAssistantChunkEvent(session: SessionAppender, chunk: Record<string, unknown>, options?: {
+    source?: string;
+}): Promise<AppendResult>;
+declare function toUIMessagesFromEvents(events: readonly {
+    type: string;
+    payload: unknown;
+}[]): Promise<UIMessage[]>;
+
+export { type ChatPayloadEnvelope, appendAssistantChunkEvent, appendUserMessageEvent, chatAssistantChunkEventType, chatUserMessageEventType, createAssistantChunkEnvelope, createUserMessageEnvelope, parseChatPayloadEnvelope, toUIMessagesFromEvents };

package/dist/chat-protocol.d.ts

@@ -0,0 +1,48 @@
+import { SessionAppendInput, AppendResult } from '@starcite/sdk';
+import { UIMessage } from 'ai';
+
+declare const chatUserMessageEventType = "chat.user.message";
+declare const chatAssistantChunkEventType = "chat.assistant.chunk";
+type ChatRole = "system" | "user" | "assistant";
+interface ChatUserMessagePayload {
+    role: ChatRole;
+    parts: unknown[];
+    [key: string]: unknown;
+}
+interface ChatAssistantChunkPayload {
+    type: string;
+    [key: string]: unknown;
+}
+type ChatPayloadEnvelope = {
+    kind: typeof chatUserMessageEventType;
+    message: ChatUserMessagePayload;
+    [key: string]: unknown;
+} | {
+    kind: typeof chatAssistantChunkEventType;
+    chunk: ChatAssistantChunkPayload;
+    [key: string]: unknown;
+};
+interface SessionAppender {
+    append: (input: SessionAppendInput) => Promise<AppendResult>;
+}
+declare function createUserMessageEnvelope<TMessage extends Record<string, unknown>>(message: TMessage): {
+    kind: typeof chatUserMessageEventType;
+    message: TMessage;
+};
+declare function createAssistantChunkEnvelope<TChunk extends Record<string, unknown>>(chunk: TChunk): {
+    kind: typeof chatAssistantChunkEventType;
+    chunk: TChunk;
+};
+declare function parseChatPayloadEnvelope(payload: unknown): ChatPayloadEnvelope;
+declare function appendUserMessageEvent(session: SessionAppender, message: Record<string, unknown>, options?: {
+    source?: string;
+}): Promise<AppendResult>;
+declare function appendAssistantChunkEvent(session: SessionAppender, chunk: Record<string, unknown>, options?: {
+    source?: string;
+}): Promise<AppendResult>;
+declare function toUIMessagesFromEvents(events: readonly {
+    type: string;
+    payload: unknown;
+}[]): Promise<UIMessage[]>;
+
+export { type ChatPayloadEnvelope, appendAssistantChunkEvent, appendUserMessageEvent, chatAssistantChunkEventType, chatUserMessageEventType, createAssistantChunkEnvelope, createUserMessageEnvelope, parseChatPayloadEnvelope, toUIMessagesFromEvents };

package/dist/chat-protocol.js

@@ -0,0 +1,21 @@
+import {
+  appendAssistantChunkEvent,
+  appendUserMessageEvent,
+  chatAssistantChunkEventType,
+  chatUserMessageEventType,
+  createAssistantChunkEnvelope,
+  createUserMessageEnvelope,
+  parseChatPayloadEnvelope,
+  toUIMessagesFromEvents
+} from "./chunk-QG237Z3K.js";
+export {
+  appendAssistantChunkEvent,
+  appendUserMessageEvent,
+  chatAssistantChunkEventType,
+  chatUserMessageEventType,
+  createAssistantChunkEnvelope,
+  createUserMessageEnvelope,
+  parseChatPayloadEnvelope,
+  toUIMessagesFromEvents
+};
+//# sourceMappingURL=chat-protocol.js.map

package/dist/chat-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}