@certscore/mcp 0.2.20 → 0.2.22

package/dist/index.d.ts

@@ -11,4 +11,5 @@ export declare function getCertScoreMcpDoctorReport(options?: CertScoreMcpDoctor
     exitCode: number;
     lines: string[];
 }>;
+export { captureMcpResponse, withResponseCapture } from "./response-capture.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAMrD,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAgDD,wBAAsB,2BAA2B,CAAC,OAAO,GAAE,yBAA8B;;;GAyFxF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAMrD,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAgDD,wBAAsB,2BAA2B,CAAC,OAAO,GAAE,yBAA8B;;;GAyFxF;AAsBD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -163,3 +163,4 @@ if (isMainModule()) {
         process.exitCode = 1;
     });
 }
+export { captureMcpResponse, withResponseCapture } from "./response-capture.js";

package/dist/response-capture.d.ts

@@ -0,0 +1,15 @@
+import { type McpResponseSummary } from "@website-signal-risk-scanner/shared/dist/mcp-response-summary.js";
+type SafeMetadata = {
+    firstResult?: McpResponseSummary["firstResult"];
+    previewWaitMs?: number;
+    internalReadCount?: number;
+    message?: string;
+    recommendedNextAction?: string;
+    upstream?: McpResponseSummary["upstream"];
+};
+/** Only call with template-owned text. Never mark upstream messages or caller values. */
+export declare function withResponseCapture<T extends object>(result: T, metadata: SafeMetadata): T;
+export declare function transferResponseCapture<T extends object>(payload: unknown, result: T): T;
+export declare function captureMcpResponse(result: unknown, protocolError?: unknown): McpResponseSummary;
+export {};
+//# sourceMappingURL=response-capture.d.ts.map

package/dist/response-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-capture.d.ts","sourceRoot":"","sources":["../src/response-capture.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,kBAAkB,EAAE,MAAM,kEAAkE,CAAC;AAErI,KAAK,YAAY,GAAG;IAAE,WAAW,CAAC,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAA;CAAE,CAAC;AAEzN,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,YAAY,GAAG,CAAC,CAG1F;AACD,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAGxF;AAGD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,kBAAkB,CA6D/F"}

package/dist/response-capture.js

