@stigmer/react 0.0.36 → 0.0.40

package/session/useSessionConversation.js

@@ -0,0 +1,282 @@
+"use client";
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { isTerminalPhase } from "../execution/execution-phases";
+import { useCreateAgentExecution } from "../execution/useCreateAgentExecution";
+import { useExecutionStream } from "../execution/useExecutionStream";
+import { useSubmitApproval } from "../execution/useSubmitApproval";
+import { useSession } from "./useSession";
+import { useSessionExecutions } from "./useSessionExecutions";
+import { useUpdateSession } from "./useUpdateSession";
+/**
+ * Behavior hook that encapsulates the full conversation lifecycle for
+ * a session: loading data, streaming the active execution, submitting
+ * follow-up messages, and updating session-level workspace entries.
+ *
+ * Composes {@link useSession}, {@link useSessionExecutions},
+ * {@link useCreateAgentExecution}, {@link useExecutionStream}, and
+ * {@link useUpdateSession} into a single return value that drives
+ * both {@link MessageThread} and {@link SessionComposer}.
+ *
+ * Platform builders get the complete conversation loop without
+ * reimplementing orchestration logic.
+ *
+ * @param sessionId - Session to display and converse in. Pass `null` to skip.
+ * @param org - Organization slug for creating follow-up executions.
+ *
+ * @example
+ * ```tsx
+ * function Chat({ sessionId, org }: { sessionId: string; org: string }) {
+ *   const conv = useSessionConversation(sessionId, org);
+ *
+ *   if (conv.isLoading) return <Spinner />;
+ *
+ *   return (
+ *     <>
+ *       <MessageThread
+ *         executions={conv.completedExecutions}
+ *         activeStreamExecution={conv.activeStreamExecution}
+ *         pendingUserMessage={conv.pendingUserMessage}
+ *         onApprovalSubmit={conv.submitApproval}
+ *         submittingApprovalIds={conv.submittingApprovalIds}
+ *         dismissedApprovalIds={conv.dismissedApprovalIds}
+ *       />
+ *       <SessionComposer
+ *         onSubmit={(msg, model) => conv.sendFollowUp(msg, { modelName: model })}
+ *         disabled={!conv.canSendFollowUp}
+ *         isSubmitting={conv.isSending}
+ *       />
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+export function useSessionConversation(sessionId, org) {
+    const { session, isLoading: sessionLoading, error: sessionError } = useSession(sessionId);
+    const { executions, isLoading: executionsLoading, error: executionsError, refetch, } = useSessionExecutions(sessionId);
+    const { create, isCreating, error: createError, clearError: clearCreateError, } = useCreateAgentExecution();
+    const { update: updateSession } = useUpdateSession();
+    const { submitApproval: rawSubmitApproval, submittingToolCallIds, error: approvalError, clearError: clearApprovalError, } = useSubmitApproval();
+    const [pendingExecutionId, setPendingExecutionId] = useState(null);
+    const [pendingUserMessage, setPendingUserMessage] = useState(null);
+    const [dismissedApprovalIds, setDismissedApprovalIds] = useState(new Set());
+    const listActiveId = useMemo(() => {
+        for (let i = executions.length - 1; i >= 0; i--) {
+            const phase = executions[i].status?.phase;
+            if (phase === undefined || !isTerminalPhase(phase)) {
+                return executions[i].metadata?.id ?? null;
+            }
+        }
+        return null;
+    }, [executions]);
+    const activeExecutionId = pendingExecutionId ?? listActiveId;
+    const stream = useExecutionStream(activeExecutionId);
+    useEffect(() => {
+        setDismissedApprovalIds(new Set());
+    }, [activeExecutionId]);
+    // Clear pendingExecutionId once the execution appears in the fetched list
+    useEffect(() => {
+        if (pendingExecutionId &&
+            executions.some((e) => (e.metadata?.id ?? "") === pendingExecutionId)) {
+            setPendingExecutionId(null);
+        }
+    }, [pendingExecutionId, executions]);
+    // Clear optimistic message once the stream delivers its first snapshot
+    useEffect(() => {
+        if (pendingUserMessage && stream.execution) {
+            setPendingUserMessage(null);
+        }
+    }, [pendingUserMessage, stream.execution]);
+    // Refetch executions when stream reaches a terminal phase so the
+    // fetched list reflects the completed status and listActiveId clears.
+    useEffect(() => {
+        if (activeExecutionId && isTerminalPhase(stream.phase)) {
+            refetch();
+        }
+    }, [activeExecutionId, stream.phase, refetch]);
+    const completedExecutions = useMemo(() => {
+        if (!activeExecutionId)
+            return executions;
+        return executions.filter((e) => (e.metadata?.id ?? "") !== activeExecutionId);
+    }, [executions, activeExecutionId]);
+    const fetchedActiveExecution = useMemo(() => {
+        if (!activeExecutionId)
+            return null;
+        return (executions.find((e) => (e.metadata?.id ?? "") === activeExecutionId) ?? null);
+    }, [executions, activeExecutionId]);
+    const activeStreamExecution = stream.execution ?? fetchedActiveExecution;
+    const activePhase = useMemo(() => {
+        if (!activeExecutionId)
+            return null;
+        return stream.phase;
+    }, [activeExecutionId, stream.phase]);
+    const canSendFollowUp = !isCreating && activeExecutionId === null;
+    const workspaceEntries = useMemo(() => session?.spec?.workspaceEntries ?? [], [session]);
+    const mcpServerUsages = useMemo(() => session?.spec?.mcpServerUsages ?? [], [session]);
+    const skillRefs = useMemo(() => session?.spec?.skillRefs ?? [], [session]);
+    const sendFollowUp = useCallback(async (message, options) => {
+        if (!sessionId || !session)
+            return;
+        setPendingUserMessage(message);
+        try {
+            const needsSessionUpdate = options?.agentInstanceId !== undefined ||
+                options?.workspaceEntries !== undefined ||
+                options?.mcpServerUsages !== undefined ||
+                options?.skillRefs !== undefined;
+            if (needsSessionUpdate) {
+                await updateSession(buildUpdateInput(session, {
+                    agentInstanceId: options?.agentInstanceId,
+                    workspaceEntries: options?.workspaceEntries,
+                    mcpServerUsages: options?.mcpServerUsages,
+                    skillRefs: options?.skillRefs,
+                }));
+            }
+            const result = await create({
+                org,
+                sessionId,
+                message,
+                modelName: options?.modelName,
+                runtimeEnv: options?.runtimeEnv,
+                attachments: options?.attachments,
+            });
+            setPendingExecutionId(result.executionId);
+            refetch();
+        }
+        catch {
+            setPendingUserMessage(null);
+        }
+    }, [sessionId, session, org, create, updateSession, refetch]);
+    const pendingApprovals = useMemo(() => {
+        const all = activeStreamExecution?.status?.pendingApprovals ?? [];
+        if (dismissedApprovalIds.size === 0)
+            return all;
+        return all.filter((a) => !dismissedApprovalIds.has(a.toolCallId));
+    }, [activeStreamExecution, dismissedApprovalIds]);
+    const submitApproval = useCallback(async (toolCallId, action, comment) => {
+        if (!activeExecutionId)
+            return;
+        await rawSubmitApproval(activeExecutionId, toolCallId, action, comment);
+        setDismissedApprovalIds((prev) => {
+            const next = new Set(prev);
+            next.add(toolCallId);
+            return next;
+        });
+    }, [activeExecutionId, rawSubmitApproval]);
+    const isLoading = sessionLoading || executionsLoading;
+    const loadError = sessionError || executionsError;
+    return {
+        session,
+        completedExecutions,
+        activeStreamExecution,
+        activePhase,
+        isStreaming: stream.isStreaming,
+        sendFollowUp,
+        canSendFollowUp,
+        isSending: isCreating,
+        sendError: createError,
+        clearSendError: clearCreateError,
+        pendingUserMessage,
+        workspaceEntries,
+        mcpServerUsages,
+        skillRefs,
+        pendingApprovals,
+        submitApproval,
+        submittingApprovalIds: submittingToolCallIds,
+        dismissedApprovalIds,
+        approvalError,
+        clearApprovalError,
+        isLoading,
+        loadError,
+        streamError: stream.error,
+        reconnectStream: stream.reconnect,
+    };
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Converts the existing Session proto into a SessionInput suitable for
+ * the update RPC (which uses replace semantics — the full spec is sent).
+ *
+ * For each session-level collection (workspace, MCP servers, skills):
+ * if an override is provided, it replaces the existing value; otherwise
+ * the current session value is preserved by converting it back to input
+ * format.
+ */
+function buildUpdateInput(session, overrides) {
+    const meta = session.metadata;
+    const spec = session.spec;
+    const workspaceEntries = overrides.workspaceEntries ?? specWorkspaceToInput(spec);
+    const mcpServerUsages = overrides.mcpServerUsages ?? specMcpUsagesToInput(spec);
+    const skillRefs = overrides.skillRefs ?? specSkillRefsToInput(spec);
+    return {
+        name: meta.name,
+        org: meta.org,
+        agentInstanceId: overrides.agentInstanceId ?? (spec?.agentInstanceId || undefined),
+        subject: spec?.subject || undefined,
+        threadId: spec?.threadId || undefined,
+        sandboxId: spec?.sandboxId || undefined,
+        metadata: spec?.metadata && Object.keys(spec.metadata).length > 0
+            ? { ...spec.metadata }
+            : undefined,
+        workspaceEntries: workspaceEntries?.length ? workspaceEntries : undefined,
+        mcpServerUsages: mcpServerUsages?.length ? mcpServerUsages : undefined,
+        skillRefs: skillRefs?.length ? skillRefs : undefined,
+    };
+}
+/** Convert proto workspace entries back to SDK input format. */
+function specWorkspaceToInput(spec) {
+    return spec?.workspaceEntries?.map((e) => {
+        if (e.source?.source.case === "gitRepo") {
+            const v = e.source.source.value;
+            return {
+                name: e.name || undefined,
+                source: {
+                    gitRepo: {
+                        url: v.url,
+                        branch: v.branch || undefined,
+                        commit: v.commit || undefined,
+                        depth: v.depth || undefined,
+                    },
+                },
+            };
+        }
+        if (e.source?.source.case === "localPath") {
+            return {
+                name: e.name || undefined,
+                source: {
+                    localPath: { path: e.source.source.value.path || undefined },
+                },
+            };
+        }
+        return { name: e.name || undefined, source: {} };
+    });
+}
+/** Convert proto MCP server usages back to SDK input format. */
+function specMcpUsagesToInput(spec) {
+    return spec?.mcpServerUsages?.map((u) => ({
+        mcpServerRef: {
+            org: u.mcpServerRef?.org ?? "",
+            slug: u.mcpServerRef?.slug ?? "",
+            version: u.mcpServerRef?.version || undefined,
+            kind: u.mcpServerRef?.kind,
+        },
+        enabledTools: u.enabledTools?.length ? [...u.enabledTools] : undefined,
+        toolApprovalOverrides: u.toolApprovalOverrides?.length
+            ? u.toolApprovalOverrides.map((o) => ({
+                toolName: o.toolName || undefined,
+                requiresApproval: o.requiresApproval || undefined,
+                message: o.message || undefined,
+            }))
+            : undefined,
+    }));
+}
+/** Convert proto skill references back to SDK input format. */
+function specSkillRefsToInput(spec) {
+    return spec?.skillRefs?.map((r) => ({
+        org: r.org ?? "",
+        slug: r.slug ?? "",
+        version: r.version || undefined,
+        kind: r.kind,
+    }));
+}
+//# sourceMappingURL=useSessionConversation.js.map

