@zenalexa/unicli 0.220.1 → 0.221.0

package/dist/adapters/google-patents-web/search.js

@@ -0,0 +1,169 @@
+/**
+ * @owner       src::adapters::google-patents-web::search
+ * @does        Keyless free-text patent search via the public XHR endpoint that drives patents.google.com — distinct from src/adapters/google-patents-bq which talks to BigQuery and needs a billed GCP project.
+ * @needs       src/adapters/google-patents-web/_shared.ts, src/engine/normalizer/patent-envelope.ts, src/registry.ts
+ * @feeds       src/commands/patent.ts (capability tag patent.search)
+ * @breaks      PATENT_API_DEPRECATED with status code embedded when the XHR returns non-2xx (typically 403 → suspected UA gating); PATENT_NOT_FOUND on empty result; PATENT_SCHEMA_DRIFT when the JSON shape no longer carries results.cluster[].result[]
+ * @invariants  output rows are canonical PatentRecord; source_adapter='google-patents-web'; results are server-ordered (Google's relevance ranking)
+ * @side-effects HTTPS egress to patents.google.com only — no env reads, no cookies, no auth
+ * @perf        single XHR request, ~40-100 KB; results capped at min(limit, 100) per call
+ * @concurrency safe — stateless
+ * @test        verification proof captured in docs/skills/patent-cookbook.md (recipe: day-zero search)
+ * @stability   experimental
+ * @since       2026-05-18
+ * @verification keyless-best-effort — Google does not publish a stability contract for this XHR; we live-call it from the same User-Agent the public site uses
+ */
+import { cli, Strategy } from "../../registry.js";
+import { assemblePatentRecord } from "../../engine/normalizer/patent-envelope.js";
+import { buildPatentEnvelope } from "../../engine/normalizer/patent-envelope.js";
+import { GooglePatentsHttpError, buildGooglePatentsXhrUrl, fetchGooglePatentsJson, flattenGoogleXhrResults, projectGoogleRowToRecord, } from "./_shared.js";
+const ADAPTER_PATH = "src/adapters/google-patents-web/search.ts";
+function clampLimit(raw) {
+    const num = typeof raw === "number" ? raw : Number(raw);
+    if (!Number.isFinite(num) || num <= 0)
+        return 25;
+    return Math.min(100, Math.max(1, Math.floor(num)));
+}
+function normaliseSince(raw) {
+    if (typeof raw !== "string")
+        return undefined;
+    const trimmed = raw.trim();
+    return /^\d{4}$/.test(trimmed) ? trimmed : undefined;
+}
+export async function runGooglePatentsWebSearch(kwargs) {
+    const query = String(kwargs.query ?? "").trim();
+    if (query.length === 0) {
+        return [
+            {
+                envelope: buildPatentEnvelope({
+                    code: "PATENT_UNSUPPORTED_QUERY",
+                    adapter_path: ADAPTER_PATH,
+                    step: "validate",
+                    suggestion: "google-patents-web search requires a non-empty query",
+                    alternatives: ["freepatentsonline-web"],
+                }),
+            },
+        ];
+    }
+    const limit = clampLimit(kwargs.limit);
+    const since = normaliseSince(kwargs.since);
+    const url = buildGooglePatentsXhrUrl(query, limit, since);
+    let body;
+    try {
+        body = await fetchGooglePatentsJson(url);
+    }
+    catch (err) {
+        if (err instanceof GooglePatentsHttpError) {
+            return [
+                {
+                    envelope: buildPatentEnvelope({
+                        code: err.status === 429
+                            ? "PATENT_RATE_LIMIT"
+                            : err.status === 403
+                                ? "PATENT_REGION_BLOCKED"
+                                : "PATENT_API_DEPRECATED",
+                        adapter_path: ADAPTER_PATH,
+                        step: "fetch",
+                        suggestion: `Google Patents XHR returned HTTP ${err.status} for ${err.url}; retry with --sources freepatentsonline-web, or check if Google now requires a session cookie`,
+                        alternatives: ["freepatentsonline-web", "espacenet"],
+                        retryable: err.status === 429,
+                    }),
+                },
+            ];
+        }
+        throw err;
+    }
+    const rows = flattenGoogleXhrResults(body);
+    if (rows.length === 0) {
+        if (!body.results || !Array.isArray(body.results.cluster)) {
+            return [
+                {
+                    envelope: buildPatentEnvelope({
+                        code: "PATENT_SCHEMA_DRIFT",
+                        adapter_path: ADAPTER_PATH,
+                        step: "select",
+                        suggestion: "Google Patents XHR no longer carries results.cluster[].result[]; the adapter's flattenGoogleXhrResults projection needs updating",
+                        alternatives: ["freepatentsonline-web"],
+                    }),
+                },
+            ];
+        }
+        return [
+            {
+                envelope: buildPatentEnvelope({
+                    code: "PATENT_NOT_FOUND",
+                    adapter_path: ADAPTER_PATH,
+                    step: "select",
+                    suggestion: `google-patents-web returned no rows for "${query}"`,
+                    alternatives: ["freepatentsonline-web", "espacenet"],
+                }),
+            },
+        ];
+    }
+    const out = [];
+    for (const row of rows.slice(0, limit)) {
+        const partial = projectGoogleRowToRecord(row, url);
+        if (!partial.publication_number)
+            continue;
+        try {
+            out.push(assemblePatentRecord(partial));
+        }
+        catch {
+            // Rows whose publication_number cannot be canonicalised are skipped
+            // rather than synthesised — we never invent ST.16 fields.
+        }
+    }
+    if (out.length === 0) {
+        return [
+            {
+                envelope: buildPatentEnvelope({
+                    code: "PATENT_NOT_FOUND",
+                    adapter_path: ADAPTER_PATH,
+                    step: "normalize",
+                    suggestion: `google-patents-web returned ${rows.length} rows but none carried a canonicalisable publication_number`,
+                    alternatives: ["freepatentsonline-web", "espacenet"],
+                }),
+            },
+        ];
+    }
+    return out;
+}
+cli({
+    site: "google-patents-web",
+    name: "search",
+    description: "Keyless Google Patents search via the public XHR endpoint (no API key, no Chrome required)",
+    domain: "patents.google.com",
+    strategy: Strategy.PUBLIC,
+    adapter_path: ADAPTER_PATH,
+    args: [
+        {
+            name: "query",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Free-text query (Google Patents smart-search syntax)",
+        },
+        {
+            name: "limit",
+            type: "int",
+            default: 25,
+            description: "Max results to return (1-100)",
+        },
+        {
+            name: "since",
+            type: "str",
+            description: "Earliest publication year (YYYY); translated to after:publication:YYYY0101",
+        },
+    ],
+    columns: [
+        "publication_number",
+        "title",
+        "publication_date",
+        "assignees",
+        "source_url",
+    ],
+    capabilities: ["http.fetch", "patent.search"],
+    minimum_capability: "http.fetch",
+    func: async (_page, kwargs) => runGooglePatentsWebSearch(kwargs),
+});
+//# sourceMappingURL=search.js.map

