@skillrecordings/cli 0.10.0 → 0.10.1

package/dist/index.js

@@ -91673,6 +91673,51 @@ init_esm_shims();
 
 // src/commands/front/api.ts
 init_esm_shims();
+
+// src/commands/front/json-output.ts
+init_esm_shims();
+import { mkdirSync as mkdirSync5, writeFileSync as writeFileSync8 } from "fs";
+import { tmpdir as tmpdir2 } from "os";
+import { join as join12 } from "path";
+var STDOUT_LIMIT = 64 * 1024;
+function writeJsonOutput(data2) {
+  const json = JSON.stringify(data2, null, 2);
+  if (json.length <= STDOUT_LIMIT) {
+    console.log(json);
+    return;
+  }
+  const dir = join12(tmpdir2(), "skill-front");
+  mkdirSync5(dir, { recursive: true });
+  const filepath = join12(dir, `${Date.now()}.json`);
+  writeFileSync8(filepath, json);
+  const envelope = {
+    _type: data2?._type ?? "result",
+    _file: filepath,
+    _size: `${(json.length / 1024).toFixed(1)}KB`,
+    _hint: `cat ${filepath} | jq`
+  };
+  const d = data2;
+  if (d.data && typeof d.data === "object") {
+    const inner = d.data;
+    if (inner.total !== void 0) envelope.total = inner.total;
+    if (inner.query !== void 0) envelope.query = inner.query;
+    if (Array.isArray(inner.conversations)) {
+      envelope.conversations = inner.conversations.map(
+        (c) => ({
+          id: c.id,
+          subject: c.subject,
+          status: c.status
+        })
+      );
+    }
+  }
+  if (Array.isArray(d._actions) && d._actions.length > 0) {
+    envelope._actions = d._actions;
+  }
+  console.log(JSON.stringify(envelope, null, 2));
+}
+
+// src/commands/front/api.ts
 function getFrontClient() {
   const apiToken = process.env.FRONT_API_TOKEN;
   if (!apiToken) {
@@ -91714,7 +91759,7 @@ async function apiPassthrough(method, endpoint, options) {
         `Unsupported method: ${method}. Use GET, POST, PATCH, PUT, or DELETE.`
       );
   }
-  console.log(JSON.stringify(result, null, 2));
+  writeJsonOutput(result);
 }
 function registerApiCommand(frontCommand) {
   frontCommand.command("api").description("Raw Front API request (escape hatch)").argument("<method>", "HTTP method (GET, POST, PATCH, PUT, DELETE)").argument(
@@ -92078,16 +92123,12 @@ async function archiveConversations(convId, additionalIds, options) {
           };
         })
       );
-      console.log(
-        JSON.stringify(
-          hateoasWrap({
-            type: "archive-result",
-            command: `skill front archive ${allIds.map(normalizeId).join(" ")} --json`,
-            data: results2
-          }),
-          null,
-          2
-        )
+      writeJsonOutput(
+        hateoasWrap({
+          type: "archive-result",
+          command: `skill front archive ${allIds.map(normalizeId).join(" ")} --json`,
+          data: results2
+        })
       );
       return;
     }
