@stigmer/react 3.5.3 → 3.6.0

package/schedule/cadence.js

@@ -0,0 +1,242 @@
+/**
+ * The cadence model behind {@link CadenceField} — a pure, dependency-free
+ * bridge between human-friendly schedule presets and the 5-field cron
+ * grammar the Schedule spec stores.
+ *
+ * Deliberately NOT a cron parser. The platform owns no cron parsing in
+ * either edition — calendar and DST semantics live in the Temporal server
+ * (see stigmer-server's schedule/controller/cron.go, DD-008 D2). This
+ * module only:
+ *
+ *   1. GENERATES cron strings from presets (`cadenceToCron`) — trivial
+ *      string construction, always valid by construction.
+ *   2. RECOGNIZES the exact shapes the builder emits (`cronToCadence`)
+ *      so a stored cron round-trips back into the preset UI; anything
+ *      else falls back to the `custom` preset showing the raw string.
+ *   3. MIRRORS the server's purely lexical validation (`validateCron`,
+ *      `validateTimeZone`) with the same user-facing wording, so the
+ *      form can reject bad input instantly. The server remains the
+ *      authority — its errors surface verbatim on submit.
+ */
+/** Day-of-week labels indexed by cron numbering (0 = Sunday). */
+export const WEEKDAY_LABELS = [
+    "Sunday",
+    "Monday",
+    "Tuesday",
+    "Wednesday",
+    "Thursday",
+    "Friday",
+    "Saturday",
+];
+// ---------------------------------------------------------------------------
+// Preset → cron
+// ---------------------------------------------------------------------------
+/**
+ * Build the 5-field cron expression for a preset.
+ *
+ * Output is always valid by construction: numeric fields only,
+ * day-of-week in cron numbering (0 = Sunday). For `custom`, the raw
+ * string is returned as-is — validate it with {@link validateCron}.
+ */
+export function cadenceToCron(preset) {
+    switch (preset.kind) {
+        case "hourly":
+            return `${preset.minute} * * * *`;
+        case "daily":
+            return `${preset.minute} ${preset.hour} * * *`;
+        case "weekly": {
+            // Sorted, deduplicated day list keeps the output canonical so
+            // cronToCadence round-trips regardless of selection order.
+            const days = [...new Set(preset.days)].sort((a, b) => a - b);
+            return `${preset.minute} ${preset.hour} * * ${days.join(",")}`;
+        }
+        case "monthly":
+            return `${preset.minute} ${preset.hour} ${preset.day} * *`;
+        case "custom":
+            return preset.cron;
+    }
+}
+// ---------------------------------------------------------------------------
+// Cron → preset (recognition, not parsing)
+// ---------------------------------------------------------------------------
+const HOURLY_RE = /^(\d{1,2}) \* \* \* \*$/;
+const DAILY_RE = /^(\d{1,2}) (\d{1,2}) \* \* \*$/;
+const WEEKLY_RE = /^(\d{1,2}) (\d{1,2}) \* \* (\d(?:,\d)*)$/;
+const MONTHLY_RE = /^(\d{1,2}) (\d{1,2}) (\d{1,2}) \* \*$/;
+/**
+ * Recognize a cron expression as one of the builder's presets.
+ *
+ * Only the exact shapes {@link cadenceToCron} emits (plus the
+ * calendar shorthands `@hourly`/`@daily`/`@weekly`/`@monthly`) map to a
+ * structured preset. Everything else — ranges, steps, names, `@yearly`
+ * — is a perfectly valid schedule that this UI simply cannot decompose,
+ * so it round-trips as `custom` with the raw string intact.
+ */
+export function cronToCadence(cron) {
+    const normalized = cron.trim().replace(/\s+/g, " ");
+    switch (normalized) {
+        case "@hourly":
+            return { kind: "hourly", minute: 0 };
+        case "@daily":
+            return { kind: "daily", hour: 0, minute: 0 };
+        case "@weekly":
+            return { kind: "weekly", days: [0], hour: 0, minute: 0 };
+        case "@monthly":
+            return { kind: "monthly", day: 1, hour: 0, minute: 0 };
+    }
+    let m = HOURLY_RE.exec(normalized);
+    if (m) {
+        const minute = Number(m[1]);
+        if (isMinute(minute))
+            return { kind: "hourly", minute };
+    }
+    m = DAILY_RE.exec(normalized);
+    if (m) {
+        const minute = Number(m[1]);
+        const hour = Number(m[2]);
+        if (isMinute(minute) && isHour(hour))
+            return { kind: "daily", hour, minute };
+    }
+    m = WEEKLY_RE.exec(normalized);
+    if (m) {
+        const minute = Number(m[1]);
+        const hour = Number(m[2]);
+        const days = m[3].split(",").map(Number);
+        if (isMinute(minute) &&
+            isHour(hour) &&
+            days.length > 0 &&
+            days.every((d) => d >= 0 && d <= 6) &&
+            new Set(days).size === days.length) {
+            return { kind: "weekly", days: [...days].sort((a, b) => a - b), hour, minute };
+        }
+    }
+    m = MONTHLY_RE.exec(normalized);
+    if (m) {
+        const minute = Number(m[1]);
+        const hour = Number(m[2]);
+        const day = Number(m[3]);
+        if (isMinute(minute) && isHour(hour) && day >= 1 && day <= 31) {
+            return { kind: "monthly", day, hour, minute };
+        }
+    }
+    return { kind: "custom", cron };
+}
+function isMinute(n) {
+    return Number.isInteger(n) && n >= 0 && n <= 59;
+}
+function isHour(n) {
+    return Number.isInteger(n) && n >= 0 && n <= 23;
+}
+// ---------------------------------------------------------------------------
+// Plain-English summary
+// ---------------------------------------------------------------------------
+/**
+ * Human-readable summary of a cadence, e.g.
+ * `"Every day at 09:00 (Asia/Kolkata)"`.
+ *
+ * This is a description of the chosen preset, not a computed fire-time
+ * forecast — the platform's next fire time is published by the server
+ * as `status.next_fire_at` after apply.
+ */
+export function describeCadence(preset, timeZone) {
+    const zone = timeZone ? ` (${timeZone})` : "";
+    switch (preset.kind) {
+        case "hourly":
+            return `Every hour at minute ${preset.minute}${zone}`;
+        case "daily":
+            return `Every day at ${formatTime(preset.hour, preset.minute)}${zone}`;
+        case "weekly": {
+            const days = [...new Set(preset.days)].sort((a, b) => a - b);
+            const names = days.length === 7
+                ? "day"
+                : listWithAnd(days.map((d) => WEEKDAY_LABELS[d]));
+            return `Every ${names} at ${formatTime(preset.hour, preset.minute)}${zone}`;
+        }
+        case "monthly":
+            return `On day ${preset.day} of every month at ${formatTime(preset.hour, preset.minute)}${zone}`;
+        case "custom":
+            return `Cron “${preset.cron.trim()}”${zone}`;
+    }
+}
+/** `9, 5` → `"09:05"` (24-hour clock, zero-padded). */
+export function formatTime(hour, minute) {
+    return `${String(hour).padStart(2, "0")}:${String(minute).padStart(2, "0")}`;
+}
+function listWithAnd(items) {
+    if (items.length === 1)
+        return items[0];
+    return `${items.slice(0, -1).join(", ")} and ${items[items.length - 1]}`;
+}
+// ---------------------------------------------------------------------------
+// Lexical validation — mirrors stigmer-server schedule/controller/cron.go
+// ---------------------------------------------------------------------------
+// The accepted @-shorthands, the field character set, the rejection
+// cases AND the message wording below mirror the server byte-for-byte
+// (Go: cron.go / cron_test.go; Java: ValidateScheduleSpec). A change on
+// any side must change all three, or the instant client feedback drifts
+// from what the server enforces on submit.
+const CRON_SHORTHANDS = new Set([
+    "@hourly",
+    "@daily",
+    "@weekly",
+    "@monthly",
+    "@yearly",
+]);
+const CRON_FIELD_PATTERN = /^[0-9A-Za-z*,/-]+$/;
+/**
+ * Validate a cron expression against the platform's lexical grammar.
+ *
+ * Returns the user-facing error message (identical wording to the
+ * server's) or `null` when the expression is acceptable. Purely
+ * lexical — it does not evaluate calendar semantics.
+ */
+export function validateCron(cron) {
+    if (cron.startsWith("CRON_TZ=") || cron.startsWith("TZ=")) {
+        return "spec.cron must not carry a timezone prefix (CRON_TZ=/TZ=) — spec.time_zone is the single timezone authority";
+    }
+    if (cron.includes("#")) {
+        return "spec.cron must not contain a comment (#)";
+    }
+    if (cron.startsWith("@")) {
+        if (cron.startsWith("@every")) {
+            return "spec.cron must be a calendar expression — @every intervals are not supported";
+        }
+        if (!CRON_SHORTHANDS.has(cron)) {
+            return `spec.cron shorthand "${cron}" is not supported — use @hourly, @daily, @weekly, @monthly, or @yearly, or a 5-field cron expression`;
+        }
+        return null;
+    }
+    // Matches Go's strings.Fields: split on runs of whitespace, so
+    // surrounding/duplicate whitespace never produces empty fields.
+    const fields = cron.split(/\s+/).filter((f) => f.length > 0);
+    if (fields.length !== 5) {
+        return `spec.cron must have exactly 5 fields (minute hour day-of-month month day-of-week); got ${fields.length}`;
+    }
+    for (const field of fields) {
+        if (!CRON_FIELD_PATTERN.test(field)) {
+            return `spec.cron field "${field}" contains unsupported characters — allowed: digits, names, '*', ',', '-', '/'`;
+        }
+    }
+    return null;
+}
+/**
+ * Validate an IANA time zone name using the runtime's own tz database
+ * (`Intl`), mirroring the server's check against the platform tz
+ * database. Returns the user-facing error message or `null`.
+ *
+ * `"Local"` is rejected explicitly for the same reason the server
+ * rejects it: it is host-dependent, not a zone.
+ */
+export function validateTimeZone(timeZone) {
+    const invalid = `spec.time_zone "${timeZone}" is not a valid IANA time zone (e.g. "Asia/Kolkata")`;
+    if (timeZone === "Local")
+        return invalid;
+    try {
+        new Intl.DateTimeFormat("en-US", { timeZone });
+        return null;
+    }
+    catch {
+        return invalid;
+    }
+}
+//# sourceMappingURL=cadence.js.map

