@lightsage/mcp 0.4.16 → 0.4.17

package/src/funcs/agentAnalyticsSourcesList.ts

@@ -0,0 +1,158 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 9a8454f939b0
+ */
+
+import { LightsageMcpCore } from "../core.js";
+import { encodeFormQuery, encodeSimple } from "../lib/encodings.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import { APIError } from "../models/errors/apierror.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import {
+  V2AgentAnalyticsSourcesListRequest,
+  V2AgentAnalyticsSourcesListRequest$zodSchema,
+} from "../models/v2agentanalyticssourceslistop.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * List Agent Analytics Sources
+ *
+ * @remarks
+ * 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.
+ */
+export function agentAnalyticsSourcesList(
+  client$: LightsageMcpCore,
+  request: V2AgentAnalyticsSourcesListRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    Response,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >
+> {
+  return new APIPromise($do(
+    client$,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client$: LightsageMcpCore,
+  request: V2AgentAnalyticsSourcesListRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      Response,
+      | APIError
+      | SDKValidationError
+      | UnexpectedClientError
+      | InvalidRequestError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | ConnectionError
+    >,
+    APICall,
+  ]
+> {
+  const parsed$ = safeParse(
+    request,
+    (value$) => V2AgentAnalyticsSourcesListRequest$zodSchema.parse(value$),
+    "Input validation failed",
+  );
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = null;
+
+  const pathParams$ = {
+    site_id: encodeSimple("site_id", payload$.site_id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path$ = pathToFunc("/v2/agent-analytics/sites/{site_id}/sources")(
+    pathParams$,
+  );
+  const query$ = encodeFormQuery({
+    "end_date": payload$.end_date,
+    "start_date": payload$.start_date,
+  });
+
+  const headers$ = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+  const securityInput = await extractSecurity(client$._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client$._options,
+    baseURL: options?.serverURL ?? client$._baseURL ?? "",
+    operationID: "v2_agent_analytics_sources_list",
+    oAuth2Scopes: null,
+    resolvedSecurity: requestSecurity,
+    securitySource: client$._options.security,
+    retryConfig: options?.retries
+      || client$._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || [
+      "429",
+      "500",
+      "502",
+      "503",
+      "504",
+    ],
+  };
+
+  const requestRes = client$._createRequest(context, {
+    security: requestSecurity,
+    method: "GET",
+    baseURL: options?.serverURL,
+    path: path$,
+    headers: headers$,
+    query: query$,
+    body: body$,
+    userAgent: client$._options.userAgent,
+    timeoutMs: options?.timeoutMs || client$._options.timeoutMs
+      || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req$ = requestRes.value;
+
+  const doResult = await client$._do(req$, {
+    context,
+    errorCodes: [],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req$ }];
+  }
+  return [doResult, {
+    status: "complete",
+    "request": req$,
+    response: doResult.value,
+  }];
+}

package/src/funcs/agentAnalyticsSummaryRetrieve.ts

@@ -0,0 +1,158 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 61717c0f36b3
+ */
+
+import { LightsageMcpCore } from "../core.js";
+import { encodeFormQuery, encodeSimple } from "../lib/encodings.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import { APIError } from "../models/errors/apierror.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import {
+  V2AgentAnalyticsSummaryRetrieveRequest,
+  V2AgentAnalyticsSummaryRetrieveRequest$zodSchema,
+} from "../models/v2agentanalyticssummaryretrieveop.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Retrieve Agent Analytics Summary
+ *
+ * @remarks
+ * 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.
+ */
+export function agentAnalyticsSummaryRetrieve(
+  client$: LightsageMcpCore,
+  request: V2AgentAnalyticsSummaryRetrieveRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    Response,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >
+> {
+  return new APIPromise($do(
+    client$,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client$: LightsageMcpCore,
+  request: V2AgentAnalyticsSummaryRetrieveRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      Response,
+      | APIError
+      | SDKValidationError
+      | UnexpectedClientError
+      | InvalidRequestError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | ConnectionError
+    >,
+    APICall,
+  ]
+> {
+  const parsed$ = safeParse(
+    request,
+    (value$) => V2AgentAnalyticsSummaryRetrieveRequest$zodSchema.parse(value$),
+    "Input validation failed",
+  );
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = null;
+
+  const pathParams$ = {
+    site_id: encodeSimple("site_id", payload$.site_id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path$ = pathToFunc("/v2/agent-analytics/sites/{site_id}/summary")(
+    pathParams$,
+  );
+  const query$ = encodeFormQuery({
+    "end_date": payload$.end_date,
+    "start_date": payload$.start_date,
+  });
+
+  const headers$ = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+  const securityInput = await extractSecurity(client$._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client$._options,
+    baseURL: options?.serverURL ?? client$._baseURL ?? "",
+    operationID: "v2_agent_analytics_summary_retrieve",
+    oAuth2Scopes: null,
+    resolvedSecurity: requestSecurity,
+    securitySource: client$._options.security,
+    retryConfig: options?.retries
+      || client$._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || [
+      "429",
+      "500",
+      "502",
+      "503",
+      "504",
+    ],
+  };
+
+  const requestRes = client$._createRequest(context, {
+    security: requestSecurity,
+    method: "GET",
+    baseURL: options?.serverURL,
+    path: path$,
+    headers: headers$,
+    query: query$,
+    body: body$,
+    userAgent: client$._options.userAgent,
+    timeoutMs: options?.timeoutMs || client$._options.timeoutMs
+      || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req$ = requestRes.value;
+
+  const doResult = await client$._do(req$, {
+    context,
+    errorCodes: [],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req$ }];
+  }
+  return [doResult, {
+    status: "complete",
+    "request": req$,
+    response: doResult.value,
+  }];
+}

package/src/funcs/tasksCreate.ts

@@ -0,0 +1,145 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 0e59c249fad2
+ */
+
+import { LightsageMcpCore } from "../core.js";
+import { encodeJSON } from "../lib/encodings.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import {
+  CreateTaskRequest,
+  CreateTaskRequest$zodSchema,
+} from "../models/createtaskrequest.js";
+import { APIError } from "../models/errors/apierror.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Create Task
+ *
+ * @remarks
+ * Adds a task to today's queue and returns it with its execution prompt. New tasks start as `new`.
+ */
+export function tasksCreate(
+  client$: LightsageMcpCore,
+  request: CreateTaskRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    Response,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >
+> {
+  return new APIPromise($do(
+    client$,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client$: LightsageMcpCore,
+  request: CreateTaskRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      Response,
+      | APIError
+      | SDKValidationError
+      | UnexpectedClientError
+      | InvalidRequestError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | ConnectionError
+    >,
+    APICall,
+  ]
+> {
+  const parsed$ = safeParse(
+    request,
+    (value$) => CreateTaskRequest$zodSchema.parse(value$),
+    "Input validation failed",
+  );
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = encodeJSON("body", payload$, { explode: true });
+  const path$ = pathToFunc("/v2/tasks")();
+
+  const headers$ = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json",
+  }));
+  const securityInput = await extractSecurity(client$._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client$._options,
+    baseURL: options?.serverURL ?? client$._baseURL ?? "",
+    operationID: "v2_tasks_create",
+    oAuth2Scopes: null,
+    resolvedSecurity: requestSecurity,
+    securitySource: client$._options.security,
+    retryConfig: options?.retries
+      || client$._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || [
+      "429",
+      "500",
+      "502",
+      "503",
+      "504",
+    ],
+  };
+
+  const requestRes = client$._createRequest(context, {
+    security: requestSecurity,
+    method: "POST",
+    baseURL: options?.serverURL,
+    path: path$,
+    headers: headers$,
+    body: body$,
+    userAgent: client$._options.userAgent,
+    timeoutMs: options?.timeoutMs || client$._options.timeoutMs
+      || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req$ = requestRes.value;
+
+  const doResult = await client$._do(req$, {
+    context,
+    errorCodes: [],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req$ }];
+  }
+  return [doResult, {
+    status: "complete",
+    "request": req$,
+    response: doResult.value,
+  }];
+}

package/src/landing-page.ts

@@ -931,7 +931,7 @@ http_headers = { "lightsage-api-key-auth" = "YOUR_LIGHTSAGE_API_KEY_AUTH" }`;
         <h1>Instructions</h1>
         <p>One-click installation for Claude Desktop users</p>
         <div class="instruction-item">
-          <a href="https://github.com/lightsagehq/mcp/releases/download/v0.4.16/mcp-server.mcpb" download="mcp-server.mcpb" class="action-button header-action" style="display: inline-flex; margin-bottom: 16px;">
+          <a href="https://github.com/lightsagehq/mcp/releases/download/v0.4.17/mcp-server.mcpb" download="mcp-server.mcpb" class="action-button header-action" style="display: inline-flex; margin-bottom: 16px;">
             📥 Download MCP Bundle
           </a>
         </div>

package/src/lib/config.ts

@@ -66,7 +66,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.0.0",
-  sdkVersion: "0.4.16",
+  sdkVersion: "0.4.17",
   genVersion: "2.948.4",
-  userAgent: "speakeasy-sdk/mcp-typescript 0.4.16 2.948.4 1.0.0 @lightsage/mcp",
+  userAgent: "speakeasy-sdk/mcp-typescript 0.4.17 2.948.4 1.0.0 @lightsage/mcp",
 } as const;

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

@@ -22,7 +22,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.4.16",
+    currentVersion: "0.4.17",
   },
 });
 

package/src/mcp-server/server.ts

@@ -18,6 +18,12 @@ import {
   MCPToolAnnotationFilter,
   registerDynamicTools,
 } from "./tools.js";
+import { tool$agentAnalyticsCountriesList } from "./tools/agentAnalyticsCountriesList.js";
+import { tool$agentAnalyticsErrorPagesList } from "./tools/agentAnalyticsErrorPagesList.js";
+import { tool$agentAnalyticsPagesList } from "./tools/agentAnalyticsPagesList.js";
+import { tool$agentAnalyticsSitesList } from "./tools/agentAnalyticsSitesList.js";
+import { tool$agentAnalyticsSourcesList } from "./tools/agentAnalyticsSourcesList.js";
+import { tool$agentAnalyticsSummaryRetrieve } from "./tools/agentAnalyticsSummaryRetrieve.js";
 import { tool$agentPreferenceCompetitorsList } from "./tools/agentPreferenceCompetitorsList.js";
 import { tool$agentPreferenceEvalsCreate } from "./tools/agentPreferenceEvalsCreate.js";
 import { tool$agentPreferenceEvalsDelete } from "./tools/agentPreferenceEvalsDelete.js";
@@ -76,6 +82,7 @@ import { tool$siteAuditsRetrieve } from "./tools/siteAuditsRetrieve.js";
 import { tool$skillsList } from "./tools/skillsList.js";
 import { tool$statusAuthStatusGet } from "./tools/statusAuthStatusGet.js";
 import { tool$statusGet } from "./tools/statusGet.js";
+import { tool$tasksCreate } from "./tools/tasksCreate.js";
 import { tool$tasksList } from "./tools/tasksList.js";
 import { tool$tasksRetrieve } from "./tools/tasksRetrieve.js";
 import { tool$tasksUpdate } from "./tools/tasksUpdate.js";
@@ -103,7 +110,7 @@ export function createMCPServer(deps: {
       sizes: ["any"],
     }],
     name: "LightsageMcp",
-    version: "0.4.16",
+    version: "0.4.17",
   });
 
   const getClient = deps.getSDK || (() =>
@@ -170,10 +177,17 @@ export function createMCPServer(deps: {
   tool(tool$opportunitiesList);
   tool(tool$opportunitiesRetrieve);
   tool(tool$tasksList);
+  tool(tool$tasksCreate);
   tool(tool$tasksRetrieve);
   tool(tool$tasksUpdate);
   tool(tool$siteAuditsList);
   tool(tool$siteAuditsRetrieve);
+  tool(tool$agentAnalyticsSitesList);
+  tool(tool$agentAnalyticsSummaryRetrieve);
+  tool(tool$agentAnalyticsSourcesList);
+  tool(tool$agentAnalyticsPagesList);
+  tool(tool$agentAnalyticsErrorPagesList);
+  tool(tool$agentAnalyticsCountriesList);
   tool(tool$evalsList);
   tool(tool$evalsCreate);
   tool(tool$evalsBatchCreate);

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

@@ -0,0 +1,43 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 0da30e8db89f
+ */
+
+import { agentAnalyticsCountriesList } from "../../funcs/agentAnalyticsCountriesList.js";
+import { V2AgentAnalyticsCountriesListRequest$zodSchema } from "../../models/v2agentanalyticscountrieslistop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: V2AgentAnalyticsCountriesListRequest$zodSchema,
+};
+
+export const tool$agentAnalyticsCountriesList: ToolDefinition<typeof args> = {
+  name: "agent-analytics-countries-list",
+  description: `List Agent Analytics Countries
+
+Returns a site's visits from coding agents and AI assistants per country in the date range, most visits first.`,
+  annotations: {
+    "title": "",
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result] = await agentAnalyticsCountriesList(
+      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/agentAnalyticsErrorPagesList.ts

@@ -0,0 +1,43 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: d33d2c1a70a9
+ */
+
+import { agentAnalyticsErrorPagesList } from "../../funcs/agentAnalyticsErrorPagesList.js";
+import { V2AgentAnalyticsErrorPagesListRequest$zodSchema } from "../../models/v2agentanalyticserrorpageslistop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: V2AgentAnalyticsErrorPagesListRequest$zodSchema,
+};
+
+export const tool$agentAnalyticsErrorPagesList: ToolDefinition<typeof args> = {
+  name: "agent-analytics-error-pages-list",
+  description: `List Agent Analytics Error Pages
+
+Returns 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.`,
+  annotations: {
+    "title": "",
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result] = await agentAnalyticsErrorPagesList(
+      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/agentAnalyticsPagesList.ts

@@ -0,0 +1,43 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 057773705e6c
+ */
+
+import { agentAnalyticsPagesList } from "../../funcs/agentAnalyticsPagesList.js";
+import { V2AgentAnalyticsPagesListRequest$zodSchema } from "../../models/v2agentanalyticspageslistop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: V2AgentAnalyticsPagesListRequest$zodSchema,
+};
+
+export const tool$agentAnalyticsPagesList: ToolDefinition<typeof args> = {
+  name: "agent-analytics-pages-list",
+  description: `List Agent Analytics Pages
+
+Returns 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.`,
+  annotations: {
+    "title": "",
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result] = await agentAnalyticsPagesList(
+      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);
+  },
+};