@signalcore/ui 0.1.0 → 1.0.0-beta.1

package/dist/automation/RunView.js

@@ -0,0 +1,187 @@
+import { joined, useKit, useParts } from "../kit/context.js";
+import { Tag } from "../kit/Tag.js";
+import { appOf, groupsOf, namingOf } from "./record.js";
+import { ByMark, callMark } from "./marks.js";
+import { momentOf, tookOf } from "./when.js";
+import { Button } from "../kit/Button.js";
+import { Note } from "../kit/Note.js";
+import { useId } from "react";
+import { ChatCircleIcon, ChatsCircleIcon } from "@phosphor-icons/react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+//#region src/automation/RunView.tsx
+const STATUS_TONES = {
+	running: "info",
+	waiting: "warning",
+	done: "success",
+	failed: "danger",
+	skipped: void 0
+};
+/**
+* One run, as its owner reads it: a head with what started it, when, how long it took and how it
+* stands; the line it returned (a test's, as what it would have done); why it failed, in words;
+* then what it did, step by step in the code's order, each call in words ("Buscó en Gmail",
+* "Añadió una fila a Citas"; a test's writes as "Habría…"), the same call in a row once with how
+* many; and the conversations it opened, each opening through the host.
+*/
+function RunView({ run, automation = null, onOpenConversation, apps, now = /* @__PURE__ */ new Date(), className }) {
+	const part = useParts();
+	const { messages, code } = useKit();
+	const words = messages.automation;
+	const title = useId();
+	const names = namingOf(automation);
+	const groups = groupsOf(run.steps, words.calls, names);
+	const order = (automation?.steps ?? []).map((step) => step.name);
+	const app = automation?.trigger.app_title ?? automation?.trigger.app ?? null;
+	const by = words.by(run.by, app);
+	const took = tookOf(run, words);
+	return /* @__PURE__ */ jsxs("article", {
+		"aria-labelledby": title,
+		className: joined(part("sc-run"), className),
+		children: [
+			/* @__PURE__ */ jsxs("header", {
+				className: part("sc-run__head"),
+				children: [
+					/* @__PURE__ */ jsx("span", {
+						role: "img",
+						"aria-label": by,
+						title: by,
+						className: part("sc-run__by"),
+						children: /* @__PURE__ */ jsx(ByMark, {
+							by: run.by,
+							trigger: automation?.trigger ?? null,
+							size: 40,
+							apps
+						})
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: part("sc-run__heading"),
+						children: [/* @__PURE__ */ jsx("h3", {
+							id: title,
+							className: part("sc-run__title"),
+							children: run.title
+						}), /* @__PURE__ */ jsx("p", {
+							className: part("sc-run__meta"),
+							children: momentOf(new Date(run.started_at), now, words, code)
+						})]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: part("sc-run__end"),
+						children: [/* @__PURE__ */ jsxs(Tag, {
+							tone: STATUS_TONES[run.status],
+							children: [run.status === "running" && /* @__PURE__ */ jsx("i", {
+								"aria-hidden": true,
+								className: part("sc-run__live")
+							}), words.statuses[run.status]]
+						}), took !== null && /* @__PURE__ */ jsx("span", {
+							className: part("sc-run__took"),
+							children: took
+						})]
+					})
+				]
+			}),
+			run.summary !== null && /* @__PURE__ */ jsx("p", {
+				className: part("sc-run__summary"),
+				children: run.dry ? words.dry(run.summary) : run.summary
+			}),
+			run.status === "failed" && run.error !== null && /* @__PURE__ */ jsx(Note, {
+				tone: "danger",
+				children: run.error
+			}),
+			groups.length === 0 ? run.status !== "running" && /* @__PURE__ */ jsx("p", {
+				className: part("sc-run__empty"),
+				children: words.noCalls
+			}) : /* @__PURE__ */ jsx("ol", {
+				className: part("sc-run__steps"),
+				children: groups.map((group, index) => /* @__PURE__ */ jsx(Group, {
+					group,
+					number: group.step === null ? null : order.indexOf(group.step) + 1 || index + 1,
+					names,
+					words,
+					apps
+				}, `${index}:${group.step ?? ""}`))
+			}),
+			run.status === "running" && /* @__PURE__ */ jsxs("p", {
+				className: part("sc-run__empty"),
+				children: [/* @__PURE__ */ jsx("i", {
+					"aria-hidden": true,
+					className: part("sc-run__live")
+				}), words.statuses.running]
+			}),
+			onOpenConversation !== void 0 && (run.opened.length > 0 || run.conversation_id !== null) && /* @__PURE__ */ jsx(Links, {
+				run,
+				words,
+				onOpen: onOpenConversation
+			})
+		]
+	});
+}
+/** One step of the run: its number and name, then its calls in words. */
+function Group({ group, number, names, words, apps }) {
+	const part = useParts();
+	return /* @__PURE__ */ jsxs("li", {
+		className: part("sc-run__step"),
+		children: [/* @__PURE__ */ jsxs("p", {
+			className: part("sc-run__name"),
+			children: [/* @__PURE__ */ jsx("span", {
+				"aria-hidden": true,
+				className: part("sc-run__number"),
+				children: number ?? "·"
+			}), group.step ?? words.outside]
+		}), /* @__PURE__ */ jsx("ul", {
+			className: part("sc-run__calls"),
+			children: group.lines.map((line) => {
+				const first = line.calls[0];
+				const alias = first ? appOf(first.call) : null;
+				return /* @__PURE__ */ jsxs("li", {
+					className: part("sc-run__call", ...line.would ? ["sc-run__call--would"] : [], ...line.error !== null ? ["sc-run__call--failed"] : []),
+					children: [first && callMark(first, alias === null ? null : {
+						name: names.app(alias),
+						icon: names.icon(alias)
+					}, apps, 20), /* @__PURE__ */ jsxs("span", { children: [
+						line.text,
+						line.count > 1 && /* @__PURE__ */ jsxs("span", {
+							className: part("sc-run__count"),
+							children: [" ", words.times(line.count)]
+						}),
+						line.error !== null && /* @__PURE__ */ jsx("span", {
+							className: part("sc-run__error"),
+							children: line.error
+						})
+					] })]
+				}, line.seq);
+			})
+		})]
+	});
+}
+/** The conversation it was asked in, then the ones it opened: each a button the host opens. */
+function Links({ run, words, onOpen }) {
+	const part = useParts();
+	const asked = run.conversation_id;
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [asked !== null && /* @__PURE__ */ jsx("div", {
+		className: part("sc-run__links"),
+		children: /* @__PURE__ */ jsx(Button, {
+			size: "sm",
+			icon: ChatCircleIcon,
+			onClick: () => onOpen(asked),
+			children: words.askedIn
+		})
+	}), run.opened.length > 0 && /* @__PURE__ */ jsxs("section", {
+		className: part("sc-run__section"),
+		children: [/* @__PURE__ */ jsx("h4", {
+			className: part("sc-run__label"),
+			children: words.opened
+		}), /* @__PURE__ */ jsx("div", {
+			className: part("sc-run__links"),
+			children: run.opened.map((id, index) => /* @__PURE__ */ jsx(Button, {
+				size: "sm",
+				icon: ChatsCircleIcon,
+				onClick: () => onOpen(id),
+				children: words.conversation(index + 1)
+			}, id))
+		})]
+	})] });
+}
+//#endregion
+export { RunView };
+
+//# sourceMappingURL=RunView.js.map

