indusagi 0.12.19 → 0.12.21

package/dist/agent/tools/teams/cleanup.js

@@ -0,0 +1,219 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { cleanupWorktrees } from "./worktree.js";
+export function assertTeamDirWithinTeamsRoot(teamsRootDir, teamDir) {
+    const teamsRootAbs = path.resolve(teamsRootDir);
+    const teamDirAbs = path.resolve(teamDir);
+    const rel = path.relative(teamsRootAbs, teamDirAbs);
+    // rel === "" => same path (would delete the whole root)
+    // rel starts with ".." or is absolute => outside root
+    if (!rel || rel === "" || rel.startsWith("..") || path.isAbsolute(rel)) {
+        throw new Error(`Refusing to operate on path outside teams root. teamsRootDir=${teamsRootAbs} teamDir=${teamDirAbs}`);
+    }
+    return { teamsRootAbs, teamDirAbs };
+}
+/**
+ * Recursively delete the given teamDir, including proper git worktree + branch removal.
+ *
+ * Steps:
+ * 1. Remove git worktrees and branches via `cleanupWorktrees`
+ * 2. Delete the team directory recursively
+ *
+ * Idempotent — safe to call multiple times.
+ */
+export async function cleanupTeamDir(teamsRootDir, teamDir, opts) {
+    const { teamDirAbs } = assertTeamDirWithinTeamsRoot(teamsRootDir, teamDir);
+    const warnings = [];
+    // Infer teamId from directory name if not provided.
+    const teamId = opts?.teamId ?? path.basename(teamDirAbs);
+    // 1. Clean up git worktrees and branches before deleting the directory.
+    let worktreeResult = { removedWorktrees: [], removedBranches: [], warnings: [] };
+    try {
+        worktreeResult = await cleanupWorktrees({ teamDir: teamDirAbs, teamId, repoCwd: opts?.repoCwd });
+        warnings.push(...worktreeResult.warnings);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        warnings.push(`Worktree cleanup failed (non-fatal): ${msg}`);
+    }
+    // 2. Delete the team directory.
+    await fs.promises.rm(teamDirAbs, { recursive: true, force: true });
+    return { teamDir: teamDirAbs, worktreeResult, warnings };
+}
+/**
+ * Garbage-collect stale team directories that have no active workers and are older
+ * than the given threshold.
+ *
+ * A team directory is considered stale when:
+ * - Its config.json `createdAt` (or directory mtime) is older than `maxAgeMs`
+ * - It has no in_progress tasks
+ * - It has no online members
+ *
+ * Returns a summary of what was cleaned up.
+ */
+export async function gcStaleTeamDirs(opts) {
+    const { teamsRootDir, maxAgeMs, repoCwd, dryRun, excludeTeamIds } = opts;
+    const teamsRootAbs = path.resolve(teamsRootDir);
+    const removed = [];
+    const skipped = [];
+    const warnings = [];
+    let entries;
+    try {
+        entries = await fs.promises.readdir(teamsRootAbs);
+    }
+    catch {
+        return { scanned: 0, removed, skipped, warnings: ["teams root directory not found"] };
+    }
+    // Filter out non-team entries (like _styles, _hooks).
+    const teamEntries = entries.filter((e) => !e.startsWith("_"));
+    const now = Date.now();
+    for (const teamId of teamEntries) {
+        if (excludeTeamIds?.has(teamId)) {
+            skipped.push({ teamId, reason: "excluded" });
+            continue;
+        }
+        const teamDir = path.join(teamsRootAbs, teamId);
+        let stat;
+        try {
+            stat = await fs.promises.stat(teamDir);
+        }
+        catch {
+            continue;
+        }
+        if (!stat.isDirectory())
+            continue;
+        // Check age: prefer config.json createdAt, fall back to directory mtime.
+        let ageMs;
+        try {
+            const configPath = path.join(teamDir, "config.json");
+            const configRaw = await fs.promises.readFile(configPath, "utf8");
+            const config = JSON.parse(configRaw);
+            const createdAt = typeof config === "object" && config !== null && "createdAt" in config
+                ? config.createdAt
+                : undefined;
+            if (typeof createdAt === "string") {
+                const ts = Date.parse(createdAt);
+                ageMs = Number.isFinite(ts) ? now - ts : now - stat.mtimeMs;
+            }
+            else {
+                ageMs = now - stat.mtimeMs;
+            }
+        }
+        catch {
+            ageMs = now - stat.mtimeMs;
+        }
+        if (ageMs < maxAgeMs) {
+            skipped.push({ teamId, reason: "too recent" });
+            continue;
+        }
+        // Check for active work: in_progress tasks, online workers, or live attach claims.
+        let hasActiveWork = false;
+        try {
+            const configPath = path.join(teamDir, "config.json");
+            const configRaw = await fs.promises.readFile(configPath, "utf8");
+            const config = JSON.parse(configRaw);
+            if (typeof config === "object" && config !== null) {
+                const members = config.members;
+                if (Array.isArray(members)) {
+                    for (const m of members) {
+                        if (typeof m !== "object" || m === null)
+                            continue;
+                        const rec = m;
+                        // Ignore the lead — it stays "online" forever and is not a signal of activity.
+                        if (rec.role === "lead")
+                            continue;
+                        if (rec.status === "online") {
+                            hasActiveWork = true;
+                            break;
+                        }
+                    }
+                }
+            }
+        }
+        catch {
+            // No config — probably safe to remove.
+        }
+        // Check for a live attach claim (another session is using this team).
+        if (!hasActiveWork) {
+            try {
+                const claimPath = path.join(teamDir, ".attach-claim.json");
+                const claimRaw = await fs.promises.readFile(claimPath, "utf8");
+                const claim = JSON.parse(claimRaw);
+                if (typeof claim === "object" && claim !== null) {
+                    const heartbeatAt = claim.heartbeatAt;
+                    if (typeof heartbeatAt === "string") {
+                        const hbTs = Date.parse(heartbeatAt);
+                        // Consider claims fresh if heartbeat is within 5 minutes.
+                        const claimFreshnessMs = 5 * 60 * 1000;
+                        if (Number.isFinite(hbTs) && now - hbTs < claimFreshnessMs) {
+                            hasActiveWork = true;
+                        }
+                    }
+                }
+            }
+            catch {
+                // No claim file or invalid — not actively attached.
+            }
+        }
+        if (!hasActiveWork) {
+            // Check task files for in_progress tasks.
+            // Tasks live at tasks/<taskListId>/<id>.json — scan all subdirectories.
+            try {
+                const tasksDir = path.join(teamDir, "tasks");
+                const taskListDirs = await fs.promises.readdir(tasksDir);
+                for (const listDir of taskListDirs) {
+                    if (hasActiveWork)
+                        break;
+                    const listPath = path.join(tasksDir, listDir);
+                    let listStat;
+                    try {
+                        listStat = await fs.promises.stat(listPath);
+                    }
+                    catch {
+                        continue;
+                    }
+                    if (!listStat.isDirectory())
+                        continue;
+                    const taskFiles = await fs.promises.readdir(listPath);
+                    for (const tf of taskFiles) {
+                        if (!tf.endsWith(".json"))
+                            continue;
+                        try {
+                            const raw = await fs.promises.readFile(path.join(listPath, tf), "utf8");
+                            const parsed = JSON.parse(raw);
+                            if (typeof parsed === "object" && parsed !== null && parsed.status === "in_progress") {
+                                hasActiveWork = true;
+                                break;
+                            }
+                        }
+                        catch {
+                            // ignore individual task read errors
+                        }
+                    }
+                }
+            }
+            catch {
+                // No tasks dir — fine.
+            }
+        }
+        if (hasActiveWork) {
+            skipped.push({ teamId, reason: "has active work" });
+            continue;
+        }
+        if (dryRun) {
+            removed.push(teamId);
+            continue;
+        }
+        try {
+            const result = await cleanupTeamDir(teamsRootAbs, teamDir, { teamId, repoCwd });
+            warnings.push(...result.warnings);
+            removed.push(teamId);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            warnings.push(`Failed to remove ${teamId}: ${msg}`);
+        }
+    }
+    return { scanned: teamEntries.length, removed, skipped, warnings };
+}
+//# sourceMappingURL=cleanup.js.map

