teppi-check 0.2.0 → 0.2.1

package/npm/cli.js

@@ -6955,7 +6955,8 @@ function toolsFrom(result) {
       {
         name,
         description: text(tool.description),
-        hasInputSchema: typeof tool.inputSchema === "object" && tool.inputSchema !== null
+        inputSchema: tool.inputSchema ?? null,
+        outputSchema: tool.outputSchema ?? null
       }
     ];
   });
@@ -6981,6 +6982,8 @@ async function turn(response, method) {
   };
 }
 var DEADLINE_MS = 45e3;
+var MAX_PAGES = 20;
+var MAX_TOOLS = 2e3;
 async function probeMcp(url, options = {}) {
   const clockFor = options.now ?? Date.now;
   const startedFor = clockFor();
@@ -6996,7 +6999,10 @@ async function probeMcp(url, options = {}) {
         protocolVersion: null,
         serverName: null,
         serverVersion: null,
+        instructions: null,
         tools: null,
+        pages: null,
+        truncated: false,
         note: "never answered and never gave up"
       }),
       options.deadlineMs ?? DEADLINE_MS
@@ -7008,6 +7014,36 @@ async function probeMcp(url, options = {}) {
     clearTimeout(timer);
   }
 }
+async function walkTools(send, session) {
+  const tools = [];
+  let cursor = null;
+  let pages = 0;
+  let status = 200;
+  for (; ; ) {
+    const asked = request(2 + pages, "tools/list", cursor === null ? void 0 : { cursor });
+    const listed = await turn(await send(asked, session), "tools/list");
+    if (listed.kind === "refused") {
+      return {
+        kind: "refused",
+        reach: listed.reach,
+        status: listed.status,
+        note: "it opened but would not list"
+      };
+    }
+    if (listed.kind === "broken")
+      return { kind: "broken", status: listed.status, note: listed.note };
+    tools.push(...toolsFrom(listed.value));
+    status = listed.status;
+    pages += 1;
+    const next = text(listed.value.nextCursor);
+    if (next === null || next === cursor)
+      return { kind: "listed", status, tools, pages, truncated: false };
+    if (pages >= MAX_PAGES || tools.length >= MAX_TOOLS) {
+      return { kind: "listed", status, tools, pages, truncated: true };
+    }
+    cursor = next;
+  }
+}
 async function handshake(url, options) {
   const doFetch = options.fetchImpl ?? fetch;
   const clock = options.now ?? Date.now;
@@ -7019,7 +7055,10 @@ async function handshake(url, options) {
     protocolVersion: null,
     serverName: null,
     serverVersion: null,
-    tools: null
+    instructions: null,
+    tools: null,
+    pages: null,
+    truncated: false
   };
   const send = (body, sessionId) => doFetch(url, {
     ...initFor(body, sessionId, userAgent),
@@ -7053,34 +7092,28 @@ async function handshake(url, options) {
       ...base,
       protocolVersion: text(hello.value.protocolVersion),
       serverName: text(info.name),
-      serverVersion: text(info.version)
+      serverVersion: text(info.version),
+      instructions: text(hello.value.instructions)
     };
     await send(notification("notifications/initialized"), session).catch(() => void 0);
-    const listed = await turn(await send(request(2, "tools/list"), session), "tools/list");
-    if (listed.kind === "refused") {
-      return {
-        ...said,
-        reach: listed.reach,
-        httpStatus: listed.status,
-        handshakeMs: took(),
-        note: "it opened but would not list"
-      };
-    }
-    if (listed.kind === "broken") {
+    const walked = await walkTools(send, session);
+    if (walked.kind !== "listed") {
       return {
         ...said,
-        reach: "error",
-        httpStatus: listed.status,
+        reach: walked.kind === "refused" ? walked.reach : "error",
+        httpStatus: walked.status,
         handshakeMs: took(),
-        note: listed.note
+        note: walked.note
       };
     }
     return {
       ...said,
       reach: "readable",
-      httpStatus: listed.status,
+      httpStatus: walked.status,
       handshakeMs: took(),
-      tools: toolsFrom(listed.value),
+      tools: walked.tools,
+      pages: walked.pages,
+      truncated: walked.truncated,
       note: null
     };
   } catch (err) {
@@ -7096,7 +7129,7 @@ async function handshake(url, options) {
 }
 function toolsDigest(tools) {
   const canonical = JSON.stringify(
-    [...tools].map((t) => [t.name, t.description ?? "", t.hasInputSchema]).sort((a, b) => a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0)
+    [...tools].map((t) => [t.name, t.description ?? "", t.inputSchema !== null]).sort((a, b) => a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0)
   );
   return createHash("sha256").update(canonical).digest("hex");
 }
@@ -7146,7 +7179,7 @@ function checksFor(seen) {
     return checks;
   }
   checks.push(pass("tools", "listed its tools", `${seen.tools.length} tool(s)`));
-  const bare = seen.tools.filter((t) => !t.hasInputSchema).map((t) => t.name);
+  const bare = seen.tools.filter((t) => t.inputSchema === null).map((t) => t.name);
   checks.push(
     bare.length === 0 ? pass("input-schemas", "every tool declared an input schema") : fail(
       "input-schemas",
@@ -7441,6 +7474,19 @@ ${body}`);
     verdict: verdictOf(checks)
   };
 }
+function askedForPayment(result) {
+  return result.checks.some((c) => c.id === "status_402" && c.status === "pass");
+}
+async function probeEitherVerb(run, explicit) {
+  const verbs = explicit === void 0 ? ["GET", "POST"] : [explicit.toUpperCase()];
+  let first;
+  for (const method of verbs) {
+    const attempt = await run(method);
+    if (askedForPayment(attempt)) return attempt;
+    first ??= attempt;
+  }
+  return first;
+}
 
 // src/report.ts
 var ANSI = {
@@ -7510,7 +7556,7 @@ var USAGE = `
   same form the public record uses.
 
     --mcp               handshake a remote mcp server instead of an x402 endpoint
-    --method <verb>     default POST
+    --method <verb>     tries get then post when not given
     --body <json|@file> default {}
     --json              machine readable output
     --timeout <ms>      default 15000
@@ -7559,17 +7605,18 @@ async function main() {
     ...values["user-agent"] ? { userAgent: values["user-agent"] } : {}
   };
   const rawBody = values.body ?? "{}";
-  const result = values.mcp ? await probeMcpEndpoint(shared) : await probe({
-    ...shared,
-    method: values.method?.toUpperCase() ?? "POST",
-    body: rawBody.startsWith("@") ? readFileSync(rawBody.slice(1), "utf8") : rawBody
-  });
+  const body = rawBody.startsWith("@") ? readFileSync(rawBody.slice(1), "utf8") : rawBody;
+  const found = await probeEitherVerb(
+    (method) => probe({ ...shared, method, body }),
+    values.method
+  );
+  const out = values.mcp ? await probeMcpEndpoint(shared) : found;
   stdout.write(
-    values.json ? `${formatJson(result)}
-` : formatText(result, shouldColour(env, stdout.isTTY === true))
+    values.json ? `${formatJson(out)}
+` : formatText(out, shouldColour(env, stdout.isTTY === true))
   );
-  if (!result.reachable) exit(2);
-  exit(result.verdict === "pass" ? 0 : 1);
+  if (!out.reachable) exit(2);
+  exit(out.verdict === "pass" ? 0 : 1);
 }
 main().catch((err) => {
   stdout.write(`${err.message}

package/npm/index.js

@@ -7099,7 +7099,8 @@ function toolsFrom(result) {
       {
         name,
         description: text(tool.description),
-        hasInputSchema: typeof tool.inputSchema === "object" && tool.inputSchema !== null
+        inputSchema: tool.inputSchema ?? null,
+        outputSchema: tool.outputSchema ?? null
       }
     ];
   });
@@ -7125,6 +7126,8 @@ async function turn(response, method) {
   };
 }
 var DEADLINE_MS = 45e3;
+var MAX_PAGES = 20;
+var MAX_TOOLS = 2e3;
 async function probeMcp(url, options = {}) {
   const clockFor = options.now ?? Date.now;
   const startedFor = clockFor();
@@ -7140,7 +7143,10 @@ async function probeMcp(url, options = {}) {
         protocolVersion: null,
         serverName: null,
         serverVersion: null,
+        instructions: null,
         tools: null,
+        pages: null,
+        truncated: false,
         note: "never answered and never gave up"
       }),
       options.deadlineMs ?? DEADLINE_MS
@@ -7152,6 +7158,36 @@ async function probeMcp(url, options = {}) {
     clearTimeout(timer);
   }
 }
+async function walkTools(send, session) {
+  const tools = [];
+  let cursor = null;
+  let pages = 0;
+  let status = 200;
+  for (; ; ) {
+    const asked = request(2 + pages, "tools/list", cursor === null ? void 0 : { cursor });
+    const listed = await turn(await send(asked, session), "tools/list");
+    if (listed.kind === "refused") {
+      return {
+        kind: "refused",
+        reach: listed.reach,
+        status: listed.status,
+        note: "it opened but would not list"
+      };
+    }
+    if (listed.kind === "broken")
+      return { kind: "broken", status: listed.status, note: listed.note };
+    tools.push(...toolsFrom(listed.value));
+    status = listed.status;
+    pages += 1;
+    const next = text(listed.value.nextCursor);
+    if (next === null || next === cursor)
+      return { kind: "listed", status, tools, pages, truncated: false };
+    if (pages >= MAX_PAGES || tools.length >= MAX_TOOLS) {
+      return { kind: "listed", status, tools, pages, truncated: true };
+    }
+    cursor = next;
+  }
+}
 async function handshake(url, options) {
   const doFetch = options.fetchImpl ?? fetch;
   const clock = options.now ?? Date.now;
@@ -7163,7 +7199,10 @@ async function handshake(url, options) {
     protocolVersion: null,
     serverName: null,
     serverVersion: null,
-    tools: null
+    instructions: null,
+    tools: null,
+    pages: null,
+    truncated: false
   };
   const send = (body, sessionId) => doFetch(url, {
     ...initFor(body, sessionId, userAgent),
@@ -7197,34 +7236,28 @@ async function handshake(url, options) {
       ...base,
       protocolVersion: text(hello.value.protocolVersion),
       serverName: text(info.name),
-      serverVersion: text(info.version)
+      serverVersion: text(info.version),
+      instructions: text(hello.value.instructions)
     };
     await send(notification("notifications/initialized"), session).catch(() => void 0);
-    const listed = await turn(await send(request(2, "tools/list"), session), "tools/list");
-    if (listed.kind === "refused") {
+    const walked = await walkTools(send, session);
+    if (walked.kind !== "listed") {
       return {
         ...said,
-        reach: listed.reach,
-        httpStatus: listed.status,
-        handshakeMs: took(),
-        note: "it opened but would not list"
-      };
-    }
-    if (listed.kind === "broken") {
-      return {
-        ...said,
-        reach: "error",
-        httpStatus: listed.status,
+        reach: walked.kind === "refused" ? walked.reach : "error",
+        httpStatus: walked.status,
         handshakeMs: took(),
-        note: listed.note
+        note: walked.note
       };
     }
     return {
       ...said,
       reach: "readable",
-      httpStatus: listed.status,
+      httpStatus: walked.status,
       handshakeMs: took(),
-      tools: toolsFrom(listed.value),
+      tools: walked.tools,
+      pages: walked.pages,
+      truncated: walked.truncated,
       note: null
     };
   } catch (err) {
@@ -7240,7 +7273,7 @@ async function handshake(url, options) {
 }
 function toolsDigest(tools) {
   const canonical = JSON.stringify(
-    [...tools].map((t) => [t.name, t.description ?? "", t.hasInputSchema]).sort((a, b) => a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0)
+    [...tools].map((t) => [t.name, t.description ?? "", t.inputSchema !== null]).sort((a, b) => a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0)
   );
   return createHash("sha256").update(canonical).digest("hex");
 }
@@ -7290,7 +7323,7 @@ function checksFor(seen) {
     return checks;
   }
   checks.push(pass2("tools", "listed its tools", `${seen.tools.length} tool(s)`));
-  const bare = seen.tools.filter((t) => !t.hasInputSchema).map((t) => t.name);
+  const bare = seen.tools.filter((t) => t.inputSchema === null).map((t) => t.name);
   checks.push(
     bare.length === 0 ? pass2("input-schemas", "every tool declared an input schema") : fail2(
       "input-schemas",

package/npm/mcp-probe/index.d.ts

@@ -1,2 +1,2 @@
 export { JSON_RPC, lastEventData, notification, PREFERRED_VERSION, PROTOCOL_VERSIONS, type RpcResult, readAnswer, request, } from './frame.js';
-export { CLIENT, HANDSHAKE_TIMEOUT_MS, INITIALIZE, initFor, type McpObservation, type ProbeOptions, probeMcp, type Reach, reachFor, type Tool, toolsDigest, toolsFrom, } from './probe.js';
+export { CLIENT, definitionDigest, definitionOf, HANDSHAKE_TIMEOUT_MS, INITIALIZE, initFor, MAX_PAGES, MAX_TOOLS, type McpObservation, type ProbeOptions, probeMcp, type Reach, reachFor, type Tool, toolsDigest, toolsFrom, } from './probe.js';

package/npm/mcp-probe/probe.d.ts

@@ -7,7 +7,8 @@ export type Reach = 'readable' | 'auth_required' | 'payment_required' | 'dead' |
 export type Tool = {
     readonly name: string;
     readonly description: string | null;
-    readonly hasInputSchema: boolean;
+    readonly inputSchema: unknown;
+    readonly outputSchema: unknown;
 };
 export type McpObservation = {
     readonly url: string;
@@ -18,7 +19,10 @@ export type McpObservation = {
     readonly protocolVersion: string | null;
     readonly serverName: string | null;
     readonly serverVersion: string | null;
+    readonly instructions: string | null;
     readonly tools: readonly Tool[] | null;
+    readonly pages: number | null;
+    readonly truncated: boolean;
     readonly note: string | null;
 };
 export type ProbeOptions = {
@@ -40,5 +44,9 @@ export declare const INITIALIZE: {
 export declare function toolsFrom(result: Record<string, unknown>): Tool[];
 export declare function reachFor(status: number): Reach | null;
 export declare const DEADLINE_MS = 45000;
+export declare const MAX_PAGES = 20;
+export declare const MAX_TOOLS = 2000;
 export declare function probeMcp(url: string, options?: ProbeOptions): Promise<McpObservation>;
 export declare function toolsDigest(tools: readonly Tool[]): string;
+export declare function definitionOf(seen: McpObservation): string;
+export declare function definitionDigest(seen: McpObservation): string;

package/npm/probe.d.ts

@@ -28,4 +28,6 @@ export type ProbeResult = {
     readonly verdict: 'pass' | 'fail';
 };
 export declare function probe(options: ProbeOptions): Promise<ProbeResult>;
+export declare function askedForPayment(result: ProbeResult): boolean;
+export declare function probeEitherVerb(run: (method: string) => Promise<ProbeResult>, explicit?: string): Promise<ProbeResult>;
 //# sourceMappingURL=probe.d.ts.map

package/npm/probe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../src/probe.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,KAAK,EAA8C,MAAM,aAAa,CAAC;AAGrF,eAAO,MAAM,kBAAkB,SAAS,CAAC;AAEzC,MAAM,MAAM,YAAY,GAAG;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1F,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC,CAAC;AAgBF,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA+DvE"}
+{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../src/probe.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,KAAK,EAA8C,MAAM,aAAa,CAAC;AAGrF,eAAO,MAAM,kBAAkB,SAAS,CAAC;AAEzC,MAAM,MAAM,YAAY,GAAG;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1F,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC,CAAC;AAgBF,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA+DvE;AAGD,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAE5D;AAGD,wBAAsB,eAAe,CACpC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,EAC7C,QAAQ,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC,CAStB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "teppi-check",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Probe any paid endpoint and print what it actually returns for the money. Reproduces any entry in the Teppi record.",
   "keywords": [
     "x402",