@topolo/mcp 0.9.11 → 0.10.1

package/dist/http.js

@@ -3098,9 +3098,9 @@ var require_data = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/fast-uri@3.1.4/node_modules/fast-uri/lib/utils.js
+// ../../node_modules/.pnpm/fast-uri@3.1.5/node_modules/fast-uri/lib/utils.js
 var require_utils = __commonJS({
-  "../../node_modules/.pnpm/fast-uri@3.1.4/node_modules/fast-uri/lib/utils.js"(exports, module) {
+  "../../node_modules/.pnpm/fast-uri@3.1.5/node_modules/fast-uri/lib/utils.js"(exports, module) {
     "use strict";
     var isUUID = RegExp.prototype.test.bind(/^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/iu);
     var isIPv4 = RegExp.prototype.test.bind(/^(?:(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)$/u);
@@ -3411,9 +3411,9 @@ var require_utils = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/fast-uri@3.1.4/node_modules/fast-uri/lib/schemes.js
+// ../../node_modules/.pnpm/fast-uri@3.1.5/node_modules/fast-uri/lib/schemes.js
 var require_schemes = __commonJS({
-  "../../node_modules/.pnpm/fast-uri@3.1.4/node_modules/fast-uri/lib/schemes.js"(exports, module) {
+  "../../node_modules/.pnpm/fast-uri@3.1.5/node_modules/fast-uri/lib/schemes.js"(exports, module) {
     "use strict";
     var { isUUID } = require_utils();
     var URN_REG = /([\da-z][\d\-a-z]{0,31}):((?:[\w!$'()*+,\-.:;=@]|%[\da-f]{2})+)/iu;
@@ -3621,9 +3621,9 @@ var require_schemes = __commonJS({
   }
 });
 
-// ../../node_modules/.pnpm/fast-uri@3.1.4/node_modules/fast-uri/index.js
+// ../../node_modules/.pnpm/fast-uri@3.1.5/node_modules/fast-uri/index.js
 var require_fast_uri = __commonJS({
-  "../../node_modules/.pnpm/fast-uri@3.1.4/node_modules/fast-uri/index.js"(exports, module) {
+  "../../node_modules/.pnpm/fast-uri@3.1.5/node_modules/fast-uri/index.js"(exports, module) {
     "use strict";
     var { normalizeIPv6, removeDotSegments, recomposeAuthority, normalizePercentEncoding, normalizePathEncoding, escapePreservingEscapes, reescapeHostDelimiters, isIPv4, nonSimpleDomain } = require_utils();
     var { SCHEMES, getSchemeHandler } = require_schemes();
@@ -3639,7 +3639,12 @@ var require_fast_uri = __commonJS({
     }
     function resolve(baseURI, relativeURI, options) {
       const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
-      const resolved = resolveComponent(parse3(baseURI, schemelessOptions), parse3(relativeURI, schemelessOptions), schemelessOptions, true);
+      const { parsed: baseParsed, malformedAuthorityOrPort: baseMalformed } = parseWithStatus(baseURI, schemelessOptions);
+      const { parsed: relativeParsed, malformedAuthorityOrPort: relativeMalformed } = parseWithStatus(relativeURI, schemelessOptions);
+      if (baseMalformed || relativeMalformed) {
+        throw new Error(baseParsed.error || relativeParsed.error || "URI is malformed.");
+      }
+      const resolved = resolveComponent(baseParsed, relativeParsed, schemelessOptions, true);
       schemelessOptions.skipEscape = true;
       return serialize(resolved, schemelessOptions);
     }
@@ -3765,6 +3770,7 @@ var require_fast_uri = __commonJS({
     }
     var URI_PARSE = /^(?:([^#/:?]+):)?(?:\/\/((?:([^#/?@]*)@)?(\[[^#/?\]]+\]|[^#/:?]*)(?::(\d*))?))?([^#?]*)(?:\?([^#]*))?(?:#((?:.|[\n\r])*))?/u;
     var AUTHORITY_PREFIX = /^(?:[^#/:?]+:)?\/\/([^/?#]*)/;
+    var AUTHORITY_INTRODUCER_REGION = /^(?:[^#/:?]+:)?([/\\\t\n\r]*)/;
     function getParseError(parsed, matches) {
       if (matches[2] !== void 0 && parsed.path && parsed.path[0] !== "/") {
         return 'URI path must start with "/" when authority is present.';
@@ -3799,6 +3805,20 @@ var require_fast_uri = __commonJS({
         parsed.error = "URI authority must not contain a literal backslash.";
         malformedAuthorityOrPort = true;
       }
+      const introducerMatch = uri.match(AUTHORITY_INTRODUCER_REGION);
+      if (introducerMatch !== null) {
+        const region = introducerMatch[1];
+        const normalizedRegion = region.replace(/[\t\n\r]/g, "");
+        if (normalizedRegion.length >= 2) {
+          if (normalizedRegion.slice(0, 2) !== "//") {
+            parsed.error = parsed.error || "URI authority must not contain a literal backslash.";
+            malformedAuthorityOrPort = true;
+          } else if (region.length !== normalizedRegion.length) {
+            parsed.error = parsed.error || "URI authority introducer must not contain whitespace.";
+            malformedAuthorityOrPort = true;
+          }
+        }
+      }
       const matches = uri.match(URI_PARSE);
       if (matches) {
         parsed.scheme = matches[1];
@@ -15830,11 +15850,16 @@ import { TopoloAuthError, TopoloHttpError, TopoloPermissionError } from "@topolo
 import {
   APPLICATION_REQUIREMENTS,
   APPLICATION_REQUIREMENTS_VERSION,
-  APPLICATIONS,
-  DEFAULT_APP_URLS,
-  auditAllApplicationRequirements,
+  auditApplicationEntries,
   applicationRequirementScopes,
+  compactActionCatalogEntry,
+  compactActionPlan,
+  compactActionValidation,
+  compactApplicationAudit,
+  friendlyAppId,
+  listApplicationDirectory,
   requirementsForApplication,
+  resolveApplicationDirectoryEntry,
   resolveCatalogServiceUrl
 } from "@topolo/sdk";
 
@@ -15876,7 +15901,6 @@ function splitService(servicePart) {
 }
 
 // src/tools.ts
-var APPLICATION_IDS = Object.keys(APPLICATIONS).sort();
 var HTTP_METHODS = ["GET", "POST", "PUT", "PATCH", "DELETE"];
 function requiredString(args, name) {
   const value = typeof args[name] === "string" ? args[name].trim() : "";
@@ -15892,6 +15916,20 @@ function optionalResourceContext(args) {
   }
   return { resourceType, resourceId };
 }
+function coerceObjectParam(value, name) {
+  let candidate = value;
+  if (typeof candidate === "string" && candidate.trim().startsWith("{")) {
+    try {
+      candidate = JSON.parse(candidate);
+    } catch {
+    }
+  }
+  if (candidate === void 0) return {};
+  if (!candidate || typeof candidate !== "object" || Array.isArray(candidate)) {
+    throw new TopoloMcpPublicError(`${name} must be an object.`);
+  }
+  return candidate;
+}
 var TOOLS = [
   {
     name: "topolo_whoami",
@@ -15917,7 +15955,8 @@ var TOOLS = [
       properties: {
         query: { type: "string" },
         cursor: { type: "string" },
-        limit: { type: "integer", minimum: 1, maximum: 100, default: 25 }
+        limit: { type: "integer", minimum: 1, maximum: 100, default: 25 },
+        detail: { type: "boolean", description: "Return full schemas and agent contracts. Defaults to compact action guidance." }
       },
       additionalProperties: false
     },
@@ -15971,12 +16010,13 @@ var TOOLS = [
     handler: async (topolo, args) => {
       const service = typeof args["service"] === "string" ? args["service"].trim() : "";
       if (!service) throw new TopoloMcpPublicError("service is required for bounded action discovery.");
-      return topolo.client.searchActions({
+      const result = await topolo.client.searchActions({
         service,
         query: typeof args["query"] === "string" ? args["query"] : void 0,
         cursor: typeof args["cursor"] === "string" ? args["cursor"] : void 0,
         limit: typeof args["limit"] === "number" ? args["limit"] : void 0
       });
+      return args["detail"] === true ? result : { actions: result.actions.map(compactActionCatalogEntry), page: result.page };
     }
   },
   {
@@ -16042,14 +16082,11 @@ var TOOLS = [
     handler: async (topolo, args) => {
       const actionId = typeof args["actionId"] === "string" ? args["actionId"].trim() : "";
       if (!actionId) throw new TopoloMcpPublicError("actionId is required.");
-      const input = args["input"];
-      if (input !== void 0 && (!input || typeof input !== "object" || Array.isArray(input))) {
-        throw new TopoloMcpPublicError("input must be an object.");
-      }
+      const input = coerceObjectParam(args["input"], "input");
       const resource = optionalResourceContext(args);
       return topolo.client.readAction(
         actionId,
-        input ?? {},
+        input,
         resource ? { resource } : {}
       );
     }
@@ -16075,14 +16112,11 @@ var TOOLS = [
     handler: async (topolo, args) => {
       const actionId = typeof args["actionId"] === "string" ? args["actionId"].trim() : "";
       if (!actionId) throw new TopoloMcpPublicError("actionId is required.");
-      const input = args["input"];
-      if (input !== void 0 && (!input || typeof input !== "object" || Array.isArray(input))) {
-        throw new TopoloMcpPublicError("input must be an object.");
-      }
+      const input = coerceObjectParam(args["input"], "input");
       const resource = optionalResourceContext(args);
       return topolo.client.callAction(
         actionId,
-        input ?? {},
+        input,
         {
           confirm: args["confirm"] === true,
           ...resource ? { resource } : {}
@@ -16121,23 +16155,17 @@ var TOOLS = [
       if (!isCanonicalBase64(contentBase64)) throw new TopoloMcpPublicError("contentBase64 must be canonical base64.");
       if (!contentType) throw new TopoloMcpPublicError("contentType is required.");
       if (!fileName) throw new TopoloMcpPublicError("fileName is required.");
-      const input = args["input"];
-      if (input !== void 0 && (!input || typeof input !== "object" || Array.isArray(input))) {
-        throw new TopoloMcpPublicError("input must be an object.");
-      }
-      const completionInput = args["completionInput"];
-      if (completionInput !== void 0 && (!completionInput || typeof completionInput !== "object" || Array.isArray(completionInput))) {
-        throw new TopoloMcpPublicError("completionInput must be an object.");
-      }
+      const input = coerceObjectParam(args["input"], "input");
+      const completionInput = coerceObjectParam(args["completionInput"], "completionInput");
       const resource = optionalResourceContext(args);
       return topolo.client.uploadActionBase64(
         actionId,
         contentBase64,
-        input ?? {},
+        input,
         {
           fileName,
           contentType,
-          completionInput: completionInput ?? {},
+          completionInput,
           confirm: args["confirm"] === true,
           ...resource ? { resource } : {}
         }
@@ -16154,7 +16182,8 @@ var TOOLS = [
       type: "object",
       properties: {
         actionId: { type: "string", minLength: 1 },
-        input: { type: "object", additionalProperties: true }
+        input: { type: "object", additionalProperties: true },
+        detail: { type: "boolean", description: "Include the full action contract. Defaults to a compact validation result." }
       },
       required: ["actionId"],
       additionalProperties: false
@@ -16162,11 +16191,9 @@ var TOOLS = [
     handler: async (topolo, args) => {
       const actionId = typeof args["actionId"] === "string" ? args["actionId"].trim() : "";
       if (!actionId) throw new TopoloMcpPublicError("actionId is required.");
-      const input = args["input"];
-      if (input !== void 0 && (!input || typeof input !== "object" || Array.isArray(input))) {
-        throw new TopoloMcpPublicError("input must be an object.");
-      }
-      return topolo.client.validateActionInput(actionId, input ?? {});
+      const input = coerceObjectParam(args["input"], "input");
+      const result = await topolo.client.validateActionInput(actionId, input);
+      return args["detail"] === true ? result : compactActionValidation(result.action.actionId, result.validation);
     }
   },
   {
@@ -16182,7 +16209,8 @@ var TOOLS = [
         input: { type: "object", additionalProperties: true },
         resourceType: { type: "string", description: "Optional resource-scoping alias published in the app resource catalog (e.g. workspace, brand, merchant)." },
         resourceId: { type: "string", description: "Resource id. Required when resourceType is provided." },
-        confirm: { type: "boolean", description: "Include confirmation in the plan without executing the action." }
+        confirm: { type: "boolean", description: "Include confirmation in the plan without executing the action." },
+        detail: { type: "boolean", description: "Include the full action contract. Defaults to the executable request and verification plan." }
       },
       required: ["actionId"],
       additionalProperties: false
@@ -16190,19 +16218,17 @@ var TOOLS = [
     handler: async (topolo, args) => {
       const actionId = typeof args["actionId"] === "string" ? args["actionId"].trim() : "";
       if (!actionId) throw new TopoloMcpPublicError("actionId is required.");
-      const input = args["input"];
-      if (input !== void 0 && (!input || typeof input !== "object" || Array.isArray(input))) {
-        throw new TopoloMcpPublicError("input must be an object.");
-      }
+      const input = coerceObjectParam(args["input"], "input");
       const resource = optionalResourceContext(args);
-      return topolo.client.planAction(
+      const plan = await topolo.client.planAction(
         actionId,
-        input ?? {},
+        input,
         {
           confirm: args["confirm"] === true,
           ...resource ? { resource } : {}
         }
       );
+      return args["detail"] === true ? plan : compactActionPlan(plan);
     }
   },
   {
@@ -16236,14 +16262,18 @@ var TOOLS = [
     destructive: false,
     inputSchema: {
       type: "object",
-      properties: { service: { type: "string", minLength: 1 } },
+      properties: {
+        service: { type: "string", minLength: 1 },
+        detail: { type: "boolean", description: "Return full schemas and agent contracts. Defaults to compact capability guidance." }
+      },
       required: ["service"],
       additionalProperties: false
     },
     handler: async (topolo, args) => {
       const service = typeof args["service"] === "string" ? args["service"].trim() : "";
       if (!service) throw new TopoloMcpPublicError("service is required.");
-      return topolo.client.searchActions({ service, limit: 100 });
+      const result = await topolo.client.searchActions({ service, limit: 100 });
+      return args["detail"] === true ? result : { actions: result.actions.map(compactActionCatalogEntry), page: result.page };
     }
   },
   {
@@ -16374,7 +16404,7 @@ var TOOLS = [
       },
       additionalProperties: false
     },
-    handler: async (_topolo, args) => {
+    handler: async (topolo, args) => {
       const application = args["application"];
       if (application === void 0) {
         return {
@@ -16384,12 +16414,8 @@ var TOOLS = [
           requirements: APPLICATION_REQUIREMENTS
         };
       }
-      if (typeof application !== "string" || !APPLICATION_IDS.includes(application)) {
-        throw new TopoloMcpPublicError(
-          `Unknown application "${String(application)}". ${formatKnownValues(APPLICATION_IDS, "applications")}`
-        );
-      }
-      const app = APPLICATIONS[application];
+      const resolved = await resolveDirectoryApplication(topolo, application);
+      const app = resolved.application;
       return {
         version: APPLICATION_REQUIREMENTS_VERSION,
         application: app,
@@ -16415,11 +16441,15 @@ var TOOLS = [
           type: "string",
           enum: ["missing", "needs_review", "partial"],
           description: "Optional conformance gate. Returns conformanceGate.passed=false when findings at this severity or worse exist."
+        },
+        detail: {
+          type: "boolean",
+          description: "Include every finding and migration item. Defaults to per-app scores and a queue count."
         }
       },
       additionalProperties: false
     },
-    handler: async (_topolo, args) => {
+    handler: async (topolo, args) => {
       const application = args["application"];
       const failOn = args["failOn"];
       if (failOn !== void 0 && typeof failOn !== "string") {
@@ -16428,16 +16458,15 @@ var TOOLS = [
       const gate = failOn ? normalizeFailOn(failOn) : null;
       let report;
       if (application === void 0) {
-        report = auditAllApplicationRequirements();
-        return gate ? { ...report, conformanceGate: evaluateApplicationAuditGate(report, gate) } : report;
+        const directory = await listApplicationDirectory(topolo.client);
+        report = auditApplicationEntries(directory.applications.map((app) => app.application));
+        const output2 = args["detail"] === true ? report : compactApplicationAudit(report);
+        return gate ? { ...output2, conformanceGate: evaluateApplicationAuditGate(report, gate) } : output2;
       }
-      if (typeof application !== "string" || !APPLICATION_IDS.includes(application)) {
-        throw new TopoloMcpPublicError(
-          `Unknown application "${String(application)}". ${formatKnownValues(APPLICATION_IDS, "applications")}`
-        );
-      }
-      report = auditAllApplicationRequirements([application]);
-      return gate ? { ...report, conformanceGate: evaluateApplicationAuditGate(report, gate) } : report;
+      const resolved = await resolveDirectoryApplication(topolo, application);
+      report = auditApplicationEntries([resolved.application]);
+      const output = args["detail"] === true ? report : compactApplicationAudit(report);
+      return gate ? { ...output, conformanceGate: evaluateApplicationAuditGate(report, gate) } : output;
     }
   },
   {
@@ -16576,31 +16605,19 @@ function statusesAtOrWorse(threshold) {
   return ["missing", "needs_review", "partial"];
 }
 function displayAppId(entry) {
-  for (const value of [entry.slug, entry.name, entry.appId]) {
-    if (typeof value !== "string" || !value.trim()) continue;
-    for (const candidate of appIdCandidates(value)) {
-      if (Object.prototype.hasOwnProperty.call(DEFAULT_APP_URLS, candidate)) {
-        return candidate;
-      }
-    }
-  }
-  return appIdCandidates(entry.slug || entry.appId)[0] || entry.appId;
+  return friendlyAppId(entry);
 }
-function appIdCandidates(value) {
-  const normalized = value.trim().toLowerCase().replace(/\s+/g, "-");
-  const withoutTopolo = normalized.startsWith("topolo-") ? normalized.slice("topolo-".length) : normalized;
-  return [.../* @__PURE__ */ new Set([
-    normalized,
-    normalized.replace(/-/g, "_"),
-    withoutTopolo,
-    withoutTopolo.replace(/-/g, "_")
-  ])].filter(Boolean);
-}
-function formatKnownValues(values, label) {
-  const sorted = [...values].sort();
-  const preview = sorted.slice(0, 25).join(", ");
-  const suffix = sorted.length > 25 ? `, ... +${sorted.length - 25} more` : "";
-  return `Run discovery for the full ${label} list. Known snapshot sample: ${preview}${suffix}`;
+async function resolveDirectoryApplication(topolo, application) {
+  if (typeof application !== "string" || !application.trim()) {
+    throw new TopoloMcpPublicError("`application` must be a non-empty string.");
+  }
+  try {
+    return await resolveApplicationDirectoryEntry(topolo.client, application);
+  } catch (error2) {
+    throw new TopoloMcpPublicError(
+      error2 instanceof Error ? error2.message : `Unknown application "${application}".`
+    );
+  }
 }
 
 // src/version.ts