package/dist/agent/tools/teams/cleanup.js.map

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

package/dist/agent/tools/teams/fs-lock.d.ts

@@ -0,0 +1,12 @@
+export interface LockOptions {
+    /** How long to wait to acquire the lock before failing. */
+    timeoutMs?: number;
+    /** If lock file is older than this, consider it stale and remove it. */
+    staleMs?: number;
+    /** Poll interval while waiting for lock. */
+    pollMs?: number;
+    /** Optional label to help debugging (written into lock file). */
+    label?: string;
+}
+export declare function withLock<T>(lockFilePath: string, fn: () => Promise<T>, opts?: LockOptions): Promise<T>;
+//# sourceMappingURL=fs-lock.d.ts.map

package/dist/agent/tools/teams/fs-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-lock.d.ts","sourceRoot":"","sources":["../../../../src/agent/tools/teams/fs-lock.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,WAAW;IAC3B,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,CAAC,CAiEhH"}

package/dist/agent/tools/teams/fs-lock.js

@@ -0,0 +1,74 @@
+import * as fs from "node:fs";
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+function isErrnoException(err) {
+    return typeof err === "object" && err !== null && "code" in err;
+}
+export async function withLock(lockFilePath, fn, opts = {}) {
+    const timeoutMs = opts.timeoutMs ?? 10_000;
+    const staleMs = opts.staleMs ?? 60_000;
+    const basePollMs = opts.pollMs ?? 50;
+    const maxPollMs = Math.max(basePollMs, 1_000);
+    const start = Date.now();
+    let fd = null;
+    let attempt = 0;
+    while (fd === null) {
+        try {
+            fd = fs.openSync(lockFilePath, "wx");
+            const payload = {
+                pid: process.pid,
+                createdAt: new Date().toISOString(),
+                label: opts.label,
+            };
+            fs.writeFileSync(fd, JSON.stringify(payload));
+        }
+        catch (err) {
+            if (!isErrnoException(err) || err.code !== "EEXIST")
+                throw err;
+            // Stale lock handling
+            try {
+                const st = fs.statSync(lockFilePath);
+                const age = Date.now() - st.mtimeMs;
+                if (age > staleMs) {
+                    fs.unlinkSync(lockFilePath);
+                    attempt = 0;
+                    continue;
+                }
+            }
+            catch {
+                // ignore: stat/unlink failures fall through to wait
+            }
+            const elapsedMs = Date.now() - start;
+            if (elapsedMs > timeoutMs) {
+                throw new Error(`Timeout acquiring lock: ${lockFilePath}`);
+            }
+            attempt += 1;
+            const expBackoff = Math.min(maxPollMs, basePollMs * 2 ** Math.min(attempt, 6));
+            const jitterFactor = 0.5 + Math.random(); // [0.5, 1.5)
+            const jitteredBackoff = Math.min(maxPollMs, Math.round(expBackoff * jitterFactor));
+            const remainingMs = timeoutMs - elapsedMs;
+            const sleepMs = Math.max(1, Math.min(remainingMs, jitteredBackoff));
+            await sleep(sleepMs);
+        }
+    }
+    try {
+        return await fn();
+    }
+    finally {
+        try {
+            if (fd !== null)
+                fs.closeSync(fd);
+        }
+        catch {
+            // ignore
+        }
+        try {
+            fs.unlinkSync(lockFilePath);
+        }
+        catch {
+            // ignore
+        }
+    }
+}
+//# sourceMappingURL=fs-lock.js.map