package/dist/automation/RunView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RunView.js","names":[],"sources":["../../src/automation/RunView.tsx"],"sourcesContent":["import { ChatCircleIcon, ChatsCircleIcon } from \"@phosphor-icons/react\";\nimport { useId } from \"react\";\n\nimport type { AppDirectory } from \"../AgentAbout\";\nimport { Button } from \"../kit/Button\";\nimport { joined, useKit, useParts } from \"../kit/context\";\nimport { Note } from \"../kit/Note\";\nimport { Tag } from \"../kit/Tag\";\nimport { ByMark, callMark } from \"./marks\";\nimport type { AutomationMessages } from \"./messages\";\nimport { appOf, groupsOf, namingOf, type Names, type StepGroup } from \"./record\";\nimport type { Automation, RunRecord, RunStatus } from \"./types\";\nimport { momentOf, tookOf } from \"./when\";\n\nexport interface RunViewProps {\n  run: RunRecord;\n  /** The automation it is a run of: its steps' order, its apps' names and logos, its table. */\n  automation?: Automation | null | undefined;\n  /** Opening a conversation the run opened, or the one it was asked in; without it, none opens. */\n  onOpenConversation?: ((id: string) => void) | undefined;\n  /** The host's logos for apps; without them an app shows the logo the API gives. */\n  apps?: AppDirectory | undefined;\n  /** What time it is, for the words that say when; now by default. */\n  now?: Date | undefined;\n  className?: string | undefined;\n}\n\nconst STATUS_TONES: Readonly<\n  Record<RunStatus, \"success\" | \"danger\" | \"info\" | \"warning\" | undefined>\n> = {\n  running: \"info\",\n  waiting: \"warning\",\n  done: \"success\",\n  failed: \"danger\",\n  skipped: undefined,\n};\n\n/**\n * One run, as its owner reads it: a head with what started it, when, how long it took and how it\n * stands; the line it returned (a test's, as what it would have done); why it failed, in words;\n * then what it did, step by step in the code's order, each call in words (\"Buscó en Gmail\",\n * \"Añadió una fila a Citas\"; a test's writes as \"Habría…\"), the same call in a row once with how\n * many; and the conversations it opened, each opening through the host.\n */\nexport function RunView({\n  run,\n  automation = null,\n  onOpenConversation,\n  apps,\n  now = new Date(),\n  className,\n}: RunViewProps) {\n  const part = useParts();\n  const { messages, code } = useKit();\n  const words = messages.automation;\n  const title = useId();\n  const names = namingOf(automation);\n  const groups = groupsOf(run.steps, words.calls, names);\n  const order = (automation?.steps ?? []).map((step) => step.name);\n  const app = automation?.trigger.app_title ?? automation?.trigger.app ?? null;\n  // What started it is its mark's to show; its words are the mark's name, and its hint.\n  const by = words.by(run.by, app);\n  const took = tookOf(run, words);\n  return (\n    <article aria-labelledby={title} className={joined(part(\"sc-run\"), className)}>\n      <header className={part(\"sc-run__head\")}>\n        <span role=\"img\" aria-label={by} title={by} className={part(\"sc-run__by\")}>\n          <ByMark by={run.by} trigger={automation?.trigger ?? null} size={40} apps={apps} />\n        </span>\n        <div className={part(\"sc-run__heading\")}>\n          <h3 id={title} className={part(\"sc-run__title\")}>\n            {run.title}\n          </h3>\n          <p className={part(\"sc-run__meta\")}>\n            {momentOf(new Date(run.started_at), now, words, code)}\n          </p>\n        </div>\n        <div className={part(\"sc-run__end\")}>\n          <Tag tone={STATUS_TONES[run.status]}>\n            {run.status === \"running\" && <i aria-hidden className={part(\"sc-run__live\")} />}\n            {words.statuses[run.status]}\n          </Tag>\n          {took !== null && <span className={part(\"sc-run__took\")}>{took}</span>}\n        </div>\n      </header>\n      {run.summary !== null && (\n        <p className={part(\"sc-run__summary\")}>{run.dry ? words.dry(run.summary) : run.summary}</p>\n      )}\n      {run.status === \"failed\" && run.error !== null && <Note tone=\"danger\">{run.error}</Note>}\n      {groups.length === 0 ? (\n        run.status !== \"running\" && <p className={part(\"sc-run__empty\")}>{words.noCalls}</p>\n      ) : (\n        <ol className={part(\"sc-run__steps\")}>\n          {groups.map((group, index) => (\n            <Group\n              key={`${index}:${group.step ?? \"\"}`}\n              group={group}\n              number={group.step === null ? null : order.indexOf(group.step) + 1 || index + 1}\n              names={names}\n              words={words}\n              apps={apps}\n            />\n          ))}\n        </ol>\n      )}\n      {run.status === \"running\" && (\n        <p className={part(\"sc-run__empty\")}>\n          <i aria-hidden className={part(\"sc-run__live\")} />\n          {words.statuses.running}\n        </p>\n      )}\n      {onOpenConversation !== undefined &&\n        (run.opened.length > 0 || run.conversation_id !== null) && (\n          <Links run={run} words={words} onOpen={onOpenConversation} />\n        )}\n    </article>\n  );\n}\n\n/** One step of the run: its number and name, then its calls in words. */\nfunction Group({\n  group,\n  number,\n  names,\n  words,\n  apps,\n}: {\n  group: StepGroup;\n  number: number | null;\n  names: Names;\n  words: AutomationMessages;\n  apps: AppDirectory | undefined;\n}) {\n  const part = useParts();\n  return (\n    <li className={part(\"sc-run__step\")}>\n      <p className={part(\"sc-run__name\")}>\n        <span aria-hidden className={part(\"sc-run__number\")}>\n          {number ?? \"·\"}\n        </span>\n        {group.step ?? words.outside}\n      </p>\n      <ul className={part(\"sc-run__calls\")}>\n        {group.lines.map((line) => {\n          const first = line.calls[0];\n          const alias = first ? appOf(first.call) : null;\n          return (\n            <li\n              key={line.seq}\n              className={part(\n                \"sc-run__call\",\n                ...(line.would ? ([\"sc-run__call--would\"] as const) : []),\n                ...(line.error !== null ? ([\"sc-run__call--failed\"] as const) : []),\n              )}\n            >\n              {first &&\n                callMark(\n                  first,\n                  alias === null ? null : { name: names.app(alias), icon: names.icon(alias) },\n                  apps,\n                  20,\n                )}\n              <span>\n                {line.text}\n                {line.count > 1 && (\n                  <span className={part(\"sc-run__count\")}> {words.times(line.count)}</span>\n                )}\n                {line.error !== null && <span className={part(\"sc-run__error\")}>{line.error}</span>}\n              </span>\n            </li>\n          );\n        })}\n      </ul>\n    </li>\n  );\n}\n\n/** The conversation it was asked in, then the ones it opened: each a button the host opens. */\nfunction Links({\n  run,\n  words,\n  onOpen,\n}: {\n  run: RunRecord;\n  words: AutomationMessages;\n  onOpen: (id: string) => void;\n}) {\n  const part = useParts();\n  const asked = run.conversation_id;\n  return (\n    <>\n      {asked !== null && (\n        <div className={part(\"sc-run__links\")}>\n          <Button size=\"sm\" icon={ChatCircleIcon} onClick={() => onOpen(asked)}>\n            {words.askedIn}\n          </Button>\n        </div>\n      )}\n      {run.opened.length > 0 && (\n        <section className={part(\"sc-run__section\")}>\n          <h4 className={part(\"sc-run__label\")}>{words.opened}</h4>\n          <div className={part(\"sc-run__links\")}>\n            {run.opened.map((id, index) => (\n              <Button key={id} size=\"sm\" icon={ChatsCircleIcon} onClick={() => onOpen(id)}>\n                {words.conversation(index + 1)}\n              </Button>\n            ))}\n          </div>\n        </section>\n      )}\n    </>\n  );\n}\n"],"mappings":"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"}

