@stigmer/react 0.0.36 → 0.0.40

package/environment/usePersonalEnvironment.js

@@ -0,0 +1,168 @@
+"use client";
+import { useCallback, useMemo, useRef, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { UpdateEnvironmentVariablesRequestSchema, RemoveEnvironmentVariablesRequestSchema, } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/io_pb";
+import { EnvironmentValueSchema } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/spec_pb";
+import { useStigmer } from "../hooks";
+import { generateSlugSuffix } from "../internal/slug";
+import { toError } from "../internal/toError";
+import { useEnvironmentList } from "./useEnvironmentList";
+const PERSONAL_LABELS = {
+    "stigmer.ai/personal": "true",
+};
+/**
+ * Layer 2 orchestration hook that manages the caller's personal
+ * {@link Environment} for a given organization.
+ *
+ * Encapsulates the "personal environment" convention: label
+ * (`stigmer.ai/personal: "true"`), unique slug per user, and
+ * the get-or-create lifecycle. Composes {@link useEnvironmentList}
+ * for declarative reading and the SDK client directly for mutations.
+ *
+ * Pass `null` as `org` to skip all operations (stable no-op).
+ *
+ * This is a Layer 2 **Environment Flow** hook. It provides the managed
+ * "personal environment" experience used by the Stigmer Console and
+ * any app that wants automatic credential storage. Callers who manage
+ * environments programmatically should use the Layer 1 building-block
+ * hooks instead:
+ * - {@link useCreateEnvironment} — create any environment
+ * - {@link useUpdateEnvironmentVariables} — incremental variable merge
+ * - {@link useRemoveEnvironmentVariables} — remove variables by key
+ *
+ * @example
+ * ```tsx
+ * // Basic usage — read the personal environment
+ * const { environment, isLoading } = usePersonalEnvironment("acme");
+ *
+ * // Get-or-create with initial data on first use
+ * const { getOrCreate, addVariables, isMutating } =
+ *   usePersonalEnvironment("acme");
+ *
+ * const env = await getOrCreate({
+ *   GITHUB_TOKEN: { value: "ghp_...", isSecret: true },
+ * });
+ *
+ * // Add variables to an existing personal environment
+ * await addVariables({
+ *   SLACK_TOKEN: { value: "xoxb-...", isSecret: true },
+ * });
+ * ```
+ */
+export function usePersonalEnvironment(org) {
+    const stigmer = useStigmer();
+    const { environments, isLoading, error: listError, refetch } = useEnvironmentList(org, PERSONAL_LABELS);
+    const environment = useMemo(() => environments[0] ?? null, [environments]);
+    const [isMutating, setIsMutating] = useState(false);
+    const [mutationError, setMutationError] = useState(null);
+    const environmentRef = useRef(environment);
+    environmentRef.current = environment;
+    const isLoadingRef = useRef(isLoading);
+    isLoadingRef.current = isLoading;
+    const error = mutationError ?? listError;
+    const getOrCreate = useCallback(async (initialData) => {
+        if (environmentRef.current)
+            return environmentRef.current;
+        if (!org) {
+            throw new Error("usePersonalEnvironment: cannot call getOrCreate when org is null.");
+        }
+        if (isLoadingRef.current) {
+            throw new Error("usePersonalEnvironment: cannot call getOrCreate while the " +
+                "environment list is loading. Wait for isLoading to become " +
+                "false before calling getOrCreate().");
+        }
+        setIsMutating(true);
+        setMutationError(null);
+        try {
+            let data;
+            if (initialData && Object.keys(initialData).length > 0) {
+                data = initialData;
+            }
+            const created = await stigmer.environment.create({
+                name: "Personal Environment",
+                slug: `env-personal-${generateSlugSuffix()}`,
+                org,
+                labels: PERSONAL_LABELS,
+                data,
+            });
+            refetch();
+            return created;
+        }
+        catch (err) {
+            setMutationError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsMutating(false);
+        }
+    }, [org, stigmer, refetch]);
+    const addVariables = useCallback(async (variables) => {
+        const env = environmentRef.current;
+        if (!env) {
+            throw new Error("usePersonalEnvironment: personal environment does not exist. " +
+                "Call getOrCreate() before addVariables().");
+        }
+        setIsMutating(true);
+        setMutationError(null);
+        try {
+            const protoVars = Object.fromEntries(Object.entries(variables).map(([k, v]) => [
+                k,
+                create(EnvironmentValueSchema, {
+                    value: v.value,
+                    isSecret: v.isSecret,
+                    description: v.description,
+                }),
+            ]));
+            const request = create(UpdateEnvironmentVariablesRequestSchema, {
+                environmentId: env.metadata.id,
+                variables: protoVars,
+            });
+            const updated = await stigmer.environment.updateVariables(request);
+            refetch();
+            return updated;
+        }
+        catch (err) {
+            setMutationError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsMutating(false);
+        }
+    }, [stigmer, refetch]);
+    const removeVariables = useCallback(async (keys) => {
+        const env = environmentRef.current;
+        if (!env) {
+            throw new Error("usePersonalEnvironment: personal environment does not exist. " +
+                "Call getOrCreate() before removeVariables().");
+        }
+        setIsMutating(true);
+        setMutationError(null);
+        try {
+            const request = create(RemoveEnvironmentVariablesRequestSchema, {
+                environmentId: env.metadata.id,
+                keys,
+            });
+            const updated = await stigmer.environment.removeVariables(request);
+            refetch();
+            return updated;
+        }
+        catch (err) {
+            setMutationError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsMutating(false);
+        }
+    }, [stigmer, refetch]);
+    return {
+        environment,
+        isLoading,
+        error,
+        refetch,
+        getOrCreate,
+        addVariables,
+        removeVariables,
+        isMutating,
+    };
+}
+//# sourceMappingURL=usePersonalEnvironment.js.map

package/environment/usePersonalEnvironment.js.map

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

package/environment/useRemoveEnvironmentVariables.d.ts

@@ -0,0 +1,45 @@
+import type { Environment } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/api_pb";
+/**
+ * Input for removing specific variables from an environment by key.
+ *
+ * Keys that do not exist in the environment are silently ignored.
+ */
+export interface RemoveEnvironmentVariablesInput {
+    /** The environment resource ID. */
+    readonly environmentId: string;
+    /** Keys to remove from the environment's `spec.data`. */
+    readonly keys: string[];
+}
+export interface UseRemoveEnvironmentVariablesReturn {
+    readonly removeVariables: (input: RemoveEnvironmentVariablesInput) => Promise<Environment>;
+    readonly isRemovingVariables: boolean;
+    readonly error: Error | null;
+    readonly clearError: () => void;
+}
+/**
+ * Behavior hook that wraps `environment.removeVariables()` with
+ * loading/error state.
+ *
+ * Removes the specified keys from the environment's `spec.data`.
+ * Keys that do not exist are silently ignored. Variables not
+ * mentioned in the request are preserved unchanged.
+ *
+ * Returns the full {@link Environment} proto (with secrets redacted)
+ * so callers can immediately reference the latest state.
+ *
+ * This is a Layer 1 building-block hook for the **Environment Flow**
+ * — delete individual variables without a full-resource update cycle.
+ *
+ * @example
+ * ```tsx
+ * const { removeVariables, isRemovingVariables, error } =
+ *   useRemoveEnvironmentVariables();
+ *
+ * const env = await removeVariables({
+ *   environmentId: "env-abc123",
+ *   keys: ["DEPRECATED_KEY", "OLD_TOKEN"],
+ * });
+ * ```
+ */
+export declare function useRemoveEnvironmentVariables(): UseRemoveEnvironmentVariablesReturn;
+//# sourceMappingURL=useRemoveEnvironmentVariables.d.ts.map

package/environment/useRemoveEnvironmentVariables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRemoveEnvironmentVariables.d.ts","sourceRoot":"","sources":["../../src/environment/useRemoveEnvironmentVariables.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0DAA0D,CAAC;AAK5F;;;;GAIG;AACH,MAAM,WAAW,+BAA+B;IAC9C,mCAAmC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,eAAe,EAAE,CACxB,KAAK,EAAE,+BAA+B,KACnC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1B,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,6BAA6B,IAAI,mCAAmC,CA8BnF"}

package/environment/useRemoveEnvironmentVariables.js

@@ -0,0 +1,57 @@
+"use client";
+import { useCallback, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { RemoveEnvironmentVariablesRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+/**
+ * Behavior hook that wraps `environment.removeVariables()` with
+ * loading/error state.
+ *
+ * Removes the specified keys from the environment's `spec.data`.
+ * Keys that do not exist are silently ignored. Variables not
+ * mentioned in the request are preserved unchanged.
+ *
+ * Returns the full {@link Environment} proto (with secrets redacted)
+ * so callers can immediately reference the latest state.
+ *
+ * This is a Layer 1 building-block hook for the **Environment Flow**
+ * — delete individual variables without a full-resource update cycle.
+ *
+ * @example
+ * ```tsx
+ * const { removeVariables, isRemovingVariables, error } =
+ *   useRemoveEnvironmentVariables();
+ *
+ * const env = await removeVariables({
+ *   environmentId: "env-abc123",
+ *   keys: ["DEPRECATED_KEY", "OLD_TOKEN"],
+ * });
+ * ```
+ */
+export function useRemoveEnvironmentVariables() {
+    const stigmer = useStigmer();
+    const [isRemovingVariables, setIsRemovingVariables] = useState(false);
+    const [error, setError] = useState(null);
+    const clearError = useCallback(() => setError(null), []);
+    const removeVariables = useCallback(async (input) => {
+        setIsRemovingVariables(true);
+        setError(null);
+        try {
+            const request = create(RemoveEnvironmentVariablesRequestSchema, {
+                environmentId: input.environmentId,
+                keys: input.keys,
+            });
+            return await stigmer.environment.removeVariables(request);
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsRemovingVariables(false);
+        }
+    }, [stigmer]);
+    return { removeVariables, isRemovingVariables, error, clearError };
+}
+//# sourceMappingURL=useRemoveEnvironmentVariables.js.map

package/environment/useRemoveEnvironmentVariables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRemoveEnvironmentVariables.js","sourceRoot":"","sources":["../../src/environment/useRemoveEnvironmentVariables.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,uCAAuC,EAAE,MAAM,yDAAyD,CAAC;AAClH,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAuB9C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,6BAA6B;IAC3C,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,mBAAmB,EAAE,sBAAsB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAEzD,MAAM,eAAe,GAAG,WAAW,CACjC,KAAK,EAAE,KAAsC,EAAwB,EAAE;QACrE,sBAAsB,CAAC,IAAI,CAAC,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,CAAC,uCAAuC,EAAE;gBAC9D,aAAa,EAAE,KAAK,CAAC,aAAa;gBAClC,IAAI,EAAE,KAAK,CAAC,IAAI;aACjB,CAAC,CAAC;YAEH,OAAO,MAAM,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,sBAAsB,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AACrE,CAAC"}

package/environment/useRevealSecretValue.d.ts

@@ -0,0 +1,66 @@
+export interface UseRevealSecretValueOptions {
+    /**
+     * Milliseconds after which the revealed value is automatically cleared
+     * from component state. Prevents sensitive values from lingering in memory.
+     *
+     * - Default: `30_000` (30 seconds) — enough time to copy a value.
+     * - Set to `0` to disable auto-clear (caller is responsible for clearing).
+     */
+    readonly autoClearMs?: number;
+}
+export interface UseRevealSecretValueReturn {
+    /**
+     * Fetch and reveal a single secret value from an environment.
+     * Replaces any previously revealed value. Resets error state.
+     *
+     * @param environmentId - The environment resource ID.
+     * @param key - The key within `spec.data` to reveal.
+     */
+    readonly reveal: (environmentId: string, key: string) => Promise<void>;
+    /** The decrypted value, or `null` when not yet revealed or cleared. */
+    readonly revealedValue: string | null;
+    /** `true` while the reveal request is in-flight. */
+    readonly isRevealing: boolean;
+    /** Error message from the last failed reveal attempt, or `null`. */
+    readonly error: Error | null;
+    /** Immediately clear the revealed value and cancel any pending auto-clear timer. */
+    readonly clearRevealedValue: () => void;
+}
+/**
+ * Behavior hook that encapsulates the "reveal secret" interaction.
+ *
+ * Fetches a single unredacted secret value via
+ * `stigmer.environment.getSecretValue()`, holds the decrypted value in
+ * state, and auto-clears it after a configurable timeout.
+ *
+ * This is an **imperative** hook (call `reveal()` on user action),
+ * not a declarative data hook (no auto-fetch on mount). It pairs with
+ * a "reveal" / "show" button in the UI — the canonical pattern for
+ * sensitive credential display (AWS, GitHub, 1Password).
+ *
+ * Follows the headless-first pattern: pure behavior, zero rendering.
+ * Platform builders compose this hook with their own UI.
+ *
+ * This is a Layer 1 building-block hook for the **Environment Flow**.
+ *
+ * @example
+ * ```tsx
+ * function SecretField({ envId, secretKey }: Props) {
+ *   const { reveal, revealedValue, isRevealing, clearRevealedValue } =
+ *     useRevealSecretValue();
+ *
+ *   return revealedValue ? (
+ *     <div>
+ *       <code>{revealedValue}</code>
+ *       <button onClick={clearRevealedValue}>Hide</button>
+ *     </div>
+ *   ) : (
+ *     <button onClick={() => reveal(envId, secretKey)} disabled={isRevealing}>
+ *       {isRevealing ? "Revealing…" : "Reveal"}
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+export declare function useRevealSecretValue(options?: UseRevealSecretValueOptions): UseRevealSecretValueReturn;
+//# sourceMappingURL=useRevealSecretValue.d.ts.map

package/environment/useRevealSecretValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRevealSecretValue.d.ts","sourceRoot":"","sources":["../../src/environment/useRevealSecretValue.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,2BAA2B;IAC1C;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,0BAA0B;IACzC;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvE,uEAAuE;IACvE,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtC,oDAAoD;IACpD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAE9B,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAE7B,oFAAoF;IACpF,QAAQ,CAAC,kBAAkB,EAAE,MAAM,IAAI,CAAC;CACzC;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,CAAC,EAAE,2BAA2B,GACpC,0BAA0B,CA0D5B"}

package/environment/useRevealSecretValue.js

@@ -0,0 +1,92 @@
+"use client";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { EnvironmentSecretValueInputSchema } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+const DEFAULT_AUTO_CLEAR_MS = 30_000;
+/**
+ * Behavior hook that encapsulates the "reveal secret" interaction.
+ *
+ * Fetches a single unredacted secret value via
+ * `stigmer.environment.getSecretValue()`, holds the decrypted value in
+ * state, and auto-clears it after a configurable timeout.
+ *
+ * This is an **imperative** hook (call `reveal()` on user action),
+ * not a declarative data hook (no auto-fetch on mount). It pairs with
+ * a "reveal" / "show" button in the UI — the canonical pattern for
+ * sensitive credential display (AWS, GitHub, 1Password).
+ *
+ * Follows the headless-first pattern: pure behavior, zero rendering.
+ * Platform builders compose this hook with their own UI.
+ *
+ * This is a Layer 1 building-block hook for the **Environment Flow**.
+ *
+ * @example
+ * ```tsx
+ * function SecretField({ envId, secretKey }: Props) {
+ *   const { reveal, revealedValue, isRevealing, clearRevealedValue } =
+ *     useRevealSecretValue();
+ *
+ *   return revealedValue ? (
+ *     <div>
+ *       <code>{revealedValue}</code>
+ *       <button onClick={clearRevealedValue}>Hide</button>
+ *     </div>
+ *   ) : (
+ *     <button onClick={() => reveal(envId, secretKey)} disabled={isRevealing}>
+ *       {isRevealing ? "Revealing…" : "Reveal"}
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+export function useRevealSecretValue(options) {
+    const stigmer = useStigmer();
+    const [revealedValue, setRevealedValue] = useState(null);
+    const [isRevealing, setIsRevealing] = useState(false);
+    const [error, setError] = useState(null);
+    const autoClearMs = options?.autoClearMs ?? DEFAULT_AUTO_CLEAR_MS;
+    const timerRef = useRef(null);
+    const cancelTimer = useCallback(() => {
+        if (timerRef.current !== null) {
+            clearTimeout(timerRef.current);
+            timerRef.current = null;
+        }
+    }, []);
+    const clearRevealedValue = useCallback(() => {
+        cancelTimer();
+        setRevealedValue(null);
+    }, [cancelTimer]);
+    // Clean up timer and clear value on unmount
+    useEffect(() => {
+        return () => {
+            cancelTimer();
+            setRevealedValue(null);
+        };
+    }, [cancelTimer]);
+    const reveal = useCallback(async (environmentId, key) => {
+        cancelTimer();
+        setIsRevealing(true);
+        setError(null);
+        try {
+            const result = await stigmer.environment.getSecretValue(create(EnvironmentSecretValueInputSchema, { environmentId, key }));
+            setRevealedValue(result.value ?? null);
+            if (autoClearMs > 0) {
+                timerRef.current = setTimeout(() => {
+                    setRevealedValue(null);
+                    timerRef.current = null;
+                }, autoClearMs);
+            }
+        }
+        catch (err) {
+            setError(toError(err));
+            setRevealedValue(null);
+        }
+        finally {
+            setIsRevealing(false);
+        }
+    }, [stigmer, autoClearMs, cancelTimer]);
+    return { reveal, revealedValue, isRevealing, error, clearRevealedValue };
+}
+//# sourceMappingURL=useRevealSecretValue.js.map

package/environment/useRevealSecretValue.js.map

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

package/environment/useSessionEnvPool.d.ts

@@ -0,0 +1,80 @@
+import type { EnvVarInput } from "@stigmer/sdk";
+import type { SessionVariableEntry } from "../execution/useSessionVariables";
+/**
+ * Inputs to the session env pool from all env-var sources.
+ *
+ * The pool aggregates keys and values from personal environment,
+ * manual session variables, agent one-time env vars, and MCP server
+ * pending runtime env. Any source can be omitted — the pool
+ * gracefully handles `undefined` inputs.
+ */
+export interface SessionEnvPoolInput {
+    /** Keys already saved in the user's personal environment. */
+    readonly personalEnvKeys?: Set<string>;
+    /** Manual session variable entries from {@link useSessionVariables}. */
+    readonly manualSecrets?: readonly SessionVariableEntry[];
+    /** Agent one-time runtime env (when resolution mode is `"oneTime"`). */
+    readonly agentRuntimeEnv?: Readonly<Record<string, EnvVarInput>>;
+    /** MCP server pending runtime env (accumulated one-time values). */
+    readonly mcpRuntimeEnv?: Readonly<Record<string, EnvVarInput>>;
+}
+export interface UseSessionEnvPoolReturn {
+    /**
+     * All env var keys currently available from any source.
+     *
+     * Includes keys from personal environment, valid manual secrets,
+     * agent one-time env, and MCP pending env. Reactive — recomputes
+     * when any source changes.
+     */
+    readonly availableKeys: Set<string>;
+    /**
+     * Look up a value by key from the pool.
+     *
+     * Priority order (last-write-wins, matching submit merge order):
+     * 1. Personal env keys (no values available — returns sentinel)
+     * 2. Agent one-time runtime env
+     * 3. MCP server pending runtime env
+     * 4. Manual session variables (highest priority)
+     *
+     * Returns `undefined` if the key is not in the pool.
+     */
+    readonly getAvailableValue: (key: string) => EnvVarInput | undefined;
+    /**
+     * Check if a key is satisfied by any source in the pool.
+     *
+     * Equivalent to `availableKeys.has(key)` but provided for
+     * semantic clarity.
+     */
+    readonly isKeySatisfied: (key: string) => boolean;
+}
+/**
+ * Reactive computation hook that aggregates environment variable
+ * availability from all session-level sources.
+ *
+ * The pool enables cross-referencing between the session variables
+ * panel, agent env form, and MCP server env form — so a variable
+ * entered in one place is recognized as "already provided" by the
+ * others. This eliminates duplicate credential prompting.
+ *
+ * Pure computation — no side effects, no API calls. Recomputes
+ * via `useMemo` when any input source changes.
+ *
+ * Platform builders who use individual setup hooks can pass the
+ * pool's `availableKeys` to `useMcpServerSetup` and `useAgentSetup`
+ * via their `poolKeys` parameter for cross-referencing.
+ *
+ * @example
+ * ```tsx
+ * const sessionVars = useSessionVariables();
+ * const personalEnv = usePersonalEnvironment(org);
+ *
+ * const pool = useSessionEnvPool({
+ *   personalEnvKeys: new Set(Object.keys(personalEnv.environment?.spec?.data ?? {})),
+ *   manualSecrets: sessionVars.entries,
+ * });
+ *
+ * // pool.isKeySatisfied("GITHUB_TOKEN") → true if entered anywhere
+ * ```
+ */
+export declare function useSessionEnvPool(input: SessionEnvPoolInput): UseSessionEnvPoolReturn;
+//# sourceMappingURL=useSessionEnvPool.d.ts.map

package/environment/useSessionEnvPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSessionEnvPool.d.ts","sourceRoot":"","sources":["../../src/environment/useSessionEnvPool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAE7E;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,QAAQ,CAAC,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvC,wEAAwE;IACxE,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACzD,wEAAwE;IACxE,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IACjE,oEAAoE;IACpE,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;;;OAMG;IACH,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAEpC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,iBAAiB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,CAAC;IAErE;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CACnD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,mBAAmB,GACzB,uBAAuB,CA8DzB"}

package/environment/useSessionEnvPool.js

@@ -0,0 +1,72 @@
+"use client";
+import { useMemo } from "react";
+/**
+ * Reactive computation hook that aggregates environment variable
+ * availability from all session-level sources.
+ *
+ * The pool enables cross-referencing between the session variables
+ * panel, agent env form, and MCP server env form — so a variable
+ * entered in one place is recognized as "already provided" by the
+ * others. This eliminates duplicate credential prompting.
+ *
+ * Pure computation — no side effects, no API calls. Recomputes
+ * via `useMemo` when any input source changes.
+ *
+ * Platform builders who use individual setup hooks can pass the
+ * pool's `availableKeys` to `useMcpServerSetup` and `useAgentSetup`
+ * via their `poolKeys` parameter for cross-referencing.
+ *
+ * @example
+ * ```tsx
+ * const sessionVars = useSessionVariables();
+ * const personalEnv = usePersonalEnvironment(org);
+ *
+ * const pool = useSessionEnvPool({
+ *   personalEnvKeys: new Set(Object.keys(personalEnv.environment?.spec?.data ?? {})),
+ *   manualSecrets: sessionVars.entries,
+ * });
+ *
+ * // pool.isKeySatisfied("GITHUB_TOKEN") → true if entered anywhere
+ * ```
+ */
+export function useSessionEnvPool(input) {
+    const { personalEnvKeys, manualSecrets, agentRuntimeEnv, mcpRuntimeEnv, } = input;
+    const valueMap = useMemo(() => {
+        const map = new Map();
+        if (agentRuntimeEnv) {
+            for (const [key, value] of Object.entries(agentRuntimeEnv)) {
+                map.set(key, value);
+            }
+        }
+        if (mcpRuntimeEnv) {
+            for (const [key, value] of Object.entries(mcpRuntimeEnv)) {
+                map.set(key, value);
+            }
+        }
+        if (manualSecrets) {
+            for (const entry of manualSecrets) {
+                const k = entry.key.trim();
+                if (k !== "" && entry.value.trim() !== "") {
+                    map.set(k, { value: entry.value, isSecret: entry.isSecret });
+                }
+            }
+        }
+        return map;
+    }, [manualSecrets, agentRuntimeEnv, mcpRuntimeEnv]);
+    const availableKeys = useMemo(() => {
+        const keys = new Set();
+        if (personalEnvKeys) {
+            for (const key of personalEnvKeys) {
+                keys.add(key);
+            }
+        }
+        for (const key of valueMap.keys()) {
+            keys.add(key);
+        }
+        return keys;
+    }, [personalEnvKeys, valueMap]);
+    const getAvailableValue = useMemo(() => (key) => valueMap.get(key), [valueMap]);
+    const isKeySatisfied = useMemo(() => (key) => availableKeys.has(key), [availableKeys]);
+    return { availableKeys, getAvailableValue, isKeySatisfied };
+}
+//# sourceMappingURL=useSessionEnvPool.js.map

package/environment/useSessionEnvPool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSessionEnvPool.js","sourceRoot":"","sources":["../../src/environment/useSessionEnvPool.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAuDhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAA0B;IAE1B,MAAM,EACJ,eAAe,EACf,aAAa,EACb,eAAe,EACf,aAAa,GACd,GAAG,KAAK,CAAC;IAEV,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;QAC5B,MAAM,GAAG,GAAG,IAAI,GAAG,EAAuB,CAAC;QAE3C,IAAI,eAAe,EAAE,CAAC;YACpB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;gBAC3D,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QAED,IAAI,aAAa,EAAE,CAAC;YAClB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;gBACzD,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QAED,IAAI,aAAa,EAAE,CAAC;YAClB,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;gBAClC,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC3B,IAAI,CAAC,KAAK,EAAE,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;oBAC1C,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAC/D,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,CAAC,aAAa,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC,CAAC;IAEpD,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,EAAE;QACjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAE/B,IAAI,eAAe,EAAE,CAAC;YACpB,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;gBAClC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC;QACH,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;YAClC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,EAAE,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEhC,MAAM,iBAAiB,GAAG,OAAO,CAC/B,GAAG,EAAE,CAAC,CAAC,GAAW,EAA2B,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EACjE,CAAC,QAAQ,CAAC,CACX,CAAC;IAEF,MAAM,cAAc,GAAG,OAAO,CAC5B,GAAG,EAAE,CAAC,CAAC,GAAW,EAAW,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EACtD,CAAC,aAAa,CAAC,CAChB,CAAC;IAEF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC;AAC9D,CAAC"}

package/environment/useUpdateEnvironment.d.ts

@@ -0,0 +1,43 @@
+import type { EnvironmentInput } from "@stigmer/sdk";
+import type { Environment } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/api_pb";
+export interface UseUpdateEnvironmentReturn {
+    readonly update: (input: EnvironmentInput) => Promise<Environment>;
+    readonly isUpdating: boolean;
+    readonly error: Error | null;
+    readonly clearError: () => void;
+}
+/**
+ * Behavior hook that wraps `environment.update()` with loading/error
+ * state.
+ *
+ * Updates an existing Environment resource. The caller provides a
+ * full {@link EnvironmentInput} including the environment's `name`
+ * and `org` (used by the backend to identify the resource) and all
+ * spec fields.
+ *
+ * Returns the full {@link Environment} proto including
+ * server-updated metadata (version, timestamps) so callers can
+ * immediately reference the latest state.
+ *
+ * This is a Layer 1 building-block hook for the **Environment Flow**
+ * — persistent credential storage via Environment resources. For the
+ * managed "personal environment" convenience, see
+ * {@link usePersonalEnvironment} which composes this hook with
+ * deterministic naming and label conventions.
+ *
+ * @example
+ * ```tsx
+ * const { update, isUpdating, error } = useUpdateEnvironment();
+ *
+ * const env = await update({
+ *   name: "prod-credentials",
+ *   org: "acme",
+ *   description: "Production API keys",
+ *   data: {
+ *     API_KEY: { value: "sk-new-...", isSecret: true },
+ *   },
+ * });
+ * ```
+ */
+export declare function useUpdateEnvironment(): UseUpdateEnvironmentReturn;
+//# sourceMappingURL=useUpdateEnvironment.d.ts.map