@stigmer/react 0.0.36 → 0.0.40

package/environment/index.d.ts

@@ -0,0 +1,28 @@
+export { useCreateEnvironment } from "./useCreateEnvironment";
+export type { UseCreateEnvironmentReturn } from "./useCreateEnvironment";
+export { useEnvironment } from "./useEnvironment";
+export type { UseEnvironmentReturn } from "./useEnvironment";
+export { useEnvironmentList } from "./useEnvironmentList";
+export type { UseEnvironmentListReturn } from "./useEnvironmentList";
+export { usePersonalEnvironment } from "./usePersonalEnvironment";
+export type { UsePersonalEnvironmentReturn } from "./usePersonalEnvironment";
+export { useRevealSecretValue } from "./useRevealSecretValue";
+export type { UseRevealSecretValueOptions, UseRevealSecretValueReturn, } from "./useRevealSecretValue";
+export { useRemoveEnvironmentVariables } from "./useRemoveEnvironmentVariables";
+export type { RemoveEnvironmentVariablesInput, UseRemoveEnvironmentVariablesReturn, } from "./useRemoveEnvironmentVariables";
+export { useUpdateEnvironment } from "./useUpdateEnvironment";
+export type { UseUpdateEnvironmentReturn } from "./useUpdateEnvironment";
+export { useUpdateEnvironmentVariables } from "./useUpdateEnvironmentVariables";
+export type { UpdateEnvironmentVariablesInput, UseUpdateEnvironmentVariablesReturn, } from "./useUpdateEnvironmentVariables";
+export { EnvironmentVariableEditor } from "./EnvironmentVariableEditor";
+export type { EnvironmentVariableEditorProps } from "./EnvironmentVariableEditor";
+export { EnvironmentListPanel } from "./EnvironmentListPanel";
+export type { EnvironmentListPanelProps } from "./EnvironmentListPanel";
+export { CreateEnvironmentForm } from "./CreateEnvironmentForm";
+export type { CreateEnvironmentFormProps } from "./CreateEnvironmentForm";
+export { EnvVarForm } from "./EnvVarForm";
+export type { EnvVarFormProps, EnvVarFormVariable, EnvVarFormSubmitOptions, } from "./EnvVarForm";
+export { diffEnvSpec } from "./diffEnvSpec";
+export { useSessionEnvPool } from "./useSessionEnvPool";
+export type { SessionEnvPoolInput, UseSessionEnvPoolReturn, } from "./useSessionEnvPool";
+//# sourceMappingURL=index.d.ts.map

package/environment/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/environment/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EACV,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,YAAY,EACV,+BAA+B,EAC/B,mCAAmC,GACpC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,YAAY,EACV,+BAA+B,EAC/B,mCAAmC,GACpC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,YAAY,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EACV,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC"}

package/environment/index.js

@@ -0,0 +1,15 @@
+export { useCreateEnvironment } from "./useCreateEnvironment";
+export { useEnvironment } from "./useEnvironment";
+export { useEnvironmentList } from "./useEnvironmentList";
+export { usePersonalEnvironment } from "./usePersonalEnvironment";
+export { useRevealSecretValue } from "./useRevealSecretValue";
+export { useRemoveEnvironmentVariables } from "./useRemoveEnvironmentVariables";
+export { useUpdateEnvironment } from "./useUpdateEnvironment";
+export { useUpdateEnvironmentVariables } from "./useUpdateEnvironmentVariables";
+export { EnvironmentVariableEditor } from "./EnvironmentVariableEditor";
+export { EnvironmentListPanel } from "./EnvironmentListPanel";
+export { CreateEnvironmentForm } from "./CreateEnvironmentForm";
+export { EnvVarForm } from "./EnvVarForm";
+export { diffEnvSpec } from "./diffEnvSpec";
+export { useSessionEnvPool } from "./useSessionEnvPool";
+//# sourceMappingURL=index.js.map

