@lightsage/mcp 0.1.7

package/src/models/publictopicvisibilityrow.ts

@@ -0,0 +1,33 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  PublicPromptVisibilityMetrics,
+  PublicPromptVisibilityMetrics$zodSchema,
+} from "./publicpromptvisibilitymetrics.js";
+import {
+  PublicPromptVisibilityRow,
+  PublicPromptVisibilityRow$zodSchema,
+} from "./publicpromptvisibilityrow.js";
+
+export type PublicTopicVisibilityRow = {
+  id: string;
+  name: string;
+  prompt_count: number;
+  metrics: PublicPromptVisibilityMetrics;
+  prompts?: Array<PublicPromptVisibilityRow> | undefined;
+};
+
+export const PublicTopicVisibilityRow$zodSchema: z.ZodType<
+  PublicTopicVisibilityRow
+> = z.object({
+  id: z.string().describe("Stable prompt topic identifier."),
+  metrics: PublicPromptVisibilityMetrics$zodSchema,
+  name: z.string().describe("Prompt topic name."),
+  prompt_count: z.int().describe("Active prompts in this topic."),
+  prompts: z.array(PublicPromptVisibilityRow$zodSchema).optional().describe(
+    "Active prompts in the topic with date-range metrics.",
+  ),
+});

package/src/models/publicupdateactionrequest.ts

@@ -0,0 +1,21 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type PublicUpdateActionRequest = {
+  status?: string | undefined;
+  owner_user_id?: string | undefined;
+  ignored_reason?: string | undefined;
+  note?: string | undefined;
+};
+
+export const PublicUpdateActionRequest$zodSchema: z.ZodType<
+  PublicUpdateActionRequest
+> = z.object({
+  ignored_reason: z.string().optional(),
+  note: z.string().optional(),
+  owner_user_id: z.string().optional(),
+  status: z.string().optional(),
+});

package/src/models/publicverifyactionresponse.ts

@@ -0,0 +1,23 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  PublicApiPerformanceAction,
+  PublicApiPerformanceAction$zodSchema,
+} from "./publicapiperformanceaction.js";
+
+export type PublicVerifyActionResponse = {
+  status: string;
+  action?: PublicApiPerformanceAction | null | undefined;
+  url_check?: { [k: string]: any } | null | undefined;
+};
+
+export const PublicVerifyActionResponse$zodSchema: z.ZodType<
+  PublicVerifyActionResponse
+> = z.object({
+  action: PublicApiPerformanceAction$zodSchema.nullable().optional(),
+  status: z.string(),
+  url_check: z.record(z.string(), z.any()).nullable().optional(),
+});

package/src/models/publicvisibilitybyplatform.ts

@@ -0,0 +1,33 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  PublicPlatformRef,
+  PublicPlatformRef$zodSchema,
+} from "./publicplatformref.js";
+import {
+  PublicSeriesPoint,
+  PublicSeriesPoint$zodSchema,
+} from "./publicseriespoint.js";
+
+export type PublicVisibilityByPlatform = {
+  platforms?: Array<PublicPlatformRef> | undefined;
+  visibility_score?: { [k: string]: Array<PublicSeriesPoint> } | undefined;
+  citations?: { [k: string]: Array<PublicSeriesPoint> } | undefined;
+};
+
+export const PublicVisibilityByPlatform$zodSchema: z.ZodType<
+  PublicVisibilityByPlatform
+> = z.object({
+  citations: z.record(z.string(), z.array(PublicSeriesPoint$zodSchema))
+    .optional().describe(
+      "Owned-domain citation-count timeseries keyed by platform_id.",
+    ),
+  platforms: z.array(PublicPlatformRef$zodSchema).optional().describe(
+    "Platforms present in the date range.",
+  ),
+  visibility_score: z.record(z.string(), z.array(PublicSeriesPoint$zodSchema))
+    .optional().describe("Visibility score timeseries keyed by platform_id."),
+});

package/src/models/publicvisibilitydaterange.ts

