@stigmer/react 0.0.91 → 0.0.93

package/session/useEditSessionPrep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEditSessionPrep.js","sourceRoot":"","sources":["../../src/session/useEditSessionPrep.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,wBAAwB,EAAE,MAAM,mDAAmD,CAAC;AAC7F,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAWxE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAAmC,EACnC,OAA+D;IAE/D,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC;IACrC,MAAM,QAAQ,GAAG,OAAO,EAAE,IAAI,IAAI,IAAI,CAAC;IAEvC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,QAAQ,CACnC,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EACtC,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CACxC,CAAC;IAEF,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,YAAY,CAC/C,SAAS,KAAK,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAC3C,SAAS,KAAK,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAC7C,CAAC;IAEF,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,QAAQ,CACnC,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EACtC,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CACxC,CAAC;IAEF,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAqB,SAAS,CAAC,CAAC;IAClE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAE5B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,KAAK,CAAC,OAAO;YAAE,OAAO;QAE1B,IAAI,SAAS,KAAK,OAAO,IAAI,SAAS,EAAE,CAAC;YACvC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;YACrB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;gBAC3C,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,EAAE,IAAI,IAAI,OAAO,CAAC;gBACjD,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;YACtE,CAAC;YAAC,MAAM,CAAC;gBACP,QAAQ,CAAC,uCAAuC,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;QAED,IAAI,SAAS,KAAK,YAAY,IAAI,aAAa,EAAE,CAAC;YAChD,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;YACrB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,sBAAsB,CAAC,aAAa,CAAC,CAAC;gBACnD,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,EAAE,IAAI,IAAI,YAAY,CAAC;gBAC1D,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;YACtE,CAAC;YAAC,MAAM,CAAC;gBACP,QAAQ,CAAC,4CAA4C,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;IACH,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC;IAE1C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,KAAK,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,SAAS,KAAK,OAAO,IAAI,CAAC,SAAS;YAAE,OAAO;QAEhD,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,EAAE,kBAAkB,CAAC;QACxD,IAAI,CAAC,UAAU;YAAE,OAAO;QAExB,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;QACrB,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,EAAE,IAAI,IAAI,OAAO,CAAC;QAEjD,OAAO,CAAC,KAAK;aACV,WAAW,CAAC,MAAM,CAAC,wBAAwB,EAAE,EAAE,kBAAkB,EAAE,UAAU,EAAE,CAAC,CAAC;aACjF,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YACb,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YACtD,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC;YAC1D,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,MAAM,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3E,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE;YACV,QAAQ,CAAC,8CAA8C,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;IACP,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IAEpC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC"}

package/session/useNewSessionFlow.d.ts

