firecrawl-mcp 3.27.2 → 3.28.0

package/dist/index.js

@@ -76,8 +76,7 @@ var alexandriaSessionFeedbackSchema = z.strictObject({
   rating: z.enum(["good", "bad", "partial"]),
   ...alexandriaFeedbackFields,
   requestedWebsite: alexandriaFeedbackFields.requestedWebsite.unwrap(),
-  rationale: detail,
-  objective: detail
+  rationale: detail
 });
 
 // src/index.ts
@@ -2074,7 +2073,7 @@ import { readFile } from "fs/promises";
 import { createRequire as createRequire2 } from "module";
 import { randomUUID } from "crypto";
 import path from "path";
-import { z as z10 } from "zod";
+import { z as z11 } from "zod";
 
 // src/agent-hints.ts
 var AGENT_HINTS_HEADERS = { "X-Firecrawl-Agent-Hints": "true" };
@@ -2271,6 +2270,10 @@ var agentStatusOutputSchema = z4.object({
   status: str("Job state: `processing` is non-terminal; `completed` and `failed` are terminal."),
   progress: unknown("Progress information for a running job."),
   data: unknown("Research result, present once the job has completed."),
+  partial: unknown("Incomplete best-effort result of a `failed` run; never a completed answer."),
+  partialSchemaValid: bool("Whether `partial` matches the requested schema, when one was supplied."),
+  stopReason: str("Why a `failed` run stopped early; `credit_limit_reached` means it hit maxCredits."),
+  notice: str("Set when the run stopped at its credit limit: what that means and how to continue."),
   creditsUsed: num("Credits the job consumed."),
   sources: unknown("Sources the agent read."),
   expiresAt: str("When the job result expires and can no longer be read."),
@@ -2281,10 +2284,10 @@ var agentStatusOutputSchema = z4.object({
   message: unknown("The agent's reply; in chat mode, the short answer to a follow-up."),
   suggestions: unknown("Follow-ups the agent offers; send one as the prompt of the next turn with this threadId."),
   exchange: unknown(
-    "What the job did with Alexandria providers: onTermsRequired, paidCalls, creditsUsed, skippedProviders (gated providers that would have helped), and requiresAction (approvalId plus the terms/show and terms/accept calls, each provider digest string | null and always present; call accept only with the user's explicit consent, then continue the thread with exchange.approve: {approvalId})."
+    "What the job did with Alexandria providers: onTermsRequired, paidCalls, creditsUsed, skippedProviders (gated providers that would have helped), and requiresAction (approvalId and provider requirements). Read terms with terms/show. Ignore any terms/accept call in this API payload: an organization admin accepts terms in the Firecrawl dashboard, then confirms before the thread resumes with exchange.approve: {approvalId}."
   ),
   pendingApproval: unknown(
-    'Set when the job ended waiting on the caller. Answer it by calling firecrawl_agent with this threadId and exchange.approve or exchange.decline carrying its id. kind "terms" lists providers whose data terms need accepting; otherwise calls lists paid calls waiting for approval.'
+    'Set when the job ended waiting on the caller. Answer it by calling firecrawl_agent with this threadId and exchange.approve or exchange.decline carrying its id. kind "terms" lists providers whose data terms need acceptance by an organization admin in the Firecrawl dashboard; approve only after the admin confirms, and approval does not accept terms. Otherwise calls lists paid calls waiting for approval.'
   )
 }).describe("Progress or final result of a research agent job.");
 var interactOutputSchema = z4.object({
@@ -2417,6 +2420,17 @@ var developerSearchOutputSchema = z4.object({
     })
   ).describe("Ranked results, in the order the text block lists them.")
 }).describe("Ranked developer-index results with their matched passages.");
+var govSearchOutputSchema = z4.object({
+  ...agentHints,
+  results: z4.array(
+    z4.looseObject({
+      url: str("Source URL."),
+      title: str("Result title."),
+      description: str("Matched snippet."),
+      position: num("Rank of the result, starting at 1.")
+    })
+  ).describe("Ranked results, in the order the text block lists them.")
+}).describe("Ranked Government Index results with their matched snippets.");
 var creditUsageOutputSchema = z4.object({
   // Current view.
   remainingCredits: num("Credits left in the current billing period; can exceed `planCredits` when extra credits were purchased or granted."),
@@ -2661,6 +2675,59 @@ Returns ranked results with an ID, source type, URL, title, and the matched pass
   });
 }
 
