@stigmer/react 0.0.92 → 0.0.94

package/runner/__tests__/useLaunchLocalRunner.test.js

@@ -0,0 +1,143 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { renderHook, act } from "@testing-library/react";
+import { create } from "@bufbuild/protobuf";
+import { timestampFromDate } from "@bufbuild/protobuf/wkt";
+import { CreateLaunchTokenResponseSchema } from "@stigmer/protos/ai/stigmer/agentic/runner/v1/io_pb";
+import { StigmerContext } from "../../context";
+import { useLaunchLocalRunner } from "../useLaunchLocalRunner";
+function buildMockClient(overrides = {}) {
+    return {
+        runner: {
+            createLaunchToken: overrides.createLaunchToken ?? vi.fn(),
+        },
+    };
+}
+function makeWrapper(client) {
+    return ({ children }) => (_jsx(StigmerContext.Provider, { value: client, children: children }));
+}
+describe("useLaunchLocalRunner", () => {
+    const ORG = "test-org";
+    let createLaunchToken;
+    let client;
+    beforeEach(() => {
+        createLaunchToken = vi.fn();
+        client = buildMockClient({ createLaunchToken });
+    });
+    it("creates a token and opens the stigmer:// URL on success", async () => {
+        const response = create(CreateLaunchTokenResponseSchema, {
+            token: "tok_abc123",
+            expiresAt: timestampFromDate(new Date()),
+        });
+        createLaunchToken.mockResolvedValueOnce(response);
+        const openUrl = vi.fn();
+        const { result } = renderHook(() => useLaunchLocalRunner({ openUrl }), { wrapper: makeWrapper(client) });
+        expect(result.current.isLaunching).toBe(false);
+        expect(result.current.error).toBeNull();
+        let launchResult;
+        await act(async () => {
+            launchResult = await result.current.launch({ org: ORG });
+        });
+        expect(createLaunchToken).toHaveBeenCalledOnce();
+        expect(openUrl).toHaveBeenCalledOnce();
+        expect(openUrl).toHaveBeenCalledWith(`stigmer://launch-runner?token=${encodeURIComponent("tok_abc123")}`);
+        expect(launchResult.url).toBe(`stigmer://launch-runner?token=${encodeURIComponent("tok_abc123")}`);
+        expect(launchResult.expiresAt).toBeInstanceOf(Date);
+        expect(result.current.isLaunching).toBe(false);
+        expect(result.current.error).toBeNull();
+    });
+    it("URL-encodes tokens with special characters", async () => {
+        const response = create(CreateLaunchTokenResponseSchema, {
+            token: "tok/with+special=chars&more",
+        });
+        createLaunchToken.mockResolvedValueOnce(response);
+        const openUrl = vi.fn();
+        const { result } = renderHook(() => useLaunchLocalRunner({ openUrl }), { wrapper: makeWrapper(client) });
+        await act(async () => {
+            await result.current.launch({ org: ORG });
+        });
+        const url = openUrl.mock.calls[0][0];
+        expect(url).toContain(encodeURIComponent("tok/with+special=chars&more"));
+        expect(url).not.toContain("&more");
+    });
+    it("uses the custom openUrl callback", async () => {
+        const response = create(CreateLaunchTokenResponseSchema, {
+            token: "tok_custom",
+        });
+        createLaunchToken.mockResolvedValueOnce(response);
+        const customOpen = vi.fn();
+        const { result } = renderHook(() => useLaunchLocalRunner({ openUrl: customOpen }), { wrapper: makeWrapper(client) });
+        await act(async () => {
+            await result.current.launch({ org: ORG });
+        });
+        expect(customOpen).toHaveBeenCalledOnce();
+        expect(customOpen.mock.calls[0][0]).toMatch(/^stigmer:\/\//);
+    });
+    it("returns undefined expiresAt when the server omits it", async () => {
+        const response = create(CreateLaunchTokenResponseSchema, {
+            token: "tok_no_expiry",
+        });
+        createLaunchToken.mockResolvedValueOnce(response);
+        const openUrl = vi.fn();
+        const { result } = renderHook(() => useLaunchLocalRunner({ openUrl }), { wrapper: makeWrapper(client) });
+        let launchResult;
+        await act(async () => {
+            launchResult = await result.current.launch({ org: ORG });
+        });
+        expect(launchResult.expiresAt).toBeUndefined();
+    });
+    it("sets error and rethrows when createLaunchToken fails", async () => {
+        const rpcError = new Error("token creation failed");
+        createLaunchToken.mockRejectedValueOnce(rpcError);
+        const openUrl = vi.fn();
+        const { result } = renderHook(() => useLaunchLocalRunner({ openUrl }), { wrapper: makeWrapper(client) });
+        await act(async () => {
+            await expect(result.current.launch({ org: ORG })).rejects.toThrow("token creation failed");
+        });
+        expect(result.current.error).toBeInstanceOf(Error);
+        expect(result.current.error.message).toBe("token creation failed");
+        expect(result.current.isLaunching).toBe(false);
+        expect(openUrl).not.toHaveBeenCalled();
+    });
+    it("handles non-Error rejection values", async () => {
+        createLaunchToken.mockRejectedValueOnce("string error");
+        const openUrl = vi.fn();
+        const { result } = renderHook(() => useLaunchLocalRunner({ openUrl }), { wrapper: makeWrapper(client) });
+        await act(async () => {
+            await expect(result.current.launch({ org: ORG })).rejects.toBe("string error");
+        });
+        expect(result.current.error).toBeInstanceOf(Error);
+        expect(result.current.error.message).toBe("string error");
+    });
+    it("clears error via clearError", async () => {
+        createLaunchToken.mockRejectedValueOnce(new Error("fail"));
+        const openUrl = vi.fn();
+        const { result } = renderHook(() => useLaunchLocalRunner({ openUrl }), { wrapper: makeWrapper(client) });
+        await act(async () => {
+            await result.current.launch({ org: ORG }).catch(() => { });
+        });
+        expect(result.current.error).not.toBeNull();
+        act(() => {
+            result.current.clearError();
+        });
+        expect(result.current.error).toBeNull();
+    });
+    it("resets previous error on a new successful launch", async () => {
+        createLaunchToken.mockRejectedValueOnce(new Error("first fail"));
+        const openUrl = vi.fn();
+        const { result } = renderHook(() => useLaunchLocalRunner({ openUrl }), { wrapper: makeWrapper(client) });
+        await act(async () => {
+            await result.current.launch({ org: ORG }).catch(() => { });
+        });
+        expect(result.current.error).not.toBeNull();
+        const response = create(CreateLaunchTokenResponseSchema, {
+            token: "tok_retry",
+        });
+        createLaunchToken.mockResolvedValueOnce(response);
+        await act(async () => {
+            await result.current.launch({ org: ORG });
+        });
+        expect(result.current.error).toBeNull();
+    });
+});
+//# sourceMappingURL=useLaunchLocalRunner.test.js.map

package/runner/__tests__/useLaunchLocalRunner.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLaunchLocalRunner.test.js","sourceRoot":"","sources":["../../../src/runner/__tests__/useLaunchLocalRunner.test.tsx"],"names":[],"mappings":"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"}

package/runner/__tests__/useStopRunner.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useStopRunner.test.d.ts.map

package/runner/__tests__/useStopRunner.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStopRunner.test.d.ts","sourceRoot":"","sources":["../../../src/runner/__tests__/useStopRunner.test.tsx"],"names":[],"mappings":""}

package/runner/__tests__/useStopRunner.test.js

@@ -0,0 +1,114 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { renderHook, act } from "@testing-library/react";
+import { create } from "@bufbuild/protobuf";
+import { RunnerSchema, RunnerStatusSchema, } from "@stigmer/protos/ai/stigmer/agentic/runner/v1/api_pb";
+import { RunnerPhase } from "@stigmer/protos/ai/stigmer/agentic/runner/v1/enum_pb";
+import { ApiResourceMetadataSchema } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
+import { StigmerContext } from "../../context";
+import { useStopRunner } from "../useStopRunner";
+function makeRunner(id, phase) {
+    const runner = create(RunnerSchema);
+    runner.metadata = create(ApiResourceMetadataSchema);
+    runner.metadata.id = id;
+    runner.status = create(RunnerStatusSchema);
+    runner.status.phase = phase;
+    return runner;
+}
+function buildMockClient(overrides = {}) {
+    return {
+        runner: {
+            stop: overrides.stop ?? vi.fn(),
+        },
+    };
+}
+function makeWrapper(client) {
+    return ({ children }) => (_jsx(StigmerContext.Provider, { value: client, children: children }));
+}
+describe("useStopRunner", () => {
+    let stopMock;
+    let client;
+    beforeEach(() => {
+        stopMock = vi.fn();
+        client = buildMockClient({ stop: stopMock });
+    });
+    it("calls runner.stop with correct proto message and returns the runner", async () => {
+        const stoppedRunner = makeRunner("rnr_1", RunnerPhase.STOPPED);
+        stopMock.mockResolvedValueOnce(stoppedRunner);
+        const { result } = renderHook(() => useStopRunner(), {
+            wrapper: makeWrapper(client),
+        });
+        expect(result.current.isStopping).toBe(false);
+        expect(result.current.error).toBeNull();
+        let returned;
+        await act(async () => {
+            returned = await result.current.stop({
+                runnerId: "rnr_1",
+                reason: "user requested",
+            });
+        });
+        expect(stopMock).toHaveBeenCalledOnce();
+        const protoArg = stopMock.mock.calls[0][0];
+        expect(protoArg.runnerId).toBe("rnr_1");
+        expect(protoArg.reason).toBe("user requested");
+        expect(returned).toBe(stoppedRunner);
+        expect(result.current.isStopping).toBe(false);
+        expect(result.current.error).toBeNull();
+    });
+    it("defaults reason to empty string when omitted", async () => {
+        const stoppedRunner = makeRunner("rnr_2", RunnerPhase.STOPPED);
+        stopMock.mockResolvedValueOnce(stoppedRunner);
+        const { result } = renderHook(() => useStopRunner(), {
+            wrapper: makeWrapper(client),
+        });
+        await act(async () => {
+            await result.current.stop({ runnerId: "rnr_2" });
+        });
+        const protoArg = stopMock.mock.calls[0][0];
+        expect(protoArg.reason).toBe("");
+    });
+    it("sets error and rethrows on failure", async () => {
+        const rpcError = new Error("runner not found");
+        stopMock.mockRejectedValueOnce(rpcError);
+        const { result } = renderHook(() => useStopRunner(), {
+            wrapper: makeWrapper(client),
+        });
+        await act(async () => {
+            await expect(result.current.stop({ runnerId: "rnr_missing" })).rejects.toThrow("runner not found");
+        });
+        expect(result.current.error).toBeInstanceOf(Error);
+        expect(result.current.error.message).toBe("runner not found");
+        expect(result.current.isStopping).toBe(false);
+    });
+    it("clears error via clearError", async () => {
+        stopMock.mockRejectedValueOnce(new Error("fail"));
+        const { result } = renderHook(() => useStopRunner(), {
+            wrapper: makeWrapper(client),
+        });
+        await act(async () => {
+            await result.current.stop({ runnerId: "rnr_1" }).catch(() => { });
+        });
+        expect(result.current.error).not.toBeNull();
+        act(() => {
+            result.current.clearError();
+        });
+        expect(result.current.error).toBeNull();
+    });
+    it("resets previous error on a new successful stop", async () => {
+        stopMock.mockRejectedValueOnce(new Error("first fail"));
+        const { result } = renderHook(() => useStopRunner(), {
+            wrapper: makeWrapper(client),
+        });
+        await act(async () => {
+            await result.current.stop({ runnerId: "rnr_1" }).catch(() => { });
+        });
+        expect(result.current.error).not.toBeNull();
+        const stoppedRunner = makeRunner("rnr_1", RunnerPhase.STOPPED);
+        stopMock.mockResolvedValueOnce(stoppedRunner);
+        await act(async () => {
+            await result.current.stop({ runnerId: "rnr_1" });
+        });
+        expect(result.current.error).toBeNull();
+    });
+});
+//# sourceMappingURL=useStopRunner.test.js.map

package/runner/__tests__/useStopRunner.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStopRunner.test.js","sourceRoot":"","sources":["../../../src/runner/__tests__/useStopRunner.test.tsx"],"names":[],"mappings":"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"}

package/runner/index.d.ts

@@ -0,0 +1,14 @@
+export { useRunnerList } from "./useRunnerList";
+export type { UseRunnerListOptions, UseRunnerListReturn, } from "./useRunnerList";
+export { useLaunchLocalRunner } from "./useLaunchLocalRunner";
+export type { UseLaunchLocalRunnerOptions, UseLaunchLocalRunnerReturn, LaunchLocalRunnerResult, } from "./useLaunchLocalRunner";
+export { useStopRunner } from "./useStopRunner";
+export type { StopRunnerInput, UseStopRunnerReturn, } from "./useStopRunner";
+export { useDeleteRunner } from "./useDeleteRunner";
+export type { UseDeleteRunnerReturn } from "./useDeleteRunner";
+export { RunnerPicker } from "./RunnerPicker";
+export type { RunnerPickerProps } from "./RunnerPicker";
+export { RunnerListPanel } from "./RunnerListPanel";
+export type { RunnerListPanelProps } from "./RunnerListPanel";
+export { phaseLabel, phaseDotColor, isActivePhase, PHASE_SORT_ORDER, } from "./phase";
+//# sourceMappingURL=index.d.ts.map

package/runner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runner/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EACV,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EACV,2BAA2B,EAC3B,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EACV,eAAe,EACf,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EACL,UAAU,EACV,aAAa,EACb,aAAa,EACb,gBAAgB,GACjB,MAAM,SAAS,CAAC"}

package/runner/index.js

@@ -0,0 +1,8 @@
+export { useRunnerList } from "./useRunnerList";
+export { useLaunchLocalRunner } from "./useLaunchLocalRunner";
+export { useStopRunner } from "./useStopRunner";
+export { useDeleteRunner } from "./useDeleteRunner";
+export { RunnerPicker } from "./RunnerPicker";
+export { RunnerListPanel } from "./RunnerListPanel";
+export { phaseLabel, phaseDotColor, isActivePhase, PHASE_SORT_ORDER, } from "./phase";
+//# sourceMappingURL=index.js.map

package/runner/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runner/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAO9D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMhD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EACL,UAAU,EACV,aAAa,EACb,aAAa,EACb,gBAAgB,GACjB,MAAM,SAAS,CAAC"}

package/runner/phase.d.ts

@@ -0,0 +1,30 @@
+import { RunnerPhase } from "@stigmer/protos/ai/stigmer/agentic/runner/v1/enum_pb";
+/**
+ * Sort order for runner phases — active phases first, then by severity.
+ *
+ * Used by both {@link RunnerPicker} and {@link RunnerListPanel} to present
+ * runners in a consistent, predictable order across all UI surfaces.
+ */
+export declare const PHASE_SORT_ORDER: Record<RunnerPhase, number>;
+/**
+ * Human-readable label for a runner phase.
+ *
+ * Returns title-case labels suitable for both compact indicators
+ * ("Ready") and full-row display ("Stopped").
+ */
+export declare function phaseLabel(phase: RunnerPhase): string;
+/**
+ * Tailwind `bg-*` class for the small colored dot indicator.
+ *
+ * - Ready  → `bg-success`  (green)
+ * - Busy   → `bg-warning`  (amber)
+ * - Others → `bg-muted-foreground` (neutral)
+ */
+export declare function phaseDotColor(phase: RunnerPhase): string;
+/**
+ * Whether the runner is in an active (workload-accepting) phase.
+ *
+ * Active = `READY` or `BUSY`. Inactive = everything else.
+ */
+export declare function isActivePhase(phase: RunnerPhase): boolean;
+//# sourceMappingURL=phase.d.ts.map

package/runner/phase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase.d.ts","sourceRoot":"","sources":["../../src/runner/phase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sDAAsD,CAAC;AAEnF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAOxD,CAAC;AAWF;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAErD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CASxD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAEzD"}

package/runner/phase.js

@@ -0,0 +1,58 @@
+import { RunnerPhase } from "@stigmer/protos/ai/stigmer/agentic/runner/v1/enum_pb";
+/**
+ * Sort order for runner phases — active phases first, then by severity.
+ *
+ * Used by both {@link RunnerPicker} and {@link RunnerListPanel} to present
+ * runners in a consistent, predictable order across all UI surfaces.
+ */
+export const PHASE_SORT_ORDER = {
+    [RunnerPhase.READY]: 0,
+    [RunnerPhase.BUSY]: 1,
+    [RunnerPhase.PENDING]: 2,
+    [RunnerPhase.STOPPED]: 3,
+    [RunnerPhase.FAILED]: 4,
+    [RunnerPhase.UNSPECIFIED]: 5,
+};
+const LABELS = {
+    [RunnerPhase.READY]: "Ready",
+    [RunnerPhase.BUSY]: "Busy",
+    [RunnerPhase.PENDING]: "Pending",
+    [RunnerPhase.STOPPED]: "Stopped",
+    [RunnerPhase.FAILED]: "Failed",
+    [RunnerPhase.UNSPECIFIED]: "Unknown",
+};
+/**
+ * Human-readable label for a runner phase.
+ *
+ * Returns title-case labels suitable for both compact indicators
+ * ("Ready") and full-row display ("Stopped").
+ */
+export function phaseLabel(phase) {
+    return LABELS[phase] ?? "Unknown";
+}
+/**
+ * Tailwind `bg-*` class for the small colored dot indicator.
+ *
+ * - Ready  → `bg-success`  (green)
+ * - Busy   → `bg-warning`  (amber)
+ * - Others → `bg-muted-foreground` (neutral)
+ */
+export function phaseDotColor(phase) {
+    switch (phase) {
+        case RunnerPhase.READY:
+            return "bg-success";
+        case RunnerPhase.BUSY:
+            return "bg-warning";
+        default:
+            return "bg-muted-foreground";
+    }
+}
+/**
+ * Whether the runner is in an active (workload-accepting) phase.
+ *
+ * Active = `READY` or `BUSY`. Inactive = everything else.
+ */
+export function isActivePhase(phase) {
+    return phase === RunnerPhase.READY || phase === RunnerPhase.BUSY;
+}
+//# sourceMappingURL=phase.js.map

package/runner/phase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase.js","sourceRoot":"","sources":["../../src/runner/phase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sDAAsD,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAgC;IAC3D,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;IACtB,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;IACrB,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;IACxB,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;IACxB,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;IACvB,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,GAAgC;IAC1C,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,OAAO;IAC5B,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM;IAC1B,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,SAAS;IAChC,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,SAAS;IAChC,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,QAAQ;IAC9B,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,SAAS;CACrC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,KAAkB;IAC3C,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC;AACpC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,KAAkB;IAC9C,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,WAAW,CAAC,KAAK;YACpB,OAAO,YAAY,CAAC;QACtB,KAAK,WAAW,CAAC,IAAI;YACnB,OAAO,YAAY,CAAC;QACtB;YACE,OAAO,qBAAqB,CAAC;IACjC,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAkB;IAC9C,OAAO,KAAK,KAAK,WAAW,CAAC,KAAK,IAAI,KAAK,KAAK,WAAW,CAAC,IAAI,CAAC;AACnE,CAAC"}

package/runner/useDeleteRunner.d.ts

@@ -0,0 +1,36 @@
+import type { Runner } from "@stigmer/protos/ai/stigmer/agentic/runner/v1/api_pb";
+/** Return value of {@link useDeleteRunner}. */
+export interface UseDeleteRunnerReturn {
+    /**
+     * Delete a runner by its resource ID. Resolves with the deleted
+     * {@link Runner} for confirmation display.
+     *
+     * The deletion is permanent — any sessions bound to this runner will
+     * fall back to auto-provisioning on their next execution.
+     */
+    readonly deleteRunner: (id: string) => Promise<Runner>;
+    /** `true` while the delete request is in flight. */
+    readonly isDeleting: boolean;
+    /** Error from the last failed delete, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Reset `error` to `null`. */
+    readonly clearError: () => void;
+}
+/**
+ * Mutation hook that wraps `runner.delete()` with loading and error
+ * state.
+ *
+ * Deletes a runner by its resource ID. Returns the deleted
+ * {@link Runner} on success so callers can confirm which runner was
+ * removed (e.g., in a toast or undo prompt).
+ *
+ * @example
+ * ```tsx
+ * const { deleteRunner, isDeleting, error } = useDeleteRunner();
+ *
+ * await deleteRunner("rnr_abc123");
+ * refetch(); // refresh the runner list
+ * ```
+ */
+export declare function useDeleteRunner(): UseDeleteRunnerReturn;
+//# sourceMappingURL=useDeleteRunner.d.ts.map

package/runner/useDeleteRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeleteRunner.d.ts","sourceRoot":"","sources":["../../src/runner/useDeleteRunner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qDAAqD,CAAC;AAIlF,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,IAAI,qBAAqB,CAyBvD"}

package/runner/useDeleteRunner.js

@@ -0,0 +1,42 @@
+"use client";
+import { useCallback, useState } from "react";
+import { useStigmer } from "../hooks";
+import { toError } from "../internal/toError";
+/**
+ * Mutation hook that wraps `runner.delete()` with loading and error
+ * state.
+ *
+ * Deletes a runner by its resource ID. Returns the deleted
+ * {@link Runner} on success so callers can confirm which runner was
+ * removed (e.g., in a toast or undo prompt).
+ *
+ * @example
+ * ```tsx
+ * const { deleteRunner, isDeleting, error } = useDeleteRunner();
+ *
+ * await deleteRunner("rnr_abc123");
+ * refetch(); // refresh the runner list
+ * ```
+ */
+export function useDeleteRunner() {
+    const stigmer = useStigmer();
+    const [isDeleting, setIsDeleting] = useState(false);
+    const [error, setError] = useState(null);
+    const clearError = useCallback(() => setError(null), []);
+    const deleteRunner = useCallback(async (id) => {
+        setIsDeleting(true);
+        setError(null);
+        try {
+            return await stigmer.runner.delete(id);
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsDeleting(false);
+        }
+    }, [stigmer]);
+    return { deleteRunner, isDeleting, error, clearError };
+}
+//# sourceMappingURL=useDeleteRunner.js.map

package/runner/useDeleteRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDeleteRunner.js","sourceRoot":"","sources":["../../src/runner/useDeleteRunner.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAoB9C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe;IAC7B,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,YAAY,GAAG,WAAW,CAC9B,KAAK,EAAE,EAAU,EAAmB,EAAE;QACpC,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzC,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,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AACzD,CAAC"}

package/runner/useLaunchLocalRunner.d.ts

@@ -0,0 +1,84 @@
+/** Options for {@link useLaunchLocalRunner}. */
+export interface UseLaunchLocalRunnerOptions {
+    /**
+     * Custom handler for opening the `stigmer://` URL.
+     *
+     * Defaults to `window.location.href` assignment, which is the standard
+     * browser pattern for dispatching custom URL schemes to the OS. The
+     * browser does not navigate away — it hands the scheme to the OS and
+     * the page stays on screen.
+     *
+     * Override this when embedding in non-standard environments (Electron,
+     * iframe, React Native WebView) where the default browser mechanism
+     * does not apply.
+     */
+    readonly openUrl?: (url: string) => void;
+}
+/** Result returned by a successful {@link UseLaunchLocalRunnerReturn.launch} call. */
+export interface LaunchLocalRunnerResult {
+    /** The `stigmer://launch-runner?token=...` URL that was opened. */
+    readonly url: string;
+    /**
+     * Absolute expiry time of the launch token. The desktop app must
+     * exchange the token before this time (typically 60 seconds).
+     */
+    readonly expiresAt: Date | undefined;
+}
+/** Return value of {@link useLaunchLocalRunner}. */
+export interface UseLaunchLocalRunnerReturn {
+    /**
+     * Create a one-time launch token and open the `stigmer://` URL to
+     * trigger the desktop app (or CLI fallback) to start a local runner.
+     *
+     * Resolves with the constructed URL and token expiry on success.
+     * The caller cannot detect whether the desktop app received the URL —
+     * use {@link useRunnerList} with `refetch()` to poll for the runner
+     * appearing in the list.
+     */
+    readonly launch: (input: {
+        org: string;
+    }) => Promise<LaunchLocalRunnerResult>;
+    /** `true` while the token creation and URL dispatch are in flight. */
+    readonly isLaunching: boolean;
+    /** Error from the last failed launch attempt, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Reset `error` to `null`. */
+    readonly clearError: () => void;
+}
+/**
+ * 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 declare function useLaunchLocalRunner(options?: UseLaunchLocalRunnerOptions): UseLaunchLocalRunnerReturn;
+//# sourceMappingURL=useLaunchLocalRunner.d.ts.map

package/runner/useLaunchLocalRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLaunchLocalRunner.d.ts","sourceRoot":"","sources":["../../src/runner/useLaunchLocalRunner.ts"],"names":[],"mappings":"AAeA,gDAAgD;AAChD,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAED,sFAAsF;AACtF,MAAM,WAAW,uBAAuB;IACtC,mEAAmE;IACnE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,SAAS,CAAC;CACtC;AAED,oDAAoD;AACpD,MAAM,WAAW,0BAA0B;IACzC;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC9E,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,CAAC,EAAE,2BAA2B,GACpC,0BAA0B,CAsC5B"}