@@ -0,0 +1,110 @@
+import { type McpServerUsageInput, type ResourceRef } from "@stigmer/sdk";
+import type { AgentResolution } from "../agent";
+import { type UseWorkspaceEntriesReturn } from "../workspace";
+import { type UseSessionVariablesReturn } from "../execution/useSessionVariables";
+import type { SessionComposerSubmitContext } from "../composer";
+/** Options for {@link useNewSessionFlow}. */
+export interface UseNewSessionFlowOptions {
+    /** Organization slug. Required for session and execution creation. */
+    readonly org: string;
+    /**
+     * Called after a session and its first execution are created successfully.
+     * The consumer is responsible for navigation (e.g. `router.push`).
+     */
+    readonly onSessionCreated: (sessionId: string) => void;
+    /**
+     * Called when an error occurs during session creation.
+     * The consumer can use this for toast notifications or other UI feedback.
+     * If not provided, errors are still available via {@link UseNewSessionFlowReturn.submitError}.
+     */
+    readonly onError?: (message: string) => void;
+}
+/** Return value of {@link useNewSessionFlow}. */
+export interface UseNewSessionFlowReturn {
+    /** Currently selected model ID (persisted to localStorage). */
+    readonly modelId: string | undefined;
+    /** Update the selected model. Automatically persists to localStorage. */
+    readonly setModelId: (id: string) => void;
+    /** Currently selected agent reference, or `null` for the default agent. */
+    readonly agentRef: ResourceRef | null;
+    /** Update the selected agent reference. */
+    readonly setAgentRef: (ref: ResourceRef | null) => void;
+    /** Current agent resolution state (saved instance vs direct reference). */
+    readonly resolution: AgentResolution | null;
+    /** Update the agent resolution. */
+    readonly setResolution: (r: AgentResolution | null) => void;
+    /** Active MCP server configurations. */
+    readonly mcpServerUsages: McpServerUsageInput[];
+    /** Update MCP server configurations. */
+    readonly setMcpServerUsages: (usages: McpServerUsageInput[]) => void;
+    /** Active skill references. */
+    readonly skillRefs: ResourceRef[];
+    /** Update skill references. */
+    readonly setSkillRefs: (refs: ResourceRef[]) => void;
+    /** Selected runner ID, or `null` for auto-selection. */
+    readonly runnerId: string | null;
+    /** Update the selected runner. */
+    readonly setRunnerId: (id: string | null) => void;
+    /** Workspace entries manager (git repos and local paths). */
+    readonly workspace: UseWorkspaceEntriesReturn;
+    /** Session variables (per-execution secrets) manager. */
+    readonly sessionVariables: UseSessionVariablesReturn;
+    /** `true` while the create session + execution flow is in flight. */
+    readonly isSubmitting: boolean;
+    /** Human-readable error from the last failed submission, or `null`. */
+    readonly submitError: string | null;
+    /**
+     * Create a session with the first execution.
+     *
+     * Composes all managed state (agent, workspace, MCP servers, skills,
+     * runner, model, session variables) into the session and execution
+     * creation RPCs, then calls `onSessionCreated` on success.
+     *
+     * The `model` parameter overrides `modelId` for this submission only
+     * (used when SessionComposer passes a per-message model selection).
+     */
+    readonly submit: (message: string, model?: string, context?: SessionComposerSubmitContext) => Promise<void>;
+}
+/**
+ * Orchestrates the "create a new session" flow.
+ *
+ * Manages all the state required to configure and submit a new session:
+ * model selection (with localStorage persistence), agent resolution,
+ * MCP server/skill/runner selection, workspace entries, and session
+ * variables. On submission, creates the session and its first execution
+ * in sequence, then notifies the consumer via `onSessionCreated`.
+ *
+ * This hook is framework-agnostic — it works identically in Next.js,
+ * Vite, Tauri, or any React environment. Navigation, toast notifications,
+ * and draft-mode logic are the consumer's responsibility.
+ *
+ * @example
+ * ```tsx
+ * const flow = useNewSessionFlow({
+ *   org: "acme",
+ *   onSessionCreated: (id) => navigate(`/sessions/${id}`),
+ *   onError: (msg) => toast.error(msg),
+ * });
+ *
+ * <SessionComposer
+ *   onSubmit={flow.submit}
+ *   isSubmitting={flow.isSubmitting}
+ *   org="acme"
+ *   workspace={flow.workspace}
+ *   agentRef={flow.agentRef}
+ *   onAgentRefChange={flow.setAgentRef}
+ *   onAgentResolutionChange={flow.setResolution}
+ *   mcpServerUsages={flow.mcpServerUsages}
+ *   onMcpServerUsagesChange={flow.setMcpServerUsages}
+ *   skillRefs={flow.skillRefs}
+ *   onSkillRefsChange={flow.setSkillRefs}
+ *   runnerId={flow.runnerId}
+ *   onRunnerIdChange={flow.setRunnerId}
+ *   sessionVariables={flow.sessionVariables}
+ *   defaultModelId={flow.modelId}
+ *   onModelChange={flow.setModelId}
+ * />
+ * ```
+ */
+export declare function useNewSessionFlow(options: UseNewSessionFlowOptions): UseNewSessionFlowReturn;
+//# sourceMappingURL=useNewSessionFlow.d.ts.map

