@stigmer/react 3.5.2 → 3.6.0

package/schedule/scheduleState.js

@@ -0,0 +1,67 @@
+// Pure schedule-state derivation — the disabled-vs-paused vocabulary,
+// computed on read.
+//
+// A schedule that is not firing is stopped by one of two levers with two
+// different writers and two different remedies (the backend pins this
+// vocabulary in its controller docs):
+//
+//   - "disabled" — the OWNER's switch (`spec.enabled = false`), cleared
+//     by re-applying the manifest or the console's Enable action.
+//   - "paused" — the PLATFORM's failure-streak latch
+//     (`status.paused_reason` non-empty), cleared only by Resume.
+//
+// The console must never collapse these into one badge (stigmer/stigmer#352):
+// each state names its own remedy. When both levers are set, "disabled"
+// wins for display — the owner's intent dominates — but callers should
+// keep the paused reason visible alongside (the banner does).
+/**
+ * Derive a schedule's display state from its spec and status.
+ *
+ * A missing spec derives as "disabled" — the same fail-closed reading the
+ * server applies to a manifest that omits `enabled`.
+ */
+export function deriveScheduleState(spec, status) {
+    const isPaused = (status?.pausedReason ?? "") !== "";
+    if (!spec?.enabled) {
+        return { state: "disabled", phase: "disabled", label: "Disabled", isPaused };
+    }
+    if (isPaused) {
+        return { state: "paused", phase: "degraded", label: "Paused", isPaused };
+    }
+    return { state: "active", phase: "ready", label: "Active", isPaused };
+}
+/**
+ * Compact future-instant formatter for a schedule's next fire time:
+ * `now`, `in 5m`, `in 3h`, `in 6d`, then a short date once "days from
+ * now" stops being how people think about it.
+ *
+ * The schedule-local sibling of the activity module's past-only
+ * `formatRelativeTime` (same compact units, same date tail) — kept
+ * separate because that util's contract is deliberately past-only.
+ * A fire time slightly in the past (a tick mid-flight, clock skew)
+ * renders as `now` rather than a nonsense negative countdown.
+ *
+ * `now` is injected, never read from the live clock — required for
+ * deterministic tests and Scenar fixtures.
+ */
+export function formatNextFire(date, now) {
+    const deltaMs = date.getTime() - now.getTime();
+    if (deltaMs < 60_000)
+        return "now";
+    const minutes = Math.floor(deltaMs / 60_000);
+    if (minutes < 60)
+        return `in ${minutes}m`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `in ${hours}h`;
+    const days = Math.floor(hours / 24);
+    if (days < 7)
+        return `in ${days}d`;
+    const sameYear = date.getFullYear() === now.getFullYear();
+    return date.toLocaleDateString(undefined, {
+        month: "short",
+        day: "numeric",
+        ...(sameYear ? {} : { year: "numeric" }),
+    });
+}
+//# sourceMappingURL=scheduleState.js.map

package/schedule/scheduleState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduleState.js","sourceRoot":"","sources":["../../src/schedule/scheduleState.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,oBAAoB;AACpB,EAAE;AACF,yEAAyE;AACzE,sEAAsE;AACtE,sCAAsC;AACtC,EAAE;AACF,wEAAwE;AACxE,kEAAkE;AAClE,qDAAqD;AACrD,kEAAkE;AAClE,EAAE;AACF,8EAA8E;AAC9E,wEAAwE;AACxE,uEAAuE;AACvE,8DAA8D;AAyB9D;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAA8B,EAC9B,MAAkC;IAElC,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,YAAY,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;IAErD,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;IAC/E,CAAC;IACD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IAC3E,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AACxE,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAAC,IAAU,EAAE,GAAS;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;IAE/C,IAAI,OAAO,GAAG,MAAM;QAAE,OAAO,KAAK,CAAC;IAEnC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC;IAC7C,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,MAAM,OAAO,GAAG,CAAC;IAE1C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACvC,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,MAAM,KAAK,GAAG,CAAC;IAEtC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IACpC,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,MAAM,IAAI,GAAG,CAAC;IAEnC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,WAAW,EAAE,CAAC;IAC1D,OAAO,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE;QACxC,KAAK,EAAE,OAAO;QACd,GAAG,EAAE,SAAS;QACd,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KACzC,CAAC,CAAC;AACL,CAAC"}

