@withpica/mcp-server 1.3.0

package/dist/apps/upload.js

@@ -0,0 +1,280 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+/**
+ * pica_upload MCP App card — generic drop zone.
+ *
+ * Renders a drop zone + file input, instantiates createUploadManager() from
+ * shared.ts, and reports uploaded file metadata back to the agent via
+ * app.updateModelContext() once all files have settled.
+ *
+ * DOM API only — never innerHTML.
+ */
+import { buildAppHtml } from "./shared.js";
+const UPLOAD_BODY = `
+<div class="stack gap-6">
+  <header>
+    <h1 class="heading heading-lg" id="up-title">upload files</h1>
+    <p class="text-secondary" id="up-subtitle">drop files here or click to browse</p>
+  </header>
+
+  <section>
+    <div id="up-dropzone" class="up-dropzone">
+      <p class="text-secondary" id="up-dropzone-label">drop files here or click to browse</p>
+      <input type="file" id="up-input" multiple style="display: none;" />
+    </div>
+    <div id="up-thumbnails" class="up-thumbnails"></div>
+    <p class="text-tertiary" id="up-max-msg" style="margin-top: 8px; display: none;"></p>
+    <p class="text-tertiary" id="up-status" style="margin-top: 12px; display: none;"></p>
+  </section>
+</div>
+
+<style>
+.up-dropzone {
+  background: rgba(255,255,255,0.03);
+  border: 1px dashed rgba(255,255,255,0.15);
+  border-radius: 12px;
+  padding: 64px 24px;
+  text-align: center;
+  cursor: pointer;
+  transition: background 0.15s, border-color 0.15s;
+}
+.up-dropzone.dragover {
+  background: rgba(184,115,51,0.05);
+  border-color: var(--accent);
+}
+.up-thumbnails {
+  display: flex;
+  gap: 12px;
+  flex-wrap: wrap;
+  margin-top: 16px;
+}
+.up-thumb {
+  position: relative;
+  min-width: 120px;
+  max-width: 180px;
+  padding: 12px;
+  border-radius: 8px;
+  border: 1px solid var(--card-border);
+  background: rgba(255,255,255,0.03);
+  font-size: 12px;
+}
+.up-thumb-filename {
+  color: var(--text-primary);
+  word-break: break-all;
+  margin-bottom: 4px;
+}
+.up-thumb-state {
+  color: var(--text-tertiary);
+  font-size: 11px;
+}
+.up-thumb-state-failed { border-color: rgba(255,80,80,0.5); }
+.up-thumb-state-network_error { border-color: rgba(255,165,0,0.4); }
+.up-thumb-state-uploaded { border-color: rgba(135,169,107,0.5); }
+.up-thumb-remove {
+  position: absolute; top: 4px; right: 4px;
+  width: 18px; height: 18px; border-radius: 50%;
+  background: rgba(0,0,0,0.6);
+  color: white; font-size: 11px; border: none; cursor: pointer;
+  display: flex; align-items: center; justify-content: center;
+}
+@media (max-width: 600px) {
+  .up-dropzone { padding: 40px 16px; }
+}
+</style>
+`;
+const UPLOAD_JS = `
+var upState = {
+  config: { accept: "any", purpose: null, max_files: null },
+  manager: null,
+  reported: false,
+};
+
+function upAcceptToAttr(accept) {
+  switch (accept) {
+    case "image": return "image/*";
+    case "audio": return "audio/*";
+    case "video": return "video/*";
+    case "document": return ".pdf,.doc,.docx,.txt,.csv,.xls,.xlsx,.rtf,.md";
+    default: return "";
+  }
+}
+
+function upRender(files) {
+  var container = document.getElementById("up-thumbnails");
+  if (!container) return;
+  container.textContent = "";
+
+  files.forEach(function (f) {
+    var thumb = document.createElement("div");
+    thumb.className = "up-thumb up-thumb-state-" + f.state;
+
+    var name = document.createElement("div");
+    name.className = "up-thumb-filename";
+    name.textContent = f.filename;
+    thumb.appendChild(name);
+
+    var stateEl = document.createElement("div");
+    stateEl.className = "up-thumb-state";
+    if (f.state === "uploading") stateEl.textContent = "uploading...";
+    else if (f.state === "uploaded") stateEl.textContent = "uploaded";
+    else if (f.state === "failed") stateEl.textContent = "failed — click to retry";
+    else if (f.state === "network_error") stateEl.textContent = "network error — check connection or use web dashboard";
+    else stateEl.textContent = f.state;
+    thumb.appendChild(stateEl);
+
+    if (f.state === "failed") {
+      thumb.style.cursor = "pointer";
+      thumb.onclick = function () { upState.manager.retryFile(f.id); };
+    }
+
+    var removeBtn = document.createElement("button");
+    removeBtn.className = "up-thumb-remove";
+    removeBtn.textContent = "\\u00D7";
+    removeBtn.onclick = function (e) {
+      e.stopPropagation();
+      upState.manager.removeFile(f.id);
+    };
+    thumb.appendChild(removeBtn);
+
+    container.appendChild(thumb);
+  });
+
+  upMaybeReport(files);
+}
+
+function upMaybeReport(files) {
+  if (upState.reported) return;
+  if (files.length === 0) return;
+  var settled = files.every(function (f) {
+    return f.state === "uploaded" || f.state === "failed" || f.state === "network_error";
+  });
+  if (!settled) return;
+
+  var uploaded = files
+    .filter(function (f) { return f.state === "uploaded"; })
+    .map(function (f) {
+      return {
+        id: f.upload_id || null,
+        url: f.url,
+        mime_type: f.mime_type,
+        size: f.size,
+        filename: f.filename,
+        uploaded_at: f.uploaded_at,
+      };
+    });
+
+  upState.reported = true;
+
+  var status = document.getElementById("up-status");
+  if (status) {
+    status.style.display = "block";
+    status.textContent = uploaded.length + " file(s) uploaded — returning to agent";
+  }
+
+  if (app && typeof app.updateModelContext === "function") {
+    try {
+      app.updateModelContext({
+        context: [{
+          type: "text",
+          text: JSON.stringify({ uploaded: uploaded }),
+        }],
+      });
+    } catch (err) {
+      console.warn("[pica_upload] updateModelContext failed:", err);
+    }
+  }
+}
+
+function upEnforceMaxFiles(incoming) {
+  var maxMsgEl = document.getElementById("up-max-msg");
+  if (maxMsgEl) {
+    maxMsgEl.style.display = "none";
+    maxMsgEl.textContent = "";
+  }
+  var max = upState.config.max_files;
+  if (!max || !upState.manager) return incoming;
+  var currentCount = upState.manager.getFiles().length;
+  var remaining = max - currentCount;
+  if (remaining <= 0) {
+    if (maxMsgEl) {
+      maxMsgEl.textContent = "max " + max + " files — extras ignored";
+      maxMsgEl.style.display = "block";
+    }
+    return [];
+  }
+  if (incoming.length > remaining) {
+    if (maxMsgEl) {
+      maxMsgEl.textContent = "max " + max + " files — extras ignored";
+      maxMsgEl.style.display = "block";
+    }
+    return Array.prototype.slice.call(incoming, 0, remaining);
+  }
+  return incoming;
+}
+
+function upSetup() {
+  var dz = document.getElementById("up-dropzone");
+  var input = document.getElementById("up-input");
+  var title = document.getElementById("up-title");
+  var subtitle = document.getElementById("up-subtitle");
+  var dzLabel = document.getElementById("up-dropzone-label");
+
+  if (upState.config.purpose && title) {
+    title.textContent = "upload: " + upState.config.purpose;
+  }
+  if (upState.config.accept && upState.config.accept !== "any" && subtitle) {
+    subtitle.textContent = "drop " + upState.config.accept + " files here or click to browse";
+    if (dzLabel) dzLabel.textContent = "drop " + upState.config.accept + " files here";
+  }
+
+  if (input) {
+    input.accept = upAcceptToAttr(upState.config.accept);
+  }
+  if (!dz || !input) return;
+
+  dz.addEventListener("click", function () { input.click(); });
+  input.addEventListener("change", function (e) {
+    if (e.target.files && e.target.files.length) {
+      var allowed = upEnforceMaxFiles(e.target.files);
+      if (allowed.length) {
+        upState.reported = false;
+        upState.manager.addFiles(allowed);
+      }
+    }
+    input.value = "";
+  });
+  dz.addEventListener("dragover", function (e) {
+    e.preventDefault();
+    dz.classList.add("dragover");
+  });
+  dz.addEventListener("dragleave", function () { dz.classList.remove("dragover"); });
+  dz.addEventListener("drop", function (e) {
+    e.preventDefault();
+    dz.classList.remove("dragover");
+    if (e.dataTransfer && e.dataTransfer.files && e.dataTransfer.files.length) {
+      var allowed = upEnforceMaxFiles(e.dataTransfer.files);
+      if (allowed.length) {
+        upState.reported = false;
+        upState.manager.addFiles(allowed);
+      }
+    }
+  });
+}
+
+window.onPicaToolResult = function (data) {
+  if (data && data.config) {
+    upState.config = {
+      accept: data.config.accept || "any",
+      purpose: data.config.purpose || null,
+      max_files: data.config.max_files || null,
+    };
+  }
+  upState.manager = createUploadManager({
+    accept: upState.config.accept,
+    onStateChange: upRender,
+    app: app,
+  });
+  upSetup();
+};
+`;
+export const UPLOAD_HTML = buildAppHtml("pica \u2014 upload", UPLOAD_BODY, UPLOAD_JS);
+//# sourceMappingURL=upload.js.map

