@cliwant/mcp-sam-gov 1.5.0 → 1.7.0

package/dist/errors.d.ts

@@ -41,6 +41,16 @@ export type ToolError = {
     upstreamStatus?: number;
     /** Endpoint that failed — for ops. */
     upstreamEndpoint?: string;
+    /**
+     * PULL-only feedback loop (feedback.ts). A PREFILLED GitHub new-issue URL, set
+     * by the dispatcher ONLY for the two "something may be broken" kinds —
+     * `schema_drift` and `upstream_unavailable`. The agent MAY relay it to the
+     * human, who opens and submits it; the server NEVER posts. Carries only the
+     * tool name, error kind, and server version — no arguments, no PII. Absent on
+     * user/expected errors (invalid_input, not_found, rate_limited) so the 429 and
+     * bad-input envelopes stay byte-identical.
+     */
+    report?: string;
     /**
      * Set true when the upstream EXPLICITLY asked us to wait — i.e. a 429, or a
      * 5xx that CARRIED a `Retry-After` header (ADR-0045 M2). The resilience layer

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,MAAM,MAAM,SAAS;AACnB,iDAAiD;AAC/C,cAAc;AAChB,mDAAmD;GACjD,sBAAsB;AACxB,6CAA6C;GAC3C,WAAW;AACb,sEAAsE;GACpE,eAAe;AACjB,oEAAoE;GAClE,cAAc;AAChB,kCAAkC;GAChC,SAAS,CAAC;AAEd,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,SAAS,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,UAAU,CAAC,CAAC,IACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GACrB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAIpC,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;gBAClB,SAAS,EAAE,SAAS;CAKjC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,QAAQ,EACX,QAAQ,EAAE,MAAM,GACf,SAAS,CA6DX;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAKvD;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,QAAQ,CAAC,CA0EnB;AAcD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CA0CzE"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,MAAM,MAAM,SAAS;AACnB,iDAAiD;AAC/C,cAAc;AAChB,mDAAmD;GACjD,sBAAsB;AACxB,6CAA6C;GAC3C,WAAW;AACb,sEAAsE;GACpE,eAAe;AACjB,oEAAoE;GAClE,cAAc;AAChB,kCAAkC;GAChC,SAAS,CAAC;AAEd,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,SAAS,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,UAAU,CAAC,CAAC,IACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GACrB;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAIpC,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;gBAClB,SAAS,EAAE,SAAS;CAKjC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,CAAC,EAAE,QAAQ,EACX,QAAQ,EAAE,MAAM,GACf,SAAS,CA6DX;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAKvD;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,QAAQ,CAAC,CA0EnB;AAcD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CA0CzE"}

package/dist/errors.js.map

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

package/dist/feedback.d.ts

@@ -0,0 +1,64 @@
+/**
+ * feedback.ts — the in-product feedback → GitHub-issue loop (KEYLESS, PULL-only).
+ *
+ * Why this exists
+ * ----------------
+ * This server's "user" is an AI agent, not a human at a keyboard. So the way we
+ * collect "this looked wrong / this is broken / I wish it could do X" from real
+ * usage is THROUGH the agent: a tool (or an error envelope) hands the agent a
+ * PREFILLED GitHub "new issue" URL, and the agent offers it to the human, who
+ * opens and submits it.
+ *
+ * Hard guarantees (consistent with the server's keyless / honest / no-telemetry
+ * posture — and with the rule never to submit a form on the user's behalf):
+ *   • PULL only. The server NEVER posts to GitHub. It builds a link; the human
+ *     clicks and submits. No token, no account, no auto-submit, no network call.
+ *   • No PII. A prefill carries only the tool name, server version, and (for the
+ *     `feedback` tool) a caller-supplied one-line summary. It NEVER embeds the
+ *     user's tool arguments or the upstream response, and every prefill body
+ *     tells the human to redact anything sensitive before submitting.
+ *   • Non-nagging. Error links are attached only to the two "something may be
+ *     broken" kinds (schema_drift, upstream_unavailable) — never to expected
+ *     outcomes (not_found, invalid_input, rate_limited).
+ */
+export declare const REPO_URL = "https://github.com/cliwant/mcp-sam-gov";
+export type FeedbackKind = "bug" | "feature" | "wrong_output";
+/**
+ * The prefilled report link attached to a schema_drift / upstream_unavailable
+ * error envelope. Carries ONLY tool + kind + server version — no args, no PII.
+ */
+export declare function reportUrlForError(tool: string, kind: string, version: string): string;
+/**
+ * The ONLY two error kinds that get a prefilled report link — the "something may
+ * be broken on our side" kinds. Expected/user errors (invalid_input, not_found,
+ * rate_limited) are deliberately excluded so their envelopes stay byte-identical.
+ */
+export declare const REPORTABLE_ERROR_KINDS: ReadonlySet<string>;
+/**
+ * Attach a prefilled `report` URL to an error envelope IN PLACE, but only for a
+ * reportable kind. A no-op (envelope unchanged) for every other kind. Centralizes
+ * the policy so the dispatcher and the tests agree on exactly which kinds report.
+ */
+export declare function maybeAttachReport(error: {
+    kind: string;
+    report?: string;
+}, tool: string, version: string): void;
+export type FeedbackResult = {
+    reportUrl: string;
+    repo: string;
+    willPost: false;
+    instructions: string;
+    privacy: string;
+};
+/**
+ * The `feedback` tool handler. Turns a caller's (agent's) bug/feature/wrong-output
+ * report into a PREFILLED GitHub new-issue URL for the HUMAN to open and submit.
+ * Pure + keyless: no network, no posting. `summary` is caller-supplied free text
+ * and is trusted to be non-sensitive (the description + privacy note say so).
+ */
+export declare function feedbackTool(input: {
+    kind?: FeedbackKind;
+    tool?: string;
+    summary?: string;
+}): FeedbackResult;
+//# sourceMappingURL=feedback.d.ts.map

package/dist/feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../src/feedback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,eAAO,MAAM,QAAQ,2CAA2C,CAAC;AAGjE,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,SAAS,GAAG,cAAc,CAAC;AAkB9D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAsBrF;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,MAAM,CAGrD,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EACxC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,IAAI,CAIN;AAaD,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,cAAc,CAgCjB"}

package/dist/feedback.js

@@ -0,0 +1,131 @@
+/**
+ * feedback.ts — the in-product feedback → GitHub-issue loop (KEYLESS, PULL-only).
+ *
+ * Why this exists
+ * ----------------
+ * This server's "user" is an AI agent, not a human at a keyboard. So the way we
+ * collect "this looked wrong / this is broken / I wish it could do X" from real
+ * usage is THROUGH the agent: a tool (or an error envelope) hands the agent a
+ * PREFILLED GitHub "new issue" URL, and the agent offers it to the human, who
+ * opens and submits it.
+ *
+ * Hard guarantees (consistent with the server's keyless / honest / no-telemetry
+ * posture — and with the rule never to submit a form on the user's behalf):
+ *   • PULL only. The server NEVER posts to GitHub. It builds a link; the human
+ *     clicks and submits. No token, no account, no auto-submit, no network call.
+ *   • No PII. A prefill carries only the tool name, server version, and (for the
+ *     `feedback` tool) a caller-supplied one-line summary. It NEVER embeds the
+ *     user's tool arguments or the upstream response, and every prefill body
+ *     tells the human to redact anything sensitive before submitting.
+ *   • Non-nagging. Error links are attached only to the two "something may be
+ *     broken" kinds (schema_drift, upstream_unavailable) — never to expected
+ *     outcomes (not_found, invalid_input, rate_limited).
+ */
+export const REPO_URL = "https://github.com/cliwant/mcp-sam-gov";
+const NEW_ISSUE_URL = `${REPO_URL}/issues/new`;
+const REDACT_NOTE = "⚠️ This is a PUBLIC issue. Do NOT paste API keys, credentials, personal data, or sensitive query values — redact anything private before you submit.";
+/**
+ * Build a GitHub "new issue" URL with a prefilled title/body/labels. Everything
+ * is URL-encoded via URLSearchParams. A prefilled label that does not exist in
+ * the repo is simply ignored by GitHub (the issue still opens) — never an error.
+ */
+function buildIssueUrl(params) {
+    const q = new URLSearchParams();
+    q.set("title", params.title);
+    q.set("body", params.body);
+    if (params.labels.length > 0)
+        q.set("labels", params.labels.join(","));
+    return `${NEW_ISSUE_URL}?${q.toString()}`;
+}
+/**
+ * The prefilled report link attached to a schema_drift / upstream_unavailable
+ * error envelope. Carries ONLY tool + kind + server version — no args, no PII.
+ */
+export function reportUrlForError(tool, kind, version) {
+    const title = `[${tool}] ${kind}`;
+    const kindHint = kind === "schema_drift"
+        ? "schema_drift means the government API very likely changed its response shape, so the wrapper needs updating — this is the single most useful thing to report."
+        : "upstream_unavailable is often a transient government-side outage; please report only if it PERSISTS or the endpoint appears to have permanently moved.";
+    const body = [
+        "**Reporting a tool problem** (this link was suggested by the server).",
+        "",
+        `- **Tool:** \`${tool}\``,
+        `- **Error kind:** \`${kind}\``,
+        `- **Server version:** \`${version}\``,
+        "",
+        "**What I was trying to do:** _(describe — no sensitive values)_",
+        "",
+        "**Why it looks wrong / how often it happens:** _(describe)_",
+        "",
+        `_${kindHint}_`,
+        "",
+        REDACT_NOTE,
+    ].join("\n");
+    return buildIssueUrl({ title, body, labels: ["from-tool"] });
+}
+/**
+ * The ONLY two error kinds that get a prefilled report link — the "something may
+ * be broken on our side" kinds. Expected/user errors (invalid_input, not_found,
+ * rate_limited) are deliberately excluded so their envelopes stay byte-identical.
+ */
+export const REPORTABLE_ERROR_KINDS = new Set([
+    "schema_drift",
+    "upstream_unavailable",
+]);
+/**
+ * Attach a prefilled `report` URL to an error envelope IN PLACE, but only for a
+ * reportable kind. A no-op (envelope unchanged) for every other kind. Centralizes
+ * the policy so the dispatcher and the tests agree on exactly which kinds report.
+ */
+export function maybeAttachReport(error, tool, version) {
+    if (REPORTABLE_ERROR_KINDS.has(error.kind)) {
+        error.report = reportUrlForError(tool, error.kind, version);
+    }
+}
+const KIND_TITLE = {
+    bug: "Bug",
+    feature: "Feature request",
+    wrong_output: "Tool returned a wrong-looking result",
+};
+const KIND_LABELS = {
+    bug: ["bug"],
+    feature: ["enhancement"],
+    wrong_output: ["bug", "wrong-output"],
+};
+/**
+ * The `feedback` tool handler. Turns a caller's (agent's) bug/feature/wrong-output
+ * report into a PREFILLED GitHub new-issue URL for the HUMAN to open and submit.
+ * Pure + keyless: no network, no posting. `summary` is caller-supplied free text
+ * and is trusted to be non-sensitive (the description + privacy note say so).
+ */
+export function feedbackTool(input) {
+    const kind = input.kind ?? "bug";
+    const toolPart = input.tool ? `[${input.tool}] ` : "";
+    const summary = (input.summary ?? "").trim();
+    const title = `${toolPart}${KIND_TITLE[kind]}${summary ? `: ${summary}` : ""}`;
+    const lead = kind === "feature"
+        ? "**What I want to be able to do:**"
+        : "**What I did, expected, and got:**";
+    const body = [
+        `**Type:** ${KIND_TITLE[kind]}`,
+        input.tool ? `**Tool:** \`${input.tool}\`` : "",
+        "",
+        `${lead} ${summary || "_(describe)_"}`,
+        "",
+        kind === "feature"
+            ? "**Why it matters / use case:** _(describe)_"
+            : "**Steps to reproduce:** _(describe — no sensitive values)_",
+        "",
+        REDACT_NOTE,
+    ]
+        .filter((line, i) => !(line === "" && i === 2 && !input.tool))
+        .join("\n");
+    return {
+        reportUrl: buildIssueUrl({ title, body, labels: KIND_LABELS[kind] }),
+        repo: REPO_URL,
+        willPost: false,
+        instructions: "Open reportUrl in a browser and submit the issue yourself — the server does NOT post anything automatically. Edit the prefilled title/body first if you like.",
+        privacy: "The link prefills only your summary + tool name — no API keys, query values, or personal data. Keep it that way; the issue is public.",
+    };
+}
+//# sourceMappingURL=feedback.js.map

package/dist/feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.js","sourceRoot":"","sources":["../src/feedback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG,wCAAwC,CAAC;AACjE,MAAM,aAAa,GAAG,GAAG,QAAQ,aAAa,CAAC;AAI/C,MAAM,WAAW,GACf,sJAAsJ,CAAC;AAEzJ;;;;GAIG;AACH,SAAS,aAAa,CAAC,MAAyD;IAC9E,MAAM,CAAC,GAAG,IAAI,eAAe,EAAE,CAAC;IAChC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACvE,OAAO,GAAG,aAAa,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,IAAY,EAAE,OAAe;IAC3E,MAAM,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;IAClC,MAAM,QAAQ,GACZ,IAAI,KAAK,cAAc;QACrB,CAAC,CAAC,+JAA+J;QACjK,CAAC,CAAC,wJAAwJ,CAAC;IAC/J,MAAM,IAAI,GAAG;QACX,uEAAuE;QACvE,EAAE;QACF,iBAAiB,IAAI,IAAI;QACzB,uBAAuB,IAAI,IAAI;QAC/B,2BAA2B,OAAO,IAAI;QACtC,EAAE;QACF,iEAAiE;QACjE,EAAE;QACF,6DAA6D;QAC7D,EAAE;QACF,IAAI,QAAQ,GAAG;QACf,EAAE;QACF,WAAW;KACZ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAwB,IAAI,GAAG,CAAC;IACjE,cAAc;IACd,sBAAsB;CACvB,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAwC,EACxC,IAAY,EACZ,OAAe;IAEf,IAAI,sBAAsB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,KAAK,CAAC,MAAM,GAAG,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,GAAiC;IAC/C,GAAG,EAAE,KAAK;IACV,OAAO,EAAE,iBAAiB;IAC1B,YAAY,EAAE,sCAAsC;CACrD,CAAC;AACF,MAAM,WAAW,GAAmC;IAClD,GAAG,EAAE,CAAC,KAAK,CAAC;IACZ,OAAO,EAAE,CAAC,aAAa,CAAC;IACxB,YAAY,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC;CACtC,CAAC;AAUF;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAI5B;IACC,MAAM,IAAI,GAAiB,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC;IAC/C,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACtD,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,MAAM,KAAK,GAAG,GAAG,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC/E,MAAM,IAAI,GACR,IAAI,KAAK,SAAS;QAChB,CAAC,CAAC,mCAAmC;QACrC,CAAC,CAAC,oCAAoC,CAAC;IAC3C,MAAM,IAAI,GAAG;QACX,aAAa,UAAU,CAAC,IAAI,CAAC,EAAE;QAC/B,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE;QAC/C,EAAE;QACF,GAAG,IAAI,IAAI,OAAO,IAAI,cAAc,EAAE;QACtC,EAAE;QACF,IAAI,KAAK,SAAS;YAChB,CAAC,CAAC,6CAA6C;YAC/C,CAAC,CAAC,4DAA4D;QAChE,EAAE;QACF,WAAW;KACZ;SACE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;SAC7D,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO;QACL,SAAS,EAAE,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACpE,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,KAAK;QACf,YAAY,EACV,+JAA+J;QACjK,OAAO,EACL,uIAAuI;KAC1I,CAAC;AACJ,CAAC"}

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG;AAQH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,YAAY,EAKb,MAAM,oBAAoB,CAAC;AAm5I5B,KAAK,OAAO,GAAG;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC;IAO1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE;QAAE,GAAG,EAAE,YAAY,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACxE,CAAC;AAoBF,eAAO,MAAM,KAAK,EAAE,OAAO,EAivD1B,CAAC;AAmKF,wBAAsB,OAAO,CAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,OAAO,CAAC,CAkClB"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG;AAQH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,YAAY,EAKb,MAAM,oBAAoB,CAAC;AA66I5B,KAAK,OAAO,GAAG;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC;IAO1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE;QAAE,GAAG,EAAE,YAAY,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACxE,CAAC;AAoBF,eAAO,MAAM,KAAK,EAAE,OAAO,EA6vD1B,CAAC;AAkLF,wBAAsB,OAAO,CAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,OAAO,CAAC,CAkClB"}