package/schedule/useCreateSchedule.d.ts

@@ -0,0 +1,57 @@
+import type { ScheduleInput } from "@stigmer/sdk";
+import type { Schedule } from "@stigmer/protos/ai/stigmer/agentic/schedule/v1/api_pb";
+/** Return value of {@link useCreateSchedule}. */
+export interface UseCreateScheduleReturn {
+    /**
+     * Submit a {@link ScheduleInput} to create (or upsert) a schedule.
+     *
+     * Uses `stigmer.schedule.apply()` — the idempotent upsert operation.
+     * Resolves with the server-created `Schedule` proto including
+     * populated metadata (id, slug, audit timestamps) and the
+     * platform-computed `status.next_fire_at`.
+     */
+    readonly create: (input: ScheduleInput) => Promise<Schedule>;
+    /** `true` while the apply request is in flight. */
+    readonly isCreating: boolean;
+    /** Error from the last failed create, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Reset `error` to `null`. */
+    readonly clearError: () => void;
+}
+/**
+ * Behavior hook that wraps `schedule.apply()` with loading and error
+ * state.
+ *
+ * Creates a schedule from a {@link ScheduleInput}. Uses `apply()`
+ * (upsert) rather than `create()` so re-submissions are idempotent —
+ * matching the CLI's `stigmer apply` semantics and the established SDK
+ * mutation hook pattern (`isCreating` flag, `error` state, `clearError`
+ * reset, result returned from the promise, not stored in hook state).
+ *
+ * NOTE: this hook is for CREATION. Editing an existing schedule must
+ * NOT go through `ScheduleInput` — the input type cannot express every
+ * metadata field (tags, description), and the server replaces spec and
+ * mutable metadata wholesale on update, so a down-converting edit would
+ * silently wipe them. Edit flows use the full-proto path instead (see
+ * `useSetScheduleEnabled` for the pattern).
+ *
+ * @example
+ * ```tsx
+ * const { create, isCreating, error, clearError } = useCreateSchedule();
+ *
+ * const schedule = await create({
+ *   name: "daily-fee-reminders",
+ *   org: "acme",
+ *   cron: "0 9 * * *",
+ *   timeZone: "Asia/Kolkata",
+ *   enabled: false,
+ *   agent: {
+ *     agentRef: { org: "acme", slug: "billing-assistant" },
+ *     message: "Send today's fee reminders.",
+ *   },
+ * });
+ * // schedule.metadata?.slug → "daily-fee-reminders"
+ * ```
+ */
+export declare function useCreateSchedule(): UseCreateScheduleReturn;
+//# sourceMappingURL=useCreateSchedule.d.ts.map

package/schedule/useCreateSchedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCreateSchedule.d.ts","sourceRoot":"","sources":["../../src/schedule/useCreateSchedule.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uDAAuD,CAAC;AAItF,iDAAiD;AACjD,MAAM,WAAW,uBAAuB;IACtC;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7D,mDAAmD;IACnD,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,iBAAiB,IAAI,uBAAuB,CAyB3D"}

package/schedule/useCreateSchedule.js