package/schedule/cadence.js.map

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

package/schedule/index.d.ts

@@ -0,0 +1,31 @@
+export { deriveScheduleState, formatNextFire } from "./scheduleState.js";
+export type { ScheduleState, ScheduleStateInfo } from "./scheduleState.js";
+export { createScheduleListFn, listSchedulesPage } from "./scheduleListFn.js";
+export type { ScheduleListClient, SchedulePage } from "./scheduleListFn.js";
+export { useSchedule } from "./useSchedule.js";
+export type { UseScheduleReturn } from "./useSchedule.js";
+export { useScheduleList } from "./useScheduleList.js";
+export type { UseScheduleListOptions, UseScheduleListReturn, } from "./useScheduleList.js";
+export { useScheduleCount } from "./useScheduleCount.js";
+export type { UseScheduleCountOptions, UseScheduleCountReturn, } from "./useScheduleCount.js";
+export { useResumeSchedule } from "./useResumeSchedule.js";
+export type { UseResumeScheduleReturn } from "./useResumeSchedule.js";
+export { useTriggerSchedule } from "./useTriggerSchedule.js";
+export type { UseTriggerScheduleReturn } from "./useTriggerSchedule.js";
+export { useSetScheduleEnabled } from "./useSetScheduleEnabled.js";
+export type { UseSetScheduleEnabledReturn } from "./useSetScheduleEnabled.js";
+export { createScheduleColumns } from "./scheduleColumns.js";
+export type { ScheduleColumnsOptions } from "./scheduleColumns.js";
+export { ScheduleRowActions } from "./ScheduleRowActions.js";
+export type { ScheduleRowActionsProps } from "./ScheduleRowActions.js";
+export { ScheduleDetailView, ScheduleIcon } from "./ScheduleDetailView.js";
+export type { ScheduleDetailViewProps } from "./ScheduleDetailView.js";
+export { cadenceToCron, cronToCadence, describeCadence, validateCron, validateTimeZone, WEEKDAY_LABELS, } from "./cadence.js";
+export type { CadencePreset, CadenceKind } from "./cadence.js";
+export { useCreateSchedule } from "./useCreateSchedule.js";
+export type { UseCreateScheduleReturn } from "./useCreateSchedule.js";
+export { CadenceField } from "./CadenceField.js";
+export type { CadenceFieldProps } from "./CadenceField.js";
+export { ScheduleForm } from "./ScheduleForm.js";
+export type { ScheduleFormProps } from "./ScheduleForm.js";
+//# sourceMappingURL=index.d.ts.map