package/session/useSessionConversation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSessionConversation.js","sourceRoot":"","sources":["../../src/session/useSessionConversation.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAelE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAmHtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,UAAU,sBAAsB,CACpC,SAAwB,EACxB,GAAW;IAEX,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE,GAC/D,UAAU,CAAC,SAAS,CAAC,CAAC;IACxB,MAAM,EACJ,UAAU,EACV,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,eAAe,EACtB,OAAO,GACR,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACpC,MAAM,EACJ,MAAM,EACN,UAAU,EACV,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,gBAAgB,GAC7B,GAAG,uBAAuB,EAAE,CAAC;IAC9B,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,gBAAgB,EAAE,CAAC;IACrD,MAAM,EACJ,cAAc,EAAE,iBAAiB,EACjC,qBAAqB,EACrB,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,kBAAkB,GAC/B,GAAG,iBAAiB,EAAE,CAAC;IAExB,MAAM,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,GAAG,QAAQ,CAC1D,IAAI,CACL,CAAC;IACF,MAAM,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,GAAG,QAAQ,CAC1D,IAAI,CACL,CAAC;IACF,MAAM,CAAC,oBAAoB,EAAE,uBAAuB,CAAC,GAAG,QAAQ,CAE9D,IAAI,GAAG,EAAE,CAAC,CAAC;IAEb,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE;QAChC,KAAK,IAAI,CAAC,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAChD,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC;YAC1C,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;gBACnD,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,IAAI,IAAI,CAAC;YAC5C,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAEjB,MAAM,iBAAiB,GAAG,kBAAkB,IAAI,YAAY,CAAC;IAE7D,MAAM,MAAM,GAAG,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;IAErD,SAAS,CAAC,GAAG,EAAE;QACb,uBAAuB,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IACrC,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAExB,0EAA0E;IAC1E,SAAS,CAAC,GAAG,EAAE;QACb,IACE,kBAAkB;YAClB,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,kBAAkB,CAAC,EACrE,CAAC;YACD,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,EAAE,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC,CAAC;IAErC,uEAAuE;IACvE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,kBAAkB,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YAC3C,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,EAAE,CAAC,kBAAkB,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IAE3C,iEAAiE;IACjE,sEAAsE;IACtE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,iBAAiB,IAAI,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACvD,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,EAAE,CAAC,iBAAiB,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IAE/C,MAAM,mBAAmB,GAAG,OAAO,CAAC,GAAG,EAAE;QACvC,IAAI,CAAC,iBAAiB;YAAE,OAAO,UAAU,CAAC;QAC1C,OAAO,UAAU,CAAC,MAAM,CACtB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,iBAAiB,CACpD,CAAC;IACJ,CAAC,EAAE,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAEpC,MAAM,sBAAsB,GAAG,OAAO,CAAC,GAAG,EAAE;QAC1C,IAAI,CAAC,iBAAiB;YAAE,OAAO,IAAI,CAAC;QACpC,OAAO,CACL,UAAU,CAAC,IAAI,CACb,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,iBAAiB,CACpD,IAAI,IAAI,CACV,CAAC;IACJ,CAAC,EAAE,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAEpC,MAAM,qBAAqB,GAAG,MAAM,CAAC,SAAS,IAAI,sBAAsB,CAAC;IAEzE,MAAM,WAAW,GAAG,OAAO,CAAwB,GAAG,EAAE;QACtD,IAAI,CAAC,iBAAiB;YAAE,OAAO,IAAI,CAAC;QACpC,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC,EAAE,CAAC,iBAAiB,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAEtC,MAAM,eAAe,GAAG,CAAC,UAAU,IAAI,iBAAiB,KAAK,IAAI,CAAC;IAElE,MAAM,gBAAgB,GAAG,OAAO,CAC9B,GAAG,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,gBAAgB,IAAI,EAAE,EAC3C,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,MAAM,eAAe,GAAG,OAAO,CAC7B,GAAG,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,eAAe,IAAI,EAAE,EAC1C,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,MAAM,SAAS,GAAG,OAAO,CACvB,GAAG,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,IAAI,EAAE,EACpC,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,MAAM,YAAY,GAAG,WAAW,CAC9B,KAAK,EAAE,OAAe,EAAE,OAA6B,EAAiB,EAAE;QACtE,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO;YAAE,OAAO;QAEnC,qBAAqB,CAAC,OAAO,CAAC,CAAC;QAE/B,IAAI,CAAC;YACH,MAAM,kBAAkB,GACtB,OAAO,EAAE,eAAe,KAAK,SAAS;gBACtC,OAAO,EAAE,gBAAgB,KAAK,SAAS;gBACvC,OAAO,EAAE,eAAe,KAAK,SAAS;gBACtC,OAAO,EAAE,SAAS,KAAK,SAAS,CAAC;YAEnC,IAAI,kBAAkB,EAAE,CAAC;gBACvB,MAAM,aAAa,CACjB,gBAAgB,CAAC,OAAO,EAAE;oBACxB,eAAe,EAAE,OAAO,EAAE,eAAe;oBACzC,gBAAgB,EAAE,OAAO,EAAE,gBAAgB;oBAC3C,eAAe,EAAE,OAAO,EAAE,eAAe;oBACzC,SAAS,EAAE,OAAO,EAAE,SAAS;iBAC9B,CAAC,CACH,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC;gBAC1B,GAAG;gBACH,SAAS;gBACT,OAAO;gBACP,SAAS,EAAE,OAAO,EAAE,SAAS;gBAC7B,UAAU,EAAE,OAAO,EAAE,UAAU;gBAC/B,WAAW,EAAE,OAAO,EAAE,WAAW;aAClC,CAAC,CAAC;YACH,qBAAqB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAC1C,OAAO,EAAE,CAAC;QACZ,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,EACD,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,CAC1D,CAAC;IAEF,MAAM,gBAAgB,GAAG,OAAO,CAA6B,GAAG,EAAE;QAChE,MAAM,GAAG,GAAG,qBAAqB,EAAE,MAAM,EAAE,gBAAgB,IAAI,EAAE,CAAC;QAClE,IAAI,oBAAoB,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC;QAChD,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IACpE,CAAC,EAAE,CAAC,qBAAqB,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAElD,MAAM,cAAc,GAAG,WAAW,CAChC,KAAK,EACH,UAAkB,EAClB,MAAsB,EACtB,OAAgB,EACD,EAAE;QACjB,IAAI,CAAC,iBAAiB;YAAE,OAAO;QAC/B,MAAM,iBAAiB,CAAC,iBAAiB,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACxE,uBAAuB,CAAC,CAAC,IAAI,EAAE,EAAE;YAC/B,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,EACD,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CACvC,CAAC;IAEF,MAAM,SAAS,GAAG,cAAc,IAAI,iBAAiB,CAAC;IACtD,MAAM,SAAS,GAAG,YAAY,IAAI,eAAe,CAAC;IAElD,OAAO;QACL,OAAO;QACP,mBAAmB;QACnB,qBAAqB;QACrB,WAAW;QACX,WAAW,EAAE,MAAM,CAAC,WAAW;QAE/B,YAAY;QACZ,eAAe;QACf,SAAS,EAAE,UAAU;QACrB,SAAS,EAAE,WAAW;QACtB,cAAc,EAAE,gBAAgB;QAEhC,kBAAkB;QAElB,gBAAgB;QAChB,eAAe;QACf,SAAS;QAET,gBAAgB;QAChB,cAAc;QACd,qBAAqB,EAAE,qBAAqB;QAC5C,oBAAoB;QACpB,aAAa;QACb,kBAAkB;QAElB,SAAS;QACT,SAAS;QAET,WAAW,EAAE,MAAM,CAAC,KAAK;QACzB,eAAe,EAAE,MAAM,CAAC,SAAS;KAClC,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,SAAS,gBAAgB,CACvB,OAAgB,EAChB,SAKC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,QAAS,CAAC;IAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAE1B,MAAM,gBAAgB,GACpB,SAAS,CAAC,gBAAgB,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAE3D,MAAM,eAAe,GACnB,SAAS,CAAC,eAAe,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAE1D,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAEpE,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,eAAe,EAAE,SAAS,CAAC,eAAe,IAAI,CAAC,IAAI,EAAE,eAAe,IAAI,SAAS,CAAC;QAClF,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,SAAS;QACnC,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,SAAS;QACrC,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,SAAS;QACvC,QAAQ,EACN,IAAI,EAAE,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC;YACrD,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE;YACtB,CAAC,CAAC,SAAS;QACf,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS;QACzE,eAAe,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS;QACtE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;KACrD,CAAC;AACJ,CAAC;AAED,gEAAgE;AAChE,SAAS,oBAAoB,CAC3B,IAAqB;IAErB,OAAO,IAAI,EAAE,gBAAgB,EAAE,GAAG,CAAC,CAAC,CAAC,EAAuB,EAAE;QAC5D,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACxC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;YAChC,OAAO;gBACL,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,SAAS;gBACzB,MAAM,EAAE;oBACN,OAAO,EAAE;wBACP,GAAG,EAAE,CAAC,CAAC,GAAG;wBACV,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,SAAS;wBAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,SAAS;wBAC7B,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,SAAS;qBAC5B;iBACF;aACF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC1C,OAAO;gBACL,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,SAAS;gBACzB,MAAM,EAAE;oBACN,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,SAAS,EAAE;iBAC7D;aACF,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,gEAAgE;AAChE,SAAS,oBAAoB,CAC3B,IAAqB;IAErB,OAAO,IAAI,EAAE,eAAe,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACxC,YAAY,EAAE;YACZ,GAAG,EAAE,CAAC,CAAC,YAAY,EAAE,GAAG,IAAI,EAAE;YAC9B,IAAI,EAAE,CAAC,CAAC,YAAY,EAAE,IAAI,IAAI,EAAE;YAChC,OAAO,EAAE,CAAC,CAAC,YAAY,EAAE,OAAO,IAAI,SAAS;YAC7C,IAAI,EAAE,CAAC,CAAC,YAAY,EAAE,IAAI;SAC3B;QACD,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS;QACtE,qBAAqB,EAAE,CAAC,CAAC,qBAAqB,EAAE,MAAM;YACpD,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAClC,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,SAAS;gBACjC,gBAAgB,EAAE,CAAC,CAAC,gBAAgB,IAAI,SAAS;gBACjD,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,SAAS;aAChC,CAAC,CAAC;YACL,CAAC,CAAC,SAAS;KACd,CAAC,CAAC,CAAC;AACN,CAAC;AAED,+DAA+D;AAC/D,SAAS,oBAAoB,CAC3B,IAAqB;IAErB,OAAO,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAClC,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE;QAChB,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE;QAClB,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,SAAS;QAC/B,IAAI,EAAE,CAAC,CAAC,IAAI;KACb,CAAC,CAAC,CAAC;AACN,CAAC"}