package/session/useNewSessionFlow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNewSessionFlow.d.ts","sourceRoot":"","sources":["../../src/session/useNewSessionFlow.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,mBAAmB,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAC1F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAGhD,OAAO,EAAuB,KAAK,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAuB,KAAK,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AACvG,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAMhE,6CAA6C;AAC7C,MAAM,WAAW,wBAAwB;IACvC,sEAAsE;IACtE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED,iDAAiD;AACjD,MAAM,WAAW,uBAAuB;IACtC,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAE1C,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IACtC,2CAA2C;IAC3C,QAAQ,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IAExD,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;IAC5C,mCAAmC;IACnC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI,KAAK,IAAI,CAAC;IAE5D,wCAAwC;IACxC,QAAQ,CAAC,eAAe,EAAE,mBAAmB,EAAE,CAAC;IAChD,wCAAwC;IACxC,QAAQ,CAAC,kBAAkB,EAAE,CAAC,MAAM,EAAE,mBAAmB,EAAE,KAAK,IAAI,CAAC;IAErE,+BAA+B;IAC/B,QAAQ,CAAC,SAAS,EAAE,WAAW,EAAE,CAAC;IAClC,+BAA+B;IAC/B,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IAErD,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,kCAAkC;IAClC,QAAQ,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAElD,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;IAC9C,yDAAyD;IACzD,QAAQ,CAAC,gBAAgB,EAAE,yBAAyB,CAAC;IAErD,qEAAqE;IACrE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpC;;;;;;;;;OASG;IACH,QAAQ,CAAC,MAAM,EAAE,CACf,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,4BAA4B,KACnC,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,GAChC,uBAAuB,CAoJzB"}

package/session/useNewSessionFlow.js