package/schedule/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schedule/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzE,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE3E,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAE5E,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EACV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EACV,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAExE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAE9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,YAAY,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvE,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC3E,YAAY,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvE,OAAO,EACL,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/schedule/index.js

@@ -0,0 +1,16 @@
+export { deriveScheduleState, formatNextFire } from "./scheduleState.js";
+export { createScheduleListFn, listSchedulesPage } from "./scheduleListFn.js";
+export { useSchedule } from "./useSchedule.js";
+export { useScheduleList } from "./useScheduleList.js";
+export { useScheduleCount } from "./useScheduleCount.js";
+export { useResumeSchedule } from "./useResumeSchedule.js";
+export { useTriggerSchedule } from "./useTriggerSchedule.js";
+export { useSetScheduleEnabled } from "./useSetScheduleEnabled.js";
+export { createScheduleColumns } from "./scheduleColumns.js";
+export { ScheduleRowActions } from "./ScheduleRowActions.js";
+export { ScheduleDetailView, ScheduleIcon } from "./ScheduleDetailView.js";
+export { cadenceToCron, cronToCadence, describeCadence, validateCron, validateTimeZone, WEEKDAY_LABELS, } from "./cadence.js";
+export { useCreateSchedule } from "./useCreateSchedule.js";
+export { CadenceField } from "./CadenceField.js";
+export { ScheduleForm } from "./ScheduleForm.js";
+//# sourceMappingURL=index.js.map

