@signalcore/ui 0.1.0 → 1.0.0-beta.0

package/dist/automation/messages.d.ts

@@ -0,0 +1,113 @@
+import { AutomationState, RunBy, RunStatus, Use } from "./types.js";
+//#region src/automation/messages.d.ts
+/**
+ * A day as a person says it beside a time: today, yesterday, tomorrow, a weekday within the
+ * week (`name` as the locale names it, short or long), or a date further away.
+ */
+export type DayRef = {
+  kind: "today" | "yesterday" | "tomorrow";
+} | {
+  kind: "weekday" | "date";
+  name: string;
+};
+/** A tool's call by what it does, read from its name: what a run's record says it did. */
+export type Verb = "search" | "send" | "create" | "update" | "remove" | "use";
+/** What a run did, call by call, in words; `would` is a test's write, recorded and not done. */
+export interface CallMessages {
+  /** An app's tool, by what its name says it does, with the app's name. */
+  tool: (verb: Verb, app: string, would: boolean) => string;
+  /** One model call: it reads and writes for real in a test too. */
+  ai: string;
+  /** A line in the owner's inbox. */
+  notify: (would: boolean) => string;
+  /**
+   * A message to a contact on one of the agent's channels: the channel's kind when the record
+   * says it (`whatsapp`, `instagram`, `sms`), and who to (a number; "" for a contact by its id).
+   */
+  send: (channel: string | null, to: string, would: boolean) => string;
+  /** A conversation of the agent opened for what needs judgement or a person. */
+  start: (would: boolean) => string;
+  /** A table's rows looked up, added, changed, by the table's title. */
+  find: (table: string) => string;
+  add: (table: string, would: boolean) => string;
+  change: (table: string, would: boolean) => string;
+  /** A call to another system, by its host. */
+  http: (host: string, would: boolean) => string;
+  /** The organization's files searched. */
+  files: string;
+  /** One of its files read, kept, or its files listed, by the file's name. */
+  read: (file: string) => string;
+  wrote: (file: string, would: boolean) => string;
+  listed: string;
+  /** A line kept in, and one looked up from, what the agent learned. */
+  remember: (would: boolean) => string;
+  recall: string;
+}
+/** The words of an automation and its runs: the trigger in words, its state, its runs. */
+export interface AutomationMessages {
+  /** When it runs, from its cron line (`whenOf`): the days, then the times. */
+  daily: string;
+  /** Monday to Friday. */
+  weekdays: string;
+  /** Saturday and Sunday. */
+  weekends: string;
+  /** Some days of the week, by their names. */
+  weekly: (days: string[]) => string;
+  /** Some days of the month. */
+  monthly: (days: number[]) => string;
+  /** The times it runs at, after the days ("9:00", as the locale writes it). */
+  at: (times: string[]) => string;
+  /** Every few minutes or hours, all day or `between` two times. */
+  every: (count: number, unit: "minute" | "hour") => string;
+  between: (from: string, to: string) => string;
+  /** A frequency on some days only: "every 15 minutes" and "on weekdays". */
+  on: (often: string, days: string) => string;
+  /** A schedule the sentence can't say. */
+  custom: string;
+  /** What another kind of trigger waits for. */
+  webhook: string;
+  event: (app: string | null, event: string | null) => string;
+  /** When it runs next, after when it runs: the day, and the time when the line doesn't say it. */
+  next: (day: DayRef, time: string | null) => string;
+  /** How it stands, on its pill. */
+  states: Readonly<Record<AutomationState, string>>;
+  /** Its switch, for screen readers. */
+  switchLabel: string;
+  /** Over its steps, the table it moves, its runs. */
+  steps: string;
+  runs: string;
+  /** In the place of its runs, when there are none yet. */
+  noRuns: string;
+  /** What a step uses, other than an app (which goes by its name). */
+  uses: Readonly<Record<Exclude<Use["kind"], "app">, string>>;
+  /** The values of the table past the ones shown: "+3". */
+  more: (count: number) => string;
+  /** An automation the agent named that is not there (removed, renamed). */
+  gone: string;
+  /** When a run started, beside what started it. */
+  moment: (day: DayRef, time: string) => string;
+  /** What started a run; an event's by its app's name, when known. */
+  by: (by: RunBy, app: string | null) => string;
+  /** How a run stands. */
+  statuses: Readonly<Record<RunStatus, string>>;
+  /** A test's line: what the run returned, though it changed nothing. */
+  dry: (summary: string) => string;
+  /** How long a run took. */
+  took: (ms: number) => string;
+  /** Over the conversations a run opened, and each one's link. */
+  opened: string;
+  conversation: (index: number) => string;
+  /** The conversation the agent was asked in, for a run it started. */
+  askedIn: string;
+  /** A run that called nothing. */
+  noCalls: string;
+  /** Over the calls made outside any step. */
+  outside: string;
+  /** A call made several times in a row: "×12". */
+  times: (count: number) => string;
+  calls: CallMessages;
+}
+/** English: what the package says until a host gives its own words. */
+export declare const AUTOMATION_MESSAGES: AutomationMessages;
+//#endregion
+//# sourceMappingURL=messages.d.ts.map

package/dist/automation/messages.js

