@chipschat/hermes 1.0.0 → 1.0.1

package/dist/THIRD-PARTY-NOTICES.md

@@ -1,6 +1,6 @@
 # Third-party notices
 
-`dist/main.js` in @chipschat/hermes 1.0.0 carries these packages, bundled in. Each one's
+`dist/main.js` in @chipschat/hermes 1.0.1 carries these packages, bundled in. Each one's
 licence follows.
 
 ## @chipschat/harness 0.0.0 (Apache-2.0)

package/dist/main.js

@@ -20231,6 +20231,27 @@ var projectToken = external_exports.object({
   expires_at: isoTimestamp,
   path: external_exports.string().describe("The project's path on this server, which the device puts its own address in front of.")
 });
+var projectFolderOpenAnswer = external_exports.object({
+  macs: external_exports.int().nonnegative().describe("How many of the person's Macs were asked.")
+});
+var projectRun = external_exports.object({
+  state: external_exports.enum(["never", "starting", "running", "ended", "failed", "stopped", "opened"]).describe("Never run on that Mac; starting (setup, or waiting for it to answer); running; ended by itself; failed; stopped by the person; or opened, for pages that need no starting."),
+  command: external_exports.string().max(1100).optional().describe("What ran: `setup`, a newline, then `run`, or `open` and the file; the bar compares it with the recipe's."),
+  since: isoTimestamp.optional(),
+  ended: isoTimestamp.optional(),
+  code: external_exports.int().optional().describe("How it ended, as its shell said."),
+  opened: external_exports.string().max(600).optional().describe("What it opened, once it answered."),
+  lines: external_exports.array(external_exports.string().max(400)).max(20).optional().describe("Its last lines, when it ended."),
+  why: external_exports.string().max(400).optional().describe("Why the Mac didn't run it when it was last asked, in its words: no run file, or a different one.")
+});
+var heldRun = projectRun.extend({
+  mac: external_exports.string().min(1).max(120).describe("The name of the Mac it runs on."),
+  said_at: isoTimestamp
+});
+var projectRunAnswer = external_exports.object({
+  run: heldRun.optional(),
+  macs: external_exports.int().nonnegative()
+});
 var commitId = external_exports.string().regex(/^[0-9a-f]{40}(?:[0-9a-f]{24})?$/).describe("A commit, by its full git object id.");
 var PROJECT_CHANGED_FILES = 200;
 var projectChangedFile = external_exports.object({
@@ -20261,8 +20282,9 @@ function isSecretsFile(path) {
 }
 var SECRET_SHAPES = [
   { what: "a Chips token", source: "chips_(?:at|inv|j|pt)_[A-Za-z0-9_-]{20,}" },
-  { what: "an Anthropic key", source: "sk-ant-[A-Za-z0-9_-]{20,}" },
-  { what: "an OpenAI key", source: "sk-(?:proj-|svcacct-|admin-)?[A-Za-z0-9_-]{40,}" },
+  // `sk-` begins a word, so a link's words ("…/elon-musk-terafab-project-…") are never a key.
+  { what: "an Anthropic key", source: "\\bsk-ant-[A-Za-z0-9_-]{20,}" },
+  { what: "an OpenAI key", source: "\\bsk-(?:proj-|svcacct-|admin-)?[A-Za-z0-9_-]{40,}" },
   { what: "an AWS access key", source: "\\b(?:AKIA|ASIA)[0-9A-Z]{16}\\b" },
   {
     what: "a GitHub token",
@@ -20332,6 +20354,7 @@ function asks(facts, options) {
       "When your file and another's use different names for the same thing, the one that reached the project first keeps its names, and the other changes its names to match."
     );
   }
+  lines2.push("When what you make is to be read (pages, PDFs, pictures), keep a start page at .chips/index.html that links to the documents worth seeing (its links start ../), with the documents themselves at the top or in folders of their own, and bring it up to date whenever you add, rename or replace one. Chips opens it in the app, and its links open there too. One document needs no start page.", `When what you make has to run on the person's Mac (a server, a script, an app), keep .chips/run.json so Run in Chips can start it from the project's folder: {"run": "the one shell command that starts it", "opens": "http://localhost:<port>, to open once it answers", "setup": "a command run first when it changes, like npm install"}. Start an app by its own program rather than with open, so Stop can close it. Leave out what it doesn't need, and check it works in your copy before you say it does.`);
   if (facts.markdown)
     lines2.push("In Markdown, put each sentence on a line of its own.");
   if (facts.pages === true) {
@@ -21562,7 +21585,7 @@ var clientHelloFrame = external_exports.object({
     autonomy: autonomyLevel.optional().describe("The level the harness believes it has.")
   })).max(64).optional().describe("Not read by Chips: a connection is its token's, and the server's `hello` names the token's harness and its agents (ADR 0087). Absent for a person's client."),
   since: external_exports.int().nonnegative().optional().describe("Not read by Chips: a stream resumes from `subscribe`'s `since`."),
-  accepts: external_exports.array(external_exports.string().min(1).max(40)).max(32).optional().describe("Server frames beyond the base set this client understands, by the names in `SERVER_EXTENSIONS`. A name the server does not know is ignored rather than refused, so a client may name a frame a newer server sends and still be answered by an older one (ADR 0211, Phase 3). A client that says `events` is sent its replay in pages rather than one frame per event; one that says `presence` is sent an agent's state as it changes (ADR 0083); a harness's socket that says `restart` is sent `restart` when a person asks it to restart (ADR 0094); an owner's or admin's that says `join` is sent each join request as it changes (ADR 0122); a harness's that says `context` is sent `context.edit` when a person changes one of its context files (ADR 0134); a harness's that says `models` is sent `model.change` when a person changes an agent's model or effort (ADR 0140); a harness's that says `heartbeats` is sent `heartbeat.change` when a person switches an agent's heartbeat or changes how often it beats (ADR 0143); a harness's that says `context_windows` is sent `context_window.compact` and `context_window.change` when a person asks an agent to compact now or changes the limit it compacts itself at (ADR 0146); one that says nothing is sent what it was always sent, since an unknown frame is dropped in silence."),
+  accepts: external_exports.array(external_exports.string().min(1).max(40)).max(32).optional().describe("Server frames beyond the base set this client understands, by the names in `SERVER_EXTENSIONS`. A name the server does not know is ignored rather than refused, so a client may name a frame a newer server sends and still be answered by an older one (ADR 0211, Phase 3). A client that says `events` is sent its replay in pages rather than one frame per event; one that says `presence` is sent an agent's state as it changes (ADR 0083); a harness's socket that says `restart` is sent `restart` when a person asks it to restart (ADR 0094); an owner's or admin's that says `join` is sent each join request as it changes (ADR 0122); a harness's that says `context` is sent `context.edit` when a person changes one of its context files (ADR 0134); a harness's that says `models` is sent `model.change` when a person changes an agent's model or effort (ADR 0140); a harness's that says `heartbeats` is sent `heartbeat.change` when a person switches an agent's heartbeat or changes how often it beats (ADR 0143); a harness's that says `context_windows` is sent `context_window.compact` and `context_window.change` when a person asks an agent to compact now or changes the limit it compacts itself at (ADR 0146); a person's that says `folders` is sent `folder.open` when they ask, from another of their devices, for a room's folder to be opened in Finder (ADR 0225), and `folder.run` when they ask for its project to be run or stopped there (ADR 0226); a person's that says `folder_runs` is sent `folder.run_state` when their Mac says how a run of theirs stands (ADR 0226); one that says nothing is sent what it was always sent, since an unknown frame is dropped in silence."),
   context: contextBudget.optional().describe("How much of a room a harness is handed with each message for it (ADR 0088): 20 lines and 4,000 characters when absent, 200 and 32,000 at most. For this connection. A person's client is handed none.")
 }).describe("The first frame a client sends.");
 var subscribeFrame = external_exports.object({
@@ -21623,6 +21646,26 @@ var restartFrame = external_exports.object({
   asked_by: id("person").describe("The person who asked."),
   asked_at: isoTimestamp.describe("When they asked.")
 }).describe("A person asks the harness to restart (ADR 0094). Sent to a harness's socket that said `restart` in its `hello`, now or never: it is not in the log, so a reconnect never hears it again. What runs is the harness's own restart.");
+var folderOpenFrame = external_exports.object({
+  frame: external_exports.literal("folder.open"),
+  space_id: id("space").describe("The room whose folder, or page, to open."),
+  what: external_exports.enum(["folder", "page"]).optional().describe("`page`: open the room's start page, or its one document, in Chips for Mac (ADR 0227). Left out, the folder in Finder."),
+  asked_from: external_exports.string().min(1).max(120).describe("The name of the device that asked: `iPhone`."),
+  asked_at: isoTimestamp.describe("When they asked.")
+}).describe("A person asks their own Mac to open a room's folder in Finder (ADR 0225), or its page in Chips for Mac (ADR 0227), from another of their devices. Sent to that person's sockets that said `folders` in their `hello`, now or never: it is not in the log. The Mac finds the folder and the page itself: nothing here is a path.");
+var folderRunFrame = external_exports.object({
+  frame: external_exports.literal("folder.run"),
+  space_id: id("space").describe("The room whose project to run, or stop."),
+  op: external_exports.enum(["run", "stop"]),
+  command: external_exports.string().min(1).max(1100).optional().describe("For `run`, what the asking device showed would run: the Mac runs nothing else, and says so when its folder's run file says something different."),
+  asked_from: external_exports.string().min(1).max(120).describe("The name of the device that asked: `iPhone`."),
+  asked_at: isoTimestamp.describe("When they asked.")
+}).describe("A person asks their own Mac to run a room's project as its run file says, or to stop it (ADR 0226), from another of their devices. Sent to that person's sockets that said `folders` in their `hello`, now or never: it is not in the log. Nothing here is a command: the Mac reads it from the room's folder.");
+var folderRunStateFrame = external_exports.object({
+  frame: external_exports.literal("folder.run_state"),
+  space_id: id("space"),
+  run: heldRun
+}).describe("How a person's run of a room's project on their Mac stands (ADR 0226), as that Mac said it. Sent to that person's sockets that said `folder_runs` in their `hello`, never to anyone else's, now or never: `GET /v1/spaces/:id/project/run` reads it again.");
 var joinFrame = external_exports.object({
   frame: external_exports.literal("join"),
   request: joinRequestView
@@ -21665,6 +21708,9 @@ var serverFrame = external_exports.discriminatedUnion("frame", [
   presenceFrame,
   restartFrame,
   joinFrame,
+  folderOpenFrame,
+  folderRunFrame,
+  folderRunStateFrame,
   contextEditFrame,
   modelChangeFrame,
   heartbeatChangeFrame,
@@ -21948,6 +21994,7 @@ import { existsSync } from "node:fs";
 import { mkdir, readFile, rename, stat, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 var READ_UP_TO = 4 * 1024 * 1024;
+var MARKED_LINES = 14;
 var TRIES = 4;
 var MARKS = /^(<<<<<<<|>>>>>>>) /m;
 var REJECTED = /\[rejected\]|fetch first|non-fast-forward/;
@@ -21986,6 +22033,27 @@ function pushedInWords(pushed) {
       return `not sent: ${pushed.why}`;
   }
 }
+var stopped = (words4) => `${words4.trim().replace(/[.\s]+$/, "")}.`;
+function heldNote(pushed, name2) {
+  switch (pushed.state) {
+    case "sent":
+    case "nothing":
+      return void 0;
+    case "clash": {
+      const whose = pushed.with.length === 0 ? "another change" : `${namesInWords(pushed.with)}'s change`;
+      return `(Not in the room's project yet: ${namesInWords(pushed.files)} clashed with ${whose}. ${name2} is asked to settle it next turn.)`;
+    }
+    case "keys": {
+      const [first] = pushed.keys;
+      const held = pushed.keys.length === 1 && first !== void 0 ? `${first.path} looks like it holds ${first.what.replace(/, by its name$/, "")}` : `${namesInWords(pushed.keys.map((key) => key.path))} look like they hold keys`;
+      return `(Not in the room's project: ${held}, so nothing was sent.)`;
+    }
+    case "refused":
+      return `(Not in the room's project: it was turned back: ${stopped(pushed.why)})`;
+    case "failed":
+      return `(Not in the room's project: it couldn't be sent: ${stopped(pushed.why)})`;
+  }
+}
 async function checkGit(git2 = "git", path = process.env["PATH"] ?? "/usr/bin:/bin") {
   const [major, minor] = versionIn(PROJECT_GIT_VERSION) ?? [0, 0];
   return new Promise((resolve5) => {
@@ -22005,7 +22073,7 @@ var Project = class {
   remote;
   constructor(options) {
     this.options = options;
-    this.copy = join(options.folder, "room");
+    this.copy = options.person === true ? options.folder : join(options.folder, "room");
     this.remote = `${options.url.replace(/\/$/, "").replace(/^ws/, "http")}${projectPath(options.spaceId)}`;
   }
   /** Before a turn: the copy made or brought up to date, and what the turn is to be told of it. */
@@ -22059,6 +22127,121 @@ var Project = class {
     }
     return { state: "failed", why: "others kept sending first." };
   }
+  /**
+   * A person's folder made, or brought up to the room's `main` while nothing in it is theirs: no
+   * file changed or added, nothing waiting to be sent, no clash (ADR 0224). Once something is
+   * theirs, nothing in the folder changes; what others changed since is told instead.
+   */
+  async look() {
+    await this.ready();
+    const fetched = await this.git(["fetch", "--quiet", "origin"]);
+    const trouble = fetched.ok ? void 0 : remoteWords(fetched.err);
+    const remote = await this.head("refs/remotes/origin/main");
+    await this.settledAsTheirs(remote);
+    const brought = await this.bringUntouched(remote);
+    return { ...await this.standing(remote), ...brought, trouble };
+  }
+  /** The folder moved on to the room's `main` while nothing in it is theirs: what came in, whose. */
+  async bringUntouched(remote) {
+    const mine = await this.head("HEAD");
+    const none = { came: [], cameBy: [] };
+    if (remote === "" || mine === remote || !await this.untouched(mine, remote))
+      return none;
+    const moved = mine === "" ? await this.git(["checkout", "--quiet", "-B", PROJECT_BRANCH, remote]) : await this.git(["merge", "--quiet", "--ff-only", remote]);
+    if (!moved.ok)
+      return none;
+    const from = mine === "" ? await this.emptyTree() : mine;
+    return {
+      came: lines((await this.git(["diff", "--name-only", from, remote])).out),
+      cameBy: await this.authors(mine === "" ? remote : `${mine}..${remote}`)
+    };
+  }
+  /**
+   * A clash the person settled by taking the room's side whole: nothing of theirs is left to send,
+   * so the folder goes back to the room's `main` and is kept up to date again. Every tracked file
+   * is already the room's, and a file git doesn't track is never touched.
+   */
+  async settledAsTheirs(remote) {
+    if (remote === "" || !existsSync(join(this.copy, ".git", "MERGE_HEAD")))
+      return;
+    if ((await this.marked()).length > 0)
+      return;
+    if (!(await this.git(["diff", "--quiet", remote])).ok)
+      return;
+    await this.git(["reset", "--quiet", "--hard", remote]);
+  }
+  /** Whether nothing in the folder is the person's own: no change, no unsent commit, no clash. */
+  async untouched(mine, remote) {
+    if (existsSync(join(this.copy, ".git", "MERGE_HEAD")))
+      return false;
+    const status = await this.git(["status", "--porcelain", "--untracked-files=all"]);
+    if (!status.ok || status.out.trim() !== "")
+      return false;
+    if (mine === "")
+      return true;
+    return (await this.git(["merge-base", "--is-ancestor", mine, remote])).ok;
+  }
+  /** What the person changed, a clash, and what others changed that the folder hasn't. */
+  async standing(remote) {
+    const mine = await this.head("HEAD");
+    const base = await this.baseOf(mine, remote);
+    const counted = lines((await this.git(["diff", "--numstat", "--no-renames", "-z", base])).out.replace(/\0/g, "\n")).map((line) => {
+      const [added2 = "0", removed = "0", ...path] = line.split("	");
+      return { path: path.join("	"), added: Number(added2) || 0, removed: Number(removed) || 0 };
+    });
+    const added = lines((await this.git(["ls-files", "--others", "--exclude-standard", "-z"])).out.replace(/\0/g, "\n"));
+    const fresh = await Promise.all(added.map(async (path) => ({ path, added: await this.lineCount(path), removed: 0 })));
+    const changed = [...counted, ...fresh].filter((change) => change.path !== "").sort((a, b) => a.path.localeCompare(b.path));
+    const clashes = await this.marked();
+    const clashedWith = await this.mergingWith();
+    const first = clashes[0];
+    const marked = first === void 0 ? void 0 : await this.markedLines(first);
+    const since = remote === "" || remote === base ? [] : lines((await this.git(["diff", "--name-only", base, remote])).out);
+    const by = since.length === 0 ? [] : await this.authors(mine === "" ? remote : `${base}..${remote}`);
+    return { changed, clashes, clashedWith, marked, since, by };
+  }
+  /**
+   * What the person's changes are measured from: where the folder and the room's `main` parted.
+   * In a clash the room's side is already in the folder, so it is `main` itself: what differs from
+   * it is what Send would change.
+   */
+  async baseOf(mine, remote) {
+    if (mine === "")
+      return this.emptyTree();
+    if (remote === "")
+      return mine;
+    if (existsSync(join(this.copy, ".git", "MERGE_HEAD")))
+      return remote;
+    return (await this.git(["merge-base", mine, remote])).out.trim() || mine;
+  }
+  /** How many lines a file the person added has: the lines it adds. None for a picture. */
+  async lineCount(path) {
+    try {
+      const at = join(this.copy, path);
+      if ((await stat(at)).size > READ_UP_TO)
+        return 0;
+      const words4 = await readFile(at, "utf8");
+      if (words4.includes("\0"))
+        return 0;
+      return words4 === "" ? 0 : words4.split("\n").length - (words4.endsWith("\n") ? 1 : 0);
+    } catch {
+      return 0;
+    }
+  }
+  /** The first clash in a file, from the line before its first mark to the line after its last. */
+  async markedLines(path) {
+    try {
+      const all = (await readFile(join(this.copy, path), "utf8")).split("\n");
+      const start = all.findIndex((line) => line.startsWith("<<<<<<< "));
+      const end2 = all.findIndex((line, at) => at > start && line.startsWith(">>>>>>> "));
+      if (start < 0 || end2 < 0)
+        return void 0;
+      const shown2 = all.slice(Math.max(0, start - 1), end2 + 2);
+      return shown2.length <= MARKED_LINES ? shown2.join("\n") : [...shown2.slice(0, MARKED_LINES - 1), "\u2026"].join("\n");
+    } catch {
+      return void 0;
+    }
+  }
   /**
    * One try at sending: sent, nothing to send, or turned back; or, when somebody sent first, the
    * agent's commits replayed on top of theirs, for the next try, unless they clashed.
@@ -22111,6 +22294,10 @@ ${sent.err}`;
       const pointed = (await this.git(["remote", "get-url", "origin"])).out.trim();
       if (pointed === this.remote)
         return false;
+      if (this.options.person === true) {
+        await this.git(["remote", "set-url", "origin", this.remote]);
+        return false;
+      }
       const was = /\/v1\/spaces\/([^/]+)\/project\.git$/.exec(pointed)?.[1] ?? "before";
       await rename(this.copy, join(this.options.folder, `room-${was}`));
     }
@@ -22264,9 +22451,12 @@ ${sent.err}`;
   }
   git(args) {
     const { options } = this;
+    const person = options.person === true;
+    const email3 = `${options.agentId}@${person ? "people" : "agents"}.chips.invalid`;
     const pairs = [
       ["http.extraHeader", `Authorization: Bearer ${options.token}`],
-      ["http.extraHeader", `${PROJECT_ACTOR_HEADER}: ${options.agentId}`],
+      // A person's project token says who they are; an agent's harness token needs the agent.
+      ...person ? [] : [["http.extraHeader", `${PROJECT_ACTOR_HEADER}: ${options.agentId}`]],
       ["core.hooksPath", "/dev/null"],
       ["commit.gpgSign", "false"],
       ["merge.conflictStyle", "merge"],
@@ -22279,9 +22469,9 @@ ${sent.err}`;
       GIT_CONFIG_GLOBAL: "/dev/null",
       GIT_TERMINAL_PROMPT: "0",
       GIT_AUTHOR_NAME: options.name,
-      GIT_AUTHOR_EMAIL: `${options.agentId}@agents.chips.invalid`,
+      GIT_AUTHOR_EMAIL: email3,
       GIT_COMMITTER_NAME: options.name,
-      GIT_COMMITTER_EMAIL: `${options.agentId}@agents.chips.invalid`,
+      GIT_COMMITTER_EMAIL: email3,
       GIT_EDITOR: "true",
       GIT_CONFIG_COUNT: String(pairs.length)
     };
@@ -23990,7 +24180,11 @@ import { readFile as readFile3, realpath, stat as stat2 } from "node:fs/promises
 import { homedir as homedir2 } from "node:os";
 import { basename as basename2, isAbsolute, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
-var SENDING_FILES = "A file reaches this room 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.";
+function sendingFiles(options = {}) {
+  const which = options.project === true ? "A file that isn't in the room's project" : "A file";
+  return `${which} reaches this room 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.`;
+}
+var SENDING_FILES = sendingFiles();
 var MOST_FILES = 20;
 var MOST_FILE_BYTES = 100 * 1024 * 1024;
 function filesNamedIn(answer) {
@@ -24098,7 +24292,7 @@ function promptFor(message, options = {}) {
   const who = options.sayWho === false ? "" : `${withRole(message.from.display_name, message.from)}: `;
   const files = (message.attachments ?? []).map(renderAttachment);
   const words4 = [`${who}${message.text}`, ...files].join("\n");
-  const sending = options.sendsFiles === true ? SENDING_FILES : void 0;
+  const sending = options.sendsFiles === true ? sendingFiles({ project: options.project !== void 0 }) : void 0;
   const replying = renderReplyingTo(message.replying_to, {
     sender: { id: message.from.participant_id, name: message.from.display_name },
     taker,
@@ -24576,9 +24770,13 @@ async function failureOf(answer) {
 
 // src/bridge.ts
 var WANTS = ["agents", "new_agents", "forks"];
-var FILES_HERE = `${SENDING_FILES} Hermes's note that this API server sends only pictures, and shows a MEDIA: tag on the runs endpoint as text, does not hold for these runs: they come from Chips, whose bridge takes each MEDIA: line out of your answer and attaches that file to your message, whatever its type, up to 100 MB.`;
-function instructionsFor(folder2) {
-  return folder2 === void 0 ? FILES_HERE : `${FILES_HERE} Your own folder is ${folder2}: make and keep your files there, and run your commands from there.`;
+function filesHere(project = false) {
+  return `${sendingFiles({ project })} Hermes's note that this API server sends only pictures, and shows a MEDIA: tag on the runs endpoint as text, does not hold for these runs: they come from Chips, whose bridge takes each MEDIA: line out of your answer and attaches that file to your message, whatever its type, up to 100 MB.`;
+}
+var FILES_HERE = filesHere();
+function instructionsFor(folder2, project = false) {
+  const files = filesHere(project);
+  return folder2 === void 0 ? files : `${files} Your own folder is ${folder2}: make and keep your files there, and run your commands from there.`;
 }
 function freeFolder(root, name2, taken) {
   const slug = name2.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "agent";
@@ -24800,18 +24998,22 @@ var Bridge = class {
   }
   /**
    * What the turn changed in its copy, sent to the room's project before its words are posted: the
-   * commit it left `main` at, for the reply to carry (Chips ADR 0222), when it sent one.
+   * commit it left `main` at, for the reply to carry (Chips ADR 0222), when it sent one; else, when
+   * the change didn't go, the line the reply says so in (Chips AP-6).
    */
   async sendProject(turn, words4) {
-    if (turn.project === void 0) return void 0;
+    if (turn.project === void 0) return {};
     const { copy, name: name2 } = turn.project;
     try {
       const pushed = await copy.push({ words: words4 });
       this.log(`${name2}'s project: ${pushedInWords(pushed)}`);
-      return pushed.state === "sent" ? pushed.commit : void 0;
+      if (pushed.state === "sent") return { change: pushed.commit };
+      const note = heldNote(pushed, name2);
+      return note === void 0 ? {} : { note };
     } catch (error61) {
       this.log(`${name2}'s project couldn't be sent: ${messageOf(error61)}`);
-      return void 0;
+      const note = heldNote({ state: "failed", why: messageOf(error61) }, name2);
+      return note === void 0 ? {} : { note };
     }
   }
   /** Trouble while a profile's gateway doesn't answer, and fine once all do (ADR 0083). */
@@ -24979,7 +25181,7 @@ var Bridge = class {
   async once(turn, session, text, key) {
     const { agent } = turn;
     try {
-      turn.hermesRun = await agent.client.startRun({ text, sessionId: session, model: agent.config.model, key, instructions: instructionsFor(turn.folder) });
+      turn.hermesRun = await agent.client.startRun({ text, sessionId: session, model: agent.config.model, key, instructions: instructionsFor(turn.folder, turn.project !== void 0) });
     } catch (error61) {
       await this.failed(turn, `${agent.config.name} couldn't start in Hermes: ${messageOf(error61)}`, true);
       return void 0;
@@ -25142,8 +25344,8 @@ var Bridge = class {
 ${command}
 \`\`\`` } }
     });
-    const stopped = new Promise((resolve5) => turn.run.on("cancel", () => resolve5(void 0)));
-    const decision = await Promise.race([asked, stopped]);
+    const stopped2 = new Promise((resolve5) => turn.run.on("cancel", () => resolve5(void 0)));
+    const decision = await Promise.race([asked, stopped2]);
     const pending = turn.approvals.get(requestId ?? approvalId);
     if (decision === void 0 || pending === void 0 || pending.answered) return;
     pending.answered = true;
@@ -25186,10 +25388,11 @@ ${command}
     await this.counted(turn, last);
     const output2 = typeof last["output"] === "string" ? last["output"].trim() : "";
     const answer = output2 !== "" ? output2 : turn.reply.trim();
-    const change = await this.sendProject(turn, answer);
+    const { change, note } = await this.sendProject(turn, answer);
     const { folder: folder2 } = turn;
     const { chips: chips2 } = this.options;
-    const post = await sendAnswer(answer, {
+    const words4 = [answer, note ?? ""].filter((part) => part !== "").join("\n\n");
+    const post = await sendAnswer(words4, {
       folders: folder2 === void 0 ? [] : [folder2],
       upload: (input2) => chips2.upload(input2)
     });
@@ -25331,9 +25534,9 @@ var end = (line, code) => {
 };
 function stopIfAsked(label2) {
   if (!flags.includes("--stop")) return;
-  const stopped = stopKeeping(label2);
-  if (stopped.state === "stopped") end(`Stopped ${label2}, and removed ${stopped.path}.`, 0);
-  if (stopped.state === "theirs") end(`${stopped.path} wasn't written by this bridge: it was left as it is.`, 1);
+  const stopped2 = stopKeeping(label2);
+  if (stopped2.state === "stopped") end(`Stopped ${label2}, and removed ${stopped2.path}.`, 0);
+  if (stopped2.state === "theirs") end(`${stopped2.path} wasn't written by this bridge: it was left as it is.`, 1);
   end(`Nothing called ${label2} was kept running here.`, 0);
 }
 function keepIfAsked(label2, url2, names, log2, before = () => void 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chipschat/hermes",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Hermes Agent as a Chips harness, on its Runs API: each profile a Chips agent, each room a Hermes session.",
   "license": "Apache-2.0",
   "type": "module",