@questionbase/deskfree 0.4.5 → 0.4.7

package/dist/bin.js

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
 import { execSync, execFileSync, execFile } from 'child_process';
-import { writeFileSync, chmodSync, existsSync, unlinkSync, mkdirSync, readdirSync, readFileSync, createWriteStream } from 'fs';
+import { mkdirSync, writeFileSync, chmodSync, existsSync, unlinkSync, appendFileSync, readdirSync, readFileSync, statSync, createWriteStream } from 'fs';
+import { homedir } from 'os';
+import { dirname, join, extname } from 'path';
 import { createRequire as createRequire$1 } from 'module';
-import { join, dirname, extname } from 'path';
 import { query, createSdkMcpServer, tool } from '@anthropic-ai/claude-agent-sdk';
 import { z } from 'zod';
 import { appendFile, readFile, mkdir, unlink } from 'fs/promises';
@@ -57,7 +58,90 @@ var install_exports = {};
 __export(install_exports, {
   install: () => install
 });
-function install(token) {
+function getMacPaths() {
+  const home = homedir();
+  const deskfreeDir = join(home, ".deskfree");
+  return {
+    deskfreeDir,
+    envFile: join(deskfreeDir, ".env"),
+    launcher: join(deskfreeDir, "launcher.sh"),
+    logDir: join(deskfreeDir, "logs"),
+    plist: join(home, "Library", "LaunchAgents", `${PLIST_LABEL}.plist`)
+  };
+}
+function installMac(token) {
+  const paths = getMacPaths();
+  let nodeBinDir;
+  try {
+    const nodePath = execSync("which node", { encoding: "utf8" }).trim();
+    nodeBinDir = dirname(nodePath);
+  } catch {
+    console.error("Error: node not found in PATH");
+    process.exit(1);
+  }
+  mkdirSync(paths.deskfreeDir, { recursive: true });
+  mkdirSync(paths.logDir, { recursive: true });
+  mkdirSync(dirname(paths.plist), { recursive: true });
+  writeFileSync(paths.envFile, `DESKFREE_LAUNCH=${token}
+`, { mode: 384 });
+  chmodSync(paths.envFile, 384);
+  console.log(`Wrote ${paths.envFile}`);
+  const launcher = `#!/bin/bash
+set -euo pipefail
+
+export PATH="${nodeBinDir}:$PATH"
+
+# Update to latest version before starting
+npm install -g ${PACKAGE} 2>/dev/null || true
+
+# Source env
+set -a
+source "${paths.envFile}"
+set +a
+
+exec deskfree-agent start
+`;
+  writeFileSync(paths.launcher, launcher, { mode: 493 });
+  chmodSync(paths.launcher, 493);
+  console.log(`Wrote ${paths.launcher}`);
+  const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${PLIST_LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${paths.launcher}</string>
+  </array>
+  <key>KeepAlive</key>
+  <true/>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${join(paths.logDir, "stdout.log")}</string>
+  <key>StandardErrorPath</key>
+  <string>${join(paths.logDir, "stderr.log")}</string>
+  <key>ThrottleInterval</key>
+  <integer>10</integer>
+</dict>
+</plist>
+`;
+  writeFileSync(paths.plist, plist);
+  console.log(`Wrote ${paths.plist}`);
+  try {
+    execSync(`launchctl bootout gui/$(id -u) ${paths.plist}`, {
+      stdio: "ignore"
+    });
+  } catch {
+  }
+  execSync(`launchctl bootstrap gui/$(id -u) ${paths.plist}`);
+  console.log(`
+Service ${PLIST_LABEL} installed and started.`);
+  console.log(`Check status: launchctl print gui/$(id -u)/${PLIST_LABEL}`);
+  console.log(`Logs: tail -f ${join(paths.logDir, "stdout.log")}`);
+}
+function installLinux(token) {
   if (process.getuid?.() !== 0) {
     console.error("Error: install must be run as root (use sudo)");
     process.exit(1);
@@ -69,10 +153,12 @@ function install(token) {
     console.error("Error: npx not found in PATH");
     process.exit(1);
   }
-  writeFileSync(ENV_FILE, `DESKFREE_LAUNCH=${token}
-`, { mode: 384 });
-  chmodSync(ENV_FILE, 384);
-  console.log(`Wrote ${ENV_FILE}`);
+  writeFileSync(SYSTEMD_ENV_FILE, `DESKFREE_LAUNCH=${token}
+`, {
+    mode: 384
+  });
+  chmodSync(SYSTEMD_ENV_FILE, 384);
+  console.log(`Wrote ${SYSTEMD_ENV_FILE}`);
   const unit = `[Unit]
 Description=DeskFree Agent
 After=network-online.target
@@ -80,8 +166,9 @@ Wants=network-online.target
 
 [Service]
 Type=simple
+ExecStartPre=${npxPath} ${PACKAGE} --version
 ExecStart=${npxPath} ${PACKAGE} start
-EnvironmentFile=${ENV_FILE}
+EnvironmentFile=${SYSTEMD_ENV_FILE}
 Environment=NODE_ENV=production
 Restart=always
 RestartSec=10
@@ -89,21 +176,33 @@ RestartSec=10
 [Install]
 WantedBy=multi-user.target
 `;
-  writeFileSync(SERVICE_FILE, unit);
-  console.log(`Wrote ${SERVICE_FILE}`);
+  writeFileSync(SYSTEMD_SERVICE_FILE, unit);
+  console.log(`Wrote ${SYSTEMD_SERVICE_FILE}`);
   execSync("systemctl daemon-reload");
   execSync(`systemctl enable ${SERVICE_NAME}`);
   execSync(`systemctl start ${SERVICE_NAME}`);
-  console.log(`Service ${SERVICE_NAME} installed and started.`);
+  console.log(`
+Service ${SERVICE_NAME} installed and started.`);
   console.log(`Check status: systemctl status ${SERVICE_NAME}`);
 }
-var SERVICE_NAME, SERVICE_FILE, ENV_FILE, PACKAGE;
+function install(token) {
+  if (process.platform === "darwin") {
+    installMac(token);
+  } else if (process.platform === "linux") {
+    installLinux(token);
+  } else {
+    console.error(`Unsupported platform: ${process.platform}`);
+    process.exit(1);
+  }
+}
+var SERVICE_NAME, PACKAGE, PLIST_LABEL, SYSTEMD_SERVICE_FILE, SYSTEMD_ENV_FILE;
 var init_install = __esm({
   "src/cli/install.ts"() {
     SERVICE_NAME = "deskfree-agent";
-    SERVICE_FILE = `/etc/systemd/system/${SERVICE_NAME}.service`;
-    ENV_FILE = `/etc/${SERVICE_NAME}.env`;
     PACKAGE = "@questionbase/deskfree@latest";
+    PLIST_LABEL = "com.deskfree.agent";
+    SYSTEMD_SERVICE_FILE = `/etc/systemd/system/${SERVICE_NAME}.service`;
+    SYSTEMD_ENV_FILE = `/etc/${SERVICE_NAME}.env`;
   }
 });
 
@@ -112,7 +211,28 @@ var uninstall_exports = {};
 __export(uninstall_exports, {
   uninstall: () => uninstall
 });
-function uninstall() {
+function uninstallMac() {
+  const home = homedir();
+  const plist = join(home, "Library", "LaunchAgents", `${PLIST_LABEL2}.plist`);
+  const deskfreeDir = join(home, ".deskfree");
+  const envFile = join(deskfreeDir, ".env");
+  const launcher = join(deskfreeDir, "launcher.sh");
+  try {
+    execSync(`launchctl bootout gui/$(id -u) ${plist}`, { stdio: "ignore" });
+  } catch {
+  }
+  for (const file of [plist, envFile, launcher]) {
+    if (existsSync(file)) {
+      unlinkSync(file);
+      console.log(`Removed ${file}`);
+    }
+  }
+  console.log(`Service ${PLIST_LABEL2} uninstalled.`);
+  console.log(
+    `Note: logs and state in ${deskfreeDir} were preserved. Remove manually if desired.`
+  );
+}
+function uninstallLinux() {
   if (process.getuid?.() !== 0) {
     console.error("Error: uninstall must be run as root (use sudo)");
     process.exit(1);
@@ -125,23 +245,104 @@ function uninstall() {
     execSync(`systemctl disable ${SERVICE_NAME2}`, { stdio: "ignore" });
   } catch {
   }
-  if (existsSync(SERVICE_FILE2)) {
-    unlinkSync(SERVICE_FILE2);
-    console.log(`Removed ${SERVICE_FILE2}`);
+  if (existsSync(SYSTEMD_SERVICE_FILE2)) {
+    unlinkSync(SYSTEMD_SERVICE_FILE2);
+    console.log(`Removed ${SYSTEMD_SERVICE_FILE2}`);
   }
-  if (existsSync(ENV_FILE2)) {
-    unlinkSync(ENV_FILE2);
-    console.log(`Removed ${ENV_FILE2}`);
+  if (existsSync(SYSTEMD_ENV_FILE2)) {
+    unlinkSync(SYSTEMD_ENV_FILE2);
+    console.log(`Removed ${SYSTEMD_ENV_FILE2}`);
   }
   execSync("systemctl daemon-reload");
   console.log(`Service ${SERVICE_NAME2} uninstalled.`);
 }
-var SERVICE_NAME2, SERVICE_FILE2, ENV_FILE2;
+function uninstall() {
+  if (process.platform === "darwin") {
+    uninstallMac();
+  } else if (process.platform === "linux") {
+    uninstallLinux();
+  } else {
+    console.error(`Unsupported platform: ${process.platform}`);
+    process.exit(1);
+  }
+}
+var SERVICE_NAME2, PLIST_LABEL2, SYSTEMD_SERVICE_FILE2, SYSTEMD_ENV_FILE2;
 var init_uninstall = __esm({
   "src/cli/uninstall.ts"() {
     SERVICE_NAME2 = "deskfree-agent";
-    SERVICE_FILE2 = `/etc/systemd/system/${SERVICE_NAME2}.service`;
-    ENV_FILE2 = `/etc/${SERVICE_NAME2}.env`;
+    PLIST_LABEL2 = "com.deskfree.agent";
+    SYSTEMD_SERVICE_FILE2 = `/etc/systemd/system/${SERVICE_NAME2}.service`;
+    SYSTEMD_ENV_FILE2 = `/etc/${SERVICE_NAME2}.env`;
+  }
+});
+
+// src/cli/status.ts
+var status_exports = {};
+__export(status_exports, {
+  status: () => status
+});
+function statusMac() {
+  const home = homedir();
+  const plist = join(home, "Library", "LaunchAgents", `${PLIST_LABEL3}.plist`);
+  if (!existsSync(plist)) {
+    console.log("DeskFree Agent is not installed.");
+    console.log(`Run: npx @questionbase/deskfree@latest install <token>`);
+    return;
+  }
+  console.log("DeskFree Agent (macOS LaunchAgent)\n");
+  try {
+    const output = execSync(
+      `launchctl print gui/$(id -u)/${PLIST_LABEL3} 2>&1`,
+      { encoding: "utf8" }
+    );
+    const pidMatch = output.match(/pid\s*=\s*(\d+)/);
+    const stateMatch = output.match(/state\s*=\s*(\w+)/);
+    if (pidMatch) console.log(`  PID: ${pidMatch[1]}`);
+    if (stateMatch) console.log(`  State: ${stateMatch[1]}`);
+    const logDir = join(home, ".deskfree", "logs");
+    console.log(`  Logs: ${logDir}/stdout.log`);
+    console.log(`  Plist: ${plist}`);
+  } catch {
+    console.log("  Status: not running (service may be unloaded)");
+  }
+}
+function statusLinux() {
+  const serviceFile = `/etc/systemd/system/${SYSTEMD_SERVICE_NAME}.service`;
+  if (!existsSync(serviceFile)) {
+    console.log("DeskFree Agent is not installed.");
+    console.log(`Run: sudo npx @questionbase/deskfree@latest install <token>`);
+    return;
+  }
+  console.log("DeskFree Agent (systemd service)\n");
+  try {
+    const output = execSync(
+      `systemctl status ${SYSTEMD_SERVICE_NAME} --no-pager 2>&1`,
+      { encoding: "utf8" }
+    );
+    console.log(output);
+  } catch (err) {
+    if (err && typeof err === "object" && "stdout" in err) {
+      console.log(err.stdout);
+    } else {
+      console.log("  Status: unknown (could not query systemd)");
+    }
+  }
+}
+function status() {
+  if (process.platform === "darwin") {
+    statusMac();
+  } else if (process.platform === "linux") {
+    statusLinux();
+  } else {
+    console.error(`Unsupported platform: ${process.platform}`);
+    process.exit(1);
+  }
+}
+var PLIST_LABEL3, SYSTEMD_SERVICE_NAME;
+var init_status = __esm({
+  "src/cli/status.ts"() {
+    PLIST_LABEL3 = "com.deskfree.agent";
+    SYSTEMD_SERVICE_NAME = "deskfree-agent";
   }
 });
 function toErrorMessage(error) {
@@ -2554,6 +2755,41 @@ function createWorkerTools(client, options) {
         return errorResult(err);
       }
     }),
+    createTool(WORKER_TOOLS.PROPOSE, async (params) => {
+      try {
+        const context = validateStringParam(params, "context", false);
+        const taskId = validateStringParam(params, "taskId", false);
+        const rawTasks = params.tasks;
+        if (!Array.isArray(rawTasks) || rawTasks.length === 0) {
+          throw new Error("tasks must be a non-empty array of task objects");
+        }
+        const tasks = rawTasks;
+        for (let i = 0; i < tasks.length; i++) {
+          const task = tasks[i];
+          if (!task || typeof task !== "object") {
+            throw new Error(`tasks[${i}] must be an object`);
+          }
+          if (!task.title || typeof task.title !== "string" || task.title.trim() === "") {
+            throw new Error(`tasks[${i}].title must be a non-empty string`);
+          }
+        }
+        await client.proposePlan({
+          context,
+          tasks,
+          taskId
+        });
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Proposal created with ${tasks.length} task(s)`
+            }
+          ]
+        };
+      } catch (err) {
+        return errorResult(err);
+      }
+    }),
     createTool(WORKER_TOOLS.COMPLETE_TASK, async (params) => {
       try {
         const taskId = validateStringParam(params, "taskId", true);
@@ -6411,96 +6647,96 @@ var init_dist = __esm({
         this.statusCode = statusCode;
       }
       static fromResponse(response, procedure, responseText) {
-        const status = response.status;
+        const status2 = response.status;
         const statusText = response.statusText;
-        if (status === 401) {
+        if (status2 === 401) {
           return new _DeskFreeError(
             "auth",
             procedure,
-            `Authentication failed: ${status} ${statusText} \u2014 ${responseText}`,
+            `Authentication failed: ${status2} ${statusText} \u2014 ${responseText}`,
             "Your bot token is invalid or has expired. Please check your authentication credentials.",
-            status
+            status2
           );
         }
-        if (status === 403) {
+        if (status2 === 403) {
           return new _DeskFreeError(
             "auth",
             procedure,
-            `Authorization failed: ${status} ${statusText} \u2014 ${responseText}`,
+            `Authorization failed: ${status2} ${statusText} \u2014 ${responseText}`,
             "Your bot does not have permission to perform this action. Contact your administrator.",
-            status
+            status2
           );
         }
-        if (status === 400) {
+        if (status2 === 400) {
           return new _DeskFreeError(
             "client",
             procedure,
-            `Bad request: ${status} ${statusText} \u2014 ${responseText}`,
+            `Bad request: ${status2} ${statusText} \u2014 ${responseText}`,
             "The request was invalid. Please check your input parameters and try again.",
-            status
+            status2
           );
         }
-        if (status === 404) {
+        if (status2 === 404) {
           return new _DeskFreeError(
             "client",
             procedure,
-            `Resource not found: ${status} ${statusText} \u2014 ${responseText}`,
+            `Resource not found: ${status2} ${statusText} \u2014 ${responseText}`,
             procedure.includes("task") ? "The specified task was not found or is not available. Use deskfree_state to see available tasks." : "The requested resource was not found. Please check your input and try again.",
-            status
+            status2
           );
         }
-        if (status === 409) {
+        if (status2 === 409) {
           return new _DeskFreeError(
             "client",
             procedure,
-            `Conflict: ${status} ${statusText} \u2014 ${responseText}`,
+            `Conflict: ${status2} ${statusText} \u2014 ${responseText}`,
             procedure.includes("start_task") || procedure.includes("claim") ? "The resource is already in use by another process. Use deskfree_state to see current status and try a different resource." : "The request conflicts with the current state of the resource. Please refresh and try again.",
-            status
+            status2
           );
         }
-        if (status === 422) {
+        if (status2 === 422) {
           return new _DeskFreeError(
             "client",
             procedure,
-            `Validation failed: ${status} ${statusText} \u2014 ${responseText}`,
+            `Validation failed: ${status2} ${statusText} \u2014 ${responseText}`,
             "The request data failed validation. Please check all required fields and data formats.",
-            status
+            status2
           );
         }
-        if (status === 429) {
+        if (status2 === 429) {
           return new _DeskFreeError(
             "client",
             procedure,
-            `Rate limit exceeded: ${status} ${statusText} \u2014 ${responseText}`,
+            `Rate limit exceeded: ${status2} ${statusText} \u2014 ${responseText}`,
             "Too many requests. Please wait a moment before trying again.",
-            status
+            status2
           );
         }
-        if (status >= 500 && status < 600) {
-          const serverErrorMessage = status === 502 || status === 503 ? "DeskFree service is temporarily unavailable due to maintenance or high load. Please try again in a few minutes." : status === 504 ? "The request timed out on the server. This may be due to high load. Please try again with a smaller request or wait a few minutes." : "DeskFree service encountered an internal error. Please try again in a few minutes.";
+        if (status2 >= 500 && status2 < 600) {
+          const serverErrorMessage = status2 === 502 || status2 === 503 ? "DeskFree service is temporarily unavailable due to maintenance or high load. Please try again in a few minutes." : status2 === 504 ? "The request timed out on the server. This may be due to high load. Please try again with a smaller request or wait a few minutes." : "DeskFree service encountered an internal error. Please try again in a few minutes.";
           return new _DeskFreeError(
             "server",
             procedure,
-            `Server error: ${status} ${statusText} \u2014 ${responseText}`,
+            `Server error: ${status2} ${statusText} \u2014 ${responseText}`,
             serverErrorMessage,
-            status
+            status2
           );
         }
-        if (status >= 400 && status < 500) {
+        if (status2 >= 400 && status2 < 500) {
           return new _DeskFreeError(
             "client",
             procedure,
-            `Client error: ${status} ${statusText} \u2014 ${responseText}`,
+            `Client error: ${status2} ${statusText} \u2014 ${responseText}`,
             "The request was not accepted by the server. Please check your input and try again.",
-            status
+            status2
           );
         }
         return new _DeskFreeError(
           "client",
           procedure,
-          `HTTP error: ${status} ${statusText} \u2014 ${responseText}`,
-          `Request failed with error ${status}. Please try again or contact support if the problem persists.`,
-          status
+          `HTTP error: ${status2} ${statusText} \u2014 ${responseText}`,
+          `Request failed with error ${status2}. Please try again or contact support if the problem persists.`,
+          status2
         );
       }
       static timeout(procedure, timeoutMs) {
@@ -7361,7 +7597,10 @@ You are the orchestrator. Your job: turn human intent into approved tasks, then
 **Match the human's energy.** Short message \u2192 short reply. Casual tone \u2192 casual response. Don't over-explain, don't lecture, don't pad responses.
 
 You do NOT claim tasks, complete tasks, or do work directly \u2014 you have no access to deskfree_start_task or deskfree_complete_task. Use \`deskfree_dispatch_worker\` to dispatch a worker for each approved task.
-- When a human writes in a task thread, decide: does it need bot action? If yes \u2192 reopen and dispatch a worker. If it's just confirmation or deferred \u2014 leave it for now.
+- When a human writes in a task thread, decide:
+  - **Continuation of the same task?** \u2192 reopen and dispatch a worker.
+  - **New/different work request?** \u2192 propose it as a new task (don't reopen the old one or do the work yourself).
+  - **Just confirmation or deferred?** \u2192 leave it for now.
 - Estimate token cost per task \u2014 consider files to read, reasoning, output.`;
     DESKFREE_WORKER_DIRECTIVE = `## DeskFree Worker
 You are a worker sub-agent. Your first message contains pre-loaded context \u2014 use it directly.
@@ -7814,18 +8053,7 @@ function runOrchestrator(opts) {
         "deskfree-orchestrator": orchestratorServer
       },
       tools: [],
-      allowedTools: [
-        "mcp__deskfree-orchestrator__*",
-        "Read",
-        "Write",
-        "Edit",
-        "Bash",
-        "Glob",
-        "Grep",
-        "WebSearch",
-        "WebFetch",
-        "NotebookEdit"
-      ],
+      allowedTools: ORCHESTRATOR_ALLOWED_TOOLS,
       disallowedTools: DISALLOWED_BUILTIN_TOOLS
     }
   });
@@ -7846,18 +8074,7 @@ function runHeartbeat(opts) {
         "deskfree-orchestrator": orchestratorServer
       },
       tools: [],
-      allowedTools: [
-        "mcp__deskfree-orchestrator__*",
-        "Read",
-        "Write",
-        "Edit",
-        "Bash",
-        "Glob",
-        "Grep",
-        "WebSearch",
-        "WebFetch",
-        "NotebookEdit"
-      ],
+      allowedTools: ORCHESTRATOR_ALLOWED_TOOLS,
       disallowedTools: DISALLOWED_BUILTIN_TOOLS
     }
   });
@@ -7880,11 +8097,19 @@ function runOneShotWorker(opts) {
     }
   });
 }
-var MAX_ORCHESTRATOR_TURNS, DISALLOWED_BUILTIN_TOOLS;
+var MAX_ORCHESTRATOR_TURNS, ORCHESTRATOR_ALLOWED_TOOLS, DISALLOWED_BUILTIN_TOOLS;
 var init_orchestrator = __esm({
   "src/agents/orchestrator.ts"() {
     init_dist();
     MAX_ORCHESTRATOR_TURNS = 20;
+    ORCHESTRATOR_ALLOWED_TOOLS = [
+      "mcp__deskfree-orchestrator__*",
+      "Read",
+      "Glob",
+      "Grep",
+      "WebSearch",
+      "WebFetch"
+    ];
     DISALLOWED_BUILTIN_TOOLS = [
       "TodoWrite",
       "AskUserQuestion",
@@ -8049,6 +8274,86 @@ var init_health_state = __esm({
   }
 });
 
+// src/util/logger.ts
+var logger_exports = {};
+__export(logger_exports, {
+  createLogger: () => createLogger,
+  enableFileLogging: () => enableFileLogging,
+  getLogFilePath: () => getLogFilePath,
+  logger: () => logger
+});
+function enableFileLogging(filePath) {
+  mkdirSync(dirname(filePath), { recursive: true });
+  logFilePath = filePath;
+}
+function getLogFilePath() {
+  return logFilePath;
+}
+function rotateIfNeeded() {
+  if (!logFilePath) return;
+  try {
+    const stat = statSync(logFilePath);
+    if (stat.size <= MAX_LOG_FILE_BYTES) return;
+    const content = readFileSync(logFilePath, "utf8");
+    const half = Math.floor(content.length / 2);
+    const newlineIdx = content.indexOf("\n", half);
+    const trimmed = newlineIdx >= 0 ? content.slice(newlineIdx + 1) : content.slice(half);
+    writeFileSync(logFilePath, trimmed);
+  } catch {
+  }
+}
+function createLogger(component, minLevel = "info") {
+  const minLevelNum = LEVELS[minLevel];
+  function log(level, message, fields) {
+    if (LEVELS[level] < minLevelNum) return;
+    const entry = {
+      ts: (/* @__PURE__ */ new Date()).toISOString(),
+      level,
+      component,
+      msg: message,
+      ...fields
+    };
+    const line = JSON.stringify(entry);
+    if (level === "error" || level === "warn") {
+      process.stderr.write(line + "\n");
+    } else {
+      process.stdout.write(line + "\n");
+    }
+    if (logFilePath) {
+      try {
+        appendFileSync(logFilePath, line + "\n");
+        if (++writesSinceCheck >= ROTATION_CHECK_INTERVAL) {
+          writesSinceCheck = 0;
+          rotateIfNeeded();
+        }
+      } catch {
+      }
+    }
+  }
+  return {
+    debug: (msg, fields) => log("debug", msg, fields),
+    info: (msg, fields) => log("info", msg, fields),
+    warn: (msg, fields) => log("warn", msg, fields),
+    error: (msg, fields) => log("error", msg, fields)
+  };
+}
+var LEVELS, MAX_LOG_FILE_BYTES, ROTATION_CHECK_INTERVAL, logFilePath, writesSinceCheck, logger;
+var init_logger = __esm({
+  "src/util/logger.ts"() {
+    LEVELS = {
+      debug: 0,
+      info: 1,
+      warn: 2,
+      error: 3
+    };
+    MAX_LOG_FILE_BYTES = 5 * 1024 * 1024;
+    ROTATION_CHECK_INTERVAL = 500;
+    logFilePath = null;
+    writesSinceCheck = 0;
+    logger = createLogger("runtime");
+  }
+});
+
 // src/gateway/polling.ts
 async function pollAndDeliver(client, accountId, stateDir, cursor, onMessage, log) {
   const ctx = { accountId };
@@ -11753,8 +12058,6 @@ var init_wrapper = __esm({
     wrapper_default2 = import_websocket2.default;
   }
 });
-
-// src/gateway/ws-gateway.ts
 function nextBackoff(state2) {
   const delay = Math.min(
     BACKOFF_INITIAL_MS * Math.pow(BACKOFF_FACTOR, state2.attempt),
@@ -11934,11 +12237,11 @@ async function runWebSocketConnection(opts) {
       }, PING_INTERVAL_MS);
       if (opts.getWorkerStatus) {
         try {
-          const status = opts.getWorkerStatus();
+          const status2 = opts.getWorkerStatus();
           ws.send(
             JSON.stringify({
               action: "heartbeatResponse",
-              ...status
+              ...status2
             })
           );
         } catch (err) {
@@ -12008,11 +12311,11 @@ async function runWebSocketConnection(opts) {
         } else if (msg.action === "heartbeatRequest") {
           if (opts.getWorkerStatus && ws.readyState === wrapper_default2.OPEN) {
             try {
-              const status = opts.getWorkerStatus();
+              const status2 = opts.getWorkerStatus();
               ws.send(
                 JSON.stringify({
                   action: "heartbeatResponse",
-                  ...status
+                  ...status2
                 })
               );
             } catch (err) {
@@ -12027,6 +12330,49 @@ async function runWebSocketConnection(opts) {
           cleanup();
           ws.close(1e3, "reload");
           process.kill(process.pid, "SIGTERM");
+        } else if (msg.action === "logs") {
+          const MAX_RESPONSE_BYTES = 12e4;
+          const lineCount = msg.lines ?? 200;
+          try {
+            const logFile = getLogFilePath();
+            if (!logFile) {
+              ws.send(
+                JSON.stringify({
+                  action: "logsResponse",
+                  lines: [],
+                  error: "File logging not enabled"
+                })
+              );
+            } else {
+              const content = readFileSync(logFile, "utf8");
+              const allLines = content.split("\n").filter(Boolean);
+              let tail = allLines.slice(-lineCount);
+              while (tail.length > 1) {
+                const payload = JSON.stringify({
+                  action: "logsResponse",
+                  lines: tail
+                });
+                if (Buffer.byteLength(payload) <= MAX_RESPONSE_BYTES) break;
+                tail = tail.slice(Math.ceil(tail.length * 0.25));
+              }
+              ws.send(
+                JSON.stringify({
+                  action: "logsResponse",
+                  lines: tail
+                })
+              );
+            }
+          } catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            log.warn(`Failed to read logs: ${errMsg}`);
+            ws.send(
+              JSON.stringify({
+                action: "logsResponse",
+                lines: [],
+                error: errMsg
+              })
+            );
+          }
         }
       } catch (err) {
         const message = err instanceof Error ? err.message : String(err);
@@ -12145,6 +12491,7 @@ var PING_INTERVAL_MS, POLL_FALLBACK_INTERVAL_MS, WS_CONNECTION_TIMEOUT_MS, WS_PO
 var init_ws_gateway = __esm({
   "src/gateway/ws-gateway.ts"() {
     init_health_state();
+    init_logger();
     init_polling();
     init_dist();
     init_wrapper();
@@ -12639,21 +12986,35 @@ function scheduleDailyCycle(label, run, hour, timezone, signal, log) {
 }
 function msUntilNextLocalHour(hour, timezone) {
   const now = Date.now();
-  const fmt = new Intl.DateTimeFormat("en-US", {
+  const hourFmt = new Intl.DateTimeFormat("en-US", {
     timeZone: timezone,
     hour: "numeric",
     hour12: false
   });
+  const detailFmt = new Intl.DateTimeFormat("en-US", {
+    timeZone: timezone,
+    minute: "numeric",
+    second: "numeric"
+  });
   for (let offsetMs = 6e4; offsetMs <= 25 * 36e5; offsetMs += 36e5) {
     const candidateMs = now + offsetMs;
-    const parts = fmt.formatToParts(new Date(candidateMs));
+    const parts = hourFmt.formatToParts(new Date(candidateMs));
     const hourPart = parts.find((p) => p.type === "hour");
     const candidateHour = parseInt(hourPart?.value ?? "-1", 10);
     if (candidateHour === hour) {
-      const candidate = new Date(candidateMs);
-      candidate.setUTCMinutes(0, 0, 0);
-      const snappedMs = candidate.getTime();
-      return Math.max(snappedMs - now, 6e4);
+      const detailParts = detailFmt.formatToParts(new Date(candidateMs));
+      const localMinute = parseInt(
+        detailParts.find((p) => p.type === "minute")?.value ?? "0",
+        10
+      );
+      const localSecond = parseInt(
+        detailParts.find((p) => p.type === "second")?.value ?? "0",
+        10
+      );
+      const snappedMs = candidateMs - localMinute * 6e4 - localSecond * 1e3;
+      if (snappedMs > now + 6e4) {
+        return snappedMs - now;
+      }
     }
   }
   return 24 * 36e5;
@@ -12749,50 +13110,6 @@ var init_registry = __esm({
   "src/tools/registry.ts"() {
   }
 });
-
-// src/util/logger.ts
-var logger_exports = {};
-__export(logger_exports, {
-  createLogger: () => createLogger,
-  logger: () => logger
-});
-function createLogger(component, minLevel = "info") {
-  const minLevelNum = LEVELS[minLevel];
-  function log(level, message, fields) {
-    if (LEVELS[level] < minLevelNum) return;
-    const entry = {
-      ts: (/* @__PURE__ */ new Date()).toISOString(),
-      level,
-      component,
-      msg: message,
-      ...fields
-    };
-    const line = JSON.stringify(entry);
-    if (level === "error" || level === "warn") {
-      process.stderr.write(line + "\n");
-    } else {
-      process.stdout.write(line + "\n");
-    }
-  }
-  return {
-    debug: (msg, fields) => log("debug", msg, fields),
-    info: (msg, fields) => log("info", msg, fields),
-    warn: (msg, fields) => log("warn", msg, fields),
-    error: (msg, fields) => log("error", msg, fields)
-  };
-}
-var LEVELS, logger;
-var init_logger = __esm({
-  "src/util/logger.ts"() {
-    LEVELS = {
-      debug: 0,
-      info: 1,
-      warn: 2,
-      error: 3
-    };
-    logger = createLogger("runtime");
-  }
-});
 function checkRateLimit(userId) {
   const now = Date.now();
   const entry = rateLimitMap.get(userId);
@@ -13244,8 +13561,6 @@ function runWorker(opts) {
   return query({
     prompt,
     options: {
-      debug: true,
-      debugFile: "/dev/stderr",
       stderr: (data) => {
         process.stderr.write(`[worker-sdk] ${data}
 `);
@@ -13863,6 +14178,9 @@ async function startAgent(opts) {
   }
   mkdirSync(config.stateDir, { recursive: true });
   mkdirSync(config.toolsDir, { recursive: true });
+  const logFile = join(config.stateDir, "runtime.log");
+  enableFileLogging(logFile);
+  log.info(`File logging enabled: ${logFile}`);
   if (config.tools.length > 0) {
     log.info(`Installing ${config.tools.length} tool package(s)...`);
     await installTools(config.tools, config.toolsDir, log);
@@ -14103,6 +14421,9 @@ if (command === "install") {
 } else if (command === "uninstall") {
   const { uninstall: uninstall2 } = await Promise.resolve().then(() => (init_uninstall(), uninstall_exports));
   uninstall2();
+} else if (command === "status") {
+  const { status: status2 } = await Promise.resolve().then(() => (init_status(), status_exports));
+  status2();
 } else {
   let handleShutdown = function(signal) {
     log.info(`Received ${signal} \u2014 shutting down...`);