@@ -0,0 +1,29 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type PublicVisibilityDateRange = {
+  start_date: string;
+  end_date: string;
+  granularity?: string | undefined;
+  latest_run_date?: string | null | undefined;
+  active_prompts_only?: boolean | undefined;
+};
+
+export const PublicVisibilityDateRange$zodSchema: z.ZodType<
+  PublicVisibilityDateRange
+> = z.object({
+  active_prompts_only: z.boolean().default(true).describe(
+    "Whether only currently active prompts were included.",
+  ),
+  end_date: z.string().describe("End date used for the calculation."),
+  granularity: z.string().default("day").describe(
+    "Spacing between timeseries data points.",
+  ),
+  latest_run_date: z.string().nullable().optional().describe(
+    "Latest prompt-run date included in the calculation.",
+  ),
+  start_date: z.string().describe("Start date used for the calculation."),
+});

package/src/models/publicvisibilityoverviewresponse.ts

@@ -0,0 +1,52 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { PublicCompany, PublicCompany$zodSchema } from "./publiccompany.js";
+import {
+  PublicCompetitorRow,
+  PublicCompetitorRow$zodSchema,
+} from "./publiccompetitorrow.js";
+import {
+  PublicVisibilityByPlatform,
+  PublicVisibilityByPlatform$zodSchema,
+} from "./publicvisibilitybyplatform.js";
+import {
+  PublicVisibilityDateRange,
+  PublicVisibilityDateRange$zodSchema,
+} from "./publicvisibilitydaterange.js";
+import {
+  PublicVisibilitySnapshot,
+  PublicVisibilitySnapshot$zodSchema,
+} from "./publicvisibilitysnapshot.js";
+import {
+  PublicVisibilityTimeseries,
+  PublicVisibilityTimeseries$zodSchema,
+} from "./publicvisibilitytimeseries.js";
+
+export type PublicVisibilityOverviewResponse = {
+  company: PublicCompany;
+  date_range: PublicVisibilityDateRange;
+  has_data: boolean;
+  snapshot: PublicVisibilitySnapshot;
+  timeseries: PublicVisibilityTimeseries;
+  by_platform: PublicVisibilityByPlatform;
+  competitors?: Array<PublicCompetitorRow> | undefined;
+};
+
+export const PublicVisibilityOverviewResponse$zodSchema: z.ZodType<
+  PublicVisibilityOverviewResponse
+> = z.object({
+  by_platform: PublicVisibilityByPlatform$zodSchema,
+  company: PublicCompany$zodSchema,
+  competitors: z.array(PublicCompetitorRow$zodSchema).optional().describe(
+    "Competitor comparison rankings, including the primary company.",
+  ),
+  date_range: PublicVisibilityDateRange$zodSchema,
+  has_data: z.boolean().describe(
+    "Whether the selected date range contains visibility data.",
+  ),
+  snapshot: PublicVisibilitySnapshot$zodSchema,
+  timeseries: PublicVisibilityTimeseries$zodSchema,
+});

package/src/models/publicvisibilitysnapshot.ts

@@ -0,0 +1,41 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type PublicVisibilitySnapshot = {
+  visibility_score?: number | null | undefined;
+  visibility_score_rank?: number | null | undefined;
+  share_of_voice?: number | null | undefined;
+  share_of_voice_rank?: number | null | undefined;
+  average_position?: number | null | undefined;
+  average_position_rank?: number | null | undefined;
+  total_citations?: number | undefined;
+};
+
+export const PublicVisibilitySnapshot$zodSchema: z.ZodType<
+  PublicVisibilitySnapshot
+> = z.object({
+  average_position: z.number().nullable().optional().describe(
+    "Average mention position aggregated over the date range.",
+  ),
+  average_position_rank: z.int().nullable().optional().describe(
+    "Rank by average mention position among tracked companies.",
+  ),
+  share_of_voice: z.number().nullable().optional().describe(
+    "Share of voice aggregated over the date range, from 0 to 1.",
+  ),
+  share_of_voice_rank: z.int().nullable().optional().describe(
+    "Rank by share of voice among tracked companies.",
+  ),
+  total_citations: z.int().default(0).describe(
+    "Total owned-domain citations across all platforms in the range.",
+  ),
+  visibility_score: z.number().nullable().optional().describe(
+    "Visibility score aggregated over the date range, from 0 to 1.",
+  ),
+  visibility_score_rank: z.int().nullable().optional().describe(
+    "Rank by visibility score among tracked companies.",
+  ),
+});

