@lightsage/mcp 0.4.8 → 0.4.10

package/src/landing-page.ts

@@ -931,7 +931,7 @@ http_headers = { "lightsage-api-key-auth" = "YOUR_LIGHTSAGE_API_KEY_AUTH" }`;
         <h1>Instructions</h1>
         <p>One-click installation for Claude Desktop users</p>
         <div class="instruction-item">
-          <a href="https://github.com/lightsagehq/mcp/releases/download/v0.4.8/mcp-server.mcpb" download="mcp-server.mcpb" class="action-button header-action" style="display: inline-flex; margin-bottom: 16px;">
+          <a href="https://github.com/lightsagehq/mcp/releases/download/v0.4.10/mcp-server.mcpb" download="mcp-server.mcpb" class="action-button header-action" style="display: inline-flex; margin-bottom: 16px;">
             📥 Download MCP Bundle
           </a>
         </div>

package/src/lib/config.ts

@@ -66,7 +66,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.0.0",
-  sdkVersion: "0.4.8",
+  sdkVersion: "0.4.10",
   genVersion: "2.943.0",
-  userAgent: "speakeasy-sdk/mcp-typescript 0.4.8 2.943.0 1.0.0 @lightsage/mcp",
+  userAgent: "speakeasy-sdk/mcp-typescript 0.4.10 2.943.0 1.0.0 @lightsage/mcp",
 } as const;

package/src/mcp-server/mcp-server.ts

@@ -22,7 +22,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.4.8",
+    currentVersion: "0.4.10",
   },
 });
 

package/src/mcp-server/server.ts

@@ -103,7 +103,7 @@ export function createMCPServer(deps: {
       sizes: ["any"],
     }],
     name: "LightsageMcp",
-    version: "0.4.8",
+    version: "0.4.10",
   });
 
   const getClient = deps.getSDK || (() =>

package/src/mcp-server/tools/agentsList.ts

@@ -10,7 +10,7 @@ export const tool$agentsList: ToolDefinition = {
   name: "agents-list",
   description: `List Agents
 
