@songsid/agend 2.3.0-beta.2 → 2.3.0-beta.20

package/dist/task-board-tool.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The `task` tool's board actions (step 2, docs/design/task-board.md), for both of the tool's doors — the MCP tool
+ * over IPC (FleetManager.handleTaskCrud) and `agend-agent task` over HTTP (handleTaskCrudHttp):
+ *
+ * - `mine` — the caller's work; `projects` — the board's projects;
+ * - `move` — a card to another status, with the reason, result or comment the move needs;
+ * - `create` or `update` naming a board field (a project, a parent, a checklist, state, a log line, a comment…);
+ * - `get` of a card on the board — the card as text, with the comments new to its assignee.
+ *
+ * Everything else is the tool's own and is answered as before (undefined here). The caller is the instance the tool
+ * belongs to; the board's rules (scheduler/task-board.ts) decide what it may do. Answers are plain text.
+ */
+import type { SchedulerDb } from "./scheduler/db.js";
+export declare function boardToolAction(db: SchedulerDb, instance: string, args: Record<string, unknown>): string | undefined;
+/** The activity log's line for a board action that changed work (as `created task:` / `claimed:` / `completed:` for plain tasks). */
+export declare function boardActivity(args: Record<string, unknown>): string | null;
+/**
+ * #2303: how many handed-out board cards an instance may have in progress at once — its `board_cards_at_once`, else
+ * 1 (the validator holds it to a whole number of at least 1; anything else here counts as 1).
+ */
+export declare function boardCardLimit(fleet: {
+    instances?: Record<string, {
+        board_cards_at_once?: unknown;
+    } | undefined>;
+} | null | undefined, name: string): number;

package/dist/task-board-tool.js