package/dist/automation/cron.d.ts

@@ -0,0 +1,41 @@
+//#region src/automation/cron.d.ts
+/**
+ * A schedule's cron line, read into what it fires at: the moments of a day (a squad's day, an
+ * automation's next runs) and the sentence that says it (`whenOf`). Five fields (minute, hour,
+ * day of the month, month, day of the week) with `*`, lists, ranges, steps and English names, as
+ * the API's croniter reads them; anything past that is not read (null).
+ */
+export interface Cron {
+  minutes: ReadonlySet<number>;
+  hours: ReadonlySet<number>;
+  /** Day of the month, 1–31. */
+  days: ReadonlySet<number>;
+  /** 1–12. */
+  months: ReadonlySet<number>;
+  /** 0–6, Sunday 0. */
+  weekdays: ReadonlySet<number>;
+  /** Left open (`*`): cron's rule for days reads which of the two narrows them. */
+  anyDay: boolean;
+  anyWeekday: boolean;
+}
+/** A cron line of five fields, or null when it is anything else. */
+export declare function parseCron(line: string): Cron | null;
+/** A moment as a zone's clock reads it. */
+export interface Wall {
+  minute: number;
+  hour: number;
+  day: number;
+  month: number;
+  weekday: number;
+}
+/**
+ * Whether the line fires at that minute. Days follow cron's rule: when both the day of the month
+ * and the day of the week are narrowed, either one is enough.
+ */
+export declare function fires(cron: Cron, at: Wall): boolean;
+/** How far the zone's clock is ahead of UTC at a moment, in milliseconds. */
+export declare function offsetOf(zone: string, at: Date): number;
+/** Every moment in [from, to) the line fires at, read on the clock of `zone`. */
+export declare function occurrences(cron: Cron, zone: string, from: Date, to: Date): Date[];
+//#endregion
+//# sourceMappingURL=cron.d.ts.map

