@chipschat/protocol 0.0.0-stage → 1.0.1

package/dist/src/exchange.js

@@ -0,0 +1,413 @@
+/**
+ * The referee (ADR 0097): Chips talks before it stops.
+ *
+ * Agents in a room hand work to each other by @. ADR 0081 held the fifth message agents sent each
+ * other without a person, which stopped three agents sharing out an alphabet before the first
+ * letter was written (the ASCII Art room, 2 October 2026). So Chips counts the talk between
+ * agents since the last reset — anything a person does in the room, or anything new an agent
+ * makes — and says what it sees. From `NUDGE_AT` the facts ride each agent's next turn; on a
+ * circle, or from `WARN_AT`, the way out rides with them and the people are told; only at
+ * `CEILING`, or when a person pauses them, are messages between agents held, and loudly. Those
+ * three are the defaults: a workspace sets its own stop and hold, either of them never, and
+ * whether circles count (`ExchangeLimits`, ADR 0187).
+ *
+ * The server that counts, the conformance fake that plays the server and the clients that draw
+ * the room read the same rules and the same words, so they live here.
+ */
+import { z } from "zod";
+import { agentId, isoTimestamp } from "./primitives.js";
+/** From this many messages between agents since the last reset, the facts ride their turns. */
+export const NUDGE_AT = 8;
+/** From this many, or on a circle, the note names the way out and the people are told. */
+export const WARN_AT = 16;
+/** After this many, messages between agents are held until a person acts. */
+export const CEILING = 48;
+export const DEFAULT_EXCHANGE_LIMITS = {
+    stop: WARN_AT,
+    hold: CEILING,
+    circles: true,
+};
+/** What a stop may be, and a hold, in messages: the event refuses anything else. */
+export const STOP_RANGE = { least: 4, most: 500 };
+export const HOLD_RANGE = { least: 10, most: 1000 };
+/** The stops and the holds You offers, beside Other and Never. */
+export const STOP_CHOICES = [8, 16, 32, 64];
+export const HOLD_CHOICES = [24, 48, 100, 200];
+/** From how many messages the facts ride the agents' turns: half the stop, or `NUDGE_AT`. */
+export function nudgeAt(limits) {
+    return limits.stop === null ? NUDGE_AT : Math.max(2, Math.round(limits.stop / 2));
+}
+const within = (n, range) => Number.isInteger(n) && n >= range.least && n <= range.most;
+/**
+ * Why these cannot be a workspace's limits, in the words a person reads, or nothing: each a whole
+ * number in its range, and the stop before the hold, or Chips would hold the agents before it
+ * told them to stop.
+ */
+export function limitsProblem(limits) {
+    if (limits.stop !== null && !within(limits.stop, STOP_RANGE)) {
+        return "Chips tells agents to stop after a whole number of messages, from 4 to 500.";
+    }
+    if (limits.hold !== null && !within(limits.hold, HOLD_RANGE)) {
+        return "Chips holds agents after a whole number of messages, from 10 to 1,000.";
+    }
+    if (limits.stop !== null && limits.hold !== null && limits.stop >= limits.hold) {
+        return "Chips would hold the agents before telling them to stop. Make the stop smaller than the hold.";
+    }
+    return undefined;
+}
+/** The limits an `exchange.limits_set` carries; what it leaves out is the default's. */
+export function exchangeLimitsOf(payload) {
+    const count = (name) => {
+        const value = payload[name];
+        if (value === null)
+            return null;
+        return typeof value === "number" ? value : DEFAULT_EXCHANGE_LIMITS[name];
+    };
+    const circles = payload["circles"];
+    return {
+        stop: count("stop"),
+        hold: count("hold"),
+        circles: typeof circles === "boolean" ? circles : DEFAULT_EXCHANGE_LIMITS.circles,
+    };
+}
+/**
+ * What a person does in a room that starts the count again, and hands over what was held:
+ * writing, answering a question, deciding or handing on an approval, adding or taking somebody
+ * out, steering or stopping a run, a thumb on what was said — and letting the agents carry on
+ * (`exchange.set` with `going`, which is asked of its state). Pausing them is not among them.
+ */
+export const PERSON_ACTS = new Set([
+    "message.post",
+    "question.answered",
+    "approval.resolved",
+    "approval.routed",
+    "membership.added",
+    "membership.removed",
+    "run.steer",
+    "run.cancel",
+    "run.pause",
+    "run.resume",
+    "feedback",
+]);
+/** Whether this event, by a person, starts the count again (`PERSON_ACTS`, or carrying on). */
+export function resetsTheCount(type, payload) {
+    return PERSON_ACTS.has(type) || (type === "exchange.set" && payload["state"] === "going");
+}
+/** What an agent makes that starts the count again, besides a file new to the room. */
+export const WORK_ACTS = new Set(["question.ask", "approval.request"]);
+export const exchangeStage = z
+    .enum(["quiet", "nudge", "warning", "held"])
+    .describe("`quiet` under the nudge; `nudge` from it (half the workspace's stop, or 8); `warning` on a circle or from the stop; `held` at the hold or while a person has paused the agents. The stop, the hold and whether circles count are the workspace's (ADR 0187): 16, 48 and yes unless an owner or an admin changed them.");
+export const exchangeReset = z
+    .object({
+    kind: z
+        .enum(["person", "work", "start"])
+        .describe("`person`: somebody did something in the room. `work`: an agent made something new — a file new to the room, a question to a person, an approval request. `start`: nothing since the room began."),
+    seq: z.int().nonnegative().describe("Where the count starts from, after this."),
+    at: isoTimestamp.optional().describe("When. Absent at the start."),
+    by: z
+        .string()
+        .min(1)
+        .max(120)
+        .optional()
+        .describe("Who: the person, or the agent that made it."),
+    made: z
+        .enum(["file", "question", "approval"])
+        .optional()
+        .describe("For `work`: what the agent made."),
+    file: z.string().min(1).max(255).optional().describe("For a file: its name."),
+})
+    .describe("The last reset of the count.");
+export const exchangeRepeat = z.object({
+    message_id: z.string().min(1).max(120),
+    by: z.string().min(1).max(120),
+    kind: z
+        .enum(["file", "words"])
+        .describe("`file`: it carried a file already in the room. `words`: its words are much the same as words its sender already sent since the reset."),
+    file: z.string().min(1).max(255).optional(),
+});
+export const exchangeFacts = z
+    .object({
+    count: z
+        .int()
+        .nonnegative()
+        .describe("Messages agents have sent agents in the room since the reset, this one included."),
+    since: exchangeReset,
+    minutes: z.int().nonnegative().describe("Since the reset."),
+    person_looking: z
+        .boolean()
+        .nullable()
+        .describe("Whether somebody has the room open: a person not behind it by a message older than a minute. `null` when Chips cannot say."),
+    person: z
+        .string()
+        .min(1)
+        .max(120)
+        .optional()
+        .describe("Who to tell what is done and what is blocked: the person who last acted here."),
+    repeats: z
+        .array(exchangeRepeat)
+        .max(CEILING)
+        .describe("Which of the messages repeat, newest last."),
+    circling: z
+        .boolean()
+        .describe("The same two or three agents taking turns with nothing new: two rounds with a repeat among them."),
+    also_for: z
+        .array(agentId)
+        .max(64)
+        .describe("Who else this message is for, besides whoever it is delivered to."),
+    stage: exchangeStage,
+    allowance: z
+        .int()
+        .positive()
+        .optional()
+        .describe("After how many messages between agents Chips holds them: the workspace's hold (ADR 0187). Absent when it holds them only on a pause."),
+    paused: z
+        .boolean()
+        .describe("A person paused the agents, or Chips did at the room's spend ceiling (ADR 0118), and nobody has acted since."),
+})
+    .describe("How the agents' talk in the room stands (ADR 0097).");
+/** The facts as a turn is handed them, with the words a harness puts at the top of the turn. */
+export const deliveredExchange = exchangeFacts.extend({
+    note: z.string().min(1).max(4000).describe("The facts in plain words, for the top of the turn."),
+});
+/**
+ * Where the talk is: held at the hold or on a pause, then a warning at the stop or on a circle,
+ * a nudge, or nothing. `circling` is a circle the workspace watches for (`circles`).
+ */
+export function stageOf(count, circling, paused, limits = DEFAULT_EXCHANGE_LIMITS) {
+    if (paused || (limits.hold !== null && count >= limits.hold))
+        return "held";
+    if (circling || (limits.stop !== null && count >= limits.stop))
+        return "warning";
+    return count >= nudgeAt(limits) ? "nudge" : "quiet";
+}
+/** Whether an agent's next message to an agent is held: after the hold, or on a pause. */
+export function holds(exchange) {
+    const hold = (exchange.limits ?? DEFAULT_EXCHANGE_LIMITS).hold;
+    return exchange.paused || (hold !== null && exchange.count >= hold);
+}
+/** Whether the last `p × rounds` speakers are the same `p` agents taking turns, in order. */
+function roundsOf(speakers, p, rounds) {
+    const tail = speakers.slice(-p * rounds);
+    if (tail.length < p * rounds)
+        return false;
+    const round = tail.slice(0, p);
+    if (new Set(round).size !== p)
+        return false;
+    return tail.every((speaker, index) => speaker === round[index % p]);
+}
+/**
+ * Whether the talk is going round: the same two or three agents taking turns (A B A B, A B C A B
+ * C) for two rounds, with a repeat among them. `repeated` says, for each speaker, whether that
+ * message repeated. Nothing new was made by them, or the count would have started again.
+ *
+ * Taking turns alone is not going round (ADR 0097's addendum of 17 October 2026). ADR 0097 also
+ * called three rounds with no repeat a circle, which told two agents working a problem through to
+ * stop at their sixth message, and three at their ninth, whatever they were saying.
+ */
+export function circleIn(speakers, repeated) {
+    return [2, 3].some((p) => roundsOf(speakers, p, 2) && repeated.slice(-2 * p).some(Boolean));
+}
+/** Fewer words than this are never a repeat: "Thanks!" twice is manners. */
+const MIN_WORDS = 6;
+/** How alike two messages' word trigrams must be to be the same words again. */
+const LIKENESS = 0.6;
+/** A message's words as a repeat compares them: lower case, no @names, links or punctuation. */
+export function wordsFor(text) {
+    return (text
+        .toLowerCase()
+        .replace(/https?:\/\/\S+/g, " ")
+        .replace(/@[\p{L}\p{N}_.-]+/gu, " ")
+        // "Bank's" is one word, so a lone letter is only ever a letter ("F to J").
+        .replace(/['’ʼ]/gu, "")
+        .replace(/[^\p{L}\p{N}\s]/gu, " ")
+        .split(/\s+/)
+        .filter((word) => word !== ""));
+}
+/**
+ * The particulars among a message's words: anything with a digit in it (a section, a batch, a
+ * commit, a total) and lone letters but "a" and "i" (a range of letters, a column). Work handed
+ * on in the same words each time differs in these, and only in these.
+ */
+function particularsOf(words) {
+    return [
+        ...new Set(words.filter((word) => /\p{N}/u.test(word) || (word.length === 1 && !/[ai]/.test(word)))),
+    ]
+        .sort()
+        .join(" ");
+}
+function trigrams(words) {
+    const grams = new Set();
+    for (let i = 0; i + 2 < words.length; i += 1)
+        grams.add(`${words[i]} ${words[i + 1]} ${words[i + 2]}`);
+    return grams;
+}
+function likeness(a, b) {
+    let shared = 0;
+    for (const gram of a)
+        if (b.has(gram))
+            shared += 1;
+    const either = a.size + b.size - shared;
+    return either === 0 ? 0 : shared / either;
+}
+/**
+ * Whether these words are much the same as one of the earlier ones (ADR 0097): their word
+ * trigrams at least 60% alike, with @names, links and punctuation left out, so the same words to
+ * another agent are the same words, and about the same particulars. Under six words is never a
+ * repeat.
+ *
+ * "Done with section 3 … over to you for section 4" after "Done with section 2 … over to you for
+ * section 3" is work handed on in the same words, not the same words again: the particulars
+ * differ (ADR 0097's addendum of 17 October 2026).
+ */
+export function repeatOf(text, earlier) {
+    const words = wordsFor(text);
+    if (words.length < MIN_WORDS)
+        return false;
+    const mine = trigrams(words);
+    const particulars = particularsOf(words);
+    return earlier.some((other) => {
+        const theirs = wordsFor(other);
+        return (theirs.length >= MIN_WORDS &&
+            particularsOf(theirs) === particulars &&
+            likeness(mine, trigrams(theirs)) >= LIKENESS);
+    });
+}
+/**
+ * The repeats in a stretch, and for each message whether it repeated, as a circle reads it: its
+ * words again, or a file already in the room posted again with nothing new said beside it. A
+ * reviewer posting the file it is commenting on, with new comments, is at work; the file is still
+ * among the repeats, so its next turn is told that posting it again reaches nobody new.
+ */
+function repeatsIn(messages) {
+    const repeats = [];
+    const repeated = messages.map((message, index) => {
+        const file = message.filesSeen[0];
+        const earlier = messages
+            .slice(0, index)
+            .filter((each) => each.by === message.by)
+            .map((each) => each.text);
+        const again = repeatOf(message.text, earlier);
+        const kind = file !== undefined ? "file" : again ? "words" : undefined;
+        if (kind === undefined)
+            return false;
+        repeats.push({
+            message_id: message.message_id,
+            by: message.by,
+            kind,
+            ...(kind === "file" && file !== undefined ? { file } : {}),
+        });
+        return again || wordsFor(message.text).length < MIN_WORDS;
+    });
+    return { repeats, repeated };
+}
+/** The facts of a stretch of talk, as of `nowMs`, for a message also for `alsoFor`. */
+export function exchangeFactsOf(stretch, options) {
+    const limits = stretch.limits ?? DEFAULT_EXCHANGE_LIMITS;
+    const { repeats, repeated } = repeatsIn(stretch.messages);
+    // A workspace that switched circles off is never told of one (ADR 0187).
+    const circling = limits.circles &&
+        circleIn(stretch.messages.map((message) => message.by), repeated);
+    const at = stretch.since.at === undefined ? Number.NaN : Date.parse(stretch.since.at);
+    return {
+        count: stretch.count,
+        since: stretch.since,
+        minutes: Number.isNaN(at) ? 0 : Math.max(0, Math.floor((options.nowMs - at) / 60_000)),
+        person_looking: stretch.personLooking,
+        ...(stretch.person === undefined ? {} : { person: stretch.person }),
+        // As many as the schema keeps, whatever the hold.
+        repeats: repeats.slice(-CEILING),
+        circling,
+        also_for: [...(options.alsoFor ?? [])],
+        stage: stageOf(stretch.count, circling, stretch.paused, limits),
+        ...(limits.hold === null ? {} : { allowance: limits.hold }),
+        paused: stretch.paused,
+    };
+}
+/** "A", "A and B", "A, B and C". */
+function listed(names) {
+    if (names.length <= 1)
+        return names[0] ?? "";
+    return `${names.slice(0, -1).join(", ")} and ${names.at(-1)}`;
+}
+function plural(n, one, many) {
+    return `${n} ${n === 1 ? one : many}`;
+}
+/** What the count runs from, in words: "Arjun last acted", "ASCII Art posted a.html". */
+function sinceWords(since, nameOf) {
+    const who = since.by === undefined ? undefined : nameOf(since.by);
+    if (since.kind === "start")
+        return "this space began";
+    if (since.kind === "person")
+        return `${who ?? "a person"} last acted here`;
+    if (since.made === "file")
+        return `${who ?? "an agent"} posted ${since.file ?? "a new file"}`;
+    if (since.made === "question")
+        return `${who ?? "an agent"} asked a person a question`;
+    return `${who ?? "an agent"} asked for an approval`;
+}
+function agoWords(facts) {
+    if (facts.since.at === undefined)
+        return "";
+    return facts.minutes === 0
+        ? ", under a minute ago"
+        : `, ${plural(facts.minutes, "minute", "minutes")} ago`;
+}
+function lookingWords(looking) {
+    if (looking === null)
+        return undefined;
+    return looking ? "A person has this space open now." : "No person has this space open now.";
+}
+function repeatWords(repeats, nameOf) {
+    const files = [
+        ...new Set(repeats.flatMap((each) => (each.file === undefined ? [] : [each.file]))),
+    ];
+    const sayers = [
+        ...new Set(repeats.filter((each) => each.kind === "words").map((each) => each.by)),
+    ];
+    const words = [];
+    if (files.length > 0) {
+        const them = files.length === 1 ? "it" : "them";
+        words.push(`${listed(files)} ${files.length === 1 ? "was" : "were"} posted here before; posting ${them} again reaches nobody new.`);
+    }
+    if (sayers.length > 0) {
+        words.push(`${listed(sayers.map(nameOf))} ${sayers.length === 1 ? "has" : "have"} said much the same before.`);
+    }
+    return words;
+}
+/**
+ * The facts in plain words, as a turn is handed them (ADR 0097). A nudge says what Chips sees; a
+ * warning, or a hold, says the way out too:
+ *
+ * > The agents in this room have sent each other 16 messages since Arjun last acted here, 21
+ * > minutes ago. No person has this room open now. ascii-alphabet.html was posted here before;
+ * > posting it again reaches nobody new. Stop, and tell Arjun what is done and what is blocked.
+ * > Messages between the agents are held after 48.
+ */
+export function renderExchangeNote(facts, nameOf) {
+    const parts = [
+        `The agents in this space have sent each other ${plural(facts.count, "message", "messages")} since ${sinceWords(facts.since, nameOf)}${agoWords(facts)}.`,
+    ];
+    const looking = lookingWords(facts.person_looking);
+    if (looking !== undefined)
+        parts.push(looking);
+    parts.push(...repeatWords(facts.repeats.slice(-5), nameOf));
+    if (facts.also_for.length > 0) {
+        parts.push(`This message is also for ${listed(facts.also_for.map(nameOf))}, who may answer it too.`);
+    }
+    if (facts.stage === "quiet" || facts.stage === "nudge")
+        return parts.join(" ");
+    if (facts.circling) {
+        parts.push("This looks like a circle: the same agents taking turns, and nothing new made since.");
+    }
+    const person = facts.person === undefined ? "the person" : nameOf(facts.person);
+    parts.push(`Stop, and tell ${person} what is done and what is blocked.`);
+    if (facts.stage === "held") {
+        parts.push("Messages between the agents are held until a person acts.");
+    }
+    else if (facts.allowance !== undefined) {
+        parts.push(`Messages between the agents are held after ${facts.allowance}.`);
+    }
+    return parts.join(" ");
+}
+//# sourceMappingURL=exchange.js.map

package/dist/src/exchange.js.map

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

package/dist/src/first-names.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The first name a new agent gets in a room asked of its harness from the + (ADR 0150): picked as
+ * the room is made, held for the harness while it waits for the first message, and taken by the
+ * agent the harness makes on it, so the room says "Milo and Theo are here" and they stay Milo and
+ * Theo. The server picks it and keeps one a person's device proposed when it is free; the devices
+ * propose one so the room is drawn with it at once.
+ *
+ * Men's first names, on Arjun's word, three to six letters, easy to say and to type after an @.
+ * Left out: the names of AI products (Claude, Jules, Leo, Devin, Jarvis, Watson, Hal, Grok), names
+ * that are everyday words (Will, Rich, Mark, Bill, Frank, Grant, Drew, Art, Dean, Pat, Rob), and the
+ * harnesses' own (Jacobian, OpenClaw, Scout, Hermes, Goose). A name somebody in the workspace has is
+ * taken like any other.
+ */
+export declare const AGENT_FIRST_NAMES: readonly string[];
+/**
+ * A first name for a new agent, off the list: one nobody has (`taken`, as clash keys: the
+ * workspace's people, its active agents and the names other rooms hold), and, while there is
+ * one, whose first letter nobody in the room has (`beside`, the names there), picked at random
+ * among those so the names are not handed out in order. With every name taken, a numbered one,
+ * "Milo 2", as Chips numbers any clash (ADR 0091). `random` is `Math.random` but in a test.
+ */
+export declare function pickAgentName(taken: ReadonlySet<string>, beside?: readonly string[], random?: () => number): string;
+/**
+ * Whether a name a person's device proposed may be held: a name at all, one line, nothing
+ * `nameProblem` refuses, never Main or You (SEC-33), and nobody's (`taken`). Chips picks another
+ * when it is not.
+ */
+export declare function mayHoldName(name: unknown, taken: ReadonlySet<string>): name is string;
+//# sourceMappingURL=first-names.d.ts.map

package/dist/src/first-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-names.d.ts","sourceRoot":"","sources":["../../src/first-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EA2BX,CAAC;AAOrC;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,EAC1B,MAAM,GAAE,SAAS,MAAM,EAAO,EAC9B,MAAM,GAAE,MAAM,MAAoB,GACjC,MAAM,CAQR;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,IAAI,MAAM,CAWrF"}

package/dist/src/first-names.js

@@ -0,0 +1,80 @@
+/**
+ * The first name a new agent gets in a room asked of its harness from the + (ADR 0150): picked as
+ * the room is made, held for the harness while it waits for the first message, and taken by the
+ * agent the harness makes on it, so the room says "Milo and Theo are here" and they stay Milo and
+ * Theo. The server picks it and keeps one a person's device proposed when it is free; the devices
+ * propose one so the room is drawn with it at once.
+ *
+ * Men's first names, on Arjun's word, three to six letters, easy to say and to type after an @.
+ * Left out: the names of AI products (Claude, Jules, Leo, Devin, Jarvis, Watson, Hal, Grok), names
+ * that are everyday words (Will, Rich, Mark, Bill, Frank, Grant, Drew, Art, Dean, Pat, Rob), and the
+ * harnesses' own (Jacobian, OpenClaw, Scout, Hermes, Goose). A name somebody in the workspace has is
+ * taken like any other.
+ */
+import { clashKey, freeAgentName, nameProblem, notAnAgentName } from "./names.js";
+export const AGENT_FIRST_NAMES = [
+    "Abel Aldo Amir Amos Anders Ansel Anton Ari Arlo Arne Aron Arvid Asher Avi Axel Aziz",
+    "Basil Beau Benji Benno Bilal Bjorn Blaise Boaz Bodhi Boris Bram Bruno Byron",
+    "Cai Caleb Calum Caspar Cato Cedric Cian Ciro Clyde Colm Conor Cosmo Cyrus",
+    "Dag Dante Dario Darius Dax Declan Diego Dima Dmitri Dorian Dov Duncan",
+    "Edgar Elan Eli Elias Elio Emil Emmet Ennio Enzo Erik Evren Ewan Ezra",
+    "Fabio Fausto Felix Fenn Ferris Finn Fitz Florin Floyd Franz",
+    "Gael Galen Gareth Gideon Gil Gino Goran Grady Guido Gunnar Gus",
+    "Hamish Hamza Hank Hans Harvey Hassan Hector Henrik Hiro Hollis Hugo Huxley",
+    "Ian Idris Igor Ike Ilan Imre Ingo Ira Isaac Ivan Ivar Ivo",
+    "Jago Jamal Jasper Javier Jem Jens Jiro Joel Jonah Jorge Joss Jude",
+    "Kai Kamal Karim Kasper Kenji Kian Kieran Klaus Knox Koa Kofi Kurt",
+    "Laszlo Lars Leif Leon Lev Lionel Lior Louis Lucca Lucien Luis Lyle",
+    "Mads Magnus Malik Marco Marlo Mateo Mattis Mauro Milo Miro Moses Musa",
+    "Nadir Nash Naveen Ned Nelson Nestor Niall Nico Nigel Nils Noah Nuri",
+    "Odin Olaf Oliver Omar Oren Orson Osman Oscar Otis Otto Owen Ozzie",
+    "Pablo Paolo Pascal Pavel Pedro Percy Perrin Philo Pierre Piet",
+    "Qadir Quincy Quinn",
+    "Rafa Ramon Raul Ravi Remy Reza Rhys Rio Rocco Rowan Ruben Rudy Rumi",
+    "Sami Sanjay Santo Saul Sergio Seth Silas Simon Soren Stefan Sven",
+    "Taj Tariq Tate Teddy Theo Thor Tiago Tobias Toby Tomas Tycho",
+    "Ugo Ulf Ulric Umar Uri",
+    "Valo Vance Vasco Vaughn Victor Vidal Viggo Vik Vinny Vito Vlad",
+    "Waldo Walt Warren Wendel Wes Wilder Willem Wim Wyatt Wynn",
+    "Xander Xavi Xavier",
+    "Yann Yaro Yosef Yuri Yusuf Yves",
+    "Zaid Zane Zeke Zeno Zev Ziggy",
+].flatMap((line) => line.split(" "));
+/** A name's first letter, as two names in one room are told apart by their faces. */
+function initialOf(name) {
+    return clashKey(name).charAt(0);
+}
+/**
+ * A first name for a new agent, off the list: one nobody has (`taken`, as clash keys: the
+ * workspace's people, its active agents and the names other rooms hold), and, while there is
+ * one, whose first letter nobody in the room has (`beside`, the names there), picked at random
+ * among those so the names are not handed out in order. With every name taken, a numbered one,
+ * "Milo 2", as Chips numbers any clash (ADR 0091). `random` is `Math.random` but in a test.
+ */
+export function pickAgentName(taken, beside = [], random = Math.random) {
+    const letters = new Set(beside.map(initialOf));
+    const free = AGENT_FIRST_NAMES.filter((name) => !taken.has(clashKey(name)));
+    const apart = free.filter((name) => !letters.has(initialOf(name)));
+    const from = apart.length > 0 ? apart : free;
+    const at = (list) => list[Math.floor(random() * list.length)];
+    if (from.length > 0)
+        return at(from);
+    return freeAgentName(at(AGENT_FIRST_NAMES), taken);
+}
+/**
+ * Whether a name a person's device proposed may be held: a name at all, one line, nothing
+ * `nameProblem` refuses, never Main or You (SEC-33), and nobody's (`taken`). Chips picks another
+ * when it is not.
+ */
+export function mayHoldName(name, taken) {
+    if (typeof name !== "string")
+        return false;
+    const trimmed = name.trim();
+    return (trimmed !== "" &&
+        trimmed.length <= 40 &&
+        !/\n/.test(trimmed) &&
+        nameProblem(trimmed) === undefined &&
+        !notAnAgentName(trimmed) &&
+        !taken.has(clashKey(trimmed)));
+}
+//# sourceMappingURL=first-names.js.map

package/dist/src/first-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-names.js","sourceRoot":"","sources":["../../src/first-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAElF,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD,qFAAqF;IACrF,6EAA6E;IAC7E,2EAA2E;IAC3E,uEAAuE;IACvE,sEAAsE;IACtE,6DAA6D;IAC7D,gEAAgE;IAChE,4EAA4E;IAC5E,2DAA2D;IAC3D,mEAAmE;IACnE,mEAAmE;IACnE,oEAAoE;IACpE,uEAAuE;IACvE,qEAAqE;IACrE,mEAAmE;IACnE,+DAA+D;IAC/D,oBAAoB;IACpB,qEAAqE;IACrE,kEAAkE;IAClE,8DAA8D;IAC9D,wBAAwB;IACxB,gEAAgE;IAChE,2DAA2D;IAC3D,oBAAoB;IACpB,iCAAiC;IACjC,+BAA+B;CAChC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;AAErC,qFAAqF;AACrF,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,KAA0B,EAC1B,SAA4B,EAAE,EAC9B,SAAuB,IAAI,CAAC,MAAM;IAElC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnE,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,MAAM,EAAE,GAAG,CAAC,IAAuB,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAW,CAAC;IAC3F,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;IACrC,OAAO,aAAa,CAAC,EAAE,CAAC,iBAAiB,CAAC,EAAE,KAAK,CAAC,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAa,EAAE,KAA0B;IACnE,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,OAAO,CACL,OAAO,KAAK,EAAE;QACd,OAAO,CAAC,MAAM,IAAI,EAAE;QACpB,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;QACnB,WAAW,CAAC,OAAO,CAAC,KAAK,SAAS;QAClC,CAAC,cAAc,CAAC,OAAO,CAAC;QACxB,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAC9B,CAAC;AACJ,CAAC"}