@chipschat/opencode 1.0.7 → 1.0.10

package/README.md

@@ -21,7 +21,7 @@ server (`opencode serve`, 2.0).
 A bridge that joins with a code asks for all of these. One that joined from Chips's gallery does
 what its card grants: a link carries what the person chose on it, not what the bridge asks for.
 
-Apache-2.0. Not published: a local repository until Chips's SDK is.
+Apache-2.0, published on npm as `@chipschat/opencode`.
 
 ## What Chips shows
 
@@ -144,22 +144,22 @@ gets Restart once you turn it on on its page.
 
 ## From Chips's gallery
 
-The card's line is `chips connect opencode '<link>'` (Chips ADR 0218). It downloads this bridge as the npm package
+The card's line is `CHIPS_JOIN_LINK='<link>' chips connect opencode` (Chips ADR 0218). It downloads this bridge as the npm package
 `@chipschat/opencode`, the newest 1.x, checks it against the registry's checksum, and runs it on the Node
 that Chips carries, so the machine needs no Node or npm of its own. The bridge checks OpenCode,
 joins, and keeps itself running from login. `chips disconnect opencode` stops it. On another computer,
-`curl -fsSL https://chipschat.ai/install | sh -s -- connect opencode '<link>'` installs Chips there
+`curl -fsSL https://chipschat.ai/install | CHIPS_JOIN_LINK='<link>' sh -s -- connect opencode` installs Chips there
 first. The steps below run the bridge from this checkout instead, to work on it.
 
 ## Run it
 
 1. Install OpenCode (opencode.ai), and `npm install` once in this repository.
 
-2. Join Chips once, with a link from Chips's gallery (Add an agent → OpenCode), whose card gives
+2. Join Chips once, with a link from Chips's gallery (Agents → Connect a harness → OpenCode), whose card gives
    this line with the link in it:
 
    ```
-   cd ~/Work/Chips/chips-opencode && CHIPS_JOIN_LINK='<link>' npm run keep
+   cd chips-opencode && CHIPS_JOIN_LINK='<link>' npm run keep
    ```
 
    The bridge runs OpenCode's server itself (`opencode serve` on `127.0.0.1`, 4096 when it is
@@ -213,7 +213,9 @@ the key it kept. The scratch Chips, the link and the run come from Chips's `tool
 ## Release
 
 `npm run release` builds `dist/main.js`, one file with the SDK and everything else bundled in, and
-`dist/THIRD-PARTY-NOTICES.md` beside it; runs the tests; and packs `chipschat-opencode-<version>.tgz`. `npm publish`
-publishes it. A version's major is the Chips protocol it speaks, and Chips's card names that major
-(Chips ADR 0218): a fix is a minor or a patch, and reaches every card of its major the day it is
-published.
+`dist/THIRD-PARTY-NOTICES.md` beside it; runs the tests; and packs `chipschat-opencode-<version>.tgz`. To publish,
+change `version` in package.json (`npm version <x> --no-git-tag-version`), commit, and push to main:
+`.github/workflows/publish.yml` runs the tests and publishes that version from GitHub with npm's
+trusted publishing, and skips a version npm already has. A version's major is the Chips protocol it
+speaks, and Chips's card names that major (Chips ADR 0218): a fix is a minor or a patch, and reaches
+every card of its major the day it is published.

package/dist/THIRD-PARTY-NOTICES.md

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

package/dist/main.js

@@ -8,7 +8,7 @@ var __export = (target, all) => {
 };
 
 // src/main.ts
-import { existsSync as existsSync7, mkdirSync as mkdirSync5, readFileSync as readFileSync8, writeFileSync as writeFileSync5 } from "node:fs";
+import { existsSync as existsSync7, mkdirSync as mkdirSync5, readFileSync as readFileSync9, writeFileSync as writeFileSync5 } from "node:fs";
 import { homedir as homedir7 } from "node:os";
 import { dirname as dirname5, join as join10, resolve as resolve4 } from "node:path";
 
