@stigmer/react 0.3.4 → 0.4.1

package/internal/store/__tests__/structural-share.test.js

@@ -0,0 +1,368 @@
+import { describe, it, expect } from "vitest";
+import { create } from "@bufbuild/protobuf";
+import { AgentExecutionSchema, AgentExecutionStatusSchema, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+import { AgentExecutionSpecSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/spec_pb";
+import { ApiResourceMetadataSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
+import { AgentMessageSchema, ToolCallSchema, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/message_pb";
+import { SubAgentExecutionSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/subagent_pb";
+import { PendingApprovalSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/approval_pb";
+import { ExecutionPhase, MessageType, ToolCallStatus, SubAgentStatus, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { structuralShare } from "../structural-share";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function msg(type, content, opts) {
+    const m = create(AgentMessageSchema);
+    m.type = type;
+    m.content = content;
+    if (opts?.toolCalls)
+        m.toolCalls = opts.toolCalls;
+    if (opts?.isStreaming)
+        m.isStreaming = true;
+    if (opts?.timestamp)
+        m.timestamp = opts.timestamp;
+    return m;
+}
+function tc(id, name, opts) {
+    const t = create(ToolCallSchema);
+    t.id = id;
+    t.name = name;
+    t.status = opts?.status ?? ToolCallStatus.TOOL_CALL_COMPLETED;
+    if (opts?.result)
+        t.result = opts.result;
+    if (opts?.isStreaming)
+        t.isStreaming = true;
+    return t;
+}
+function subAgent(id, opts) {
+    const sa = create(SubAgentExecutionSchema);
+    sa.id = id;
+    sa.name = `agent-${id}`;
+    sa.status = opts?.status ?? SubAgentStatus.SUB_AGENT_IN_PROGRESS;
+    if (opts?.messages)
+        sa.messages = opts.messages;
+    if (opts?.output)
+        sa.output = opts.output;
+    return sa;
+}
+function approval(toolCallId, toolName) {
+    const a = create(PendingApprovalSchema);
+    a.toolCallId = toolCallId;
+    a.toolName = toolName;
+    return a;
+}
+function exec(opts) {
+    const e = create(AgentExecutionSchema);
+    const meta = create(ApiResourceMetadataSchema);
+    meta.id = opts.id ?? "exec-1";
+    e.metadata = meta;
+    const spec = create(AgentExecutionSpecSchema);
+    e.spec = spec;
+    const status = create(AgentExecutionStatusSchema);
+    status.phase = opts.phase ?? ExecutionPhase.EXECUTION_IN_PROGRESS;
+    if (opts.messages)
+        status.messages = opts.messages;
+    if (opts.subAgents)
+        status.subAgentExecutions = opts.subAgents;
+    if (opts.approvals)
+        status.pendingApprovals = opts.approvals;
+    e.status = status;
+    return e;
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe("structuralShare", () => {
+    describe("first snapshot (prev is null)", () => {
+        it("returns next unchanged", () => {
+            const next = exec({ messages: [msg(MessageType.MESSAGE_HUMAN, "hi")] });
+            expect(structuralShare(null, next)).toBe(next);
+        });
+    });
+    describe("identical snapshots", () => {
+        it("returns prev reference when nothing changed", () => {
+            const snapshot = exec({
+                messages: [
+                    msg(MessageType.MESSAGE_HUMAN, "hello"),
+                    msg(MessageType.MESSAGE_AI, "world"),
+                ],
+            });
+            const next = exec({
+                messages: [
+                    msg(MessageType.MESSAGE_HUMAN, "hello"),
+                    msg(MessageType.MESSAGE_AI, "world"),
+                ],
+            });
+            const result = structuralShare(snapshot, next);
+            expect(result).toBe(snapshot);
+        });
+    });
+    describe("message-level sharing", () => {
+        it("reuses references for unchanged messages at the prefix", () => {
+            const m1 = msg(MessageType.MESSAGE_HUMAN, "hello");
+            const m2 = msg(MessageType.MESSAGE_AI, "complete response");
+            const prev = exec({ messages: [m1, m2] });
+            const m3 = msg(MessageType.MESSAGE_AI, "streaming...", {
+                isStreaming: true,
+            });
+            const next = exec({
+                messages: [
+                    msg(MessageType.MESSAGE_HUMAN, "hello"),
+                    msg(MessageType.MESSAGE_AI, "complete response"),
+                    m3,
+                ],
+            });
+            const result = structuralShare(prev, next);
+            expect(result).not.toBe(prev);
+            expect(result.status.messages[0]).toBe(m1);
+            expect(result.status.messages[1]).toBe(m2);
+            expect(result.status.messages[2]).toBe(m3);
+        });
+        it("produces new reference for a message whose content changed", () => {
+            const m1 = msg(MessageType.MESSAGE_HUMAN, "hello");
+            const prev = exec({
+                messages: [m1, msg(MessageType.MESSAGE_AI, "partial")],
+            });
+            const next = exec({
+                messages: [
+                    msg(MessageType.MESSAGE_HUMAN, "hello"),
+                    msg(MessageType.MESSAGE_AI, "partial text growing"),
+                ],
+            });
+            const result = structuralShare(prev, next);
+            expect(result.status.messages[0]).toBe(m1);
+            expect(result.status.messages[1]).not.toBe(prev.status.messages[1]);
+            expect(result.status.messages[1].content).toBe("partial text growing");
+        });
+        it("produces new reference when isStreaming flag changes", () => {
+            const prev = exec({
+                messages: [
+                    msg(MessageType.MESSAGE_AI, "done text", { isStreaming: true }),
+                ],
+            });
+            const next = exec({
+                messages: [
+                    msg(MessageType.MESSAGE_AI, "done text", { isStreaming: false }),
+                ],
+            });
+            const result = structuralShare(prev, next);
+            expect(result).not.toBe(prev);
+            expect(result.status.messages[0]).not.toBe(prev.status.messages[0]);
+        });
+        it("handles empty to non-empty messages transition", () => {
+            const prev = exec({ messages: [] });
+            const next = exec({
+                messages: [msg(MessageType.MESSAGE_HUMAN, "first")],
+            });
+            const result = structuralShare(prev, next);
+            expect(result).not.toBe(prev);
+            expect(result.status.messages.length).toBe(1);
+        });
+        it("returns prev when both have empty messages", () => {
+            const prev = exec({ messages: [] });
+            const next = exec({ messages: [] });
+            expect(structuralShare(prev, next)).toBe(prev);
+        });
+    });
+    describe("tool call sharing within messages", () => {
+        it("preserves unchanged tool call references by id", () => {
+            const tc1 = tc("tc-1", "read_file", { result: "file content" });
+            const tc2 = tc("tc-2", "write_file", {
+                status: ToolCallStatus.TOOL_CALL_RUNNING,
+                isStreaming: true,
+            });
+            const prev = exec({
+                messages: [
+                    msg(MessageType.MESSAGE_AI, "using tools", { toolCalls: [tc1, tc2] }),
+                ],
+            });
+            const tc2Updated = tc("tc-2", "write_file", {
+                status: ToolCallStatus.TOOL_CALL_COMPLETED,
+                result: "written",
+            });
+            const next = exec({
+                messages: [
+                    msg(MessageType.MESSAGE_AI, "using tools", {
+                        toolCalls: [
+                            tc("tc-1", "read_file", { result: "file content" }),
+                            tc2Updated,
+                        ],
+                    }),
+                ],
+            });
+            const result = structuralShare(prev, next);
+            const resultTcs = result.status.messages[0].toolCalls;
+            expect(resultTcs[0]).toBe(tc1);
+            expect(resultTcs[1]).not.toBe(tc2);
+            expect(resultTcs[1].status).toBe(ToolCallStatus.TOOL_CALL_COMPLETED);
+        });
+        it("handles new tool calls being appended", () => {
+            const tc1 = tc("tc-1", "read_file", { result: "ok" });
+            const prev = exec({
+                messages: [
+                    msg(MessageType.MESSAGE_AI, "tools", { toolCalls: [tc1] }),
+                ],
+            });
+            const next = exec({
+                messages: [
+                    msg(MessageType.MESSAGE_AI, "tools", {
+                        toolCalls: [
+                            tc("tc-1", "read_file", { result: "ok" }),
+                            tc("tc-2", "write_file"),
+                        ],
+                    }),
+                ],
+            });
+            const result = structuralShare(prev, next);
+            const resultTcs = result.status.messages[0].toolCalls;
+            expect(resultTcs[0]).toBe(tc1);
+            expect(resultTcs.length).toBe(2);
+        });
+    });
+    describe("sub-agent sharing", () => {
+        it("reuses unchanged sub-agent references by id", () => {
+            const sa1 = subAgent("sa-1", {
+                status: SubAgentStatus.SUB_AGENT_COMPLETED,
+                messages: [msg(MessageType.MESSAGE_AI, "sub done")],
+                output: "result",
+            });
+            const prev = exec({ subAgents: [sa1] });
+            const next = exec({
+                subAgents: [
+                    subAgent("sa-1", {
+                        status: SubAgentStatus.SUB_AGENT_COMPLETED,
+                        messages: [msg(MessageType.MESSAGE_AI, "sub done")],
+                        output: "result",
+                    }),
+                ],
+            });
+            const result = structuralShare(prev, next);
+            expect(result.status.subAgentExecutions[0]).toBe(sa1);
+        });
+        it("produces new reference for updated sub-agent but shares its inner messages", () => {
+            const innerMsg = msg(MessageType.MESSAGE_AI, "thinking");
+            const sa = subAgent("sa-1", {
+                status: SubAgentStatus.SUB_AGENT_IN_PROGRESS,
+                messages: [innerMsg],
+            });
+            const prev = exec({ subAgents: [sa] });
+            const next = exec({
+                subAgents: [
+                    subAgent("sa-1", {
+                        status: SubAgentStatus.SUB_AGENT_IN_PROGRESS,
+                        messages: [
+                            msg(MessageType.MESSAGE_AI, "thinking"),
+                            msg(MessageType.MESSAGE_AI, "more thinking"),
+                        ],
+                    }),
+                ],
+            });
+            const result = structuralShare(prev, next);
+            const resultSa = result.status.subAgentExecutions[0];
+            expect(resultSa).not.toBe(sa);
+            expect(resultSa.messages[0]).toBe(innerMsg);
+            expect(resultSa.messages.length).toBe(2);
+        });
+        it("handles new sub-agent appearing", () => {
+            const sa1 = subAgent("sa-1", {
+                status: SubAgentStatus.SUB_AGENT_COMPLETED,
+            });
+            const prev = exec({ subAgents: [sa1] });
+            const next = exec({
+                subAgents: [
+                    subAgent("sa-1", {
+                        status: SubAgentStatus.SUB_AGENT_COMPLETED,
+                    }),
+                    subAgent("sa-2", {
+                        status: SubAgentStatus.SUB_AGENT_IN_PROGRESS,
+                    }),
+                ],
+            });
+            const result = structuralShare(prev, next);
+            expect(result.status.subAgentExecutions[0]).toBe(sa1);
+            expect(result.status.subAgentExecutions.length).toBe(2);
+        });
+    });
+    describe("pending approvals sharing", () => {
+        it("reuses prev array when approvals are unchanged", () => {
+            const a1 = approval("tc-1", "dangerous_tool");
+            const prev = exec({ approvals: [a1] });
+            const next = exec({
+                approvals: [approval("tc-1", "dangerous_tool")],
+            });
+            const result = structuralShare(prev, next);
+            expect(result.status.pendingApprovals).toBe(prev.status.pendingApprovals);
+        });
+        it("uses new array when approvals change", () => {
+            const prev = exec({ approvals: [approval("tc-1", "tool1")] });
+            const next = exec({
+                approvals: [approval("tc-1", "tool1"), approval("tc-2", "tool2")],
+            });
+            const result = structuralShare(prev, next);
+            expect(result.status.pendingApprovals).not.toBe(prev.status.pendingApprovals);
+        });
+        it("uses new array when an approval is removed", () => {
+            const prev = exec({
+                approvals: [approval("tc-1", "tool1"), approval("tc-2", "tool2")],
+            });
+            const next = exec({ approvals: [approval("tc-1", "tool1")] });
+            const result = structuralShare(prev, next);
+            expect(result.status.pendingApprovals).not.toBe(prev.status.pendingApprovals);
+        });
+    });
+    describe("phase changes", () => {
+        it("produces new reference when phase changes", () => {
+            const prev = exec({ phase: ExecutionPhase.EXECUTION_IN_PROGRESS });
+            const next = exec({ phase: ExecutionPhase.EXECUTION_COMPLETED });
+            const result = structuralShare(prev, next);
+            expect(result).not.toBe(prev);
+            expect(result.status.phase).toBe(ExecutionPhase.EXECUTION_COMPLETED);
+        });
+    });
+    describe("realistic streaming scenario", () => {
+        it("only the streaming tail produces new references during token streaming", () => {
+            const humanMsg = msg(MessageType.MESSAGE_HUMAN, "Explain React hooks");
+            const completedAi = msg(MessageType.MESSAGE_AI, "React hooks are...", {
+                toolCalls: [tc("tc-1", "read_docs", { result: "hooks docs" })],
+            });
+            const prev = exec({
+                messages: [
+                    humanMsg,
+                    completedAi,
+                    msg(MessageType.MESSAGE_AI, "Let me explain fur", {
+                        isStreaming: true,
+                    }),
+                ],
+            });
+            const next = exec({
+                messages: [
+                    msg(MessageType.MESSAGE_HUMAN, "Explain React hooks"),
+                    msg(MessageType.MESSAGE_AI, "React hooks are...", {
+                        toolCalls: [tc("tc-1", "read_docs", { result: "hooks docs" })],
+                    }),
+                    msg(MessageType.MESSAGE_AI, "Let me explain further. Hooks are", {
+                        isStreaming: true,
+                    }),
+                ],
+            });
+            const result = structuralShare(prev, next);
+            expect(result.status.messages[0]).toBe(humanMsg);
+            expect(result.status.messages[1]).toBe(completedAi);
+            expect(result.status.messages[2]).not.toBe(prev.status.messages[2]);
+            expect(result.status.messages[2].content).toBe("Let me explain further. Hooks are");
+        });
+    });
+    describe("missing status", () => {
+        it("returns next when prev has no status", () => {
+            const prev = create(AgentExecutionSchema);
+            const next = exec({ messages: [msg(MessageType.MESSAGE_AI, "hi")] });
+            expect(structuralShare(prev, next)).toBe(next);
+        });
+        it("returns next when next has no status", () => {
+            const prev = exec({ messages: [msg(MessageType.MESSAGE_AI, "hi")] });
+            const next = create(AgentExecutionSchema);
+            expect(structuralShare(prev, next)).toBe(next);
+        });
+    });
+});
+//# sourceMappingURL=structural-share.test.js.map

package/internal/store/__tests__/structural-share.test.js.map

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

package/internal/store/conversation-store.d.ts

@@ -0,0 +1,62 @@
+import type { AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+export type StreamState = {
+    readonly stage: "idle";
+} | {
+    readonly stage: "connecting";
+    readonly executionId: string;
+} | {
+    readonly stage: "streaming";
+    readonly executionId: string;
+} | {
+    readonly stage: "complete";
+    readonly executionId: string;
+} | {
+    readonly stage: "error";
+    readonly executionId: string;
+    readonly error: Error;
+};
+type Listener = () => void;
+/**
+ * Framework-agnostic store that holds the active execution snapshot
+ * with structural sharing. Implements the contract required by
+ * React's `useSyncExternalStore`.
+ *
+ * - `ingestSnapshot` applies structural sharing so unchanged nested
+ *   entities keep their previous reference.
+ * - Listeners are notified only when state actually changes.
+ * - `getExecution` and `getStreamState` return stable references
+ *   suitable as `useSyncExternalStore` snapshot selectors.
+ */
+export declare class ConversationStore {
+    private _execution;
+    private _streamState;
+    private _listeners;
+    /**
+     * Ingest a new execution snapshot. Applies structural sharing
+     * against the previous snapshot and notifies listeners only if
+     * the resulting reference changed.
+     */
+    ingestSnapshot(snapshot: AgentExecution): void;
+    /**
+     * Transition the stream lifecycle state. Notifies listeners only
+     * when the stage or executionId actually changes.
+     */
+    setStreamState(state: StreamState): void;
+    /**
+     * Reset to initial state. Used when the session identity changes
+     * or the hook unmounts.
+     */
+    reset(): void;
+    /**
+     * Subscribe a listener that is called whenever any store state
+     * changes. Returns an unsubscribe function.
+     */
+    subscribe: (listener: Listener) => (() => void);
+    /** Stable snapshot selector for the current execution. */
+    getExecution: () => AgentExecution | null;
+    /** Stable snapshot selector for the stream lifecycle state. */
+    getStreamState: () => StreamState;
+    private _notify;
+}
+export {};
+//# sourceMappingURL=conversation-store.d.ts.map

package/internal/store/conversation-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-store.d.ts","sourceRoot":"","sources":["../../../src/internal/store/conversation-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6DAA6D,CAAC;AAOlG,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC5D;IACE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB,CAAC;AAQN,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAE3B;;;;;;;;;;GAUG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,UAAU,CAAuB;IAIzC;;;;OAIG;IACH,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAO9C;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAMxC;;;OAGG;IACH,KAAK,IAAI,IAAI;IAUb;;;OAGG;IACH,SAAS,GAAI,UAAU,QAAQ,KAAG,CAAC,MAAM,IAAI,CAAC,CAK5C;IAEF,0DAA0D;IAC1D,YAAY,QAAO,cAAc,GAAG,IAAI,CAEtC;IAEF,+DAA+D;IAC/D,cAAc,QAAO,WAAW,CAE9B;IAIF,OAAO,CAAC,OAAO;CAKhB"}

package/internal/store/conversation-store.js

@@ -0,0 +1,95 @@
+import { structuralShare } from "./structural-share";
+const IDLE_STATE = { stage: "idle" };
+/**
+ * Framework-agnostic store that holds the active execution snapshot
+ * with structural sharing. Implements the contract required by
+ * React's `useSyncExternalStore`.
+ *
+ * - `ingestSnapshot` applies structural sharing so unchanged nested
+ *   entities keep their previous reference.
+ * - Listeners are notified only when state actually changes.
+ * - `getExecution` and `getStreamState` return stable references
+ *   suitable as `useSyncExternalStore` snapshot selectors.
+ */
+export class ConversationStore {
+    _execution = null;
+    _streamState = IDLE_STATE;
+    _listeners = new Set();
+    // -- Ingestion -----------------------------------------------------------
+    /**
+     * Ingest a new execution snapshot. Applies structural sharing
+     * against the previous snapshot and notifies listeners only if
+     * the resulting reference changed.
+     */
+    ingestSnapshot(snapshot) {
+        const shared = structuralShare(this._execution, snapshot);
+        if (shared === this._execution)
+            return;
+        this._execution = shared;
+        this._notify();
+    }
+    /**
+     * Transition the stream lifecycle state. Notifies listeners only
+     * when the stage or executionId actually changes.
+     */
+    setStreamState(state) {
+        if (streamStateEqual(this._streamState, state))
+            return;
+        this._streamState = state;
+        this._notify();
+    }
+    /**
+     * Reset to initial state. Used when the session identity changes
+     * or the hook unmounts.
+     */
+    reset() {
+        const wasIdle = this._execution === null && this._streamState.stage === "idle";
+        this._execution = null;
+        this._streamState = IDLE_STATE;
+        if (!wasIdle)
+            this._notify();
+    }
+    // -- useSyncExternalStore contract ---------------------------------------
+    /**
+     * Subscribe a listener that is called whenever any store state
+     * changes. Returns an unsubscribe function.
+     */
+    subscribe = (listener) => {
+        this._listeners.add(listener);
+        return () => {
+            this._listeners.delete(listener);
+        };
+    };
+    /** Stable snapshot selector for the current execution. */
+    getExecution = () => {
+        return this._execution;
+    };
+    /** Stable snapshot selector for the stream lifecycle state. */
+    getStreamState = () => {
+        return this._streamState;
+    };
+    // -- Internal ------------------------------------------------------------
+    _notify() {
+        for (const listener of this._listeners) {
+            listener();
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function streamStateEqual(a, b) {
+    if (a.stage !== b.stage)
+        return false;
+    if (a.stage === "idle")
+        return true;
+    if (a.stage === "error" &&
+        b.stage === "error" &&
+        a.executionId === b.executionId &&
+        a.error === b.error)
+        return true;
+    if ("executionId" in a && "executionId" in b)
+        return a.executionId === b.executionId;
+    return false;
+}
+//# sourceMappingURL=conversation-store.js.map

package/internal/store/conversation-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-store.js","sourceRoot":"","sources":["../../../src/internal/store/conversation-store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAiBrD,MAAM,UAAU,GAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAQlD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,iBAAiB;IACpB,UAAU,GAA0B,IAAI,CAAC;IACzC,YAAY,GAAgB,UAAU,CAAC;IACvC,UAAU,GAAG,IAAI,GAAG,EAAY,CAAC;IAEzC,2EAA2E;IAE3E;;;;OAIG;IACH,cAAc,CAAC,QAAwB;QACrC,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC1D,IAAI,MAAM,KAAK,IAAI,CAAC,UAAU;YAAE,OAAO;QACvC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC;QACzB,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,KAAkB;QAC/B,IAAI,gBAAgB,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC;YAAE,OAAO;QACvD,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,MAAM,OAAO,GACX,IAAI,CAAC,UAAU,KAAK,IAAI,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,KAAK,MAAM,CAAC;QACjE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC;QAC/B,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IAC/B,CAAC;IAED,2EAA2E;IAE3E;;;OAGG;IACH,SAAS,GAAG,CAAC,QAAkB,EAAgB,EAAE;QAC/C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC,CAAC;IACJ,CAAC,CAAC;IAEF,0DAA0D;IAC1D,YAAY,GAAG,GAA0B,EAAE;QACzC,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC,CAAC;IAEF,+DAA+D;IAC/D,cAAc,GAAG,GAAgB,EAAE;QACjC,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC,CAAC;IAEF,2EAA2E;IAEnE,OAAO;QACb,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACvC,QAAQ,EAAE,CAAC;QACb,CAAC;IACH,CAAC;CACF;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,gBAAgB,CAAC,CAAc,EAAE,CAAc;IACtD,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACpC,IACE,CAAC,CAAC,KAAK,KAAK,OAAO;QACnB,CAAC,CAAC,KAAK,KAAK,OAAO;QACnB,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,WAAW;QAC/B,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;QAEnB,OAAO,IAAI,CAAC;IACd,IAAI,aAAa,IAAI,CAAC,IAAI,aAAa,IAAI,CAAC;QAC1C,OAAO,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,WAAW,CAAC;IACzC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/internal/store/index.d.ts

@@ -0,0 +1,31 @@
+import type { AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+import { ConversationStore, type StreamState } from "./conversation-store";
+export { ConversationStore, type StreamState } from "./conversation-store";
+export { structuralShare } from "./structural-share";
+/**
+ * Internal context for the conversation store. Not exported from the
+ * public SDK barrel — used only within SDK hooks and components.
+ */
+export declare const ConversationStoreContext: import("react").Context<ConversationStore | null>;
+/**
+ * Access the conversation store from context.
+ * Throws if called outside a `ConversationStoreContext.Provider`.
+ */
+export declare function useConversationStore(): ConversationStore;
+/**
+ * Create or reuse a `ConversationStore` instance. The store is
+ * created once and preserved across re-renders via ref.
+ */
+export declare function useConversationStoreRef(): ConversationStore;
+/**
+ * Subscribe to the execution snapshot from the conversation store.
+ * Returns a stable reference when the execution is unchanged
+ * (structural sharing ensures this).
+ */
+export declare function useStoreExecution(store: ConversationStore): AgentExecution | null;
+/**
+ * Subscribe to the stream lifecycle state from the conversation store.
+ * Returns a stable reference when the state is unchanged.
+ */
+export declare function useStoreStreamState(store: ConversationStore): StreamState;
+//# sourceMappingURL=index.d.ts.map

package/internal/store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internal/store/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6DAA6D,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE3E,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAMrD;;;GAGG;AACH,eAAO,MAAM,wBAAwB,mDACU,CAAC;AAMhD;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,CAQxD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CAM3D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,iBAAiB,GACvB,cAAc,GAAG,IAAI,CAEvB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,WAAW,CAEzE"}

package/internal/store/index.js

@@ -0,0 +1,54 @@
+"use client";
+import { createContext, useContext, useRef, useSyncExternalStore } from "react";
+import { ConversationStore } from "./conversation-store";
+export { ConversationStore } from "./conversation-store";
+export { structuralShare } from "./structural-share";
+// ---------------------------------------------------------------------------
+// Context
+// ---------------------------------------------------------------------------
+/**
+ * Internal context for the conversation store. Not exported from the
+ * public SDK barrel — used only within SDK hooks and components.
+ */
+export const ConversationStoreContext = createContext(null);
+// ---------------------------------------------------------------------------
+// Hooks
+// ---------------------------------------------------------------------------
+/**
+ * Access the conversation store from context.
+ * Throws if called outside a `ConversationStoreContext.Provider`.
+ */
+export function useConversationStore() {
+    const store = useContext(ConversationStoreContext);
+    if (!store) {
+        throw new Error("useConversationStore must be used within a ConversationStoreContext.Provider");
+    }
+    return store;
+}
+/**
+ * Create or reuse a `ConversationStore` instance. The store is
+ * created once and preserved across re-renders via ref.
+ */
+export function useConversationStoreRef() {
+    const ref = useRef(null);
+    if (!ref.current) {
+        ref.current = new ConversationStore();
+    }
+    return ref.current;
+}
+/**
+ * Subscribe to the execution snapshot from the conversation store.
+ * Returns a stable reference when the execution is unchanged
+ * (structural sharing ensures this).
+ */
+export function useStoreExecution(store) {
+    return useSyncExternalStore(store.subscribe, store.getExecution);
+}
+/**
+ * Subscribe to the stream lifecycle state from the conversation store.
+ * Returns a stable reference when the state is unchanged.
+ */
+export function useStoreStreamState(store) {
+    return useSyncExternalStore(store.subscribe, store.getStreamState);
+}
+//# sourceMappingURL=index.js.map

package/internal/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/internal/store/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAEhF,OAAO,EAAE,iBAAiB,EAAoB,MAAM,sBAAsB,CAAC;AAE3E,OAAO,EAAE,iBAAiB,EAAoB,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GACnC,aAAa,CAA2B,IAAI,CAAC,CAAC;AAEhD,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,KAAK,GAAG,UAAU,CAAC,wBAAwB,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,GAAG,GAAG,MAAM,CAA2B,IAAI,CAAC,CAAC;IACnD,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjB,GAAG,CAAC,OAAO,GAAG,IAAI,iBAAiB,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,GAAG,CAAC,OAAO,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAwB;IAExB,OAAO,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;AACnE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAwB;IAC1D,OAAO,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;AACrE,CAAC"}