@@ -0,0 +1,113 @@
+//#region src/automation/messages.ts
+const plural = (count, one, many) => count === 1 ? one : `${count} ${many}`;
+/** English: what the package says until a host gives its own words. */
+const AUTOMATION_MESSAGES = {
+	daily: "Every day",
+	weekdays: "Every weekday",
+	weekends: "Every weekend",
+	weekly: (days) => days.length === 1 ? `Every ${days[0] ?? ""}` : `On ${new Intl.ListFormat("en").format(days)}`,
+	monthly: (days) => `On day ${new Intl.ListFormat("en").format(days.map(String))} of every month`,
+	at: (times) => `at ${new Intl.ListFormat("en").format(times)}`,
+	every: (count, unit) => `Every ${plural(count, unit, `${unit}s`)}`,
+	between: (from, to) => `from ${from} to ${to}`,
+	on: (often, days) => `${often}, ${days.charAt(0).toLowerCase()}${days.slice(1)}`,
+	custom: "On a schedule of its own",
+	webhook: "When another system calls it",
+	event: (app, event) => event ? `When ${event} in ${app ?? "an app"}` : `On an event in ${app ?? "an app"}`,
+	next: (day, time) => {
+		const at = time === null ? "" : ` at ${time}`;
+		switch (day.kind) {
+			case "today": return `next today${at}`;
+			case "tomorrow": return `next tomorrow${at}`;
+			case "yesterday": return `next${at}`;
+			default: return `next on ${day.name}${at}`;
+		}
+	},
+	states: {
+		active: "On",
+		paused: "Paused",
+		failing: "Last run failed"
+	},
+	switchLabel: "On",
+	steps: "Steps",
+	runs: "Runs",
+	noRuns: "It hasn't run yet.",
+	uses: {
+		ai: "AI",
+		agent: "Agent",
+		notify: "Inbox",
+		send: "Message",
+		data: "Table",
+		http: "Web"
+	},
+	more: (count) => `+${count}`,
+	gone: "This automation is no longer there.",
+	moment: (day, time) => {
+		switch (day.kind) {
+			case "today": return `Today ${time}`;
+			case "yesterday": return `Yesterday ${time}`;
+			case "tomorrow": return `Tomorrow ${time}`;
+			default: return `${day.name} ${time}`;
+		}
+	},
+	by: (by, app) => ({
+		schedule: "scheduled",
+		webhook: "webhook",
+		event: app ? `${app} event` : "event",
+		agent: "you asked in the chat",
+		test: "test"
+	})[by],
+	statuses: {
+		running: "Running",
+		waiting: "Waiting",
+		done: "Done",
+		failed: "Failed",
+		skipped: "Skipped"
+	},
+	dry: (summary) => `Test: ${summary}`,
+	took: (ms) => ms < 6e4 ? `${Math.max(1, Math.round(ms / 1e3))} s` : `${Math.round(ms / 6e4)} min`,
+	opened: "Conversations it opened",
+	conversation: (index) => `Conversation ${index}`,
+	askedIn: "The conversation you asked in",
+	noCalls: "It didn't call anything.",
+	outside: "Outside the steps",
+	times: (count) => `×${count}`,
+	calls: {
+		tool: (verb, app, would) => {
+			const done = {
+				search: `Searched ${app}`,
+				send: `Sent with ${app}`,
+				create: `Created in ${app}`,
+				update: `Changed in ${app}`,
+				remove: `Removed in ${app}`,
+				use: `Used ${app}`
+			}[verb];
+			return would && verb !== "search" ? `Would have ${done.charAt(0).toLowerCase()}${done.slice(1)}` : done;
+		},
+		ai: "Used AI",
+		notify: (would) => would ? "Would have told you in the inbox" : "Told you in the inbox",
+		send: (channel, to, would) => {
+			const sent = `${{
+				whatsapp: "a WhatsApp",
+				sms: "an SMS",
+				instagram: "an Instagram message"
+			}[channel ?? ""] ?? "a message"} to ${to || "a contact"}`;
+			return would ? `Would have sent ${sent}` : `Sent ${sent}`;
+		},
+		start: (would) => would ? "Would have opened a conversation" : "Opened a conversation",
+		find: (table) => `Looked up ${table}`,
+		add: (table, would) => would ? `Would have added a row to ${table}` : `Added a row to ${table}`,
+		change: (table, would) => would ? `Would have changed a row of ${table}` : `Changed a row of ${table}`,
+		http: (host, would) => would ? `Would have called ${host}` : `Called ${host}`,
+		files: "Searched the files",
+		read: (file) => `Read ${file}`,
+		wrote: (file, would) => would ? `Would have saved ${file}` : `Saved ${file}`,
+		listed: "Looked through its files",
+		remember: (would) => would ? "Would have kept a memory" : "Kept a memory",
+		recall: "Searched what it learned"
+	}
+};
+//#endregion
+export { AUTOMATION_MESSAGES };
+
+//# sourceMappingURL=messages.js.map