package/dist/agent/tools/teams/fs-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-lock.js","sourceRoot":"","sources":["../../../../src/agent/tools/teams/fs-lock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B,SAAS,KAAK,CAAC,EAAU;IACxB,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAY;IACrC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,MAAM,IAAI,GAAG,CAAC;AACjE,CAAC;AAaD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAI,YAAoB,EAAE,EAAoB,EAAE,OAAoB,EAAE;IACnG,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC;IACvC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;IACrC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEzB,IAAI,EAAE,GAAkB,IAAI,CAAC;IAC7B,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;QACpB,IAAI,CAAC;YACJ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;YACrC,MAAM,OAAO,GAAG;gBACf,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,KAAK,EAAE,IAAI,CAAC,KAAK;aACjB,CAAC;YACF,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACvB,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,GAAG,CAAC;YAE/D,sBAAsB;YACtB,IAAI,CAAC;gBACJ,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;gBACrC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC;gBACpC,IAAI,GAAG,GAAG,OAAO,EAAE,CAAC;oBACnB,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;oBAC5B,OAAO,GAAG,CAAC,CAAC;oBACZ,SAAS;gBACV,CAAC;YACF,CAAC;YAAC,MAAM,CAAC;gBACR,oDAAoD;YACrD,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YACrC,IAAI,SAAS,GAAG,SAAS,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,2BAA2B,YAAY,EAAE,CAAC,CAAC;YAC5D,CAAC;YAED,OAAO,IAAI,CAAC,CAAC;YACb,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/E,MAAM,YAAY,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,aAAa;YACvD,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,YAAY,CAAC,CAAC,CAAC;YAEnF,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;YAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC,CAAC;YACpE,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;IACF,CAAC;IAED,IAAI,CAAC;QACJ,OAAO,MAAM,EAAE,EAAE,CAAC;IACnB,CAAC;YAAS,CAAC;QACV,IAAI,CAAC;YACJ,IAAI,EAAE,KAAK,IAAI;gBAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACR,SAAS;QACV,CAAC;QACD,IAAI,CAAC;YACJ,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACR,SAAS;QACV,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/agent/tools/teams/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./activity-tracker.js";
+export * from "./cleanup.js";
+export * from "./fs-lock.js";
+export * from "./mailbox.js";
+export * from "./model-policy.js";
+export * from "./names.js";
+export * from "./protocol.js";
+export * from "./task-store.js";
+export * from "./team-attach-claim.js";
+export * from "./team-config.js";
+export * from "./worktree.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/tools/teams/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/agent/tools/teams/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}