package/dist/automation/cron.js

@@ -0,0 +1,169 @@
+//#region src/automation/cron.ts
+const FIELDS = [
+	{
+		min: 0,
+		max: 59
+	},
+	{
+		min: 0,
+		max: 23
+	},
+	{
+		min: 1,
+		max: 31
+	},
+	{
+		min: 1,
+		max: 12,
+		names: [
+			"jan",
+			"feb",
+			"mar",
+			"apr",
+			"may",
+			"jun",
+			"jul",
+			"aug",
+			"sep",
+			"oct",
+			"nov",
+			"dec"
+		]
+	},
+	{
+		min: 0,
+		max: 7,
+		names: [
+			"sun",
+			"mon",
+			"tue",
+			"wed",
+			"thu",
+			"fri",
+			"sat"
+		]
+	}
+];
+/** One value of a field: a number in its bounds, or one of its names (`mon`, `jan`). */
+function valueOf(text, field) {
+	const named = field.names?.indexOf(text.toLowerCase()) ?? -1;
+	if (named >= 0) return named + field.min;
+	if (!/^\d+$/.test(text)) return null;
+	const value = Number(text);
+	return value >= field.min && value <= field.max ? value : null;
+}
+/** A field's values: `*`, `5`, `1-5`, `*` every 15, `8-18` every 2, `mon-fri`, and lists of them. */
+function parseField(text, field) {
+	const values = /* @__PURE__ */ new Set();
+	for (const part of text.split(",")) {
+		const [range = "", stepText] = part.split("/");
+		const step = stepText === void 0 ? 1 : Number(stepText);
+		if (!Number.isInteger(step) || step < 1) return null;
+		let from;
+		let to;
+		if (range === "*") [from, to] = [field.min, field.max];
+		else {
+			const [first = "", last] = range.split("-");
+			from = valueOf(first, field);
+			to = last !== void 0 ? valueOf(last, field) : stepText !== void 0 ? field.max : from;
+		}
+		if (from === null || to === null || from > to) return null;
+		for (let value = from; value <= to; value += step) values.add(value);
+	}
+	return [...values];
+}
+/** A cron line of five fields, or null when it is anything else. */
+function parseCron(line) {
+	const texts = line.trim().split(/\s+/);
+	if (texts.length !== 5) return null;
+	const [minutes, hours, days, months, weekdays] = texts.map((text, at) => {
+		const field = FIELDS[at];
+		return field ? parseField(text, field) : null;
+	});
+	if (!minutes || !hours || !days || !months || !weekdays) return null;
+	return {
+		minutes: new Set(minutes),
+		hours: new Set(hours),
+		days: new Set(days),
+		months: new Set(months),
+		weekdays: new Set(weekdays.map((day) => day % 7)),
+		anyDay: texts[2]?.startsWith("*") ?? false,
+		anyWeekday: texts[4]?.startsWith("*") ?? false
+	};
+}
+/**
+* Whether the line fires at that minute. Days follow cron's rule: when both the day of the month
+* and the day of the week are narrowed, either one is enough.
+*/
+function fires(cron, at) {
+	if (!cron.minutes.has(at.minute) || !cron.hours.has(at.hour) || !cron.months.has(at.month)) return false;
+	const day = cron.days.has(at.day);
+	const weekday = cron.weekdays.has(at.weekday);
+	if (cron.anyDay && cron.anyWeekday) return true;
+	if (cron.anyDay) return weekday;
+	if (cron.anyWeekday) return day;
+	return day || weekday;
+}
+const MINUTE = 6e4;
+/** How often the zone's offset is read again: a quarter of an hour meets every zone's changes. */
+const QUARTER = 15 * MINUTE;
+const clocks = /* @__PURE__ */ new Map();
+/** The zone's clock, kept; an unknown zone reads as UTC, the API's default. */
+function clockOf(zone) {
+	let clock = clocks.get(zone);
+	if (!clock) {
+		const options = {
+			hourCycle: "h23",
+			year: "numeric",
+			month: "numeric",
+			day: "numeric",
+			hour: "numeric",
+			minute: "numeric",
+			second: "numeric"
+		};
+		try {
+			clock = new Intl.DateTimeFormat("en-US", {
+				...options,
+				timeZone: zone
+			});
+		} catch {
+			clock = new Intl.DateTimeFormat("en-US", {
+				...options,
+				timeZone: "UTC"
+			});
+		}
+		clocks.set(zone, clock);
+	}
+	return clock;
+}
+/** How far the zone's clock is ahead of UTC at a moment, in milliseconds. */
+function offsetOf(zone, at) {
+	const parts = clockOf(zone).formatToParts(at);
+	const part = (type) => Number(parts.find((each) => each.type === type)?.value ?? 0);
+	return Date.UTC(part("year"), part("month") - 1, part("day"), part("hour") % 24, part("minute"), part("second")) - Math.floor(at.getTime() / 1e3) * 1e3;
+}
+/** Every moment in [from, to) the line fires at, read on the clock of `zone`. */
+function occurrences(cron, zone, from, to) {
+	const out = [];
+	let quarter = NaN;
+	let offset = 0;
+	for (let at = Math.ceil(from.getTime() / MINUTE) * MINUTE; at < to.getTime(); at += MINUTE) {
+		if (Math.floor(at / QUARTER) !== quarter) {
+			quarter = Math.floor(at / QUARTER);
+			offset = offsetOf(zone, new Date(at));
+		}
+		const wall = new Date(at + offset);
+		if (fires(cron, {
+			minute: wall.getUTCMinutes(),
+			hour: wall.getUTCHours(),
+			day: wall.getUTCDate(),
+			month: wall.getUTCMonth() + 1,
+			weekday: wall.getUTCDay()
+		})) out.push(new Date(at));
+	}
+	return out;
+}
+//#endregion
+export { fires, occurrences, offsetOf, parseCron };
+
+//# sourceMappingURL=cron.js.map