@@ -0,0 +1,61 @@
+"use client";
+import { useCallback, useState } from "react";
+import { useStigmer } from "../hooks.js";
+import { toError } from "../internal/toError.js";
+/**
+ * Behavior hook that wraps `schedule.apply()` with loading and error
+ * state.
+ *
+ * Creates a schedule from a {@link ScheduleInput}. Uses `apply()`
+ * (upsert) rather than `create()` so re-submissions are idempotent —
+ * matching the CLI's `stigmer apply` semantics and the established SDK
+ * mutation hook pattern (`isCreating` flag, `error` state, `clearError`
+ * reset, result returned from the promise, not stored in hook state).
+ *
+ * NOTE: this hook is for CREATION. Editing an existing schedule must
+ * NOT go through `ScheduleInput` — the input type cannot express every
+ * metadata field (tags, description), and the server replaces spec and
+ * mutable metadata wholesale on update, so a down-converting edit would
+ * silently wipe them. Edit flows use the full-proto path instead (see
+ * `useSetScheduleEnabled` for the pattern).
+ *
+ * @example
+ * ```tsx
+ * const { create, isCreating, error, clearError } = useCreateSchedule();
+ *
+ * const schedule = await create({
+ *   name: "daily-fee-reminders",
+ *   org: "acme",
+ *   cron: "0 9 * * *",
+ *   timeZone: "Asia/Kolkata",
+ *   enabled: false,
+ *   agent: {
+ *     agentRef: { org: "acme", slug: "billing-assistant" },
+ *     message: "Send today's fee reminders.",
+ *   },
+ * });
+ * // schedule.metadata?.slug → "daily-fee-reminders"
+ * ```
+ */
+export function useCreateSchedule() {
+    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.schedule.apply(input);
+        }
+        catch (err) {
+            setError(toError(err));
+            throw err;
+        }
+        finally {
+            setIsCreating(false);
+        }
+    }, [stigmer]);
+    return { create, isCreating, error, clearError };
+}
+//# sourceMappingURL=useCreateSchedule.js.map

package/schedule/useCreateSchedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCreateSchedule.js","sourceRoot":"","sources":["../../src/schedule/useCreateSchedule.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAG9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAqBjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,UAAU,iBAAiB;IAC/B,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,KAAoB,EAAqB,EAAE;QAChD,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,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/schedule/useResumeSchedule.d.ts

@@ -0,0 +1,30 @@
+import type { Schedule } from "@stigmer/protos/ai/stigmer/agentic/schedule/v1/api_pb";
+/** Return value of {@link useResumeSchedule}. */
+export interface UseResumeScheduleReturn {
+    /**
+     * Clear the platform's failure-streak pause and let the schedule fire
+     * again. Resolves with the post-resume schedule; the caller refetches
+     * or replaces its local copy from it.
+     */
+    readonly resumeSchedule: (scheduleId: string) => Promise<Schedule>;
+    /** `true` while the resume request is in flight. */
+    readonly isResuming: boolean;
+    /** Error from the last failed resume, or `null` when healthy. */
+    readonly error: Error | null;
+}
+/**
+ * Behavior hook that resumes a platform-paused schedule.
+ *
+ * Resume is the ONE path that clears `status.paused_reason` (and the
+ * failure streak with it) — re-applying the manifest deliberately does
+ * not, so a routine GitOps apply can never silently un-pause a failing
+ * schedule. Resuming a schedule that is not paused is a server-side
+ * no-op; resuming a disabled schedule clears the pause but the schedule
+ * stays disabled (the owner's lever is separate — see
+ * {@link useSetScheduleEnabled}).
+ *
+ * Error toasts relay the server's message verbatim: the copy is
+ * identical across editions and states the remedy.
+ */
+export declare function useResumeSchedule(): UseResumeScheduleReturn;
+//# sourceMappingURL=useResumeSchedule.d.ts.map

package/schedule/useResumeSchedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResumeSchedule.d.ts","sourceRoot":"","sources":["../../src/schedule/useResumeSchedule.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uDAAuD,CAAC;AAMtF,iDAAiD;AACjD,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnE,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,IAAI,uBAAuB,CA6B3D"}

package/schedule/useResumeSchedule.js

