@meetkai/mka1 0.54.23 → 0.54.25

package/src/funcs/llmEvalsUploadSampleTrajectory.ts

@@ -0,0 +1,201 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { SDKCore } from "../core.js";
+import { encodeFormQuery, encodeJSON, encodeSimple } from "../lib/encodings.js";
+import { matchStatusCode } from "../lib/http.js";
+import * as M from "../lib/matchers.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 * as components from "../models/components/index.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKError } from "../models/errors/sdkerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Upload an eval sample trajectory
+ *
+ * @remarks
+ * Stores one coding-agent trial's session, in whatever interchange format the harness produced (record it in `schema_version`, e.g. `ATIF-v1.7`). `steps` is stored verbatim and never validated, so a harness format change needs no gateway release. Separate from the run import because a trajectory averages ~92 KB and a whole run's worth would not fit in one request. Upserts, so re-sending after a timeout replaces the trajectory rather than failing. Sample indices are unique per (task, model), not per run, so pass `task_id` and/or `model` when the run covers more than one — an ambiguous index returns 400 rather than writing to the wrong trial. Rejects a payload whose `steps` and `logs` together exceed 16 MiB with 413.
+ *
+ * If set, this operation will use {@link Security.bearerAuth} from the global security.
+ */
+export function llmEvalsUploadSampleTrajectory(
+  client: SDKCore,
+  request: operations.UploadEvalSampleTrajectoryRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    components.EvalSampleTrajectoryUploadedObject,
+    | SDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: SDKCore,
+  request: operations.UploadEvalSampleTrajectoryRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      components.EvalSampleTrajectoryUploadedObject,
+      | SDKError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      operations.UploadEvalSampleTrajectoryRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = encodeJSON("body", payload.UploadEvalSampleTrajectoryRequest, {
+    explode: true,
+  });
+
+  const pathParams = {
+    run_id: encodeSimple("run_id", payload.run_id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+    sample_index: encodeSimple("sample_index", payload.sample_index, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path = pathToFunc(
+    "/api/v1/llm/evals/runs/{run_id}/samples/{sample_index}/trajectory",
+  )(pathParams);
+
+  const query = encodeFormQuery({
+    "model": payload.model,
+    "task_id": payload.task_id,
+  });
+
+  const headers = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json",
+    "X-On-Behalf-Of": encodeSimple(
+      "X-On-Behalf-Of",
+      payload["X-On-Behalf-Of"],
+      { explode: false, charEncoding: "none" },
+    ),
+  }));
+
+  const secConfig = await extractSecurity(client._options.bearerAuth);
+  const securityInput = secConfig == null ? {} : { bearerAuth: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput, [0]);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "uploadEvalSampleTrajectory",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.bearerAuth,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || {
+        strategy: "backoff",
+        backoff: {
+          initialInterval: 500,
+          maxInterval: 5000,
+          exponent: 1.5,
+          maxElapsedTime: 15000,
+        },
+        retryConnectionErrors: true,
+      }
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "PUT",
+    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,
+    isErrorStatusCode: (statusCode: number) =>
+      matchStatusCode({ status: statusCode } as Response, ["4XX", "5XX"]),
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const [result] = await M.match<
+    components.EvalSampleTrajectoryUploadedObject,
+    | SDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, components.EvalSampleTrajectoryUploadedObject$inboundSchema),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req);
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/lib/config.ts

@@ -65,7 +65,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.1.0",
-  sdkVersion: "0.54.23",
+  sdkVersion: "0.54.25",
   genVersion: "2.935.1",
-  userAgent: "speakeasy-sdk/typescript 0.54.23 2.935.1 1.1.0 @meetkai/mka1",
+  userAgent: "speakeasy-sdk/typescript 0.54.25 2.935.1 1.1.0 @meetkai/mka1",
 } as const;

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

@@ -19,7 +19,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.54.23",
+    currentVersion: "0.54.25",
   },
 });
 

package/src/mcp-server/server.ts

