@lightsage/mcp 0.1.7 → 0.1.11

package/src/models/v2visibilitypromptsretrieveop.ts

@@ -0,0 +1,41 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 0e357da52429
+ */
+
+import * as z from "zod";
+import {
+  HTTPValidationError,
+  HTTPValidationError$zodSchema,
+} from "./httpvalidationerror.js";
+import {
+  PublicPromptVisibilityReportResponse,
+  PublicPromptVisibilityReportResponse$zodSchema,
+} from "./publicpromptvisibilityreportresponse.js";
+
+export type V2VisibilityPromptsRetrieveRequest = {
+  start_date?: string | undefined;
+  end_date?: string | undefined;
+};
+
+export const V2VisibilityPromptsRetrieveRequest$zodSchema: z.ZodType<
+  V2VisibilityPromptsRetrieveRequest
+> = z.object({
+  end_date: z.string().date().describe(
+    "Inclusive range end; defaults to today.",
+  ).optional(),
+  start_date: z.string().date().describe(
+    "Inclusive range start; defaults to 30 days before the end date.",
+  ).optional(),
+});
+
+export type V2VisibilityPromptsRetrieveResponse =
+  | PublicPromptVisibilityReportResponse
+  | HTTPValidationError;
+
+export const V2VisibilityPromptsRetrieveResponse$zodSchema: z.ZodType<
+  V2VisibilityPromptsRetrieveResponse
+> = z.union([
+  PublicPromptVisibilityReportResponse$zodSchema,
+  HTTPValidationError$zodSchema,
+]);

package/src/models/validationerror.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 5d038f3f7846
  */
 
 import * as z from "zod";

package/src/tool-names.ts