@@ -0,0 +1,45 @@
+"use client";
+import { useCallback, useMemo, useState } from "react";
+import { getUserMessage } from "@stigmer/sdk";
+import { useStigmer } from "../hooks.js";
+import { toast } from "../feedback/toast.js";
+import { toError } from "../internal/toError.js";
+/**
+ * Behavior hook that resumes a platform-paused schedule.
+ *
+ * Resume is the ONE path that clears `status.paused_reason` (and the
+ * failure streak with it) — re-applying the manifest deliberately does
+ * not, so a routine GitOps apply can never silently un-pause a failing
+ * schedule. Resuming a schedule that is not paused is a server-side
+ * no-op; resuming a disabled schedule clears the pause but the schedule
+ * stays disabled (the owner's lever is separate — see
+ * {@link useSetScheduleEnabled}).
+ *
+ * Error toasts relay the server's message verbatim: the copy is
+ * identical across editions and states the remedy.
+ */
+export function useResumeSchedule() {
+    const stigmer = useStigmer();
+    const [isResuming, setIsResuming] = useState(false);
+    const [error, setError] = useState(null);
+    const resumeSchedule = useCallback(async (scheduleId) => {
+        setIsResuming(true);
+        setError(null);
+        try {
+            const resumed = await stigmer.schedule.resume(scheduleId);
+            toast.success("Schedule resumed");
+            return resumed;
+        }
+        catch (err) {
+            const wrapped = toError(err);
+            setError(wrapped);
+            toast.error(getUserMessage(err));
+            throw wrapped;
+        }
+        finally {
+            setIsResuming(false);
+        }
+    }, [stigmer]);
+    return useMemo(() => ({ resumeSchedule, isResuming, error }), [resumeSchedule, isResuming, error]);
+}
+//# sourceMappingURL=useResumeSchedule.js.map

package/schedule/useResumeSchedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResumeSchedule.js","sourceRoot":"","sources":["../../src/schedule/useResumeSchedule.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAgBjD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB;IAC/B,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,cAAc,GAAG,WAAW,CAChC,KAAK,EAAE,UAAkB,EAAqB,EAAE;QAC9C,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC1D,KAAK,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;YAClC,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YAC7B,QAAQ,CAAC,OAAO,CAAC,CAAC;YAClB,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;YACjC,MAAM,OAAO,CAAC;QAChB,CAAC;gBAAS,CAAC;YACT,aAAa,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC,EAAE,cAAc,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,EAC7C,CAAC,cAAc,EAAE,UAAU,EAAE,KAAK,CAAC,CACpC,CAAC;AACJ,CAAC"}

package/schedule/useSchedule.d.ts

