@lazco/cli 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -3,6 +3,19 @@
 All releases of `@lazco/cli` are in this file.
 The newest release is at the top.
 
+## [0.2.0]
+
+### Added
+
+- `lazco labs artifacts publish <path>` and `lazco labs artifacts update <artifact-id> <path>`, and the MCP tools `labs_artifacts_publish` and `labs_artifacts_update`, publish a Lazco Artifact from one HTML or Markdown file, or from a directory with one entry file and the images, CSS and fonts it uses.
+  In a directory, every file or directory whose name starts with a dot is skipped, so a `.env` is never published.
+  The command refuses a file type that an artifact may not hold, more than 100 files, and more than 5 MiB, before it sends anything.
+  An update reads the current version first and sends it as `If-Match`, unless `--if-match` gives it, so a change made since then fails instead of being overwritten.
+
+### Changed
+
+- The browser page that ends an SSO sign-in uses the Lazco design, in the dark theme.
+
 ## [0.1.0]
 
 ### Added

package/README.md

@@ -120,6 +120,21 @@ The command checks the API's limits before it sends anything, uploads only the f
 A failed or interrupted upload cancels the deployment, so the next deploy can start at once.
 `--dry-run` reads the limits and the site, and prints the manifest it would send.
 
+### Publish a Lazco Artifact
+
+```sh
+lazco labs artifacts publish ./report.md --region <region> --title "<title>"
+lazco labs artifacts publish ./report --region <region> --title "<title>"
+lazco labs artifacts update <artifact-id> ./report
+```
+
+The path is one HTML or Markdown file, or a directory with one entry file and the images, CSS and fonts it uses.
+Anyone with the link the answer holds in `url` can open it.
+In a directory, every file or directory whose name starts with a dot is skipped, so a `.env` is never published.
+The command refuses a file type a publish may not hold, more than 100 files and more than 5 MiB before it sends anything.
+The answer's `warnings` lists what the page loads from outside, misses or runs, which will not work.
+An update reads the current version first and sends it as `If-Match`, unless `--if-match` gives it, so a change made since then fails instead of being overwritten.
+
 ## Use it from an MCP client
 
 `lazco mcp` is a local MCP server with the same sign-in, and it renews an SSO sign-in as it runs.

package/dist/cli.js

