@lightsage/mcp 0.4.2 → 0.4.3

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

@@ -0,0 +1,48 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: e0ae54886903
+ */
+
+import { promptsRun } from "../../funcs/promptsRun.js";
+import { CreateV2PromptRunRequest$zodSchema } from "../../models/createv2promptrunrequest.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: CreateV2PromptRunRequest$zodSchema,
+};
+
+export const tool$promptsRun: ToolDefinition<typeof args> = {
+  name: "prompts-run",
+  description: `Run Prompts
+
+Queue saved prompts using the organization's configured targets.
+
+Provide \`prompt_ids\` to run selected prompts, or omit them to run all active
+prompts. Saved prompt run settings apply to coding-agent targets. The
+response returns a run ID to poll with
+\`GET /v2/prompts/runs/{run_id}/status\`.`,
+  annotations: {
+    "title": "",
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result] = await promptsRun(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    return formatResult(result.value);
+  },
+};

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

@@ -0,0 +1,46 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 6ee310f41b65
+ */
+
+import { promptsRunStatus } from "../../funcs/promptsRunStatus.js";
+import { V2PromptRunStatusRetrieveRequest$zodSchema } from "../../models/v2promptrunstatusretrieveop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: V2PromptRunStatusRetrieveRequest$zodSchema,
+};
+
+export const tool$promptsRunStatus: ToolDefinition<typeof args> = {
+  name: "prompts-run-status",
+  description: `Get Prompt Run Status
+
+Return status and progress for a queued prompt run.
+
+Poll this endpoint until \`status\` is \`completed\`, \`failed\`, or \`cancelled\`.
+Individual stored results are available from \`GET /v2/prompts/runs\`.`,
+  annotations: {
+    "title": "",
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result] = await promptsRunStatus(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    return formatResult(result.value);
+  },
+};

package/src/models/createv2promptrunrequest.ts

@@ -0,0 +1,22 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b7b72bfe20d1
+ */
+
+import * as z from "zod";
+
+export type CreateV2PromptRunRequest = {
+  prompt_ids?: Array<string> | null | undefined;
+  force?: boolean | undefined;
+};
+
+export const CreateV2PromptRunRequest$zodSchema: z.ZodType<
+  CreateV2PromptRunRequest
+> = z.object({
+  force: z.boolean().default(false).describe(
+    "Run even when a prompt already ran today on the configured platform and model.",
+  ),
+  prompt_ids: z.array(z.string()).nullable().optional().describe(
+    "Prompt IDs from `GET /v2/prompts`. Omit this field to run all active prompts.",
+  ),
+});

package/src/models/v2evalrunscreateop.ts

@@ -23,9 +23,15 @@ export const V2EvalRunsCreateForbiddenResponseBody$zodSchema: z.ZodType<
   "The requested coding agent is unavailable on the organization's current plan.",
 );
 
-export type Detail = { error: string; required: number; balance: number };
+export type V2EvalRunsCreateDetail = {
+  error: string;
+  required: number;
+  balance: number;
+};
 