package/session/useSessionExecutions.d.ts

@@ -0,0 +1,20 @@
+import type { AgentExecution } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+export interface UseSessionExecutionsReturn {
+    readonly executions: readonly AgentExecution[];
+    readonly isLoading: boolean;
+    readonly error: Error | null;
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches all {@link AgentExecution} entries for a session.
+ *
+ * Pass `null` to skip fetching (stable no-op). Call `refetch()` to
+ * re-query after a new execution is created within the same session
+ * (needed by the follow-up conversation loop in SP2).
+ *
+ * Returns up to 100 executions per call. Sessions rarely exceed a
+ * handful of executions; full cursor-based pagination can be added
+ * later without breaking the return type.
+ */
+export declare function useSessionExecutions(sessionId: string | null): UseSessionExecutionsReturn;
+//# sourceMappingURL=useSessionExecutions.d.ts.map

package/session/useSessionExecutions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSessionExecutions.d.ts","sourceRoot":"","sources":["../../src/session/useSessionExecutions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6DAA6D,CAAC;AAKlG,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,0BAA0B,CA+C5B"}

package/session/useSessionExecutions.js

@@ -0,0 +1,57 @@
+"use client";
+import { useCallback, useEffect, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { ListAgentExecutionsBySessionRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+/**
+ * Data hook that fetches all {@link AgentExecution} entries for a session.
+ *
+ * Pass `null` to skip fetching (stable no-op). Call `refetch()` to
+ * re-query after a new execution is created within the same session
+ * (needed by the follow-up conversation loop in SP2).
+ *
+ * Returns up to 100 executions per call. Sessions rarely exceed a
+ * handful of executions; full cursor-based pagination can be added
+ * later without breaking the return type.
+ */
+export function useSessionExecutions(sessionId) {
+    const stigmer = useStigmer();
+    const [executions, setExecutions] = useState([]);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [fetchKey, setFetchKey] = useState(0);
+    const refetch = useCallback(() => setFetchKey((k) => k + 1), []);
+    useEffect(() => {
+        if (!sessionId) {
+            setExecutions([]);
+            setIsLoading(false);
+            setError(null);
+            return;
+        }
+        const cancelled = { current: false };
+        setIsLoading(true);
+        setError(null);
+        stigmer.agentExecution
+            .listBySession(create(ListAgentExecutionsBySessionRequestSchema, {
+            sessionId,
+            pageSize: 100,
+        }))
+            .then((result) => {
+            if (cancelled.current)
+                return;
+            setExecutions(result.entries);
+            setIsLoading(false);
+        }, (err) => {
+            if (cancelled.current)
+                return;
+            setError(toError(err));
+            setIsLoading(false);
+        });
+        return () => {
+            cancelled.current = true;
+        };
+    }, [sessionId, stigmer, fetchKey]);
+    return { executions, isLoading, error, refetch };
+}
+//# sourceMappingURL=useSessionExecutions.js.map

package/session/useSessionExecutions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSessionExecutions.js","sourceRoot":"","sources":["../../src/session/useSessionExecutions.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,yCAAyC,EAAE,MAAM,4DAA4D,CAAC;AACvH,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAS9C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAClC,SAAwB;IAExB,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAmB,EAAE,CAAC,CAAC;IACnE,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE5C,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEjE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,aAAa,CAAC,EAAE,CAAC,CAAC;YAClB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACrC,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,OAAO,CAAC,cAAc;aACnB,aAAa,CACZ,MAAM,CAAC,yCAAyC,EAAE;YAChD,SAAS;YACT,QAAQ,EAAE,GAAG;SACd,CAAC,CACH;aACA,IAAI,CACH,CAAC,MAAM,EAAE,EAAE;YACT,IAAI,SAAS,CAAC,OAAO;gBAAE,OAAO;YAC9B,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC9B,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,EACD,CAAC,GAAG,EAAE,EAAE;YACN,IAAI,SAAS,CAAC,OAAO;gBAAE,OAAO;YAC9B,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,CACF,CAAC;QAEJ,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;QAC3B,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEnC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACnD,CAAC"}

package/session/useSessionList.d.ts

@@ -0,0 +1,25 @@
+import type { Session } from "@stigmer/protos/ai/stigmer/agentic/session/v1/api_pb";
+export interface UseSessionListOptions {
+    /** Maximum sessions to return. Defaults to 50. */
+    pageSize?: number;
+    /** Optional tag filter. */
+    tags?: string[];
+}
+export interface UseSessionListReturn {
+    readonly sessions: readonly Session[];
+    readonly isLoading: boolean;
+    readonly error: string | null;
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches a paginated list of {@link Session} entries.
+ *
+ * Org scoping is handled at the transport level (auth context),
+ * consistent with other data hooks. Call `refetch()` to re-query
+ * after creating a session or navigating between views.
+ *
+ * Returns up to `pageSize` sessions (default 50). Full cursor-based
+ * pagination can be added later without breaking the return type.
+ */
+export declare function useSessionList(options?: UseSessionListOptions): UseSessionListReturn;
+//# sourceMappingURL=useSessionList.d.ts.map

package/session/useSessionList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSessionList.d.ts","sourceRoot":"","sources":["../../src/session/useSessionList.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sDAAsD,CAAC;AAIpF,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAID;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,oBAAoB,CAqDtB"}

package/session/useSessionList.js

@@ -0,0 +1,57 @@
+"use client";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { ListSessionsRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/session/v1/io_pb";
+import { useStigmer } from "../hooks";
+const DEFAULT_PAGE_SIZE = 50;
+/**
+ * Data hook that fetches a paginated list of {@link Session} entries.
+ *
+ * Org scoping is handled at the transport level (auth context),
+ * consistent with other data hooks. Call `refetch()` to re-query
+ * after creating a session or navigating between views.
+ *
+ * Returns up to `pageSize` sessions (default 50). Full cursor-based
+ * pagination can be added later without breaking the return type.
+ */
+export function useSessionList(options) {
+    const stigmer = useStigmer();
+    const [sessions, setSessions] = useState([]);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [fetchKey, setFetchKey] = useState(0);
+    const pageSize = options?.pageSize ?? DEFAULT_PAGE_SIZE;
+    const tagsRef = useRef(options?.tags);
+    if (options?.tags !== tagsRef.current &&
+        JSON.stringify(options?.tags) !== JSON.stringify(tagsRef.current)) {
+        tagsRef.current = options?.tags;
+    }
+    const tags = tagsRef.current;
+    const refetch = useCallback(() => setFetchKey((k) => k + 1), []);
+    useEffect(() => {
+        const cancelled = { current: false };
+        setIsLoading(true);
+        setError(null);
+        stigmer.session
+            .list(create(ListSessionsRequestSchema, {
+            pageSize,
+            tags: tags ?? [],
+        }))
+            .then((result) => {
+            if (cancelled.current)
+                return;
+            setSessions(result.entries);
+            setIsLoading(false);
+        }, (err) => {
+            if (cancelled.current)
+                return;
+            setError(err instanceof Error ? err.message : "Failed to load sessions");
+            setIsLoading(false);
+        });
+        return () => {
+            cancelled.current = true;
+        };
+    }, [stigmer, fetchKey, pageSize, tags]);
+    return { sessions, isLoading, error, refetch };
+}
+//# sourceMappingURL=useSessionList.js.map

package/session/useSessionList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSessionList.js","sourceRoot":"","sources":["../../src/session/useSessionList.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,yBAAyB,EAAE,MAAM,qDAAqD,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAgBtC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAE7B;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAC5B,OAA+B;IAE/B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAY,EAAE,CAAC,CAAC;IACxD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IACxD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE5C,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,iBAAiB,CAAC;IACxD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAEtC,IACE,OAAO,EAAE,IAAI,KAAK,OAAO,CAAC,OAAO;QACjC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EACjE,CAAC;QACD,OAAO,CAAC,OAAO,GAAG,OAAO,EAAE,IAAI,CAAC;IAClC,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAE7B,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEjE,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,SAAS,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACrC,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,OAAO,CAAC,OAAO;aACZ,IAAI,CACH,MAAM,CAAC,yBAAyB,EAAE;YAChC,QAAQ;YACR,IAAI,EAAE,IAAI,IAAI,EAAE;SACjB,CAAC,CACH;aACA,IAAI,CACH,CAAC,MAAM,EAAE,EAAE;YACT,IAAI,SAAS,CAAC,OAAO;gBAAE,OAAO;YAC9B,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC5B,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,EACD,CAAC,GAAG,EAAE,EAAE;YACN,IAAI,SAAS,CAAC,OAAO;gBAAE,OAAO;YAC9B,QAAQ,CACN,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,yBAAyB,CAC/D,CAAC;YACF,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,CACF,CAAC;QAEJ,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;QAC3B,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;IAExC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACjD,CAAC"}

package/session/useUpdateSession.d.ts

@@ -0,0 +1,22 @@
+import type { SessionInput } from "@stigmer/sdk";
+import type { Session } from "@stigmer/protos/ai/stigmer/agentic/session/v1/api_pb";
+export interface UseUpdateSessionReturn {
+    readonly update: (input: SessionInput) => Promise<Session>;
+    readonly isUpdating: boolean;
+    readonly error: string | null;
+    readonly clearError: () => void;
+}
+/**
+ * Behavior hook that wraps `session.update()` with loading/error state.
+ *
+ * Updates an existing Session resource. The caller provides a full
+ * {@link SessionInput} including the session's `name` and `org` (used
+ * by the backend to identify the resource) and all spec fields.
+ *
+ * Typically composed into higher-level hooks like
+ * {@link useSessionConversation} rather than used directly. Platform
+ * builders who need direct session mutation can use this hook
+ * standalone.
+ */
+export declare function useUpdateSession(): UseUpdateSessionReturn;
+//# sourceMappingURL=useUpdateSession.d.ts.map

package/session/useUpdateSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUpdateSession.d.ts","sourceRoot":"","sources":["../../src/session/useUpdateSession.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sDAAsD,CAAC;AAGpF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3D,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,IAAI,sBAAsB,CA2BzD"}

package/session/useUpdateSession.js

@@ -0,0 +1,38 @@
+"use client";
+import { useCallback, useState } from "react";
+import { useStigmer } from "../hooks";
+/**
+ * Behavior hook that wraps `session.update()` with loading/error state.
+ *
+ * Updates an existing Session resource. The caller provides a full
+ * {@link SessionInput} including the session's `name` and `org` (used
+ * by the backend to identify the resource) and all spec fields.
+ *
+ * Typically composed into higher-level hooks like
+ * {@link useSessionConversation} rather than used directly. Platform
+ * builders who need direct session mutation can use this hook
+ * standalone.
+ */
+export function useUpdateSession() {
+    const stigmer = useStigmer();
+    const [isUpdating, setIsUpdating] = useState(false);
+    const [error, setError] = useState(null);
+    const clearError = useCallback(() => setError(null), []);
+    const update = useCallback(async (input) => {
+        setIsUpdating(true);
+        setError(null);
+        try {
+            return await stigmer.session.update(input);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : "Failed to update session";
+            setError(message);
+            throw err;
+        }
+        finally {
+            setIsUpdating(false);
+        }
+    }, [stigmer]);
+    return { update, isUpdating, error, clearError };
+}
+//# sourceMappingURL=useUpdateSession.js.map

package/session/useUpdateSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUpdateSession.js","sourceRoot":"","sources":["../../src/session/useUpdateSession.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAG9C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAStC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAExD,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAEzD,MAAM,MAAM,GAAG,WAAW,CACxB,KAAK,EAAE,KAAmB,EAAoB,EAAE;QAC9C,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GACX,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,CAAC;YAClE,QAAQ,CAAC,OAAO,CAAC,CAAC;YAClB,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,aAAa,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AACnD,CAAC"}

package/skill/SkillDetailView.d.ts

@@ -0,0 +1,62 @@
+import { ApiResourceVisibility } from "@stigmer/protos/ai/stigmer/commons/apiresource/enum_pb";
+export interface SkillDetailViewProps {
+    /** Organization slug that owns the skill. */
+    readonly org: string;
+    /** Skill slug (URL-friendly identifier unique within the org). */
+    readonly slug: string;
+    /** Optional version tag or content hash to pin to a specific version. */
+    readonly version?: string;
+    /**
+     * Called once when the skill resource has been fetched successfully.
+     * Provides the resource display name for use cases like breadcrumbs,
+     * document titles, or analytics — without requiring the consumer to
+     * also call {@link useSkill}.
+     *
+     * Not called on error or not-found states.
+     */
+    readonly onResourceLoad?: (meta: {
+        name: string;
+        id: string;
+    }) => void;
+    /**
+     * Called when the user toggles visibility via the inline control.
+     * When provided, the header renders an interactive
+     * {@link VisibilityToggle} instead of a read-only badge.
+     * When omitted, visibility is displayed as a static "Public" pill.
+     */
+    readonly onVisibilityChange?: (v: ApiResourceVisibility) => void;
+    /** `true` while a visibility update RPC is in flight. */
+    readonly isVisibilityPending?: boolean;
+    /** Additional CSS classes for the root container. */
+    readonly className?: string;
+}
+/**
+ * Read-only detail view for a Skill knowledge package.
+ *
+ * Fetches the skill via {@link useSkill} internally and renders its
+ * full content in structured sections: header, SKILL.md content
+ * (rendered as formatted markdown), and version/provenance info.
+ * Sections with no data are omitted entirely.
+ *
+ * The SKILL.md content is the primary value of this view — it IS the
+ * skill. The markdown is rendered using the same styled component
+ * overrides used across all SDK markdown surfaces.
+ *
+ * Handles loading, error, and not-found states automatically.
+ * Zero Console dependencies — safe for platform builder embedding.
+ * All visual properties flow through `--stgm-*` design tokens.
+ *
+ * @example
+ * ```tsx
+ * // Minimal — self-contained, fetches its own data
+ * <SkillDetailView org="acme" slug="code-style-guide" />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Pinned to a specific version tag
+ * <SkillDetailView org="acme" slug="code-style-guide" version="stable" />
+ * ```
+ */
+export declare function SkillDetailView({ org, slug, version, onResourceLoad, onVisibilityChange, isVisibilityPending, className, }: SkillDetailViewProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=SkillDetailView.d.ts.map

package/skill/SkillDetailView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillDetailView.d.ts","sourceRoot":"","sources":["../../src/skill/SkillDetailView.tsx"],"names":[],"mappings":"AASA,OAAO,EAAE,qBAAqB,EAAE,MAAM,wDAAwD,CAAC;AAM/F,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;OAOG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACvE;;;;;OAKG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACjE,yDAAyD;IACzD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,eAAe,CAAC,EAC9B,GAAG,EACH,IAAI,EACJ,OAAO,EACP,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,SAAS,GACV,EAAE,oBAAoB,2CA+CtB"}