package/dist/adapters/google-patents-web/search.js.map

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

package/dist/adapters/inpi-br/_shared.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @owner       src::adapters::inpi-br::_shared
+ * @does        Shared helpers for the INPI Brasil browser adapter — busca.inpi.gov.br/pePI/ has no programmatic API today (pre-API status); the browser route is the only path.
+ * @needs       src/engine/transport/mcp-browser.ts, src/engine/normalizer/patent-envelope.ts, src/types/patent.ts
+ * @feeds       src/adapters/inpi-br/*.ts
+ * @breaks      none — pure helpers
+ * @invariants  every transport gap surfaces as a PatentEnvelope row
+ * @side-effects none
+ * @perf        n/a
+ * @concurrency safe
+ * @test        covered transitively
+ * @stability   experimental
+ * @since       2026-05-18
+ * @verification browser-only
+ */
+import { TransportError, type McpBrowserResult } from "../../engine/transport/mcp-browser.js";
+import type { PatentEnvelope, PatentErrorCode } from "../../types/patent.js";
+export declare function inpiBrEnvelope(code: PatentErrorCode, adapter_path: string, step: string, suggestion: string, alternatives?: string[]): PatentEnvelope;
+export declare function transportErrorToInpiBrEnvelope(err: TransportError, adapter_path: string, step: string): PatentEnvelope;
+export declare function inpiBrNavigateAndExtract<T>(url: string, expression: string): Promise<McpBrowserResult<T>>;
+//# sourceMappingURL=_shared.d.ts.map

