@chipschat/harness 0.0.0-stage → 1.0.0

package/dist/run.js

@@ -0,0 +1,295 @@
+/**
+ * One run, from the harness's side. `runs.start` returns one; everything it sends carries the
+ * run id, so the person sees a timeline, a receipt, and cards that belong to it. An approval
+ * or a question is a promise: send the ask, and the decision comes back when a person — or
+ * the policy engine, at once — has answered, however many reconnects happen in between.
+ */
+import { Emitter } from "./events.js";
+import { Lane } from "./lane.js";
+/** An ask's optional fields as the wire spells them, leaving out each one that was not given. */
+function givenFields(input) {
+    const fields = {
+        question: input.question,
+        effect: input.effect,
+        lasts: input.lasts,
+        preview: input.preview,
+        step_id: input.stepId,
+        sources: input.sources,
+        fallback: input.fallback,
+        approvers: input.approvers,
+        editable: input.editable,
+    };
+    return Object.fromEntries(Object.entries(fields).filter(([, value]) => value !== undefined));
+}
+const cost = (usd) => usd === undefined ? {} : { cost: { usd, estimated: true } };
+export class Run {
+    id;
+    spaceId;
+    wire;
+    laneId;
+    events = new Emitter();
+    held = false;
+    ended = false;
+    constructor(id, spaceId, wire, 
+    /** The lane this run is, when a lead routed it here (`chips.runs.accept`). */
+    laneId) {
+        this.id = id;
+        this.spaceId = spaceId;
+        this.wire = wire;
+        this.laneId = laneId;
+    }
+    /** A person paused the run and has not resumed it. */
+    get paused() {
+        return this.held;
+    }
+    /** A person stopped the run, or it completed or failed. Nothing more should be sent. */
+    get over() {
+        return this.ended;
+    }
+    on(name, handler) {
+        return this.events.on(name, handler);
+    }
+    /** What a person did to this run, from the connection. */
+    hear(event) {
+        switch (event["type"]) {
+            case "run.steer":
+                this.events.emit("steer", event);
+                return;
+            case "run.pause":
+                this.held = true;
+                this.events.emit("pause", event);
+                return;
+            case "run.resume":
+                this.held = false;
+                this.events.emit("resume", event);
+                return;
+            case "run.cancel":
+                this.ended = true;
+                this.held = false;
+                this.events.emit("cancel", event);
+                return;
+            case "message.new":
+                this.events.emit("message", event);
+                return;
+            default:
+                return;
+        }
+    }
+    /** Resolve once the run is not paused. A stopped run resolves too: check `over` after. */
+    async whenRunning() {
+        while (this.held && !this.ended) {
+            await new Promise((resolve) => setTimeout(resolve, 50));
+        }
+    }
+    status(input) {
+        const status = typeof input === "string" ? { verbPhrase: input } : input;
+        return this.wire.send("run.status", {
+            phase: status.phase ?? phaseOf(status.verbPhrase),
+            verb_phrase: status.verbPhrase,
+            ...(status.progress === undefined ? {} : { progress: status.progress }),
+            ...(status.estimateSeconds === undefined ? {} : { estimate_seconds: status.estimateSeconds }),
+        });
+    }
+    /** The steps still to come, replacing the ones not yet done. */
+    plan(steps, reason) {
+        return this.wire.send("run.plan", {
+            plan: steps.map((step) => ({ step_id: step.stepId, title: step.title })),
+            ...(reason === undefined ? {} : { reason }),
+        });
+    }
+    step(input) {
+        return this.wire.send("step.log", {
+            step_id: input.stepId ?? this.newStepId(),
+            status: input.status ?? "done",
+            ...(input.title === undefined ? {} : { title: input.title }),
+            ...(input.tool === undefined ? {} : { tool: input.tool }),
+            ...(input.kind === undefined ? {} : { kind: input.kind }),
+            ...(input.summary === undefined ? {} : { summary: input.summary }),
+            ...(input.sources === undefined ? {} : { sources: input.sources }),
+            ...(input.durationMs === undefined ? {} : { duration_ms: input.durationMs }),
+            ...(input.error === undefined ? {} : { error: input.error }),
+        });
+    }
+    /**
+     * A step around a piece of work: `started` now, `done` with how long it took when the work
+     * resolves, `failed` with why when it throws, and the error thrown on. Give `tool` (or a title
+     * like `web_search · LEGO trucks`) and the thinking bubble says what is going on while it works.
+     */
+    async track(step, work) {
+        const stepId = step.stepId ?? this.newStepId();
+        const begun = Date.now();
+        await this.step({ ...step, stepId, status: "started" });
+        try {
+            const value = await work();
+            await this.step({ ...step, stepId, status: "done", durationMs: Date.now() - begun });
+            return value;
+        }
+        catch (error) {
+            const why = error instanceof Error ? error.message : String(error);
+            await this.step({
+                ...step,
+                stepId,
+                status: "failed",
+                durationMs: Date.now() - begun,
+                error: (why === "" ? "It failed." : why).slice(0, 2000),
+            }).catch(() => undefined);
+            throw error;
+        }
+    }
+    newStepId() {
+        return `step-${this.wire.newId("event").slice(-8).toLowerCase()}`;
+    }
+    /**
+     * Ask, and wait for the answer. Resolves when a person decides — or at once, when the
+     * policy engine decides for them — and survives a reconnect, since the decision is an
+     * event the resumed subscription replays.
+     */
+    async approval(input) {
+        const approvalId = input.approvalId ?? this.wire.newId("approval");
+        const decided = this.wire.waitFor((event) => event["type"] === "approval.resolved" && event["approval_id"] === approvalId
+            ? event
+            : undefined);
+        await this.wire.send("approval.request", {
+            approval_id: approvalId,
+            action: input.action,
+            risk: input.risk,
+            expires_in: input.expiresIn ?? 3600,
+            ...givenFields(input),
+        });
+        const event = await decided;
+        return {
+            approvalId,
+            decision: event.decision,
+            allowed: event.decision === "approved" || event.decision === "edited",
+            scope: event.scope ?? "once",
+            input: event.decision === "edited" ? event.updated_input : input.action.input,
+            reason: event.reason,
+            by: event.resolved_by,
+            at: event.resolved_at,
+            event,
+        };
+    }
+    /**
+     * Route work to another harness, or to one of this harness's own spaces, as a lane of this
+     * run (M3.5). Resolves once Chips has acknowledged the task with where the lane is; the lane's
+     * `result` resolves when the specialist is done. A task Chips flattens — an unknown harness, a
+     * chain too deep, a loop — comes back as a lane whose `result` is `flattened`, so the lead
+     * can carry on without it.
+     */
+    async task(input) {
+        const taskId = input.taskId ?? this.wire.newId("lane");
+        const lane = new Lane(taskId, this.wire.lanes);
+        const ack = await this.wire.send("task", {
+            task_id: taskId,
+            ...(input.to === undefined ? {} : { to: input.to }),
+            ...(input.child === undefined ? {} : { to: input.child.label, child: input.child }),
+            goal: input.goal,
+            on_behalf_of: input.onBehalfOf,
+            ...(input.constraints === undefined ? {} : { constraints: input.constraints }),
+            ...(input.deadline === undefined ? {} : { deadline: input.deadline }),
+            ...(input.autonomy === undefined ? {} : { autonomy: input.autonomy }),
+            ...(input.origin === undefined ? {} : { origin: input.origin }),
+            link_to: input.linkTo ?? this.spaceId,
+            ...(input.home === undefined ? {} : { home: input.home }),
+            ...(input.label === undefined ? {} : { label: input.label }),
+        });
+        lane.opened(ack.lane);
+        return lane;
+    }
+    /** What happened after a yes: the card changes from approved to sent, or to failed. */
+    executed(approvalId, outcome, detail) {
+        return this.wire.send("approval.executed", {
+            approval_id: approvalId,
+            outcome,
+            ...(detail === undefined ? {} : { detail }),
+        });
+    }
+    /** One to four questions with options; resolves with the answers, or the default on a timeout. */
+    async question(input) {
+        const askId = input.askId ?? this.wire.newId("question");
+        const answered = this.wire.waitFor((event) => event["type"] === "question.answered" && event["ask_id"] === askId
+            ? event
+            : undefined);
+        await this.wire.send("question.ask", {
+            ask_id: askId,
+            questions: input.questions.map((question, index) => ({
+                question_id: question.questionId ?? `q${index + 1}`,
+                prompt: question.prompt,
+                options: question.options,
+                ...(question.multiSelect === undefined ? {} : { multi_select: question.multiSelect }),
+                ...(question.allowFreeText === undefined
+                    ? {}
+                    : { allow_free_text: question.allowFreeText }),
+                ...(question.defaultValue === undefined ? {} : { default_value: question.defaultValue }),
+            })),
+            ...(input.timeoutSeconds === undefined ? {} : { timeout_seconds: input.timeoutSeconds }),
+            ...(input.onNoAnswer === undefined ? {} : { on_no_answer: input.onNoAnswer }),
+        });
+        const event = await answered;
+        const answers = {};
+        for (const answer of event.answers) {
+            answers[answer.question_id] = { values: answer.values, freeText: answer.free_text };
+        }
+        return { askId, answers, timedOut: event.timed_out === true, by: event.answered_by, event };
+    }
+    context(input) {
+        return this.wire.send("context.usage", {
+            used_tokens: input.usedTokens,
+            limit_tokens: input.limitTokens,
+            model: input.model,
+            ...(input.compacted === undefined ? {} : { compacted: input.compacted }),
+        });
+    }
+    usage(input) {
+        return this.wire.send("usage", {
+            scope: input.scope ?? "run",
+            model: input.model,
+            ...(input.inputTokens === undefined ? {} : { input_tokens: input.inputTokens }),
+            ...(input.cacheReadTokens === undefined ? {} : { cache_read_tokens: input.cacheReadTokens }),
+            ...(input.cacheWriteTokens === undefined
+                ? {}
+                : { cache_write_tokens: input.cacheWriteTokens }),
+            ...(input.outputTokens === undefined ? {} : { output_tokens: input.outputTokens }),
+            ...cost(input.costUsd),
+        });
+    }
+    /**
+     * That this turn heard a message said in the room while it worked (ADR 0106): one that
+     * `message.overheard` named this run for in `working_turns`, handed to the turn at a step. The
+     * room shows its agent heard it while working. Say it once the turn has the words, never before.
+     */
+    heard(messageId) {
+        return this.wire.send("message.heard", { message_id: messageId });
+    }
+    checkpoint(label, next, compacted) {
+        return this.wire.send("checkpoint", {
+            label,
+            ...(next === undefined ? {} : { next }),
+            ...(compacted === undefined ? {} : { compacted }),
+        });
+    }
+    complete(input) {
+        this.ended = true;
+        return this.wire.send("run.completed", {
+            summary: input.summary,
+            ...(input.changed === undefined ? {} : { changed: input.changed }),
+            ...(input.followUps === undefined ? {} : { follow_ups: input.followUps }),
+            ...cost(input.costUsd),
+        });
+    }
+    fail(input) {
+        this.ended = true;
+        return this.wire.send("run.failed", {
+            error: input.error,
+            ...(input.leftUndone === undefined ? {} : { left_undone: input.leftUndone }),
+            ...(input.retryable === undefined ? {} : { retryable: input.retryable }),
+            ...cost(input.costUsd),
+        });
+    }
+}
+/** `Reading PO #4471…` → `reading`: a machine-ish label from the first word. */
+function phaseOf(verbPhrase) {
+    const word = verbPhrase.trim().split(/\s+/)[0] ?? "working";
+    return word.replace(/[^a-z0-9]/gi, "").toLowerCase() || "working";
+}
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

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

