@lightsage/mcp 0.1.7

package/src/models/publicpromptopportunity.ts

@@ -0,0 +1,62 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { collectExtraKeys as collectExtraKeys$ } from "../lib/schemas.js";
+
+export type PublicPromptOpportunity = {
+  id: string;
+  type: string;
+  category: string;
+  priority: string;
+  title: string;
+  description: string;
+  action: string;
+  execution_prompt: string;
+  impact_score: number;
+  created_at: string;
+  AdditionalProperties?: { [k: string]: any };
+};
+
+export const PublicPromptOpportunity$zodSchema: z.ZodType<
+  PublicPromptOpportunity
+> = collectExtraKeys$(
+  z.object({
+    action: z.string(),
+    category: z.string(),
+    created_at: z.string(),
+    description: z.string(),
+    execution_prompt: z.string().describe(
+      "Paste-ready instructions for an AI agent to address this opportunity.",
+    ),
+    id: z.string(),
+    impact_score: z.number(),
+    priority: z.string(),
+    title: z.string(),
+    type: z.string(),
+  }).catchall(z.any()),
+  "AdditionalProperties",
+  true,
+);
+
+export const PublicPromptOpportunity$zodSchemaOutbound: z.ZodType<any> = z
+  .object({
+    AdditionalProperties: z.record(z.string(), z.any()).optional(),
+    action: z.string(),
+    category: z.string(),
+    created_at: z.string(),
+    description: z.string(),
+    execution_prompt: z.string(),
+    id: z.string(),
+    impact_score: z.number(),
+    priority: z.string(),
+    title: z.string(),
+    type: z.string(),
+  }).transform((v) => {
+    const { AdditionalProperties, ...rest } = v;
+    return {
+      ...rest,
+      ...AdditionalProperties,
+    };
+  });

package/src/models/publicpromptplatform.ts

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

package/src/models/publicpromptplatformcatalogitem.ts

@@ -0,0 +1,21 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type PublicPromptPlatformCatalogItem = {
+  id: string;
+  name: string;
+  model?: string | null | undefined;
+  credits_per_prompt: number;
+};
+
+export const PublicPromptPlatformCatalogItem$zodSchema: z.ZodType<
+  PublicPromptPlatformCatalogItem
+> = z.object({
+  credits_per_prompt: z.int(),
+  id: z.string(),
+  model: z.string().nullable().optional(),
+  name: z.string(),
+});

package/src/models/publicpromptregion.ts

@@ -0,0 +1,18 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type PublicPromptRegion = {
+  id: string;
+  country: string;
+  country_code?: string | null | undefined;
+};
+
+export const PublicPromptRegion$zodSchema: z.ZodType<PublicPromptRegion> = z
+  .object({
+    country: z.string(),
+    country_code: z.string().nullable().optional(),
+    id: z.string(),
+  });

package/src/models/publicprompttag.ts

@@ -0,0 +1,19 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type PublicPromptTag = {
+  id: string;
+  name: string;
+  created_at?: string | null | undefined;
+  updated_at?: string | null | undefined;
+};
+
+export const PublicPromptTag$zodSchema: z.ZodType<PublicPromptTag> = z.object({
+  created_at: z.string().nullable().optional(),
+  id: z.string(),
+  name: z.string(),
+  updated_at: z.string().nullable().optional(),
+});

package/src/models/publicprompttopic.ts

@@ -0,0 +1,20 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type PublicPromptTopic = {
+  id: string;
+  name: string;
+  created_at?: string | null | undefined;
+  updated_at?: string | null | undefined;
+};
+
+export const PublicPromptTopic$zodSchema: z.ZodType<PublicPromptTopic> = z
+  .object({
+    created_at: z.string().nullable().optional(),
+    id: z.string(),
+    name: z.string(),
+    updated_at: z.string().nullable().optional(),
+  });

package/src/models/publicpromptvisibilitydaterange.ts