package/dist/automation/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","names":[],"sources":["../../src/automation/messages.ts"],"sourcesContent":["import type { AutomationState, RunBy, RunStatus, Use } from \"./types\";\n\n/**\n * A day as a person says it beside a time: today, yesterday, tomorrow, a weekday within the\n * week (`name` as the locale names it, short or long), or a date further away.\n */\nexport type DayRef =\n  { kind: \"today\" | \"yesterday\" | \"tomorrow\" } | { kind: \"weekday\" | \"date\"; name: string };\n\n/** A tool's call by what it does, read from its name: what a run's record says it did. */\nexport type Verb = \"search\" | \"send\" | \"create\" | \"update\" | \"remove\" | \"use\";\n\n/** What a run did, call by call, in words; `would` is a test's write, recorded and not done. */\nexport interface CallMessages {\n  /** An app's tool, by what its name says it does, with the app's name. */\n  tool: (verb: Verb, app: string, would: boolean) => string;\n  /** One model call: it reads and writes for real in a test too. */\n  ai: string;\n  /** A line in the owner's inbox. */\n  notify: (would: boolean) => string;\n  /**\n   * A message to a contact on one of the agent's channels: the channel's kind when the record\n   * says it (`whatsapp`, `instagram`, `sms`), and who to (a number; \"\" for a contact by its id).\n   */\n  send: (channel: string | null, to: string, would: boolean) => string;\n  /** A conversation of the agent opened for what needs judgement or a person. */\n  start: (would: boolean) => string;\n  /** A table's rows looked up, added, changed, by the table's title. */\n  find: (table: string) => string;\n  add: (table: string, would: boolean) => string;\n  change: (table: string, would: boolean) => string;\n  /** A call to another system, by its host. */\n  http: (host: string, would: boolean) => string;\n  /** The organization's files searched. */\n  files: string;\n  /** One of its files read, kept, or its files listed, by the file's name. */\n  read: (file: string) => string;\n  wrote: (file: string, would: boolean) => string;\n  listed: string;\n  /** A line kept in, and one looked up from, what the agent learned. */\n  remember: (would: boolean) => string;\n  recall: string;\n}\n\n/** The words of an automation and its runs: the trigger in words, its state, its runs. */\nexport interface AutomationMessages {\n  /** When it runs, from its cron line (`whenOf`): the days, then the times. */\n  daily: string;\n  /** Monday to Friday. */\n  weekdays: string;\n  /** Saturday and Sunday. */\n  weekends: string;\n  /** Some days of the week, by their names. */\n  weekly: (days: string[]) => string;\n  /** Some days of the month. */\n  monthly: (days: number[]) => string;\n  /** The times it runs at, after the days (\"9:00\", as the locale writes it). */\n  at: (times: string[]) => string;\n  /** Every few minutes or hours, all day or `between` two times. */\n  every: (count: number, unit: \"minute\" | \"hour\") => string;\n  between: (from: string, to: string) => string;\n  /** A frequency on some days only: \"every 15 minutes\" and \"on weekdays\". */\n  on: (often: string, days: string) => string;\n  /** A schedule the sentence can't say. */\n  custom: string;\n  /** What another kind of trigger waits for. */\n  webhook: string;\n  event: (app: string | null, event: string | null) => string;\n  /** When it runs next, after when it runs: the day, and the time when the line doesn't say it. */\n  next: (day: DayRef, time: string | null) => string;\n  /** How it stands, on its pill. */\n  states: Readonly<Record<AutomationState, string>>;\n  /** Its switch, for screen readers. */\n  switchLabel: string;\n  /** Over its steps, the table it moves, its runs. */\n  steps: string;\n  runs: string;\n  /** In the place of its runs, when there are none yet. */\n  noRuns: string;\n  /** What a step uses, other than an app (which goes by its name). */\n  uses: Readonly<Record<Exclude<Use[\"kind\"], \"app\">, string>>;\n  /** The values of the table past the ones shown: \"+3\". */\n  more: (count: number) => string;\n  /** An automation the agent named that is not there (removed, renamed). */\n  gone: string;\n  /** When a run started, beside what started it. */\n  moment: (day: DayRef, time: string) => string;\n  /** What started a run; an event's by its app's name, when known. */\n  by: (by: RunBy, app: string | null) => string;\n  /** How a run stands. */\n  statuses: Readonly<Record<RunStatus, string>>;\n  /** A test's line: what the run returned, though it changed nothing. */\n  dry: (summary: string) => string;\n  /** How long a run took. */\n  took: (ms: number) => string;\n  /** Over the conversations a run opened, and each one's link. */\n  opened: string;\n  conversation: (index: number) => string;\n  /** The conversation the agent was asked in, for a run it started. */\n  askedIn: string;\n  /** A run that called nothing. */\n  noCalls: string;\n  /** Over the calls made outside any step. */\n  outside: string;\n  /** A call made several times in a row: \"×12\". */\n  times: (count: number) => string;\n  calls: CallMessages;\n}\n\nconst plural = (count: number, one: string, many: string) =>\n  count === 1 ? one : `${count} ${many}`;\n\n/** English: what the package says until a host gives its own words. */\nexport const AUTOMATION_MESSAGES: AutomationMessages = {\n  daily: \"Every day\",\n  weekdays: \"Every weekday\",\n  weekends: \"Every weekend\",\n  weekly: (days) =>\n    days.length === 1 ? `Every ${days[0] ?? \"\"}` : `On ${new Intl.ListFormat(\"en\").format(days)}`,\n  monthly: (days) => `On day ${new Intl.ListFormat(\"en\").format(days.map(String))} of every month`,\n  at: (times) => `at ${new Intl.ListFormat(\"en\").format(times)}`,\n  every: (count, unit) => `Every ${plural(count, unit, `${unit}s`)}`,\n  between: (from, to) => `from ${from} to ${to}`,\n  on: (often, days) => `${often}, ${days.charAt(0).toLowerCase()}${days.slice(1)}`,\n  custom: \"On a schedule of its own\",\n  webhook: \"When another system calls it\",\n  event: (app, event) =>\n    event ? `When ${event} in ${app ?? \"an app\"}` : `On an event in ${app ?? \"an app\"}`,\n  next: (day, time) => {\n    const at = time === null ? \"\" : ` at ${time}`;\n    switch (day.kind) {\n      case \"today\":\n        return `next today${at}`;\n      case \"tomorrow\":\n        return `next tomorrow${at}`;\n      case \"yesterday\":\n        return `next${at}`;\n      default:\n        return `next on ${day.name}${at}`;\n    }\n  },\n  states: { active: \"On\", paused: \"Paused\", failing: \"Last run failed\" },\n  switchLabel: \"On\",\n  steps: \"Steps\",\n  runs: \"Runs\",\n  noRuns: \"It hasn't run yet.\",\n  uses: {\n    ai: \"AI\",\n    agent: \"Agent\",\n    notify: \"Inbox\",\n    send: \"Message\",\n    data: \"Table\",\n    http: \"Web\",\n  },\n  more: (count) => `+${count}`,\n  gone: \"This automation is no longer there.\",\n  moment: (day, time) => {\n    switch (day.kind) {\n      case \"today\":\n        return `Today ${time}`;\n      case \"yesterday\":\n        return `Yesterday ${time}`;\n      case \"tomorrow\":\n        return `Tomorrow ${time}`;\n      default:\n        return `${day.name} ${time}`;\n    }\n  },\n  by: (by, app) =>\n    ({\n      schedule: \"scheduled\",\n      webhook: \"webhook\",\n      event: app ? `${app} event` : \"event\",\n      agent: \"you asked in the chat\",\n      test: \"test\",\n    })[by],\n  statuses: {\n    running: \"Running\",\n    waiting: \"Waiting\",\n    done: \"Done\",\n    failed: \"Failed\",\n    skipped: \"Skipped\",\n  },\n  dry: (summary) => `Test: ${summary}`,\n  took: (ms) =>\n    ms < 60_000 ? `${Math.max(1, Math.round(ms / 1000))} s` : `${Math.round(ms / 60_000)} min`,\n  opened: \"Conversations it opened\",\n  conversation: (index) => `Conversation ${index}`,\n  askedIn: \"The conversation you asked in\",\n  noCalls: \"It didn't call anything.\",\n  outside: \"Outside the steps\",\n  times: (count) => `×${count}`,\n  calls: {\n    tool: (verb, app, would) => {\n      const done = {\n        search: `Searched ${app}`,\n        send: `Sent with ${app}`,\n        create: `Created in ${app}`,\n        update: `Changed in ${app}`,\n        remove: `Removed in ${app}`,\n        use: `Used ${app}`,\n      }[verb];\n      return would && verb !== \"search\"\n        ? `Would have ${done.charAt(0).toLowerCase()}${done.slice(1)}`\n        : done;\n    },\n    ai: \"Used AI\",\n    notify: (would) => (would ? \"Would have told you in the inbox\" : \"Told you in the inbox\"),\n    send: (channel, to, would) => {\n      const what =\n        { whatsapp: \"a WhatsApp\", sms: \"an SMS\", instagram: \"an Instagram message\" }[\n          channel ?? \"\"\n        ] ?? \"a message\";\n      const sent = `${what} to ${to || \"a contact\"}`;\n      return would ? `Would have sent ${sent}` : `Sent ${sent}`;\n    },\n    start: (would) => (would ? \"Would have opened a conversation\" : \"Opened a conversation\"),\n    find: (table) => `Looked up ${table}`,\n    add: (table, would) =>\n      would ? `Would have added a row to ${table}` : `Added a row to ${table}`,\n    change: (table, would) =>\n      would ? `Would have changed a row of ${table}` : `Changed a row of ${table}`,\n    http: (host, would) => (would ? `Would have called ${host}` : `Called ${host}`),\n    files: \"Searched the files\",\n    read: (file) => `Read ${file}`,\n    wrote: (file, would) => (would ? `Would have saved ${file}` : `Saved ${file}`),\n    listed: \"Looked through its files\",\n    remember: (would) => (would ? \"Would have kept a memory\" : \"Kept a memory\"),\n    recall: \"Searched what it learned\",\n  },\n};\n"],"mappings":"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"}