@@ -0,0 +1,184 @@
+"use client";
+import { useCallback, useEffect, useState } from "react";
+import { getUserMessage } from "@stigmer/sdk";
+import { useDefaultAgent } from "../agent";
+import { useModelRegistry } from "../models";
+import { useWorkspaceEntries } from "../workspace";
+import { useSessionVariables } from "../execution/useSessionVariables";
+import { useCreateSession } from "./useCreateSession";
+import { useCreateAgentExecution } from "../execution/useCreateAgentExecution";
+const STORAGE_KEY_MODEL = "stigmer:session:model";
+/**
+ * Orchestrates the "create a new session" flow.
+ *
+ * Manages all the state required to configure and submit a new session:
+ * model selection (with localStorage persistence), agent resolution,
+ * MCP server/skill/runner selection, workspace entries, and session
+ * variables. On submission, creates the session and its first execution
+ * in sequence, then notifies the consumer via `onSessionCreated`.
+ *
+ * This hook is framework-agnostic — it works identically in Next.js,
+ * Vite, Tauri, or any React environment. Navigation, toast notifications,
+ * and draft-mode logic are the consumer's responsibility.
+ *
+ * @example
+ * ```tsx
+ * const flow = useNewSessionFlow({
+ *   org: "acme",
+ *   onSessionCreated: (id) => navigate(`/sessions/${id}`),
+ *   onError: (msg) => toast.error(msg),
+ * });
+ *
+ * <SessionComposer
+ *   onSubmit={flow.submit}
+ *   isSubmitting={flow.isSubmitting}
+ *   org="acme"
+ *   workspace={flow.workspace}
+ *   agentRef={flow.agentRef}
+ *   onAgentRefChange={flow.setAgentRef}
+ *   onAgentResolutionChange={flow.setResolution}
+ *   mcpServerUsages={flow.mcpServerUsages}
+ *   onMcpServerUsagesChange={flow.setMcpServerUsages}
+ *   skillRefs={flow.skillRefs}
+ *   onSkillRefsChange={flow.setSkillRefs}
+ *   runnerId={flow.runnerId}
+ *   onRunnerIdChange={flow.setRunnerId}
+ *   sessionVariables={flow.sessionVariables}
+ *   defaultModelId={flow.modelId}
+ *   onModelChange={flow.setModelId}
+ * />
+ * ```
+ */
+export function useNewSessionFlow(options) {
+    const { org, onSessionCreated, onError } = options;
+    const { getModel } = useModelRegistry();
+    const { create: createSession } = useCreateSession();
+    const { create: createExecution } = useCreateAgentExecution();
+    const { agent: defaultAgent } = useDefaultAgent(org);
+    const workspace = useWorkspaceEntries();
+    const sessionVariables = useSessionVariables();
+    const [modelId, setModelId] = useState(undefined);
+    const [agentRef, setAgentRef] = useState(null);
+    const [resolution, setResolution] = useState(null);
+    const [mcpServerUsages, setMcpServerUsages] = useState([]);
+    const [skillRefs, setSkillRefs] = useState([]);
+    const [runnerId, setRunnerId] = useState(null);
+    const [isSubmitting, setIsSubmitting] = useState(false);
+    const [submitError, setSubmitError] = useState(null);
+    const validModelId = modelId && getModel(modelId) ? modelId : undefined;
+    // Restore persisted model on mount
+    useEffect(() => {
+        const stored = localStorage.getItem(STORAGE_KEY_MODEL);
+        if (stored && getModel(stored)) {
+            setModelId(stored);
+        }
+    }, [getModel]);
+    // Persist model on change
+    useEffect(() => {
+        if (modelId) {
+            localStorage.setItem(STORAGE_KEY_MODEL, modelId);
+        }
+    }, [modelId]);
+    const submit = useCallback(async (message, selectedModel, context) => {
+        if (isSubmitting)
+            return;
+        if (!org) {
+            const msg = "Select an organization before starting a session.";
+            setSubmitError(msg);
+            onError?.(msg);
+            return;
+        }
+        setIsSubmitting(true);
+        setSubmitError(null);
+        try {
+            const sessionFields = {
+                org,
+                workspaceEntries: workspace.hasEntries
+                    ? workspace.toInput()
+                    : undefined,
+                mcpServerUsages: mcpServerUsages.length > 0 ? mcpServerUsages : undefined,
+                skillRefs: skillRefs.length > 0 ? skillRefs : undefined,
+                runnerId: runnerId ?? undefined,
+            };
+            const executionFields = {
+                org,
+                message,
+                modelName: selectedModel ?? validModelId,
+                runtimeEnv: context?.runtimeEnv,
+                attachments: context?.attachments,
+            };
+            let sessionId;
+            if (agentRef && resolution) {
+                if (resolution.mode === "saved") {
+                    ({ sessionId } = await createSession({
+                        ...sessionFields,
+                        agentInstanceId: resolution.instanceId,
+                    }));
+                }
+                else {
+                    ({ sessionId } = await createSession({
+                        ...sessionFields,
+                        agentRef,
+                    }));
+                }
+            }
+            else {
+                const defaultInstanceId = defaultAgent?.status?.defaultInstanceId;
+                if (!defaultInstanceId) {
+                    throw new Error("No default agent available. Select an agent to start a session.");
+                }
+                ({ sessionId } = await createSession({
+                    ...sessionFields,
+                    agentInstanceId: defaultInstanceId,
+                }));
+            }
+            await createExecution({ ...executionFields, sessionId });
+            sessionVariables.clear();
+            onSessionCreated(sessionId);
+        }
+        catch (err) {
+            const detail = getUserMessage(err, "Failed to start session");
+            setSubmitError(detail);
+            onError?.(detail);
+        }
+        finally {
+            setIsSubmitting(false);
+        }
+    }, [
+        isSubmitting,
+        org,
+        validModelId,
+        workspace,
+        mcpServerUsages,
+        skillRefs,
+        runnerId,
+        agentRef,
+        resolution,
+        defaultAgent,
+        createSession,
+        createExecution,
+        sessionVariables,
+        onSessionCreated,
+        onError,
+    ]);
+    return {
+        modelId: validModelId,
+        setModelId,
+        agentRef,
+        setAgentRef,
+        resolution,
+        setResolution,
+        mcpServerUsages,
+        setMcpServerUsages,
+        skillRefs,
+        setSkillRefs,
+        runnerId,
+        setRunnerId,
+        workspace,
+        sessionVariables,
+        isSubmitting,
+        submitError,
+        submit,
+    };
+}
+//# sourceMappingURL=useNewSessionFlow.js.map

package/session/useNewSessionFlow.js.map

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

package/session/usePersistedModel.d.ts

@@ -0,0 +1,18 @@
+/** Return value of {@link usePersistedModel}. */
+export type UsePersistedModelReturn = readonly [
+    modelId: string | undefined,
+    setModelId: (id: string) => void
+];
+/**
+ * Model selection with localStorage persistence.
+ *
+ * Restores the last selected model on mount and validates it against the
+ * model registry. Invalid or removed models are silently ignored (returns
+ * `undefined`). On change, persists the new selection to localStorage so
+ * it survives page reloads and navigation.
+ *
+ * Used by both the session launcher (new session) and session page
+ * (follow-up messages) to maintain a consistent model preference.
+ */
+export declare function usePersistedModel(): UsePersistedModelReturn;
+//# sourceMappingURL=usePersistedModel.d.ts.map