package/dist/automation/cron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.js","names":[],"sources":["../../src/automation/cron.ts"],"sourcesContent":["/**\n * A schedule's cron line, read into what it fires at: the moments of a day (a squad's day, an\n * automation's next runs) and the sentence that says it (`whenOf`). Five fields (minute, hour,\n * day of the month, month, day of the week) with `*`, lists, ranges, steps and English names, as\n * the API's croniter reads them; anything past that is not read (null).\n */\n\nexport interface Cron {\n  minutes: ReadonlySet<number>;\n  hours: ReadonlySet<number>;\n  /** Day of the month, 1–31. */\n  days: ReadonlySet<number>;\n  /** 1–12. */\n  months: ReadonlySet<number>;\n  /** 0–6, Sunday 0. */\n  weekdays: ReadonlySet<number>;\n  /** Left open (`*`): cron's rule for days reads which of the two narrows them. */\n  anyDay: boolean;\n  anyWeekday: boolean;\n}\n\ninterface Field {\n  min: number;\n  max: number;\n  names?: readonly string[];\n}\n\nconst MONTH_NAMES = [\n  \"jan\",\n  \"feb\",\n  \"mar\",\n  \"apr\",\n  \"may\",\n  \"jun\",\n  \"jul\",\n  \"aug\",\n  \"sep\",\n  \"oct\",\n  \"nov\",\n  \"dec\",\n] as const;\nconst WEEKDAY_NAMES = [\"sun\", \"mon\", \"tue\", \"wed\", \"thu\", \"fri\", \"sat\"] as const;\n\nconst FIELDS: readonly Field[] = [\n  { min: 0, max: 59 },\n  { min: 0, max: 23 },\n  { min: 1, max: 31 },\n  { min: 1, max: 12, names: MONTH_NAMES },\n  { min: 0, max: 7, names: WEEKDAY_NAMES },\n];\n\n/** One value of a field: a number in its bounds, or one of its names (`mon`, `jan`). */\nfunction valueOf(text: string, field: Field): number | null {\n  const named = field.names?.indexOf(text.toLowerCase()) ?? -1;\n  if (named >= 0) return named + field.min;\n  if (!/^\\d+$/.test(text)) return null;\n  const value = Number(text);\n  return value >= field.min && value <= field.max ? value : null;\n}\n\n/** A field's values: `*`, `5`, `1-5`, `*` every 15, `8-18` every 2, `mon-fri`, and lists of them. */\nfunction parseField(text: string, field: Field): number[] | null {\n  const values = new Set<number>();\n  for (const part of text.split(\",\")) {\n    const [range = \"\", stepText] = part.split(\"/\");\n    const step = stepText === undefined ? 1 : Number(stepText);\n    if (!Number.isInteger(step) || step < 1) return null;\n    let from: number | null;\n    let to: number | null;\n    if (range === \"*\") {\n      [from, to] = [field.min, field.max];\n    } else {\n      const [first = \"\", last] = range.split(\"-\");\n      from = valueOf(first, field);\n      // \"8/2\" runs from 8 to the end of the field, as cron reads it.\n      to = last !== undefined ? valueOf(last, field) : stepText !== undefined ? field.max : from;\n    }\n    if (from === null || to === null || from > to) return null;\n    for (let value = from; value <= to; value += step) values.add(value);\n  }\n  return [...values];\n}\n\n/** A cron line of five fields, or null when it is anything else. */\nexport function parseCron(line: string): Cron | null {\n  const texts = line.trim().split(/\\s+/);\n  if (texts.length !== 5) return null;\n  const [minutes, hours, days, months, weekdays] = texts.map((text, at) => {\n    const field = FIELDS[at];\n    return field ? parseField(text, field) : null;\n  });\n  if (!minutes || !hours || !days || !months || !weekdays) return null;\n  return {\n    minutes: new Set(minutes),\n    hours: new Set(hours),\n    days: new Set(days),\n    months: new Set(months),\n    // 7 is Sunday too.\n    weekdays: new Set(weekdays.map((day) => day % 7)),\n    anyDay: texts[2]?.startsWith(\"*\") ?? false,\n    anyWeekday: texts[4]?.startsWith(\"*\") ?? false,\n  };\n}\n\n/** A moment as a zone's clock reads it. */\nexport interface Wall {\n  minute: number;\n  hour: number;\n  day: number;\n  month: number;\n  weekday: number;\n}\n\n/**\n * Whether the line fires at that minute. Days follow cron's rule: when both the day of the month\n * and the day of the week are narrowed, either one is enough.\n */\nexport function fires(cron: Cron, at: Wall): boolean {\n  if (!cron.minutes.has(at.minute) || !cron.hours.has(at.hour) || !cron.months.has(at.month)) {\n    return false;\n  }\n  const day = cron.days.has(at.day);\n  const weekday = cron.weekdays.has(at.weekday);\n  if (cron.anyDay && cron.anyWeekday) return true;\n  if (cron.anyDay) return weekday;\n  if (cron.anyWeekday) return day;\n  return day || weekday;\n}\n\nconst MINUTE = 60_000;\n/** How often the zone's offset is read again: a quarter of an hour meets every zone's changes. */\nconst QUARTER = 15 * MINUTE;\n\nconst clocks = new Map<string, Intl.DateTimeFormat>();\n\n/** The zone's clock, kept; an unknown zone reads as UTC, the API's default. */\nfunction clockOf(zone: string): Intl.DateTimeFormat {\n  let clock = clocks.get(zone);\n  if (!clock) {\n    const options: Intl.DateTimeFormatOptions = {\n      hourCycle: \"h23\",\n      year: \"numeric\",\n      month: \"numeric\",\n      day: \"numeric\",\n      hour: \"numeric\",\n      minute: \"numeric\",\n      second: \"numeric\",\n    };\n    try {\n      clock = new Intl.DateTimeFormat(\"en-US\", { ...options, timeZone: zone });\n    } catch {\n      clock = new Intl.DateTimeFormat(\"en-US\", { ...options, timeZone: \"UTC\" });\n    }\n    clocks.set(zone, clock);\n  }\n  return clock;\n}\n\n/** How far the zone's clock is ahead of UTC at a moment, in milliseconds. */\nexport function offsetOf(zone: string, at: Date): number {\n  const parts = clockOf(zone).formatToParts(at);\n  const part = (type: Intl.DateTimeFormatPartTypes) =>\n    Number(parts.find((each) => each.type === type)?.value ?? 0);\n  const wall = Date.UTC(\n    part(\"year\"),\n    part(\"month\") - 1,\n    part(\"day\"),\n    part(\"hour\") % 24,\n    part(\"minute\"),\n    part(\"second\"),\n  );\n  return wall - Math.floor(at.getTime() / 1000) * 1000;\n}\n\n/** Every moment in [from, to) the line fires at, read on the clock of `zone`. */\nexport function occurrences(cron: Cron, zone: string, from: Date, to: Date): Date[] {\n  const out: Date[] = [];\n  let quarter = Number.NaN;\n  let offset = 0;\n  for (let at = Math.ceil(from.getTime() / MINUTE) * MINUTE; at < to.getTime(); at += MINUTE) {\n    if (Math.floor(at / QUARTER) !== quarter) {\n      quarter = Math.floor(at / QUARTER);\n      offset = offsetOf(zone, new Date(at));\n    }\n    const wall = new Date(at + offset);\n    const fired = fires(cron, {\n      minute: wall.getUTCMinutes(),\n      hour: wall.getUTCHours(),\n      day: wall.getUTCDate(),\n      month: wall.getUTCMonth() + 1,\n      weekday: wall.getUTCDay(),\n    });\n    if (fired) out.push(new Date(at));\n  }\n  return out;\n}\n"],"mappings":"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"}

