@integrity-labs/agt-cli 0.28.138 → 0.28.140

package/dist/mcp/index.js

@@ -6798,6 +6798,11 @@ var require_dist = __commonJS({
   }
 });
 
+// src/index.ts
+import { mkdtemp, writeFile } from "fs/promises";
+import { tmpdir } from "os";
+import { basename, join as join3 } from "path";
+
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/external.js
 var external_exports = {};
 __export(external_exports, {
@@ -23052,6 +23057,7 @@ var LOCAL_TOOL_NAMES = /* @__PURE__ */ new Set([
   "artefacts_list",
   "artefacts_get",
   "artefacts_get_source_chunk",
+  "artefacts_download",
   // ADR-0017 Projects container (the reclaimed projects_* namespace). Read tools
   // shipped in v1; ENG-6769 adds agent-initiated create + post-creation tagging
   // of artefacts/tasks to a project. No projects_get_source_chunk — a project is
@@ -23193,6 +23199,92 @@ server.tool(
     ]
   })
 );
+var ARTEFACT_DOWNLOAD_MAX_ITEMS = 50;
+function safeDownloadName(name, fallback) {
+  const base = basename(name).replace(/[^a-zA-Z0-9._-]/g, "_").replace(/^\.+/, "");
+  return base.length > 0 ? base : fallback;
+}
+async function exportArtefactToFile(dir, artefactId, format, item) {
+  const data = await apiPost(`/host/artefact/${encodeURIComponent(artefactId)}/export`, {
+    agent_id: AGT_AGENT_ID,
+    format,
+    item
+  });
+  const fallback = `${artefactId}${item !== void 0 ? `-item-${item + 1}` : ""}.${format}`;
+  const filePath = join3(dir, safeDownloadName(data.filename, fallback));
+  const buf = Buffer.from(data.base64, "base64");
+  await writeFile(filePath, buf);
+  return { path: filePath, bytes: buf.length, contentType: data.content_type, version: data.version };
+}
+async function resolveItemCountForPng(artefactId) {
+  try {
+    const meta = await apiPost(`/host/published-artefact/${encodeURIComponent(artefactId)}`, { agent_id: AGT_AGENT_ID });
+    const manifest = meta.artefact?.metadata?.manifest;
+    if (manifest?.hasItems && typeof manifest.itemCount === "number" && manifest.itemCount > 1) {
+      return { count: Math.min(manifest.itemCount, ARTEFACT_DOWNLOAD_MAX_ITEMS), total: manifest.itemCount };
+    }
+  } catch {
+  }
+  return { count: 1, total: 1 };
+}
+async function downloadArtefactText(params) {
+  const dir = await mkdtemp(join3(tmpdir(), "augmented-artefact-"));
+  let items;
+  let truncatedFrom = null;
+  if (params.format === "pdf") {
+    items = [void 0];
+  } else if (params.item === void 0) {
+    const { count, total } = await resolveItemCountForPng(params.artefact_id);
+    if (count > 1) {
+      items = Array.from({ length: count }, (_, i) => i);
+      if (total > count) truncatedFrom = total;
+    } else {
+      items = [void 0];
+    }
+  } else {
+    items = [params.item];
+  }
+  const saved = [];
+  let contentType = "";
+  let version2 = 0;
+  for (const item of items) {
+    const r = await exportArtefactToFile(dir, params.artefact_id, params.format, item);
+    saved.push({ path: r.path, bytes: r.bytes });
+    contentType = r.contentType;
+    version2 = r.version;
+  }
+  const fmt = params.format.toUpperCase();
+  if (saved.length === 1) {
+    const kb = Math.max(1, Math.round(saved[0].bytes / 1024));
+    return [
+      `Downloaded the artefact as ${fmt} (${kb} KB, v${version2}).`,
+      `Saved to: ${saved[0].path}`,
+      `Content-Type: ${contentType}`,
+      "You can now attach or upload this file (e.g. send it over a channel)."
+    ].join("\n");
+  }
+  const totalKb = Math.max(1, Math.round(saved.reduce((s, f) => s + f.bytes, 0) / 1024));
+  const header = truncatedFrom ? `Downloaded the first ${saved.length} of ${truncatedFrom} items as separate ${fmt} files (${totalKb} KB total, v${version2}). To get a later page, call again with its item index:` : `Downloaded ${saved.length} items as separate ${fmt} files (${totalKb} KB total, v${version2}):`;
+  return [
+    header,
+    ...saved.map((f) => `- ${f.path}`),
+    "You can now attach or upload these files (e.g. send them over a channel)."
+  ].join("\n");
+}
+server.tool(
+  "artefacts_download",
+  "Download a published artefact as a PDF or image (PNG) file(s) on this host, returning the saved file path(s) so you can attach, upload, or send them. pdf gives one multi-page document (one page per carousel item). png with an item index gives that single page. png with NO item index gives one PNG per item for a multi-item carousel (or a single PNG for a one-item artefact). Video downloads are not supported yet (tracked in ENG-6776).",
+  {
+    artefact_id: external_exports.string().uuid().describe("The artefact id returned by artefacts_list"),
+    format: external_exports.enum(["pdf", "png"]).describe('Output format: "pdf" (carousel document) or "png" (image)'),
+    item: external_exports.number().int().min(0).optional().describe(
+      "For a carousel, the 0-based page index to export as a single PNG. Omit to get one PNG per item (png) or the full multi-page document (pdf)."
+    )
+  },
+  async (params) => ({
+    content: [{ type: "text", text: await downloadArtefactText(params) }]
+  })
+);
 async function listProjectsText(params) {
   const data = await apiPost("/host/my-projects", {
     agent_id: AGT_AGENT_ID,

package/dist/{persistent-session-SVZCOP7I.js → persistent-session-BRGQGGZY.js}

@@ -34,8 +34,8 @@ import {
   writeDirectChatSessionState,
   writeEgressAllowlist,
   writePersistentClaudeWrapper
-} from "./chunk-NGES4EZD.js";
-import "./chunk-ROOFBKRE.js";
+} from "./chunk-6GNDRA3F.js";
+import "./chunk-WI6HYZ7K.js";
 import "./chunk-XWVM4KPK.js";
 export {
   EGRESS_BASELINE_DOMAINS,
@@ -74,4 +74,4 @@ export {
   writeEgressAllowlist,
   writePersistentClaudeWrapper
 };
-//# sourceMappingURL=persistent-session-SVZCOP7I.js.map
+//# sourceMappingURL=persistent-session-BRGQGGZY.js.map

package/dist/{responsiveness-probe-AS7ASMDE.js → responsiveness-probe-RZYQMCM3.js}

@@ -1,7 +1,7 @@
 import {
   paneLogPath
-} from "./chunk-NGES4EZD.js";
-import "./chunk-ROOFBKRE.js";
+} from "./chunk-6GNDRA3F.js";
+import "./chunk-WI6HYZ7K.js";
 import "./chunk-XWVM4KPK.js";
 
 // src/lib/responsiveness-probe.ts
@@ -304,4 +304,4 @@ export {
   readAndResetChannelDeflections,
   readAndResetChannelLaneClassifications
 };
-//# sourceMappingURL=responsiveness-probe-AS7ASMDE.js.map
+//# sourceMappingURL=responsiveness-probe-RZYQMCM3.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@integrity-labs/agt-cli",
-  "version": "0.28.138",
+  "version": "0.28.140",
   "description": "Augmented Team CLI — agent provisioning and management",
   "type": "module",
   "engines": {