package/dist/automation/record.d.ts

@@ -0,0 +1,47 @@
+import { Automation, RunStep } from "./types.js";
+import { CallMessages, Verb } from "./messages.js";
+//#region src/automation/record.d.ts
+/**
+ * What a tool does, from its name (`GMAIL_SEND_EMAIL`, `Gmail.SendEmail`): the first of its
+ * words that says so; none, it only uses the app.
+ */
+export declare function verbOf(tool: string): Verb;
+/** How a record names an app and a table: the app by its display name, the table by its title. */
+export interface Names {
+  app: (alias: string) => string;
+  /** The app's logo, when the automation knows it. */
+  icon: (alias: string) => string | null;
+  table: (name: string) => string;
+}
+/**
+ * The names an automation knows: its apps' (from its steps' uses and its event's trigger) and
+ * its board's table; anything else by its own name, in words.
+ */
+export declare function namingOf(automation: Pick<Automation, "steps" | "trigger" | "board"> | null): Names;
+/** The app an app's tool call reached (`tool:gmail.GMAIL_SEND_EMAIL` is `gmail`); null for the rest. */
+export declare function appOf(call: string): string | null;
+/** One call of a run in words; a call the package doesn't know keeps its own name. */
+export declare function callWords(step: RunStep, words: CallMessages, names: Names): string;
+/** One line of a step: what was done, how many times in a row, and why it failed when it did. */
+export interface CallLine {
+  /** The first call's place in the record. */
+  seq: number;
+  text: string;
+  count: number;
+  error: string | null;
+  would: boolean;
+  /** Every call the line stands for: their inputs and outputs, for whoever reads them. */
+  calls: RunStep[];
+}
+/** The calls made in one step, in their order; `step` null for those made outside any. */
+export interface StepGroup {
+  step: string | null;
+  lines: CallLine[];
+}
+/**
+ * A run's calls under the step each ran in, in the record's order: a new group each time the
+ * step changes, and in a group the same words in a row (none failed) as one line with a count.
+ */
+export declare function groupsOf(steps: readonly RunStep[], words: CallMessages, names: Names): StepGroup[];
+//#endregion
+//# sourceMappingURL=record.d.ts.map

