@signalcore/ui 0.1.0 → 1.0.0-beta.1

package/dist/flow/kinds.d.ts

@@ -1,23 +0,0 @@
-/**
- * The package as the owner reads it: the folders of an agent's package
- * (`signalcore_core.package`) in the order the owner thinks in, each named by what it holds for
- * them, never by its path. The same words name the kinds of parts a change touched and the
- * columns of the map, so a folder and a change speak of the same thing.
- *
- * Pure. The words are the language's (`Messages["flow"]`), Spanish unless a caller passes
- * another, so the same function serves a host in any locale.
- */
-import type { Messages } from "../messages/types.js";
-/** The words the map and the package's vocabulary use: `useMessages().flow`. */
-export type FlowWords = Messages["flow"];
-declare const ORDER: readonly ["conduct", "channels", "automations", "actions", "records", "apps", "tests", "dependencies", "other", "readme"];
-export type PartKind = (typeof ORDER)[number];
-/** The kinds of parts in the package's order, for anything that lists them. */
-export declare const KINDS: readonly string[];
-/** How a kind of part reads to the owner ("automations" → "Qué hace"). */
-export declare const kindLabel: (kind: string, words?: FlowWords) => string;
-/** Which kind a file belongs to. Root files and unknown folders get a kind of their own. */
-export declare function kindOf(path: string): string;
-/** The stable name of a part, as the owner sees it: `automations/aviso.py` → `aviso`. */
-export declare function partName(path: string, words?: FlowWords): string;
-export {};

package/dist/flow/kinds.js

@@ -1,48 +0,0 @@
-/**
- * The package as the owner reads it: the folders of an agent's package
- * (`signalcore_core.package`) in the order the owner thinks in, each named by what it holds for
- * them, never by its path. The same words name the kinds of parts a change touched and the
- * columns of the map, so a folder and a change speak of the same thing.
- *
- * Pure. The words are the language's (`Messages["flow"]`), Spanish unless a caller passes
- * another, so the same function serves a host in any locale.
- */
-import { es } from "../messages/es.js";
-const ORDER = [
-    "conduct",
-    "channels",
-    "automations",
-    "actions",
-    "records",
-    "apps",
-    "tests",
-    "dependencies",
-    "other",
-    "readme",
-];
-/** The kinds of parts in the package's order, for anything that lists them. */
-export const KINDS = ORDER;
-const isKind = (value) => KINDS.includes(value);
-/** How a kind of part reads to the owner ("automations" → "Qué hace"). */
-export const kindLabel = (kind, words = es.flow) => isKind(kind) ? words.kinds[kind] : kind;
-/** Which kind a file belongs to. Root files and unknown folders get a kind of their own. */
-export function kindOf(path) {
-    if (path === "requirements.txt")
-        return "dependencies";
-    if (path === "README.md")
-        return "readme";
-    const [folder, rest] = path.split("/", 2);
-    if (folder && rest !== undefined && isKind(folder))
-        return folder;
-    return "other";
-}
-/** The stable name of a part, as the owner sees it: `automations/aviso.py` → `aviso`. */
-export function partName(path, words = es.flow) {
-    if (path === "conduct/instructions.md")
-        return words.conductFiles.instructions;
-    if (path === "conduct/agent.yaml")
-        return words.conductFiles.settings;
-    const file = path.split("/").at(-1) ?? path;
-    const dot = file.lastIndexOf(".");
-    return dot > 0 ? file.slice(0, dot) : file;
-}

package/dist/flow/map.d.ts