package/dist/adapters/inpi-br/_shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../../src/adapters/inpi-br/_shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,cAAc,EAId,KAAK,gBAAgB,EACtB,MAAM,uCAAuC,CAAC;AAE/C,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7E,wBAAgB,cAAc,CAC5B,IAAI,EAAE,eAAe,EACrB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,YAAY,GAAE,MAAM,EAAO,GAC1B,cAAc,CAShB;AAED,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,cAAc,EACnB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,GACX,cAAc,CAoBhB;AAED,wBAAsB,wBAAwB,CAAC,CAAC,EAC9C,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAyB9B"}

package/dist/adapters/inpi-br/_shared.js

@@ -0,0 +1,67 @@
+/**
+ * @owner       src::adapters::inpi-br::_shared
+ * @does        Shared helpers for the INPI Brasil browser adapter — busca.inpi.gov.br/pePI/ has no programmatic API today (pre-API status); the browser route is the only path.
+ * @needs       src/engine/transport/mcp-browser.ts, src/engine/normalizer/patent-envelope.ts, src/types/patent.ts
+ * @feeds       src/adapters/inpi-br/*.ts
+ * @breaks      none — pure helpers
+ * @invariants  every transport gap surfaces as a PatentEnvelope row
+ * @side-effects none
+ * @perf        n/a
+ * @concurrency safe
+ * @test        covered transitively
+ * @stability   experimental
+ * @since       2026-05-18
+ * @verification browser-only
+ */
+import { TransportError, initMcpBrowserTransport, mcpBrowserEvaluate, mcpBrowserNavigate, } from "../../engine/transport/mcp-browser.js";
+import { buildPatentEnvelope } from "../../engine/normalizer/patent-envelope.js";
+export function inpiBrEnvelope(code, adapter_path, step, suggestion, alternatives = []) {
+    return buildPatentEnvelope({
+        code,
+        adapter_path,
+        step,
+        suggestion,
+        alternatives,
+        retryable: false,
+    });
+}
+export function transportErrorToInpiBrEnvelope(err, adapter_path, step) {
+    if (err.code === "MCP_BUS_MISSING") {
+        return buildPatentEnvelope({
+            code: "PATENT_API_DEPRECATED",
+            adapter_path,
+            step,
+            suggestion: "engine has no outbound MCP transport wired into the bus today; INPI Brasil has no upstream API so the browser path is the only route — install an McpResolver to activate this adapter",
+            alternatives: ["espacenet", "lens"],
+            retryable: false,
+        });
+    }
+    return buildPatentEnvelope({
+        code: "PATENT_API_DEPRECATED",
+        adapter_path,
+        step,
+        suggestion: `mcp-browser transport error (${err.code}): ${err.message}`,
+        alternatives: ["espacenet"],
+        retryable: false,
+    });
+}
+export async function inpiBrNavigateAndExtract(url, expression) {
+    const init = await initMcpBrowserTransport();
+    if (init.active_server === "none") {
+        const code = init.reason === "bus-missing" ? "MCP_BUS_MISSING" : "MCP_NO_SERVER";
+        throw new TransportError(code, `mcp-browser unavailable (${init.reason})`);
+    }
+    const navResult = await mcpBrowserNavigate({ url });
+    if (!navResult.ok) {
+        throw new TransportError(navResult.code ?? "MCP_NAVIGATE_FAILED", navResult.message ?? "navigate did not succeed");
+    }
+    const evalResult = await mcpBrowserEvaluate({
+        expression,
+        tab: navResult.tab,
+    });
+    if (!evalResult.ok) {
+        throw new TransportError(evalResult.code ?? "MCP_EVALUATE_FAILED", evalResult.message ?? "evaluate did not succeed");
+    }
+    return evalResult;
+}
+//# sourceMappingURL=_shared.js.map

