@lightsage/mcp 0.4.18 → 0.4.19

package/src/models/v2prompttargetinput.ts

@@ -0,0 +1,72 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 69ccb1989872
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+export const AnswerEngine = {
+  Chatgpt: "chatgpt",
+  GoogleAiOverviews: "google-ai-overviews",
+  GoogleAiMode: "google-ai-mode",
+  GeminiSearch: "gemini-search",
+  Perplexity: "perplexity",
+  Claude: "claude",
+  MicrosoftCopilot: "microsoft-copilot",
+} as const;
+export type AnswerEngine = ClosedEnum<typeof AnswerEngine>;
+
+export const AnswerEngine$zodSchema = z.enum([
+  "chatgpt",
+  "google-ai-overviews",
+  "google-ai-mode",
+  "gemini-search",
+  "perplexity",
+  "claude",
+  "microsoft-copilot",
+]);
+
+/**
+ * How often this target runs on schedule. `manual` keeps it for runs you start yourself. Frequencies other than `daily` require custom prompt scheduling on the organization.
+ */
+export const V2PromptTargetInputFrequency = {
+  Daily: "daily",
+  EveryOtherDay: "every_other_day",
+  Weekly: "weekly",
+  Manual: "manual",
+} as const;
+/**
+ * How often this target runs on schedule. `manual` keeps it for runs you start yourself. Frequencies other than `daily` require custom prompt scheduling on the organization.
+ */
+export type V2PromptTargetInputFrequency = ClosedEnum<
+  typeof V2PromptTargetInputFrequency
+>;
+
+export const V2PromptTargetInputFrequency$zodSchema = z.enum([
+  "daily",
+  "every_other_day",
+  "weekly",
+  "manual",
+]).describe(
+  "How often this target runs on schedule. `manual` keeps it for runs you start yourself. Frequencies other than `daily` require custom prompt scheduling on the organization.",
+);
+
+export type V2PromptTargetInput = {
+  answer_engine?: AnswerEngine | null | undefined;
+  agent?: string | null | undefined;
+  frequency?: V2PromptTargetInputFrequency | undefined;
+};
+
+export const V2PromptTargetInput$zodSchema: z.ZodType<V2PromptTargetInput> = z
+  .object({
+    agent: z.string().nullable().optional().describe(
+      "Runnable agent from `GET /v2/agents`, a coding-agent harness and model such as `claude-code:claude-opus-5-5`. Set this or `answer_engine`, not both.",
+    ),
+    answer_engine: AnswerEngine$zodSchema.nullable().optional().describe(
+      "Answer engine to run the topic's prompts on. Set this or `agent`, not both.",
+    ),
+    frequency: V2PromptTargetInputFrequency$zodSchema.default("daily").describe(
+      "How often this target runs on schedule. `manual` keeps it for runs you start yourself. Frequencies other than `daily` require custom prompt scheduling on the organization.",
+    ),
+  });

package/src/models/v2prompttargetslistop.ts

@@ -0,0 +1,33 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 31f493d5ba11
+ */
+
+import * as z from "zod";
+import {
+  HTTPValidationError,
+  HTTPValidationError$zodSchema,
+} from "./httpvalidationerror.js";
+import {
+  V2PromptTargetsResponse,
+  V2PromptTargetsResponse$zodSchema,
+} from "./v2prompttargetsresponse.js";
+
+export type V2PromptTargetsListRequest = { topic_id?: string | undefined };
+
+export const V2PromptTargetsListRequest$zodSchema: z.ZodType<
+  V2PromptTargetsListRequest
+> = z.object({
+  topic_id: z.string().describe("Optional prompt topic ID.").optional(),
+});
+
+export type V2PromptTargetsListResponse =
+  | V2PromptTargetsResponse
+  | HTTPValidationError;
+
+export const V2PromptTargetsListResponse$zodSchema: z.ZodType<
+  V2PromptTargetsListResponse
+> = z.union([
+  V2PromptTargetsResponse$zodSchema,
+  HTTPValidationError$zodSchema,
+]);

package/src/models/v2prompttargetsresponse.ts

@@ -0,0 +1,19 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 25379b3b6438
+ */
+
+import * as z from "zod";
+import { V2PromptTarget, V2PromptTarget$zodSchema } from "./v2prompttarget.js";
+
+export type V2PromptTargetsResponse = {
+  data?: Array<V2PromptTarget> | undefined;
+  count: number;
+};
+
+export const V2PromptTargetsResponse$zodSchema: z.ZodType<
+  V2PromptTargetsResponse
+> = z.object({
+  count: z.int(),
+  data: z.array(V2PromptTarget$zodSchema).optional(),
+});