@@ -1,44 +0,0 @@
-/**
- * The agent as a map: its parts as nodes, in columns from what starts things (the channels)
- * through what it does (automations, skills) and what those call (actions) to what they reach
- * (records, apps, the owner); the connections read from its code and its page. Pure and
- * deterministic, so the same agent always draws the same. The words on it (the line between two
- * parts, the word under a node) are the language's, Spanish unless a caller passes another.
- */
-import type { Overview } from "../windows/types.js";
-import { type FlowWords } from "./kinds.js";
-export type NodeKind = "channel" | "automation" | "skill" | "action" | "record" | "app" | "owner" | "browser" | "files" | "store";
-export interface MapNode {
-    /** `automation:<id>`, `skill:<id>`, a channel's id, a file's path, `app:<alias>`, `owner`… */
-    id: string;
-    kind: NodeKind;
-    label: string;
-    detail: string | null;
-    /** The file it lives in, when it has one. */
-    path: string | null;
-    /** For its logo, when it is a brand. */
-    provider: string | null;
-    /** An automation's, a channel's or an app's state, as the overview says it. */
-    status: string | null;
-    /** How an automation starts. */
-    trigger: "cron" | "webhook" | "event" | null;
-    x: number;
-    y: number;
-}
-export interface MapEdge {
-    id: string;
-    from: string;
-    to: string;
-    label: string | null;
-}
-export declare const NODE_W = 232;
-export declare const NODE_H = 60;
-/** Which handler of a file a line belongs to: the last one that starts before it. */
-export declare function ownerOf(handlers: {
-    id: string;
-    first: number;
-}[] | undefined, line: number): string | null;
-export declare function agentMap(overview: Overview, files: Record<string, string>, words?: FlowWords): {
-    nodes: MapNode[];
-    edges: MapEdge[];
-};

package/dist/flow/map.js