package/dist/adapters/inpi-br/_shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../../src/adapters/inpi-br/_shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,GAEnB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AAGjF,MAAM,UAAU,cAAc,CAC5B,IAAqB,EACrB,YAAoB,EACpB,IAAY,EACZ,UAAkB,EAClB,eAAyB,EAAE;IAE3B,OAAO,mBAAmB,CAAC;QACzB,IAAI;QACJ,YAAY;QACZ,IAAI;QACJ,UAAU;QACV,YAAY;QACZ,SAAS,EAAE,KAAK;KACjB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,GAAmB,EACnB,YAAoB,EACpB,IAAY;IAEZ,IAAI,GAAG,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;QACnC,OAAO,mBAAmB,CAAC;YACzB,IAAI,EAAE,uBAAuB;YAC7B,YAAY;YACZ,IAAI;YACJ,UAAU,EACR,wLAAwL;YAC1L,YAAY,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC;YACnC,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,mBAAmB,CAAC;QACzB,IAAI,EAAE,uBAAuB;QAC7B,YAAY;QACZ,IAAI;QACJ,UAAU,EAAE,gCAAgC,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,OAAO,EAAE;QACvE,YAAY,EAAE,CAAC,WAAW,CAAC;QAC3B,SAAS,EAAE,KAAK;KACjB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,GAAW,EACX,UAAkB;IAElB,MAAM,IAAI,GAAG,MAAM,uBAAuB,EAAE,CAAC;IAC7C,IAAI,IAAI,CAAC,aAAa,KAAK,MAAM,EAAE,CAAC;QAClC,MAAM,IAAI,GACR,IAAI,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,eAAe,CAAC;QACtE,MAAM,IAAI,cAAc,CAAC,IAAI,EAAE,4BAA4B,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IACpD,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,cAAc,CACtB,SAAS,CAAC,IAAI,IAAI,qBAAqB,EACvC,SAAS,CAAC,OAAO,IAAI,0BAA0B,CAChD,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAI;QAC7C,UAAU;QACV,GAAG,EAAE,SAAS,CAAC,GAAG;KACnB,CAAC,CAAC;IACH,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;QACnB,MAAM,IAAI,cAAc,CACtB,UAAU,CAAC,IAAI,IAAI,qBAAqB,EACxC,UAAU,CAAC,OAAO,IAAI,0BAA0B,CACjD,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/adapters/inpi-br/get.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @owner       src::adapters::inpi-br::get
+ * @does        Browser-driven retrieval of an INPI Brasil patent record by application/publication number; extracts the bibliographic block from the pePI detail page.
+ * @needs       src/engine/transport/mcp-browser.ts, src/engine/normalizer/patent-envelope.ts, src/adapters/inpi-br/_shared.ts, src/registry.ts
+ * @feeds       src/commands/patent.ts (capability tag patent.get)
+ * @breaks      PATENT_INVALID_NUMBER, PATENT_NOT_FOUND, PATENT_API_DEPRECATED (MCP_BUS_MISSING)
+ * @invariants  output row is a canonical PatentRecord
+ * @side-effects controls Chrome via MCP
+ * @perf        single navigate + evaluate
+ * @concurrency safe
+ * @test        tests/unit/adapters/inpi-br/search.test.ts (shared transport-error path)
+ * @stability   experimental
+ * @since       2026-05-18
+ * @verification browser-only
+ */
+export declare function runInpiBrGet(kwargs: {
+    publication_number: string;
+}): Promise<unknown[]>;
+//# sourceMappingURL=get.d.ts.map