package/src/models/v2prompttargetssetop.ts

@@ -0,0 +1,25 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 4187502eab53
+ */
+
+import * as z from "zod";
+import {
+  HTTPValidationError,
+  HTTPValidationError$zodSchema,
+} from "./httpvalidationerror.js";
+import {
+  SetV2PromptTargetsResponse,
+  SetV2PromptTargetsResponse$zodSchema,
+} from "./setv2prompttargetsresponse.js";
+
+export type V2PromptTargetsSetResponse =
+  | SetV2PromptTargetsResponse
+  | HTTPValidationError;
+
+export const V2PromptTargetsSetResponse$zodSchema: z.ZodType<
+  V2PromptTargetsSetResponse
+> = z.union([
+  SetV2PromptTargetsResponse$zodSchema,
+  HTTPValidationError$zodSchema,
+]);

package/src/tool-names.ts

@@ -52,6 +52,14 @@ export const toolNames: Array<{ name: string; description: string }>= [
     "name": "prompts-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": "prompts-targets-list",
+    "description": "List Targets\n\nReturns the answer engines and coding agents that run the organization's prompts on schedule, with each target's topic and frequency. Provide `topic_id` to list one topic's targets."
+  },
+  {
+    "name": "prompts-targets-set",
+    "description": "Set Targets\n\nSets which answer engines and coding agents run a topic's prompts on schedule, the same way the prompt editor does. The list replaces the topic's targets: targets you leave out stop running. Every prompt in the topic is set to exactly these platforms; you can still narrow one prompt afterwards with `platform_ids`. Name coding agents with IDs from `GET /v2/agents`, and list a harness more than once to run it on several models. To pick agents for a single run without changing the schedule, pass `agent` to `POST /v2/prompts/runs` instead."
+  },
   {
     "name": "prompts-runs-list",
     "description": "List Prompt Runs\n\nReturns stored prompt runs with limit-and-offset pagination, without exposing raw runtime or provider configuration. Filter by prompt, platform, or date range."
@@ -74,7 +82,7 @@ export const toolNames: Array<{ name: string; description: string }>= [
   },
   {
     "name": "prompts-run",
-    "description": "Run Prompts\n\nQueue saved prompts on answer engines and coding agents.\n\nProvide `prompt_ids` to run selected prompts, or omit them to run all active\nprompts. By default the run uses the organization's configured targets.\nProvide `agent` with IDs from `GET /v2/agents` to run the prompts on\nspecific coding-agent harnesses and models instead, for example to compare\nhow several coding tools answer the same developer question. Results\ninclude mentions and citations. Saved prompt run settings apply to\ncoding-agent targets. The response returns a run ID to poll with\n`GET /v2/prompts/runs/{run_id}/status`."
+    "description": "Run Prompts\n\nQueue saved prompts on answer engines and coding agents.\n\nProvide `prompt_ids` to run selected prompts, or omit them to run all active\nprompts. By default the run uses the organization's configured targets,\nlisted by `GET /v2/prompts/targets`.\nProvide `agent` with IDs from `GET /v2/agents` to run the prompts on\nspecific coding-agent harnesses and models instead, for example to compare\nhow several coding tools answer the same developer question. Results\ninclude mentions and citations. Saved prompt run settings apply to\ncoding-agent targets. The response returns a run ID to poll with\n`GET /v2/prompts/runs/{run_id}/status`."
   },
   {
     "name": "prompts-run-status",
@@ -258,7 +266,7 @@ export const toolNames: Array<{ name: string; description: string }>= [
   },
   {
     "name": "agents-list",
-    "description": "List Agents\n\nReturns the coding-agent harness-and-model combinations your plan can run, as single agent IDs. Pass them as `agent` to `POST /v2/prompts/runs` to see how coding agents answer your prompts, with mentions and citations; to `POST /v2/agent-preference/evals` to see whether agents recommend your company over one competitor; or to `POST /v2/evals` and `POST /v2/eval-runs` to measure how well agents complete tasks with your product."
+    "description": "List Agents\n\nReturns the coding-agent harness-and-model combinations your plan can run, as single agent IDs. Pass them as `agent` to `POST /v2/prompts/runs` to see how coding agents answer your prompts, with mentions and citations, or to `PUT /v2/prompts/targets` to run them on a schedule; to `POST /v2/agent-preference/evals` to see whether agents recommend your company over one competitor; or to `POST /v2/evals` and `POST /v2/eval-runs` to measure how well agents complete tasks with your product."
   },
   {
     "name": "repositories-list",

package/test/tracker.test.js

@@ -313,11 +313,93 @@ test("OAuth sessions follow the user, not the token", async () => {
 });
 
 
-test("only failed calls and catalog tool results are stored", async () => {
+test("only failed calls, catalog tool results and feedback confirmations are stored", async () => {
   const { shouldStoreResponse } = await import("../lib/tracker.js");
   assert.equal(shouldStoreResponse({ toolName: "list_tools", isError: false }), true);
   assert.equal(shouldStoreResponse({ toolName: "describe_tool_input", isError: false }), true);
   assert.equal(shouldStoreResponse({ toolName: "execute_tool", isError: false }), false);
   assert.equal(shouldStoreResponse({ toolName: "get_profile", isError: false }), false);
   assert.equal(shouldStoreResponse({ toolName: "execute_tool", isError: true }), true);
+  assert.equal(shouldStoreResponse({ toolName: "send_feedback", isError: false }), true);
+});
+
+async function connectedClient(url, apiKey) {
+  const client = new Client({ name: "feedback-test", version: "1.0.0" });
+  await client.connect(
+    new StreamableHTTPClientTransport(url, {
+      fetch: realFetch,
+      requestInit: { headers: { "lightsage-api-key-auth": apiKey } },
+    }),
+  );
+  return client;
+}
+
+test("a recorded caller can send feedback, and MCP Analytics keeps its input and output", async () => {
+  await withServer(async (url) => {
+    const client = await connectedClient(new URL(url), "ls_feedback_key");
+    try {
+      const { tools } = await client.listTools();
+      const tool = tools.find((t) => t.name === "send_feedback");
+      assert.ok(tool, "send_feedback is listed");
+      assert.equal(tool.annotations.readOnlyHint, false);
+      assert.equal(tool.annotations.destructiveHint, false);
+      assert.deepEqual(tool.inputSchema.required, ["feedback"]);
+      assert.equal(tool.inputSchema.additionalProperties, false);
+
+      const before = sentEvents().length;
+      const result = await client.callTool({
+        name: "send_feedback",
+        arguments: { feedback: "  list_tools missed the visibility tools  " },
+      });
+      assert.ok(!result.isError);
+      assert.equal(result.content[0].text, "Feedback received. Thank you!");
+
+      const call = sentEvents().slice(before).find((e) =>
+        e.event === "$mcp_tool_call" && e.tool_name === "send_feedback"
+      );
+      assert.equal(call.parameters.feedback, "  list_tools missed the visibility tools  ");
+      assert.equal(call.response.content[0].text, "Feedback received. Thank you!");
+      assert.ok(!JSON.stringify(call).includes("ls_feedback_key"));
+    } finally {
+      await client.close();
+    }
+  });
+});
+
+test("feedback must be text within the limit, with no other fields", async () => {
+  const { MAX_FEEDBACK_LENGTH } = await import("../lib/feedback.js");
+  await withServer(async (url) => {
+    const client = await connectedClient(new URL(url), "ls_feedback_key");
+    try {
+      for (const args of [
+        {},
+        { feedback: "   " },
+        { feedback: "x".repeat(MAX_FEEDBACK_LENGTH + 1) },
+        { feedback: "ok", email: "a@example.com" },
+      ]) {
+        const result = await client.callTool({ name: "send_feedback", arguments: args });
+        assert.equal(result.isError, true, JSON.stringify(args).slice(0, 60));
+      }
+      const result = await client.callTool({
+        name: "send_feedback",
+        arguments: { feedback: "x".repeat(MAX_FEEDBACK_LENGTH) },
+      });
+      assert.ok(!result.isError);
+    } finally {
+      await client.close();
+    }
+  });
+});
+
+test("callers who are not recorded are not offered the feedback tool", async () => {
+  await withServer(async (url) => {
+    const client = await connectedClient(new URL(url), "ls_bad_unrecorded");
+    try {
+      const { tools } = await client.listTools();
+      assert.ok(tools.length > 0);
+      assert.ok(!tools.some((t) => t.name === "send_feedback"));
+    } finally {
+      await client.close();
+    }
+  });
 });