@rlarua/agentrunner 0.0.3

package/dist/runners/log-reporter.js

@@ -0,0 +1,107 @@
+import { logger } from "../logger.js";
+const MAX_BATCH_SIZE = 50;
+const MAX_BUFFERED_LOGS = 500;
+const MAX_MESSAGE_LENGTH = 2000;
+const DEFAULT_FLUSH_INTERVAL_MS = 2000;
+const ANSI_ESCAPE_PATTERN = /\u001B\[[0-9;?]*[ -/]*[@-~]/g;
+const CONTROL_CHAR_PATTERN = /[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/g;
+const normalizeMessage = (message) => {
+    const withoutAnsi = message.replace(ANSI_ESCAPE_PATTERN, "");
+    const normalizedNewline = withoutAnsi.replace(/\r\n?/g, "\n");
+    const withoutControlChars = normalizedNewline.replace(CONTROL_CHAR_PATTERN, "");
+    const squashed = withoutControlChars.replace(/\n{3,}/g, "\n\n");
+    const trimmed = squashed.trim();
+    if (trimmed.length <= MAX_MESSAGE_LENGTH) {
+        return trimmed;
+    }
+    return trimmed.slice(0, MAX_MESSAGE_LENGTH);
+};
+export class TriggerLogReporter {
+    client;
+    triggerId;
+    flushIntervalMs;
+    queue = [];
+    flushTimer = null;
+    flushInFlight = false;
+    droppedCount = 0;
+    constructor(client, triggerId, flushIntervalMs = DEFAULT_FLUSH_INTERVAL_MS) {
+        this.client = client;
+        this.triggerId = triggerId;
+        this.flushIntervalMs = flushIntervalMs;
+    }
+    start() {
+        if (this.flushTimer) {
+            return;
+        }
+        this.flushTimer = setInterval(() => {
+            void this.flush({ heartbeat: true });
+        }, this.flushIntervalMs);
+    }
+    append(level, message) {
+        const normalized = normalizeMessage(message);
+        if (normalized.length === 0) {
+            return;
+        }
+        if (this.queue.length >= MAX_BUFFERED_LOGS) {
+            this.queue.shift();
+            this.droppedCount += 1;
+        }
+        this.queue.push({ level, message: normalized });
+    }
+    async stop() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+        await this.flush({ heartbeat: true, drain: true });
+    }
+    async flush(opts) {
+        if (this.flushInFlight) {
+            return;
+        }
+        this.flushInFlight = true;
+        try {
+            if (this.droppedCount > 0) {
+                const droppedMessage = `Dropped ${this.droppedCount} log line(s) due to buffer limit (${MAX_BUFFERED_LOGS}).`;
+                this.queue.unshift({ level: "WARN", message: droppedMessage });
+                this.droppedCount = 0;
+            }
+            if (opts.drain) {
+                while (this.queue.length > 0) {
+                    const batch = this.queue.splice(0, MAX_BATCH_SIZE);
+                    await this.send({ logs: batch, heartbeat: opts.heartbeat });
+                    opts.heartbeat = false;
+                }
+                if (opts.heartbeat) {
+                    await this.send({ heartbeat: true });
+                }
+                return;
+            }
+            const batch = this.queue.splice(0, MAX_BATCH_SIZE);
+            if (batch.length === 0 && !opts.heartbeat) {
+                return;
+            }
+            await this.send({ logs: batch.length > 0 ? batch : undefined, heartbeat: opts.heartbeat });
+        }
+        finally {
+            this.flushInFlight = false;
+        }
+    }
+    async send(payload) {
+        if (!payload.logs && !payload.heartbeat) {
+            return;
+        }
+        try {
+            await this.client.appendTriggerLogs(this.triggerId, payload);
+        }
+        catch (error) {
+            logger.warn("Failed to report trigger logs", {
+                triggerId: this.triggerId,
+                error: error instanceof Error ? error.message : String(error),
+                payloadSize: payload.logs?.length ?? 0,
+                heartbeat: payload.heartbeat === true
+            });
+        }
+    }
+}
+//# sourceMappingURL=log-reporter.js.map

package/dist/runners/log-reporter.js.map

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

package/dist/runners/opencode.d.ts

@@ -0,0 +1,6 @@
+import type { Runner, RunnerOptions, RunResult } from "./types.js";
+export declare class OpenCodeRunner implements Runner {
+    private readonly runnerCmd;
+    constructor(runnerCmd?: string);
+    run(opts: RunnerOptions): Promise<RunResult>;
+}

package/dist/runners/opencode.js

@@ -0,0 +1,170 @@
+import { createWriteStream } from "node:fs";
+import { mkdir } from "node:fs/promises";
+import { spawn } from "node:child_process";
+import { dirname, join } from "node:path";
+import { logger } from "../logger.js";
+const FORCE_KILL_AFTER_MS = 10_000;
+const PROMPT_PREVIEW_MAX = 500;
+const OUTPUT_PREVIEW_MAX = 400;
+const toPromptPreview = (prompt) => {
+    if (prompt.length <= PROMPT_PREVIEW_MAX) {
+        return prompt;
+    }
+    return `${prompt.slice(0, PROMPT_PREVIEW_MAX)}...`;
+};
+const toOutputPreview = (chunk) => {
+    const text = (typeof chunk === "string" ? chunk : String(chunk)).trim();
+    if (text.length <= OUTPUT_PREVIEW_MAX) {
+        return text;
+    }
+    return `${text.slice(0, OUTPUT_PREVIEW_MAX)}...`;
+};
+export class OpenCodeRunner {
+    runnerCmd;
+    constructor(runnerCmd = "opencode") {
+        this.runnerCmd = runnerCmd;
+    }
+    async run(opts) {
+        if (!opts.authPath || opts.authPath.trim().length === 0) {
+            logger.error("authPath is missing for trigger");
+            return {
+                exitCode: 1,
+                errorMessage: "authPath is missing for trigger"
+            };
+        }
+        const cwd = opts.authPath;
+        const logPath = join(cwd, ".agentteams", "runner-log", `${opts.triggerId}.log`);
+        await mkdir(dirname(logPath), { recursive: true });
+        logger.info("Runner prompt", {
+            triggerId: opts.triggerId,
+            promptLength: opts.prompt.length,
+            promptPreview: toPromptPreview(opts.prompt)
+        });
+        const child = spawn(this.runnerCmd, ["run", opts.prompt], {
+            cwd,
+            detached: true,
+            stdio: ["ignore", "pipe", "pipe"],
+            env: {
+                ...process.env,
+                AGENTTEAMS_API_KEY: opts.apiKey,
+                AGENTTEAMS_API_URL: opts.apiUrl,
+                AGENTTEAMS_AGENT_NAME: opts.agentConfigId
+            }
+        });
+        const logStream = createWriteStream(logPath, { flags: "a" });
+        child.stdout?.pipe(logStream);
+        child.stderr?.pipe(logStream);
+        let lastOutput = "";
+        let lastErrorOutput = "";
+        child.stdout?.on("data", (chunk) => {
+            const output = toOutputPreview(Buffer.isBuffer(chunk) ? chunk.toString("utf8") : chunk);
+            if (output.length > 0) {
+                lastOutput = output;
+                opts.onStdoutChunk?.(output);
+                logger.info("Runner stdout", {
+                    triggerId: opts.triggerId,
+                    pid: child.pid,
+                    output
+                });
+            }
+        });
+        child.stderr?.on("data", (chunk) => {
+            const output = toOutputPreview(Buffer.isBuffer(chunk) ? chunk.toString("utf8") : chunk);
+            if (output.length > 0) {
+                lastOutput = output;
+                lastErrorOutput = output;
+                opts.onStderrChunk?.(output);
+                logger.warn("Runner stderr", {
+                    triggerId: opts.triggerId,
+                    pid: child.pid,
+                    output
+                });
+            }
+        });
+        logger.info("Runner started", {
+            triggerId: opts.triggerId,
+            cwd,
+            logPath,
+            pid: child.pid
+        });
+        return await new Promise((resolve) => {
+            let finished = false;
+            let timedOut = false;
+            const cleanup = () => {
+                if (finished) {
+                    return;
+                }
+                finished = true;
+                logStream.end();
+            };
+            const timeoutId = setTimeout(() => {
+                timedOut = true;
+                if (!child.pid) {
+                    return;
+                }
+                logger.warn("Runner timeout reached; sending SIGTERM", {
+                    triggerId: opts.triggerId,
+                    pid: child.pid,
+                    timeoutMs: opts.timeoutMs
+                });
+                try {
+                    process.kill(-child.pid, "SIGTERM");
+                }
+                catch {
+                    // ignore
+                }
+                setTimeout(() => {
+                    if (!finished && child.pid) {
+                        logger.warn("Runner still alive after SIGTERM; sending SIGKILL", {
+                            triggerId: opts.triggerId,
+                            pid: child.pid
+                        });
+                        try {
+                            process.kill(-child.pid, "SIGKILL");
+                        }
+                        catch {
+                            // ignore
+                        }
+                    }
+                }, FORCE_KILL_AFTER_MS);
+            }, opts.timeoutMs);
+            child.on("error", (error) => {
+                clearTimeout(timeoutId);
+                cleanup();
+                logger.error("Runner process launch failed", {
+                    triggerId: opts.triggerId,
+                    error: error.message
+                });
+                resolve({
+                    exitCode: 1,
+                    lastOutput,
+                    errorMessage: error.message
+                });
+            });
+            child.on("close", (code) => {
+                clearTimeout(timeoutId);
+                cleanup();
+                logger.info("Runner process closed", {
+                    triggerId: opts.triggerId,
+                    pid: child.pid,
+                    exitCode: code,
+                    timedOut
+                });
+                if (timedOut) {
+                    resolve({
+                        exitCode: 1,
+                        lastOutput,
+                        errorMessage: `Runner timed out after ${opts.timeoutMs}ms`
+                    });
+                    return;
+                }
+                resolve({
+                    exitCode: code ?? 1,
+                    lastOutput,
+                    errorMessage: code === 0 ? undefined : (lastErrorOutput || lastOutput || `Runner exited with code ${code ?? 1}`)
+                });
+            });
+        });
+    }
+}
+//# sourceMappingURL=opencode.js.map

package/dist/runners/opencode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.js","sourceRoot":"","sources":["../../src/runners/opencode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAGtC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AACnC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAC/B,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B,MAAM,eAAe,GAAG,CAAC,MAAc,EAAU,EAAE;IACjD,IAAI,MAAM,CAAC,MAAM,IAAI,kBAAkB,EAAE,CAAC;QACxC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC,KAAK,CAAC;AACrD,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,KAAc,EAAU,EAAE;IACjD,MAAM,IAAI,GAAG,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACxE,IAAI,IAAI,CAAC,MAAM,IAAI,kBAAkB,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC,KAAK,CAAC;AACnD,CAAC,CAAC;AAEF,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,YAAoB,UAAU;QAA9B,cAAS,GAAT,SAAS,CAAqB;IAAG,CAAC;IAE/D,KAAK,CAAC,GAAG,CAAC,IAAmB;QAC3B,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxD,MAAM,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;YAChD,OAAO;gBACL,QAAQ,EAAE,CAAC;gBACX,YAAY,EAAE,iCAAiC;aAChD,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC,SAAS,MAAM,CAAC,CAAC;QAChF,MAAM,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEnD,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE;YAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAChC,aAAa,EAAE,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC;SAC5C,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE;YACxD,GAAG;YACH,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;YACjC,GAAG,EAAE;gBACH,GAAG,OAAO,CAAC,GAAG;gBACd,kBAAkB,EAAE,IAAI,CAAC,MAAM;gBAC/B,kBAAkB,EAAE,IAAI,CAAC,MAAM;gBAC/B,qBAAqB,EAAE,IAAI,CAAC,aAAa;aAC1C;SACF,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QAC7D,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC9B,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC9B,IAAI,UAAU,GAAG,EAAE,CAAC;QACpB,IAAI,eAAe,GAAG,EAAE,CAAC;QAEzB,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YACjC,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACxF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,UAAU,GAAG,MAAM,CAAC;gBACpB,IAAI,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC;gBAC7B,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE;oBAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,GAAG,EAAE,KAAK,CAAC,GAAG;oBACd,MAAM;iBACP,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YACjC,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACxF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,UAAU,GAAG,MAAM,CAAC;gBACpB,eAAe,GAAG,MAAM,CAAC;gBACzB,IAAI,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC;gBAC7B,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE;oBAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,GAAG,EAAE,KAAK,CAAC,GAAG;oBACd,MAAM;iBACP,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE;YAC5B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG;YACH,OAAO;YACP,GAAG,EAAE,KAAK,CAAC,GAAG;SACf,CAAC,CAAC;QAEH,OAAO,MAAM,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,EAAE;YAC9C,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,IAAI,QAAQ,GAAG,KAAK,CAAC;YAErB,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,IAAI,QAAQ,EAAE,CAAC;oBACb,OAAO;gBACT,CAAC;gBAED,QAAQ,GAAG,IAAI,CAAC;gBAChB,SAAS,CAAC,GAAG,EAAE,CAAC;YAClB,CAAC,CAAC;YAEF,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;gBAChC,QAAQ,GAAG,IAAI,CAAC;gBAEhB,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;oBACf,OAAO;gBACT,CAAC;gBAED,MAAM,CAAC,IAAI,CAAC,yCAAyC,EAAE;oBACrD,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,GAAG,EAAE,KAAK,CAAC,GAAG;oBACd,SAAS,EAAE,IAAI,CAAC,SAAS;iBAC1B,CAAC,CAAC;gBAEH,IAAI,CAAC;oBACH,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;gBACtC,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS;gBACX,CAAC;gBAED,UAAU,CAAC,GAAG,EAAE;oBACd,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;wBAC3B,MAAM,CAAC,IAAI,CAAC,mDAAmD,EAAE;4BAC/D,SAAS,EAAE,IAAI,CAAC,SAAS;4BACzB,GAAG,EAAE,KAAK,CAAC,GAAG;yBACf,CAAC,CAAC;wBAEH,IAAI,CAAC;4BACH,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;wBACtC,CAAC;wBAAC,MAAM,CAAC;4BACP,SAAS;wBACX,CAAC;oBACH,CAAC;gBACH,CAAC,EAAE,mBAAmB,CAAC,CAAC;YAC1B,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAEnB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBAC1B,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,OAAO,EAAE,CAAC;gBACV,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE;oBAC3C,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,KAAK,EAAE,KAAK,CAAC,OAAO;iBACrB,CAAC,CAAC;gBACH,OAAO,CAAC;oBACN,QAAQ,EAAE,CAAC;oBACX,UAAU;oBACV,YAAY,EAAE,KAAK,CAAC,OAAO;iBAC5B,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACzB,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,OAAO,EAAE,CAAC;gBACV,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE;oBACnC,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,GAAG,EAAE,KAAK,CAAC,GAAG;oBACd,QAAQ,EAAE,IAAI;oBACd,QAAQ;iBACT,CAAC,CAAC;gBAEH,IAAI,QAAQ,EAAE,CAAC;oBACb,OAAO,CAAC;wBACN,QAAQ,EAAE,CAAC;wBACX,UAAU;wBACV,YAAY,EAAE,0BAA0B,IAAI,CAAC,SAAS,IAAI;qBAC3D,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;gBAED,OAAO,CAAC;oBACN,QAAQ,EAAE,IAAI,IAAI,CAAC;oBACnB,UAAU;oBACV,YAAY,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,eAAe,IAAI,UAAU,IAAI,2BAA2B,IAAI,IAAI,CAAC,EAAE,CAAC;iBACjH,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/runners/types.d.ts

@@ -0,0 +1,19 @@
+export interface Runner {
+    run(opts: RunnerOptions): Promise<RunResult>;
+}
+export interface RunnerOptions {
+    triggerId: string;
+    prompt: string;
+    authPath: string | null;
+    apiKey: string;
+    apiUrl: string;
+    timeoutMs: number;
+    agentConfigId: string;
+    onStdoutChunk?: (chunk: string) => void;
+    onStderrChunk?: (chunk: string) => void;
+}
+export type RunResult = {
+    exitCode: number;
+    lastOutput?: string;
+    errorMessage?: string;
+};

package/dist/runners/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/runners/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/runners/types.ts"],"names":[],"mappings":""}

package/dist/types.d.ts

@@ -0,0 +1,52 @@
+export type RuntimeConfig = {
+    daemonToken: string;
+    apiUrl: string;
+    pollingIntervalMs: number;
+    timeoutMs: number;
+    runnerCmd: string;
+};
+export type DaemonConfigFile = {
+    daemonToken: string;
+    apiUrl: string;
+};
+export type DaemonInfo = {
+    id: string;
+    memberId: string;
+    label: string | null;
+    lastSeenAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+export type DaemonTrigger = {
+    id: string;
+    prompt: string | Record<string, unknown>;
+    runnerType: string;
+    status: string;
+    agentConfigId: string;
+    startedAt: string | null;
+    errorMessage: string | null;
+    historyMarkdown: string | null;
+    lastHeartbeatAt: string | null;
+    conversationId: string | null;
+    parentTriggerId: string | null;
+    createdByMemberId: string;
+    claimedByDaemonId: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+export type TriggerFinalStatus = "DONE" | "FAILED" | "REJECTED";
+export type ClaimResult = {
+    ok: boolean;
+    conflict: boolean;
+};
+export type TriggerRuntime = {
+    triggerId: string;
+    agentConfigId: string;
+    authPath: string | null;
+    apiKey: string;
+};
+export type TriggerLogLevel = "INFO" | "WARN" | "ERROR";
+export type TriggerLogInput = {
+    level: TriggerLogLevel;
+    message: string;
+};

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/runner-history.d.ts

@@ -0,0 +1,6 @@
+type RunnerHistoryPaths = {
+    currentHistoryPath: string | null;
+    parentHistoryPath: string | null;
+};
+export declare const resolveRunnerHistoryPaths: (authPath: string | null, triggerId: string, parentTriggerId: string | null) => RunnerHistoryPaths;
+export {};

package/dist/utils/runner-history.js

@@ -0,0 +1,13 @@
+import { join } from "node:path";
+const historyDirectory = (authPath) => join(authPath, ".agentteams", "runner-history");
+const historyFilePath = (authPath, triggerId) => join(historyDirectory(authPath), `${triggerId}.md`);
+export const resolveRunnerHistoryPaths = (authPath, triggerId, parentTriggerId) => {
+    if (!authPath) {
+        return { currentHistoryPath: null, parentHistoryPath: null };
+    }
+    return {
+        currentHistoryPath: historyFilePath(authPath, triggerId),
+        parentHistoryPath: parentTriggerId ? historyFilePath(authPath, parentTriggerId) : null
+    };
+};
+//# sourceMappingURL=runner-history.js.map

package/dist/utils/runner-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-history.js","sourceRoot":"","sources":["../../src/utils/runner-history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAOjC,MAAM,gBAAgB,GAAG,CAAC,QAAgB,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,EAAE,gBAAgB,CAAC,CAAC;AAE/F,MAAM,eAAe,GAAG,CAAC,QAAgB,EAAE,SAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,GAAG,SAAS,KAAK,CAAC,CAAC;AAErH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,QAAuB,EACvB,SAAiB,EACjB,eAA8B,EACV,EAAE;IACtB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;IAC/D,CAAC;IAED,OAAO;QACL,kBAAkB,EAAE,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC;QACxD,iBAAiB,EAAE,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI;KACvF,CAAC;AACJ,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@rlarua/agentrunner",
+  "version": "0.0.3",
+  "description": "AgentRunner - Background runner that polls and executes AI agent tasks",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "agentrunner": "dist/index.js"
+  },
+  "files": [
+    "dist/**/*",
+    "readme.md"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "init": "node dist/index.js init",
+    "prepublishOnly": "npm run build"
+  },
+  "homepage": "https://agentteams.run",
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "agentteams",
+    "runner",
+    "ai-agent",
+    "automation"
+  ],
+  "license": "Apache-2.0",
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "tsx": "^4.20.5",
+    "typescript": "^5.9.2"
+  }
+}