@@ -92207,20 +92248,16 @@ async function assignConversation(conversationId, teammateId, options) {
     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
-        )
+      writeJsonOutput(
+        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
+          }
+        })
       );
     } else {
       if (options.unassign) {
@@ -92462,16 +92499,12 @@ Found ${result.matches.length} matching conversations`);
     }
     if (dryRun) {
       if (json) {
-        console.log(
-          JSON.stringify(
-            hateoasWrap({
-              type: "bulk-archive-result",
-              command: `skill front bulk-archive --inbox ${inbox} --dry-run --json`,
-              data: result
-            }),
-            null,
-            2
-          )
+        writeJsonOutput(
+          hateoasWrap({
+            type: "bulk-archive-result",
+            command: `skill front bulk-archive --inbox ${inbox} --dry-run --json`,
+            data: result
+          })
         );
       } else {
         console.log("\nMatching conversations:");
@@ -92491,16 +92524,12 @@ Run without --dry-run to archive ${result.matches.length} conversation(s)`
       if (!json) {
         console.log("\nNo conversations to archive.");
       } else {
-        console.log(
-          JSON.stringify(
-            hateoasWrap({
-              type: "bulk-archive-result",
-              command: `skill front bulk-archive --inbox ${inbox} --json`,
-              data: result
-            }),
-            null,
-            2
-          )
+        writeJsonOutput(
+          hateoasWrap({
+            type: "bulk-archive-result",
+            command: `skill front bulk-archive --inbox ${inbox} --json`,
+            data: result
+          })
         );
       }
       return;
@@ -92530,16 +92559,12 @@ Run without --dry-run to archive ${result.matches.length} conversation(s)`
       await new Promise((r) => setTimeout(r, 150));
     }
     if (json) {
-      console.log(
-        JSON.stringify(
-          hateoasWrap({
-            type: "bulk-archive-result",
-            command: `skill front bulk-archive --inbox ${inbox} --json`,
-            data: result
-          }),
-          null,
-          2
-        )
+      writeJsonOutput(
+        hateoasWrap({
+          type: "bulk-archive-result",
+          command: `skill front bulk-archive --inbox ${inbox} --json`,
+          data: result
+        })
       );
     } else {
       console.log("\n\nBulk Archive Results:");
@@ -92683,21 +92708,17 @@ async function tagConversation(convId, tagNameOrId, options) {
     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
-        )
+      writeJsonOutput(
+        hateoasWrap({
+          type: "tag-result",
+          command: `skill front tag ${normalizedConvId} ${tagNameOrId} --json`,
+          data: {
+            conversationId: normalizedConvId,
+            tagId: tag.id,
+            tagName: tag.name,
+            action: "added"
+          }
+        })
       );
       return;
     }
@@ -92729,21 +92750,17 @@ async function untagConversation(convId, tagNameOrId, options) {
     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
-        )
+      writeJsonOutput(
+        hateoasWrap({
+          type: "untag-result",
+          command: `skill front untag ${normalizedConvId} ${tagNameOrId} --json`,
+          data: {
+            conversationId: normalizedConvId,
+            tagId: tag.id,
+            tagName: tag.name,
+            action: "removed"
+          }
+        })
       );
       return;
     }
@@ -92893,19 +92910,15 @@ async function listInboxes(options) {
     const inboxList = await front.inboxes.list();
     const inboxes = inboxList._results ?? [];
     if (options.json) {
-      console.log(
-        JSON.stringify(
-          hateoasWrap({
-            type: "inbox-list",
-            command: "skill front inbox --json",
-            data: inboxes,
-            links: inboxListLinks(
-              inboxes.map((i) => ({ id: i.id, name: i.name }))
-            )
-          }),
-          null,
-          2
-        )
+      writeJsonOutput(
+        hateoasWrap({
+          type: "inbox-list",
+          command: "skill front inbox --json",
+          data: inboxes,
+          links: inboxListLinks(
+            inboxes.map((i) => ({ id: i.id, name: i.name }))
+          )
+        })
       );
       return;
     }
@@ -92984,24 +92997,20 @@ async function listConversations(inboxNameOrId, options) {
 `);
     }
     if (options.json) {
-      console.log(
-        JSON.stringify(
-          hateoasWrap({
-            type: "conversation-list",
-            command: `skill front inbox ${inbox.id} --json`,
-            data: {
-              total: conversations.length,
-              conversations
-            },
-            links: conversationListLinks(
-              conversations.map((c) => ({ id: c.id, subject: c.subject })),
-              inbox.id
-            ),
-            actions: conversationListActions(inbox.id)
-          }),
-          null,
-          2
-        )
+      writeJsonOutput(
+        hateoasWrap({
+          type: "conversation-list",
+          command: `skill front inbox ${inbox.id} --json`,
+          data: {
+            total: conversations.length,
+            conversations
+          },
+          links: conversationListLinks(
+            conversations.map((c) => ({ id: c.id, subject: c.subject })),
+            inbox.id
+          ),
+          actions: conversationListActions(inbox.id)
+        })
       );
       return;
     }
@@ -93160,7 +93169,7 @@ RELATED COMMANDS
 
 // src/commands/front/pull-conversations.ts
 init_esm_shims();
-import { writeFileSync as writeFileSync8 } from "fs";
+import { writeFileSync as writeFileSync9 } from "fs";
 async function pullConversations(options) {
   const { inbox, limit: limit2 = 50, output, filter: filter4, json = false } = options;
   const frontToken = process.env.FRONT_API_TOKEN;
@@ -93279,20 +93288,16 @@ Built ${samples.length} eval samples`);
       console.log(`  ${cat}: ${count}`);
     }
     if (output) {
-      writeFileSync8(output, JSON.stringify(samples, null, 2));
+      writeFileSync9(output, JSON.stringify(samples, null, 2));
       console.log(`
 Saved to ${output}`);
     } else if (json) {
-      console.log(
-        JSON.stringify(
-          hateoasWrap({
-            type: "eval-dataset",
-            command: `skill front pull --inbox ${inbox} --json`,
-            data: samples
-          }),
-          null,
-          2
-        )
+      writeJsonOutput(
+        hateoasWrap({
+          type: "eval-dataset",
+          command: `skill front pull --inbox ${inbox} --json`,
+          data: samples
+        })
       );
     }
   } catch (error) {
@@ -93397,16 +93402,12 @@ async function replyToConversation(conversationId, options) {
       }
     );
     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
-        )
+      writeJsonOutput(
+        hateoasWrap({
+          type: "draft-reply",
+          command: `skill front reply ${normalizedId} --body ${JSON.stringify(options.body)}${options.author ? ` --author ${options.author}` : ""} --json`,
+          data: draft
+        })
       );
       return;
     }
@@ -93596,18 +93597,14 @@ async function generateReport(options) {
     );
     if (json) {
       const unresolvedIds = report.unresolvedIssues.map((i) => i.id);
-      console.log(
-        JSON.stringify(
-          hateoasWrap({
-            type: "report",
-            command: `skill front report --inbox ${inbox} --json`,
-            data: report,
-            links: reportLinks(inbox, unresolvedIds),
-            actions: reportActions(inbox)
-          }),
-          null,
-          2
-        )
+      writeJsonOutput(
+        hateoasWrap({
+          type: "report",
+          command: `skill front report --inbox ${inbox} --json`,
+          data: report,
+          links: reportLinks(inbox, unresolvedIds),
+          actions: reportActions(inbox)
+        })
       );
     } else {
       printReport(report);
@@ -93814,24 +93811,20 @@ async function searchConversations(query, options) {
       console.log("");
     }
     if (options.json) {
-      console.log(
-        JSON.stringify(
-          hateoasWrap({
-            type: "search-results",
-            command: `skill front search ${JSON.stringify(fullQuery)} --json`,
-            data: {
-              query: fullQuery,
-              total: conversations.length,
-              conversations
-            },
-            links: conversationListLinks(
-              conversations.map((c) => ({ id: c.id, subject: c.subject }))
-            ),
-            actions: options.inbox ? conversationListActions(options.inbox) : []
-          }),
-          null,
-          2
-        )
+      writeJsonOutput(
+        hateoasWrap({
+          type: "search-results",
+          command: `skill front search ${JSON.stringify(fullQuery)} --json`,
+          data: {
+            query: fullQuery,
+            total: conversations.length,
+            conversations
+          },
+          links: conversationListLinks(
+            conversations.map((c) => ({ id: c.id, subject: c.subject }))
+          ),
+          actions: options.inbox ? conversationListActions(options.inbox) : []
+        })
       );
       return;
     }
@@ -93961,6 +93954,17 @@ EXAMPLES
   # Pipe JSON to jq for IDs only
   skill front search "is:unassigned" --inbox inb_4bj7r --json | jq '.data.conversations[].id'
 
+LARGE RESULTS
+  When --json output exceeds 64KB (common with 25+ conversations), results are
+  automatically written to a temp file. Stdout gets a summary with the file path:
+    { "_file": "/tmp/skill-front/1738692000.json", "total": 50, ... }
+
+  To always get the full file:
+    skill front search "..." --json > results.json
+
+  To process the spilled file:
+    cat /tmp/skill-front/*.json | jq '.data.conversations[].id'
+
   Full docs: https://dev.frontapp.com/docs/search-1
 `
   ).action((query, options) => {
@@ -94100,20 +94104,16 @@ async function listTags(options) {
     );
     const filteredTags = options.unused ? tagsWithCounts.filter((t2) => t2.conversation_count === 0) : tagsWithCounts;
     if (options.json) {
-      console.log(
-        JSON.stringify(
-          hateoasWrap({
-            type: "tag-list",
-            command: `skill front tags list${options.unused ? " --unused" : ""} --json`,
-            data: filteredTags,
-            links: tagListLinks(
-              filteredTags.map((t2) => ({ id: t2.id, name: t2.name }))
-            ),
-            actions: tagListActions()
-          }),
-          null,
-          2
-        )
+      writeJsonOutput(
+        hateoasWrap({
+          type: "tag-list",
+          command: `skill front tags list${options.unused ? " --unused" : ""} --json`,
+          data: filteredTags,
+          links: tagListLinks(
+            filteredTags.map((t2) => ({ id: t2.id, name: t2.name }))
+          ),
+          actions: tagListActions()
+        })
       );
       return;
     }
@@ -94757,21 +94757,17 @@ Fetching ${status} conversations from inbox ${inbox}...`);
       });
     }
     if (json) {
-      console.log(
-        JSON.stringify(
-          hateoasWrap({
-            type: "triage-result",
-            command: `skill front triage --inbox ${inbox} --json`,
-            data: {
-              total: allConversations.length,
-              stats: stats4,
-              results
-            },
-            actions: triageActions(inbox)
-          }),
-          null,
-          2
-        )
+      writeJsonOutput(
+        hateoasWrap({
+          type: "triage-result",
+          command: `skill front triage --inbox ${inbox} --json`,
+          data: {
+            total: allConversations.length,
+            stats: stats4,
+            results
+          },
+          actions: triageActions(inbox)
+        })
       );
       return;
     }
@@ -94984,17 +94980,13 @@ async function getMessage(id, options) {
     const front = getFrontClient9();
     const message = await front.messages.get(normalizeId6(id));
     if (options.json) {
-      console.log(
-        JSON.stringify(
-          hateoasWrap({
-            type: "message",
-            command: `skill front message ${normalizeId6(id)} --json`,
-            data: message,
-            links: messageLinks(message.id)
-          }),
-          null,
-          2
-        )
+      writeJsonOutput(
+        hateoasWrap({
+          type: "message",
+          command: `skill front message ${normalizeId6(id)} --json`,
+          data: message,
+          links: messageLinks(message.id)
+        })
       );
       return;
     }
@@ -95053,18 +95045,14 @@ async function getConversation2(id, options) {
     }
     if (options.json) {
       const convId = normalizeId6(id);
-      console.log(
-        JSON.stringify(
-          hateoasWrap({
-            type: "conversation",
-            command: `skill front conversation ${convId} --json`,
-            data: { conversation, messages },
-            links: conversationLinks(conversation.id),
-            actions: conversationActions(conversation.id)
-          }),
-          null,
-          2
-        )
+      writeJsonOutput(
+        hateoasWrap({
+          type: "conversation",
+          command: `skill front conversation ${convId} --json`,
+          data: { conversation, messages },
+          links: conversationLinks(conversation.id),
+          actions: conversationActions(conversation.id)
+        })
       );
       return;
     }
@@ -95122,19 +95110,15 @@ async function listTeammates(options) {
     const front = getFrontSdkClient2();
     const result = await front.teammates.list();
     if (options.json) {
-      console.log(
-        JSON.stringify(
-          hateoasWrap({
-            type: "teammate-list",
-            command: "skill front teammates --json",
-            data: result._results,
-            links: teammateListLinks(
-              result._results.map((t2) => ({ id: t2.id, email: t2.email }))
-            )
-          }),
-          null,
-          2
-        )
+      writeJsonOutput(
+        hateoasWrap({
+          type: "teammate-list",
+          command: "skill front teammates --json",
+          data: result._results,
+          links: teammateListLinks(
+            result._results.map((t2) => ({ id: t2.id, email: t2.email }))
+          )
+        })
       );
       return;
     }
@@ -95175,17 +95159,13 @@ async function getTeammate(id, options) {
     const front = getFrontSdkClient2();
     const teammate = await front.teammates.get(id);
     if (options.json) {
-      console.log(
-        JSON.stringify(
-          hateoasWrap({
-            type: "teammate",
-            command: `skill front teammate ${id} --json`,
-            data: teammate,
-            links: teammateLinks(teammate.id)
-          }),
-          null,
-          2
-        )
+      writeJsonOutput(
+        hateoasWrap({
+          type: "teammate",
+          command: `skill front teammate ${id} --json`,
+          data: teammate,
+          links: teammateLinks(teammate.id)
+        })
       );
       return;
     }
@@ -113643,7 +113623,7 @@ Total: ${result.totalDurationMs}ms`);
 
 // src/commands/responses.ts
 init_esm_shims();
-import { writeFileSync as writeFileSync9 } from "fs";
+import { writeFileSync as writeFileSync10 } from "fs";
 function formatDate3(date) {
   return date.toLocaleString("en-US", {
     month: "short",
@@ -114144,7 +114124,7 @@ async function exportResponses(options) {
     }
     const outputJson = JSON.stringify(exportData, null, 2);
     if (options.output) {
-      writeFileSync9(options.output, outputJson, "utf-8");
+      writeFileSync10(options.output, outputJson, "utf-8");
       console.log(
         `Exported ${exportData.length} responses to ${options.output}`
       );