package/dist/automation/record.js

@@ -0,0 +1,177 @@
+import { toolName } from "../about.js";
+//#region src/automation/record.ts
+/**
+* A run's record in words: each call as what it did ("Buscó en Gmail", "Añadió una fila a
+* Citas"; a test's writes as what it would have done), gathered under the step it ran in, the same
+* call made several times in a row said once with how many. Pure, so it is tested without a page.
+*/
+/** The words in a tool's name that say what it does, first match wins; the rest only use it. */
+const VERBS = [
+	["send", /* @__PURE__ */ new Set([
+		"send",
+		"post",
+		"reply",
+		"forward",
+		"notify",
+		"publish"
+	])],
+	["remove", /* @__PURE__ */ new Set([
+		"delete",
+		"remove",
+		"trash",
+		"archive",
+		"cancel"
+	])],
+	["update", /* @__PURE__ */ new Set([
+		"update",
+		"edit",
+		"patch",
+		"modify",
+		"move",
+		"mark",
+		"set",
+		"rename"
+	])],
+	["create", /* @__PURE__ */ new Set([
+		"create",
+		"add",
+		"insert",
+		"new",
+		"upload",
+		"book",
+		"schedule",
+		"draft"
+	])],
+	["search", /* @__PURE__ */ new Set([
+		"search",
+		"fetch",
+		"list",
+		"get",
+		"find",
+		"read",
+		"query",
+		"retrieve",
+		"lookup"
+	])]
+];
+/**
+* What a tool does, from its name (`GMAIL_SEND_EMAIL`, `Gmail.SendEmail`): the first of its
+* words that says so; none, it only uses the app.
+*/
+function verbOf(tool) {
+	const words = tool.replace(/([a-z0-9])([A-Z])/g, "$1 $2").split(/[^A-Za-z0-9]+/).map((word) => word.toLowerCase()).filter(Boolean);
+	for (const word of words) for (const [verb, names] of VERBS) if (names.has(word)) return verb;
+	return "use";
+}
+/**
+* The names an automation knows: its apps' (from its steps' uses and its event's trigger) and
+* its board's table; anything else by its own name, in words.
+*/
+function namingOf(automation) {
+	const apps = /* @__PURE__ */ new Map();
+	const trigger = automation?.trigger;
+	if (trigger?.app && trigger.app_title) apps.set(trigger.app, {
+		title: trigger.app_title,
+		icon: trigger.icon
+	});
+	for (const step of automation?.steps ?? []) for (const use of step.uses) if (use.kind === "app" && use.app !== null && use.title !== null) apps.set(use.app, {
+		title: use.title,
+		icon: use.icon
+	});
+	const board = automation?.board ?? null;
+	return {
+		app: (alias) => apps.get(alias)?.title ?? toolName(alias),
+		icon: (alias) => apps.get(alias)?.icon ?? null,
+		table: (name) => board !== null && board.table === name ? board.title : toolName(name)
+	};
+}
+/** The app an app's tool call reached (`tool:gmail.GMAIL_SEND_EMAIL` is `gmail`); null for the rest. */
+function appOf(call) {
+	if (!call.startsWith("tool:")) return null;
+	const target = call.slice(5);
+	const dot = target.indexOf(".");
+	return dot === -1 ? target : target.slice(0, dot);
+}
+const field = (value, name) => {
+	if (typeof value !== "object" || value === null || !(name in value)) return null;
+	const found = value[name];
+	return typeof found === "string" ? found : null;
+};
+function hostOf(url) {
+	if (url === null) return "";
+	try {
+		return new URL(url).host;
+	} catch {
+		return url;
+	}
+}
+/**
+* The channel a `send` went out on: what the record says it reached (a test's stand-in names the
+* one asked for), else the one asked for; null when neither says.
+*/
+function sentOn(step) {
+	return field(step.output, "channel") ?? field(step.input, "via");
+}
+/** Who a `send` went to, as words can say it: a number as it was given; a contact's id, "". */
+const recipientOf = (contact) => contact === null || /^ctc_/.test(contact) ? "" : contact;
+/** A file's name from its path, as a call names it; "" when the call didn't say. */
+const nameOf = (path) => (path ?? "").slice((path ?? "").lastIndexOf("/") + 1);
+/** One call of a run in words; a call the package doesn't know keeps its own name. */
+function callWords(step, words, names) {
+	const { call, would } = step;
+	const app = appOf(call);
+	if (app !== null) return words.tool(verbOf(call.slice(5 + app.length + 1)), names.app(app), would);
+	const table = () => names.table(field(step.input, "table") ?? "");
+	switch (call) {
+		case "ai": return words.ai;
+		case "notify": return words.notify(would);
+		case "send": return words.send(sentOn(step), recipientOf(field(step.input, "contact")), would);
+		case "agent.start": return words.start(would);
+		case "data.find": return words.find(table());
+		case "data.add": return words.add(table(), would);
+		case "data.update": return words.change(table(), would);
+		case "http": return words.http(hostOf(field(step.input, "url")), would);
+		case "files.search": return words.files;
+		case "files.read": return words.read(nameOf(field(step.input, "path")));
+		case "files.write": return words.wrote(nameOf(field(step.input, "path")), would);
+		case "files.list": return words.listed;
+		case "memory.remember": return words.remember(would);
+		case "memory.recall": return words.recall;
+		default: return call;
+	}
+}
+/**
+* A run's calls under the step each ran in, in the record's order: a new group each time the
+* step changes, and in a group the same words in a row (none failed) as one line with a count.
+*/
+function groupsOf(steps, words, names) {
+	const groups = [];
+	for (const step of [...steps].sort((a, b) => a.seq - b.seq)) {
+		let group = groups[groups.length - 1];
+		if (group === void 0 || group.step !== step.step) {
+			group = {
+				step: step.step,
+				lines: []
+			};
+			groups.push(group);
+		}
+		const text = callWords(step, words, names);
+		const last = group.lines[group.lines.length - 1];
+		if (last !== void 0 && last.text === text && last.error === null && step.error === null) {
+			last.count += 1;
+			last.calls.push(step);
+		} else group.lines.push({
+			seq: step.seq,
+			text,
+			count: 1,
+			error: step.error,
+			would: step.would,
+			calls: [step]
+		});
+	}
+	return groups;
+}
+//#endregion
+export { appOf, callWords, groupsOf, namingOf, sentOn, verbOf };
+
+//# sourceMappingURL=record.js.map

