@alook/cli 0.0.60 → 0.0.62

package/dist/meeting-runner.js

@@ -391,7 +391,8 @@ function ensureChrome() {
   return installed;
 }
 // daemon/meeting-runner.ts
-import { join as join2 } from "path";
+import { join as join3 } from "path";
+import { mkdirSync as mkdirSync2 } from "fs";
 
 // lib/platform.ts
 import { tmpdir } from "os";
@@ -521,8 +522,170 @@ function createLogger(opts) {
 }
 var log = createLogger();
 
+// daemon/execenv/timeline.ts
+import { appendFileSync, readFileSync, writeFileSync, renameSync } from "fs";
+import { join as join2 } from "path";
+
+// daemon/execenv/filelock.ts
+import { mkdirSync, rmdirSync, statSync } from "fs";
+var DEFAULT_STALE_MS = 3600000;
+function acquireLock(lockPath, staleMs = DEFAULT_STALE_MS) {
+  try {
+    mkdirSync(lockPath);
+    return true;
+  } catch {
+    try {
+      const stat = statSync(lockPath);
+      if (Date.now() - stat.mtimeMs > staleMs) {
+        rmdirSync(lockPath);
+        try {
+          mkdirSync(lockPath);
+          return true;
+        } catch {
+          return false;
+        }
+      }
+    } catch {
+      try {
+        mkdirSync(lockPath);
+        return true;
+      } catch {
+        return false;
+      }
+    }
+    return false;
+  }
+}
+function releaseLock(lockPath) {
+  try {
+    rmdirSync(lockPath);
+  } catch {}
+}
+
+// daemon/execenv/timeline.ts
+var log2 = createLogger({ module: "timeline" });
+function filenameForDate(date) {
+  const y = date.getFullYear();
+  const m = String(date.getMonth() + 1).padStart(2, "0");
+  const d = String(date.getDate()).padStart(2, "0");
+  return `${y}-${m}-${d}.jsonl`;
+}
+function todayFilename() {
+  return filenameForDate(new Date);
+}
+function recentFilenames(maxDays) {
+  const filenames = [];
+  const now = new Date;
+  for (let i = 0;i < maxDays; i++) {
+    const d = new Date(now);
+    d.setDate(d.getDate() - i);
+    filenames.push(filenameForDate(d));
+  }
+  return filenames;
+}
+function localISOString() {
+  const now = new Date;
+  const tzOffset = -now.getTimezoneOffset();
+  const sign = tzOffset >= 0 ? "+" : "-";
+  const absOffset = Math.abs(tzOffset);
+  const hh = String(Math.floor(absOffset / 60)).padStart(2, "0");
+  const mm = String(absOffset % 60).padStart(2, "0");
+  const y = now.getFullYear();
+  const mo = String(now.getMonth() + 1).padStart(2, "0");
+  const d = String(now.getDate()).padStart(2, "0");
+  const h = String(now.getHours()).padStart(2, "0");
+  const mi = String(now.getMinutes()).padStart(2, "0");
+  const s = String(now.getSeconds()).padStart(2, "0");
+  return `${y}-${mo}-${d}T${h}:${mi}:${s}${sign}${hh}:${mm}`;
+}
+function lockPathFor(timelineDir, filename) {
+  return join2(timelineDir, `.${filename}.lock`);
+}
+function initEntry(timelineDir, entry) {
+  const filename = todayFilename();
+  const filePath = join2(timelineDir, filename);
+  const lockPath = lockPathFor(timelineDir, filename);
+  try {
+    const acquired = acquireLock(lockPath);
+    if (!acquired) {
+      log2.debug(`Timeline initEntry: could not acquire lock for ${filename}`);
+      return;
+    }
+    try {
+      appendFileSync(filePath, JSON.stringify(entry) + `
+`);
+    } finally {
+      releaseLock(lockPath);
+    }
+  } catch (err) {
+    log2.debug("Timeline initEntry failed", err);
+  }
+}
+function updateEntry(timelineDir, taskId, updater) {
+  for (const filename of recentFilenames(7)) {
+    const filePath = join2(timelineDir, filename);
+    const lockPath = lockPathFor(timelineDir, filename);
+    try {
+      const acquired = acquireLock(lockPath);
+      if (!acquired) {
+        log2.debug(`Timeline updateEntry: lock held for ${filename}, skipping`);
+        continue;
+      }
+      try {
+        let content;
+        try {
+          content = readFileSync(filePath, "utf-8");
+        } catch {
+          continue;
+        }
+        const lines = content.trimEnd().split(`
+`);
+        let found = false;
+        const updated = lines.map((line) => {
+          const entry = JSON.parse(line);
+          if (entry.task_id === taskId) {
+            found = true;
+            updater(entry);
+          }
+          return JSON.stringify(entry);
+        });
+        if (!found)
+          continue;
+        const tmpPath = join2(timelineDir, `.${filename}.tmp`);
+        writeFileSync(tmpPath, updated.join(`
+`) + `
+`);
+        renameSync(tmpPath, filePath);
+        return;
+      } finally {
+        releaseLock(lockPath);
+      }
+    } catch (err) {
+      log2.debug(`Timeline updateEntry failed for ${filename}`, err);
+    }
+  }
+  log2.debug(`Timeline updateEntry: task_id ${taskId} not found in last 7 days`);
+}
+function createTimelineEntry(taskId, prompt, type, sessionId, pid, provider, contextKey, detailedLog) {
+  return {
+    task_id: taskId,
+    context_key: contextKey ?? null,
+    session_id: sessionId || null,
+    pid: pid ?? null,
+    status: "running",
+    datetime: localISOString(),
+    type,
+    prompt,
+    agent_responses: [],
+    errmsg: null,
+    provider: provider ?? null,
+    detailed_log: detailedLog ?? null
+  };
+}
+var RESUME_MAX_AGE_MS = 72 * 60 * 60 * 1000;
+
 // daemon/meeting-runner.ts
