@skillrecordings/cli 0.5.0 → 0.6.0

package/dist/index.js

@@ -91670,6 +91670,77 @@ function registerFaqCommands(program3) {
 // src/commands/front/index.ts
 init_esm_shims();
 
+// src/commands/front/api.ts
+init_esm_shims();
+function getFrontClient() {
+  const apiToken = process.env.FRONT_API_TOKEN;
+  if (!apiToken) {
+    throw new Error("FRONT_API_TOKEN environment variable is required");
+  }
+  return createInstrumentedFrontClient({ apiToken });
+}
+async function apiPassthrough(method, endpoint, options) {
+  const front = getFrontClient();
+  const httpMethod = method.toUpperCase();
+  let body = void 0;
+  if (options.data) {
+    try {
+      body = JSON.parse(options.data);
+    } catch {
+      throw new Error("Invalid JSON in --data");
+    }
+  }
+  const normalizedEndpoint = endpoint.startsWith("/") ? endpoint : `/${endpoint}`;
+  let result;
+  switch (httpMethod) {
+    case "GET":
+      result = await front.raw.get(normalizedEndpoint);
+      break;
+    case "POST":
+      result = await front.raw.post(normalizedEndpoint, body);
+      break;
+    case "PATCH":
+      result = await front.raw.patch(normalizedEndpoint, body);
+      break;
+    case "PUT":
+      result = await front.raw.put(normalizedEndpoint, body);
+      break;
+    case "DELETE":
+      result = await front.raw.delete(normalizedEndpoint);
+      break;
+    default:
+      throw new Error(
+        `Unsupported method: ${method}. Use GET, POST, PATCH, PUT, or DELETE.`
+      );
+  }
+  console.log(JSON.stringify(result, null, 2));
+}
+function registerApiCommand(frontCommand) {
+  frontCommand.command("api").description("Raw Front API request (escape hatch)").argument("<method>", "HTTP method (GET, POST, PATCH, PUT, DELETE)").argument(
+    "<endpoint>",
+    "API endpoint path (e.g., /me, /conversations/cnv_xxx)"
+  ).option("--data <json>", "Request body as JSON string").action(
+    async (method, endpoint, options) => {
+      try {
+        await apiPassthrough(method, endpoint, options);
+      } catch (error) {
+        console.error(
+          JSON.stringify(
+            {
+              error: error instanceof Error ? error.message : "Unknown error",
+              method: method.toUpperCase(),
+              endpoint
+            },
+            null,
+            2
+          )
+        );
+        process.exit(1);
+      }
+    }
+  );
+}
+
 // src/commands/front/archive.ts
 init_esm_shims();
 
@@ -91721,6 +91792,31 @@ function conversationActions(convId) {
       description: "Archive this conversation",
       destructive: true
     },
+    {
+      action: "assign",
+      command: `skill front assign ${convId} <teammate-id> --json`,
+      description: "Assign to a teammate"
+    },
+    {
+      action: "unassign",
+      command: `skill front assign ${convId} --unassign --json`,
+      description: "Remove assignee"
+    },
+    {
+      action: "tag",
+      command: `skill front tag ${convId} <tag-name-or-id> --json`,
+      description: "Add a tag"
+    },
+    {
+      action: "untag",
+      command: `skill front untag ${convId} <tag-name-or-id> --json`,
+      description: "Remove a tag"
+    },
+    {
+      action: "reply",
+      command: `skill front reply ${convId} --body "<text>" --json`,
+      description: "Create a draft reply"
+    },
     {
       action: "tags",
       command: `skill front tags list --json`,
@@ -91757,6 +91853,11 @@ function conversationListActions(inboxId) {
         action: "triage",
         command: `skill front triage --inbox ${inboxId} --json`,
         description: "Triage conversations"
+      },
+      {
+        action: "report",
+        command: `skill front report --inbox ${inboxId} --json`,
+        description: "Generate inbox report"
       }
     );
   }
