@spira-lab/cli 0.0.9 → 0.0.10

package/README.md

@@ -2,6 +2,14 @@
 
 Command line client for Spira.
 
+> ⚠️ **Database feature is deprecated.** The Brand Machine "Database" subsystem
+> has been retired from the product. The `spira dataBase glob | read | grep |
+> search` commands still exist for backward compatibility only — do NOT build
+> new workflows against them. Use the Brand Machine web dashboard or the
+> per-user cc-engine workspace (`spira workspace` / dashboard Workspace tab)
+> instead. The bundled `spira-database` skill has been removed so agents are
+> no longer guided toward these commands.
+
 ## Install
 
 ```bash

package/dist/index.cjs

@@ -3457,7 +3457,7 @@ var require_commander = __commonJS({
 });
 
 // src/program.ts
-var import_promises3 = require("node:fs/promises");
+var import_promises5 = require("node:fs/promises");
 
 // ../../node_modules/.pnpm/commander@14.0.3/node_modules/commander/esm.mjs
 var import_index = __toESM(require_commander(), 1);
@@ -18060,6 +18060,8 @@ var cliResultTypeSchema = external_exports.enum([
   "scheduleOccurrenceList",
   "scheduleExecutionList",
   "scheduleAction",
+  "mediaInfo",
+  "mediaAsset",
   "dataBaseGlob",
   "dataBaseRead",
   "dataBaseGrep",
@@ -20407,7 +20409,7 @@ function getCliAiModelDoc(modelId) {
 // src/ai/wait.ts
 var DEFAULT_WAIT_COMMAND = "spira ai jobs create";
 function wait(durationMs) {
-  return new Promise((resolve) => setTimeout(resolve, durationMs));
+  return new Promise((resolve2) => setTimeout(resolve2, durationMs));
 }
 function jobStatus(result) {
   if (!result.data || typeof result.data !== "object") return void 0;
@@ -21340,6 +21342,92 @@ var commandDefinitions = [
     examples: ["spira schedules calendar --from 1781884800000 --to 1782490000000"],
     relatedCommands: ["spira schedules get <scheduleId>"]
   },
+  {
+    path: ["media", "info"],
+    purpose: "Resolve a TikTok / YouTube / Instagram / X / Facebook link and show its metadata.",
+    arguments: [{ name: "url", description: "Public post or video URL.", required: true }],
+    http: {
+      method: "POST",
+      path: "/api/tools/media/info",
+      authRequired: true,
+      body: [{ name: "url", source: "argument", from: "url" }]
+    },
+    resultType: "mediaInfo",
+    examples: [
+      "spira media info https://www.youtube.com/watch?v=dQw4w9WgXcQ",
+      "spira media info https://www.tiktok.com/@user/video/123 --json"
+    ],
+    relatedCommands: ["spira media video <url>", "spira media thumbnail <url>", "spira credits balance"]
+  },
+  {
+    path: ["media", "video"],
+    purpose: "Download the video file behind a social link.",
+    arguments: [{ name: "url", description: "Public post or video URL.", required: true }],
+    options: [
+      {
+        name: "maxHeight",
+        flag: "--max-height <pixels>",
+        description: "Cap the selected format height. Omit for the best available.",
+        type: "number",
+        minimum: 144
+      },
+      {
+        name: "quality",
+        flag: "--quality <mode>",
+        description: "compatible (default) grabs H.264 MP4 that any editor opens; best grabs the highest resolution, which may be WebM/AV1.",
+        type: "string",
+        enumValues: ["compatible", "best"]
+      },
+      {
+        name: "output",
+        flag: "--output <path>",
+        description: "Also save a local copy from the returned URL.",
+        type: "string"
+      }
+    ],
+    http: {
+      method: "POST",
+      path: "/api/tools/media/video",
+      authRequired: true,
+      body: [
+        { name: "url", source: "argument", from: "url" },
+        { name: "maxHeight", source: "option", from: "maxHeight" },
+        { name: "quality", source: "option", from: "quality" }
+      ]
+    },
+    resultType: "mediaAsset",
+    examples: [
+      "spira media video https://www.tiktok.com/@user/video/123",
+      "spira media video https://www.youtube.com/watch?v=dQw4w9WgXcQ --max-height 1080 --output ./downloads/",
+      "spira media video https://www.youtube.com/shorts/abc123 --quality best"
+    ],
+    relatedCommands: ["spira media info <url>", "spira media thumbnail <url>"]
+  },
+  {
+    path: ["media", "thumbnail"],
+    purpose: "Download the cover image behind a social link.",
+    arguments: [{ name: "url", description: "Public post or video URL.", required: true }],
+    options: [
+      {
+        name: "output",
+        flag: "--output <path>",
+        description: "Also save a local copy from the returned URL.",
+        type: "string"
+      }
+    ],
+    http: {
+      method: "POST",
+      path: "/api/tools/media/thumbnail",
+      authRequired: true,
+      body: [{ name: "url", source: "argument", from: "url" }]
+    },
+    resultType: "mediaAsset",
+    examples: [
+      "spira media thumbnail https://x.com/user/status/123",
+      "spira media thumbnail https://www.facebook.com/watch/?v=123 --output ./cover.jpg"
+    ],
+    relatedCommands: ["spira media info <url>", "spira media video <url>"]
+  },
   {
     path: ["dataBase", "glob"],
     purpose: "List files and folders in your Brand database matching a glob pattern.",
@@ -21871,6 +21959,69 @@ async function executeHttpCommand(input) {
   return successResult(input.command, response.body, response.requestId);
 }
 
+// src/media/save.ts
+var import_node_fs = require("node:fs");
+var import_promises3 = require("node:fs/promises");
+var import_node_path3 = require("node:path");
+var import_node_stream = require("node:stream");
+var import_promises4 = require("node:stream/promises");
+function assetRecord(data) {
+  if (!data || typeof data !== "object") return null;
+  const asset = data.asset;
+  return asset && typeof asset === "object" ? asset : null;
+}
+function fileNameFor(asset) {
+  const key = typeof asset.key === "string" ? (0, import_node_path3.basename)(asset.key) : "";
+  if (key) return key;
+  const fromUrl = typeof asset.url === "string" ? (0, import_node_path3.basename)(new URL(asset.url).pathname) : "";
+  return fromUrl || "download";
+}
+async function isDirectory(path) {
+  return (0, import_promises3.stat)(path).then((entry) => entry.isDirectory()).catch(() => false);
+}
+async function resolveTargetPath(output, asset) {
+  const target = (0, import_node_path3.resolve)(output);
+  const looksLikeDirectory = /[\\/]$/.test(output) || await isDirectory(target);
+  return looksLikeDirectory ? (0, import_node_path3.join)(target, fileNameFor(asset)) : target;
+}
+async function writeAssetToDisk(url2, targetPath) {
+  const response = await fetch(url2);
+  if (!response.ok || !response.body) {
+    throw new Error(`Download failed with status ${response.status}.`);
+  }
+  await (0, import_promises3.mkdir)((0, import_node_path3.dirname)(targetPath), { recursive: true });
+  await (0, import_promises4.pipeline)(
+    import_node_stream.Readable.fromWeb(response.body),
+    (0, import_node_fs.createWriteStream)(targetPath)
+  );
+}
+async function saveMediaAsset(result, output) {
+  if (result.status !== "success") return result;
+  const asset = assetRecord(result.data);
+  const url2 = asset && typeof asset.url === "string" ? asset.url : null;
+  if (!asset || !url2) {
+    return cliResultSchema.parse({
+      ...result,
+      warnings: [...result.warnings, "Response contained no downloadable asset URL; nothing was saved locally."]
+    });
+  }
+  try {
+    const targetPath = await resolveTargetPath(output, asset);
+    await writeAssetToDisk(url2, targetPath);
+    return cliResultSchema.parse({
+      ...result,
+      data: { ...result.data, asset: { ...asset, savedTo: targetPath } },
+      impact: [...result.impact, `Saved to ${targetPath}`]
+    });
+  } catch (error51) {
+    const message = error51 instanceof Error && error51.message ? error51.message : "Unknown error.";
+    return cliResultSchema.parse({
+      ...result,
+      warnings: [...result.warnings, `Could not save the file locally: ${message} The asset URL is still available.`]
+    });
+  }
+}
+
 // src/auth/login.ts
 var import_node_crypto = require("node:crypto");
 
@@ -21884,19 +22035,19 @@ function openBrowser(url2) {
   child.unref();
 }
 function closeServer(server) {
-  return new Promise((resolve) => server.close(() => resolve()));
+  return new Promise((resolve2) => server.close(() => resolve2()));
 }
 function startLoopbackCallbackServer(input) {
   const server = (0, import_node_http.createServer)();
   let timer = null;
   let resolveCallback = null;
   let rejectCallback = null;
-  const callback = new Promise((resolve, reject) => {
-    resolveCallback = resolve;
+  const callback = new Promise((resolve2, reject) => {
+    resolveCallback = resolve2;
     rejectCallback = reject;
   });
   const ready = new Promise(
-    (resolve, reject) => {
+    (resolve2, reject) => {
       timer = setTimeout(() => {
         rejectCallback?.(new Error("Timed out waiting for browser callback."));
         void closeServer(server);
@@ -21923,7 +22074,7 @@ function startLoopbackCallbackServer(input) {
           reject(new Error("Failed to start local CLI callback server."));
           return;
         }
-        resolve({
+        resolve2({
           redirectUri: `http://127.0.0.1:${address.port}/callback`,
           waitForCallback: () => callback,
           close: () => closeServer(server)