@@ -0,0 +1,89 @@
+import { mcpResponseSummarySchema } from "@website-signal-risk-scanner/shared/dist/mcp-response-summary.js";
+const controlled = new WeakMap();
+/** Only call with template-owned text. Never mark upstream messages or caller values. */
+export function withResponseCapture(result, metadata) {
+    controlled.set(result, { ...controlled.get(result), ...metadata });
+    return result;
+}
+export function transferResponseCapture(payload, result) {
+    const metadata = payload && typeof payload === "object" ? controlled.get(payload) : undefined;
+    return metadata ? withResponseCapture(result, metadata) : result;
+}
+const record = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : {};
+const token = (value) => typeof value === "string" && /^[a-zA-Z0-9_.:-]{1,80}$/.test(value) ? value : undefined;
+export function captureMcpResponse(result, protocolError) {
+    const outer = record(result);
+    let payload = record(outer.structuredContent);
+    if (!Object.keys(payload).length && Array.isArray(outer.content)) {
+        const text = outer.content.find((item) => item?.type === "text")?.text;
+        if (typeof text === "string") {
+            try {
+                payload = record(JSON.parse(text));
+            }
+            catch { /* Markdown is never retained. */ }
+        }
+    }
+    const scan = payload.type === "certscore_domain_latest_scan" ? record(payload.scan) : payload;
+    const guidance = record(record(outer._meta)['ai.certscore/responseGuidance']);
+    const next = record(guidance.nextAction);
+    const actionCategories = ["poll_status", "get_bundle", "get_next_page", "create_if_requested", "summarize", "review_connection", "stop_review"];
+    const actionCategory = actionCategories.find(value => value === guidance.actionCategory);
+    const page = record(guidance.pagination);
+    const fm = record(payload.findingsMetadata), inventory = record(payload.preConsentCookiesTrackers), metadata = record(payload.mcpMetadata);
+    const counts = {};
+    for (const [key, value] of Object.entries({ findingsReturned: fm.returned, findingsTotal: fm.total, inventoryReturned: inventory.returned, inventoryTotal: inventory.total })) {
+        if (Number.isInteger(value) && value >= 0)
+            counts[key] = value;
+    }
+    if (Array.isArray(metadata.omittedSections))
+        counts.omittedSections = metadata.omittedSections.filter((v) => token(v)).slice(0, 12);
+    const quota = { limit: payload.anonymousQuotaLimit, remaining: payload.anonymousQuotaRemaining, resetAt: payload.anonymousQuotaResetAt };
+    const protocol = record(protocolError);
+    const error = protocolError ? record(protocol.data) : record(payload.error);
+    const safe = controlled.get(protocolError ? protocol : outer) ?? {};
+    const retryAfterSeconds = Object.hasOwn(error, "retryAfterSeconds") ? error.retryAfterSeconds : payload.retryAfterSeconds ?? next.retryAfterSeconds;
+    const summary = {
+        version: 1, captureBasis: "response_generated", templateVersion: "2026-09-11.1",
+        kind: protocolError ? "protocol_error" : "tool_result", isError: protocolError ? true : outer.isError === true,
+        type: token(payload.type), status: token(scan.status ?? scan.scanStatus), errorCode: token(error.code), reasonCode: token(error.reasonCode),
+        ...(Number.isInteger(protocolError ? protocol.code : error.mcpCode) ? { mcpCode: protocolError ? protocol.code : error.mcpCode } : {}),
+        ...(typeof error.retryable === "boolean" ? { retryable: error.retryable } : {}),
+        ...(retryAfterSeconds === null || Number.isInteger(retryAfterSeconds) && retryAfterSeconds >= 0 && retryAfterSeconds <= 86400 ? { retryAfterSeconds } : {}),
+        recommendedNextTool: token(next.tool) ?? (payload.recommendedNextTool === null ? null : token(payload.recommendedNextTool)),
+        ...(actionCategory ? { actionCategory } : {}),
+        retryDisposition: !protocolError && outer.isError !== true && ["summarize", "get_bundle", "get_next_page", "create_if_requested", "review_connection"].includes(actionCategory ?? "") ? "not_needed" : actionCategory ? "follow_guidance" : "not_recorded",
+        scanAssociation: token(scan.scanId ?? scan.scan_id) ? "linked" : payload.type === "certscore_domain_latest_scan" && payload.scan === null ? "no_eligible_scan" : payload.type === "certscore_auth_check" ? "not_applicable" : "not_recorded",
+        ...(typeof (error.quotaConsumed ?? payload.quotaConsumed) === "boolean" ? { quotaConsumed: error.quotaConsumed ?? payload.quotaConsumed } : {}),
+        ...(typeof (error.scanStarted ?? payload.scanStarted) === "boolean" ? { scanStarted: error.scanStarted ?? payload.scanStarted } : {}),
+        ...(token(metadata.truncationReason) ? { omissionReason: token(metadata.truncationReason) } : {}),
+        ...(["new_scan", "reused_scan", "not_requested", "unknown"].includes(guidance.creationDecision) ? { creationDecision: guidance.creationDecision } : {}),
+        ...(typeof page.complete === "boolean" && (page.nextOffset === null || Number.isInteger(page.nextOffset) && page.nextOffset >= 0) ? { pagination: { complete: page.complete, nextOffset: page.nextOffset } } : {}),
+        ...(Number.isInteger(quota.limit) && quota.limit >= 0 && Number.isInteger(quota.remaining) && quota.remaining >= 0 && typeof quota.resetAt === "string" && /^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\d(?:\.\d+)?Z$/.test(quota.resetAt) ? { anonymousCreationQuota: quota } : {}),
+        ...(Object.keys(counts).length ? { completeness: counts } : {}),
+        ...safe,
+        textOmitted: Boolean((protocolError ? protocol.message : error.message) && !safe.message || (error.recommendedNextAction || payload.recommendedNextAction) && !safe.recommendedNextAction),
+        summaryTruncated: false,
+    };
+    // Issues are captured only from our controlled validation response.
+    if (safe.message && Array.isArray(error.issues))
+        summary.issues = error.issues.slice(0, 8).map((issue) => ({ field: token(issue.field) ?? "arguments", code: token(issue.code) ?? "invalid", ...(issue.required === true ? { required: true } : {}) }));
+    for (const [key, limit] of [["message", 400], ["recommendedNextAction", 800]]) {
+        if ((summary[key]?.length ?? 0) > limit) {
+            summary[key] = summary[key].slice(0, limit);
+            summary.summaryTruncated = true;
+        }
+    }
+    // Bound UTF-8 bytes as well as character counts; preserve diagnosis before prose.
+    for (const key of ["recommendedNextAction", "message", "issues"]) {
+        if (Buffer.byteLength(JSON.stringify(summary)) <= 2048)
+            break;
+        delete summary[key];
+        summary.summaryTruncated = true;
+        summary.textOmitted = true;
+    }
+    const parsed = mcpResponseSummarySchema.safeParse(summary);
+    return parsed.success ? parsed.data : {
+        version: 1, captureBasis: "response_generated", templateVersion: "2026-09-11.1",
+        kind: summary.kind, isError: summary.isError, textOmitted: true, summaryTruncated: true,
+    };
+}

