stow-cli 2.2.0 → 2.2.3

package/dist/mcp-TUZZB2C7.js

@@ -0,0 +1,189 @@
+import {
+  createStow
+} from "./chunk-5LU25QZK.js";
+import "./chunk-TOADDO2F.js";
+
+// src/commands/mcp.ts
+import { z } from "zod";
+async function startMcpServer() {
+  const { McpServer } = await import("@modelcontextprotocol/sdk/server/mcp.js");
+  const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
+  const server = new McpServer({
+    name: "stow",
+    version: "2.0.4"
+  });
+  server.tool("stow_whoami", "Show current user and organization", {}, async () => {
+    const stow = createStow();
+    const result = await stow.whoami();
+    return { content: [{ type: "text", text: JSON.stringify(result) }] };
+  });
+  server.tool("stow_buckets_list", "List all buckets", {}, async () => {
+    const stow = createStow();
+    const result = await stow.listBuckets();
+    return { content: [{ type: "text", text: JSON.stringify(result) }] };
+  });
+  server.tool(
+    "stow_files_list",
+    "List files in a bucket",
+    {
+      bucket: z.string().describe("Bucket name"),
+      limit: z.number().optional().describe("Max results (default 50)")
+    },
+    async (params) => {
+      const stow = createStow();
+      const result = await stow.listFiles({
+        bucket: params.bucket,
+        limit: params.limit
+      });
+      return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    }
+  );
+  server.tool(
+    "stow_files_get",
+    "Get file details",
+    {
+      bucket: z.string().describe("Bucket name"),
+      key: z.string().describe("File key")
+    },
+    async (params) => {
+      const stow = createStow();
+      const result = await stow.getFile(params.key, {
+        bucket: params.bucket
+      });
+      return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    }
+  );
+  server.tool(
+    "stow_search_text",
+    "Search files by text query",
+    {
+      query: z.string().describe("Search query"),
+      bucket: z.string().optional().describe("Bucket name (optional)"),
+      limit: z.number().optional().describe("Max results (default 10)")
+    },
+    async (params) => {
+      const stow = createStow();
+      const result = await stow.search.text({
+        query: params.query,
+        bucket: params.bucket,
+        limit: params.limit
+      });
+      return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    }
+  );
+  server.tool(
+    "stow_search_similar",
+    "Find visually similar files",
+    {
+      fileKey: z.string().describe("File key to find similar files for"),
+      bucket: z.string().optional().describe("Bucket name (optional)"),
+      limit: z.number().optional().describe("Max results (default 10)")
+    },
+    async (params) => {
+      const stow = createStow();
+      const result = await stow.search.similar({
+        fileKey: params.fileKey,
+        bucket: params.bucket,
+        limit: params.limit
+      });
+      return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    }
+  );
+  server.tool(
+    "stow_search_color",
+    "Search files by hex color",
+    {
+      hex: z.string().describe("Hex color code (e.g. #ff0000)"),
+      bucket: z.string().optional().describe("Bucket name (optional)"),
+      limit: z.number().optional().describe("Max results (default 10)")
+    },
+    async (params) => {
+      const stow = createStow();
+      const result = await stow.search.color({
+        hex: params.hex,
+        bucket: params.bucket,
+        limit: params.limit
+      });
+      return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    }
+  );
+  server.tool(
+    "stow_search_diverse",
+    "Get a diverse set of files from a bucket",
+    {
+      bucket: z.string().optional().describe("Bucket name (optional)"),
+      limit: z.number().optional().describe("Max results (default 10)")
+    },
+    async (params) => {
+      const stow = createStow();
+      const result = await stow.search.diverse({
+        bucket: params.bucket,
+        limit: params.limit
+      });
+      return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    }
+  );
+  server.tool(
+    "stow_search_image",
+    "Search by image URL or existing file key",
+    {
+      url: z.string().optional().describe("Image URL to search by"),
+      fileKey: z.string().optional().describe("Existing file key to search by"),
+      bucket: z.string().optional().describe("Bucket name (optional)"),
+      limit: z.number().optional().describe("Max results (default 12)")
+    },
+    async (params) => {
+      const stow = createStow();
+      const input = {};
+      if (params.url) {
+        input.url = params.url;
+      }
+      if (params.fileKey) {
+        input.fileKey = params.fileKey;
+      }
+      const result = await stow.search.image(input, {
+        bucket: params.bucket,
+        limit: params.limit ?? 12
+      });
+      return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    }
+  );
+  server.tool("stow_tags_list", "List all tags", {}, async () => {
+    const stow = createStow();
+    const result = await stow.tags.list();
+    return { content: [{ type: "text", text: JSON.stringify(result) }] };
+  });
+  server.tool(
+    "stow_anchors_list",
+    "List anchors in a bucket",
+    {
+      bucket: z.string().optional().describe("Bucket name (optional)")
+    },
+    async (params) => {
+      const stow = createStow();
+      const result = await stow.anchors.list({ bucket: params.bucket });
+      return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    }
+  );
+  server.tool(
+    "stow_anchors_create",
+    "Create a text anchor for semantic search",
+    {
+      text: z.string().describe("Anchor text to embed"),
+      label: z.string().optional().describe("Human-readable label (optional)")
+    },
+    async (params) => {
+      const stow = createStow();
+      const result = await stow.anchors.create({
+        text: params.text,
+        label: params.label
+      });
+      return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    }
+  );
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+export {
+  startMcpServer
+};

package/dist/profiles-FOLKZZRU.js

@@ -0,0 +1,53 @@
+import {
+  output
+} from "./chunk-RH4BOSYB.js";
+import {
+  formatTable
+} from "./chunk-FZGOTXTE.js";
+import {
+  createStow
+} from "./chunk-5LU25QZK.js";
+import "./chunk-TOADDO2F.js";
+
+// src/commands/profiles.ts
+async function createProfile(options) {
+  const stow = createStow();
+  const profile = await stow.profiles.create({
+    name: options.name,
+    ...options.bucket ? { bucketId: options.bucket } : {}
+  });
+  output(profile, () => `Created profile: ${profile.name} (${profile.id})`, {
+    json: options.json
+  });
+}
+async function getProfile(id, options) {
+  const stow = createStow();
+  const profile = await stow.profiles.get(id);
+  output(
+    profile,
+    () => {
+      const lines = [`Profile: ${profile.name} (${profile.id})`];
+      if (profile.clusters && profile.clusters.length > 0) {
+        lines.push("\nClusters:");
+        const rows = profile.clusters.map((c) => [
+          String(c.index),
+          c.name ?? "(unnamed)",
+          String(c.signalCount)
+        ]);
+        lines.push(formatTable(["Index", "Name", "Signals"], rows));
+      }
+      return lines.join("\n");
+    },
+    { json: options.json }
+  );
+}
+async function deleteProfile(id) {
+  const stow = createStow();
+  await stow.profiles.delete(id);
+  console.log(`Deleted profile: ${id}`);
+}
+export {
+  createProfile,
+  deleteProfile,
+  getProfile
+};

package/dist/profiles-MB3TZQE4.js

@@ -0,0 +1,53 @@
+import {
+  output
+} from "./chunk-5IX3ASXH.js";
+import {
+  formatTable
+} from "./chunk-FZGOTXTE.js";
+import {
+  createStow
+} from "./chunk-5LU25QZK.js";
+import "./chunk-TOADDO2F.js";
+
+// src/commands/profiles.ts
+async function createProfile(options) {
+  const stow = createStow();
+  const profile = await stow.profiles.create({
+    name: options.name,
+    ...options.bucket ? { bucketId: options.bucket } : {}
+  });
+  output(profile, () => `Created profile: ${profile.name} (${profile.id})`, {
+    json: options.json
+  });
+}
+async function getProfile(id, options) {
+  const stow = createStow();
+  const profile = await stow.profiles.get(id);
+  output(
+    profile,
+    () => {
+      const lines = [`Profile: ${profile.name} (${profile.id})`];
+      if (profile.clusters && profile.clusters.length > 0) {
+        lines.push("\nClusters:");
+        const rows = profile.clusters.map((c) => [
+          String(c.index),
+          c.name ?? "(unnamed)",
+          String(c.signalCount)
+        ]);
+        lines.push(formatTable(["Index", "Name", "Signals"], rows));
+      }
+      return lines.join("\n");
+    },
+    { json: options.json }
+  );
+}
+async function deleteProfile(id) {
+  const stow = createStow();
+  await stow.profiles.delete(id);
+  console.log(`Deleted profile: ${id}`);
+}
+export {
+  createProfile,
+  deleteProfile,
+  getProfile
+};

package/dist/profiles-NVCJCYXR.js

@@ -0,0 +1,53 @@
+import {
+  output
+} from "./chunk-5BVMPHKH.js";
+import {
+  formatTable
+} from "./chunk-FZGOTXTE.js";
+import {
+  createStow
+} from "./chunk-5LU25QZK.js";
+import "./chunk-TOADDO2F.js";
+
+// src/commands/profiles.ts
+async function createProfile(options) {
+  const stow = createStow();
+  const profile = await stow.profiles.create({
+    name: options.name,
+    ...options.bucket ? { bucketId: options.bucket } : {}
+  });
+  output(profile, () => `Created profile: ${profile.name} (${profile.id})`, {
+    json: options.json
+  });
+}
+async function getProfile(id, options) {
+  const stow = createStow();
+  const profile = await stow.profiles.get(id);
+  output(
+    profile,
+    () => {
+      const lines = [`Profile: ${profile.name} (${profile.id})`];
+      if (profile.clusters && profile.clusters.length > 0) {
+        lines.push("\nClusters:");
+        const rows = profile.clusters.map((c) => [
+          String(c.index),
+          c.name ?? "(unnamed)",
+          String(c.signalCount)
+        ]);
+        lines.push(formatTable(["Index", "Name", "Signals"], rows));
+      }
+      return lines.join("\n");
+    },
+    { json: options.json }
+  );
+}
+async function deleteProfile(id) {
+  const stow = createStow();
+  await stow.profiles.delete(id);
+  console.log(`Deleted profile: ${id}`);
+}
+export {
+  createProfile,
+  deleteProfile,
+  getProfile
+};

package/dist/profiles-XXVM3UKI.js

@@ -0,0 +1,53 @@
+import {
+  output
+} from "./chunk-KPIQZBTO.js";
+import {
+  formatTable
+} from "./chunk-PE6V3MVP.js";
+import {
+  createStow
+} from "./chunk-5LU25QZK.js";
+import "./chunk-TOADDO2F.js";
+
+// src/commands/profiles.ts
+async function createProfile(options) {
+  const stow = createStow();
+  const profile = await stow.profiles.create({
+    name: options.name,
+    ...options.bucket ? { bucketId: options.bucket } : {}
+  });
+  output(profile, () => `Created profile: ${profile.name} (${profile.id})`, {
+    json: options.json
+  });
+}
+async function getProfile(id, options) {
+  const stow = createStow();
+  const profile = await stow.profiles.get(id);
+  output(
+    profile,
+    () => {
+      const lines = [`Profile: ${profile.name} (${profile.id})`];
+      if (profile.clusters && profile.clusters.length > 0) {
+        lines.push("\nClusters:");
+        const rows = profile.clusters.map((c) => [
+          String(c.index),
+          c.name ?? "(unnamed)",
+          String(c.signalCount)
+        ]);
+        lines.push(formatTable(["Index", "Name", "Signals"], rows));
+      }
+      return lines.join("\n");
+    },
+    { json: options.json }
+  );
+}
+async function deleteProfile(id) {
+  const stow = createStow();
+  await stow.profiles.delete(id);
+  console.log(`Deleted profile: ${id}`);
+}
+export {
+  createProfile,
+  deleteProfile,
+  getProfile
+};

package/dist/queues-AUGTAFBT.js

@@ -0,0 +1,61 @@
+import {
+  adminRequest
+} from "./chunk-QF7PVPWQ.js";
+import {
+  isJsonOutput,
+  output
+} from "./chunk-5BVMPHKH.js";
+import {
+  formatTable
+} from "./chunk-FZGOTXTE.js";
+import "./chunk-TOADDO2F.js";
+
+// src/commands/admin/queues.ts
+async function listQueues(options) {
+  const result = await adminRequest({
+    method: "GET",
+    path: "/admin/queues"
+  });
+  const entries = Object.entries(result.queues);
+  if (entries.length === 0) {
+    if (isJsonOutput() || options.json) {
+      output(result.queues, void 0, { json: options.json });
+    } else {
+      console.log("No queues found.");
+    }
+    return;
+  }
+  output(
+    result.queues,
+    () => {
+      const rows = entries.map(([name, counts]) => [
+        name,
+        String(counts.waiting),
+        String(counts.active),
+        String(counts.completed),
+        String(counts.failed)
+      ]);
+      return formatTable(
+        ["Queue", "Waiting", "Active", "Completed", "Failed"],
+        rows
+      );
+    },
+    { json: options.json }
+  );
+}
+async function cleanQueue(queueName, options) {
+  const status = options.failed ? "failed" : "completed";
+  const grace = options.grace ? Number(options.grace) : 0;
+  const result = await adminRequest({
+    method: "POST",
+    path: `/admin/queues/${encodeURIComponent(queueName)}/clean`,
+    body: { status, grace }
+  });
+  console.log(
+    `Cleaned ${result.cleaned} ${result.status} jobs from ${result.queue}.`
+  );
+}
+export {
+  cleanQueue,
+  listQueues
+};

package/dist/queues-MTA2RWUP.js

@@ -0,0 +1,56 @@
+import {
+  adminRequest
+} from "./chunk-QF7PVPWQ.js";
+import {
+  isJsonOutput,
+  output
+} from "./chunk-KPIQZBTO.js";
+import {
+  formatTable
+} from "./chunk-PE6V3MVP.js";
+import "./chunk-TOADDO2F.js";
+
+// src/commands/admin/queues.ts
+async function listQueues(options) {
+  const result = await adminRequest({
+    method: "GET",
+    path: "/admin/queues"
+  });
+  const entries = Object.entries(result.queues);
+  if (entries.length === 0) {
+    if (isJsonOutput() || options.json) {
+      output(result.queues, void 0, { json: options.json });
+    } else {
+      console.log("No queues found.");
+    }
+    return;
+  }
+  output(
+    result.queues,
+    () => {
+      const rows = entries.map(([name, counts]) => [
+        name,
+        String(counts.waiting),
+        String(counts.active),
+        String(counts.completed),
+        String(counts.failed)
+      ]);
+      return formatTable(["Queue", "Waiting", "Active", "Completed", "Failed"], rows);
+    },
+    { json: options.json }
+  );
+}
+async function cleanQueue(queueName, options) {
+  const status = options.failed ? "failed" : "completed";
+  const grace = options.grace ? Number(options.grace) : 0;
+  const result = await adminRequest({
+    method: "POST",
+    path: `/admin/queues/${encodeURIComponent(queueName)}/clean`,
+    body: { status, grace }
+  });
+  console.log(`Cleaned ${result.cleaned} ${result.status} jobs from ${result.queue}.`);
+}
+export {
+  cleanQueue,
+  listQueues
+};

package/dist/queues-NR25TGT7.js

@@ -0,0 +1,61 @@
+import {
+  adminRequest
+} from "./chunk-QF7PVPWQ.js";
+import {
+  isJsonOutput,
+  output
+} from "./chunk-5IX3ASXH.js";
+import {
+  formatTable
+} from "./chunk-FZGOTXTE.js";
+import "./chunk-TOADDO2F.js";
+
+// src/commands/admin/queues.ts
+async function listQueues(options) {
+  const result = await adminRequest({
+    method: "GET",
+    path: "/admin/queues"
+  });
+  const entries = Object.entries(result.queues);
+  if (entries.length === 0) {
+    if (isJsonOutput() || options.json) {
+      output(result.queues, void 0, { json: options.json });
+    } else {
+      console.log("No queues found.");
+    }
+    return;
+  }
+  output(
+    result.queues,
+    () => {
+      const rows = entries.map(([name, counts]) => [
+        name,
+        String(counts.waiting),
+        String(counts.active),
+        String(counts.completed),
+        String(counts.failed)
+      ]);
+      return formatTable(
+        ["Queue", "Waiting", "Active", "Completed", "Failed"],
+        rows
+      );
+    },
+    { json: options.json }
+  );
+}
+async function cleanQueue(queueName, options) {
+  const status = options.failed ? "failed" : "completed";
+  const grace = options.grace ? Number(options.grace) : 0;
+  const result = await adminRequest({
+    method: "POST",
+    path: `/admin/queues/${encodeURIComponent(queueName)}/clean`,
+    body: { status, grace }
+  });
+  console.log(
+    `Cleaned ${result.cleaned} ${result.status} jobs from ${result.queue}.`
+  );
+}
+export {
+  cleanQueue,
+  listQueues
+};

package/dist/queues-X6IU3KBZ.js

@@ -0,0 +1,61 @@
+import {
+  adminRequest
+} from "./chunk-QF7PVPWQ.js";
+import {
+  isJsonOutput,
+  output
+} from "./chunk-RH4BOSYB.js";
+import {
+  formatTable
+} from "./chunk-FZGOTXTE.js";
+import "./chunk-TOADDO2F.js";
+
+// src/commands/admin/queues.ts
+async function listQueues(options) {
+  const result = await adminRequest({
+    method: "GET",
+    path: "/admin/queues"
+  });
+  const entries = Object.entries(result.queues);
+  if (entries.length === 0) {
+    if (isJsonOutput() || options.json) {
+      output(result.queues, void 0, { json: options.json });
+    } else {
+      console.log("No queues found.");
+    }
+    return;
+  }
+  output(
+    result.queues,
+    () => {
+      const rows = entries.map(([name, counts]) => [
+        name,
+        String(counts.waiting),
+        String(counts.active),
+        String(counts.completed),
+        String(counts.failed)
+      ]);
+      return formatTable(
+        ["Queue", "Waiting", "Active", "Completed", "Failed"],
+        rows
+      );
+    },
+    { json: options.json }
+  );
+}
+async function cleanQueue(queueName, options) {
+  const status = options.failed ? "failed" : "completed";
+  const grace = options.grace ? Number(options.grace) : 0;
+  const result = await adminRequest({
+    method: "POST",
+    path: `/admin/queues/${encodeURIComponent(queueName)}/clean`,
+    body: { status, grace }
+  });
+  console.log(
+    `Cleaned ${result.cleaned} ${result.status} jobs from ${result.queue}.`
+  );
+}
+export {
+  cleanQueue,
+  listQueues
+};