package/dist/server.js

@@ -78,13 +78,15 @@ import * as cbpBorder from "./cbp-border.js";
 import { fetchAttachmentText } from "./attachments.js";
 import * as keys from "./keys.js";
 import { toToolError, ToolErrorCarrier, errorFromResponse } from "./errors.js";
+import * as feedback from "./feedback.js";
+import { checkForUpdate } from "./update-check.js";
 import { buildMeta, isMetaBundle, withMeta, } from "./meta.js";
 import { pathToFileURL, fileURLToPath } from "node:url";
 import { realpathSync } from "node:fs";
 const SERVER_NAME = "mcp-sam-gov";
 // Kept in lockstep with package.json / manifest.json / server.json.
 // Keep in sync with package.json "version" (asserted at release; see CHANGELOG).
-const SERVER_VERSION = "1.5.0";
+const SERVER_VERSION = "1.7.0";
 // ─── Tool input schemas (Zod) ────────────────────────────────────
 const SamSearchInput = z.object({
     query: z.string().optional().describe("Free-text title query"),
@@ -3785,6 +3787,25 @@ const NonprofitFinancialsInput = z.object({
 });
 // api_key_status takes no input — it is a pure status query over process.env.
 const ApiKeyStatusInput = z.object({});
+// `feedback` builds a PREFILLED GitHub issue URL for the human to submit (PULL —
+// the server never posts). All inputs optional; `summary` is a short, NON-sensitive
+// title line (the issue is public — the description + return value say so).
+const FeedbackInput = z.object({
+    kind: z
+        .enum(["bug", "feature", "wrong_output"])
+        .optional()
+        .describe("What kind of report: bug (default), feature (a capability this server lacks), or wrong_output (a tool returned a wrong/suspicious result)."),
+    tool: z
+        .string()
+        .max(80)
+        .optional()
+        .describe("The tool name this is about, if any (e.g. 'sam_search_opportunities')."),
+    summary: z
+        .string()
+        .max(500)
+        .optional()
+        .describe("A short one-line summary for the issue title/body. PUBLIC — never include API keys, personal data, or sensitive query values."),
+});
 // Build a ToolDef whose `handler` is type-checked against the schema's inferred
 // input `I` at the call site (e.g. `input.searchText` is known-present). The
 // `I` binding is erased to `any` in the ToolDef[] array, so entries without a
@@ -5362,6 +5383,17 @@ export const TOOLS = [
         inputSchema: ApiKeyStatusInput,
         handler: async () => keys.apiKeyStatus(),
     }),
+    // ━━━ Meta: in-product feedback → GitHub issue (PULL-only, keyless) ━━━
+    // The server's "user" is an AI agent, so we collect real-usage friction THROUGH
+    // it: this returns a PREFILLED GitHub new-issue URL for the HUMAN to open and
+    // submit. The server NEVER posts (no token/account/auto-submit) and embeds no
+    // PII — only the caller's summary + tool name. See feedback.ts.
+    defineTool({
+        name: "feedback",
+        description: "Report a problem, request a feature, or flag a wrong-looking result for THIS server — returns a PREFILLED GitHub issue link (public repo cliwant/mcp-sam-gov) for the USER to open and submit. KEYLESS. The server does NOT post anything: it only builds the link; the human submits it (nothing is sent automatically, no network call). Use when the user reports a bug, says a tool's output looks wrong, or wants a capability this server doesn't have. Input (all optional): `kind` (bug|feature|wrong_output, default bug), `tool` (the tool it's about), `summary` (a short, NON-SENSITIVE title line). Returns { reportUrl, repo, willPost:false, instructions, privacy }. PRIVACY: never put secrets, personal data, or sensitive query values in `summary` — the issue is PUBLIC and the link prefills only your summary + tool + server version.",
+        inputSchema: FeedbackInput,
+        handler: async (input) => feedback.feedbackTool(input),
+    }),
 ];
 // ─── Server bootstrap ────────────────────────────────────────────
 async function main() {
@@ -5382,7 +5414,12 @@ async function main() {
             },
         },
     });