@@ -0,0 +1,154 @@
+import { CARD_PRIORITIES, CARD_SIZES, CARD_STATUSES, TaskBoardError } from "./scheduler/task-board.js";
+import { cardLine, cardText, myWorkText, projectsText, writeText } from "./scheduler/task-board-text.js";
+/** A `create` naming one of these opens a board card; without them it is the tool's plain task. */
+const BOARD_CREATE = ["project", "parent", "scope", "acceptance", "context", "needs_review", "size", "dispatcher"];
+/** An `update` naming one of these edits the card on the board's terms; without them it is the tool's plain update. */
+const BOARD_UPDATE = ["title", "description", "scope", "context", "state", "acceptance", "check", "uncheck", "log", "comment", "needs_review", "size", "depends_on", "version", "dispatcher"];
+/** Words agents bring from other boards. */
+const STATUS_ALIAS = { todo: "open", "to do": "open", doing: "claimed", in_progress: "claimed", "in progress": "claimed", waiting: "review" };
+const str = (v) => (typeof v === "string" ? v : undefined);
+const strs = (v) => (Array.isArray(v) && v.every((x) => typeof x === "string") ? v : undefined);
+const nums = (v) => (Array.isArray(v) && v.every((x) => typeof x === "number") ? v : undefined);
+const int = (v) => (typeof v === "number" && Number.isInteger(v) ? v : undefined);
+const bool = (v) => (typeof v === "boolean" ? v : undefined);
+// A dispatcher of null is a value (nobody), not an absent field.
+const has = (args, keys) => keys.some((k) => args[k] !== undefined && (args[k] !== null || k === "dispatcher"));
+function status(v, param = "to") {
+    const s = typeof v === "string" ? v.trim().toLowerCase() : "";
+    const known = CARD_STATUSES.includes(s) ? s : STATUS_ALIAS[s];
+    if (!known)
+        throw new TaskBoardError("invalid", `"${param}" is one of ${CARD_STATUSES.join(", ")}`);
+    return known;
+}
+const priority = (v) => (CARD_PRIORITIES.includes(v) ? v : undefined);
+/** An instance's name; null, "" or "none": nobody. */
+const dispatcher = (v) => {
+    if (v === undefined)
+        return undefined;
+    const name = typeof v === "string" ? v.trim() : "";
+    return !name || name.toLowerCase() === "none" ? null : { kind: "instance", name };
+};
+const size = (v) => (v === null || v === "" ? null : CARD_SIZES.includes(v) ? v : undefined);
+function need(v, what) {
+    const s = str(v)?.trim();
+    if (!s)
+        throw new TaskBoardError("invalid", `${what} is required`);
+    return s;
+}
+export function boardToolAction(db, instance, args) {
+    const board = db.board;
+    const actor = { kind: "instance", name: instance };
+    switch (args.action) {
+        case "mine":
+            return myWorkText(board, instance, board.myWork(instance));
+        case "projects":
+            return projectsText(board.listProjects(true), board.projectStats());
+        case "move": {
+            const id = need(args.id, "id");
+            let to = status(args.to ?? args.status);
+            // As the tool's `done`: finishing a card that waits for the person's confirmation hands it to them (review).
+            if (to === "done") {
+                const held = board.findCard(id);
+                if (held?.needsReview && held.status !== "review")
+                    to = "review";
+            }
+            const { card, from, notes } = board.moveCard(actor, id, to, {
+                reason: str(args.reason), result: str(args.result), comment: str(args.comment), version: int(args.version),
+            });
+            return writeText(card, notes, from);
+        }
+        case "create": {
+            if (!has(args, BOARD_CREATE))
+                return undefined;
+            const spec = {
+                title: need(args.title, "title"),
+                goal: str(args.description),
+                scope: str(args.scope),
+                context: str(args.context),
+                acceptance: strs(args.acceptance),
+                priority: priority(args.priority),
+                size: size(args.size) ?? undefined,
+                dependsOn: strs(args.depends_on),
+                needsReview: bool(args.needs_review),
+                dispatcher: dispatcher(args.dispatcher),
+                ...(str(args.parent) ? { parent: str(args.parent) } : { project: str(args.project) ?? (typeof args.project === "number" ? args.project : undefined) }),
+                ...(args.assignee !== undefined ? { assignee: str(args.assignee) ?? null } : {}),
+            };
+            const { cards, notes } = board.createCards(actor, { cards: [spec] });
+            return writeText(cards[0], notes);
+        }
+        case "update": {
+            if (!has(args, BOARD_UPDATE))
+                return undefined;
+            const patch = {
+                version: int(args.version),
+                title: str(args.title),
+                goal: str(args.description),
+                scope: str(args.scope),
+                context: str(args.context),
+                state: str(args.state),
+                result: str(args.result),
+                acceptance: strs(args.acceptance),
+                check: nums(args.check),
+                uncheck: nums(args.uncheck),
+                log: str(args.log),
+                comment: str(args.comment),
+                needsReview: bool(args.needs_review),
+                dispatcher: dispatcher(args.dispatcher),
+                size: size(args.size),
+                priority: priority(args.priority),
+                dependsOn: strs(args.depends_on),
+                ...(args.assignee !== undefined ? { assignee: str(args.assignee) ?? null } : {}),
+            };
+            if (args.status === undefined) {
+                const { card, notes } = board.updateCard(actor, need(args.id, "id"), patch);
+                return writeText(card, notes);
+            }
+            // A status given with the fields: the fields, then the move as the tool's plain update makes it (the board's
+            // rules, the gate) — one write, so a refused move keeps the fields unchanged too.
+            const to = status(args.status, "status");
+            const { card, from } = board.atomically(() => {
+                const { card: edited } = board.updateCard(actor, need(args.id, "id"), patch);
+                if (to !== edited.status)
+                    db.updateTask(edited.uuid, { status: to }, actor);
+                return { card: board.getCard(edited.uuid), from: edited.status };
+            });
+            return writeText(card, board.takeNotes(), from);
+        }
+        case "list": {
+            if (!has(args, ["project", "parent"]))
+                return undefined;
+            const filterStatus = args.filter_status === undefined ? undefined : (Array.isArray(args.filter_status) ? args.filter_status : [args.filter_status]).map((v) => status(v, "filter_status"));
+            const project = args.project === "" || args.project === "none" ? null : (str(args.project) ?? (typeof args.project === "number" ? args.project : undefined));
+            const { cards, total } = board.listCards({ project, parent: str(args.parent), assignee: str(args.filter_assignee) || undefined, status: filterStatus });
+            if (!cards.length)
+                return "No cards match.";
+            return [...cards.map((c) => cardLine(c)), ...(total > cards.length ? [`… ${total - cards.length} more: narrow with filter_status or filter_assignee`] : [])].join("\n");
+        }
+        case "get": {
+            const card = board.findCard(need(args.id, "id"));
+            return card && board.isOnBoard(card) ? cardText(board, card) : undefined;
+        }
+        default:
+            return undefined;
+    }
+}
+/** The activity log's line for a board action that changed work (as `created task:` / `claimed:` / `completed:` for plain tasks). */
+export function boardActivity(args) {
+    const id = typeof args.id === "string" ? args.id : "";
+    if (args.action === "create" && has(args, BOARD_CREATE) && typeof args.title === "string")
+        return `created task: ${args.title}`;
+    if (args.action !== "move")
+        return null;
+    const to = typeof args.to === "string" ? args.to : typeof args.status === "string" ? args.status : "";
+    return { claimed: `claimed: ${id}`, done: `completed: ${id}`, review: `submitted for review: ${id}`, blocked: `blocked: ${id}`, cancelled: `cancelled: ${id}`, open: `put back: ${id}` }[STATUS_ALIAS[to] ?? to] ?? null;
+}
+/**
+ * #2303: how many handed-out board cards an instance may have in progress at once — its `board_cards_at_once`, else
+ * 1 (the validator holds it to a whole number of at least 1; anything else here counts as 1).
+ */
+export function boardCardLimit(fleet, name) {
+    const own = fleet?.instances && Object.prototype.hasOwnProperty.call(fleet.instances, name) ? fleet.instances[name]?.board_cards_at_once : undefined;
+    return typeof own === "number" && Number.isInteger(own) && own >= 1 ? own : 1;
+}
+//# sourceMappingURL=task-board-tool.js.map

