@lightsage/mcp 0.4.16 → 0.4.18

package/src/models/createtaskrequest.ts

@@ -0,0 +1,98 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 1f765de65bb3
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+export const TaskType = {
+  Create: "Create",
+  Refresh: "Refresh",
+  WinBack: "Win back",
+  Outreach: "Outreach",
+  Community: "Community",
+  Docs: "Docs",
+  Redirect: "Redirect",
+} as const;
+export type TaskType = ClosedEnum<typeof TaskType>;
+
+export const TaskType$zodSchema = z.enum([
+  "Create",
+  "Refresh",
+  "Win back",
+  "Outreach",
+  "Community",
+  "Docs",
+  "Redirect",
+]);
+
+export const Effort = {
+  Low: "Low",
+  Medium: "Medium",
+  High: "High",
+} as const;
+export type Effort = ClosedEnum<typeof Effort>;
+
+export const Effort$zodSchema = z.enum([
+  "Low",
+  "Medium",
+  "High",
+]);
+
+export const CreateTaskRequestPriority = {
+  Urgent: "urgent",
+  High: "high",
+  Medium: "medium",
+  Low: "low",
+} as const;
+export type CreateTaskRequestPriority = ClosedEnum<
+  typeof CreateTaskRequestPriority
+>;
+
+export const CreateTaskRequestPriority$zodSchema = z.enum([
+  "urgent",
+  "high",
+  "medium",
+  "low",
+]);
+
+export const CreateTaskRequestActionType = {
+  AgentDiscovery: "agent_discovery",
+  AgentUsability: "agent_usability",
+} as const;
+export type CreateTaskRequestActionType = ClosedEnum<
+  typeof CreateTaskRequestActionType
+>;
+
+export const CreateTaskRequestActionType$zodSchema = z.enum([
+  "agent_discovery",
+  "agent_usability",
+]);
+
+export type CreateTaskRequest = {
+  title: string;
+  description?: string | undefined;
+  task_type?: TaskType | undefined;
+  effort?: Effort | undefined;
+  priority?: CreateTaskRequestPriority | undefined;
+  action_type?: CreateTaskRequestActionType | undefined;
+  assignee_user_id?: string | undefined;
+};
+
+export const CreateTaskRequest$zodSchema: z.ZodType<CreateTaskRequest> = z
+  .object({
+    action_type: CreateTaskRequestActionType$zodSchema.default(
+      "agent_discovery",
+    ),
+    assignee_user_id: z.string().optional().describe(
+      "A member of your organization to assign the task to. They are emailed unless they have turned off task notifications.",
+    ),
+    description: z.string().optional().describe(
+      "A Markdown description of what to do and why.",
+    ),
+    effort: Effort$zodSchema.default("Medium"),
+    priority: CreateTaskRequestPriority$zodSchema.default("medium"),
+    task_type: TaskType$zodSchema.default("Create"),
+    title: z.string(),
+  });

package/src/models/createv2promptrequest.ts

