@lightsage/mcp 0.4.15 → 0.4.17

package/src/mcp-server/tools/agentAnalyticsSitesList.ts

@@ -0,0 +1,36 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: d95f6428bdb2
+ */
+
+import { agentAnalyticsSitesList } from "../../funcs/agentAnalyticsSitesList.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+export const tool$agentAnalyticsSitesList: ToolDefinition = {
+  name: "agent-analytics-sites-list",
+  description: `List Agent Analytics Sites
+
+Returns every site with tracked visits. Use a \`site_id\` from this list to read that site's agent traffic.`,
+  annotations: {
+    "title": "",
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
+  tool: async (client, ctx) => {
+    const [result] = await agentAnalyticsSitesList(
+      client,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    return formatResult(result.value);
+  },
+};

package/src/mcp-server/tools/agentAnalyticsSourcesList.ts

@@ -0,0 +1,43 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 866f96a4dbca
+ */
+
+import { agentAnalyticsSourcesList } from "../../funcs/agentAnalyticsSourcesList.js";
+import { V2AgentAnalyticsSourcesListRequest$zodSchema } from "../../models/v2agentanalyticssourceslistop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: V2AgentAnalyticsSourcesListRequest$zodSchema,
+};
+
+export const tool$agentAnalyticsSourcesList: ToolDefinition<typeof args> = {
+  name: "agent-analytics-sources-list",
+  description: `List Agent Analytics Sources
+
+Returns 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.`,
+  annotations: {
+    "title": "",
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result] = await agentAnalyticsSourcesList(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    return formatResult(result.value);
+  },
+};

package/src/mcp-server/tools/agentAnalyticsSummaryRetrieve.ts

@@ -0,0 +1,43 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 40ea59809461
+ */
+
+import { agentAnalyticsSummaryRetrieve } from "../../funcs/agentAnalyticsSummaryRetrieve.js";
+import { V2AgentAnalyticsSummaryRetrieveRequest$zodSchema } from "../../models/v2agentanalyticssummaryretrieveop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: V2AgentAnalyticsSummaryRetrieveRequest$zodSchema,
+};
+
+export const tool$agentAnalyticsSummaryRetrieve: ToolDefinition<typeof args> = {
+  name: "agent-analytics-summary-retrieve",
+  description: `Retrieve Agent Analytics Summary
+
+Returns 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.`,
+  annotations: {
+    "title": "",
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result] = await agentAnalyticsSummaryRetrieve(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    return formatResult(result.value);
+  },
+};

package/src/mcp-server/tools/tasksCreate.ts

@@ -0,0 +1,43 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 6713b53d6c00
+ */
+
+import { tasksCreate } from "../../funcs/tasksCreate.js";
+import { CreateTaskRequest$zodSchema } from "../../models/createtaskrequest.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: CreateTaskRequest$zodSchema,
+};
+
+export const tool$tasksCreate: ToolDefinition<typeof args> = {
+  name: "tasks-create",
+  description: `Create Task
+
+Adds a task to today's queue and returns it with its execution prompt. New tasks start as \`new\`.`,
+  annotations: {
+    "title": "",
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result] = await tasksCreate(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    return formatResult(result.value);
+  },
+};

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/graderdefinition.ts

@@ -4,6 +4,20 @@
  */
 
 import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+export const Metric = {
+  ToolCalls: "tool_calls",
+  Time: "time",
+  Cost: "cost",
+} as const;
+export type Metric = ClosedEnum<typeof Metric>;
+
+export const Metric$zodSchema = z.enum([
+  "tool_calls",
+  "time",
+  "cost",
+]);
 
 export type GraderDefinition = {
   name: string;
@@ -13,6 +27,9 @@ export type GraderDefinition = {
   pattern?: string | null | undefined;
   case_sensitive?: boolean | undefined;
   criteria?: string | null | undefined;
+  metric?: Metric | null | undefined;
+  min_score?: number | null | undefined;
+  max_value?: number | null | undefined;
   weight?: number | undefined;
   blocking?: boolean | undefined;
 };
@@ -24,6 +41,9 @@ 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(),
     needle: z.string().nullable().optional(),
     needles: z.array(z.string()).nullable().optional(),

package/src/models/publicagentanalyticscountrylistresponse.ts

@@ -0,0 +1,28 @@
+/*
+ * 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";
+
+export type PublicAgentAnalyticsCountryListResponse = {
+  site_id: string;
+  start_date: string;
+  end_date: string;
+  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(),
+  site_id: z.string(),
+  start_date: z.string().date(),
+});

package/src/models/publicagentanalyticserrorpagelistresponse.ts

@@ -0,0 +1,32 @@
+/*
+ * 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";
+
+export type PublicAgentAnalyticsErrorPageListResponse = {
+  site_id: string;
+  start_date: string;
+  end_date: string;
+  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.",
+  ),
+  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,30 @@
+/*
+ * 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";
+
+export type PublicAgentAnalyticsPageListResponse = {
+  site_id: string;
+  start_date: string;
+  end_date: string;
+  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(),
+  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,28 @@
+/*
+ * 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";
+
+export type PublicAgentAnalyticsSourceListResponse = {
+  site_id: string;
+  start_date: string;
+  end_date: string;
+  sources?: Array<PublicAgentTrafficSource> | undefined;
+};
+
+export const PublicAgentAnalyticsSourceListResponse$zodSchema: z.ZodType<
+  PublicAgentAnalyticsSourceListResponse
+> = z.object({
+  end_date: z.string().date(),
+  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,28 @@
+/*
+ * 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";
+
+export type PublicAgentAnalyticsSummary = {
+  site_id: string;
+  start_date: string;
+  end_date: string;
+  current: PublicAgentTrafficTotals;
+  previous: PublicAgentTrafficTotals;
+};
+
+export const PublicAgentAnalyticsSummary$zodSchema: z.ZodType<
+  PublicAgentAnalyticsSummary
+> = z.object({
+  current: PublicAgentTrafficTotals$zodSchema,
+  end_date: z.string().date(),
+  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.",
+  ),
+});