@@ -171,6 +171,7 @@ import { tool$llmConversationsListItems } from "./tools/llmConversationsListItem
 import { tool$llmConversationsUpdate } from "./tools/llmConversationsUpdate.js";
 import { tool$llmEmbeddingsEmbed } from "./tools/llmEmbeddingsEmbed.js";
 import { tool$llmEmbeddingsListModels } from "./tools/llmEmbeddingsListModels.js";
+import { tool$llmEvalsAppendAgentTrials } from "./tools/llmEvalsAppendAgentTrials.js";
 import { tool$llmEvalsCancelRun } from "./tools/llmEvalsCancelRun.js";
 import { tool$llmEvalsCreateRun } from "./tools/llmEvalsCreateRun.js";
 import { tool$llmEvalsCreateSchedule } from "./tools/llmEvalsCreateSchedule.js";
@@ -181,10 +182,14 @@ import { tool$llmEvalsDeleteSchedule } from "./tools/llmEvalsDeleteSchedule.js";
 import { tool$llmEvalsDeleteSuite } from "./tools/llmEvalsDeleteSuite.js";
 import { tool$llmEvalsGetArtifacts } from "./tools/llmEvalsGetArtifacts.js";
 import { tool$llmEvalsGetRun } from "./tools/llmEvalsGetRun.js";
+import { tool$llmEvalsGetRunOverview } from "./tools/llmEvalsGetRunOverview.js";
 import { tool$llmEvalsGetSampleAudio } from "./tools/llmEvalsGetSampleAudio.js";
+import { tool$llmEvalsGetSampleTrajectory } from "./tools/llmEvalsGetSampleTrajectory.js";
 import { tool$llmEvalsGetSchedule } from "./tools/llmEvalsGetSchedule.js";
 import { tool$llmEvalsGetSuite } from "./tools/llmEvalsGetSuite.js";
+import { tool$llmEvalsGetSuiteLeaderboard } from "./tools/llmEvalsGetSuiteLeaderboard.js";
 import { tool$llmEvalsGetSuiteVersion } from "./tools/llmEvalsGetSuiteVersion.js";
+import { tool$llmEvalsImportAgentRun } from "./tools/llmEvalsImportAgentRun.js";
 import { tool$llmEvalsImportHistoricalResults } from "./tools/llmEvalsImportHistoricalResults.js";
 import { tool$llmEvalsListRuns } from "./tools/llmEvalsListRuns.js";
 import { tool$llmEvalsListSamples } from "./tools/llmEvalsListSamples.js";
@@ -197,6 +202,7 @@ import { tool$llmEvalsRerunFailedSamples } from "./tools/llmEvalsRerunFailedSamp
 import { tool$llmEvalsRetryFailedRun } from "./tools/llmEvalsRetryFailedRun.js";
 import { tool$llmEvalsTriggerSchedule } from "./tools/llmEvalsTriggerSchedule.js";
 import { tool$llmEvalsUpdateSchedule } from "./tools/llmEvalsUpdateSchedule.js";
+import { tool$llmEvalsUploadSampleTrajectory } from "./tools/llmEvalsUploadSampleTrajectory.js";
 import { tool$llmExtractCreateSchema } from "./tools/llmExtractCreateSchema.js";
 import { tool$llmExtractDeleteSchema } from "./tools/llmExtractDeleteSchema.js";
 import { tool$llmExtractExtract } from "./tools/llmExtractExtract.js";