@@ -22387,6 +22538,57 @@ function formatAnchor(anchor) {
   }
   return parts.join(", ") || "-";
 }
+function formatMediaDuration(value) {
+  if (typeof value !== "number" || !Number.isFinite(value) || value < 0) return "-";
+  const total = Math.round(value);
+  const hours = Math.floor(total / 3600);
+  const minutes = Math.floor(total % 3600 / 60);
+  const seconds = total % 60;
+  const padded = `${String(minutes).padStart(hours ? 2 : 1, "0")}:${String(seconds).padStart(2, "0")}`;
+  return hours ? `${hours}:${padded}` : padded;
+}
+function renderMediaInfo(data) {
+  const info = objectRecord2(objectRecord2(data).info);
+  const formats = Array.isArray(info.formats) ? info.formats.map(objectRecord2) : [];
+  const lines = [
+    `platform: ${valueToText(info.platform)}`,
+    `title: ${compactText(info.title)}`,
+    `uploader: ${valueToText(info.uploader ?? info.channel)}`,
+    `duration: ${formatMediaDuration(info.duration)}`,
+    `views: ${valueToText(info.view_count)}`,
+    `likes: ${valueToText(info.like_count)}`,
+    `uploadDate: ${valueToText(info.upload_date)}`,
+    `url: ${valueToText(info.webpage_url ?? info.url)}`,
+    `suggestedFilename: ${valueToText(info.suggested_filename)}`
+  ];
+  if (formats.length === 0) return `${lines.join("\n")}
+`;
+  const rows = formats.filter((format) => format.has_video === true).map((format) => ({
+    format_id: format.format_id,
+    ext: format.ext,
+    resolution: format.resolution,
+    fps: format.fps,
+    size: formatByteSize(format.filesize),
+    audio: format.has_audio === true ? "yes" : "no"
+  }));
+  if (rows.length === 0) return `${lines.join("\n")}
+`;
+  return `${lines.join("\n")}
+videoFormats (${rows.length}):
+${renderRows(rows, ["format_id", "ext", "resolution", "fps", "size", "audio"])}`;
+}
+function renderMediaAsset(data) {
+  const asset = objectRecord2(objectRecord2(data).asset);
+  const lines = [
+    `title: ${compactText(asset.title)}`,
+    `size: ${formatByteSize(asset.size)}`,
+    `contentType: ${valueToText(asset.contentType)}`,
+    `url: ${valueToText(asset.url)}`
+  ];
+  if (asset.savedTo) lines.push(`savedTo: ${valueToText(asset.savedTo)}`);
+  return `${lines.join("\n")}
+`;
+}
 function renderDataBaseGlob(data) {
   const record2 = objectRecord2(data);
   const pattern = valueToText(record2.pattern);
@@ -22531,6 +22733,10 @@ function renderSuccess(result) {
         "startedAt",
         "finishedAt"
       ]);
