@jinion/core 0.2.1 → 0.4.0

package/dist/directions/store.js

@@ -0,0 +1,61 @@
+import { randomUUID } from 'node:crypto';
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { projectDir } from '../lib/paths.js';
+/** The project's rounds of directions, a folder each, out of the project and of git. */
+export class DirectionsStore {
+    cwd;
+    constructor(cwd) {
+        this.cwd = cwd;
+    }
+    get dir() {
+        return join(projectDir(this.cwd), 'directions');
+    }
+    add({ title, directions }) {
+        const round = { id: randomUUID().slice(0, 8), title, at: Date.now(), directions: directions.map(({ name, idea }) => ({ name, idea })) };
+        const folder = join(this.dir, round.id);
+        mkdirSync(folder, { recursive: true });
+        for (const [index, { html }] of directions.entries())
+            writeFileSync(join(folder, pageName(index)), html);
+        this.save(round);
+        return round;
+    }
+    /** The newest first. */
+    list() {
+        if (!existsSync(this.dir))
+            return [];
+        return readdirSync(this.dir)
+            .flatMap((id) => this.get(id) ?? [])
+            .sort((a, b) => b.at - a.at);
+    }
+    get(id) {
+        if (!ROUND_ID.test(id))
+            return undefined;
+        const file = join(this.dir, id, 'round.json');
+        return existsSync(file) ? JSON.parse(readFileSync(file, 'utf8')) : undefined;
+    }
+    /** The page of a round's direction, by its place in the round. */
+    page(id, index) {
+        const round = this.get(id);
+        if (!round || !Number.isInteger(index) || index < 0 || index >= round.directions.length)
+            return undefined;
+        return readFileSync(join(this.dir, id, pageName(index)), 'utf8');
+    }
+    pick(id, name) {
+        const round = this.get(id);
+        if (!round?.directions.some((direction) => direction.name === name))
+            return undefined;
+        const picked = { ...round, picked: name };
+        this.save(picked);
+        return picked;
+    }
+    save(round) {
+        writeFileSync(join(this.dir, round.id, 'round.json'), `${JSON.stringify(round, null, 2)}\n`);
+    }
+}
+// Ids come back in addresses, so only one of ours ever names a folder.
+const ROUND_ID = /^[0-9a-f]{8}$/;
+function pageName(index) {
+    return `${index + 1}.html`;
+}
+//# sourceMappingURL=store.js.map

package/dist/directions/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/directions/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAsB7C,wFAAwF;AACxF,MAAM,OAAO,eAAe;IACG,GAAG;IAAhC,YAA6B,GAAW;mBAAX,GAAG;IAAW,CAAC;IAE5C,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC,CAAC;IAClD,CAAC;IAED,GAAG,CAAC,EAAE,KAAK,EAAE,UAAU,EAAW;QAChC,MAAM,KAAK,GAAU,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QAC/I,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QAExC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,KAAK,MAAM,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE;YAAE,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACzG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEjB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,wBAAwB;IACxB,IAAI;QACF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;QAErC,OAAO,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC;aACzB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;aACnC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,OAAO,SAAS,CAAC;QAEzC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,YAAY,CAAC,CAAC;QAE9C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1F,CAAC;IAED,kEAAkE;IAClE,IAAI,CAAC,EAAU,EAAE,KAAa;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAE1G,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,CAAC,EAAU,EAAE,IAAY;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC;YAAE,OAAO,SAAS,CAAC;QAEtF,MAAM,MAAM,GAAG,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAE1C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAElB,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,IAAI,CAAC,KAAY;QACvB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,YAAY,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC/F,CAAC;CACF;AAED,uEAAuE;AACvE,MAAM,QAAQ,GAAG,eAAe,CAAC;AAEjC,SAAS,QAAQ,CAAC,KAAa;IAC7B,OAAO,GAAG,KAAK,GAAG,CAAC,OAAO,CAAC;AAC7B,CAAC"}