@@ -1,203 +1,211 @@
 // Auto-generated at build time
 export const toolNames: Array<{ name: string; description: string }>= [
   {
-    "name": "status-status-get",
-    "description": "Get Status"
+    "name": "status-v2-status-get",
+    "description": "Get Status\n\nChecks API liveness without authentication. Use `GET /v2/auth/status` to validate an API key."
   },
   {
-    "name": "status-auth-status-get",
-    "description": "Get Auth Status"
+    "name": "status-v2-auth-status-get",
+    "description": "Get Auth Status\n\nValidates the API key and returns its organization ID, API key ID, scopes, and authentication status."
   },
   {
-    "name": "prompts-prompts-list",
-    "description": "List Prompts"
+    "name": "visibility-v2-visibility-current-retrieve",
+    "description": "Retrieve Current Visibility\n\nReturns visibility score, share of voice, ranks, and date-range metadata for the configured primary company. Metrics are computed from active prompts only; when no data exists, values are `null`."
   },
   {
-    "name": "prompts-prompts-create",
-    "description": "Create Prompts"
+    "name": "visibility-v2-visibility-overview-retrieve",
+    "description": "Retrieve Visibility Overview\n\nReturns aggregate snapshot, daily trends, per-platform breakdowns, and competitor comparison. Calculated from active prompts only."
   },
   {
-    "name": "prompts-prompts-config-retrieve",
-    "description": "Retrieve Prompt Config"
+    "name": "visibility-v2-visibility-citations-list",
+    "description": "List Top Cited Urls\n\nReturns URL-level citation counts ranked from most to least cited. Results can be filtered by platform and to owned or external sources."
   },
   {
-    "name": "prompts-prompts-topics-create",
-    "description": "Create Topic"
+    "name": "visibility-v2-visibility-prompts-retrieve",
+    "description": "Retrieve Prompt Visibility Report\n\nReturns per-topic and per-prompt visibility metrics including score, rank, share of voice, average position, and citation counts."
   },
   {
-    "name": "prompts-prompts-topics-update",
-    "description": "Update Topic"
+    "name": "prompts-v2-prompts-list",
+    "description": "List Prompts\n\nReturns active and inactive prompts by default. Set `include_archived` to include archived prompts."
   },
   {
-    "name": "prompts-prompts-topics-delete",
-    "description": "Delete Topic"
+    "name": "prompts-v2-prompts-create",
+    "description": "Create Prompts\n\nCreates prompts in a batch. Each item is validated independently, so the response can contain both created prompts and individual errors."
   },
   {
-    "name": "prompts-prompts-retrieve",
-    "description": "Retrieve Prompt"
+    "name": "prompts-v2-prompt-topics-list",
+    "description": "List Topics\n\nReturns all prompt topics available to the organization."
   },
   {
-    "name": "prompts-prompts-update",
-    "description": "Update Prompt"
+    "name": "prompts-v2-prompt-topics-create",
+    "description": "Create Topic\n\nCreates a prompt topic and returns the saved topic."
   },
   {
-    "name": "prompts-prompts-delete",
-    "description": "Delete Prompt"
+    "name": "prompts-v2-prompt-topics-update",
+    "description": "Update Topic\n\nRenames a prompt topic and returns the updated topic."
   },
   {
-    "name": "opportunities-opportunities-list",
-    "description": "List Opportunities\n\nList prompt opportunities with execution prompts.\n\nReturns pre-computed opportunities from Lightsage's prompt visibility analysis.\nEach opportunity includes an `execution_prompt` with the context an AI agent\nneeds to address it. This endpoint reads existing analysis; it does not run\nprompts or generate new opportunities."
+    "name": "prompts-v2-prompt-topics-delete",
+    "description": "Delete Topic\n\nArchives a prompt topic. Set `archive_prompts` to archive remaining prompts; otherwise the request fails with `400` if prompts remain."
   },
   {
-    "name": "tasks-tasks-list",
-    "description": "List Tasks\n\nList the persisted daily tasks for the organization.\n\nReturns existing tasks filtered by workflow `status`, along with per-status\ncounts. Each task includes an `execution_prompt` with the context an AI\nagent needs to execute it. If `action_date` is omitted, the response spans\npersisted tasks across generation dates. This reads existing tasks; it does\nnot generate a new batch."
+    "name": "prompts-v2-prompt-runs-list",
+    "description": "List Prompt Runs\n\nReturns stored prompt runs without exposing raw runtime or provider configuration. Filterable by prompt, platform, and date range."
   },
   {
-    "name": "tasks-tasks-retrieve",
-    "description": "Retrieve Task\n\nRetrieve a single daily task and its execution prompt."
+    "name": "prompts-v2-prompt-runs-retrieve",
+    "description": "Retrieve Prompt Run\n\nReturns one stored prompt run, including its mentions and citations."
   },
   {
-    "name": "tasks-tasks-update",
-    "description": "Update Task\n\nUpdate the status and delegation of a single daily task.\n\nMove a task through its lifecycle (for example to `in_progress`,\n`done`, or `dismissed`), reprioritize it (`priority`), delegate it to a\nteammate (`assignee_user_id`), or change its `action_type`. Only the fields\nsent are changed; sending `null` clears an assignee or action type. Send at\nleast one field."
+    "name": "prompts-v2-prompts-retrieve",
+    "description": "Retrieve Prompt\n\nReturns a prompt with its topic, platforms, tags, and lifecycle status."
   },
   {
-    "name": "eval-runs-eval-runs-create",
-    "description": "Create Eval Run\n\nStart a durable eval run and return the parent job ID to poll.\n\nFor prompt evals, provide explicit `targets` to override the configured\nprompt targets, or omit `targets` to use the organization's configured\nscheduled prompt targets. For API Performance evals, explicit `targets` or\n`models` override the stored configuration; when omitted, Lightsage uses\nconfigured scheduled targets or legacy configured models. Custom eval runs\nuse `custom_eval_ids` when provided, otherwise the configured custom eval\nset for the organization.\n\nFor API Performance source types backed by a source (`rest_api`, `sdk`, or\n`cli`), provide `source_id` from `api-performance sources list`, or omit it\nwhen `operation_ids`, `eval_ids`, or the requested `source_type` identify a\nsingle source. `operation_ids` are Lightsage API Performance operation IDs,\nnot OpenAPI operationId strings.\n\nEvery run is queued through the durable job queue. The response `id` is the\n`eval_run_id` to pass to `GET /v1/eval-runs/{eval_run_id}`. When Lightsage can\ndetermine the runnable work, the response also includes `dispatch_id` and\ninitial queued progress for the child jobs."
+    "name": "prompts-v2-prompts-update",
+    "description": "Update Prompt\n\nUpdates a prompt's text, topic, platforms, or lifecycle status. Omitted fields remain unchanged."
   },
   {
-    "name": "eval-runs-eval-runs-retrieve",
-    "description": "Retrieve Eval Run\n\nRetrieve status and progress for a durable eval run.\n\nThe `eval_run_id` is the `id` returned by `POST /v1/eval-runs`. Progress is\ncomputed from the parent job, its dispatch, and child jobs."
+    "name": "prompts-v2-prompts-delete",
+    "description": "Delete Prompt\n\nArchives the prompt and excludes it from normal listings while preserving its historical run data."
   },
   {
-    "name": "content-content-generate-draft",
-    "description": "Generate Content Draft\n\nGenerate a draft marketing/blog article and save it as draft content.\n\nWrites the AI-generated article (markdown) to a new content record and\nreturns its id, title, body, slug, and status. Costs credits. Use the\nreturned id to finalize the draft or to open it for editing."
+    "name": "opportunities-v2-opportunities-list",
+    "description": "List Opportunities\n\nReturns ranked opportunities computed from stored prompt visibility results. Each includes an `execution_prompt` with context for an AI agent. Default window is 30 days."
   },
   {
-    "name": "content-content-generate-final",
-    "description": "Generate Content Final\n\nPolish an existing draft into final, publish-ready content.\n\nRewrites the referenced draft into a finalized article, updates its status\nto `final`, and returns the updated content. Costs credits."
+    "name": "opportunities-v2-opportunities-retrieve",
+    "description": "Retrieve Opportunity\n\nReturns one computed opportunity and its execution context for the selected date window."
   },
   {
-    "name": "content-content-get",
-    "description": "Get Content Endpoint\n\nRetrieve a content record (title, markdown body, slug, status)."
+    "name": "tasks-v2-tasks-list",
+    "description": "List Tasks\n\nReturns persisted daily tasks with execution instructions. Includes per-status counts not narrowed by the `status` filter."
   },
   {
-    "name": "visibility-visibility-current-retrieve",
-    "description": "Retrieve Current Visibility\n\nRetrieve current visibility metrics for the organization.\n\nReturns visibility score, share of voice, ranks, and date-range metadata for\nthe configured primary company. Values are calculated from currently active\nprompts. When the selected range has no prompt-run data, metric values are\n`null` and `has_data` is `false`."
+    "name": "tasks-v2-tasks-retrieve",
+    "description": "Retrieve Task\n\nReturns one persisted task and its execution prompt."
   },
   {
-    "name": "visibility-visibility-overview-retrieve",
-    "description": "Retrieve Visibility Overview\n\nRetrieve the visibility overview for the organization.\n\nMirrors the dashboard overview: a point-in-time `snapshot` (visibility score,\nshare of voice, average position, ranks, and total citations aggregated over\nthe range), a daily `timeseries` of visibility score, per-platform visibility\nand citation series in `by_platform`, and a `competitors` comparison. Values\nare calculated from currently active prompts. When the selected range has no\nprompt-run data, snapshot values are `null` and `has_data` is `false`."
+    "name": "tasks-v2-tasks-update",
+    "description": "Update Task\n\nUpdates a task's status, priority, assignee, or action type. Only sent fields are changed; omitted fields remain unchanged."
   },
   {
-    "name": "visibility-visibility-prompts-retrieve",
-    "description": "Retrieve Prompt Visibility Report\n\nRetrieve the prompt visibility report for the organization.\n\nMirrors the dashboard Prompts tab with an overall summary, topic rows, and\nnested active prompt rows. Each row includes visibility score, visibility\nrank, share of voice, average position, owned-domain citations, and prompt\nruns for the selected date range. Active prompts without runs remain in the\nresponse with `null` visibility metrics and zero counts."
+    "name": "content-v2-content-drafts-create",
+    "description": "Create Content Draft\n\nGenerates and saves a draft article using AI. Returns the new content record with its ID, title, markdown body, slug, and status. Consumes credits."
   },
   {
-    "name": "API-performance-api-performance-targets-list",
-    "description": "List Targets"
+    "name": "content-v2-content-finalize",
+    "description": "Finalize Content\n\nRewrites an existing draft into final, publish-ready content and updates its status. Consumes credits."
   },
   {
-    "name": "API-performance-api-performance-runs-list",
-    "description": "List Eval Runs"
+    "name": "content-v2-content-retrieve",
+    "description": "Retrieve Content\n\nReturns a content record by ID, including title, markdown body, slug, and status."
   },
   {
-    "name": "API-performance-api-performance-runs-retrieve",
-    "description": "Retrieve Eval Run"
+    "name": "site-audits-v2-site-audits-list",
+    "description": "List Site Audits\n\nReturns every audited page and its actionable issues. Each page includes its score, priority, issue descriptions, evidence, and recommended fixes. This reads existing data and does not start a crawl."
   },
   {
-    "name": "API-performance-api-performance-diagnose",
-    "description": "Diagnose Eval Runs"
+    "name": "site-audits-v2-site-audits-retrieve",
+    "description": "Retrieve Site Audit\n\nReturns one audited page with its score, priority, supporting evidence, and recommended fixes."
   },
   {
-    "name": "API-performance-api-performance-config-retrieve",
-    "description": "Retrieve Eval Config"
+    "name": "evals-v2-evals-list",
+    "description": "List Evals\n\nReturns all active evals including workflow, MCP, CLI, and skill evals owned by the organization."
   },
   {
-    "name": "API-performance-api-performance-config-update",
-    "description": "Update Eval Config"
+    "name": "evals-v2-evals-create",
+    "description": "Create Eval\n\nCreates an eval with a task prompt, subject, and judge. The eval can then be run through eval runs."
   },
   {
-    "name": "API-performance-api-performance-sources-list",
-    "description": "List Sources"
+    "name": "evals-v2-evals-retrieve",
+    "description": "Retrieve Eval\n\nReturns one eval and its judge configuration."
   },
   {
-    "name": "API-performance-api-performance-skills-list",
-    "description": "List Skills"
+    "name": "evals-v2-evals-update",
+    "description": "Update Eval\n\nUpdates an eval's task prompt, subject, judge, or name. Omitted fields remain unchanged."
   },
   {
-    "name": "API-performance-api-performance-evals-list",
-    "description": "List Eval Definitions"
+    "name": "evals-v2-evals-delete",
+    "description": "Delete Eval\n\nPermanently deletes an eval and all of its saved configurations."
   },
   {
-    "name": "API-performance-api-performance-evals-retrieve",
-    "description": "Retrieve Eval Definition"
+    "name": "evals-v2-eval-configurations-list",
+    "description": "List Configurations\n\nReturns the saved runtime configurations for an eval, including repository, environment, and tool selections."
   },
   {
-    "name": "API-performance-api-performance-evals-update",
-    "description": "Update Eval Definition"
+    "name": "evals-v2-eval-configurations-create",
+    "description": "Create Configuration\n\nCreates a saved runtime configuration that pairs an eval with a repository, environment, and selected tools."
   },
   {
-    "name": "API-performance-api-performance-custom-evals-list",
-    "description": "List Custom Evals"
+    "name": "evals-v2-eval-configurations-retrieve",
+    "description": "Retrieve Configuration\n\nReturns one saved configuration for an eval."
   },
   {
-    "name": "API-performance-api-performance-custom-evals-create",
-    "description": "Create Custom Eval"
+    "name": "evals-v2-eval-configurations-update",
+    "description": "Update Configuration\n\nUpdates an eval configuration; omitted fields remain unchanged."
   },
   {
-    "name": "API-performance-api-performance-custom-evals-173",
-    "description": "List Custom Eval History\n\nList custom eval history rows for the organization.\n\nUse `custom_eval_id` to retrieve the evaluated run history for one custom\neval prompt. The public API hides infrastructure-error rows, matching the\nnon-admin dashboard behavior."
+    "name": "evals-v2-eval-configurations-delete",
+    "description": "Delete Configuration\n\nPermanently deletes an eval configuration and returns its last saved state."
   },
   {
-    "name": "API-performance-api-performance-custom-evals-e24",
-    "description": "Retrieve Custom Eval"
+    "name": "eval-runs-v2-eval-runs-list",
+    "description": "List Runs\n\nReturns jobs created through `POST /v2/eval-runs`, ordered newest first, with lifecycle state and progress."
   },
   {
-    "name": "API-performance-api-performance-custom-evals-update",
-    "description": "Update Custom Eval"
+    "name": "eval-runs-v2-eval-runs-create",
+    "description": "Create Run\n\nQueues a new eval job for one configuration and agent, and returns immediately with a polling ID."
   },
   {
-    "name": "API-performance-api-performance-custom-evals-delete",
-    "description": "Delete Custom Eval"
+    "name": "eval-runs-v2-eval-runs-retrieve",
+    "description": "Retrieve Run\n\nReturns the status and progress of an eval job. Poll until the status reaches a terminal value."
   },
   {
-    "name": "API-performance-api-performance-starter-projects-632",
-    "description": "List Starter Projects"
+    "name": "eval-results-v2-eval-results-list",
+    "description": "List Results\n\nReturns completed custom-eval results from onboarding, v1, and v2 run flows, ordered newest first. Result IDs are different from eval run IDs."
   },
   {
-    "name": "API-performance-api-performance-starter-projects-20c",
-    "description": "Create Starter Project"
+    "name": "eval-results-v2-eval-results-retrieve",
+    "description": "Retrieve Result\n\nReturns one completed custom-eval result with its output and diagnostic details."
   },
   {
-    "name": "API-performance-api-performance-starter-projects-372",
-    "description": "Retrieve Starter Project"
+    "name": "agents-v2-agents-list",
+    "description": "List Agents\n\nReturns all runnable harness-and-model combinations as single agent IDs for use in eval runs."
   },
   {
-    "name": "API-performance-api-performance-starter-projects-5ca",
-    "description": "Update Starter Project"
+    "name": "repositories-v2-repositories-list",
+    "description": "List Repositories\n\nReturns Git repositories available as reusable workspaces for eval configurations."
   },
   {
-    "name": "API-performance-api-performance-starter-projects-1c8",
-    "description": "Delete Starter Project"
+    "name": "repositories-v2-repositories-create",
+    "description": "Create Repository\n\nAdds a reusable Git repository workspace for eval configurations."
   },
   {
-    "name": "API-performance-api-performance-actions-list",
-    "description": "List Actions"
+    "name": "repositories-v2-repositories-retrieve",
+    "description": "Retrieve Repository\n\nReturns one reusable repository workspace."
   },
   {
-    "name": "API-performance-api-performance-actions-refresh",
-    "description": "Refresh Actions"
+    "name": "repositories-v2-repositories-update",
+    "description": "Update Repository\n\nUpdates a repository workspace; omitted fields remain unchanged."
   },
   {
-    "name": "API-performance-api-performance-actions-retrieve",
-    "description": "Retrieve Action"
+    "name": "repositories-v2-repositories-delete",
+    "description": "Delete Repository\n\nPermanently deletes a repository workspace and returns its last saved state."
   },
   {
-    "name": "API-performance-api-performance-actions-update",
-    "description": "Update Action"
+    "name": "environments-v2-environments-list",
+    "description": "List Environments\n\nReturns reusable environments without exposing secret values."
   },
   {
-    "name": "API-performance-api-performance-actions-verify",
-    "description": "Verify Action"
+    "name": "MCP-servers-v2-mcp-servers-list",
+    "description": "List Mcp Servers\n\nReturns reusable MCP servers without exposing credentials or secret values."
+  },
+  {
+    "name": "CL-is-v2-clis-list",
+    "description": "List Clis\n\nReturns reusable CLIs without exposing setup or installation commands."
+  },
+  {
+    "name": "skills-v2-skills-list",
+    "description": "List Skills\n\nReturns reusable skills available to workflows and eval configurations."
   }
 ];