package/dist/automation/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","names":[],"sources":["../../src/automation/record.ts"],"sourcesContent":["/**\n * A run's record in words: each call as what it did (\"Buscó en Gmail\", \"Añadió una fila a\n * Citas\"; a test's writes as what it would have done), gathered under the step it ran in, the same\n * call made several times in a row said once with how many. Pure, so it is tested without a page.\n */\n\nimport { toolName } from \"../about\";\nimport type { CallMessages, Verb } from \"./messages\";\nimport type { Automation, RunStep } from \"./types\";\n\n/** The words in a tool's name that say what it does, first match wins; the rest only use it. */\nconst VERBS: readonly (readonly [Verb, ReadonlySet<string>])[] = [\n  [\"send\", new Set([\"send\", \"post\", \"reply\", \"forward\", \"notify\", \"publish\"])],\n  [\"remove\", new Set([\"delete\", \"remove\", \"trash\", \"archive\", \"cancel\"])],\n  [\"update\", new Set([\"update\", \"edit\", \"patch\", \"modify\", \"move\", \"mark\", \"set\", \"rename\"])],\n  [\"create\", new Set([\"create\", \"add\", \"insert\", \"new\", \"upload\", \"book\", \"schedule\", \"draft\"])],\n  [\n    \"search\",\n    new Set([\"search\", \"fetch\", \"list\", \"get\", \"find\", \"read\", \"query\", \"retrieve\", \"lookup\"]),\n  ],\n];\n\n/**\n * What a tool does, from its name (`GMAIL_SEND_EMAIL`, `Gmail.SendEmail`): the first of its\n * words that says so; none, it only uses the app.\n */\nexport function verbOf(tool: string): Verb {\n  const words = tool\n    .replace(/([a-z0-9])([A-Z])/g, \"$1 $2\")\n    .split(/[^A-Za-z0-9]+/)\n    .map((word) => word.toLowerCase())\n    .filter(Boolean);\n  for (const word of words) {\n    for (const [verb, names] of VERBS) if (names.has(word)) return verb;\n  }\n  return \"use\";\n}\n\n/** How a record names an app and a table: the app by its display name, the table by its title. */\nexport interface Names {\n  app: (alias: string) => string;\n  /** The app's logo, when the automation knows it. */\n  icon: (alias: string) => string | null;\n  table: (name: string) => string;\n}\n\n/**\n * The names an automation knows: its apps' (from its steps' uses and its event's trigger) and\n * its board's table; anything else by its own name, in words.\n */\nexport function namingOf(\n  automation: Pick<Automation, \"steps\" | \"trigger\" | \"board\"> | null,\n): Names {\n  const apps = new Map<string, { title: string; icon: string | null }>();\n  const trigger = automation?.trigger;\n  if (trigger?.app && trigger.app_title) {\n    apps.set(trigger.app, { title: trigger.app_title, icon: trigger.icon });\n  }\n  for (const step of automation?.steps ?? []) {\n    for (const use of step.uses) {\n      if (use.kind === \"app\" && use.app !== null && use.title !== null) {\n        apps.set(use.app, { title: use.title, icon: use.icon });\n      }\n    }\n  }\n  const board = automation?.board ?? null;\n  return {\n    app: (alias) => apps.get(alias)?.title ?? toolName(alias),\n    icon: (alias) => apps.get(alias)?.icon ?? null,\n    table: (name) => (board !== null && board.table === name ? board.title : toolName(name)),\n  };\n}\n\n/** The app an app's tool call reached (`tool:gmail.GMAIL_SEND_EMAIL` is `gmail`); null for the rest. */\nexport function appOf(call: string): string | null {\n  if (!call.startsWith(\"tool:\")) return null;\n  const target = call.slice(5);\n  const dot = target.indexOf(\".\");\n  return dot === -1 ? target : target.slice(0, dot);\n}\n\nconst field = (value: unknown, name: string): string | null => {\n  if (typeof value !== \"object\" || value === null || !(name in value)) return null;\n  const found: unknown = (value as Record<string, unknown>)[name];\n  return typeof found === \"string\" ? found : null;\n};\n\nfunction hostOf(url: string | null): string {\n  if (url === null) return \"\";\n  try {\n    return new URL(url).host;\n  } catch {\n    return url;\n  }\n}\n\n/**\n * The channel a `send` went out on: what the record says it reached (a test's stand-in names the\n * one asked for), else the one asked for; null when neither says.\n */\nexport function sentOn(step: RunStep): string | null {\n  return field(step.output, \"channel\") ?? field(step.input, \"via\");\n}\n\n/** Who a `send` went to, as words can say it: a number as it was given; a contact's id, \"\". */\nconst recipientOf = (contact: string | null): string =>\n  contact === null || /^ctc_/.test(contact) ? \"\" : contact;\n\n/** A file's name from its path, as a call names it; \"\" when the call didn't say. */\nconst nameOf = (path: string | null): string =>\n  (path ?? \"\").slice((path ?? \"\").lastIndexOf(\"/\") + 1);\n\n/** One call of a run in words; a call the package doesn't know keeps its own name. */\nexport function callWords(step: RunStep, words: CallMessages, names: Names): string {\n  const { call, would } = step;\n  const app = appOf(call);\n  if (app !== null) {\n    return words.tool(verbOf(call.slice(5 + app.length + 1)), names.app(app), would);\n  }\n  const table = () => names.table(field(step.input, \"table\") ?? \"\");\n  switch (call) {\n    case \"ai\":\n      return words.ai;\n    case \"notify\":\n      return words.notify(would);\n    case \"send\":\n      return words.send(sentOn(step), recipientOf(field(step.input, \"contact\")), would);\n    case \"agent.start\":\n      return words.start(would);\n    case \"data.find\":\n      return words.find(table());\n    case \"data.add\":\n      return words.add(table(), would);\n    case \"data.update\":\n      return words.change(table(), would);\n    case \"http\":\n      return words.http(hostOf(field(step.input, \"url\")), would);\n    case \"files.search\":\n      return words.files;\n    case \"files.read\":\n      return words.read(nameOf(field(step.input, \"path\")));\n    case \"files.write\":\n      return words.wrote(nameOf(field(step.input, \"path\")), would);\n    case \"files.list\":\n      return words.listed;\n    case \"memory.remember\":\n      return words.remember(would);\n    case \"memory.recall\":\n      return words.recall;\n    default:\n      return call;\n  }\n}\n\n/** One line of a step: what was done, how many times in a row, and why it failed when it did. */\nexport interface CallLine {\n  /** The first call's place in the record. */\n  seq: number;\n  text: string;\n  count: number;\n  error: string | null;\n  would: boolean;\n  /** Every call the line stands for: their inputs and outputs, for whoever reads them. */\n  calls: RunStep[];\n}\n\n/** The calls made in one step, in their order; `step` null for those made outside any. */\nexport interface StepGroup {\n  step: string | null;\n  lines: CallLine[];\n}\n\n/**\n * A run's calls under the step each ran in, in the record's order: a new group each time the\n * step changes, and in a group the same words in a row (none failed) as one line with a count.\n */\nexport function groupsOf(\n  steps: readonly RunStep[],\n  words: CallMessages,\n  names: Names,\n): StepGroup[] {\n  const groups: StepGroup[] = [];\n  for (const step of [...steps].sort((a, b) => a.seq - b.seq)) {\n    let group = groups[groups.length - 1];\n    if (group === undefined || group.step !== step.step) {\n      group = { step: step.step, lines: [] };\n      groups.push(group);\n    }\n    const text = callWords(step, words, names);\n    const last = group.lines[group.lines.length - 1];\n    if (last !== undefined && last.text === text && last.error === null && step.error === null) {\n      last.count += 1;\n      last.calls.push(step);\n    } else {\n      group.lines.push({\n        seq: step.seq,\n        text,\n        count: 1,\n        error: step.error,\n        would: step.would,\n        calls: [step],\n      });\n    }\n  }\n  return groups;\n}\n"],"mappings":"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"}

