@zenalexa/unicli 0.220.1 → 0.221.0

package/dist/adapters/cnipa/get.js

@@ -0,0 +1,149 @@
+/**
+ * @owner       src::adapters::cnipa::get
+ * @does        Browser-driven retrieval of a single CNIPA patent document by publication number; loads the detail page through the mcp-browser transport and extracts the bibliographic fields into a PatentRecord.
+ * @needs       src/engine/transport/mcp-browser.ts, src/engine/normalizer/patent-envelope.ts, src/adapters/cnipa/_shared.ts, src/registry.ts
+ * @feeds       src/commands/patent.ts (capability tag patent.get)
+ * @breaks      emits PATENT_INVALID_NUMBER when input is empty or fails canonicalization; emits PATENT_NOT_FOUND when the detail page returns no fields; PATENT_BROWSER_CAPTCHA when the page is captcha-gated; PATENT_API_DEPRECATED with MCP_BUS_MISSING context when no outbound MCP transport is registered
+ * @invariants  output is a single PatentRecord row when the upstream answers; never falls back to a stub record
+ * @side-effects controls the user's Chrome via MCP
+ * @perf        single navigate + one evaluate
+ * @concurrency safe
+ * @test        tests/unit/adapters/cnipa/search.test.ts (transport-error path) — get-specific tests deferred to integration
+ * @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 { cnipaEnvelope, looksLikeCaptcha, navigateAndExtract, transportErrorToEnvelope, } from "./_shared.js";
+const ADAPTER_PATH = "src/adapters/cnipa/get.ts";
+const CNIPA_DETAIL_URL = "https://pss-system.cponline.cnipa.gov.cn/conventionalDetail";
+const DETAIL_EXTRACTOR = `(() => {
+  const text = (sel) => {
+    const node = document.querySelector(sel);
+    return node ? (node.textContent || '').trim() : '';
+  };
+  return {
+    publication_number: text('[data-field="pubNo"], .publication-number'),
+    application_number: text('[data-field="appNo"], .application-number'),
+    title: text('[data-field="title"], h1.title, .invention-title'),
+    abstract: text('[data-field="abstract"], .abstract'),
+    applicant: text('[data-field="applicant"], .applicant'),
+    inventor: text('[data-field="inventor"], .inventor'),
+    publication_date: text('[data-field="pubDate"], .publication-date'),
+    filing_date: text('[data-field="appDate"], .filing-date'),
+    grant_date: text('[data-field="grantDate"], .grant-date'),
+    legal_status: text('[data-field="legalStatus"], .legal-status'),
+    source_url: location.href,
+    html_marker: document.body && document.body.innerText
+      ? document.body.innerText.slice(0, 200)
+      : '',
+  };
+})()`;
+export async function runCnipaGet(kwargs) {
+    const pubNo = String(kwargs.publication_number ?? "").trim();
+    if (pubNo.length === 0) {
+        return [
+            {
+                envelope: cnipaEnvelope("PATENT_INVALID_NUMBER", ADAPTER_PATH, "validate", "cnipa get requires a non-empty publication_number"),
+            },
+        ];
+    }
+    const url = `${CNIPA_DETAIL_URL}?pubNo=${encodeURIComponent(pubNo)}`;
+    let detail;
+    try {
+        const result = await navigateAndExtract(url, DETAIL_EXTRACTOR);
+        if (!result.data) {
+            return [
+                {
+                    envelope: cnipaEnvelope("PATENT_SCHEMA_DRIFT", ADAPTER_PATH, "evaluate", "mcp-browser evaluate returned no data; check selector schema in src/adapters/cnipa/get.ts"),
+                },
+            ];
+        }
+        detail = result.data;
+    }
+    catch (err) {
+        if (err instanceof TransportError) {
+            return [
+                {
+                    envelope: transportErrorToEnvelope(err, ADAPTER_PATH, "navigate"),
+                },
+            ];
+        }
+        throw err;
+    }
+    // Captcha heuristic: detail page returned without any of the expected
+    // bibliographic fields → almost certainly captcha-gated.
+    const fieldCount = [
+        detail.publication_number,
+        detail.title,
+        detail.application_number,
+        detail.publication_date,
+    ].filter(Boolean).length;
+    if (looksLikeCaptcha(fieldCount, detail.html_marker)) {
+        return [
+            {
+                envelope: cnipaEnvelope("PATENT_BROWSER_CAPTCHA", ADAPTER_PATH, "evaluate", "CNIPA detail page returned no bibliographic fields; solve the 验证码 in the open browser tab and re-run", ["espacenet"]),
+            },
+        ];
+    }
+    const canonicalPubNo = detail.publication_number || pubNo;
+    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: "CN" }]
+                    : undefined,
+                inventors: detail.inventor
+                    ? [{ name: detail.inventor, country: "CN" }]
+                    : undefined,
+                publication_date: detail.publication_date || undefined,
+                filing_date: detail.filing_date || undefined,
+                grant_date: detail.grant_date || undefined,
+                legal_status: detail.legal_status || undefined,
+                source_adapter: "cnipa",
+                source_url: detail.source_url || url,
+            }),
+        ];
+    }
+    catch {
+        return [
+            {
+                envelope: cnipaEnvelope("PATENT_NOT_FOUND", ADAPTER_PATH, "normalize", `cnipa detail page did not yield a valid publication_number for "${pubNo}"`, ["espacenet"]),
+            },
+        ];
+    }
+}
+cli({
+    site: "cnipa",
+    name: "get",
+    description: "Retrieve a single CNIPA patent document by publication number",
+    domain: "pss-system.cponline.cnipa.gov.cn",
+    strategy: Strategy.PUBLIC,
+    adapter_path: ADAPTER_PATH,
+    args: [
+        {
+            name: "publication_number",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "ST.16 publication number (e.g. CN114123456A)",
+        },
+    ],
+    columns: [
+        "publication_number",
+        "title",
+        "publication_date",
+        "legal_status",
+        "source_url",
+    ],
+    capabilities: ["mcp-browser.navigate", "mcp-browser.evaluate", "patent.get"],
+    minimum_capability: "mcp-browser.evaluate",
+    func: async (_page, kwargs) => runCnipaGet(kwargs),
+});
+//# sourceMappingURL=get.js.map

package/dist/adapters/cnipa/get.js.map

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

package/dist/adapters/cnipa/legal-status.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @owner       src::adapters::cnipa::legal-status
+ * @does        Browser-driven CNIPA legal-status lookup — scrapes the prosecution timeline + grant status from the 公众查询 detail page; emits structured envelopes for captcha / not-found / MCP-bus gaps.
+ * @needs       src/engine/transport/mcp-browser.ts, src/engine/normalizer/patent-envelope.ts, src/adapters/cnipa/_shared.ts, src/registry.ts
+ * @feeds       src/commands/patent.ts (capability tag patent.legal-status)
+ * @breaks      emits PATENT_INVALID_NUMBER, PATENT_BROWSER_CAPTCHA, PATENT_API_DEPRECATED (with MCP_BUS_MISSING context); never synthesizes a status
+ * @invariants  output row carries `legal_status` exactly as scraped; no normalization beyond trim
+ * @side-effects controls Chrome via MCP
+ * @perf        single navigate + evaluate
+ * @concurrency safe
+ * @test        tests/unit/adapters/cnipa/search.test.ts (shared transport-error path)
+ * @stability   experimental
+ * @since       2026-05-18
+ * @verification browser-only
+ */
+export declare function runCnipaLegalStatus(kwargs: {
+    publication_number: string;
+}): Promise<unknown[]>;
+//# sourceMappingURL=legal-status.d.ts.map