-    const server = new Server({ name: SERVER_NAME, version: SERVER_VERSION }, { capabilities: { tools: {} } });
+    const server = new Server({ name: SERVER_NAME, version: SERVER_VERSION }, {
+        capabilities: { tools: {} },
+        // Surfaced to the agent at initialize. Tells it how to route real-usage
+        // friction back to the project WITHOUT the server ever posting anything.
+        instructions: "This server wraps US government open data (keyless-first). If a tool result looks wrong, a tool stays broken, or the user wants a capability this server lacks, help improve it: call the `feedback` tool — or use the `report` URL present on schema_drift / upstream_unavailable errors — to get a PREFILLED GitHub issue link, and offer it to the user to open and submit. Nothing is posted automatically; the user submits. Never include secrets or personal data in a report (the repo is public).",
+    });
     server.setRequestHandler(ListToolsRequestSchema, async () => {
         return {
             tools: TOOLS.map((t) => ({
@@ -5421,6 +5458,12 @@ async function main() {
             // NON-retryable `invalid_input` with readable field-level issues — never a
             // generic `unknown` carrying Zod's raw JSON dump.
             const error = toToolError(err, name);
+            // PULL-only feedback loop (feedback.ts): attach a PREFILLED GitHub issue URL
+            // ONLY for the two "something may be broken" kinds — schema_drift (the
+            // upstream changed shape) and upstream_unavailable (a possible moved/broken
+            // endpoint). Carries only tool + kind + version (no args/PII). The 429 and
+            // invalid_input/not_found envelopes stay byte-identical (no `report`).
+            feedback.maybeAttachReport(error, name, SERVER_VERSION);
             const envelope = { ok: false, error };
             return {
                 content: [
@@ -5433,6 +5476,9 @@ async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
     console.error(`[mcp-sam-gov] v${SERVER_VERSION} listening on stdio (${TOOLS.length} tools).`);
+    // Fire-and-forget, opt-out, fail-silent update notice (STDERR only, never stdout).
+    // Deliberately NOT awaited: it must never delay or affect the server (update-check.ts).
+    void checkForUpdate(SERVER_VERSION);
 }
 /**
  * Minimal truthful `_meta` for handlers that don't attach their own.