@@ -0,0 +1,39 @@
+import type { Schedule } from "@stigmer/protos/ai/stigmer/agentic/schedule/v1/api_pb";
+/** Return value of {@link useSchedule}. */
+export interface UseScheduleReturn {
+    /** The resolved schedule, or `null` while loading, on error, or when not found. */
+    readonly schedule: Schedule | null;
+    /** `true` while the initial fetch is in flight. */
+    readonly isLoading: boolean;
+    /** `true` while a background refetch is in flight. */
+    readonly isRefetching: boolean;
+    /** Error from the last failed request, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Discard cached data and re-fetch the schedule from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches a single Schedule by organization and slug.
+ *
+ * Wraps `stigmer.schedule.getByReference()` with loading, error, and
+ * not-found state management. The loaded resource carries the spec
+ * (cron, time zone, enabled, target) and the platform-written status
+ * (`next_fire_at`, `last_fire_at`, `last_execution_id`,
+ * `consecutive_failures`, `paused_reason`) — everything the detail view
+ * renders, including the disabled-vs-paused distinction (see
+ * {@link deriveScheduleState}).
+ *
+ * Pass `null` for either `org` or `slug` to skip fetching (stable
+ * no-op).
+ *
+ * **Not-found handling:** a NOT_FOUND response sets `schedule` to
+ * `null` without raising an error; `schedule === null && !isLoading
+ * && !error` means the resource does not exist.
+ *
+ * @example
+ * ```tsx
+ * const { schedule, isLoading, error, refetch } = useSchedule("isc", "daily-fee-reminders");
+ * ```
+ */
+export declare function useSchedule(org: string | null, slug: string | null): UseScheduleReturn;
+//# sourceMappingURL=useSchedule.d.ts.map

package/schedule/useSchedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSchedule.d.ts","sourceRoot":"","sources":["../../src/schedule/useSchedule.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uDAAuD,CAAC;AAKtF,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IACnC,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,IAAI,EAAE,MAAM,GAAG,IAAI,GAClB,iBAAiB,CAmBnB"}

package/schedule/useSchedule.js

@@ -0,0 +1,44 @@
+"use client";
+import { isNotFound } from "@stigmer/sdk";
+import { useStigmer } from "../hooks.js";
+import { useFetch } from "../internal/useFetch.js";
+/**
+ * Data hook that fetches a single Schedule by organization and slug.
+ *
+ * Wraps `stigmer.schedule.getByReference()` with loading, error, and
+ * not-found state management. The loaded resource carries the spec
+ * (cron, time zone, enabled, target) and the platform-written status
+ * (`next_fire_at`, `last_fire_at`, `last_execution_id`,
+ * `consecutive_failures`, `paused_reason`) — everything the detail view
+ * renders, including the disabled-vs-paused distinction (see
+ * {@link deriveScheduleState}).
+ *
+ * Pass `null` for either `org` or `slug` to skip fetching (stable
+ * no-op).
+ *
+ * **Not-found handling:** a NOT_FOUND response sets `schedule` to
+ * `null` without raising an error; `schedule === null && !isLoading
+ * && !error` means the resource does not exist.
+ *
+ * @example
+ * ```tsx
+ * const { schedule, isLoading, error, refetch } = useSchedule("isc", "daily-fee-reminders");
+ * ```
+ */
+export function useSchedule(org, slug) {
+    const stigmer = useStigmer();
+    const { data: schedule, isLoading, isRefetching, error, refetch } = useFetch(org && slug
+        ? async () => {
+            try {
+                return await stigmer.schedule.getByReference({ org, slug });
+            }
+            catch (err) {
+                if (isNotFound(err))
+                    return null;
+                throw err;
+            }
+        }
+        : null, [org, slug, stigmer], null);
+    return { schedule, isLoading, isRefetching, error, refetch };
+}
+//# sourceMappingURL=useSchedule.js.map

package/schedule/useSchedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSchedule.js","sourceRoot":"","sources":["../../src/schedule/useSchedule.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAgBnD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,WAAW,CACzB,GAAkB,EAClB,IAAmB;IAEnB,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CAC1E,GAAG,IAAI,IAAI;QACT,CAAC,CAAC,KAAK,IAAI,EAAE;YACT,IAAI,CAAC;gBACH,OAAO,MAAM,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,UAAU,CAAC,GAAG,CAAC;oBAAE,OAAO,IAAI,CAAC;gBACjC,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;QACH,CAAC,CAAC,IAAI,EACR,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,EACpB,IAAI,CACL,CAAC;IAEF,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC/D,CAAC"}

package/schedule/useScheduleCount.d.ts

@@ -0,0 +1,38 @@
+/** Options for {@link useScheduleCount}. */
+export interface UseScheduleCountOptions {
+    /** Opaque token that forces a recount when its value changes. */
+    readonly refetchToken?: unknown;
+}
+/** Return value of {@link useScheduleCount}. */
+export interface UseScheduleCountReturn {
+    /**
+     * Total number of schedules in the organization. `undefined` until
+     * the first successful fetch completes.
+     */
+    readonly count: number | undefined;
+    /** `true` while the count fetch is in flight. */
+    readonly isLoading: boolean;
+    /** Error from the last failed request, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Discard cached data and re-fetch the count from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches the total count of an organization's schedules.
+ *
+ * Issues a minimal direct `listSchedules` call to retrieve only the
+ * total count. Useful for the Library landing card and dashboard
+ * widgets. There is no scope option: schedules are org-only.
+ *
+ * For the full paginated schedule list, use {@link useScheduleList}
+ * instead.
+ *
+ * Pass `null` as `org` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { count, isLoading } = useScheduleCount("isc");
+ * ```
+ */
+export declare function useScheduleCount(org: string | null, options?: UseScheduleCountOptions): UseScheduleCountReturn;
+//# sourceMappingURL=useScheduleCount.d.ts.map

package/schedule/useScheduleCount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScheduleCount.d.ts","sourceRoot":"","sources":["../../src/schedule/useScheduleCount.ts"],"names":[],"mappings":"AAOA,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB;IACtC,iEAAiE;IACjE,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,gDAAgD;AAChD,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,OAAO,CAAC,EAAE,uBAAuB,GAChC,sBAAsB,CAQxB"}

package/schedule/useScheduleCount.js

@@ -0,0 +1,30 @@
+"use client";
+import { useMemo } from "react";
+import { useStigmer } from "../hooks.js";
+import { useResourceCount } from "../search/index.js";
+import { createScheduleListFn } from "./scheduleListFn.js";
+/**
+ * Data hook that fetches the total count of an organization's schedules.
+ *
+ * Issues a minimal direct `listSchedules` call to retrieve only the
+ * total count. Useful for the Library landing card and dashboard
+ * widgets. There is no scope option: schedules are org-only.
+ *
+ * For the full paginated schedule list, use {@link useScheduleList}
+ * instead.
+ *
+ * Pass `null` as `org` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { count, isLoading } = useScheduleCount("isc");
+ * ```
+ */
+export function useScheduleCount(org, options) {
+    const stigmer = useStigmer();
+    const listFn = useMemo(() => createScheduleListFn(stigmer), [stigmer]);
+    return useResourceCount(listFn, org, {
+        refetchToken: options?.refetchToken,
+    });
+}
+//# sourceMappingURL=useScheduleCount.js.map

package/schedule/useScheduleCount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScheduleCount.js","sourceRoot":"","sources":["../../src/schedule/useScheduleCount.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAuB3D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAkB,EAClB,OAAiC;IAEjC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEvE,OAAO,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE;QACnC,YAAY,EAAE,OAAO,EAAE,YAAY;KACpC,CAAC,CAAC;AACL,CAAC"}

package/schedule/useScheduleList.d.ts

@@ -0,0 +1,48 @@
+import type { Schedule } from "@stigmer/protos/ai/stigmer/agentic/schedule/v1/api_pb";
+/** Options for {@link useScheduleList}. */
+export interface UseScheduleListOptions {
+    /** Maximum schedules per page. @default 20 */
+    readonly pageSize?: number;
+    /** Page number (1-indexed). @default 1 */
+    readonly page?: number;
+}
+/** Return value of {@link useScheduleList}. */
+export interface UseScheduleListReturn {
+    /** Full `Schedule` protos (spec + status) for the current page. */
+    readonly schedules: readonly Schedule[];
+    /** Total number of schedules in the organization. */
+    readonly totalCount: number;
+    /** Total pages available at the current page size. */
+    readonly totalPages: number;
+    /** The current page number (mirrors the `page` option). */
+    readonly currentPage: number;
+    /** `true` while the initial fetch is in flight. */
+    readonly isLoading: boolean;
+    /** `true` while a background refetch is in flight. */
+    readonly isRefetching: boolean;
+    /** Error from the last failed request, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Discard cached data and re-fetch the current page from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches a paginated list of an organization's schedules.
+ *
+ * Backed by the direct `listSchedules` query — not the search service —
+ * so each entry is a full `Schedule` proto with the operational status
+ * fields a schedule list exists to show (`next_fire_at`, enabled/paused
+ * state, `last_fire_at`). There is no text query or visibility scope:
+ * schedules are org-only and have no server-side search.
+ *
+ * Pass `null` as `org` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { schedules, totalCount, isLoading } = useScheduleList("isc", {
+ *   page: 1,
+ *   pageSize: 20,
+ * });
+ * ```
+ */
+export declare function useScheduleList(org: string | null, options?: UseScheduleListOptions): UseScheduleListReturn;
+//# sourceMappingURL=useScheduleList.d.ts.map

package/schedule/useScheduleList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScheduleList.d.ts","sourceRoot":"","sources":["../../src/schedule/useScheduleList.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uDAAuD,CAAC;AAKtF,2CAA2C;AAC3C,MAAM,WAAW,sBAAsB;IACrC,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC,mEAAmE;IACnE,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;IACxC,qDAAqD;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAID;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,qBAAqB,CAuBvB"}

package/schedule/useScheduleList.js

@@ -0,0 +1,43 @@
+"use client";
+import { useStigmer } from "../hooks.js";
+import { useFetch } from "../internal/useFetch.js";
+import { listSchedulesPage } from "./scheduleListFn.js";
+const INITIAL_PAGE = { items: [], totalCount: 0, totalPages: 0 };
+/**
+ * Data hook that fetches a paginated list of an organization's schedules.
+ *
+ * Backed by the direct `listSchedules` query — not the search service —
+ * so each entry is a full `Schedule` proto with the operational status
+ * fields a schedule list exists to show (`next_fire_at`, enabled/paused
+ * state, `last_fire_at`). There is no text query or visibility scope:
+ * schedules are org-only and have no server-side search.
+ *
+ * Pass `null` as `org` to skip fetching (stable no-op).
+ *
+ * @example
+ * ```tsx
+ * const { schedules, totalCount, isLoading } = useScheduleList("isc", {
+ *   page: 1,
+ *   pageSize: 20,
+ * });
+ * ```
+ */
+export function useScheduleList(org, options) {
+    const stigmer = useStigmer();
+    const pageSize = options?.pageSize;
+    const page = options?.page ?? 1;
+    const { data, isLoading, isRefetching, error, refetch } = useFetch(org
+        ? () => listSchedulesPage(stigmer, org, { num: page, size: pageSize })
+        : null, [stigmer, org, page, pageSize], INITIAL_PAGE);
+    return {
+        schedules: data.items,
+        totalCount: data.totalCount,
+        totalPages: data.totalPages,
+        currentPage: page,
+        isLoading,
+        isRefetching,
+        error,
+        refetch,
+    };
+}
+//# sourceMappingURL=useScheduleList.js.map

package/schedule/useScheduleList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScheduleList.js","sourceRoot":"","sources":["../../src/schedule/useScheduleList.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAqB,MAAM,qBAAqB,CAAC;AA8B3E,MAAM,YAAY,GAAiB,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;AAE/E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,eAAe,CAC7B,GAAkB,EAClB,OAAgC;IAEhC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,CAAC;IACnC,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,CAAC,CAAC;IAEhC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CAChE,GAAG;QACD,CAAC,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACtE,CAAC,CAAC,IAAI,EACR,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,EAC9B,YAAY,CACb,CAAC;IAEF,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,KAAK;QACrB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,WAAW,EAAE,IAAI;QACjB,SAAS;QACT,YAAY;QACZ,KAAK;QACL,OAAO;KACR,CAAC;AACJ,CAAC"}

package/schedule/useSetScheduleEnabled.d.ts

@@ -0,0 +1,31 @@
+import { type Schedule } from "@stigmer/protos/ai/stigmer/agentic/schedule/v1/api_pb";
+/** Return value of {@link useSetScheduleEnabled}. */
+export interface UseSetScheduleEnabledReturn {
+    /**
+     * Flip the owner's `spec.enabled` switch. Takes the full fetched
+     * schedule (not just an id) because the write re-applies the whole
+     * resource. Resolves with the post-apply schedule; the caller
+     * refetches or replaces its local copy from it.
+     */
+    readonly setEnabled: (schedule: Schedule, enabled: boolean) => Promise<Schedule>;
+    /** `true` while the apply is in flight. */
+    readonly isPending: boolean;
+    /** Error from the last failed apply, or `null` when healthy. */
+    readonly error: Error | null;
+}
+/**
+ * Behavior hook that flips a schedule's owner-controlled `enabled` flag.
+ *
+ * The write path is deliberate: clone the fetched proto, flip one
+ * field, and re-apply the WHOLE resource through the manifest engine
+ * (`stigmer.manifest.apply`) — never down-convert to the curated
+ * `ScheduleInput` shape. The server replaces spec and mutable metadata
+ * wholesale on update, and `ScheduleInput` cannot express every
+ * metadata field (tags, description), so the input route would silently
+ * wipe them. The full-proto route is lossless by construction; the
+ * server ignores client-provided status, and re-applying never clears a
+ * platform pause (Resume is the one clearing path — see
+ * {@link useResumeSchedule}).
+ */
+export declare function useSetScheduleEnabled(): UseSetScheduleEnabledReturn;
+//# sourceMappingURL=useSetScheduleEnabled.d.ts.map

package/schedule/useSetScheduleEnabled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSetScheduleEnabled.d.ts","sourceRoot":"","sources":["../../src/schedule/useSetScheduleEnabled.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,QAAQ,EACd,MAAM,uDAAuD,CAAC;AAM/D,qDAAqD;AACrD,MAAM,WAAW,2BAA2B;IAC1C;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjF,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,IAAI,2BAA2B,CAyCnE"}

package/schedule/useSetScheduleEnabled.js

@@ -0,0 +1,53 @@
+"use client";
+import { useCallback, useMemo, useState } from "react";
+import { clone } from "@bufbuild/protobuf";
+import { ScheduleSchema, } from "@stigmer/protos/ai/stigmer/agentic/schedule/v1/api_pb";
+import { getUserMessage, manifestDocumentForResource } from "@stigmer/sdk";
+import { useStigmer } from "../hooks.js";
+import { toast } from "../feedback/toast.js";
+import { toError } from "../internal/toError.js";
+/**
+ * Behavior hook that flips a schedule's owner-controlled `enabled` flag.
+ *
+ * The write path is deliberate: clone the fetched proto, flip one
+ * field, and re-apply the WHOLE resource through the manifest engine
+ * (`stigmer.manifest.apply`) — never down-convert to the curated
+ * `ScheduleInput` shape. The server replaces spec and mutable metadata
+ * wholesale on update, and `ScheduleInput` cannot express every
+ * metadata field (tags, description), so the input route would silently
+ * wipe them. The full-proto route is lossless by construction; the
+ * server ignores client-provided status, and re-applying never clears a
+ * platform pause (Resume is the one clearing path — see
+ * {@link useResumeSchedule}).
+ */
+export function useSetScheduleEnabled() {
+    const stigmer = useStigmer();
+    const [isPending, setIsPending] = useState(false);
+    const [error, setError] = useState(null);
+    const setEnabled = useCallback(async (schedule, enabled) => {
+        if (!schedule.spec) {
+            throw new Error("Cannot toggle this schedule: it has no spec. Pass a schedule " +
+                "as returned by the server (get/getByReference).");
+        }
+        setIsPending(true);
+        setError(null);
+        try {
+            const updated = clone(ScheduleSchema, schedule);
+            updated.spec.enabled = enabled;
+            const applied = await stigmer.manifest.apply(manifestDocumentForResource(updated));
+            toast.success(enabled ? "Schedule enabled" : "Schedule disabled");
+            return applied.message;
+        }
+        catch (err) {
+            const wrapped = toError(err);
+            setError(wrapped);
+            toast.error(getUserMessage(err));
+            throw wrapped;
+        }
+        finally {
+            setIsPending(false);
+        }
+    }, [stigmer]);
+    return useMemo(() => ({ setEnabled, isPending, error }), [setEnabled, isPending, error]);
+}
+//# sourceMappingURL=useSetScheduleEnabled.js.map