stow-cli 1.0.1 → 1.0.3

package/dist/cli.js

@@ -14,11 +14,14 @@ var CLI_DOCS = {
       "stow upload ./photo.jpg --bucket photos",
       "stow drop ./screenshot.png",
       "stow buckets",
-      "stow files photos --limit 50"
+      "stow files photos --limit 50",
+      "stow search text 'sunset beach'",
+      "stow admin health"
     ],
     notes: [
       "Set STOW_API_KEY before running commands that call the API.",
-      "Set STOW_API_URL to target a non-default environment."
+      "Set STOW_API_URL to target a non-default environment.",
+      "Set STOW_ADMIN_SECRET for admin commands."
     ]
   },
   drop: {
@@ -64,7 +67,46 @@ var CLI_DOCS = {
     usage: "stow files <bucket> [options]",
     examples: [
       "stow files photos",
-      "stow files photos --search avatars/ --limit 100"
+      "stow files photos --search avatars/ --limit 100",
+      "stow files photos --json"
+    ]
+  },
+  filesGet: {
+    description: "Get details for a single file",
+    usage: "stow files get <bucket> <key>",
+    examples: [
+      "stow files get photos hero.png",
+      "stow files get photos hero.png --json"
+    ]
+  },
+  filesUpdate: {
+    description: "Update file metadata",
+    usage: "stow files update <bucket> <key> -m key=value",
+    examples: [
+      "stow files update photos hero.png -m alt='Hero image'",
+      "stow files update photos hero.png -m category=banner -m priority=high"
+    ]
+  },
+  filesMissing: {
+    description: "List files missing processing data",
+    usage: "stow files missing <bucket> <type>",
+    examples: [
+      "stow files missing brera dimensions",
+      "stow files missing brera embeddings --limit 200",
+      "stow files missing brera colors --json"
+    ],
+    notes: ["Valid types: dimensions, embeddings, colors"]
+  },
+  filesEnrich: {
+    description: "Generate title, description, and alt text for an image",
+    usage: "stow files enrich <bucket> <key>",
+    examples: [
+      "stow files enrich photos hero.jpg",
+      "stow files enrich next l5igro4iutep3"
+    ],
+    notes: [
+      "Triggers title, description, and alt text generation in parallel.",
+      "Requires a searchable bucket with image files."
     ]
   },
   drops: {
@@ -96,6 +138,179 @@ var CLI_DOCS = {
     description: "Launch interactive TUI mode",
     usage: "stow --interactive",
     examples: ["stow", "stow --interactive"]
+  },
+  search: {
+    description: "Search files across buckets",
+    usage: "stow search <subcommand>",
+    examples: [
+      "stow search text 'sunset beach' -b photos",
+      "stow search similar --file hero.png -b photos",
+      'stow search color --hex "#ff0000" -b photos',
+      "stow search diverse -b photos"
+    ]
+  },
+  searchText: {
+    description: "Semantic text search",
+    usage: "stow search text <query> [options]",
+    examples: ["stow search text 'sunset beach' -b photos --limit 10 --json"]
+  },
+  searchSimilar: {
+    description: "Find files similar to a given file",
+    usage: "stow search similar --file <key> [options]",
+    examples: ["stow search similar --file hero.png -b photos"]
+  },
+  searchColor: {
+    description: "Search by color",
+    usage: 'stow search color --hex "#ff0000" [options]',
+    examples: ['stow search color --hex "#ff0000" -b photos --limit 20']
+  },
+  searchDiverse: {
+    description: "Diversity-aware search",
+    usage: "stow search diverse [options]",
+    examples: ["stow search diverse -b photos --limit 20"]
+  },
+  tags: {
+    description: "Manage tags",
+    usage: "stow tags",
+    examples: [
+      "stow tags",
+      "stow tags create 'Hero Images'",
+      "stow tags delete <id>"
+    ]
+  },
+  tagsCreate: {
+    description: "Create a new tag",
+    usage: "stow tags create <name> [options]",
+    examples: [
+      'stow tags create "Hero Images"',
+      'stow tags create "Featured" --color "#ff6600"'
+    ]
+  },
+  tagsDelete: {
+    description: "Delete a tag by ID",
+    usage: "stow tags delete <id>",
+    examples: ["stow tags delete tag_abc123"]
+  },
+  profiles: {
+    description: "Manage taste profiles",
+    usage: "stow profiles <subcommand>",
+    examples: [
+      'stow profiles create --name "My Profile"',
+      "stow profiles get <id>",
+      "stow profiles delete <id>"
+    ]
+  },
+  profilesCreate: {
+    description: "Create a taste profile",
+    usage: 'stow profiles create --name "My Profile" [options]',
+    examples: ['stow profiles create --name "My Profile" -b photos']
+  },
+  profilesGet: {
+    description: "Get a taste profile with clusters",
+    usage: "stow profiles get <id>",
+    examples: ["stow profiles get profile_abc123 --json"]
+  },
+  profilesDelete: {
+    description: "Delete a taste profile",
+    usage: "stow profiles delete <id>",
+    examples: ["stow profiles delete profile_abc123"]
+  },
+  jobs: {
+    description: "List processing jobs for a bucket",
+    usage: "stow jobs --bucket <id> [options]",
+    examples: [
+      "stow jobs --bucket <id>",
+      "stow jobs --bucket <id> --status failed",
+      "stow jobs --bucket <id> --queue extract-colors --json"
+    ]
+  },
+  jobsRetry: {
+    description: "Retry a failed job",
+    usage: "stow jobs retry <id> --queue <name> --bucket <id>",
+    examples: ["stow jobs retry job123 --queue generate-title --bucket <id>"]
+  },
+  jobsDelete: {
+    description: "Remove a job",
+    usage: "stow jobs delete <id> --queue <name> --bucket <id>",
+    examples: ["stow jobs delete job123 --queue extract-colors --bucket <id>"]
+  },
+  admin: {
+    description: "Admin commands (requires STOW_ADMIN_SECRET)",
+    usage: "stow admin <subcommand>",
+    examples: [
+      "stow admin health",
+      "stow admin backfill dimensions --bucket <id> --dry-run",
+      "stow admin cleanup-drops --dry-run"
+    ],
+    notes: ["Requires STOW_ADMIN_SECRET environment variable."]
+  },
+  adminHealth: {
+    description: "Check system health and queue depths",
+    usage: "stow admin health",
+    examples: ["stow admin health", "stow admin health --json"]
+  },
+  adminBackfill: {
+    description: "Backfill processing data for files",
+    usage: "stow admin backfill <type> [options]",
+    examples: [
+      "stow admin backfill dimensions --bucket <id> --dry-run",
+      "stow admin backfill colors --bucket <id> --limit 200",
+      "stow admin backfill embeddings --bucket <id> --limit 100 --json"
+    ],
+    notes: ["Valid types: dimensions, colors, embeddings"]
+  },
+  adminCleanupDrops: {
+    description: "Remove expired drops",
+    usage: "stow admin cleanup-drops [options]",
+    examples: ["stow admin cleanup-drops --max-age-hours 24 --dry-run"]
+  },
+  adminPurgeEvents: {
+    description: "Purge old webhook events",
+    usage: "stow admin purge-events [options]",
+    examples: ["stow admin purge-events --dry-run"]
+  },
+  adminReconcileFiles: {
+    description: "Reconcile files between R2 and database",
+    usage: "stow admin reconcile-files --bucket <id>",
+    examples: ["stow admin reconcile-files --bucket <id> --dry-run"]
+  },
+  adminRetrySyncFailures: {
+    description: "Retry failed S3 sync operations",
+    usage: "stow admin retry-sync-failures",
+    examples: ["stow admin retry-sync-failures"]
+  },
+  adminJobs: {
+    description: "List and manage processing jobs",
+    usage: "stow admin jobs [options]",
+    examples: [
+      "stow admin jobs",
+      "stow admin jobs --status failed",
+      "stow admin jobs --org <id> --queue generate-title",
+      "stow admin jobs --json"
+    ]
+  },
+  adminJobsRetry: {
+    description: "Retry a failed job",
+    usage: "stow admin jobs retry <id> --queue <name>",
+    examples: ["stow admin jobs retry job123 --queue generate-title"]
+  },
+  adminJobsDelete: {
+    description: "Remove a job",
+    usage: "stow admin jobs delete <id> --queue <name>",
+    examples: ["stow admin jobs delete job123 --queue extract-colors"]
+  },
+  adminQueues: {
+    description: "Show queue depths and counts",
+    usage: "stow admin queues",
+    examples: ["stow admin queues", "stow admin queues --json"]
+  },
+  adminQueuesClean: {
+    description: "Clean jobs from a queue",
+    usage: "stow admin queues clean <name> --failed|--completed",
+    examples: [
+      "stow admin queues clean generate-title --failed",
+      "stow admin queues clean extract-colors --completed --grace 3600"
+    ]
   }
 };
 function renderCommandHelp(key) {
@@ -129,7 +344,7 @@ var program = new Command();
 program.name("stow").description(CLI_DOCS.root.description).version(VERSION).addHelpText("after", renderCommandHelp("root"));
 program.command("drop").description(CLI_DOCS.drop.description).argument("<file>", "File to upload").option("-q, --quiet", "Only output the URL").addHelpText("after", renderCommandHelp("drop")).action(async (file, options) => {
   try {
-    const { uploadDrop } = await import("./upload-DQDBDIDI.js");
+    const { uploadDrop } = await import("./upload-ESYKBYHA.js");
     await uploadDrop(file, options);
   } catch (err) {
     handleError(err);
@@ -138,7 +353,7 @@ program.command("drop").description(CLI_DOCS.drop.description).argument("<file>"
 program.command("upload").description(CLI_DOCS.upload.description).argument("<file>", "File to upload").option("-b, --bucket <name>", "Bucket name or ID").option("-q, --quiet", "Only output the URL").addHelpText("after", renderCommandHelp("upload")).action(
   async (file, options) => {
     try {
-      const { uploadFile } = await import("./upload-DQDBDIDI.js");
+      const { uploadFile } = await import("./upload-ESYKBYHA.js");
       await uploadFile(file, options);
     } catch (err) {
       handleError(err);
@@ -147,7 +362,7 @@ program.command("upload").description(CLI_DOCS.upload.description).argument("<fi
 );
 var bucketsCmd = program.command("buckets").description(CLI_DOCS.buckets.description).addHelpText("after", renderCommandHelp("buckets")).action(async () => {
   try {
-    const { listBuckets } = await import("./list-KEQPJY7I.js");
+    const { listBuckets } = await import("./buckets-JQKZ3PH3.js");
     await listBuckets();
   } catch (err) {
     handleError(err);
@@ -156,7 +371,7 @@ var bucketsCmd = program.command("buckets").description(CLI_DOCS.buckets.descrip
 bucketsCmd.command("create").description(CLI_DOCS.bucketsCreate.description).argument("<name>", "Bucket name").option("-d, --description <text>", "Bucket description").option("--public", "Make bucket public").addHelpText("after", renderCommandHelp("bucketsCreate")).action(
   async (name, options) => {
     try {
-      const { createBucket } = await import("./list-KEQPJY7I.js");
+      const { createBucket } = await import("./buckets-JQKZ3PH3.js");
       await createBucket(name, options);
     } catch (err) {
       handleError(err);
@@ -165,7 +380,7 @@ bucketsCmd.command("create").description(CLI_DOCS.bucketsCreate.description).arg
 );
 bucketsCmd.command("rename").description(CLI_DOCS.bucketsRename.description).argument("<name>", "Current bucket name").argument("<new-name>", "New bucket name").option("-y, --yes", "Skip confirmation warning").addHelpText("after", renderCommandHelp("bucketsRename")).action(async (name, newName, options) => {
   try {
-    const { renameBucket } = await import("./list-KEQPJY7I.js");
+    const { renameBucket } = await import("./buckets-JQKZ3PH3.js");
     await renameBucket(name, newName, options);
   } catch (err) {
     handleError(err);
@@ -173,25 +388,65 @@ bucketsCmd.command("rename").description(CLI_DOCS.bucketsRename.description).arg
 });
 bucketsCmd.command("delete").description(CLI_DOCS.bucketsDelete.description).argument("<id>", "Bucket ID").addHelpText("after", renderCommandHelp("bucketsDelete")).action(async (id) => {
   try {
-    const { deleteBucket } = await import("./list-KEQPJY7I.js");
+    const { deleteBucket } = await import("./buckets-JQKZ3PH3.js");
     await deleteBucket(id);
   } catch (err) {
     handleError(err);
   }
 });
-program.command("files").description(CLI_DOCS.files.description).argument("<bucket>", "Bucket name").option("-s, --search <prefix>", "Filter by prefix").option("-l, --limit <count>", "Max files to return").addHelpText("after", renderCommandHelp("files")).action(
+var filesCmd = program.command("files").description(CLI_DOCS.files.description).argument("[bucket]", "Bucket name").option("-s, --search <prefix>", "Filter by prefix").option("-l, --limit <count>", "Max files to return").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("files")).action(
   async (bucket, options) => {
+    if (!bucket) {
+      filesCmd.help();
+      return;
+    }
     try {
-      const { listFiles } = await import("./list-KEQPJY7I.js");
+      const { listFiles } = await import("./files-OCYICIAM.js");
       await listFiles(bucket, options);
     } catch (err) {
       handleError(err);
     }
   }
 );
+filesCmd.command("get").description(CLI_DOCS.filesGet.description).argument("<bucket>", "Bucket name").argument("<key>", "File key").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("filesGet")).action(async (bucket, key, options) => {
+  try {
+    const { getFile } = await import("./files-OCYICIAM.js");
+    await getFile(bucket, key, options);
+  } catch (err) {
+    handleError(err);
+  }
+});
+filesCmd.command("update").description(CLI_DOCS.filesUpdate.description).argument("<bucket>", "Bucket name").argument("<key>", "File key").option("-m, --metadata <kv...>", "Metadata key=value pairs").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("filesUpdate")).action(
+  async (bucket, key, options) => {
+    try {
+      const { updateFile } = await import("./files-OCYICIAM.js");
+      await updateFile(bucket, key, options);
+    } catch (err) {
+      handleError(err);
+    }
+  }
+);
+filesCmd.command("enrich").description(CLI_DOCS.filesEnrich.description).argument("<bucket>", "Bucket name").argument("<key>", "File key").addHelpText("after", renderCommandHelp("filesEnrich")).action(async (bucket, key) => {
+  try {
+    const { enrichFile } = await import("./files-OCYICIAM.js");
+    await enrichFile(bucket, key);
+  } catch (err) {
+    handleError(err);
+  }
+});
+filesCmd.command("missing").description(CLI_DOCS.filesMissing.description).argument("<bucket>", "Bucket name").argument("<type>", "dimensions | embeddings | colors").option("-l, --limit <count>", "Max files to return").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("filesMissing")).action(
+  async (bucket, type, options) => {
+    try {
+      const { listMissing } = await import("./files-OCYICIAM.js");
+      await listMissing(bucket, type, options);
+    } catch (err) {
+      handleError(err);
+    }
+  }
+);
 var dropsCmd = program.command("drops").description(CLI_DOCS.drops.description).addHelpText("after", renderCommandHelp("drops")).action(async () => {
   try {
-    const { listDrops } = await import("./list-KEQPJY7I.js");
+    const { listDrops } = await import("./drops-QXGTYB5E.js");
     await listDrops();
   } catch (err) {
     handleError(err);
@@ -199,12 +454,250 @@ var dropsCmd = program.command("drops").description(CLI_DOCS.drops.description).
 });
 dropsCmd.command("delete").description(CLI_DOCS.dropsDelete.description).argument("<id>", "Drop ID").addHelpText("after", renderCommandHelp("dropsDelete")).action(async (id) => {
   try {
-    const { deleteDrop } = await import("./list-KEQPJY7I.js");
+    const { deleteDrop } = await import("./drops-QXGTYB5E.js");
     await deleteDrop(id);
   } catch (err) {
     handleError(err);
   }
 });
+var searchCmd = program.command("search").description(CLI_DOCS.search.description).addHelpText("after", renderCommandHelp("search"));
+searchCmd.command("text").description(CLI_DOCS.searchText.description).argument("<query>", "Search query").option("-b, --bucket <name>", "Bucket name").option("-l, --limit <count>", "Max results").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("searchText")).action(
+  async (query, options) => {
+    try {
+      const { textSearch } = await import("./search-2PXM6XQ6.js");
+      await textSearch(query, options);
+    } catch (err) {
+      handleError(err);
+    }
+  }
+);
+searchCmd.command("similar").description(CLI_DOCS.searchSimilar.description).requiredOption("--file <key>", "File key to search from").option("-b, --bucket <name>", "Bucket name").option("-l, --limit <count>", "Max results").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("searchSimilar")).action(
+  async (options) => {
+    try {
+      const { similarSearch } = await import("./search-2PXM6XQ6.js");
+      await similarSearch(options);
+    } catch (err) {
+      handleError(err);
+    }
+  }
+);
+searchCmd.command("color").description(CLI_DOCS.searchColor.description).requiredOption("--hex <color>", "Hex color code").option("-b, --bucket <name>", "Bucket name").option("-l, --limit <count>", "Max results").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("searchColor")).action(
+  async (options) => {
+    try {
+      const { colorSearch } = await import("./search-2PXM6XQ6.js");
+      await colorSearch(options);
+    } catch (err) {
+      handleError(err);
+    }
+  }
+);
+searchCmd.command("diverse").description(CLI_DOCS.searchDiverse.description).option("-b, --bucket <name>", "Bucket name").option("-l, --limit <count>", "Max results").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("searchDiverse")).action(
+  async (options) => {
+    try {
+      const { diverseSearch } = await import("./search-2PXM6XQ6.js");
+      await diverseSearch(options);
+    } catch (err) {
+      handleError(err);
+    }
+  }
+);
+var tagsCmd = program.command("tags").description(CLI_DOCS.tags.description).option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("tags")).action(async (options) => {
+  try {
+    const { listTags } = await import("./tags-LSVEIIUF.js");
+    await listTags(options);
+  } catch (err) {
+    handleError(err);
+  }
+});
+tagsCmd.command("create").description(CLI_DOCS.tagsCreate.description).argument("<name>", "Tag name").option("--color <hex>", "Tag color (hex)").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("tagsCreate")).action(async (name, options) => {
+  try {
+    const { createTag } = await import("./tags-LSVEIIUF.js");
+    await createTag(name, options);
+  } catch (err) {
+    handleError(err);
+  }
+});
+tagsCmd.command("delete").description(CLI_DOCS.tagsDelete.description).argument("<id>", "Tag ID").addHelpText("after", renderCommandHelp("tagsDelete")).action(async (id) => {
+  try {
+    const { deleteTag } = await import("./tags-LSVEIIUF.js");
+    await deleteTag(id);
+  } catch (err) {
+    handleError(err);
+  }
+});
+var profilesCmd = program.command("profiles").description(CLI_DOCS.profiles.description).addHelpText("after", renderCommandHelp("profiles"));
+profilesCmd.command("create").description(CLI_DOCS.profilesCreate.description).requiredOption("--name <name>", "Profile name").option("-b, --bucket <id>", "Bucket ID").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("profilesCreate")).action(
+  async (options) => {
+    try {
+      const { createProfile } = await import("./profiles-GWLBEEIT.js");
+      await createProfile(options);
+    } catch (err) {
+      handleError(err);
+    }
+  }
+);
+profilesCmd.command("get").description(CLI_DOCS.profilesGet.description).argument("<id>", "Profile ID").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("profilesGet")).action(async (id, options) => {
+  try {
+    const { getProfile } = await import("./profiles-GWLBEEIT.js");
+    await getProfile(id, options);
+  } catch (err) {
+    handleError(err);
+  }
+});
+profilesCmd.command("delete").description(CLI_DOCS.profilesDelete.description).argument("<id>", "Profile ID").addHelpText("after", renderCommandHelp("profilesDelete")).action(async (id) => {
+  try {
+    const { deleteProfile } = await import("./profiles-GWLBEEIT.js");
+    await deleteProfile(id);
+  } catch (err) {
+    handleError(err);
+  }
+});
+var jobsCmd = program.command("jobs").description(CLI_DOCS.jobs.description).requiredOption("-b, --bucket <id>", "Bucket ID (required)").option("-s, --status <status>", "Filter by status").option("-q, --queue <name>", "Filter by queue name").option("-l, --limit <count>", "Max jobs to return").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("jobs")).action(
+  async (options) => {
+    try {
+      const { listJobs } = await import("./jobs-6JY4SVV5.js");
+      await listJobs(options.bucket, options);
+    } catch (err) {
+      handleError(err);
+    }
+  }
+);
+jobsCmd.command("retry").description(CLI_DOCS.jobsRetry.description).argument("<id>", "Job ID").requiredOption("-q, --queue <name>", "Queue name").requiredOption("-b, --bucket <id>", "Bucket ID").addHelpText("after", renderCommandHelp("jobsRetry")).action(async (id, options) => {
+  try {
+    const { retryJob } = await import("./jobs-6JY4SVV5.js");
+    await retryJob(id, options);
+  } catch (err) {
+    handleError(err);
+  }
+});
+jobsCmd.command("delete").description(CLI_DOCS.jobsDelete.description).argument("<id>", "Job ID").requiredOption("-q, --queue <name>", "Queue name").requiredOption("-b, --bucket <id>", "Bucket ID").addHelpText("after", renderCommandHelp("jobsDelete")).action(async (id, options) => {
+  try {
+    const { deleteJob } = await import("./jobs-6JY4SVV5.js");
+    await deleteJob(id, options);
+  } catch (err) {
+    handleError(err);
+  }
+});
+var adminCmd = program.command("admin").description(CLI_DOCS.admin.description).addHelpText("after", renderCommandHelp("admin"));
+adminCmd.command("health").description(CLI_DOCS.adminHealth.description).option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("adminHealth")).action(async (options) => {
+  try {
+    const { health } = await import("./health-YMZTZUFX.js");
+    await health(options);
+  } catch (err) {
+    handleError(err);
+  }
+});
+var backfillCmd = adminCmd.command("backfill").description(CLI_DOCS.adminBackfill.description).addHelpText("after", renderCommandHelp("adminBackfill"));
+backfillCmd.command("dimensions").description("Backfill image dimensions").option("--bucket <id>", "Bucket ID").option("-l, --limit <count>", "Max files to enqueue").option("--dry-run", "Preview without enqueuing").option("--json", "Output as JSON").action(
+  async (options) => {
+    try {
+      const { backfillDimensions } = await import("./backfill-QZTVNJZM.js");
+      await backfillDimensions(options);
+    } catch (err) {
+      handleError(err);
+    }
+  }
+);
+backfillCmd.command("colors").description("Backfill color extraction").option("--bucket <id>", "Bucket ID").option("-l, --limit <count>", "Max files to enqueue").option("--dry-run", "Preview without enqueuing").option("--json", "Output as JSON").action(
+  async (options) => {
+    try {
+      const { backfillColors } = await import("./backfill-QZTVNJZM.js");
+      await backfillColors(options);
+    } catch (err) {
+      handleError(err);
+    }
+  }
+);
+backfillCmd.command("embeddings").description("Backfill embedding generation").option("--bucket <id>", "Bucket ID").option("-l, --limit <count>", "Max files to enqueue").option("--dry-run", "Preview without enqueuing").option("--json", "Output as JSON").action(
+  async (options) => {
+    try {
+      const { backfillEmbeddings } = await import("./backfill-QZTVNJZM.js");
+      await backfillEmbeddings(options);
+    } catch (err) {
+      handleError(err);
+    }
+  }
+);
+adminCmd.command("cleanup-drops").description(CLI_DOCS.adminCleanupDrops.description).option("--max-age-hours <hours>", "Max age in hours").option("--dry-run", "Preview without deleting").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("adminCleanupDrops")).action(
+  async (options) => {
+    try {
+      const { cleanupDrops } = await import("./maintenance-EZUHQK5Q.js");
+      await cleanupDrops(options);
+    } catch (err) {
+      handleError(err);
+    }
+  }
+);
+adminCmd.command("purge-events").description(CLI_DOCS.adminPurgeEvents.description).option("--dry-run", "Preview without deleting").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("adminPurgeEvents")).action(async (options) => {
+  try {
+    const { purgeEvents } = await import("./maintenance-EZUHQK5Q.js");
+    await purgeEvents(options);
+  } catch (err) {
+    handleError(err);
+  }
+});
+adminCmd.command("reconcile-files").description(CLI_DOCS.adminReconcileFiles.description).requiredOption("--bucket <id>", "Bucket ID").option("--dry-run", "Preview without reconciling").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("adminReconcileFiles")).action(
+  async (options) => {
+    try {
+      const { reconcileFiles } = await import("./maintenance-EZUHQK5Q.js");
+      await reconcileFiles(options);
+    } catch (err) {
+      handleError(err);
+    }
+  }
+);
+adminCmd.command("retry-sync-failures").description(CLI_DOCS.adminRetrySyncFailures.description).option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("adminRetrySyncFailures")).action(async (options) => {
+  try {
+    const { retrySyncFailures } = await import("./maintenance-EZUHQK5Q.js");
+    await retrySyncFailures(options);
+  } catch (err) {
+    handleError(err);
+  }
+});
+var adminJobsCmd = adminCmd.command("jobs").description(CLI_DOCS.adminJobs.description).option("--org <id>", "Filter by org ID").option("--bucket <id>", "Filter by bucket ID").option("-s, --status <status>", "Filter by status").option("-q, --queue <name>", "Filter by queue name").option("-l, --limit <count>", "Max jobs to return").option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("adminJobs")).action(
+  async (options) => {
+    try {
+      const { listAdminJobs } = await import("./jobs-OKKGKSIH.js");
+      await listAdminJobs(options);
+    } catch (err) {
+      handleError(err);
+    }
+  }
+);
+adminJobsCmd.command("retry").description(CLI_DOCS.adminJobsRetry.description).argument("<id>", "Job ID").requiredOption("-q, --queue <name>", "Queue name").addHelpText("after", renderCommandHelp("adminJobsRetry")).action(async (id, options) => {
+  try {
+    const { retryAdminJob } = await import("./jobs-OKKGKSIH.js");
+    await retryAdminJob(id, options);
+  } catch (err) {
+    handleError(err);
+  }
+});
+adminJobsCmd.command("delete").description(CLI_DOCS.adminJobsDelete.description).argument("<id>", "Job ID").requiredOption("-q, --queue <name>", "Queue name").addHelpText("after", renderCommandHelp("adminJobsDelete")).action(async (id, options) => {
+  try {
+    const { deleteAdminJob } = await import("./jobs-OKKGKSIH.js");
+    await deleteAdminJob(id, options);
+  } catch (err) {
+    handleError(err);
+  }
+});
+var adminQueuesCmd = adminCmd.command("queues").description(CLI_DOCS.adminQueues.description).option("--json", "Output as JSON").addHelpText("after", renderCommandHelp("adminQueues")).action(async (options) => {
+  try {
+    const { listQueues } = await import("./queues-EQX7EJZF.js");
+    await listQueues(options);
+  } catch (err) {
+    handleError(err);
+  }
+});
+adminQueuesCmd.command("clean").description(CLI_DOCS.adminQueuesClean.description).argument("<name>", "Queue name").option("--failed", "Clean failed jobs").option("--completed", "Clean completed jobs").option("--grace <seconds>", "Grace period in seconds").addHelpText("after", renderCommandHelp("adminQueuesClean")).action(
+  async (name, options) => {
+    try {
+      const { cleanQueue } = await import("./queues-EQX7EJZF.js");
+      await cleanQueue(name, options);
+    } catch (err) {
+      handleError(err);
+    }
+  }
+);
 program.command("delete").description(CLI_DOCS.delete.description).argument("<bucket>", "Bucket name").argument("<key>", "File key").addHelpText("after", renderCommandHelp("delete")).action(async (bucket, key) => {
   try {
     const { deleteFile } = await import("./delete-NAV6P5O5.js");
@@ -215,7 +708,7 @@ program.command("delete").description(CLI_DOCS.delete.description).argument("<bu
 });
 program.command("whoami").description(CLI_DOCS.whoami.description).addHelpText("after", renderCommandHelp("whoami")).action(async () => {
   try {
-    const { whoami } = await import("./whoami-754O5IML.js");
+    const { whoami } = await import("./whoami-4UYMSRVP.js");
     await whoami();
   } catch (err) {
     handleError(err);
@@ -234,5 +727,5 @@ program.parse();
 var opts = program.opts();
 var args = process.argv.slice(2);
 if (args.length === 0 || args.length === 1 && opts.interactive) {
-  import("./app-2A2CFVBC.js").then(({ startInteractive }) => startInteractive()).catch(handleError);
+  import("./app-JPUDM4LJ.js").then(({ startInteractive }) => startInteractive()).catch(handleError);
 }

package/dist/drops-QXGTYB5E.js

@@ -0,0 +1,39 @@
+import {
+  formatBytes,
+  formatTable,
+  usageBar
+} from "./chunk-ELSDWMEB.js";
+import {
+  createStow
+} from "./chunk-JYOMHKFS.js";
+import "./chunk-OZ7QQTIZ.js";
+
+// src/commands/drops.ts
+async function listDrops() {
+  const stow = createStow();
+  const data = await stow.listDrops();
+  if (data.drops.length === 0) {
+    console.log("No drops yet. Create one with: stow drop <file>");
+    return;
+  }
+  const rows = data.drops.map((d) => [
+    d.filename,
+    formatBytes(Number(d.size)),
+    d.contentType,
+    d.url
+  ]);
+  console.log(formatTable(["Filename", "Size", "Type", "URL"], rows));
+  console.log(
+    `
+Storage: ${usageBar(data.usage.bytes, data.usage.limit)}  ${formatBytes(data.usage.bytes)} / ${formatBytes(data.usage.limit)}`
+  );
+}
+async function deleteDrop(id) {
+  const stow = createStow();
+  await stow.deleteDrop(id);
+  console.log(`Deleted drop: ${id}`);
+}
+export {
+  deleteDrop,
+  listDrops
+};