package/schedule/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schedule/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzE,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG9E,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAMvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAMzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAG3E,OAAO,EACL,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,cAAc,GACf,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/schedule/scheduleColumns.d.ts

@@ -0,0 +1,26 @@
+import type { Schedule } from "@stigmer/protos/ai/stigmer/agentic/schedule/v1/api_pb";
+import type { WorkbenchColumnDef } from "../resource-workbench/types.js";
+/** Options for {@link createScheduleColumns}. */
+export interface ScheduleColumnsOptions {
+    /**
+     * Clock provider for the "next fire" and "last run" columns.
+     * Injectable for deterministic tests and Scenar fixtures.
+     * @default () => new Date()
+     */
+    readonly now?: () => Date;
+}
+/**
+ * Column set for a schedule workbench — shared by every console so the
+ * list renders identically everywhere (DD-016).
+ *
+ * The columns exist because schedules are listed via the direct query:
+ * each row is a full `Schedule` proto, so the operational fields the
+ * issue calls for (next fire, last run, enabled/paused state) render
+ * straight from the row — no generic `SearchResult` limitations.
+ *
+ * Columns are not sortable: the direct query has one fixed server-side
+ * order (newest first), and a sort affordance that silently does
+ * nothing would lie.
+ */
+export declare function createScheduleColumns(options?: ScheduleColumnsOptions): WorkbenchColumnDef<Schedule>[];
+//# sourceMappingURL=scheduleColumns.d.ts.map

package/schedule/scheduleColumns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduleColumns.d.ts","sourceRoot":"","sources":["../../src/schedule/scheduleColumns.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uDAAuD,CAAC;AAGtF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGzE,iDAAiD;AACjD,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAmFhC"}

package/schedule/scheduleColumns.js

