struere 0.16.1 → 0.16.3

package/dist/bin/struere.js

@@ -73596,6 +73596,144 @@ async function findThreadByPhone(options) {
     return false;
   }) ?? null;
 }
+async function replyToThread(options) {
+  const apiKey = getApiKey();
+  const credentials = loadCredentials();
+  if (apiKey && !credentials?.token) {
+    return threadsApiCall("/v1/threads/reply", {
+      threadId: options.threadId,
+      message: options.message
+    });
+  }
+  const token = getToken5();
+  const response = await fetch(`${CONVEX_URL}/api/action`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${token}`
+    },
+    body: JSON.stringify({
+      path: "chat:replyToThreadCli",
+      args: { threadId: options.threadId, message: options.message }
+    }),
+    signal: AbortSignal.timeout(30000)
+  });
+  const text = await response.text();
+  let json;
+  try {
+    json = JSON.parse(text);
+  } catch {
+    throw new Error(text || `HTTP ${response.status}`);
+  }
+  if (!response.ok) {
+    throw new Error(json.errorData?.message || json.errorMessage || text);
+  }
+  if (json.status === "error") {
+    throw new Error(json.errorData?.message || json.errorMessage || "Unknown error from Convex");
+  }
+  return json.value;
+}
+async function pauseThread(options) {
+  const apiKey = getApiKey();
+  const credentials = loadCredentials();
+  if (apiKey && !credentials?.token) {
+    return threadsApiCall("/v1/threads/pause", {
+      threadId: options.threadId
+    });
+  }
+  const token = getToken5();
+  const response = await fetch(`${CONVEX_URL}/api/mutation`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${token}`
+    },
+    body: JSON.stringify({
+      path: "threads:setAgentPaused",
+      args: { threadId: options.threadId, paused: true }
+    }),
+    signal: AbortSignal.timeout(30000)
+  });
+  const text = await response.text();
+  let json;
+  try {
+    json = JSON.parse(text);
+  } catch {
+    throw new Error(text || `HTTP ${response.status}`);
+  }
+  if (!response.ok) {
+    throw new Error(json.errorData?.message || json.errorMessage || text);
+  }
+  if (json.status === "error") {
+    throw new Error(json.errorData?.message || json.errorMessage || "Unknown error from Convex");
+  }
+  return { success: true, paused: true };
+}
+async function resumeThread(options) {
+  const apiKey = getApiKey();
+  const credentials = loadCredentials();
+  if (apiKey && !credentials?.token) {
+    return threadsApiCall("/v1/threads/resume", {
+      threadId: options.threadId
+    });
+  }
+  const token = getToken5();
+  const response = await fetch(`${CONVEX_URL}/api/mutation`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${token}`
+    },
+    body: JSON.stringify({
+      path: "threads:setAgentPaused",
+      args: { threadId: options.threadId, paused: false }
+    }),
+    signal: AbortSignal.timeout(30000)
+  });
+  const text = await response.text();
+  let json;
+  try {
+    json = JSON.parse(text);
+  } catch {
+    throw new Error(text || `HTTP ${response.status}`);
+  }
+  if (!response.ok) {
+    throw new Error(json.errorData?.message || json.errorMessage || text);
+  }
+  if (json.status === "error") {
+    throw new Error(json.errorData?.message || json.errorMessage || "Unknown error from Convex");
+  }
+  return { success: true, paused: false };
+}
+async function resolveActiveWhatsAppThread(options) {
+  const threads = await listThreads({
+    environment: options.environment,
+    organizationId: options.organizationId,
+    limit: 100
+  });
+  const isPhone = options.target.startsWith("+") || /^\d+$/.test(options.target);
+  let matches;
+  if (isPhone) {
+    const normalize = (p) => p.replace(/\D/g, "");
+    const normalizedInput = normalize(options.target);
+    matches = threads.filter((t2) => {
+      const phoneNumber = t2.channelParams?.phoneNumber;
+      if (phoneNumber && normalize(phoneNumber) === normalizedInput)
+        return true;
+      if (t2.externalId && t2.externalId.includes(normalizedInput))
+        return true;
+      return false;
+    });
+  } else {
+    matches = threads.filter((t2) => t2._id === options.target);
+  }
+  const active = matches.filter((t2) => !t2.externalId?.includes(":archived:"));
+  if (active.length === 0)
+    return { kind: "none" };
+  if (active.length === 1)
+    return { kind: "ok", thread: active[0] };
+  return { kind: "multiple", candidates: active };
+}
 
 // src/cli/commands/threads.ts
 async function ensureAuth7() {
@@ -73676,6 +73814,16 @@ function roleColor(role) {
       return chalk22.gray(role);
   }
 }
+function threadPhone(thread) {
+  const phoneNumber = thread.channelParams?.phoneNumber;
+  if (phoneNumber)
+    return phoneNumber;
+  if (thread.externalId) {
+    const parts = thread.externalId.split(":");
+    return parts[parts.length - 1];
+  }
+  return "unknown";
+}
 var threadsCommand = new Command20("threads").description("Manage conversation threads");
 threadsCommand.command("list", { isDefault: true }).description("List conversation threads").option("--env <environment>", "Environment (development|production|eval)", "development").option("--channel <channel>", "Filter by channel (whatsapp|api|widget|dashboard|voice)").option("--limit <n>", "Maximum results", "25").option("--json", "Output raw JSON").action(async (opts) => {
   await ensureAuth7();
@@ -73703,7 +73851,7 @@ threadsCommand.command("list", { isDefault: true }).description("List conversati
     ], threads.map((t2) => ({
       id: t2._id,
       channel: channelColor(t2.channel),
-      participant: t2.participantName ?? "Unknown",
+      participant: t2.agentPaused ? `${t2.participantName ?? "Unknown"} ${chalk22.yellow("PAUSED")}` : t2.participantName ?? "Unknown",
       agent: t2.agentName ?? "Unknown",
       lastMessage: t2.lastMessage ? t2.lastMessage.content.slice(0, 40) : chalk22.gray("-"),
       time: relativeTime4(t2.updatedAt ?? t2.createdAt)
@@ -73859,6 +74007,138 @@ threadsCommand.command("reset").description("Archive a thread by phone number").
     process.exit(1);
   }
 });
+async function resolveOrExit(target, environment, json, spinner) {
+  const project = loadProject(process.cwd());
+  const resolution = await resolveActiveWhatsAppThread({
+    target,
+    environment,
+    organizationId: project?.organization.id
+  });
+  if (resolution.kind === "none") {
+    const error = `No active WhatsApp thread found for "${target}" in ${environment}. Did you mean --env production?`;
+    spinner?.fail(error);
+    if (json) {
+      console.log(JSON.stringify({ success: false, error }));
+    } else {
+      console.log(chalk22.red("Error:"), error);
+    }
+    process.exit(1);
+  }
+  if (resolution.kind === "multiple") {
+    spinner?.stop();
+    if (json) {
+      console.log(JSON.stringify({ success: false, error: `Multiple active threads match ${target}` }));
+    } else {
+      console.log(chalk22.yellow(`Multiple active threads match ${target}:`));
+      for (const candidate of resolution.candidates) {
+        console.log(`  ${chalk22.cyan(candidate._id)}  ${candidate.agentName ?? "Unknown"}  ${threadPhone(candidate)}`);
+      }
+      console.log(chalk22.gray("Re-run with an explicit thread id."));
+    }
+    process.exit(1);
+  }
+  const thread = resolution.thread;
+  if (!thread.externalId?.startsWith("whatsapp:")) {
+    const error = `Thread ${thread._id} is not a WhatsApp conversation (reply/pause/resume only support WhatsApp).`;
+    spinner?.fail(error);
+    if (json) {
+      console.log(JSON.stringify({ success: false, error }));
+    } else {
+      console.log(chalk22.red("Error:"), error);
+    }
+    process.exit(1);
+  }
+  return thread;
+}
+threadsCommand.command("reply").description("Send a WhatsApp message directly to a user as a human operator (does not pause the agent)").argument("<target>", "Thread id or phone number").requiredOption("-m, --message <text>", "Message to send to the user").option("--env <environment>", "Environment: development | production | eval", "development").option("--json", "Output raw JSON").action(async (target, opts) => {
+  await ensureAuth7();
+  const spinner = opts.json ? null : ora16();
+  const environment = opts.env;
+  try {
+    spinner?.start(`Resolving thread for ${target}...`);
+    const thread = await resolveOrExit(target, environment, !!opts.json, spinner);
+    const phone = threadPhone(thread);
+    if (spinner)
+      spinner.text = `Sending to ${phone}...`;
+    const result = await replyToThread({
+      threadId: thread._id,
+      message: opts.message,
+      environment
+    });
+    if (result.whatsappStatus === "failed") {
+      spinner?.fail(`Failed to send to ${phone} (env: ${environment})`);
+      if (opts.json) {
+        console.log(JSON.stringify({ success: false, threadId: thread._id, whatsappStatus: result.whatsappStatus, environment }));
+      } else {
+        console.log(chalk22.gray(`Tip: the 24h window may be closed or the connection is not connected. Re-open with a template: struere run-tool whatsapp.sendTemplate --args '{"to":"${phone}","templateName":"...","language":"..."}'`));
+      }
+      process.exit(1);
+    }
+    spinner?.succeed(chalk22.green(`Sent to ${phone} (env: ${environment})`));
+    if (opts.json) {
+      console.log(JSON.stringify({ success: true, threadId: thread._id, whatsappStatus: result.whatsappStatus, environment }));
+    }
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    spinner?.fail("Failed to reply to thread");
+    if (opts.json) {
+      console.log(JSON.stringify({ success: false, error: message }));
+    } else {
+      console.log(chalk22.red("Error:"), message);
+    }
+    process.exit(1);
+  }
+});
+threadsCommand.command("pause").description("Pause the agent on a conversation so it stops auto-responding").argument("<target>", "Thread id or phone number").option("--env <environment>", "Environment: development | production | eval", "development").option("--json", "Output raw JSON").action(async (target, opts) => {
+  await ensureAuth7();
+  const spinner = opts.json ? null : ora16();
+  const environment = opts.env;
+  try {
+    spinner?.start(`Resolving thread for ${target}...`);
+    const thread = await resolveOrExit(target, environment, !!opts.json, spinner);
+    if (spinner)
+      spinner.text = `Pausing agent for thread ${thread._id}...`;
+    await pauseThread({ threadId: thread._id, environment });
+    spinner?.succeed(chalk22.green(`Agent paused for thread ${thread._id} (env: ${environment})`));
+    if (opts.json) {
+      console.log(JSON.stringify({ success: true, threadId: thread._id, paused: true, environment }));
+    }
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    spinner?.fail("Failed to pause thread");
+    if (opts.json) {
+      console.log(JSON.stringify({ success: false, error: message }));
+    } else {
+      console.log(chalk22.red("Error:"), message);
+    }
+    process.exit(1);
+  }
+});
+threadsCommand.command("resume").description("Resume the agent on a paused conversation").argument("<target>", "Thread id or phone number").option("--env <environment>", "Environment: development | production | eval", "development").option("--json", "Output raw JSON").action(async (target, opts) => {
+  await ensureAuth7();
+  const spinner = opts.json ? null : ora16();
+  const environment = opts.env;
+  try {
+    spinner?.start(`Resolving thread for ${target}...`);
+    const thread = await resolveOrExit(target, environment, !!opts.json, spinner);
+    if (spinner)
+      spinner.text = `Resuming agent for thread ${thread._id}...`;
+    await resumeThread({ threadId: thread._id, environment });
+    spinner?.succeed(chalk22.green(`Agent resumed for thread ${thread._id} (env: ${environment})`));
+    if (opts.json) {
+      console.log(JSON.stringify({ success: true, threadId: thread._id, paused: false, environment }));
+    }
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    spinner?.fail("Failed to resume thread");
+    if (opts.json) {
+      console.log(JSON.stringify({ success: false, error: message }));
+    } else {
+      console.log(chalk22.red("Error:"), message);
+    }
+    process.exit(1);
+  }
+});
 
 // src/cli/commands/compile-prompt.ts
 init_credentials();
@@ -75914,7 +76194,7 @@ keysCommand.command("revoke <id-or-prefix>").description("Revoke an API key (del
 // package.json
 var package_default = {
   name: "struere",
-  version: "0.16.1",
+  version: "0.16.3",
   description: "Build, test, and deploy AI agents",
   keywords: [
     "ai",

package/dist/cli/commands/threads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/threads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AA2FnC,eAAO,MAAM,cAAc,SACkB,CAAA"}
+{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/threads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AA0GnC,eAAO,MAAM,cAAc,SACkB,CAAA"}

package/dist/cli/index.js

@@ -74586,6 +74586,144 @@ async function findThreadByPhone(options) {
     return false;
   }) ?? null;
 }
+async function replyToThread(options) {
+  const apiKey = getApiKey();
+  const credentials = loadCredentials();
+  if (apiKey && !credentials?.token) {
+    return threadsApiCall("/v1/threads/reply", {
+      threadId: options.threadId,
+      message: options.message
+    });
+  }
+  const token = getToken5();
+  const response = await fetch(`${CONVEX_URL}/api/action`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${token}`
+    },
+    body: JSON.stringify({
+      path: "chat:replyToThreadCli",
+      args: { threadId: options.threadId, message: options.message }
+    }),
+    signal: AbortSignal.timeout(30000)
+  });
+  const text = await response.text();
+  let json;
+  try {
+    json = JSON.parse(text);
+  } catch {
+    throw new Error(text || `HTTP ${response.status}`);
+  }
+  if (!response.ok) {
+    throw new Error(json.errorData?.message || json.errorMessage || text);
+  }
+  if (json.status === "error") {
+    throw new Error(json.errorData?.message || json.errorMessage || "Unknown error from Convex");
+  }
+  return json.value;
+}
+async function pauseThread(options) {
+  const apiKey = getApiKey();
+  const credentials = loadCredentials();
+  if (apiKey && !credentials?.token) {
+    return threadsApiCall("/v1/threads/pause", {
+      threadId: options.threadId
+    });
+  }
+  const token = getToken5();
+  const response = await fetch(`${CONVEX_URL}/api/mutation`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${token}`
+    },
+    body: JSON.stringify({
+      path: "threads:setAgentPaused",
+      args: { threadId: options.threadId, paused: true }
+    }),
+    signal: AbortSignal.timeout(30000)
+  });
+  const text = await response.text();
+  let json;
+  try {
+    json = JSON.parse(text);
+  } catch {
+    throw new Error(text || `HTTP ${response.status}`);
+  }
+  if (!response.ok) {
+    throw new Error(json.errorData?.message || json.errorMessage || text);
+  }
+  if (json.status === "error") {
+    throw new Error(json.errorData?.message || json.errorMessage || "Unknown error from Convex");
+  }
+  return { success: true, paused: true };
+}
+async function resumeThread(options) {
+  const apiKey = getApiKey();
+  const credentials = loadCredentials();
+  if (apiKey && !credentials?.token) {
+    return threadsApiCall("/v1/threads/resume", {
+      threadId: options.threadId
+    });
+  }
+  const token = getToken5();
+  const response = await fetch(`${CONVEX_URL}/api/mutation`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${token}`
+    },
+    body: JSON.stringify({
+      path: "threads:setAgentPaused",
+      args: { threadId: options.threadId, paused: false }
+    }),
+    signal: AbortSignal.timeout(30000)
+  });
+  const text = await response.text();
+  let json;
+  try {
+    json = JSON.parse(text);
+  } catch {
+    throw new Error(text || `HTTP ${response.status}`);
+  }
+  if (!response.ok) {
+    throw new Error(json.errorData?.message || json.errorMessage || text);
+  }
+  if (json.status === "error") {
+    throw new Error(json.errorData?.message || json.errorMessage || "Unknown error from Convex");
+  }
+  return { success: true, paused: false };
+}
+async function resolveActiveWhatsAppThread(options) {
+  const threads = await listThreads({
+    environment: options.environment,
+    organizationId: options.organizationId,
+    limit: 100
+  });
+  const isPhone = options.target.startsWith("+") || /^\d+$/.test(options.target);
+  let matches;
+  if (isPhone) {
+    const normalize = (p) => p.replace(/\D/g, "");
+    const normalizedInput = normalize(options.target);
+    matches = threads.filter((t2) => {
+      const phoneNumber = t2.channelParams?.phoneNumber;
+      if (phoneNumber && normalize(phoneNumber) === normalizedInput)
+        return true;
+      if (t2.externalId && t2.externalId.includes(normalizedInput))
+        return true;
+      return false;
+    });
+  } else {
+    matches = threads.filter((t2) => t2._id === options.target);
+  }
+  const active = matches.filter((t2) => !t2.externalId?.includes(":archived:"));
+  if (active.length === 0)
+    return { kind: "none" };
+  if (active.length === 1)
+    return { kind: "ok", thread: active[0] };
+  return { kind: "multiple", candidates: active };
+}
 
 // src/cli/commands/threads.ts
 async function ensureAuth7() {
@@ -74666,6 +74804,16 @@ function roleColor(role) {
       return chalk27.gray(role);
   }
 }
