@lightsage/mcp 0.4.1 → 0.4.2

package/README.md

@@ -33,9 +33,9 @@ Lightsage Public API: Public API for Lightsage CLI and external integrations.
 <details>
 <summary>Claude Desktop</summary>
 
-Install the MCP server as a Desktop Extension using the pre-built [`mcp-server.mcpb`](https://github.com/lightsagehq/mcp/releases/download/v0.4.1/mcp-server.mcpb) file:
+Install the MCP server as a Desktop Extension using the pre-built [`mcp-server.mcpb`](https://github.com/lightsagehq/mcp/releases/download/v0.4.2/mcp-server.mcpb) file:
 
-Simply drag and drop the [`mcp-server.mcpb`](https://github.com/lightsagehq/mcp/releases/download/v0.4.1/mcp-server.mcpb) file onto Claude Desktop to install the extension.
+Simply drag and drop the [`mcp-server.mcpb`](https://github.com/lightsagehq/mcp/releases/download/v0.4.2/mcp-server.mcpb) file onto Claude Desktop to install the extension.
 
 The MCP bundle package includes the MCP server and all necessary configuration. Once installed, the server will be available without additional setup.
 

package/bin/mcp-server.js

@@ -52844,9 +52844,9 @@ var init_config = __esm(() => {
   SDK_METADATA = {
     language: "typescript",
     openapiDocVersion: "1.0.0",
-    sdkVersion: "0.4.1",
+    sdkVersion: "0.4.2",
     genVersion: "2.941.0",
-    userAgent: "speakeasy-sdk/mcp-typescript 0.4.1 2.941.0 1.0.0 @lightsage/mcp"
+    userAgent: "speakeasy-sdk/mcp-typescript 0.4.2 2.941.0 1.0.0 @lightsage/mcp"
   };
 });
 
@@ -54639,14 +54639,17 @@ Generates and saves a draft article using AI. Returns the new content record wit
 });
 
 // src/models/validationerror.ts
-var Loc$zodSchema, ValidationError$zodSchema;
+var Loc$zodSchema, Context$zodSchema, ValidationError$zodSchema;
 var init_validationerror = __esm(() => {
   init_zod();
   Loc$zodSchema = union([
     string2(),
     int()
   ]);
+  Context$zodSchema = object({});
   ValidationError$zodSchema = object({
+    ctx: lazy(() => Context$zodSchema).optional(),
+    input: any().optional(),
     loc: array(union([
       string2(),
       int()
@@ -58876,6 +58879,7 @@ var init_v2promptrunprompt = __esm(() => {
 var V2PromptRunSummaryTargetKind$zodSchema, V2PromptRunSummary$zodSchema;
 var init_v2promptrunsummary = __esm(() => {
   init_zod();
+  init_searchgroundingmode();
   init_v2promptrunplatform();
   init_v2promptrunprompt();
   V2PromptRunSummaryTargetKind$zodSchema = _enum([
@@ -58885,6 +58889,8 @@ var init_v2promptrunsummary = __esm(() => {
   V2PromptRunSummary$zodSchema = object({
     citation_count: int().default(0),
     created_at: string2().nullable().optional(),
+    grounding_qualification_reason: string2().nullable().optional(),
+    grounding_qualified: boolean2().nullable().optional().describe("Whether the run satisfied the requested web access mode. Null means the default mode was used or isolation could not be proven."),
     harness: string2().nullable().optional().describe("Coding-agent harness for agent runs; otherwise the answer platform identifier."),
     id: string2(),
     is_brand_mentioned: boolean2().nullable().optional(),
@@ -58894,8 +58900,11 @@ var init_v2promptrunsummary = __esm(() => {
     prompt_id: string2(),
     response_preview: string2().nullable().optional(),
     run_date: string2(),
+    search_grounding: SearchGroundingMode$zodSchema.nullable().optional().describe("Web access mode requested for this run. Null for runs recorded before web access was tracked."),
+    search_observed: boolean2().nullable().optional(),
     target_kind: V2PromptRunSummaryTargetKind$zodSchema.nullable().optional(),
-    tool_call_count: int().nullable().optional().describe("Coding-agent tool invocations, counting a call and its result once. Matches the length of `tool_calls` on the detail response; null for answer-engine runs.")
+    tool_call_count: int().nullable().optional().describe("Coding-agent tool invocations, counting a call and its result once. Matches the length of `tool_calls` on the detail response; null for answer-engine runs."),
+    web_retrieval_observed: boolean2().nullable().optional().describe("Whether the coding agent was observed searching or fetching from the web. Null when not measured, including answer-engine runs.")
   });
 });
 
@@ -59094,6 +59103,7 @@ var init_v2promptrunmention = __esm(() => {
 var V2PromptRunDetailTargetKind$zodSchema, V2PromptRunDetail$zodSchema;
 var init_v2promptrundetail = __esm(() => {
   init_zod();
+  init_searchgroundingmode();
   init_v2promptruncitation();
   init_v2promptrunmention();
   init_v2promptrunplatform();
@@ -59107,6 +59117,8 @@ var init_v2promptrundetail = __esm(() => {
     citations: array(V2PromptRunCitation$zodSchema).optional(),
     conversation_turns: array(record(string2(), any())).optional().describe("Sanitized interleaved text and tool-call trace captured for this run. It interleaves the agent's `text` turns with `tool_call` turns, so its length is not a tool-call count; use `tool_calls` or `tool_call_count`."),
     created_at: string2().nullable().optional(),
+    grounding_qualification_reason: string2().nullable().optional(),
+    grounding_qualified: boolean2().nullable().optional().describe("Whether the run satisfied the requested web access mode. Null means the default mode was used or isolation could not be proven."),
     harness: string2().nullable().optional().describe("Coding-agent harness for agent runs; otherwise the answer platform identifier."),
     id: string2(),
     is_brand_mentioned: boolean2().nullable().optional(),
@@ -59118,9 +59130,12 @@ var init_v2promptrundetail = __esm(() => {
     response: string2().nullable().optional(),
     response_preview: string2().nullable().optional(),
     run_date: string2(),
+    search_grounding: SearchGroundingMode$zodSchema.nullable().optional().describe("Web access mode requested for this run. Null for runs recorded before web access was tracked."),
+    search_observed: boolean2().nullable().optional(),
     target_kind: V2PromptRunDetailTargetKind$zodSchema.nullable().optional(),
     tool_call_count: int().nullable().optional().describe("Coding-agent tool invocations, counting a call and its result once. Matches the length of `tool_calls` on the detail response; null for answer-engine runs."),
-    tool_calls: array(record(string2(), any())).optional().describe("Sanitized coding-agent tool invocations captured for this run, one entry per invocation with its result merged in.")
+    tool_calls: array(record(string2(), any())).optional().describe("Sanitized coding-agent tool invocations captured for this run, one entry per invocation with its result merged in."),
+    web_retrieval_observed: boolean2().nullable().optional().describe("Whether the coding agent was observed searching or fetching from the web. Null when not measured, including answer-engine runs.")
   });
 });
 
@@ -59252,12 +59267,30 @@ Returns one stored prompt run, including mentions, citations, and any sanitized
   };
 });
 
+// src/models/v2promptrunsettingsinput.ts
+var V2PromptRunSettingsInputWebSearchInstruction$zodSchema, V2PromptRunSettingsInput$zodSchema;
+var init_v2promptrunsettingsinput = __esm(() => {
+  init_zod();
+  init_searchgroundingmode();
+  V2PromptRunSettingsInputWebSearchInstruction$zodSchema = _enum([
+    "omit",
+    "append",
+    "both"
+  ]);
+  V2PromptRunSettingsInput$zodSchema = object({
+    search_grounding: SearchGroundingMode$zodSchema.nullable().optional().describe("Web access for coding-agent runs of this prompt. `disabled` blocks web access in the agent sandbox, `enabled` requires the agent to retrieve from the web, and `default` leaves the choice to the agent. Answer engines are not affected. An eval-run target that sets `search_grounding` overrides this setting."),
+    web_search_instruction: V2PromptRunSettingsInputWebSearchInstruction$zodSchema.nullable().optional().describe('Whether coding-agent runs append "Use web search." to the prompt. `both` runs the prompt once without and once with the instruction. Ignored when `search_grounding` is `disabled`. Answer engines always receive the prompt as written.')
+  });
+});
+
 // src/models/createv2promptrequest.ts
 var CreateV2PromptRequest$zodSchema;
 var init_createv2promptrequest = __esm(() => {
   init_zod();
+  init_v2promptrunsettingsinput();
   CreateV2PromptRequest$zodSchema = object({
     platform_ids: array(string2()).optional().describe("Answer-platform IDs from the prompt configuration. Omit to attach none."),
+    run_settings: V2PromptRunSettingsInput$zodSchema.nullable().optional().describe("Run settings that apply to coding-agent runs of this prompt. Omitted fields keep their current or default values."),
     text: string2(),
     topic_id: string2().describe("Prompt topic ID from `GET /v2/prompts/topics`.")
   });
@@ -59552,25 +59585,43 @@ var init_publicprompttopic = __esm(() => {
   });
 });
 
-// src/models/publicprompt.ts
-var PublicPromptStatus$zodSchema, PublicPrompt$zodSchema;
-var init_publicprompt = __esm(() => {
+// src/models/v2promptrunsettings.ts
+var V2PromptRunSettingsWebSearchInstruction$zodSchema, V2PromptRunSettings$zodSchema;
+var init_v2promptrunsettings = __esm(() => {
+  init_zod();
+  init_searchgroundingmode();
+  V2PromptRunSettingsWebSearchInstruction$zodSchema = _enum([
+    "omit",
+    "append",
+    "both"
+  ]).describe('Whether coding-agent runs append "Use web search." to the prompt. `both` runs the prompt once without and once with the instruction. Ignored when `search_grounding` is `disabled`. Answer engines always receive the prompt as written.');
+  V2PromptRunSettings$zodSchema = object({
+    search_grounding: SearchGroundingMode$zodSchema.optional().describe("Requested web-retrieval behavior for an eval run."),
+    web_search_instruction: V2PromptRunSettingsWebSearchInstruction$zodSchema.default("omit").describe('Whether coding-agent runs append "Use web search." to the prompt. `both` runs the prompt once without and once with the instruction. Ignored when `search_grounding` is `disabled`. Answer engines always receive the prompt as written.')
+  });
+});
+
+// src/models/v2promptresponse.ts
+var V2PromptResponseStatus$zodSchema, V2PromptResponse$zodSchema;
+var init_v2promptresponse = __esm(() => {
   init_zod();
   init_publicpromptplatform();
   init_publicprompttag();
   init_publicprompttopic();
-  PublicPromptStatus$zodSchema = _enum([
+  init_v2promptrunsettings();
+  V2PromptResponseStatus$zodSchema = _enum([
     "active",
     "inactive",
     "archived"
   ]).describe("The prompt lifecycle status. Only `active` prompts run on schedule.");
-  PublicPrompt$zodSchema = object({
+  V2PromptResponse$zodSchema = object({
     created_at: string2().nullable().optional(),
     id: string2(),
     language_id: string2().nullable().optional(),
     platforms: array(PublicPromptPlatform$zodSchema).optional(),
     region_id: string2().nullable().optional(),
-    status: PublicPromptStatus$zodSchema.describe("The prompt lifecycle status. Only `active` prompts run on schedule."),
+    run_settings: V2PromptRunSettings$zodSchema.optional(),
+    status: V2PromptResponseStatus$zodSchema.describe("The prompt lifecycle status. Only `active` prompts run on schedule."),
     tags: array(PublicPromptTag$zodSchema).optional(),
     text: string2(),
     topic: PublicPromptTopic$zodSchema.nullable().optional(),
@@ -59579,14 +59630,14 @@ var init_publicprompt = __esm(() => {
   });
 });
 
-// src/models/listpromptsresponse.ts
-var ListPromptsResponse$zodSchema;
-var init_listpromptsresponse = __esm(() => {
+// src/models/v2listpromptsresponse.ts
+var V2ListPromptsResponse$zodSchema;
+var init_v2listpromptsresponse = __esm(() => {
   init_zod();
-  init_publicprompt();
-  ListPromptsResponse$zodSchema = object({
+  init_v2promptresponse();
+  V2ListPromptsResponse$zodSchema = object({
     count: int(),
-    data: array(PublicPrompt$zodSchema)
+    data: array(V2PromptResponse$zodSchema)
   });
 });
 
@@ -59595,7 +59646,7 @@ var V2PromptsListStatus$zodSchema, V2PromptsListRequest$zodSchema, V2PromptsList
 var init_v2promptslistop = __esm(() => {
   init_zod();
   init_httpvalidationerror();
-  init_listpromptsresponse();
+  init_v2listpromptsresponse();
   V2PromptsListStatus$zodSchema = _enum([
     "active",
     "inactive",
@@ -59607,7 +59658,7 @@ var init_v2promptslistop = __esm(() => {
     topic_id: string2().describe("Optional prompt topic ID.").optional()
   });
   V2PromptsListResponse$zodSchema = union([
-    ListPromptsResponse$zodSchema,
+    V2ListPromptsResponse$zodSchema,
     HTTPValidationError$zodSchema
   ]);
 });
@@ -59730,12 +59781,12 @@ var V2PromptsRetrieveRequest$zodSchema, V2PromptsRetrieveResponse$zodSchema;
 var init_v2promptsretrieveop = __esm(() => {
   init_zod();
   init_httpvalidationerror();
-  init_publicprompt();
+  init_v2promptresponse();
   V2PromptsRetrieveRequest$zodSchema = object({
     prompt_id: string2()
   });
   V2PromptsRetrieveResponse$zodSchema = union([
-    PublicPrompt$zodSchema,
+    V2PromptResponse$zodSchema,
     HTTPValidationError$zodSchema
   ]);
 });
@@ -59831,7 +59882,7 @@ var init_promptsV2PromptsRetrieve2 = __esm(() => {
     name: "prompts-v2-prompts-retrieve",
     description: `Retrieve Prompt
 
-Returns a prompt with its topic, platforms, tags, and lifecycle status.`,
+Returns a prompt with its topic, platforms, tags, lifecycle status, and coding-agent run settings.`,
     annotations: {
       title: "",
       destructiveHint: false,
@@ -59857,12 +59908,14 @@ Returns a prompt with its topic, platforms, tags, and lifecycle status.`,
 var UpdateV2PromptRequestStatus$zodSchema, UpdateV2PromptRequest$zodSchema;
 var init_updatev2promptrequest = __esm(() => {
   init_zod();
+  init_v2promptrunsettingsinput();
   UpdateV2PromptRequestStatus$zodSchema = _enum([
     "active",
     "inactive"
   ]);
   UpdateV2PromptRequest$zodSchema = object({
     platform_ids: array(string2()).nullable().optional().describe("Replacement list of answer-platform IDs."),
+    run_settings: V2PromptRunSettingsInput$zodSchema.nullable().optional().describe("Run settings that apply to coding-agent runs of this prompt. Omitted fields keep their current or default values."),
     status: UpdateV2PromptRequestStatus$zodSchema.optional(),
     text: string2().optional(),
     topic_id: string2().optional().describe("Prompt topic ID from `GET /v2/prompts/topics`.")
@@ -59874,14 +59927,14 @@ var V2PromptsUpdateRequest$zodSchema, V2PromptsUpdateResponse$zodSchema;
 var init_v2promptsupdateop = __esm(() => {
   init_zod();
   init_httpvalidationerror();
-  init_publicprompt();
   init_updatev2promptrequest();
+  init_v2promptresponse();
   V2PromptsUpdateRequest$zodSchema = object({
     body: UpdateV2PromptRequest$zodSchema,
     prompt_id: string2()
   });
   V2PromptsUpdateResponse$zodSchema = union([
-    PublicPrompt$zodSchema,
+    V2PromptResponse$zodSchema,
     HTTPValidationError$zodSchema
   ]);
 });
@@ -59978,7 +60031,7 @@ var init_promptsV2PromptsUpdate2 = __esm(() => {
     name: "prompts-v2-prompts-update",
     description: `Update Prompt
 
-Updates a prompt's text, topic, platforms, or lifecycle status. Omitted fields remain unchanged.`,
+Updates a prompt's text, topic, platforms, lifecycle status, or coding-agent run settings. Omitted fields remain unchanged.`,
     annotations: {
       title: "",
       destructiveHint: false,
@@ -63028,7 +63081,7 @@ function createMCPServer(deps) {
       sizes: ["any"]
     }],
     name: "LightsageMcp",
-    version: "0.4.1"
+    version: "0.4.2"
   });
   const getClient = deps.getSDK || (() => new LightsageMcpCore({
     security: deps.security,
@@ -63259,13 +63312,13 @@ Returns one stored prompt run, including mentions, citations, and any sanitized
       name: "prompts-v2-prompts-retrieve",
       description: `Retrieve Prompt
 
-Returns a prompt with its topic, platforms, tags, and lifecycle status.`
+Returns a prompt with its topic, platforms, tags, lifecycle status, and coding-agent run settings.`
     },
     {
       name: "prompts-v2-prompts-update",
       description: `Update Prompt
 
-Updates a prompt's text, topic, platforms, or lifecycle status. Omitted fields remain unchanged.`
+Updates a prompt's text, topic, platforms, lifecycle status, or coding-agent run settings. Omitted fields remain unchanged.`
     },
     {
       name: "prompts-v2-prompts-delete",
@@ -64403,7 +64456,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.1/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.2/mcp-server.mcpb" download="mcp-server.mcpb" class="action-button header-action" style="display: inline-flex; margin-bottom: 16px;">
             \uD83D\uDCE5 Download MCP Bundle
           </a>
         </div>
@@ -67281,7 +67334,7 @@ var routes = buildRouteMap({
 var app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.4.1"
+    currentVersion: "0.4.2"
   }
 });
 run(app, process3.argv.slice(2), buildContext(process3));
@@ -67289,5 +67342,5 @@ export {
   app
 };
 
-//# debugId=9D9BF9F9417C659E64756E2164756E21
+//# debugId=EB4BA033DF30A06964756E2164756E21
 //# sourceMappingURL=mcp-server.js.map