package/dist/automation/marks.js

@@ -0,0 +1,121 @@
+import { Mark } from "../kit/Mark.js";
+import { sentOn } from "./record.js";
+import { BellIcon, BrainIcon, ChatCircleIcon, ChatTextIcon, ChatsCircleIcon, ClockIcon, FileTextIcon, FlaskIcon, GlobeIcon, LightningIcon, SparkleIcon, TableIcon, WebhooksLogoIcon } from "@phosphor-icons/react";
+import { Fragment, jsx } from "react/jsx-runtime";
+//#region src/automation/marks.tsx
+/** Only an https logo is loaded: never a script, never a local file. */
+const https = (url) => url !== null && /^https:\/\//i.test(url);
+/**
+* An app's mark: the host's logo when it draws apps (`apps`), else the logo the API gives, else
+* the app's initial; each bare, as `Mark` draws it.
+*/
+function AppMark({ name, icon, size, apps }) {
+	if (apps !== void 0) return /* @__PURE__ */ jsx(Fragment, { children: apps.logo({
+		provider: "",
+		name,
+		icon,
+		size
+	}) });
+	if (https(icon)) return /* @__PURE__ */ jsx(Mark, {
+		src: icon,
+		size
+	});
+	return /* @__PURE__ */ jsx(Mark, {
+		size,
+		children: /* @__PURE__ */ jsx("span", { children: name.trim().charAt(0).toUpperCase() || "?" })
+	});
+}
+const KINDS = {
+	schedule: ClockIcon,
+	webhook: WebhooksLogoIcon
+};
+/** What starts an automation, as a mark: a clock, a webhook, the app whose event it waits for. */
+function TriggerMark({ trigger, size, apps }) {
+	if (trigger.kind !== "event") return /* @__PURE__ */ jsx(Mark, {
+		icon: KINDS[trigger.kind],
+		size
+	});
+	const name = trigger.app_title ?? trigger.app;
+	if (name === null) return /* @__PURE__ */ jsx(Mark, {
+		icon: LightningIcon,
+		size
+	});
+	return /* @__PURE__ */ jsx(AppMark, {
+		name,
+		icon: trigger.icon,
+		size,
+		apps
+	});
+}
+/** What started a run: its time, a call, its app's event, a chat with the agent, a test. */
+const BY = {
+	schedule: ClockIcon,
+	webhook: WebhooksLogoIcon,
+	agent: ChatCircleIcon,
+	test: FlaskIcon
+};
+function ByMark({ by, trigger, size, apps }) {
+	if (by !== "event") return /* @__PURE__ */ jsx(Mark, {
+		icon: BY[by],
+		size
+	});
+	return trigger === null ? /* @__PURE__ */ jsx(Mark, {
+		icon: LightningIcon,
+		size
+	}) : /* @__PURE__ */ jsx(TriggerMark, {
+		trigger,
+		size,
+		apps
+	});
+}
+/**
+* What a step uses, other than an app: the model, the agent, the inbox, a message on a channel, a
+* table, the web.
+*/
+const USES = {
+	ai: SparkleIcon,
+	agent: ChatsCircleIcon,
+	notify: BellIcon,
+	send: ChatTextIcon,
+	data: TableIcon,
+	http: GlobeIcon
+};
+/** A call of a run's record, by what it reached; an app's tool by the app's mark. */
+const CALLS = {
+	ai: SparkleIcon,
+	notify: BellIcon,
+	send: ChatTextIcon,
+	"agent.start": ChatsCircleIcon,
+	"data.find": TableIcon,
+	"data.add": TableIcon,
+	"data.update": TableIcon,
+	http: GlobeIcon,
+	"files.search": FileTextIcon,
+	"files.read": FileTextIcon,
+	"files.write": FileTextIcon,
+	"files.list": FileTextIcon,
+	"memory.remember": BrainIcon,
+	"memory.recall": BrainIcon
+};
+function callMark(step, app, apps, size) {
+	if (app !== null) return /* @__PURE__ */ jsx(AppMark, {
+		name: app.name,
+		icon: app.icon,
+		size,
+		apps
+	});
+	const channel = step.call === "send" ? sentOn(step) : null;
+	if (channel !== null && apps !== void 0) return apps.logo({
+		provider: channel,
+		name: channel,
+		size
+	});
+	return /* @__PURE__ */ jsx(Mark, {
+		icon: CALLS[step.call] ?? LightningIcon,
+		size
+	});
+}
+//#endregion
+export { AppMark, ByMark, TriggerMark, USES, callMark };
+
+//# sourceMappingURL=marks.js.map

