@lightsage/mcp 0.1.7

package/src/models/visibilityoverviewretrieveop.ts

@@ -0,0 +1,65 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  HTTPValidationError,
+  HTTPValidationError$zodSchema,
+} from "./httpvalidationerror.js";
+import {
+  PublicVisibilityOverviewResponse,
+  PublicVisibilityOverviewResponse$zodSchema,
+} from "./publicvisibilityoverviewresponse.js";
+
+export type VisibilityOverviewRetrieveRequest = {
+  start_date?: string | undefined;
+  end_date?: string | undefined;
+};
+
+export const VisibilityOverviewRetrieveRequest$zodSchema: z.ZodType<
+  VisibilityOverviewRetrieveRequest
+> = z.object({
+  end_date: z.string().date().describe("Optional end date. Defaults to today.")
+    .optional(),
+  start_date: z.string().date().describe(
+    "Optional start date. Defaults to 30 days before the end date.",
+  ).optional(),
+});
+
+/**
+ * No configured company was found for this organization.
+ */
+export type VisibilityOverviewRetrieveNotFoundResponseBody = { detail: string };
+
+export const VisibilityOverviewRetrieveNotFoundResponseBody$zodSchema:
+  z.ZodType<VisibilityOverviewRetrieveNotFoundResponseBody> = z.object({
+    detail: z.string(),
+  }).describe("No configured company was found for this organization.");
+
+/**
+ * The requested date range is invalid.
+ */
+export type VisibilityOverviewRetrieveBadRequestResponseBody = {
+  detail: string;
+};
+
+export const VisibilityOverviewRetrieveBadRequestResponseBody$zodSchema:
+  z.ZodType<VisibilityOverviewRetrieveBadRequestResponseBody> = z.object({
+    detail: z.string(),
+  }).describe("The requested date range is invalid.");
+
+export type VisibilityOverviewRetrieveResponse =
+  | PublicVisibilityOverviewResponse
+  | VisibilityOverviewRetrieveBadRequestResponseBody
+  | VisibilityOverviewRetrieveNotFoundResponseBody
+  | HTTPValidationError;
+
+export const VisibilityOverviewRetrieveResponse$zodSchema: z.ZodType<
+  VisibilityOverviewRetrieveResponse
+> = z.union([
+  PublicVisibilityOverviewResponse$zodSchema,
+  z.lazy(() => VisibilityOverviewRetrieveBadRequestResponseBody$zodSchema),
+  z.lazy(() => VisibilityOverviewRetrieveNotFoundResponseBody$zodSchema),
+  HTTPValidationError$zodSchema,
+]);

package/src/models/visibilitypromptsretrieveop.ts

@@ -0,0 +1,66 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  HTTPValidationError,
+  HTTPValidationError$zodSchema,
+} from "./httpvalidationerror.js";
+import {
+  PublicPromptVisibilityReportResponse,
+  PublicPromptVisibilityReportResponse$zodSchema,
+} from "./publicpromptvisibilityreportresponse.js";
+
+export type VisibilityPromptsRetrieveRequest = {
+  start_date?: string | undefined;
+  end_date?: string | undefined;
+};
+
+export const VisibilityPromptsRetrieveRequest$zodSchema: z.ZodType<
+  VisibilityPromptsRetrieveRequest
+> = z.object({
+  end_date: z.string().date().describe("Optional end date. Defaults to today.")
+    .optional(),
+  start_date: z.string().date().describe(
+    "Optional start date. Defaults to 30 days before the end date.",
+  ).optional(),
+});
+
+/**
+ * No configured company was found for this organization.
+ */
+export type VisibilityPromptsRetrieveNotFoundResponseBody = { detail: string };
+
+export const VisibilityPromptsRetrieveNotFoundResponseBody$zodSchema: z.ZodType<
+  VisibilityPromptsRetrieveNotFoundResponseBody
+> = z.object({
+  detail: z.string(),
+}).describe("No configured company was found for this organization.");
+
+/**
+ * The requested date range is invalid.
+ */
+export type VisibilityPromptsRetrieveBadRequestResponseBody = {
+  detail: string;
+};
+
+export const VisibilityPromptsRetrieveBadRequestResponseBody$zodSchema:
+  z.ZodType<VisibilityPromptsRetrieveBadRequestResponseBody> = z.object({
+    detail: z.string(),
+  }).describe("The requested date range is invalid.");
+
+export type VisibilityPromptsRetrieveResponse =
+  | PublicPromptVisibilityReportResponse
+  | VisibilityPromptsRetrieveBadRequestResponseBody
+  | VisibilityPromptsRetrieveNotFoundResponseBody
+  | HTTPValidationError;
+
+export const VisibilityPromptsRetrieveResponse$zodSchema: z.ZodType<
+  VisibilityPromptsRetrieveResponse
+> = z.union([
+  PublicPromptVisibilityReportResponse$zodSchema,
+  z.lazy(() => VisibilityPromptsRetrieveBadRequestResponseBody$zodSchema),
+  z.lazy(() => VisibilityPromptsRetrieveNotFoundResponseBody$zodSchema),
+  HTTPValidationError$zodSchema,
+]);