package/dist/directions/tools.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import type { ToolCall } from '../agent/tools.js';
+import type { Previews } from '../preview/previews.js';
+import { type Directions, type Picked } from './directions.js';
+/** A tool the agent shows directions with; each backend offers it its own way. */
+export interface DirectionsTool<S extends z.ZodRawShape = z.ZodRawShape> {
+    description: string;
+    input: S;
+    run(input: z.infer<z.ZodObject<S>>): Promise<string>;
+}
+/** `onPick` is told of a pick on a round this conversation showed; `previews` opens the round beside the thread where the app has a Preview. */
+export declare function directionsTools(directions: Directions, onPick: (picked: Picked) => void, previews?: Previews): {
+    show_directions: DirectionsTool<{
+        title: z.ZodString;
+        directions: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            idea: z.ZodString;
+            html: z.ZodString;
+        }, z.core.$strip>>;
+    }>;
+};
+export type DirectionsTools = ReturnType<typeof directionsTools>;
+export type DirectionsAction = keyof DirectionsTools;
+export declare const DIRECTIONS_ACTIONS: Set<string>;
+/** A call of the tool as the conversation shows it, worded alike whichever backend made it. */
+export declare function directionsCall(input: unknown): ToolCall;
+/** What the user's pick says to the agent, as their own message. */
+export declare function pickMessage({ round, direction }: Picked): string;
+//# sourceMappingURL=tools.d.ts.map

package/dist/directions/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/directions/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,MAAM,EAAkB,MAAM,iBAAiB,CAAC;AAE/E,kFAAkF;AAClF,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,CAAC,CAAC;IACT,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACtD;AAMD,gJAAgJ;AAChJ,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,EAAE,QAAQ,CAAC,EAAE,QAAQ;IAEzG,eAAe;;;;;;;;EA4ClB;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAEjE,MAAM,MAAM,gBAAgB,GAAG,MAAM,eAAe,CAAC;AAErD,eAAO,MAAM,kBAAkB,aAAoE,CAAC;AAEpG,+FAA+F;AAC/F,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAIvD;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,MAAM,UAEvD"}

package/dist/directions/tools.js

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+import { errorMessage } from '../lib/errors.js';
+import { SIDEBAR_CLOSED } from './directions.js';
+const MAX_PAGE_BYTES = 2 * 1024 * 1024;
+const define = (tool) => tool;
+/** `onPick` is told of a pick on a round this conversation showed; `previews` opens the round beside the thread where the app has a Preview. */
+export function directionsTools(directions, onPick, previews) {
+    return {
+        show_directions: define({
+            description: "Shows the user a round of directions to pick from, in Jinion's own viewer outside the project: each direction's name, its idea in a sentence and its page. Use it whenever you offer directions, rather than describing them in words or writing their pages into the project. Nothing is written in the project and nothing is asked. The user's pick comes back as their next message.",
+            input: {
+                title: z.string().describe('What the round decides, in a few words, such as "The today screen".'),
+                directions: z
+                    .array(z.object({
+                    name: z.string().describe('A word or two the user can call it by.'),
+                    idea: z.string().describe('What it stands for and what it gives up, in a sentence.'),
+                    html: z
+                        .string()
+                        .describe("Its page: one whole HTML document, its CSS and any script inline, pictures as data: URLs or from the web. Nothing from the project's files or its dev server, which the viewer can't reach."),
+                }))
+                    .min(2)
+                    .max(4),
+            },
+            run: async ({ title, directions: offered }) => {
+                const names = offered.map(({ name }) => name.trim());
+                if (new Set(names).size < names.length)
+                    return 'Two directions have the same name. Give each its own, so the user can tell them apart.';
+                const large = offered.find(({ html }) => Buffer.byteLength(html) > MAX_PAGE_BYTES);
+                if (large)
+                    return `The page of ${large.name} is over 2 MB. Leave large pictures out, or take them from the web.`;
+                const { address, pages, shown } = await directions.show({ title, directions: offered.map((direction, index) => ({ ...direction, name: names[index] })) }, onPick);
+                const preview = previews?.client;
+                const opened = preview && !(await preview.open(`${address}${SIDEBAR_CLOSED}`).catch((error) => ({ error: errorMessage(error) }))).error;
+                return [
+                    opened
+                        ? 'The directions are open in the Preview beside the conversation, where the user sees them now.'
+                        : `The directions are shown. Give the user this address to open in their browser: ${address}`,
+                    'They pick there, and the pick comes back as their next message; they may also answer in words. Until they pick, build none of the directions in the project.',
+                    'Before you tell them, look at each page with `look`; if one needs fixing, show the round again:',
+                    // In the Preview each is looked at in the viewer, so the round stays where the user sees it.
+                    ...(opened ? shown : pages).map((page, index) => `- ${names[index]}: ${page}`),
+                ].join('\n');
+            },
+        }),
+    };
+}
+export const DIRECTIONS_ACTIONS = new Set(['show_directions']);
+/** A call of the tool as the conversation shows it, worded alike whichever backend made it. */
+export function directionsCall(input) {
+    const { title } = (input ?? {});
+    return { name: 'other', input: { title: 'Show directions', detail: String(title ?? '') } };
+}
+/** What the user's pick says to the agent, as their own message. */
+export function pickMessage({ round, direction }) {
+    return `I pick ${direction}, of the directions for ${round.title}.`;
+}
+//# sourceMappingURL=tools.js.map