@@ -0,0 +1,77 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { timestampDate } from "@bufbuild/protobuf/wkt";
+import { formatRelativeTime } from "../activity/format-relative-time.js";
+import { StatusBadge } from "../resource-workbench/components/StatusBadge.js";
+import { deriveScheduleState, formatNextFire } from "./scheduleState.js";
+/**
+ * Column set for a schedule workbench — shared by every console so the
+ * list renders identically everywhere (DD-016).
+ *
+ * The columns exist because schedules are listed via the direct query:
+ * each row is a full `Schedule` proto, so the operational fields the
+ * issue calls for (next fire, last run, enabled/paused state) render
+ * straight from the row — no generic `SearchResult` limitations.
+ *
+ * Columns are not sortable: the direct query has one fixed server-side
+ * order (newest first), and a sort affordance that silently does
+ * nothing would lie.
+ */
+export function createScheduleColumns(options) {
+    const now = options?.now ?? (() => new Date());
+    return [
+        {
+            id: "name",
+            header: "Name",
+            cell: (item) => (_jsx("span", { className: "font-medium text-foreground", children: item.metadata?.name || item.metadata?.slug })),
+            flex: 2,
+        },
+        {
+            id: "state",
+            header: "State",
+            cell: (item) => {
+                const info = deriveScheduleState(item.spec, item.status);
+                return _jsx(StatusBadge, { phase: info.phase, label: info.label });
+            },
+            flex: 1,
+        },
+        {
+            id: "cron",
+            header: "Cadence",
+            cell: (item) => (_jsxs("span", { className: "inline-flex items-baseline gap-1.5", children: [_jsx("code", { className: "font-mono text-xs text-foreground", children: item.spec?.cron || "—" }), _jsx("span", { className: "text-xs text-muted-foreground", children: item.spec?.timeZone })] })),
+            flex: 1.5,
+        },
+        {
+            id: "next-fire",
+            header: "Next fire",
+            cell: (item) => {
+                const info = deriveScheduleState(item.spec, item.status);
+                const nextFireAt = item.status?.nextFireAt;
+                return (_jsx("span", { className: "text-muted-foreground", children: info.state === "active" && nextFireAt
+                        ? formatNextFire(timestampDate(nextFireAt), now())
+                        : "—" }));
+            },
+            flex: 1,
+        },
+        {
+            id: "last-run",
+            header: "Last run",
+            cell: (item) => (_jsx("span", { className: "text-muted-foreground", children: item.status?.lastFireAt
+                    ? formatRelativeTime(timestampDate(item.status.lastFireAt), now())
+                    : "Never" })),
+            flex: 1,
+        },
+        {
+            id: "target",
+            header: "Target agent",
+            cell: (item) => {
+                const target = item.spec?.target?.case === "agent" ? item.spec.target.value : undefined;
+                return (_jsx("span", { className: "text-muted-foreground", children: target?.agentRef
+                        ? `${target.agentRef.org}/${target.agentRef.slug}`
+                        : "—" }));
+            },
+            flex: 1.5,
+        },
+    ];
+}
+//# sourceMappingURL=scheduleColumns.js.map

package/schedule/scheduleColumns.js.map

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

package/schedule/scheduleListFn.d.ts

@@ -0,0 +1,50 @@
+import type { Schedule } from "@stigmer/protos/ai/stigmer/agentic/schedule/v1/api_pb";
+import { type ListSchedulesRequest, type ScheduleList } from "@stigmer/protos/ai/stigmer/agentic/schedule/v1/io_pb";
+import type { ListParams, ListResult } from "@stigmer/sdk";
+/** The slice of the Stigmer client this module needs (mockable in tests). */
+export interface ScheduleListClient {
+    readonly schedule: {
+        list(input: ListSchedulesRequest): Promise<ScheduleList>;
+    };
+}
+/** One page of schedules, with pagination totals. */
+export interface SchedulePage {
+    /** Full `Schedule` protos (spec + status) for the requested page. */
+    readonly items: readonly Schedule[];
+    /** Total schedules in the org (across all pages). */
+    readonly totalCount: number;
+    /** Total pages at the requested page size. */
+    readonly totalPages: number;
+}
+/**
+ * Fetch one page of an organization's schedules via the direct query.
+ *
+ * Handles a verified split between the two server editions: cloud slices
+ * pages server-side, while the OSS server documents that it ignores
+ * `page_info` and returns every matching schedule. A server that
+ * paginated can never return more rows than the requested size, so an
+ * overflowing response is the tell that the server ignored pagination —
+ * only then is the page sliced locally (absolute indices into the full
+ * list). A cloud page passes through untouched.
+ */
+export declare function listSchedulesPage(client: ScheduleListClient, org: string, page?: {
+    readonly num?: number;
+    readonly size?: number;
+}): Promise<SchedulePage>;
+/**
+ * Build a `ResourceWorkbench`-compatible `listFn` over the direct
+ * schedule query.
+ *
+ * The returned entries are full `Schedule` protos occupying the
+ * `SearchResult` slot of `ListResult` — `ResourceWorkbench` is generic
+ * over its row type (`useResourceCollection` casts entries through to
+ * `TData`), and this is the one documented place where that cast
+ * happens. Consumers type their workbench as
+ * `ResourceWorkbench<Schedule>` and pass `getItemId={(s) => s.metadata?.id}`.
+ *
+ * `params.query` and `params.crossOrgPublic` are ignored: schedules have
+ * no server-side text search (render the workbench with
+ * `searchable={false}`) and are never public/cross-org.
+ */
+export declare function createScheduleListFn(client: ScheduleListClient): (params: ListParams) => Promise<ListResult>;
+//# sourceMappingURL=scheduleListFn.d.ts.map

