@stigmer/react 0.0.91 → 0.0.93

package/runner/useLaunchLocalRunner.js

@@ -0,0 +1,75 @@
+"use client";
+import { useCallback, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { timestampDate } from "@bufbuild/protobuf/wkt";
+import { CreateLaunchTokenRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/runner/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+const LAUNCH_RUNNER_SCHEME = "stigmer://launch-runner";
+function defaultOpenUrl(url) {
+    window.location.href = url;
+}
+/**
+ * Behavior hook that initiates a browser-to-desktop runner launch.
+ *
+ * Orchestrates two steps:
+ * 1. Calls `stigmer.runner.createLaunchToken({ org })` to mint a
+ *    one-time, 60-second token backed by the caller's credentials.
+ * 2. Opens `stigmer://launch-runner?token={token}` so the OS dispatches
+ *    to the Stigmer Desktop app (which exchanges the token for a JWT
+ *    and starts a local runner via its CLI sidecar).
+ *
+ * The hook reports success when the URL is opened. It does **not**
+ * detect whether the desktop app is installed or whether the runner
+ * actually started — those are observable via `useRunnerList`.
+ *
+ * @example
+ * ```tsx
+ * function LaunchButton({ org }: { org: string }) {
+ *   const { launch, isLaunching, error } = useLaunchLocalRunner();
+ *
+ *   return (
+ *     <button onClick={() => launch({ org })} disabled={isLaunching}>
+ *       {isLaunching ? "Launching…" : "Launch Local Runner"}
+ *     </button>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Custom URL handler for non-browser environments
+ * const { launch } = useLaunchLocalRunner({
+ *   openUrl: (url) => nativeBridge.openExternal(url),
+ * });
+ * ```
+ */
+export function useLaunchLocalRunner(options) {
+    const stigmer = useStigmer();
+    const [isLaunching, setIsLaunching] = useState(false);
+    const [error, setError] = useState(null);
+    const openUrl = options?.openUrl ?? defaultOpenUrl;
+    const clearError = useCallback(() => setError(null), []);
+    const launch = useCallback(async (input) => {
+        setIsLaunching(true);
+        setError(null);
+        try {
+            const response = await stigmer.runner.createLaunchToken(create(CreateLaunchTokenRequestSchema, { org: input.org }));
+            const url = `${LAUNCH_RUNNER_SCHEME}?token=${encodeURIComponent(response.token)}`;
+            const expiresAt = response.expiresAt
+                ? timestampDate(response.expiresAt)
+                : undefined;
+            openUrl(url);
+            return { url, expiresAt };
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsLaunching(false);
+        }
+    }, [stigmer, openUrl]);
+    return { launch, isLaunching, error, clearError };
+}
+//# sourceMappingURL=useLaunchLocalRunner.js.map

package/runner/useLaunchLocalRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLaunchLocalRunner.js","sourceRoot":"","sources":["../../src/runner/useLaunchLocalRunner.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,8BAA8B,EAAE,MAAM,oDAAoD,CAAC;AACpG,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,MAAM,oBAAoB,GAAG,yBAAyB,CAAC;AAEvD,SAAS,cAAc,CAAC,GAAW;IACjC,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAG,GAAG,CAAC;AAC7B,CAAC;AAkDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAqC;IAErC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,cAAc,CAAC;IAEnD,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAEzD,MAAM,MAAM,GAAG,WAAW,CACxB,KAAK,EAAE,KAAsB,EAAoC,EAAE;QACjE,cAAc,CAAC,IAAI,CAAC,CAAC;QACrB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,iBAAiB,CACrD,MAAM,CAAC,8BAA8B,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAC3D,CAAC;YAEF,MAAM,GAAG,GAAG,GAAG,oBAAoB,UAAU,kBAAkB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAClF,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS;gBAClC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC;gBACnC,CAAC,CAAC,SAAS,CAAC;YAEd,OAAO,CAAC,GAAG,CAAC,CAAC;YAEb,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,cAAc,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,EACD,CAAC,OAAO,EAAE,OAAO,CAAC,CACnB,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AACpD,CAAC"}

package/runner/useRunnerList.d.ts

@@ -0,0 +1,49 @@
+import type { Runner } from "@stigmer/protos/ai/stigmer/agentic/runner/v1/api_pb";
+/** Options for {@link useRunnerList}. */
+export interface UseRunnerListOptions {
+    /**
+     * Include system-managed (ephemeral cloud) runners in the result.
+     *
+     * System-managed runners are labeled `stigmer.ai/system-managed: "true"`
+     * and are created by the platform for cloud executions. They are hidden
+     * from the session composer by default but useful in admin views.
+     *
+     * @default false
+     */
+    readonly includeSystemManaged?: boolean;
+}
+/** Return value of {@link useRunnerList}. */
+export interface UseRunnerListReturn {
+    /** User-created runners for the organization, empty while loading or on error. */
+    readonly runners: readonly Runner[];
+    /** `true` while the fetch is in flight. */
+    readonly isLoading: boolean;
+    /** Error from the last failed fetch, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Discard cached data and re-fetch the runner list from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches runners for an organization.
+ *
+ * Calls `stigmer.runner.list({ org })` and returns the result with
+ * loading/error state. System-managed (ephemeral cloud) runners are
+ * filtered out by default — pass `includeSystemManaged: true` to
+ * include them (useful for admin panels like Settings > Runners).
+ *
+ * Returns an empty array when `org` is `null` (no organization selected).
+ *
+ * @example
+ * ```tsx
+ * // Session composer — user-created runners only
+ * const { runners, isLoading } = useRunnerList("acme");
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Admin page — all runners including system-managed
+ * const { runners } = useRunnerList("acme", { includeSystemManaged: true });
+ * ```
+ */
+export declare function useRunnerList(org: string | null, options?: UseRunnerListOptions): UseRunnerListReturn;
+//# sourceMappingURL=useRunnerList.d.ts.map

package/runner/useRunnerList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRunnerList.d.ts","sourceRoot":"","sources":["../../src/runner/useRunnerList.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qDAAqD,CAAC;AAOlF,yCAAyC;AACzC,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;OAQG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CACzC;AAED,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,kFAAkF;IAClF,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,mBAAmB,CAmDrB"}

package/runner/useRunnerList.js

@@ -0,0 +1,70 @@
+"use client";
+import { useCallback, useEffect, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { ListRunnersRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/runner/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+const SYSTEM_MANAGED_LABEL = "stigmer.ai/system-managed";
+/**
+ * Data hook that fetches runners for an organization.
+ *
+ * Calls `stigmer.runner.list({ org })` and returns the result with
+ * loading/error state. System-managed (ephemeral cloud) runners are
+ * filtered out by default — pass `includeSystemManaged: true` to
+ * include them (useful for admin panels like Settings > Runners).
+ *
+ * Returns an empty array when `org` is `null` (no organization selected).
+ *
+ * @example
+ * ```tsx
+ * // Session composer — user-created runners only
+ * const { runners, isLoading } = useRunnerList("acme");
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Admin page — all runners including system-managed
+ * const { runners } = useRunnerList("acme", { includeSystemManaged: true });
+ * ```
+ */
+export function useRunnerList(org, options) {
+    const stigmer = useStigmer();
+    const [runners, setRunners] = useState([]);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [fetchKey, setFetchKey] = useState(0);
+    const includeSystemManaged = options?.includeSystemManaged ?? false;
+    const refetch = useCallback(() => setFetchKey((k) => k + 1), []);
+    useEffect(() => {
+        if (!org) {
+            setRunners([]);
+            setIsLoading(false);
+            setError(null);
+            return;
+        }
+        const cancelled = { current: false };
+        setIsLoading(true);
+        setError(null);
+        stigmer.runner
+            .list(create(ListRunnersRequestSchema, { org }))
+            .then((result) => {
+            if (cancelled.current)
+                return;
+            const items = includeSystemManaged
+                ? result.items
+                : result.items.filter((r) => r.metadata?.labels[SYSTEM_MANAGED_LABEL] !== "true");
+            setRunners(items);
+            setIsLoading(false);
+        }, (err) => {
+            if (cancelled.current)
+                return;
+            setError(toError(err));
+            setIsLoading(false);
+        });
+        return () => {
+            cancelled.current = true;
+        };
+    }, [stigmer, org, includeSystemManaged, fetchKey]);
+    return { runners, isLoading, error, refetch };
+}
+//# sourceMappingURL=useRunnerList.js.map

package/runner/useRunnerList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRunnerList.js","sourceRoot":"","sources":["../../src/runner/useRunnerList.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,wBAAwB,EAAE,MAAM,oDAAoD,CAAC;AAC9F,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,MAAM,oBAAoB,GAAG,2BAA2B,CAAC;AA4BzD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAkB,EAClB,OAA8B;IAE9B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAW,EAAE,CAAC,CAAC;IACrD,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,oBAAoB,GAAG,OAAO,EAAE,oBAAoB,IAAI,KAAK,CAAC;IAEpE,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,UAAU,CAAC,EAAE,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,MAAM;aACX,IAAI,CAAC,MAAM,CAAC,wBAAwB,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;aAC/C,IAAI,CACH,CAAC,MAAM,EAAE,EAAE;YACT,IAAI,SAAS,CAAC,OAAO;gBAAE,OAAO;YAE9B,MAAM,KAAK,GAAG,oBAAoB;gBAChC,CAAC,CAAC,MAAM,CAAC,KAAK;gBACd,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,oBAAoB,CAAC,KAAK,MAAM,CAC3D,CAAC;YAEN,UAAU,CAAC,KAAK,CAAC,CAAC;YAClB,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,EACD,CAAC,GAAG,EAAE,EAAE;YACN,IAAI,SAAS,CAAC,OAAO;gBAAE,OAAO;YAC9B,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,CACF,CAAC;QAEJ,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;QAC3B,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,oBAAoB,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEnD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAChD,CAAC"}

package/runner/useStopRunner.d.ts

@@ -0,0 +1,53 @@
+import type { Runner } from "@stigmer/protos/ai/stigmer/agentic/runner/v1/api_pb";
+/** Input for {@link UseStopRunnerReturn.stop}. */
+export interface StopRunnerInput {
+    /** ID of the runner to stop. */
+    readonly runnerId: string;
+    /**
+     * Optional reason for the stop, logged on the runner and in audit.
+     *
+     * @example "user requested via web console"
+     */
+    readonly reason?: string;
+}
+/** Return value of {@link useStopRunner}. */
+export interface UseStopRunnerReturn {
+    /**
+     * Stop a runner gracefully.
+     *
+     * If the runner is connected, sends a stop command via the bidi stream
+     * and waits for acknowledgment. If offline, directly transitions to
+     * STOPPED. Idempotent — stopping an already-stopped or failed runner
+     * returns the resource as-is.
+     *
+     * Resolves with the updated {@link Runner} resource.
+     */
+    readonly stop: (input: StopRunnerInput) => Promise<Runner>;
+    /** `true` while the stop RPC is in flight. */
+    readonly isStopping: boolean;
+    /** Error from the last failed stop attempt, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Reset `error` to `null`. */
+    readonly clearError: () => void;
+}
+/**
+ * Mutation hook that wraps `runner.stop()` with loading and error state.
+ *
+ * Stops a runner gracefully. Connected runners receive a stop command
+ * via the bidi stream; offline runners transition directly to STOPPED.
+ * The operation is idempotent — stopping an already-stopped or failed
+ * runner succeeds without error.
+ *
+ * Returns the updated {@link Runner} resource on success so callers
+ * can reflect the new phase in the UI without a separate refetch.
+ *
+ * @example
+ * ```tsx
+ * const { stop, isStopping, error } = useStopRunner();
+ *
+ * await stop({ runnerId: "rnr_abc123", reason: "user requested" });
+ * refetch(); // refresh the runner list
+ * ```
+ */
+export declare function useStopRunner(): UseStopRunnerReturn;
+//# sourceMappingURL=useStopRunner.d.ts.map

package/runner/useStopRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStopRunner.d.ts","sourceRoot":"","sources":["../../src/runner/useStopRunner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qDAAqD,CAAC;AAKlF,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;OASG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3D,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,IAAI,mBAAmB,CA8BnD"}

package/runner/useStopRunner.js

@@ -0,0 +1,50 @@
+"use client";
+import { useCallback, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { RunnerStopInputSchema } from "@stigmer/protos/ai/stigmer/agentic/runner/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+/**
+ * Mutation hook that wraps `runner.stop()` with loading and error state.
+ *
+ * Stops a runner gracefully. Connected runners receive a stop command
+ * via the bidi stream; offline runners transition directly to STOPPED.
+ * The operation is idempotent — stopping an already-stopped or failed
+ * runner succeeds without error.
+ *
+ * Returns the updated {@link Runner} resource on success so callers
+ * can reflect the new phase in the UI without a separate refetch.
+ *
+ * @example
+ * ```tsx
+ * const { stop, isStopping, error } = useStopRunner();
+ *
+ * await stop({ runnerId: "rnr_abc123", reason: "user requested" });
+ * refetch(); // refresh the runner list
+ * ```
+ */
+export function useStopRunner() {
+    const stigmer = useStigmer();
+    const [isStopping, setIsStopping] = useState(false);
+    const [error, setError] = useState(null);
+    const clearError = useCallback(() => setError(null), []);
+    const stop = useCallback(async (input) => {
+        setIsStopping(true);
+        setError(null);
+        try {
+            return await stigmer.runner.stop(create(RunnerStopInputSchema, {
+                runnerId: input.runnerId,
+                reason: input.reason ?? "",
+            }));
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsStopping(false);
+        }
+    }, [stigmer]);
+    return { stop, isStopping, error, clearError };
+}
+//# sourceMappingURL=useStopRunner.js.map

package/runner/useStopRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStopRunner.js","sourceRoot":"","sources":["../../src/runner/useStopRunner.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,qBAAqB,EAAE,MAAM,oDAAoD,CAAC;AAC3F,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAmC9C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,aAAa;IAC3B,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,IAAI,GAAG,WAAW,CACtB,KAAK,EAAE,KAAsB,EAAmB,EAAE;QAChD,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAC9B,MAAM,CAAC,qBAAqB,EAAE;gBAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE;aAC3B,CAAC,CACH,CAAC;QACJ,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,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AACjD,CAAC"}

package/session/draft.d.ts

@@ -0,0 +1,53 @@
+import type { ResourceRef } from "@stigmer/sdk";
+/**
+ * Resource types that can be created or edited via a draft session.
+ *
+ * Each type maps to a Stigmer system agent that guides the user
+ * through the creation/editing flow in a conversational session.
+ */
+export type DraftResourceType = "agent" | "skill" | "mcp-server";
+/**
+ * Parsed draft session parameters.
+ *
+ * When `editRef` is present, the session is an edit session (modify an
+ * existing resource). When absent, it's a create session (new resource).
+ */
+export interface DraftParams {
+    /** The kind of resource this draft session will create or edit. */
+    readonly draftType: DraftResourceType;
+    /**
+     * When present, identifies the existing resource to edit.
+     * Absent for create-mode sessions.
+     */
+    readonly editRef?: {
+        /** Organization that owns the resource. */
+        readonly org: string;
+        /** URL-friendly identifier of the resource. */
+        readonly slug: string;
+    };
+}
+/**
+ * System agents responsible for creating each resource type.
+ *
+ * Keys match {@link DraftResourceType}; values are {@link ResourceRef}
+ * objects pointing to Stigmer's built-in creator agents.
+ */
+export declare const CREATOR_AGENTS: Record<DraftResourceType, ResourceRef>;
+/**
+ * Validate a string as a recognized {@link DraftResourceType}.
+ *
+ * Returns the validated type or `null` if unrecognized.
+ */
+export declare function parseDraftType(value: string | null): DraftResourceType | null;
+/**
+ * Parse draft session parameters from standard `URLSearchParams`.
+ *
+ * Returns `null` when no valid `draft` param is present. When `editOrg`
+ * and `editSlug` are both present, the returned object includes an
+ * `editRef` indicating this is an edit session rather than a create session.
+ *
+ * Works identically with Next.js `useSearchParams()` or react-router's
+ * `useSearchParams()` — both return standard `URLSearchParams`.
+ */
+export declare function parseDraftParams(searchParams: URLSearchParams): DraftParams | null;
+//# sourceMappingURL=draft.d.ts.map

package/session/draft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft.d.ts","sourceRoot":"","sources":["../../src/session/draft.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,OAAO,GAAG,YAAY,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE;QACjB,2CAA2C;QAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,+CAA+C;QAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,iBAAiB,EAAE,WAAW,CAIjE,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,iBAAiB,GAAG,IAAI,CAK7E;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,eAAe,GAC5B,WAAW,GAAG,IAAI,CAYpB"}

package/session/draft.js

@@ -0,0 +1,45 @@
+/**
+ * System agents responsible for creating each resource type.
+ *
+ * Keys match {@link DraftResourceType}; values are {@link ResourceRef}
+ * objects pointing to Stigmer's built-in creator agents.
+ */
+export const CREATOR_AGENTS = {
+    agent: { org: "stigmer", slug: "agent-creator" },
+    skill: { org: "stigmer", slug: "skill-creator" },
+    "mcp-server": { org: "stigmer", slug: "mcp-server-creator" },
+};
+const VALID_TYPES = new Set(Object.keys(CREATOR_AGENTS));
+/**
+ * Validate a string as a recognized {@link DraftResourceType}.
+ *
+ * Returns the validated type or `null` if unrecognized.
+ */
+export function parseDraftType(value) {
+    if (value !== null && VALID_TYPES.has(value)) {
+        return value;
+    }
+    return null;
+}
+/**
+ * Parse draft session parameters from standard `URLSearchParams`.
+ *
+ * Returns `null` when no valid `draft` param is present. When `editOrg`
+ * and `editSlug` are both present, the returned object includes an
+ * `editRef` indicating this is an edit session rather than a create session.
+ *
+ * Works identically with Next.js `useSearchParams()` or react-router's
+ * `useSearchParams()` — both return standard `URLSearchParams`.
+ */
+export function parseDraftParams(searchParams) {
+    const draftType = parseDraftType(searchParams.get("draft"));
+    if (!draftType)
+        return null;
+    const editOrg = searchParams.get("editOrg");
+    const editSlug = searchParams.get("editSlug");
+    if (editOrg && editSlug) {
+        return { draftType, editRef: { org: editOrg, slug: editSlug } };
+    }
+    return { draftType };
+}
+//# sourceMappingURL=draft.js.map

package/session/draft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"draft.js","sourceRoot":"","sources":["../../src/session/draft.ts"],"names":[],"mappings":"AA+BA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAA2C;IACpE,KAAK,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE;IAChD,KAAK,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE;IAChD,YAAY,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,oBAAoB,EAAE;CAC7D,CAAC;AAEF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;AAEjE;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAoB;IACjD,IAAI,KAAK,KAAK,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7C,OAAO,KAA0B,CAAC;IACpC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAC9B,YAA6B;IAE7B,MAAM,SAAS,GAAG,cAAc,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5D,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAE5B,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAE9C,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;QACxB,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;IAClE,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,CAAC;AACvB,CAAC"}

package/session/index.d.ts

@@ -18,6 +18,16 @@ export { useSessionUsage } from "./useSessionUsage";
 export type { ModelCostEntry, UseSessionUsageReturn, } from "./useSessionUsage";
 export { useAgentRefFromSession } from "./useAgentRefFromSession";
 export type { UseAgentRefFromSessionReturn } from "./useAgentRefFromSession";
+export { useNewSessionFlow } from "./useNewSessionFlow";
+export type { UseNewSessionFlowOptions, UseNewSessionFlowReturn, } from "./useNewSessionFlow";
+export { useSessionPageFlow } from "./useSessionPageFlow";
+export type { UseSessionPageFlowOptions, UseSessionPageFlowReturn, } from "./useSessionPageFlow";
+export { usePersistedModel } from "./usePersistedModel";
+export type { UsePersistedModelReturn } from "./usePersistedModel";
+export { useEditSessionPrep } from "./useEditSessionPrep";
+export type { UseEditSessionPrepReturn } from "./useEditSessionPrep";
+export { CREATOR_AGENTS, parseDraftType, parseDraftParams, } from "./draft";
+export type { DraftResourceType, DraftParams, } from "./draft";
 export { groupSessionsByTime } from "./group-sessions";
 export type { SessionGroup } from "./group-sessions";
 export { PENDING_SUBJECT, resolvedSubject } from "@stigmer/sdk";

package/session/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAEzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EACV,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EACV,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EACV,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,cAAc,EACd,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAE7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAEzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EACV,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EACV,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EACV,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EACV,cAAc,EACd,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAE7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EACV,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EACV,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAErE,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,GACjB,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,iBAAiB,EACjB,WAAW,GACZ,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/session/index.js

@@ -8,6 +8,11 @@ export { useSessionArtifacts } from "./useSessionArtifacts";
 export { useSessionWriteBacks } from "./useSessionWriteBacks";
 export { useSessionUsage } from "./useSessionUsage";
 export { useAgentRefFromSession } from "./useAgentRefFromSession";
+export { useNewSessionFlow } from "./useNewSessionFlow";
+export { useSessionPageFlow } from "./useSessionPageFlow";
+export { usePersistedModel } from "./usePersistedModel";
+export { useEditSessionPrep } from "./useEditSessionPrep";
+export { CREATOR_AGENTS, parseDraftType, parseDraftParams, } from "./draft";
 export { groupSessionsByTime } from "./group-sessions";
 // Session utilities (re-exported from @stigmer/sdk)
 export { PENDING_SUBJECT, resolvedSubject } from "@stigmer/sdk";

package/session/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAQtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMlD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAMlE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAM5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAM9D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD,oDAAoD;AACpD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAQtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMlD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAMlE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAM5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAM9D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAMxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAM1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAMjB,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD,oDAAoD;AACpD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/session/useCreateSession.d.ts

@@ -11,6 +11,14 @@ export interface SharedSessionFields {
     readonly mcpServerUsages?: McpServerUsageInput[];
     /** Skill references to enable for executions in this session. */
     readonly skillRefs?: ResourceRef[];
+    /**
+     * Runner to bind this session to.
+     *
+     * When set, all executions in the session are routed to this runner's
+     * task queue. When omitted, the backend auto-selects a runner (session
+     * auto-bind in OSS, cloud auto-provisioning in Cloud).
+     */
+    readonly runnerId?: string;
 }
 /**
  * Input for creating a session. Exactly one agent resolution strategy

package/session/useCreateSession.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCreateSession.d.ts","sourceRoot":"","sources":["../../src/session/useCreateSession.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACzB,MAAM,cAAc,CAAC;AAItB,4EAA4E;AAC5E,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAClD,oEAAoE;IACpE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,eAAe,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACjD,iEAAiE;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;CACpC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,GAClD,CACI;IACE,+DAA+D;IAC/D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;CAC3B,GACD;IACE,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,qEAAqE;IACrE,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC;CAClC,CACJ,CAAC;AAEJ,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,gDAAgD;AAChD,MAAM,WAAW,sBAAsB;IACrC,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC7E,gDAAgD;IAChD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,uCAAuC;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,gBAAgB,IAAI,sBAAsB,CA0DzD"}
+{"version":3,"file":"useCreateSession.d.ts","sourceRoot":"","sources":["../../src/session/useCreateSession.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACzB,MAAM,cAAc,CAAC;AAItB,4EAA4E;AAC5E,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAClD,oEAAoE;IACpE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,eAAe,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACjD,iEAAiE;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,GAClD,CACI;IACE,+DAA+D;IAC/D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;CAC3B,GACD;IACE,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,qEAAqE;IACrE,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC;CAClC,CACJ,CAAC;AAEJ,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,gDAAgD;AAChD,MAAM,WAAW,sBAAsB;IACrC,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC7E,gDAAgD;IAChD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,uCAAuC;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,gBAAgB,IAAI,sBAAsB,CA2DzD"}

package/session/useCreateSession.js

@@ -70,6 +70,7 @@ export function useCreateSession() {
                 workspaceEntries: input.workspaceEntries,
                 mcpServerUsages: input.mcpServerUsages,
                 skillRefs: input.skillRefs,
+                runnerId: input.runnerId,
                 agentInstanceId: resolvedInstanceId,
             });
             return { sessionId: session.metadata.id };

package/session/useCreateSession.js.map

@@ -1 +1 @@
-{"version":3,"file":"useCreateSession.js","sourceRoot":"","sources":["../../src/session/useCreateSession.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EACL,eAAe,GAIhB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AA8D9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,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,EAAgC,EAAE;QAChE,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,IAAI,kBAA0B,CAAC;YAE/B,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;gBAC1B,kBAAkB,GAAG,KAAK,CAAC,eAAe,CAAC;YAC7C,CAAC;iBAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAC1B,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBACjE,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,iBAAiB,CAAC;gBAElD,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,MAAM,IAAI,KAAK,CACb,UAAU,KAAK,CAAC,QAAQ,CAAC,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,sCAAsC;wBACvF,2CAA2C,CAC9C,CAAC;gBACJ,CAAC;gBAED,kBAAkB,GAAG,SAAS,CAAC;YACjC,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CACb,gEAAgE;oBAC9D,6DAA6D,CAChE,CAAC;YACJ,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;gBAC3C,IAAI,EAAE,WAAW,IAAI,CAAC,GAAG,EAAE,EAAE;gBAC7B,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,eAAe;gBACzC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;gBACxC,eAAe,EAAE,KAAK,CAAC,eAAe;gBACtC,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,eAAe,EAAE,kBAAkB;aACpC,CAAC,CAAC;YAEH,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,QAAS,CAAC,EAAE,EAAE,CAAC;QAC7C,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"}
+{"version":3,"file":"useCreateSession.js","sourceRoot":"","sources":["../../src/session/useCreateSession.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EACL,eAAe,GAIhB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAsE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,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,EAAgC,EAAE;QAChE,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,IAAI,kBAA0B,CAAC;YAE/B,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;gBAC1B,kBAAkB,GAAG,KAAK,CAAC,eAAe,CAAC;YAC7C,CAAC;iBAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAC1B,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBACjE,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,iBAAiB,CAAC;gBAElD,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,MAAM,IAAI,KAAK,CACb,UAAU,KAAK,CAAC,QAAQ,CAAC,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,sCAAsC;wBACvF,2CAA2C,CAC9C,CAAC;gBACJ,CAAC;gBAED,kBAAkB,GAAG,SAAS,CAAC;YACjC,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CACb,gEAAgE;oBAC9D,6DAA6D,CAChE,CAAC;YACJ,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;gBAC3C,IAAI,EAAE,WAAW,IAAI,CAAC,GAAG,EAAE,EAAE;gBAC7B,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,eAAe;gBACzC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;gBACxC,eAAe,EAAE,KAAK,CAAC,eAAe;gBACtC,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,eAAe,EAAE,kBAAkB;aACpC,CAAC,CAAC;YAEH,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,QAAS,CAAC,EAAE,EAAE,CAAC;QAC7C,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/session/useEditSessionPrep.d.ts

@@ -0,0 +1,26 @@
+import type { DraftResourceType } from "./draft";
+/** Return value of {@link useEditSessionPrep}. */
+export interface UseEditSessionPrepReturn {
+    /** Files ready to be passed as `initialAttachments` to SessionComposer. */
+    readonly files: File[] | undefined;
+    /** Non-null when resource fetch or serialization failed. */
+    readonly error: string | null;
+}
+/**
+ * Prepares initial attachment files for an edit-mode draft session.
+ *
+ * Given a resource type and an org/slug reference, this hook fetches the
+ * existing resource and serializes it into a `File` object suitable for
+ * the `initialAttachments` prop of `SessionComposer`:
+ *
+ * - **agent** / **mcp-server**: serialized to YAML
+ * - **skill**: downloaded as a ZIP package
+ *
+ * Pass `null` for `draftType` or `editRef` to skip preparation (used
+ * when the session is in create-mode rather than edit-mode).
+ */
+export declare function useEditSessionPrep(draftType: DraftResourceType | null, editRef: {
+    readonly org: string;
+    readonly slug: string;
+} | null): UseEditSessionPrepReturn;
+//# sourceMappingURL=useEditSessionPrep.d.ts.map

package/session/useEditSessionPrep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEditSessionPrep.d.ts","sourceRoot":"","sources":["../../src/session/useEditSessionPrep.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,kDAAkD;AAClD,MAAM,WAAW,wBAAwB;IACvC,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC;IACnC,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,iBAAiB,GAAG,IAAI,EACnC,OAAO,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAC9D,wBAAwB,CA0E1B"}

package/session/useEditSessionPrep.js

@@ -0,0 +1,83 @@
+"use client";
+import { useEffect, useRef, useState } from "react";
+import { create } from "@bufbuild/protobuf";
+import { GetArtifactRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/io_pb";
+import { useStigmer } from "../hooks";
+import { useAgent } from "../agent";
+import { useMcpServer } from "../mcp-server";
+import { useSkill } from "../skill";
+import { serializeAgentYaml, serializeMcpServerYaml } from "../library";
+/**
+ * Prepares initial attachment files for an edit-mode draft session.
+ *
+ * Given a resource type and an org/slug reference, this hook fetches the
+ * existing resource and serializes it into a `File` object suitable for
+ * the `initialAttachments` prop of `SessionComposer`:
+ *
+ * - **agent** / **mcp-server**: serialized to YAML
+ * - **skill**: downloaded as a ZIP package
+ *
+ * Pass `null` for `draftType` or `editRef` to skip preparation (used
+ * when the session is in create-mode rather than edit-mode).
+ */
+export function useEditSessionPrep(draftType, editRef) {
+    const stigmer = useStigmer();
+    const editOrg = editRef?.org ?? null;
+    const editSlug = editRef?.slug ?? null;
+    const { agent: editAgent } = useAgent(draftType === "agent" ? editOrg : null, draftType === "agent" ? editSlug : null);
+    const { mcpServer: editMcpServer } = useMcpServer(draftType === "mcp-server" ? editOrg : null, draftType === "mcp-server" ? editSlug : null);
+    const { skill: editSkill } = useSkill(draftType === "skill" ? editOrg : null, draftType === "skill" ? editSlug : null);
+    const [files, setFiles] = useState(undefined);
+    const [error, setError] = useState(null);
+    const built = useRef(false);
+    useEffect(() => {
+        if (built.current)
+            return;
+        if (draftType === "agent" && editAgent) {
+            built.current = true;
+            try {
+                const yaml = serializeAgentYaml(editAgent);
+                const slug = editAgent.metadata?.slug ?? "agent";
+                setFiles([new File([yaml], `${slug}.yaml`, { type: "text/yaml" })]);
+            }
+            catch {
+                setError("Failed to serialize agent for editing");
+            }
+        }
+        if (draftType === "mcp-server" && editMcpServer) {
+            built.current = true;
+            try {
+                const yaml = serializeMcpServerYaml(editMcpServer);
+                const slug = editMcpServer.metadata?.slug ?? "mcp-server";
+                setFiles([new File([yaml], `${slug}.yaml`, { type: "text/yaml" })]);
+            }
+            catch {
+                setError("Failed to serialize MCP server for editing");
+            }
+        }
+    }, [draftType, editAgent, editMcpServer]);
+    useEffect(() => {
+        if (built.current)
+            return;
+        if (draftType !== "skill" || !editSkill)
+            return;
+        const storageKey = editSkill.status?.artifactStorageKey;
+        if (!storageKey)
+            return;
+        built.current = true;
+        const slug = editSkill.metadata?.slug ?? "skill";
+        stigmer.skill
+            .getArtifact(create(GetArtifactRequestSchema, { artifactStorageKey: storageKey }))
+            .then((resp) => {
+            const buf = new ArrayBuffer(resp.artifact.byteLength);
+            new Uint8Array(buf).set(resp.artifact);
+            const blob = new Blob([buf], { type: "application/zip" });
+            setFiles([new File([blob], `${slug}.zip`, { type: "application/zip" })]);
+        })
+            .catch(() => {
+            setError("Failed to download skill package for editing");
+        });
+    }, [draftType, editSkill, stigmer]);
+    return { files, error };
+}
+//# sourceMappingURL=useEditSessionPrep.js.map