huddle-cli 0.1.1 → 0.1.5

package/dist/room/user.js

@@ -0,0 +1,54 @@
+// The person at the keyboard, as a member of the room.
+//
+// Found live (0.1.2 test): mid-run there was no way to tell the agents
+// anything; a typed line only queued the next goal. Now a line typed during a
+// run reaches every agent that's working, sent as "you", and it outranks
+// teammates' notes: they are information; this is the person the work is for.
+// Agents that start later get every such note in their launch prompt.
+/** The user's id in messages and shared memory. Never an agent's id. */
+export const USER_ID = "you";
+export const isUser = (from) => from === USER_ID;
+/** The prefix of a note from the user in shared memory. */
+const SAID = "The user said: ";
+/**
+ * Send what the user typed to the agents working now (or to `to`, an agent
+ * id), and keep it in shared memory so every task that starts later gets it.
+ * Returns who got it now.
+ */
+export function sayToAgents(db, text, to) {
+    const body = text.trim();
+    if (!body)
+        return { now: [], saved: false };
+    const working = db.listAgents().filter((a) => a.status === "working").map((a) => a.id);
+    const want = to?.trim().replace(/^@/, "").toLowerCase();
+    const now = want ? working.filter((id) => id.toLowerCase() === want || id.toLowerCase().split("#")[0] === want) : working;
+    for (const id of now)
+        db.sendMessage({ from: USER_ID, to: id, body, kind: "note" });
+    // Addressed to one agent: it's for that agent's task, not every later one.
+    if (!want)
+        db.remember({ kind: "decision", body: SAID + body, author: USER_ID });
+    return { now, saved: !want };
+}
+/** Everything the user said this run, for the launch prompt of a task that starts now. */
+export function userBrief(db) {
+    const since = db.currentSession()?.created_at ?? 0;
+    const said = db
+        .recall()
+        .filter((m) => m.author === USER_ID && m.created_at >= since)
+        .reverse()
+        .map((m) => `- ${m.body.startsWith(SAID) ? m.body.slice(SAID.length) : m.body}`);
+    if (!said.length)
+        return "";
+    return [
+        "FROM THE USER — the person this work is for said this during the run. Follow it: it wins over the plan and the contract",
+        "(if it changes a name another task uses, huddle_amend_contract so they hear it too):",
+        ...said.slice(-10),
+    ].join("\n");
+}
+/** How a message reads in an agent's tool result: the user's are marked as theirs. */
+export function fromLabel(m) {
+    return isUser(m.from_agent) ? "the user" : m.from_agent;
+}
+/** Leads a tool result's inbox hint when the user wrote. */
+export const USER_HEAD_HINT = 'The USER (the person this work is for) wrote to the team — see new_messages sent by "the user". Follow it now: it wins over the plan, the contract and teammates\' notes. ';
+//# sourceMappingURL=user.js.map