@@ -0,0 +1,25 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type PublicPromptVisibilityDateRange = {
+  start_date: string;
+  end_date: string;
+  latest_run_date?: string | null | undefined;
+  active_prompts_only?: boolean | undefined;
+};
+
+export const PublicPromptVisibilityDateRange$zodSchema: z.ZodType<
+  PublicPromptVisibilityDateRange
+> = 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."),
+  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/publicpromptvisibilitymetrics.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type PublicPromptVisibilityMetrics = {
+  visibility_score?: number | null | undefined;
+  visibility_score_rank?: number | null | undefined;
+  share_of_voice?: number | null | undefined;
+  average_position?: number | null | undefined;
+  citation_count?: number | undefined;
+  run_count?: number | undefined;
+};
+
+export const PublicPromptVisibilityMetrics$zodSchema: z.ZodType<
+  PublicPromptVisibilityMetrics
+> = z.object({
+  average_position: z.number().nullable().optional().describe(
+    "Average mention position aggregated over the date range.",
+  ),
+  citation_count: z.int().default(0).describe(
+    "Owned-domain citations found in prompt runs for the date range.",
+  ),
+  run_count: z.int().default(0).describe(
+    "Prompt runs included in the date-range calculation.",
+  ),
+  share_of_voice: z.number().nullable().optional().describe(
+    "Share of voice aggregated over the date range, from 0 to 1.",
+  ),
+  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/publicpromptvisibilityreportresponse.ts

@@ -0,0 +1,40 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { PublicCompany, PublicCompany$zodSchema } from "./publiccompany.js";
+import {
+  PublicPromptVisibilityDateRange,
+  PublicPromptVisibilityDateRange$zodSchema,
+} from "./publicpromptvisibilitydaterange.js";
+import {
+  PublicPromptVisibilitySummary,
+  PublicPromptVisibilitySummary$zodSchema,
+} from "./publicpromptvisibilitysummary.js";
+import {
+  PublicTopicVisibilityRow,
+  PublicTopicVisibilityRow$zodSchema,
+} from "./publictopicvisibilityrow.js";
+
+export type PublicPromptVisibilityReportResponse = {
+  company: PublicCompany;
+  date_range: PublicPromptVisibilityDateRange;
+  has_data: boolean;
+  summary: PublicPromptVisibilitySummary;
+  topics?: Array<PublicTopicVisibilityRow> | undefined;
+};
+
+export const PublicPromptVisibilityReportResponse$zodSchema: z.ZodType<
+  PublicPromptVisibilityReportResponse
+> = z.object({
+  company: PublicCompany$zodSchema,
+  date_range: PublicPromptVisibilityDateRange$zodSchema,
+  has_data: z.boolean().describe(
+    "Whether the selected date range contains prompt-run data.",
+  ),
+  summary: PublicPromptVisibilitySummary$zodSchema,
+  topics: z.array(PublicTopicVisibilityRow$zodSchema).optional().describe(
+    "Topic and prompt rows shown in the prompt visibility report.",
+  ),
+});

package/src/models/publicpromptvisibilityrow.ts

@@ -0,0 +1,23 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  PublicPromptVisibilityMetrics,
+  PublicPromptVisibilityMetrics$zodSchema,
+} from "./publicpromptvisibilitymetrics.js";
+
+export type PublicPromptVisibilityRow = {
+  id: string;
+  text: string;
+  metrics: PublicPromptVisibilityMetrics;
+};
+
+export const PublicPromptVisibilityRow$zodSchema: z.ZodType<
+  PublicPromptVisibilityRow
+> = z.object({
+  id: z.string().describe("Stable prompt identifier."),
+  metrics: PublicPromptVisibilityMetrics$zodSchema,
+  text: z.string().describe("Prompt text."),
+});

package/src/models/publicpromptvisibilitysummary.ts

@@ -0,0 +1,23 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  PublicPromptVisibilityMetrics,
+  PublicPromptVisibilityMetrics$zodSchema,
+} from "./publicpromptvisibilitymetrics.js";
+
+export type PublicPromptVisibilitySummary = {
+  prompt_count: number;
+  topic_count: number;
+  metrics: PublicPromptVisibilityMetrics;
+};
+
+export const PublicPromptVisibilitySummary$zodSchema: z.ZodType<
+  PublicPromptVisibilitySummary
+> = z.object({
+  metrics: PublicPromptVisibilityMetrics$zodSchema,
+  prompt_count: z.int().describe("Active prompts included in the report."),
+  topic_count: z.int().describe("Topics containing active prompts."),
+});