package/dist/adapters/cnipa/legal-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legal-status.d.ts","sourceRoot":"","sources":["../../../src/adapters/cnipa/legal-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAsCH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,kBAAkB,EAAE,MAAM,CAAC;CAC5B,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAgFrB"}

package/dist/adapters/cnipa/legal-status.js

@@ -0,0 +1,119 @@
+/**
+ * @owner       src::adapters::cnipa::legal-status
+ * @does        Browser-driven CNIPA legal-status lookup — scrapes the prosecution timeline + grant status from the 公众查询 detail page; emits structured envelopes for captcha / not-found / MCP-bus gaps.
+ * @needs       src/engine/transport/mcp-browser.ts, src/engine/normalizer/patent-envelope.ts, src/adapters/cnipa/_shared.ts, src/registry.ts
+ * @feeds       src/commands/patent.ts (capability tag patent.legal-status)
+ * @breaks      emits PATENT_INVALID_NUMBER, PATENT_BROWSER_CAPTCHA, PATENT_API_DEPRECATED (with MCP_BUS_MISSING context); never synthesizes a status
+ * @invariants  output row carries `legal_status` exactly as scraped; no normalization beyond trim
+ * @side-effects controls Chrome via MCP
+ * @perf        single navigate + evaluate
+ * @concurrency safe
+ * @test        tests/unit/adapters/cnipa/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 { cnipaEnvelope, looksLikeCaptcha, navigateAndExtract, transportErrorToEnvelope, } from "./_shared.js";
+const ADAPTER_PATH = "src/adapters/cnipa/legal-status.ts";
+const CNIPA_LEGAL_URL = "https://pss-system.cponline.cnipa.gov.cn/legalStatus";
+const EXTRACTOR = `(() => {
+  const text = (sel) => {
+    const node = document.querySelector(sel);
+    return node ? (node.textContent || '').trim() : '';
+  };
+  return {
+    publication_number: text('[data-field="pubNo"], .publication-number'),
+    legal_status: text('[data-field="legalStatus"], .legal-status'),
+    status_date: text('[data-field="statusDate"], .status-date'),
+    source_url: location.href,
+    html_marker: document.body && document.body.innerText
+      ? document.body.innerText.slice(0, 200)
+      : '',
+  };
+})()`;
+export async function runCnipaLegalStatus(kwargs) {
+    const pubNo = String(kwargs.publication_number ?? "").trim();
+    if (pubNo.length === 0) {
+        return [
+            {
+                envelope: cnipaEnvelope("PATENT_INVALID_NUMBER", ADAPTER_PATH, "validate", "cnipa legal-status requires a non-empty publication_number"),
+            },
+        ];
+    }
+    const url = `${CNIPA_LEGAL_URL}?pubNo=${encodeURIComponent(pubNo)}`;
+    let detail;
+    try {
+        const result = await navigateAndExtract(url, EXTRACTOR);
+        if (!result.data) {
+            return [
+                {
+                    envelope: cnipaEnvelope("PATENT_SCHEMA_DRIFT", ADAPTER_PATH, "evaluate", "mcp-browser evaluate returned no data"),
+                },
+            ];
+        }
+        detail = result.data;
+    }
+    catch (err) {
+        if (err instanceof TransportError) {
+            return [
+                {
+                    envelope: transportErrorToEnvelope(err, ADAPTER_PATH, "navigate"),
+                },
+            ];
+        }
+        throw err;
+    }
+    const fieldCount = [detail.publication_number, detail.legal_status].filter(Boolean).length;
+    if (looksLikeCaptcha(fieldCount, detail.html_marker)) {
+        return [
+            {
+                envelope: cnipaEnvelope("PATENT_BROWSER_CAPTCHA", ADAPTER_PATH, "evaluate", "CNIPA legal-status page returned no fields; solve the 验证码 and re-run", ["espacenet"]),
+            },
+        ];
+    }
+    if (!detail.legal_status) {
+        return [
+            {
+                envelope: cnipaEnvelope("PATENT_NOT_FOUND", ADAPTER_PATH, "normalize", `cnipa returned no legal_status for "${pubNo}"`, ["espacenet"]),
+            },
+        ];
+    }
+    return [
+        {
+            publication_number: detail.publication_number || pubNo,
+            legal_status: detail.legal_status,
+            status_date: detail.status_date,
+            source_adapter: "cnipa",
+            source_url: detail.source_url || url,
+            retrieved_at: new Date().toISOString(),
+        },
+    ];
+}
+cli({
+    site: "cnipa",
+    name: "legal-status",
+    description: "CNIPA legal-status / prosecution timeline lookup (browser)",
+    domain: "pss-system.cponline.cnipa.gov.cn",
+    strategy: Strategy.PUBLIC,
+    adapter_path: ADAPTER_PATH,
+    args: [
+        {
+            name: "publication_number",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "ST.16 publication number",
+        },
+    ],
+    columns: ["publication_number", "legal_status", "status_date", "source_url"],
+    capabilities: [
+        "mcp-browser.navigate",
+        "mcp-browser.evaluate",
+        "patent.legal-status",
+    ],
+    minimum_capability: "mcp-browser.evaluate",
+    func: async (_page, kwargs) => runCnipaLegalStatus(kwargs),
+});
+//# sourceMappingURL=legal-status.js.map

package/dist/adapters/cnipa/legal-status.js.map

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

package/dist/adapters/cnipa/search.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @owner       src::adapters::cnipa::search
+ * @does        Browser-driven search of CNIPA 公众查询 system at pss-system.cponline.cnipa.gov.cn — the only programmatic route for CN patents (CNIPA has no open API today). Drives a real Chrome session via the mcp-browser transport, extracts result rows, normalizes through assemblePatentRecord.
+ * @needs       src/engine/transport/mcp-browser.ts, src/engine/normalizer/patent-envelope.ts, src/types/patent.ts, src/adapters/cnipa/_shared.ts, src/registry.ts
+ * @feeds       src/commands/patent.ts (meta-command discovers via patent.search capability tag)
+ * @breaks      emits PATENT_BROWSER_CAPTCHA envelope when zero rows return from a navigation that did not error (CNIPA almost always shows a captcha gate); emits PATENT_API_DEPRECATED with MCP_BUS_MISSING context when no outbound MCP transport is registered
+ * @invariants  result rows always include source_adapter='cnipa'; publication_number canonicalized via assemblePatentRecord; never returns a synthetic row when extraction fails
+ * @side-effects controls the user's Chrome browser via MCP; reads no env vars
+ * @perf        single navigation + one evaluate; ~2-5 s wall-clock when active
+ * @concurrency safe — every call opens a fresh tab via mcpBrowserNavigate
+ * @test        tests/unit/adapters/cnipa/search.test.ts
+ * @stability   experimental
+ * @since       2026-05-18
+ * @verification browser-only — no upstream API; gated on a live mcp-browser transport
+ */
+export declare function runCnipaSearch(kwargs: {
+    query: string;
+    limit?: number;
+    offset?: number;
+}): Promise<unknown[]>;
+//# sourceMappingURL=search.d.ts.map