-var log2 = createLogger({ module: "meeting-runner" });
+var log3 = createLogger({ module: "meeting-runner" });
 var SCRAPE_INTERVAL_MS = 3000;
 var DEFAULT_BOT_NAME = "Alook Meeting Bot";
 var MAX_RETRY_DURATION_MS = 30 * 60 * 1000;
@@ -544,9 +707,9 @@ async function callbackWeb(input, status, transcript, error) {
       },
       body: payload
     });
-    log2.info(`callback ${status} → HTTP ${res.status}`, { meeting: input.meetingId });
+    log3.info(`callback ${status} → HTTP ${res.status}`, { meeting: input.meetingId });
   } catch (err) {
-    log2.error(`callback failed: ${err instanceof Error ? err.message : err}`, { meeting: input.meetingId });
+    log3.error(`callback failed: ${err instanceof Error ? err.message : err}`, { meeting: input.meetingId });
   }
 }
 function launchBrowser(chromePath) {
@@ -576,7 +739,7 @@ async function tryJoinAndRecord(input, chromePath) {
   try {
     const botName = input.agentName ? `${input.agentName} (Alook)` : DEFAULT_BOT_NAME;
     await joinMeeting(page, input.meetingUrl, botName);
-    log2.info("joined meeting, waiting for UI ready...", { meeting: input.meetingId });
+    log3.info("joined meeting, waiting for UI ready...", { meeting: input.meetingId });
     await waitForMeetingReady(page);
     await page.evaluate(() => {
       for (const btn of document.querySelectorAll("button")) {
@@ -586,11 +749,11 @@ async function tryJoinAndRecord(input, chromePath) {
         }
       }
     });
-    log2.info("meeting ready, enabling captions...", { meeting: input.meetingId });
+    log3.info("meeting ready, enabling captions...", { meeting: input.meetingId });
     await enableCaptions(page);
     await page.evaluate(buildCaptionObserverScript());
     await page.evaluate(buildAloneDetectorScript());
-    log2.info("captions enabled, scraping loop started", { meeting: input.meetingId });
+    log3.info("captions enabled, scraping loop started", { meeting: input.meetingId });
     let scrapeCount = 0;
     while (true) {
       try {
@@ -600,9 +763,9 @@ async function tryJoinAndRecord(input, chromePath) {
           const finalCaptions = parseCaptionElements(finalRaw);
           if (finalCaptions.length > 0) {
             transcript = deduplicateCaptions(transcript, finalCaptions, meetingStartMs, Date.now());
-            log2.debug(`final scrape: ${finalCaptions.length} caption(s), total ${transcript.length}`, { meeting: input.meetingId });
+            log3.debug(`final scrape: ${finalCaptions.length} caption(s), total ${transcript.length}`, { meeting: input.meetingId });
           }
-          log2.info("meeting ended (no longer active)", { meeting: input.meetingId });
+          log3.info("meeting ended (no longer active)", { meeting: input.meetingId });
           break;
         }
         const rawElements = await page.evaluate(buildCaptionScrapeScript());
@@ -612,13 +775,13 @@ async function tryJoinAndRecord(input, chromePath) {
           const prevLen = transcript.length;
           transcript = deduplicateCaptions(transcript, captions, meetingStartMs, Date.now());
           if (transcript.length > prevLen) {
-            log2.debug(`caption: ${captions[captions.length - 1].speaker}: "${captions[captions.length - 1].text}" (total ${transcript.length})`, { meeting: input.meetingId });
+            log3.debug(`caption: ${captions[captions.length - 1].speaker}: "${captions[captions.length - 1].text}" (total ${transcript.length})`, { meeting: input.meetingId });
           }
         } else if (scrapeCount <= 5) {
-          log2.debug(`scrape #${scrapeCount}: no captions yet`, { meeting: input.meetingId });
+          log3.debug(`scrape #${scrapeCount}: no captions yet`, { meeting: input.meetingId });
         }
       } catch (err) {
-        log2.error(`scrape error: ${err instanceof Error ? err.message : err}`, { meeting: input.meetingId });
+        log3.error(`scrape error: ${err instanceof Error ? err.message : err}`, { meeting: input.meetingId });
         break;
       }
       await new Promise((resolve) => setTimeout(resolve, SCRAPE_INTERVAL_MS));
@@ -628,27 +791,53 @@ async function tryJoinAndRecord(input, chromePath) {
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     if (msg.includes("Blocked from joining")) {
-      const screenshotPath = join2(tempDir("alook-meetings"), `meeting-${input.meetingId}-blocked.png`);
+      const screenshotPath = join3(tempDir("alook-meetings"), `meeting-${input.meetingId}-blocked.png`);
       await page.screenshot({ path: screenshotPath }).catch(() => {});
-      log2.warn(`blocked from joining, screenshot saved: ${screenshotPath}`, { meeting: input.meetingId });
+      log3.warn(`blocked from joining, screenshot saved: ${screenshotPath}`, { meeting: input.meetingId });
       return { status: "blocked", transcript, error: msg };
     }
-    log2.error(`unexpected error: ${msg}`, { meeting: input.meetingId });
+    log3.error(`unexpected error: ${msg}`, { meeting: input.meetingId });
     return { status: "error", transcript, error: msg };
   } finally {
     await page.close().catch(() => {});
     await browser.close().catch(() => {});
   }
 }
+function writeTimeline(input, status, responses, errmsg) {
+  if (!input.timelineDir)
+    return;
+  try {
+    mkdirSync2(input.timelineDir, { recursive: true });
+    const taskId = `meeting-${input.meetingId}`;
+    if (status === "running") {
+      const meetingLabel = input.title || input.meetingUrl;
+      const entry = createTimelineEntry(taskId, `Meeting: ${meetingLabel} (participants: ${input.participants.join(", ")})`, "meeting", undefined, process.pid);
+      initEntry(input.timelineDir, entry);
+    } else {
+      updateEntry(input.timelineDir, taskId, (entry) => {
+        entry.status = status;
+        entry.pid = null;
+        if (responses)
+          entry.agent_responses = responses;
+        if (errmsg)
+          entry.errmsg = errmsg;
+      });
+    }
+  } catch (err) {
+    log3.debug(`timeline write failed: ${err instanceof Error ? err.message : err}`);
+  }
+}
 async function run(input) {
-  log2.info(`starting meeting: url=${input.meetingUrl}`, { meeting: input.meetingId, workspace: input.workspaceId });
+  log3.info(`starting meeting: url=${input.meetingUrl}`, { meeting: input.meetingId, workspace: input.workspaceId });
+  writeTimeline(input, "running");
   let chromePath;
   try {
     chromePath = ensureChrome();
-    log2.debug(`chrome found: ${chromePath}`);
+    log3.debug(`chrome found: ${chromePath}`);
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
-    log2.error(`chrome setup failed: ${msg}`, { meeting: input.meetingId });
+    log3.error(`chrome setup failed: ${msg}`, { meeting: input.meetingId });
+    writeTimeline(input, "failed", undefined, `Chrome setup failed: ${msg}`);
     await callbackWeb(input, "failed", undefined, `Chrome setup failed: ${msg}`);
     process.exit(1);
   }
@@ -656,26 +845,33 @@ async function run(input) {
   let attempt = 0;
   while (true) {
     attempt++;
-    log2.info(attempt > 1 ? `retry attempt #${attempt}` : "launching browser (en-US, stealth)...", { meeting: input.meetingId });
+    log3.info(attempt > 1 ? `retry attempt #${attempt}` : "launching browser (en-US, stealth)...", { meeting: input.meetingId });
     const result = await tryJoinAndRecord(input, chromePath);
     if (result.status === "completed") {
       const transcriptText = formatTranscript(result.transcript);
-      log2.info(`completed: ${result.transcript.length} transcript entries`, { meeting: input.meetingId });
+      log3.info(`completed: ${result.transcript.length} transcript entries`, { meeting: input.meetingId });
+      const transcriptR2Key = `meetings/${input.meetingId}/transcript`;
+      writeTimeline(input, "completed", [
+        `Meeting completed. ${result.transcript.length} transcript entries captured.`,
+        `Transcript stored at: ${transcriptR2Key}`
+      ]);
       await callbackWeb(input, "completed", transcriptText);
       return;
     }
     if (result.status === "blocked") {
       const elapsed = Date.now() - startTime;
       if (elapsed >= MAX_RETRY_DURATION_MS) {
-        log2.warn(`giving up after ${Math.round(elapsed / 60000)}min of retries`, { meeting: input.meetingId });
+        log3.warn(`giving up after ${Math.round(elapsed / 60000)}min of retries`, { meeting: input.meetingId });
+        writeTimeline(input, "failed", undefined, result.error);
         await callbackWeb(input, "failed", undefined, result.error);
         return;
       }
       const backoff = RETRY_BACKOFF[Math.min(attempt - 1, RETRY_BACKOFF.length - 1)];
-      log2.info(`blocked, retrying in ${backoff / 1000}s (attempt=${attempt}, elapsed=${Math.round(elapsed / 60000)}min)`, { meeting: input.meetingId });
+      log3.info(`blocked, retrying in ${backoff / 1000}s (attempt=${attempt}, elapsed=${Math.round(elapsed / 60000)}min)`, { meeting: input.meetingId });
       await new Promise((resolve) => setTimeout(resolve, backoff));
       continue;
     }
+    writeTimeline(input, "failed", undefined, result.error);
     await callbackWeb(input, "failed", undefined, result.error);
     return;
   }
@@ -687,6 +883,6 @@ if (!encoded) {
 }
 var input = JSON.parse(Buffer.from(encoded, "base64").toString("utf-8"));
 run(input).then(() => process.exit(0)).catch((err) => {
-  log2.error(`fatal: ${err instanceof Error ? err.message : err}`);
+  log3.error(`fatal: ${err instanceof Error ? err.message : err}`);
   process.exit(1);
 });

package/dist/session-runner.js

@@ -11542,7 +11542,7 @@ function finalize(ctx, schema) {
     result.$schema = "http://json-schema.org/draft-07/schema#";
   } else if (ctx.target === "draft-04") {
     result.$schema = "http://json-schema.org/draft-04/schema#";
-  } else if (ctx.target === "openapi-3.0") {} else {}
+  } else if (ctx.target === "openapi-3.0") {}
   if (ctx.external?.uri) {
     const id = ctx.external.registry.get(schema)?.id;
     if (!id)
@@ -11786,7 +11786,7 @@ var literalProcessor = (schema, ctx, json, _params) => {
     if (val === undefined) {
       if (ctx.unrepresentable === "throw") {
         throw new Error("Literal `undefined` cannot be represented in JSON Schema");
-      } else {}
+      }
     } else if (typeof val === "bigint") {
       if (ctx.unrepresentable === "throw") {
         throw new Error("BigInt literals cannot be represented in JSON Schema");
@@ -14449,7 +14449,9 @@ var PollMeetingItemSchema = exports_external.object({
   meeting_url: exports_external.string(),
   participants: exports_external.array(exports_external.string()),
   workspace_id: exports_external.string(),
-  agent_name: exports_external.string()
+  agent_id: exports_external.string(),
+  agent_name: exports_external.string(),
+  title: exports_external.string().optional()
 });
 var PollResponseSchema = exports_external.object({
   tasks: exports_external.array(TaskApiSchema),
@@ -14484,6 +14486,7 @@ var RegisterDaemonRequestSchema = exports_external.object({
   daemon_id: exports_external.string().min(1),
   device_name: exports_external.string().optional().default(""),
   cli_version: exports_external.string().optional().default(""),
+  workspaces_root: exports_external.string().optional().default(""),
   runtimes: exports_external.array(DaemonRuntimeItemSchema).min(1)
 });
 var DeregisterRequestSchema = exports_external.object({
@@ -14692,7 +14695,8 @@ var EmailNotifyRequestSchema = exports_external.object({
   meetingInfo: MeetingInfoSchema.nullable().optional(),
   attachments: exports_external.string().optional(),
   traceId: exports_external.string().optional(),
-  sourceTaskId: exports_external.string().optional()
+  sourceTaskId: exports_external.string().optional(),
+  isInternal: exports_external.boolean().optional().default(false)
 });
 var CreateEmailAccountSchema = exports_external.object({
   emailAddress: exports_external.string().email("valid email required"),
@@ -16591,6 +16595,17 @@ var machineToken = sqliteTable("machine_token", {
   lastUsedAt: text("last_used_at"),
   createdAt: text("created_at").notNull().$defaultFn(() => new Date().toISOString())
 }, (t) => [index("idx_machine_token").on(t.token)]);
+var messageFlag = sqliteTable("message_flag", {
+  id: text("id").primaryKey().$defaultFn(() => nanoid3()),
+  messageId: text("message_id").notNull().references(() => message.id, { onDelete: "cascade" }),
+  userId: text("user_id").notNull().references(() => user.id, { onDelete: "cascade" }),
+  workspaceId: text("workspace_id").notNull().references(() => workspace.id, { onDelete: "cascade" }),
+  createdAt: text("created_at").notNull().$defaultFn(() => new Date().toISOString())
+}, (t) => [
+  unique("message_flag_message_user").on(t.messageId, t.userId),
+  index("idx_message_flag_ws_user_created").on(t.workspaceId, t.userId, t.createdAt),
+  index("idx_message_flag_message_user").on(t.messageId, t.userId)
+]);
 var conversationMap = sqliteTable("conversation_map", {
   id: text("id").primaryKey().$defaultFn(() => nanoid3()),
   key: text("key").notNull(),
@@ -16671,6 +16686,28 @@ var RESERVED_HANDLES = new Set([
 function toAlookAddress(h) {
   return `${h}${DOMAIN}`;
 }
+// ../shared/src/mode.ts
+function resolveMode(signals) {
+  if (signals.nodeEnv === "development" && !signals.cmdPrefix)
+    return "dev";
+  if (signals.serverUrl && !signals.cmdPrefix)
+    return "dev";
+  if (signals.cmdPrefix)
+    return "app";
+  if (signals.hostname && ["localhost", "127.0.0.1"].includes(signals.hostname))
+    return "app";
+  return "production";
+}
+function cliCommand(mode) {
+  switch (mode) {
+    case "dev":
+      return "pnpm dev:cli";
+    case "app":
+      return "npx @alook/app cli";
+    case "production":
+      return "npx @alook/cli";
+  }
+}
 // daemon/client.ts
 class DaemonClient {
   baseURL;
@@ -17743,6 +17780,14 @@ function tempDir(subdir) {
   return join(tmpdir(), subdir);
 }
 
+// lib/env.ts
+function cmdPrefix() {
+  return process.env.ALOOK_CMD_PREFIX || cliCommand(resolveMode({
+    serverUrl: process.env.ALOOK_SERVER_URL,
+    cmdPrefix: process.env.ALOOK_CMD_PREFIX
+  }));
+}
+
 // daemon/execenv/context.ts
 import {
   writeFileSync,
@@ -17881,12 +17926,12 @@ ${lines.join(`
 
 ### Emails
 ---
-Run 'npx @alook/cli email pull --agent_id ${task.agentId} --status unread' to download unread emails from inbox to '${tempDir("alook-emails")}/${task.workspaceId}/${task.agentId}/'.
+Run '${cmdPrefix()} email pull --agent_id ${task.agentId} --status unread' to download unread emails from inbox to '${tempDir("alook-emails")}/${task.workspaceId}/${task.agentId}/'.
 ---
-To download sent emails, add '--folder sent': 'npx @alook/cli email pull --agent_id ${task.agentId} --folder sent'
+To download sent emails, add '--folder sent': '${cmdPrefix()} email pull --agent_id ${task.agentId} --folder sent'
 Valid folders: inbox (default), sent, untrust.
 To limit the number of emails downloaded, add '--limit <N>' (e.g. '--limit 20'). Use '--offset <N>' to skip emails for pagination.
-Example: 'npx @alook/cli email pull --agent_id ${task.agentId} --status unread --limit 20 --offset 0'
+Example: '${cmdPrefix()} email pull --agent_id ${task.agentId} --status unread --limit 20 --offset 0'
 ---
 Each email is saved to '${tempDir("alook-emails")}/${task.workspaceId}/${task.agentId}/<emailId>/' with:
 - 'metadata.json' — sender, recipient, subject, date, status, message_id, in_reply_to, references
@@ -17895,40 +17940,40 @@ Each email is saved to '${tempDir("alook-emails")}/${task.workspaceId}/${task.ag
 - 'attachments/' — extracted attachment files (if any)
 ---
 Before starting to process an INBOX email, mark it as read:
-- Run 'npx @alook/cli email set --agent_id ${task.agentId} --email_id <EMAIL_ID> --status read'
+- Run '${cmdPrefix()} email set --agent_id ${task.agentId} --email_id <EMAIL_ID> --status read'
 ---
 
 #### Sending a new email
 Write the HTML body to a file first, then send it. The body is forwarded as-is (HTML).
-- Run 'npx @alook/cli email send --agent_id ${task.agentId} --to <ADDRESS> --subject "<SUBJECT>" --body-file <PATH_TO_HTML>'
+- Run '${cmdPrefix()} email send --agent_id ${task.agentId} --to <ADDRESS> --subject "<SUBJECT>" --body-file <PATH_TO_HTML>'
 - To send from a specific mailbox, add '--from <YOUR_EMAIL_ADDRESS>'. Without '--from', the default Alook address is used.
 - Attach files with '--attachment <PATH>' — repeat the flag for multiple attachments. Each file is uploaded before sending.
-- Example: 'npx @alook/cli email send --agent_id ${task.agentId} --to foo@bar.com --subject "Weekly report" --body-file /tmp/body.html --from alice@company.com --attachment /tmp/report.pdf'
+- Example: '${cmdPrefix()} email send --agent_id ${task.agentId} --to foo@bar.com --subject "Weekly report" --body-file /tmp/body.html --from alice@company.com --attachment /tmp/report.pdf'
 
 #### Replying to an email
 To reply to an email, add '--in-reply-to <EMAIL_ID>' to the send command. This sets the correct email threading headers so the recipient's email client groups the reply into the same conversation thread.
 - Use 'Re: <original subject>' as the subject.
 - Quote the original email body in your reply (wrap it in a blockquote).
 - The <EMAIL_ID> is the Alook email id from metadata.json (not the message_id header).
-- Example: 'npx @alook/cli email send --agent_id ${task.agentId} --to sender@example.com --subject "Re: Bug report" --body-file /tmp/reply.html --in-reply-to <EMAIL_ID>'
+- Example: '${cmdPrefix()} email send --agent_id ${task.agentId} --to sender@example.com --subject "Re: Bug report" --body-file /tmp/reply.html --in-reply-to <EMAIL_ID>'
 Tips:
 - If you think the task will take a while, consider sending a short "I'm on it" style email reply first to reassure the sender.
 ---
 
 #### Forwarding an email
 Forward any email to a new recipient, with an optional note prepended above the original content. All original attachments are re-attached automatically.
-- Run 'npx @alook/cli email forward --agent_id ${task.agentId} --email_id <EMAIL_ID> --to <RECIPIENT>'
+- Run '${cmdPrefix()} email forward --agent_id ${task.agentId} --email_id <EMAIL_ID> --to <RECIPIENT>'
 - Add '--note "FYI, see the request below."' to prepend a note above the forwarded body.
 - Add '--from <YOUR_EMAIL_ADDRESS>' to send from a specific mailbox.
 - Add '--attachment <PATH>' to attach extra files (repeatable).
-- Example: 'npx @alook/cli email forward --agent_id ${task.agentId} --email_id em_abc --to boss@company.com --note "FYI" --attachment /tmp/summary.pdf'
+- Example: '${cmdPrefix()} email forward --agent_id ${task.agentId} --email_id em_abc --to boss@company.com --note "FYI" --attachment /tmp/summary.pdf'
 ---
 
 #### Email Whitelist (Allowed Senders)
 Manage which email addresses are allowed to send you emails.
-- List: 'npx @alook/cli email whitelist list --agent_id ${task.agentId}' (add '--json' for machine-readable output)
-- Add: 'npx @alook/cli email whitelist add --agent_id ${task.agentId} <EMAIL_ADDRESS>'
-- Remove: 'npx @alook/cli email whitelist delete --agent_id ${task.agentId} <EMAIL_ADDRESS>'
+- List: '${cmdPrefix()} email whitelist list --agent_id ${task.agentId}' (add '--json' for machine-readable output)
+- Add: '${cmdPrefix()} email whitelist add --agent_id ${task.agentId} <EMAIL_ADDRESS>'
+- Remove: '${cmdPrefix()} email whitelist delete --agent_id ${task.agentId} <EMAIL_ADDRESS>'
 ---
 `;
   }
@@ -17936,7 +17981,7 @@ Manage which email addresses are allowed to send you emails.
 ### Artifacts
 Upload files for your owner to review in the app.
 - Your current conversation id is available via env var: $ALOOK_CONVERSATION_ID
-- Run 'npx @alook/cli sync upload-artifact --agent_id ${task.agentId} --conversation_id $ALOOK_CONVERSATION_ID --file <PATH>'
+- Run '${cmdPrefix()} sync upload-artifact --agent_id ${task.agentId} --conversation_id $ALOOK_CONVERSATION_ID --file <PATH>'
 - Use this after generating plans, reports, or any file the owner should review.
 - You response will be rendered in remote server, so don't output link format with local path in your response (cause user can click it and jump to nowheres)
 - If you think user may need to know any file detail, use upload-artifact tool to send the file to user.
@@ -17958,26 +18003,26 @@ Schedule future tasks for yourself. At the scheduled time, a new task is dispatc
 Keep the event title informative and concise, less than 20 words.
 Place the event details in description.
 Create a one-off event:
-- Run 'npx @alook/cli calendar set --agent_id ${task.agentId} --event_title "<TASK_TITLE>" --description "<TASK_BODY>" --datetime <YYYY-MM-DDTHH:MM>'
+- Run '${cmdPrefix()} calendar set --agent_id ${task.agentId} --event_title "<TASK_TITLE>" --description "<TASK_BODY>" --datetime <YYYY-MM-DDTHH:MM>'
   - '--datetime' is LOCAL time, format 'YYYY-MM-DDTHH:MM' (e.g. '2026-04-17T09:30'). Do NOT pass UTC / ISO strings with 'Z'.
   - '--event_title' becomes the task prompt when the event fires — write it as the instruction you want future-you to receive.
 
 Create a repeating event:
 - Add '--repeat <interval>' where interval is like '1day', '2hour', '1week', '1month'.
 - Optionally add '--repeat_stop_date <YYYY-MM-DD>' to stop the recurrence (local date).
-- Example: 'npx @alook/cli calendar set --agent_id ${task.agentId} --event_title "<REPEAT_TASK_TITLE>" --description "<REPEAT_TASK_BODY>" --datetime 2026-04-18T09:00 --repeat 1day --repeat_stop_date 2026-05-18'
+- Example: '${cmdPrefix()} calendar set --agent_id ${task.agentId} --event_title "<REPEAT_TASK_TITLE>" --description "<REPEAT_TASK_BODY>" --datetime 2026-04-18T09:00 --repeat 1day --repeat_stop_date 2026-05-18'
 ---
 List upcoming events:
-- Run 'npx @alook/cli calendar list --agent_id ${task.agentId}' (defaults: next 30 days, past 0 days).
+- Run '${cmdPrefix()} calendar list --agent_id ${task.agentId}' (defaults: next 30 days, past 0 days).
 - Tune the window with '--future_days <N>' and '--past_days <N>'. Add '--json' for machine-readable output.
 - 'list' shows a '[has description]' badge instead of the full description — use 'show' (below) to read it.
 
 Show full detail of one event (use this to read the description):
-- Run 'npx @alook/cli calendar show --agent_id ${task.agentId} --event_id <EVENT_ID>'
+- Run '${cmdPrefix()} calendar show --agent_id ${task.agentId} --event_id <EVENT_ID>'
 - Add '--json' for machine-readable output.
 
 Edit an existing event (preserves event id and recurring state):
-- Run 'npx @alook/cli calendar update --agent_id ${task.agentId} --event_id <EVENT_ID> [flags]'
+- Run '${cmdPrefix()} calendar update --agent_id ${task.agentId} --event_id <EVENT_ID> [flags]'
 - Supply only the fields you want to change. Available flags:
   - '--event_title "<t>"' — rename the event / change the fire-time prompt
   - '--description "<d>"' to set, or '--clear_description' to remove
@@ -17987,7 +18032,7 @@ Edit an existing event (preserves event id and recurring state):
 - Passing no mutating flag is an error. Do NOT use 'delete' + 'set' to edit — that loses the event id and the recurring 'last fired' state.
 
 Delete an event:
-- Run 'npx @alook/cli calendar delete --agent_id ${task.agentId} --event_id <EVENT_ID>'
+- Run '${cmdPrefix()} calendar delete --agent_id ${task.agentId} --event_id <EVENT_ID>'
 ---
 `;
   return content;
@@ -18410,7 +18455,7 @@ function clearKillIntent(baseDir, taskId) {
 // daemon/prompt.ts
 var DM_RESPONSE_NOTICE = "IMPORTANT: Only your final text response is visible to the user." + " Tool calls, intermediate reasoning, and mid-process outputs are NOT displayed." + " Put all key information, answers, and conclusions in your final response — that is the only thing the user will read.";
 var EMAIL_NOTICE = "This task was triggered automatically by an incoming email. There is no human in this session." + " If you need to communicate with a human, you MUST send an email using the email sending tool." + " If you need more information or confirmation from the human, send them an email asking for it and then exit." + " Do not wait — when the human replies, a new task will be triggered automatically and you will be woken up with their response.";
-var ISSUE_NOTICE = "This task was triggered by an assigned issue. The issue_id is provided in this message." + " Use `alook issue show --agent_id <your_agent_id> --issue_id <issue_id>` to read full context." + " Use `alook issue update --agent_id <your_agent_id> --issue_id <issue_id> --status <status>` to change status." + " Use `alook issue comment --agent_id <your_agent_id> --issue_id <issue_id> --body <text>` to leave a comment." + " CRITICAL — You MUST update the issue status before you finish. This is NOT optional:" + " 1. Set status to 'in_progress' when you start working." + " 2. Set status to 'review' as your LAST action before exiting — this means your work is done and ready for the owner to review. You cannot improve the issue further without user feedback." + " If you delegated work to colleagues, wait for their responses, then set 'review' once everything is complete." + " NEVER exit without updating the status. A task left in 'in_progress' is a failed task." + " Always leave a comment summarizing what you did before changing status to 'review'.";
+var ISSUE_NOTICE = "This task was triggered by an assigned issue. The issue_id is provided in this message." + " Use `alook issue show --agent_id <your_agent_id> --issue_id <issue_id>` to read full context." + " Use `alook issue update --agent_id <your_agent_id> --issue_id <issue_id> --status <status>` to change status." + " Use `alook issue comment --agent_id <your_agent_id> --issue_id <issue_id> --body <text>` to leave a comment." + " CRITICAL — You MUST manage the issue status correctly. This is NOT optional:" + " 1. Set status to 'in_progress' when you start working." + " 2. If you complete the work yourself: leave a summary comment, then set status to 'review' as your last action. 'review' means there is actual completed work (code, artifact, result) ready for the owner to look at." + " 3. If you delegated work to colleagues and are waiting for their response: KEEP status as 'in_progress' and exit. This is expected — you will be woken up when they reply. Set 'review' only after all delegated work is confirmed complete." + " 4. NEVER set 'review' unless there is concrete completed work for the owner to review. Sending a plan to a colleague is NOT completed work." + " NEVER exit without doing at least one of: updating the status, or leaving a comment explaining what you did and what you're waiting for.";
 function buildDmNotice(name, email3) {
   return `This task was triggered by an incoming email on a conversation with ${name} (${email3}).` + ` ${name} is present in this session — reply to them directly.` + ` If you need to communicate with anyone else, use the email sending tool.`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alook/cli",
-  "version": "0.0.60",
+  "version": "0.0.62",
   "description": "Alook CLI — Enable Your Person Colleague",
   "license": "Apache-2.0",
   "homepage": "https://github.com/alookai/alook#readme",
@@ -41,6 +41,7 @@
     "build": "bun build src/index.ts --outdir dist --target node --format esm --external citty --external commander --external postal-mime --external playwright-core && bun build daemon/session-runner.ts --outdir dist --target node --format esm --external citty --external commander --external postal-mime && bun build daemon/meeting-runner.ts --outdir dist --target node --format esm --external playwright-core && node scripts/prepare-dist.mjs",
     "prepack": "pnpm run build",
     "test": "vitest run",
+    "lint": "eslint .",
     "typecheck": "tsc --noEmit -p tsconfig.build.json"
   },
   "dependencies": {
@@ -52,7 +53,9 @@
   "devDependencies": {
     "@alook/shared": "workspace:*",
     "@types/bun": "^1.3.13",
+    "eslint": "^10.3.0",
     "typescript": "^6.0.3",
+    "typescript-eslint": "^8.59.3",
     "vitest": "^4.1.5"
   }
 }