package/environment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/environment/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAK9D,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAKhF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAKhF,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAExE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAM1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/environment/useCreateEnvironment.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 UseCreateEnvironmentReturn {
+    readonly create: (input: EnvironmentInput) => Promise<Environment>;
+    readonly isCreating: boolean;
+    readonly error: Error | null;
+    readonly clearError: () => void;
+}
+/**
+ * Behavior hook that wraps `environment.create()` with loading/error
+ * state.
+ *
+ * Creates an Environment resource — a named collection of
+ * configuration values and secrets. The caller provides an
+ * {@link EnvironmentInput} with `name`, `org`, and optionally
+ * `description` and `data` (key-value pairs).
+ *
+ * Returns the full {@link Environment} proto including
+ * server-generated metadata (id, version, timestamps) so callers
+ * can immediately reference the created resource.
+ *
+ * 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 { create, isCreating, error } = useCreateEnvironment();
+ *
+ * const env = await create({
+ *   name: "prod-credentials",
+ *   org: "acme",
+ *   description: "Production API keys",
+ *   data: {
+ *     API_KEY: { value: "sk-...", isSecret: true },
+ *   },
+ * });
+ * ```
+ */
+export declare function useCreateEnvironment(): UseCreateEnvironmentReturn;
+//# sourceMappingURL=useCreateEnvironment.d.ts.map

package/environment/useCreateEnvironment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCreateEnvironment.d.ts","sourceRoot":"","sources":["../../src/environment/useCreateEnvironment.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0DAA0D,CAAC;AAI5F,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IACnE,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,oBAAoB,IAAI,0BAA0B,CAyBjE"}

package/environment/useCreateEnvironment.js

@@ -0,0 +1,59 @@
+"use client";
+import { useCallback, useState } from "react";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+/**
+ * Behavior hook that wraps `environment.create()` with loading/error
+ * state.
+ *
+ * Creates an Environment resource — a named collection of
+ * configuration values and secrets. The caller provides an
+ * {@link EnvironmentInput} with `name`, `org`, and optionally
+ * `description` and `data` (key-value pairs).
+ *
+ * Returns the full {@link Environment} proto including
+ * server-generated metadata (id, version, timestamps) so callers
+ * can immediately reference the created resource.
+ *
+ * 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 { create, isCreating, error } = useCreateEnvironment();
+ *
+ * const env = await create({
+ *   name: "prod-credentials",
+ *   org: "acme",
+ *   description: "Production API keys",
+ *   data: {
+ *     API_KEY: { value: "sk-...", isSecret: true },
+ *   },
+ * });
+ * ```
+ */
+export function useCreateEnvironment() {
+    const stigmer = useStigmer();
+    const [isCreating, setIsCreating] = useState(false);
+    const [error, setError] = useState(null);
+    const clearError = useCallback(() => setError(null), []);
+    const create = useCallback(async (input) => {
+        setIsCreating(true);
+        setError(null);
+        try {
+            return await stigmer.environment.create(input);
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsCreating(false);
+        }
+    }, [stigmer]);
+    return { create, isCreating, error, clearError };
+}
+//# sourceMappingURL=useCreateEnvironment.js.map

package/environment/useCreateEnvironment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCreateEnvironment.js","sourceRoot":"","sources":["../../src/environment/useCreateEnvironment.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAG9C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAS9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,oBAAoB;IAClC,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,CAAe,IAAI,CAAC,CAAC;IAEvD,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAEzD,MAAM,MAAM,GAAG,WAAW,CACxB,KAAK,EAAE,KAAuB,EAAwB,EAAE;QACtD,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,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/environment/useEnvironment.d.ts

@@ -0,0 +1,37 @@
+import type { Environment } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/api_pb";
+import type { ResourceRef } from "@stigmer/sdk";
+export interface UseEnvironmentReturn {
+    readonly environment: Environment | null;
+    readonly isLoading: boolean;
+    readonly error: Error | null;
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches a single Environment by resource reference.
+ *
+ * Pass `null` to skip fetching (stable no-op). When the reference
+ * fields change, the previous in-flight request is discarded and a
+ * fresh fetch begins. Call `refetch()` to re-query after mutating the
+ * environment through a separate hook or API call.
+ *
+ * Returns the full proto {@link Environment} resource so consumers
+ * have access to metadata, spec (including `data` key-value pairs),
+ * and status without additional calls.
+ *
+ * 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}. For ephemeral per-execution secrets,
+ * see the Execution Flow via {@link useCreateAgentExecution} with
+ * `runtimeEnv`.
+ *
+ * @example
+ * ```tsx
+ * const { environment, isLoading, error } = useEnvironment({
+ *   org: "acme",
+ *   slug: "prod-env",
+ * });
+ * ```
+ */
+export declare function useEnvironment(ref: ResourceRef | null): UseEnvironmentReturn;
+//# sourceMappingURL=useEnvironment.d.ts.map