package/dist/automation/types.d.ts

@@ -0,0 +1,143 @@
+//#region src/automation/types.d.ts
+/**
+ * An agent's automations and their runs, as the API gives them (v3/AUTOMATIONS.md): what starts
+ * each one, the steps its code names, the table it moves, and every run with its record. Written
+ * by hand, one to one with the API's answers; times are ISO 8601 in UTC.
+ */
+/**
+ * What a step uses, as the manifest reads it from the code before any run: an app, the model,
+ * the agent, the owner's inbox, a message to a contact on a channel (`sc.send`), a table, the web.
+ */
+export interface Use {
+  kind: "app" | "ai" | "agent" | "notify" | "send" | "data" | "http";
+  /** An app's: the connection's name (its alias). */
+  app: string | null;
+  /** An app's: its display name. */
+  title: string | null;
+  /** An app's: its logo (https), when known. */
+  icon: string | null;
+}
+/** A step of the code (`sc.step("…")`), in the code's order, with what it uses. */
+export interface Step {
+  name: string;
+  uses: Use[];
+}
+/** What starts an automation: a time (cron, on a zone's clock), a call to its URL, an app's event. */
+export interface Trigger {
+  kind: "schedule" | "webhook" | "event";
+  /** Five-field cron. */
+  schedule: string | null;
+  /** IANA zone. */
+  timezone: string | null;
+  /** The webhook's full URL. */
+  url: string | null;
+  /** An event's app: the connection's name, its display name, its logo. */
+  app: string | null;
+  app_title: string | null;
+  /** The provider's event slug, and the event in words when the provider gives them. */
+  event: string | null;
+  event_title: string | null;
+  icon: string | null;
+}
+/** The table an automation moves, as counts of its rows per value of one field. */
+export interface Board {
+  table: string;
+  /** The table's title. */
+  title: string;
+  /** The field the rows are counted by. */
+  field: string;
+  /** Per value, biggest first, at most 8. */
+  counts: {
+    value: string;
+    count: number;
+  }[];
+}
+export type RunStatus = "running" | "waiting" | "done" | "failed" | "skipped";
+/** What started a run: its time, a call, an app's event, the agent in a chat, a test. */
+export type RunBy = "schedule" | "webhook" | "event" | "agent" | "test";
+/** One start of an automation, whatever started it. */
+export interface Run {
+  id: string;
+  agent_id: string;
+  /** The automation's name. */
+  automation: string;
+  /** The automation's title when it ran. */
+  title: string;
+  by: RunBy;
+  /** Started by the agent: the conversation it was asked in. */
+  conversation_id: string | null;
+  status: RunStatus;
+  /** What the code returned: the run's one line. */
+  summary: string | null;
+  /** Why it failed, in words, naming the step: "Paró en «…»: …". */
+  error: string | null;
+  /** A test: what would change the world was recorded, not done. */
+  dry: boolean;
+  started_at: string;
+  ended_at: string | null;
+  tokens_in: number;
+  tokens_out: number;
+  /** The conversations it opened. */
+  opened: string[];
+}
+/** One call of a run's record, in the order it was made. */
+export interface RunStep {
+  seq: number;
+  /** The `sc.step` it ran in. */
+  step: string | null;
+  /**
+   * `tool:<app>.<TOOL>` · `ai` · `notify` · `send` · `agent.start` · `data.find` · `data.add` ·
+   * `data.update` · `http` · `files.search` · `memory.remember` · `memory.recall`.
+   */
+  call: string;
+  /** Both trimmed. */
+  input: unknown;
+  output: unknown;
+  error: string | null;
+  ms: number;
+  at: string;
+  /** A test's write: recorded, not done. */
+  would: boolean;
+}
+/** A run with its record (`GET /runs/{id}`). */
+export type RunRecord = Run & {
+  steps: RunStep[];
+};
+export type AutomationState = "active" | "paused" | "failing";
+/** One automation: `automations/<name>.py` in the agent's folder, with its trigger and its state. */
+export interface Automation {
+  /** Its trigger's id. */
+  id: string;
+  agent_id: string;
+  /** Its file's name; unique per agent. */
+  name: string;
+  title: string;
+  /** What it does, in the owner's words. */
+  summary: string;
+  trigger: Trigger;
+  on: boolean;
+  next_run_at: string | null;
+  steps: Step[];
+  board: Board | null;
+  /** `failing`: its last finished real run failed. */
+  state: AutomationState;
+  /** Its newest run, tests included. */
+  last_run: Run | null;
+}
+/** An automation with its newest runs (`GET /agents/{id}/automations/{name}`: 20; in a block: 5). */
+export type AutomationView = Automation & {
+  runs: Run[];
+};
+/**
+ * A task the agent runs for one contact (`GET /agents/{id}/tasks`): set up in words in a
+ * conversation with them, read as an automation is (its instruction is its `summary`, its trigger
+ * a schedule: a cron line, or none for a task once at `next_run_at`), with its newest five runs.
+ */
+export type Task = AutomationView & {
+  contact_id: string;
+  /** The conversation it runs in: the one it was set up in. */
+  conversation_id: string | null;
+  created_at: string;
+};
+//#endregion
+//# sourceMappingURL=types.d.ts.map