package/src/models/publicrefreshactionsrequest.ts

@@ -0,0 +1,17 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type PublicRefreshActionsRequest = {
+  source_id?: string | undefined;
+  force?: boolean | undefined;
+};
+
+export const PublicRefreshActionsRequest$zodSchema: z.ZodType<
+  PublicRefreshActionsRequest
+> = z.object({
+  force: z.boolean().default(false),
+  source_id: z.string().optional(),
+});

package/src/models/publicrefreshactionsresponse.ts

@@ -0,0 +1,21 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type PublicRefreshActionsResponse = {
+  generated: number;
+  updated: number;
+  unchanged: number;
+  total_candidates: number;
+};
+
+export const PublicRefreshActionsResponse$zodSchema: z.ZodType<
+  PublicRefreshActionsResponse
+> = z.object({
+  generated: z.int(),
+  total_candidates: z.int(),
+  unchanged: z.int(),
+  updated: z.int(),
+});

package/src/models/publicseriespoint.ts

@@ -0,0 +1,18 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type PublicSeriesPoint = {
+  date: string;
+  value?: number | null | undefined;
+};
+
+export const PublicSeriesPoint$zodSchema: z.ZodType<PublicSeriesPoint> = z
+  .object({
+    date: z.string().describe("Prompt-run date for this data point."),
+    value: z.number().nullable().optional().describe(
+      "Metric value on this date.",
+    ),
+  });

package/src/models/publicstartingproject.ts

@@ -0,0 +1,64 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+export const PublicStartingProjectFramework = {
+  Fastify: "fastify",
+  Nuxt: "nuxt",
+  Express: "express",
+  SpaJs: "spa-js",
+  Angular: "angular",
+  React: "react",
+  Fastapi: "fastapi",
+  Vite: "vite",
+  Nextjs: "nextjs",
+  Custom: "custom",
+} as const;
+export type PublicStartingProjectFramework = ClosedEnum<
+  typeof PublicStartingProjectFramework
+>;
+
+export const PublicStartingProjectFramework$zodSchema = z.enum([
+  "fastify",
+  "nuxt",
+  "express",
+  "spa-js",
+  "angular",
+  "react",
+  "fastapi",
+  "vite",
+  "nextjs",
+  "custom",
+]);
+
+export type PublicStartingProject = {
+  id: string;
+  source_id?: string | null | undefined;
+  name: string;
+  repo_url: string;
+  ref: string;
+  subdir?: string | undefined;
+  install_steps?: Array<string> | undefined;
+  framework?: PublicStartingProjectFramework | undefined;
+  enabled: boolean;
+  created_at?: string | null | undefined;
+  updated_at?: string | null | undefined;
+};
+
+export const PublicStartingProject$zodSchema: z.ZodType<PublicStartingProject> =
+  z.object({
+    created_at: z.string().nullable().optional(),
+    enabled: z.boolean(),
+    framework: PublicStartingProjectFramework$zodSchema.default("custom"),
+    id: z.string(),
+    install_steps: z.array(z.string()).optional(),
+    name: z.string(),
+    ref: z.string(),
+    repo_url: z.string(),
+    source_id: z.string().nullable().optional(),
+    subdir: z.string().default(""),
+    updated_at: z.string().nullable().optional(),
+  });

package/src/models/publicstartingprojectrequest.ts

