@jinion/core 0.3.0 → 0.5.0

package/dist/directions/directions.js

@@ -0,0 +1,120 @@
+import { randomBytes } from 'node:crypto';
+import { createServer } from 'node:http';
+import { basename } from 'node:path';
+import { DirectionsStore } from './store.js';
+import { viewerPage } from './viewer.js';
+const MAX_PICK_BYTES = 4 * 1024;
+/** The viewer as a Preview beside the thread shows it, which has no room for the rounds. */
+export const SIDEBAR_CLOSED = '#sidebar-closed';
+/**
+ * Jinion's own place to show directions, the same for every project and client: the rounds kept under the project's
+ * folder in `~/.jinion`, served to a viewer on 127.0.0.1 behind a token. Nothing listens before a round is shown.
+ */
+export class Directions {
+    cwd;
+    store;
+    token = randomBytes(16).toString('hex');
+    /** The conversation each round was shown in, while it is open; a pick on any other is only kept. */
+    listeners = new Map();
+    server;
+    port;
+    constructor(cwd) {
+        this.cwd = cwd;
+        this.store = new DirectionsStore(cwd);
+    }
+    async show(offered, onPick) {
+        const round = this.store.add(offered);
+        this.listeners.set(round.id, onPick);
+        const viewer = await this.address();
+        return {
+            round,
+            address: `${viewer}?round=${round.id}`,
+            /** Each direction's page alone, for the agent to look at. */
+            pages: round.directions.map((_, index) => `${viewer}rounds/${round.id}/${index + 1}`),
+            /** Each direction in the viewer without its sidebar, as a Preview shows the round. */
+            shown: round.directions.map((_, index) => `${viewer}?round=${round.id}&direction=${index + 1}${SIDEBAR_CLOSED}`),
+        };
+    }
+    /** The viewer, at the newest round. */
+    async address() {
+        this.port ??= this.listen();
+        return `http://127.0.0.1:${await this.port}/${this.token}/`;
+    }
+    pick(id, direction) {
+        const round = this.store.pick(id, direction);
+        if (!round)
+            return undefined;
+        const listener = this.listeners.get(id);
+        listener?.({ round, direction });
+        return { round, sent: listener !== undefined };
+    }
+    close() {
+        this.server?.close();
+        this.server = undefined;
+        this.port = undefined;
+    }
+    listen() {
+        const server = createServer((request, response) => this.receive(request, response));
+        this.server = server;
+        // The app quits whether or not a browser still holds a connection open.
+        server.unref();
+        return new Promise((resolve, reject) => {
+            server.once('error', reject);
+            server.listen(0, '127.0.0.1', () => resolve(server.address().port));
+        });
+    }
+    receive(request, response) {
+        const { pathname } = new URL(request.url ?? '/', 'http://127.0.0.1');
+        const [token, ...rest] = pathname.split('/').slice(1);
+        const path = rest.join('/');
+        response.setHeader('Cache-Control', 'no-store');
+        if (token !== this.token)
+            return void response.writeHead(404).end();
+        if (request.method === 'GET' && path === '')
+            return send(response, 'text/html', viewerPage(basename(this.cwd)));
+        if (request.method === 'GET' && path === 'rounds')
+            return send(response, 'application/json', JSON.stringify(this.store.list()));
+        const page = /^rounds\/([^/]+)\/(\d+)$/.exec(path);
+        if (request.method === 'GET' && page) {
+            const html = this.store.page(page[1], Number(page[2]) - 1);
+            if (html === undefined)
+                return void response.writeHead(404).end();
+            // A page of its own origin, so what the agent wrote can't reach the viewer, its token or the picks.
+            response.setHeader('Content-Security-Policy', 'sandbox allow-scripts allow-forms allow-popups');
+            return send(response, 'text/html', html);
+        }
+        const pick = /^rounds\/([^/]+)\/pick$/.exec(path);
+        if (request.method === 'POST' && pick)
+            return this.receivePick(request, response, pick[1]);
+        response.writeHead(404).end();
+    }
+    receivePick(request, response, id) {
+        const chunks = [];
+        let size = 0;
+        request.on('data', (chunk) => {
+            size += chunk.length;
+            if (size <= MAX_PICK_BYTES)
+                chunks.push(chunk);
+        });
+        request.on('end', () => {
+            const direction = size <= MAX_PICK_BYTES ? directionOf(Buffer.concat(chunks).toString('utf8')) : undefined;
+            const answer = direction === undefined ? undefined : this.pick(id, direction);
+            if (!answer)
+                return void response.writeHead(400).end();
+            send(response, 'application/json', JSON.stringify(answer));
+        });
+    }
+}
+function send(response, type, body) {
+    response.writeHead(200, { 'Content-Type': `${type}; charset=utf-8` }).end(body);
+}
+function directionOf(body) {
+    try {
+        const { direction } = JSON.parse(body);
+        return typeof direction === 'string' ? direction : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=directions.js.map

package/dist/directions/directions.js.map

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

package/dist/directions/store.d.ts

@@ -0,0 +1,34 @@
+export interface Direction {
+    name: string;
+    idea: string;
+}
+/** A round as the agent hands it over: each direction with its page. */
+export interface Offered {
+    title: string;
+    directions: (Direction & {
+        html: string;
+    })[];
+}
+export interface Round {
+    id: string;
+    title: string;
+    /** When it was shown, in milliseconds. */
+    at: number;
+    directions: Direction[];
+    picked?: string;
+}
+/** The project's rounds of directions, a folder each, out of the project and of git. */
+export declare class DirectionsStore {
+    private readonly cwd;
+    constructor(cwd: string);
+    get dir(): string;
+    add({ title, directions }: Offered): Round;
+    /** The newest first. */
+    list(): Round[];
+    get(id: string): Round | undefined;
+    /** The page of a round's direction, by its place in the round. */
+    page(id: string, index: number): string | undefined;
+    pick(id: string, name: string): Round | undefined;
+    private save;
+}
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/directions/store.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wEAAwE;AACxE,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,CAAC,SAAS,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wFAAwF;AACxF,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,GAAG;IAAhC,YAA6B,GAAG,EAAE,MAAM,EAAI;IAE5C,IAAI,GAAG,WAEN;IAED,GAAG,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,OAAO,GAAG,KAAK,CASzC;IAED,wBAAwB;IACxB,IAAI,IAAI,KAAK,EAAE,CAMd;IAED,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAMjC;IAED,kEAAkE;IAClE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,sBAK7B;IAED,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAShD;IAED,OAAO,CAAC,IAAI;CAGb"}

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"}