-Returns all runnable harness-and-model combinations as single agent IDs for use in eval runs.`,
+Returns the harness-and-model combinations your plan can run, as single agent IDs for use in eval runs.`,
   annotations: {
     "title": "",
     "destructiveHint": false,

package/src/mcp-server/tools/visibilityCurrentRetrieve.ts

@@ -15,7 +15,7 @@ export const tool$visibilityCurrentRetrieve: ToolDefinition<typeof args> = {
   name: "visibility-current-retrieve",
   description: `Retrieve Current Visibility
 
-Returns 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\`.`,
+Returns recommendation score, visibility score, ranks, and date-range metadata for the configured primary company. Metrics are computed from active prompts only; when no data exists, values are \`null\`.`,
   annotations: {
     "title": "",
     "destructiveHint": false,

package/src/mcp-server/tools/visibilityPromptsRetrieve.ts

@@ -15,7 +15,7 @@ export const tool$visibilityPromptsRetrieve: ToolDefinition<typeof args> = {
   name: "visibility-prompts-retrieve",
   description: `Retrieve Prompt Visibility Report
 
-Returns per-topic and per-prompt visibility metrics including score, rank, share of voice, average position, and citation counts.`,
+Returns per-topic and per-prompt visibility metrics including recommendation score, rank, visibility score, average position, and citation counts.`,
   annotations: {
     "title": "",
     "destructiveHint": false,

package/src/models/publiccompetitorrow.ts

@@ -8,6 +8,8 @@ import { PublicCompany, PublicCompany$zodSchema } from "./publiccompany.js";
 
 export type PublicCompetitorRow = {
   company: PublicCompany;
+  recommendation_score?: number | null | undefined;
+  recommendation_score_rank?: number | null | undefined;
   visibility_score?: number | null | undefined;
   visibility_score_rank?: number | null | undefined;
   share_of_voice?: number | null | undefined;
@@ -25,12 +27,18 @@ export const PublicCompetitorRow$zodSchema: z.ZodType<PublicCompetitorRow> = z
       "Companies with an `average_position` of 0 rank last.",
     ),
     company: PublicCompany$zodSchema,
+    recommendation_score: z.number().nullable().optional().describe(
+      "Mean recommendation strength across successful prompt runs, from 0 to 1. Each run contributes the company's recommendation strength (0 to 1) when it is mentioned and 0 when it is not. Failed provider runs are excluded. Rows do not sum to 1.",
+    ),
+    recommendation_score_rank: z.int().nullable().optional(),
     share_of_voice: z.number().nullable().optional().describe(
-      "Fraction of successful prompt runs that mention the company, from 0 to 1; for example, 0.25 means one in four runs. Failed provider runs are excluded. A run can mention several companies, so rows do not sum to 1.",
+      "Deprecated: use `visibility_score`. Same value; this field will be removed in a future release.",
+    ),
+    share_of_voice_rank: z.int().nullable().optional().describe(
+      "Deprecated: use `visibility_score_rank`. Same value; this field will be removed in a future release.",
     ),
-    share_of_voice_rank: z.int().nullable().optional(),
     visibility_score: z.number().nullable().optional().describe(
-      "Mean recommendation strength across successful prompt runs, from 0 to 1. Each run contributes the company's recommendation strength (0 to 1) when it is mentioned and 0 when it is not. Failed provider runs are excluded. Rows do not sum to 1.",
+      "Fraction of successful prompt runs that mention the company, from 0 to 1; for example, 0.25 means one in four runs. Failed provider runs are excluded. A run can mention several companies, so rows do not sum to 1.",
     ),
     visibility_score_rank: z.int().nullable().optional(),
   });

package/src/models/publiccurrentvisibilityresponse.ts

@@ -8,6 +8,8 @@ import { PublicCompany, PublicCompany$zodSchema } from "./publiccompany.js";
 
 export type PublicCurrentVisibilityResponse = {
   company: PublicCompany;
+  recommendation_score?: number | null | undefined;
+  recommendation_score_rank?: number | null | undefined;
   visibility_score?: number | null | undefined;
   visibility_score_rank?: number | null | undefined;
   share_of_voice?: number | null | undefined;
@@ -35,13 +37,19 @@ export const PublicCurrentVisibilityResponse$zodSchema: z.ZodType<
   ),
   end_date: z.string(),
   has_data: z.boolean(),
+  recommendation_score: z.number().nullable().optional().describe(
+    "Mean recommendation strength across successful prompt runs, from 0 to 1. Each run contributes the company's recommendation strength (0 to 1) when it is mentioned and 0 when it is not. Failed provider runs are excluded.",
+  ),
+  recommendation_score_rank: z.int().nullable().optional(),
   share_of_voice: z.number().nullable().optional().describe(
-    "Fraction of successful prompt runs that mention the company, from 0 to 1; for example, 0.25 means one in four runs. Failed provider runs are excluded.",
+    "Deprecated: use `visibility_score`. Same value; this field will be removed in a future release.",
+  ),
+  share_of_voice_rank: z.int().nullable().optional().describe(
+    "Deprecated: use `visibility_score_rank`. Same value; this field will be removed in a future release.",
   ),
-  share_of_voice_rank: z.int().nullable().optional(),
   start_date: z.string(),
   visibility_score: z.number().nullable().optional().describe(
-    "Mean recommendation strength across successful prompt runs, from 0 to 1. Each run contributes the company's recommendation strength (0 to 1) when it is mentioned and 0 when it is not. Failed provider runs are excluded.",
+    "Fraction of successful prompt runs that mention the company, from 0 to 1; for example, 0.25 means one in four runs. Failed provider runs are excluded.",
   ),
   visibility_score_rank: z.int().nullable().optional(),
 });

package/src/models/publicpromptvisibilitymetrics.ts

@@ -6,8 +6,9 @@
 import * as z from "zod";
 
 export type PublicPromptVisibilityMetrics = {
+  recommendation_score?: number | null | undefined;
+  recommendation_score_rank?: number | null | undefined;
   visibility_score?: number | null | undefined;
-  visibility_score_rank?: number | null | undefined;
   share_of_voice?: number | null | undefined;
   average_position?: number | null | undefined;
   citation_count?: number | undefined;
@@ -21,14 +22,17 @@ export const PublicPromptVisibilityMetrics$zodSchema: z.ZodType<
     "Mean mention position in AI responses; 1 is first and lower is better. 0 when runs produced no mentions.",
   ),
   citation_count: z.int().default(0).describe("Owned-domain citations only."),
+  recommendation_score: z.number().nullable().optional().describe(
+    "Mean recommendation strength across successful prompt runs, from 0 to 1. Each run contributes the company's recommendation strength (0 to 1) when it is mentioned and 0 when it is not. Failed provider runs are excluded.",
+  ),
+  recommendation_score_rank: z.int().nullable().optional(),
   run_count: z.int().default(0).describe(
     "One per prompt, platform, and run date.",
   ),
   share_of_voice: z.number().nullable().optional().describe(
-    "Fraction of successful prompt runs that mention the company, from 0 to 1; for example, 0.25 means one in four runs. Failed provider runs are excluded.",
+    "Deprecated: use `visibility_score`. Same value; this field will be removed in a future release.",
   ),
   visibility_score: z.number().nullable().optional().describe(
-    "Mean recommendation strength across successful prompt runs, from 0 to 1. Each run contributes the company's recommendation strength (0 to 1) when it is mentioned and 0 when it is not. Failed provider runs are excluded.",
+    "Fraction of successful prompt runs that mention the company, from 0 to 1; for example, 0.25 means one in four runs. Failed provider runs are excluded.",
   ),
-  visibility_score_rank: z.int().nullable().optional(),
 });

package/src/models/publicvisibilitybyplatform.ts

@@ -15,7 +15,7 @@ import {
 
 export type PublicVisibilityByPlatform = {
   platforms?: Array<PublicPlatformRef> | undefined;
-  visibility_score?: { [k: string]: Array<PublicSeriesPoint> } | undefined;
+  recommendation_score?: { [k: string]: Array<PublicSeriesPoint> } | undefined;
   citations?: { [k: string]: Array<PublicSeriesPoint> } | undefined;
 };
 
@@ -25,6 +25,8 @@ export const PublicVisibilityByPlatform$zodSchema: z.ZodType<
   citations: z.record(z.string(), z.array(PublicSeriesPoint$zodSchema))
     .optional().describe("Owned-domain citation counts keyed by platform_id."),
   platforms: z.array(PublicPlatformRef$zodSchema).optional(),
-  visibility_score: z.record(z.string(), z.array(PublicSeriesPoint$zodSchema))
-    .optional().describe("Visibility score series keyed by `platform_id`."),
+  recommendation_score: z.record(
+    z.string(),
+    z.array(PublicSeriesPoint$zodSchema),
+  ).optional().describe("Recommendation score series keyed by `platform_id`."),
 });

package/src/models/publicvisibilitysnapshot.ts

@@ -6,6 +6,8 @@
 import * as z from "zod";
 
 export type PublicVisibilitySnapshot = {
+  recommendation_score?: number | null | undefined;
+  recommendation_score_rank?: number | null | undefined;
   visibility_score?: number | null | undefined;
   visibility_score_rank?: number | null | undefined;
   share_of_voice?: number | null | undefined;
@@ -22,15 +24,21 @@ export const PublicVisibilitySnapshot$zodSchema: z.ZodType<
     "Mean mention position in AI responses; 1 is first and lower is better.",
   ),
   average_position_rank: z.int().nullable().optional(),
+  recommendation_score: z.number().nullable().optional().describe(
+    "Mean recommendation strength across successful prompt runs, from 0 to 1. Each run contributes the company's recommendation strength (0 to 1) when it is mentioned and 0 when it is not. Failed provider runs are excluded.",
+  ),
+  recommendation_score_rank: z.int().nullable().optional(),
   share_of_voice: z.number().nullable().optional().describe(
-    "Fraction of successful prompt runs that mention the company, from 0 to 1; for example, 0.25 means one in four runs. Failed provider runs are excluded.",
+    "Deprecated: use `visibility_score`. Same value; this field will be removed in a future release.",
+  ),
+  share_of_voice_rank: z.int().nullable().optional().describe(
+    "Deprecated: use `visibility_score_rank`. Same value; this field will be removed in a future release.",
   ),
-  share_of_voice_rank: z.int().nullable().optional(),
   total_citations: z.int().default(0).describe(
     "Owned-domain citations across all platforms; 0, not `null`, with no prompt runs.",
   ),
   visibility_score: z.number().nullable().optional().describe(
-    "Mean recommendation strength across successful prompt runs, from 0 to 1. Each run contributes the company's recommendation strength (0 to 1) when it is mentioned and 0 when it is not. Failed provider runs are excluded.",
+    "Fraction of successful prompt runs that mention the company, from 0 to 1; for example, 0.25 means one in four runs. Failed provider runs are excluded.",
   ),
   visibility_score_rank: z.int().nullable().optional(),
 });

package/src/models/publicvisibilitytimeseries.ts

@@ -10,11 +10,11 @@ import {
 } from "./publicseriespoint.js";
 
 export type PublicVisibilityTimeseries = {
-  visibility_score?: Array<PublicSeriesPoint> | undefined;
+  recommendation_score?: Array<PublicSeriesPoint> | undefined;
 };
 
 export const PublicVisibilityTimeseries$zodSchema: z.ZodType<
   PublicVisibilityTimeseries
 > = z.object({
-  visibility_score: z.array(PublicSeriesPoint$zodSchema).optional(),
+  recommendation_score: z.array(PublicSeriesPoint$zodSchema).optional(),
 });

package/src/tool-names.ts

@@ -10,7 +10,7 @@ export const toolNames: Array<{ name: string; description: string }>= [
   },
   {
     "name": "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`."
+    "description": "Retrieve Current Visibility\n\nReturns recommendation score, visibility score, 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": "visibility-overview-retrieve",
@@ -22,7 +22,7 @@ export const toolNames: Array<{ name: string; description: string }>= [
   },
   {
     "name": "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."
+    "description": "Retrieve Prompt Visibility Report\n\nReturns per-topic and per-prompt visibility metrics including recommendation score, rank, visibility score, average position, and citation counts."
   },
   {
     "name": "prompts-list",
@@ -222,7 +222,7 @@ export const toolNames: Array<{ name: string; description: string }>= [
   },
   {
     "name": "agents-list",
-    "description": "List Agents\n\nReturns all runnable harness-and-model combinations as single agent IDs for use in eval runs."
+    "description": "List Agents\n\nReturns the harness-and-model combinations your plan can run, as single agent IDs for use in eval runs."
   },
   {
     "name": "repositories-list",