+function threadPhone(thread) {
+  const phoneNumber = thread.channelParams?.phoneNumber;
+  if (phoneNumber)
+    return phoneNumber;
+  if (thread.externalId) {
+    const parts = thread.externalId.split(":");
+    return parts[parts.length - 1];
+  }
+  return "unknown";
+}
 var threadsCommand = new Command25("threads").description("Manage conversation threads");
 threadsCommand.command("list", { isDefault: true }).description("List conversation threads").option("--env <environment>", "Environment (development|production|eval)", "development").option("--channel <channel>", "Filter by channel (whatsapp|api|widget|dashboard|voice)").option("--limit <n>", "Maximum results", "25").option("--json", "Output raw JSON").action(async (opts) => {
   await ensureAuth7();
@@ -74693,7 +74841,7 @@ threadsCommand.command("list", { isDefault: true }).description("List conversati
     ], threads.map((t2) => ({
       id: t2._id,
       channel: channelColor(t2.channel),
-      participant: t2.participantName ?? "Unknown",
+      participant: t2.agentPaused ? `${t2.participantName ?? "Unknown"} ${chalk27.yellow("PAUSED")}` : t2.participantName ?? "Unknown",
       agent: t2.agentName ?? "Unknown",
       lastMessage: t2.lastMessage ? t2.lastMessage.content.slice(0, 40) : chalk27.gray("-"),
       time: relativeTime4(t2.updatedAt ?? t2.createdAt)
@@ -74849,6 +74997,138 @@ threadsCommand.command("reset").description("Archive a thread by phone number").
     process.exit(1);
   }
 });
+async function resolveOrExit(target, environment, json, spinner) {
+  const project = loadProject(process.cwd());
+  const resolution = await resolveActiveWhatsAppThread({
+    target,
+    environment,
+    organizationId: project?.organization.id
+  });
+  if (resolution.kind === "none") {
+    const error = `No active WhatsApp thread found for "${target}" in ${environment}. Did you mean --env production?`;
+    spinner?.fail(error);
+    if (json) {
+      console.log(JSON.stringify({ success: false, error }));
+    } else {
+      console.log(chalk27.red("Error:"), error);
+    }
+    process.exit(1);
+  }
+  if (resolution.kind === "multiple") {
+    spinner?.stop();
+    if (json) {
+      console.log(JSON.stringify({ success: false, error: `Multiple active threads match ${target}` }));
+    } else {
+      console.log(chalk27.yellow(`Multiple active threads match ${target}:`));
+      for (const candidate of resolution.candidates) {
+        console.log(`  ${chalk27.cyan(candidate._id)}  ${candidate.agentName ?? "Unknown"}  ${threadPhone(candidate)}`);
+      }
+      console.log(chalk27.gray("Re-run with an explicit thread id."));
+    }
+    process.exit(1);
+  }
+  const thread = resolution.thread;
+  if (!thread.externalId?.startsWith("whatsapp:")) {
+    const error = `Thread ${thread._id} is not a WhatsApp conversation (reply/pause/resume only support WhatsApp).`;
+    spinner?.fail(error);
+    if (json) {
+      console.log(JSON.stringify({ success: false, error }));
+    } else {
+      console.log(chalk27.red("Error:"), error);
+    }
+    process.exit(1);
+  }
+  return thread;
+}
+threadsCommand.command("reply").description("Send a WhatsApp message directly to a user as a human operator (does not pause the agent)").argument("<target>", "Thread id or phone number").requiredOption("-m, --message <text>", "Message to send to the user").option("--env <environment>", "Environment: development | production | eval", "development").option("--json", "Output raw JSON").action(async (target, opts) => {
+  await ensureAuth7();
+  const spinner = opts.json ? null : ora20();
+  const environment = opts.env;
+  try {
+    spinner?.start(`Resolving thread for ${target}...`);
+    const thread = await resolveOrExit(target, environment, !!opts.json, spinner);
+    const phone = threadPhone(thread);
+    if (spinner)
+      spinner.text = `Sending to ${phone}...`;
+    const result = await replyToThread({
+      threadId: thread._id,
+      message: opts.message,
+      environment
+    });
+    if (result.whatsappStatus === "failed") {
+      spinner?.fail(`Failed to send to ${phone} (env: ${environment})`);
+      if (opts.json) {
+        console.log(JSON.stringify({ success: false, threadId: thread._id, whatsappStatus: result.whatsappStatus, environment }));
+      } else {
+        console.log(chalk27.gray(`Tip: the 24h window may be closed or the connection is not connected. Re-open with a template: struere run-tool whatsapp.sendTemplate --args '{"to":"${phone}","templateName":"...","language":"..."}'`));
+      }
+      process.exit(1);
+    }
+    spinner?.succeed(chalk27.green(`Sent to ${phone} (env: ${environment})`));
+    if (opts.json) {
+      console.log(JSON.stringify({ success: true, threadId: thread._id, whatsappStatus: result.whatsappStatus, environment }));
+    }
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    spinner?.fail("Failed to reply to thread");
+    if (opts.json) {
+      console.log(JSON.stringify({ success: false, error: message }));
+    } else {
+      console.log(chalk27.red("Error:"), message);
+    }
+    process.exit(1);
+  }
+});
+threadsCommand.command("pause").description("Pause the agent on a conversation so it stops auto-responding").argument("<target>", "Thread id or phone number").option("--env <environment>", "Environment: development | production | eval", "development").option("--json", "Output raw JSON").action(async (target, opts) => {
+  await ensureAuth7();
+  const spinner = opts.json ? null : ora20();
+  const environment = opts.env;
+  try {
+    spinner?.start(`Resolving thread for ${target}...`);
+    const thread = await resolveOrExit(target, environment, !!opts.json, spinner);
+    if (spinner)
+      spinner.text = `Pausing agent for thread ${thread._id}...`;
+    await pauseThread({ threadId: thread._id, environment });
+    spinner?.succeed(chalk27.green(`Agent paused for thread ${thread._id} (env: ${environment})`));
+    if (opts.json) {
+      console.log(JSON.stringify({ success: true, threadId: thread._id, paused: true, environment }));
+    }
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    spinner?.fail("Failed to pause thread");
+    if (opts.json) {
+      console.log(JSON.stringify({ success: false, error: message }));
+    } else {
+      console.log(chalk27.red("Error:"), message);
+    }
+    process.exit(1);
+  }
+});
+threadsCommand.command("resume").description("Resume the agent on a paused conversation").argument("<target>", "Thread id or phone number").option("--env <environment>", "Environment: development | production | eval", "development").option("--json", "Output raw JSON").action(async (target, opts) => {
+  await ensureAuth7();
+  const spinner = opts.json ? null : ora20();
+  const environment = opts.env;
+  try {
+    spinner?.start(`Resolving thread for ${target}...`);
+    const thread = await resolveOrExit(target, environment, !!opts.json, spinner);
+    if (spinner)
+      spinner.text = `Resuming agent for thread ${thread._id}...`;
+    await resumeThread({ threadId: thread._id, environment });
+    spinner?.succeed(chalk27.green(`Agent resumed for thread ${thread._id} (env: ${environment})`));
+    if (opts.json) {
+      console.log(JSON.stringify({ success: true, threadId: thread._id, paused: false, environment }));
+    }
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    spinner?.fail("Failed to resume thread");
+    if (opts.json) {
+      console.log(JSON.stringify({ success: false, error: message }));
+    } else {
+      console.log(chalk27.red("Error:"), message);
+    }
+    process.exit(1);
+  }
+});
 
 // src/cli/commands/compile-prompt.ts
 init_credentials();
@@ -76904,7 +77184,7 @@ keysCommand.command("revoke <id-or-prefix>").description("Revoke an API key (del
 // package.json
 var package_default = {
   name: "struere",
-  version: "0.16.1",
+  version: "0.16.3",
   description: "Build, test, and deploy AI agents",
   keywords: [
     "ai",

package/dist/cli/utils/threads.d.ts

@@ -12,6 +12,7 @@ export interface ThreadPreview {
     } | null;
     participantName: string;
     messageCount: number;
+    agentPaused?: boolean;
     createdAt: number;
     updatedAt: number;
 }
@@ -58,4 +59,40 @@ export declare function findThreadByPhone(options: {
     environment: string;
     organizationId?: string;
 }): Promise<ThreadPreview | null>;
+export declare function replyToThread(options: {
+    threadId: string;
+    message: string;
+    environment: string;
+}): Promise<{
+    success: boolean;
+    whatsappStatus: 'sent' | 'failed' | 'skipped';
+}>;
+export declare function pauseThread(options: {
+    threadId: string;
+    environment: string;
+}): Promise<{
+    success: boolean;
+    paused: boolean;
+}>;
+export declare function resumeThread(options: {
+    threadId: string;
+    environment: string;
+}): Promise<{
+    success: boolean;
+    paused: boolean;
+}>;
+export type ResolveResult = {
+    kind: 'ok';
+    thread: ThreadPreview;
+} | {
+    kind: 'none';
+} | {
+    kind: 'multiple';
+    candidates: ThreadPreview[];
+};
+export declare function resolveActiveWhatsAppThread(options: {
+    target: string;
+    environment: string;
+    organizationId?: string;
+}): Promise<ResolveResult>;
 //# sourceMappingURL=threads.d.ts.map

package/dist/cli/utils/threads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/threads.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACvC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IACzE,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AA4GD,wBAAsB,WAAW,CAAC,OAAO,EAAE;IACzC,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAkB3B;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE;IACnD,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,GAAG,OAAO,CAAC;IACV,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACvC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,KAAK,CAAC;QACd,GAAG,EAAE,MAAM,CAAA;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;QACf,SAAS,EAAE,MAAM,CAAA;QACjB,SAAS,CAAC,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,OAAO,CAAA;SAAE,CAAC,CAAA;KACpE,CAAC,CAAA;CACH,GAAG,IAAI,CAAC,CAKR;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE;IAC3C,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAmChC;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAgBhC"}
+{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/threads.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "struere",
-  "version": "0.16.1",
+  "version": "0.16.3",
   "description": "Build, test, and deploy AI agents",
   "keywords": [
     "ai",