@aphrody/m3-ai 3.3.5 → 3.3.7

package/dist/openaiChatStream.d.ts

@@ -0,0 +1,140 @@
+import type { Citation } from "./citations";
+export type ChatRole = "system" | "user" | "assistant" | "tool";
+/** One complete tool call, as OpenAI returns it once every delta is merged. */
+export interface OpenAIToolCall {
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+/** One message of the conversation, in the shape the chat components render. */
+export interface ChatMessage {
+    id: string;
+    role: ChatRole;
+    content: string;
+    /** `reasoning_content` deltas (reasoning models), kept apart from the answer. */
+    reasoning?: string;
+    toolCalls?: OpenAIToolCall[];
+    /** For a `tool` message: the call it answers. */
+    toolCallId?: string;
+    finishReason?: string | null;
+    /** Grounded answer: the numbered passages `[n]` the text refers to. */
+    citations?: Citation[];
+    /** The backend refused to answer (out of the sources' scope). */
+    refusal?: boolean;
+}
+/** What one SSE chunk contributes. */
+export type ChatStreamEvent = {
+    type: "content";
+    text: string;
+} | {
+    type: "reasoning";
+    text: string;
+} | {
+    type: "tool_call_delta";
+    index: number;
+    id?: string;
+    name?: string;
+    arguments?: string;
+} | {
+    type: "citations";
+    citations: Citation[];
+} | {
+    type: "refusal";
+    text?: string;
+} | {
+    type: "finish";
+    reason: string;
+} | {
+    type: "done";
+};
+export type ChatStreamErrorKind = "network" | "http" | "aborted" | "parse" | "stream";
+/** Typed failure of a chat request. `unavailable` marks a model that cannot answer right now. */
+export declare class ChatStreamError extends Error {
+    readonly kind: ChatStreamErrorKind;
+    readonly status?: number;
+    readonly unavailable: boolean;
+    constructor(kind: ChatStreamErrorKind, message: string, options?: {
+        status?: number;
+        cause?: unknown;
+    });
+}
+/** HTTP statuses that mean "no model to answer" rather than "bad request". */
+export declare function isUnavailableStatus(status: number | undefined): boolean;
+/**
+ * Incremental SSE parser: feed it decoded text in arbitrary pieces, it calls `onData` with the
+ * payload of every complete event (multi-line `data:` fields joined by `\n`). Comments and
+ * other fields are ignored.
+ */
+export declare function createSseParser(onData: (data: string) => void): {
+    push(chunk: string): void;
+    flush(): void;
+};
+/**
+ * Decode one `data:` payload of a chat-completions stream into events. `[DONE]` yields `done`.
+ * A payload carrying `error` throws a `stream` error; malformed JSON throws a `parse` error.
+ * Top-level `citations` / `refusal: true` (grounded backends such as Shenron) are passed on.
+ */
+export declare function parseChatCompletionChunk(payload: string): ChatStreamEvent[];
+/** Merge a tool-call delta into the calls accumulated so far (returns a new array). */
+export declare function accumulateToolCall(calls: readonly OpenAIToolCall[], delta: Extract<ChatStreamEvent, {
+    type: "tool_call_delta";
+}>): OpenAIToolCall[];
+/** The request body messages, in the OpenAI wire shape. */
+export declare function toOpenAIMessages(messages: readonly ChatMessage[]): Record<string, unknown>[];
+export interface StreamChatOptions {
+    /** API root including `/v1` (e.g. `http://127.0.0.1:8080/v1`). */
+    baseUrl: string;
+    model?: string;
+    messages: readonly ChatMessage[];
+    /** Extra body fields (`temperature`, `tools`, `max_tokens`...). */
+    body?: Record<string, unknown>;
+    headers?: Record<string, string>;
+    signal?: AbortSignal;
+    fetch?: typeof fetch;
+}
+/** `<baseUrl>/chat/completions`, tolerant of a trailing slash. */
+export declare function chatCompletionsUrl(baseUrl: string): string;
+/**
+ * POST a streaming chat completion and yield its events until `[DONE]` or the end of the body.
+ *
+ * Throws `ChatStreamError`: `network` (fetch rejected: server down), `http` (non-2xx status;
+ * `unavailable` for 404/502/503/504), `aborted` (the signal fired), `parse` / `stream`.
+ */
+export declare function streamChatCompletion(options: StreamChatOptions): AsyncGenerator<ChatStreamEvent, void, undefined>;
+export type ChatStatus = "idle" | "streaming" | "error" | "unavailable";
+export interface ChatState {
+    messages: ChatMessage[];
+    status: ChatStatus;
+    error: ChatStreamError | null;
+}
+export type ChatAction = {
+    type: "start";
+    user: ChatMessage;
+    assistantId: string;
+} | {
+    type: "event";
+    assistantId: string;
+    event: ChatStreamEvent;
+} | {
+    type: "finish";
+} | {
+    type: "fail";
+    error: ChatStreamError;
+} | {
+    type: "stop";
+} | {
+    type: "reset";
+    messages?: ChatMessage[];
+} | {
+    type: "set";
+    messages: ChatMessage[];
+};
+export declare function initialChatState(messages?: ChatMessage[]): ChatState;
+/** Pure reducer of a streamed conversation (the state behind `useOpenAIChat`). */
+export declare function chatReducer(state: ChatState, action: ChatAction): ChatState;
+/** Message id: `crypto.randomUUID` when present, else a process-local counter. */
+export declare function newMessageId(): string;
+//# sourceMappingURL=openaiChatStream.d.ts.map

package/dist/openaiChatStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openaiChatStream.d.ts","sourceRoot":"","sources":["../src/openaiChatStream.ts"],"names":[],"mappings":"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"}

package/dist/useOpenAIChat.d.ts

@@ -0,0 +1,30 @@
+import { type ChatMessage, type ChatStatus, ChatStreamError } from "./openaiChatStream";
+export interface UseOpenAIChatOptions {
+    /** API root including `/v1` (e.g. `http://127.0.0.1:8080/v1`). */
+    baseUrl: string;
+    model?: string;
+    fetch?: typeof fetch;
+    headers?: Record<string, string>;
+    initialMessages?: ChatMessage[];
+    /** Messages sent before the conversation on every request (system prompt...). */
+    preamble?: ChatMessage[];
+    /** Extra body fields (`temperature`, `tools`...). */
+    body?: Record<string, unknown>;
+    /** Called with the finished assistant message. */
+    onFinish?: (message: ChatMessage) => void;
+    onError?: (error: ChatStreamError) => void;
+}
+export interface UseOpenAIChatResult {
+    messages: ChatMessage[];
+    status: ChatStatus;
+    error: ChatStreamError | null;
+    /** Send a user message and stream the answer. Ignored while streaming. */
+    send: (content: string) => Promise<void>;
+    /** Abort the running request; the partial answer stays. */
+    stop: () => void;
+    /** Abort and clear (or replace) the conversation. */
+    reset: (messages?: ChatMessage[]) => void;
+    setMessages: (messages: ChatMessage[]) => void;
+}
+export declare function useOpenAIChat(options: UseOpenAIChatOptions): UseOpenAIChatResult;
+//# sourceMappingURL=useOpenAIChat.d.ts.map

package/dist/useOpenAIChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useOpenAIChat.d.ts","sourceRoot":"","sources":["../src/useOpenAIChat.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,eAAe,EAKhB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;IAChC,iFAAiF;IACjF,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,kDAAkD;IAClD,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAC1C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAC9B,0EAA0E;IAC1E,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,2DAA2D;IAC3D,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,qDAAqD;IACrD,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IAC1C,WAAW,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;CAChD;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CA8EhF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aphrody/m3-ai",
-  "version": "3.3.5",
+  "version": "3.3.7",
   "description": "Material Design 3 agent-interaction components (tool calls, markdown, chat composer, workers, tasks): the SpaceUI (@spacedrive/ai) set rebuilt on @aphrody/m3-primitives.",
   "keywords": [
     "material-3",
@@ -27,7 +27,8 @@
       "import": "./src/index.ts",
       "types": "./src/index.ts",
       "default": "./dist/index.js"
-    }
+    },
+    "./ag-ui": "./src/ag-ui.ts"
   },
   "publishConfig": {
     "access": "public"
@@ -39,9 +40,13 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@aphrody/ag-ui": "1.0.1",
-    "@aphrody/m3-motion": "3.3.5",
-    "@aphrody/m3-primitives": "3.3.5",
+    "@ag-ui/a2ui-toolkit": "0.0.4",
+    "@ag-ui/client": "npm:@aphrody/ag-ui-client@1.0.1-aphrody.1",
+    "@ag-ui/core": "1.0.1",
+    "@ag-ui/encoder": "1.0.1",
+    "@ag-ui/proto": "1.0.1",
+    "@aphrody/m3-motion": "3.3.7",
+    "@aphrody/m3-primitives": "3.3.7",
     "@aphrody/mcp-ui": "7.1.1-aphrody.1",
     "clsx": "^2.1.1",
     "motion": "^13.4.4",
@@ -50,7 +55,7 @@
     "remark-gfm": "^4.0.1"
   },
   "devDependencies": {
-    "@aphrody/m3-config": "3.3.5"
+    "@aphrody/m3-config": "3.3.7"
   },
   "peerDependencies": {
     "react": ">=18.0.0",

package/src/AgUiEventStream.ts

@@ -21,7 +21,7 @@ import {
   type SubagentFinishedEvent,
   type SubagentErrorEvent,
   type RunErrorEvent,
-} from "@aphrody/ag-ui";
+} from "./ag-ui";
 import {
   type TranscriptStep,
   type TranscriptItem,

package/src/ag-ui.ts

@@ -0,0 +1,19 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * @aphrody/ag-ui
+ *
+ * Full-stack Bun + TS 7 AG-UI Protocol Suite for Aphrody.
+ * Provides typed event-driven agent lifecycle streaming, binary Protobuf transport,
+ * A2UI declarative component generation, and Agent-to-User reactive adapters.
+ */
+
+// Core Protocol & Schema
+export * from "@ag-ui/core";
+export { EventEncoder, type EventEncoderParams } from "@ag-ui/encoder";
+export { encode as encodeProto, decode as decodeProto, AGUI_MEDIA_TYPE } from "@ag-ui/proto";
+
+// Client runtime & transformers
+export * from "@ag-ui/client";
+
+// A2UI Declarative UI Toolkit
+export * from "@ag-ui/a2ui-toolkit";

package/src/index.ts

@@ -86,7 +86,7 @@ export { TaskCreateForm } from "./TaskCreateForm";
 export type { TaskCreateFormProps, TaskCreateFormData } from "./TaskCreateForm";
 
 // AG-UI Protocol & Agent-to-User (A2U) Bridge
-export { EventType } from "@aphrody/ag-ui";
+export { EventType } from "./ag-ui";
 export {
   AgUiEventAccumulator,
   agUiEventsToTranscriptSteps,