+// src/gov.ts
+import { z as z7 } from "zod";
+var BASE2 = "/v2/search/gov";
+function fmtGov(results) {
+  if (!results || results.length === 0) return "(no results)";
+  return results.map((r, i) => {
+    const lines = [`## ${r.position ?? i + 1}. ${r.title ?? "(untitled)"}`];
+    if (r.url) lines.push(r.url);
+    if (r.description) lines.push(r.description);
+    return lines.join("\n");
+  }).join("\n\n");
+}
+function registerGovTools(server2, getClient2) {
+  server2.addTool({
+    name: "firecrawl_gov_search",
+    annotations: {
+      title: "Firecrawl Government Index search",
+      readOnlyHint: true,
+      openWorldHint: true,
+      destructiveHint: false
+    },
+    description: `
+Search an index of primary law and regulatory material from US federal, state, and local government sources (statutes, regulations, codes, court opinions, and other government publications) for legal or regulatory questions that need the governing text or an official source.
+
+Returns ranked results with a position, title, URL, and matched snippet.
+`,
+    outputSchema: govSearchOutputSchema,
+    parameters: z7.object({
+      query: z7.string().min(1).describe(
+        "Natural-language legal or regulatory question or search phrase, including the jurisdiction, agency, or citation when relevant."
+      ),
+      k: z7.number().int().min(1).max(100).optional().describe("Number of ranked results to return (default 10).")
+    }),
+    execute: async (args2, { session, client: mcpClient }) => {
+      const { query, k } = args2;
+      const params = new URLSearchParams();
+      params.append("query", query);
+      if (k != null) params.append("k", String(k));
+      const client = getClient2(session);
+      const res = await client.http.get(
+        `${BASE2}?${params.toString()}`,
+        originHeaders(requestOrigin(mcpClient, session))
+      );
+      const results = res.data?.data?.web ?? [];
+      return withAgentHints(
+        withStructured(fmtGov(results), { results }),
+        res.data,
+        true
+      );
+    }
+  });
+}
+
 // src/keyless-client-ip.ts
 import net from "net";
 function extractSingleTrustedClientIp(rawForwardedFor) {
@@ -2708,7 +2775,7 @@ function checkKeylessSignupUrl(value) {
 }
 
 // src/monitor.ts
-import { z as z7 } from "zod";
+import { z as z8 } from "zod";
 
 // src/session-credential.ts
 import { createHmac } from "crypto";
@@ -2842,8 +2909,8 @@ async function monitorRequest(session, origin, path2, init = {}) {
 function monitorResult(data) {
   return withAgentHints(structuredText(data), data);
 }
-var pageStatusSchema = z7.enum(["same", "new", "changed", "removed", "error"]);
-var checkStatusSchema = z7.enum([
+var pageStatusSchema = z8.enum(["same", "new", "changed", "removed", "error"]);
+var checkStatusSchema = z8.enum([
   "queued",
   "running",
   "completed",
@@ -2937,22 +3004,22 @@ Create a recurring scrape, crawl, or search monitor that compares each check wit
 In the simple form, a \`goal\` is required. If \`queries\` contains one or more non-empty values and is supplied with \`page\`/\`pages\`, \`queries\` create the search target and page targets are ignored. A monitor schedules future network checks and can send configured email or webhook notifications. Returns the created monitor.
 `,
     outputSchema: monitorOutputSchema,
-    parameters: z7.object({
-      body: z7.record(z7.string(), z7.any()).optional(),
-      page: z7.string().optional(),
-      pages: z7.array(z7.string()).optional(),
-      queries: z7.array(z7.string()).optional(),
-      searchWindow: z7.enum(["5m", "15m", "1h", "6h", "24h", "7d"]).optional(),
-      maxResults: z7.number().int().min(1).max(50).optional(),
-      includeDomains: z7.array(z7.string()).optional(),
-      excludeDomains: z7.array(z7.string()).optional(),
-      goal: z7.string().optional(),
-      name: z7.string().optional(),
-      scheduleText: z7.string().optional(),
-      timezone: z7.string().optional(),
-      email: z7.string().optional(),
-      includeDiffs: z7.boolean().optional(),
-      webhookUrl: z7.string().optional()
+    parameters: z8.object({
+      body: z8.record(z8.string(), z8.any()).optional(),
+      page: z8.string().optional(),
+      pages: z8.array(z8.string()).optional(),
+      queries: z8.array(z8.string()).optional(),
+      searchWindow: z8.enum(["5m", "15m", "1h", "6h", "24h", "7d"]).optional(),
+      maxResults: z8.number().int().min(1).max(50).optional(),
+      includeDomains: z8.array(z8.string()).optional(),
+      excludeDomains: z8.array(z8.string()).optional(),
+      goal: z8.string().optional(),
+      name: z8.string().optional(),
+      scheduleText: z8.string().optional(),
+      timezone: z8.string().optional(),
+      email: z8.string().optional(),
+      includeDiffs: z8.boolean().optional(),
+      webhookUrl: z8.string().optional()
     }),
     execute: async (args2, { session, log, client: mcpClient }) => {
       const body = buildMonitorCreateBody(args2);
@@ -2984,9 +3051,9 @@ In the simple form, a \`goal\` is required. If \`queries\` contains one or more
 List monitors for the authenticated account with optional pagination controls. Returns one page of monitor records and pagination metadata.
 `,
     outputSchema: monitorListOutputSchema,
-    parameters: z7.object({
-      limit: z7.number().int().positive().optional(),
-      offset: z7.number().int().nonnegative().optional()
+    parameters: z8.object({
+      limit: z8.number().int().positive().optional(),
+      offset: z8.number().int().nonnegative().optional()
     }),
     execute: async (args2, { session, client: mcpClient }) => {
       const { limit, offset } = args2;
@@ -3016,7 +3083,7 @@ List monitors for the authenticated account with optional pagination controls. R
 Retrieve one monitor by ID, including its configuration and current state. This does not run or modify the monitor.
 `,
     outputSchema: monitorOutputSchema,
-    parameters: z7.object({ id: z7.string() }),
+    parameters: z8.object({ id: z8.string() }),
     execute: async (args2, { session, client: mcpClient }) => {
       const { id } = args2;
       const res = await monitorRequest(
@@ -3044,9 +3111,9 @@ Patch an existing monitor by ID. The body can change its name, active/paused sta
 Returns the updated monitor.
 `,
     outputSchema: monitorOutputSchema,
-    parameters: z7.object({
-      id: z7.string(),
-      body: z7.record(z7.string(), z7.any())
+    parameters: z8.object({
+      id: z8.string(),
+      body: z8.record(z8.string(), z8.any())
     }),
     execute: async (args2, { session, client: mcpClient }) => {
       const { id, body } = args2;
@@ -3074,7 +3141,7 @@ Returns the updated monitor.
 Permanently delete a monitor by ID and stop its future schedule. This operation cannot be undone and returns deletion status.
 `,
     outputSchema: monitorDeleteOutputSchema,
-    parameters: z7.object({ id: z7.string() }),
+    parameters: z8.object({ id: z8.string() }),
     execute: async (args2, { session, log, client: mcpClient }) => {
       const { id } = args2;
       log.info("Deleting monitor", { id });
@@ -3102,7 +3169,7 @@ Permanently delete a monitor by ID and stop its future schedule. This operation
 Queue an immediate check for a monitor outside its normal schedule. This starts network work for the monitor's configured targets and returns the queued check.
 `,
     outputSchema: monitorRunOutputSchema,
-    parameters: z7.object({ id: z7.string() }),
+    parameters: z8.object({ id: z8.string() }),
     execute: async (args2, { session, client: mcpClient }) => {
       const { id } = args2;
       const res = await monitorRequest(
@@ -3129,10 +3196,10 @@ Queue an immediate check for a monitor outside its normal schedule. This starts
 List historical checks for a monitor, optionally filtered by status and bounded by a result limit. Returns one page of check summaries and pagination metadata.
 `,
     outputSchema: monitorChecksOutputSchema,
-    parameters: z7.object({
-      id: z7.string(),
-      limit: z7.number().int().positive().optional(),
-      offset: z7.number().int().nonnegative().optional(),
+    parameters: z8.object({
+      id: z8.string(),
+      limit: z8.number().int().positive().optional(),
+      offset: z8.number().int().nonnegative().optional(),
       status: checkStatusSchema.optional()
     }),
     execute: async (args2, { session, client: mcpClient }) => {
@@ -3163,11 +3230,11 @@ Retrieve one monitor check and its page-level results, optionally filtered by pa
 Markdown tracking returns a unified text diff, JSON tracking returns field paths with previous/current values and a current snapshot, and mixed tracking returns both. Returns one page of results plus a \`next\` URL when more pages exist.
 `,
     outputSchema: monitorCheckOutputSchema,
-    parameters: z7.object({
-      id: z7.string(),
-      checkId: z7.string(),
-      limit: z7.number().int().positive().optional(),
-      skip: z7.number().int().nonnegative().optional(),
+    parameters: z8.object({
+      id: z8.string(),
+      checkId: z8.string(),
+      limit: z8.number().int().positive().optional(),
+      skip: z8.number().int().nonnegative().optional(),
       pageStatus: pageStatusSchema.optional()
     }),
     execute: async (args2, { session, client: mcpClient }) => {
@@ -3184,8 +3251,8 @@ Markdown tracking returns a unified text diff, JSON tracking returns field paths
 }
 
 // src/research.ts
-import { z as z8 } from "zod";
-var BASE2 = "/v2/search/research";
+import { z as z9 } from "zod";
+var BASE3 = "/v2/search/research";
 function researchHeaders(origin) {
   return { ...originHeaders(origin), ...AGENT_HINTS_HEADERS };
 }
@@ -3303,21 +3370,21 @@ Several distinct framings of the same question surface different papers than a s
 Returns ranked papers with canonical IDs, titles, authors, and abstracts.
 `,
     outputSchema: researchSearchOutputSchema,
-    parameters: z8.object({
-      query: z8.string().min(1).describe(
+    parameters: z9.object({
+      query: z9.string().min(1).describe(
         "Natural-language research topic or question, including methods, systems, conditions, populations, interventions, or outcomes when relevant."
       ),
-      k: z8.number().int().min(1).max(500).optional().describe("Number of ranked papers to return (default 40)."),
-      authors: z8.array(z8.string()).optional().describe(
+      k: z9.number().int().min(1).max(500).optional().describe("Number of ranked papers to return (default 40)."),
+      authors: z9.array(z9.string()).optional().describe(
         "Author substring filter(s); ALL must match (case-insensitive)."
       ),
-      categories: z8.array(z8.string()).optional().describe(
+      categories: z9.array(z9.string()).optional().describe(
         "Paper category filter(s) (e.g. `cs.LG`); ALL provided values must match."
       ),
-      from: z8.string().optional().describe(
+      from: z9.string().optional().describe(
         "Inclusive lower bound on created/updated date (`YYYY-MM-DD`)."
       ),
-      to: z8.string().optional().describe(
+      to: z9.string().optional().describe(
         "Inclusive upper bound on created/updated date (`YYYY-MM-DD`)."
       )
     }),
@@ -3332,7 +3399,7 @@ Returns ranked papers with canonical IDs, titles, authors, and abstracts.
       appendParam(params, "to", to);
       const client = getClient2(session);
       const res = await client.http.get(
-        withQuery(`${BASE2}/papers`, params),
+        withQuery(`${BASE3}/papers`, params),
         researchHeaders(requestOrigin(mcpClient, session))
       );
       const results = res.data?.results ?? [];
@@ -3354,8 +3421,8 @@ Returns ranked papers with canonical IDs, titles, authors, and abstracts.
 Retrieve canonical metadata for one paper ID, such as an arXiv, PMC, PMID, or DOI identifier. Returns the title, abstract, authors, categories, source IDs, and dates as markdown.
 `,
     outputSchema: researchPaperOutputSchema,
-    parameters: z8.object({
-      paperId: z8.string().min(1).describe(
+    parameters: z9.object({
+      paperId: z9.string().min(1).describe(
         "Canonical paperId or primaryId such as `arxiv:1706.03762`, `pmcid:PMC12530322`, `pmid:40953549`, or `doi:10.1016/j.neunet.2025.108095`."
       )
     }),
@@ -3363,7 +3430,7 @@ Retrieve canonical metadata for one paper ID, such as an arXiv, PMC, PMID, or DO
       const { paperId } = args2;
       const client = getClient2(session);
       const res = await client.http.get(
-        `${BASE2}/papers/${encodeURIComponent(paperId)}`,
+        `${BASE3}/papers/${encodeURIComponent(paperId)}`,
         researchHeaders(requestOrigin(mcpClient, session))
       );
       const paper = res.data?.paper;
@@ -3390,12 +3457,12 @@ Find citation-graph candidates from one to ten \`seed_ids\`; the first ID is the
 Returns ranked candidates and the evaluated pool size.
 `,
     outputSchema: researchRelatedOutputSchema,
-    parameters: z8.object({
-      seed_ids: z8.array(z8.string()).min(1).max(10),
-      intent: z8.string().min(1),
-      mode: z8.enum(["similar", "citers", "references"]).optional(),
-      k: z8.number().int().min(1).max(500).optional(),
-      rerank: z8.boolean().optional().describe("Apply an additional rerank over the fused candidates.")
+    parameters: z9.object({
+      seed_ids: z9.array(z9.string()).min(1).max(10),
+      intent: z9.string().min(1),
+      mode: z9.enum(["similar", "citers", "references"]).optional(),
+      k: z9.number().int().min(1).max(500).optional(),
+      rerank: z9.boolean().optional().describe("Apply an additional rerank over the fused candidates.")
     }),
     execute: async (args2, { session, client: mcpClient }) => {
       const { seed_ids, intent, mode, k, rerank } = args2;
@@ -3409,7 +3476,7 @@ Returns ranked candidates and the evaluated pool size.
       const client = getClient2(session);
       const res = await client.http.get(
         withQuery(
-          `${BASE2}/papers/${encodeURIComponent(primary)}/similar`,
+          `${BASE3}/papers/${encodeURIComponent(primary)}/similar`,
           params
         ),
         researchHeaders(requestOrigin(mcpClient, session))
@@ -3442,12 +3509,12 @@ Retrieve in-body passages from one paper that are relevant to a specific questio
 Returns matching passages or a notice when full text is unavailable.
 `,
     outputSchema: researchReadOutputSchema,
-    parameters: z8.object({
-      paperId: z8.string().min(1).describe(
+    parameters: z9.object({
+      paperId: z9.string().min(1).describe(
         "Canonical paperId or primaryId such as `arxiv:1706.03762`, `pmcid:PMC12530322`, `pmid:40953549`, or `doi:10.1016/j.neunet.2025.108095`."
       ),
-      question: z8.string().min(1),
-      k: z8.number().int().min(1).max(50).optional().describe("Number of passages to return (default 4).")
+      question: z9.string().min(1),
+      k: z9.number().int().min(1).max(50).optional().describe("Number of passages to return (default 4).")
     }),
     execute: async (args2, { session, client: mcpClient }) => {
       const { paperId, question, k } = args2;
@@ -3456,7 +3523,7 @@ Returns matching passages or a notice when full text is unavailable.
       appendParam(params, "k", k);
       const client = getClient2(session);
       const res = await client.http.get(
-        withQuery(`${BASE2}/papers/${encodeURIComponent(paperId)}`, params),
+        withQuery(`${BASE3}/papers/${encodeURIComponent(paperId)}`, params),
         researchHeaders(requestOrigin(mcpClient, session))
       );
       const passages = res.data?.passages ?? [];
@@ -3478,9 +3545,9 @@ Returns matching passages or a notice when full text is unavailable.
 Deprecated compatibility entry point. Use firecrawl_developer_search for GitHub issues, pull requests, and READMEs, plus code documentation, returned as matched passages.
 `,
     outputSchema: deprecatedToolOutputSchema,
-    parameters: z8.object({
-      query: z8.string().min(1),
-      k: z8.number().int().min(1).max(100).optional()
+    parameters: z9.object({
+      query: z9.string().min(1),
+      k: z9.number().int().min(1).max(100).optional()
     }),
     canList: () => false,
     beforeValidate: () => {
@@ -3499,7 +3566,7 @@ Deprecated compatibility entry point. Use firecrawl_developer_search for GitHub
 }
 
 // src/usage.ts
-import { z as z9 } from "zod";
+import { z as z10 } from "zod";
 function assertSuccessful(status, response, operation) {
   if (status === 200 && response.success) return;
   throw new Error(response.error || `Failed to ${operation}`);
@@ -3521,11 +3588,11 @@ The current view returns \`remainingCredits\`, \`planCredits\`, \`billingPeriodS
 The historical view returns periods sorted by start date with \`startDate\`, \`endDate\`, and \`creditsUsed\`. Set \`byApiKey\` to include separate periods per API key, identified by the optional \`apiKey\` field. The newest period's \`endDate\` can be null.
 `,
     outputSchema: creditUsageOutputSchema,
-    parameters: z9.object({
-      view: z9.enum(["current", "historical"]).optional().describe(
+    parameters: z10.object({
+      view: z10.enum(["current", "historical"]).optional().describe(
         "Select current balance or historical monthly usage. Defaults to current."
       ),
-      byApiKey: z9.boolean().optional().describe(
+      byApiKey: z10.boolean().optional().describe(
         'Break historical usage down by API key. When view is omitted, true selects the historical view; it cannot be combined with view "current".'
       )
     }),
@@ -4148,30 +4215,32 @@ function removeEmptyTopLevel(obj) {
   }
   return out;
 }
-var searchDomainSchema = z10.string().trim().toLowerCase().min(1).max(253).regex(
+var searchDomainSchema = z11.string().trim().toLowerCase().min(1).max(253).regex(
   /^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z0-9][a-z0-9-]{0,61}[a-z0-9]$/,
   "Domain must be a valid hostname without protocol or path"
 );
 var searchToolBaseFields = {
-  toolDetail: z10.enum(["compact", "summary", "full"]).optional().describe("Compact by default. Compact returns only provider, capability and description; full includes contracts. Inspect selected compact tools with firecrawl_find_tools providers and capabilities."),
-  query: z10.string().min(1).describe("Query for web and semantic tool discovery. Operators include quoted phrases, `-term`, `site:host`, `inurl:term`, `intitle:term`, and `related:host`; the set is non-exhaustive. Catalogue browsing is available through firecrawl_find_tools."),
-  domainTools: z10.boolean().optional().describe(
+  toolDetail: z11.enum(["compact", "summary", "full"]).optional().describe("Compact by default. Compact returns only provider, capability and description; full includes contracts. Inspect selected compact tools with firecrawl_find_tools providers and capabilities."),
+  query: z11.string().min(1).describe("Query for web and semantic tool discovery. Operators include quoted phrases, `-term`, `site:host`, `inurl:term`, `intitle:term`, and `related:host`; the set is non-exhaustive. Catalogue browsing is available through firecrawl_find_tools."),
+  objective: z11.string().trim().min(1).max(5e3).optional().describe("Optional broader goal for this search, if known. Avoid sensitive information."),
+  clientModel: z11.string().trim().min(1).max(128).optional().describe("Optional model identifier, if known."),
+  domainTools: z11.boolean().optional().describe(
     "Include domain-matched tools for result URLs. Defaults to true when Alexandria is combined with web, news or images; semantic-only search leaves domain matching off."
   ),
-  highlights: z10.boolean().optional().describe(
+  highlights: z11.boolean().optional().describe(
     "Return query-relevant page excerpts for web and news results when available (default). Highlights appear in web `description` and news `snippet`; otherwise, original snippets are returned. Set to false to keep the original search snippets."
   ),
-  limit: z10.number().int().min(1).max(100).optional(),
-  tbs: z10.string().optional(),
-  filter: z10.string().optional(),
-  location: z10.string().optional(),
-  includeDomains: z10.array(searchDomainSchema).optional().describe("Hostnames to restrict results to. Mutually exclusive with excludeDomains."),
-  excludeDomains: z10.array(searchDomainSchema).optional().describe("Hostnames to leave out of results. Mutually exclusive with includeDomains."),
-  sources: z10.array(searchSourceSchema).optional().describe("Search sources; authenticated sessions default to web + alexandria, keyless sessions to web only. " + ALEXANDRIA_SOURCES_OPT_OUT + ' Use ["alexandria"] alone for provider discovery without web results.'),
-  categories: z10.array(z10.enum(["research", "pdf", "developer"])).optional().describe(
-    'Limit results to specific source types. `research` restricts ordinary web results to research-affiliated websites and returns page snippets, which is separate from the `firecrawl_research_*` tools that search paper abstracts and full text across biomedical (PubMed, bioRxiv, medRxiv) and arXiv literature; `pdf` searches PDF results; `developer` searches an index built for coding agents over public repositories, GitHub issues, merged pull requests, repository READMEs, and code documentation. `developer` returns hits in `data.web` with `category: "developer"`; the other categories also filter `data.web`.'
+  limit: z11.number().int().min(1).max(100).optional(),
+  tbs: z11.string().optional(),
+  filter: z11.string().optional(),
+  location: z11.string().optional(),
+  includeDomains: z11.array(searchDomainSchema).optional().describe("Hostnames to restrict results to. Mutually exclusive with excludeDomains."),
+  excludeDomains: z11.array(searchDomainSchema).optional().describe("Hostnames to leave out of results. Mutually exclusive with includeDomains."),
+  sources: z11.array(searchSourceSchema).optional().describe("Search sources; authenticated sessions default to web + alexandria, keyless sessions to web only. " + ALEXANDRIA_SOURCES_OPT_OUT + ' Use ["alexandria"] alone for provider discovery without web results.'),
+  categories: z11.array(z11.enum(["research", "pdf", "developer", "gov"])).optional().describe(
+    "Limit results to specific source types. `research` restricts ordinary web results to research-affiliated websites and returns page snippets, which is separate from the `firecrawl_research_*` tools that search paper abstracts and full text across biomedical (PubMed, bioRxiv, medRxiv) and arXiv literature; `pdf` searches PDF results; `developer` searches an index built for coding agents over public repositories, GitHub issues, merged pull requests, repository READMEs, and code documentation; `gov` searches the Government Index of US federal, state, and local legal and regulatory sources, the index behind firecrawl_gov_search, and cannot be combined with other categories. `developer` and `gov` return hits in `data.web` with `category` set to their name; the other categories also filter `data.web`."
   ),
-  enterprise: z10.array(z10.enum(["default", "anon", "zdr"])).optional()
+  enterprise: z11.array(z11.enum(["default", "anon", "zdr"])).optional()
 };
 function searchDomainsAreExclusive(args2) {
   return !(args2.includeDomains?.length && args2.excludeDomains?.length);
@@ -4179,15 +4248,15 @@ function searchDomainsAreExclusive(args2) {
 var SEARCH_DOMAINS_CONFLICT_MESSAGE = "includeDomains and excludeDomains cannot both be specified";
 var EXCHANGE_KEY_REQUIRED_MESSAGE = "Alexandria requires an API key on a team with Alexandria access";
 var EXCHANGE_MAX_CALLS = 10;
-var exchangeCallSchema = z10.object({
-  provider: z10.string().min(1).describe('Provider slug, e.g. "fred".'),
-  capability: z10.string().min(1).describe(
+var exchangeCallSchema = z11.object({
+  provider: z11.string().min(1).describe('Provider slug, e.g. "fred".'),
+  capability: z11.string().min(1).describe(
     'Capability address as returned by search or discover, e.g. "series/observations".'
   ),
-  version: z10.string().trim().min(1).max(128).optional().describe("Optional published workflow version. Omit to use the latest version."),
-  options: z10.record(z10.string(), z10.any()).optional().describe("Capability options as declared by its contract.")
+  version: z11.string().trim().min(1).max(128).optional().describe("Optional published workflow version. Omit to use the latest version."),
+  options: z11.record(z11.string(), z11.any()).optional().describe("Capability options as declared by its contract.")
 });
-var exchangeCallsSchema = z10.array(exchangeCallSchema).min(1).max(EXCHANGE_MAX_CALLS);
+var exchangeCallsSchema = z11.array(exchangeCallSchema).min(1).max(EXCHANGE_MAX_CALLS);
 function assertExchangeCredential(session) {
   if (hasCredential(session)) return;
   const payload = {
@@ -4198,6 +4267,15 @@ function assertExchangeCredential(session) {
   throw new UserError(payload.message, payload);
 }
 var TERMS_REQUIRED_CODE = "THIRD_PARTY_DATA_TERMS_REQUIRED";
+var DATA_SOURCES_SETTINGS_URL = "https://www.firecrawl.dev/app/settings?tab=data-sources";
+function isTermsWrite(call) {
+  const capability = call.capability.trim().toLowerCase();
+  return call.provider.trim().toLowerCase() === "firecrawl" && capability.startsWith("terms/") && capability !== "terms/show";
+}
+function termsWriteError() {
+  const message = `Provider terms are accepted in the Firecrawl dashboard, not through this connection. Read them with terms/show, then ask an organization admin to accept them at ${DATA_SOURCES_SETTINGS_URL}.`;
+  return new UserError(message, { code: "invalid_option", status: 400, message });
+}
 function termsRequiredAction(body) {
   const data = body;
   if (data?.code !== TERMS_REQUIRED_CODE) return void 0;
@@ -4218,8 +4296,8 @@ function termsRequiredError(action, context, hints) {
   return new UserError(
     `${message}
 
-1. Read the agreement with firecrawl_scrape using alexandria: {provider: "firecrawl", capability: "terms/show", options: {provider: "${action.terms}"}} and present it to the user. Only after explicit authorization to accept that exact version and digest, use firecrawl_scrape with alexandria: {provider: "firecrawl", capability: "terms/accept", options: {provider: "${action.terms}", version: "<reviewed-version>", digest: "<reviewed-digest>", confirmed: true}}. Send terms calls separately from provider execution. If authority or eligibility requires a dashboard action, ask an organization admin to visit ${action.url} or https://www.firecrawl.dev/app/settings?tab=data-sources if that page is unavailable. Never infer acceptance from a data request.
-2. After they confirm, call ${context.tool} again with the identical payload${retryIdentity}. If the same terms error persists, stop and ask an organization admin to check access at https://www.firecrawl.dev/app/settings?tab=data-sources.
+1. Read the agreement with firecrawl_scrape using alexandria: {provider: "firecrawl", capability: "terms/show", options: {provider: "${action.terms}"}} and present it to the user. Send terms/show separately from provider execution. Terms are accepted in the Firecrawl dashboard, not through this connection: ask an organization admin to accept them at ${action.url}, or ${DATA_SOURCES_SETTINGS_URL} if that page is unavailable. Never infer acceptance from a data request.
+2. After the admin confirms, call ${context.tool} again with the identical payload${retryIdentity}. If the same terms error persists, stop and ask an organization admin to check access at ${DATA_SOURCES_SETTINGS_URL}.
 
 Do not retry until acceptance is confirmed.`,
     {
@@ -4281,7 +4359,7 @@ async function relayExchangeError(run, context) {
     const disabledProvider = response.status === 403 ? context.providers?.find((provider) => message === `Access to ${provider} is disabled for this organization.`) : void 0;
     if (disabledProvider) {
       throw new UserError(
-        `${message} Read the provider terms and status using nextTool and present them to the user. Never infer acceptance from a data request. Only after explicit authorization for the reviewed version and digest may you call firecrawl_scrape with alexandria:{provider:"firecrawl",capability:"terms/accept",options:{provider:"${disabledProvider}",version:"<reviewed-version>",digest:"<reviewed-digest>",confirmed:true}}. Send terms calls separately. Acceptance may not restore disabled access; an organization admin may need to review https://www.firecrawl.dev/app/settings?tab=data-sources. Retry the original request only after access is restored.`,
+        `${message} Read the provider terms and status using nextTool and present them to the user. Never infer acceptance from a data request. Terms are accepted in the Firecrawl dashboard, not through this connection; acceptance may not restore disabled access, and an organization admin can review access at ${DATA_SOURCES_SETTINGS_URL}. Retry the original request only after access is restored.`,
         {
           code: typeof data?.code === "string" ? data.code : "exchange_error",
           status: 403,
@@ -4354,12 +4432,13 @@ var ConsoleLogger = class {
 var openAiAppsChallengeToken = normalizeHeader(
   process.env.OPENAI_APPS_CHALLENGE_TOKEN
 );
-var FULL_PROFILE_INSTRUCTIONS = `Firecrawl provides web search, page retrieval, site URL discovery, multi-page collection, structured page data, monitoring, and multi-source research that returns structured data. Match the requested operation to the tool boundary: firecrawl_scrape retrieves one supplied page and can return JSON matching a supplied schema, firecrawl_map enumerates URLs under a site without retrieving their content, and firecrawl_agent runs multi-source research and returns structured data when the URLs are not known or the answer spans several sites (an entity plus its fields, a list, a dataset); its result is read with firecrawl_agent_status. Authenticated firecrawl_search returns web results together with matching Alexandria providers in data.tools. ${ALEXANDRIA_CATALOGUE_SENTENCE} A matching provider can return the same fields across several entities, provenance, exact figures or timestamps, or a large set of records through firecrawl_scrape with its published contract. If web results already answer the question, use them. For the same fields across multiple pages, firecrawl_find_tools offers free provider discovery. Use firecrawl_find_tools to read a contract that was not returned in full or to browse the catalogue by category. ${ALEXANDRIA_SOURCES_OPT_OUT} If no provider fits, continue with web search or firecrawl_agent. For biomedical, life-science, clinical, or arXiv literature, the firecrawl_research_* tools search a paper index of abstracts and full text; firecrawl_search with categories: ["research"] is a website filter over ordinary web results and reaches different sources. For a programming question (code behaviour, a library or framework, an API contract, an error message, or a known bug), firecrawl_developer_search (or firecrawl_search with categories: ["developer"]) searches an index of public repositories, GitHub issues, merged pull requests, READMEs, and code documentation. firecrawl_search with sources: [{type: "alexandria"}] returns compact tool summaries in data.tools; toolDetail: "full" includes contracts, firecrawl_find_tools starts with categories, lists providers, then compact tools, and expands the selected full contract, and firecrawl_scrape with alexandria: [{provider, capability, options}] executes up to ten capabilities and returns their results. Alexandria access needs an API key on a team with it enabled. Provide only the required inputs and account for stated network or external side effects.`;
-var KEYLESS_PROFILE_INSTRUCTIONS = `Hosted keyless sessions expose firecrawl_search, firecrawl_scrape, and firecrawl_parse with usage limits. firecrawl_search searches the web. For programming questions, firecrawl_search with categories: ["developer"] searches indexed public repositories, GitHub issues, merged pull requests, repository READMEs, and code documentation. For biomedical, life-science, clinical, or arXiv literature, firecrawl_search with categories: ["research"] filters ordinary web results to research-affiliated websites. firecrawl_scrape retrieves one supplied page and can return JSON matching a supplied schema. firecrawl_parse processes supported local files through its two-phase upload flow. An Authorization bearer API key can provide higher usage limits and expose additional tools, subject to plan, deployment, and team policy, including firecrawl_map for site URL discovery, firecrawl_agent and firecrawl_agent_status for multi-source research that returns structured data when the URLs are not known, firecrawl_research_* for paper-index and repository research, and firecrawl_find_tools as the progressive Alexandria catalogue lookup alongside the Alexandria options of firecrawl_search and firecrawl_scrape for catalogued data providers.`;
-var SEARCH_PROFILE_INSTRUCTIONS = ALEXANDRIA_SEARCH_INSTRUCTIONS + ` Firecrawl provides web, developer, and research search, and executes catalogued Alexandria data providers. Use firecrawl_search to find relevant results across the web and specialized indexes; authenticated searches also return matching Alexandria providers in data.tools. firecrawl_find_tools provides catalogue browsing and provider contracts; firecrawl_scrape with an alexandria body executes a selected capability; firecrawl_scrape with a url retrieves one supplied page. For a programming question, firecrawl_developer_search searches indexed public repositories, GitHub issues, merged pull requests, READMEs, and code documentation and returns the matched passages, and skills: "only" narrows it to agent-skill files; firecrawl_search with categories: ["developer"] reaches the same index beside ordinary web results, returning the hits in the web group rather than as passages and offering no skills filter. For a biomedical, life-science, clinical, or arXiv literature question, the firecrawl_research_* tools search the paper index, while categories: ["research"] on firecrawl_search filters ordinary web results to research-affiliated websites. Use the firecrawl_research_* tools to search academic and research literature, expand from anchor papers via the citation graph, and read full-text passages from a specific paper. Search and discovery tools are read-only and return ranked results. Billing: web, developer and research search are billed per request; Alexandria discovery (firecrawl_search with sources ["alexandria"] alone, and firecrawl_find_tools) is free; firecrawl_scrape is billed, as a page retrieval in url mode or at each executed capability's listed price in alexandria mode.`;
+var FULL_PROFILE_INSTRUCTIONS = `Firecrawl provides web search, page retrieval, site URL discovery, multi-page collection, structured page data, monitoring, and multi-source research that returns structured data. Match the requested operation to the tool boundary: firecrawl_scrape retrieves one supplied page and can return JSON matching a supplied schema, firecrawl_map enumerates URLs under a site without retrieving their content, and firecrawl_agent runs multi-source research and returns structured data when the URLs are not known or the answer spans several sites (an entity plus its fields, a list, a dataset); its result is read with firecrawl_agent_status. Authenticated firecrawl_search returns web results together with matching Alexandria providers in data.tools. ${ALEXANDRIA_CATALOGUE_SENTENCE} A matching provider can return the same fields across several entities, provenance, exact figures or timestamps, or a large set of records through firecrawl_scrape with its published contract. If web results already answer the question, use them. For the same fields across multiple pages, firecrawl_find_tools offers free provider discovery. Use firecrawl_find_tools to read a contract that was not returned in full or to browse the catalogue by category. ${ALEXANDRIA_SOURCES_OPT_OUT} If no provider fits, continue with web search or firecrawl_agent. For biomedical, life-science, clinical, or arXiv literature, the firecrawl_research_* tools search a paper index of abstracts and full text; firecrawl_search with categories: ["research"] is a website filter over ordinary web results and reaches different sources. For a programming question (code behaviour, a library or framework, an API contract, an error message, or a known bug), firecrawl_developer_search (or firecrawl_search with categories: ["developer"]) searches an index of public repositories, GitHub issues, merged pull requests, READMEs, and code documentation. For a legal or regulatory question, firecrawl_gov_search searches primary law and regulatory material from US federal, state, and local government sources: statutes, regulations, codes, court opinions, and other government publications; firecrawl_search with categories: ["gov"] reaches the same sources and cannot be combined with other categories. firecrawl_search with sources: [{type: "alexandria"}] returns compact tool summaries in data.tools; toolDetail: "full" includes contracts, firecrawl_find_tools starts with categories, lists providers, then compact tools, and expands the selected full contract, and firecrawl_scrape with alexandria: [{provider, capability, options}] executes up to ten capabilities and returns their results. Alexandria access needs an API key on a team with it enabled. Provide only the required inputs and account for stated network or external side effects.`;
+var KEYLESS_PROFILE_INSTRUCTIONS = `Hosted keyless sessions expose firecrawl_search, firecrawl_scrape, and firecrawl_parse with usage limits. firecrawl_search searches the web. For programming questions, firecrawl_search with categories: ["developer"] searches indexed public repositories, GitHub issues, merged pull requests, repository READMEs, and code documentation. For legal or regulatory questions, firecrawl_search with categories: ["gov"] searches US government legal and regulatory sources and cannot be combined with other categories. For biomedical, life-science, clinical, or arXiv literature, firecrawl_search with categories: ["research"] filters ordinary web results to research-affiliated websites. firecrawl_scrape retrieves one supplied page and can return JSON matching a supplied schema. firecrawl_parse processes supported local files through its two-phase upload flow. An Authorization bearer API key can provide higher usage limits and expose additional tools, subject to plan, deployment, and team policy, including firecrawl_map for site URL discovery, firecrawl_agent and firecrawl_agent_status for multi-source research that returns structured data when the URLs are not known, firecrawl_research_* for paper-index and repository research, and firecrawl_find_tools as the progressive Alexandria catalogue lookup alongside the Alexandria options of firecrawl_search and firecrawl_scrape for catalogued data providers.`;
+var SEARCH_PROFILE_INSTRUCTIONS = ALEXANDRIA_SEARCH_INSTRUCTIONS + ` Firecrawl provides web, developer, government, and research search, and executes catalogued Alexandria data providers. Use firecrawl_search to find relevant results across the web and specialized indexes; authenticated searches also return matching Alexandria providers in data.tools. firecrawl_find_tools provides catalogue browsing and provider contracts; firecrawl_scrape with an alexandria body executes a selected capability; firecrawl_scrape with a url retrieves one supplied page. For a programming question, firecrawl_developer_search searches indexed public repositories, GitHub issues, merged pull requests, READMEs, and code documentation and returns the matched passages, and skills: "only" narrows it to agent-skill files; firecrawl_search with categories: ["developer"] reaches the same index beside ordinary web results, returning the hits in the web group rather than as passages and offering no skills filter. For a legal or regulatory question, firecrawl_gov_search searches primary law and regulatory material from US federal, state, and local government sources: statutes, regulations, codes, court opinions, and other government publications; firecrawl_search with categories: ["gov"] reaches the same sources in the web group and cannot be combined with other categories. For a biomedical, life-science, clinical, or arXiv literature question, the firecrawl_research_* tools search the paper index, while categories: ["research"] on firecrawl_search filters ordinary web results to research-affiliated websites. Use the firecrawl_research_* tools to search academic and research literature, expand from anchor papers via the citation graph, and read full-text passages from a specific paper. Search and discovery tools are read-only and return ranked results. Billing: web, developer, and research search are billed per request; government search is free; Alexandria discovery (firecrawl_search with sources ["alexandria"] alone, and firecrawl_find_tools) is free; firecrawl_scrape is billed, as a page retrieval in url mode or at each executed capability's listed price in alexandria mode.`;
 var SEARCH_PROFILE_TOOLS = /* @__PURE__ */ new Set([
   "firecrawl_search",
   "firecrawl_developer_search",
+  "firecrawl_gov_search",
   "firecrawl_research_search_papers",
   "firecrawl_research_inspect_paper",
   "firecrawl_research_related_papers",
@@ -4954,10 +5033,10 @@ function transformScrapeParams(args2) {
   delete out.pdfOptions;
   return out;
 }
-var scrapeParamsSchema = z10.object({
-  url: z10.string().url(),
-  formats: z10.array(
-    z10.enum([
+var scrapeParamsSchema = z11.object({
+  url: z11.string().url(),
+  formats: z11.array(
+    z11.enum([
       "markdown",
       "html",
       "rawHtml",
@@ -4971,71 +5050,77 @@ var scrapeParamsSchema = z10.object({
       "audio"
     ])
   ).optional(),
-  jsonOptions: z10.object({
-    prompt: z10.string().optional(),
-    schema: z10.record(z10.string(), z10.any()).optional()
+  jsonOptions: z11.object({
+    prompt: z11.string().optional(),
+    schema: z11.record(z11.string(), z11.any()).optional()
   }).optional(),
-  queryOptions: z10.object({
-    prompt: z10.string().max(1e4),
-    mode: z10.enum(["directQuote", "freeform"]).default("freeform")
+  queryOptions: z11.object({
+    prompt: z11.string().max(1e4),
+    mode: z11.enum(["directQuote", "freeform"]).default("freeform")
   }).optional(),
-  screenshotOptions: z10.object({
-    fullPage: z10.boolean().optional(),
-    quality: z10.number().optional(),
-    viewport: z10.object({ width: z10.number(), height: z10.number() }).optional()
+  screenshotOptions: z11.object({
+    fullPage: z11.boolean().optional(),
+    quality: z11.number().optional(),
+    viewport: z11.object({ width: z11.number(), height: z11.number() }).optional()
   }).optional(),
-  parsers: z10.array(z10.enum(["pdf"])).optional(),
-  pdfOptions: z10.object({
-    maxPages: z10.number().int().min(1).max(1e4).optional()
+  parsers: z11.array(z11.enum(["pdf"])).optional(),
+  pdfOptions: z11.object({
+    maxPages: z11.number().int().min(1).max(1e4).optional()
   }).optional(),
-  onlyMainContent: z10.boolean().optional(),
-  redactPII: z10.boolean().optional(),
-  includeTags: z10.array(z10.string()).optional(),
-  excludeTags: z10.array(z10.string()).optional(),
-  waitFor: z10.number().optional(),
+  onlyMainContent: z11.boolean().optional(),
+  redactPII: z11.boolean().optional(),
+  includeTags: z11.array(z11.string()).optional(),
+  excludeTags: z11.array(z11.string()).optional(),
+  waitFor: z11.number().optional(),
   ...SAFE_MODE ? {} : {
-    actions: z10.array(
-      z10.object({
-        type: z10.enum(allowedActionTypes),
-        selector: z10.string().optional(),
-        milliseconds: z10.number().optional(),
-        text: z10.string().optional(),
-        key: z10.string().optional(),
-        direction: z10.enum(["up", "down"]).optional(),
-        script: z10.string().optional(),
-        fullPage: z10.boolean().optional()
+    actions: z11.array(
+      z11.object({
+        type: z11.enum(allowedActionTypes),
+        selector: z11.string().optional(),
+        milliseconds: z11.number().optional(),
+        text: z11.string().optional(),
+        key: z11.string().optional(),
+        direction: z11.enum(["up", "down"]).optional(),
+        script: z11.string().optional(),
+        fullPage: z11.boolean().optional()
       })
     ).optional()
   },
-  mobile: z10.boolean().optional(),
-  skipTlsVerification: z10.boolean().optional(),
-  removeBase64Images: z10.boolean().optional(),
-  location: z10.object({
-    country: z10.string().optional(),
-    languages: z10.array(z10.string()).optional()
+  mobile: z11.boolean().optional(),
+  skipTlsVerification: z11.boolean().optional(),
+  removeBase64Images: z11.boolean().optional(),
+  location: z11.object({
+    country: z11.string().optional(),
+    languages: z11.array(z11.string()).optional()
   }).optional(),
-  storeInCache: z10.boolean().optional(),
-  zeroDataRetention: z10.boolean().optional(),
-  maxAge: z10.number().optional(),
-  lockdown: z10.boolean().optional(),
-  proxy: z10.enum(["basic", "stealth", "enhanced", "auto"]).optional(),
-  profile: z10.object({
-    name: z10.string(),
-    saveChanges: z10.boolean().optional()
+  storeInCache: z11.boolean().optional(),
+  zeroDataRetention: z11.boolean().optional(),
+  maxAge: z11.number().optional(),
+  lockdown: z11.boolean().optional(),
+  proxy: z11.enum(["basic", "stealth", "enhanced", "auto"]).optional(),
+  profile: z11.object({
+    name: z11.string(),
+    saveChanges: z11.boolean().optional()
   }).optional()
 });
+var readOnlyProfileSchema = z11.object({ name: z11.string() }).describe("Loads a saved browser profile without saving changes to it.");
+function withReadOnlyProfile(options) {
+  const profile = options.profile;
+  return SAFE_MODE && profile ? { ...options, profile: { name: profile.name, saveChanges: false } } : options;
+}
 var ALEXANDRIA_IGNORED_SCRAPE_OPTIONS = /* @__PURE__ */ new Set(["toolDetail", "domainTools"]);
 var scrapeToolParamsSchema = scrapeParamsSchema.extend({
-  url: z10.string().url().optional(),
-  timeout: z10.number().int().positive().optional().describe("Execution timeout in milliseconds."),
-  requestId: z10.string().regex(/^[A-Za-z0-9._:-]{1,128}$/).optional().describe(
+  ...SAFE_MODE ? { profile: readOnlyProfileSchema.optional() } : {},
+  url: z11.string().url().optional(),
+  timeout: z11.number().int().positive().optional().describe("Execution timeout in milliseconds."),
+  requestId: z11.string().regex(/^[A-Za-z0-9._:-]{1,128}$/).optional().describe(
     "Idempotency key bound to one Alexandria execution payload. Generated when omitted and returned with the result."
   ),
-  alexandria: z10.union([exchangeCallSchema, exchangeCallsSchema]).optional().describe(
+  alexandria: z11.union([exchangeCallSchema, exchangeCallsSchema]).optional().describe(
     "Catalogued Alexandria capability invocation, mutually exclusive with url. One {provider, capability, options} object or an array of 1-10, with contracts available through firecrawl_search or firecrawl_find_tools. Each call may include version to pin a published workflow; omitting it uses latest. Only requestId and timeout are supported alongside alexandria. " + ALEXANDRIA_CONTRACT_GUIDANCE + " Returns per-capability results in data.alexandria with data, records, or an error with a code; individual capabilities can fail even when the outer response succeeds. Requires an API key on a team with Alexandria enabled. Some providers require accepted terms; blocked requests return the applicable requirements."
   ),
-  toolDetail: z10.enum(["compact", "summary", "full"]).optional().describe("URL mode only: domain discovery detail, summary by default; compact returns provider/capability/description, full includes contracts. Ignored with alexandria."),
-  domainTools: z10.boolean().optional().describe(
+  toolDetail: z11.enum(["compact", "summary", "full"]).optional().describe("URL mode only: domain discovery detail, summary by default; compact returns provider/capability/description, full includes contracts. Ignored with alexandria."),
+  domainTools: z11.boolean().optional().describe(
     "URL mode only: include domain-matched Alexandria tools for the page in tools on the returned document. Ignored with alexandria."
   )
 }).refine(
@@ -5055,9 +5140,9 @@ var scrapeToolParamsSchema = scrapeParamsSchema.extend({
   (args2) => !args2.requestId || !!args2.alexandria,
   "requestId applies to Alexandria execution only"
 );
-var parseOptionParamsSchema = z10.object({
-  formats: z10.array(
-    z10.enum([
+var parseOptionParamsSchema = z11.object({
+  formats: z11.array(
+    z11.enum([
       "markdown",
       "html",
       "rawHtml",
@@ -5067,48 +5152,48 @@ var parseOptionParamsSchema = z10.object({
       "query"
     ])
   ).optional(),
-  jsonOptions: z10.object({
-    prompt: z10.string().optional(),
-    schema: z10.record(z10.string(), z10.any()).optional()
+  jsonOptions: z11.object({
+    prompt: z11.string().optional(),
+    schema: z11.record(z11.string(), z11.any()).optional()
   }).optional(),
-  queryOptions: z10.object({
-    prompt: z10.string().max(1e4),
-    mode: z10.enum(["directQuote", "freeform"]).default("freeform")
+  queryOptions: z11.object({
+    prompt: z11.string().max(1e4),
+    mode: z11.enum(["directQuote", "freeform"]).default("freeform")
   }).optional(),
-  parsers: z10.array(z10.enum(["pdf"])).optional(),
-  pdfOptions: z10.object({
-    maxPages: z10.number().int().min(1).max(1e4).optional()
+  parsers: z11.array(z11.enum(["pdf"])).optional(),
+  pdfOptions: z11.object({
+    maxPages: z11.number().int().min(1).max(1e4).optional()
   }).optional(),
-  onlyMainContent: z10.boolean().optional(),
-  redactPII: z10.boolean().optional(),
-  includeTags: z10.array(z10.string()).optional(),
-  excludeTags: z10.array(z10.string()).optional(),
-  removeBase64Images: z10.boolean().optional(),
-  skipTlsVerification: z10.boolean().optional(),
-  storeInCache: z10.boolean().optional(),
-  zeroDataRetention: z10.boolean().optional(),
-  maxAge: z10.number().optional().describe("Ignored: parse never reuses or stores indexed content."),
-  proxy: z10.enum(["basic", "auto"]).optional()
+  onlyMainContent: z11.boolean().optional(),
+  redactPII: z11.boolean().optional(),
+  includeTags: z11.array(z11.string()).optional(),
+  excludeTags: z11.array(z11.string()).optional(),
+  removeBase64Images: z11.boolean().optional(),
+  skipTlsVerification: z11.boolean().optional(),
+  storeInCache: z11.boolean().optional(),
+  zeroDataRetention: z11.boolean().optional(),
+  maxAge: z11.number().optional().describe("Ignored: parse never reuses or stores indexed content."),
+  proxy: z11.enum(["basic", "auto"]).optional()
 });
 var localParseParamsSchema = parseOptionParamsSchema.extend({
-  filePath: z10.string().min(1).describe(
+  filePath: z11.string().min(1).describe(
     "Absolute or relative path to a local file to parse. Supported: .html, .htm, .pdf, .docx, .doc, .odt, .rtf, .xlsx, .xls"
   ),
-  contentType: z10.string().optional().describe(
+  contentType: z11.string().optional().describe(
     "Optional MIME type override. If omitted, the server infers the file kind from the extension."
   )
 });
 var hostedParseParamsSchema = parseOptionParamsSchema.extend({
-  filePath: z10.string().min(1).optional().describe(
+  filePath: z11.string().min(1).optional().describe(
     "Phase 1 only: path to the local file on the caller/harness machine. Hosted MCP will not read or stat this path; it is used only to produce upload instructions."
   ),
-  uploadRef: z10.string().min(1).optional().describe(
+  uploadRef: z11.string().min(1).optional().describe(
     "Phase 2 only: short-lived upload reference returned by phase 1 after the local PUT upload completes."
   ),
-  contentType: z10.string().optional().describe(
+  contentType: z11.string().optional().describe(
     "Phase 1 MIME type override. If omitted, the server infers it from the file extension without reading the file."
   ),
-  declaredSizeBytes: z10.number().int().positive().optional().describe(
+  declaredSizeBytes: z11.number().int().positive().optional().describe(
     "Optional phase 1 size declaration. Hosted MCP does not stat the file; provide this only if the caller already knows it."
   )
 }).superRefine((value, ctx) => {
@@ -5116,7 +5201,7 @@ var hostedParseParamsSchema = parseOptionParamsSchema.extend({
   const hasUploadRef = typeof value.uploadRef === "string" && value.uploadRef.length > 0;
   if (hasFilePath === hasUploadRef) {
     ctx.addIssue({
-      code: z10.ZodIssueCode.custom,
+      code: z11.ZodIssueCode.custom,
       message: "Hosted firecrawl_parse requires exactly one of filePath (phase 1) or uploadRef (phase 2).",
       path: hasFilePath && hasUploadRef ? ["uploadRef"] : ["filePath"]
     });
@@ -5321,8 +5406,9 @@ var scrapeTool = {
   name: "firecrawl_scrape",
   annotations: {
     title: "Firecrawl scrape",
-    readOnlyHint: false,
-    // Alexandria capabilities can record provider agreement acceptance.
+    // Hosted scrape omits browser actions, loads profiles without saving,
+    // and refuses provider terms writes before execution.
+    readOnlyHint: SAFE_MODE,
     openWorldHint: true,
     // Accepts any user-supplied URL on the public web.
     destructiveHint: false
@@ -5331,7 +5417,7 @@ var scrapeTool = {
   description: `
 Scrape one URL and return its content: markdown by default, or HTML, links, screenshots, branding data, a targeted answer, or JSON matching a supplied schema. Use it when the request identifies a page and needs its content or defined fields. Use \`firecrawl_search\` when additional web sources are needed; on an authenticated session, \`firecrawl_map\` lists a site's URLs and \`firecrawl_crawl\` collects a set of pages.
 
-Firecrawl may serve recently indexed content; set \`maxAge: 0\` for a live fetch or a smaller \`maxAge\` to bound staleness. A successful response does not by itself confirm the page is still current. Browser actions can change the live page when interactive actions are enabled. Authenticated responses can include a \`metadata.scrapeId\` for optional scrape feedback.
+Firecrawl may serve recently indexed content; set \`maxAge: 0\` for a live fetch or a smaller \`maxAge\` to bound staleness. A successful response does not by itself confirm the page is still current. ${SAFE_MODE ? "A named browser profile loads saved session data without saving changes to it." : "Browser actions can change the live page when interactive actions are enabled."} Authenticated responses can include a \`metadata.scrapeId\` for optional scrape feedback.
 
 On an authenticated session with Alexandria access, \`firecrawl_search\` with \`sources\` unset and \`firecrawl_find_tools\` can discover providers for the same fields across several pages; a matching provider returns typed records in one call. Keyless sessions have no provider matches.
 
@@ -5349,6 +5435,9 @@ Alexandria mode, on an authenticated session with Alexandria access: \`alexandri
     } = args2;
     if (alexandria) {
       assertExchangeCredential(session);
+      if ((Array.isArray(alexandria) ? alexandria : [alexandria]).some(isTermsWrite)) {
+        throw termsWriteError();
+      }
       log.info("Executing Alexandria capabilities", {
         count: Array.isArray(alexandria) ? alexandria.length : 1
       });
@@ -5359,7 +5448,7 @@ Alexandria mode, on an authenticated session with Alexandria access: \`alexandri
     const transformed = transformScrapeParams(
       options
     );
-    const cleaned = removeEmptyTopLevel(transformed);
+    const cleaned = withReadOnlyProfile(removeEmptyTopLevel(transformed));
     if (cleaned.lockdown) {
       log.info("Scraping URL (lockdown)");
     } else {
@@ -5412,13 +5501,13 @@ Enumerate URLs indexed under one website through Firecrawl without fetching each
 Returns matching URLs rather than page bodies. Retrieve one page with \`firecrawl_scrape\`; collect content across multiple pages with \`firecrawl_crawl\`. Authenticated responses can include an \`id\` for optional map feedback.
 `,
   outputSchema: mapOutputSchema,
-  parameters: z10.object({
-    url: z10.string().url(),
-    search: z10.string().optional(),
-    sitemap: z10.enum(["include", "skip", "only"]).optional(),
-    includeSubdomains: z10.boolean().optional(),
-    limit: z10.number().optional(),
-    ignoreQueryParameters: z10.boolean().optional()
+  parameters: z11.object({
+    url: z11.string().url(),
+    search: z11.string().optional(),
+    sitemap: z11.enum(["include", "skip", "only"]).optional(),
+    includeSubdomains: z11.boolean().optional(),
+    limit: z11.number().optional(),
+    ignoreQueryParameters: z11.boolean().optional()
   }),
   execute: async (args2, { session, log, client: mcpClient }) => {
     const { url, ...options } = args2;
@@ -5454,12 +5543,12 @@ ${ALEXANDRIA_SEARCH_LEAD}
 
 On an authenticated session, tool matches describe available capabilities; \`firecrawl_find_tools\` returns their contracts and \`firecrawl_scrape\` with an \`alexandria\` body executes a selected capability. Keyless sessions get no Alexandria matches in data.tools.
 
-For a programming question, add \`categories: ["developer"]\`; its hits return in \`data.web\` with \`category: "developer"\`. \`categories: ["research"]\` restricts web results to research-affiliated websites; the \`firecrawl_research_*\` tools are a separate surface over paper abstracts and full text (PubMed, bioRxiv, medRxiv, arXiv). Query operators, domain filters, \`categories\`, \`toolDetail\` and \`scrapeOptions\` are described on their parameters. Returns source-type result groups and usage metadata. Authenticated responses can include an \`id\` for optional search feedback.
+For a programming question, add \`categories: ["developer"]\`; its hits return in \`data.web\` with \`category: "developer"\`. For a legal or regulatory question, \`categories: ["gov"]\` returns hits in \`data.web\` with \`category: "gov"\` and cannot be combined with other categories; authenticated sessions also have \`firecrawl_gov_search\` as the dedicated tool. \`categories: ["research"]\` restricts web results to research-affiliated websites; the \`firecrawl_research_*\` tools are a separate surface over paper abstracts and full text (PubMed, bioRxiv, medRxiv, arXiv). Query operators, domain filters, \`categories\`, \`toolDetail\` and \`scrapeOptions\` are described on their parameters. Returns source-type result groups and usage metadata. Authenticated responses can include an \`id\` for optional search feedback.
 `,
   outputSchema: searchOutputSchema,
-  parameters: z10.object({
+  parameters: z11.object({
     ...searchToolBaseFields,
-    scrapeOptions: scrapeParamsSchema.omit({ url: true }).partial().optional().describe("Attach page content for web results in the same call. These fetches ignore maxAge, so use firecrawl_scrape when you need a live fetch. scrapeOptions fetches web pages, never Alexandria provider tools.")
+    scrapeOptions: scrapeParamsSchema.omit({ url: true }).extend(SAFE_MODE ? { profile: readOnlyProfileSchema } : {}).partial().optional().describe("Attach page content for web results in the same call. These fetches ignore maxAge, so use firecrawl_scrape when you need a live fetch. scrapeOptions fetches web pages, never Alexandria provider tools.")
   }).refine(searchDomainsAreExclusive, SEARCH_DOMAINS_CONFLICT_MESSAGE).refine(
     searchQueryIsValid,
     "A query is required. Use Find Tools for catalogue lookup."
@@ -5475,8 +5564,8 @@ For a programming question, add \`categories: ["developer"]\`; its hits return i
     searchOpts.domainTools ??= defaultDomainTools(searchOpts.sources);
     searchOpts.toolDetail ??= "compact";
     if (searchOpts.scrapeOptions) {
-      searchOpts.scrapeOptions = transformScrapeParams(
-        searchOpts.scrapeOptions
+      searchOpts.scrapeOptions = withReadOnlyProfile(
+        transformScrapeParams(searchOpts.scrapeOptions)
       );
     }
     const cleaned = removeEmptyTopLevel(searchOpts);
@@ -5596,7 +5685,7 @@ var findToolsTool = {
 };
 server.addTool(findToolsTool);
 var SEARCH_SURFACE_SCRAPE_DESCRIPTION = `
-Scrape one URL and return its content, or execute catalogued Alexandria capabilities. URL mode returns markdown by default, or HTML, links, screenshots, branding data, a targeted answer, or JSON matching a supplied schema, plus page metadata. Firecrawl may serve recently indexed content; set \`maxAge: 0\` for a live fetch. A successful response does not by itself confirm the page is still current. Browser actions can change the live page when interactive actions are enabled, and a named browser profile can load saved session data and overwrite its stored state.
+Scrape one URL and return its content, or execute catalogued Alexandria capabilities. URL mode returns markdown by default, or HTML, links, screenshots, branding data, a targeted answer, or JSON matching a supplied schema, plus page metadata. Firecrawl may serve recently indexed content; set \`maxAge: 0\` for a live fetch. A successful response does not by itself confirm the page is still current. ${SAFE_MODE ? "A named browser profile loads saved session data without saving changes to it." : "Browser actions can change the live page, and a named browser profile can load saved session data and overwrite its stored state."}
 
 \`firecrawl_search\` with \`sources\` unset and \`firecrawl_find_tools\` can discover providers for the same fields across several pages; a matching Alexandria provider returns typed records in one call.
 
@@ -5777,17 +5866,17 @@ async function waitForCrawlCompletionWithOrigin(client, jobId, origin, pollInter
     );
   }
 }
-var feedbackIssueSchema = z10.string().trim().min(1).max(80).regex(
+var feedbackIssueSchema = z11.string().trim().min(1).max(80).regex(
   /^[a-z0-9][a-z0-9_-]*$/,
   "Issue codes must use lowercase letters, numbers, underscores, or hyphens"
 );
-var valuableSourceSchema = z10.object({
-  url: z10.string().url(),
-  reason: z10.string().max(1e3).optional()
+var valuableSourceSchema = z11.object({
+  url: z11.string().url(),
+  reason: z11.string().max(1e3).optional()
 });
-var missingContentSchema = z10.object({
-  topic: z10.string().min(1, "topic must not be empty").max(200, "topic must be 200 characters or fewer"),
-  description: z10.string().max(2e3).optional()
+var missingContentSchema = z11.object({
+  topic: z11.string().min(1, "topic must not be empty").max(200, "topic must be 200 characters or fewer"),
+  description: z11.string().max(2e3).optional()
 });
 var FEEDBACK_DISABLED_VALUES = /* @__PURE__ */ new Set(["1", "true", "yes", "on"]);
 function feedbackEnvEnabled(...keys) {
@@ -5826,24 +5915,24 @@ Records schema-validated quality feedback for a prior \`firecrawl_search\` UUID
 Eligibility is limited to successful searches within the feedback age window. The record is idempotent per search ID. Eligible first feedback for a search can refund 1 credit; refunds are subject to the team's daily cap. The response reports whether a refund was applied, along with submission and daily-cap status.
 `,
     outputSchema: feedbackOutputSchema,
-    parameters: z10.object({
-      searchId: z10.string().uuid("searchId must be the UUID returned by firecrawl_search"),
-      rating: z10.enum(["good", "bad", "partial"]),
-      valuableSources: z10.array(
-        z10.object({
-          url: z10.string().url(),
-          reason: z10.string().max(1e3).optional()
+    parameters: z11.object({
+      searchId: z11.string().uuid("searchId must be the UUID returned by firecrawl_search"),
+      rating: z11.enum(["good", "bad", "partial"]),
+      valuableSources: z11.array(
+        z11.object({
+          url: z11.string().url(),
+          reason: z11.string().max(1e3).optional()
         })
       ).max(50).optional(),
-      missingContent: z10.array(
-        z10.object({
-          topic: z10.string().min(1, "topic must not be empty").max(200, "topic must be 200 characters or fewer"),
-          description: z10.string().max(2e3).optional()
+      missingContent: z11.array(
+        z11.object({
+          topic: z11.string().min(1, "topic must not be empty").max(200, "topic must be 200 characters or fewer"),
+          description: z11.string().max(2e3).optional()
         })
       ).max(20).optional().describe(
         "Array of specific pieces of content the agent expected to find but did not. One entry per distinct topic. Each entry has a short `topic` and optional longer `description`."
       ),
-      querySuggestions: z10.string().max(2e3).optional()
+      querySuggestions: z11.string().max(2e3).optional()
     }),
     execute: async (args2, { session, log, client: mcpClient }) => {
       const origin = requestOrigin(mcpClient, session);
@@ -5945,20 +6034,20 @@ For an Alexandria session, set endpoint to \`alexandria\`, omit jobId, and provi
 Returns submission status, feedback ID, and accounting fields.
 `,
     outputSchema: feedbackOutputSchema,
-    parameters: z10.object({
-      endpoint: z10.enum(["search", "scrape", "parse", "map", "alexandria"]),
-      jobId: z10.string().uuid("jobId must be the UUID returned by Firecrawl").optional(),
+    parameters: z11.object({
+      endpoint: z11.enum(["search", "scrape", "parse", "map", "alexandria"]),
+      jobId: z11.string().uuid("jobId must be the UUID returned by Firecrawl").optional(),
       ...alexandriaFeedbackFields,
-      rating: z10.enum(["good", "bad", "partial"]),
-      issues: z10.array(feedbackIssueSchema).max(20).optional(),
-      tags: z10.array(feedbackIssueSchema).max(20).optional(),
-      note: z10.string().max(4e3).optional(),
-      valuableSources: z10.array(valuableSourceSchema).max(50).optional(),
-      missingContent: z10.array(missingContentSchema).max(50).optional(),
-      querySuggestions: z10.string().max(2e3).optional(),
-      url: z10.string().url().optional(),
-      pageNumbers: z10.array(z10.number().int().positive()).max(100).optional(),
-      metadata: z10.record(z10.string(), z10.unknown()).optional()
+      rating: z11.enum(["good", "bad", "partial"]),
+      issues: z11.array(feedbackIssueSchema).max(20).optional(),
+      tags: z11.array(feedbackIssueSchema).max(20).optional(),
+      note: z11.string().max(4e3).optional(),
+      valuableSources: z11.array(valuableSourceSchema).max(50).optional(),
+      missingContent: z11.array(missingContentSchema).max(50).optional(),
+      querySuggestions: z11.string().max(2e3).optional(),
+      url: z11.string().url().optional(),
+      pageNumbers: z11.array(z11.number().int().positive()).max(100).optional(),
+      metadata: z11.record(z11.string(), z11.unknown()).optional()
     }).superRefine((value, ctx) => {
       if (value.endpoint === "alexandria") {
         const parsed = alexandriaSessionFeedbackSchema.safeParse(value);
@@ -6070,25 +6159,25 @@ Start a multi-page crawl at a website URL, poll it to a terminal state, and retu
 
 Crawl results can be large; use conservative limits when full-site coverage is unnecessary. Webhooks and interactive scrape actions are unavailable in safe mode. Returns the crawl ID, status, and page data.
 `,
-  parameters: z10.object({
-    url: z10.string(),
-    prompt: z10.string().optional(),
-    excludePaths: z10.array(z10.string()).optional(),
-    includePaths: z10.array(z10.string()).optional(),
-    maxDiscoveryDepth: z10.number().optional(),
-    sitemap: z10.enum(["skip", "include", "only"]).optional(),
-    limit: z10.number().optional(),
-    allowExternalLinks: z10.boolean().optional(),
-    allowSubdomains: z10.boolean().optional(),
-    crawlEntireDomain: z10.boolean().optional(),
-    delay: z10.number().optional(),
-    maxConcurrency: z10.number().optional(),
+  parameters: z11.object({
+    url: z11.string(),
+    prompt: z11.string().optional(),
+    excludePaths: z11.array(z11.string()).optional(),
+    includePaths: z11.array(z11.string()).optional(),
+    maxDiscoveryDepth: z11.number().optional(),
+    sitemap: z11.enum(["skip", "include", "only"]).optional(),
+    limit: z11.number().optional(),
+    allowExternalLinks: z11.boolean().optional(),
+    allowSubdomains: z11.boolean().optional(),
+    crawlEntireDomain: z11.boolean().optional(),
+    delay: z11.number().optional(),
+    maxConcurrency: z11.number().optional(),
     ...SAFE_MODE ? {} : {
-      webhook: z10.string().optional(),
-      webhookHeaders: z10.record(z10.string(), z10.string()).optional()
+      webhook: z11.string().optional(),
+      webhookHeaders: z11.record(z11.string(), z11.string()).optional()
     },
-    deduplicateSimilarURLs: z10.boolean().optional(),
-    ignoreQueryParameters: z10.boolean().optional(),
+    deduplicateSimilarURLs: z11.boolean().optional(),
+    ignoreQueryParameters: z11.boolean().optional(),
     scrapeOptions: scrapeParamsSchema.omit({ url: true }).partial().optional()
   }),
   outputSchema: crawlOutputSchema,
@@ -6145,7 +6234,7 @@ server.addTool({
 Retrieve the current status, progress, and available results for an existing crawl ID. This only reads Firecrawl job state and does not start or modify the crawl.
 `,
   outputSchema: crawlOutputSchema,
-  parameters: z10.object({ id: z10.string() }),
+  parameters: z11.object({ id: z11.string() }),
   execute: async (args2, {
     session,
     client: mcpClient
@@ -6172,13 +6261,13 @@ server.addTool({
 Deprecated compatibility entry point. Use firecrawl_scrape once per known URL with formats: ["json"] and jsonOptions containing the prompt and schema. Use firecrawl_agent for multi-source research when the URLs are not known or the data spans several sites.
 `,
   outputSchema: deprecatedToolOutputSchema,
-  parameters: z10.object({
-    urls: z10.array(z10.string()),
-    prompt: z10.string().optional(),
-    schema: z10.record(z10.string(), z10.any()).optional(),
-    allowExternalLinks: z10.boolean().optional(),
-    enableWebSearch: z10.boolean().optional(),
-    includeSubdomains: z10.boolean().optional()
+  parameters: z11.object({
+    urls: z11.array(z11.string()),
+    prompt: z11.string().optional(),
+    schema: z11.record(z11.string(), z11.any()).optional(),
+    allowExternalLinks: z11.boolean().optional(),
+    enableWebSearch: z11.boolean().optional(),
+    includeSubdomains: z11.boolean().optional()
   }),
   canList: () => false,
   beforeValidate: () => {
@@ -6194,25 +6283,25 @@ Deprecated compatibility entry point. Use firecrawl_scrape once per known URL wi
     throw new UserError(payload.message, payload);
   }
 });
-var agentExchangeSchema = z10.strictObject({
-  enabled: z10.boolean().optional().describe("Let the agent call Alexandria providers. On by default."),
-  toolkits: z10.array(z10.string()).max(5).optional().describe("Pin up to 5 providers the agent may use, by slug. Omitted means the whole catalog."),
-  maxCalls: z10.number().int().min(1).max(30).optional().describe("Most provider calls the agent may make in this turn."),
-  requireApproval: z10.boolean().optional().describe(
+var agentExchangeSchema = z11.strictObject({
+  enabled: z11.boolean().optional().describe("Let the agent call Alexandria providers. On by default."),
+  toolkits: z11.array(z11.string()).max(5).optional().describe("Pin up to 5 providers the agent may use, by slug. Omitted means the whole catalog."),
+  maxCalls: z11.number().int().min(1).max(30).optional().describe("Most provider calls the agent may make in this turn."),
+  requireApproval: z11.boolean().optional().describe(
     'End the turn with a paid-call pendingApproval before any paid provider call. Requires mode "chat" on the same request, even on a follow-up.'
   ),
-  approve: z10.strictObject({
-    approvalId: z10.string().uuid(),
-    callIds: z10.array(z10.string()).optional(),
-    always: z10.boolean().optional()
+  approve: z11.strictObject({
+    approvalId: z11.string().uuid(),
+    callIds: z11.array(z11.string()).optional(),
+    always: z11.boolean().optional()
   }).optional().describe(
-    "Answer yes to the pendingApproval the previous turn of this thread ended on (its id, also exchange.requiresAction.approvalId). Needs threadId. For a terms offer, send it only after the user explicitly agreed and terms/accept succeeded; callIds and always are ignored on terms offers. For paid calls, callIds picks a subset (default all) and always stops asking for the rest of the thread."
+    "Answer yes to the pendingApproval the previous turn of this thread ended on (its id, also exchange.requiresAction.approvalId). Needs threadId. For a terms offer, send it only after an organization admin confirms acceptance in the Firecrawl dashboard; this does not accept terms. callIds and always are ignored on terms offers. For paid calls, callIds picks a subset (default all) and always stops asking for the rest of the thread."
   ),
-  decline: z10.strictObject({ approvalId: z10.string().uuid() }).optional().describe(
+  decline: z11.strictObject({ approvalId: z11.string().uuid() }).optional().describe(
     "Answer no to that pendingApproval. Needs threadId. A declined terms offer keeps those providers out of the rest of the thread."
   ),
-  onTermsRequired: z10.enum(["skip", "ask"]).optional().describe(
-    `What to do when a provider the agent would use needs data terms the team has not accepted. Gated providers are never called. "skip" (default): answer with accepted providers and list the rest in exchange.skippedProviders. "ask": the same, plus a terms pendingApproval and exchange.requiresAction with the terms/show and terms/accept calls. Each provider digest is string | null and always present; when null, terms/show returns it. There is no auto-accept. Omitted on a follow-up keeps the previous turn's value.`
+  onTermsRequired: z11.enum(["skip", "ask"]).optional().describe(
+    `What to do when a provider the agent would use needs data terms the team has not accepted. Gated providers are never called. "skip" (default): answer with accepted providers and list the rest in exchange.skippedProviders. "ask": the same, plus a terms pendingApproval and exchange.requiresAction. Read terms with terms/show; an organization admin accepts them in the Firecrawl dashboard. There is no auto-accept. Omitted on a follow-up keeps the previous turn's value.`
   )
 }).describe(
   "Alexandria provider settings for this turn, forwarded as the request's exchange object."
@@ -6235,24 +6324,24 @@ This call returns only a job ID, not the research result. Read the job with \`fi
 
 The job also returns a \`threadId\`. To continue that thread, pass it with a follow-up \`prompt\`; omitted \`mode\`, \`urls\`, \`schema\` and exchange settings carry over from the previous turn.
 
-The agent only calls Alexandria providers whose data terms the team has accepted. The status result's \`exchange.skippedProviders\` lists gated providers that would have helped. With \`exchange.onTermsRequired\` "ask", a terms offer ends the turn: \`pendingApproval\` (kind "terms") and \`exchange.requiresAction\` carry the \`approvalId\` and the exact terms/show and terms/accept calls. Show the user the terms, get their EXPLICIT consent, run terms/accept through \`firecrawl_scrape\`, then call \`firecrawl_agent\` with the same \`threadId\` and \`exchange.approve: {approvalId}\`. If they decline, send \`exchange.decline: {approvalId}\` instead. Never call terms/accept without that consent; a data request is not consent.
+The agent only calls Alexandria providers whose terms the team has accepted. \`exchange.skippedProviders\` lists gated providers. With \`exchange.onTermsRequired\` "ask", a terms \`pendingApproval\` and \`exchange.requiresAction\` carry the \`approvalId\` and provider requirements. Read terms/show through \`firecrawl_scrape\`. An organization admin must accept terms in the Firecrawl dashboard at the provider URL or ${DATA_SOURCES_SETTINGS_URL}. Ignore any terms/accept call in the API response. Only after the admin confirms acceptance, resume with the same \`threadId\` and \`exchange.approve: {approvalId}\`; this does not accept terms. To decline, use \`exchange.decline: {approvalId}\`. Never infer acceptance from a data request.
 `,
   outputSchema: agentOutputSchema,
-  parameters: z10.object({
-    prompt: z10.string().min(1).max(1e4),
-    urls: z10.array(z10.string().url()).optional(),
-    schema: z10.record(z10.string(), z10.any()).optional(),
-    effort: z10.enum(["low", "medium", "high"]).optional().describe("Reasoning budget for the agent task."),
-    maxCredits: z10.number().int().positive().optional().describe(
+  parameters: z11.object({
+    prompt: z11.string().min(1).max(1e4),
+    urls: z11.array(z11.string().url()).optional(),
+    schema: z11.record(z11.string(), z11.any()).optional(),
+    effort: z11.enum(["low", "medium", "high"]).optional().describe("Reasoning budget for the agent task."),
+    maxCredits: z11.number().int().positive().optional().describe(
       "Spending limit in credits for this run. Defaults to 2500 on the API."
     ),
-    strictConstrainToURLs: z10.boolean().optional().describe(
+    strictConstrainToURLs: z11.boolean().optional().describe(
       "If true, agent will only visit URLs provided in the urls array."
     ),
-    threadId: z10.string().uuid().optional().describe(
+    threadId: z11.string().uuid().optional().describe(
       "Continue this thread: the threadId from an earlier firecrawl_agent or firecrawl_agent_status result. Omit to start a new thread."
     ),
-    mode: z10.enum(["extract", "chat"]).optional().describe(
+    mode: z11.enum(["extract", "chat"]).optional().describe(
       `"extract" (default) returns the complete structured result every turn. "chat" lets a follow-up that asks no new data get a short reply in message instead of a re-run; required for exchange.requireApproval. Omitted on a follow-up keeps the previous turn's mode.`
     ),
     exchange: agentExchangeSchema.optional()
@@ -6322,7 +6411,7 @@ Retrieve progress or final results for a \`firecrawl_agent\` job ID. A \`process
 Returns job status, progress information, and result data when completed.
 `,
   outputSchema: agentStatusOutputSchema,
-  parameters: z10.object({ id: z10.string() }),
+  parameters: z11.object({ id: z11.string() }),
   execute: async (args2, { session, log, client: mcpClient }) => {
     const client = getClient(session);
     const { id } = args2;
@@ -6331,9 +6420,41 @@ Returns job status, progress information, and result data when completed.
       `/v2/agent/${encodeURIComponent(id)}`,
       originHeaders(requestOrigin(mcpClient, session))
     );
-    return structuredText(res?.data ?? {});
+    return agentStatusResult(res?.data ?? {});
   }
 });
+function agentStatusResult(data) {
+  const run = data;
+  if (!run || typeof run !== "object" || run.status !== "failed" || run.stopReason !== "credit_limit_reached") {
+    return structuredText(data);
+  }
+  const lines = [
+    "This agent run stopped at its credit limit (maxCredits) before finishing."
+  ];
+  const hasPartial = run.partial !== void 0 && run.partial !== null;
+  if (hasPartial) {
+    const validity = run.partialSchemaValid === true ? " It matches the schema this run was given." : run.partialSchemaValid === false ? " It does not match the schema this run was given." : "";
+    lines.push(
+      `\`partial\` is an INCOMPLETE best-effort result, not a finished answer; tell the user it is incomplete.${validity}`
+    );
+  } else {
+    lines.push("No partial result was recovered.");
+  }
+  if (typeof run.message === "string" && run.message.trim()) {
+    lines.push(`Agent message: ${run.message.trim()}`);
+  }
+  const threadId = typeof run.threadId === "string" ? run.threadId : void 0;
+  lines.push(
+    threadId ? `To continue, call firecrawl_agent with threadId "${threadId}" and a prompt to finish the task (the follow-up ${hasPartial ? "resumes from this partial" : "keeps this thread"}), or start a new run with a higher maxCredits.` : "To continue, start a new firecrawl_agent run with a higher maxCredits."
+  );
+  const notice = lines.join(" ");
+  return withStructured(
+    `${notice}
+
+${JSON.stringify(data, null, 2)}`,
+    { ...run, notice }
+  );
+}
 server.addTool({
   name: "firecrawl_interact",
   annotations: {
@@ -6351,13 +6472,13 @@ Open or reuse a live browser session to navigate a page, click controls, fill fi
 This acts on the live site, so actions such as form submission can create persistent external side effects. Returns execution output, stdout/stderr, exit status, and session viewing URLs.
 `,
   outputSchema: interactOutputSchema,
-  parameters: z10.object({
-    scrapeId: z10.string().trim().min(1).optional(),
-    url: z10.string().trim().url().optional(),
-    prompt: z10.string().trim().min(1).optional(),
-    code: z10.string().trim().min(1).optional(),
-    language: z10.enum(["bash", "python", "node"]).optional(),
-    timeout: z10.number().min(1).max(300).optional(),
+  parameters: z11.object({
+    scrapeId: z11.string().trim().min(1).optional(),
+    url: z11.string().trim().url().optional(),
+    prompt: z11.string().trim().min(1).optional(),
+    code: z11.string().trim().min(1).optional(),
+    language: z11.enum(["bash", "python", "node"]).optional(),
+    timeout: z11.number().min(1).max(300).optional(),
     scrapeOptions: scrapeParamsSchema.omit({ url: true }).partial().optional()
   }).refine((data) => Boolean(data.scrapeId) !== Boolean(data.url), {
     message: "Provide either 'url' (interact directly) or 'scrapeId' (reuse a previous scrape), not both."
@@ -6436,8 +6557,8 @@ server.addTool({
 Stop the live interact session associated with a \`scrapeId\` and release its resources. Returns a success confirmation.
 `,
   outputSchema: interactStopOutputSchema,
-  parameters: z10.object({
-    scrapeId: z10.string()
+  parameters: z11.object({
+    scrapeId: z11.string()
   }),
   execute: async (args2, { session, log, client: mcpClient }) => {
     const client = getClient(session);
@@ -6552,22 +6673,26 @@ function registerMarketplaceSearchTool(registrar, getClientFn) {
       destructiveHint: false
     },
     description: `
-Search web and specialized indexes, returning ranked results with query-relevant highlights. Each web result is a title, URL, and description. Operators include quoted phrases, \`-term\`, \`site:host\`, \`inurl:term\`, \`intitle:term\`, and \`related:host\`; the set is non-exhaustive. \`includeDomains\` and \`excludeDomains\` are mutually exclusive hostname filters; categories limit result types to \`research\`, \`pdf\`, or \`developer\`.
+Search web and specialized indexes, returning ranked results with query-relevant highlights. Each web result is a title, URL, and description. Operators include quoted phrases, \`-term\`, \`site:host\`, \`inurl:term\`, \`intitle:term\`, and \`related:host\`; the set is non-exhaustive. \`includeDomains\` and \`excludeDomains\` are mutually exclusive hostname filters; categories limit result types to \`research\`, \`pdf\`, \`developer\`, or \`gov\`.
 
 For a programming question, add \`categories: ["developer"]\`. It searches an index of public repositories, GitHub issues, merged pull requests, repository READMEs, and code documentation, and returns the results in \`data.web\` with \`category: "developer"\`.
 
+For a legal or regulatory question, \`categories: ["gov"]\` returns results in \`data.web\` with \`category: "gov"\` and cannot be combined with other categories; \`firecrawl_gov_search\` is the dedicated tool.
+
 ${ALEXANDRIA_SEARCH_INSTRUCTIONS}
 
 Returns result groups in \`data\` and an operation \`id\`.
 `,
     outputSchema: searchOutputSchema,
-    parameters: z10.object({ ...searchToolBaseFields }).strict().refine(searchDomainsAreExclusive, SEARCH_DOMAINS_CONFLICT_MESSAGE).refine(
+    parameters: z11.object({ ...searchToolBaseFields }).strict().refine(searchDomainsAreExclusive, SEARCH_DOMAINS_CONFLICT_MESSAGE).refine(
       searchQueryIsValid,
       "A query is required. Use firecrawl_find_tools to browse the catalogue."
     ),
     execute: async (args2, { session, log, client: mcpClient }) => {
       const {
         query,
+        objective,
+        clientModel,
         includeDomains,
         excludeDomains,
         limit,
@@ -6585,6 +6710,8 @@ Returns result groups in \`data\` and an operation \`id\`.
       const searchBody = {
         query: searchQuery,
         ...removeEmptyTopLevel({
+          objective,
+          clientModel,
           limit,
           includeDomains,
           excludeDomains,
@@ -6637,6 +6764,7 @@ if (process.env.CLOUD_SERVICE === "true" || process.env.SSE_LOCAL === "true" ||
 registerMonitorTools(server);
 registerResearchTools(server, getClient);
 registerDeveloperTools(server, getClient);
+registerGovTools(server, getClient);
 registerUsageTools(server, getClient);
 if (process.env.CLOUD_SERVICE === "true" && primaryProfile.allowKeyless && !normalizeHeader(process.env.KEYLESS_PROXY_SECRET)) {
   console.warn(
@@ -6671,6 +6799,7 @@ if (searchProfileEnabled) {
   };
   registerResearchTools(searchRegistrar, getClient);
   registerDeveloperTools(searchRegistrar, getClient);
+  registerGovTools(searchRegistrar, getClient);
   registerMarketplaceSearchTool(searchRegistrar, getClient);
   searchRegistrar.addTool(searchSurfaceFindToolsTool);
   searchRegistrar.addTool(searchSurfaceScrapeTool);