sparkecoder 0.1.115 → 0.1.117

package/dist/cli.js

@@ -5386,7 +5386,7 @@ function isPathExcluded(relativePath, exclude) {
 }
 async function walkDirectory(dir, include, exclude, baseDir) {
   const { readdirSync: readdirSync4 } = await import("fs");
-  const { join: join17, relative: relative10 } = await import("path");
+  const { join: join18, relative: relative10 } = await import("path");
   const files = [];
   function walk(currentDir) {
     let entries;
@@ -5396,7 +5396,7 @@ async function walkDirectory(dir, include, exclude, baseDir) {
       return;
     }
     for (const entry2 of entries) {
-      const fullPath = join17(currentDir, entry2.name);
+      const fullPath = join18(currentDir, entry2.name);
       const relativePath = relative10(baseDir, fullPath);
       if (isPathExcluded(relativePath, exclude)) {
         continue;
@@ -8409,6 +8409,68 @@ Headless workers never interfere with desktop workers (they don't touch the scre
 When you spawn a **desktop worker**, include a one-liner in the goal asking it to **record the session by default** (\`screencapture -v -V <seconds> -C\` on macOS) and return the recording path in its result, *unless* the task is long-running / boring / contains sensitive content. The recording lets you (and the user) replay what actually happened on screen. When the worker reports back, mention the recording path in your reply via the original channel.` : ""}
 
 Default bias: **when in doubt, decompose**. Two workers running in parallel and reporting independently is almost always better UX than one worker doing things sequentially.
+
+### How to TALK to the user (versus how you reason internally)
+
+All of the rules below \u2014 decomposition, parallel spawning, "don't invent commands", load-the-skill, etc. \u2014 are **your internal operating procedure**. They are how you decide what to do. They are NOT something to recite back to the user.
+
+When replying to the user (Slack, web, or any channel), be a normal helpful assistant:
+
+- Tell them *what you're doing*, not *how you're doing it internally*.
+- Don't quote your own prompt language ("just the goal", "read the skill", "no step-by-step from me", "decomposing into parallel workers"). The user doesn't care about your delegation pattern.
+- Don't narrate "handing off to a worker now" unless it's actually relevant (e.g. they asked how you work, or the work is going to take a noticeably long time).
+- Skip ceremony. A short acknowledgement + a brief description of the actual task + (optionally) a heads-up if there's anything they need to do or avoid is plenty.
+
+| What you might be tempted to say | What you should say instead |
+|---|---|
+| *"Got it \u2014 handing it off with just the goal + 'read the skills and figure it out.' No step-by-step from me."* | *"On it. Recording a screen capture of the Weather app showing Anchorage. Don't touch the keyboard while it's running \u2014 I'll post the video when it's done."* |
+| *"Decomposing into two parallel workers: one headless, one desktop."* | *"Running the tests and pulling the diff at the same time. Back in ~30s."* |
+| *"Spawning worker \`screenshot-calc\` with goal: \u2026"* | *"Taking a screenshot of Calculator now."* |
+| *"I'll relay the user's instructions to the worker verbatim."* | *(say nothing \u2014 just do it)* |
+
+If the user explicitly asks how you work, *then* you can explain the orchestrator/worker split. Otherwise: less is more.
+
+### How to write a worker goal (and what NOT to put in it)
+
+You delegate; the worker executes. Stay at the **what** level, not the **how**.
+
+**DO** put in the goal:
+
+- The end objective ("open the macOS Weather app and capture the forecast for Anchorage as a screen recording").
+- Which skills the worker should load up-front (\`load_skill recording\`, \`load_skill computer-use\`).
+- Acceptance criteria ("verify the city name is visible in the screenshot before reporting done").
+- Routing back ("post the recording URL to Slack channel C0123 thread 1700.001").
+
+**DO NOT** put in the goal (when you're inventing commands from memory):
+
+- Literal shell commands (\`screencapture -v -V 45 -C /tmp/...\`, \`osascript -e ...\`, \`cliclick kp:cmd+f\`).
+- Pre-written step-by-step bash that you're drafting from training-data recall.
+- The names of tools you can't see in your current toolset.
+
+If you have to reach for memory to write a command, **you're guessing** \u2014 your training data has lots of plausible-looking commands that are subtly wrong or stale. The worker will dutifully follow your wrong instructions instead of consulting the source of truth.
+
+**Exceptions \u2014 concrete steps ARE appropriate ONLY when relayed verbatim:**
+
+You CAN include literal step-by-step commands when one of these is true:
+
+1. **The user gave the steps to you.** Their message says "first run X, then Y, then commit" \u2192 forward those verbatim. That's the user's intent, not your guess.
+2. **A previous turn already established them.** An earlier worker reported "the deploy script lives at \`./scripts/deploy.sh --env prod\`" \u2192 you can hand that command to the next worker.
+3. **The conversation history contains them.** A documented \`bash\` invocation from earlier in the chat, an error message that revealed the right path, a CI log the user shared \u2014 anything already concrete in context.
+
+In all three cases, **label the source** in the goal: *"Per your instructions earlier: 1. run X, 2. run Y..."* or *"Reusing the command worker-foo found last turn: \`./scripts/deploy.sh\`"*.
+
+What you do NOT do:
+
+- **Don't paraphrase or "improve" a skill into the goal.** If the recording skill describes \`sparkecoder record start/stop\`, the goal just says *"per the recording skill, bracket the work with start/stop"* \u2014 never quote the exact command. The worker loads the skill and reads the canonical version itself. You quoting it just adds a way for the quote to drift behind the source of truth.
+- **Don't reason your way to a command.** "I think macOS uses \`open -a Weather\` to launch apps" is exactly the kind of training-data recall that produces stale or wrong commands. Don't include it.
+
+The rule is: **relay, never invent \u2014 and never quote a skill.** Your job is to (a) tell the worker which skills to load, (b) state the objective and acceptance criteria, (c) relay any concrete steps the user or prior context already established. Workers do the looking-up; you do the dispatching.
+
+Bad goal (don't do this):
+> "Start a screen recording with \`screencapture -v -V 45 -C /tmp/weather.mov &\`, then open Weather with \`open -a Weather\`, then click the search bar with cliclick, type 'Anchorage'..."
+
+Good goal (do this):
+> "Capture a 30\u201360s screen recording of opening the macOS Weather app and viewing the Anchorage, AK forecast. \`load_skill recording\` and \`load_skill computer-use\` first; use the canonical commands from those skills. Verify the Anchorage temperature is visible in a final screenshot before completing. Return the recording path + a one-line summary of the forecast."
 `;
 }
 function createSummaryPrompt(conversationHistory) {
@@ -11325,11 +11387,11 @@ ${p.text}` : p.text;
           const { isRemoteConfigured: isRemoteConfigured2, storageQueries: storageQueries2 } = await Promise.resolve().then(() => (init_remote(), remote_exports));
           if (!isRemoteConfigured2()) return [];
           const { readFile: readFile12 } = await import("fs/promises");
-          const { join: join17, basename: basename6 } = await import("path");
+          const { join: join18, basename: basename6 } = await import("path");
           const urls = [];
           for (const filePath of filePaths) {
             try {
-              const fullPath = filePath.startsWith("/") ? filePath : join17(this.session.workingDirectory, filePath);
+              const fullPath = filePath.startsWith("/") ? filePath : join18(this.session.workingDirectory, filePath);
               const fileName = basename6(fullPath);
               const ext = fileName.split(".").pop()?.toLowerCase() || "";
               const mimeMap = {
@@ -11533,6 +11595,121 @@ var init_session_lock = __esm({
   }
 });
 
+// src/orchestrator/webhook-events.ts
+import { existsSync as existsSync18, readFileSync as readFileSync9, appendFileSync as appendFileSync3, writeFileSync as writeFileSync3, mkdirSync as mkdirSync7 } from "fs";
+import { dirname as dirname6, join as join12 } from "path";
+import { nanoid as nanoid10 } from "nanoid";
+function logFilePath() {
+  return join12(getAppDataDirectory(), "webhook-events.jsonl");
+}
+function ensureLoaded() {
+  if (cache !== null) return cache;
+  cache = [];
+  try {
+    const p = logFilePath();
+    if (!existsSync18(p)) return cache;
+    const lines = readFileSync9(p, "utf-8").split("\n").filter(Boolean);
+    for (const line of lines) {
+      try {
+        cache.push(JSON.parse(line));
+      } catch {
+      }
+    }
+    if (cache.length > MAX_EVENTS) {
+      cache = cache.slice(-MAX_EVENTS);
+      try {
+        writeFileSync3(p, cache.map((e) => JSON.stringify(e)).join("\n") + "\n");
+      } catch {
+      }
+    }
+  } catch {
+  }
+  return cache;
+}
+function appendEvent(ev) {
+  const list = ensureLoaded();
+  list.push(ev);
+  if (list.length > MAX_EVENTS) list.shift();
+  try {
+    const p = logFilePath();
+    mkdirSync7(dirname6(p), { recursive: true });
+    appendFileSync3(p, JSON.stringify(ev) + "\n");
+  } catch {
+  }
+}
+function recordEvent(ev) {
+  const full = {
+    id: ev.id ?? nanoid10(),
+    ts: ev.ts ?? (/* @__PURE__ */ new Date()).toISOString(),
+    source: ev.source,
+    status: ev.status,
+    subtype: ev.subtype,
+    channel: ev.channel,
+    user: ev.user,
+    textSnippet: ev.textSnippet?.slice(0, 200),
+    dropReason: ev.dropReason,
+    error: ev.error,
+    sessionId: ev.sessionId,
+    durationMs: ev.durationMs,
+    meta: ev.meta
+  };
+  appendEvent(full);
+  return full.id;
+}
+function updateEvent(id, patch) {
+  const list = ensureLoaded();
+  const i = list.findIndex((e) => e.id === id);
+  if (i < 0) return;
+  list[i] = { ...list[i], ...patch };
+  try {
+    const p = logFilePath();
+    mkdirSync7(dirname6(p), { recursive: true });
+    writeFileSync3(p, list.map((e) => JSON.stringify(e)).join("\n") + "\n");
+  } catch {
+  }
+}
+function listEvents(filter = {}) {
+  const list = ensureLoaded();
+  const q = filter.q?.toLowerCase();
+  const sinceTs = filter.since ? Date.parse(filter.since) : -Infinity;
+  const beforeTs = filter.before ? Date.parse(filter.before) : Infinity;
+  const matched = list.filter((e) => {
+    if (filter.source && e.source !== filter.source) return false;
+    if (filter.status && e.status !== filter.status) return false;
+    const t = Date.parse(e.ts);
+    if (t < sinceTs) return false;
+    if (t >= beforeTs) return false;
+    if (q) {
+      const hay = `${e.channel ?? ""} ${e.user ?? ""} ${e.textSnippet ?? ""} ${e.dropReason ?? ""} ${e.error ?? ""} ${e.subtype ?? ""}`.toLowerCase();
+      if (!hay.includes(q)) return false;
+    }
+    return true;
+  });
+  matched.reverse();
+  const offset = Math.max(0, filter.offset ?? 0);
+  const limit = Math.min(500, Math.max(1, filter.limit ?? 50));
+  return {
+    events: matched.slice(offset, offset + limit),
+    total: matched.length
+  };
+}
+function clearAllEvents() {
+  cache = [];
+  try {
+    writeFileSync3(logFilePath(), "");
+  } catch {
+  }
+}
+var MAX_EVENTS, cache;
+var init_webhook_events = __esm({
+  "src/orchestrator/webhook-events.ts"() {
+    "use strict";
+    init_config();
+    MAX_EVENTS = 1e3;
+    cache = null;
+  }
+});
+
 // src/orchestrator/daemon.ts
 var daemon_exports = {};
 __export(daemon_exports, {
@@ -11594,6 +11771,17 @@ async function runDaemonTurn(sessionId, events) {
   });
   const finishedAt = /* @__PURE__ */ new Date();
   const trimmed = text.trim();
+  recordEvent({
+    source: "daemon",
+    status: error ? "failed" : "completed",
+    channel: events[0]?.ref?.channel ?? void 0,
+    user: events[0]?.ref?.user,
+    textSnippet: trimmed.slice(0, 200),
+    error,
+    sessionId,
+    durationMs: finishedAt.getTime() - startedAt.getTime(),
+    meta: { triggeredBy: events.map((e) => e.content?.slice(0, 80)) }
+  });
   broadcast({ sessionId, text: trimmed, triggeredBy: events, startedAt, finishedAt, error });
 }
 var listeners;
@@ -11604,6 +11792,7 @@ var init_daemon = __esm({
     init_session_lock();
     init_db();
     init_inbox();
+    init_webhook_events();
     listeners = /* @__PURE__ */ new Map();
   }
 });
@@ -11855,7 +12044,7 @@ import chalk from "chalk";
 import ora from "ora";
 import "dotenv/config";
 import { createInterface } from "readline";
-import { dirname as dirname8 } from "path";
+import { dirname as dirname9 } from "path";
 import { fileURLToPath as fileURLToPath5 } from "url";
 
 // src/server/index.ts
@@ -11864,8 +12053,8 @@ import { Hono as Hono9 } from "hono";
 import { serve } from "@hono/node-server";
 import { cors } from "hono/cors";
 import { logger } from "hono/logger";
-import { existsSync as existsSync20, mkdirSync as mkdirSync9, writeFileSync as writeFileSync5 } from "fs";
-import { resolve as resolve11, dirname as dirname7, join as join15 } from "path";
+import { existsSync as existsSync21, mkdirSync as mkdirSync10, writeFileSync as writeFileSync6 } from "fs";
+import { resolve as resolve11, dirname as dirname8, join as join16 } from "path";
 import { spawn as spawn2 } from "child_process";
 import { createServer as createNetServer } from "net";
 import { fileURLToPath as fileURLToPath4 } from "url";
@@ -11879,10 +12068,10 @@ init_checkpoints();
 import { Hono } from "hono";
 import { zValidator } from "@hono/zod-validator";
 import { z as z17 } from "zod";
-import { existsSync as existsSync18, mkdirSync as mkdirSync7, writeFileSync as writeFileSync3, readdirSync as readdirSync3, statSync as statSync2, unlinkSync as unlinkSync3 } from "fs";
+import { existsSync as existsSync19, mkdirSync as mkdirSync8, writeFileSync as writeFileSync4, readdirSync as readdirSync3, statSync as statSync2, unlinkSync as unlinkSync3 } from "fs";
 import { readdir as readdir6 } from "fs/promises";
-import { join as join12, basename as basename5, extname as extname8, relative as relative9 } from "path";
-import { nanoid as nanoid10 } from "nanoid";
+import { join as join13, basename as basename5, extname as extname8, relative as relative9 } from "path";
+import { nanoid as nanoid11 } from "nanoid";
 
 // src/tasks/agent-status.ts
 init_questions();
@@ -12523,12 +12712,12 @@ sessions2.get("/:id/diff/:filePath", async (c) => {
 });
 function getAttachmentsDir(sessionId) {
   const appDataDir = getAppDataDirectory();
-  return join12(appDataDir, "attachments", sessionId);
+  return join13(appDataDir, "attachments", sessionId);
 }
 function ensureAttachmentsDir(sessionId) {
   const dir = getAttachmentsDir(sessionId);
-  if (!existsSync18(dir)) {
-    mkdirSync7(dir, { recursive: true });
+  if (!existsSync19(dir)) {
+    mkdirSync8(dir, { recursive: true });
   }
   return dir;
 }
@@ -12539,12 +12728,12 @@ sessions2.get("/:id/attachments", async (c) => {
     return c.json({ error: "Session not found" }, 404);
   }
   const dir = getAttachmentsDir(sessionId);
-  if (!existsSync18(dir)) {
+  if (!existsSync19(dir)) {
     return c.json({ sessionId, attachments: [], count: 0 });
   }
   const files = readdirSync3(dir);
   const attachments = files.map((filename) => {
-    const filePath = join12(dir, filename);
+    const filePath = join13(dir, filename);
     const stats = statSync2(filePath);
     return {
       id: filename.split("_")[0],
@@ -12576,12 +12765,12 @@ sessions2.post("/:id/attachments", async (c) => {
         return c.json({ error: "No file provided" }, 400);
       }
       const dir = ensureAttachmentsDir(sessionId);
-      const id = nanoid10(10);
+      const id = nanoid11(10);
       const ext = extname8(file.name) || "";
       const safeFilename = `${id}_${basename5(file.name).replace(/[^a-zA-Z0-9._-]/g, "_")}`;
-      const filePath = join12(dir, safeFilename);
+      const filePath = join13(dir, safeFilename);
       const arrayBuffer = await file.arrayBuffer();
-      writeFileSync3(filePath, Buffer.from(arrayBuffer));
+      writeFileSync4(filePath, Buffer.from(arrayBuffer));
       return c.json({
         id,
         filename: file.name,
@@ -12602,16 +12791,16 @@ sessions2.post("/:id/attachments", async (c) => {
       return c.json({ error: "Missing filename or data" }, 400);
     }
     const dir = ensureAttachmentsDir(sessionId);
-    const id = nanoid10(10);
+    const id = nanoid11(10);
     const ext = extname8(body.filename) || "";
     const safeFilename = `${id}_${basename5(body.filename).replace(/[^a-zA-Z0-9._-]/g, "_")}`;
-    const filePath = join12(dir, safeFilename);
+    const filePath = join13(dir, safeFilename);
     let base64Data = body.data;
     if (base64Data.includes(",")) {
       base64Data = base64Data.split(",")[1];
     }
     const buffer = Buffer.from(base64Data, "base64");
-    writeFileSync3(filePath, buffer);
+    writeFileSync4(filePath, buffer);
     return c.json({
       id,
       filename: body.filename,
@@ -12634,7 +12823,7 @@ sessions2.delete("/:id/attachments/:attachmentId", async (c) => {
     return c.json({ error: "Session not found" }, 404);
   }
   const dir = getAttachmentsDir(sessionId);
-  if (!existsSync18(dir)) {
+  if (!existsSync19(dir)) {
     return c.json({ error: "Attachment not found" }, 404);
   }
   const files = readdirSync3(dir);
@@ -12642,7 +12831,7 @@ sessions2.delete("/:id/attachments/:attachmentId", async (c) => {
   if (!file) {
     return c.json({ error: "Attachment not found" }, 404);
   }
-  const filePath = join12(dir, file);
+  const filePath = join13(dir, file);
   unlinkSync3(filePath);
   return c.json({ success: true, id: attachmentId });
 });
@@ -12725,7 +12914,7 @@ async function listWorkspaceFiles(baseDir, currentDir, query, limit, results = [
     const entries = await readdir6(currentDir, { withFileTypes: true });
     for (const entry2 of entries) {
       if (results.length >= limit * 2) break;
-      const fullPath = join12(currentDir, entry2.name);
+      const fullPath = join13(currentDir, entry2.name);
       const relativePath = relative9(baseDir, fullPath);
       if (entry2.isDirectory() && IGNORED_DIRECTORIES.has(entry2.name)) {
         continue;
@@ -12773,7 +12962,7 @@ sessions2.get(
       return c.json({ error: "Session not found" }, 404);
     }
     const workingDirectory = session.workingDirectory;
-    if (!existsSync18(workingDirectory)) {
+    if (!existsSync19(workingDirectory)) {
       return c.json({
         sessionId,
         workingDirectory,
@@ -12887,8 +13076,8 @@ init_config();
 import { Hono as Hono2 } from "hono";
 import { zValidator as zValidator2 } from "@hono/zod-validator";
 import { z as z18 } from "zod";
-import { existsSync as existsSync19, mkdirSync as mkdirSync8, writeFileSync as writeFileSync4 } from "fs";
-import { join as join13 } from "path";
+import { existsSync as existsSync20, mkdirSync as mkdirSync9, writeFileSync as writeFileSync5 } from "fs";
+import { join as join14 } from "path";
 
 // src/server/resumable-stream.ts
 import { createResumableStreamContext } from "resumable-stream/generic";
@@ -12975,7 +13164,7 @@ var streamContext = createResumableStreamContext({
 
 // src/server/routes/agents.ts
 init_checkpoints();
-import { nanoid as nanoid11 } from "nanoid";
+import { nanoid as nanoid12 } from "nanoid";
 init_stream_proxy();
 init_recorder();
 init_remote();
@@ -13095,12 +13284,12 @@ var rejectSchema = z18.object({
 var streamAbortControllers = /* @__PURE__ */ new Map();
 function getAttachmentsDirectory(sessionId) {
   const appDataDir = getAppDataDirectory();
-  return join13(appDataDir, "attachments", sessionId);
+  return join14(appDataDir, "attachments", sessionId);
 }
 async function saveAttachmentToDisk(sessionId, attachment, index) {
   const attachmentsDir = getAttachmentsDirectory(sessionId);
-  if (!existsSync19(attachmentsDir)) {
-    mkdirSync8(attachmentsDir, { recursive: true });
+  if (!existsSync20(attachmentsDir)) {
+    mkdirSync9(attachmentsDir, { recursive: true });
   }
   let filename = attachment.filename;
   if (!filename) {
@@ -13118,8 +13307,8 @@ async function saveAttachmentToDisk(sessionId, attachment, index) {
     attachment.mediaType = resized.mediaType;
     attachment.data = buffer.toString("base64");
   }
-  const filePath = join13(attachmentsDir, filename);
-  writeFileSync4(filePath, buffer);
+  const filePath = join14(attachmentsDir, filename);
+  writeFileSync5(filePath, buffer);
   return filePath;
 }
 function stripDataUrlPrefix2(data) {
@@ -13555,7 +13744,7 @@ ${prompt}` });
       });
     } catch {
     }
-    const streamId = `stream_${id}_${nanoid11(10)}`;
+    const streamId = `stream_${id}_${nanoid12(10)}`;
     console.log(`[STREAM] Creating stream ${streamId} for session ${id}`);
     await activeStreamQueries.create(id, streamId);
     const stream = await streamContext.resumableStream(
@@ -13760,7 +13949,7 @@ agents.post(
     });
     const session = agent.getSession();
     const enrichedPrompt = enrichPromptWithDevtoolsContext(session.id, body.prompt);
-    const streamId = `stream_${session.id}_${nanoid11(10)}`;
+    const streamId = `stream_${session.id}_${nanoid12(10)}`;
     await createCheckpoint(session.id, session.workingDirectory, 0);
     await activeStreamQueries.create(session.id, streamId);
     const createQuickStreamProducer = () => {
@@ -14079,26 +14268,26 @@ init_config();
 import { Hono as Hono3 } from "hono";
 import { zValidator as zValidator3 } from "@hono/zod-validator";
 import { z as z19 } from "zod";
-import { readFileSync as readFileSync9 } from "fs";
+import { readFileSync as readFileSync10 } from "fs";
 import { fileURLToPath as fileURLToPath3 } from "url";
-import { dirname as dirname6, join as join14 } from "path";
+import { dirname as dirname7, join as join15 } from "path";
 var __filename = fileURLToPath3(import.meta.url);
-var __dirname = dirname6(__filename);
+var __dirname = dirname7(__filename);
 var possiblePaths = [
-  join14(__dirname, "../package.json"),
+  join15(__dirname, "../package.json"),
   // From dist/server -> dist/../package.json
-  join14(__dirname, "../../package.json"),
+  join15(__dirname, "../../package.json"),
   // From dist/server (if nested differently)
-  join14(__dirname, "../../../package.json"),
+  join15(__dirname, "../../../package.json"),
   // From src/server/routes (development)
-  join14(process.cwd(), "package.json")
+  join15(process.cwd(), "package.json")
   // From current working directory
 ];
 var currentVersion = "0.0.0";
 var packageName = "sparkecoder";
 for (const packageJsonPath of possiblePaths) {
   try {
-    const packageJson = JSON.parse(readFileSync9(packageJsonPath, "utf-8"));
+    const packageJson = JSON.parse(readFileSync10(packageJsonPath, "utf-8"));
     if (packageJson.name === "sparkecoder") {
       currentVersion = packageJson.version || "0.0.0";
       packageName = packageJson.name || "sparkecoder";
@@ -14548,7 +14737,7 @@ init_config();
 import { Hono as Hono5 } from "hono";
 import { zValidator as zValidator5 } from "@hono/zod-validator";
 import { z as z21 } from "zod";
-import { nanoid as nanoid12 } from "nanoid";
+import { nanoid as nanoid13 } from "nanoid";
 init_questions();
 var tasks = new Hono5();
 var taskAbortControllers = /* @__PURE__ */ new Map();
@@ -14629,7 +14818,7 @@ tasks.post(
     const taskId = agent.sessionId;
     const abortController = new AbortController();
     taskAbortControllers.set(taskId, abortController);
-    const streamId = `stream_${taskId}_${nanoid12(10)}`;
+    const streamId = `stream_${taskId}_${nanoid13(10)}`;
     await activeStreamQueries.create(taskId, streamId);
     const taskStreamProducer = () => {
       const { readable, writable } = new TransformStream();
@@ -14855,6 +15044,7 @@ function verifySlackSignature(opts) {
 // src/server/routes/slack.ts
 init_client3();
 init_slack();
+init_webhook_events();
 init_inbox();
 var recentlyHandled = /* @__PURE__ */ new Map();
 var MAX_RECENT = 1e3;
@@ -14895,7 +15085,17 @@ slack.post("/events", async (c) => {
   }
   if (payload?.type === "event_callback" && payload?.event) {
     const ev = payload.event;
+    const auditId = recordEvent({
+      source: "slack",
+      status: "received",
+      subtype: ev.type === "message" ? `message.${ev.channel_type ?? "channels"}` : ev.type,
+      channel: ev.channel,
+      user: ev.user,
+      textSnippet: typeof ev.text === "string" ? ev.text : void 0,
+      meta: { ts: ev.ts, thread_ts: ev.thread_ts, team: ev.team, event_subtype: ev.subtype }
+    });
     if (alreadyHandled(ev.channel, ev.ts)) {
+      updateEvent(auditId, { status: "dropped", dropReason: "duplicate_delivery" });
       return c.json({ ok: true });
     }
     const { event: inbound, dropReason } = slackEventToInboundResult(ev);
@@ -14905,6 +15105,7 @@ slack.post("/events", async (c) => {
         const ours = isThreadOwned(ev.channel, ev.thread_ts) || await threadBelongsToUs(ev.channel, ev.thread_ts);
         if (!ours) {
           console.log(`[slack] dropping thread reply in unknown thread: channel=${ev.channel} thread=${ev.thread_ts}`);
+          updateEvent(auditId, { status: "dropped", dropReason: "thread_not_owned" });
           return c.json({ ok: true });
         }
       }
@@ -14917,8 +15118,12 @@ slack.post("/events", async (c) => {
       const orchestratorId = await findOrCreateOrchestratorId();
       if (orchestratorId) {
         pushToInbox(orchestratorId, inbound);
+        updateEvent(auditId, { status: "routed", sessionId: orchestratorId });
+      } else {
+        updateEvent(auditId, { status: "error", error: "no orchestrator session available" });
       }
     } else if (dropReason) {
+      updateEvent(auditId, { status: "dropped", dropReason });
       const userFacingDrops = ["user_not_allowed", "channel_not_allowed", "dm_blocked"];
       if (userFacingDrops.includes(dropReason)) {
         console.log(`[slack] dropped event from user=${payload.event.user} channel=${payload.event.channel}: ${dropReason}`);
@@ -14981,13 +15186,30 @@ async function sendDeniedReply(event) {
 init_webhooks_store();
 init_webhook();
 init_inbox();
+init_webhook_events();
 import { Hono as Hono7 } from "hono";
 var inbox = new Hono7();
 inbox.post("/:token", async (c) => {
   const token = c.req.param("token");
-  if (!token || token.length < 16) return c.json({ error: "invalid token" }, 401);
+  if (!token || token.length < 16) {
+    recordEvent({
+      source: "inbox",
+      status: "dropped",
+      dropReason: "invalid_token_format",
+      meta: { tokenLen: token?.length ?? 0 }
+    });
+    return c.json({ error: "invalid token" }, 401);
+  }
   const lookup = await findByToken(token);
-  if (!lookup) return c.json({ error: "unknown token" }, 404);
+  if (!lookup) {
+    recordEvent({
+      source: "inbox",
+      status: "dropped",
+      dropReason: "unknown_token",
+      meta: { tokenPrefix: token.slice(0, 8) + "\u2026" }
+    });
+    return c.json({ error: "unknown token" }, 404);
+  }
   let body;
   const contentType = c.req.header("content-type") || "";
   try {
@@ -15009,6 +15231,14 @@ inbox.post("/:token", async (c) => {
   pushToInbox(lookup.orchestratorSessionId, event);
   void recordHit(lookup.orchestratorSessionId, lookup.webhook.id).catch(() => {
   });
+  recordEvent({
+    source: "inbox",
+    status: "routed",
+    channel: lookup.webhook.name,
+    textSnippet: typeof body === "string" ? body : JSON.stringify(body).slice(0, 200),
+    sessionId: lookup.orchestratorSessionId,
+    meta: { wake: lookup.webhook.wake, webhookId: lookup.webhook.id }
+  });
   return c.json({ ok: true, queued: true, wake: lookup.webhook.wake });
 });
 
@@ -15020,6 +15250,7 @@ init_webhooks_store();
 init_messenger();
 init_store();
 init_pool();
+init_webhook_events();
 import { Hono as Hono8 } from "hono";
 import { zValidator as zValidator6 } from "@hono/zod-validator";
 import { z as z22 } from "zod";
@@ -15078,6 +15309,24 @@ function webhookPrefix() {
   const token = cfg?.webhooks?.token;
   return token ? `/w/${token}` : "/api";
 }
+integrations.get("/events", async (c) => {
+  const q = c.req.query();
+  const filter = {
+    source: q.source,
+    status: q.status,
+    q: q.q,
+    since: q.since,
+    before: q.before,
+    limit: q.limit ? Math.min(500, Math.max(1, parseInt(q.limit, 10))) : 50,
+    offset: q.offset ? Math.max(0, parseInt(q.offset, 10)) : 0
+  };
+  const { events, total } = listEvents(filter);
+  return c.json({ events, total, limit: filter.limit, offset: filter.offset });
+});
+integrations.delete("/events", async (c) => {
+  clearAllEvents();
+  return c.json({ ok: true });
+});
 integrations.get("/", async (c) => {
   const cfg = getConfig();
   return c.json({
@@ -15536,13 +15785,13 @@ var DEFAULT_WEB_PORT = 6969;
 var WEB_PORT_SEQUENCE = [6969, 6970, 6971, 6972, 6973, 6974, 6975, 6976, 6977, 6978];
 function getWebDirectory() {
   try {
-    const currentDir = dirname7(fileURLToPath4(import.meta.url));
+    const currentDir = dirname8(fileURLToPath4(import.meta.url));
     const webDir = resolve11(currentDir, "..", "web");
-    if (existsSync20(webDir) && existsSync20(join15(webDir, "package.json"))) {
+    if (existsSync21(webDir) && existsSync21(join16(webDir, "package.json"))) {
       return webDir;
     }
     const altWebDir = resolve11(currentDir, "..", "..", "web");
-    if (existsSync20(altWebDir) && existsSync20(join15(altWebDir, "package.json"))) {
+    if (existsSync21(altWebDir) && existsSync21(join16(altWebDir, "package.json"))) {
       return altWebDir;
     }
     return null;
@@ -15600,23 +15849,23 @@ async function findWebPort(preferredPort) {
   return { port: preferredPort, alreadyRunning: false };
 }
 function hasProductionBuild(webDir) {
-  const buildIdPath = join15(webDir, ".next", "BUILD_ID");
-  return existsSync20(buildIdPath);
+  const buildIdPath = join16(webDir, ".next", "BUILD_ID");
+  return existsSync21(buildIdPath);
 }
 function hasSourceFiles(webDir) {
-  const appDir = join15(webDir, "src", "app");
-  const pagesDir = join15(webDir, "src", "pages");
-  const rootAppDir = join15(webDir, "app");
-  const rootPagesDir = join15(webDir, "pages");
-  return existsSync20(appDir) || existsSync20(pagesDir) || existsSync20(rootAppDir) || existsSync20(rootPagesDir);
+  const appDir = join16(webDir, "src", "app");
+  const pagesDir = join16(webDir, "src", "pages");
+  const rootAppDir = join16(webDir, "app");
+  const rootPagesDir = join16(webDir, "pages");
+  return existsSync21(appDir) || existsSync21(pagesDir) || existsSync21(rootAppDir) || existsSync21(rootPagesDir);
 }
 function getStandaloneServerPath(webDir) {
   const possiblePaths2 = [
-    join15(webDir, ".next", "standalone", "server.js"),
-    join15(webDir, ".next", "standalone", "web", "server.js")
+    join16(webDir, ".next", "standalone", "server.js"),
+    join16(webDir, ".next", "standalone", "web", "server.js")
   ];
   for (const serverPath of possiblePaths2) {
-    if (existsSync20(serverPath)) {
+    if (existsSync21(serverPath)) {
       return serverPath;
     }
   }
@@ -15656,15 +15905,15 @@ async function startWebUI(apiPort, webPort = DEFAULT_WEB_PORT, quiet = false, pu
     if (!quiet) console.log(`  \u2713 Web UI already running at http://localhost:${actualPort}`);
     return { process: null, port: actualPort };
   }
-  const usePnpm = existsSync20(join15(webDir, "pnpm-lock.yaml"));
-  const useNpm = !usePnpm && existsSync20(join15(webDir, "package-lock.json"));
+  const usePnpm = existsSync21(join16(webDir, "pnpm-lock.yaml"));
+  const useNpm = !usePnpm && existsSync21(join16(webDir, "package-lock.json"));
   const pkgManager = usePnpm ? "pnpm" : useNpm ? "npm" : "npx";
   const { NODE_OPTIONS, TSX_TSCONFIG_PATH, ...cleanEnv } = process.env;
   const apiUrl = publicUrl || `http://127.0.0.1:${apiPort}`;
   const runtimeConfig = { apiBaseUrl: apiUrl };
-  const runtimeConfigPath = join15(webDir, "runtime-config.json");
+  const runtimeConfigPath = join16(webDir, "runtime-config.json");
   try {
-    writeFileSync5(runtimeConfigPath, JSON.stringify(runtimeConfig, null, 2));
+    writeFileSync6(runtimeConfigPath, JSON.stringify(runtimeConfig, null, 2));
     if (!quiet) console.log(`  \u{1F4DD} Runtime config written to ${runtimeConfigPath}`);
   } catch (err) {
     if (!quiet) console.warn(`  \u26A0 Could not write runtime config: ${err}`);
@@ -15684,7 +15933,7 @@ async function startWebUI(apiPort, webPort = DEFAULT_WEB_PORT, quiet = false, pu
   if (standaloneServerPath) {
     command = "node";
     args = ["server.js"];
-    cwd = dirname7(standaloneServerPath);
+    cwd = dirname8(standaloneServerPath);
     webEnv.PORT = String(actualPort);
     webEnv.HOSTNAME = "0.0.0.0";
     if (!quiet) console.log("  \u{1F4E6} Starting Web UI from standalone build...");
@@ -15877,8 +16126,8 @@ async function startServer(options = {}) {
   if (options.workingDirectory) {
     config.resolvedWorkingDirectory = options.workingDirectory;
   }
-  if (!existsSync20(config.resolvedWorkingDirectory)) {
-    mkdirSync9(config.resolvedWorkingDirectory, { recursive: true });
+  if (!existsSync21(config.resolvedWorkingDirectory)) {
+    mkdirSync10(config.resolvedWorkingDirectory, { recursive: true });
     if (!options.quiet) console.log(`\u{1F4C1} Created agent workspace: ${config.resolvedWorkingDirectory}`);
   }
   if (!config.resolvedRemoteServer.url) {
@@ -16422,18 +16671,18 @@ function generateOpenAPISpec() {
 init_config();
 init_semantic();
 init_db();
-import { mkdirSync as mkdirSync10, writeFileSync as writeFileSync6, readFileSync as readFileSync10, existsSync as existsSync21, statSync as statSync3 } from "fs";
-import { resolve as resolve12, join as join16 } from "path";
+import { mkdirSync as mkdirSync11, writeFileSync as writeFileSync7, readFileSync as readFileSync11, existsSync as existsSync22, statSync as statSync3 } from "fs";
+import { resolve as resolve12, join as join17 } from "path";
 function getCliVersion() {
-  const here = dirname8(fileURLToPath5(import.meta.url));
+  const here = dirname9(fileURLToPath5(import.meta.url));
   const candidates = [
-    join16(here, "..", "package.json"),
-    join16(here, "..", "..", "package.json"),
-    join16(process.cwd(), "package.json")
+    join17(here, "..", "package.json"),
+    join17(here, "..", "..", "package.json"),
+    join17(process.cwd(), "package.json")
   ];
   for (const p of candidates) {
     try {
-      const pkg = JSON.parse(readFileSync10(p, "utf8"));
+      const pkg = JSON.parse(readFileSync11(p, "utf8"));
       if (pkg.name === "sparkecoder" && pkg.version) return pkg.version;
     } catch {
     }
@@ -17096,8 +17345,8 @@ program.command("task").description("Run an autonomous task that completes witho
   let outputSchema;
   try {
     const schemaStr = options.schema;
-    if (existsSync21(schemaStr)) {
-      outputSchema = JSON.parse(readFileSync10(schemaStr, "utf-8"));
+    if (existsSync22(schemaStr)) {
+      outputSchema = JSON.parse(readFileSync11(schemaStr, "utf-8"));
     } else {
       outputSchema = JSON.parse(schemaStr);
     }
@@ -17164,19 +17413,19 @@ program.command("init").description("Create a sparkecoder.config.json file").opt
   let configLocation;
   if (options.global) {
     const appDataDir = ensureAppDataDirectory();
-    configPath = join16(appDataDir, "sparkecoder.config.json");
+    configPath = join17(appDataDir, "sparkecoder.config.json");
     configLocation = "global";
   } else {
     configPath = resolve12(process.cwd(), "sparkecoder.config.json");
     configLocation = "local";
   }
-  if (existsSync21(configPath) && !options.force) {
+  if (existsSync22(configPath) && !options.force) {
     console.log(chalk.yellow("Config file already exists. Use --force to overwrite."));
     console.log(chalk.dim(`  ${configPath}`));
     return;
   }
   const config = createDefaultConfig();
-  writeFileSync6(configPath, JSON.stringify(config, null, 2));
+  writeFileSync7(configPath, JSON.stringify(config, null, 2));
   console.log(chalk.green(`\u2713 Created ${configLocation} config`));
   console.log(chalk.dim(`  ${configPath}`));
   console.log(chalk.dim("Set AI_GATEWAY_API_KEY and run sparkecoder to start"));
@@ -17195,11 +17444,11 @@ program.command("slack-setup").description("Interactively configure Slack integr
       console.error(chalk.red("Both bot token and signing secret are required."));
       process.exit(1);
     }
-    const configPath = options.global ? join16(ensureAppDataDirectory(), "sparkecoder.config.json") : resolve12(process.cwd(), "sparkecoder.config.json");
+    const configPath = options.global ? join17(ensureAppDataDirectory(), "sparkecoder.config.json") : resolve12(process.cwd(), "sparkecoder.config.json");
     let existing = {};
-    if (existsSync21(configPath)) {
+    if (existsSync22(configPath)) {
       try {
-        existing = JSON.parse(readFileSync10(configPath, "utf-8"));
+        existing = JSON.parse(readFileSync11(configPath, "utf-8"));
       } catch {
       }
     } else {
@@ -17211,7 +17460,7 @@ program.command("slack-setup").description("Interactively configure Slack integr
       signingSecret,
       defaultOrchestratorName: existing.slack?.defaultOrchestratorName ?? "orchestrator"
     };
-    writeFileSync6(configPath, JSON.stringify(existing, null, 2));
+    writeFileSync7(configPath, JSON.stringify(existing, null, 2));
     console.log(chalk.green(`
 \u2713 Slack configured`));
     console.log(chalk.dim(`  ${configPath}`));
@@ -17463,9 +17712,9 @@ program.command("cloudflared-setup").description("Auto-detect cloudflared + set
     }
     const verOut = run("cloudflared", ["--version"]).stdout?.toString().split("\n")[0] || "installed";
     console.log(chalk.green("\u2713"), "cloudflared:", chalk.dim(verOut));
-    const cfDir = join16(homedir2(), ".cloudflared");
-    const certPath = join16(cfDir, "cert.pem");
-    if (!existsSync21(certPath)) {
+    const cfDir = join17(homedir2(), ".cloudflared");
+    const certPath = join17(cfDir, "cert.pem");
+    if (!existsSync22(certPath)) {
       console.log(chalk.yellow("No Cloudflare login cert found."));
       if (await confirm("Run `cloudflared tunnel login` now (opens a browser)?", true)) {
         run("cloudflared", ["tunnel", "login"], { inheritIO: true, check: true });
@@ -17509,8 +17758,8 @@ program.command("cloudflared-setup").description("Auto-detect cloudflared + set
         return;
       }
     }
-    const credsFile = tunnel.credentials_file || join16(cfDir, `${tunnel.id}.json`);
-    if (!existsSync21(credsFile)) {
+    const credsFile = tunnel.credentials_file || join17(cfDir, `${tunnel.id}.json`);
+    if (!existsSync22(credsFile)) {
       console.log(chalk.yellow(`Credentials file not found at ${credsFile}. The tunnel may still work via cert.pem.`));
     }
     let hostname = options.hostname;
@@ -17533,7 +17782,7 @@ program.command("cloudflared-setup").description("Auto-detect cloudflared + set
         console.log(chalk.yellow("DNS route warning:"), err.trim().split("\n").slice(-2).join(" "));
       }
     }
-    const configPath = join16(cfDir, "config.yml");
+    const configPath = join17(cfDir, "config.yml");
     const configBody = `tunnel: ${tunnel.id}
 credentials-file: ${credsFile}
 ingress:
@@ -17544,14 +17793,14 @@ ingress:
   - service: http_status:404
 `;
     let wroteConfig = false;
-    if (existsSync21(configPath)) {
-      const existing = readFileSync10(configPath, "utf8");
+    if (existsSync22(configPath)) {
+      const existing = readFileSync11(configPath, "utf8");
       if (existing.trim() === configBody.trim()) {
         console.log(chalk.green("\u2713"), `config.yml already up to date: ${configPath}`);
         wroteConfig = true;
       } else if (await confirm(`A different ${configPath} exists. Overwrite (a backup will be saved)?`, false)) {
         copyFileSync(configPath, `${configPath}.bak.${Date.now()}`);
-        writeFileSync6(configPath, configBody);
+        writeFileSync7(configPath, configBody);
         console.log(chalk.green("\u2713"), `wrote ${configPath} (previous saved as .bak.*)`);
         wroteConfig = true;
       } else {
@@ -17559,7 +17808,7 @@ ingress:
         console.log(chalk.cyan(configBody));
       }
     } else {
-      writeFileSync6(configPath, configBody);
+      writeFileSync7(configPath, configBody);
       console.log(chalk.green("\u2713"), `wrote ${configPath}`);
       wroteConfig = true;
     }
@@ -18028,17 +18277,17 @@ program.command("request-permissions").description("Request macOS permissions fo
 });
 {
   let stateFilePath = function() {
-    return join16(ensureAppDataDirectory(), "recordings.json");
+    return join17(ensureAppDataDirectory(), "recordings.json");
   }, readState = function() {
     const p = stateFilePath();
-    if (!existsSync21(p)) return [];
+    if (!existsSync22(p)) return [];
     try {
-      return JSON.parse(readFileSync10(p, "utf-8"));
+      return JSON.parse(readFileSync11(p, "utf-8"));
     } catch {
       return [];
     }
   }, writeState = function(rows) {
-    writeFileSync6(stateFilePath(), JSON.stringify(rows, null, 2), { mode: 384 });
+    writeFileSync7(stateFilePath(), JSON.stringify(rows, null, 2), { mode: 384 });
   }, isAlive = function(pid) {
     try {
       process.kill(pid, 0);
@@ -18052,18 +18301,17 @@ program.command("request-permissions").description("Request macOS permissions fo
   stateFilePath2 = stateFilePath, readState2 = readState, writeState2 = writeState, isAlive2 = isAlive, pruneDead2 = pruneDead;
   const record = program.command("record").description("Start/stop screen recordings");
   record.command("start").description("Start a screen recording (returns id, path, pid as JSON)").option("--name <slug>", "Optional human-readable label for the recording").option("--dir <path>", "Output directory (default: ~/recordings)").action(async (opts) => {
-    const { spawn: spawn3 } = await import("child_process");
     const { homedir: homedir2, platform: osPlatform } = await import("os");
-    const outDir = opts.dir ? resolve12(opts.dir.replace(/^~/, homedir2())) : join16(homedir2(), "recordings");
-    mkdirSync10(outDir, { recursive: true });
+    const outDir = opts.dir ? resolve12(opts.dir.replace(/^~/, homedir2())) : join17(homedir2(), "recordings");
+    mkdirSync11(outDir, { recursive: true });
     const id = `rec-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`;
     const ext = osPlatform() === "darwin" ? "mov" : "mp4";
     const filename = `${id}${opts.name ? `-${String(opts.name).replace(/[^a-z0-9-]+/gi, "-").toLowerCase()}` : ""}.${ext}`;
-    const path = join16(outDir, filename);
+    const path = join17(outDir, filename);
     let cmd;
     let args;
     if (osPlatform() === "darwin") {
-      cmd = "screencapture";
+      cmd = existsSync22("/usr/sbin/screencapture") ? "/usr/sbin/screencapture" : "screencapture";
       args = ["-v", "-C", "-k", path];
     } else if (osPlatform() === "linux") {
       const display = process.env.DISPLAY || ":0.0";
@@ -18091,12 +18339,43 @@ program.command("request-permissions").description("Request macOS permissions fo
       console.error(JSON.stringify({ error: `Unsupported platform: ${osPlatform()}` }));
       process.exit(1);
     }
-    const child = spawn3(cmd, args, { detached: true, stdio: "ignore" });
-    child.unref();
-    if (!child.pid) {
-      console.error(JSON.stringify({ error: `Failed to spawn ${cmd}` }));
+    const { spawn: spawnRec } = await import("child_process");
+    const child = spawnRec(cmd, args, { detached: true, stdio: ["ignore", "ignore", "pipe"] });
+    let stderrTail = "";
+    child.stderr?.on("data", (b) => {
+      stderrTail = (stderrTail + b.toString()).slice(-2e3);
+    });
+    let spawnError = null;
+    child.on("error", (err) => {
+      spawnError = err?.message ?? String(err);
+    });
+    let exited = false;
+    let exitCode = null;
+    child.on("exit", (code) => {
+      exited = true;
+      exitCode = code;
+    });
+    await new Promise((r) => setTimeout(r, 600));
+    if (spawnError || exited || !child.pid) {
+      const diagnosis = [
+        spawnError && `spawn error: ${spawnError}`,
+        exited && `recorder exited code=${exitCode} within 600ms`,
+        stderrTail.trim() && `stderr: ${stderrTail.trim()}`,
+        osPlatform() === "darwin" && `tried: ${cmd} ${args.join(" ")}`,
+        osPlatform() === "darwin" && `if missing Screen Recording permission, run: sparkecoder request-permissions`,
+        osPlatform() === "linux" && `display=${process.env.DISPLAY || ":0.0"} \u2014 ensure X server is running and ffmpeg is installed`
+      ].filter(Boolean).join(". ");
+      console.error(JSON.stringify({
+        error: `Failed to start ${cmd}`,
+        detail: diagnosis || "(no diagnostic output)",
+        cmd,
+        args,
+        pid: child.pid,
+        exitCode
+      }));
       process.exit(1);
     }
+    child.unref();
     const row = {
       id,
       name: opts.name,
@@ -18135,7 +18414,7 @@ program.command("request-permissions").description("Request macOS permissions fo
       }
     }
     writeState(rows.filter((r) => r.id !== id));
-    const fileExists = existsSync21(row.path);
+    const fileExists = existsSync22(row.path);
     const sizeMb = fileExists ? Math.round(statSync3(row.path).size / (1024 * 1024) * 10) / 10 : 0;
     console.log(JSON.stringify({
       id,
@@ -18170,7 +18449,7 @@ program.command("request-permissions").description("Request macOS permissions fo
           }
         }
       }
-      stopped.push({ id: r.id, path: r.path, ok: existsSync21(r.path) });
+      stopped.push({ id: r.id, path: r.path, ok: existsSync22(r.path) });
     }
     writeState([]);
     console.log(JSON.stringify({ stopped }));