package/schedule/scheduleListFn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduleListFn.d.ts","sourceRoot":"","sources":["../../src/schedule/scheduleListFn.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uDAAuD,CAAC;AACtF,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,YAAY,EAClB,MAAM,sDAAsD,CAAC;AAE9D,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE3D,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE;QACjB,IAAI,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;KAC1D,CAAC;CACH;AAED,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IACpC,qDAAqD;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,kBAAkB,EAC1B,GAAG,EAAE,MAAM,EACX,IAAI,GAAE;IAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC3D,OAAO,CAAC,YAAY,CAAC,CAqBvB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,kBAAkB,GACzB,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,UAAU,CAAC,CAa7C"}

package/schedule/scheduleListFn.js

@@ -0,0 +1,65 @@
+// Schedule list fetching — the direct-query core plus the workbench adapter.
+//
+// Schedules are the one Library kind NOT backed by the search service: the
+// generic `SearchResult` summary cannot carry the operational fields a
+// schedule list exists to show (`next_fire_at`, enabled/paused state, last
+// run), while the direct `listSchedules` query returns full `Schedule`
+// protos and was explicitly shaped for "the org-context view a console tab
+// needs". Both consoles consume this single implementation — inlining it
+// per-app would duplicate correctness-bearing pagination logic (DD-016).
+import { create } from "@bufbuild/protobuf";
+import { ListSchedulesRequestSchema, } from "@stigmer/protos/ai/stigmer/agentic/schedule/v1/io_pb";
+const DEFAULT_PAGE_SIZE = 20;
+/**
+ * Fetch one page of an organization's schedules via the direct query.
+ *
+ * Handles a verified split between the two server editions: cloud slices
+ * pages server-side, while the OSS server documents that it ignores
+ * `page_info` and returns every matching schedule. A server that
+ * paginated can never return more rows than the requested size, so an
+ * overflowing response is the tell that the server ignored pagination —
+ * only then is the page sliced locally (absolute indices into the full
+ * list). A cloud page passes through untouched.
+ */
+export async function listSchedulesPage(client, org, page = {}) {
+    const size = page.size && page.size > 0 ? page.size : DEFAULT_PAGE_SIZE;
+    const num = page.num && page.num > 0 ? page.num : 1;
+    const result = await client.schedule.list(create(ListSchedulesRequestSchema, {
+        org,
+        pageInfo: { num, size },
+    }));
+    const items = result.items.length > size
+        ? result.items.slice((num - 1) * size, num * size)
+        : result.items;
+    return {
+        items,
+        totalCount: result.totalCount,
+        totalPages: Math.ceil(result.totalCount / size),
+    };
+}
+/**
+ * Build a `ResourceWorkbench`-compatible `listFn` over the direct
+ * schedule query.
+ *
+ * The returned entries are full `Schedule` protos occupying the
+ * `SearchResult` slot of `ListResult` — `ResourceWorkbench` is generic
+ * over its row type (`useResourceCollection` casts entries through to
+ * `TData`), and this is the one documented place where that cast
+ * happens. Consumers type their workbench as
+ * `ResourceWorkbench<Schedule>` and pass `getItemId={(s) => s.metadata?.id}`.
+ *
+ * `params.query` and `params.crossOrgPublic` are ignored: schedules have
+ * no server-side text search (render the workbench with
+ * `searchable={false}`) and are never public/cross-org.
+ */
+export function createScheduleListFn(client) {
+    return async (params) => {
+        const { items, totalCount, totalPages } = await listSchedulesPage(client, params.org, params.page ?? {});
+        return {
+            entries: items,
+            totalCount,
+            totalPages,
+        };
+    };
+}
+//# sourceMappingURL=scheduleListFn.js.map