package/src/models/publicvisibilitytimeseries.ts

@@ -0,0 +1,21 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  PublicSeriesPoint,
+  PublicSeriesPoint$zodSchema,
+} from "./publicseriespoint.js";
+
+export type PublicVisibilityTimeseries = {
+  visibility_score?: Array<PublicSeriesPoint> | undefined;
+};
+
+export const PublicVisibilityTimeseries$zodSchema: z.ZodType<
+  PublicVisibilityTimeseries
+> = z.object({
+  visibility_score: z.array(PublicSeriesPoint$zodSchema).optional().describe(
+    "Primary company visibility score over time.",
+  ),
+});

package/src/models/security.ts

@@ -0,0 +1,11 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type Security = { LightsageApiKeyAuth: string };
+
+export const Security$zodSchema: z.ZodType<Security> = z.object({
+  LightsageApiKeyAuth: z.string().describe("API Key"),
+});

package/src/models/taskslistop.ts

@@ -0,0 +1,69 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+import {
+  HTTPValidationError,
+  HTTPValidationError$zodSchema,
+} from "./httpvalidationerror.js";
+import {
+  ListTasksResponse,
+  ListTasksResponse$zodSchema,
+} from "./listtasksresponse.js";
+
+/**
+ * Which slice of the queue to return. The default active view returns todo/new and in-progress tasks. Use todo/new, in_progress, done, dismissed, completed, or all for a narrower or broader slice.
+ */
+export const TasksListStatus = {
+  Active: "active",
+  Todo: "todo",
+  New: "new",
+  InProgress: "in_progress",
+  Completed: "completed",
+  Done: "done",
+  Dismissed: "dismissed",
+  All: "all",
+} as const;
+/**
+ * Which slice of the queue to return. The default active view returns todo/new and in-progress tasks. Use todo/new, in_progress, done, dismissed, completed, or all for a narrower or broader slice.
+ */
+export type TasksListStatus = ClosedEnum<typeof TasksListStatus>;
+
+export const TasksListStatus$zodSchema = z.enum([
+  "active",
+  "todo",
+  "new",
+  "in_progress",
+  "completed",
+  "done",
+  "dismissed",
+  "all",
+]).describe(
+  "Which slice of the queue to return. The default active view returns todo/new and in-progress tasks. Use todo/new, in_progress, done, dismissed, completed, or all for a narrower or broader slice.",
+);
+
+export type TasksListRequest = {
+  action_date?: string | undefined;
+  status?: TasksListStatus | undefined;
+};
+
+export const TasksListRequest$zodSchema: z.ZodType<TasksListRequest> = z.object(
+  {
+    action_date: z.string().date().describe(
+      "Action-queue date to read (YYYY-MM-DD). Omit to read persisted tasks across all generation dates.",
+    ).optional(),
+    status: TasksListStatus$zodSchema.default("active").describe(
+      "Which slice of the queue to return. The default active view returns todo/new and in-progress tasks. Use todo/new, in_progress, done, dismissed, completed, or all for a narrower or broader slice.",
+    ),
+  },
+);
+
+export type TasksListResponse = ListTasksResponse | HTTPValidationError;
+
+export const TasksListResponse$zodSchema: z.ZodType<TasksListResponse> = z
+  .union([
+    ListTasksResponse$zodSchema,
+    HTTPValidationError$zodSchema,
+  ]);

package/src/models/tasksretrieveop.ts