package/dist/response-guidance.d.ts

@@ -0,0 +1,4 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+/** Presentation metadata only: never derive findings, eligibility or quota from observations. */
+export declare function withResponseGuidance(tool: string, input: unknown, result: CallToolResult, now?: number): CallToolResult;
+//# sourceMappingURL=response-guidance.d.ts.map

package/dist/response-guidance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-guidance.d.ts","sourceRoot":"","sources":["../src/response-guidance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAuBzE,iGAAiG;AACjG,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,SAAa,GAAG,cAAc,CAqE3H"}

package/dist/response-guidance.js

@@ -0,0 +1,100 @@
+import { transferResponseCapture } from './response-capture.js';
+const record = (value) => value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+const string = (value) => typeof value === 'string' && value.trim() ? value.slice(0, 1000) : null;
+const toolPurposes = {
+    certscore_get_connection_status: "Check current access and quota without creating a scan.",
+    certscore_scan_site: 'Start the requested public-website scan; latest may reuse an eligible result, refresh requests a new scan.',
+    certscore_get_scan: 'Read one scan’s identity, lifecycle and overview without starting another scan.',
+    certscore_get_scan_status: 'Check whether a scan is ready; follow the polling interval instead of repeatedly fetching reports.',
+    certscore_get_report_evidence_page: 'Retrieve the complete report projection in bounded pages, preserving observation limitations.',
+    certscore_get_report: 'Read the report in JSON or Markdown for the requested level of detail.',
+    certscore_get_evidence: 'Inspect retained supporting evidence when the report summary is insufficient.',
+    certscore_get_scan_bundle: 'Use this as the main completed-scan summary: score, findings, evidence and pre-consent inventory together.',
+    certscore_export_findings: 'Export the returned canonical findings for downstream review or processing.',
+    certscore_list_findings: 'Browse canonical findings in pages; use their exact IDs for explanations.',
+    certscore_get_pre_consent_cookies_trackers: 'Inspect observed pre-consent inventory for this exact scan; unknown purpose is not proof of non-essential use.',
+    certscore_explain_finding: 'Explain one returned finding and its reviewer action, grounded in retained evidence.',
+    certscore_get_latest_domain_scan: 'Find an existing eligible domain scan before requesting new work when freshness is not required.',
+    certscore_get_latest_domain_pre_consent_cookies_trackers: 'Read pre-consent inventory from the latest eligible domain scan without starting a new scan.',
+};
+/** Presentation metadata only: never derive findings, eligibility or quota from observations. */
+export function withResponseGuidance(tool, input, result, now = Date.now()) {
+    if (result.isError || !result.structuredContent)
+        return result;
+    const args = record(input), payload = record(result.structuredContent);
+    const scan = payload.scan === null ? {} : Object.keys(record(payload.scan)).length ? record(payload.scan) : payload;
+    const summary = record(scan.summary), provenance = record(scan.provenance);
+    const noGo = scan.resultDisposition === 'no_go' || payload.resultDisposition === 'no_go';
+    const scanId = string(scan.scanId) ?? string(scan.scan_id) ?? string(args.scanId);
+    const status = string(scan.status);
+    const completedAt = string(scan.completedAt);
+    const parsedTime = completedAt ? Date.parse(completedAt) : NaN;
+    const ageSeconds = Number.isFinite(parsedTime) && parsedTime <= now ? Math.floor((now - parsedTime) / 1000) : null;
+    const isCreation = tool === 'certscore_scan_site';
+    const active = ['queued', 'running', 'finalizing'].includes(status ?? '');
+    const ready = ['completed', 'completed_limited'].includes(status ?? '');
+    const pagination = record(payload.pagination);
+    const hasMore = pagination.truncated === true || pagination.complete === false;
+    const nextOffset = hasMore && Number.isInteger(pagination.offset) && Number.isInteger(pagination.returned) && pagination.returned > 0
+        ? pagination.offset + pagination.returned : null;
+    let nextAction = { tool: null, arguments: null, instruction: 'Summarize the returned observations and coverage limitations.' };
+    if (tool === 'certscore_get_connection_status')
+        nextAction = { tool: null, arguments: null, instruction: string(record(payload.diagnostics).nextAction) ?? 'Review the connection diagnostics.' };
+    else if (noGo)
+        nextAction = { tool: null, arguments: null, instruction: string(scan.recommendedNextAction) ?? 'Review the retained no-go reason. Do not continue polling this scan.' };
+    else if (scanId && active)
+        nextAction = { tool: 'certscore_get_scan_status', arguments: { scanId }, retryAfterSeconds: scan.retryAfterSeconds ?? null, instruction: 'Wait for the returned polling interval before checking status.' };
+    else if (scanId && ready && payload.resultDisposition !== 'no_go' && ['certscore_scan_site', 'certscore_get_scan', 'certscore_get_scan_status', 'certscore_get_latest_domain_scan'].includes(tool))
+        nextAction = { tool: 'certscore_get_scan_bundle', arguments: { scanId }, instruction: 'Fetch the report bundle to summarize this completed scan.' };
+    else if (tool === 'certscore_get_report_evidence_page' && typeof pagination.nextCursor === 'string')
+        nextAction = { tool, arguments: { scanId, cursor: pagination.nextCursor }, instruction: 'Fetch the next report evidence page. Keep the same snapshot until export is complete.' };
+    else if (tool === 'certscore_list_findings' && nextOffset !== null)
+        nextAction = { tool, arguments: { scanId, offset: nextOffset, limit: pagination.limit }, instruction: 'Fetch the next page if more findings are needed.' };
+    else if (payload.scan === null)
+        nextAction = { tool: 'certscore_scan_site', arguments: null, instruction: 'No eligible retained scan was returned. Start a scan only if requested, using the intended public website URL.' };
+    else if (['failed', 'cancelled', 'canceled', 'no_go'].includes(status ?? '') || payload.resultDisposition === 'no_go')
+        nextAction = { tool: null, arguments: null, instruction: string(payload.recommendedNextAction) ?? 'Review the terminal error or no-go reason. Do not continue polling this scan.' };
+    const actionCategory = tool === 'certscore_get_connection_status' ? 'review_connection'
+        : nextAction.tool === 'certscore_get_scan_status' ? 'poll_status'
+            : nextAction.tool === 'certscore_get_scan_bundle' ? 'get_bundle'
+                : ['certscore_list_findings', 'certscore_get_report_evidence_page'].includes(String(nextAction.tool)) ? 'get_next_page'
+                    : nextAction.tool === 'certscore_scan_site' ? 'create_if_requested'
+                        : noGo || ['failed', 'cancelled', 'canceled', 'no_go'].includes(status ?? '') ? 'stop_review' : 'summarize';
+    const findingIds = (Array.isArray(payload.findings) ? payload.findings : Array.isArray(payload.topFindings) ? payload.topFindings : [])
+        .slice(0, 20).map((item) => string(record(item).id)).filter(Boolean);
+    if (tool === 'certscore_explain_finding' && string(payload.id))
+        findingIds.push(string(payload.id));
+    const guidance = {
+        version: 'certscore.mcp-response-guidance.v1', tool, purpose: toolPurposes[tool] ?? null, scanId, status,
+        score: typeof scan.score === 'number' ? scan.score : typeof summary.score === 'number' ? summary.score : null,
+        risk: string(scan.riskLevel) ?? string(summary.riskLevel) ?? string(scan.risk) ?? string(summary.risk),
+        coverage: string(scan.coverage) ?? string(record(scan.coverage).status),
+        reportUrl: string(scan.reportUrl) ?? string(record(scan.links).report),
+        retrieval: isCreation ? 'creation_response' : tool.includes('latest_domain') ? 'latest_eligible_domain_scan' : 'retained_result',
+        creationDecision: isCreation ? string(provenance.creationDecision) ?? (payload.reused === true ? 'reused_scan' : 'unknown') : 'not_requested',
+        quotaConsumed: typeof payload.quotaConsumed === 'boolean' ? payload.quotaConsumed : null,
+        completedAt, ageSeconds, scanFrom: string(scan.scanFrom), findingIds,
+        returnedRows: Array.isArray(payload.rows) ? payload.rows.length : Array.isArray(record(payload.preConsentCookiesTrackers).rows) ? payload.preConsentCookiesTrackers.rows.length : null,
+        evidenceLimits: { truncated: record(payload.evidenceMetadata).truncated ?? record(payload.mcpMetadata).truncated ?? null, total: record(payload.evidenceMetadata).total ?? null, returned: record(payload.evidenceMetadata).returned ?? null },
+        pagination: Object.keys(pagination).length ? { ...pagination, nextOffset, complete: !hasMore } : null,
+        optionalFollowUps: !noGo && !active && scanId && findingIds.length ? [
+            { tool: 'certscore_explain_finding', arguments: { scanId, findingId: findingIds[0] }, reason: 'Explain a returned finding using retained evidence.' },
+            { prompt: 'certscore_remediation_checklist', arguments: { scanId }, reason: 'Prepare a proposed checklist; do not claim remediation is verified.' }
+        ] : [],
+        nextAction, actionCategory,
+    };
+    // Keep full machine metadata; avoid repeating the entire envelope in model-visible text.
+    const compact = Object.fromEntries(Object.entries({
+        scanId, status, score: guidance.score, risk: guidance.risk, reportUrl: guidance.reportUrl,
+        quotaConsumed: guidance.quotaConsumed, nextAction,
+        ...(guidance.pagination ? { pagination: guidance.pagination } : {})
+    }).filter(([, value]) => value !== null));
+    const overview = `CertScore guidance: ${JSON.stringify(compact)}`;
+    const explanation = tool === 'certscore_explain_finding'
+        ? `\nFinding: ${JSON.stringify({ id: string(payload.id), observation: string(payload.evidenceSummary) ?? string(record(payload.evidence).summary), interpretation: string(payload.plainEnglish), reviewerAction: string(payload.nextStep) })}` : '';
+    return transferResponseCapture(result, {
+        ...result,
+        _meta: { ...result._meta, 'ai.certscore/responseGuidance': guidance },
+        content: [...result.content, { type: 'text', text: overview + explanation }],
+    });
+}