@@ -19943,8 +19943,9 @@ var policyRule = external_exports.object({
     external: external_exports.boolean().optional(),
     irreversible: external_exports.boolean().optional(),
     money_usd_over: external_exports.number().nonnegative().optional(),
-    risk: external_exports.array(riskClass).max(8).optional()
-  }).optional().describe("Extra conditions on the action's flags."),
+    risk: external_exports.array(riskClass).max(8).optional(),
+    starts_with: external_exports.array(external_exports.string().min(1).max(400)).min(1).max(8).optional().describe("For an action that carries a command (ADR 0239): the words a part of it starts with. A command goes ahead on such rules only when every part starts with one that allows it.")
+  }).optional().describe("Extra conditions on the action's flags, and for a command, how its parts start."),
   decision: external_exports.enum(["allow", "ask", "deny"]).describe("What to do when the rule matches."),
   approvers: external_exports.array(approverRef).max(16).optional().describe("Who may answer, when the decision is `ask`."),
   reason: external_exports.string().max(400).optional().describe("Shown to the harness, and recorded in the audit log."),
@@ -20463,9 +20464,17 @@ var roomIdle = external_exports.object({
 var roomNote = external_exports.object({
   members: external_exports.array(roomMember).max(500).describe("The room's people, then its agents, each by name, anybody removed left out."),
   notes: external_exports.record(external_exports.string().max(120), external_exports.string().max(64e3)).describe("The note for each who takes the turn (`for`), by their id: who is here, with handles, and that only those @-mentioned act. A harness puts it at the top of the turn."),
+  rules: external_exports.record(external_exports.string().max(120), external_exports.string().max(4e3)).optional().describe("How the space works, for each who takes the turn, by their id: the words its note ends with (ADR 0250), that everyone here reads what it writes and, beside other agents, what an @ does and when to answer NO_REPLY. They stay the same while the space's agents do, so a harness whose session keeps its earlier turns may say them once, and the note without them after."),
   working: external_exports.array(roomWork).max(500).optional().describe("The room's agents with a turn going as Chips sends this one (ADR 0104), the takers' own included. A turn nothing has been heard from for ten minutes is not counted."),
   idle: external_exports.array(roomIdle).max(500).optional().describe("The room's other agents that have had a turn here: how long since the last one ended (ADR 0104).")
 });
+function noteWithoutRules(room, taker) {
+  const note = room?.notes[taker];
+  const rules = room?.rules?.[taker];
+  if (note === void 0 || rules === void 0 || !note.endsWith(rules))
+    return note;
+  return note.slice(0, note.length - rules.length).trimEnd();
+}
 var MONTHS = [
   "January",
   "February",
@@ -20485,8 +20494,8 @@ var MONTHS = [
 var CONTEXT_CEILING = { lines: 200, chars: 32e3 };
 var CONTEXT_HEADING = "Said in this space since you last spoke:";
 var contextBudget = external_exports.object({
-  lines: external_exports.int().nonnegative().optional().describe("The most lines to be handed, 20 when absent. Chips hands over 200 at most, and none when this is 0."),
-  chars: external_exports.int().nonnegative().optional().describe("The most characters those lines may run to, as `Name: words` one per line, 4,000 when absent. Chips hands over 32,000 at most.")
+  lines: external_exports.int().nonnegative().optional().describe("The most lines to be handed, 40 when absent. Chips hands over 200 at most, and none when this is 0."),
+  chars: external_exports.int().nonnegative().optional().describe("The most characters those lines may run to, as `Name: words` one per line, 16,000 when absent. Chips hands over 32,000 at most.")
 }).describe("How much of the room a harness is handed with a message for it (ADR 0088). Its own to say: a budget promises nothing to anybody else.");
 var contextLine = external_exports.object({
   seq: external_exports.int().positive().describe("Where in the log it happened."),
@@ -20698,12 +20707,14 @@ var contextAnswer = {
     message: external_exports.string().min(1).max(300).optional().describe("What went wrong, for the person.")
   }).optional().describe("An edit not made. The copy beside it is the file as it is now.")
 };
+var readNote = external_exports.string().min(1).max(300).describe("When the agent reads these, in the harness's words: `Hermes reads these when a conversation starts.` Absent: at the start of every turn.");
 function uniqueNames(files) {
   return new Set(files.map((file3) => file3.name)).size === files.length;
 }
 var agentContextPut = external_exports.object({
   files: external_exports.array(contextFile).max(CONTEXT_FILES_SHOWN).refine(uniqueNames, { message: "Each file is named once." }).describe("The agent's files, in the order its page shows them: eight at most."),
   not_shown: external_exports.array(notShownFile).max(CONTEXT_NOT_SHOWN_MAX).optional(),
+  read_note: readNote.optional(),
   ...contextAnswer
 }).describe("`PUT /v1/agents/:id/context`: a harness's copy of one of its agents' files.");
 var harnessContextPut = external_exports.object({
@@ -20736,6 +20747,7 @@ var agentContextView = external_exports.object({
   harness_id: id("harness"),
   files: external_exports.array(contextFile),
   not_shown: external_exports.array(notShownFile),
+  read_note: readNote.optional(),
   read_at: isoTimestamp.describe("When the harness last sent its copy."),
   away: external_exports.boolean().describe("No socket of the harness hears edits now: read, but not saved.")
 }).describe("`GET /v1/agents/:id/context`, for the harness's owner.");
@@ -20863,7 +20875,7 @@ var messageNew = defineEvent({
   summary: "Someone said something, with any attachments as signed URLs the harness can fetch.",
   requiresRun: false,
   payload: deliveredMessage.extend({
-    context: roomContext.optional().describe("What was said in the room since this harness last spoke there, or since it joined when it has not, up to this message and without it (ADR 0088). From when the turn that said its last words began, so what was said while it worked is here, and its own words are not (ADR 0105). Worked out from the log, so a replay hands over the same lines. As many as the budget the harness gave in its `hello`: 20 lines and 4,000 characters when it gave none, and none when it asked for 0. When older lines were left out, the taker's room note says so."),
+    context: roomContext.optional().describe("What was said in the room since this harness last spoke there, or since it joined when it has not, up to this message and without it (ADR 0088). From when the turn that said its last words began, so what was said while it worked is here, and its own words are not (ADR 0105). Worked out from the log, so a replay hands over the same lines. As many as the budget the harness gave in its `hello`: 40 lines and 16,000 characters when it gave none, and none when it asked for 0. When older lines were left out, the taker's room note says so."),
     room: roomNote.optional().describe("Who is in the room, with the handle that reaches each, and a note for each who takes the turn saying so and what an @ does (ADR 0092). A harness puts `notes[<taker>]` at the top of that turn. Absent on a message in no room."),
     exchange: deliveredExchange.optional().describe("How the agents' talk in the room stands, once it is worth a word (ADR 0097): from eight messages between agents since a person last acted or an agent last made something new. A harness puts `note` at the top of the turn, as Chips's, ahead of the room's note. Absent below that, and worked out from the log, so a replay hands over the same facts."),
     handed: external_exports.literal(true).optional().describe("Chips held this message when it was said and hands it over now a person has acted (ADR 0097): the newest of an agent's held messages, once; or, with `lead`, hands it to the room's lead. Its seq and id are the hand-over's, its `message_id` the message's own."),
@@ -20913,6 +20925,7 @@ var approvalResolved = defineEvent({
     approval_id: id("approval"),
     decision: external_exports.enum(["approved", "edited", "denied", "expired"]).describe("`expired` means nobody answered and the fallback applied."),
     scope: external_exports.enum(["once", "session", "always"]).default("once").describe("How far the answer reaches. `always` becomes a policy rule."),
+    everywhere: external_exports.boolean().optional().describe("With `always`: the rule is the harness's in every space, not only this one (ADR 0239). An owner or an admin only."),
     updated_input: external_exports.unknown().optional().describe("The edited action input, when the decision is `edited`."),
     reason: external_exports.string().max(4e3).optional().describe("Why. The harness gets to read this."),
     resolved_by: external_exports.string().min(1).max(120).describe("The participant who answered, or `system` on expiry \u2014 a harness when it settles its own ask, answered in its own tools. Filled in by Chips from the credential that sent it; a value the sender writes is replaced."),
@@ -21177,6 +21190,10 @@ function namesInWords(names) {
   return `${names.slice(0, -1).join(", ")} and ${names[names.length - 1]}`;
 }
 function renderProjectNote(facts, options) {
+  return `${renderProjectFacts(facts)}
+${renderProjectAsks(facts, options)}`;
+}
+function renderProjectFacts(facts) {
   const files = `${facts.files} file${facts.files === 1 ? "" : "s"}`;
   const lines2 = [
     `The space's project is a git repository. Your copy is ${facts.folder} (${files}), ${facts.trouble === void 0 ? "brought up to date just now" : "not brought up to date"}.`
@@ -21194,9 +21211,9 @@ function renderProjectNote(facts, options) {
   for (const key of facts.keys) {
     lines2.push(`${key.path} holds what looks like ${key.what}, so your last change wasn't sent: take it out and read it from outside the project.`);
   }
-  return [...lines2, ...asks(facts, options)].join("\n");
+  return lines2.join("\n");
 }
-function asks(facts, options) {
+function renderProjectAsks(facts, options) {
   const lines2 = [
     "Work on the project in that folder and leave git to Chips: when your turn ends, what you changed is committed under your name and sent to everyone here. Keep scratch work outside it.",
     // Sent with the answer too, a project's file became a room file of its own, with versions of
@@ -21217,7 +21234,7 @@ function asks(facts, options) {
   if (facts.pages === true) {
     lines2.push("A page opens in Chips as one document: name every file it needs in its tags and imports (<link>, <script src>, <img src>, import), since it can't fetch files while it runs.");
   }
-  return lines2;
+  return lines2.join("\n");
 }
 
 // node_modules/@chipschat/protocol/dist/src/events/harness-to-chips.js
@@ -21869,7 +21886,7 @@ var membershipRemoved = defineEvent({
   payload: external_exports.object({
     participant_id: external_exports.string().min(1).max(120).describe("Who left."),
     removed_by: external_exports.string().min(1).max(120).optional().describe("Who removed them, if not themselves."),
-    reason: external_exports.enum([...RELEASE_REASONS, "person_removed"]).optional().describe("For an agent (ADR 0087): why it left, as `agent.released` says. For a person, `person_removed`: they were removed from the workspace (ADR 0160). Written by Chips; absent, a person took them out or they left."),
+    reason: external_exports.enum([...RELEASE_REASONS, "person_removed", "person_left"]).optional().describe("For an agent (ADR 0087): why it left, as `agent.released` says. For a person, `person_removed`: they were removed from the workspace (ADR 0160); `person_left`: they deleted their account and left it (ADR 0243). Written by Chips; absent, a person took them out or they left the room."),
     moved_to: id("space").optional().describe("For an agent moved away: the room it went to, so this room can say so.")
   })
 });
@@ -22178,14 +22195,14 @@ var personRemoved = defineEvent({
   type: "person.removed",
   direction: "workspace",
   sender: "chips",
-  summary: "A person was removed from the workspace: signed out everywhere, out of every room, and the harnesses they owned handed to whoever removed them. What they said stays, under their name.",
+  summary: "A person was removed from the workspace, or deleted their account: signed out everywhere, out of every room, and the harnesses they owned handed on. What they said stays, under their name.",
   requiresRun: false,
   payload: external_exports.object({
     participant_id: id("person").describe("Who was removed."),
     display_name: external_exports.string().min(1).max(120).describe("What they were called when they were removed, so the audit needs no lookup."),
-    removed_by: id("person").describe("The owner or admin who removed them."),
+    removed_by: id("person").describe("The owner or admin who removed them, or they themselves when they deleted their account (ADR 0243)."),
     spaces: external_exports.array(id("space")).max(1e3).optional().describe("The rooms they were taken out of, each with its own `membership.removed`."),
-    harnesses: external_exports.array(id("harness")).max(1e3).optional().describe("The harnesses they owned, handed to `removed_by` by `harness.transferred`.")
+    harnesses: external_exports.array(id("harness")).max(1e3).optional().describe("The harnesses they owned, each handed on by `harness.transferred`: to `removed_by`, or, for an account deleted, to an owner.")
   })
 });
 var joinWho = {
@@ -22401,6 +22418,89 @@ var EVENT_TYPES = EVENTS.map((event) => event.type);
 var byType = new Map(EVENTS.map((event) => [event.type, event]));
 var schemas = new Map(EVENTS.map((event) => [event.type, eventSchema(event)]));
 
+// node_modules/@chipschat/protocol/dist/src/names.js
+var LOOK_LIKE = {
+  A: "\u0410\u0391",
+  // Cyrillic А, Greek Α
+  B: "\u0412\u0392",
+  // Cyrillic В, Greek Β
+  C: "\u0421",
+  // Cyrillic С
+  E: "\u0415\u0395",
+  // Cyrillic Е, Greek Ε
+  H: "\u041D\u0397",
+  // Cyrillic Н, Greek Η
+  I: "\u0406\u04C0\u0399",
+  // Cyrillic І and Ӏ, Greek Ι
+  J: "\u0408",
+  // Cyrillic Ј
+  K: "\u041A\u039A",
+  // Cyrillic К, Greek Κ
+  M: "\u041C\u039C",
+  // Cyrillic М, Greek Μ
+  N: "\u039D",
+  // Greek Ν
+  O: "\u041E\u039F",
+  // Cyrillic О, Greek Ο
+  P: "\u0420\u03A1",
+  // Cyrillic Р, Greek Ρ
+  Q: "\u051A",
+  // Cyrillic Ԛ
+  S: "\u0405",
+  // Cyrillic Ѕ
+  T: "\u0422\u03A4",
+  // Cyrillic Т, Greek Τ
+  W: "\u051C",
+  // Cyrillic Ԝ
+  X: "\u0425\u03A7",
+  // Cyrillic Х, Greek Χ
+  Y: "\u0423\u04AE\u03A5",
+  // Cyrillic У and Ү, Greek Υ
+  Z: "\u0396",
+  // Greek Ζ
+  a: "\u0430\u03B1",
+  // Cyrillic а, Greek α
+  c: "\u0441",
+  // Cyrillic с
+  d: "\u0501",
+  // Cyrillic ԁ
+  e: "\u0435",
+  // Cyrillic е
+  h: "\u04BB",
+  // Cyrillic һ
+  i: "\u0456\u03B9\u0131",
+  // Cyrillic і, Greek ι, Latin dotless ı
+  j: "\u0458",
+  // Cyrillic ј
+  k: "\u03BA",
+  // Greek κ
+  l: "\u04CF",
+  // Cyrillic ӏ
+  o: "\u043E\u03BF",
+  // Cyrillic о, Greek ο
+  p: "\u0440\u03C1",
+  // Cyrillic р, Greek ρ
+  q: "\u051B",
+  // Cyrillic ԛ
+  s: "\u0455",
+  // Cyrillic ѕ
+  u: "\u03C5",
+  // Greek υ
+  v: "\u03BD",
+  // Greek ν
+  w: "\u051D",
+  // Cyrillic ԝ
+  x: "\u0445\u03C7",
+  // Cyrillic х, Greek χ
+  y: "\u0443\u04AF"
+  // Cyrillic у and ү
+};
+var LATIN_OF = new Map(Object.entries(LOOK_LIKE).flatMap(([latin, others]) => [...others].map((other) => [other, latin])));
+var HIDDEN = "\\p{Cc}\\p{Cf}\\u034f\\u115f\\u1160\\u3164\\uffa0\\u2800";
+var UNSEEN = new RegExp(`[${HIDDEN}\\ufe00-\\ufe0f\\u{e0100}-\\u{e01ef}]`, "gu");
+var HIDDEN_ONE = new RegExp(`[${HIDDEN}]`, "u");
+var ALPHABETS = [new RegExp("\\p{Script=Latin}", "u"), new RegExp("\\p{Script=Cyrillic}", "u"), new RegExp("\\p{Script=Greek}", "u")];
+
 // node_modules/@chipschat/protocol/dist/src/first-names.js
 var AGENT_FIRST_NAMES = [
   "Abel Aldo Amir Amos Anders Ansel Anton Ari Arlo Arne Aron Arvid Asher Avi Axel Aziz",
@@ -22448,7 +22548,7 @@ var clientHelloFrame = external_exports.object({
   })).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); 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.")
+  context: contextBudget.optional().describe("How much of a room a harness is handed with each message for it (ADR 0088): 40 lines and 16,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({
   frame: external_exports.literal("subscribe"),
@@ -25010,8 +25110,19 @@ async function redeem(url2, secret, options, send, machine) {
     throw await refused(answered);
   return await answered.json();
 }
+function reaching(send, url2) {
+  return async (input2, init) => {
+    try {
+      return await send(input2, init);
+    } catch (error62) {
+      if (error62 instanceof Error && error62.name === "AbortError")
+        throw error62;
+      throw new JoinError("unreachable", `Can't reach Chips at ${url2} from this computer. It has to be on the same network as Chips, on its tailnet, or Chips has to be at an address this computer can reach.`);
+    }
+  };
+}
 function askOrRedeem(server2, options) {
-  const send = options.fetch ?? fetch;
+  const send = reaching(options.fetch ?? fetch, server2.url);
   const machine = options.machine ?? hostname3();
   return server2.secret === void 0 ? ask(server2.url, options, send, machine) : redeem(server2.url, server2.secret, options, send, machine);
 }
@@ -25177,14 +25288,31 @@ async function sendAnswer(answer, options) {
 }
 
 // node_modules/@chipschat/harness/dist/prompt.js
+function takerOf(message, options) {
+  return options.taker ?? (message.for?.length === 1 ? message.for[0] : void 0);
+}
+function othersBeside(message, taker) {
+  return (message.room?.members ?? []).some((member) => member.kind === "agent" && member.participant_id !== taker);
+}
+function rulesFor(message, options = {}) {
+  const taker = takerOf(message, options);
+  const { project } = options;
+  const rules = message.room?.rules ?? {};
+  return [
+    taker === void 0 ? void 0 : rules[taker],
+    project === void 0 ? void 0 : renderProjectAsks(project, { othersInRoom: othersBeside(message, taker) }),
+    options.sendsFiles === true ? sendingFiles({ project: project !== void 0 }) : void 0
+  ].filter((part) => part !== void 0 && part !== "").join("\n\n");
+}
 function promptFor(message, options = {}) {
-  const taker = options.taker ?? (message.for?.length === 1 ? message.for[0] : void 0);
+  const taker = takerOf(message, options);
+  const held = options.rulesHeld === true;
   const notes = message.room?.notes ?? {};
-  const note = taker === void 0 ? void 0 : notes[taker];
+  const note = taker === void 0 ? void 0 : held ? noteWithoutRules(message.room, taker) : notes[taker];
   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 ? sendingFiles({ project: options.project !== void 0 }) : void 0;
+  const sending = options.sendsFiles === true && !held ? sendingFiles({ project: options.project !== void 0 }) : void 0;
   const replying = renderReplyingTo(message.replying_to, {
     sender: {
       id: message.from.participant_id,
@@ -25196,8 +25324,7 @@ function promptFor(message, options = {}) {
     at: message.ts,
     zone: options.zone
   });
-  const others = (message.room?.members ?? []).some((member) => member.kind === "agent" && member.participant_id !== taker);
-  const project = options.project === void 0 ? void 0 : renderProjectNote(options.project, { othersInRoom: others });
+  const project = options.project === void 0 ? void 0 : held ? renderProjectFacts(options.project) : renderProjectNote(options.project, { othersInRoom: othersBeside(message, taker) });
   return [
     message.exchange?.note,
     note,
@@ -25209,6 +25336,24 @@ function promptFor(message, options = {}) {
   ].filter((part) => part !== void 0 && part !== "").join("\n\n");
 }
 
+// node_modules/@chipschat/harness/dist/rules.js
+var SessionRules = class {
+  held = /* @__PURE__ */ new Map();
+  /** Whether `session` holds these rules: told them word for word, or there are none to hold. */
+  holds(session, rules) {
+    return rules === "" || this.held.get(session) === rules;
+  }
+  /** That `session` was told these rules: its turn that said them was given to it. */
+  told(session, rules) {
+    if (rules !== "")
+      this.held.set(session, rules);
+  }
+  /** That `session` no longer holds what it was told: it compacted, or it is gone. */
+  forget(session) {
+    this.held.delete(session);
+  }
+};
+
 // node_modules/@chipschat/harness/dist/service.js
 import { execFileSync as execFileSync2 } from "node:child_process";
 import { accessSync, chmodSync as chmodSync2, constants, existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync3, rmSync as rmSync2, writeFileSync as writeFileSync2 } from "node:fs";
@@ -25384,7 +25529,10 @@ function nodeOnPath(env = process.env) {
 }
 var pause = (ms) => Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
 var LOAD_TRIES = 40;
-var runOf = (options) => options.run ?? ((command) => void execFileSync2(command[0], command.slice(1), { stdio: "ignore" }));
+var runOf = (options) => options.run ?? ((command) => execFileSync2(command[0], command.slice(1), {
+  encoding: "utf8",
+  stdio: ["ignore", "pipe", "ignore"]
+}));
 var ours = (path) => !existsSync3(path) || readFileSync3(path, "utf8").includes(MARK);
 function runOne(command, run2, retryMs) {
   const tries = command[0] === "launchctl" && command[1] === "bootstrap" ? LOAD_TRIES : 1;
@@ -25407,6 +25555,24 @@ function runAll(commands, options) {
     runOne(command, run2, options.retryMs ?? 250);
 }
 var uidOf = (options) => options.uid ?? process.getuid?.() ?? 0;
+function lingers(options) {
+  const run2 = runOf(options);
+  const uid = String(uidOf(options));
+  try {
+    const on = run2(["loginctl", "show-user", uid, "--property=Linger", "--value"]);
+    if (typeof on === "string" && on.trim() === "yes")
+      return true;
+  } catch {
+  }
+  try {
+    run2(["loginctl", "enable-linger", uid]);
+    return true;
+  } catch {
+    return false;
+  }
+}
+var sayOf = (options) => options.say ?? ((line) => void process.stderr.write(`${line}
+`));
 function keepRunning(spec, options = {}) {
   if (machineOf(options.machine).env["CHIPS_KEEP"] === "off")
     return { state: "off" };
@@ -25421,6 +25587,9 @@ function keepRunning(spec, options = {}) {
   writeFileSync2(file3.path, file3.contents, { mode: 384 });
   chmodSync2(file3.path, 384);
   runAll(startCommands(file3.kind, spec.label, file3.path, uidOf(options)), options);
+  if (file3.kind === "systemd" && !lingers(options)) {
+    sayOf(options)("It stops when you log out. To keep it running on a machine nobody logs in to, run this once: sudo loginctl enable-linger $USER");
+  }
   return { state: "kept", path: file3.path, logFile: file3.logFile };
 }
 function stopKeeping(label2, options = {}) {
@@ -26184,6 +26353,8 @@ var Bridge = class {
   rooms = /* @__PURE__ */ new Map();
   /** The turn going in each OpenCode session. */
   turns = /* @__PURE__ */ new Map();
+  /** The room's rules each session holds (Chips ADR 0250): said once, and again after it compacts. */
+  rules = new SessionRules();
   /**
    * What a session said while it was being given a turn's words, before the turn was known: OpenCode
    * may say it took them before it answers that it has them. Heard by the turn once it is.
@@ -26728,6 +26899,7 @@ var Bridge = class {
    * refused after all, in OpenCode's words.
    */
   compactionHeard(sessionId, event) {
+    if (event.type === "session.compaction.started") this.rules.forget(sessionId);
     const who = this.whoseSession(sessionId);
     const kept = who === void 0 ? void 0 : this.options.state.windows?.[who];
     if (who === void 0 || kept === void 0) return;
@@ -26885,16 +27057,18 @@ var Bridge = class {
     const speaker = speakerId === void 0 ? this.options.chips : this.options.chips.as(speakerId);
     const run2 = await speaker.runs.start({ spaceId, goal: goal ?? goalOf(message, agent.config.name) });
     const readied = await this.projectFor(room, speakerId ?? agent.agentId);
-    const text2 = promptFor(message, {
+    const asked = {
       ...speakerId === void 0 ? {} : { taker: speakerId },
       sayWho: saysWho !== true,
       sendsFiles: true,
       project: readied?.facts
-    });
+    };
+    const rules = rulesFor(message, asked);
+    const said = (session) => promptFor(message, { ...asked, rulesHeld: this.rules.holds(session, rules) });
     let sessionId;
     let given;
     try {
-      ({ sessionId, given } = await this.give(room, text2));
+      ({ sessionId, given } = await this.give(room, said, rules));
     } catch (error62) {
       await this.failed(run2, `${agent.config.name} couldn't reach OpenCode: ${messageOf(error62)}`, true);
       return;
@@ -26947,7 +27121,7 @@ var Bridge = class {
     await this.turnHeld(turn);
   }
   /** The words into the room's session: the one it had, or a new one when OpenCode no longer has it. */
-  async give({ id: id2, who, agent, spaceId }, text2) {
+  async give({ id: id2, who, agent, spaceId }, said, rules) {
     const { opencode: opencode2, state: state2, saveState } = this.options;
     let kept = state2.sessions[id2];
     if (kept === void 0 && this.copying.size > 0) {
@@ -26957,7 +27131,7 @@ var Bridge = class {
     if (kept !== void 0) {
       try {
         await this.modelled(kept, { who, agent });
-        return { sessionId: kept, given: await this.prompted(kept, text2) };
+        return { sessionId: kept, given: await this.prompted(kept, said(kept), rules) };
       } catch (error62) {
         if (!(error62 instanceof OpenCodeError && error62.tag === "SessionNotFoundError")) throw error62;
         this.log(`${agent.config.name}'s session for ${spaceId} is gone from OpenCode: a new one`);
@@ -26973,7 +27147,7 @@ var Bridge = class {
     });
     state2.sessions[id2] = made;
     saveState(state2);
-    return { sessionId: made, given: await this.prompted(made, text2) };
+    return { sessionId: made, given: await this.prompted(made, said(made), rules) };
   }
   /**
    * The folder an agent's new sessions work in, its own: made the first time, named after it, and
@@ -27043,12 +27217,18 @@ var Bridge = class {
     return known.find((each) => each.agentId === who)?.name ?? "agent";
   }
   /** A turn's first words into a session, what it says meanwhile held for the turn. */
-  async prompted(sessionId, text2) {
+  /**
+   * A turn's words given to a session, which is told the room's rules they carry as they are
+   * given, so a compaction heard during the turn forgets them (Chips ADR 0250).
+   */
+  async prompted(sessionId, text2, rules) {
     this.early.set(sessionId, []);
+    this.rules.told(sessionId, rules);
     try {
       return await this.options.opencode.prompt(sessionId, text2);
     } catch (error62) {
       this.early.delete(sessionId);
+      this.rules.forget(sessionId);
       throw error62;
     }
   }
@@ -27966,6 +28146,10 @@ async function checkOpenCode(config3, client) {
   }
 }
 
+// src/version.ts
+import { readFileSync as readFileSync8 } from "node:fs";
+var VERSION = JSON.parse(readFileSync8(new URL("../package.json", import.meta.url), "utf8")).version;
+
 // src/main.ts
 var home2 = (path) => path.startsWith("~/") ? join10(homedir7(), path.slice(2)) : path;
 var link = process.env["CHIPS_JOIN_LINK"] || void 0;
@@ -28033,17 +28217,17 @@ var joined = await join3({
   link,
   url: process.env["CHIPS_URL"],
   name: config2.name,
-  software: "chips-opencode 1.0.0",
+  software: `chips-opencode ${VERSION}`,
   wants: wantsFor(server !== void 0),
   onCode: (code) => log(`Allow this harness in Chips: ${code}`)
 }).catch(refused2);
 keepIfAsked(LABEL, joined.url, [config2.passwordEnv], log, () => server?.stop());
-var state = existsSync7(statePath) ? JSON.parse(readFileSync8(statePath, "utf8")) : { sessions: {} };
+var state = existsSync7(statePath) ? JSON.parse(readFileSync9(statePath, "utf8")) : { sessions: {} };
 var bridge;
 var chips = await connect({
   url: joined.url,
   token: joined.token,
-  client: { name: "chips-opencode", version: "1.0.0" },
+  client: { name: "chips-opencode", version: VERSION },
   store: fileStore(join10(folder, "chips-state.json")),
   // A person's Restart (Chips ADR 0094), heard only where the bridge runs OpenCode's server: one a
   // person runs themselves isn't the bridge's to restart, so this connection doesn't say it hears them.

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "@chipschat/opencode",
-  "version": "1.0.7",
+  "version": "1.0.10",
   "description": "OpenCode as a Chips harness, on its V2 server (opencode serve): each OpenCode agent a Chips agent, each room an OpenCode session.",
   "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/arjungupta99/chips-opencode.git"
+  },
   "type": "module",
   "engines": {
     "node": ">=22.19.0"