package/dist/directions/tools.js.map

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

package/dist/directions/viewer.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The viewer the core serves, as drawn in @jinion/ui's playground (`pages/directions`): one page that reads the rounds
+ * from beside it. The core draws no React, so it is written out here, with @jinion/ui's tokens by the same names.
+ */
+export declare function viewerPage(project: string): string;
+//# sourceMappingURL=viewer.d.ts.map

package/dist/directions/viewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer.d.ts","sourceRoot":"","sources":["../../src/directions/viewer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,UAezC"}

package/dist/directions/viewer.js

@@ -0,0 +1,266 @@
+/**
+ * The viewer the core serves, as drawn in @jinion/ui's playground (`pages/directions`): one page that reads the rounds
+ * from beside it. The core draws no React, so it is written out here, with @jinion/ui's tokens by the same names.
+ */
+export function viewerPage(project) {
+    return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Directions</title>
+<style>${STYLE}</style>
+</head>
+<body>
+<nav id="rounds"><h1><span class="strong">Directions</span><span class="faint">${escapeHtml(project)}</span></h1></nav>
+<main><div class="sheet" id="sheet"></div></main>
+<script>${SCRIPT}</script>
+</body>
+</html>`;
+}
+function escapeHtml(text) {
+    return text.replace(/[&<>"']/g, (character) => `&#${character.charCodeAt(0)};`);
+}
+const STYLE = `
+:root {
+  --background: #ffffff;
+  --raised: #f4f5f8;
+  --floating: #ffffff;
+  --ink: #12162a;
+  --muted: #5c6275;
+  --faint: #989dae;
+  --edge: rgb(18 22 42 / 0.1);
+  --shade: rgb(18 22 42 / 0.045);
+  --selected: rgb(18 22 42 / 0.07);
+  --primary: #181e33;
+  --on-primary: #ffffff;
+  --float-shadow: 0 6px 24px -8px rgb(0 0 0 / 0.14), 0 0 0 0.5px rgb(0 0 0 / 0.1);
+  --sheet-shadow: 0 0 0 1px rgb(0 0 0 / 0.05), 0 1px 2px 0 rgb(0 0 0 / 0.05);
+  --font-sans: -apple-system, BlinkMacSystemFont, "SF Pro Text", system-ui, sans-serif;
+  --font-mono: "JetBrains Mono", ui-monospace, Menlo, monospace;
+  color-scheme: light;
+}
+* { box-sizing: border-box; }
+html, body { height: 100%; margin: 0; }
+body { display: flex; background: var(--raised); color: var(--ink); font: 13px/20px var(--font-sans); -webkit-font-smoothing: antialiased; }
+button { font: inherit; color: inherit; border: 0; background: none; padding: 0; cursor: default; text-align: left; transition: background-color 100ms ease-out, color 100ms ease-out; }
+button:focus-visible { outline: 2px solid var(--primary); outline-offset: 1px; }
+.strong { font-weight: 600; }
+.faint { color: var(--faint); }
+.small { font-size: 12px; line-height: 16px; }
+.truncate { overflow: hidden; white-space: nowrap; text-overflow: ellipsis; }
+nav { display: flex; flex-direction: column; gap: 1px; width: 224px; flex-shrink: 0; padding: 12px; overflow-y: auto; }
+nav h1 { display: flex; align-items: baseline; gap: 8px; margin: 0; padding: 4px 10px 12px; font-size: inherit; font-weight: 400; min-width: 0; }
+.round { display: flex; flex-direction: column; min-width: 0; border-radius: 8px; padding: 6px 10px; color: var(--muted); }
+.round:hover { color: var(--ink); }
+.round[aria-current="true"] { background: var(--shade); color: var(--ink); }
+main { flex: 1; min-width: 0; padding: 12px 12px 12px 0; }
+.sidebar-closed nav { display: none; }
+.sidebar-closed main { padding-left: 12px; }
+.sheet { position: relative; height: 100%; overflow: hidden; border-radius: 12px; background: var(--background); box-shadow: var(--sheet-shadow); }
+iframe { display: block; width: 100%; height: 100%; border: 0; }
+.dock { position: absolute; inset: auto 16px 16px; display: flex; justify-content: center; pointer-events: none; }
+.switcher { display: flex; align-items: center; gap: 4px; max-width: 100%; min-width: 0; padding: 4px; border-radius: 16px; background: var(--floating); box-shadow: var(--float-shadow); pointer-events: auto; user-select: none; }
+.options { display: flex; gap: 4px; min-width: 0; overflow-x: auto; }
+.option { display: flex; flex-direction: column; gap: 2px; width: 208px; min-width: 144px; flex-shrink: 1; border-radius: 12px; padding: 8px 12px; }
+.option:hover { background: var(--shade); }
+.option[aria-pressed="true"] { background: var(--selected); }
+.option-head { display: flex; align-items: center; gap: 6px; }
+.option-name { font-weight: 500; color: var(--ink); }
+.option-number { margin-left: auto; font: 12px/20px var(--font-mono); color: var(--faint); }
+.idea { display: -webkit-box; -webkit-box-orient: vertical; -webkit-line-clamp: 2; overflow: hidden; font-size: 12px; line-height: 16px; color: var(--muted); }
+.check { width: 14px; height: 14px; flex-shrink: 0; color: var(--muted); }
+.act { display: flex; flex-direction: column; align-items: flex-end; gap: 2px; flex-shrink: 0; padding: 0 8px; }
+.button { display: inline-flex; align-items: center; gap: 8px; height: 32px; padding: 0 12px; border-radius: 8px; font-weight: 500; white-space: nowrap; }
+.button .check { width: 16px; height: 16px; color: inherit; }
+.primary { background: var(--primary); color: var(--on-primary); }
+.primary:hover { background: color-mix(in srgb, var(--primary) 90%, transparent); }
+.outline { background: var(--background); box-shadow: 0 0 0 1px var(--edge), 0 1px 2px 0 rgb(0 0 0 / 0.05); }
+.button:disabled { opacity: 0.4; }
+.said { max-width: 208px; text-align: right; }
+.empty { display: flex; flex-direction: column; align-items: center; justify-content: center; gap: 4px; height: 100%; padding: 0 24px; text-align: center; }
+.empty p { margin: 0; }
+.empty .title { font-weight: 500; }
+.empty .text { max-width: 320px; color: var(--muted); text-wrap: pretty; }
+@media (prefers-reduced-motion: reduce) { * { transition: none !important; } }
+`;
+const SCRIPT = `
+const CHECK = '<svg class="check" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M20 6 9 17l-5-5"/></svg>';
+const nav = document.getElementById('rounds');
+const sheet = document.getElementById('sheet');
+let rounds = [];
+let loaded = false;
+const params = new URLSearchParams(location.search);
+let roundId = params.get('round');
+// The direction the address asks for, by its number in the round, as the agent opens each one to look at it.
+const asked = Number(params.get('direction') ?? 1) - 1;
+let shown = 0;
+let said = '';
+
+function element(tag, className, text) {
+  const made = document.createElement(tag);
+  if (className) made.className = className;
+  if (text !== undefined) made.textContent = text;
+  return made;
+}
+
+function current() {
+  return rounds.find((round) => round.id === roundId);
+}
+
+function when(at) {
+  const date = new Date(at);
+  const time = date.toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' });
+  const days = Math.round((new Date().setHours(0, 0, 0, 0) - new Date(at).setHours(0, 0, 0, 0)) / 86400000);
+  if (days === 0) return 'Today, ' + time;
+  if (days === 1) return 'Yesterday, ' + time;
+  return date.toLocaleDateString([], { day: 'numeric', month: 'long' });
+}
+
+function open(id, index = 0) {
+  roundId = id;
+  show(index);
+}
+
+function show(index) {
+  const round = current();
+  shown = round && index >= 0 && index < round.directions.length ? index : 0;
+  said = '';
+  const url = new URL(location.href);
+  if (roundId) url.searchParams.set('round', roundId);
+  url.searchParams.set('direction', String(shown + 1));
+  history.replaceState(null, '', url);
+  render();
+}
+
+function renderRounds() {
+  nav.querySelectorAll('.round').forEach((row) => row.remove());
+  for (const round of rounds) {
+    const row = element('button', 'round');
+    row.type = 'button';
+    row.setAttribute('aria-current', String(round.id === roundId));
+    row.append(element('span', 'truncate', round.title));
+    const status = round.picked ? 'Picked ' + round.picked : round.directions.length + ' to pick from';
+    row.append(element('span', 'truncate small faint', status + ' · ' + when(round.at)));
+    row.onclick = () => open(round.id);
+    nav.append(row);
+  }
+}
+
+function renderSheet() {
+  const round = current();
+  if (!round) {
+    sheet.replaceChildren(empty());
+    return;
+  }
+  document.title = round.title + ' · Directions';
+  const direction = round.directions[shown];
+  const src = 'rounds/' + round.id + '/' + (shown + 1);
+  let frame = sheet.querySelector('iframe');
+  if (!frame) frame = element('iframe');
+  if (frame.getAttribute('src') !== src) {
+    frame.setAttribute('src', src);
+    frame.title = direction.name;
+  }
+  // The page holds no secret of the viewer's, and runs on an origin of its own besides.
+  frame.setAttribute('sandbox', 'allow-scripts allow-forms allow-popups');
+  sheet.replaceChildren(frame, dock(round));
+}
+
+function dock(round) {
+  const options = element('div', 'options');
+  round.directions.forEach((direction, index) => {
+    const option = element('button', 'option');
+    option.type = 'button';
+    option.title = direction.idea;
+    option.setAttribute('aria-pressed', String(index === shown));
+    const head = element('span', 'option-head');
+    head.append(element('span', 'option-name', direction.name));
+    if (direction.name === round.picked) head.insertAdjacentHTML('beforeend', CHECK);
+    head.append(element('span', 'option-number', String(index + 1)));
+    option.append(head, element('span', 'idea', direction.idea));
+    option.onclick = () => show(index);
+    options.append(option);
+  });
+  const act = element('div', 'act');
+  const name = round.directions[shown].name;
+  const button = element('button', 'button');
+  button.type = 'button';
+  if (name === round.picked) {
+    button.className = 'button outline';
+    button.disabled = true;
+    button.innerHTML = CHECK;
+    button.append('Picked');
+  } else {
+    button.className = 'button primary';
+    button.textContent = round.picked ? 'Pick ' + name + ' instead' : 'Pick ' + name;
+    button.onclick = () => pick(round, name);
+  }
+  act.append(button);
+  if (said) act.append(element('span', 'said small faint', said));
+  const switcher = element('div', 'switcher');
+  switcher.append(options, act);
+  const wrapper = element('div', 'dock');
+  wrapper.append(switcher);
+  return wrapper;
+}
+
+function empty(title = 'No directions yet', text = 'When Jinion offers you directions for this project, each round shows here to compare and pick from.') {
+  const box = element('div', 'empty');
+  box.append(element('p', 'title', title), element('p', 'text', text));
+  return box;
+}
+
+async function pick(round, name) {
+  try {
+    const response = await fetch('rounds/' + round.id + '/pick', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ direction: name }) });
+    if (!response.ok) throw new Error(String(response.status));
+    const answer = await response.json();
+    rounds = rounds.map((each) => (each.id === answer.round.id ? answer.round : each));
+    said = answer.sent ? '' : "Saved. Its conversation isn't open, so tell Jinion there.";
+  } catch {
+    said = "Jinion couldn't be reached. Is it still running?";
+  }
+  render();
+}
+
+function render() {
+  document.body.classList.toggle('sidebar-closed', location.hash === '#sidebar-closed');
+  renderRounds();
+  renderSheet();
+}
+
+async function load() {
+  try {
+    const known = new Set(rounds.map((round) => round.id));
+    const response = await fetch('rounds');
+    if (!response.ok) throw new Error(String(response.status));
+    const fresh = await response.json();
+    const first = !loaded;
+    loaded = true;
+    rounds = fresh;
+    const added = fresh.find((round) => !known.has(round.id));
+    // A round shown while the viewer is open comes up by itself.
+    if (!first && added) return open(added.id);
+    if (!current()) roundId = rounds[0] ? rounds[0].id : null;
+    if (first) return roundId ? open(roundId, asked) : render();
+    renderRounds();
+  } catch {
+    if (rounds.length === 0) sheet.replaceChildren(empty("Jinion isn't running", 'The directions show while Jinion runs. Start it again, then reload this page.'));
+  }
+}
+
+addEventListener('hashchange', render);
+addEventListener('keydown', (event) => {
+  const round = current();
+  if (!round || event.metaKey || event.ctrlKey || event.altKey) return;
+  const count = round.directions.length;
+  const number = Number(event.key);
+  if (event.key === 'ArrowRight') show((shown + 1) % count);
+  else if (event.key === 'ArrowLeft') show((shown - 1 + count) % count);
+  else if (number >= 1 && number <= count) show(number - 1);
+});
+load();
+setInterval(load, 2000);
+`;
+//# sourceMappingURL=viewer.js.map