package/dist/adapters/inpi-br/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/adapters/inpi-br/get.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAoDH,wBAAsB,YAAY,CAAC,MAAM,EAAE;IACzC,kBAAkB,EAAE,MAAM,CAAC;CAC5B,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CA+FrB"}

package/dist/adapters/inpi-br/get.js

@@ -0,0 +1,142 @@
+/**
+ * @owner       src::adapters::inpi-br::get
+ * @does        Browser-driven retrieval of an INPI Brasil patent record by application/publication number; extracts the bibliographic block from the pePI detail page.
+ * @needs       src/engine/transport/mcp-browser.ts, src/engine/normalizer/patent-envelope.ts, src/adapters/inpi-br/_shared.ts, src/registry.ts
+ * @feeds       src/commands/patent.ts (capability tag patent.get)
+ * @breaks      PATENT_INVALID_NUMBER, PATENT_NOT_FOUND, PATENT_API_DEPRECATED (MCP_BUS_MISSING)
+ * @invariants  output row is a canonical PatentRecord
+ * @side-effects controls Chrome via MCP
+ * @perf        single navigate + evaluate
+ * @concurrency safe
+ * @test        tests/unit/adapters/inpi-br/search.test.ts (shared transport-error path)
+ * @stability   experimental
+ * @since       2026-05-18
+ * @verification browser-only
+ */
+import { cli, Strategy } from "../../registry.js";
+import { TransportError } from "../../engine/transport/mcp-browser.js";
+import { assemblePatentRecord } from "../../engine/normalizer/patent-envelope.js";
+import { inpiBrEnvelope, inpiBrNavigateAndExtract, transportErrorToInpiBrEnvelope, } from "./_shared.js";
+const ADAPTER_PATH = "src/adapters/inpi-br/get.ts";
+const DETAIL_EXTRACTOR = `(() => {
+  const text = (sel) => {
+    const node = document.querySelector(sel);
+    return node ? (node.textContent || '').trim() : '';
+  };
+  return {
+    publication_number: text('[data-field="numPedido"], .num-pedido, td.numero'),
+    application_number: text('[data-field="numAplicacao"], .num-aplicacao'),
+    title: text('[data-field="titulo"], .titulo, h1'),
+    abstract: text('[data-field="resumo"], .resumo'),
+    applicant: text('[data-field="depositante"], .depositante'),
+    inventor: text('[data-field="inventor"], .inventor'),
+    publication_date: text('[data-field="dataPub"], .data-pub'),
+    filing_date: text('[data-field="dataDep"], .data-dep'),
+    source_url: location.href,
+  };
+})()`;
+function detailUrlFor(pubNo) {
+    const stripped = pubNo.replace(/^BR[-]?/, "");
+    const params = new URLSearchParams({
+        Action: "detail",
+        NumPedido: stripped,
+    });
+    return `https://busca.inpi.gov.br/pePI/servlet/PatenteServletController?${params.toString()}`;
+}
+export async function runInpiBrGet(kwargs) {
+    const pubNo = String(kwargs.publication_number ?? "").trim();
+    if (pubNo.length === 0) {
+        return [
+            {
+                envelope: inpiBrEnvelope("PATENT_INVALID_NUMBER", ADAPTER_PATH, "validate", "inpi-br get requires a non-empty publication_number"),
+            },
+        ];
+    }
+    const url = detailUrlFor(pubNo);
+    let detail;
+    try {
+        const result = await inpiBrNavigateAndExtract(url, DETAIL_EXTRACTOR);
+        if (!result.data) {
+            return [
+                {
+                    envelope: inpiBrEnvelope("PATENT_SCHEMA_DRIFT", ADAPTER_PATH, "evaluate", "inpi-br detail evaluate returned no data"),
+                },
+            ];
+        }
+        detail = result.data;
+    }
+    catch (err) {
+        if (err instanceof TransportError) {
+            return [
+                {
+                    envelope: transportErrorToInpiBrEnvelope(err, ADAPTER_PATH, "navigate"),
+                },
+            ];
+        }
+        throw err;
+    }
+    if (!detail.publication_number && !detail.title) {
+        return [
+            {
+                envelope: inpiBrEnvelope("PATENT_NOT_FOUND", ADAPTER_PATH, "evaluate", `inpi-br detail page for "${pubNo}" yielded no bibliographic fields`, ["espacenet"]),
+            },
+        ];
+    }
+    const rawPubNo = detail.publication_number || pubNo;
+    const canonicalPubNo = /^BR[-]?/.test(rawPubNo) ? rawPubNo : `BR${rawPubNo}`;
+    try {
+        return [
+            assemblePatentRecord({
+                publication_number: canonicalPubNo,
+                application_number: detail.application_number || undefined,
+                title: detail.title || undefined,
+                abstract: detail.abstract || undefined,
+                assignees: detail.applicant
+                    ? [{ name: detail.applicant, country: "BR" }]
+                    : undefined,
+                inventors: detail.inventor
+                    ? [{ name: detail.inventor, country: "BR" }]
+                    : undefined,
+                publication_date: detail.publication_date || undefined,
+                filing_date: detail.filing_date || undefined,
+                source_adapter: "inpi-br",
+                source_url: detail.source_url || url,
+            }),
+        ];
+    }
+    catch {
+        return [
+            {
+                envelope: inpiBrEnvelope("PATENT_NOT_FOUND", ADAPTER_PATH, "normalize", `inpi-br detail page for "${pubNo}" did not yield a valid publication_number`, ["espacenet"]),
+            },
+        ];
+    }
+}
+cli({
+    site: "inpi-br",
+    name: "get",
+    description: "Retrieve a single INPI Brasil patent record (browser-only)",
+    domain: "busca.inpi.gov.br",
+    strategy: Strategy.PUBLIC,
+    adapter_path: ADAPTER_PATH,
+    args: [
+        {
+            name: "publication_number",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Brazil patent application/publication number",
+        },
+    ],
+    columns: [
+        "publication_number",
+        "title",
+        "publication_date",
+        "filing_date",
+        "source_url",
+    ],
+    capabilities: ["mcp-browser.navigate", "mcp-browser.evaluate", "patent.get"],
+    minimum_capability: "mcp-browser.evaluate",
+    func: async (_page, kwargs) => runInpiBrGet(kwargs),
+});
+//# sourceMappingURL=get.js.map