package/session/usePersistedModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePersistedModel.d.ts","sourceRoot":"","sources":["../../src/session/usePersistedModel.ts"],"names":[],"mappings":"AAOA,iDAAiD;AACjD,MAAM,MAAM,uBAAuB,GAAG,SAAS;IAC7C,OAAO,EAAE,MAAM,GAAG,SAAS;IAC3B,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI;CACjC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,IAAI,uBAAuB,CAgB3D"}

package/session/usePersistedModel.js

@@ -0,0 +1,31 @@
+"use client";
+import { useEffect, useState } from "react";
+import { useModelRegistry } from "../models";
+const STORAGE_KEY_MODEL = "stigmer:session:model";
+/**
+ * Model selection with localStorage persistence.
+ *
+ * Restores the last selected model on mount and validates it against the
+ * model registry. Invalid or removed models are silently ignored (returns
+ * `undefined`). On change, persists the new selection to localStorage so
+ * it survives page reloads and navigation.
+ *
+ * Used by both the session launcher (new session) and session page
+ * (follow-up messages) to maintain a consistent model preference.
+ */
+export function usePersistedModel() {
+    const { getModel } = useModelRegistry();
+    const [modelId, setModelId] = useState(() => {
+        if (typeof window === "undefined")
+            return undefined;
+        return localStorage.getItem(STORAGE_KEY_MODEL) ?? undefined;
+    });
+    useEffect(() => {
+        if (modelId) {
+            localStorage.setItem(STORAGE_KEY_MODEL, modelId);
+        }
+    }, [modelId]);
+    const validModelId = modelId && getModel(modelId) ? modelId : undefined;
+    return [validModelId, setModelId];
+}
+//# sourceMappingURL=usePersistedModel.js.map

package/session/usePersistedModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePersistedModel.js","sourceRoot":"","sources":["../../src/session/usePersistedModel.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;AAQlD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,EAAE,QAAQ,EAAE,GAAG,gBAAgB,EAAE,CAAC;IAExC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAqB,GAAG,EAAE;QAC9D,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO,SAAS,CAAC;QACpD,OAAO,YAAY,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,SAAS,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,EAAE,CAAC;YACZ,YAAY,CAAC,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,MAAM,YAAY,GAAG,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACxE,OAAO,CAAC,YAAY,EAAE,UAAU,CAAU,CAAC;AAC7C,CAAC"}

package/session/useSessionPageFlow.d.ts