@@ -91861,7 +91962,7 @@ function teammateListLinks(teammates) {
 }
 
 // src/commands/front/archive.ts
-function getFrontClient() {
+function getFrontClient2() {
   const apiToken = process.env.FRONT_API_TOKEN;
   if (!apiToken) {
     throw new Error("FRONT_API_TOKEN environment variable is required");
@@ -91885,7 +91986,7 @@ async function archiveConversation(front, convId) {
 }
 async function archiveConversations(convId, additionalIds, options) {
   try {
-    const front = getFrontClient();
+    const front = getFrontClient2();
     const allIds = [convId, ...additionalIds];
     if (options.json) {
       const results2 = await Promise.all(
@@ -91960,6 +92061,75 @@ function registerArchiveCommand(frontCommand) {
   frontCommand.command("archive").description("Archive one or more conversations by ID").argument("<id>", "Conversation ID (e.g., cnv_xxx)").argument("[ids...]", "Additional conversation IDs to archive").option("--json", "Output as JSON").action(archiveConversations);
 }
 
+// src/commands/front/assign.ts
+init_esm_shims();
+function getFrontClient3() {
+  const apiToken = process.env.FRONT_API_TOKEN;
+  if (!apiToken) {
+    throw new Error("FRONT_API_TOKEN environment variable is required");
+  }
+  return createInstrumentedFrontClient({ apiToken });
+}
+function normalizeId2(idOrUrl) {
+  return idOrUrl.startsWith("http") ? idOrUrl.split("/").pop() : idOrUrl;
+}
+async function assignConversation(conversationId, teammateId, options) {
+  try {
+    const front = getFrontClient3();
+    const convId = normalizeId2(conversationId);
+    if (!teammateId && !options.unassign) {
+      throw new Error(
+        "Provide a teammate ID or use --unassign to remove assignment"
+      );
+    }
+    if (teammateId && options.unassign) {
+      throw new Error("Cannot provide both teammate ID and --unassign");
+    }
+    const assigneeId = options.unassign ? "" : normalizeId2(teammateId);
+    await front.conversations.updateAssignee(convId, assigneeId);
+    if (options.json) {
+      console.log(
+        JSON.stringify(
+          hateoasWrap({
+            type: "assign-result",
+            command: options.unassign ? `skill front assign ${convId} --unassign --json` : `skill front assign ${convId} ${assigneeId} --json`,
+            data: {
+              id: convId,
+              assignee: options.unassign ? null : assigneeId,
+              success: true
+            }
+          }),
+          null,
+          2
+        )
+      );
+    } else {
+      if (options.unassign) {
+        console.log(`\u2705 Unassigned ${convId}`);
+      } else {
+        console.log(`\u2705 Assigned ${convId} to ${assigneeId}`);
+      }
+    }
+  } catch (error) {
+    if (options.json) {
+      console.error(
+        JSON.stringify({
+          error: error instanceof Error ? error.message : "Unknown error"
+        })
+      );
+    } else {
+      console.error(
+        "Error:",
+        error instanceof Error ? error.message : "Unknown error"
+      );
+    }
+    process.exit(1);
+  }
+}
+function registerAssignCommand(frontCommand) {
+  frontCommand.command("assign").description("Assign a conversation to a teammate").argument("<conversation-id>", "Conversation ID (cnv_xxx)").argument("[teammate-id]", "Teammate ID (tea_xxx) - omit with --unassign").option("--unassign", "Remove assignee").option("--json", "Output as JSON").action(assignConversation);
+}
+
 // src/commands/front/bulk-archive.ts
 init_esm_shims();
 function parseDuration(duration) {
@@ -92247,9 +92417,133 @@ function registerBulkArchiveCommand(parent2) {
   ).option("--dry-run", "Preview without archiving").option("--json", "JSON output").action(bulkArchiveConversations);
 }
 
+// src/commands/front/conversation-tag.ts
+init_esm_shims();
+function getFrontClient4() {
+  const apiToken = process.env.FRONT_API_TOKEN;
+  if (!apiToken) {
+    throw new Error("FRONT_API_TOKEN environment variable is required");
+  }
+  return createInstrumentedFrontClient({ apiToken });
+}
+function normalizeId3(idOrUrl) {
+  return idOrUrl.startsWith("http") ? idOrUrl.split("/").pop() : idOrUrl;
+}
+async function resolveTag(front, tagNameOrId) {
+  const normalized = normalizeId3(tagNameOrId);
+  const data2 = await front.raw.get("/tags");
+  const tags = data2._results ?? [];
+  if (normalized.startsWith("tag_")) {
+    const match2 = tags.find((t2) => t2.id === normalized);
+    return { id: normalized, name: match2?.name ?? normalized };
+  }
+  const needle = tagNameOrId.trim().toLowerCase();
+  const match = tags.find((t2) => t2.name.toLowerCase() === needle);
+  if (!match) {
+    throw new Error(
+      `Tag not found: "${tagNameOrId}". Use \`skill front tags list\` to see available tags.`
+    );
+  }
+  return { id: match.id, name: match.name };
+}
+async function tagConversation(convId, tagNameOrId, options) {
+  try {
+    const front = getFrontClient4();
+    const normalizedConvId = normalizeId3(convId);
+    const tag = await resolveTag(front, tagNameOrId);
+    await front.conversations.addTag(normalizedConvId, tag.id);
+    if (options.json) {
+      console.log(
+        JSON.stringify(
+          hateoasWrap({
+            type: "tag-result",
+            command: `skill front tag ${normalizedConvId} ${tagNameOrId} --json`,
+            data: {
+              conversationId: normalizedConvId,
+              tagId: tag.id,
+              tagName: tag.name,
+              action: "added"
+            }
+          }),
+          null,
+          2
+        )
+      );
+      return;
+    }
+    console.log(
+      `
+   \u2705 Tagged ${normalizedConvId} with "${tag.name}" (${tag.id})
+`
+    );
+  } catch (error) {
+    if (options.json) {
+      console.error(
+        JSON.stringify({
+          error: error instanceof Error ? error.message : "Unknown error"
+        })
+      );
+    } else {
+      console.error(
+        "Error:",
+        error instanceof Error ? error.message : "Unknown error"
+      );
+    }
+    process.exit(1);
+  }
+}
+async function untagConversation(convId, tagNameOrId, options) {
+  try {
+    const front = getFrontClient4();
+    const normalizedConvId = normalizeId3(convId);
+    const tag = await resolveTag(front, tagNameOrId);
+    await front.conversations.removeTag(normalizedConvId, tag.id);
+    if (options.json) {
+      console.log(
+        JSON.stringify(
+          hateoasWrap({
+            type: "untag-result",
+            command: `skill front untag ${normalizedConvId} ${tagNameOrId} --json`,
+            data: {
+              conversationId: normalizedConvId,
+              tagId: tag.id,
+              tagName: tag.name,
+              action: "removed"
+            }
+          }),
+          null,
+          2
+        )
+      );
+      return;
+    }
+    console.log(`
+   \u2705 Removed tag "${tag.name}" from ${normalizedConvId}
+`);
+  } catch (error) {
+    if (options.json) {
+      console.error(
+        JSON.stringify({
+          error: error instanceof Error ? error.message : "Unknown error"
+        })
+      );
+    } else {
+      console.error(
+        "Error:",
+        error instanceof Error ? error.message : "Unknown error"
+      );
+    }
+    process.exit(1);
+  }
+}
+function registerConversationTagCommands(frontCommand) {
+  frontCommand.command("tag").description("Add a tag to a conversation").argument("<conversation-id>", "Conversation ID (cnv_xxx)").argument("<tag-name-or-id>", "Tag name or ID (tag_xxx)").option("--json", "Output as JSON").action(tagConversation);
+  frontCommand.command("untag").description("Remove a tag from a conversation").argument("<conversation-id>", "Conversation ID (cnv_xxx)").argument("<tag-name-or-id>", "Tag name or ID (tag_xxx)").option("--json", "Output as JSON").action(untagConversation);
+}
+
 // src/commands/front/inbox.ts
 init_esm_shims();
-function getFrontClient2() {
+function getFrontClient5() {
   const apiToken = process.env.FRONT_API_TOKEN;
   if (!apiToken) {
     throw new Error("FRONT_API_TOKEN environment variable is required");
@@ -92264,12 +92558,12 @@ function formatTimestamp(ts) {
     minute: "2-digit"
   });
 }
-function normalizeId2(idOrUrl) {
+function normalizeId4(idOrUrl) {
   return idOrUrl.startsWith("http") ? idOrUrl.split("/").pop() : idOrUrl;
 }
 async function findInbox(nameOrId) {
-  const front = getFrontClient2();
-  const normalizedId = normalizeId2(nameOrId);
+  const front = getFrontClient5();
+  const normalizedId = normalizeId4(nameOrId);
   if (normalizedId.startsWith("inb_")) {
     try {
       const inbox = await front.inboxes.get(normalizedId);
@@ -92286,7 +92580,7 @@ async function findInbox(nameOrId) {
 }
 async function listInboxes(options) {
   try {
-    const front = getFrontClient2();
+    const front = getFrontClient5();
     const inboxList = await front.inboxes.list();
     const inboxes = inboxList._results ?? [];
     if (options.json) {
@@ -92337,35 +92631,59 @@ async function listInboxes(options) {
 }
 async function listConversations(inboxNameOrId, options) {
   try {
-    const front = getFrontClient2();
+    const front = getFrontClient5();
     const inbox = await findInbox(inboxNameOrId);
     if (!inbox) {
       throw new Error(`Inbox not found: ${inboxNameOrId}`);
     }
+    const totalLimit = parseInt(String(options.limit ?? "50"), 10);
+    const resolvedLimit = Number.isFinite(totalLimit) && totalLimit > 0 ? totalLimit : void 0;
     const filters2 = [];
     if (options.status) {
-      filters2.push(`status:${options.status}`);
+      filters2.push(`status: ${options.status}`);
     }
     if (options.tag) {
-      filters2.push(`tag:"${options.tag}"`);
+      filters2.push(`tag: "${options.tag}"`);
     }
-    const queryParts = [];
-    if (filters2.length > 0) {
-      queryParts.push(`q=${encodeURIComponent(filters2.join(" "))}`);
+    const queryParts = ["limit=50"];
+    if (options.status) {
+      queryParts.push(`q[statuses][]=${encodeURIComponent(options.status)}`);
     }
-    if (options.limit) {
-      queryParts.push(`limit=${options.limit}`);
+    if (options.tag) {
+      queryParts.push(`q=${encodeURIComponent(`tag:"${options.tag}"`)}`);
+    }
+    const queryString = `?${queryParts.join("&")}`;
+    const conversations = [];
+    let nextUrl = `/inboxes/${inbox.id}/conversations${queryString}`;
+    while (nextUrl) {
+      const response = await front.raw.get(nextUrl);
+      conversations.push(...response._results ?? []);
+      if (!options.json) {
+        process.stdout.write(
+          `\r  Fetched ${conversations.length} conversations...`
+        );
+      }
+      nextUrl = response._pagination?.next || null;
+      if (resolvedLimit && conversations.length >= resolvedLimit) {
+        conversations.splice(resolvedLimit);
+        break;
+      }
+    }
+    if (!options.json) {
+      console.log(`
+  Total: ${conversations.length} conversations
+`);
     }
-    const queryString = queryParts.length > 0 ? `?${queryParts.join("&")}` : "";
-    const response = await front.raw.get(`/inboxes/${inbox.id}/conversations${queryString}`);
-    const conversations = response._results ?? [];
     if (options.json) {
       console.log(
         JSON.stringify(
           hateoasWrap({
             type: "conversation-list",
             command: `skill front inbox ${inbox.id} --json`,
-            data: conversations,
+            data: {
+              total: conversations.length,
+              conversations
+            },
             links: conversationListLinks(
               conversations.map((c) => ({ id: c.id, subject: c.subject })),
               inbox.id
@@ -92405,12 +92723,6 @@ async function listConversations(inboxNameOrId, options) {
       console.log(`   Created:   ${time}`);
     }
     console.log("");
-    if (response._pagination?.next) {
-      console.log(
-        `   \u{1F4A1} More conversations available. Use --limit to adjust results.`
-      );
-      console.log("");
-    }
   } catch (error) {
     if (options.json) {
       console.error(
@@ -92593,6 +92905,74 @@ function registerPullCommand(parent2) {
   parent2.command("pull").description("Export conversations to JSON for eval datasets").option("-i, --inbox <id>", "Inbox ID to pull from").option("-l, --limit <n>", "Max conversations to pull", parseInt).option("-o, --output <file>", "Output file path").option("-f, --filter <term>", "Filter by subject/tag containing term").option("--json", "JSON output").action(pullConversations);
 }
 
+// src/commands/front/reply.ts
+init_esm_shims();
+function getFrontClient6() {
+  const apiToken = process.env.FRONT_API_TOKEN;
+  if (!apiToken) {
+    throw new Error("FRONT_API_TOKEN environment variable is required");
+  }
+  return createInstrumentedFrontClient({ apiToken });
+}
+function normalizeId5(idOrUrl) {
+  return idOrUrl.startsWith("http") ? idOrUrl.split("/").pop() : idOrUrl;
+}
+async function replyToConversation(conversationId, options) {
+  try {
+    const front = getFrontClient6();
+    const normalizedId = normalizeId5(conversationId);
+    const draft = await front.raw.post(
+      `/conversations/${normalizedId}/drafts`,
+      {
+        body: options.body,
+        ...options.author ? { author_id: options.author } : {}
+      }
+    );
+    if (options.json) {
+      console.log(
+        JSON.stringify(
+          hateoasWrap({
+            type: "draft-reply",
+            command: `skill front reply ${normalizedId} --body ${JSON.stringify(options.body)}${options.author ? ` --author ${options.author}` : ""} --json`,
+            data: draft
+          }),
+          null,
+          2
+        )
+      );
+      return;
+    }
+    const draftId = draft.id;
+    const bodyPreview = options.body.length > 100 ? options.body.slice(0, 100) + "..." : options.body;
+    console.log("");
+    console.log(`\u{1F4DD} Draft reply created on ${normalizedId}`);
+    if (draftId) {
+      console.log(`   Draft ID: ${draftId}`);
+    }
+    console.log(`   Body preview: ${bodyPreview}`);
+    console.log("");
+    console.log(`   \u{1F4A1} Review and send from Front.`);
+    console.log("");
+  } catch (error) {
+    if (options.json) {
+      console.error(
+        JSON.stringify({
+          error: error instanceof Error ? error.message : "Unknown error"
+        })
+      );
+    } else {
+      console.error(
+        "Error:",
+        error instanceof Error ? error.message : "Unknown error"
+      );
+    }
+    process.exit(1);
+  }
+}
+function registerReplyCommand(frontCommand) {
+  frontCommand.command("reply").description("Create a draft reply on a conversation").argument("<conversation-id>", "Conversation ID (cnv_xxx)").requiredOption("--body <text>", "Reply body text").option("--author <teammate-id>", "Author teammate ID").option("--json", "Output as JSON").action(replyToConversation);
+}
+
 // src/commands/front/report.ts
 init_esm_shims();
 function formatDate2(timestamp) {
@@ -93355,7 +93735,7 @@ function registerTagCommands(frontCommand) {
 
 // src/commands/front/triage.ts
 init_esm_shims();
-function getFrontClient3() {
+function getFrontClient7() {
   const apiToken = process.env.FRONT_API_TOKEN;
   if (!apiToken) {
     throw new Error("FRONT_API_TOKEN environment variable is required");
@@ -93410,7 +93790,7 @@ async function triageConversations(options) {
     json = false
   } = options;
   try {
-    const front = getFrontClient3();
+    const front = getFrontClient7();
     if (!json) {
       console.log(`
 Fetching ${status} conversations from inbox ${inbox}...`);
@@ -93577,7 +93957,7 @@ function registerTriageCommand(front) {
 }
 
 // src/commands/front/index.ts
-function getFrontClient4() {
+function getFrontClient8() {
   const apiToken = process.env.FRONT_API_TOKEN;
   if (!apiToken) {
     throw new Error("FRONT_API_TOKEN environment variable is required");
@@ -93603,19 +93983,19 @@ function truncate3(str2, len) {
   if (str2.length <= len) return str2;
   return str2.slice(0, len - 3) + "...";
 }
-function normalizeId3(idOrUrl) {
+function normalizeId6(idOrUrl) {
   return idOrUrl.startsWith("http") ? idOrUrl.split("/").pop() : idOrUrl;
 }
 async function getMessage(id, options) {
   try {
-    const front = getFrontClient4();
-    const message = await front.messages.get(normalizeId3(id));
+    const front = getFrontClient8();
+    const message = await front.messages.get(normalizeId6(id));
     if (options.json) {
       console.log(
         JSON.stringify(
           hateoasWrap({
             type: "message",
-            command: `skill front message ${normalizeId3(id)} --json`,
+            command: `skill front message ${normalizeId6(id)} --json`,
             data: message,
             links: messageLinks(message.id)
           }),
@@ -93669,17 +94049,17 @@ async function getMessage(id, options) {
 }
 async function getConversation2(id, options) {
   try {
-    const front = getFrontClient4();
-    const conversation = await front.conversations.get(normalizeId3(id));
+    const front = getFrontClient8();
+    const conversation = await front.conversations.get(normalizeId6(id));
     let messages;
     if (options.messages) {
       const messageList = await front.conversations.listMessages(
-        normalizeId3(id)
+        normalizeId6(id)
       );
       messages = messageList._results ?? [];
     }
     if (options.json) {
-      const convId = normalizeId3(id);
+      const convId = normalizeId6(id);
       console.log(
         JSON.stringify(
           hateoasWrap({
@@ -93782,10 +94162,18 @@ async function listTeammates(options) {
       console.log("");
     }
   } catch (error) {
-    console.error(
-      "Error:",
-      error instanceof Error ? error.message : "Unknown error"
-    );
+    if (options.json) {
+      console.error(
+        JSON.stringify({
+          error: error instanceof Error ? error.message : "Unknown error"
+        })
+      );
+    } else {
+      console.error(
+        "Error:",
+        error instanceof Error ? error.message : "Unknown error"
+      );
+    }
     process.exit(1);
   }
 }
@@ -93822,10 +94210,18 @@ async function getTeammate(id, options) {
     console.log(`   Available: ${teammate.is_available ? "Yes" : "No"}`);
     console.log("");
   } catch (error) {
-    console.error(
-      "Error:",
-      error instanceof Error ? error.message : "Unknown error"
-    );
+    if (options.json) {
+      console.error(
+        JSON.stringify({
+          error: error instanceof Error ? error.message : "Unknown error"
+        })
+      );
+    } else {
+      console.error(
+        "Error:",
+        error instanceof Error ? error.message : "Unknown error"
+      );
+    }
     process.exit(1);
   }
 }
@@ -93842,6 +94238,10 @@ function registerFrontCommands(program3) {
   registerTriageCommand(front);
   registerPullCommand(front);
   registerTagCommands(front);
+  registerAssignCommand(front);
+  registerConversationTagCommands(front);
+  registerReplyCommand(front);
+  registerApiCommand(front);
 }
 
 // src/commands/health.ts