package/readme.md

@@ -0,0 +1,160 @@
+# @rlarua/agentrunner
+
+A background runner that polls and executes AI agent tasks from the AgentTeams platform.
+
+## Prerequisites
+
+- Node.js `18` or later
+- AgentTeams API server running
+- A daemon token issued from the web UI (`x-daemon-token`)
+
+## Installation
+
+```bash
+npm install -g @rlarua/agentrunner
+```
+
+Verify the installation:
+
+```bash
+agentrunner --help
+```
+
+## Quick Start
+
+### 1. Initialize
+
+```bash
+agentrunner init --token <DAEMON_TOKEN>
+```
+
+The `init` command:
+
+1. Saves the token to `~/.agentteams/daemon.json`
+2. Validates the token against the API server
+3. Registers an OS-level autostart service and starts the runner immediately
+   - **macOS**: `~/Library/LaunchAgents/run.agentteams.daemon.plist` (launchd)
+   - **Linux**: `~/.config/systemd/user/agentrunner.service` (systemd)
+   - **Windows**: `AgentRunner` (Task Scheduler)
+
+### Options
+
+- `--token <token>` — **Required**. Daemon token issued from the web UI
+- `--no-autostart` — Optional. Skip autostart registration (manual start only)
+
+Examples:
+
+```bash
+# Standard setup (with autostart)
+agentrunner init --token daemon_xxxxx
+
+# Token-only setup (no autostart)
+agentrunner init --token daemon_xxxxx --no-autostart
+```
+
+### 2. Start (`start`)
+
+```bash
+agentrunner start
+```
+
+Running without a subcommand defaults to `start`:
+
+```bash
+agentrunner
+```
+
+> If autostart was registered via `init`, you do not need to run `start` manually.
+> The OS will start the runner automatically on login/boot.
+
+### 3. Check Status (`status`)
+
+```bash
+agentrunner status
+```
+
+Shows whether the runner process is active and whether autostart is registered.
+
+Example output:
+
+```
+[...] INFO Daemon is running { pid: 12345 }
+[...] INFO Autostart is enabled { platform: 'launchd' }
+```
+
+### 4. Stop (`stop`)
+
+```bash
+agentrunner stop
+```
+
+Sends SIGTERM to the running process for a graceful shutdown.
+
+> If autostart is registered, the OS may restart the runner automatically.
+> Use `uninstall` to stop completely.
+
+### 5. Uninstall (`uninstall`)
+
+```bash
+agentrunner uninstall
+```
+
+Performs the following:
+
+1. Stops the running process
+2. Removes the autostart service and deletes the service file
+3. Cleans up the PID file
+
+## Configuration
+
+Settings are resolved in the following priority order at runtime.
+
+### Token
+
+1. `AGENTTEAMS_DAEMON_TOKEN` environment variable
+2. `daemonToken` in `~/.agentteams/daemon.json`
+
+### Environment Variables
+
+| Variable | Default | Description |
+|---|---|---|
+| `POLLING_INTERVAL_MS` | `30000` (30s) | Polling interval for pending triggers |
+| `TIMEOUT_MS` | `1800000` (30min) | Runner process timeout |
+| `RUNNER_CMD` | `opencode` | Command used to execute agent tasks |
+| `LOG_LEVEL` | `info` | Log level: `debug`, `info`, `warn`, `error` |
+| `DAEMON_VERBOSE_RUNNER_LOGS` | `true` | When `false`, reduces runner stdout/stderr to start/stop/error only |
+| `DAEMON_PROMPT_LOG_MODE` | `preview` | Prompt logging: `off`, `length`, `preview`, `full` |
+
+## How It Works
+
+After `start`, the runner operates in the following loop:
+
+1. Polls for pending triggers periodically
+2. Claims a trigger
+3. Fetches runtime info (working directory, API key)
+4. Executes `RUNNER_CMD run "<prompt>"`
+5. Updates trigger status based on exit code or timeout
+
+If a process is already running for the same `agentConfigId`, new triggers are `REJECTED`.
+
+## Logs
+
+- **Runner logs**: console output (forwarded to OS log system when autostarted)
+  - **macOS**: `/tmp/agentrunner.log`, `/tmp/agentrunner-error.log`
+  - **Linux**: `journalctl --user -u agentrunner -f`
+  - **Windows**: Event Viewer → Windows Logs → Application (`AgentRunner`)
+- **Task logs**: `<workdir>/.agentteams/daemonLog/daemon-<triggerId>.log`
+
+## Troubleshooting
+
+### `Missing token. Usage: agentrunner init --token <token> ...`
+
+The `--token` flag was not provided to `init`.
+
+### `Daemon token is missing. Run 'agentrunner init --token <token>' first.`
+
+No token found at runtime. Run `init` first or set the `AGENTTEAMS_DAEMON_TOKEN` environment variable.
+
+## License
+
+Apache-2.0