package/dist/directions/viewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer.js","sourceRoot":"","sources":["../../src/directions/viewer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,OAAO;;;;;;SAMA,KAAK;;;iFAGmE,UAAU,CAAC,OAAO,CAAC;;UAE1F,MAAM;;QAER,CAAC;AACT,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8Db,CAAC;AAEF,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkLd,CAAC"}

package/dist/files/names.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The first name free in `folder`, as the Finder names a copy: with a word, `box copy.tsx`, then `box copy 2.tsx`;
+ * without one, `box.tsx` itself, then `box 2.tsx`.
+ */
+export declare function freeName(folder: string, name: string, word: string): Promise<string>;
+//# sourceMappingURL=names.d.ts.map

package/dist/files/names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../src/files/names.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,mBAexE"}

package/dist/files/names.js

@@ -0,0 +1,18 @@
+import { lstat } from 'node:fs/promises';
+import { extname, join } from 'node:path';
+/**
+ * The first name free in `folder`, as the Finder names a copy: with a word, `box copy.tsx`, then `box copy 2.tsx`;
+ * without one, `box.tsx` itself, then `box 2.tsx`.
+ */
+export async function freeName(folder, name, word) {
+    const extension = extname(name);
+    const stem = name.slice(0, name.length - extension.length);
+    for (let count = 1;; count++) {
+        const suffix = [word, count > 1 ? String(count) : ''].filter(Boolean).join(' ');
+        const candidate = suffix ? `${stem} ${suffix}${extension}` : name;
+        const taken = await lstat(join(folder, candidate)).then(() => true, () => false);
+        if (!taken)
+            return candidate;
+    }
+}
+//# sourceMappingURL=names.js.map