package/dist/task-board-tool.js.map

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

package/dist/task-board-waker.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Waking an instance when someone else changes a card it owns or handed out (step 2, docs/design/task-board.md). The
+ * board decides who hears what (TaskBoard's settleWakes); this gathers an instance's news for `gatherMs` (10 s) into
+ * one message — dragging five cards, or opening a whole plan, is one wake — checks again that each piece still stands
+ * when it goes out (wakeHolds), and hands it to the fleet as a notice from AgEnD: the delivery outbox holds it until
+ * the instance can take it, across a restart too. What is gathered but not yet handed over is lost on a stop; the card
+ * keeps the news (`task mine`, the comments new to its assignee).
+ */
+import type { Wake } from "./scheduler/task-board.js";
+import { type Card } from "./scheduler/task-board.js";
+export interface TaskBoardWakerDeps {
+    /** Hand `message` to the instance for good (the fleet's durable delivery); false when it could not be taken. */
+    deliver(instance: string, message: string, key: string): boolean;
+    /** Whether the board may wake this name: a fleet instance (an assignee can be any name). */
+    isInstance(name: string): boolean;
+    /** What of a wake still stands now (TaskBoard.wakeHolds), and the card, to say what it lacks. */
+    holds(wake: Wake): Wake | null;
+    card(uuid: string): Card | undefined;
+    log(level: "info" | "warn", message: string, extra?: Record<string, unknown>): void;
+    gatherMs?: number;
+    timers?: {
+        set(fn: () => void, ms: number): unknown;
+        clear(handle: unknown): void;
+    };
+    now?: () => number;
+}
+/**
+ * One message for an instance's gathered news: a line per card (a main task assigned with its sub tasks is one line),
+ * or — a whole plan assigned at once — a count, so it does not read as everything to do right now.
+ */
+export declare function wakeMessage(wakes: Wake[], card?: (uuid: string) => Card | undefined): string;
+export declare class TaskBoardWaker {
+    private readonly deps;
+    private readonly gathering;
+    private stopped;
+    private seq;
+    private readonly timers;
+    constructor(deps: TaskBoardWakerDeps);
+    /** A committed write's wakes: gathered per instance, a card's news merged (each reason keeps its own words). */
+    note(wakes: readonly Wake[]): void;
+    /** Nothing more is sent (the fleet is stopping); news still gathering is dropped — the cards keep it. */
+    stop(): void;
+    private flush;
+}

package/dist/task-board-waker.js

@@ -0,0 +1,128 @@
+import { gapText, oneLine } from "./scheduler/task-board-text.js";
+import { wrapUpGap } from "./scheduler/task-board.js";
+/** More assignments than this in one message are told as a count, not a line each. */
+const MANY_ASSIGNED = 3;
+/** The order a card's news is told in. */
+const ORDER = ["cancelled", "sent_back", "decide", "answered", "approved", "wrap_up", "assigned", "start", "ready", "comment"];
+const quote = (text) => (text ? `: "${oneLine(text, 160)}"` : "");
+/** One reason, as a line about the card says it. */
+function say(w, r, card) {
+    const by = w.by[r] ?? "someone";
+    switch (r) {
+        case "assigned": return `assigned to you by ${by}`;
+        case "start": return `${by} asks you to start it`;
+        case "sent_back": return `sent back by ${by}${quote(w.texts.sent_back)}`;
+        case "answered": return `${by} answered your blocked question${quote(w.texts.answered)} — it is in progress again`;
+        case "comment": return `new comment from ${by}${quote(w.texts.comment)}`;
+        case "ready": return "everything it waited for is done — you can start it";
+        case "decide": return `you handed it out and it is blocked${card?.assignee ? ` (@${card.assignee})` : ""}${quote(w.texts.decide)} — ask the person, then answer it: move it back to claimed with the decision as the comment`;
+        case "approved": return card?.assignee === w.instance ? `the person confirmed it${quote(w.texts.approved)}` : `you handed it out; the person confirmed it${quote(w.texts.approved)}`;
+        case "cancelled": return `cancelled by ${by}${w.texts.cancelled?.startsWith("with its main task") ? ` ${oneLine(w.texts.cancelled, 160)}` : quote(w.texts.cancelled)} — stop working on it`;
+        case "wrap_up": {
+            const gap = card ? wrapUpGap(card) : null;
+            return `it went to the person for confirmation by itself${gap ? `, but ${gapText(gap, true)}` : ""} — fill it in with update`;
+        }
+    }
+}
+/** "M-11–M-16" for a run of numbers, else the first few. */
+function idList(codes) {
+    const n = (c) => Number(c.slice(2));
+    const sorted = [...codes].sort((a, b) => n(a) - n(b));
+    const run = sorted.length > 2 && sorted.every((c, i) => i === 0 || n(c) === n(sorted[i - 1]) + 1);
+    if (run)
+        return `${sorted[0]}–${sorted[sorted.length - 1]}`;
+    return sorted.length > 5 ? `${sorted.slice(0, 5).join(", ")} …` : sorted.join(", ");
+}
+/**
+ * One message for an instance's gathered news: a line per card (a main task assigned with its sub tasks is one line),
+ * or — a whole plan assigned at once — a count, so it does not read as everything to do right now.
+ */
+export function wakeMessage(wakes, card = () => undefined) {
+    const assignedMains = new Set(wakes.filter((w) => w.reasons.includes("assigned") && !w.parent).map((w) => w.code));
+    const folded = new Map();
+    const items = wakes.filter((w) => {
+        const into = w.parent && w.reasons.length === 1 && w.reasons[0] === "assigned" && assignedMains.has(w.parent) ? w.parent : null;
+        if (into)
+            folded.set(into, (folded.get(into) ?? 0) + 1);
+        return !into;
+    });
+    const line = (w) => {
+        const subs = folded.get(w.code);
+        const news = ORDER.filter((r) => w.reasons.includes(r)).map((r) => say(w, r, card(w.uuid))).join("; ");
+        return `${w.code} "${oneLine(w.title, 60)}"${subs ? ` (with ${subs} sub task${subs === 1 ? "" : "s"})` : ""}: ${news}.`;
+    };
+    const assigned = items.filter((w) => w.reasons.length === 1 && w.reasons[0] === "assigned");
+    if (items.length > 1 && assigned.length > MANY_ASSIGNED) {
+        const mains = assigned.filter((w) => !w.parent).map((w) => w.code);
+        const subs = assigned.length - mains.length + [...folded.values()].reduce((a, b) => a + b, 0);
+        const what = [mains.length ? `${mains.length} main task${mains.length === 1 ? "" : "s"} (${idList(mains)})` : "", subs ? `${subs} sub task${subs === 1 ? "" : "s"}` : ""].filter(Boolean).join(" and ");
+        const summary = `You were assigned ${what}.`;
+        const rest = items.filter((w) => !assigned.includes(w));
+        const tail = "Read task mine for the order and work through them one at a time, by priority.";
+        return rest.length ? `[Task board] ${summary}\n${rest.map((w) => `- ${line(w)}`).join("\n")}\n${tail}` : `[Task board] ${summary} ${tail}`;
+    }
+    if (items.length === 1)
+        return `[Task board] ${line(items[0])} Read it with: task get ${items[0].code}`;
+    return `[Task board] ${items.length} things on your cards:\n${items.map((w) => `- ${line(w)}`).join("\n")}\nYour work: task mine`;
+}
+export class TaskBoardWaker {
+    deps;
+    gathering = new Map();
+    stopped = false;
+    seq = 0;
+    timers;
+    constructor(deps) {
+        this.deps = deps;
+        this.timers = deps.timers ?? { set: (fn, ms) => { const h = setTimeout(fn, ms); h.unref?.(); return h; }, clear: (h) => clearTimeout(h) };
+    }
+    /** A committed write's wakes: gathered per instance, a card's news merged (each reason keeps its own words). */
+    note(wakes) {
+        if (this.stopped)
+            return;
+        for (const w of wakes) {
+            if (!this.deps.isInstance(w.instance))
+                continue;
+            let batch = this.gathering.get(w.instance);
+            if (!batch) {
+                batch = { wakes: new Map(), timer: this.timers.set(() => this.flush(w.instance), this.deps.gatherMs ?? 10_000) };
+                this.gathering.set(w.instance, batch);
+            }
+            const had = batch.wakes.get(w.uuid);
+            batch.wakes.set(w.uuid, had
+                ? { ...had, title: w.title, reasons: [...new Set([...had.reasons, ...w.reasons])], by: { ...had.by, ...w.by }, texts: { ...had.texts, ...w.texts } }
+                : { ...w, reasons: [...w.reasons], by: { ...w.by }, texts: { ...w.texts } });
+        }
+    }
+    /** Nothing more is sent (the fleet is stopping); news still gathering is dropped — the cards keep it. */
+    stop() {
+        this.stopped = true;
+        for (const b of this.gathering.values())
+            this.timers.clear(b.timer);
+        this.gathering.clear();
+    }
+    flush(instance) {
+        const batch = this.gathering.get(instance);
+        this.gathering.delete(instance);
+        if (!batch || this.stopped)
+            return;
+        // Only what still holds as it goes out: not finished meanwhile, still theirs, still waiting on them.
+        const wakes = [...batch.wakes.values()].map((w) => this.deps.holds(w)).filter((w) => w !== null);
+        if (!wakes.length)
+            return;
+        const codes = wakes.map((w) => w.code);
+        const key = `task-board:${instance}:${(this.deps.now ?? Date.now)()}:${++this.seq}`;
+        let taken = false;
+        try {
+            taken = this.deps.deliver(instance, wakeMessage(wakes, (uuid) => this.deps.card(uuid)), key);
+        }
+        catch (err) {
+            this.deps.log("warn", "Task board wake failed", { instance, codes, err: err.message });
+            return;
+        }
+        if (taken)
+            this.deps.log("info", "Task board wake handed to delivery", { instance, codes });
+        else
+            this.deps.log("warn", "Task board wake not taken; the cards keep the news", { instance, codes });
+    }
+}
+//# sourceMappingURL=task-board-waker.js.map

package/dist/task-board-waker.js.map

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

package/dist/tmux-exec-helper.d.ts

@@ -0,0 +1,94 @@
+import { type ChildProcess } from "node:child_process";
+export interface HelperExecOptions {
+    timeout?: number;
+    maxBuffer?: number;
+    env?: NodeJS.ProcessEnv;
+    /** Written to the command's stdin, then closed (load-buffer). */
+    input?: string;
+}
+export interface HelperExecResult {
+    stdout: string;
+    stderr: string;
+}
+/** The binaries the helper may start (by name; resolved to absolute paths on PATH when the helper starts). */
+export declare const HELPER_BINARIES: readonly ["tmux", "stty"];
+/** How long a request may wait for the helper's "started" before the helper is taken as wedged. */
+export declare const HELPER_START_TIMEOUT_MS = 1500;
+/** After "started": how long past the command's own timeout its answer may take (no timeout: this alone). */
+export declare const HELPER_ANSWER_GRACE_MS = 5000;
+export declare const HELPER_NO_TIMEOUT_DEADLINE_MS = 120000;
+/**
+ * The helper's program (`node -e`): JSON lines in on stdin, JSON lines out on stdout. It exits when its stdin ends
+ * (the fleet went away) or its parent no longer exists (the fleet died while something else held the pipe).
+ */
+export declare const HELPER_SOURCE: string;
+/** The absolute path `name` resolves to on this PATH (an executable file), or null. */
+export declare function resolveOnPath(name: string, path: string | undefined): string | null;
+export interface ExecHelperOptions {
+    /** The direct call, used when the helper isn't (or can no longer be) used for a call. */
+    direct(file: string, args: string[], opts: HelperExecOptions): Promise<HelperExecResult>;
+    /** Start the helper process (tests: another program). */
+    spawnHelper?(allow: string[]): ChildProcess;
+    /** The PATH binaries are resolved on (default: the fleet's, when the helper starts). */
+    path?(): string | undefined;
+    now?(): number;
+    startTimeoutMs?: number;
+    answerGraceMs?: number;
+    log?(event: string, detail?: Record<string, unknown>): void;
+}
+export declare class ExecHelper {
+    private readonly options;
+    private proc;
+    private allow;
+    private pending;
+    private nextId;
+    private trusted;
+    private backoffMs;
+    private restartAt;
+    private stopped;
+    private resolvedPath;
+    constructor(options: ExecHelperOptions);
+    private now;
+    /** Whether calls go to the helper now. */
+    usable(): boolean;
+    /** Start the helper (the fleet's own start and timer only). */
+    start(): void;
+    /** The fleet's timer: start a helper that is not running, after the backoff. */
+    maintain(): void;
+    /** A fleet started again after a stop may start the helper again. */
+    reopen(): void;
+    /** The fleet is stopping: no more calls go to the helper; its stdin ends, and it exits once its commands have answered. */
+    stop(): void;
+    /**
+     * A command, through the helper when it can be used, else directly — exactly once either way. `direct` is the
+     * caller's own call as it has always been made (so a direct call is byte-for-byte the old one); default: directExec.
+     */
+    exec<R = HelperExecResult>(file: string, args: string[], opts?: HelperExecOptions, direct?: () => Promise<R>): Promise<R>;
+    /** The helper's absolute path for `file` when the call would start the same binary; else null (the call goes direct). */
+    private absoluteFor;
+    private receive;
+    /**
+     * While a call waits on it, the helper keeps the process alive, as a direct call's child would; with none waiting it
+     * never does (the fleet's exit is not held up by an idle helper).
+     */
+    private holdOpen;
+    private settle;
+    /** What a direct call that timed out would have rejected with. */
+    private timeoutError;
+    /**
+     * Stop trusting this helper and end it; the calls it never started go direct once it is gone (gone()). Taken as
+     * wedged (no_start) while commands it started still run, it is not killed — killing it would not stop them, and their
+     * calls would fail though they ran: its stdin is ended, and it exits once they have answered (or their deadline kills it).
+     */
+    private retire;
+    /** The helper is gone and its output has been read to the end. */
+    private gone;
+    private scheduleRestart;
+}
+/** execFile as a promise, the way the direct call has always run it (with its sync-work attribution done by callers). */
+export declare function directExec(file: string, args: string[], opts: HelperExecOptions): Promise<HelperExecResult>;
+/**
+ * The fleet's one helper. Until the fleet starts it (and whenever it can't be used) every call is the direct one, its
+ * synchronous fork attributed as before (#1235's "tmux.spawn").
+ */
+export declare const tmuxExecHelper: ExecHelper;