package/src/tool-names.ts

@@ -0,0 +1,203 @@
+// Auto-generated at build time
+export const toolNames: Array<{ name: string; description: string }>= [
+  {
+    "name": "status-status-get",
+    "description": "Get Status"
+  },
+  {
+    "name": "status-auth-status-get",
+    "description": "Get Auth Status"
+  },
+  {
+    "name": "prompts-prompts-list",
+    "description": "List Prompts"
+  },
+  {
+    "name": "prompts-prompts-create",
+    "description": "Create Prompts"
+  },
+  {
+    "name": "prompts-prompts-config-retrieve",
+    "description": "Retrieve Prompt Config"
+  },
+  {
+    "name": "prompts-prompts-topics-create",
+    "description": "Create Topic"
+  },
+  {
+    "name": "prompts-prompts-topics-update",
+    "description": "Update Topic"
+  },
+  {
+    "name": "prompts-prompts-topics-delete",
+    "description": "Delete Topic"
+  },
+  {
+    "name": "prompts-prompts-retrieve",
+    "description": "Retrieve Prompt"
+  },
+  {
+    "name": "prompts-prompts-update",
+    "description": "Update Prompt"
+  },
+  {
+    "name": "prompts-prompts-delete",
+    "description": "Delete Prompt"
+  },
+  {
+    "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": "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": "tasks-tasks-retrieve",
+    "description": "Retrieve Task\n\nRetrieve a single daily task and its execution prompt."
+  },
+  {
+    "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": "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": "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": "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": "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": "content-content-get",
+    "description": "Get Content Endpoint\n\nRetrieve a content record (title, markdown body, slug, status)."
+  },
+  {
+    "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": "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": "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": "API-performance-api-performance-targets-list",
+    "description": "List Targets"
+  },
+  {
+    "name": "API-performance-api-performance-runs-list",
+    "description": "List Eval Runs"
+  },
+  {
+    "name": "API-performance-api-performance-runs-retrieve",
+    "description": "Retrieve Eval Run"
+  },
+  {
+    "name": "API-performance-api-performance-diagnose",
+    "description": "Diagnose Eval Runs"
+  },
+  {
+    "name": "API-performance-api-performance-config-retrieve",
+    "description": "Retrieve Eval Config"
+  },
+  {
+    "name": "API-performance-api-performance-config-update",
+    "description": "Update Eval Config"
+  },
+  {
+    "name": "API-performance-api-performance-sources-list",
+    "description": "List Sources"
+  },
+  {
+    "name": "API-performance-api-performance-skills-list",
+    "description": "List Skills"
+  },
+  {
+    "name": "API-performance-api-performance-evals-list",
+    "description": "List Eval Definitions"
+  },
+  {
+    "name": "API-performance-api-performance-evals-retrieve",
+    "description": "Retrieve Eval Definition"
+  },
+  {
+    "name": "API-performance-api-performance-evals-update",
+    "description": "Update Eval Definition"
+  },
+  {
+    "name": "API-performance-api-performance-custom-evals-list",
+    "description": "List Custom Evals"
+  },
+  {
+    "name": "API-performance-api-performance-custom-evals-create",
+    "description": "Create Custom Eval"
+  },
+  {
+    "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": "API-performance-api-performance-custom-evals-e24",
+    "description": "Retrieve Custom Eval"
+  },
+  {
+    "name": "API-performance-api-performance-custom-evals-update",
+    "description": "Update Custom Eval"
+  },
+  {
+    "name": "API-performance-api-performance-custom-evals-delete",
+    "description": "Delete Custom Eval"
+  },
+  {
+    "name": "API-performance-api-performance-starter-projects-632",
+    "description": "List Starter Projects"
+  },
+  {
+    "name": "API-performance-api-performance-starter-projects-20c",
+    "description": "Create Starter Project"
+  },
+  {
+    "name": "API-performance-api-performance-starter-projects-372",
+    "description": "Retrieve Starter Project"
+  },
+  {
+    "name": "API-performance-api-performance-starter-projects-5ca",
+    "description": "Update Starter Project"
+  },
+  {
+    "name": "API-performance-api-performance-starter-projects-1c8",
+    "description": "Delete Starter Project"
+  },
+  {
+    "name": "API-performance-api-performance-actions-list",
+    "description": "List Actions"
+  },
+  {
+    "name": "API-performance-api-performance-actions-refresh",
+    "description": "Refresh Actions"
+  },
+  {
+    "name": "API-performance-api-performance-actions-retrieve",
+    "description": "Retrieve Action"
+  },
+  {
+    "name": "API-performance-api-performance-actions-update",
+    "description": "Update Action"
+  },
+  {
+    "name": "API-performance-api-performance-actions-verify",
+    "description": "Verify Action"
+  }
+];