@@ -0,0 +1,104 @@
+import type { McpServerUsageInput, ResourceRef } from "@stigmer/sdk";
+import type { AgentResolution } from "../agent";
+import { type UseWorkspaceEntriesReturn } from "../workspace";
+import { type UseSessionVariablesReturn } from "../execution/useSessionVariables";
+import type { SessionComposerSubmitContext } from "../composer";
+import { type UseSessionConversationReturn } from "./useSessionConversation";
+import { type UsePersistedModelReturn } from "./usePersistedModel";
+/** Options for {@link useSessionPageFlow}. */
+export interface UseSessionPageFlowOptions {
+    /** Session ID to load and manage. */
+    readonly sessionId: string;
+    /** Organization slug. */
+    readonly org: string;
+}
+/** Return value of {@link useSessionPageFlow}. */
+export interface UseSessionPageFlowReturn {
+    /** Full conversation state from `useSessionConversation`. */
+    readonly conv: UseSessionConversationReturn;
+    /** Persisted model selection: `[modelId, setModelId]`. */
+    readonly model: UsePersistedModelReturn;
+    /** Currently selected agent reference (derived from session, or overridden by user). */
+    readonly agentRef: ResourceRef | null;
+    /** Update the agent reference for future follow-ups. */
+    readonly setAgentRef: (ref: ResourceRef | null) => void;
+    /** Current agent resolution state. */
+    readonly resolution: AgentResolution | null;
+    /** Update the agent resolution. */
+    readonly setResolution: (r: AgentResolution | null) => void;
+    /** Active MCP server configurations for follow-ups. */
+    readonly mcpServerUsages: McpServerUsageInput[];
+    /** Update MCP server configurations. */
+    readonly setMcpServerUsages: (usages: McpServerUsageInput[]) => void;
+    /** Active skill references for follow-ups. */
+    readonly skillRefs: ResourceRef[];
+    /** Update skill references. */
+    readonly setSkillRefs: (refs: ResourceRef[]) => void;
+    /** Workspace entries manager (synced from session on load). */
+    readonly workspace: UseWorkspaceEntriesReturn;
+    /** Session variables (per-execution secrets) manager. */
+    readonly sessionVariables: UseSessionVariablesReturn;
+    /**
+     * Submit a follow-up message. Handles agent override resolution
+     * (if the user changed the agent mid-session) and delegates to
+     * `conv.sendFollowUp` with all managed state.
+     */
+    readonly handleSubmit: (message: string, model?: string, context?: SessionComposerSubmitContext) => Promise<void>;
+    /**
+     * The most relevant execution for sidebar display — the active
+     * streaming execution, or the last completed one.
+     */
+    readonly displayExecution: UseSessionConversationReturn["activeStreamExecution"];
+    /**
+     * All executions for widget display (completed + active stream).
+     */
+    readonly allExecutions: UseSessionConversationReturn["completedExecutions"];
+    /**
+     * Sandbox workspace root for file path normalization, or `undefined`
+     * when the session has no git-repo workspace entries.
+     */
+    readonly sandboxWorkspaceRoot: string | undefined;
+}
+/**
+ * Orchestrates the session page experience.
+ *
+ * Composes `useSessionConversation` with agent resolution, workspace
+ * synchronization, model persistence, and follow-up submission logic.
+ * Returns everything a session page needs to render its UI without
+ * duplicating domain orchestration.
+ *
+ * Framework-agnostic — works identically in Next.js, Vite, Tauri, or
+ * any React environment. The consumer provides layout, error states,
+ * and loading skeletons.
+ *
+ * @example
+ * ```tsx
+ * const flow = useSessionPageFlow({ sessionId: "ses_abc", org: "acme" });
+ *
+ * if (flow.conv.isLoading) return <Spinner />;
+ * if (flow.conv.loadError) return <ErrorView error={flow.conv.loadError} />;
+ *
+ * return (
+ *   <>
+ *     <MessageThread
+ *       executions={flow.conv.completedExecutions}
+ *       activeStreamExecution={flow.conv.activeStreamExecution}
+ *       sandboxWorkspaceRoot={flow.sandboxWorkspaceRoot}
+ *     />
+ *     <SessionComposer
+ *       onSubmit={flow.handleSubmit}
+ *       isSubmitting={flow.conv.isSending}
+ *       disabled={!flow.conv.canSendFollowUp}
+ *       workspace={flow.workspace}
+ *       agentRef={flow.agentRef}
+ *       onAgentRefChange={flow.setAgentRef}
+ *       onAgentResolutionChange={flow.setResolution}
+ *       defaultModelId={flow.model[0]}
+ *       onModelChange={flow.model[1]}
+ *     />
+ *   </>
+ * );
+ * ```
+ */
+export declare function useSessionPageFlow(options: UseSessionPageFlowOptions): UseSessionPageFlowReturn;
+//# sourceMappingURL=useSessionPageFlow.d.ts.map

package/session/useSessionPageFlow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSessionPageFlow.d.ts","sourceRoot":"","sources":["../../src/session/useSessionPageFlow.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAGhD,OAAO,EAAuB,KAAK,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAuB,KAAK,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AACvG,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAA0B,KAAK,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAErG,OAAO,EAAqB,KAAK,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAQtF,8CAA8C;AAC9C,MAAM,WAAW,yBAAyB;IACxC,qCAAqC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yBAAyB;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACvC,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC;IAE5C,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IAExC,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IACtC,wDAAwD;IACxD,QAAQ,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IACxD,sCAAsC;IACtC,QAAQ,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;IAC5C,mCAAmC;IACnC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI,KAAK,IAAI,CAAC;IAE5D,uDAAuD;IACvD,QAAQ,CAAC,eAAe,EAAE,mBAAmB,EAAE,CAAC;IAChD,wCAAwC;IACxC,QAAQ,CAAC,kBAAkB,EAAE,CAAC,MAAM,EAAE,mBAAmB,EAAE,KAAK,IAAI,CAAC;IAErE,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,WAAW,EAAE,CAAC;IAClC,+BAA+B;IAC/B,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IAErD,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;IAC9C,yDAAyD;IACzD,QAAQ,CAAC,gBAAgB,EAAE,yBAAyB,CAAC;IAErD;;;;OAIG;IACH,QAAQ,CAAC,YAAY,EAAE,CACrB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,4BAA4B,KACnC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnB;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,EAAE,4BAA4B,CAAC,uBAAuB,CAAC,CAAC;IAEjF;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,4BAA4B,CAAC,qBAAqB,CAAC,CAAC;IAE5E;;;OAGG;IACH,QAAQ,CAAC,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;CACnD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GACjC,wBAAwB,CAmJ1B"}

