@agentcash/discovery 0.1.0 → 0.1.1

package/dist/index.js

@@ -11,6 +11,9 @@ var STRICT_ESCALATION_CODES = [
   "INTEROP_MPP_USED"
 ];
 
+// src/mmm-enabled.ts
+var isMmmEnabled = () => "0.1.1".includes("-mmm");
+
 // src/core/constants.ts
 var OPENAPI_PATH_CANDIDATES = ["/openapi.json", "/.well-known/openapi.json"];
 var WELL_KNOWN_MPP_PATH = "/.well-known/mpp";
@@ -963,7 +966,7 @@ function detectProtocols(response) {
   }
   const authHeader = response.headers.get("www-authenticate")?.toLowerCase() ?? "";
   if (authHeader.includes("x402")) protocols.add("x402");
-  if (authHeader.includes("mpp")) protocols.add("mpp");
+  if (isMmmEnabled() && authHeader.includes("mpp")) protocols.add("mpp");
   return [...protocols];
 }
 async function runProbeStage(options) {
@@ -1295,7 +1298,7 @@ async function runDiscovery({
         includeRaw
       })
     );
-    if (includeInteropMpp) {
+    if (includeInteropMpp && isMmmEnabled()) {
       stages.push(
         () => runInteropMppStage({
           origin,
@@ -1397,6 +1400,246 @@ async function runDiscovery({
   };
 }
 
+// src/harness.ts
+var INTENT_TRIGGERS = ["x402", "mpp", "pay for", "micropayment", "agentic commerce"];
+var CLIENT_PROFILES = {
+  "claude-code": {
+    id: "claude-code",
+    label: "Claude Code MCP Harness",
+    surface: "mcp",
+    defaultContextWindowTokens: 2e5,
+    zeroHopBudgetPercent: 0.1,
+    notes: "Targets environments where MCP context can use roughly 10% of total context."
+  },
+  "skill-cli": {
+    id: "skill-cli",
+    label: "Skill + CLI Harness",
+    surface: "skill-cli",
+    defaultContextWindowTokens: 2e5,
+    zeroHopBudgetPercent: 0.02,
+    notes: "Targets constrained skill contexts with title/description-heavy routing."
+  },
+  "generic-mcp": {
+    id: "generic-mcp",
+    label: "Generic MCP Harness",
+    surface: "mcp",
+    defaultContextWindowTokens: 128e3,
+    zeroHopBudgetPercent: 0.05,
+    notes: "Conservative MCP profile when specific client budgets are unknown."
+  },
+  generic: {
+    id: "generic",
+    label: "Generic Agent Harness",
+    surface: "generic",
+    defaultContextWindowTokens: 128e3,
+    zeroHopBudgetPercent: 0.03,
+    notes: "Fallback profile for unknown clients."
+  }
+};
+function isFirstPartyDomain(hostname) {
+  const normalized = hostname.toLowerCase();
+  return normalized.endsWith(".dev") && normalized.startsWith("stable");
+}
+function safeHostname(origin) {
+  try {
+    return new URL(origin).hostname;
+  } catch {
+    return origin.replace(/^https?:\/\//, "").split("/")[0] ?? origin;
+  }
+}
+function previewText(text) {
+  if (!text) return null;
+  const compact = text.replace(/\s+/g, " ").trim();
+  if (!compact) return null;
+  return compact.length > 220 ? `${compact.slice(0, 217)}...` : compact;
+}
+function toAuthModeCount(resources) {
+  const counts = {
+    paid: 0,
+    siwx: 0,
+    apiKey: 0,
+    unprotected: 0,
+    unknown: 0
+  };
+  for (const resource of resources) {
+    const mode = resource.authHint;
+    if (mode === "paid" || mode === "siwx" || mode === "apiKey" || mode === "unprotected") {
+      counts[mode] += 1;
+    } else {
+      counts.unknown += 1;
+    }
+  }
+  return counts;
+}
+function toSourceCount(resources) {
+  return resources.reduce(
+    (acc, resource) => {
+      acc[resource.source] = (acc[resource.source] ?? 0) + 1;
+      return acc;
+    },
+    {}
+  );
+}
+function toL2Entries(resources) {
+  return [...resources].sort((a, b) => {
+    if (a.path !== b.path) return a.path.localeCompare(b.path);
+    if (a.method !== b.method) return a.method.localeCompare(b.method);
+    return a.resourceKey.localeCompare(b.resourceKey);
+  }).map((resource) => ({
+    resourceKey: resource.resourceKey,
+    method: resource.method,
+    path: resource.path,
+    source: resource.source,
+    authMode: resource.authHint ?? null
+  }));
+}
+function getLlmsTxtInfo(result) {
+  const llmsTxtUrl = result.trace.find((entry) => entry.links?.llmsTxtUrl)?.links?.llmsTxtUrl ?? result.resources.find((resource) => resource.links?.llmsTxtUrl)?.links?.llmsTxtUrl ?? null;
+  const llmsTxt = result.rawSources?.llmsTxt;
+  if (llmsTxt) {
+    return {
+      llmsTxtUrl,
+      llmsTxtTokenEstimate: estimateTokenCount(llmsTxt),
+      guidancePreview: previewText(llmsTxt),
+      guidanceStatus: "present"
+    };
+  }
+  if (llmsTxtUrl) {
+    const failed = result.warnings.some((warning2) => warning2.code === "LLMSTXT_FETCH_FAILED");
+    return {
+      llmsTxtUrl,
+      llmsTxtTokenEstimate: 0,
+      guidancePreview: null,
+      guidanceStatus: failed ? "advertised_but_unfetched" : "missing"
+    };
+  }
+  return {
+    llmsTxtUrl: null,
+    llmsTxtTokenEstimate: 0,
+    guidancePreview: null,
+    guidanceStatus: "not_advertised"
+  };
+}
+function getHarnessClientProfile(client = "claude-code") {
+  return CLIENT_PROFILES[client] ?? CLIENT_PROFILES.generic;
+}
+function listHarnessClientProfiles() {
+  return Object.values(CLIENT_PROFILES);
+}
+function buildContextHarnessReport(options) {
+  const client = getHarnessClientProfile(options.client);
+  const contextWindowTokens = options.contextWindowTokens ?? client.defaultContextWindowTokens;
+  const zeroHopBudgetTokens = Math.floor(contextWindowTokens * client.zeroHopBudgetPercent);
+  const hostname = safeHostname(options.result.origin);
+  const domainClass = isFirstPartyDomain(hostname) ? "first-party" : "ugc";
+  const l0Summary = "Route payment-capable intents to agentcash and use install/discover commands for progressive disclosure.";
+  const l1Summary = "Expose installed domain routing hints and trigger fan-out into L2/L3 commands when user intent matches domain capabilities.";
+  const l0EstimatedTokens = estimateTokenCount(
+    `${INTENT_TRIGGERS.join(", ")} npx agentcash install npx agentcash install-ext`
+  );
+  const l1EstimatedTokens = estimateTokenCount(
+    `${hostname} ${l1Summary} npx agentcash discover ${hostname} npx agentcash discover ${hostname} --verbose`
+  );
+  const llmsInfo = getLlmsTxtInfo(options.result);
+  return {
+    target: options.target,
+    origin: options.result.origin,
+    client,
+    budget: {
+      contextWindowTokens,
+      zeroHopBudgetTokens,
+      estimatedZeroHopTokens: l0EstimatedTokens + l1EstimatedTokens,
+      withinBudget: l0EstimatedTokens + l1EstimatedTokens <= zeroHopBudgetTokens
+    },
+    levels: {
+      l0: {
+        layer: "L0",
+        intentTriggers: INTENT_TRIGGERS,
+        installCommand: "npx agentcash install",
+        deliverySurfaces: ["MCP", "Skill+CLI"],
+        summary: l0Summary,
+        estimatedTokens: l0EstimatedTokens
+      },
+      l1: {
+        layer: "L1",
+        domain: hostname,
+        domainClass,
+        selectedDiscoveryStage: options.result.selectedStage ?? null,
+        summary: l1Summary,
+        fanoutCommands: [
+          `npx agentcash discover ${hostname}`,
+          `npx agentcash discover ${hostname} --verbose`
+        ],
+        estimatedTokens: l1EstimatedTokens
+      },
+      l2: {
+        layer: "L2",
+        command: `npx agentcash discover ${hostname}`,
+        tokenLight: true,
+        resourceCount: options.result.resources.length,
+        resources: toL2Entries(options.result.resources)
+      },
+      l3: {
+        layer: "L3",
+        command: `npx agentcash discover ${hostname} --verbose`,
+        detailLevel: "endpoint-schema-and-metadata",
+        countsByAuthMode: toAuthModeCount(options.result.resources),
+        countsBySource: toSourceCount(options.result.resources),
+        pricedResourceCount: options.result.resources.filter(
+          (resource) => resource.authHint === "paid"
+        ).length
+      },
+      l4: {
+        layer: "L4",
+        guidanceSource: llmsInfo.llmsTxtUrl ? "llms.txt" : "none",
+        llmsTxtUrl: llmsInfo.llmsTxtUrl,
+        llmsTxtTokenEstimate: llmsInfo.llmsTxtTokenEstimate,
+        guidancePreview: llmsInfo.guidancePreview,
+        guidanceStatus: llmsInfo.guidanceStatus
+      },
+      l5: {
+        layer: "L5",
+        status: "out_of_scope",
+        note: "Cross-domain composition is intentionally out of scope for discovery v1."
+      }
+    },
+    diagnostics: {
+      warningCount: options.result.warnings.length,
+      errorWarningCount: options.result.warnings.filter((warning2) => warning2.severity === "error").length,
+      selectedStage: options.result.selectedStage ?? null,
+      upgradeSuggested: options.result.upgradeSuggested,
+      upgradeReasons: options.result.upgradeReasons
+    }
+  };
+}
+async function auditContextHarness(options) {
+  const result = await runDiscovery({
+    detailed: true,
+    options: {
+      ...options,
+      rawView: "full"
+    }
+  });
+  return buildContextHarnessReport({
+    target: options.target,
+    result,
+    client: options.client,
+    contextWindowTokens: options.contextWindowTokens
+  });
+}
+function defaultHarnessProbeCandidates(report) {
+  const methodsByPath = /* @__PURE__ */ new Map();
+  for (const resource of report.levels.l2.resources) {
+    const methods = methodsByPath.get(resource.path) ?? /* @__PURE__ */ new Set();
+    methods.add(resource.method);
+    methodsByPath.set(resource.path, methods);
+  }
+  return [...methodsByPath.entries()].map(([path, methods]) => ({
+    path,
+    methods: [...methods]
+  }));
+}
+
 // src/index.ts
 async function discover(options) {
   return await runDiscovery({ detailed: false, options });
@@ -1409,7 +1652,12 @@ export {
   LEGACY_SUNSET_DATE,
   STRICT_ESCALATION_CODES,
   UPGRADE_WARNING_CODES,
+  auditContextHarness,
+  buildContextHarnessReport,
   computeUpgradeSignal,
+  defaultHarnessProbeCandidates,
   discover,
-  discoverDetailed
+  discoverDetailed,
+  getHarnessClientProfile,
+  listHarnessClientProfiles
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentcash/discovery",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Canonical OpenAPI-first discovery runtime for the agentcash ecosystem",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -44,7 +44,6 @@
     "bin",
     "README.md",
     "LICENSE",
-    ".claude/CLAUDE.md",
     "AGENTS.md"
   ],
   "engines": {
@@ -54,7 +53,6 @@
     "agentcash",
     "discovery",
     "x402",
-    "mpp",
     "openapi"
   ],
   "license": "MIT",
@@ -66,6 +64,7 @@
     "access": "public"
   },
   "dependencies": {
+    "table": "^6.9.0",
     "zod": "^4.1.13"
   },
   "devDependencies": {

package/.claude/CLAUDE.md

@@ -1,24 +0,0 @@
-# CLAUDE.md
-
-This package is the canonical discovery runtime for agentcash.
-
-## Core decisions
-
-- OpenAPI is canonical machine discovery source.
-- Discovery order: override -> OpenAPI -> `/.well-known/x402` -> DNS `_x402` -> probe.
-- `discover` is progressive and token-light.
-- `discoverDetailed` is full-waterfall with trace.
-- Compatibility adapters are isolated and removable.
-- `llms.txt` is unstructured guidance only; OpenAPI carries machine metadata.
-
-## Important defaults
-
-- `compatMode = on` (until legacy sunset window ends).
-- `verified = false` in advisory output.
-- `trustTier` values: `unverified | origin_hosted | ownership_verified | runtime_verified`.
-
-## Do not do
-
-- Do not leak legacy branches into canonical parser logic.
-- Do not introduce hidden fallback passes.
-- Do not change warning codes without a breaking version decision.