@songsid/agend 2.1.12-beta.6 → 2.1.12-beta.8

package/dist/profile-control.js

@@ -0,0 +1,308 @@
+import { createServer, createConnection } from "node:net";
+import { constants } from "node:fs";
+import { lstat, mkdir, open, chmod, unlink } from "node:fs/promises";
+import { join } from "node:path";
+import { performance } from "node:perf_hooks";
+import { cpuProfileSeconds, CPU_PROFILE_ENV } from "./cpu-profile.js";
+import { UNIX_SOCKET_PATH_MAX } from "./channel/ipc-bridge.js";
+import { ProfileBusyError, profileDuration } from "./runtime-cpu-profile.js";
+const INPUT_BYTES = 256;
+export const profileSocketPath = (dataDir) => join(dataDir, "operator", "profile.sock");
+function uid() {
+    if (!process.getuid)
+        throw new Error("Local CPU profile control requires Unix user permissions.");
+    return process.getuid();
+}
+async function checkRoot(dataDir) {
+    const root = await lstat(dataDir);
+    if (!root.isDirectory() || root.isSymbolicLink() || root.uid !== uid() || (root.mode & 0o022)) {
+        throw new Error("Profile control requires an owned real AGEND_HOME without group/other write permission.");
+    }
+}
+async function checkClientPath(dataDir) {
+    await checkRoot(dataDir);
+    const directory = await lstat(join(dataDir, "operator"));
+    const socket = await lstat(profileSocketPath(dataDir));
+    if (!directory.isDirectory() || directory.isSymbolicLink() || directory.uid !== uid() || (directory.mode & 0o077)
+        || !socket.isSocket() || socket.uid !== uid() || (socket.mode & 0o077)) {
+        throw new Error("Profile control is not a private socket owned by this user.");
+    }
+}
+/** Operator-only Unix socket; never attached to daemon/MCP IPC or any HTTP listener. */
+export class ProfileControlServer {
+    dataDir;
+    profiler;
+    server = null;
+    clients = new Set();
+    closed = false;
+    inode = null;
+    closing = null;
+    constructor(dataDir, profiler) {
+        this.dataDir = dataDir;
+        this.profiler = profiler;
+    }
+    async listen() {
+        const deadline = performance.now() + 2000;
+        let timer;
+        try {
+            await Promise.race([this.bind(deadline).catch(async (err) => { if (this.closed)
+                    await this.removeOwnedSocket(); throw err; }), new Promise((_yes, no) => {
+                    timer = setTimeout(() => { this.closed = true; no(new Error("Profile socket startup timed out")); }, 2000);
+                })]);
+        }
+        catch (err) {
+            await this.close();
+            throw err;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async bind(deadline) {
+        const current = () => {
+            if (this.closed || performance.now() >= deadline)
+                throw new Error("Profile socket startup expired.");
+        };
+        const path = profileSocketPath(this.dataDir);
+        if (Buffer.byteLength(path) >= UNIX_SOCKET_PATH_MAX)
+            throw new Error("Profile socket path exceeds the Unix socket limit.");
+        await checkRoot(this.dataDir);
+        current();
+        const directory = join(this.dataDir, "operator");
+        await mkdir(directory, { mode: 0o700 }).catch(err => { if (err.code !== "EEXIST")
+            throw err; });
+        current();
+        const dir = await open(directory, constants.O_RDONLY | constants.O_DIRECTORY | constants.O_NOFOLLOW);
+        try {
+            current();
+            const info = await dir.stat();
+            current();
+            if (!info.isDirectory() || info.uid !== uid())
+                throw new Error("Profile operator directory is not owned by this user.");
+            await dir.chmod(0o700);
+            current(); // same fd checked and changed, never follow a replaced symlink
+        }
+        finally {
+            await dir.close();
+        }
+        current();
+        const existing = await lstat(path).catch(err => { if (err.code !== "ENOENT")
+            throw err; return null; });
+        current();
+        if (existing) {
+            if (!existing.isSocket() || existing.uid !== uid())
+                throw new Error("Refusing to replace a non-owned/non-socket profile path.");
+            await unlink(path);
+            current(); // only called after the fleet singleton has been claimed
+        }
+        const server = createServer(socket => this.accept(socket));
+        this.server = server;
+        server.on("error", () => { void this.close(); });
+        await new Promise((yes, no) => {
+            server.once("error", no);
+            server.listen(path, () => {
+                server.removeListener("error", no);
+                if (this.closed || performance.now() >= deadline) {
+                    // A late native listen completion must not reopen an expired listener.
+                    server.close();
+                    no(new Error("Profile socket startup expired."));
+                }
+                else
+                    yes();
+            });
+        });
+        // The 0700 parent already gates access while these asynchronous checks run.
+        const info = await lstat(path);
+        this.inode = info.ino;
+        current();
+        await chmod(path, 0o600);
+        current();
+        if (this.closed)
+            await this.removeOwnedSocket();
+    }
+    accept(socket) {
+        if (this.closed || this.clients.size >= 8) {
+            socket.destroy();
+            return;
+        }
+        this.clients.add(socket);
+        let buffer = "", bytes = 0, handled = false;
+        let timer;
+        const write = (value) => {
+            try {
+                if (!socket.destroyed)
+                    socket.write(JSON.stringify(value) + "\n");
+            }
+            catch {
+                socket.destroy();
+            }
+        };
+        const expireAt = (deadline) => {
+            clearTimeout(timer);
+            const check = () => {
+                const remaining = deadline - performance.now();
+                if (remaining > 0)
+                    timer = setTimeout(check, Math.ceil(remaining));
+                else
+                    socket.destroy();
+            };
+            timer = setTimeout(check, Math.max(0, Math.ceil(deadline - performance.now())));
+        };
+        const inputDeadline = performance.now() + 2000;
+        expireAt(inputDeadline);
+        socket.on("close", () => { clearTimeout(timer); this.clients.delete(socket); });
+        socket.on("error", () => socket.destroy());
+        socket.on("data", (data) => {
+            if (handled || this.closed || socket.destroyed)
+                return;
+            if (performance.now() >= inputDeadline) {
+                socket.destroy();
+                return;
+            }
+            bytes += data.length;
+            if (bytes > INPUT_BYTES) {
+                socket.destroy();
+                return;
+            }
+            buffer += data.toString("utf8");
+            if (!buffer.includes("\n"))
+                return;
+            handled = true;
+            void (async () => {
+                try {
+                    const request = JSON.parse(buffer.slice(0, buffer.indexOf("\n")));
+                    if (!request || typeof request !== "object" || Object.keys(request).length !== 1
+                        || !Object.hasOwn(request, "seconds") || typeof request.seconds !== "number")
+                        throw new Error("Invalid profile request.");
+                    const seconds = profileDuration(request.seconds);
+                    expireAt(performance.now() + seconds * 1000 + 15_000);
+                    const ticket = await this.profiler.start(seconds);
+                    write({ status: "recording", seconds });
+                    write({ status: "saved", ...await ticket.done });
+                }
+                catch (err) {
+                    write({ status: "error", message: String(err), ...(err instanceof ProfileBusyError ? { remainingSeconds: err.remainingSeconds } : {}) });
+                }
+                finally {
+                    clearTimeout(timer);
+                    try {
+                        socket.end();
+                    }
+                    catch {
+                        socket.destroy();
+                    }
+                }
+            })();
+        });
+    }
+    close() {
+        this.closed = true;
+        for (const socket of this.clients)
+            socket.destroy();
+        this.clients.clear();
+        this.closing ??= (async () => {
+            const server = this.server;
+            this.server = null;
+            let timer;
+            try {
+                if (server)
+                    await Promise.race([
+                        new Promise(resolve => server.close(() => resolve())),
+                        new Promise(resolve => { timer = setTimeout(resolve, 2000); }),
+                    ]);
+            }
+            finally {
+                clearTimeout(timer);
+            }
+            await this.removeOwnedSocket();
+        })();
+        return this.closing;
+    }
+    async removeOwnedSocket() {
+        if (this.inode !== null) {
+            const info = await lstat(profileSocketPath(this.dataDir)).catch(() => null);
+            if (info?.isSocket() && info.ino === this.inode && info.uid === uid())
+                await unlink(profileSocketPath(this.dataDir)).catch(() => { });
+        }
+    }
+}
+/** No fleet construction or fallback startup. Refuse agent env before filesystem/socket effects. */
+export async function requestCpuProfile(dataDir, value, env = process.env) {
+    const seconds = cpuProfileSeconds({ ...env, [CPU_PROFILE_ENV]: String(value ?? 60) });
+    try {
+        await checkClientPath(dataDir);
+    }
+    catch (err) {
+        throw new Error(`Running fleet profile control unavailable: ${String(err)}`);
+    }
+    const deadline = performance.now() + seconds * 1000 + 20_000;
+    return new Promise((resolve, reject) => {
+        const socket = createConnection(profileSocketPath(dataDir));
+        let buffer = "", bytes = 0, settled = false;
+        let timer;
+        const finish = (err, result) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            socket.destroy();
+            if (err)
+                reject(err);
+            else
+                resolve(result);
+        };
+        const check = () => {
+            const remaining = deadline - performance.now();
+            if (remaining > 0)
+                timer = setTimeout(check, Math.ceil(remaining));
+            else
+                finish(new Error("CPU profile request timed out; the fleet may still save its capture."));
+        };
+        timer = setTimeout(check, seconds * 1000 + 20_000);
+        socket.once("connect", () => {
+            if (settled || performance.now() >= deadline) {
+                finish(new Error("CPU profile connection arrived after its deadline."));
+                return;
+            }
+            try {
+                socket.write(JSON.stringify({ seconds }) + "\n");
+            }
+            catch (err) {
+                finish(err);
+            }
+        });
+        socket.on("error", err => finish(new Error(`Running fleet profile control unavailable: ${err.message}`)));
+        socket.on("close", () => finish(new Error("Fleet disconnected before the CPU profile result.")));
+        socket.on("data", (data) => {
+            bytes += data.length;
+            if (bytes > 8192) {
+                finish(new Error("Invalid CPU profile response."));
+                return;
+            }
+            buffer += data.toString("utf8");
+            while (buffer.includes("\n") && !settled) {
+                const end = buffer.indexOf("\n"), line = buffer.slice(0, end);
+                buffer = buffer.slice(end + 1);
+                try {
+                    const result = JSON.parse(line);
+                    if (performance.now() >= deadline) {
+                        finish(new Error("CPU profile response arrived after its deadline."));
+                        return;
+                    }
+                    if (result.status === "error") {
+                        finish(typeof result.remainingSeconds === "number" ? new ProfileBusyError(result.remainingSeconds) : new Error(String(result.message)));
+                    }
+                    else if (result.status === "saved" && typeof result.path === "string" && (result.bytes === null || typeof result.bytes === "number")) {
+                        finish(null, { path: result.path, bytes: result.bytes });
+                    }
+                    else if (result.status !== "recording")
+                        finish(new Error("Invalid CPU profile response."));
+                }
+                catch (err) {
+                    finish(err);
+                }
+            }
+        });
+    });
+}
+//# sourceMappingURL=profile-control.js.map

package/dist/profile-control.js.map

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

package/dist/runtime-cpu-profile.d.ts

@@ -0,0 +1,37 @@
+import { startCpuProfileFromEnvironment, type CpuProfile } from "./cpu-profile.js";
+export interface ProfileResult {
+    path: string;
+    bytes: number | null;
+}
+export interface ProfileTicket {
+    seconds: number;
+    done: Promise<ProfileResult>;
+}
+interface Logger {
+    info(message: string): void;
+    warn(message: string): void;
+}
+type Starter = typeof startCpuProfileFromEnvironment;
+export declare class ProfileBusyError extends Error {
+    readonly remainingSeconds: number;
+    constructor(remainingSeconds: number);
+}
+export declare function profileDuration(value?: string | number): number;
+/** One owner for startup-env, local operator and General recordings. No effect until start. */
+export declare class RuntimeCpuProfiler {
+    private readonly options;
+    private active;
+    private closing;
+    constructor(options: {
+        dataDir: string;
+        logger: Logger;
+        start?: Starter;
+    });
+    get closed(): boolean;
+    start(value?: string | number): Promise<ProfileTicket>;
+    startFromEnvironment(env?: NodeJS.ProcessEnv): Promise<CpuProfile | null>;
+    /** Fence new starts synchronously, including requests racing a pending native start. */
+    shutdown(reason?: string): Promise<string | null>;
+    private finish;
+}
+export {};

package/dist/runtime-cpu-profile.js

@@ -0,0 +1,123 @@
+import { performance } from "node:perf_hooks";
+import { stat } from "node:fs/promises";
+import { CPU_PROFILE_ENV, cpuProfileSeconds, startCpuProfileFromEnvironment } from "./cpu-profile.js";
+export class ProfileBusyError extends Error {
+    remainingSeconds;
+    constructor(remainingSeconds) {
+        super(`A CPU profile is already recording or finishing (${remainingSeconds}s remaining).`);
+        this.remainingSeconds = remainingSeconds;
+    }
+}
+export function profileDuration(value) {
+    return cpuProfileSeconds({ [CPU_PROFILE_ENV]: String(value ?? 60) });
+}
+/** One owner for startup-env, local operator and General recordings. No effect until start. */
+export class RuntimeCpuProfiler {
+    options;
+    active = null;
+    closing = false;
+    constructor(options) {
+        this.options = options;
+    }
+    get closed() { return this.closing; }
+    async start(value) {
+        const seconds = profileDuration(value);
+        if (this.closing)
+            throw new Error("Fleet is stopping; CPU profiling is unavailable.");
+        if (this.active)
+            throw new ProfileBusyError(Math.max(0, Math.ceil((this.active.deadline - performance.now()) / 1000)));
+        let resolve, reject;
+        const done = new Promise((yes, no) => { resolve = yes; reject = no; });
+        // Startup can fail before a caller gets a ticket; still let ticket holders observe rejection.
+        void done.catch(() => { });
+        const recording = { deadline: performance.now() + seconds * 1000, startup: Promise.resolve(null), done, resolve, reject };
+        this.active = recording; // reserve before the first await / native startup
+        recording.startup = Promise.resolve().then(() => (this.options.start ?? startCpuProfileFromEnvironment)({
+            dataDir: this.options.dataDir, logger: this.options.logger, env: { [CPU_PROFILE_ENV]: String(seconds) },
+        }));
+        try {
+            const handle = await recording.startup;
+            if (!handle)
+                throw new Error("CPU profiler could not start; see daemon.log.");
+            if (this.closing || this.active !== recording) {
+                await this.finish(recording, "startup superseded by shutdown");
+                throw new Error("Fleet stopped during CPU profile startup.");
+            }
+            const expire = () => {
+                if (this.active !== recording || recording.finishing)
+                    return;
+                const remaining = recording.deadline - performance.now();
+                if (remaining > 0) {
+                    recording.timer = setTimeout(expire, Math.ceil(remaining));
+                    recording.timer.unref?.();
+                }
+                else
+                    void this.finish(recording, "duration cap");
+            };
+            recording.timer = setTimeout(expire, Math.max(0, Math.ceil(recording.deadline - performance.now())));
+            recording.timer.unref?.();
+            return { seconds, done };
+        }
+        catch (err) {
+            await this.finish(recording, "startup failed");
+            throw err;
+        }
+    }
+    async startFromEnvironment(env = process.env) {
+        try {
+            const seconds = cpuProfileSeconds(env);
+            if (seconds === null)
+                return null;
+            await this.start(seconds);
+            return { stop: reason => this.shutdown(reason) };
+        }
+        catch (err) {
+            this.options.logger.warn(String(err));
+            return null;
+        }
+    }
+    /** Fence new starts synchronously, including requests racing a pending native start. */
+    shutdown(reason = "fleet shutdown") {
+        this.closing = true;
+        const current = this.active;
+        if (!current)
+            return Promise.resolve(null);
+        void this.finish(current, reason);
+        return current.done.then(result => result.path, () => null);
+    }
+    finish(recording, reason) {
+        recording.finishing ??= (async () => {
+            clearTimeout(recording.timer);
+            try {
+                const handle = await recording.startup;
+                const path = await handle?.stop(reason);
+                if (!path)
+                    throw new Error("CPU profile was not saved; see daemon.log.");
+                let bytes = null;
+                const deadline = performance.now() + 2000;
+                let timer;
+                try {
+                    const info = await Promise.race([stat(path), new Promise((_yes, no) => {
+                            timer = setTimeout(() => no(new Error("Profile size lookup timed out")), 2000);
+                        })]);
+                    if (performance.now() < deadline && info.isFile())
+                        bytes = info.size;
+                }
+                catch { /* a saved path remains useful if its size cannot be read */ }
+                finally {
+                    clearTimeout(timer);
+                }
+                recording.resolve({ path, bytes });
+            }
+            catch (err) {
+                recording.reject(err instanceof Error ? err : new Error(String(err)));
+            }
+            finally {
+                if (this.active === recording)
+                    this.active = null;
+            }
+        })();
+        return recording.finishing;
+    }
+}
+//# sourceMappingURL=runtime-cpu-profile.js.map

package/dist/runtime-cpu-profile.js.map

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

package/dist/scheduler/db.d.ts

@@ -1,4 +1,4 @@
-import type { Schedule, ScheduleRun, CreateScheduleParams, UpdateScheduleParams, Decision, CreateDecisionParams, UpdateDecisionParams, Task, CreateTaskParams, UpdateTaskParams } from "./types.js";
+import type { Schedule, ScheduleRun, CreateScheduleParams, UpdateScheduleParams, Decision, CreateDecisionParams, UpdateDecisionParams, Task, TaskCompact, ListTasksOpts, CreateTaskParams, UpdateTaskParams } from "./types.js";
 export declare class SchedulerDb {
     private db;
     constructor(dbPath: string);
@@ -20,6 +20,15 @@ export declare class SchedulerDb {
     recordRun(scheduleId: string, status: string, detail?: string): void;
     getRuns(scheduleId: string, limit?: number): ScheduleRun[];
     pruneOldRuns(days?: number): void;
+    /**
+     * #1335: Prune done/cancelled tasks older than `days`. Open, claimed and
+     * blocked tasks are never pruned regardless of age.
+     * Cancelled tasks that appear in a live task's `depends_on` are also kept:
+     * pruning a cancelled dep would silently un-block a task whose prerequisite
+     * was explicitly cancelled (claimTask treats a missing dep as satisfied).
+     * Runs in async chunks of 500 rows with setImmediate yields (#1340 P4).
+     */
+    pruneOldTasks(days?: number): Promise<number>;
     dismissTip(userId: string, tipId: string): void;
     /** Tips are shared General-topic messages: one acknowledgement retires them fleet-wide. */
     listDismissedTipIds(): Set<string>;
@@ -48,10 +57,26 @@ export declare class SchedulerDb {
     private rowToTask;
     createTask(params: CreateTaskParams): Task;
     getTask(id: string): Task | null;
-    listTasks(opts?: {
-        assignee?: string;
-        status?: string;
+    /** #1336: project a full Task down to the compact list row. */
+    private toCompact;
+    /**
+     * #1336: Resolve a task by an 8-hex (or longer) id prefix. A full 36-char
+     * UUID is matched exactly first. Throws on ambiguous or not-found so the
+     * caller surfaces a clear error instead of silently acting on the wrong row.
+     */
+    getTaskByPrefix(prefix: string): Task;
+    /**
+     * #1336: list tasks. Returns compact rows by default; pass `verbose: true`
+     * for full {@link Task} rows. `status` accepts a single value or an array
+     * (OR-matched). No implicit live-only filtering happens here — the caller
+     * decides the default status set.
+     */
+    listTasks(opts?: ListTasksOpts & {
+        verbose: true;
     }): Task[];
+    listTasks(opts?: ListTasksOpts): TaskCompact[];
+    /** Normalize a status filter (string | string[] | undefined) to a deduped non-empty array. */
+    private normalizeStatuses;
     updateTask(id: string, params: UpdateTaskParams): Task;
     claimTask(id: string, assignee: string): Task;
     completeTask(id: string, result?: string): Task;