package/session/useSessionPageFlow.js

@@ -0,0 +1,172 @@
+"use client";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { useDefaultAgent } from "../agent";
+import { useStigmer } from "../hooks";
+import { useWorkspaceEntries } from "../workspace";
+import { useSessionVariables } from "../execution/useSessionVariables";
+import { useSessionConversation } from "./useSessionConversation";
+import { useAgentRefFromSession } from "./useAgentRefFromSession";
+import { usePersistedModel } from "./usePersistedModel";
+/**
+ * Well-known Daytona sandbox workspace root. Used as the SDK safety-net
+ * normalization target for cloud sessions (git-repo workspace entries).
+ */
+const DAYTONA_WORKSPACE_ROOT = "/home/daytona/workspace";
+/**
+ * Orchestrates the session page experience.
+ *
+ * Composes `useSessionConversation` with agent resolution, workspace
+ * synchronization, model persistence, and follow-up submission logic.
+ * Returns everything a session page needs to render its UI without
+ * duplicating domain orchestration.
+ *
+ * Framework-agnostic — works identically in Next.js, Vite, Tauri, or
+ * any React environment. The consumer provides layout, error states,
+ * and loading skeletons.
+ *
+ * @example
+ * ```tsx
+ * const flow = useSessionPageFlow({ sessionId: "ses_abc", org: "acme" });
+ *
+ * if (flow.conv.isLoading) return <Spinner />;
+ * if (flow.conv.loadError) return <ErrorView error={flow.conv.loadError} />;
+ *
+ * return (
+ *   <>
+ *     <MessageThread
+ *       executions={flow.conv.completedExecutions}
+ *       activeStreamExecution={flow.conv.activeStreamExecution}
+ *       sandboxWorkspaceRoot={flow.sandboxWorkspaceRoot}
+ *     />
+ *     <SessionComposer
+ *       onSubmit={flow.handleSubmit}
+ *       isSubmitting={flow.conv.isSending}
+ *       disabled={!flow.conv.canSendFollowUp}
+ *       workspace={flow.workspace}
+ *       agentRef={flow.agentRef}
+ *       onAgentRefChange={flow.setAgentRef}
+ *       onAgentResolutionChange={flow.setResolution}
+ *       defaultModelId={flow.model[0]}
+ *       onModelChange={flow.model[1]}
+ *     />
+ *   </>
+ * );
+ * ```
+ */
+export function useSessionPageFlow(options) {
+    const { sessionId, org } = options;
+    const stigmer = useStigmer();
+    const conv = useSessionConversation(sessionId, org);
+    const model = usePersistedModel();
+    const [modelId] = model;
+    const workspace = useWorkspaceEntries();
+    const sessionVariables = useSessionVariables();
+    const [mcpServerUsages, setMcpServerUsages] = useState([]);
+    const [skillRefs, setSkillRefs] = useState([]);
+    const initialSyncDone = useRef(false);
+    // -------------------------------------------------------------------------
+    // Agent — derive from session, allow mid-session changes
+    // -------------------------------------------------------------------------
+    const sessionInstanceId = conv.session?.spec?.agentInstanceId ?? null;
+    const { agentRef: derivedAgentRef } = useAgentRefFromSession(sessionInstanceId);
+    const { agent: defaultAgent, isLoading: isDefaultAgentLoading } = useDefaultAgent(org);
+    const [agentRef, setAgentRef] = useState(null);
+    const [resolution, setResolution] = useState(null);
+    const [agentInitDone, setAgentInitDone] = useState(false);
+    if (!agentInitDone && derivedAgentRef && sessionInstanceId && !isDefaultAgentLoading) {
+        setAgentInitDone(true);
+        const isDefault = defaultAgent &&
+            derivedAgentRef.org === defaultAgent.metadata?.org &&
+            derivedAgentRef.slug === defaultAgent.metadata?.slug;
+        if (!isDefault) {
+            setAgentRef(derivedAgentRef);
+            setResolution({ mode: "saved", instanceId: sessionInstanceId });
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Workspace — sync entries from session on first load
+    // -------------------------------------------------------------------------
+    useEffect(() => {
+        if (!conv.session || initialSyncDone.current)
+            return;
+        initialSyncDone.current = true;
+        const protoEntries = conv.session.spec?.workspaceEntries ?? [];
+        for (const entry of protoEntries) {
+            if (entry.source?.source.case === "gitRepo") {
+                const { url, branch } = entry.source.source.value;
+                workspace.addGitRepo(url, branch || undefined);
+            }
+            else if (entry.source?.source.case === "localPath") {
+                workspace.addLocalPath(entry.source.source.value.path);
+            }
+        }
+    }, [conv.session, workspace]);
+    // -------------------------------------------------------------------------
+    // Follow-up submission with agent override
+    // -------------------------------------------------------------------------
+    const handleSubmit = useCallback(async (message, selectedModel, context) => {
+        let agentInstanceIdOverride;
+        if (resolution) {
+            if (resolution.mode === "saved" &&
+                resolution.instanceId !== sessionInstanceId) {
+                agentInstanceIdOverride = resolution.instanceId;
+            }
+            else if (resolution.mode === "direct" && agentRef) {
+                const agent = await stigmer.agent.getByReference(agentRef);
+                const defaultId = agent.status?.defaultInstanceId;
+                if (defaultId && defaultId !== sessionInstanceId) {
+                    agentInstanceIdOverride = defaultId;
+                }
+            }
+        }
+        conv.sendFollowUp(message, {
+            agentInstanceId: agentInstanceIdOverride,
+            modelName: selectedModel ?? modelId,
+            workspaceEntries: workspace.hasEntries
+                ? workspace.toInput()
+                : undefined,
+            mcpServerUsages: mcpServerUsages.length > 0 ? mcpServerUsages : undefined,
+            skillRefs: skillRefs.length > 0 ? skillRefs : undefined,
+            runtimeEnv: context?.runtimeEnv,
+            attachments: context?.attachments,
+        });
+        sessionVariables.clear();
+    }, [conv, modelId, workspace, mcpServerUsages, skillRefs, sessionVariables, resolution, agentRef, sessionInstanceId, stigmer]);
+    // -------------------------------------------------------------------------
+    // Derived display state
+    // -------------------------------------------------------------------------
+    const displayExecution = useMemo(() => {
+        if (conv.activeStreamExecution)
+            return conv.activeStreamExecution;
+        const completed = conv.completedExecutions;
+        return completed.length > 0 ? completed[completed.length - 1] : null;
+    }, [conv.activeStreamExecution, conv.completedExecutions]);
+    const allExecutions = useMemo(() => [
+        ...conv.completedExecutions,
+        ...(conv.activeStreamExecution ? [conv.activeStreamExecution] : []),
+    ], [conv.completedExecutions, conv.activeStreamExecution]);
+    const sandboxWorkspaceRoot = useMemo(() => {
+        const entries = conv.workspaceEntries;
+        const hasGitRepo = entries.some((e) => e.source?.source.case === "gitRepo");
+        return hasGitRepo ? DAYTONA_WORKSPACE_ROOT : undefined;
+    }, [conv.workspaceEntries]);
+    return {
+        conv,
+        model,
+        agentRef,
+        setAgentRef,
+        resolution,
+        setResolution,
+        mcpServerUsages,
+        setMcpServerUsages,
+        skillRefs,
+        setSkillRefs,
+        workspace,
+        sessionVariables,
+        handleSubmit,
+        displayExecution,
+        allExecutions,
+        sandboxWorkspaceRoot,
+    };
+}
+//# sourceMappingURL=useSessionPageFlow.js.map