package/dist/adapters/inpi-br/get.js.map

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

package/dist/adapters/inpi-br/search.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @owner       src::adapters::inpi-br::search
+ * @does        Browser-driven INPI Brasil search at busca.inpi.gov.br/pePI/ — Brazil's patent office has no open API (pre-API status); the public web search is the only programmatic surface.
+ * @needs       src/engine/transport/mcp-browser.ts, src/engine/normalizer/patent-envelope.ts, src/adapters/inpi-br/_shared.ts, src/registry.ts
+ * @feeds       src/commands/patent.ts (capability tag patent.search)
+ * @breaks      PATENT_UNSUPPORTED_QUERY (empty), PATENT_NOT_FOUND (no rows), PATENT_API_DEPRECATED with MCP_BUS_MISSING
+ * @invariants  output rows canonicalized into PatentRecord with source_adapter='inpi-br'
+ * @side-effects controls Chrome via MCP
+ * @perf        single navigate + evaluate
+ * @concurrency safe
+ * @test        tests/unit/adapters/inpi-br/search.test.ts
+ * @stability   experimental
+ * @since       2026-05-18
+ * @verification browser-only
+ */
+export declare function runInpiBrSearch(kwargs: {
+    query: string;
+    limit?: number;
+}): Promise<unknown[]>;
+//# sourceMappingURL=search.d.ts.map