package/dist/apps/upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.js","sourceRoot":"","sources":["../../src/apps/upload.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuEnB,CAAC;AAEF,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkMjB,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CACrC,oBAAoB,EACpB,WAAW,EACX,SAAS,CACV,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,14 @@
+export declare const VERSION: string;
+export interface ServerConfig {
+    picaApiKey: string | null;
+    picaApiUrl: string;
+    serverName: string;
+    version: string;
+    debug: boolean;
+    lobbyMode: boolean;
+    credentialsPath: string;
+    discoveryMode: boolean;
+}
+export declare function loadConfig(): ServerConfig;
+export declare function validateConfig(config: ServerConfig): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAoCA,eAAO,MAAM,OAAO,EAAE,MAAoB,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,UAAU,IAAI,YAAY,CAwCzC;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAWzD"}

package/dist/config.js

@@ -0,0 +1,73 @@
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+/**
+ * MCP Server Configuration
+ */
+import { readCredentials, getDefaultCredentialsPath, } from "@withpica/mcp-utils";
+import { createRequire } from "module";
+// Single TS-side source of truth for the customer MCP server version,
+// AUTO-DERIVED from package.json so the two cannot drift. Past drift
+// incidents that motivated this: 2026-04-08 (banner 2.5.0 vs npm 2.6.1),
+// 2026-04-19 ADR-181 Phase 2 (banner 2.6.2 vs npm 2.22.0), 2026-04-24
+// (publish blocked TWICE by stale literal at 2.27.0 → 2.28.0 bumps).
+//
+// Implementation note: uses `createRequire` rather than the import-
+// attribute syntax (`import pkg from "..." with { type: "json" }`)
+// because the package's tsconfig.json sets `module: "Node16"`, which
+// doesn't support import attributes. createRequire works in any
+// module setting and resolves ../package.json relative to the
+// compiled dist/config.js file at runtime — same path semantics, no
+// tsconfig change needed.
+//
+// scripts/lint-mcp-tools.ts version-sync check now accepts both this
+// derived form (preferred) and the legacy literal hardcode (still
+// version-matched against package.json). Surfaces on stdio via the
+// boot banner + MCP `initialize` handshake (loadConfig below) and on
+// HTTP via app/api/mcp/route.ts, which imports this const from
+// mcp-server/dist/config.js. ADR-180 Phase 2 collapsed the
+// duplication; ADR-196 Phase 4b makes it drift-proof.
+const pkg = createRequire(import.meta.url)("../package.json");
+export const VERSION = pkg.version;
+export function loadConfig() {
+    const credentialsPath = process.env.PICA_CREDENTIALS_PATH || getDefaultCredentialsPath();
+    const debug = process.env.DEBUG === "true" || process.env.DEBUG === "1";
+    // Priority 1: env var
+    let picaApiKey = process.env.PICA_API_KEY || null;
+    // Priority 2: credentials file
+    if (!picaApiKey) {
+        const creds = readCredentials(credentialsPath);
+        if (creds) {
+            picaApiKey = creds.api_key;
+            if (debug) {
+                console.error(`[MCP Server] Loaded credentials for ${creds.email}`);
+            }
+        }
+    }
+    const lobbyMode = !picaApiKey;
+    const discoveryMode = process.env.MCP_LAYERED_DISCOVERY === "1";
+    if (lobbyMode && debug) {
+        console.error("[MCP Server] No API key found — starting in lobby mode");
+    }
+    if (discoveryMode && debug) {
+        console.error("[MCP Server] Layered discovery mode enabled");
+    }
+    return {
+        picaApiKey,
+        picaApiUrl: process.env.PICA_API_URL || "https://withpica.com/api",
+        serverName: "pica-mcp-server",
+        version: VERSION,
+        debug,
+        lobbyMode,
+        credentialsPath,
+        discoveryMode,
+    };
+}
+export function validateConfig(config) {
+    if (!config.lobbyMode &&
+        (!config.picaApiKey || config.picaApiKey.trim() === "")) {
+        throw new Error("PICA API key cannot be empty when not in lobby mode");
+    }
+    if (!config.picaApiUrl || !config.picaApiUrl.startsWith("http")) {
+        throw new Error("Invalid PICA API URL");
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D;;GAEG;AAEH,OAAO,EACL,eAAe,EACf,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,sEAAsE;AACtE,qEAAqE;AACrE,yEAAyE;AACzE,sEAAsE;AACtE,qEAAqE;AACrE,EAAE;AACF,oEAAoE;AACpE,mEAAmE;AACnE,qEAAqE;AACrE,gEAAgE;AAChE,8DAA8D;AAC9D,oEAAoE;AACpE,0BAA0B;AAC1B,EAAE;AACF,qEAAqE;AACrE,kEAAkE;AAClE,mEAAmE;AACnE,qEAAqE;AACrE,+DAA+D;AAC/D,2DAA2D;AAC3D,sDAAsD;AACtD,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAE3D,CAAC;AACF,MAAM,CAAC,MAAM,OAAO,GAAW,GAAG,CAAC,OAAO,CAAC;AAa3C,MAAM,UAAU,UAAU;IACxB,MAAM,eAAe,GACnB,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,yBAAyB,EAAE,CAAC;IACnE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC;IAExE,sBAAsB;IACtB,IAAI,UAAU,GAAkB,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC;IAEjE,+BAA+B;IAC/B,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,KAAK,GAAG,eAAe,CAAC,eAAe,CAAC,CAAC;QAC/C,IAAI,KAAK,EAAE,CAAC;YACV,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC;YAC3B,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,CAAC,KAAK,CAAC,uCAAuC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,CAAC,UAAU,CAAC;IAC9B,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,GAAG,CAAC;IAEhE,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,aAAa,IAAI,KAAK,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO;QACL,UAAU;QACV,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,0BAA0B;QAClE,UAAU,EAAE,iBAAiB;QAC7B,OAAO,EAAE,OAAO;QAChB,KAAK;QACL,SAAS;QACT,eAAe;QACf,aAAa;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,IACE,CAAC,MAAM,CAAC,SAAS;QACjB,CAAC,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EACvD,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
+/**
+ * PICA MCP Server
+ * Entry point for the Model Context Protocol server
+ */
+import { loadConfig, validateConfig } from "./config.js";
+import { PicaMcpServer } from "./server.js";
+async function main() {
+    try {
+        const config = loadConfig();
+        validateConfig(config);
+        if (config.lobbyMode) {
+            console.error('[MCP Server] Starting in lobby mode — say "sign me in" to connect');
+        }
+        const server = new PicaMcpServer(config);
+        await server.start();
+        process.on("SIGINT", async () => {
+            console.error("[MCP Server] Shutting down...");
+            await server.stop();
+            process.exit(0);
+        });
+        process.on("SIGTERM", async () => {
+            console.error("[MCP Server] Shutting down...");
+            await server.stop();
+            process.exit(0);
+        });
+    }
+    catch (error) {
+        console.error("[MCP Server] Fatal error:", error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,6DAA6D;AAE7D;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,cAAc,CAAC,MAAM,CAAC,CAAC;QAEvB,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,OAAO,CAAC,KAAK,CACX,mEAAmE,CACpE,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QAErB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;YAC9B,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;YAC/C,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;YAC/B,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;YAC/C,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACX,2BAA2B,EAC3B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Prompt Registry for MCP Server
+ * Manages pre-configured prompts for common workflows
+ */
+export interface PromptDefinition {
+    name: string;
+    description: string;
+    arguments?: Array<{
+        name: string;
+        description: string;
+        required?: boolean;
+    }>;
+}
+export interface PromptMessage {
+    role: "user" | "assistant";
+    content: {
+        type: string;
+        text: string;
+    };
+}
+export interface PromptResult {
+    messages: PromptMessage[];
+}
+export declare class PromptRegistry {
+    /**
+     * List all available prompts
+     */
+    listPrompts(): PromptDefinition[];
+    /**
+     * Get a prompt by name
+     */
+    getPrompt(name: string, args?: Record<string, any>): Promise<any>;
+    /**
+     * Analyze catalog prompt
+     */
+    private getAnalyzeCatalogPrompt;
+    /**
+     * Find duplicates prompt
+     */
+    private getFindDuplicatesPrompt;
+    /**
+     * Enrich metadata prompt
+     */
+    private getEnrichMetadataPrompt;
+    /**
+     * Verify works prompt
+     */
+    private getVerifyWorksPrompt;
+    /**
+     * Assess catalog health prompt
+     */
+    private getAssessCatalogHealthPrompt;
+    /**
+     * Audit credits prompt
+     */
+    private getAuditCreditsPrompt;
+    /**
+     * New catalog setup prompt — first-time onboarding
+     */
+    private getNewCatalogSetupPrompt;
+    /**
+     * Close the loop — check a specific work's gaps and offer to fix each one
+     */
+    private getCloseTheLoopPrompt;
+    /**
+     * Register my works — check registration status and prepare for PRO submission
+     */
+    private getRegisterMyWorksPrompt;
+    /**
+     * Workspace autopilot — assess state and route to the right workflow
+     */
+    private getWorkspaceAutopilotPrompt;
+    /**
+     * Prepare for sync — get catalog sync-ready
+     */
+    private getPrepareForSyncPrompt;
+    /**
+     * Log a session — guided studio session capture
+     */
+    private getLogASessionPrompt;
+    /**
+     * Set recording splits — guided master ownership split assignment with verify gate
+     */
+    private getSetRecordingSplitsPrompt;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,qBAAa,cAAc;IACzB;;OAEG;IACH,WAAW,IAAI,gBAAgB,EAAE;IAuGjC;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IA8CvE;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAgC/B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA+B/B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAqC/B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgC5B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAiCpC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAoC7B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAyChC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA0C7B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAqChC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAiDnC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAuC/B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAsC5B;;OAEG;IACH,OAAO,CAAC,2BAA2B;CA6CpC"}