package/environment/useEnvironment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEnvironment.d.ts","sourceRoot":"","sources":["../../src/environment/useEnvironment.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0DAA0D,CAAC;AAC5F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IACzC,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;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,WAAW,GAAG,IAAI,GACtB,oBAAoB,CA4CtB"}

package/environment/useEnvironment.js

@@ -0,0 +1,69 @@
+"use client";
+import { useCallback, useEffect, useState } from "react";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+/**
+ * Data hook that fetches a single Environment by resource reference.
+ *
+ * Pass `null` to skip fetching (stable no-op). When the reference
+ * fields change, the previous in-flight request is discarded and a
+ * fresh fetch begins. Call `refetch()` to re-query after mutating the
+ * environment through a separate hook or API call.
+ *
+ * Returns the full proto {@link Environment} resource so consumers
+ * have access to metadata, spec (including `data` key-value pairs),
+ * and status without additional calls.
+ *
+ * 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}. For ephemeral per-execution secrets,
+ * see the Execution Flow via {@link useCreateAgentExecution} with
+ * `runtimeEnv`.
+ *
+ * @example
+ * ```tsx
+ * const { environment, isLoading, error } = useEnvironment({
+ *   org: "acme",
+ *   slug: "prod-env",
+ * });
+ * ```
+ */
+export function useEnvironment(ref) {
+    const stigmer = useStigmer();
+    const [environment, setEnvironment] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [fetchKey, setFetchKey] = useState(0);
+    const refetch = useCallback(() => setFetchKey((k) => k + 1), []);
+    const org = ref?.org;
+    const slug = ref?.slug;
+    const version = ref?.version;
+    useEffect(() => {
+        if (!org || !slug) {
+            setEnvironment(null);
+            setIsLoading(false);
+            setError(null);
+            return;
+        }
+        const cancelled = { current: false };
+        setIsLoading(true);
+        setError(null);
+        stigmer.environment.getByReference({ org, slug, version }).then((result) => {
+            if (cancelled.current)
+                return;
+            setEnvironment(result);
+            setIsLoading(false);
+        }, (err) => {
+            if (cancelled.current)
+                return;
+            setError(toError(err));
+            setIsLoading(false);
+        });
+        return () => {
+            cancelled.current = true;
+        };
+    }, [org, slug, version, stigmer, fetchKey]);
+    return { environment, isLoading, error, refetch };
+}
+//# sourceMappingURL=useEnvironment.js.map

package/environment/useEnvironment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEnvironment.js","sourceRoot":"","sources":["../../src/environment/useEnvironment.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGzD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAS9C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAuB;IAEvB,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAqB,IAAI,CAAC,CAAC;IACzE,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,MAAM,GAAG,GAAG,GAAG,EAAE,GAAG,CAAC;IACrB,MAAM,IAAI,GAAG,GAAG,EAAE,IAAI,CAAC;IACvB,MAAM,OAAO,GAAG,GAAG,EAAE,OAAO,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,cAAc,CAAC,IAAI,CAAC,CAAC;YACrB,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,WAAW,CAAC,cAAc,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,CAC7D,CAAC,MAAM,EAAE,EAAE;YACT,IAAI,SAAS,CAAC,OAAO;gBAAE,OAAO;YAC9B,cAAc,CAAC,MAAM,CAAC,CAAC;YACvB,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;QAEF,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;QAC3B,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE5C,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACpD,CAAC"}

package/environment/useEnvironmentList.d.ts