package/dist/sending.d.ts

@@ -0,0 +1,78 @@
+/**
+ * The files an answer sends to its room (ADR 0099). An agent names a file on a line of its own,
+ * `MEDIA:<path>`, a convention some harnesses' agents already keep; the bridge takes those lines
+ * out of the words and posts each file with them, so it reaches the people and agents in the room.
+ * A path alone reaches nobody: in the Tic Tac Toe runs of 17 October 2026 (finding TT-7) three
+ * harnesses' agents answered with a path on the Mac, a `127.0.0.1` link to a server they started,
+ * or a site they hosted, and one went looking through the Mac for a way in.
+ *
+ * Only a file inside one of the agent's own folders is sent: a line naming any other (`~/.ssh/…`,
+ * or a link out of the folder) is refused, and the post says so.
+ */
+import type { Uploaded, UploadInput } from "./files.js";
+/**
+ * How a file reaches a room, said with every turn of an agent whose bridge sends its files. A turn
+ * that works on the room's project is told that only a file outside it needs sending: told that a
+ * file "reaches this room only when you send it", agents sent the project's files too, each a room
+ * file with versions of its own, even after the project's note said not to (Phase 8, AP-3, AP-9).
+ */
+export declare function sendingFiles(options?: {
+    readonly project?: boolean | undefined;
+}): string;
+/** How a file reaches a room that has no project to work on. */
+export declare const SENDING_FILES: string;
+/** The most files one post carries (`message.post`'s `upload_ids`). */
+export declare const MOST_FILES = 20;
+/** The most bytes a file may have; Chips judges the size again by what the file is. */
+export declare const MOST_FILE_BYTES: number;
+/** An answer's words with its `MEDIA:` lines taken out, and what those lines named, in order. */
+export interface NamedFiles {
+    readonly words: string;
+    readonly named: readonly string[];
+}
+/** The `MEDIA:` lines of an answer, taken out of its words. A line that only mentions one stays. */
+export declare function filesNamedIn(answer: string): NamedFiles;
+/** What one `MEDIA:` line turned out to be. */
+export type Sendable = {
+    readonly kind: "file";
+    readonly filename: string;
+    readonly bytes: Uint8Array;
+}
+/** A web address, which goes back into the words rather than being fetched. */
+ | {
+    readonly kind: "link";
+    readonly url: string;
+} | {
+    readonly kind: "refused";
+    readonly name: string;
+    readonly why: string;
+};
+/**
+ * A file a line named, read if it is inside one of `folders`. A relative path starts in the first
+ * of them, and `~/` at the home of the user the bridge runs as.
+ */
+export declare function readSendable(reference: string, folders: readonly string[]): Promise<Sendable>;
+/** An answer as it is posted, its files sent. */
+export interface SentAnswer {
+    /** The words without their `MEDIA:` lines, then a link a line gave, and why a file did not go. */
+    readonly text: string;
+    /** For the post's `uploadIds`. */
+    readonly uploadIds: readonly string[];
+    /** The files sent, by name. */
+    readonly sent: readonly string[];
+    /** The run's summary: the post's text, or what it sent when it has no words. */
+    readonly summary: string;
+}
+export interface SendOptions {
+    /** The agent's own folders. A file outside them is not sent. */
+    readonly folders: readonly string[];
+    /** `chips.upload`. */
+    readonly upload: (input: UploadInput) => Promise<Uploaded>;
+}
+/**
+ * Take an answer's `MEDIA:` lines out of its words and send each file they name. Nothing is thrown
+ * for a file that cannot go: the post says why instead, so the room is never told of a file it
+ * did not get.
+ */
+export declare function sendAnswer(answer: string, options: SendOptions): Promise<SentAnswer>;
+//# sourceMappingURL=sending.d.ts.map

