@stigmer/react 3.5.2 → 3.6.0

package/src/schedule/ScheduleForm.tsx

@@ -0,0 +1,405 @@
+"use client";
+
+import { useCallback, useState, type FormEvent } from "react";
+import { cn } from "@stigmer/theme";
+import { getUserMessage, type ResourceRef } from "@stigmer/sdk";
+import type { Schedule } from "@stigmer/protos/ai/stigmer/agentic/schedule/v1/api_pb";
+import { Popover } from "@base-ui/react/popover";
+import { AgentPicker } from "../agent/AgentPicker.js";
+import { Switch } from "../switch/Switch.js";
+import { useStigmerPortalContainer } from "../portal-container.js";
+import { CadenceField } from "./CadenceField.js";
+import { TimeZoneField, browserTimeZone } from "./TimeZoneField.js";
+import { useCreateSchedule } from "./useCreateSchedule.js";
+import { cadenceToCron, validateCron, type CadencePreset } from "./cadence.js";
+
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+
+/** Props for {@link ScheduleForm}. */
+export interface ScheduleFormProps {
+  /**
+   * Organization slug. Schedules are org-local: the server requires the
+   * target agent to live in this same org, so the agent picker is
+   * locked to org scope.
+   */
+  readonly org: string;
+  /** Fired with the created schedule after a successful submit. */
+  readonly onComplete?: (schedule: Schedule) => void;
+  /** Fired when the user cancels. */
+  readonly onCancel?: () => void;
+  /** Additional CSS class names for the root form element. */
+  readonly className?: string;
+}
+
+/** spec.proto pins AgentTarget.message to 8192 characters. */
+const MESSAGE_MAX_LEN = 8192;
+/** Show the remaining-characters counter once within this margin. */
+const MESSAGE_COUNTER_THRESHOLD = 500;
+
+/**
+ * Single-page form for creating a {@link Schedule}.
+ *
+ * Collects the four things a user decides about a schedule — which
+ * agent, what message, when ({@link CadenceField}, generating the cron
+ * expression from human-friendly presets), and whether it starts
+ * enabled — then creates it via {@link useCreateSchedule}.
+ *
+ * Enabled defaults to OFF, deliberately: it matches the proto/YAML
+ * default (an omitted `enabled` is false) and the platform's
+ * recommended workflow — create staged-disabled, validate with
+ * "Run now" on the detail page, then enable.
+ *
+ * Creation only. Editing an existing schedule must not flow through
+ * this form's curated input — see the note on {@link useCreateSchedule}.
+ *
+ * @example
+ * ```tsx
+ * <ScheduleForm
+ *   org="acme"
+ *   onComplete={(s) => navigate(`/library/schedules/${s.metadata?.org}/${s.metadata?.slug}`)}
+ *   onCancel={() => navigate("/library/schedules")}
+ * />
+ * ```
+ */
+export function ScheduleForm({
+  org,
+  onComplete,
+  onCancel,
+  className,
+}: ScheduleFormProps) {
+  const { create, isCreating, error, clearError } = useCreateSchedule();
+
+  const [name, setName] = useState("");
+  const [agentRef, setAgentRef] = useState<ResourceRef | null>(null);
+  const [agentName, setAgentName] = useState<string | null>(null);
+  const [message, setMessage] = useState("");
+  const [cadence, setCadence] = useState<CadencePreset>({
+    kind: "daily",
+    hour: 9,
+    minute: 0,
+  });
+  const [timeZone, setTimeZone] = useState(browserTimeZone);
+  const [enabled, setEnabled] = useState(false);
+  const [pickerOpen, setPickerOpen] = useState(false);
+
+  const trimmedName = name.trim();
+  const trimmedMessage = message.trim();
+  const cron = cadenceToCron(cadence).trim();
+  const cronValid = cron !== "" && validateCron(cron) === null;
+
+  const canSubmit =
+    trimmedName !== "" &&
+    agentRef !== null &&
+    trimmedMessage !== "" &&
+    cronValid &&
+    !isCreating;
+
+  const handleAgentChange = useCallback((ref: ResourceRef | null) => {
+    setAgentRef(ref);
+    if (ref === null) setAgentName(null);
+    setPickerOpen(false);
+  }, []);
+
+  const handleSubmit = useCallback(
+    async (e: FormEvent) => {
+      e.preventDefault();
+      if (!canSubmit || !agentRef) return;
+
+      clearError();
+      try {
+        const schedule = await create({
+          name: trimmedName,
+          org,
+          cron,
+          timeZone,
+          enabled,
+          agent: { agentRef, message: trimmedMessage },
+        });
+        onComplete?.(schedule);
+      } catch {
+        // error state is managed by useCreateSchedule
+      }
+    },
+    [
+      canSubmit,
+      agentRef,
+      clearError,
+      create,
+      trimmedName,
+      org,
+      cron,
+      timeZone,
+      enabled,
+      trimmedMessage,
+      onComplete,
+    ],
+  );
+
+  const remaining = MESSAGE_MAX_LEN - message.length;
+
+  return (
+    <form
+      onSubmit={handleSubmit}
+      className={cn("max-w-2xl space-y-5", className)}
+      aria-label="New schedule"
+    >
+      {/* Name */}
+      <div className="space-y-1">
+        <label htmlFor="stgm-new-schedule-name" className={labelClasses}>
+          Name
+        </label>
+        <input
+          id="stgm-new-schedule-name"
+          type="text"
+          value={name}
+          onChange={(e) => setName(e.target.value)}
+          placeholder="e.g. daily-fee-reminders"
+          disabled={isCreating}
+          autoFocus
+          required
+          className={inputClasses}
+        />
+      </div>
+
+      {/* Target agent */}
+      <div className="space-y-1">
+        <span id="stgm-new-schedule-agent-label" className={labelClasses}>
+          Agent to run
+        </span>
+        <Popover.Root open={pickerOpen} onOpenChange={setPickerOpen}>
+          <Popover.Trigger
+            disabled={isCreating}
+            aria-labelledby="stgm-new-schedule-agent-label"
+            className={cn(
+              "flex w-full items-center justify-between rounded-md border border-input bg-background px-2.5 py-1.5 text-left text-xs",
+              "focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring",
+              "disabled:pointer-events-none disabled:opacity-50",
+              agentRef ? "text-foreground" : "text-muted-foreground",
+            )}
+          >
+            <span className="truncate">
+              {agentRef
+                ? (agentName ?? `${agentRef.org}/${agentRef.slug}`)
+                : "Choose an agent…"}
+            </span>
+            <ChevronIcon />
+          </Popover.Trigger>
+          <AgentPickerPopup
+            org={org}
+            value={agentRef}
+            onChange={handleAgentChange}
+            onDisplayNameResolved={(_key, resolvedName) =>
+              setAgentName(resolvedName)
+            }
+            disabled={isCreating}
+          />
+        </Popover.Root>
+        <p className={hintClasses}>
+          Each fire runs this agent unattended in a fresh session. Only
+          agents in <span className="font-medium">{org}</span> can be
+          scheduled.
+        </p>
+      </div>
+
+      {/* Message */}
+      <div className="space-y-1">
+        <label htmlFor="stgm-new-schedule-message" className={labelClasses}>
+          Message
+        </label>
+        <textarea
+          id="stgm-new-schedule-message"
+          value={message}
+          onChange={(e) => setMessage(e.target.value)}
+          placeholder="The instruction the agent receives on every fire — write it for a run with no human present."
+          disabled={isCreating}
+          required
+          rows={5}
+          maxLength={MESSAGE_MAX_LEN}
+          className={cn(inputClasses, "resize-y")}
+        />
+        {remaining <= MESSAGE_COUNTER_THRESHOLD && (
+          <p className={hintClasses}>{remaining} characters left</p>
+        )}
+      </div>
+
+      {/* Cadence */}
+      <div className="space-y-1">
+        <span className={labelClasses}>Runs</span>
+        <CadenceField
+          value={cadence}
+          onChange={setCadence}
+          timeZone={timeZone}
+          disabled={isCreating}
+        />
+      </div>
+
+      {/* Time zone */}
+      <div className="space-y-1">
+        <label htmlFor="stgm-new-schedule-tz" className={labelClasses}>
+          Time zone
+        </label>
+        <TimeZoneField
+          id="stgm-new-schedule-tz"
+          value={timeZone}
+          onChange={setTimeZone}
+          disabled={isCreating}
+        />
+      </div>
+
+      {/* Enabled */}
+      <div className="flex items-start gap-3">
+        <Switch
+          id="stgm-new-schedule-enabled"
+          checked={enabled}
+          onCheckedChange={setEnabled}
+          disabled={isCreating}
+          aria-labelledby="stgm-new-schedule-enabled-label"
+        />
+        <div className="space-y-0.5">
+          <label
+            id="stgm-new-schedule-enabled-label"
+            htmlFor="stgm-new-schedule-enabled"
+            className={labelClasses}
+          >
+            Enabled
+          </label>
+          <p className={hintClasses}>
+            Leave off to create the schedule staged: validate it with
+            &ldquo;Run now&rdquo; on the schedule page, then enable it there.
+          </p>
+        </div>
+      </div>
+
+      {error && (
+        <p className="text-xs text-destructive" role="alert">
+          {getUserMessage(error)}
+        </p>
+      )}
+
+      <div className="flex items-center gap-2">
+        <button
+          type="submit"
+          disabled={!canSubmit}
+          className={cn(
+            "inline-flex items-center gap-1.5 rounded-md px-3 py-1.5 text-sm font-medium",
+            "bg-primary text-primary-foreground hover:bg-primary-hover",
+            "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+            "disabled:pointer-events-none disabled:opacity-40",
+          )}
+        >
+          {isCreating && <SpinnerIcon />}
+          Create schedule
+        </button>
+
+        {onCancel && (
+          <button
+            type="button"
+            onClick={onCancel}
+            disabled={isCreating}
+            className={cn(
+              "rounded-md px-3 py-1.5 text-sm",
+              "text-muted-foreground hover:bg-accent-hover hover:text-foreground",
+              "disabled:pointer-events-none disabled:opacity-50",
+            )}
+          >
+            Cancel
+          </button>
+        )}
+      </div>
+    </form>
+  );
+}
+
+// ---------------------------------------------------------------------------
+// Private helpers
+// ---------------------------------------------------------------------------
+
+const labelClasses = "block text-xs font-medium text-foreground";
+const hintClasses = "text-[0.65rem] text-muted-foreground";
+const inputClasses = cn(
+  "w-full rounded-md border border-input bg-background px-2.5 py-1.5 text-xs text-foreground",
+  "placeholder:text-muted-foreground",
+  "focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring",
+  "disabled:pointer-events-none disabled:opacity-50",
+);
+
+function AgentPickerPopup({
+  org,
+  value,
+  onChange,
+  onDisplayNameResolved,
+  disabled,
+}: {
+  readonly org: string;
+  readonly value: ResourceRef | null;
+  readonly onChange: (ref: ResourceRef | null) => void;
+  readonly onDisplayNameResolved: (key: string, name: string) => void;
+  readonly disabled?: boolean;
+}) {
+  const portalContainer = useStigmerPortalContainer();
+  return (
+    <Popover.Portal container={portalContainer}>
+      <Popover.Positioner sideOffset={4} align="start">
+        <Popover.Popup
+          className={cn(
+            "z-popover overflow-x-hidden overflow-y-auto rounded-lg border border-border",
+            "bg-popover p-3 text-popover-foreground shadow-md",
+            "max-h-[60vh]",
+          )}
+        >
+          <AgentPicker
+            org={org}
+            value={value}
+            onChange={onChange}
+            onDisplayNameResolved={onDisplayNameResolved}
+            // Schedules are org-local: the server rejects a target
+            // agent outside the schedule's org, so cross-org browsing
+            // could only offer choices that fail at submit.
+            scope="org"
+            showScopeToggle={false}
+            disabled={disabled}
+          />
+        </Popover.Popup>
+      </Popover.Positioner>
+    </Popover.Portal>
+  );
+}
+
+function ChevronIcon() {
+  return (
+    <svg
+      width="12"
+      height="12"
+      viewBox="0 0 16 16"
+      fill="none"
+      stroke="currentColor"
+      strokeWidth="1.5"
+      strokeLinecap="round"
+      strokeLinejoin="round"
+      className="shrink-0 text-muted-foreground"
+      aria-hidden="true"
+    >
+      <path d="M4 6l4 4 4-4" />
+    </svg>
+  );
+}
+
+function SpinnerIcon() {
+  return (
+    <svg
+      width="14"
+      height="14"
+      viewBox="0 0 16 16"
+      fill="none"
+      stroke="currentColor"
+      strokeWidth="2"
+      strokeLinecap="round"
+      className="animate-spin"
+      aria-hidden="true"
+    >
+      <path d="M8 2a6 6 0 1 0 6 6" />
+    </svg>
+  );
+}