package/dist/adapters/inpi-br/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/adapters/inpi-br/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAsDH,wBAAsB,eAAe,CAAC,MAAM,EAAE;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAqGrB"}

package/dist/adapters/inpi-br/search.js

@@ -0,0 +1,154 @@
+/**
+ * @owner       src::adapters::inpi-br::search
+ * @does        Browser-driven INPI Brasil search at busca.inpi.gov.br/pePI/ — Brazil's patent office has no open API (pre-API status); the public web search is the only programmatic surface.
+ * @needs       src/engine/transport/mcp-browser.ts, src/engine/normalizer/patent-envelope.ts, src/adapters/inpi-br/_shared.ts, src/registry.ts
+ * @feeds       src/commands/patent.ts (capability tag patent.search)
+ * @breaks      PATENT_UNSUPPORTED_QUERY (empty), PATENT_NOT_FOUND (no rows), PATENT_API_DEPRECATED with MCP_BUS_MISSING
+ * @invariants  output rows canonicalized into PatentRecord with source_adapter='inpi-br'
+ * @side-effects controls Chrome via MCP
+ * @perf        single navigate + evaluate
+ * @concurrency safe
+ * @test        tests/unit/adapters/inpi-br/search.test.ts
+ * @stability   experimental
+ * @since       2026-05-18
+ * @verification browser-only
+ */
+import { cli, Strategy } from "../../registry.js";
+import { TransportError } from "../../engine/transport/mcp-browser.js";
+import { assemblePatentRecord } from "../../engine/normalizer/patent-envelope.js";
+import { inpiBrEnvelope, inpiBrNavigateAndExtract, transportErrorToInpiBrEnvelope, } from "./_shared.js";
+const ADAPTER_PATH = "src/adapters/inpi-br/search.ts";
+const INPI_BR_SEARCH_URL = "https://busca.inpi.gov.br/pePI/servlet/PatenteServletController";
+const EXTRACTOR = `(() => {
+  const rows = Array.from(
+    document.querySelectorAll('table.tabela tr.linha, table tr[bgcolor]')
+  ).map((el) => {
+    const text = (sel) => {
+      const node = el.querySelector(sel);
+      return node ? (node.textContent || '').trim() : '';
+    };
+    const cells = Array.from(el.querySelectorAll('td')).map((td) => (td.textContent || '').trim());
+    const linkEl = el.querySelector('a[href]');
+    return {
+      publication_number: text('td.num-pedido, td:first-child') || (cells[0] || ''),
+      title: text('td.titulo, td:nth-child(3)') || (cells[2] || ''),
+      applicant: text('td.depositante, td:nth-child(4)') || (cells[3] || ''),
+      publication_date: text('td.data-pub, td:nth-child(5)') || (cells[4] || ''),
+      filing_date: text('td.data-dep, td:nth-child(2)') || (cells[1] || ''),
+      source_url: linkEl ? linkEl.href : '',
+    };
+  });
+  return { rows };
+})()`;
+function buildSearchUrl(query) {
+    const params = new URLSearchParams({
+        Action: "searchPatente",
+        ExpressaoPesquisa: query,
+    });
+    return `${INPI_BR_SEARCH_URL}?${params.toString()}`;
+}
+export async function runInpiBrSearch(kwargs) {
+    const limit = typeof kwargs.limit === "number" && Number.isFinite(kwargs.limit)
+        ? Math.max(1, Math.min(100, Math.floor(kwargs.limit)))
+        : 25;
+    const query = String(kwargs.query ?? "").trim();
+    if (query.length === 0) {
+        return [
+            {
+                envelope: inpiBrEnvelope("PATENT_UNSUPPORTED_QUERY", ADAPTER_PATH, "validate", "inpi-br search requires a non-empty query"),
+            },
+        ];
+    }
+    const url = buildSearchUrl(query);
+    let extract;
+    try {
+        const result = await inpiBrNavigateAndExtract(url, EXTRACTOR);
+        if (!result.data) {
+            return [
+                {
+                    envelope: inpiBrEnvelope("PATENT_SCHEMA_DRIFT", ADAPTER_PATH, "evaluate", "inpi-br evaluate returned no data; selectors likely drifted"),
+                },
+            ];
+        }
+        extract = result.data;
+    }
+    catch (err) {
+        if (err instanceof TransportError) {
+            return [
+                {
+                    envelope: transportErrorToInpiBrEnvelope(err, ADAPTER_PATH, "navigate"),
+                },
+            ];
+        }
+        throw err;
+    }
+    if (extract.rows.length === 0) {
+        return [
+            {
+                envelope: inpiBrEnvelope("PATENT_NOT_FOUND", ADAPTER_PATH, "evaluate", `inpi-br returned no rows for query "${query}"`, ["espacenet", "lens"]),
+            },
+        ];
+    }
+    const out = [];
+    for (const row of extract.rows.slice(0, limit)) {
+        if (!row.publication_number)
+            continue;
+        const normalizedPub = /^BR[-]?/.test(row.publication_number)
+            ? row.publication_number
+            : `BR${row.publication_number}`;
+        try {
+            out.push(assemblePatentRecord({
+                publication_number: normalizedPub,
+                title: row.title || undefined,
+                assignees: row.applicant
+                    ? [{ name: row.applicant, country: "BR" }]
+                    : undefined,
+                publication_date: row.publication_date || undefined,
+                filing_date: row.filing_date || undefined,
+                source_adapter: "inpi-br",
+                source_url: row.source_url || url,
+            }));
+        }
+        catch {
+            // Skip malformed rows.
+        }
+    }
+    if (out.length === 0) {
+        out.push({
+            envelope: inpiBrEnvelope("PATENT_NOT_FOUND", ADAPTER_PATH, "normalize", "inpi-br returned rows but none normalized to a valid publication_number", ["espacenet"]),
+        });
+    }
+    return out;
+}
+cli({
+    site: "inpi-br",
+    name: "search",
+    description: "Search INPI Brasil patents (browser-only, no upstream API)",
+    domain: "busca.inpi.gov.br",
+    strategy: Strategy.PUBLIC,
+    adapter_path: ADAPTER_PATH,
+    args: [
+        {
+            name: "query",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Free-text query for INPI Brasil patent search",
+        },
+        {
+            name: "limit",
+            type: "int",
+            default: 25,
+            description: "Max results (1-100)",
+        },
+    ],
+    columns: ["publication_number", "title", "publication_date", "source_url"],
+    capabilities: [
+        "mcp-browser.navigate",
+        "mcp-browser.evaluate",
+        "patent.search",
+    ],
+    minimum_capability: "mcp-browser.evaluate",
+    func: async (_page, kwargs) => runInpiBrSearch(kwargs),
+});
+//# sourceMappingURL=search.js.map

package/dist/adapters/inpi-br/search.js.map

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

package/dist/adapters/instagram/subtitles.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @owner   Instagram subtitle adapter.
+ * @does    Extracts LLM-readable subtitle text from public Instagram reel and video URLs.
+ * @needs   `yt-dlp` on PATH and an accessible video subtitle track.
+ * @feeds   Cross-platform social video analysis workflows.
+ * @breaks  Instagram or yt-dlp extractor changes can alter subtitle availability.
+ */
+export {};
+//# sourceMappingURL=subtitles.d.ts.map

package/dist/adapters/instagram/subtitles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtitles.d.ts","sourceRoot":"","sources":["../../../src/adapters/instagram/subtitles.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}