@@ -1,225 +0,0 @@
-/**
- * The agent as a map: its parts as nodes, in columns from what starts things (the channels)
- * through what it does (automations, skills) and what those call (actions) to what they reach
- * (records, apps, the owner); the connections read from its code and its page. Pure and
- * deterministic, so the same agent always draws the same. The words on it (the line between two
- * parts, the word under a node) are the language's, Spanish unless a caller passes another.
- */
-import { es } from "../messages/es.js";
-import { kindOf, partName } from "./kinds.js";
-import { relationsOf } from "./relations.js";
-export const NODE_W = 232;
-export const NODE_H = 60;
-const COL_GAP = 104;
-const ROW_GAP = 28;
-const COLUMN = {
-    channel: 0,
-    automation: 1,
-    skill: 1,
-    action: 2,
-    record: 3,
-    app: 3,
-    owner: 3,
-    browser: 3,
-    files: 3,
-    store: 3,
-};
-const PSEUDO_KINDS = ["owner", "browser", "files", "store"];
-const isPseudo = (id) => PSEUDO_KINDS.includes(id);
-/** A node that is not a file of the package: what a part reaches outside it. */
-function outside(kind, words) {
-    return {
-        id: kind,
-        kind,
-        ...words.outside[kind],
-        path: null,
-        provider: null,
-        status: null,
-        trigger: null,
-    };
-}
-/** The handlers a file holds, each with the first line it owns, so a call can be attributed. */
-function handlersByFile(overview) {
-    const byFile = new Map();
-    const put = (file, id, flow) => {
-        const lines = flow.flatMap((step) => (step.line ? [step.line] : []));
-        const list = byFile.get(file) ?? [];
-        list.push({ id, first: lines.length ? Math.min(...lines) : 0 });
-        byFile.set(file, list);
-    };
-    for (const a of overview.automations)
-        put(a.file, `automation:${a.id}`, a.flow);
-    for (const s of overview.skills)
-        put(s.file, `skill:${s.id}`, s.flow);
-    for (const list of byFile.values())
-        list.sort((a, b) => a.first - b.first);
-    return byFile;
-}
-/** Which handler of a file a line belongs to: the last one that starts before it. */
-export function ownerOf(handlers, line) {
-    if (!handlers || handlers.length === 0)
-        return null;
-    const before = handlers.filter((handler) => handler.first <= line);
-    return (before.at(-1) ?? handlers[0])?.id ?? null;
-}
-export function agentMap(overview, files, words = es.flow) {
-    const nodes = new Map();
-    const edges = new Map();
-    const add = (node) => {
-        if (!nodes.has(node.id))
-            nodes.set(node.id, node);
-    };
-    const link = (from, to, label) => {
-        if (from === to)
-            return;
-        const id = `${from}->${to}`;
-        if (!edges.has(id))
-            edges.set(id, { id, from, to, label });
-    };
-    const apps = (chips, from) => {
-        for (const chip of chips) {
-            add({
-                id: `app:${chip.alias}`,
-                kind: "app",
-                label: chip.name,
-                detail: chip.connected
-                    ? chip.uses.slice(0, 2).join(" · ") || words.detail.connected
-                    : words.detail.notConnected,
-                path: null,
-                provider: chip.provider ?? null,
-                status: chip.connected ? "active" : "disconnected",
-                trigger: null,
-            });
-            link(from, `app:${chip.alias}`, words.verbs["uses-app"]);
-        }
-    };
-    for (const channel of overview.channels) {
-        add({
-            id: channel.id,
-            kind: "channel",
-            label: channel.title,
-            detail: channel.name,
-            path: null,
-            provider: channel.provider,
-            status: channel.status,
-            trigger: null,
-        });
-    }
-    for (const automation of overview.automations) {
-        add({
-            id: `automation:${automation.id}`,
-            kind: "automation",
-            label: automation.title,
-            detail: automation.when,
-            path: automation.file,
-            provider: null,
-            status: automation.status,
-            trigger: automation.kind,
-        });
-    }
-    for (const skill of overview.skills) {
-        add({
-            id: `skill:${skill.id}`,
-            kind: "skill",
-            label: skill.id,
-            detail: skill.description,
-            path: skill.file,
-            provider: null,
-            status: null,
-            trigger: null,
-        });
-    }
-    for (const path of Object.keys(files).sort()) {
-        const kind = kindOf(path);
-        if (kind === "actions" || kind === "records") {
-            add({
-                id: path,
-                kind: kind === "actions" ? "action" : "record",
-                label: partName(path, words),
-                detail: kind === "actions" ? words.detail.action : words.detail.record,
-                path,
-                provider: null,
-                status: null,
-                trigger: null,
-            });
-        }
-    }
-    for (const automation of overview.automations)
-        apps(automation.apps, `automation:${automation.id}`);
-    for (const skill of overview.skills)
-        apps(skill.apps, `skill:${skill.id}`);
-    // A conversation may use any skill: every channel reaches every skill.
-    for (const channel of overview.channels)
-        for (const skill of overview.skills)
-            link(channel.id, `skill:${skill.id}`, words.verbs.canUse);
-    // What the code says, each call attributed to the handler that makes it.
-    const handlers = handlersByFile(overview);
-    for (const edge of relationsOf(files, words).edges) {
-        const from = ownerOf(handlers.get(edge.from), edge.line) ?? (nodes.has(edge.from) ? edge.from : null);
-        if (!from)
-            continue;
-        const to = targetOf(edge, add, words);
-        if (!to)
-            continue;
-        if (edge.kind === "starts-from")
-            link(to, from, words.verbs[edge.kind]);
-        else
-            link(from, to, edge.kind === "reaches" && to !== "owner" ? words.verbs.sends : words.verbs[edge.kind]);
-    }
-    return { nodes: place([...nodes.values()]), edges: [...edges.values()] };
-}
-/** The node an edge points at, made on the way when it is an app, a channel or a pseudo node. */
-function targetOf(edge, add, words) {
-    if (isPseudo(edge.to)) {
-        add(outside(edge.to, words));
-        return edge.to;
-    }
-    const kind = kindOf(edge.to);
-    if (kind === "apps") {
-        const id = `app:${partName(edge.to, words)}`;
-        add({
-            id,
-            kind: "app",
-            label: partName(edge.to, words),
-            detail: null,
-            path: edge.to,
-            provider: null,
-            status: null,
-            trigger: null,
-        });
-        return id;
-    }
-    if (kind === "channels") {
-        add({
-            id: edge.to,
-            kind: "channel",
-            label: partName(edge.to, words),
-            detail: words.detail.channel,
-            path: edge.to,
-            provider: null,
-            status: null,
-            trigger: null,
-        });
-        return edge.to;
-    }
-    if (kind === "actions" || kind === "records")
-        return edge.to;
-    return null;
-}
-/** Columns by role, only the ones in use, each stacked and centred on the tallest. */
-function place(nodes) {
-    const used = [...new Set(nodes.map((node) => COLUMN[node.kind]))].sort((a, b) => a - b);
-    const rows = new Map();
-    const placed = nodes.map((node) => {
-        const column = used.indexOf(COLUMN[node.kind]);
-        const row = rows.get(column) ?? 0;
-        rows.set(column, row + 1);
-        return { ...node, x: column * (NODE_W + COL_GAP), y: row * (NODE_H + ROW_GAP) };
-    });
-    const tallest = Math.max(0, ...rows.values());
-    return placed.map((node) => {
-        const column = used.indexOf(COLUMN[node.kind]);
-        const offset = ((tallest - (rows.get(column) ?? 0)) * (NODE_H + ROW_GAP)) / 2;
-        return { ...node, y: node.y + offset };
-    });
-}