@@ -0,0 +1,40 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  HTTPValidationError,
+  HTTPValidationError$zodSchema,
+} from "./httpvalidationerror.js";
+import { PublicTask, PublicTask$zodSchema } from "./publictask.js";
+
+export type TasksRetrieveRequest = { task_id: string };
+
+export const TasksRetrieveRequest$zodSchema: z.ZodType<TasksRetrieveRequest> = z
+  .object({
+    task_id: z.string(),
+  });
+
+/**
+ * The task does not exist or is not visible to this API key.
+ */
+export type TasksRetrieveResponseBody = { detail: string };
+
+export const TasksRetrieveResponseBody$zodSchema: z.ZodType<
+  TasksRetrieveResponseBody
+> = z.object({
+  detail: z.string(),
+}).describe("The task does not exist or is not visible to this API key.");
+
+export type TasksRetrieveResponse =
+  | PublicTask
+  | TasksRetrieveResponseBody
+  | HTTPValidationError;
+
+export const TasksRetrieveResponse$zodSchema: z.ZodType<TasksRetrieveResponse> =
+  z.union([
+    PublicTask$zodSchema,
+    z.lazy(() => TasksRetrieveResponseBody$zodSchema),
+    HTTPValidationError$zodSchema,
+  ]);

package/src/models/tasksupdateop.ts

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  HTTPValidationError,
+  HTTPValidationError$zodSchema,
+} from "./httpvalidationerror.js";
+import { PublicTask, PublicTask$zodSchema } from "./publictask.js";
+import {
+  UpdateTaskRequest,
+  UpdateTaskRequest$zodSchema,
+} from "./updatetaskrequest.js";
+
+export type TasksUpdateRequest = { task_id: string; body: UpdateTaskRequest };
+
+export const TasksUpdateRequest$zodSchema: z.ZodType<TasksUpdateRequest> = z
+  .object({
+    body: UpdateTaskRequest$zodSchema,
+    task_id: z.string(),
+  });
+
+/**
+ * The task does not exist or is not visible to this API key.
+ */
+export type TasksUpdateResponseBody = { detail: string };
+
+export const TasksUpdateResponseBody$zodSchema: z.ZodType<
+  TasksUpdateResponseBody
+> = z.object({
+  detail: z.string(),
+}).describe("The task does not exist or is not visible to this API key.");
+
+export type TasksUpdateResponse =
+  | PublicTask
+  | TasksUpdateResponseBody
+  | HTTPValidationError;
+
+export const TasksUpdateResponse$zodSchema: z.ZodType<TasksUpdateResponse> = z
+  .union([
+    PublicTask$zodSchema,
+    z.lazy(() => TasksUpdateResponseBody$zodSchema),
+    HTTPValidationError$zodSchema,
+  ]);

package/src/models/updateprompttopicrequest.ts

@@ -0,0 +1,13 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type UpdatePromptTopicRequest = { name: string };
+
+export const UpdatePromptTopicRequest$zodSchema: z.ZodType<
+  UpdatePromptTopicRequest
+> = z.object({
+  name: z.string(),
+});

package/src/models/updatepublicpromptrequest.ts

@@ -0,0 +1,21 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type UpdatePublicPromptRequest = {
+  text?: string | undefined;
+  topic_id?: string | undefined;
+  platform_ids?: Array<string> | null | undefined;
+  is_active?: boolean | undefined;
+};
+
+export const UpdatePublicPromptRequest$zodSchema: z.ZodType<
+  UpdatePublicPromptRequest
+> = z.object({
+  is_active: z.boolean().optional(),
+  platform_ids: z.array(z.string()).nullable().optional(),
+  text: z.string().optional(),
+  topic_id: z.string().optional(),
+});

package/src/models/updatetaskrequest.ts