package/dist/server.d.ts

@@ -1,9 +1,14 @@
+import type { McpResponseSummary } from "@website-signal-risk-scanner/shared";
 import { type McpCallerInput } from "@website-signal-risk-scanner/shared/dist/mcp-caller-input.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { type RequestInfo } from "@modelcontextprotocol/sdk/types.js";
 import { type McpTaskContext } from "@website-signal-risk-scanner/shared/dist/mcp-product-context.js";
 export interface CertScoreMcpOptions {
     apiKey?: string;
+    /** Validated hosted OAuth scopes; never inferred from an unverified token. */
+    grantedOAuthScopes?: readonly string[];
+    /** Trusted host callback providing the current request's validated credential. */
+    resolveApiKey?: () => string;
     baseUrl?: string;
     forwardedClientIp?: string | null;
     resolveForwardedClientIp?: (headers: RequestInfo["headers"]) => string | null;
@@ -14,19 +19,31 @@ export interface CertScoreMcpOptions {
     toolProfile?: "full" | "light";
     initialPreConsentPreviewWaitMs?: number;
     exampleDomainDemoUrl?: string | null;
+    resolveRequestId?: () => string | undefined;
+    onToolInvocationStarted?: (input: {
+        requestId: string;
+        toolName: string;
+        startedAt: string;
+    }) => void | Promise<void>;
     onToolInvocation?: (observation: McpToolInvocationObservation, requestContext: McpToolInvocationRequestContext) => void | Promise<void>;
 }
 export type McpToolInvocationRequestContext = {
     headers: RequestInfo["headers"] | null;
 };
 export type McpToolInvocationObservation = {
+    requestId?: string;
+    timing?: {
+        startedAt: string;
+        responseGeneratedAt: string;
+    };
     callerInput?: McpCallerInput;
     captureBasis?: "protocol_request";
     taskContext?: McpTaskContext;
     response?: {
-        bytes: number;
+        bytes: number | null;
         truncated: boolean | null;
         effectiveMaxBytes?: number;
+        summary?: McpResponseSummary;
     };
     requestArguments?: {
         values: Record<string, string | number | boolean>;

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}