package/dist/agent/tools/teams/index.js

@@ -0,0 +1,12 @@
+export * from "./activity-tracker.js";
+export * from "./cleanup.js";
+export * from "./fs-lock.js";
+export * from "./mailbox.js";
+export * from "./model-policy.js";
+export * from "./names.js";
+export * from "./protocol.js";
+export * from "./task-store.js";
+export * from "./team-attach-claim.js";
+export * from "./team-config.js";
+export * from "./worktree.js";
+//# sourceMappingURL=index.js.map

package/dist/agent/tools/teams/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/agent/tools/teams/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}

package/dist/agent/tools/teams/mailbox.d.ts

@@ -0,0 +1,21 @@
+export interface MailboxMessage {
+    from: string;
+    text: string;
+    timestamp: string;
+    read: boolean;
+    color?: string;
+    /** When true, the recipient should deliver this message as a steering interrupt
+     *  even if the agent is mid-turn, rather than queueing for the next idle window. */
+    urgent?: boolean;
+}
+export declare function getInboxPath(teamDir: string, namespace: string, agentName: string): string;
+/** Append a message to an agent's inbox. */
+export declare function writeToMailbox(teamDir: string, namespace: string, recipient: string, msg: Omit<MailboxMessage, "read"> & {
+    read?: boolean;
+}): Promise<void>;
+/**
+ * Read unread messages and mark them as read in a single locked transaction.
+ * This is the worker/leader poll primitive.
+ */
+export declare function popUnreadMessages(teamDir: string, namespace: string, agentName: string): Promise<MailboxMessage[]>;
+//# sourceMappingURL=mailbox.d.ts.map

package/dist/agent/tools/teams/mailbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox.d.ts","sourceRoot":"","sources":["../../../../src/agent/tools/teams/mailbox.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;wFACoF;IACpF,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAMD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1F;AA0CD,4CAA4C;AAC5C,wBAAsB,cAAc,CACnC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GACpD,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAoCxH"}

package/dist/agent/tools/teams/mailbox.js