package/dist/adapters/cnipa/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/adapters/cnipa/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAsEH,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAkGrB"}

package/dist/adapters/cnipa/search.js

@@ -0,0 +1,170 @@
+/**
+ * @owner       src::adapters::cnipa::search
+ * @does        Browser-driven search of CNIPA 公众查询 system at pss-system.cponline.cnipa.gov.cn — the only programmatic route for CN patents (CNIPA has no open API today). Drives a real Chrome session via the mcp-browser transport, extracts result rows, normalizes through assemblePatentRecord.
+ * @needs       src/engine/transport/mcp-browser.ts, src/engine/normalizer/patent-envelope.ts, src/types/patent.ts, src/adapters/cnipa/_shared.ts, src/registry.ts
+ * @feeds       src/commands/patent.ts (meta-command discovers via patent.search capability tag)
+ * @breaks      emits PATENT_BROWSER_CAPTCHA envelope when zero rows return from a navigation that did not error (CNIPA almost always shows a captcha gate); emits PATENT_API_DEPRECATED with MCP_BUS_MISSING context when no outbound MCP transport is registered
+ * @invariants  result rows always include source_adapter='cnipa'; publication_number canonicalized via assemblePatentRecord; never returns a synthetic row when extraction fails
+ * @side-effects controls the user's Chrome browser via MCP; reads no env vars
+ * @perf        single navigation + one evaluate; ~2-5 s wall-clock when active
+ * @concurrency safe — every call opens a fresh tab via mcpBrowserNavigate
+ * @test        tests/unit/adapters/cnipa/search.test.ts
+ * @stability   experimental
+ * @since       2026-05-18
+ * @verification browser-only — no upstream API; gated on a live mcp-browser transport
+ */
+import { cli, Strategy } from "../../registry.js";
+import { TransportError } from "../../engine/transport/mcp-browser.js";
+import { assemblePatentRecord } from "../../engine/normalizer/patent-envelope.js";
+import { cnipaEnvelope, looksLikeCaptcha, navigateAndExtract, transportErrorToEnvelope, } from "./_shared.js";
+const ADAPTER_PATH = "src/adapters/cnipa/search.ts";
+const CNIPA_SEARCH_URL = "https://pss-system.cponline.cnipa.gov.cn/conventionalSearch";
+/**
+ * DOM extractor executed inside the page via mcp-browser. The selectors are
+ * the documented ones for the CNIPA 公众查询 result table; when CNIPA
+ * changes the markup an agent reads the failure envelope and updates the
+ * selector here (rule 02 self-repair).
+ */
+const EXTRACTOR = `(() => {
+  const rows = Array.from(
+    document.querySelectorAll('table.result-table tbody tr, .result-list .result-item')
+  ).map((el) => {
+    const text = (sel) => {
+      const node = el.querySelector(sel);
+      return node ? (node.textContent || '').trim() : '';
+    };
+    return {
+      publication_number: text('.publication-number, [data-field="pubNo"]'),
+      application_number: text('.application-number, [data-field="appNo"]'),
+      title: text('.title, [data-field="title"]'),
+      applicant: text('.applicant, [data-field="applicant"]'),
+      publication_date: text('.publication-date, [data-field="pubDate"]'),
+      filing_date: text('.filing-date, [data-field="appDate"]'),
+      source_url: (el.querySelector('a[href]') || {}).href || '',
+    };
+  });
+  const html_marker = (document.body && document.body.innerText
+    ? document.body.innerText.slice(0, 200)
+    : '');
+  return { rows, html_marker };
+})()`;
+function buildSearchUrl(query, limit, offset) {
+    const params = new URLSearchParams({
+        q: query,
+        pageSize: String(limit),
+        pageNo: String(Math.floor(offset / Math.max(1, limit)) + 1),
+    });
+    return `${CNIPA_SEARCH_URL}?${params.toString()}`;
+}
+export async function runCnipaSearch(kwargs) {
+    const limit = typeof kwargs.limit === "number" && Number.isFinite(kwargs.limit)
+        ? Math.max(1, Math.min(100, Math.floor(kwargs.limit)))
+        : 25;
+    const offset = typeof kwargs.offset === "number" && Number.isFinite(kwargs.offset)
+        ? Math.max(0, Math.floor(kwargs.offset))
+        : 0;
+    const query = String(kwargs.query ?? "").trim();
+    if (query.length === 0) {
+        return [
+            {
+                envelope: cnipaEnvelope("PATENT_UNSUPPORTED_QUERY", ADAPTER_PATH, "validate", "cnipa search requires a non-empty query string"),
+            },
+        ];
+    }
+    const url = buildSearchUrl(query, limit, offset);
+    let extract;
+    try {
+        const result = await navigateAndExtract(url, EXTRACTOR);
+        if (!result.data) {
+            return [
+                {
+                    envelope: cnipaEnvelope("PATENT_SCHEMA_DRIFT", ADAPTER_PATH, "evaluate", "mcp-browser evaluate returned no data; check selector schema in src/adapters/cnipa/search.ts"),
+                },
+            ];
+        }
+        extract = result.data;
+    }
+    catch (err) {
+        if (err instanceof TransportError) {
+            return [
+                {
+                    envelope: transportErrorToEnvelope(err, ADAPTER_PATH, "navigate"),
+                },
+            ];
+        }
+        throw err;
+    }
+    if (looksLikeCaptcha(extract.rows.length, extract.html_marker)) {
+        return [
+            {
+                envelope: cnipaEnvelope("PATENT_BROWSER_CAPTCHA", ADAPTER_PATH, "evaluate", "CNIPA returned no rows for a non-empty query; solve the 验证码 in the open browser tab and re-run", ["espacenet", "lens"]),
+            },
+        ];
+    }
+    const out = [];
+    for (const row of extract.rows.slice(0, limit)) {
+        if (!row.publication_number)
+            continue;
+        try {
+            out.push(assemblePatentRecord({
+                publication_number: row.publication_number,
+                application_number: row.application_number || undefined,
+                title: row.title || undefined,
+                assignees: row.applicant
+                    ? [{ name: row.applicant, country: "CN" }]
+                    : undefined,
+                publication_date: row.publication_date || undefined,
+                filing_date: row.filing_date || undefined,
+                source_adapter: "cnipa",
+                source_url: row.source_url || url,
+            }));
+        }
+        catch {
+            // Skip malformed row rather than synthesize — rule 02.
+        }
+    }
+    if (out.length === 0) {
+        out.push({
+            envelope: cnipaEnvelope("PATENT_NOT_FOUND", ADAPTER_PATH, "normalize", "cnipa returned rows but none carried a publication_number; report as schema drift", ["espacenet"]),
+        });
+    }
+    return out;
+}
+cli({
+    site: "cnipa",
+    name: "search",
+    description: "Search CNIPA via the public 公众查询 browser interface (no API)",
+    domain: "pss-system.cponline.cnipa.gov.cn",
+    strategy: Strategy.PUBLIC,
+    adapter_path: ADAPTER_PATH,
+    args: [
+        {
+            name: "query",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "Free-text query — matched against title/abstract/claims",
+        },
+        {
+            name: "limit",
+            type: "int",
+            default: 25,
+            description: "Maximum results to return (1-100)",
+        },
+        {
+            name: "offset",
+            type: "int",
+            default: 0,
+            description: "Result offset for pagination",
+        },
+    ],
+    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) => runCnipaSearch(kwargs),
+});
+//# sourceMappingURL=search.js.map