package/src/types/async.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: fac8da972f86
  */
 
 export type APICall =

package/src/types/bigint.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 3ca6e3280e43
  */
 
 import * as z from "zod/v4";

package/src/types/blobs.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: f8ab9b326c86
  */
 
 export function isBlobLike(val: unknown): val is Blob {

package/src/types/enums.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 4d03ddfe5100
  */
 
 declare const __brand: unique symbol;

package/src/types/fp.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: ae9f0fb8aab6
  */
 
 /**

package/src/types/rfcdate.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 9eb64906dcd6
  */
 
 const dateRE = /^\d{4}-\d{2}-\d{2}$/;

package/src/types/streams.ts

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: f99be9c4bf14
  */
 
 export function isReadableStream<T = Uint8Array>(

package/test/site-audit.test.js

@@ -0,0 +1,160 @@
+import assert from "node:assert/strict";
+import http from "node:http";
+import test from "node:test";
+
+const { LightsageMcpCore } = await import("../esm/core.js");
+const { createConsoleLogger } = await import(
+  "../esm/mcp-server/console-logger.js"
+);
+const { createMCPServer } = await import("../esm/mcp-server/server.js");
+const { tool$siteAuditsV2SiteAuditsRetrieve } = await import(
+  "../esm/mcp-server/tools/siteAuditsV2SiteAuditsRetrieve.js"
+);
+const { tool$siteAuditsV2SiteAuditsList } = await import(
+  "../esm/mcp-server/tools/siteAuditsV2SiteAuditsList.js"
+);
+
+const siteId = "3f93c9d4-0478-53f3-812f-3e5de85a8bc7";
+const page = {
+  site_id: siteId,
+  url: "https://example.com/docs",
+  title: "Developer documentation",
+  score: 84,
+  grade: "B",
+  status: "warning",
+  priority: "medium",
+  issue_count: 1,
+  issues: [
+    {
+      id: "markdown-support",
+      category: "access",
+      severity: "warning",
+      message: "No agent-readable Markdown response was found.",
+      recommendation: "Serve Markdown when the client requests it.",
+      evidence: "Content-Type was text/html.",
+    },
+  ],
+};
+const websiteAudit = {
+  audit: {
+    url: "https://example.com",
+    status: "completed",
+    score: 88,
+    grade: "B",
+    generated_at: "2026-08-21T08:30:00Z",
+    total_pages: 1,
+    pages_with_issues: 1,
+    failed_pages: 0,
+  },
+  pages: [page],
+};
+
+function createAuditServer(requests) {
+  return http.createServer((req, res) => {
+    requests.push({
+      method: req.method,
+      url: req.url,
+      apiKey: req.headers["x-lightsage-api-key"],
+    });
+    res.setHeader("content-type", "application/json");
+
+    if (req.url === "/v2/site-audits") {
+      res.end(JSON.stringify(websiteAudit));
+      return;
+    }
+    if (req.url === `/v2/site-audits/${siteId}`) {
+      res.end(JSON.stringify(page));
+      return;
+    }
+
+    res.statusCode = 404;
+    res.end(JSON.stringify({ detail: "Site audit result not found" }));
+  });
+}
+
+function parseTextResult(result) {
+  assert.equal(result.content.length, 1);
+  assert.equal(result.content[0].type, "text");
+  return JSON.parse(result.content[0].text);
+}
+
+test("Site Audit tools are registered as focused read-only tools", () => {
+  const { tools } = createMCPServer({
+    logger: createConsoleLogger("error"),
+    dynamic: true,
+  });
+  const siteAuditTools = tools.filter(({ name }) => name.startsWith("site-audits-"));
+
+  assert.deepEqual(siteAuditTools.map(({ name }) => name), [
+    "site-audits-v2-site-audits-list",
+    "site-audits-v2-site-audits-retrieve",
+  ]);
+  assert.match(siteAuditTools[0].description, /actionable issues/);
+  assert.match(siteAuditTools[1].description, /recommended fixes/);
+});
+
+test("Site Audit tools request the list and page endpoints with API-key auth", async () => {
+  const requests = [];
+  const server = createAuditServer(requests);
+  await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
+  const address = server.address();
+  const client = new LightsageMcpCore({
+    serverURL: `http://127.0.0.1:${address.port}`,
+    security: { LightsageApiKeyAuth: "ls_site_audit_test" },
+  });
+  const ctx = { signal: new AbortController().signal };
+
+  try {
+    const listResult = await tool$siteAuditsV2SiteAuditsList.tool(client, ctx);
+    assert.equal(listResult.isError, undefined);
+    assert.deepEqual(parseTextResult(listResult), websiteAudit);
+
+    const detailResult = await tool$siteAuditsV2SiteAuditsRetrieve.tool(
+      client,
+      { request: { site_id: siteId } },
+      ctx,
+    );
+    assert.equal(detailResult.isError, undefined);
+    assert.deepEqual(parseTextResult(detailResult), page);
+
+    assert.deepEqual(requests, [
+      {
+        method: "GET",
+        url: "/v2/site-audits",
+        apiKey: "ls_site_audit_test",
+      },
+      {
+        method: "GET",
+        url: `/v2/site-audits/${siteId}`,
+        apiKey: "ls_site_audit_test",
+      },
+    ]);
+  } finally {
+    server.close();
+  }
+});
+
+test("Site Audit page lookup returns API errors to the MCP caller", async () => {
+  const server = createAuditServer([]);
+  await new Promise((resolve) => server.listen(0, "127.0.0.1", resolve));
+  const address = server.address();
+  const client = new LightsageMcpCore({
+    serverURL: `http://127.0.0.1:${address.port}`,
+    security: { LightsageApiKeyAuth: "ls_site_audit_test" },
+  });
+
+  try {
+    const result = await tool$siteAuditsV2SiteAuditsRetrieve.tool(
+      client,
+      { request: { site_id: "missing-site" } },
+      { signal: new AbortController().signal },
+    );
+
+    assert.equal(result.isError, true);
+    assert.deepEqual(parseTextResult(result), {
+      detail: "Site audit result not found",
+    });
+  } finally {
+    server.close();
+  }
+});

package/esm/funcs/apiPerformanceAPIPerformanceActionsList.d.ts

@@ -1,13 +0,0 @@
-import { LightsageMcpCore } from "../core.js";
-import { RequestOptions } from "../lib/sdks.js";
-import { ApiPerformanceActionsListRequest } from "../models/apiperformanceactionslistop.js";
-import { APIError } from "../models/errors/apierror.js";
-import { ConnectionError, InvalidRequestError, RequestAbortedError, RequestTimeoutError, UnexpectedClientError } from "../models/errors/httpclienterrors.js";
-import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
-import { APIPromise } from "../types/async.js";
-import { Result } from "../types/fp.js";
-/**
- * List Actions
- */
-export declare function apiPerformanceAPIPerformanceActionsList(client$: LightsageMcpCore, request?: ApiPerformanceActionsListRequest | undefined, options?: RequestOptions): APIPromise<Result<Response, APIError | SDKValidationError | UnexpectedClientError | InvalidRequestError | RequestAbortedError | RequestTimeoutError | ConnectionError>>;
-//# sourceMappingURL=apiPerformanceAPIPerformanceActionsList.d.ts.map

package/esm/funcs/apiPerformanceAPIPerformanceActionsList.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"apiPerformanceAPIPerformanceActionsList.d.ts","sourceRoot":"","sources":["../../src/funcs/apiPerformanceAPIPerformanceActionsList.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAI9C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EACL,gCAAgC,EAEjC,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAW,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC;;GAEG;AACH,wBAAgB,uCAAuC,CACrD,OAAO,EAAE,gBAAgB,EACzB,OAAO,CAAC,EAAE,gCAAgC,GAAG,SAAS,EACtD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CACX,MAAM,CACJ,QAAQ,EACN,QAAQ,GACR,kBAAkB,GAClB,qBAAqB,GACrB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,eAAe,CAClB,CACF,CAMA"}