@@ -17,7 +17,7 @@ async function readAll(stream) {
 // package.json
 var package_default = {
   name: "@lazco/cli",
-  version: "0.1.0",
+  version: "0.2.0",
   description: "Lazco Cloud CLI and local MCP server",
   type: "module",
   license: "MIT",
@@ -1110,11 +1110,37 @@ var LOOPBACK_TIMEOUT_MS = 10 * 60 * 1000;
 var CALLBACK_PATH = "/callback";
 var DONE_PAGE = `<!doctype html>
 <html lang="en">
-<head><meta charset="utf-8"><title>Lazco CLI</title></head>
-<body style="font-family: system-ui, sans-serif; margin: 3rem auto; max-width: 32rem; line-height: 1.6">
-<h1 style="font-size: 1.25rem">Return to your terminal</h1>
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="color-scheme" content="dark">
+<title>Lazco CLI</title>
+<style>
+:root{--ground:#08090a;--panel:#101112;--ink:#e8eaec;--ink-2:#c3c8cc;--faint:#858c92;--line:rgba(255,255,255,.07);--brand-fill:#40b7f3;--shadow-2:inset 0 1px 0 0 rgba(255,255,255,.03),inset 0 0 0 1px rgba(255,255,255,.05),0 1px 1px -.5px rgba(0,0,0,.18)}
+*{box-sizing:border-box}
+html,body{margin:0}
+body{min-height:100vh;display:grid;place-items:center;padding:24px;background:var(--ground);color:var(--ink-2);font-family:'Noto Sans TC','PingFang TC','Microsoft JhengHei',-apple-system,'Segoe UI',Roboto,'Helvetica Neue',Arial,sans-serif;font-size:14px;line-height:1.5;-webkit-font-smoothing:antialiased}
+main{width:100%;max-width:26rem;padding:28px;background:var(--panel);border-radius:10px;box-shadow:var(--shadow-2)}
+.mark{display:flex;align-items:center;gap:8px;margin:0 0 20px;color:var(--faint);font-size:11.5px;font-weight:600}
+.mark::before{content:"";width:8px;height:8px;border-radius:50%;background:var(--brand-fill)}
+h1{margin:0 0 6px;color:var(--ink);font-size:24px;line-height:1.25;font-weight:650;letter-spacing:-.01em}
+.title{margin:0 0 6px;color:var(--ink);font-size:16px;line-height:1.25;font-weight:600}
+p{margin:0}
+hr{margin:20px 0;border:0;border-top:1px solid var(--line)}
+@media (max-width:640px){h1{font-size:26px}.title{font-size:17px}.mark{font-size:12.5px}}
+</style>
+</head>
+<body>
+<main>
+<p class="mark">Lazco CLI</p>
+<h1>Return to your terminal</h1>
 <p>The Lazco CLI got the answer from your browser. You can close this tab.</p>
-<p lang="zh-Hant-TW">請回到終端機。Lazco CLI 已經收到瀏覽器的回應，你可以關閉這個分頁。</p>
+<hr>
+<div lang="zh-Hant-TW">
+<p class="title">請回到終端機</p>
+<p>Lazco CLI 已經收到瀏覽器的回應，你可以關閉這個分頁。</p>
+</div>
+</main>
 </body>
 </html>
 `;
@@ -2112,8 +2138,28 @@ var PAGES_DEPLOYMENT_INPUT = {
     "When the call ends before the deployment does, the deployment goes on: read it with the deployment read tool."
   ]
 };
+var ARTIFACT_PATH_INPUT = "path";
+var ARTIFACT_FILES_INPUT = "files";
+var ARTIFACT_INPUT = {
+  properties: {
+    [ARTIFACT_PATH_INPUT]: {
+      type: "string",
+      minLength: 1,
+      description: "The local file or directory to publish, in place of files. A directory is read with every file below it, and every file or directory whose name starts with a dot is skipped. A relative path is resolved against the working directory, and the MCP tool takes an absolute path only."
+    }
+  },
+  required: [],
+  positionals: [ARTIFACT_PATH_INPUT],
+  toolNotes: [
+    "Publishes content that anyone with the link can open. Only publish what the user asked to publish.",
+    "Give either path, an absolute path of a local file or directory, or files, for content that is not in a file, such as one Markdown or HTML document. Never both.",
+    "The answer holds url, the permanent link, and warnings: what the page loads from outside, misses or runs, which will not work."
+  ],
+  fills: [ARTIFACT_FILES_INPUT]
+};
 var KNOWN_UPLOADERS = new Map([
-  ["pages-deployment", PAGES_DEPLOYMENT_INPUT]
+  ["pages-deployment", PAGES_DEPLOYMENT_INPUT],
+  ["artifact", ARTIFACT_INPUT]
 ]);
 var COMMAND_WORD = "[a-z0-9][a-z0-9-]*";
 var ANNOTATION_SCHEMA = {
@@ -2447,7 +2493,7 @@ function buildOperation(document, path, method, source, annotation, pathLevelPar
       description: "The ETag of the version this change is based on, sent as If-Match. Without it, the current ETag is read first."
     };
   }
-  const body = uploader === undefined ? mergeBody(document, source, properties, required) : addUploaderInput(annotation.upload, uploader, properties, required);
+  const body = uploader === undefined ? mergeBody(document, source, properties, required) : addUploaderInput(document, source, annotation.upload, uploader, properties, required);
   let resolved;
   try {
     resolved = resolveReferences(document, {
@@ -2505,7 +2551,23 @@ function withoutQuoteInputs(schema, mapping, parameters) {
     required: required.filter((name) => !QUOTE_INPUTS.includes(name))
   };
 }
-function addUploaderInput(name, uploader, properties, required) {
+function addUploaderInput(document, source, name, uploader, properties, required) {
+  const bodyInputs = [];
+  if (uploader.fills !== undefined) {
+    const before = new Set(Object.keys(properties));
+    const merged = mergeBody(document, source, properties, required);
+    bodyInputs.push(...Object.keys(properties).filter((property) => !before.has(property)));
+    const missing = uploader.fills.filter((property) => !bodyInputs.includes(property));
+    if (merged.mapping.mode !== "merged" || missing.length > 0) {
+      throw new SkipError("unsupported-body", `the uploader "${name}" needs a JSON object body with ${uploader.fills.join(", ")}`);
+    }
+    for (const property of uploader.fills) {
+      const index = required.indexOf(property);
+      if (index !== -1) {
+        required.splice(index, 1);
+      }
+    }
+  }
   for (const [property, schema] of Object.entries(uploader.properties)) {
     if (Object.hasOwn(properties, property)) {
       throw new SkipError("unsupported-parameter", `the parameter "${property}" clashes with an input of the uploader "${name}"`);
@@ -2513,7 +2575,7 @@ function addUploaderInput(name, uploader, properties, required) {
     properties[property] = { ...schema };
   }
   required.push(...uploader.required);
-  return { mapping: { mode: "upload", uploader: name }, additionalProperties: false };
+  return { mapping: { mode: "upload", uploader: name, bodyInputs }, additionalProperties: false };
 }
 function collectParameters(document, ...lists) {
   const byKey = new Map;
@@ -2992,13 +3054,9 @@ async function walkPages(operation, input, prepare, context, onPage) {
   }
 }
 
-// src/uploads/interrupted.ts
-class Interrupted extends Error {
-  constructor() {
-    super("Interrupted");
-    this.name = "Interrupted";
-  }
-}
+// src/uploads/artifacts/files.ts
+import { lstat as lstat2, readdir as readdir2, readFile as readFile4, realpath as realpath3, stat as stat2 } from "node:fs/promises";
+import nodePath2 from "node:path";
 
 // src/uploads/pages/directory.ts
 import { lstat, open, readdir, realpath as realpath2, stat } from "node:fs/promises";
@@ -3128,6 +3186,256 @@ async function walkSiteDirectory(root) {
   return { files, skipped };
 }
 
+// src/uploads/artifacts/files.ts
+var MAX_ARTIFACT_BYTES = 5 * 1024 * 1024;
+var MAX_ARTIFACT_FILES = 100;
+var ENCODING_BY_EXTENSION = new Map([
+  [".html", "utf-8"],
+  [".htm", "utf-8"],
+  [".md", "utf-8"],
+  [".css", "utf-8"],
+  [".svg", "utf-8"],
+  [".png", "base64"],
+  [".jpg", "base64"],
+  [".jpeg", "base64"],
+  [".gif", "base64"],
+  [".webp", "base64"],
+  [".avif", "base64"],
+  [".woff2", "base64"],
+  [".woff", "base64"]
+]);
+function invalid4(message, details) {
+  return new CliError("CLI_INVALID_INPUT", message, details);
+}
+function encodingOf(path) {
+  return ENCODING_BY_EXTENSION.get(nodePath2.posix.extname(path).toLowerCase());
+}
+function mebibytes(bytes) {
+  return `${(bytes / 1048576).toFixed(1)} MiB`;
+}
+function checkArtifactLimits(files, field) {
+  const unknownType = files.filter((file) => encodingOf(file.path) === undefined);
+  if (unknownType.length > 0) {
+    throw invalid4(`A publish holds only HTML, Markdown, CSS, images and fonts, so ${unknownType.map((file) => file.path).join(", ")} cannot be published`, {
+      field,
+      files: unknownType.map((file) => file.path),
+      allowed: [...ENCODING_BY_EXTENSION.keys()]
+    });
+  }
+  if (files.length > MAX_ARTIFACT_FILES) {
+    throw invalid4(`A publish holds at most ${MAX_ARTIFACT_FILES} files, and this one has ${files.length}`, { field, files: files.length, limit: MAX_ARTIFACT_FILES });
+  }
+  const totalBytes = files.reduce((sum, file) => sum + file.size, 0);
+  if (totalBytes > MAX_ARTIFACT_BYTES) {
+    throw invalid4(`A publish holds at most ${mebibytes(MAX_ARTIFACT_BYTES)}, and this one has ${mebibytes(totalBytes)}`, { field, bytes: totalBytes, limit: MAX_ARTIFACT_BYTES });
+  }
+}
+function decodedSize(file) {
+  return file.encoding === "base64" ? Buffer.from(file.content, "base64").length : Buffer.byteLength(file.content, "utf8");
+}
+async function readLocalArtifact(localPath, options) {
+  const problem = (message) => invalid4(message, [{ field: ARTIFACT_PATH_INPUT, message }]);
+  if (options.requireAbsolute && !nodePath2.isAbsolute(localPath)) {
+    throw problem(`path must be an absolute path, because the working directory of the MCP server is the client's choice: ${localPath}`);
+  }
+  const given = nodePath2.resolve(options.workingDirectory, localPath);
+  let root;
+  let info;
+  try {
+    root = await realpath3(given);
+    info = await stat2(root);
+  } catch {
+    throw problem(`${given} does not exist or cannot be read`);
+  }
+  if (info.isFile()) {
+    const files = [{ path: nodePath2.basename(root), absolutePath: root, size: info.size }];
+    checkArtifactLimits(files, ARTIFACT_PATH_INPUT);
+    return { root, files, skipped: [] };
+  }
+  if (!info.isDirectory()) {
+    throw problem(`${given} is not a file or a directory`);
+  }
+  if (isFilesystemRoot(root)) {
+    throw problem(`${given} is a filesystem root, which is never published`);
+  }
+  const home = await realpath3(options.homeDirectory).catch(() => {
+    return;
+  });
+  if (home !== undefined && (root === home || holds(root, home, nodePath2))) {
+    throw problem(`${given} is or holds the home directory, which is never published`);
+  }
+  const { files, skipped } = await walkArtifactDirectory(root);
+  checkArtifactLimits(files, ARTIFACT_PATH_INPUT);
+  return { root, files, skipped };
+}
+async function walkArtifactDirectory(root) {
+  const files = [];
+  const skipped = [];
+  const pathInArtifact = (absolutePath) => nodePath2.relative(root, absolutePath).split(nodePath2.sep).join("/");
+  const unreadable = (path, error) => invalid4(`${path || "."} could not be read`, {
+    path: path || ".",
+    cause: error instanceof Error ? error.message : String(error)
+  });
+  const visit = async (directory) => {
+    let names;
+    try {
+      names = (await readdir2(directory)).sort();
+    } catch (error) {
+      throw unreadable(pathInArtifact(directory), error);
+    }
+    for (const name of names) {
+      const absolutePath = nodePath2.join(directory, name);
+      const path = pathInArtifact(absolutePath);
+      if (name.startsWith(".")) {
+        skipped.push(path);
+        continue;
+      }
+      let entry;
+      try {
+        entry = await lstat2(absolutePath);
+      } catch (error) {
+        throw unreadable(path, error);
+      }
+      if (entry.isSymbolicLink()) {
+        throw invalid4(`${path} is a link. A publish never follows a link, so remove it first`, {
+          path
+        });
+      }
+      if (entry.isDirectory()) {
+        await visit(absolutePath);
+      } else if (entry.isFile()) {
+        files.push({ path, absolutePath, size: entry.size });
+        if (files.length > MAX_ARTIFACT_FILES) {
+          throw invalid4(`A publish holds at most ${MAX_ARTIFACT_FILES} files, and ${root} has more`, { field: ARTIFACT_PATH_INPUT, files: files.length, limit: MAX_ARTIFACT_FILES });
+        }
+      } else {
+        throw invalid4(`${path} is not a file or a directory, so it cannot be published`, {
+          path
+        });
+      }
+    }
+  };
+  await visit(root);
+  if (files.length === 0) {
+    throw invalid4(`${root} holds no file to publish${skipped.length > 0 ? ` (${skipped.length} skipped)` : ""}`, [{ field: ARTIFACT_PATH_INPUT, message: "holds no file to publish" }]);
+  }
+  files.sort((left, right) => left.path < right.path ? -1 : left.path > right.path ? 1 : 0);
+  return { files, skipped };
+}
+async function encodeArtifactFiles(files) {
+  const decoder = new TextDecoder("utf-8", { fatal: true });
+  return Promise.all(files.map(async (file) => {
+    const bytes = await readFile4(file.absolutePath);
+    const encoding = encodingOf(file.path);
+    if (encoding === "base64") {
+      return { path: file.path, encoding, content: bytes.toString("base64") };
+    }
+    try {
+      return { path: file.path, encoding, content: decoder.decode(bytes) };
+    } catch {
+      throw invalid4(`${file.path} is not valid UTF-8, so it cannot be published as text`, {
+        field: ARTIFACT_PATH_INPUT,
+        path: file.path
+      });
+    }
+  }));
+}
+function checkGivenFiles(files) {
+  checkArtifactLimits(files.map((file) => ({ path: file.path, size: decodedSize(file) })), ARTIFACT_FILES_INPUT);
+}
+
+// src/uploads/artifact.ts
+var SKIPPED_NAMED = 5;
+function mebibytes2(bytes) {
+  return `${(bytes / 1048576).toFixed(1)} MiB`;
+}
+async function artifactFiles(context) {
+  const localPath = context.input[ARTIFACT_PATH_INPUT];
+  const given = context.input[ARTIFACT_FILES_INPUT];
+  if (localPath === undefined === (given === undefined)) {
+    const message = `Give either ${ARTIFACT_PATH_INPUT}, a local file or directory, or ${ARTIFACT_FILES_INPUT}, and not both`;
+    throw new CliError("CLI_INVALID_INPUT", message, [
+      { field: ARTIFACT_PATH_INPUT, message },
+      { field: ARTIFACT_FILES_INPUT, message }
+    ]);
+  }
+  if (localPath === undefined) {
+    const files = given;
+    checkGivenFiles(files);
+    return files;
+  }
+  const local = await readLocalArtifact(String(localPath), {
+    workingDirectory: context.workingDirectory,
+    homeDirectory: context.homeDirectory,
+    requireAbsolute: context.requireAbsolutePaths
+  });
+  const totalBytes = local.files.reduce((sum, file) => sum + file.size, 0);
+  const named = local.skipped.slice(0, SKIPPED_NAMED).join(", ");
+  const more = local.skipped.length > SKIPPED_NAMED ? ", ..." : "";
+  context.progress(`found ${local.files.length} file${local.files.length === 1 ? "" : "s"} (${mebibytes2(totalBytes)}) in ${local.root}${local.skipped.length > 0 ? `, skipped ${local.skipped.length}: ${named}${more}` : ""}`);
+  return encodeArtifactFiles(local.files);
+}
+async function publishArtifact(context) {
+  const { client, operation, signal } = context;
+  if (operation.body.mode !== "upload") {
+    throw new CliError("CLI_INTERNAL", `${operation.operationId} is not an upload`);
+  }
+  const files = await artifactFiles(context);
+  const body = {};
+  for (const property of operation.body.bodyInputs) {
+    if (context.input[property] !== undefined) {
+      body[property] = context.input[property];
+    }
+  }
+  body[ARTIFACT_FILES_INPUT] = files;
+  const request = { ...context.request, body };
+  if (context.dryRun) {
+    const preview = {
+      ...body,
+      files: files.map(({ content, ...file }) => ({ ...file, contentLength: content.length }))
+    };
+    return {
+      dryRun: true,
+      method: request.method,
+      url: client.url(request),
+      headers: client.publicHeaders({ headers: request.headers, body: preview }),
+      body: preview,
+      ...operation.annotation.concurrency === "etag" && request.headers?.["If-Match"] === undefined ? {
+        ifMatchFrom: {
+          method: "GET",
+          url: client.url({ path: request.path }),
+          headers: { "Accept-Encoding": ETAG_READ_ENCODING }
+        }
+      } : {}
+    };
+  }
+  if (signal.aborted) {
+    throw new CliError("CLI_TASK_FAILED", "Interrupted before the publish. Nothing was changed", {
+      interrupted: true
+    });
+  }
+  context.progress(`sending ${files.length} file${files.length === 1 ? "" : "s"}`);
+  const answer = await executeOperation(operation, request, { client, clock: context.clock }, { wait: false, timeoutSeconds: context.timeoutSeconds });
+  if (answer === null || typeof answer !== "object" || Array.isArray(answer)) {
+    throw new CliError("CLI_BAD_RESPONSE", "The API answered the publish with no object", {
+      answer
+    });
+  }
+  const warnings = answer.warnings;
+  if (Array.isArray(warnings) && warnings.length > 0) {
+    context.progress(`warning: ${warnings.length} thing${warnings.length === 1 ? "" : "s"} in the content will not work, see warnings in the answer`);
+  }
+  return answer;
+}
+
+// src/uploads/interrupted.ts
+class Interrupted extends Error {
+  constructor() {
+    super("Interrupted");
+    this.name = "Interrupted";
+  }
+}
+
 // src/uploads/pages/finalize.ts
 var POLL_INTERVAL_MS = 5000;
 var SUCCEEDED = new Set(["live", "superseded"]);
@@ -3205,7 +3513,7 @@ async function waitForDeployment(options) {
 
 // src/uploads/pages/manifest.ts
 import { createHash as createHash3 } from "node:crypto";
-import { readFile as readFile4 } from "node:fs/promises";
+import { readFile as readFile5 } from "node:fs/promises";
 
 // src/uploads/pages/rules.ts
 var LIMIT_NAMES = ["fileBytes", "totalBytes", "fileCount", "textBytes"];
@@ -3298,7 +3606,7 @@ function sha256Hex2(bytes) {
 async function readSiteFile(file) {
   let bytes;
   try {
-    bytes = await readFile4(file.absolutePath);
+    bytes = await readFile5(file.absolutePath);
   } catch (error) {
     throw new CliError("CLI_INVALID_INPUT", `${file.path} could not be read`, {
       path: file.path,
@@ -3662,7 +3970,7 @@ async function uploadFiles(options) {
 
 // src/uploads/pagesDeployment.ts
 var PROGRESS_INTERVAL_MS = 1000;
-var SKIPPED_NAMED = 5;
+var SKIPPED_NAMED2 = 5;
 function badResponse2(message) {
   return new CliError("CLI_BAD_RESPONSE", message);
 }
@@ -3694,7 +4002,7 @@ function parseStart(body) {
     }
   };
 }
-function mebibytes(bytes) {
+function mebibytes3(bytes) {
   return `${(bytes / 1048576).toFixed(1)} MiB`;
 }
 function throttled(context) {
@@ -3740,9 +4048,9 @@ async function deployPagesSite(context) {
     const walk = await walkSiteDirectory(root);
     files = walk.files;
     totalBytes = files.reduce((sum, file) => sum + file.size, 0);
-    const named = walk.skipped.slice(0, SKIPPED_NAMED).join(", ");
-    const more = walk.skipped.length > SKIPPED_NAMED ? ", ..." : "";
-    context.progress(`found ${files.length} files (${mebibytes(totalBytes)}) in ${root}${walk.skipped.length > 0 ? `, skipped ${walk.skipped.length}: ${named}${more}` : ""}`);
+    const named = walk.skipped.slice(0, SKIPPED_NAMED2).join(", ");
+    const more = walk.skipped.length > SKIPPED_NAMED2 ? ", ..." : "";
+    context.progress(`found ${files.length} files (${mebibytes3(totalBytes)}) in ${root}${walk.skipped.length > 0 ? `, skipped ${walk.skipped.length}: ${named}${more}` : ""}`);
     checkLimits(files, rules);
     const hashProgress = throttled(context);
     manifest = await buildManifest(files, rules, {
@@ -3799,7 +4107,7 @@ async function deployPagesSite(context) {
       context.progress("warning: the API sent no Date header, so the upload window is timed by the local clock");
     }
     const uploadBytes = start.uploads.reduce((sum, upload) => sum + (byPath.get(upload.path)?.size ?? 0), 0);
-    context.progress(`uploading ${start.uploads.length} files (${mebibytes(uploadBytes)}) to the deployment ${deployment.id}, ${files.length - start.uploads.length} unchanged`);
+    context.progress(`uploading ${start.uploads.length} files (${mebibytes3(uploadBytes)}) to the deployment ${deployment.id}, ${files.length - start.uploads.length} unchanged`);
     const uploadProgress = throttled(context);
     const uploaded = await uploadFiles({
       uploads: start.uploads,
@@ -3824,7 +4132,7 @@ async function deployPagesSite(context) {
       fetch: context.storageFetch,
       clock: context.clock,
       signal,
-      onUploaded: (progress) => uploadProgress(`uploaded ${progress.files} of ${start.uploads.length} files (${mebibytes(progress.bytes)})`, progress.files === start.uploads.length)
+      onUploaded: (progress) => uploadProgress(`uploaded ${progress.files} of ${start.uploads.length} files (${mebibytes3(progress.bytes)})`, progress.files === start.uploads.length)
     });
     signal.throwIfAborted();
     context.progress(`finalizing the deployment ${deployment.id}`);
@@ -3894,7 +4202,8 @@ async function cancelDeployment(context, deploymentPath, deploymentId) {
 
 // src/uploads/registry.ts
 var UPLOADERS = new Map([
-  ["pages-deployment", deployPagesSite]
+  ["pages-deployment", deployPagesSite],
+  ["artifact", publishArtifact]
 ]);
 
 // src/mcp/tools.ts
@@ -4943,7 +5252,7 @@ var BY_NAME = new Map(GLOBAL_FLAGS.map((flag) => [flag.name, flag]));
 function isGlobalFlagName(name) {
   return BY_NAME.has(name);
 }
-function invalid4(message, field) {
+function invalid5(message, field) {
   return new CliError("CLI_INVALID_INPUT", message, [{ field, message }]);
 }
 function extractGlobalFlags(argv) {
@@ -4969,17 +5278,17 @@ function extractGlobalFlags(argv) {
     const inline = match[2];
     if (!spec.takesValue) {
       if (inline !== undefined) {
-        throw invalid4(`--${spec.name} takes no value`, spec.name);
+        throw invalid5(`--${spec.name} takes no value`, spec.name);
       }
       switches.add(spec.name);
       continue;
     }
     if (values.has(spec.name)) {
-      throw invalid4(`--${spec.name} is given twice`, spec.name);
+      throw invalid5(`--${spec.name} is given twice`, spec.name);
     }
     const value = inline ?? argv[index + 1];
     if (value === undefined) {
-      throw invalid4(`--${spec.name} needs a value`, spec.name);
+      throw invalid5(`--${spec.name} needs a value`, spec.name);
     }
     if (inline === undefined) {
       index += 1;
@@ -4987,14 +5296,14 @@ function extractGlobalFlags(argv) {
     values.set(spec.name, value);
   }
   if (switches.has("wait") && switches.has("no-wait")) {
-    throw invalid4("--wait and --no-wait cannot both be given", "wait");
+    throw invalid5("--wait and --no-wait cannot both be given", "wait");
   }
   let timeoutSeconds = DEFAULT_WAIT_SECONDS;
   const timeout = values.get("timeout");
   if (timeout !== undefined) {
     timeoutSeconds = Number(timeout);
     if (!/^\d+$/.test(timeout) || timeoutSeconds < 1) {
-      throw invalid4("--timeout must be a whole number of seconds, 1 or more", "timeout");
+      throw invalid5("--timeout must be a whole number of seconds, 1 or more", "timeout");
     }
   }
   const fields = values.get("fields");
@@ -5106,7 +5415,7 @@ function coerce(kind, text) {
   }
   return text;
 }
-function invalid5(message, problems) {
+function invalid6(message, problems) {
   return new CliError("CLI_INVALID_INPUT", message, problems);
 }
 function parsePayload(text) {
@@ -5114,12 +5423,12 @@ function parsePayload(text) {
   try {
     value = JSON.parse(text);
   } catch (error) {
-    throw invalid5("--json is not valid JSON", [
+    throw invalid6("--json is not valid JSON", [
       { field: "json", message: error instanceof Error ? error.message : "is not valid JSON" }
     ]);
   }
   if (value === null || typeof value !== "object" || Array.isArray(value)) {
-    throw invalid5("--json must be one JSON object", [
+    throw invalid6("--json must be one JSON object", [
       { field: "json", message: "must be an object" }
     ]);
   }
@@ -5201,7 +5510,7 @@ function buildInput(options) {
     }
   }
   if (problems.length > 0) {
-    throw invalid5("The arguments are not valid", problems);
+    throw invalid6("The arguments are not valid", problems);
   }
   return { ...options.payload, ...fromArguments };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lazco/cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Lazco Cloud CLI and local MCP server",
   "type": "module",
   "license": "MIT",