package/dist/sending.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sending.d.ts","sourceRoot":"","sources":["../src/sending.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE;IAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAAO,GAAG,MAAM,CAO7F;AAED,gEAAgE;AAChE,eAAO,MAAM,aAAa,QAAiB,CAAC;AAE5C,uEAAuE;AACvE,eAAO,MAAM,UAAU,KAAK,CAAC;AAE7B,uFAAuF;AACvF,eAAO,MAAM,eAAe,QAAoB,CAAC;AAEjD,iGAAiG;AACjG,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,oGAAoG;AACpG,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAevD;AAED,+CAA+C;AAC/C,MAAM,MAAM,QAAQ,GAChB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE;AAClF,+EAA+E;GAC7E;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAiC9E;;;GAGG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,OAAO,CAAC,QAAQ,CAAC,CAgBnB;AAED,iDAAiD;AACjD,MAAM,WAAW,UAAU;IACzB,kGAAkG;IAClG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,sBAAsB;IACtB,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC5D;AAsBD;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAgB1F"}

package/dist/sending.js

@@ -0,0 +1,149 @@
+/**
+ * The files an answer sends to its room (ADR 0099). An agent names a file on a line of its own,
+ * `MEDIA:<path>`, a convention some harnesses' agents already keep; the bridge takes those lines
+ * out of the words and posts each file with them, so it reaches the people and agents in the room.
+ * A path alone reaches nobody: in the Tic Tac Toe runs of 17 October 2026 (finding TT-7) three
+ * harnesses' agents answered with a path on the Mac, a `127.0.0.1` link to a server they started,
+ * or a site they hosted, and one went looking through the Mac for a way in.
+ *
+ * Only a file inside one of the agent's own folders is sent: a line naming any other (`~/.ssh/…`,
+ * or a link out of the folder) is refused, and the post says so.
+ */
+import { readFile, realpath, stat } from "node:fs/promises";
+import { homedir } from "node:os";
+import { basename, isAbsolute, resolve, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+/**
+ * How a file reaches a room, said with every turn of an agent whose bridge sends its files. A turn
+ * that works on the room's project is told that only a file outside it needs sending: told that a
+ * file "reaches this room only when you send it", agents sent the project's files too, each a room
+ * file with versions of its own, even after the project's note said not to (Phase 8, AP-3, AP-9).
+ */
+export function sendingFiles(options = {}) {
+    const which = options.project === true ? "A file that isn't in the space's project" : "A file";
+    return (`${which} reaches this space only when you send it: put MEDIA:<path> on a line of its own in ` +
+        "your answer, one line for each file, from your own folder. A path, or a link to this machine, " +
+        "reaches nobody: the people and agents here cannot open your folder.");
+}
+/** How a file reaches a room that has no project to work on. */
+export const SENDING_FILES = sendingFiles();
+/** The most files one post carries (`message.post`'s `upload_ids`). */
+export const MOST_FILES = 20;
+/** The most bytes a file may have; Chips judges the size again by what the file is. */
+export const MOST_FILE_BYTES = 100 * 1024 * 1024;
+/** The `MEDIA:` lines of an answer, taken out of its words. A line that only mentions one stays. */
+export function filesNamedIn(answer) {
+    const named = [];
+    const kept = answer.split("\n").filter((line) => {
+        const media = /^\s*MEDIA:\s*(\S.*?)\s*$/.exec(line);
+        if (media?.[1] === undefined)
+            return true;
+        if (!named.includes(media[1]))
+            named.push(media[1]);
+        return false;
+    });
+    return {
+        words: kept
+            .join("\n")
+            .replace(/\n{3,}/g, "\n\n")
+            .trim(),
+        named,
+    };
+}
+/** Whether `path` is `folder` or inside it, both as the disk resolves them. */
+function inside(path, folder) {
+    return path === folder || path.startsWith(folder.endsWith(sep) ? folder : folder + sep);
+}
+/** Where a line points on this disk, or what it is instead: a web address, or nothing a file has. */
+function pathOf(said) {
+    if (/^https?:\/\//i.test(said))
+        return { kind: "link", url: said };
+    if (/^file:/i.test(said)) {
+        try {
+            return fileURLToPath(said);
+        }
+        catch {
+            return { kind: "refused", name: said, why: "its address is not a file's" };
+        }
+    }
+    return said === "~" || said.startsWith("~/") ? homedir() + said.slice(1) : said;
+}
+/** Whether a file the disk resolved may go: inside a folder, a file, not empty, not too big. */
+async function refusalOf(real, folders) {
+    const roots = await Promise.all(folders.map((folder) => realpath(folder).catch(() => undefined)));
+    if (!roots.some((root) => root !== undefined && inside(real, root))) {
+        return "it is outside the agent's folder";
+    }
+    const info = await stat(real);
+    if (!info.isFile())
+        return "it is not a file";
+    if (info.size === 0)
+        return "it is empty";
+    if (info.size > MOST_FILE_BYTES)
+        return `it is larger than ${MOST_FILE_BYTES / 1024 / 1024} MB`;
+    return undefined;
+}
+/**
+ * A file a line named, read if it is inside one of `folders`. A relative path starts in the first
+ * of them, and `~/` at the home of the user the bridge runs as.
+ */
+export async function readSendable(reference, folders) {
+    const said = reference.trim().replace(/^<(.*)>$/, "$1");
+    const path = pathOf(said);
+    if (typeof path !== "string")
+        return path;
+    const name = basename(path) || said;
+    const first = folders[0];
+    if (first === undefined) {
+        return { kind: "refused", name, why: "this agent has no folder its files are sent from" };
+    }
+    const real = await realpath(isAbsolute(path) ? path : resolve(first, path)).catch(() => undefined);
+    if (real === undefined)
+        return { kind: "refused", name, why: "it is not there" };
+    const why = await refusalOf(real, folders);
+    if (why !== undefined)
+        return { kind: "refused", name, why };
+    return { kind: "file", filename: basename(real), bytes: new Uint8Array(await readFile(real)) };
+}
+/** One named file sent, or a note in its place: a link, or why it did not go. */
+async function sendOne(reference, options, room) {
+    const file = await readSendable(reference, options.folders);
+    if (file.kind === "link")
+        return { note: file.url };
+    if (file.kind === "refused")
+        return { note: `(${file.name} was not attached: ${file.why}.)` };
+    if (!room) {
+        return { note: `(${file.filename} was not attached: a message takes ${MOST_FILES} files.)` };
+    }
+    try {
+        return { sent: await options.upload({ bytes: file.bytes, filename: file.filename }) };
+    }
+    catch (error) {
+        const why = error instanceof Error ? error.message : String(error);
+        return { note: `(${file.filename} was not attached: Chips refused it: ${why})` };
+    }
+}
+/**
+ * Take an answer's `MEDIA:` lines out of its words and send each file they name. Nothing is thrown
+ * for a file that cannot go: the post says why instead, so the room is never told of a file it
+ * did not get.
+ */
+export async function sendAnswer(answer, options) {
+    const { words, named } = filesNamedIn(answer);
+    const uploadIds = [];
+    const sent = [];
+    const notes = [];
+    for (const reference of named) {
+        const one = await sendOne(reference, options, uploadIds.length < MOST_FILES);
+        if (one.sent !== undefined) {
+            uploadIds.push(one.sent.attachmentId);
+            sent.push(one.sent.filename);
+        }
+        if (one.note !== undefined)
+            notes.push(one.note);
+    }
+    const text = [words, ...notes].filter((part) => part !== "").join("\n\n");
+    const summary = text !== "" ? text : sent.length > 0 ? `Sent ${sent.join(", ")}.` : "";
+    return { text, uploadIds, sent, summary };
+}
+//# sourceMappingURL=sending.js.map

package/dist/sending.js.map

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