@@ -0,0 +1,59 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+export const PublicStartingProjectRequestFramework = {
+  Fastify: "fastify",
+  Nuxt: "nuxt",
+  Express: "express",
+  SpaJs: "spa-js",
+  Angular: "angular",
+  React: "react",
+  Fastapi: "fastapi",
+  Vite: "vite",
+  Nextjs: "nextjs",
+  Custom: "custom",
+} as const;
+export type PublicStartingProjectRequestFramework = ClosedEnum<
+  typeof PublicStartingProjectRequestFramework
+>;
+
+export const PublicStartingProjectRequestFramework$zodSchema = z.enum([
+  "fastify",
+  "nuxt",
+  "express",
+  "spa-js",
+  "angular",
+  "react",
+  "fastapi",
+  "vite",
+  "nextjs",
+  "custom",
+]);
+
+export type PublicStartingProjectRequest = {
+  name: string;
+  repo_url: string;
+  ref?: string | undefined;
+  subdir?: string | undefined;
+  install_steps?: Array<string> | undefined;
+  source_id?: string | undefined;
+  framework?: PublicStartingProjectRequestFramework | undefined;
+  enabled?: boolean | undefined;
+};
+
+export const PublicStartingProjectRequest$zodSchema: z.ZodType<
+  PublicStartingProjectRequest
+> = z.object({
+  enabled: z.boolean().default(true),
+  framework: PublicStartingProjectRequestFramework$zodSchema.default("custom"),
+  install_steps: z.array(z.string()).optional(),
+  name: z.string(),
+  ref: z.string().default("main"),
+  repo_url: z.string(),
+  source_id: z.string().optional(),
+  subdir: z.string().default(""),
+});

package/src/models/publicstartingprojectsresponse.ts

@@ -0,0 +1,21 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  PublicStartingProject,
+  PublicStartingProject$zodSchema,
+} from "./publicstartingproject.js";
+
+export type PublicStartingProjectsResponse = {
+  data: Array<PublicStartingProject>;
+  meta?: { [k: string]: any } | undefined;
+};
+
+export const PublicStartingProjectsResponse$zodSchema: z.ZodType<
+  PublicStartingProjectsResponse
+> = z.object({
+  data: z.array(PublicStartingProject$zodSchema),
+  meta: z.record(z.string(), z.any()).optional(),
+});

package/src/models/publicstartingprojectupdaterequest.ts

@@ -0,0 +1,59 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+export const PublicStartingProjectUpdateRequestFramework = {
+  Fastify: "fastify",
+  Nuxt: "nuxt",
+  Express: "express",
+  SpaJs: "spa-js",
+  Angular: "angular",
+  React: "react",
+  Fastapi: "fastapi",
+  Vite: "vite",
+  Nextjs: "nextjs",
+  Custom: "custom",
+} as const;
+export type PublicStartingProjectUpdateRequestFramework = ClosedEnum<
+  typeof PublicStartingProjectUpdateRequestFramework
+>;
+
+export const PublicStartingProjectUpdateRequestFramework$zodSchema = z.enum([
+  "fastify",
+  "nuxt",
+  "express",
+  "spa-js",
+  "angular",
+  "react",
+  "fastapi",
+  "vite",
+  "nextjs",
+  "custom",
+]);
+
+export type PublicStartingProjectUpdateRequest = {
+  name?: string | undefined;
+  repo_url?: string | undefined;
+  ref?: string | undefined;
+  subdir?: string | undefined;
+  install_steps?: Array<string> | null | undefined;
+  source_id?: string | undefined;
+  framework?: PublicStartingProjectUpdateRequestFramework | undefined;
+  enabled?: boolean | undefined;
+};
+
+export const PublicStartingProjectUpdateRequest$zodSchema: z.ZodType<
+  PublicStartingProjectUpdateRequest
+> = z.object({
+  enabled: z.boolean().optional(),
+  framework: PublicStartingProjectUpdateRequestFramework$zodSchema.optional(),
+  install_steps: z.array(z.string()).nullable().optional(),
+  name: z.string().optional(),
+  ref: z.string().optional(),
+  repo_url: z.string().optional(),
+  source_id: z.string().optional(),
+  subdir: z.string().optional(),
+});

package/src/models/publictask.ts