@@ -406,7 +412,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "SDK",
-    version: "0.54.23",
+    version: "0.54.25",
   });
 
   const client = new SDKCore({
@@ -627,6 +633,7 @@ export function createMCPServer(deps: {
   tool(tool$llmEvalsListSuiteVersions);
   tool(tool$llmEvalsGetSuiteVersion);
   tool(tool$llmEvalsListSuiteLeaderboardRuns);
+  tool(tool$llmEvalsGetSuiteLeaderboard);
   tool(tool$llmEvalsCreateRun);
   tool(tool$llmEvalsListRuns);
   tool(tool$llmEvalsGetRun);
@@ -634,9 +641,14 @@ export function createMCPServer(deps: {
   tool(tool$llmEvalsCancelRun);
   tool(tool$llmEvalsRerunFailedSamples);
   tool(tool$llmEvalsRetryFailedRun);
+  tool(tool$llmEvalsGetRunOverview);
   tool(tool$llmEvalsListSamples);
   tool(tool$llmEvalsGetSampleAudio);
+  tool(tool$llmEvalsGetSampleTrajectory);
+  tool(tool$llmEvalsUploadSampleTrajectory);
   tool(tool$llmEvalsGetArtifacts);
+  tool(tool$llmEvalsImportAgentRun);
+  tool(tool$llmEvalsAppendAgentTrials);
   tool(tool$llmEvalsImportHistoricalResults);
   tool(tool$llmEvalsCreateSchedule);
   tool(tool$llmEvalsListSchedules);

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { llmEvalsAppendAgentTrials } from "../../funcs/llmEvalsAppendAgentTrials.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.AppendAgentEvalTrialsRequest$inboundSchema,
+};
+
+export const tool$llmEvalsAppendAgentTrials: ToolDefinition<typeof args> = {
+  name: "llm-evals-append-agent-trials",
+  description: `Append trials to an open coding-agent run
+
+Adds finished trials to a run opened with \`finalize: false\`, so a job started from MKA1 can be watched while it runs instead of appearing complete out of nowhere at the end. Each trial pins its own \`sample_index\` and upserts on (task, model, sample_index): a harness cannot tell a timeout from a lost response, so re-sending a batch is safe and replaces rather than duplicates. The whole batch and its aggregate recompute land in one transaction, serialized per run. Counts, metrics and cost are recomputed from the stored rows on every call, never accumulated from the request, so a replayed batch cannot double them. Send \`finalize: true\` (usually with an empty \`trials\`) to close the run — until then it stays \`in_progress\` and off the leaderboards, which only count completed runs. Appending to an already-completed or cancelled run is rejected: that record is finished, and rewriting it would silently move a number someone may have already read.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await llmEvalsAppendAgentTrials(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { llmEvalsGetRunOverview } from "../../funcs/llmEvalsGetRunOverview.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetEvalRunOverviewRequest$inboundSchema,
+};
+
+export const tool$llmEvalsGetRunOverview: ToolDefinition<typeof args> = {
+  name: "llm-evals-get-run-overview",
+  description: `Get an eval run overview
+
+Aggregate header for one run's trials view: trial counts, average reward, cost, and the input/output/cached token split. Its own route rather than fields on the run object because it scans the run's samples — folding it into \`GET /evals/runs/{run_id}\` would charge that scan to every run list and to the status polling that runs for the whole length of an eval. \`trials.errored\` overlaps \`trials.failed\` instead of partitioning it: a coding-agent trial can carry an agent timeout in \`error\` and still be completed and scored. \`trials.retried\` counts trials rerun through rerun-failed, read from the pre-rerun snapshot, since a rerun overwrites the sample in place.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await llmEvalsGetRunOverview(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { llmEvalsGetSampleTrajectory } from "../../funcs/llmEvalsGetSampleTrajectory.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetEvalSampleTrajectoryRequest$inboundSchema,
+};
+
+export const tool$llmEvalsGetSampleTrajectory: ToolDefinition<typeof args> = {
+  name: "llm-evals-get-sample-trajectory",
+  description: `Get an eval sample trajectory
+
+Returns one coding-agent trial's session — the steps the agent took, verbatim in the harness's interchange format (see \`schema_version\`, e.g. \`ATIF-v1.7\`). Deliberately not part of the samples list: a trajectory averages ~92 KB and that list pages up to 500 rows. Sample indices are unique per (task, model), not per run, so pass \`task_id\` and/or \`model\` when the run covers more than one; an index that matches several trials returns 400 rather than guessing, and never falls back to another trial's session. Returns 404 when the sample does not exist or recorded no trajectory.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await llmEvalsGetSampleTrajectory(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { llmEvalsGetSuiteLeaderboard } from "../../funcs/llmEvalsGetSuiteLeaderboard.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetEvalSuiteLeaderboardRequest$inboundSchema,
+};
+
+export const tool$llmEvalsGetSuiteLeaderboard: ToolDefinition<typeof args> = {
+  name: "llm-evals-get-suite-leaderboard",
+  description: `Get the coding-agent leaderboard for an eval suite
+
+Ranks the suite's completed coding-agent runs, one row per (agent, model, effort). Only runs that recorded an \`agent_name\` participate — a QA or transcription run of the same suite has no agent to attribute a score to and is not a board row. \`accuracy\` is the mean of \`metric\` (default \`reward\`) over the row's scored trials, and \`accuracy_ci\` is the 95% Wald interval around it; both are derived per request rather than stored, so rerunning a failed trial moves them instead of leaving a stale copy behind. \`agent_version\` is reported but is not part of the row identity, so an agent upgrade does not split a row in two. Rows are ordered by accuracy descending, nulls last. Pass \`suite_version\` when the suite has more than one, otherwise the board mixes task sets.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await llmEvalsGetSuiteLeaderboard(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { llmEvalsImportAgentRun } from "../../funcs/llmEvalsImportAgentRun.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.ImportAgentEvalRunRequest$inboundSchema,
+};
+
+export const tool$llmEvalsImportAgentRun: ToolDefinition<typeof args> = {
+  name: "llm-evals-import-agent-run",
+  description: `Import a finished coding-agent run
+
+Uploads one completed harness job — the run and its trials — directly, so results never round-trip through external storage the way the Hugging Face importer does. Every \`task_id\` must already exist in the target suite version's manifest; unknown ids are rejected rather than invented, because a typo would otherwise import as a task the suite does not have and read as a model that never covered the version. The run is recorded as \`completed\` and is not executed: this is a write, not a run request, so no workflow is started. Trials that cover every task of the version get \`task_ids: null\`, which is what lets the run rank as a complete sweep. Trajectories are NOT part of this payload — a full 91-task run measured 8.3 MB of them — so upload each one against \`PUT /evals/runs/{run_id}/samples/{sample_index}/trajectory\` afterwards. Pass \`idempotency_key\` and a retried upload returns the first run instead of doubling the trials behind a board row.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await llmEvalsImportAgentRun(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

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

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { llmEvalsUploadSampleTrajectory } from "../../funcs/llmEvalsUploadSampleTrajectory.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.UploadEvalSampleTrajectoryRequest$inboundSchema,
+};
+
+export const tool$llmEvalsUploadSampleTrajectory: ToolDefinition<typeof args> =
+  {
+    name: "llm-evals-upload-sample-trajectory",
+    description: `Upload an eval sample trajectory
+
+Stores one coding-agent trial's session, in whatever interchange format the harness produced (record it in \`schema_version\`, e.g. \`ATIF-v1.7\`). \`steps\` is stored verbatim and never validated, so a harness format change needs no gateway release. Separate from the run import because a trajectory averages ~92 KB and a whole run's worth would not fit in one request. Upserts, so re-sending after a timeout replaces the trajectory rather than failing. Sample indices are unique per (task, model), not per run, so pass \`task_id\` and/or \`model\` when the run covers more than one — an ambiguous index returns 400 rather than writing to the wrong trial. Rejects a payload whose \`steps\` and \`logs\` together exceed 16 MiB with 413.`,
+    args,
+    tool: async (client, args, ctx) => {
+      const [result, apiCall] = await llmEvalsUploadSampleTrajectory(
+        client,
+        args.request,
+        { fetchOptions: { signal: ctx.signal } },
+      ).$inspect();
+
+      if (!result.ok) {
+        return {
+          content: [{ type: "text", text: result.error.message }],
+          isError: true,
+        };
+      }
+
+      const value = result.value;
+
+      return formatResult(value, apiCall);
+    },
+  };