package/src/schedule/ScheduleRowActions.tsx

@@ -0,0 +1,124 @@
+"use client";
+
+import { cn } from "@stigmer/theme";
+import type { Schedule } from "@stigmer/protos/ai/stigmer/agentic/schedule/v1/api_pb";
+import { ConfirmDialog } from "../resource-detail/ConfirmDialog.js";
+import { useConfirmAction } from "../resource-detail/useConfirmAction.js";
+import { deriveScheduleState } from "./scheduleState.js";
+import { useResumeSchedule } from "./useResumeSchedule.js";
+import { useTriggerSchedule } from "./useTriggerSchedule.js";
+
+/** Props for {@link ScheduleRowActions}. */
+export interface ScheduleRowActionsProps {
+  /** The schedule this row represents. */
+  readonly schedule: Schedule;
+  /** Called after a successful action so the list can refetch. */
+  readonly onChanged?: () => void;
+}
+
+/**
+ * Compact per-row actions for a schedule list: **Run now** on an active
+ * schedule (confirmation-gated — it starts a real, billable execution)
+ * and **Resume** on a platform-paused one. Exactly one action renders
+ * at a time — the one that is currently meaningful; an owner-disabled
+ * schedule renders neither (its remedy lives on the detail page).
+ *
+ * Shared by every console's schedule workbench via `renderItemAction`
+ * so row behavior never diverges between apps (DD-016).
+ */
+export function ScheduleRowActions({
+  schedule,
+  onChanged,
+}: ScheduleRowActionsProps) {
+  const { resumeSchedule, isResuming } = useResumeSchedule();
+  const { triggerSchedule, isTriggering } = useTriggerSchedule();
+  const { confirmState, confirm, handleConfirm, handleCancel } =
+    useConfirmAction();
+
+  const info = deriveScheduleState(schedule.spec, schedule.status);
+  const scheduleId = schedule.metadata?.id ?? "";
+  const name = schedule.metadata?.name || schedule.metadata?.slug || "schedule";
+
+  const handleTrigger = async () => {
+    const confirmed = await confirm({
+      title: "Run this schedule now?",
+      description:
+        `"${name}" starts a real agent execution immediately, outside ` +
+        "the cron cadence.",
+      confirmLabel: "Start run",
+      variant: "default",
+    });
+    if (!confirmed) return;
+    await triggerSchedule(scheduleId);
+    onChanged?.();
+  };
+
+  const handleResume = async () => {
+    await resumeSchedule(scheduleId);
+    onChanged?.();
+  };
+
+  if (info.state === "disabled") return null;
+
+  return (
+    // Row actions must never bubble into the row's navigate-to-detail
+    // click handler. The span is a non-interactive event fence — the
+    // real interactive element (with keyboard support) is the button.
+    <span onClick={(e) => e.stopPropagation()}>
+      {info.state === "active" ? (
+        <RowActionButton
+          label={`Run ${name} now`}
+          busy={isTriggering}
+          onClick={() => void handleTrigger()}
+        >
+          Run now
+        </RowActionButton>
+      ) : (
+        <RowActionButton
+          label={`Resume ${name}`}
+          busy={isResuming}
+          onClick={() => void handleResume()}
+        >
+          Resume
+        </RowActionButton>
+      )}
+
+      {confirmState && (
+        <ConfirmDialog
+          state={confirmState}
+          onConfirm={handleConfirm}
+          onCancel={handleCancel}
+        />
+      )}
+    </span>
+  );
+}
+
+function RowActionButton({
+  label,
+  busy,
+  onClick,
+  children,
+}: {
+  readonly label: string;
+  readonly busy: boolean;
+  readonly onClick: () => void;
+  readonly children: React.ReactNode;
+}) {
+  return (
+    <button
+      type="button"
+      aria-label={label}
+      onClick={onClick}
+      disabled={busy}
+      className={cn(
+        "rounded-md border border-input bg-background px-2 py-1 text-xs font-medium text-foreground",
+        "hover:bg-accent hover:text-accent-foreground",
+        "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+        "disabled:pointer-events-none disabled:opacity-50",
+      )}
+    >
+      {children}
+    </button>
+  );
+}