package/dist/flow/nodePaths.d.ts

@@ -1,7 +0,0 @@
-import type { NodeKind } from "./map.js";
-/**
- * What marks each kind of part on the map, from Phosphor Icons (MIT, phosphoricons.com): the
- * solid weight for what the agent does, the regular one for what it reaches. Drawn here so the
- * package carries no icon dependency.
- */
-export declare const NODE_PATHS: Readonly<Record<NodeKind, string>>;

package/dist/flow/nodePaths.js

@@ -1,17 +0,0 @@
-/**
- * What marks each kind of part on the map, from Phosphor Icons (MIT, phosphoricons.com): the
- * solid weight for what the agent does, the regular one for what it reaches. Drawn here so the
- * package carries no icon dependency.
- */
-export const NODE_PATHS = {
-    channel: "M232.07,186.76a80,80,0,0,0-62.5-114.17A80,80,0,1,0,23.93,138.76l-7.27,24.71a16,16,0,0,0,19.87,19.87l24.71-7.27a80.39,80.39,0,0,0,25.18,7.35,80,80,0,0,0,108.34,40.65l24.71,7.27a16,16,0,0,0,19.87-19.86ZM62,159.5a8.28,8.28,0,0,0-2.26.32L32,168l8.17-27.76a8,8,0,0,0-.63-6,64,64,0,1,1,26.26,26.26A8,8,0,0,0,62,159.5Zm153.79,28.73L224,216l-27.76-8.17a8,8,0,0,0-6,.63,64.05,64.05,0,0,1-85.87-24.88A79.93,79.93,0,0,0,174.7,89.71a64,64,0,0,1,41.75,92.48A8,8,0,0,0,215.82,188.23Z",
-    automation: "M213.85,125.46l-112,120a8,8,0,0,1-13.69-7l14.66-73.33L45.19,143.49a8,8,0,0,1-3-13l112-120a8,8,0,0,1,13.69,7L153.18,90.9l57.63,21.61a8,8,0,0,1,3,12.95Z",
-    skill: "M208,144a15.78,15.78,0,0,1-10.42,14.94L146,178l-19,51.62a15.92,15.92,0,0,1-29.88,0L78,178l-51.62-19a15.92,15.92,0,0,1,0-29.88L78,110l19-51.62a15.92,15.92,0,0,1,29.88,0L146,110l51.62,19A15.78,15.78,0,0,1,208,144ZM152,48h16V64a8,8,0,0,0,16,0V48h16a8,8,0,0,0,0-16H184V16a8,8,0,0,0-16,0V32H152a8,8,0,0,0,0,16Zm88,32h-8V72a8,8,0,0,0-16,0v8h-8a8,8,0,0,0,0,16h8v8a8,8,0,0,0,16,0V96h8a8,8,0,0,0,0-16Z",
-    action: "M226.76,69a8,8,0,0,0-12.84-2.88l-40.3,37.19-17.23-3.7-3.7-17.23,37.19-40.3A8,8,0,0,0,187,29.24,72,72,0,0,0,88,96,72.34,72.34,0,0,0,94,124.94L33.79,177c-.15.12-.29.26-.43.39a32,32,0,0,0,45.26,45.26c.13-.13.27-.28.39-.42L131.06,162A72,72,0,0,0,232,96,71.56,71.56,0,0,0,226.76,69ZM160,152a56.14,56.14,0,0,1-27.07-7,8,8,0,0,0-9.92,1.77L67.11,211.51a16,16,0,0,1-22.62-22.62L109.18,133a8,8,0,0,0,1.77-9.93,56,56,0,0,1,58.36-82.31l-31.2,33.81a8,8,0,0,0-1.94,7.1L141.83,108a8,8,0,0,0,6.14,6.14l26.35,5.66a8,8,0,0,0,7.1-1.94l33.81-31.2A56.06,56.06,0,0,1,160,152Z",
-    record: "M128,24C74.17,24,32,48.6,32,80v96c0,31.4,42.17,56,96,56s96-24.6,96-56V80C224,48.6,181.83,24,128,24Zm80,104c0,9.62-7.88,19.43-21.61,26.92C170.93,163.35,150.19,168,128,168s-42.93-4.65-58.39-13.08C55.88,147.43,48,137.62,48,128V111.36c17.06,15,46.23,24.64,80,24.64s62.94-9.68,80-24.64ZM69.61,53.08C85.07,44.65,105.81,40,128,40s42.93,4.65,58.39,13.08C200.12,60.57,208,70.38,208,80s-7.88,19.43-21.61,26.92C170.93,115.35,150.19,120,128,120s-42.93-4.65-58.39-13.08C55.88,99.43,48,89.62,48,80S55.88,60.57,69.61,53.08ZM186.39,202.92C170.93,211.35,150.19,216,128,216s-42.93-4.65-58.39-13.08C55.88,195.43,48,185.62,48,176V159.36c17.06,15,46.23,24.64,80,24.64s62.94-9.68,80-24.64V176C208,185.62,200.12,195.43,186.39,202.92Z",
-    app: "M220.27,158.54a8,8,0,0,0-7.7-.46,20,20,0,1,1,0-36.16A8,8,0,0,0,224,114.69V72a16,16,0,0,0-16-16H171.78a35.36,35.36,0,0,0,.22-4,36.11,36.11,0,0,0-11.36-26.24,36,36,0,0,0-60.55,23.62,36.56,36.56,0,0,0,.14,6.62H64A16,16,0,0,0,48,72v32.22a35.36,35.36,0,0,0-4-.22,36.12,36.12,0,0,0-26.24,11.36,35.7,35.7,0,0,0-9.69,27,36.08,36.08,0,0,0,33.31,33.6,35.68,35.68,0,0,0,6.62-.14V208a16,16,0,0,0,16,16H208a16,16,0,0,0,16-16V165.31A8,8,0,0,0,220.27,158.54ZM208,208H64V165.31a8,8,0,0,0-11.43-7.23,20,20,0,1,1,0-36.16A8,8,0,0,0,64,114.69V72h46.69a8,8,0,0,0,7.23-11.43,20,20,0,1,1,36.16,0A8,8,0,0,0,161.31,72H208v32.23a35.68,35.68,0,0,0-6.62-.14A36,36,0,0,0,204,176a35.36,35.36,0,0,0,4-.22Z",
-    owner: "M128,24A104,104,0,1,0,232,128,104.11,104.11,0,0,0,128,24ZM74.08,197.5a64,64,0,0,1,107.84,0,87.83,87.83,0,0,1-107.84,0ZM96,120a32,32,0,1,1,32,32A32,32,0,0,1,96,120Zm97.76,66.41a79.66,79.66,0,0,0-36.06-28.75,48,48,0,1,0-59.4,0,79.66,79.66,0,0,0-36.06,28.75,88,88,0,1,1,131.52,0Z",
-    browser: "M128,24h0A104,104,0,1,0,232,128,104.12,104.12,0,0,0,128,24Zm88,104a87.61,87.61,0,0,1-3.33,24H174.16a157.44,157.44,0,0,0,0-48h38.51A87.61,87.61,0,0,1,216,128ZM102,168H154a115.11,115.11,0,0,1-26,45A115.27,115.27,0,0,1,102,168Zm-3.9-16a140.84,140.84,0,0,1,0-48h59.88a140.84,140.84,0,0,1,0,48ZM40,128a87.61,87.61,0,0,1,3.33-24H81.84a157.44,157.44,0,0,0,0,48H43.33A87.61,87.61,0,0,1,40,128ZM154,88H102a115.11,115.11,0,0,1,26-45A115.27,115.27,0,0,1,154,88Zm52.33,0H170.71a135.28,135.28,0,0,0-22.3-45.6A88.29,88.29,0,0,1,206.37,88ZM107.59,42.4A135.28,135.28,0,0,0,85.29,88H49.63A88.29,88.29,0,0,1,107.59,42.4ZM49.63,168H85.29a135.28,135.28,0,0,0,22.3,45.6A88.29,88.29,0,0,1,49.63,168Zm98.78,45.6a135.28,135.28,0,0,0,22.3-45.6h35.66A88.29,88.29,0,0,1,148.41,213.6Z",
-    files: "M216,72H131.31L104,44.69A15.86,15.86,0,0,0,92.69,40H40A16,16,0,0,0,24,56V200.62A15.4,15.4,0,0,0,39.38,216H216.89A15.13,15.13,0,0,0,232,200.89V88A16,16,0,0,0,216,72ZM40,56H92.69l16,16H40ZM216,200H40V88H216Z",
-    store: "M128,24C74.17,24,32,48.6,32,80v96c0,31.4,42.17,56,96,56s96-24.6,96-56V80C224,48.6,181.83,24,128,24Zm80,104c0,9.62-7.88,19.43-21.61,26.92C170.93,163.35,150.19,168,128,168s-42.93-4.65-58.39-13.08C55.88,147.43,48,137.62,48,128V111.36c17.06,15,46.23,24.64,80,24.64s62.94-9.68,80-24.64ZM69.61,53.08C85.07,44.65,105.81,40,128,40s42.93,4.65,58.39,13.08C200.12,60.57,208,70.38,208,80s-7.88,19.43-21.61,26.92C170.93,115.35,150.19,120,128,120s-42.93-4.65-58.39-13.08C55.88,99.43,48,89.62,48,80S55.88,60.57,69.61,53.08ZM186.39,202.92C170.93,211.35,150.19,216,128,216s-42.93-4.65-58.39-13.08C55.88,195.43,48,185.62,48,176V159.36c17.06,15,46.23,24.64,80,24.64s62.94-9.68,80-24.64V176C208,185.62,200.12,195.43,186.39,202.92Z",
-};

