@synaplink/orqlaude 0.3.0

package/dist/telegram/notifier.js

@@ -0,0 +1,136 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { StateStore } from "../lib/state.js";
+const EMPTY_CURSOR = {
+    lastNoteId: null,
+    taskStatus: {},
+    planStatus: {},
+    alertedHallucinations: [],
+};
+export class Notifier {
+    projectDir;
+    cfg;
+    api;
+    cursorPath;
+    cursor = null;
+    constructor(projectDir, cfg, api) {
+        this.projectDir = projectDir;
+        this.cfg = cfg;
+        this.api = api;
+        this.cursorPath = path.join(projectDir, ".orqlaude", "telegram-cursor.json");
+    }
+    async loadCursor() {
+        if (this.cursor)
+            return this.cursor;
+        try {
+            const raw = await fs.readFile(this.cursorPath, "utf8");
+            this.cursor = { ...EMPTY_CURSOR, ...JSON.parse(raw) };
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                this.cursor = { ...EMPTY_CURSOR };
+            else
+                throw err;
+        }
+        return this.cursor;
+    }
+    async saveCursor() {
+        if (!this.cursor)
+            return;
+        await fs.mkdir(path.dirname(this.cursorPath), { recursive: true });
+        const tmp = `${this.cursorPath}.${process.pid}.tmp`;
+        await fs.writeFile(tmp, JSON.stringify(this.cursor, null, 2));
+        await fs.rename(tmp, this.cursorPath);
+    }
+    /** One pass: detect deltas, push notifications, advance cursor. */
+    async tick() {
+        if (this.cfg.whitelist.length === 0)
+            return;
+        const cursor = await this.loadCursor();
+        const store = new StateStore(path.join(this.projectDir, ".orqlaude"));
+        const plans = await store.read((s) => Object.values(s.plans));
+        const messages = [];
+        for (const plan of plans) {
+            const prevStatus = cursor.planStatus[plan.id];
+            // Plan status transitions we care about
+            if (prevStatus !== plan.status) {
+                if (!prevStatus && plan.status === "draft") {
+                    messages.push(`📋 *New plan* \`${plan.id.slice(0, 8)}\` — ${plan.tasks.length} task(s)\n${truncate(plan.rootTask, 100)}`);
+                }
+                else if (plan.status === "approved" && prevStatus !== "approved") {
+                    messages.push(`✅ *Approved* \`${plan.id.slice(0, 8)}\` — spawning ${plan.tasks.length} agents`);
+                }
+                else if (plan.status === "collected") {
+                    const total = plan.tasks.length;
+                    const done = plan.tasks.filter((t) => t.status === "done").length;
+                    messages.push(`🎉 *Collected* \`${plan.id.slice(0, 8)}\` — ${done}/${total} tasks done`);
+                }
+                else if (plan.status === "cancelled_overbudget") {
+                    messages.push(`💸 *Auto-cancelled* \`${plan.id.slice(0, 8)}\` — fleet exceeded token budget`);
+                }
+                else if (plan.status === "cancelled") {
+                    messages.push(`❌ *Cancelled* \`${plan.id.slice(0, 8)}\``);
+                }
+                cursor.planStatus[plan.id] = plan.status;
+            }
+            // Per-task status transitions
+            for (const task of plan.tasks) {
+                const prev = cursor.taskStatus[task.id];
+                if (prev !== task.status) {
+                    if (task.status === "done") {
+                        const prSuffix = task.prUrl ? `\n${task.prUrl}` : "";
+                        messages.push(`✓ *${truncate(task.title, 60)}* — done${prSuffix}`);
+                    }
+                    else if (task.status === "failed") {
+                        messages.push(`❌ *${truncate(task.title, 60)}* — failed${task.exitReason ? `\n${task.exitReason}` : ""}`);
+                    }
+                    else if (task.status === "cancelled") {
+                        messages.push(`🛑 *${truncate(task.title, 60)}* — cancelled`);
+                    }
+                    cursor.taskStatus[task.id] = task.status;
+                }
+            }
+            // New notes (only after the last-seen note id)
+            let foundLast = cursor.lastNoteId === null;
+            for (const note of plan.notes) {
+                if (!foundLast) {
+                    if (note.id === cursor.lastNoteId)
+                        foundLast = true;
+                    continue;
+                }
+                const taskTitle = plan.tasks.find((t) => t.id === note.taskId)?.title ?? note.taskId.slice(0, 8);
+                const blocking = note.blocking ? " 🟡 blocking" : "";
+                messages.push(`📝 *${truncate(taskTitle, 50)}*${blocking}\n${truncate(note.text, 300)}${note.prUrl ? `\n${note.prUrl}` : ""}`);
+                cursor.lastNoteId = note.id;
+            }
+            // If we never had a cursor, seed it to the last note so we don't blast history.
+            if (cursor.lastNoteId === null && plan.notes.length > 0) {
+                cursor.lastNoteId = plan.notes[plan.notes.length - 1].id;
+            }
+        }
+        if (messages.length === 0) {
+            // still save cursor in case statuses changed but no message produced
+            await this.saveCursor();
+            return;
+        }
+        // Save cursor BEFORE sending, to avoid resends on partial failures.
+        await this.saveCursor();
+        // Push.
+        for (const entry of this.cfg.whitelist) {
+            for (const msg of messages) {
+                try {
+                    await this.api.sendMessage(entry.chatId, msg, { parseMode: "Markdown" });
+                }
+                catch (err) {
+                    process.stderr.write(`[orqlaude tg notifier] send to ${entry.chatId} failed: ${err.message}\n`);
+                }
+            }
+        }
+    }
+}
+function truncate(s, n) {
+    if (s.length <= n)
+        return s;
+    return s.slice(0, n - 1) + "…";
+}
+//# sourceMappingURL=notifier.js.map

