@songsid/agend 2.3.0-beta.21 → 2.3.0-beta.23

package/dist/login-shell.js

@@ -12,7 +12,7 @@
  * something still holds the pipe after the shell is gone. A background child that let go of the pipe is left alone,
  * as it always was.
  */
-import { spawn } from "node:child_process";
+import { spawn } from "./child-process.js";
 /** How long the login shell may take, as before. */
 export const LOGIN_SHELL_TIMEOUT_MS = 10_000;
 /** After the shell exits: how long its output may still take to drain before the pipe is let go. */
@@ -82,6 +82,8 @@ export function runOnLoginShell(script, opts = {}) {
             }
             chunks.push(chunk);
         });
+        // #2243: the pipe is its own emitter; unheard, its error would be uncaught and stop the fleet. A failed read is no answer.
+        child.stdout?.on("error", () => { chunks.length = 0; finish(null, false); });
         child.on("error", () => finish(null, false));
         child.on("exit", (code) => {
             // The shell is done. Its output normally ends with it; give the last bytes a moment, never a background holder.

package/dist/login-shell.js.map

@@ -1 +1 @@
-{"version":3,"file":"login-shell.js","sourceRoot":"","sources":["../src/login-shell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,oDAAoD;AACpD,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAC7C,oGAAoG;AACpG,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AACxC,iHAAiH;AACjH,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,GAAG,IAAI,CAAC;AAWxD,MAAM,UAAU,eAAe,CAC7B,MAAc,EACd,OAAmH,EAAE;IAErH,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,sBAAsB,CAAC;IAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,oBAAoB,CAAC;IACrD,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,4BAA4B,CAAC;IAC3E,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;QAC3B,IAAI,KAA+B,CAAC;QACpC,IAAI,CAAC;YACH,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE;gBACnD,oGAAoG;gBACpG,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO;gBACtC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;gBACnC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvC,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,UAAsC,CAAC;QAC3C,MAAM,SAAS,GAAG,GAAS,EAAE;YAC3B,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;YACtB,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO;YAC9B,IAAI,CAAC;gBACH,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;oBAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;;oBACnD,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YACrC,CAAC;YAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAChC,CAAC,CAAC;QACF,MAAM,MAAM,GAAG,CAAC,MAAqB,EAAE,QAAiB,EAAE,QAAQ,GAAG,KAAK,EAAQ,EAAE;YAClF,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,QAAQ,CAAC,CAAC;YACvB,IAAI,UAAU;gBAAE,YAAY,CAAC,UAAU,CAAC,CAAC;YACzC,yGAAyG;YACzG,oFAAoF;YACpF,IAAI,QAAQ,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,aAAa;gBAAE,SAAS,EAAE,CAAC;YAC1D,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YACxB,OAAO,CAAC,QAAQ;gBACd,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/D,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7F,CAAC,CAAC;QACF,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;QACjE,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;QACnB,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACzC,IAAI,OAAO;gBAAE,OAAO;YACpB,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC;YACrB,wGAAwG;YACxG,IAAI,IAAI,GAAG,cAAc,EAAE,CAAC;gBAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;gBAAC,OAAO;YAAC,CAAC;YACjE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QAC7C,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,gHAAgH;YAChH,IAAI,KAAK,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;gBAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBAAC,OAAO;YAAC,CAAC;YACjE,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;YACrD,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;YAC5D,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"login-shell.js","sourceRoot":"","sources":["../src/login-shell.ts"],"names":[],"mappings":"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"}

package/dist/ls-rows.js

@@ -1,4 +1,4 @@
-import { execFile } from "node:child_process";
+import { execFile } from "./child-process.js";
 import { existsSync, readFileSync, statSync } from "node:fs";
 import { join } from "node:path";
 import { clampContextPercent, parseContextPercent } from "./context-percent.js";

package/dist/needs-you-hub.d.ts

@@ -1,7 +1,11 @@
 import type { ChannelAdapter } from "./channel/types.js";
-import { type DeliveryInput, type InstanceInput, type NeedsYouItem, type PromptInput, type WorldPlace } from "./needs-you.js";
+import { type DeliveryInput, type InstanceInput, type NeedsYouItem, type PromptInput, type TaskInput, type WorldPlace } from "./needs-you.js";
 import { type LiveTarget } from "./needs-you-live.js";
 export declare const NEEDS_ACK_PREFIX = "needs-ack:";
+/** A Send back or Answer prompt waits this long for its reply (monotonic). */
+export declare const TASK_REPLY_TTL_MS: number;
+/** Send back / Answer prompts open at once, being sent or waiting for their reply, over every card and person (#2306 review). */
+export declare const TASK_REPLY_MAX = 32;
 /** awaiting_input pings (DM, browser) only once it has lasted this long; the list itself is never delayed (§6.3). */
 export declare const AWAITING_PING_MIN_MS = 5000;
 /** An Acknowledge button's capability lapses this long after it was minted, whether or not a renewal replaced it. */
@@ -27,6 +31,15 @@ export interface NeedsYouHubContext {
     worlds(): NeedsYouWorld[];
     /** Where a world's fleet notices go (its General), or null. */
     noticeTarget(world: string): LiveTarget | null;
+    /** #2352: an instance's own channel (its topic in its world's group, or its ClassicBot room), or null. */
+    laneTarget?(instance: string): LiveTarget | null;
+    /**
+     * #2355 review: where a card's buttons belong NOW, read from the board (not from the last render): `{ lane }` (no lane:
+     * General), or null when the card no longer waits for the person (the board answers a move by its version).
+     */
+    taskRoute?(code: string): {
+        lane?: string;
+    } | null;
     /** An instance's own thread/topic id, for its link. */
     instanceTopic(instance: string): string | undefined;
     isFleetAdmin(userId: string, world: string): boolean;
@@ -34,6 +47,16 @@ export interface NeedsYouHubContext {
     emitSse(event: string, data: unknown): void;
     /** outbox.acknowledge: true when this call acknowledged it; throws on a write error. */
     acknowledge(deliveryId: string, by: string): boolean;
+    /** Task board cards waiting for the person (#2246 step 3); none when the board is not open. */
+    tasks?(): TaskInput[];
+    /**
+     * The person's move on a card from the chat: confirm it, send it back with `text` (the reason), or answer its blocked
+     * question with `text`. Checked against the version the button showed; the answer is said to the clicker.
+     */
+    taskAction?(action: TaskAction): {
+        ok: boolean;
+        message: string;
+    };
     settings(): {
         liveMessage: boolean;
         dm: boolean;
@@ -42,16 +65,44 @@ export interface NeedsYouHubContext {
     t(key: string, ...args: Array<string | number>): string;
     log(level: "info" | "warn" | "debug", message: string, extra?: Record<string, unknown>): void;
 }
+export type TaskVerb = "confirm" | "back" | "answer";
+export interface TaskAction {
+    verb: TaskVerb;
+    code: string;
+    version: number;
+    /** The reason (back) or the answer (answer). */
+    text?: string;
+    /** The person, as the platform names them. */
+    by: {
+        platform: string;
+        userId: string;
+        username?: string;
+    };
+}
+/** A reply to a message, as the inbound handler sees it (InboundMessage's fields). */
+export interface ReplyMessage {
+    adapterId: string;
+    chatId: string;
+    threadId?: string;
+    replyTo?: string;
+    messageId: string;
+    userId: string;
+    username?: string;
+    text: string;
+}
 export interface AckCallback {
     callbackData: string;
     chatId: string;
     threadId?: string;
     messageId: string;
     userId?: string;
+    username?: string;
     ack?(notice?: string): void;
 }
 /** What the web receives: the items without their chat coordinates. */
 export type WebNeedsItem = Omit<NeedsYouItem, "promptAt">;
+/** #2352: a live message's key — its world (General, as before #2352) or `<world>#lane:<instance>` (a lane's channel). */
+export declare function liveKey(world: string, lane: string | null): string;
 export declare class NeedsYouHub {
     private readonly ctx;
     private items;
@@ -62,6 +113,16 @@ export declare class NeedsYouHub {
      *  moved place gets a new renderer, and the old one can no longer publish. */
     private readonly live;
     private readonly acks;
+    /** Send back / Answer prompts waiting for the clicker's reply, by `${world}|${chatId}|${messageId}`. */
+    /** Pending replies by where their prompt is (`<chatId>|<messageId>`), whichever bot receives the reply. */
+    private readonly replies;
+    /** Prompts on their way: reserved before the send, released when it is posted or fails (#2306 review). */
+    private readonly asking;
+    /**
+     * #2341 review r2: replies already taken, by `<chatId>|<messageId>`, until the prompt's TTL — so another bot's copy of
+     * the same message (a shared group) is dropped by the inbound handler, not handed to an agent as input.
+     */
+    private readonly taken;
     private readonly dmSeen;
     private readonly dmLastAt;
     /** Per world: the ids waiting to be DMed, and the one timer that will send them. */
@@ -84,7 +145,12 @@ export declare class NeedsYouHub {
     private pointerPath;
     private readPointers;
     private writePointer;
+    /** A line's words: why it waits — and for a card, which card and what it asks or lacks (the chat shows no detail). */
     private lineTitle;
+    /** #2352: a lane can carry a list here: its instance is this world's now, and has a channel of its own. */
+    private laneUsable;
+    /** Where a list (General, or a lane's) is posted now, or null. */
+    private listTarget;
     private makeLive;
     private mintAcks;
     private revokeAcks;
@@ -94,6 +160,37 @@ export declare class NeedsYouHub {
      * never edited from here — that would strip the current keyboard of the same message.
      */
     handleCallback(data: AckCallback, adapterId: string): boolean;
+    /**
+     * #2352: a card still routes to this lane (or, for no lane, to General) — asked of the board now (#2355 review: a
+     * project's lead can change with the card's version unchanged, and the last render may not have seen it yet). One
+     * that no longer waits for the person is left to the board, which answers by its version.
+     */
+    private stillInLane;
+    /** #2355 review: a list's place (its lane's channel, or General) is still where this button or prompt is. */
+    private placeStill;
+    /** A prompt for this reservation still waits for its reply. */
+    private pendingFor;
+    /** Prompts still waiting for their reply (lapsed ones go). */
+    private livePending;
+    /**
+     * The card's instance is still this world's, the world still the same connection in the same place, and its notice
+     * place still where the prompt is: else a reply there is not this world's to take (#2306 review — an instance that
+     * moved to another world, a replaced connection, a new notice room).
+     */
+    private stillHere;
+    /** Post the prompt for a Send back's reason or an answer, and wait for the clicker's reply to it. */
+    private askForReply;
+    /**
+     * An inbound message that replies to one of our Send back / Answer prompts, by the admin who clicked: its text is
+     * the reason or the answer, and the message goes no further (true). Anything else — another message, another
+     * person, a lapsed prompt — is not ours (false) and flows on as usual.
+     */
+    handleReply(msg: ReplyMessage): boolean;
+    /**
+     * #2341 review r2: this message (another bot's copy of it) was already taken as a prompt's answer. The inbound handler
+     * asks it first and drops the copy: it is neither a second answer nor an agent's input.
+     */
+    wasTakenReply(chatId: string, messageId: string | undefined): boolean;
     /** The web's Acknowledge: any item (the web is global, §5.0). `principal` is "web:<session handle>" or "cli". */
     webAcknowledge(itemId: string, principal: string): {
         status: 200 | 400 | 404 | 409 | 500;