package/dist/flow/relations.d.ts

@@ -1,42 +0,0 @@
-/**
- * How the parts of an agent relate, read from the package's files without running anything:
- * which part calls which action, writes which record, uses which app, reaches the owner. The
- * same references the server's manifest checks, found with the SDK's own spelling
- * (`sc.call("x")`, `sc.records.find("x")`, `sc.tool("alias", "Action")`…). A reference to
- * something that is not in the package is dropped, never an error: the map shows what is true.
- */
-import { type FlowWords } from "./kinds.js";
-export interface PartNode {
-    /** The file's path, or `owner` / `browser` / `files` / `store` for what a part reaches outside the package. */
-    path: string;
-    kind: string;
-    /** The part's stable name (`aviso`). */
-    name: string;
-    /** What its kind is called to the owner ("Qué hace"). */
-    label: string;
-}
-export type EdgeKind = "calls" | "writes" | "reads" | "uses-app" | "reaches" | "starts-from";
-export interface Edge {
-    from: string;
-    to: string;
-    kind: EdgeKind;
-    /** The operation or action named at the reference (`find`, `notify`, `Gmail_SendEmail`). */
-    label?: string;
-    /** 1-based line of the first reference in `from`. */
-    line: number;
-}
-export interface Trigger {
-    kind: "cron" | "webhook" | "event" | "none";
-    /** The schedule, the path or the event type, as written. */
-    detail: string;
-}
-/** How an automation starts: the `@sc.cron`, `@sc.webhook` or `@sc.on` over its handler. */
-export declare function triggerOf(path: string, source: string): Trigger | null;
-/**
- * The parts of the package and how they relate. Edges to parts that do not exist are dropped.
- * The `words` name the kinds and what lies outside the package (Spanish unless given).
- */
-export declare function relationsOf(files: Record<string, string>, words?: FlowWords): {
-    nodes: PartNode[];
-    edges: Edge[];
-};