package/dist/files/names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../../src/files/names.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAc,EAAE,IAAY,EAAE,IAAY;IACvE,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAE3D,KAAK,IAAI,KAAK,GAAG,CAAC,GAAI,KAAK,EAAE,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChF,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,MAAM,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAElE,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CACrD,GAAG,EAAE,CAAC,IAAI,EACV,GAAG,EAAE,CAAC,KAAK,CACZ,CAAC;QAEF,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/dist/files/operations.d.ts

@@ -0,0 +1,54 @@
+import type { FileCreated, FilesCopied, FilesMoved, FilesRestored, Trashed } from './types.js';
+/** Why an operation was refused, for the API to tell as its own error. */
+export declare class FileProblem extends Error {
+    readonly kind: 'missing' | 'taken' | 'invalid';
+    readonly path?: string | undefined;
+    constructor(kind: 'missing' | 'taken' | 'invalid', message: string, path?: string | undefined);
+}
+/**
+ * What can change which files a folder holds: each keeps to the folder, by real paths, so neither `..` nor a link
+ * leads out of it, and a name already taken is refused unless `replace` says to move what holds it to the Trash.
+ */
+export declare class FolderFiles {
+    private readonly root;
+    private constructor();
+    static of(folder: string): Promise<FolderFiles>;
+    /** A file, empty or with `content`, or a folder; the folders it is in are made as needed. */
+    create(path: string, { folder, content, replace }: {
+        folder?: boolean;
+        content?: Buffer;
+        replace?: boolean;
+    }): Promise<FileCreated>;
+    /** Gives a file or folder another name where it is. */
+    rename(path: string, name: string, replace?: boolean): Promise<FilesMoved>;
+    /**
+     * Moves files and folders into a folder of the session's, each keeping its name; with `keepBoth`, one whose name is
+     * taken there takes the next free one, as the Finder's Keep Both names it, `box 2.tsx`.
+     */
+    move(paths: string[], into: string, replace?: boolean, keepBoth?: boolean): Promise<FilesMoved>;
+    /**
+     * Copies files and folders into a folder of the session's: ones of the folder by their paths in it, others, as files
+     * dropped from the Finder, by their whole paths. Copied into the folder it is in, a copy takes a name of its own, as
+     * one whose name is taken does with `keepBoth`.
+     */
+    copy(paths: string[], into: string, replace?: boolean, keepBoth?: boolean): Promise<FilesCopied>;
+    /** Moves files and folders to the Trash. */
+    delete(paths: string[]): Promise<{
+        path: string;
+        trash: string;
+    }[]>;
+    /** Puts back what `delete` or a replace sent to the Trash, at the path it had. */
+    restore(items: Trashed[], replace?: boolean): Promise<FilesRestored>;
+    /** A folder of the session's by its path there, `''` for the folder itself, as a whole path. */
+    folderAt(path: string): Promise<string>;
+    private relocate;
+    private notInto;
+    /** What holds `target`, to the Trash when `replace` says so. */
+    private clear;
+    private existing;
+    private outside;
+    /** Where something new goes: under the deepest folder of its path that is there, which has to be in the folder. */
+    private target;
+    private named;
+}
+//# sourceMappingURL=operations.d.ts.map