@@ -0,0 +1,112 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { collectExtraKeys as collectExtraKeys$ } from "../lib/schemas.js";
+
+/**
+ * A single persisted daily task in the public contract shape.
+ */
+export type PublicTask = {
+  id: string;
+  action_date: string;
+  batch_number: number;
+  rank: number;
+  source_key: string;
+  task_type: string;
+  title: string;
+  why: string;
+  next_action: string;
+  description?: string | null | undefined;
+  execution_prompt: string;
+  reasoning?: string | null | undefined;
+  evidence?: { [k: string]: any } | undefined;
+  score: number;
+  effort: string;
+  priority?: string | null | undefined;
+  status: string;
+  assignee_user_id?: string | null | undefined;
+  function_area?: string | null | undefined;
+  action_type?: string | null | undefined;
+  source?: string | null | undefined;
+  source_type: string;
+  source_refs?: { [k: string]: any } | undefined;
+  metadata?: { [k: string]: any } | undefined;
+  created_at?: string | null | undefined;
+  updated_at?: string | null | undefined;
+  AdditionalProperties?: { [k: string]: any };
+};
+
+export const PublicTask$zodSchema: z.ZodType<PublicTask> = collectExtraKeys$(
+  z.object({
+    action_date: z.string(),
+    action_type: z.string().nullable().optional(),
+    assignee_user_id: z.string().nullable().optional(),
+    batch_number: z.int(),
+    created_at: z.string().nullable().optional(),
+    description: z.string().nullable().optional(),
+    effort: z.string(),
+    evidence: z.record(z.string(), z.any()).optional(),
+    execution_prompt: z.string().describe(
+      "Paste-ready instructions for an AI agent to execute this task.",
+    ),
+    function_area: z.string().nullable().optional(),
+    id: z.string(),
+    metadata: z.record(z.string(), z.any()).optional(),
+    next_action: z.string(),
+    priority: z.string().nullable().optional(),
+    rank: z.int(),
+    reasoning: z.string().nullable().optional(),
+    score: z.number(),
+    source: z.string().nullable().optional(),
+    source_key: z.string(),
+    source_refs: z.record(z.string(), z.any()).optional(),
+    source_type: z.string(),
+    status: z.string(),
+    task_type: z.string(),
+    title: z.string(),
+    updated_at: z.string().nullable().optional(),
+    why: z.string(),
+  }).describe("A single persisted daily task in the public contract shape.")
+    .catchall(z.any()),
+  "AdditionalProperties",
+  true,
+);
+
+export const PublicTask$zodSchemaOutbound: z.ZodType<any> = z.object({
+  AdditionalProperties: z.record(z.string(), z.any()).optional(),
+  action_date: z.string(),
+  action_type: z.nullable(z.string()).optional(),
+  assignee_user_id: z.nullable(z.string()).optional(),
+  batch_number: z.int(),
+  created_at: z.nullable(z.string()).optional(),
+  description: z.nullable(z.string()).optional(),
+  effort: z.string(),
+  evidence: z.record(z.string(), z.any()).optional(),
+  execution_prompt: z.string(),
+  function_area: z.nullable(z.string()).optional(),
+  id: z.string(),
+  metadata: z.record(z.string(), z.any()).optional(),
+  next_action: z.string(),
+  priority: z.nullable(z.string()).optional(),
+  rank: z.int(),
+  reasoning: z.nullable(z.string()).optional(),
+  score: z.number(),
+  source: z.nullable(z.string()).optional(),
+  source_key: z.string(),
+  source_refs: z.record(z.string(), z.any()).optional(),
+  source_type: z.string(),
+  status: z.string(),
+  task_type: z.string(),
+  title: z.string(),
+  updated_at: z.nullable(z.string()).optional(),
+  why: z.string(),
+}).describe("A single persisted daily task in the public contract shape.")
+  .transform((v) => {
+    const { AdditionalProperties, ...rest } = v;
+    return {
+      ...rest,
+      ...AdditionalProperties,
+    };
+  });