@@ -0,0 +1,106 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { withLock } from "./fs-lock.js";
+import { sanitizeName } from "./names.js";
+function inboxDir(teamDir, namespace) {
+    return path.join(teamDir, "mailboxes", sanitizeName(namespace), "inboxes");
+}
+export function getInboxPath(teamDir, namespace, agentName) {
+    return path.join(inboxDir(teamDir, namespace), `${sanitizeName(agentName)}.json`);
+}
+async function ensureDir(p) {
+    await fs.promises.mkdir(p, { recursive: true });
+}
+function isRecord(v) {
+    return typeof v === "object" && v !== null;
+}
+function isLockTimeoutError(err) {
+    return err instanceof Error && err.message.startsWith("Timeout acquiring lock:");
+}
+function coerceMailboxMessage(v) {
+    if (!isRecord(v))
+        return null;
+    if (typeof v.from !== "string")
+        return null;
+    if (typeof v.text !== "string")
+        return null;
+    if (typeof v.timestamp !== "string")
+        return null;
+    const read = typeof v.read === "boolean" ? v.read : false;
+    const color = typeof v.color === "string" ? v.color : undefined;
+    const urgent = typeof v.urgent === "boolean" ? v.urgent : undefined;
+    return { from: v.from, text: v.text, timestamp: v.timestamp, read, color, urgent };
+}
+async function readJsonArray(file) {
+    try {
+        const raw = await fs.promises.readFile(file, "utf8");
+        const parsed = JSON.parse(raw);
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
+async function writeJsonAtomic(file, data) {
+    await ensureDir(path.dirname(file));
+    const tmp = `${file}.tmp.${process.pid}.${Date.now()}`;
+    await fs.promises.writeFile(tmp, JSON.stringify(data, null, 2) + "\n", "utf8");
+    await fs.promises.rename(tmp, file);
+}
+/** Append a message to an agent's inbox. */
+export async function writeToMailbox(teamDir, namespace, recipient, msg) {
+    const inboxPath = getInboxPath(teamDir, namespace, recipient);
+    const lockPath = `${inboxPath}.lock`;
+    await ensureDir(path.dirname(inboxPath));
+    await withLock(lockPath, async () => {
+        const arr = await readJsonArray(inboxPath);
+        const m = {
+            from: msg.from,
+            text: msg.text,
+            timestamp: msg.timestamp,
+            read: msg.read ?? false,
+            color: msg.color,
+            ...(msg.urgent === true ? { urgent: true } : {}),
+        };
+        arr.push(m);
+        await writeJsonAtomic(inboxPath, arr);
+    }, { label: `mailbox:write:${namespace}:${recipient}` });
+}
+/**
+ * Read unread messages and mark them as read in a single locked transaction.
+ * This is the worker/leader poll primitive.
+ */
+export async function popUnreadMessages(teamDir, namespace, agentName) {
+    const inboxPath = getInboxPath(teamDir, namespace, agentName);
+    const lockPath = `${inboxPath}.lock`;
+    await ensureDir(path.dirname(inboxPath));
+    try {
+        return await withLock(lockPath, async () => {
+            const arr = (await readJsonArray(inboxPath))
+                .map(coerceMailboxMessage)
+                .filter((m) => m !== null);
+            if (arr.length === 0)
+                return [];
+            const unread = [];
+            const updated = arr.map((m) => {
+                if (!m.read) {
+                    const next = { ...m, read: true };
+                    unread.push(next);
+                    return next;
+                }
+                return m;
+            });
+            if (unread.length)
+                await writeJsonAtomic(inboxPath, updated);
+            return unread;
+        }, { label: `mailbox:pop:${namespace}:${agentName}` });
+    }
+    catch (err) {
+        // In practice this can happen if a previous process crashed and left a non-stale
+        // lockfile behind. Treat as transient and try again on the next poll tick.
+        if (isLockTimeoutError(err))
+            return [];
+        throw err;
+    }
+}
+//# sourceMappingURL=mailbox.js.map

package/dist/agent/tools/teams/mailbox.js.map

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

package/dist/agent/tools/teams/model-policy.d.ts

@@ -0,0 +1,23 @@
+export declare function isDeprecatedTeammateModelId(modelId: string): boolean;
+export type TeammateModelSource = "override" | "inherit_leader" | "default";
+export interface ResolvedTeammateModel {
+    source: TeammateModelSource;
+    provider?: string;
+    modelId?: string;
+    warnings: string[];
+}
+export type ResolveTeammateModelResult = {
+    ok: true;
+    value: ResolvedTeammateModel;
+} | {
+    ok: false;
+    error: string;
+    reason: "invalid_override" | "deprecated_override";
+};
+export declare function formatProviderModel(provider: string | undefined, modelId: string | undefined): string | null;
+export declare function resolveTeammateModelSelection(input: {
+    modelOverride?: string;
+    leaderProvider?: string;
+    leaderModelId?: string;
+}): ResolveTeammateModelResult;
+//# sourceMappingURL=model-policy.d.ts.map

package/dist/agent/tools/teams/model-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-policy.d.ts","sourceRoot":"","sources":["../../../../src/agent/tools/teams/model-policy.ts"],"names":[],"mappings":"AAoBA,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAUpE;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,gBAAgB,GAAG,SAAS,CAAC;AAE5E,MAAM,WAAW,qBAAqB;IACrC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,MAAM,0BAA0B,GACnC;IACA,EAAE,EAAE,IAAI,CAAC;IACT,KAAK,EAAE,qBAAqB,CAAC;CAC5B,GACD;IACA,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,kBAAkB,GAAG,qBAAqB,CAAC;CAClD,CAAC;AAEL,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAG5G;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,0BAA0B,CAgF7B"}

package/dist/agent/tools/teams/model-policy.js

@@ -0,0 +1,113 @@
+const SONNET4_DEPRECATED_MARKER = "claude-sonnet-4";
+const SONNET45_ALLOWED_MARKERS = ["claude-sonnet-4-5", "claude-sonnet-4.5"];
+function normalizeModelId(modelId) {
+    return modelId.trim().toLowerCase();
+}
+function hasAnyMarker(value, markers) {
+    for (const marker of markers) {
+        if (value.includes(marker))
+            return true;
+    }
+    return false;
+}
+function trimOrUndefined(value) {
+    if (value === undefined)
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+export function isDeprecatedTeammateModelId(modelId) {
+    const normalized = normalizeModelId(modelId);
+    if (!normalized)
+        return false;
+    if (!normalized.includes(SONNET4_DEPRECATED_MARKER))
+        return false;
+    if (hasAnyMarker(normalized, SONNET45_ALLOWED_MARKERS))
+        return false;
+    const idx = normalized.indexOf(SONNET4_DEPRECATED_MARKER);
+    const next = normalized.at(idx + SONNET4_DEPRECATED_MARKER.length);
+    if (!next)
+        return true;
+    return next === "-" || next === "_" || next === "." || next === ":";
+}
+export function formatProviderModel(provider, modelId) {
+    if (!modelId)
+        return null;
+    return provider ? `${provider}/${modelId}` : modelId;
+}
+export function resolveTeammateModelSelection(input) {
+    const override = trimOrUndefined(input.modelOverride);
+    if (override) {
+        const slashIdx = override.indexOf("/");
+        if (slashIdx >= 0) {
+            const provider = override.slice(0, slashIdx).trim();
+            const id = override.slice(slashIdx + 1).trim();
+            if (!provider || !id) {
+                return {
+                    ok: false,
+                    reason: "invalid_override",
+                    error: `Invalid model override '${override}'. Expected <provider>/<modelId>.`,
+                };
+            }
+            if (isDeprecatedTeammateModelId(id)) {
+                return {
+                    ok: false,
+                    reason: "deprecated_override",
+                    error: `Model override '${override}' is deprecated. Choose a current model id.`,
+                };
+            }
+            return {
+                ok: true,
+                value: {
+                    source: "override",
+                    provider,
+                    modelId: id,
+                    warnings: [],
+                },
+            };
+        }
+        if (isDeprecatedTeammateModelId(override)) {
+            return {
+                ok: false,
+                reason: "deprecated_override",
+                error: `Model override '${override}' is deprecated. Choose a current model id.`,
+            };
+        }
+        const leaderProvider = trimOrUndefined(input.leaderProvider);
+        const warnings = [];
+        if (!leaderProvider) {
+            warnings.push(`Model override '${override}' provided without a provider. ` +
+                `Teammate will use its default provider; use <provider>/<modelId> to force one.`);
+        }
+        return {
+            ok: true,
+            value: {
+                source: "override",
+                provider: leaderProvider,
+                modelId: override,
+                warnings,
+            },
+        };
+    }
+    const leaderModelId = trimOrUndefined(input.leaderModelId);
+    const leaderProvider = trimOrUndefined(input.leaderProvider);
+    if (leaderModelId && !isDeprecatedTeammateModelId(leaderModelId)) {
+        return {
+            ok: true,
+            value: {
+                source: "inherit_leader",
+                provider: leaderProvider,
+                modelId: leaderModelId,
+                warnings: [],
+            },
+        };
+    }
+    return {
+        ok: true,
+        value: {
+            source: "default",
+            warnings: [],
+        },
+    };
+}
+//# sourceMappingURL=model-policy.js.map