@@ -0,0 +1,31 @@
+import type { Environment } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/api_pb";
+export interface UseEnvironmentListReturn {
+    readonly environments: readonly Environment[];
+    readonly totalCount: number;
+    readonly isLoading: boolean;
+    readonly error: Error | null;
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches a paginated list of {@link Environment} entries
+ * for a given organization, with optional label filtering.
+ *
+ * Pass `null` as `org` to skip fetching (stable no-op). When the org
+ * or labels change, the previous in-flight request is discarded and a
+ * fresh fetch begins. Call `refetch()` to re-query after mutations.
+ *
+ * Secret values in returned environments are redacted server-side.
+ *
+ * This is a Layer 1 building-block hook for the **Environment Flow**.
+ * For the managed "personal environment" convenience, see
+ * {@link usePersonalEnvironment}.
+ *
+ * @example
+ * ```tsx
+ * const { environments, isLoading } = useEnvironmentList("acme", {
+ *   "stigmer.ai/personal": "true",
+ * });
+ * ```
+ */
+export declare function useEnvironmentList(org: string | null, labels?: Record<string, string>): UseEnvironmentListReturn;
+//# sourceMappingURL=useEnvironmentList.d.ts.map

package/environment/useEnvironmentList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEnvironmentList.d.ts","sourceRoot":"","sources":["../../src/environment/useEnvironmentList.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0DAA0D,CAAC;AAK5F,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,YAAY,EAAE,SAAS,WAAW,EAAE,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,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;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,wBAAwB,CAsE1B"}

package/environment/useEnvironmentList.js

@@ -0,0 +1,88 @@
+"use client";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { ListEnvironmentsRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+/**
+ * Data hook that fetches a paginated list of {@link Environment} entries
+ * for a given organization, with optional label filtering.
+ *
+ * Pass `null` as `org` to skip fetching (stable no-op). When the org
+ * or labels change, the previous in-flight request is discarded and a
+ * fresh fetch begins. Call `refetch()` to re-query after mutations.
+ *
+ * Secret values in returned environments are redacted server-side.
+ *
+ * This is a Layer 1 building-block hook for the **Environment Flow**.
+ * For the managed "personal environment" convenience, see
+ * {@link usePersonalEnvironment}.
+ *
+ * @example
+ * ```tsx
+ * const { environments, isLoading } = useEnvironmentList("acme", {
+ *   "stigmer.ai/personal": "true",
+ * });
+ * ```
+ */
+export function useEnvironmentList(org, labels) {
+    const stigmer = useStigmer();
+    const [environments, setEnvironments] = useState([]);
+    const [totalCount, setTotalCount] = useState(0);
+    const [isLoading, setIsLoading] = useState(!!org);
+    const [error, setError] = useState(null);
+    const [fetchKey, setFetchKey] = useState(0);
+    // Synchronously reset loading state when org changes so that
+    // downstream hooks see isLoading=true in the SAME render —
+    // not deferred to the next render via an effect.
+    const [prevOrg, setPrevOrg] = useState(org);
+    if (org !== prevOrg) {
+        setPrevOrg(org);
+        if (org) {
+            setIsLoading(true);
+            setEnvironments([]);
+            setTotalCount(0);
+            setError(null);
+        }
+        else {
+            setIsLoading(false);
+            setEnvironments([]);
+            setTotalCount(0);
+            setError(null);
+        }
+    }
+    const labelsRef = useRef(labels);
+    if (labels !== labelsRef.current &&
+        JSON.stringify(labels) !== JSON.stringify(labelsRef.current)) {
+        labelsRef.current = labels;
+    }
+    const stableLabels = labelsRef.current;
+    const refetch = useCallback(() => setFetchKey((k) => k + 1), []);
+    useEffect(() => {
+        if (!org)
+            return;
+        const cancelled = { current: false };
+        stigmer.environment
+            .list(create(ListEnvironmentsRequestSchema, {
+            org,
+            labels: stableLabels ?? {},
+        }))
+            .then((result) => {
+            if (cancelled.current)
+                return;
+            setEnvironments(result.items);
+            setTotalCount(result.totalCount);
+            setIsLoading(false);
+        }, (err) => {
+            if (cancelled.current)
+                return;
+            setError(toError(err));
+            setIsLoading(false);
+        });
+        return () => {
+            cancelled.current = true;
+        };
+    }, [org, stableLabels, stigmer, fetchKey]);
+    return { environments, totalCount, isLoading, error, refetch };
+}
+//# sourceMappingURL=useEnvironmentList.js.map

package/environment/useEnvironmentList.js.map

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

package/environment/usePersonalEnvironment.d.ts

@@ -0,0 +1,100 @@
+import type { EnvVarInput } from "@stigmer/sdk";
+import type { Environment } from "@stigmer/protos/ai/stigmer/agentic/environment/v1/api_pb";
+export interface UsePersonalEnvironmentReturn {
+    /** The caller's personal environment, or `null` if not yet created or still loading. */
+    readonly environment: Environment | null;
+    /** `true` while the initial list query is in-flight. */
+    readonly isLoading: boolean;
+    /** Error message from the most recent failed operation (fetch or mutation), or `null`. */
+    readonly error: Error | null;
+    /** Re-query the personal environment from the server. */
+    readonly refetch: () => void;
+    /**
+     * Ensure a personal environment exists for this org.
+     *
+     * If one already exists, returns it immediately without a network call.
+     * Otherwise, creates a new environment with a unique slug and
+     * label `stigmer.ai/personal: "true"`, optionally seeded with initial data.
+     *
+     * **Preconditions:** `org` must be non-null and {@link isLoading} must be
+     * `false`. Calling while `isLoading` is `true` throws — the list query
+     * has not completed, so `getOrCreate` cannot determine whether the
+     * environment already exists and would risk creating a duplicate.
+     *
+     * @param initialData - Key-value pairs to include on creation. Ignored
+     *   if the personal environment already exists. Use {@link addVariables}
+     *   to merge variables into an existing environment.
+     * @returns The personal environment (existing or newly created).
+     * @throws If `org` is null or the environment list is still loading.
+     */
+    readonly getOrCreate: (initialData?: Record<string, EnvVarInput>) => Promise<Environment>;
+    /**
+     * Add or update variables in the personal environment via server-side merge.
+     *
+     * Only the supplied keys are affected — existing variables not mentioned
+     * are preserved unchanged. Secret values are encrypted server-side.
+     *
+     * Requires the personal environment to exist. Call {@link getOrCreate}
+     * first if it may not.
+     *
+     * @param variables - Variables to add or update.
+     * @returns The updated environment (secrets redacted).
+     */
+    readonly addVariables: (variables: Record<string, EnvVarInput>) => Promise<Environment>;
+    /**
+     * Remove variables from the personal environment by key.
+     *
+     * Keys that do not exist are silently ignored. Variables not mentioned
+     * are preserved unchanged.
+     *
+     * Requires the personal environment to exist. Call {@link getOrCreate}
+     * first if it may not.
+     *
+     * @param keys - Keys to remove from the environment's data.
+     * @returns The updated environment (secrets redacted).
+     */
+    readonly removeVariables: (keys: string[]) => Promise<Environment>;
+    /** `true` while any mutation (`getOrCreate`, `addVariables`, `removeVariables`) is in-flight. */
+    readonly isMutating: boolean;
+}
+/**
+ * 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 declare function usePersonalEnvironment(org: string | null): UsePersonalEnvironmentReturn;
+//# sourceMappingURL=usePersonalEnvironment.d.ts.map

package/environment/usePersonalEnvironment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePersonalEnvironment.d.ts","sourceRoot":"","sources":["../../src/environment/usePersonalEnvironment.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0DAA0D,CAAC;AAe5F,MAAM,WAAW,4BAA4B;IAC3C,wFAAwF;IACxF,QAAQ,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IACzC,wDAAwD;IACxD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,0FAA0F;IAC1F,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAE7B;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,WAAW,EAAE,CACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,KACtC,OAAO,CAAC,WAAW,CAAC,CAAC;IAE1B;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,YAAY,EAAE,CACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,KACnC,OAAO,CAAC,WAAW,CAAC,CAAC;IAE1B;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAEnE,iGAAiG;IACjG,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,GAAG,IAAI,GACjB,4BAA4B,CA6J9B"}