@@ -0,0 +1,80 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+export const UpdateTaskRequestStatus = {
+  New: "new",
+  InProgress: "in_progress",
+  AddedToSheet: "added_to_sheet",
+  Done: "done",
+  Dismissed: "dismissed",
+  Snoozed: "snoozed",
+} as const;
+export type UpdateTaskRequestStatus = ClosedEnum<
+  typeof UpdateTaskRequestStatus
+>;
+
+export const UpdateTaskRequestStatus$zodSchema = z.enum([
+  "new",
+  "in_progress",
+  "added_to_sheet",
+  "done",
+  "dismissed",
+  "snoozed",
+]);
+
+export const Priority = {
+  Urgent: "urgent",
+  High: "high",
+  Medium: "medium",
+  Low: "low",
+} as const;
+export type Priority = ClosedEnum<typeof Priority>;
+
+export const Priority$zodSchema = z.enum([
+  "urgent",
+  "high",
+  "medium",
+  "low",
+]);
+
+export const ActionType = {
+  AgentDiscovery: "agent_discovery",
+  AgentUsability: "agent_usability",
+} as const;
+export type ActionType = ClosedEnum<typeof ActionType>;
+
+export const ActionType$zodSchema = z.enum([
+  "agent_discovery",
+  "agent_usability",
+]);
+
+/**
+ * Update the status and delegation of a single task.
+ *
+ * @remarks
+ *
+ * All fields are optional so status transitions and delegation can be changed
+ * independently. Only the fields present in the request body are changed;
+ * omitted fields are left unchanged. Setting `assignee_user_id` or
+ * `action_type` to `null` clears it. Send at least one field.
+ */
+export type UpdateTaskRequest = {
+  status?: UpdateTaskRequestStatus | undefined;
+  priority?: Priority | undefined;
+  assignee_user_id?: string | undefined;
+  action_type?: ActionType | undefined;
+};
+
+export const UpdateTaskRequest$zodSchema: z.ZodType<UpdateTaskRequest> = z
+  .object({
+    action_type: ActionType$zodSchema.optional(),
+    assignee_user_id: z.string().optional(),
+    priority: Priority$zodSchema.optional(),
+    status: UpdateTaskRequestStatus$zodSchema.optional(),
+  }).describe(
+    "Update the status and delegation of a single task.\n\nAll fields are optional so status transitions and delegation can be changed\nindependently. Only the fields present in the request body are changed;\nomitted fields are left unchanged. Setting `assignee_user_id` or\n`action_type` to `null` clears it. Send at least one field.",
+  );

package/src/models/validationerror.ts

@@ -0,0 +1,27 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type Loc = string | number;
+
+export const Loc$zodSchema: z.ZodType<Loc> = z.union([
+  z.string(),
+  z.int(),
+]);
+
+export type ValidationError = {
+  loc: Array<string | number>;
+  msg: string;
+  type: string;
+};
+
+export const ValidationError$zodSchema: z.ZodType<ValidationError> = z.object({
+  loc: z.array(z.union([
+    z.string(),
+    z.int(),
+  ])),
+  msg: z.string(),
+  type: z.string(),
+});

package/src/models/visibilitycurrentretrieveop.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 {
+  PublicCurrentVisibilityResponse,
+  PublicCurrentVisibilityResponse$zodSchema,
+} from "./publiccurrentvisibilityresponse.js";
+
+export type VisibilityCurrentRetrieveRequest = {
+  start_date?: string | undefined;
+  end_date?: string | undefined;
+};
+
+export const VisibilityCurrentRetrieveRequest$zodSchema: z.ZodType<
+  VisibilityCurrentRetrieveRequest
+> = 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 VisibilityCurrentRetrieveNotFoundResponseBody = { detail: string };
+
+export const VisibilityCurrentRetrieveNotFoundResponseBody$zodSchema: z.ZodType<
+  VisibilityCurrentRetrieveNotFoundResponseBody
+> = z.object({
+  detail: z.string(),
+}).describe("No configured company was found for this organization.");
+
+/**
+ * The requested date range is invalid.
+ */
+export type VisibilityCurrentRetrieveBadRequestResponseBody = {
+  detail: string;
+};
+
+export const VisibilityCurrentRetrieveBadRequestResponseBody$zodSchema:
+  z.ZodType<VisibilityCurrentRetrieveBadRequestResponseBody> = z.object({
+    detail: z.string(),
+  }).describe("The requested date range is invalid.");
+
+export type VisibilityCurrentRetrieveResponse =
+  | PublicCurrentVisibilityResponse
+  | VisibilityCurrentRetrieveBadRequestResponseBody
+  | VisibilityCurrentRetrieveNotFoundResponseBody
+  | HTTPValidationError;
+
+export const VisibilityCurrentRetrieveResponse$zodSchema: z.ZodType<
+  VisibilityCurrentRetrieveResponse
+> = z.union([
+  PublicCurrentVisibilityResponse$zodSchema,
+  z.lazy(() => VisibilityCurrentRetrieveBadRequestResponseBody$zodSchema),
+  z.lazy(() => VisibilityCurrentRetrieveNotFoundResponseBody$zodSchema),
+  HTTPValidationError$zodSchema,
+]);