@alook/cli 0.0.8 → 0.0.10

package/dist/index.js

@@ -15,7 +15,7 @@ var __export = (target, all) => {
 };
 
 // src/index.ts
-import { Command as Command9 } from "commander";
+import { Command as Command10 } from "commander";
 
 // commands/register.ts
 import { Command } from "commander";
@@ -167,7 +167,8 @@ function saveCLIConfigForProfile(profile, profileConfig) {
 // commands/register.ts
 function isCommandAvailable(cmd) {
   try {
-    execSync(`which ${cmd}`, { stdio: "ignore" });
+    const check = process.platform === "win32" ? `where ${cmd}` : `which ${cmd}`;
+    execSync(check, { stdio: "ignore" });
     return true;
   } catch {
     return false;
@@ -13864,6 +13865,7 @@ var ClaimedTaskRowSchema = exports_external.object({
   result: exports_external.unknown().nullable(),
   context: exports_external.unknown().nullable(),
   type: exports_external.string().default(TASK_TYPES.USER_DM_MESSAGE),
+  contextKey: exports_external.string().nullable().optional(),
   sessionId: exports_external.string().nullable(),
   createdAt: exports_external.coerce.date(),
   dispatchedAt: exports_external.coerce.date().nullable(),
@@ -13893,7 +13895,9 @@ var TaskApiBaseSchema = exports_external.object({
   result: exports_external.unknown().nullable(),
   error: exports_external.string().nullable(),
   created_at: exports_external.string(),
-  type: exports_external.string()
+  type: exports_external.string(),
+  context_key: exports_external.string().nullable().optional(),
+  context: exports_external.unknown().nullable().optional()
 });
 var TaskApiSchema = TaskApiBaseSchema.extend({
   agent: TaskAgentDataApiSchema.nullable().optional()
@@ -14012,6 +14016,64 @@ var CalendarEventApiSchema = exports_external.object({
 var AddWhitelistRequestSchema = exports_external.object({
   email: exports_external.string().email()
 });
+var RuntimeConfigSchema = exports_external.object({ model: exports_external.string().max(100).optional() }).passthrough().optional();
+var CreateAgentRequestSchema = exports_external.object({
+  name: exports_external.string().min(1, "name is required"),
+  description: exports_external.string().optional().default(""),
+  instructions: exports_external.string().optional().default(""),
+  runtime_id: exports_external.string().min(1, "runtime_id is required"),
+  runtime_config: RuntimeConfigSchema,
+  max_concurrent_tasks: exports_external.number().int().optional(),
+  email_handle: exports_external.string().optional()
+});
+var UpdateAgentRequestSchema = exports_external.object({
+  name: exports_external.string().min(1).optional(),
+  description: exports_external.string().optional(),
+  instructions: exports_external.string().optional(),
+  runtime_id: exports_external.string().min(1).optional(),
+  runtime_config: RuntimeConfigSchema
+}).refine((v) => v.name !== undefined || v.description !== undefined || v.instructions !== undefined || v.runtime_id !== undefined || v.runtime_config !== undefined, { message: "at least one field is required" });
+var CreateConversationRequestSchema = exports_external.object({
+  agent_id: exports_external.string().min(1, "agent_id is required")
+});
+var CreateMessageRequestSchema = exports_external.object({
+  content: exports_external.string().min(1, "content is required")
+});
+var EmailAttachmentSchema = exports_external.object({
+  key: exports_external.string().min(1),
+  filename: exports_external.string().min(1),
+  size: exports_external.number().int().nonnegative().optional(),
+  contentType: exports_external.string().min(1)
+});
+var SendEmailRequestSchema = exports_external.object({
+  agentId: exports_external.string().min(1, "agentId is required"),
+  to: exports_external.string().min(1, "to is required"),
+  subject: exports_external.string().min(1, "subject is required"),
+  htmlBody: exports_external.string().default(""),
+  inReplyTo: exports_external.string().optional(),
+  references: exports_external.string().optional(),
+  attachments: exports_external.array(EmailAttachmentSchema).optional()
+});
+var UpdateEmailStatusRequestSchema = exports_external.object({
+  status: exports_external.enum(["unread", "read", "archived"])
+});
+var EmailNotifyRequestSchema = exports_external.object({
+  agentId: exports_external.string().min(1),
+  workspaceId: exports_external.string().min(1),
+  r2Key: exports_external.string().min(1),
+  from: exports_external.string().min(1),
+  to: exports_external.string().optional(),
+  subject: exports_external.string().min(1),
+  isWhitelisted: exports_external.boolean(),
+  forwarded: exports_external.boolean().optional().default(false),
+  messageId: exports_external.string().optional().default(""),
+  inReplyTo: exports_external.string().optional().default(""),
+  references: exports_external.string().optional().default("")
+});
+var CreateWorkspaceRequestSchema = exports_external.object({
+  name: exports_external.string().min(1, "name is required"),
+  slug: exports_external.string().min(1, "slug is required")
+});
 // ../../node_modules/.pnpm/drizzle-orm@0.45.2_@cloudflare+workers-types@4.20260418.1_@opentelemetry+api@1.9.1_bun-types@1.3.12_kysely@0.28.16/node_modules/drizzle-orm/entity.js
 var entityKind = Symbol.for("drizzle:entityKind");
 var hasOwnEntityKind = Symbol.for("drizzle:hasOwnEntityKind");
@@ -15518,6 +15580,7 @@ var message = sqliteTable("message", {
   role: text("role").notNull(),
   content: text("content").notNull().default(""),
   taskId: text("task_id"),
+  attachmentIds: text("attachment_ids"),
   createdAt: text("created_at").notNull().$defaultFn(() => new Date().toISOString())
 });
 var agentTaskQueue = sqliteTable("agent_task_queue", {
@@ -15528,6 +15591,7 @@ var agentTaskQueue = sqliteTable("agent_task_queue", {
   conversationId: text("conversation_id").notNull().references(() => conversation.id),
   prompt: text("prompt").notNull(),
   type: text("type").notNull().default(TASK_TYPES.USER_DM_MESSAGE),
+  contextKey: text("context_key"),
   status: text("status").notNull().default("queued"),
   priority: integer2("priority").notNull().default(0),
   result: text("result", { mode: "json" }),
@@ -15601,6 +15665,24 @@ var calendarEvent = sqliteTable("calendar_event", {
     foreignColumns: [agent.id, agent.workspaceId]
   }).onDelete("cascade")
 ]);
+var artifact = sqliteTable("artifact", {
+  id: text("id").primaryKey().$defaultFn(() => "art_" + nanoid3()),
+  conversationId: text("conversation_id").notNull().references(() => conversation.id, { onDelete: "cascade" }),
+  agentId: text("agent_id").notNull(),
+  workspaceId: text("workspace_id").notNull().references(() => workspace.id, { onDelete: "cascade" }),
+  filename: text("filename").notNull(),
+  contentType: text("content_type").notNull().default("application/octet-stream"),
+  size: integer2("size").notNull(),
+  r2Key: text("r2_key").notNull(),
+  source: text("source").notNull().default("agent"),
+  createdAt: text("created_at").notNull().$defaultFn(() => new Date().toISOString())
+}, (t) => [
+  index("idx_artifact_conversation").on(t.conversationId),
+  foreignKey({
+    columns: [t.agentId, t.workspaceId],
+    foreignColumns: [agent.id, agent.workspaceId]
+  }).onDelete("cascade")
+]);
 var machineToken = sqliteTable("machine_token", {
   id: text("id").primaryKey().$defaultFn(() => nanoid3()),
   userId: text("user_id").notNull().references(() => user.id, { onDelete: "cascade" }),
@@ -15697,6 +15779,16 @@ class DaemonClient {
       error: error48
     });
   }
+  async getArtifactMeta(token, artifactId, workspaceId) {
+    return this.request("GET", `/api/artifacts/${artifactId}?workspace_id=${encodeURIComponent(workspaceId)}`, token);
+  }
+  async downloadArtifact(token, artifactId, workspaceId) {
+    const res = await fetch(`${this.baseURL}/api/artifacts/${artifactId}/content?workspace_id=${encodeURIComponent(workspaceId)}`, { headers: { Authorization: `Bearer ${token}` } });
+    if (!res.ok) {
+      throw new Error(`artifact download failed: HTTP ${res.status}`);
+    }
+    return res.arrayBuffer();
+  }
   reportMessages(token, taskId, messages) {
     return this.request("POST", `/api/daemon/tasks/${taskId}/messages`, token, { messages });
   }
@@ -15866,6 +15958,8 @@ function fromApiTask(api2) {
     status: api2.status,
     priority: api2.priority,
     type: api2.type,
+    contextKey: api2.context_key ?? null,
+    context: api2.context ?? undefined,
     agent: api2.agent ? { name: api2.agent.name, instructions: api2.agent.instructions, emailHandle: api2.agent.email_handle ?? undefined, userEmail: api2.agent.user_email ?? undefined, runtimeConfig: api2.agent.runtime_config ?? undefined } : undefined,
     repos: undefined,
     createdAt: api2.created_at
@@ -16077,7 +16171,8 @@ var _dir = dirname3(fileURLToPath2(import.meta.url));
 var sessionRunnerPath = existsSync(join4(_dir, "session-runner.js")) ? join4(_dir, "session-runner.js") : join4(_dir, "session-runner.ts");
 function isCommandAvailable2(cmd) {
   try {
-    execSync3(`which ${cmd}`, { stdio: "ignore" });
+    const check2 = process.platform === "win32" ? `where ${cmd}` : `which ${cmd}`;
+    execSync3(check2, { stdio: "ignore" });
     return true;
   } catch {
     return false;
@@ -16178,7 +16273,16 @@ async function startDaemon(profile, serverUrl) {
         runtimes
       });
     } catch (e) {
-      log.error(`Failed to register workspace ${ws.id}, skipping`, e);
+      if (e instanceof Error && e.message.startsWith("HTTP 401")) {
+        log.warn(`Workspace ${ws.id} token invalid — removing from config`);
+        try {
+          const cfg = loadCLIConfigForProfile(profile);
+          cfg.watched_workspaces = (cfg.watched_workspaces || []).filter((w) => w.id !== ws.id);
+          saveCLIConfigForProfile(profile, cfg);
+        } catch {}
+      } else {
+        log.error(`Failed to register workspace ${ws.id}, skipping`, e);
+      }
       continue;
     }
     log.info(`Workspace ${ws.id} registered — ${resp.runtimes.length} runtime(s)`);
@@ -16270,7 +16374,11 @@ async function startDaemon(profile, serverUrl) {
           });
         }
       } catch (e) {
-        log.debug("Poll error", e);
+        if (e instanceof Error && e.message.startsWith("HTTP 401")) {
+          evictedIds.push(ws.workspaceId);
+        } else {
+          log.debug("Poll error", e);
+        }
       }
     }
     for (const id of evictedIds) {
@@ -17015,8 +17123,83 @@ ${result.output}`);
   return cmd;
 }
 
+// commands/sync.ts
+import { Command as Command9 } from "commander";
+import { readFileSync as readFileSync5, statSync as statSync3 } from "fs";
+import { basename as basename2 } from "path";
+var MIME_BY_EXT2 = {
+  ".pdf": "application/pdf",
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".gif": "image/gif",
+  ".txt": "text/plain",
+  ".html": "text/html",
+  ".json": "application/json",
+  ".csv": "text/csv",
+  ".md": "text/markdown",
+  ".ts": "text/typescript",
+  ".js": "text/javascript",
+  ".yaml": "text/yaml",
+  ".yml": "text/yaml",
+  ".svg": "image/svg+xml",
+  ".xml": "application/xml",
+  ".zip": "application/zip"
+};
+function guessContentType2(filename) {
+  const idx = filename.lastIndexOf(".");
+  if (idx < 0)
+    return "application/octet-stream";
+  const ext = filename.slice(idx).toLowerCase();
+  return MIME_BY_EXT2[ext] ?? "application/octet-stream";
+}
+function resolveClientOpts3(command, agentId) {
+  const parentOpts = command.parent?.parent?.opts() || {};
+  const profile = parentOpts.profile;
+  const cfg = loadCLIConfigForProfile(profile);
+  const serverUrl = parentOpts.server || cfg.server_url;
+  const workspaces = cfg.watched_workspaces || [];
+  const ws = workspaces.find((w) => w.agent_ids?.includes(agentId));
+  if (!ws || !ws.token) {
+    console.error(`Error: no registered workspace contains agent ${agentId}. Run '${cmdPrefix()} register --token <token>' first.`);
+    process.exit(1);
+  }
+  return { serverUrl, token: ws.token, workspaceId: ws.id };
+}
+function syncCommand() {
+  const cmd = new Command9("sync").description("File sync utilities");
+  cmd.command("upload-artifact").description("Upload a file artifact to a conversation").requiredOption("--agent_id <id>", "Agent ID").requiredOption("--conversation_id <id>", "Conversation ID").requiredOption("--file <path>", "Path to file to upload").action(async (opts, command) => {
+    const { serverUrl, token, workspaceId } = resolveClientOpts3(command, opts.agent_id);
+    const client = new APIClient(serverUrl, token, workspaceId);
+    let bytes;
+    let size;
+    try {
+      const stat = statSync3(opts.file);
+      size = stat.size;
+      bytes = readFileSync5(opts.file);
+    } catch (err) {
+      console.error(`Error: cannot read file "${opts.file}": ${err.message}`);
+      process.exit(1);
+    }
+    const filename = basename2(opts.file);
+    const contentType = guessContentType2(filename);
+    const form = new FormData;
+    form.append("file", new Blob([new Uint8Array(bytes)], { type: contentType }), filename);
+    form.append("agent_id", opts.agent_id);
+    form.append("conversation_id", opts.conversation_id);
+    try {
+      const result = await client.postMultipart("/api/artifacts/upload", form);
+      printJSON(result);
+    } catch (err) {
+      console.error(`Error uploading artifact: ${err.message}`);
+      process.exit(1);
+    }
+  });
+  return cmd;
+}
+
 // src/index.ts
-var program = new Command9;
+var program = new Command10;
 program.name("alook").description("Alook CLI").option("--server <url>", "Server URL").option("--profile <name>", "Profile name");
 program.addCommand(registerCommand());
 program.addCommand(statusCommand());
@@ -17026,4 +17209,5 @@ program.addCommand(calendarCommand());
 program.addCommand(configCommand());
 program.addCommand(versionCommand());
 program.addCommand(updateCommand());
+program.addCommand(syncCommand());
 program.parse();

package/dist/session-runner.js

@@ -15,6 +15,8 @@ var __export = (target, all) => {
 
 // daemon/session-runner.ts
 import { createWriteStream } from "fs";
+import { mkdir, writeFile, rm } from "fs/promises";
+import path from "path";
 
 // ../shared/src/constants.ts
 var TASK_TYPES = {
@@ -13581,6 +13583,7 @@ var ClaimedTaskRowSchema = exports_external.object({
   result: exports_external.unknown().nullable(),
   context: exports_external.unknown().nullable(),
   type: exports_external.string().default(TASK_TYPES.USER_DM_MESSAGE),
+  contextKey: exports_external.string().nullable().optional(),
   sessionId: exports_external.string().nullable(),
   createdAt: exports_external.coerce.date(),
   dispatchedAt: exports_external.coerce.date().nullable(),
@@ -13610,7 +13613,9 @@ var TaskApiBaseSchema = exports_external.object({
   result: exports_external.unknown().nullable(),
   error: exports_external.string().nullable(),
   created_at: exports_external.string(),
-  type: exports_external.string()
+  type: exports_external.string(),
+  context_key: exports_external.string().nullable().optional(),
+  context: exports_external.unknown().nullable().optional()
 });
 var TaskApiSchema = TaskApiBaseSchema.extend({
   agent: TaskAgentDataApiSchema.nullable().optional()
@@ -13729,6 +13734,64 @@ var CalendarEventApiSchema = exports_external.object({
 var AddWhitelistRequestSchema = exports_external.object({
   email: exports_external.string().email()
 });
+var RuntimeConfigSchema = exports_external.object({ model: exports_external.string().max(100).optional() }).passthrough().optional();
+var CreateAgentRequestSchema = exports_external.object({
+  name: exports_external.string().min(1, "name is required"),
+  description: exports_external.string().optional().default(""),
+  instructions: exports_external.string().optional().default(""),
+  runtime_id: exports_external.string().min(1, "runtime_id is required"),
+  runtime_config: RuntimeConfigSchema,
+  max_concurrent_tasks: exports_external.number().int().optional(),
+  email_handle: exports_external.string().optional()
+});
+var UpdateAgentRequestSchema = exports_external.object({
+  name: exports_external.string().min(1).optional(),
+  description: exports_external.string().optional(),
+  instructions: exports_external.string().optional(),
+  runtime_id: exports_external.string().min(1).optional(),
+  runtime_config: RuntimeConfigSchema
+}).refine((v) => v.name !== undefined || v.description !== undefined || v.instructions !== undefined || v.runtime_id !== undefined || v.runtime_config !== undefined, { message: "at least one field is required" });
+var CreateConversationRequestSchema = exports_external.object({
+  agent_id: exports_external.string().min(1, "agent_id is required")
+});
+var CreateMessageRequestSchema = exports_external.object({
+  content: exports_external.string().min(1, "content is required")
+});
+var EmailAttachmentSchema = exports_external.object({
+  key: exports_external.string().min(1),
+  filename: exports_external.string().min(1),
+  size: exports_external.number().int().nonnegative().optional(),
+  contentType: exports_external.string().min(1)
+});
+var SendEmailRequestSchema = exports_external.object({
+  agentId: exports_external.string().min(1, "agentId is required"),
+  to: exports_external.string().min(1, "to is required"),
+  subject: exports_external.string().min(1, "subject is required"),
+  htmlBody: exports_external.string().default(""),
+  inReplyTo: exports_external.string().optional(),
+  references: exports_external.string().optional(),
+  attachments: exports_external.array(EmailAttachmentSchema).optional()
+});
+var UpdateEmailStatusRequestSchema = exports_external.object({
+  status: exports_external.enum(["unread", "read", "archived"])
+});
+var EmailNotifyRequestSchema = exports_external.object({
+  agentId: exports_external.string().min(1),
+  workspaceId: exports_external.string().min(1),
+  r2Key: exports_external.string().min(1),
+  from: exports_external.string().min(1),
+  to: exports_external.string().optional(),
+  subject: exports_external.string().min(1),
+  isWhitelisted: exports_external.boolean(),
+  forwarded: exports_external.boolean().optional().default(false),
+  messageId: exports_external.string().optional().default(""),
+  inReplyTo: exports_external.string().optional().default(""),
+  references: exports_external.string().optional().default("")
+});
+var CreateWorkspaceRequestSchema = exports_external.object({
+  name: exports_external.string().min(1, "name is required"),
+  slug: exports_external.string().min(1, "slug is required")
+});
 // ../../node_modules/.pnpm/drizzle-orm@0.45.2_@cloudflare+workers-types@4.20260418.1_@opentelemetry+api@1.9.1_bun-types@1.3.12_kysely@0.28.16/node_modules/drizzle-orm/entity.js
 var entityKind = Symbol.for("drizzle:entityKind");
 var hasOwnEntityKind = Symbol.for("drizzle:hasOwnEntityKind");
@@ -15235,6 +15298,7 @@ var message = sqliteTable("message", {
   role: text("role").notNull(),
   content: text("content").notNull().default(""),
   taskId: text("task_id"),
+  attachmentIds: text("attachment_ids"),
   createdAt: text("created_at").notNull().$defaultFn(() => new Date().toISOString())
 });
 var agentTaskQueue = sqliteTable("agent_task_queue", {
@@ -15245,6 +15309,7 @@ var agentTaskQueue = sqliteTable("agent_task_queue", {
   conversationId: text("conversation_id").notNull().references(() => conversation.id),
   prompt: text("prompt").notNull(),
   type: text("type").notNull().default(TASK_TYPES.USER_DM_MESSAGE),
+  contextKey: text("context_key"),
   status: text("status").notNull().default("queued"),
   priority: integer2("priority").notNull().default(0),
   result: text("result", { mode: "json" }),
@@ -15318,6 +15383,24 @@ var calendarEvent = sqliteTable("calendar_event", {
     foreignColumns: [agent.id, agent.workspaceId]
   }).onDelete("cascade")
 ]);
+var artifact = sqliteTable("artifact", {
+  id: text("id").primaryKey().$defaultFn(() => "art_" + nanoid3()),
+  conversationId: text("conversation_id").notNull().references(() => conversation.id, { onDelete: "cascade" }),
+  agentId: text("agent_id").notNull(),
+  workspaceId: text("workspace_id").notNull().references(() => workspace.id, { onDelete: "cascade" }),
+  filename: text("filename").notNull(),
+  contentType: text("content_type").notNull().default("application/octet-stream"),
+  size: integer2("size").notNull(),
+  r2Key: text("r2_key").notNull(),
+  source: text("source").notNull().default("agent"),
+  createdAt: text("created_at").notNull().$defaultFn(() => new Date().toISOString())
+}, (t) => [
+  index("idx_artifact_conversation").on(t.conversationId),
+  foreignKey({
+    columns: [t.agentId, t.workspaceId],
+    foreignColumns: [agent.id, agent.workspaceId]
+  }).onDelete("cascade")
+]);
 var machineToken = sqliteTable("machine_token", {
   id: text("id").primaryKey().$defaultFn(() => nanoid3()),
   userId: text("user_id").notNull().references(() => user.id, { onDelete: "cascade" }),
@@ -15403,6 +15486,16 @@ class DaemonClient {
       error: error48
     });
   }
+  async getArtifactMeta(token, artifactId, workspaceId) {
+    return this.request("GET", `/api/artifacts/${artifactId}?workspace_id=${encodeURIComponent(workspaceId)}`, token);
+  }
+  async downloadArtifact(token, artifactId, workspaceId) {
+    const res = await fetch(`${this.baseURL}/api/artifacts/${artifactId}/content?workspace_id=${encodeURIComponent(workspaceId)}`, { headers: { Authorization: `Bearer ${token}` } });
+    if (!res.ok) {
+      throw new Error(`artifact download failed: HTTP ${res.status}`);
+    }
+    return res.arrayBuffer();
+  }
   reportMessages(token, taskId, messages) {
     return this.request("POST", `/api/daemon/tasks/${taskId}/messages`, token, { messages });
   }
@@ -16350,8 +16443,8 @@ var SYSTEM_PROMPT_BODY = `## Memory Management
 - For SPECIFIC yet LONG rules or pattern, write to experiences/[NAME].md, and add index to ./memory.md for later recall.
 ### whats is ESSENTIAL and SHORT Memory?
 - basic user profile, e.g.:
-  - "user name is gus"
-  - "user is working on alook"
+  - "user name is ..."
+  - "user is working on ..."
 - certain local project mapping, e.g.:
   - "alook means the project under /user/home/alook/"
 - when to read certain stuff, e.g.:
@@ -16388,6 +16481,7 @@ those json are sorted by datetime in asc order.
 - When you start a new task, read the last ~10 lines of today's timeline to understand what has been asked and done recently.
   - if you don't know the current datetime, obtain the current datetime first.
 - When user ask you something you don't have in your current context, try to read the timeline jsonl files for answer (today or previous days).
+- When access other local projects, make sure you read the CLAUDE.md/AGENTS.md file under the project root dir to understand the requirements.
 `;
 function buildInstructionContent(task) {
   const displayName = task.agent?.name || "Alook Agent";
@@ -16438,21 +16532,38 @@ To reply to an email, add '--in-reply-to <EMAIL_ID>' to the send command. This s
 `;
   }
   content += `
+### 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>'
+- Use this after generating plans, reports, or any file the owner should review.
+---
+
+### Attachments
+When your task includes attachments, their local paths are listed in the prompt JSON under "attachments".
+Use your Read tool to open them. Images and PDFs are read visually.
+---
+`;
+  content += `
 ### Calendar
 You have your own calendar to setup daily routines and reminders.
 Schedule future tasks for yourself. At the scheduled time, a new task is dispatched to you with the event as the prompt (task type 'calendar_event').
+
+!USE Calendar when you think the tasks are recurring or it should be conducted in the future.
+!When scheduling calendar events relative to a weekday (e.g. "every Monday"), always run date '+%A' first to confirm today's weekday before calculating the target date
 ---
+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 "<PROMPT_TEXT>" --datetime <YYYY-MM-DDTHH:MM>'
+- Run 'npx @alook/cli 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.
-  - Optional '--description "<text>"' — longer notes/context shown alongside the event in the web UI. Use it for anything that wouldn't fit cleanly in the title.
 
 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 "daily standup summary" --datetime 2026-04-18T09:00 --repeat 1day --repeat_stop_date 2026-05-18'
-
+- 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'
+---
 List upcoming events:
 - Run 'npx @alook/cli 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.
@@ -16785,9 +16896,10 @@ function updateEntry(timelineDir, taskId, updater) {
   }
   log.debug(`Timeline updateEntry: task_id ${taskId} not found in last 7 days`);
 }
-function createTimelineEntry(taskId, prompt, type, sessionId, pid, provider) {
+function createTimelineEntry(taskId, prompt, type, sessionId, pid, provider, contextKey) {
   return {
     task_id: taskId,
+    context_key: contextKey ?? null,
     session_id: sessionId || null,
     pid: pid ?? null,
     status: "running",
@@ -16800,7 +16912,9 @@ function createTimelineEntry(taskId, prompt, type, sessionId, pid, provider) {
   };
 }
 var DEFAULT_RESUME_MAX_AGE_MS = 3 * 60 * 60 * 1000;
-function findResumableSessionId(timelineDir, type, provider, maxAgeMs = DEFAULT_RESUME_MAX_AGE_MS) {
+var EMAIL_RESUME_MAX_AGE_MS = 48 * 60 * 60 * 1000;
+function findResumableSessionByContextKey(timelineDir, contextKey, provider) {
+  const maxAgeMs = contextKey.startsWith("email:") ? EMAIL_RESUME_MAX_AGE_MS : DEFAULT_RESUME_MAX_AGE_MS;
   const now = new Date;
   const cutoff = new Date(now.getTime() - maxAgeMs);
   const daysToScan = Math.ceil(maxAgeMs / 86400000) + 1;
@@ -16810,7 +16924,7 @@ function findResumableSessionId(timelineDir, type, provider, maxAgeMs = DEFAULT_
   }
   entries.sort((a, b) => new Date(b.datetime).getTime() - new Date(a.datetime).getTime());
   for (const entry of entries) {
-    if (entry.status === "completed" && entry.type === type && entry.provider === provider && entry.session_id && new Date(entry.datetime) >= cutoff) {
+    if (entry.status === "completed" && entry.context_key === contextKey && entry.provider === provider && entry.session_id && new Date(entry.datetime) >= cutoff) {
       return entry.session_id;
     }
   }
@@ -16837,20 +16951,68 @@ function prepare(config2, task) {
 }
 
 // daemon/prompt.ts
-function buildPrompt(task) {
-  return JSON.stringify({ type: task.type, instruction: task.prompt });
+function buildPrompt(task, attachments) {
+  const obj = { type: task.type, instruction: task.prompt };
+  if (attachments && attachments.length > 0) {
+    obj.attachments = attachments.map((a) => ({
+      path: a.path,
+      content_type: a.content_type,
+      filename: a.filename
+    }));
+  }
+  return JSON.stringify(obj);
 }
 
 // daemon/session-runner.ts
+var ATTACHMENTS_BASE = "/tmp/alook-attachments";
+function sanitizeFilename(name) {
+  return path.basename(name).replace(/[/\\]/g, "_").replace(/\.\./g, "_").slice(0, 255) || "file";
+}
+async function cleanupAttachments(taskId) {
+  try {
+    await rm(path.join(ATTACHMENTS_BASE, taskId), { recursive: true, force: true });
+  } catch {}
+}
+async function downloadAttachments(client, token, workspaceId, taskId, attachmentIds) {
+  const dir = path.join(ATTACHMENTS_BASE, taskId);
+  await mkdir(dir, { recursive: true });
+  const attachments = [];
+  for (const artId of attachmentIds) {
+    const meta3 = await client.getArtifactMeta(token, artId, workspaceId);
+    const content = await client.downloadArtifact(token, artId, workspaceId);
+    const filename = sanitizeFilename(meta3.filename);
+    const localPath = path.join(dir, `${artId}_${filename}`);
+    await writeFile(localPath, Buffer.from(content));
+    attachments.push({
+      path: localPath,
+      content_type: meta3.content_type,
+      filename: meta3.filename
+    });
+  }
+  return attachments;
+}
 async function runSession(input) {
   const { task, provider, cliPath, model, serverURL, token, workspacesRoot, agentTimeout } = input;
   const client = new DaemonClient(serverURL);
   const backend = createBackend(provider, cliPath);
-  const prompt = buildPrompt(task);
   const { workDir, logFile, timelineDir, env } = prepare({ workspacesRoot }, task);
-  const resumeSessionId = task.type === TASK_TYPES.USER_DM_MESSAGE ? findResumableSessionId(timelineDir, task.type, provider) ?? undefined : undefined;
+  const attachmentIds = task.context?.attachment_ids ?? [];
+  let attachments;
+  if (attachmentIds.length > 0) {
+    try {
+      attachments = await downloadAttachments(client, token, task.workspaceId, task.id, attachmentIds);
+    } catch (e) {
+      await cleanupAttachments(task.id);
+      const errMsg = `failed to download attachments: ${e}`;
+      log.error(`Task ${task.id} ${errMsg}`);
+      await client.failTask(token, task.id, errMsg);
+      return;
+    }
+  }
+  const prompt = buildPrompt(task, attachments);
+  const resumeSessionId = task.contextKey ? findResumableSessionByContextKey(timelineDir, task.contextKey, provider) ?? undefined : undefined;
   if (resumeSessionId) {
-    log.info(`Task ${task.id} resuming session ${resumeSessionId}`);
+    log.info(`Task ${task.id} resuming session ${resumeSessionId} (context_key: ${task.contextKey})`);
   }
   const session2 = backend.execute(prompt, {
     cwd: workDir,
@@ -16861,11 +17023,11 @@ async function runSession(input) {
   });
   const agentPid = session2.pid;
   const earlySessionId = await session2.sessionId;
-  await initEntryAsync(timelineDir, createTimelineEntry(task.id, task.prompt, task.type, earlySessionId, process.pid, provider));
+  await initEntryAsync(timelineDir, createTimelineEntry(task.id, task.prompt, task.type, earlySessionId, process.pid, provider, task.contextKey));
   const pendingMessages = [];
   let seq = 0;
   const BATCH_SIZE = Number(process.env.ALOOK_MESSAGE_BATCH_SIZE) || 20;
-  const FLUSH_INTERVAL_MS = Number(process.env.ALOOK_MESSAGE_FLUSH_INTERVAL_MS) || 2000;
+  const FLUSH_INTERVAL_MS = Number(process.env.ALOOK_MESSAGE_FLUSH_INTERVAL_MS) || 100;
   const flushMessages = async () => {
     if (pendingMessages.length === 0)
       return;
@@ -16906,6 +17068,7 @@ async function runSession(input) {
       await flushMessages();
     } catch {}
     logStream?.end();
+    await cleanupAttachments(task.id);
     updateEntry(timelineDir, task.id, (entry) => {
       entry.pid = null;
       entry.status = "killed";
@@ -16968,6 +17131,7 @@ async function runSession(input) {
   process.removeListener("SIGINT", onKill);
   if (killed)
     return;
+  await cleanupAttachments(task.id);
   if (result.status === "completed") {
     updateEntry(timelineDir, task.id, (entry) => {
       entry.session_id = result.sessionId || null;
@@ -17013,6 +17177,7 @@ async function main() {
     await runSession(input);
   } catch (e) {
     log.error(`session-runner: unhandled error for task ${input.task.id}`, e);
+    await cleanupAttachments(input.task.id);
     try {
       await client.failTask(input.token, input.task.id, `session-runner crash: ${e}`);
     } catch {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alook/cli",
-  "version": "0.0.8",
+  "version": "0.0.10",
   "description": "Alook CLI — register and run always-on AI coding agents.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/alookai/alook#readme",