package/src/types/async.ts

@@ -0,0 +1,69 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+export type APICall =
+  | {
+      status: "complete";
+      request: Request;
+      response: Response;
+    }
+  | {
+      status: "request-error";
+      request: Request;
+      response?: undefined;
+    }
+  | {
+      status: "invalid";
+      request?: undefined;
+      response?: undefined;
+    };
+
+export class APIPromise<T> implements Promise<T> {
+  readonly #promise: Promise<[T, APICall]>;
+  #unwrapped: Promise<T> | null;
+
+  readonly [Symbol.toStringTag] = "APIPromise";
+
+  constructor(p: [T, APICall] | Promise<[T, APICall]>) {
+    this.#promise = p instanceof Promise ? p : Promise.resolve(p);
+    this.#unwrapped = p instanceof Promise ? null : Promise.resolve(p[0]);
+  }
+
+  #getUnwrapped(): Promise<T> {
+    return (this.#unwrapped ??= this.#promise.then(([value]) => value));
+  }
+
+  then<TResult1 = T, TResult2 = never>(
+    onfulfilled?:
+      | ((value: T) => TResult1 | PromiseLike<TResult1>)
+      | null
+      | undefined,
+    onrejected?:
+      | ((reason: any) => TResult2 | PromiseLike<TResult2>)
+      | null
+      | undefined,
+  ): Promise<TResult1 | TResult2> {
+    return this.#promise.then(
+      onfulfilled ? ([value]) => onfulfilled(value) : void 0,
+      onrejected,
+    );
+  }
+
+  catch<TResult = never>(
+    onrejected?:
+      | ((reason: any) => TResult | PromiseLike<TResult>)
+      | null
+      | undefined,
+  ): Promise<T | TResult> {
+    return this.#getUnwrapped().catch(onrejected);
+  }
+
+  finally(onfinally?: (() => void) | null | undefined): Promise<T> {
+    return this.#getUnwrapped().finally(onfinally);
+  }
+
+  $inspect(): Promise<[T, APICall]> {
+    return this.#promise;
+  }
+}

package/src/types/bigint.ts

@@ -0,0 +1,88 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4";
+
+export function bigint(): z.ZodType<bigint | string> {
+  return z.union([
+    z.bigint().transform((v) => String(v)),
+    z.string().transform((v, ctx) => {
+      try {
+        return BigInt(v);
+      } catch {
+        ctx.addIssue({
+          code: z.ZodIssueCode.custom,
+          message: "Invalid bigint value",
+        });
+        return z.NEVER;
+      }
+    }),
+    z.number().transform((v) => BigInt(Math.trunc(v))),
+    z.union([z.null(), z.undefined()]).transform(() => BigInt(0)),
+  ]);
+}
+
+export function bigintOptional(): z.ZodType<bigint | string | undefined> {
+  return z
+    .union([
+      z.bigint().transform((v) => String(v)),
+      z.string().transform((v, ctx) => {
+        try {
+          return BigInt(v);
+        } catch {
+          ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Invalid bigint value",
+          });
+          return z.NEVER;
+        }
+      }),
+      z.number().transform((v) => BigInt(Math.trunc(v))),
+      z.null().transform(() => undefined),
+    ])
+    .optional();
+}
+
+export function bigintNullable(): z.ZodType<bigint | string | null> {
+  return z.union([
+    z.bigint().transform((v) => String(v)),
+    z.string().transform((v, ctx) => {
+      try {
+        return BigInt(v);
+      } catch {
+        ctx.addIssue({
+          code: z.ZodIssueCode.custom,
+          message: "Invalid bigint value",
+        });
+        return z.NEVER;
+      }
+    }),
+    z.number().transform((v) => BigInt(Math.trunc(v))),
+    z.null(),
+    z.undefined().transform(() => null),
+  ]);
+}
+
+export function bigintConst<T extends bigint>(value: T): z.ZodType<T> {
+  return z
+    .union([
+      z.bigint(),
+      z.string().transform((v, ctx) => {
+        try {
+          return BigInt(v);
+        } catch {
+          ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Invalid bigint value",
+          });
+          return z.NEVER;
+        }
+      }),
+      z.number().transform((v) => BigInt(Math.trunc(v))),
+    ])
+    .refine((v) => v === value, {
+      message: `Value must be ${value}`,
+    })
+    .transform(() => value as T);
+}

package/src/types/blobs.ts

