@stigmer/react 0.0.36 → 0.0.40

package/agent/useAgentSetup.js.map

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

package/agent/useDefaultAgent.d.ts

@@ -0,0 +1,29 @@
+import type { Agent } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb";
+export interface UseDefaultAgentReturn {
+    /** The platform default agent, or null while loading / on error. */
+    readonly agent: Agent | null;
+    readonly isLoading: boolean;
+    readonly error: Error | null;
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches the platform's default agent.
+ *
+ * The default agent is the one labeled `stigmer.ai/default-agent: "true"`
+ * with `visibility_public`. It enables session-first UX where users
+ * start a conversation without choosing an agent.
+ *
+ * Pass `null` for `org` to skip fetching (stable no-op). The hook
+ * fetches once on mount and caches the result — the default agent
+ * rarely changes within a session.
+ *
+ * @example
+ * ```tsx
+ * const { agent: defaultAgent, isLoading } = useDefaultAgent("acme");
+ *
+ * // Use defaultAgent.status.defaultInstanceId for session creation
+ * // when the user hasn't explicitly selected an agent.
+ * ```
+ */
+export declare function useDefaultAgent(org: string | null): UseDefaultAgentReturn;
+//# sourceMappingURL=useDefaultAgent.d.ts.map

package/agent/useDefaultAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDefaultAgent.d.ts","sourceRoot":"","sources":["../../src/agent/useDefaultAgent.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oDAAoD,CAAC;AAKhF,MAAM,WAAW,qBAAqB;IACpC,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,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;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,qBAAqB,CAwCzE"}

package/agent/useDefaultAgent.js

@@ -0,0 +1,60 @@
+"use client";
+import { useCallback, useEffect, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { GetDefaultAgentRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+/**
+ * Data hook that fetches the platform's default agent.
+ *
+ * The default agent is the one labeled `stigmer.ai/default-agent: "true"`
+ * with `visibility_public`. It enables session-first UX where users
+ * start a conversation without choosing an agent.
+ *
+ * Pass `null` for `org` to skip fetching (stable no-op). The hook
+ * fetches once on mount and caches the result — the default agent
+ * rarely changes within a session.
+ *
+ * @example
+ * ```tsx
+ * const { agent: defaultAgent, isLoading } = useDefaultAgent("acme");
+ *
+ * // Use defaultAgent.status.defaultInstanceId for session creation
+ * // when the user hasn't explicitly selected an agent.
+ * ```
+ */
+export function useDefaultAgent(org) {
+    const stigmer = useStigmer();
+    const [agent, setAgent] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [fetchKey, setFetchKey] = useState(0);
+    const refetch = useCallback(() => setFetchKey((k) => k + 1), []);
+    useEffect(() => {
+        if (!org) {
+            setAgent(null);
+            setIsLoading(false);
+            setError(null);
+            return;
+        }
+        const cancelled = { current: false };
+        setIsLoading(true);
+        setError(null);
+        stigmer.agent.getDefault(create(GetDefaultAgentRequestSchema, { org })).then((result) => {
+            if (cancelled.current)
+                return;
+            setAgent(result);
+            setIsLoading(false);
+        }, (err) => {
+            if (cancelled.current)
+                return;
+            setError(toError(err));
+            setIsLoading(false);
+        });
+        return () => {
+            cancelled.current = true;
+        };
+    }, [org, stigmer, fetchKey]);
+    return { agent, isLoading, error, refetch };
+}
+//# sourceMappingURL=useDefaultAgent.js.map

package/agent/useDefaultAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDefaultAgent.js","sourceRoot":"","sources":["../../src/agent/useDefaultAgent.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,4BAA4B,EAAE,MAAM,mDAAmD,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAU9C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,eAAe,CAAC,GAAkB;IAChD,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE5C,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEjE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,QAAQ,CAAC,IAAI,CAAC,CAAC;YACf,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,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,4BAA4B,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAC1E,CAAC,MAAM,EAAE,EAAE;YACT,IAAI,SAAS,CAAC,OAAO;gBAAE,OAAO;YAC9B,QAAQ,CAAC,MAAM,CAAC,CAAC;YACjB,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,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE7B,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC9C,CAAC"}

package/agent-instance/buildPersonalInstanceInput.d.ts

@@ -0,0 +1,20 @@
+import type { AgentInstanceInput, ResourceRef } from "@stigmer/sdk";
+export interface PersonalInstanceParams {
+    readonly org: string;
+    readonly agentId: string;
+    readonly agentSlug: string;
+    readonly environmentRef: ResourceRef;
+}
+/**
+ * Builds the {@link AgentInstanceInput} for creating a personal agent
+ * instance. Centralizes the naming convention, unique slug generation,
+ * and label assignment so that every call site produces consistent
+ * personal instances.
+ *
+ * The slug includes a random suffix to guarantee uniqueness within
+ * the org (multiple users can each have their own personal instance
+ * for the same agent). Lookup is always label-based via FGA-scoped
+ * list queries, so the slug is never used for retrieval.
+ */
+export declare function buildPersonalInstanceInput(params: PersonalInstanceParams): AgentInstanceInput;
+//# sourceMappingURL=buildPersonalInstanceInput.d.ts.map

package/agent-instance/buildPersonalInstanceInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildPersonalInstanceInput.d.ts","sourceRoot":"","sources":["../../src/agent-instance/buildPersonalInstanceInput.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAMpE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC;CACtC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,sBAAsB,GAC7B,kBAAkB,CAapB"}

package/agent-instance/buildPersonalInstanceInput.js

@@ -0,0 +1,29 @@
+import { generateSlugSuffix } from "../internal/slug";
+const PERSONAL_LABEL = "stigmer.ai/personal";
+const FOR_AGENT_LABEL = "stigmer.ai/for-agent";
+/**
+ * Builds the {@link AgentInstanceInput} for creating a personal agent
+ * instance. Centralizes the naming convention, unique slug generation,
+ * and label assignment so that every call site produces consistent
+ * personal instances.
+ *
+ * The slug includes a random suffix to guarantee uniqueness within
+ * the org (multiple users can each have their own personal instance
+ * for the same agent). Lookup is always label-based via FGA-scoped
+ * list queries, so the slug is never used for retrieval.
+ */
+export function buildPersonalInstanceInput(params) {
+    const { org, agentId, agentSlug, environmentRef } = params;
+    return {
+        name: `${agentSlug} Personal`,
+        slug: `${agentSlug}-personal-${generateSlugSuffix()}`,
+        org,
+        agentId,
+        labels: {
+            [PERSONAL_LABEL]: "true",
+            [FOR_AGENT_LABEL]: `${org}/${agentSlug}`,
+        },
+        environmentRefs: [environmentRef],
+    };
+}
+//# sourceMappingURL=buildPersonalInstanceInput.js.map

package/agent-instance/buildPersonalInstanceInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildPersonalInstanceInput.js","sourceRoot":"","sources":["../../src/agent-instance/buildPersonalInstanceInput.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,cAAc,GAAG,qBAAqB,CAAC;AAC7C,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAS/C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAA8B;IAE9B,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;IAC3D,OAAO;QACL,IAAI,EAAE,GAAG,SAAS,WAAW;QAC7B,IAAI,EAAE,GAAG,SAAS,aAAa,kBAAkB,EAAE,EAAE;QACrD,GAAG;QACH,OAAO;QACP,MAAM,EAAE;YACN,CAAC,cAAc,CAAC,EAAE,MAAM;YACxB,CAAC,eAAe,CAAC,EAAE,GAAG,GAAG,IAAI,SAAS,EAAE;SACzC;QACD,eAAe,EAAE,CAAC,cAAc,CAAC;KAClC,CAAC;AACJ,CAAC"}

package/agent-instance/index.d.ts

@@ -0,0 +1,9 @@
+export { useAgentInstance } from "./useAgentInstance";
+export type { UseAgentInstanceReturn } from "./useAgentInstance";
+export { useAgentInstanceList } from "./useAgentInstanceList";
+export type { UseAgentInstanceListReturn } from "./useAgentInstanceList";
+export { useCreateAgentInstance } from "./useCreateAgentInstance";
+export type { UseCreateAgentInstanceReturn } from "./useCreateAgentInstance";
+export { usePersonalAgentInstance } from "./usePersonalAgentInstance";
+export type { GetOrCreatePersonalInstanceInput, UsePersonalAgentInstanceReturn, } from "./usePersonalAgentInstance";
+//# sourceMappingURL=index.d.ts.map

package/agent-instance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent-instance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EACV,gCAAgC,EAChC,8BAA8B,GAC/B,MAAM,4BAA4B,CAAC"}

package/agent-instance/index.js

@@ -0,0 +1,5 @@
+export { useAgentInstance } from "./useAgentInstance";
+export { useAgentInstanceList } from "./useAgentInstanceList";
+export { useCreateAgentInstance } from "./useCreateAgentInstance";
+export { usePersonalAgentInstance } from "./usePersonalAgentInstance";
+//# sourceMappingURL=index.js.map

package/agent-instance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent-instance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC"}

package/agent-instance/useAgentInstance.d.ts

@@ -0,0 +1,35 @@
+import type { AgentInstance } from "@stigmer/protos/ai/stigmer/agentic/agentinstance/v1/api_pb";
+import type { ResourceRef } from "@stigmer/sdk";
+export interface UseAgentInstanceReturn {
+    readonly agentInstance: AgentInstance | null;
+    readonly isLoading: boolean;
+    readonly error: Error | null;
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches a single AgentInstance 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
+ * agent instance through a separate hook or API call.
+ *
+ * Returns the full proto {@link AgentInstance} resource so consumers
+ * have access to metadata, spec (including `environment_refs` and
+ * agent reference), and status without additional calls.
+ *
+ * This is a Layer 1 building-block hook for the **Environment Flow**
+ * — agent instances bind Environment resources to Agent blueprints.
+ * For the managed "personal agent instance" convenience, see
+ * {@link usePersonalAgentInstance}.
+ *
+ * @example
+ * ```tsx
+ * const { agentInstance, isLoading, error } = useAgentInstance({
+ *   org: "acme",
+ *   slug: "my-agent-personal",
+ * });
+ * ```
+ */
+export declare function useAgentInstance(ref: ResourceRef | null): UseAgentInstanceReturn;
+//# sourceMappingURL=useAgentInstance.d.ts.map

package/agent-instance/useAgentInstance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentInstance.d.ts","sourceRoot":"","sources":["../../src/agent-instance/useAgentInstance.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4DAA4D,CAAC;AAChG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7C,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;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,WAAW,GAAG,IAAI,GACtB,sBAAsB,CA4CxB"}

package/agent-instance/useAgentInstance.js

@@ -0,0 +1,67 @@
+"use client";
+import { useCallback, useEffect, useState } from "react";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+/**
+ * Data hook that fetches a single AgentInstance 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
+ * agent instance through a separate hook or API call.
+ *
+ * Returns the full proto {@link AgentInstance} resource so consumers
+ * have access to metadata, spec (including `environment_refs` and
+ * agent reference), and status without additional calls.
+ *
+ * This is a Layer 1 building-block hook for the **Environment Flow**
+ * — agent instances bind Environment resources to Agent blueprints.
+ * For the managed "personal agent instance" convenience, see
+ * {@link usePersonalAgentInstance}.
+ *
+ * @example
+ * ```tsx
+ * const { agentInstance, isLoading, error } = useAgentInstance({
+ *   org: "acme",
+ *   slug: "my-agent-personal",
+ * });
+ * ```
+ */
+export function useAgentInstance(ref) {
+    const stigmer = useStigmer();
+    const [agentInstance, setAgentInstance] = 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) {
+            setAgentInstance(null);
+            setIsLoading(false);
+            setError(null);
+            return;
+        }
+        const cancelled = { current: false };
+        setIsLoading(true);
+        setError(null);
+        stigmer.agentInstance.getByReference({ org, slug, version }).then((result) => {
+            if (cancelled.current)
+                return;
+            setAgentInstance(result);
+            setIsLoading(false);
+        }, (err) => {
+            if (cancelled.current)
+                return;
+            setError(toError(err));
+            setIsLoading(false);
+        });
+        return () => {
+            cancelled.current = true;
+        };
+    }, [org, slug, version, stigmer, fetchKey]);
+    return { agentInstance, isLoading, error, refetch };
+}
+//# sourceMappingURL=useAgentInstance.js.map

package/agent-instance/useAgentInstance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentInstance.js","sourceRoot":"","sources":["../../src/agent-instance/useAgentInstance.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;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAuB;IAEvB,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAuB,IAAI,CAAC,CAAC;IAC/E,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,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACvB,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,aAAa,CAAC,cAAc,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,CAC/D,CAAC,MAAM,EAAE,EAAE;YACT,IAAI,SAAS,CAAC,OAAO;gBAAE,OAAO;YAC9B,gBAAgB,CAAC,MAAM,CAAC,CAAC;YACzB,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,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACtD,CAAC"}

package/agent-instance/useAgentInstanceList.d.ts

@@ -0,0 +1,29 @@
+import type { AgentInstance } from "@stigmer/protos/ai/stigmer/agentic/agentinstance/v1/api_pb";
+export interface UseAgentInstanceListReturn {
+    readonly agentInstances: readonly AgentInstance[];
+    readonly totalCount: number;
+    readonly isLoading: boolean;
+    readonly error: Error | null;
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches a paginated list of {@link AgentInstance} 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.
+ *
+ * This is a Layer 1 building-block hook for the **Environment Flow**.
+ * For the managed "personal agent instance" convenience, see
+ * {@link usePersonalAgentInstance}.
+ *
+ * @example
+ * ```tsx
+ * const { agentInstances, isLoading } = useAgentInstanceList("acme", {
+ *   "stigmer.ai/personal": "true",
+ * });
+ * ```
+ */
+export declare function useAgentInstanceList(org: string | null, labels?: Record<string, string>): UseAgentInstanceListReturn;
+//# sourceMappingURL=useAgentInstanceList.d.ts.map

package/agent-instance/useAgentInstanceList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentInstanceList.d.ts","sourceRoot":"","sources":["../../src/agent-instance/useAgentInstanceList.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4DAA4D,CAAC;AAKhG,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,cAAc,EAAE,SAAS,aAAa,EAAE,CAAC;IAClD,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;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,0BAA0B,CA2D5B"}

package/agent-instance/useAgentInstanceList.js

@@ -0,0 +1,74 @@
+"use client";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { ListAgentInstancesRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/agentinstance/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+/**
+ * Data hook that fetches a paginated list of {@link AgentInstance} 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.
+ *
+ * This is a Layer 1 building-block hook for the **Environment Flow**.
+ * For the managed "personal agent instance" convenience, see
+ * {@link usePersonalAgentInstance}.
+ *
+ * @example
+ * ```tsx
+ * const { agentInstances, isLoading } = useAgentInstanceList("acme", {
+ *   "stigmer.ai/personal": "true",
+ * });
+ * ```
+ */
+export function useAgentInstanceList(org, labels) {
+    const stigmer = useStigmer();
+    const [agentInstances, setAgentInstances] = useState([]);
+    const [totalCount, setTotalCount] = useState(0);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [fetchKey, setFetchKey] = useState(0);
+    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) {
+            setAgentInstances([]);
+            setTotalCount(0);
+            setIsLoading(false);
+            setError(null);
+            return;
+        }
+        const cancelled = { current: false };
+        setIsLoading(true);
+        setError(null);
+        stigmer.agentInstance
+            .list(create(ListAgentInstancesRequestSchema, {
+            org,
+            labels: stableLabels ?? {},
+        }))
+            .then((result) => {
+            if (cancelled.current)
+                return;
+            setAgentInstances(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 { agentInstances, totalCount, isLoading, error, refetch };
+}
+//# sourceMappingURL=useAgentInstanceList.js.map

package/agent-instance/useAgentInstanceList.js.map

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

package/agent-instance/useCreateAgentInstance.d.ts

@@ -0,0 +1,44 @@
+import type { AgentInstanceInput } from "@stigmer/sdk";
+import type { AgentInstance } from "@stigmer/protos/ai/stigmer/agentic/agentinstance/v1/api_pb";
+export interface UseCreateAgentInstanceReturn {
+    readonly create: (input: AgentInstanceInput) => Promise<AgentInstance>;
+    readonly isCreating: boolean;
+    readonly error: Error | null;
+    readonly clearError: () => void;
+}
+/**
+ * Behavior hook that wraps `agentInstance.create()` with
+ * loading/error state.
+ *
+ * Creates an AgentInstance resource — a deployed configuration of an
+ * Agent blueprint bound to one or more Environments. The caller
+ * provides an {@link AgentInstanceInput} with `name`, `org`, and
+ * optionally `agentId`, `description`, and `environmentRefs`.
+ *
+ * Returns the full {@link AgentInstance} 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**
+ * — agent instances bind Environment resources to Agent blueprints.
+ * For the managed "personal agent instance" convenience, see
+ * {@link usePersonalAgentInstance} which composes this hook with
+ * deterministic naming and label conventions.
+ *
+ * @example
+ * ```tsx
+ * const { create, isCreating, error } = useCreateAgentInstance();
+ *
+ * const instance = await create({
+ *   name: "github-bot-prod",
+ *   org: "acme",
+ *   agentId: "agent-abc123",
+ *   description: "Production GitHub bot",
+ *   environmentRefs: [
+ *     { org: "acme", slug: "prod-credentials" },
+ *   ],
+ * });
+ * ```
+ */
+export declare function useCreateAgentInstance(): UseCreateAgentInstanceReturn;
+//# sourceMappingURL=useCreateAgentInstance.d.ts.map

package/agent-instance/useCreateAgentInstance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCreateAgentInstance.d.ts","sourceRoot":"","sources":["../../src/agent-instance/useCreateAgentInstance.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4DAA4D,CAAC;AAIhG,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACvE,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,sBAAsB,IAAI,4BAA4B,CAyBrE"}

package/agent-instance/useCreateAgentInstance.js

@@ -0,0 +1,60 @@
+"use client";
+import { useCallback, useState } from "react";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+/**
+ * Behavior hook that wraps `agentInstance.create()` with
+ * loading/error state.
+ *
+ * Creates an AgentInstance resource — a deployed configuration of an
+ * Agent blueprint bound to one or more Environments. The caller
+ * provides an {@link AgentInstanceInput} with `name`, `org`, and
+ * optionally `agentId`, `description`, and `environmentRefs`.
+ *
+ * Returns the full {@link AgentInstance} 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**
+ * — agent instances bind Environment resources to Agent blueprints.
+ * For the managed "personal agent instance" convenience, see
+ * {@link usePersonalAgentInstance} which composes this hook with
+ * deterministic naming and label conventions.
+ *
+ * @example
+ * ```tsx
+ * const { create, isCreating, error } = useCreateAgentInstance();
+ *
+ * const instance = await create({
+ *   name: "github-bot-prod",
+ *   org: "acme",
+ *   agentId: "agent-abc123",
+ *   description: "Production GitHub bot",
+ *   environmentRefs: [
+ *     { org: "acme", slug: "prod-credentials" },
+ *   ],
+ * });
+ * ```
+ */
+export function useCreateAgentInstance() {
+    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.agentInstance.create(input);
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsCreating(false);
+        }
+    }, [stigmer]);
+    return { create, isCreating, error, clearError };
+}
+//# sourceMappingURL=useCreateAgentInstance.js.map

package/agent-instance/useCreateAgentInstance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCreateAgentInstance.js","sourceRoot":"","sources":["../../src/agent-instance/useCreateAgentInstance.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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,sBAAsB;IACpC,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,KAAyB,EAA0B,EAAE;QAC1D,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnD,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/agent-instance/usePersonalAgentInstance.d.ts

@@ -0,0 +1,93 @@
+import type { ResourceRef } from "@stigmer/sdk";
+import type { AgentInstance } from "@stigmer/protos/ai/stigmer/agentic/agentinstance/v1/api_pb";
+/**
+ * Input for creating a personal agent instance via
+ * {@link UsePersonalAgentInstanceReturn.getOrCreate}.
+ *
+ * The hook already knows `org` (from its first parameter) and
+ * `agentId` (from its second parameter). This input supplies the
+ * additional context needed only at creation time.
+ */
+export interface GetOrCreatePersonalInstanceInput {
+    /**
+     * The agent's slug, used to derive the instance display name and
+     * unique slug, and the `stigmer.ai/for-agent` label.
+     */
+    readonly agentSlug: string;
+    /**
+     * Reference to the caller's personal environment. The created
+     * instance will link to this environment via `environmentRefs`.
+     */
+    readonly personalEnvironmentRef: ResourceRef;
+}
+export interface UsePersonalAgentInstanceReturn {
+    /** The caller's personal agent instance, or `null` if not yet created or still loading. */
+    readonly agentInstance: AgentInstance | null;
+    /** `true` while the initial list query is in-flight. */
+    readonly isLoading: boolean;
+    /** Error from the most recent failed operation (fetch or mutation), or `null`. */
+    readonly error: Error | null;
+    /** Re-query personal agent instances from the server. */
+    readonly refetch: () => void;
+    /**
+     * Ensure a personal agent instance exists for this org and agent.
+     *
+     * If one already exists (matched by `agentId`), returns it immediately
+     * without a network call. Otherwise, creates a new instance with:
+     * - Name: `"{agentSlug} Personal"` (display-friendly, may be duplicate)
+     * - Slug: `"{agentSlug}-personal-{random}"` (unique per org)
+     * - Labels: `stigmer.ai/personal: "true"`, `stigmer.ai/for-agent: "{org}/{agentSlug}"`
+     * - Agent binding: the `agentId` passed to the hook
+     * - Environment linkage: `[personalEnvironmentRef]`
+     *
+     * Requires `agentId` to be set on the hook. Throws a descriptive
+     * error if called without it.
+     *
+     * @param input - Agent slug and personal environment reference.
+     * @returns The personal agent instance (existing or newly created).
+     */
+    readonly getOrCreate: (input: GetOrCreatePersonalInstanceInput) => Promise<AgentInstance>;
+    /** `true` while a `getOrCreate` mutation is in-flight. */
+    readonly isMutating: boolean;
+}
+/**
+ * Layer 2 orchestration hook that manages the caller's personal
+ * {@link AgentInstance} for a given organization, optionally scoped
+ * to a specific agent.
+ *
+ * Encapsulates the "personal agent instance" convention: unique slug
+ * per user, labels (`stigmer.ai/personal`, `stigmer.ai/for-agent`),
+ * and the get-or-create lifecycle. Composes {@link useAgentInstanceList}
+ * for declarative reading and the SDK client directly for mutations.
+ *
+ * Pass `null` as `org` to skip all operations (stable no-op).
+ * The `agentId` parameter is optional for read-only use (listing all
+ * personal instances) but required for {@link getOrCreate}.
+ *
+ * This is a Layer 2 **Environment Flow** hook. It provides the managed
+ * "personal agent instance" experience used by the Stigmer Console.
+ * Callers who pre-provision agent instances should use the Layer 1
+ * building-block hook {@link useCreateAgentInstance} directly.
+ *
+ * @example
+ * ```tsx
+ * // Read-only: check if a personal instance exists for an agent
+ * const { agentInstance, isLoading } = usePersonalAgentInstance(
+ *   "acme",
+ *   agent.metadata.id,
+ * );
+ *
+ * // Get-or-create: ensure a personal instance exists
+ * const { getOrCreate, isMutating } = usePersonalAgentInstance(
+ *   "acme",
+ *   agent.metadata.id,
+ * );
+ *
+ * const instance = await getOrCreate({
+ *   agentSlug: "my-github-bot",
+ *   personalEnvironmentRef: { org: "acme", slug: "env-personal-a1b2c3d4" },
+ * });
+ * ```
+ */
+export declare function usePersonalAgentInstance(org: string | null, agentId?: string): UsePersonalAgentInstanceReturn;
+//# sourceMappingURL=usePersonalAgentInstance.d.ts.map

package/agent-instance/usePersonalAgentInstance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePersonalAgentInstance.d.ts","sourceRoot":"","sources":["../../src/agent-instance/usePersonalAgentInstance.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4DAA4D,CAAC;AAUhG;;;;;;;GAOG;AACH,MAAM,WAAW,gCAAgC;IAC/C;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,sBAAsB,EAAE,WAAW,CAAC;CAC9C;AAED,MAAM,WAAW,8BAA8B;IAC7C,2FAA2F;IAC3F,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7C,wDAAwD;IACxD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAE7B;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,WAAW,EAAE,CACpB,KAAK,EAAE,gCAAgC,KACpC,OAAO,CAAC,aAAa,CAAC,CAAC;IAE5B,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,8BAA8B,CAwEhC"}