-export const Detail$zodSchema: z.ZodType<Detail> = z.object({
+export const V2EvalRunsCreateDetail$zodSchema: z.ZodType<
+  V2EvalRunsCreateDetail
+> = z.object({
   balance: z.number().describe("The organization's current credit balance."),
   error: z.string(),
   required: z.number().describe("Usage-based credits the requested run needs."),
@@ -34,12 +40,14 @@ export const Detail$zodSchema: z.ZodType<Detail> = z.object({
 /**
  * The organization does not currently have enough credits for the requested run.
  */
-export type V2EvalRunsCreatePaymentRequiredResponseBody = { detail: Detail };
+export type V2EvalRunsCreatePaymentRequiredResponseBody = {
+  detail: V2EvalRunsCreateDetail;
+};
 
 export const V2EvalRunsCreatePaymentRequiredResponseBody$zodSchema: z.ZodType<
   V2EvalRunsCreatePaymentRequiredResponseBody
 > = z.object({
-  detail: z.lazy(() => Detail$zodSchema),
+  detail: z.lazy(() => V2EvalRunsCreateDetail$zodSchema),
 }).describe(
   "The organization does not currently have enough credits for the requested run.",
 );

package/src/models/v2promptrunjobresponse.ts

@@ -0,0 +1,97 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 4ccfac1e4b39
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+import {
+  PublicEvalRunProgress,
+  PublicEvalRunProgress$zodSchema,
+} from "./publicevalrunprogress.js";
+
+export const V2PromptRunJobResponseStatusEnum = {
+  Pending: "pending",
+  Running: "running",
+  Summarizing: "summarizing",
+  Completed: "completed",
+  Failed: "failed",
+  Cancelled: "cancelled",
+  Interrupted: "interrupted",
+} as const;
+export type V2PromptRunJobResponseStatusEnum = ClosedEnum<
+  typeof V2PromptRunJobResponseStatusEnum
+>;
+
+export const V2PromptRunJobResponseStatusEnum$zodSchema = z.enum([
+  "pending",
+  "running",
+  "summarizing",
+  "completed",
+  "failed",
+  "cancelled",
+  "interrupted",
+]);
+
+/**
+ * Terminal values: `completed`, `failed`, and `cancelled`. Recoverable interruptions are reported as `running` with stage `retrying`.
+ */
+export type Status = V2PromptRunJobResponseStatusEnum | string;
+
+export const Status$zodSchema: z.ZodType<Status> = z.union([
+  V2PromptRunJobResponseStatusEnum$zodSchema,
+  z.string(),
+]).describe(
+  "Terminal values: `completed`, `failed`, and `cancelled`. Recoverable interruptions are reported as `running` with stage `retrying`.",
+);
+
+export type V2PromptRunJobResponse = {
+  id: string;
+  job_id: string;
+  type?: "prompts" | undefined;
+  source_type?: "prompts" | undefined;
+  status: V2PromptRunJobResponseStatusEnum | string;
+  stage?: string | null | undefined;
+  dispatch_id?: string | null | undefined;
+  progress?: PublicEvalRunProgress | undefined;
+  estimated_cost?: number | null | undefined;
+  eval_count?: number | null | undefined;
+  model_count?: number | null | undefined;
+  error?: string | null | undefined;
+  created_at?: string | null | undefined;
+  started_at?: string | null | undefined;
+  completed_at?: string | null | undefined;
+};
+
+export const V2PromptRunJobResponse$zodSchema: z.ZodType<
+  V2PromptRunJobResponse
+> = z.object({
+  completed_at: z.string().nullable().optional().describe(
+    "Can be set while `status` is still `summarizing`; use `status` to detect completion.",
+  ),
+  created_at: z.string().nullable().optional(),
+  dispatch_id: z.string().nullable().optional(),
+  error: z.string().nullable().optional(),
+  estimated_cost: z.number().nullable().optional().describe(
+    "The estimated credit cost for prompt jobs or estimated USD cost for API Performance jobs. Null when no estimate is available.",
+  ),
+  eval_count: z.int().nullable().optional(),
+  id: z.string().describe(
+    "Run ID to poll with `GET /v2/prompts/runs/{run_id}/status`.",
+  ),
+  job_id: z.string().describe("Parent job ID. It currently matches `id`."),
+  model_count: z.int().nullable().optional(),
+  progress: PublicEvalRunProgress$zodSchema.optional(),
+  source_type: z.literal("prompts").default("prompts").optional(),
+  stage: z.string().nullable().optional().describe(
+    "Current lifecycle stage, including `retrying` while interrupted child jobs wait to be reclaimed.",
+  ),
+  started_at: z.string().nullable().optional(),
+  status: z.union([
+    V2PromptRunJobResponseStatusEnum$zodSchema,
+    z.string(),
+  ]).describe(
+    "Terminal values: `completed`, `failed`, and `cancelled`. Recoverable interruptions are reported as `running` with stage `retrying`.",
+  ),
+  type: z.literal("prompts").default("prompts").optional(),
+});

package/src/models/v2promptrunscreateop.ts

@@ -0,0 +1,100 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 54866e0df895
+ */
+
+import * as z from "zod";
+import {
+  HTTPValidationError,
+  HTTPValidationError$zodSchema,
+} from "./httpvalidationerror.js";
+import {
+  V2PromptRunJobResponse,
+  V2PromptRunJobResponse$zodSchema,
+} from "./v2promptrunjobresponse.js";
+
+/**
+ * The background queue is temporarily unavailable.
+ */
+export type V2PromptRunsCreateServiceUnavailableResponseBody = {
+  detail: string;
+};
+
+export const V2PromptRunsCreateServiceUnavailableResponseBody$zodSchema:
+  z.ZodType<V2PromptRunsCreateServiceUnavailableResponseBody> = z.object({
+    detail: z.string(),
+  }).describe("The background queue is temporarily unavailable.");
+
+/**
+ * One or more configured targets are unavailable on the organization's current plan.
+ */
+export type V2PromptRunsCreateForbiddenResponseBody = { detail: string };
+
+export const V2PromptRunsCreateForbiddenResponseBody$zodSchema: z.ZodType<
+  V2PromptRunsCreateForbiddenResponseBody
+> = z.object({
+  detail: z.string(),
+}).describe(
+  "One or more configured targets are unavailable on the organization's current plan.",
+);
+
+export type V2PromptRunsCreateDetail = {
+  error: string;
+  required: number;
+  balance: number;
+};
+
+export const V2PromptRunsCreateDetail$zodSchema: z.ZodType<
+  V2PromptRunsCreateDetail
+> = z.object({
+  balance: z.number().describe("The organization's current credit balance."),
+  error: z.string(),
+  required: z.number().describe("Usage-based credits the requested run needs."),
+});
+
+/**
+ * The organization does not currently have enough credits for the requested run.
+ */
+export type V2PromptRunsCreatePaymentRequiredResponseBody = {
+  detail: V2PromptRunsCreateDetail;
+};
+
+export const V2PromptRunsCreatePaymentRequiredResponseBody$zodSchema: z.ZodType<
+  V2PromptRunsCreatePaymentRequiredResponseBody
+> = z.object({
+  detail: z.lazy(() => V2PromptRunsCreateDetail$zodSchema),
+}).describe(
+  "The organization does not currently have enough credits for the requested run.",
+);
+
+/**
+ * No runnable configured targets were found for the selected prompts.
+ */
+export type V2PromptRunsCreateBadRequestResponseBody = { detail: string };
+
+export const V2PromptRunsCreateBadRequestResponseBody$zodSchema: z.ZodType<
+  V2PromptRunsCreateBadRequestResponseBody
+> = z.object({
+  detail: z.string(),
+}).describe(
+  "No runnable configured targets were found for the selected prompts.",
+);
+
+export type V2PromptRunsCreateResponse =
+  | V2PromptRunJobResponse
+  | V2PromptRunsCreateBadRequestResponseBody
+  | V2PromptRunsCreatePaymentRequiredResponseBody
+  | V2PromptRunsCreateForbiddenResponseBody
+  | V2PromptRunsCreateServiceUnavailableResponseBody
+  | HTTPValidationError;
+
+export const V2PromptRunsCreateResponse$zodSchema: z.ZodType<
+  V2PromptRunsCreateResponse
+> = z.union([
+  V2PromptRunJobResponse$zodSchema,
+  z.lazy(() => V2PromptRunsCreateBadRequestResponseBody$zodSchema),
+  z.lazy(() => V2PromptRunsCreatePaymentRequiredResponseBody$zodSchema),
+  z.lazy(() => V2PromptRunsCreateForbiddenResponseBody$zodSchema),
+  z.lazy(() => V2PromptRunsCreateServiceUnavailableResponseBody$zodSchema),
+  HTTPValidationError$zodSchema,
+]);

package/src/models/v2promptrunstatusretrieveop.ts

@@ -0,0 +1,64 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 8f9c98c256bf
+ */
+
+import * as z from "zod";
+import {
+  HTTPValidationError,
+  HTTPValidationError$zodSchema,
+} from "./httpvalidationerror.js";
+import {
+  V2PromptRunJobResponse,
+  V2PromptRunJobResponse$zodSchema,
+} from "./v2promptrunjobresponse.js";
+
+export type V2PromptRunStatusRetrieveRequest = { run_id: string };
+
+export const V2PromptRunStatusRetrieveRequest$zodSchema: z.ZodType<
+  V2PromptRunStatusRetrieveRequest
+> = z.object({
+  run_id: z.string().describe(
+    "Run ID returned by `POST /v2/prompts/runs`, not a stored prompt result ID.",
+  ),
+});
+
+/**
+ * The prompt run job does not exist or is not visible to this API key.
+ */
+export type V2PromptRunStatusRetrieveNotFoundResponseBody = { detail: string };
+
+export const V2PromptRunStatusRetrieveNotFoundResponseBody$zodSchema: z.ZodType<
+  V2PromptRunStatusRetrieveNotFoundResponseBody
+> = z.object({
+  detail: z.string(),
+}).describe(
+  "The prompt run job does not exist or is not visible to this API key.",
+);
+
+/**
+ * The prompt run ID is not a valid UUID.
+ */
+export type V2PromptRunStatusRetrieveBadRequestResponseBody = {
+  detail: string;
+};
+
+export const V2PromptRunStatusRetrieveBadRequestResponseBody$zodSchema:
+  z.ZodType<V2PromptRunStatusRetrieveBadRequestResponseBody> = z.object({
+    detail: z.string(),
+  }).describe("The prompt run ID is not a valid UUID.");
+
+export type V2PromptRunStatusRetrieveResponse =
+  | V2PromptRunJobResponse
+  | V2PromptRunStatusRetrieveBadRequestResponseBody
+  | V2PromptRunStatusRetrieveNotFoundResponseBody
+  | HTTPValidationError;
+
+export const V2PromptRunStatusRetrieveResponse$zodSchema: z.ZodType<
+  V2PromptRunStatusRetrieveResponse
+> = z.union([
+  V2PromptRunJobResponse$zodSchema,
+  z.lazy(() => V2PromptRunStatusRetrieveBadRequestResponseBody$zodSchema),
+  z.lazy(() => V2PromptRunStatusRetrieveNotFoundResponseBody$zodSchema),
+  HTTPValidationError$zodSchema,
+]);

package/src/tool-names.ts

@@ -68,6 +68,14 @@ export const toolNames: Array<{ name: string; description: string }>= [
     "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": "prompts-run",
+    "description": "Run Prompts\n\nQueue saved prompts using the organization's configured targets.\n\nProvide `prompt_ids` to run selected prompts, or omit them to run all active\nprompts. Saved prompt run settings apply to coding-agent targets. The\nresponse returns a run ID to poll with\n`GET /v2/prompts/runs/{run_id}/status`."
+  },
+  {
+    "name": "prompts-run-status",
+    "description": "Get Prompt Run Status\n\nReturn status and progress for a queued prompt run.\n\nPoll this endpoint until `status` is `completed`, `failed`, or `cancelled`.\nIndividual stored results are available from `GET /v2/prompts/runs`."
+  },
   {
     "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."