@@ -0,0 +1,23 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+export function isBlobLike(val: unknown): val is Blob {
+  if (val instanceof Blob) {
+    return true;
+  }
+
+  if (typeof val !== "object" || val == null || !(Symbol.toStringTag in val)) {
+    return false;
+  }
+
+  const name = val[Symbol.toStringTag];
+  if (typeof name !== "string") {
+    return false;
+  }
+  if (name !== "Blob" && name !== "File") {
+    return false;
+  }
+
+  return "stream" in val && typeof val.stream === "function";
+}

package/src/types/enums.ts

@@ -0,0 +1,16 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+declare const __brand: unique symbol;
+export type Unrecognized<T> = T & { [__brand]: "unrecognized" };
+
+export function catchUnrecognizedEnum<T>(value: T): Unrecognized<T> {
+  return value as Unrecognized<T>;
+}
+
+type Prettify<T> = { [K in keyof T]: T[K] } & {};
+export type ClosedEnum<T> = T[keyof T];
+export type OpenEnum<T> =
+  | Prettify<T[keyof T]>
+  | Unrecognized<T[keyof T] extends number ? number : string>;

package/src/types/fp.ts

@@ -0,0 +1,50 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+/**
+ * A monad that captures the result of a function call or an error if it was not
+ * successful. Railway programming, enabled by this type, can be a nicer
+ * alternative to traditional exception throwing because it allows functions to
+ * declare all _known_ errors with static types and then check for them
+ * exhaustively in application code. Thrown exception have a type of `unknown`
+ * and break out of regular control flow of programs making them harder to
+ * inspect and more verbose work with due to try-catch blocks.
+ */
+export type Result<T, E = unknown> =
+  | { ok: true; value: T; error?: never }
+  | { ok: false; value?: never; error: E };
+
+export function OK<V>(value: V): Result<V, never> {
+  return { ok: true, value };
+}
+
+export function ERR<E>(error: E): Result<never, E> {
+  return { ok: false, error };
+}
+
+/**
+ * unwrap is a convenience function for extracting a value from a result or
+ * throwing if there was an error.
+ */
+export function unwrap<T>(r: Result<T, unknown>): T {
+  if (!r.ok) {
+    throw r.error;
+  }
+  return r.value;
+}
+
+/**
+ * unwrapAsync is a convenience function for resolving a value from a Promise
+ * of a result or rejecting if an error occurred.
+ */
+export async function unwrapAsync<T>(
+  pr: Promise<Result<T, unknown>>,
+): Promise<T> {
+  const r = await pr;
+  if (!r.ok) {
+    throw r.error;
+  }
+
+  return r.value;
+}

package/src/types/rfcdate.ts

@@ -0,0 +1,54 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+const dateRE = /^\d{4}-\d{2}-\d{2}$/;
+
+export class RFCDate {
+  private serialized: string;
+
+  /**
+   * Creates a new RFCDate instance using today's date.
+   */
+  static today(): RFCDate {
+    return new RFCDate(new Date());
+  }
+
+  /**
+   * Creates a new RFCDate instance using the provided input.
+   * If a string is used then in must be in the format YYYY-MM-DD.
+   *
+   * @param date A Date object or a date string in YYYY-MM-DD format
+   * @example
+   * new RFCDate("2022-01-01")
+   * @example
+   * new RFCDate(new Date())
+   */
+  constructor(date: Date | string) {
+    if (typeof date === "string" && !dateRE.test(date)) {
+      throw new RangeError(
+        "RFCDate: date strings must be in the format YYYY-MM-DD: " + date,
+      );
+    }
+
+    const value = new Date(date);
+    if (isNaN(+value)) {
+      throw new RangeError("RFCDate: invalid date provided: " + date);
+    }
+
+    this.serialized = value.toISOString().slice(0, "YYYY-MM-DD".length);
+    if (!dateRE.test(this.serialized)) {
+      throw new TypeError(
+        `RFCDate: failed to build valid date with given value: ${date} serialized to ${this.serialized}`,
+      );
+    }
+  }
+
+  toJSON(): string {
+    return this.toString();
+  }
+
+  toString(): string {
+    return this.serialized;
+  }
+}

package/src/types/streams.ts

@@ -0,0 +1,21 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+export function isReadableStream<T = Uint8Array>(
+  val: unknown,
+): val is ReadableStream<T> {
+  if (typeof val !== "object" || val === null) {
+    return false;
+  }
+
+  // Check for the presence of methods specific to ReadableStream
+  const stream = val as ReadableStream<Uint8Array>;
+
+  // ReadableStream has methods like getReader, cancel, and tee
+  return (
+    typeof stream.getReader === "function" &&
+    typeof stream.cancel === "function" &&
+    typeof stream.tee === "function"
+  );
+}