package/dist/adapters/cnipa/search.js.map

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

package/dist/adapters/espacenet/_shared.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @owner       src::adapters::espacenet::_shared
+ * @does        Shared helpers for the Espacenet browser-driven adapter — distinct from the EPO OPS HTTP adapter (which lives at src/adapters/epo/*). Espacenet is the no-key public front end; EPO OPS is the keyed REST API.
+ * @needs       src/engine/transport/mcp-browser.ts, src/engine/normalizer/patent-envelope.ts, src/types/patent.ts
+ * @feeds       src/adapters/espacenet/*.ts
+ * @breaks      none — pure helpers
+ * @invariants  every transport gap surfaces as a PatentEnvelope row with adapter_path stamped
+ * @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 espacenetEnvelope(code: PatentErrorCode, adapter_path: string, step: string, suggestion: string, alternatives?: string[]): PatentEnvelope;
+export declare function transportErrorToEspacenetEnvelope(err: TransportError, adapter_path: string, step: string): PatentEnvelope;
+export declare function espacenetNavigateAndExtract<T>(url: string, expression: string): Promise<McpBrowserResult<T>>;
+//# sourceMappingURL=_shared.d.ts.map

package/dist/adapters/espacenet/_shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.d.ts","sourceRoot":"","sources":["../../../src/adapters/espacenet/_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,iBAAiB,CAC/B,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,iCAAiC,CAC/C,GAAG,EAAE,cAAc,EACnB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,GACX,cAAc,CAoBhB;AAED,wBAAsB,2BAA2B,CAAC,CAAC,EACjD,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAyB9B"}

package/dist/adapters/espacenet/_shared.js

@@ -0,0 +1,67 @@
+/**
+ * @owner       src::adapters::espacenet::_shared
+ * @does        Shared helpers for the Espacenet browser-driven adapter — distinct from the EPO OPS HTTP adapter (which lives at src/adapters/epo/*). Espacenet is the no-key public front end; EPO OPS is the keyed REST API.
+ * @needs       src/engine/transport/mcp-browser.ts, src/engine/normalizer/patent-envelope.ts, src/types/patent.ts
+ * @feeds       src/adapters/espacenet/*.ts
+ * @breaks      none — pure helpers
+ * @invariants  every transport gap surfaces as a PatentEnvelope row with adapter_path stamped
+ * @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 espacenetEnvelope(code, adapter_path, step, suggestion, alternatives = []) {
+    return buildPatentEnvelope({
+        code,
+        adapter_path,
+        step,
+        suggestion,
+        alternatives,
+        retryable: false,
+    });
+}
+export function transportErrorToEspacenetEnvelope(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; install an McpResolver before invoking espacenet browser adapter, or use EPO OPS (src/adapters/epo/*) which exposes a keyed API",
+            alternatives: ["epo", "uspto", "lens"],
+            retryable: false,
+        });
+    }
+    return buildPatentEnvelope({
+        code: "PATENT_API_DEPRECATED",
+        adapter_path,
+        step,
+        suggestion: `mcp-browser transport error (${err.code}): ${err.message}`,
+        alternatives: ["epo"],
+        retryable: false,
+    });
+}
+export async function espacenetNavigateAndExtract(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/espacenet/_shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_shared.js","sourceRoot":"","sources":["../../../src/adapters/espacenet/_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,iBAAiB,CAC/B,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,iCAAiC,CAC/C,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,gMAAgM;YAClM,YAAY,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC;YACtC,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,KAAK,CAAC;QACrB,SAAS,EAAE,KAAK;KACjB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,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/espacenet/family.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @owner       src::adapters::espacenet::family
+ * @does        Browser-driven Espacenet family lookup — DOCDB simple-family rows visible on the family tab of the detail page; alternative to EPO OPS keyed family broker.
+ * @needs       src/engine/transport/mcp-browser.ts, src/adapters/espacenet/_shared.ts, src/registry.ts
+ * @feeds       src/commands/patent.ts (capability tag patent.family)
+ * @breaks      PATENT_INVALID_NUMBER, PATENT_NOT_FOUND, PATENT_API_DEPRECATED (MCP_BUS_MISSING)
+ * @invariants  output rows carry publication_number + jurisdiction + relationship per PatentFamilyMember shape
+ * @side-effects controls Chrome via MCP
+ * @perf        single navigate + evaluate
+ * @concurrency safe
+ * @test        tests/unit/adapters/espacenet/search.test.ts (transport-error shared path)
+ * @stability   experimental
+ * @since       2026-05-18
+ * @verification browser-only
+ */
+export declare function runEspacenetFamily(kwargs: {
+    publication_number: string;
+}): Promise<unknown[]>;
+//# sourceMappingURL=family.d.ts.map

package/dist/adapters/espacenet/family.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"family.d.ts","sourceRoot":"","sources":["../../../src/adapters/espacenet/family.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAyCH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,kBAAkB,EAAE,MAAM,CAAC;CAC5B,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAuErB"}