@@ -19,7 +19,7 @@ export type CreateV2PromptRequest = {
 export const CreateV2PromptRequest$zodSchema: z.ZodType<CreateV2PromptRequest> =
   z.object({
     platform_ids: z.array(z.string()).optional().describe(
-      "Answer-platform IDs from the prompt configuration. Omit to attach none.",
+      "Platform IDs, as returned in `platforms` on `GET /v2/prompts`. Omit to attach none. To choose which coding-agent models a run uses, pass `agent` to `POST /v2/prompts/runs`.",
     ),
     run_settings: V2PromptRunSettingsInput$zodSchema.nullable().optional()
       .describe(

package/src/models/createv2promptrunrequest.ts

@@ -7,14 +7,18 @@ import * as z from "zod";
 
 export type CreateV2PromptRunRequest = {
   prompt_ids?: Array<string> | null | undefined;
+  agent?: Array<string> | null | undefined;
   force?: boolean | undefined;
 };
 
 export const CreateV2PromptRunRequest$zodSchema: z.ZodType<
   CreateV2PromptRunRequest
 > = z.object({
+  agent: z.array(z.string()).nullable().optional().describe(
+    "Runnable agents from `GET /v2/agents`, each a coding-agent harness and model such as `claude-code:claude-opus-5-5`. Every selected prompt runs once on each agent, so you can compare how several coding tools and models answer the same question. When set, this run uses only these agents instead of the organization's configured targets, including answer engines. Omit it to use the configured targets. CLI clients expose repeatable `--agent`.",
+  ),
   force: z.boolean().default(false).describe(
-    "Run even when a prompt already ran today on the configured platform and model.",
+    "Run even when a prompt already ran today on the same 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/graderdefinition.ts

@@ -29,6 +29,7 @@ export type GraderDefinition = {
   criteria?: string | null | undefined;
   metric?: Metric | null | undefined;
   min_score?: number | null | undefined;
+  max_value?: number | null | undefined;
   weight?: number | undefined;
   blocking?: boolean | undefined;
 };
@@ -40,6 +41,7 @@ export const GraderDefinition$zodSchema: z.ZodType<GraderDefinition> = z.object(
     ),
     case_sensitive: z.boolean().default(false),
     criteria: z.string().nullable().optional(),
+    max_value: z.number().nullable().optional(),
     metric: Metric$zodSchema.nullable().optional(),
     min_score: z.number().nullable().optional(),
     name: z.string(),

package/src/models/publicagentanalyticscountrylistresponse.ts

@@ -0,0 +1,36 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 86f3c9d1075f
+ */
+
+import * as z from "zod";
+import {
+  PublicAgentCountry,
+  PublicAgentCountry$zodSchema,
+} from "./publicagentcountry.js";
+import {
+  PublicResolvedPeriod,
+  PublicResolvedPeriod$zodSchema,
+} from "./publicresolvedperiod.js";
+
+export type PublicAgentAnalyticsCountryListResponse = {
+  site_id: string;
+  start_date: string;
+  end_date: string;
+  period?: PublicResolvedPeriod | null | undefined;
+  countries?: Array<PublicAgentCountry> | undefined;
+};
+
+export const PublicAgentAnalyticsCountryListResponse$zodSchema: z.ZodType<
+  PublicAgentAnalyticsCountryListResponse
+> = z.object({
+  countries: z.array(PublicAgentCountry$zodSchema).optional().describe(
+    "Visits from coding agents and AI assistants per country, most visits first. The country is located from the IP address the request came from. For hosted assistants such as ChatGPT that is usually the provider's servers, not the person who asked; for coding agents it is usually the developer's machine.",
+  ),
+  end_date: z.string().date(),
+  period: PublicResolvedPeriod$zodSchema.nullable().optional().describe(
+    "The resolved period and the previous period it is compared with.",
+  ),
+  site_id: z.string(),
+  start_date: z.string().date(),
+});

package/src/models/publicagentanalyticserrorpagelistresponse.ts

@@ -0,0 +1,40 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: add3275aa752
+ */
+
+import * as z from "zod";
+import {
+  PublicAgentErrorPage,
+  PublicAgentErrorPage$zodSchema,
+} from "./publicagenterrorpage.js";
+import {
+  PublicResolvedPeriod,
+  PublicResolvedPeriod$zodSchema,
+} from "./publicresolvedperiod.js";
+
+export type PublicAgentAnalyticsErrorPageListResponse = {
+  site_id: string;
+  start_date: string;
+  end_date: string;
+  period?: PublicResolvedPeriod | null | undefined;
+  status_codes_tracked: boolean;
+  pages?: Array<PublicAgentErrorPage> | undefined;
+};
+
+export const PublicAgentAnalyticsErrorPageListResponse$zodSchema: z.ZodType<
+  PublicAgentAnalyticsErrorPageListResponse
+> = z.object({
+  end_date: z.string().date(),
+  pages: z.array(PublicAgentErrorPage$zodSchema).optional().describe(
+    "Most error requests first.",
+  ),
+  period: PublicResolvedPeriod$zodSchema.nullable().optional().describe(
+    "The resolved period and the previous period it is compared with.",
+  ),
+  site_id: z.string(),
+  start_date: z.string().date(),
+  status_codes_tracked: z.boolean().describe(
+    "Whether any request to the site in the date range reported a status code. Status codes come from server-side tracking such as a log drain or middleware; when this is false, an empty `pages` list does not mean there were no errors.",
+  ),
+});

package/src/models/publicagentanalyticspagelistresponse.ts

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 3c92a38d9c87
+ */
+
+import * as z from "zod";
+import {
+  PublicAgentTrafficPage,
+  PublicAgentTrafficPage$zodSchema,
+} from "./publicagenttrafficpage.js";
+import {
+  PublicResolvedPeriod,
+  PublicResolvedPeriod$zodSchema,
+} from "./publicresolvedperiod.js";
+
+export type PublicAgentAnalyticsPageListResponse = {
+  site_id: string;
+  start_date: string;
+  end_date: string;
+  period?: PublicResolvedPeriod | null | undefined;
+  agent?: string | null | undefined;
+  pages?: Array<PublicAgentTrafficPage> | undefined;
+};
+
+export const PublicAgentAnalyticsPageListResponse$zodSchema: z.ZodType<
+  PublicAgentAnalyticsPageListResponse
+> = z.object({
+  agent: z.string().nullable().optional().describe(
+    "The coding agent the pages were filtered to, when `agent` was set. Its visits are in `coding` and `ai_total`; the other counts are 0.",
+  ),
+  end_date: z.string().date(),
+  pages: z.array(PublicAgentTrafficPage$zodSchema).optional(),
+  period: PublicResolvedPeriod$zodSchema.nullable().optional().describe(
+    "The resolved period and the previous period it is compared with.",
+  ),
+  site_id: z.string(),
+  start_date: z.string().date(),
+});

package/src/models/publicagentanalyticssite.ts

@@ -0,0 +1,26 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 89d624aea6b6
+ */
+
+import * as z from "zod";
+
+export type PublicAgentAnalyticsSite = {
+  site_id: string;
+  domain: string;
+  source?: string | null | undefined;
+  created_at?: string | null | undefined;
+};
+
+export const PublicAgentAnalyticsSite$zodSchema: z.ZodType<
+  PublicAgentAnalyticsSite
+> = z.object({
+  created_at: z.string().nullable().optional().describe(
+    "When the first tracked visit created the site.",
+  ),
+  domain: z.string(),
+  site_id: z.string(),
+  source: z.string().nullable().optional().describe(
+    "Kind of site: `website`, `docs`, `app`, or `blog`.",
+  ),
+});

package/src/models/publicagentanalyticssitelistresponse.ts

@@ -0,0 +1,20 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 3e8ea7d7a375
+ */
+
+import * as z from "zod";
+import {
+  PublicAgentAnalyticsSite,
+  PublicAgentAnalyticsSite$zodSchema,
+} from "./publicagentanalyticssite.js";
+
+export type PublicAgentAnalyticsSiteListResponse = {
+  sites?: Array<PublicAgentAnalyticsSite> | undefined;
+};
+
+export const PublicAgentAnalyticsSiteListResponse$zodSchema: z.ZodType<
+  PublicAgentAnalyticsSiteListResponse
+> = z.object({
+  sites: z.array(PublicAgentAnalyticsSite$zodSchema).optional(),
+});

package/src/models/publicagentanalyticssourcelistresponse.ts

@@ -0,0 +1,36 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 10a8263b1d4c
+ */
+
+import * as z from "zod";
+import {
+  PublicAgentTrafficSource,
+  PublicAgentTrafficSource$zodSchema,
+} from "./publicagenttrafficsource.js";
+import {
+  PublicResolvedPeriod,
+  PublicResolvedPeriod$zodSchema,
+} from "./publicresolvedperiod.js";
+
+export type PublicAgentAnalyticsSourceListResponse = {
+  site_id: string;
+  start_date: string;
+  end_date: string;
+  period?: PublicResolvedPeriod | null | undefined;
+  sources?: Array<PublicAgentTrafficSource> | undefined;
+};
+
+export const PublicAgentAnalyticsSourceListResponse$zodSchema: z.ZodType<
+  PublicAgentAnalyticsSourceListResponse
+> = z.object({
+  end_date: z.string().date(),
+  period: PublicResolvedPeriod$zodSchema.nullable().optional().describe(
+    "The resolved period and the previous period it is compared with.",
+  ),
+  site_id: z.string(),
+  sources: z.array(PublicAgentTrafficSource$zodSchema).optional().describe(
+    "Most visits first.",
+  ),
+  start_date: z.string().date(),
+});

package/src/models/publicagentanalyticssummary.ts

@@ -0,0 +1,36 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 6705efe0cd12
+ */
+
+import * as z from "zod";
+import {
+  PublicAgentTrafficTotals,
+  PublicAgentTrafficTotals$zodSchema,
+} from "./publicagenttraffictotals.js";
+import {
+  PublicResolvedPeriod,
+  PublicResolvedPeriod$zodSchema,
+} from "./publicresolvedperiod.js";
+
+export type PublicAgentAnalyticsSummary = {
+  site_id: string;
+  start_date: string;
+  end_date: string;
+  period?: PublicResolvedPeriod | null | undefined;
+  current: PublicAgentTrafficTotals;
+  previous: PublicAgentTrafficTotals;
+};
+
+export const PublicAgentAnalyticsSummary$zodSchema: z.ZodType<
+  PublicAgentAnalyticsSummary
+> = z.object({
+  current: PublicAgentTrafficTotals$zodSchema,
+  end_date: z.string().date(),
+  period: PublicResolvedPeriod$zodSchema.nullable().optional().describe(
+    "The resolved period and the previous period it is compared with.",
+  ),
+  previous: PublicAgentTrafficTotals$zodSchema,
+  site_id: z.string(),
+  start_date: z.string().date(),
+});

package/src/models/publicagentcountry.ts

@@ -0,0 +1,16 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: d45f08c86764
+ */
+
+import * as z from "zod";
+
+export type PublicAgentCountry = { country: string; visits: number };
+
+export const PublicAgentCountry$zodSchema: z.ZodType<PublicAgentCountry> = z
+  .object({
+    country: z.string().describe(
+      "Two-letter ISO country code of the request, or `unknown`.",
+    ),
+    visits: z.int(),
+  });

package/src/models/publicagenterrorpage.ts

@@ -0,0 +1,35 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b42d4a9d83b6
+ */
+
+import * as z from "zod";
+import {
+  PublicAgentErrorSource,
+  PublicAgentErrorSource$zodSchema,
+} from "./publicagenterrorsource.js";
+
+export type PublicAgentErrorPage = {
+  path: string;
+  status_code: number;
+  visits: number;
+  ai_visits: number;
+  last_seen?: string | null | undefined;
+  sources?: Array<PublicAgentErrorSource> | undefined;
+};
+
+export const PublicAgentErrorPage$zodSchema: z.ZodType<PublicAgentErrorPage> = z
+  .object({
+    ai_visits: z.int().describe(
+      "Of `visits`, those from coding agents and AI bots.",
+    ),
+    last_seen: z.string().nullable().optional().describe(
+      "Time of the latest error.",
+    ),
+    path: z.string(),
+    sources: z.array(PublicAgentErrorSource$zodSchema).optional().describe(
+      "Who got the error, most requests first.",
+    ),
+    status_code: z.int().describe("HTTP status returned, such as 404."),
+    visits: z.int().describe("Requests to this path that got this status."),
+  });

package/src/models/publicagenterrorsource.ts

@@ -0,0 +1,63 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 3682193b0636
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+export const PublicAgentErrorSourceKind = {
+  Agent: "agent",
+  Bot: "bot",
+  Other: "other",
+  People: "people",
+} as const;
+export type PublicAgentErrorSourceKind = ClosedEnum<
+  typeof PublicAgentErrorSourceKind
+>;
+
+export const PublicAgentErrorSourceKind$zodSchema = z.enum([
+  "agent",
+  "bot",
+  "other",
+  "people",
+]);
+
+export const PublicAgentErrorSourceType = {
+  Coding: "coding",
+  User: "user",
+  Search: "search",
+  Training: "training",
+  Other: "other",
+  People: "people",
+} as const;
+export type PublicAgentErrorSourceType = ClosedEnum<
+  typeof PublicAgentErrorSourceType
+>;
+
+export const PublicAgentErrorSourceType$zodSchema = z.enum([
+  "coding",
+  "user",
+  "search",
+  "training",
+  "other",
+  "people",
+]);
+
+export type PublicAgentErrorSource = {
+  name: string;
+  kind: PublicAgentErrorSourceKind;
+  type: PublicAgentErrorSourceType;
+  visits: number;
+};
+
+export const PublicAgentErrorSource$zodSchema: z.ZodType<
+  PublicAgentErrorSource
+> = z.object({
+  kind: PublicAgentErrorSourceKind$zodSchema,
+  name: z.string().describe(
+    "Agent or bot name, as in the traffic sources list, or `people`.",
+  ),
+  type: PublicAgentErrorSourceType$zodSchema,
+  visits: z.int().describe("Requests from this source that got the error."),
+});

package/src/models/publicagenttrafficpage.ts

@@ -0,0 +1,46 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 017b350c494c
+ */
+
+import * as z from "zod";
+
+export type PublicAgentTrafficPage = {
+  path: string;
+  coding: number;
+  user: number;
+  search: number;
+  training: number;
+  other: number;
+  people: number;
+  ai_total: number;
+  last_seen?: string | null | undefined;
+};
+
+export const PublicAgentTrafficPage$zodSchema: z.ZodType<
+  PublicAgentTrafficPage
+> = z.object({
+  ai_total: z.int().describe(
+    "Sum of `coding`, `user`, `search`, and `training` visits.",
+  ),
+  coding: z.int().describe(
+    "Visits from coding agents such as Claude Code, Codex, and Cursor.",
+  ),
+  last_seen: z.string().nullable().optional().describe(
+    "Day of the latest visit, in `YYYY-MM-DD` format.",
+  ),
+  other: z.int().describe(
+    "Visits from bots with no AI purpose, such as search engine crawlers.",
+  ),
+  path: z.string(),
+  people: z.int().describe("Visits from people."),
+  search: z.int().describe(
+    "Visits from AI search indexers such as OAI-SearchBot.",
+  ),
+  training: z.int().describe(
+    "Visits from AI training crawlers such as GPTBot.",
+  ),
+  user: z.int().describe(
+    "Visits from AI assistants fetching a page because a user asked, such as ChatGPT-User.",
+  ),
+});

package/src/models/publicagenttrafficsource.ts

@@ -0,0 +1,77 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 1c02f8d2cfe9
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * `agent` for coding agents, `bot` for AI bots, `other` for bots with no AI purpose, and `people` for all human visits as one row.
+ */
+export const PublicAgentTrafficSourceKind = {
+  Agent: "agent",
+  Bot: "bot",
+  Other: "other",
+  People: "people",
+} as const;
+/**
+ * `agent` for coding agents, `bot` for AI bots, `other` for bots with no AI purpose, and `people` for all human visits as one row.
+ */
+export type PublicAgentTrafficSourceKind = ClosedEnum<
+  typeof PublicAgentTrafficSourceKind
+>;
+
+export const PublicAgentTrafficSourceKind$zodSchema = z.enum([
+  "agent",
+  "bot",
+  "other",
+  "people",
+]).describe(
+  "`agent` for coding agents, `bot` for AI bots, `other` for bots with no AI purpose, and `people` for all human visits as one row.",
+);
+
+export const PublicAgentTrafficSourceType = {
+  Coding: "coding",
+  User: "user",
+  Search: "search",
+  Training: "training",
+  Other: "other",
+  People: "people",
+} as const;
+export type PublicAgentTrafficSourceType = ClosedEnum<
+  typeof PublicAgentTrafficSourceType
+>;
+
+export const PublicAgentTrafficSourceType$zodSchema = z.enum([
+  "coding",
+  "user",
+  "search",
+  "training",
+  "other",
+  "people",
+]);
+
+export type PublicAgentTrafficSource = {
+  name: string;
+  kind: PublicAgentTrafficSourceKind;
+  provider?: string | null | undefined;
+  type: PublicAgentTrafficSourceType;
+  visits: number;
+};
+
+export const PublicAgentTrafficSource$zodSchema: z.ZodType<
+  PublicAgentTrafficSource
+> = z.object({
+  kind: PublicAgentTrafficSourceKind$zodSchema.describe(
+    "`agent` for coding agents, `bot` for AI bots, `other` for bots with no AI purpose, and `people` for all human visits as one row.",
+  ),
+  name: z.string().describe(
+    "Agent or bot name, such as `claude-code` or `GPTBot`.",
+  ),
+  provider: z.string().nullable().optional().describe(
+    "Company that runs the bot.",
+  ),
+  type: PublicAgentTrafficSourceType$zodSchema,
+  visits: z.int(),
+});

package/src/models/publicagenttraffictotals.ts

@@ -0,0 +1,42 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: e4e90b5419e7
+ */
+
+import * as z from "zod";
+
+export type PublicAgentTrafficTotals = {
+  coding: number;
+  user: number;
+  search: number;
+  training: number;
+  other: number;
+  people: number;
+  ai_total: number;
+  total: number;
+};
+
+export const PublicAgentTrafficTotals$zodSchema: z.ZodType<
+  PublicAgentTrafficTotals
+> = z.object({
+  ai_total: z.int().describe(
+    "Sum of `coding`, `user`, `search`, and `training` visits.",
+  ),
+  coding: z.int().describe(
+    "Visits from coding agents such as Claude Code, Codex, and Cursor.",
+  ),
+  other: z.int().describe(
+    "Visits from bots with no AI purpose, such as search engine crawlers.",
+  ),
+  people: z.int().describe("Visits from people."),
+  search: z.int().describe(
+    "Visits from AI search indexers such as OAI-SearchBot.",
+  ),
+  total: z.int().describe("Every visit, AI or not."),
+  training: z.int().describe(
+    "Visits from AI training crawlers such as GPTBot.",
+  ),
+  user: z.int().describe(
+    "Visits from AI assistants fetching a page because a user asked, such as ChatGPT-User.",
+  ),
+});