package/dist/telegram/notifier.js.map

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

package/dist/tools/broker.d.ts

@@ -0,0 +1,15 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StateStore } from "../lib/state.js";
+import type { AuditLog } from "../lib/audit.js";
+/**
+ * Broker tools.
+ *
+ * v0.2.0:
+ *  • `checkin` accepts an optional `task_id`. If the session is not yet
+ *    registered AND task_id matches a dispatched-but-unclaimed task, the
+ *    session self-registers. This removes the manual register_spawn step.
+ *  • New `claim_files` and `release_files` tools for cross-agent file
+ *    ownership. Conflicting claims are returned to the caller (and surfaced
+ *    to the primary Claude through the next status() call).
+ */
+export declare function registerBroker(server: McpServer, store: StateStore, audit: AuditLog): void;

package/dist/tools/broker.js

@@ -0,0 +1,245 @@
+import { z } from "zod";
+import { randomUUID } from "node:crypto";
+import { planForSession, findPlan, unclaimedTaskById, normalizeClaimPath, } from "../lib/state.js";
+/**
+ * Broker tools.
+ *
+ * v0.2.0:
+ *  • `checkin` accepts an optional `task_id`. If the session is not yet
+ *    registered AND task_id matches a dispatched-but-unclaimed task, the
+ *    session self-registers. This removes the manual register_spawn step.
+ *  • New `claim_files` and `release_files` tools for cross-agent file
+ *    ownership. Conflicting claims are returned to the caller (and surfaced
+ *    to the primary Claude through the next status() call).
+ */
+export function registerBroker(server, store, audit) {
+    // ---- checkin (child → orqlaude) ------------------------------------------
+    server.tool("checkin", "Called BY A SPAWNED AGENT. Two purposes: (1) on your FIRST turn, pass your own session_id AND task_id (from the prompt) to self-register. (2) on subsequent turns, pass only session_id to pull queued messages and check ack status. Returns messages (possibly empty), STOP signal status, and ack state of any blocking notes you posted.", {
+        session_id: z.string().describe("Your own session id. Read from $CLAUDE_CODE_SESSION_ID or the prompt."),
+        task_id: z.string().optional().describe("Pass this ONCE on your first checkin to self-register against your task. The prompt you received contains it as `task_id: ...`."),
+    }, audit.wrap("checkin", async ({ session_id, task_id }) => {
+        const result = await store.update((state) => {
+            // Already-registered session?
+            let found = planForSession(state, session_id);
+            let selfRegistered = false;
+            // First-turn self-registration path.
+            if (!found && task_id) {
+                const target = unclaimedTaskById(state, task_id);
+                if (target) {
+                    target.task.spawnedSessionId = session_id;
+                    target.task.status = "running";
+                    found = target;
+                    selfRegistered = true;
+                }
+            }
+            if (!found) {
+                return {
+                    registered: false,
+                    note: task_id
+                        ? "task_id provided but no matching unclaimed dispatched task. Either the plan moved on or another spawn claimed it."
+                        : "This session is not registered. On your first checkin, pass your task_id too (it's in the prompt under 'task_id:').",
+                    messages: [],
+                    stop_signal: null,
+                    blocking_notes_acked: [],
+                };
+            }
+            const { plan, task } = found;
+            // Deliver queued messages.
+            const pending = plan.messages.filter((m) => m.toSessionId === session_id && !m.delivered);
+            let stopSignal = null;
+            for (const m of pending) {
+                m.delivered = true;
+                m.deliveredAt = Date.now();
+                if (m.kind === "stop") {
+                    stopSignal = { reason: m.text, at: m.queuedAt };
+                }
+            }
+            // Surface STOP from task-level flag too.
+            if (!stopSignal && task.stopRequested) {
+                stopSignal = { reason: task.stopRequested.reason, at: task.stopRequested.requestedAt };
+            }
+            const myBlocking = plan.notes.filter((n) => n.fromSessionId === session_id && n.blocking);
+            return {
+                registered: true,
+                self_registered: selfRegistered,
+                plan_id: plan.id,
+                task_id: task.id,
+                task_title: task.title,
+                messages: pending
+                    .filter((m) => m.kind !== "stop")
+                    .map((m) => ({ id: m.id, text: m.text, from_task: m.fromTaskId ?? null, queued_at: m.queuedAt })),
+                stop_signal: stopSignal,
+                blocking_notes_acked: myBlocking.map((n) => ({ id: n.id, acked: n.acked })),
+                guidance: stopSignal
+                    ? "STOP received — commit what you have and exit."
+                    : selfRegistered
+                        ? "Registered with the orchestrator. Now do your task."
+                        : "Carry on.",
+            };
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }, ({ session_id }) => ({ sessionId: session_id })));
+    // ---- post_note (child → orqlaude) ----------------------------------------
+    server.tool("post_note", "Called BY A SPAWNED AGENT to share a finding or report a PR URL. Set `blocking: true` only when you must pause until the primary Claude acks. Setting `pr_url` attaches it to your task for `collect`.", {
+        session_id: z.string(),
+        text: z.string().min(1),
+        blocking: z.boolean().default(false),
+        pr_url: z.string().url().optional(),
+    }, audit.wrap("post_note", async ({ session_id, text, blocking, pr_url }) => {
+        const result = await store.update((state) => {
+            const found = planForSession(state, session_id);
+            if (!found)
+                return { posted: false, note: "Session not registered. Run checkin with task_id first." };
+            const { plan, task } = found;
+            const note = {
+                id: randomUUID(),
+                fromSessionId: session_id,
+                taskId: task.id,
+                text,
+                blocking,
+                postedAt: Date.now(),
+                acked: false,
+                prUrl: pr_url,
+            };
+            plan.notes.push(note);
+            if (pr_url)
+                task.prUrl = pr_url;
+            return {
+                posted: true,
+                note_id: note.id,
+                blocking,
+                guidance: blocking
+                    ? "Now call `checkin` periodically until your note appears in blocking_notes_acked with acked=true."
+                    : "Note queued. Continue.",
+            };
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }, ({ session_id }) => ({ sessionId: session_id })));
+    // ---- claim_files (child → orqlaude) --------------------------------------
+    server.tool("claim_files", "Called BY A SPAWNED AGENT to register intent to edit specific files. Returns existing conflicting claims by other sessions; the caller decides whether to coordinate (via post_note) or proceed anyway. Paths can be absolute or relative; relative paths are resolved against the orqlaude server's cwd (the project root).", {
+        session_id: z.string(),
+        paths: z.array(z.string().min(1)).min(1),
+        reason: z.string().optional().describe("Optional human-readable reason for the claim, surfaced to other agents."),
+    }, audit.wrap("claim_files", async ({ session_id, paths, reason }) => {
+        const result = await store.update((state) => {
+            const found = planForSession(state, session_id);
+            if (!found)
+                return { claimed: [], conflicts: [], note: "Session not registered." };
+            const { plan, task } = found;
+            const cwd = process.cwd();
+            const conflicts = [];
+            const claimed = [];
+            for (const raw of paths) {
+                const normalized = normalizeClaimPath(raw, cwd);
+                const existing = plan.claims.find((c) => c.path === normalized && c.claimedBy !== session_id);
+                if (existing) {
+                    conflicts.push({
+                        path: normalized,
+                        claimedBy: existing.claimedBy,
+                        taskId: existing.taskId,
+                        reason: existing.reason,
+                    });
+                    continue;
+                }
+                const already = plan.claims.find((c) => c.path === normalized && c.claimedBy === session_id);
+                if (!already) {
+                    plan.claims.push({
+                        path: normalized,
+                        claimedBy: session_id,
+                        taskId: task.id,
+                        reason,
+                        claimedAt: Date.now(),
+                    });
+                }
+                claimed.push(normalized);
+            }
+            return {
+                claimed,
+                conflicts,
+                guidance: conflicts.length > 0
+                    ? "Conflicts found. Consider post_note(blocking=true) to coordinate, or release_files if you don't actually need these paths."
+                    : "Claims registered. Other agents will see them.",
+            };
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }, ({ session_id }) => ({ sessionId: session_id })));
+    // ---- release_files (child → orqlaude) ------------------------------------
+    server.tool("release_files", "Called BY A SPAWNED AGENT to release file claims after finishing edits (or if you decide not to touch them).", {
+        session_id: z.string(),
+        paths: z.array(z.string().min(1)).min(1),
+    }, audit.wrap("release_files", async ({ session_id, paths }) => {
+        const result = await store.update((state) => {
+            const found = planForSession(state, session_id);
+            if (!found)
+                return { released: 0, note: "Session not registered." };
+            const { plan } = found;
+            const cwd = process.cwd();
+            const normalized = new Set(paths.map((p) => normalizeClaimPath(p, cwd)));
+            const before = plan.claims.length;
+            plan.claims = plan.claims.filter((c) => !(c.claimedBy === session_id && normalized.has(c.path)));
+            return { released: before - plan.claims.length };
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }, ({ session_id }) => ({ sessionId: session_id })));
+    // ---- poll_notes (primary Claude → orqlaude) ------------------------------
+    server.tool("poll_notes", "Called BY PRIMARY CLAUDE to read notes posted by fleet agents. Returns notes since `since_ts` (or all). Pass `mark_acked` to ack blocking notes — that unblocks the posting agent on its next checkin.", {
+        plan_id: z.string(),
+        since_ts: z.number().optional(),
+        mark_acked: z.array(z.string()).optional(),
+    }, audit.wrap("poll_notes", async ({ plan_id, since_ts, mark_acked }) => {
+        const result = await store.update((state) => {
+            const plan = findPlan(state, plan_id);
+            if (mark_acked) {
+                for (const id of mark_acked) {
+                    const n = plan.notes.find((x) => x.id === id);
+                    if (n)
+                        n.acked = true;
+                }
+            }
+            const cutoff = since_ts ?? 0;
+            const notes = plan.notes
+                .filter((n) => n.postedAt >= cutoff)
+                .map((n) => ({
+                id: n.id,
+                from_task_id: n.taskId,
+                from_session_id: n.fromSessionId,
+                text: n.text,
+                blocking: n.blocking,
+                acked: n.acked,
+                posted_at: n.postedAt,
+                pr_url: n.prUrl ?? null,
+            }));
+            return { plan_id, notes };
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }, ({ plan_id }) => ({ planId: plan_id })));
+    // ---- send_message (primary Claude → child) -------------------------------
+    server.tool("send_message", "Called BY PRIMARY CLAUDE to queue a directed message for a child agent. Delivered on its next checkin. Set `kind: 'stop'` to signal that the agent should commit-and-exit.", {
+        plan_id: z.string(),
+        to_session_id: z.string(),
+        text: z.string().min(1),
+        from_task_id: z.string().optional(),
+        kind: z.enum(["directed", "stop"]).default("directed"),
+    }, audit.wrap("send_message", async ({ plan_id, to_session_id, text, from_task_id, kind }) => {
+        const result = await store.update((state) => {
+            const plan = findPlan(state, plan_id);
+            plan.messages.push({
+                id: randomUUID(),
+                toSessionId: to_session_id,
+                fromTaskId: from_task_id,
+                text,
+                queuedAt: Date.now(),
+                delivered: false,
+                kind,
+            });
+            if (kind === "stop") {
+                const task = plan.tasks.find((t) => t.spawnedSessionId === to_session_id);
+                if (task)
+                    task.stopRequested = { reason: text, requestedAt: Date.now() };
+            }
+            return { plan_id, queued: true, kind };
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }, ({ plan_id }) => ({ planId: plan_id })));
+}
+//# sourceMappingURL=broker.js.map

package/dist/tools/broker.js.map

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

package/dist/tools/dispatch.d.ts

@@ -0,0 +1,14 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StateStore } from "../lib/state.js";
+import type { AuditLog } from "../lib/audit.js";
+/**
+ * Dispatch-phase tools: next_task, register_spawn, status, collect.
+ *
+ * v0.2.0:
+ *  • status() now includes per-agent hallucination report + token usage.
+ *  • status() flips the plan to `cancelled_overbudget` and queues STOP
+ *    broker messages when total token usage exceeds the budget cap.
+ *  • The spawn prompt embeds the task_id so children can self-register via
+ *    `checkin` on their first turn — register_spawn becomes a fallback.
+ */
+export declare function registerDispatch(server: McpServer, store: StateStore, audit: AuditLog): void;