@lightsage/mcp 0.4.16 → 0.4.17

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.",
+  ),
+});

package/src/models/updatetaskrequest.ts

@@ -35,44 +35,48 @@ export const UpdateTaskRequestStatus$zodSchema = z.enum([
   "The new task status. `added_to_sheet` and `snoozed` tasks are listed only when `status=all`.",
 );
 
-export const Priority = {
+export const UpdateTaskRequestPriority = {
   Urgent: "urgent",
   High: "high",
   Medium: "medium",
   Low: "low",
 } as const;
-export type Priority = ClosedEnum<typeof Priority>;
+export type UpdateTaskRequestPriority = ClosedEnum<
+  typeof UpdateTaskRequestPriority
+>;
 
-export const Priority$zodSchema = z.enum([
+export const UpdateTaskRequestPriority$zodSchema = z.enum([
   "urgent",
   "high",
   "medium",
   "low",
 ]);
 
-export const ActionType = {
+export const UpdateTaskRequestActionType = {
   AgentDiscovery: "agent_discovery",
   AgentUsability: "agent_usability",
 } as const;
-export type ActionType = ClosedEnum<typeof ActionType>;
+export type UpdateTaskRequestActionType = ClosedEnum<
+  typeof UpdateTaskRequestActionType
+>;
 
-export const ActionType$zodSchema = z.enum([
+export const UpdateTaskRequestActionType$zodSchema = z.enum([
   "agent_discovery",
   "agent_usability",
 ]);
 
 export type UpdateTaskRequest = {
   status?: UpdateTaskRequestStatus | undefined;
-  priority?: Priority | undefined;
+  priority?: UpdateTaskRequestPriority | undefined;
   assignee_user_id?: string | undefined;
-  action_type?: ActionType | undefined;
+  action_type?: UpdateTaskRequestActionType | undefined;
 };
 
 export const UpdateTaskRequest$zodSchema: z.ZodType<UpdateTaskRequest> = z
   .object({
-    action_type: ActionType$zodSchema.optional(),
+    action_type: UpdateTaskRequestActionType$zodSchema.optional(),
     assignee_user_id: z.string().optional(),
-    priority: Priority$zodSchema.optional(),
+    priority: UpdateTaskRequestPriority$zodSchema.optional(),
     status: UpdateTaskRequestStatus$zodSchema.optional().describe(
       "The new task status. `added_to_sheet` and `snoozed` tasks are listed only when `status=all`.",
     ),

package/src/models/v2agentanalyticscountrieslistop.ts

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: c96ad2487ae4
+ */
+
+import * as z from "zod";
+import {
+  HTTPValidationError,
+  HTTPValidationError$zodSchema,
+} from "./httpvalidationerror.js";
+import {
+  PublicAgentAnalyticsCountryListResponse,
+  PublicAgentAnalyticsCountryListResponse$zodSchema,
+} from "./publicagentanalyticscountrylistresponse.js";
+
+export type V2AgentAnalyticsCountriesListRequest = {
+  site_id: string;
+  start_date?: string | undefined;
+  end_date?: string | undefined;
+  limit?: number | undefined;
+};
+
+export const V2AgentAnalyticsCountriesListRequest$zodSchema: z.ZodType<
+  V2AgentAnalyticsCountriesListRequest
+> = z.object({
+  end_date: z.string().date().describe(
+    "Inclusive range end in UTC; defaults to today.",
+  ).optional(),
+  limit: z.int().default(20),
+  site_id: z.string(),
+  start_date: z.string().date().describe(
+    "Inclusive range start; defaults to 6 days before the end date. The range may span at most 90 days.",
+  ).optional(),
+});
+
+export type V2AgentAnalyticsCountriesListResponse =
+  | PublicAgentAnalyticsCountryListResponse
+  | HTTPValidationError;
+
+export const V2AgentAnalyticsCountriesListResponse$zodSchema: z.ZodType<
+  V2AgentAnalyticsCountriesListResponse
+> = z.union([
+  PublicAgentAnalyticsCountryListResponse$zodSchema,
+  HTTPValidationError$zodSchema,
+]);

package/src/models/v2agentanalyticserrorpageslistop.ts

@@ -0,0 +1,79 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 9329eca6bf33
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+import {
+  HTTPValidationError,
+  HTTPValidationError$zodSchema,
+} from "./httpvalidationerror.js";
+import {
+  PublicAgentAnalyticsErrorPageListResponse,
+  PublicAgentAnalyticsErrorPageListResponse$zodSchema,
+} from "./publicagentanalyticserrorpagelistresponse.js";
+
+/**
+ * Only errors this traffic type got.
+ */
+export const V2AgentAnalyticsErrorPagesListType = {
+  Coding: "coding",
+  User: "user",
+  Search: "search",
+  Training: "training",
+  Other: "other",
+  People: "people",
+} as const;
+/**
+ * Only errors this traffic type got.
+ */
+export type V2AgentAnalyticsErrorPagesListType = ClosedEnum<
+  typeof V2AgentAnalyticsErrorPagesListType
+>;
+
+export const V2AgentAnalyticsErrorPagesListType$zodSchema = z.enum([
+  "coding",
+  "user",
+  "search",
+  "training",
+  "other",
+  "people",
+]).describe("Only errors this traffic type got.");
+
+export type V2AgentAnalyticsErrorPagesListRequest = {
+  site_id: string;
+  start_date?: string | undefined;
+  end_date?: string | undefined;
+  limit?: number | undefined;
+  status?: number | undefined;
+  type?: V2AgentAnalyticsErrorPagesListType | undefined;
+};
+
+export const V2AgentAnalyticsErrorPagesListRequest$zodSchema: z.ZodType<
+  V2AgentAnalyticsErrorPagesListRequest
+> = z.object({
+  end_date: z.string().date().describe(
+    "Inclusive range end in UTC; defaults to today.",
+  ).optional(),
+  limit: z.int().default(50),
+  site_id: z.string(),
+  start_date: z.string().date().describe(
+    "Inclusive range start; defaults to 6 days before the end date. The range may span at most 90 days.",
+  ).optional(),
+  status: z.int().describe("Only this status code, such as 404.").optional(),
+  type: V2AgentAnalyticsErrorPagesListType$zodSchema.optional().describe(
+    "Only errors this traffic type got.",
+  ),
+});
+
+export type V2AgentAnalyticsErrorPagesListResponse =
+  | PublicAgentAnalyticsErrorPageListResponse
+  | HTTPValidationError;
+
+export const V2AgentAnalyticsErrorPagesListResponse$zodSchema: z.ZodType<
+  V2AgentAnalyticsErrorPagesListResponse
+> = z.union([
+  PublicAgentAnalyticsErrorPageListResponse$zodSchema,
+  HTTPValidationError$zodSchema,
+]);

package/src/models/v2agentanalyticspageslistop.ts

@@ -0,0 +1,119 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 1623e8feffb2
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+import {
+  HTTPValidationError,
+  HTTPValidationError$zodSchema,
+} from "./httpvalidationerror.js";
+import {
+  PublicAgentAnalyticsPageListResponse,
+  PublicAgentAnalyticsPageListResponse$zodSchema,
+} from "./publicagentanalyticspagelistresponse.js";
+
+/**
+ * Traffic type to sort by, most visits first, or `last_seen` for the latest visit first.
+ */
+export const Sort = {
+  Coding: "coding",
+  User: "user",
+  Search: "search",
+  Training: "training",
+  Other: "other",
+  People: "people",
+  AiTotal: "ai_total",
+  LastSeen: "last_seen",
+} as const;
+/**
+ * Traffic type to sort by, most visits first, or `last_seen` for the latest visit first.
+ */
+export type Sort = ClosedEnum<typeof Sort>;
+
+export const Sort$zodSchema = z.enum([
+  "coding",
+  "user",
+  "search",
+  "training",
+  "other",
+  "people",
+  "ai_total",
+  "last_seen",
+]).describe(
+  "Traffic type to sort by, most visits first, or `last_seen` for the latest visit first.",
+);
+
+/**
+ * Only pages this traffic type visited.
+ */
+export const V2AgentAnalyticsPagesListType = {
+  Coding: "coding",
+  User: "user",
+  Search: "search",
+  Training: "training",
+  Other: "other",
+  People: "people",
+} as const;
+/**
+ * Only pages this traffic type visited.
+ */
+export type V2AgentAnalyticsPagesListType = ClosedEnum<
+  typeof V2AgentAnalyticsPagesListType
+>;
+
+export const V2AgentAnalyticsPagesListType$zodSchema = z.enum([
+  "coding",
+  "user",
+  "search",
+  "training",
+  "other",
+  "people",
+]).describe("Only pages this traffic type visited.");
+
+export type V2AgentAnalyticsPagesListRequest = {
+  site_id: string;
+  start_date?: string | undefined;
+  end_date?: string | undefined;
+  limit?: number | undefined;
+  search?: string | undefined;
+  sort?: Sort | undefined;
+  type?: V2AgentAnalyticsPagesListType | undefined;
+  agent?: string | undefined;
+};
+
+export const V2AgentAnalyticsPagesListRequest$zodSchema: z.ZodType<
+  V2AgentAnalyticsPagesListRequest
+> = z.object({
+  agent: z.string().describe(
+    "Only pages this coding agent read, by the `name` the sources list gives it, such as `codex` or `cursor`.",
+  ).optional(),
+  end_date: z.string().date().describe(
+    "Inclusive range end in UTC; defaults to today.",
+  ).optional(),
+  limit: z.int().default(20),
+  search: z.string().describe("Only pages whose path contains this text.")
+    .optional(),
+  site_id: z.string(),
+  sort: Sort$zodSchema.default("ai_total").describe(
+    "Traffic type to sort by, most visits first, or `last_seen` for the latest visit first.",
+  ),
+  start_date: z.string().date().describe(
+    "Inclusive range start; defaults to 6 days before the end date. The range may span at most 90 days.",
+  ).optional(),
+  type: V2AgentAnalyticsPagesListType$zodSchema.optional().describe(
+    "Only pages this traffic type visited.",
+  ),
+});
+
+export type V2AgentAnalyticsPagesListResponse =
+  | PublicAgentAnalyticsPageListResponse
+  | HTTPValidationError;
+
+export const V2AgentAnalyticsPagesListResponse$zodSchema: z.ZodType<
+  V2AgentAnalyticsPagesListResponse
+> = z.union([
+  PublicAgentAnalyticsPageListResponse$zodSchema,
+  HTTPValidationError$zodSchema,
+]);

package/src/models/v2agentanalyticssourceslistop.ts

@@ -0,0 +1,43 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: da5c8805b14f
+ */
+
+import * as z from "zod";
+import {
+  HTTPValidationError,
+  HTTPValidationError$zodSchema,
+} from "./httpvalidationerror.js";
+import {
+  PublicAgentAnalyticsSourceListResponse,
+  PublicAgentAnalyticsSourceListResponse$zodSchema,
+} from "./publicagentanalyticssourcelistresponse.js";
+
+export type V2AgentAnalyticsSourcesListRequest = {
+  site_id: string;
+  start_date?: string | undefined;
+  end_date?: string | undefined;
+};
+
+export const V2AgentAnalyticsSourcesListRequest$zodSchema: z.ZodType<
+  V2AgentAnalyticsSourcesListRequest
+> = z.object({
+  end_date: z.string().date().describe(
+    "Inclusive range end in UTC; defaults to today.",
+  ).optional(),
+  site_id: z.string(),
+  start_date: z.string().date().describe(
+    "Inclusive range start; defaults to 6 days before the end date. The range may span at most 90 days.",
+  ).optional(),
+});
+
+export type V2AgentAnalyticsSourcesListResponse =
+  | PublicAgentAnalyticsSourceListResponse
+  | HTTPValidationError;
+
+export const V2AgentAnalyticsSourcesListResponse$zodSchema: z.ZodType<
+  V2AgentAnalyticsSourcesListResponse
+> = z.union([
+  PublicAgentAnalyticsSourceListResponse$zodSchema,
+  HTTPValidationError$zodSchema,
+]);

package/src/models/v2agentanalyticssummaryretrieveop.ts

@@ -0,0 +1,43 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b5dfa63686f4
+ */
+
+import * as z from "zod";
+import {
+  HTTPValidationError,
+  HTTPValidationError$zodSchema,
+} from "./httpvalidationerror.js";
+import {
+  PublicAgentAnalyticsSummary,
+  PublicAgentAnalyticsSummary$zodSchema,
+} from "./publicagentanalyticssummary.js";
+
+export type V2AgentAnalyticsSummaryRetrieveRequest = {
+  site_id: string;
+  start_date?: string | undefined;
+  end_date?: string | undefined;
+};
+
+export const V2AgentAnalyticsSummaryRetrieveRequest$zodSchema: z.ZodType<
+  V2AgentAnalyticsSummaryRetrieveRequest
+> = z.object({
+  end_date: z.string().date().describe(
+    "Inclusive range end in UTC; defaults to today.",
+  ).optional(),
+  site_id: z.string(),
+  start_date: z.string().date().describe(
+    "Inclusive range start; defaults to 6 days before the end date. The range may span at most 90 days.",
+  ).optional(),
+});
+
+export type V2AgentAnalyticsSummaryRetrieveResponse =
+  | PublicAgentAnalyticsSummary
+  | HTTPValidationError;
+
+export const V2AgentAnalyticsSummaryRetrieveResponse$zodSchema: z.ZodType<
+  V2AgentAnalyticsSummaryRetrieveResponse
+> = z.union([
+  PublicAgentAnalyticsSummary$zodSchema,
+  HTTPValidationError$zodSchema,
+]);

package/src/models/v2inlinemcpdefinition.ts

@@ -38,7 +38,7 @@ export const V2InlineMcpDefinition$zodSchema: z.ZodType<V2InlineMcpDefinition> =
       "Executable command for a `stdio` MCP server.",
     ),
     env: z.record(z.string(), z.string()).optional().describe(
-      "Environment mapping for a `stdio` MCP server. Values may reference run secrets with `${VARIABLE_NAME}`.",
+      "Environment mapping for a `stdio` MCP server. Values may reference the run environment's variables with `${VARIABLE_NAME}`; secrets (names ending in KEY, TOKEN, SECRET or PASSWORD) must.",
     ),
     headers: z.record(z.string(), z.string()).optional().describe(
       "HTTP headers. Reference run secrets with `${VARIABLE_NAME}` instead of embedding credentials.",

package/src/models/v2repository.ts

@@ -9,16 +9,16 @@ import { ClosedEnum } from "../types/enums.js";
 /**
  * Whether the repository is a read-only built-in template or an organization-owned saved repository.
  */
-export const Kind = {
+export const V2RepositoryKind = {
   Template: "template",
   Saved: "saved",
 } as const;
 /**
  * Whether the repository is a read-only built-in template or an organization-owned saved repository.
  */
-export type Kind = ClosedEnum<typeof Kind>;
+export type V2RepositoryKind = ClosedEnum<typeof V2RepositoryKind>;
 
-export const Kind$zodSchema = z.enum([
+export const V2RepositoryKind$zodSchema = z.enum([
   "template",
   "saved",
 ]).describe(
@@ -54,7 +54,7 @@ export const V2RepositoryFramework$zodSchema = z.enum([
 
 export type V2Repository = {
   id: string;
-  kind: Kind;
+  kind: V2RepositoryKind;
   name: string;
   repo_url: string;
   ref: string;
@@ -74,7 +74,7 @@ export const V2Repository$zodSchema: z.ZodType<V2Repository> = z.object({
     "Value to pass as `repository` in a direct eval run. Built-in templates use aliases such as `nextjs-starter`; saved repositories use their persisted IDs.",
   ),
   install_steps: z.array(z.string()).optional(),
-  kind: Kind$zodSchema.describe(
+  kind: V2RepositoryKind$zodSchema.describe(
     "Whether the repository is a read-only built-in template or an organization-owned saved repository.",
   ),
   name: z.string(),

package/src/models/v2taskscreateop.ts

@@ -0,0 +1,34 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 858a2209718a
+ */
+
+import * as z from "zod";
+import {
+  HTTPValidationError,
+  HTTPValidationError$zodSchema,
+} from "./httpvalidationerror.js";
+import { V2PublicTask, V2PublicTask$zodSchema } from "./v2publictask.js";
+
+/**
+ * The assignee is not a member of your organization.
+ */
+export type V2TasksCreateResponseBody = { detail: string };
+
+export const V2TasksCreateResponseBody$zodSchema: z.ZodType<
+  V2TasksCreateResponseBody
+> = z.object({
+  detail: z.string(),
+}).describe("The assignee is not a member of your organization.");
+
+export type V2TasksCreateResponse =
+  | V2PublicTask
+  | V2TasksCreateResponseBody
+  | HTTPValidationError;
+
+export const V2TasksCreateResponse$zodSchema: z.ZodType<V2TasksCreateResponse> =
+  z.union([
+    V2PublicTask$zodSchema,
+    z.lazy(() => V2TasksCreateResponseBody$zodSchema),
+    HTTPValidationError$zodSchema,
+  ]);

package/src/tool-names.ts

@@ -88,6 +88,10 @@ export const toolNames: Array<{ name: string; description: string }>= [
     "name": "tasks-list",
     "description": "List Tasks\n\nReturns persisted daily tasks with execution instructions. Includes per-status counts not narrowed by the `status` filter."
   },
+  {
+    "name": "tasks-create",
+    "description": "Create Task\n\nAdds a task to today's queue and returns it with its execution prompt. New tasks start as `new`."
+  },
   {
     "name": "tasks-retrieve",
     "description": "Retrieve Task\n\nReturns one persisted task and its execution prompt."
@@ -104,6 +108,30 @@ export const toolNames: Array<{ name: string; description: string }>= [
     "name": "site-audits-retrieve",
     "description": "Retrieve Site Audit\n\nReturns one audited page with its score, priority, supporting evidence, and recommended fixes."
   },
+  {
+    "name": "agent-analytics-sites-list",
+    "description": "List Agent Analytics Sites\n\nReturns every site with tracked visits. Use a `site_id` from this list to read that site's agent traffic."
+  },
+  {
+    "name": "agent-analytics-summary-retrieve",
+    "description": "Retrieve Agent Analytics Summary\n\nReturns a site's visits by traffic type (coding agents, user-requested AI fetches, AI search, AI training, other bots, and people) for the date range and for the same number of days before it."
+  },
+  {
+    "name": "agent-analytics-sources-list",
+    "description": "List Agent Analytics Sources\n\nReturns every coding agent and bot that visited a site in the date range, with its traffic type and visit count, most visits first. Human visits are one `people` row."
+  },
+  {
+    "name": "agent-analytics-pages-list",
+    "description": "List Agent Analytics Pages\n\nReturns the pages AI agents and bots read on a site in the date range, with visits per traffic type. Sorted by AI visits unless `sort` is set. With `type`, returns only pages that traffic type visited. With `agent`, returns only the pages that one coding agent read."
+  },
+  {
+    "name": "agent-analytics-error-pages-list",
+    "description": "List Agent Analytics Error Pages\n\nReturns the pages on a site that returned an error status (400 and up) in the date range, most error requests first, with the agents, bots, and people that got each error. Set `status` to 404 for pages that were not found. Needs server-side tracking that records status codes; `status_codes_tracked` says whether the site has any."
+  },
+  {
+    "name": "agent-analytics-countries-list",
+    "description": "List Agent Analytics Countries\n\nReturns a site's visits from coding agents and AI assistants per country in the date range, most visits first."
+  },
   {
     "name": "evals-list",
     "description": "List Evals\n\nReturns all active eval definitions owned by the organization. Agent Preference evals are not included; list them with `GET /v2/agent-preference/evals`."