package/dist/automation/marks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marks.js","names":[],"sources":["../../src/automation/marks.tsx"],"sourcesContent":["import {\n  BellIcon,\n  BrainIcon,\n  ChatCircleIcon,\n  ChatTextIcon,\n  ChatsCircleIcon,\n  ClockIcon,\n  FileTextIcon,\n  FlaskIcon,\n  GlobeIcon,\n  LightningIcon,\n  SparkleIcon,\n  TableIcon,\n  WebhooksLogoIcon,\n  type Icon,\n} from \"@phosphor-icons/react\";\nimport type { ReactNode } from \"react\";\n\nimport type { AppDirectory } from \"../AgentAbout\";\nimport { Mark } from \"../kit/Mark\";\nimport { sentOn } from \"./record\";\nimport type { RunBy, RunStep, Trigger, Use } from \"./types\";\n\n/** Only an https logo is loaded: never a script, never a local file. */\nconst https = (url: string | null): url is string => url !== null && /^https:\\/\\//i.test(url);\n\n/**\n * An app's mark: the host's logo when it draws apps (`apps`), else the logo the API gives, else\n * the app's initial; each bare, as `Mark` draws it.\n */\nexport function AppMark({\n  name,\n  icon,\n  size,\n  apps,\n}: {\n  name: string;\n  icon: string | null;\n  size: number;\n  apps: AppDirectory | undefined;\n}) {\n  if (apps !== undefined) return <>{apps.logo({ provider: \"\", name, icon, size })}</>;\n  if (https(icon)) return <Mark src={icon} size={size} />;\n  return (\n    <Mark size={size}>\n      <span>{name.trim().charAt(0).toUpperCase() || \"?\"}</span>\n    </Mark>\n  );\n}\n\nconst KINDS: Readonly<Record<Exclude<Trigger[\"kind\"], \"event\">, Icon>> = {\n  schedule: ClockIcon,\n  webhook: WebhooksLogoIcon,\n};\n\n/** What starts an automation, as a mark: a clock, a webhook, the app whose event it waits for. */\nexport function TriggerMark({\n  trigger,\n  size,\n  apps,\n}: {\n  trigger: Trigger;\n  size: number;\n  apps: AppDirectory | undefined;\n}) {\n  if (trigger.kind !== \"event\") return <Mark icon={KINDS[trigger.kind]} size={size} />;\n  const name = trigger.app_title ?? trigger.app;\n  if (name === null) return <Mark icon={LightningIcon} size={size} />;\n  return <AppMark name={name} icon={trigger.icon} size={size} apps={apps} />;\n}\n\n/** What started a run: its time, a call, its app's event, a chat with the agent, a test. */\nconst BY: Readonly<Record<Exclude<RunBy, \"event\">, Icon>> = {\n  schedule: ClockIcon,\n  webhook: WebhooksLogoIcon,\n  agent: ChatCircleIcon,\n  test: FlaskIcon,\n};\n\nexport function ByMark({\n  by,\n  trigger,\n  size,\n  apps,\n}: {\n  by: RunBy;\n  /** The automation's, for an event's app; none, a plain mark. */\n  trigger: Trigger | null;\n  size: number;\n  apps: AppDirectory | undefined;\n}) {\n  if (by !== \"event\") return <Mark icon={BY[by]} size={size} />;\n  return trigger === null ? (\n    <Mark icon={LightningIcon} size={size} />\n  ) : (\n    <TriggerMark trigger={trigger} size={size} apps={apps} />\n  );\n}\n\n/**\n * What a step uses, other than an app: the model, the agent, the inbox, a message on a channel, a\n * table, the web.\n */\nexport const USES: Readonly<Record<Exclude<Use[\"kind\"], \"app\">, Icon>> = {\n  ai: SparkleIcon,\n  agent: ChatsCircleIcon,\n  notify: BellIcon,\n  send: ChatTextIcon,\n  data: TableIcon,\n  http: GlobeIcon,\n};\n\n/** A call of a run's record, by what it reached; an app's tool by the app's mark. */\nconst CALLS: Readonly<Record<string, Icon>> = {\n  ai: SparkleIcon,\n  notify: BellIcon,\n  send: ChatTextIcon,\n  \"agent.start\": ChatsCircleIcon,\n  \"data.find\": TableIcon,\n  \"data.add\": TableIcon,\n  \"data.update\": TableIcon,\n  http: GlobeIcon,\n  \"files.search\": FileTextIcon,\n  \"files.read\": FileTextIcon,\n  \"files.write\": FileTextIcon,\n  \"files.list\": FileTextIcon,\n  \"memory.remember\": BrainIcon,\n  \"memory.recall\": BrainIcon,\n};\n\nexport function callMark(\n  step: RunStep,\n  app: { name: string; icon: string | null } | null,\n  apps: AppDirectory | undefined,\n  size: number,\n): ReactNode {\n  if (app !== null) return <AppMark name={app.name} icon={app.icon} size={size} apps={apps} />;\n  // A message sent on a channel: the channel's brand, when the host draws brands and it is known.\n  const channel = step.call === \"send\" ? sentOn(step) : null;\n  if (channel !== null && apps !== undefined) {\n    return apps.logo({ provider: channel, name: channel, size });\n  }\n  return <Mark icon={CALLS[step.call] ?? LightningIcon} size={size} />;\n}\n"],"mappings":";;;;;;AAwBA,MAAM,SAAS,QAAsC,QAAQ,QAAQ,eAAe,KAAK,GAAG;;;;;AAM5F,SAAgB,QAAQ,EACtB,MACA,MACA,MACA,QAMC;CACD,IAAI,SAAS,KAAA,GAAW,OAAO,oBAAA,UAAA,EAAA,UAAG,KAAK,KAAK;EAAE,UAAU;EAAI;EAAM;EAAM;CAAK,CAAC,EAAI,CAAA;CAClF,IAAI,MAAM,IAAI,GAAG,OAAO,oBAAC,MAAD;EAAM,KAAK;EAAY;CAAO,CAAA;CACtD,OACE,oBAAC,MAAD;EAAY;EACV,UAAA,oBAAC,QAAD,EAAA,UAAO,KAAK,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,KAAK,IAAU,CAAA;CACpD,CAAA;AAEV;AAEA,MAAM,QAAmE;CACvE,UAAU;CACV,SAAS;AACX;;AAGA,SAAgB,YAAY,EAC1B,SACA,MACA,QAKC;CACD,IAAI,QAAQ,SAAS,SAAS,OAAO,oBAAC,MAAD;EAAM,MAAM,MAAM,QAAQ;EAAa;CAAO,CAAA;CACnF,MAAM,OAAO,QAAQ,aAAa,QAAQ;CAC1C,IAAI,SAAS,MAAM,OAAO,oBAAC,MAAD;EAAM,MAAM;EAAqB;CAAO,CAAA;CAClE,OAAO,oBAAC,SAAD;EAAe;EAAM,MAAM,QAAQ;EAAY;EAAY;CAAO,CAAA;AAC3E;;AAGA,MAAM,KAAsD;CAC1D,UAAU;CACV,SAAS;CACT,OAAO;CACP,MAAM;AACR;AAEA,SAAgB,OAAO,EACrB,IACA,SACA,MACA,QAOC;CACD,IAAI,OAAO,SAAS,OAAO,oBAAC,MAAD;EAAM,MAAM,GAAG;EAAW;CAAO,CAAA;CAC5D,OAAO,YAAY,OACjB,oBAAC,MAAD;EAAM,MAAM;EAAqB;CAAO,CAAA,IAExC,oBAAC,aAAD;EAAsB;EAAe;EAAY;CAAO,CAAA;AAE5D;;;;;AAMA,MAAa,OAA4D;CACvE,IAAI;CACJ,OAAO;CACP,QAAQ;CACR,MAAM;CACN,MAAM;CACN,MAAM;AACR;;AAGA,MAAM,QAAwC;CAC5C,IAAI;CACJ,QAAQ;CACR,MAAM;CACN,eAAe;CACf,aAAa;CACb,YAAY;CACZ,eAAe;CACf,MAAM;CACN,gBAAgB;CAChB,cAAc;CACd,eAAe;CACf,cAAc;CACd,mBAAmB;CACnB,iBAAiB;AACnB;AAEA,SAAgB,SACd,MACA,KACA,MACA,MACW;CACX,IAAI,QAAQ,MAAM,OAAO,oBAAC,SAAD;EAAS,MAAM,IAAI;EAAM,MAAM,IAAI;EAAY;EAAY;CAAO,CAAA;CAE3F,MAAM,UAAU,KAAK,SAAS,SAAS,OAAO,IAAI,IAAI;CACtD,IAAI,YAAY,QAAQ,SAAS,KAAA,GAC/B,OAAO,KAAK,KAAK;EAAE,UAAU;EAAS,MAAM;EAAS;CAAK,CAAC;CAE7D,OAAO,oBAAC,MAAD;EAAM,MAAM,MAAM,KAAK,SAAS;EAAqB;CAAO,CAAA;AACrE"}