package/dist/files/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/files/operations.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAS,OAAO,EAAE,MAAM,YAAY,CAAC;AAEtG,0EAA0E;AAC1E,qBAAa,WAAY,SAAQ,KAAK;IAElC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS;IAE9C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM;IAHxB,YACW,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,EAC9C,OAAO,EAAE,MAAM,EACN,IAAI,CAAC,EAAE,MAAM,YAAA,EAGvB;CACF;AAED;;;GAGG;AACH,qBAAa,WAAW;IACF,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAzC,OAAO,eAA8C;IAErD,OAAa,EAAE,CAAC,MAAM,EAAE,MAAM,wBAE7B;IAED,6FAA6F;IACvF,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAc,EAAE,OAAO,EAAE,OAAe,EAAE,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAUxJ;IAED,uDAAuD;IACjD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,UAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAQ7E;IAED;;;OAGG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,UAAQ,EAAE,QAAQ,UAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAQhG;IAED;;;;OAIG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,UAAQ,EAAE,QAAQ,UAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,CAkBjG;IAED,4CAA4C;IACtC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE;;;SAO3B;IAED,kFAAkF;IAC5E,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,OAAO,UAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,CAcvE;IAED,gGAAgG;IAC1F,QAAQ,CAAC,IAAI,EAAE,MAAM,mBAO1B;YAEa,QAAQ;IAiBtB,OAAO,CAAC,OAAO;IAIf,gEAAgE;YAClD,KAAK;YAQL,QAAQ;YAUR,OAAO;IAMrB,mHAAmH;YACrG,MAAM;IAcpB,OAAO,CAAC,KAAK;CAGd"}