@aevr/agents-react 0.1.0

package/README.md

@@ -0,0 +1,27 @@
+# @aevr/agents-react
+
+Headless React hooks, state, and SSE transport for `@aevr/agents` conversation hosts. **No components, no styles, no Tailwind dependency** — compose the state with the shadcn chat suite (`Message`, `MessageScroller`, `Marker`, `Attachment`) or any other UI.
+
+## What ships
+
+- `ConversationsClient` — framework-neutral fetch client for the host `/conversations` API (list/create/get/sendMessage/rename/end + SSE URL/auth helpers).
+- `subscribeConversationEvents` / `readSseStream` — fetch-based SSE with named events, `Last-Event-ID` resume, and bounded auto-reconnect (EventSource cannot send `Authorization` headers).
+- `applyConversationEvent` / `mergeThreadMessages` — pure timeline reducer folding canonical events (`message_delta`, `message_complete`, `tool_call`, `tool_result`, `file_ref`, `approval_required`, `usage`, `done`, `error`) and persisted thread history into one ordered item list.
+- Hooks: `useConversations`, `useConversationEvents` (SSE + resume + polling fallback), `useSendMessage`, `useConversationCost`.
+
+## Usage
+
+```tsx
+const client = useMemo(() => new ConversationsClient({ baseUrl, getToken }), [baseUrl]);
+const { conversations, create } = useConversations(client, projectId);
+const { timeline, status, detail } = useConversationEvents(client, conversationId);
+const { send, sending } = useSendMessage(client, conversationId);
+
+// timeline.items: user_message | assistant_message | tool | approval | file_ref | error
+// Recommended shadcn composition: user turns as scroll anchors, tool/approval
+// items as Marker rows, file_ref items as Attachment rows.
+```
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,32 @@
+import type { ConversationDetail, ConversationMessage, ConversationSummary } from "./types.js";
+export interface ConversationsClientOptions {
+    /** Host API base URL, e.g. https://dashboard.example.com */
+    readonly baseUrl: string;
+    /** Returns the bearer token for the current session. */
+    readonly getToken?: () => string | Promise<string | undefined> | undefined;
+    readonly fetchImpl?: typeof globalThis.fetch;
+}
+/** Minimal fetch client for the host /conversations API. Framework-neutral. */
+export declare class ConversationsClient {
+    #private;
+    constructor(options: ConversationsClientOptions);
+    get baseUrl(): string;
+    authHeaders(): Promise<Record<string, string>>;
+    eventsUrl(conversationId: string, lastEventId?: string): string;
+    list(projectId: string): Promise<readonly ConversationSummary[]>;
+    create(input: {
+        projectId: string;
+        title?: string;
+    }): Promise<{
+        conversation: ConversationSummary;
+        threadId: string;
+    }>;
+    get(conversationId: string, limit?: number): Promise<ConversationDetail>;
+    sendMessage(conversationId: string, content: string): Promise<ConversationMessage>;
+    rename(conversationId: string, title: string): Promise<ConversationSummary>;
+    end(conversationId: string): Promise<{
+        id: string;
+        canceled: boolean;
+    }>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE/F,MAAM,WAAW,0BAA0B;IACzC,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IAC3E,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAC9C;AAID,+EAA+E;AAC/E,qBAAa,mBAAmB;;gBAGlB,OAAO,EAAE,0BAA0B;IAI/C,IAAI,OAAO,IAAI,MAAM,CAEpB;IAEK,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAKpD,SAAS,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM;IAKzD,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC;IAIhE,MAAM,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,YAAY,EAAE,mBAAmB,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAItH,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAKxE,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAIlF,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAI3E,GAAG,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;CAoB9E"}

package/dist/client.js

@@ -0,0 +1,54 @@
+/** Minimal fetch client for the host /conversations API. Framework-neutral. */
+export class ConversationsClient {
+    #options;
+    constructor(options) {
+        this.#options = options;
+    }
+    get baseUrl() {
+        return this.#options.baseUrl.replace(/\/$/, "");
+    }
+    async authHeaders() {
+        const token = await this.#options.getToken?.();
+        return token ? { Authorization: `Bearer ${token}` } : {};
+    }
+    eventsUrl(conversationId, lastEventId) {
+        const query = lastEventId ? `?lastEventId=${encodeURIComponent(lastEventId)}` : "";
+        return `${this.baseUrl}/conversations/${encodeURIComponent(conversationId)}/events${query}`;
+    }
+    async list(projectId) {
+        return this.#request(`/conversations?projectId=${encodeURIComponent(projectId)}`);
+    }
+    async create(input) {
+        return this.#request("/conversations", { method: "POST", body: input });
+    }
+    async get(conversationId, limit) {
+        const query = limit ? `?limit=${limit}` : "";
+        return this.#request(`/conversations/${encodeURIComponent(conversationId)}${query}`);
+    }
+    async sendMessage(conversationId, content) {
+        return this.#request(`/conversations/${encodeURIComponent(conversationId)}/messages`, { method: "POST", body: { content } });
+    }
+    async rename(conversationId, title) {
+        return this.#request(`/conversations/${encodeURIComponent(conversationId)}`, { method: "PATCH", body: { title } });
+    }
+    async end(conversationId) {
+        return this.#request(`/conversations/${encodeURIComponent(conversationId)}`, { method: "DELETE" });
+    }
+    async #request(path, init = {}) {
+        const fetchImpl = this.#options.fetchImpl ?? globalThis.fetch;
+        const response = await fetchImpl(`${this.baseUrl}${path}`, {
+            method: init.method ?? "GET",
+            headers: {
+                ...(init.body !== undefined ? { "Content-Type": "application/json" } : {}),
+                ...(await this.authHeaders()),
+            },
+            body: init.body !== undefined ? JSON.stringify(init.body) : undefined,
+        });
+        const payload = await response.json().catch(() => null);
+        if (!response.ok || !payload?.success) {
+            throw new Error(payload?.error ?? `Conversations request failed with status ${response.status}`);
+        }
+        return payload.data;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/hooks.d.ts

@@ -0,0 +1,35 @@
+import type { ConversationsClient } from "./client.js";
+import { type ConversationTimeline } from "./timeline.js";
+import type { ConversationDetail, ConversationSummary } from "./types.js";
+export interface UseConversationsResult {
+    readonly conversations: readonly ConversationSummary[];
+    readonly loading: boolean;
+    readonly error: string | null;
+    readonly refresh: () => Promise<void>;
+    readonly create: (title?: string) => Promise<ConversationSummary>;
+    readonly rename: (conversationId: string, title: string) => Promise<void>;
+    readonly end: (conversationId: string) => Promise<void>;
+}
+export declare function useConversations(client: ConversationsClient, projectId: string | undefined): UseConversationsResult;
+export type ConversationConnectionStatus = "connecting" | "streaming" | "polling" | "closed" | "error";
+export interface UseConversationEventsResult {
+    readonly timeline: ConversationTimeline;
+    readonly status: ConversationConnectionStatus;
+    readonly detail: ConversationDetail | null;
+    readonly refresh: () => Promise<void>;
+}
+/**
+ * Live conversation state: loads persisted history, subscribes to the SSE
+ * stream with Last-Event-ID resume, and falls back to polling the thread when
+ * the stream cannot be established.
+ */
+export declare function useConversationEvents(client: ConversationsClient, conversationId: string | undefined): UseConversationEventsResult;
+export interface UseSendMessageResult {
+    readonly send: (content: string) => Promise<void>;
+    readonly sending: boolean;
+    readonly error: string | null;
+}
+export declare function useSendMessage(client: ConversationsClient, conversationId: string | undefined, onSent?: () => void): UseSendMessageResult;
+/** Running conversation cost derived from usage events, with a detail fallback. */
+export declare function useConversationCost(timeline: ConversationTimeline, detail: ConversationDetail | null): number;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAA+D,KAAK,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACvH,OAAO,KAAK,EAAE,kBAAkB,EAA6B,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAErG,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,aAAa,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACvD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAClE,QAAQ,CAAC,MAAM,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,QAAQ,CAAC,GAAG,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,sBAAsB,CAsCnH;AAED,MAAM,MAAM,4BAA4B,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEvG,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,GAAG,SAAS,GAAG,2BAA2B,CA8DlI;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,IAAI,GAAG,oBAAoB,CAoBzI;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI,GAAG,MAAM,CAK7G"}

package/dist/hooks.js

@@ -0,0 +1,132 @@
+import { useCallback, useEffect, useMemo, useReducer, useRef, useState } from "react";
+import { subscribeConversationEvents } from "./sse.js";
+import { EMPTY_TIMELINE, applyConversationEvent, mergeThreadMessages } from "./timeline.js";
+export function useConversations(client, projectId) {
+    const [conversations, setConversations] = useState([]);
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const refresh = useCallback(async () => {
+        if (!projectId)
+            return;
+        setLoading(true);
+        try {
+            setConversations(await client.list(projectId));
+            setError(null);
+        }
+        catch (cause) {
+            setError(cause instanceof Error ? cause.message : String(cause));
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [client, projectId]);
+    useEffect(() => { void refresh(); }, [refresh]);
+    const create = useCallback(async (title) => {
+        if (!projectId)
+            throw new Error("projectId is required to create a conversation.");
+        const created = await client.create({ projectId, title });
+        await refresh();
+        return created.conversation;
+    }, [client, projectId, refresh]);
+    const rename = useCallback(async (conversationId, title) => {
+        await client.rename(conversationId, title);
+        await refresh();
+    }, [client, refresh]);
+    const end = useCallback(async (conversationId) => {
+        await client.end(conversationId);
+        await refresh();
+    }, [client, refresh]);
+    return { conversations, loading, error, refresh, create, rename, end };
+}
+/**
+ * Live conversation state: loads persisted history, subscribes to the SSE
+ * stream with Last-Event-ID resume, and falls back to polling the thread when
+ * the stream cannot be established.
+ */
+export function useConversationEvents(client, conversationId) {
+    const [timeline, dispatch] = useReducer((state, action) => {
+        if (action.type === "reset")
+            return EMPTY_TIMELINE;
+        if (action.type === "history") {
+            return mergeThreadMessages(state, action.detail.messages.items, { agentSubjectId: action.detail.conversation.assignedTo });
+        }
+        return applyConversationEvent(state, action.envelope);
+    }, EMPTY_TIMELINE);
+    const [status, setStatus] = useState("connecting");
+    const [detail, setDetail] = useState(null);
+    const lastEventIdRef = useRef(undefined);
+    lastEventIdRef.current = timeline.lastEventId;
+    const refresh = useCallback(async () => {
+        if (!conversationId)
+            return;
+        const loaded = await client.get(conversationId, 200);
+        setDetail(loaded);
+        dispatch({ type: "history", detail: loaded });
+    }, [client, conversationId]);
+    useEffect(() => {
+        if (!conversationId)
+            return;
+        dispatch({ type: "reset" });
+        setDetail(null);
+        setStatus("connecting");
+        let pollTimer = null;
+        let disposed = false;
+        void refresh().catch(() => undefined);
+        let unsubscribe = null;
+        void (async () => {
+            const headers = await client.authHeaders();
+            if (disposed)
+                return;
+            unsubscribe = subscribeConversationEvents({
+                url: client.eventsUrl(conversationId, lastEventIdRef.current),
+                headers,
+                lastEventId: lastEventIdRef.current,
+                onOpen: () => setStatus("streaming"),
+                onEvent: (envelope) => {
+                    dispatch({ type: "event", envelope });
+                    if (envelope.event === "done")
+                        void refresh().catch(() => undefined);
+                },
+                onError: () => {
+                    setStatus("polling");
+                    // SSE unavailable — poll the persisted thread instead.
+                    pollTimer ??= setInterval(() => { void refresh().catch(() => undefined); }, 3_000);
+                },
+            });
+        })();
+        return () => {
+            disposed = true;
+            unsubscribe?.();
+            if (pollTimer)
+                clearInterval(pollTimer);
+        };
+    }, [client, conversationId, refresh]);
+    return { timeline, status, detail, refresh };
+}
+export function useSendMessage(client, conversationId, onSent) {
+    const [sending, setSending] = useState(false);
+    const [error, setError] = useState(null);
+    const send = useCallback(async (content) => {
+        if (!conversationId || !content.trim())
+            return;
+        setSending(true);
+        try {
+            await client.sendMessage(conversationId, content);
+            setError(null);
+            onSent?.();
+        }
+        catch (cause) {
+            setError(cause instanceof Error ? cause.message : String(cause));
+            throw cause;
+        }
+        finally {
+            setSending(false);
+        }
+    }, [client, conversationId, onSent]);
+    return { send, sending, error };
+}
+/** Running conversation cost derived from usage events, with a detail fallback. */
+export function useConversationCost(timeline, detail) {
+    return useMemo(() => Math.max(timeline.cumulativeCostUsd, detail?.conversation.usage?.projectedCostUsd ?? 0), [timeline.cumulativeCostUsd, detail]);
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./types.js";
+export * from "./sse.js";
+export * from "./timeline.js";
+export * from "./client.js";
+export * from "./hooks.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./types.js";
+export * from "./sse.js";
+export * from "./timeline.js";
+export * from "./client.js";
+export * from "./hooks.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/sse.d.ts

@@ -0,0 +1,23 @@
+import type { ConversationEventEnvelope } from "./types.js";
+/** Parses a text/event-stream body into named event envelopes (data JSON-decoded when possible). */
+export declare function readSseStream(stream: ReadableStream<Uint8Array>): AsyncGenerator<ConversationEventEnvelope>;
+export declare function parseSseBlock(block: string): ConversationEventEnvelope | null;
+export interface SubscribeConversationEventsOptions {
+    readonly url: string;
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly lastEventId?: string;
+    readonly fetchImpl?: typeof globalThis.fetch;
+    readonly onEvent: (envelope: ConversationEventEnvelope) => void;
+    readonly onError?: (error: unknown) => void;
+    readonly onOpen?: () => void;
+    /** Reconnect backoff in ms; reconnects resume from the last seen event id. Default 2000. */
+    readonly retryDelayMs?: number;
+    /** Maximum consecutive failed connection attempts before giving up. Default 5. */
+    readonly maxRetries?: number;
+}
+/**
+ * Fetch-based SSE subscription (EventSource cannot send Authorization headers).
+ * Auto-reconnects with Last-Event-ID resume. Returns an unsubscribe function.
+ */
+export declare function subscribeConversationEvents(options: SubscribeConversationEventsOptions): () => void;
+//# sourceMappingURL=sse.d.ts.map

package/dist/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE5D,oGAAoG;AACpG,wBAAuB,aAAa,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,cAAc,CAAC,yBAAyB,CAAC,CAqBlH;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,yBAAyB,GAAG,IAAI,CAmB7E;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,yBAAyB,KAAK,IAAI,CAAC;IAChE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B,4FAA4F;IAC5F,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,kFAAkF;IAClF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,kCAAkC,GAAG,MAAM,IAAI,CAsCnG"}

package/dist/sse.js

@@ -0,0 +1,103 @@
+/** Parses a text/event-stream body into named event envelopes (data JSON-decoded when possible). */
+export async function* readSseStream(stream) {
+    const reader = stream.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            let boundary = buffer.indexOf("\n\n");
+            while (boundary >= 0) {
+                const block = buffer.slice(0, boundary);
+                buffer = buffer.slice(boundary + 2);
+                const envelope = parseSseBlock(block);
+                if (envelope)
+                    yield envelope;
+                boundary = buffer.indexOf("\n\n");
+            }
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+export function parseSseBlock(block) {
+    let event = "message";
+    let id;
+    const dataLines = [];
+    for (const line of block.split("\n")) {
+        if (line.startsWith(":"))
+            continue; // comment / heartbeat
+        const separator = line.indexOf(":");
+        if (separator < 0)
+            continue;
+        const field = line.slice(0, separator);
+        const value = line.slice(separator + 1).replace(/^ /, "");
+        if (field === "event")
+            event = value;
+        else if (field === "id")
+            id = value;
+        else if (field === "data")
+            dataLines.push(value);
+    }
+    if (dataLines.length === 0)
+        return null;
+    const raw = dataLines.join("\n");
+    let data = raw;
+    try {
+        data = JSON.parse(raw);
+    }
+    catch { /* keep raw string */ }
+    return { event, id, data };
+}
+/**
+ * Fetch-based SSE subscription (EventSource cannot send Authorization headers).
+ * Auto-reconnects with Last-Event-ID resume. Returns an unsubscribe function.
+ */
+export function subscribeConversationEvents(options) {
+    const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+    const controller = new AbortController();
+    let lastEventId = options.lastEventId;
+    let failures = 0;
+    void (async () => {
+        while (!controller.signal.aborted) {
+            try {
+                const response = await fetchImpl(options.url, {
+                    headers: {
+                        Accept: "text/event-stream",
+                        ...options.headers,
+                        ...(lastEventId ? { "Last-Event-ID": lastEventId } : {}),
+                    },
+                    signal: controller.signal,
+                });
+                if (!response.ok || !response.body)
+                    throw new Error(`SSE connection failed with status ${response.status}`);
+                options.onOpen?.();
+                failures = 0;
+                for await (const envelope of readSseStream(response.body)) {
+                    if (controller.signal.aborted)
+                        return;
+                    if (envelope.id)
+                        lastEventId = envelope.id;
+                    options.onEvent(envelope);
+                }
+                // Server closed the stream (terminal conversation state) — stop reconnecting.
+                return;
+            }
+            catch (error) {
+                if (controller.signal.aborted)
+                    return;
+                failures += 1;
+                options.onError?.(error);
+                if (failures >= (options.maxRetries ?? 5))
+                    return;
+                await new Promise((resolve) => setTimeout(resolve, options.retryDelayMs ?? 2_000));
+            }
+        }
+    })();
+    return () => controller.abort();
+}
+//# sourceMappingURL=sse.js.map

package/dist/sse.js.map

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

package/dist/timeline.d.ts

@@ -0,0 +1,59 @@
+import type { ConversationEventEnvelope, ConversationMessage, DoneEvent, FileRef } from "./types.js";
+export type TimelineItem = {
+    readonly kind: "user_message";
+    readonly id: string;
+    readonly content: string;
+    readonly createdAt?: string;
+} | {
+    readonly kind: "assistant_message";
+    readonly id: string;
+    readonly content: string;
+    readonly streaming: boolean;
+    readonly createdAt?: string;
+} | {
+    readonly kind: "tool";
+    readonly id: string;
+    readonly callId: string;
+    readonly tool: string;
+    readonly args?: unknown;
+    readonly status: "running" | "ok" | "failed";
+    readonly summary?: string;
+    readonly truncated?: boolean;
+    readonly durationMs?: number;
+    readonly startedAt?: string;
+} | {
+    readonly kind: "approval";
+    readonly id: string;
+    readonly approvalId: string;
+    readonly tool?: string;
+    readonly reason?: string;
+} | {
+    readonly kind: "file_ref";
+    readonly id: string;
+    readonly ref: FileRef;
+} | {
+    readonly kind: "error";
+    readonly id: string;
+    readonly code: string;
+    readonly message: string;
+    readonly retryable?: boolean;
+};
+export interface ConversationTimeline {
+    readonly items: readonly TimelineItem[];
+    readonly lastEventId?: string;
+    readonly cumulativeCostUsd: number;
+    readonly streaming: boolean;
+    readonly lastStopReason?: DoneEvent["stopReason"];
+}
+export declare const EMPTY_TIMELINE: ConversationTimeline;
+/** Pure reducer: folds one canonical SSE event envelope into the timeline. */
+export declare function applyConversationEvent(state: ConversationTimeline, envelope: ConversationEventEnvelope): ConversationTimeline;
+/**
+ * Folds persisted thread messages (polling fallback / initial history) into the
+ * timeline, deduplicating by message id. Messages from the agent subject render
+ * as assistant messages; everything else as user messages.
+ */
+export declare function mergeThreadMessages(state: ConversationTimeline, messages: readonly ConversationMessage[], options: {
+    readonly agentSubjectId?: string;
+}): ConversationTimeline;
+//# sourceMappingURL=timeline.d.ts.map

package/dist/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../src/timeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,yBAAyB,EACzB,mBAAmB,EACnB,SAAS,EAET,OAAO,EAMR,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7G;IAAE,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/I;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,GAAG,QAAQ,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACzR;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACjI;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GACzE;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEnI,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;CACnD;AAED,eAAO,MAAM,cAAc,EAAE,oBAA2F,CAAC;AAUzH,8EAA8E;AAC9E,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,yBAAyB,GAAG,oBAAoB,CA0D7H;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,SAAS,mBAAmB,EAAE,EACxC,OAAO,EAAE;IAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,oBAAoB,CAatB"}

package/dist/timeline.js

@@ -0,0 +1,92 @@
+export const EMPTY_TIMELINE = Object.freeze({ items: [], cumulativeCostUsd: 0, streaming: false });
+function upsert(items, id, next) {
+    const index = items.findIndex((item) => item.id === id);
+    if (index < 0)
+        return [...items, next];
+    const copy = [...items];
+    copy[index] = next;
+    return copy;
+}
+/** Pure reducer: folds one canonical SSE event envelope into the timeline. */
+export function applyConversationEvent(state, envelope) {
+    const lastEventId = envelope.id ?? state.lastEventId;
+    switch (envelope.event) {
+        case "message_delta": {
+            const data = envelope.data;
+            const existing = state.items.find((item) => item.id === data.messageId);
+            const content = existing?.kind === "assistant_message" ? existing.content + data.delta : data.delta;
+            return { ...state, lastEventId, streaming: true, items: upsert(state.items, data.messageId, { kind: "assistant_message", id: data.messageId, content, streaming: true }) };
+        }
+        case "message_complete": {
+            const data = envelope.data;
+            if (!data.content)
+                return { ...state, lastEventId };
+            return { ...state, lastEventId, items: upsert(state.items, data.messageId, { kind: "assistant_message", id: data.messageId, content: data.content, streaming: false }) };
+        }
+        case "tool_call": {
+            const data = envelope.data;
+            const id = `tool:${data.callId}`;
+            return { ...state, lastEventId, streaming: true, items: upsert(state.items, id, { kind: "tool", id, callId: data.callId, tool: data.tool, args: data.argsRedacted, status: "running", startedAt: data.startedAt }) };
+        }
+        case "tool_result": {
+            const data = envelope.data;
+            const id = `tool:${data.callId}`;
+            const existing = state.items.find((item) => item.id === id);
+            const base = existing?.kind === "tool" ? existing : { kind: "tool", id, callId: data.callId, tool: "unknown", status: "running" };
+            return { ...state, lastEventId, items: upsert(state.items, id, { ...base, status: data.ok ? "ok" : "failed", summary: data.summary, truncated: data.truncated, durationMs: data.durationMs }) };
+        }
+        case "file_ref": {
+            const data = envelope.data;
+            const id = `file:${data.kind}:${data.id}:${envelope.id ?? state.items.length}`;
+            return { ...state, lastEventId, items: [...state.items, { kind: "file_ref", id, ref: data }] };
+        }
+        case "approval_required": {
+            const data = envelope.data;
+            const id = `approval:${data.approvalId}`;
+            return { ...state, lastEventId, items: upsert(state.items, id, { kind: "approval", id, approvalId: data.approvalId, tool: data.tool, reason: data.reason }) };
+        }
+        case "usage": {
+            const data = envelope.data;
+            return { ...state, lastEventId, cumulativeCostUsd: Math.max(state.cumulativeCostUsd, data.cumulativeCostUsd) };
+        }
+        case "done": {
+            const data = envelope.data;
+            return {
+                ...state,
+                lastEventId,
+                streaming: false,
+                lastStopReason: data.stopReason,
+                items: state.items.map((item) => item.kind === "assistant_message" && item.streaming ? { ...item, streaming: false } : item),
+            };
+        }
+        case "error": {
+            const data = envelope.data;
+            const id = `error:${envelope.id ?? state.items.length}`;
+            return { ...state, lastEventId, streaming: false, items: [...state.items, { kind: "error", id, code: data.code, message: data.message, retryable: data.retryable }] };
+        }
+        default:
+            return { ...state, lastEventId };
+    }
+}
+/**
+ * Folds persisted thread messages (polling fallback / initial history) into the
+ * timeline, deduplicating by message id. Messages from the agent subject render
+ * as assistant messages; everything else as user messages.
+ */
+export function mergeThreadMessages(state, messages, options) {
+    let items = state.items;
+    const assistantContents = new Set(items.filter((item) => item.kind === "assistant_message").map((item) => item.content));
+    for (const message of messages) {
+        if (items.some((item) => item.id === message.id))
+            continue;
+        const isAgent = options.agentSubjectId !== undefined && message.senderId === options.agentSubjectId;
+        // SSE-delivered assistant text has run-scoped ids; skip persisted duplicates by content.
+        if (isAgent && assistantContents.has(message.content))
+            continue;
+        items = [...items, isAgent
+                ? { kind: "assistant_message", id: message.id, content: message.content, streaming: false, createdAt: message.createdAt }
+                : { kind: "user_message", id: message.id, content: message.content, createdAt: message.createdAt }];
+    }
+    return items === state.items ? state : { ...state, items };
+}
+//# sourceMappingURL=timeline.js.map

package/dist/timeline.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Canonical conversation SSE event contract (host: GET /conversations/:id/events).
+ * Mirrors the Phase 33 spec table — named events with JSON payloads.
+ */
+export interface FileRef {
+    readonly kind: string;
+    readonly id: string;
+    readonly folder?: string;
+    readonly action: "created" | "updated" | "referenced" | "deleted";
+    readonly label?: string;
+}
+export interface MessageDeltaEvent {
+    readonly messageId: string;
+    readonly delta: string;
+}
+export interface MessageCompleteEvent {
+    readonly messageId: string;
+    readonly content: string;
+}
+export interface ToolCallEvent {
+    readonly callId: string;
+    readonly tool: string;
+    readonly argsRedacted?: unknown;
+    readonly startedAt?: string;
+}
+export interface ToolResultEvent {
+    readonly callId: string;
+    readonly ok: boolean;
+    readonly summary?: string;
+    readonly truncated?: boolean;
+    readonly durationMs?: number;
+    readonly fileRefs?: readonly FileRef[];
+}
+export interface ApprovalRequiredEvent {
+    readonly approvalId: string;
+    readonly tool?: string;
+    readonly argsRedacted?: unknown;
+    readonly reason?: string;
+}
+export interface UsageEvent {
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly estimatedCostUsd: number;
+    readonly cumulativeCostUsd: number;
+}
+export interface DoneEvent {
+    readonly taskRunId: string | null;
+    readonly stopReason: "completed" | "awaiting_approval" | "max_iterations" | "cancelled" | "error";
+}
+export interface ErrorEvent {
+    readonly code: string;
+    readonly message: string;
+    readonly retryable?: boolean;
+}
+export type ConversationEvent = {
+    readonly event: "message_delta";
+    readonly data: MessageDeltaEvent;
+} | {
+    readonly event: "message_complete";
+    readonly data: MessageCompleteEvent;
+} | {
+    readonly event: "tool_call";
+    readonly data: ToolCallEvent;
+} | {
+    readonly event: "tool_result";
+    readonly data: ToolResultEvent;
+} | {
+    readonly event: "file_ref";
+    readonly data: FileRef;
+} | {
+    readonly event: "approval_required";
+    readonly data: ApprovalRequiredEvent;
+} | {
+    readonly event: "usage";
+    readonly data: UsageEvent;
+} | {
+    readonly event: "done";
+    readonly data: DoneEvent;
+} | {
+    readonly event: "error";
+    readonly data: ErrorEvent;
+};
+export interface ConversationEventEnvelope {
+    readonly event: string;
+    readonly id?: string;
+    readonly data: unknown;
+}
+/** Conversation summary as returned by the host list/detail endpoints. */
+export interface ConversationSummary {
+    readonly id: string;
+    readonly projectId: string;
+    readonly title: string;
+    /** "idle" while the agent awaits the next user message; otherwise the task status. */
+    readonly status: string;
+    readonly taskStatus: string;
+    readonly blockedReason?: string;
+    readonly assignedTo?: string;
+    readonly latestRunId?: string;
+    readonly usage?: Readonly<Record<string, number>>;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly threadId?: string | null;
+    readonly lastMessage?: ConversationMessage | null;
+}
+export interface ConversationMessage {
+    readonly id: string;
+    readonly threadId: string;
+    readonly senderId: string;
+    readonly recipientIds?: readonly string[];
+    readonly kind: string;
+    readonly content: string;
+    readonly createdAt: string;
+}
+export interface ConversationDetail {
+    readonly conversation: ConversationSummary;
+    readonly threadId: string | null;
+    readonly messages: {
+        readonly items: readonly ConversationMessage[];
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Canonical conversation SSE event contract (host: GET /conversations/:id/events).
+ * Mirrors the Phase 33 spec table — named events with JSON payloads.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@aevr/agents-react",
+  "version": "0.1.0",
+  "description": "Headless React hooks, state, and SSE transport for @aevr/agents conversations. No components, no styles — compose with shadcn or any UI.",
+  "keywords": [
+    "agents",
+    "ai",
+    "chat",
+    "conversations",
+    "headless",
+    "hooks",
+    "react",
+    "sse",
+    "typescript"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.js.map",
+    "dist/**/*.d.ts",
+    "dist/**/*.d.ts.map",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc -p .",
+    "typecheck": "tsc --noEmit",
+    "test": "tsx --test src/*.test.ts",
+    "prepublishOnly": "npm test && npm run typecheck && npm run build",
+    "release": "standard-version --tag-prefix agents-react@v",
+    "release:patch": "standard-version --release-as patch --tag-prefix agents-react@v",
+    "release:minor": "standard-version --release-as minor --tag-prefix agents-react@v",
+    "release:major": "standard-version --release-as major --tag-prefix agents-react@v"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/miracleonyenma/proxmox-management.git",
+    "directory": "packages/agents-react"
+  },
+  "homepage": "https://github.com/miracleonyenma/proxmox-management/tree/main/packages/agents-react#readme",
+  "bugs": {
+    "url": "https://github.com/miracleonyenma/proxmox-management/issues"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "22.20.1",
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0",
+    "standard-version": "^9.5.0",
+    "tsx": "^4.20.6",
+    "typescript": "^5.7.2"
+  }
+}