+    case "mediaInfo":
+      return renderMediaInfo(result.data);
+    case "mediaAsset":
+      return renderMediaAsset(result.data);
     case "dataBaseGlob":
       return renderDataBaseGlob(result.data);
     case "dataBaseRead":
@@ -22868,12 +23074,12 @@ function renderCommandIndex() {
 `;
 }
 async function packageVersion() {
-  if ("0.0.9".length > 0) {
-    return "0.0.9";
+  if ("0.0.10".length > 0) {
+    return "0.0.10";
   }
   try {
     const packageUrl = new URL("../package.json", import_meta.url);
-    const pkg = JSON.parse(await (0, import_promises3.readFile)(packageUrl, "utf8"));
+    const pkg = JSON.parse(await (0, import_promises5.readFile)(packageUrl, "utf8"));
     return pkg.version ?? "0.0.0";
   } catch {
     return "0.0.0";
@@ -23090,6 +23296,11 @@ ${url2}
       poll: () => executeHttpCommand({ command: statusCommand, args: { jobId }, options: {} })
     });
   }
+  if (commandKey(definition.path) === "media video" || commandKey(definition.path) === "media thumbnail") {
+    const downloaded = await executeHttpCommand({ command: definition, args, options });
+    if (typeof options.output !== "string" || options.output.length === 0) return downloaded;
+    return saveMediaAsset(downloaded, options.output);
+  }
   return executeHttpCommand({ command: definition, args, options });
 }
 function addLeafCommand(root, definition, output) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spira-lab/cli",
-  "version": "0.0.9",
+  "version": "0.0.10",
   "description": "Command line client for Spira.",
   "type": "module",
   "bin": {