package/schedule/scheduleListFn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduleListFn.js","sourceRoot":"","sources":["../../src/schedule/scheduleListFn.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,EAAE;AACF,2EAA2E;AAC3E,uEAAuE;AACvE,2EAA2E;AAC3E,uEAAuE;AACvE,2EAA2E;AAC3E,yEAAyE;AACzE,yEAAyE;AAEzE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EACL,0BAA0B,GAG3B,MAAM,sDAAsD,CAAC;AAqB9D,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAE7B;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAA0B,EAC1B,GAAW,EACX,OAA0D,EAAE;IAE5D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC;IACxE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CACvC,MAAM,CAAC,0BAA0B,EAAE;QACjC,GAAG;QACH,QAAQ,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE;KACxB,CAAC,CACH,CAAC;IAEF,MAAM,KAAK,GACT,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI;QACxB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,GAAG,IAAI,CAAC;QAClD,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;IAEnB,OAAO;QACL,KAAK;QACL,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC;KAChD,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAA0B;IAE1B,OAAO,KAAK,EAAE,MAAkB,EAAuB,EAAE;QACvD,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,MAAM,iBAAiB,CAC/D,MAAM,EACN,MAAM,CAAC,GAAG,EACV,MAAM,CAAC,IAAI,IAAI,EAAE,CAClB,CAAC;QACF,OAAO;YACL,OAAO,EAAE,KAAkC;YAC3C,UAAU;YACV,UAAU;SACX,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/schedule/scheduleState.d.ts

@@ -0,0 +1,43 @@
+import type { ScheduleSpec } from "@stigmer/protos/ai/stigmer/agentic/schedule/v1/spec_pb";
+import type { ScheduleStatus } from "@stigmer/protos/ai/stigmer/agentic/schedule/v1/status_pb";
+import type { StatusPhase } from "../resource-workbench/types.js";
+/** The three mutually-exclusive display states of a schedule. */
+export type ScheduleState = "active" | "disabled" | "paused";
+/** Derived display state: the tri-state plus its shared-badge rendering. */
+export interface ScheduleStateInfo {
+    /** The display state ("disabled" wins when both levers are set). */
+    readonly state: ScheduleState;
+    /** `StatusPhase` for the shared `StatusBadge` (`--stgm-status-*` tokens). */
+    readonly phase: StatusPhase;
+    /** Human-readable badge label. */
+    readonly label: string;
+    /**
+     * `true` when the platform pause latch is set — independent of the
+     * display state, so a disabled-AND-paused schedule can still surface
+     * its `status.pausedReason`.
+     */
+    readonly isPaused: boolean;
+}
+/**
+ * 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 declare function deriveScheduleState(spec: ScheduleSpec | undefined, status: ScheduleStatus | undefined): ScheduleStateInfo;
+/**
+ * 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 declare function formatNextFire(date: Date, now: Date): string;
+//# sourceMappingURL=scheduleState.d.ts.map

package/schedule/scheduleState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduleState.d.ts","sourceRoot":"","sources":["../../src/schedule/scheduleState.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wDAAwD,CAAC;AAC3F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0DAA0D,CAAC;AAC/F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAElE,iEAAiE;AACjE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE7D,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,YAAY,GAAG,SAAS,EAC9B,MAAM,EAAE,cAAc,GAAG,SAAS,GACjC,iBAAiB,CAUnB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,CAoB5D"}