package/dist/flow/relations.js

@@ -1,174 +0,0 @@
-/**
- * How the parts of an agent relate, read from the package's files without running anything:
- * which part calls which action, writes which record, uses which app, reaches the owner. The
- * same references the server's manifest checks, found with the SDK's own spelling
- * (`sc.call("x")`, `sc.records.find("x")`, `sc.tool("alias", "Action")`…). A reference to
- * something that is not in the package is dropped, never an error: the map shows what is true.
- */
-import { es } from "../messages/es.js";
-import { kindLabel, kindOf, partName } from "./kinds.js";
-/** Kinds of parts that take part in the map; tests, libraries and loose files do not. */
-const MAPPED_KINDS = new Set([
-    "conduct",
-    "channels",
-    "automations",
-    "actions",
-    "records",
-    "apps",
-]);
-/** What a part can reach outside the package, by the path an edge points at. */
-const OUTSIDE = ["owner", "browser", "files", "store"];
-const isOutside = (path) => OUTSIDE.includes(path);
-/**
- * Which characters of Python source are code: not inside a comment, and not inside a string
- * (its quotes count as code, its content does not). Enough to ignore `# sc.call("x")` and
- * `"sc.call('x')"` without a parser.
- */
-function codeMask(source) {
-    const mask = new Array(source.length).fill(true);
-    let i = 0;
-    while (i < source.length) {
-        const ch = source[i];
-        if (ch === "#") {
-            while (i < source.length && source[i] !== "\n")
-                mask[i++] = false;
-        }
-        else if (ch === '"' || ch === "'") {
-            const triple = source.startsWith(ch.repeat(3), i);
-            const quote = triple ? ch.repeat(3) : ch;
-            i += quote.length;
-            while (i < source.length && !source.startsWith(quote, i)) {
-                if (source[i] === "\\")
-                    mask[i++] = false;
-                else if (!triple && source[i] === "\n")
-                    break;
-                mask[i++] = false;
-            }
-            i += quote.length;
-        }
-        else {
-            i++;
-        }
-    }
-    return mask;
-}
-const lineAt = (source, index) => {
-    let line = 1;
-    for (let i = 0; i < index; i++)
-        if (source[i] === "\n")
-            line++;
-    return line;
-};
-/** Every match of `pattern` that starts in code, with its line. */
-function hits(source, mask, pattern) {
-    const found = [];
-    for (const match of source.matchAll(new RegExp(pattern, `${pattern.flags}g`))) {
-        if (mask[match.index])
-            found.push({ match, line: lineAt(source, match.index) });
-    }
-    return found;
-}
-const CALL = /\bsc\.call\(\s*(["'])([\w-]+)\1/;
-const RECORDS = /\bsc\.records\.(add|get|update|find|remove)\(\s*(["'])([\w-]+)\2/;
-const TOOL = /\bsc\.tool\(\s*(["'])([\w-]+)\1(?:\s*,\s*(["'])([\w.-]+)\3)?/;
-const OWNER = /\bsc\.owner\.(notify|ask|approve)\(/;
-const SEND_VIA = /\bsc\.send\([^)]*?\bvia\s*=\s*(["'])([\w-]+)\1/;
-const BROWSER = /\bsc\.browser\.(open|do|read|screenshot|show|close)\(/;
-const FILES = /\bsc\.files\.(put|get|list|url|delete)\(/;
-/** The key-value store (`sc.store`), what an agent keeps when it has no record of its own. */
-const STORE = /\bsc\.store\.(put|get|query|delete)\(/;
-const DECORATOR = /^[ \t]*@sc\.(cron|webhook|on)\(\s*(["'])([^"'\n]*)\2/m;
-const WRITES = new Set(["add", "update", "remove", "put", "delete"]);
-/** The trigger of an automation and the line it is declared on. */
-function declaredTrigger(path, source, mask) {
-    if (kindOf(path) !== "automations")
-        return null;
-    const [found] = hits(source, mask, DECORATOR);
-    if (!found)
-        return { trigger: { kind: "none", detail: "" }, line: 1 };
-    const [, decorator = "", , detail = ""] = found.match;
-    const kind = decorator === "on" ? "event" : decorator;
-    return { trigger: { kind, detail }, line: found.line };
-}
-/** How an automation starts: the `@sc.cron`, `@sc.webhook` or `@sc.on` over its handler. */
-export function triggerOf(path, source) {
-    return declaredTrigger(path, source, codeMask(source))?.trigger ?? null;
-}
-/** The references one Python file makes, before they are checked against the package. */
-function referencesOf(path, source) {
-    const mask = codeMask(source);
-    const edge = (kind, to, line, label) => ({
-        from: path,
-        to,
-        kind,
-        line,
-        ...(label !== undefined && { label }),
-    });
-    const edges = [];
-    for (const { match, line } of hits(source, mask, CALL)) {
-        edges.push(edge("calls", `actions/${match[2]}.py`, line));
-    }
-    for (const { match, line } of hits(source, mask, RECORDS)) {
-        const op = match[1] ?? "";
-        edges.push(edge(WRITES.has(op) ? "writes" : "reads", `records/${match[3]}.py`, line, op));
-    }
-    for (const { match, line } of hits(source, mask, TOOL)) {
-        edges.push(edge("uses-app", `apps/${match[2]}.yaml`, line, match[4]));
-    }
-    for (const { match, line } of hits(source, mask, OWNER)) {
-        edges.push(edge("reaches", "owner", line, match[1]));
-    }
-    for (const { match, line } of hits(source, mask, SEND_VIA)) {
-        edges.push(edge("reaches", `channels/${match[2]}.yaml`, line, "send"));
-    }
-    for (const { match, line } of hits(source, mask, BROWSER)) {
-        edges.push(edge("reaches", "browser", line, match[1]));
-    }
-    for (const { match, line } of hits(source, mask, FILES)) {
-        const op = match[1] ?? "";
-        edges.push(edge(WRITES.has(op) ? "writes" : "reads", "files", line, op));
-    }
-    for (const { match, line } of hits(source, mask, STORE)) {
-        const op = match[1] ?? "";
-        edges.push(edge(WRITES.has(op) ? "writes" : "reads", "store", line, op));
-    }
-    const declared = declaredTrigger(path, source, mask);
-    const app = declared?.trigger.kind === "event"
-        ? /^connection\.([\w-]+)\.(.+)$/.exec(declared.trigger.detail)
-        : null;
-    if (declared && app) {
-        edges.push(edge("starts-from", `apps/${app[1]}.yaml`, declared.line, app[2]));
-    }
-    return edges;
-}
-/**
- * The parts of the package and how they relate. Edges to parts that do not exist are dropped.
- * The `words` name the kinds and what lies outside the package (Spanish unless given).
- */
-export function relationsOf(files, words = es.flow) {
-    // The package's parts, and a loose `.py` at the root: the old layout's one `app.py`.
-    const paths = Object.keys(files).filter((path) => MAPPED_KINDS.has(kindOf(path)) || (!path.includes("/") && path.endsWith(".py")));
-    const known = new Set(paths);
-    const seen = new Set();
-    const edges = [];
-    for (const path of paths.filter((p) => p.endsWith(".py"))) {
-        for (const edge of referencesOf(path, files[path] ?? "")) {
-            const key = [edge.from, edge.to, edge.kind, edge.label].join("|");
-            if (seen.has(key) || !(known.has(edge.to) || isOutside(edge.to)))
-                continue;
-            seen.add(key);
-            edges.push(edge);
-        }
-    }
-    const nodes = paths.map((path) => {
-        const kind = kindOf(path);
-        return { path, kind, name: partName(path, words), label: kindLabel(kind, words) };
-    });
-    for (const outside of OUTSIDE) {
-        if (edges.some((edge) => edge.to === outside)) {
-            const { label } = words.outside[outside];
-            nodes.push({ path: outside, kind: outside, name: outside, label });
-        }
-    }
-    return { nodes, edges };
-}