@dalmia/calibrate-mcp 0.0.34 → 0.0.35

package/src/funcs/tracesCreate.ts

@@ -0,0 +1,148 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { CalibrateMcpCore } from "../core.js";
+import { encodeJSON, 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 {
+  IngestTraceTracesPostRequest,
+  IngestTraceTracesPostRequest$zodSchema,
+} from "../models/ingesttracetracespostop.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Create trace
+ *
+ * @remarks
+ * Store a production agent turn and its conversation history for later review
+ */
+export function tracesCreate(
+  client$: CalibrateMcpCore,
+  request: IngestTraceTracesPostRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    Response,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >
+> {
+  return new APIPromise($do(
+    client$,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client$: CalibrateMcpCore,
+  request: IngestTraceTracesPostRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      Response,
+      | APIError
+      | SDKValidationError
+      | UnexpectedClientError
+      | InvalidRequestError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | ConnectionError
+    >,
+    APICall,
+  ]
+> {
+  const parsed$ = safeParse(
+    request,
+    (value$) => IngestTraceTracesPostRequest$zodSchema.parse(value$),
+    "Input validation failed",
+  );
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = encodeJSON("body", payload$.body, { explode: true });
+  const path$ = pathToFunc("/traces")();
+
+  const headers$ = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json",
+    "X-API-Key": encodeSimple("X-API-Key", payload$.xAPIKey, {
+      explode: false,
+      charEncoding: "none",
+    }),
+  }));
+  const securityInput = await extractSecurity(client$._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client$._options,
+    baseURL: options?.serverURL ?? client$._baseURL ?? "",
+    operationID: "ingest_trace_traces_post",
+    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

@@ -930,7 +930,7 @@ http_headers = { "api-key-auth" = "YOUR_API_KEY_AUTH" }`;
         <h1>Instructions</h1>
         <p>One-click installation for Claude Desktop users</p>
         <div class="instruction-item">
-          <a href="https://github.com/dalmia/calibrate-mcp/releases/download/v0.0.34/mcp-server.mcpb" download="mcp-server.mcpb" class="action-button header-action" style="display: inline-flex; margin-bottom: 16px;">
+          <a href="https://github.com/dalmia/calibrate-mcp/releases/download/v0.0.35/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

@@ -65,8 +65,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "0.1.0",
-  sdkVersion: "0.0.34",
+  sdkVersion: "0.0.35",
   genVersion: "2.915.1",
   userAgent:
-    "speakeasy-sdk/mcp-typescript 0.0.34 2.915.1 0.1.0 @dalmia/calibrate-mcp",
+    "speakeasy-sdk/mcp-typescript 0.0.35 2.915.1 0.1.0 @dalmia/calibrate-mcp",
 } as const;

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

@@ -21,7 +21,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.0.34",
+    currentVersion: "0.0.35",
   },
 });
 

package/src/mcp-server/server.ts

@@ -55,6 +55,7 @@ import { tool$testsCreate } from "./tools/testsCreate.js";
 import { tool$testsGet } from "./tools/testsGet.js";
 import { tool$testsList } from "./tools/testsList.js";
 import { tool$testsUpdate } from "./tools/testsUpdate.js";
+import { tool$tracesCreate } from "./tools/tracesCreate.js";
 
 export function createMCPServer(deps: {
   logger: ConsoleLogger;
@@ -69,7 +70,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "CalibrateMcp",
-    version: "0.0.34",
+    version: "0.0.35",
   });
 
   const getClient = deps.getSDK || (() =>
@@ -152,6 +153,7 @@ export function createMCPServer(deps: {
   tool(tool$annotatorsCreate);
   tool(tool$annotatorsList);
   tool(tool$annotatorsUpdate);
+  tool(tool$tracesCreate);
 
   if (deps.dynamic) {
     registerDynamicTools(deps.logger, server, getClient, toolMap, scopes);

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

@@ -0,0 +1,47 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { tracesCreate } from "../../funcs/tracesCreate.js";
+import { IngestTraceTracesPostRequest$zodSchema } from "../../models/ingesttracetracespostop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: IngestTraceTracesPostRequest$zodSchema,
+};
+
+export const tool$tracesCreate: ToolDefinition<typeof args> = {
+  name: "create-trace",
+  description:
+    `Store one production agent turn against an agent in the caller's org:
+the conversation history as input, what the agent produced as output,
+and optional metadata. Use this to capture live traffic for later
+review and conversion into tests. Fails with 429 once the workspace
+hits its trace limit.
+`,
+  scopes: ["write"],
+  annotations: {
+    "title": "Create trace",
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": true,
+    "readOnlyHint": false,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result] = await tracesCreate(
+      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/ingesttracetracespostop.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  HTTPValidationError,
+  HTTPValidationError$zodSchema,
+} from "./httpvalidationerror.js";
+import { TraceIngest, TraceIngest$zodSchema } from "./traceingest.js";
+import {
+  TraceIngestResponse,
+  TraceIngestResponse$zodSchema,
+} from "./traceingestresponse.js";
+
+export type IngestTraceTracesPostRequest = {
+  xAPIKey?: string | null | undefined;
+  body: TraceIngest;
+};
+
+export const IngestTraceTracesPostRequest$zodSchema: z.ZodType<
+  IngestTraceTracesPostRequest
+> = z.object({
+  body: TraceIngest$zodSchema,
+  xAPIKey: z.string().nullable().optional(),
+});
+
+export type IngestTraceTracesPostResponse =
+  | TraceIngestResponse
+  | HTTPValidationError;
+
+export const IngestTraceTracesPostResponse$zodSchema: z.ZodType<
+  IngestTraceTracesPostResponse
+> = z.union([
+  TraceIngestResponse$zodSchema,
+  HTTPValidationError$zodSchema,
+]);

package/src/models/traceingest.ts

@@ -0,0 +1,40 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  TraceMetadataEntry,
+  TraceMetadataEntry$zodSchema,
+} from "./tracemetadataentry.js";
+import { TraceOutput, TraceOutput$zodSchema } from "./traceoutput.js";
+import { TraceTurn, TraceTurn$zodSchema } from "./traceturn.js";
+
+export type TraceIngest = {
+  agent_id: string;
+  message_id?: string | null | undefined;
+  conversation_id?: string | null | undefined;
+  input: Array<TraceTurn>;
+  output: TraceOutput;
+  metadata?: Array<TraceMetadataEntry> | null | undefined;
+};
+
+export const TraceIngest$zodSchema: z.ZodType<TraceIngest> = z.object({
+  agent_id: z.string().describe(
+    "ID of the agent that produced the turn. Must be an agent in your workspace",
+  ),
+  conversation_id: z.string().nullable().optional().describe(
+    "Your own ID for the conversation this turn belongs to, stored for reference only. Omit if you have none",
+  ),
+  input: z.array(TraceTurn$zodSchema).describe(
+    "Conversation history up to the reported output, oldest turn first, in OpenAI chat format",
+  ),
+  message_id: z.string().nullable().optional().describe(
+    "Your own ID for the last user message in `input`, stored for reference only. Omit if you have none",
+  ),
+  metadata: z.array(TraceMetadataEntry$zodSchema).nullable().optional()
+    .describe(
+      "Key-value pairs stored with the trace. Prefer OTel `gen_ai.*` key names where they fit. Omit if you have none",
+    ),
+  output: TraceOutput$zodSchema,
+});

package/src/models/traceingestresponse.ts

@@ -0,0 +1,26 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type TraceIngestResponse = {
+  uuid: string;
+  message_id?: string | null | undefined;
+  conversation_id?: string | null | undefined;
+  created_at: string;
+};
+
+export const TraceIngestResponse$zodSchema: z.ZodType<TraceIngestResponse> = z
+  .object({
+    conversation_id: z.string().nullable().optional().describe(
+      "The conversation ID you sent, if any",
+    ),
+    created_at: z.string().describe(
+      "When the trace was created (ISO 8601 UTC)",
+    ),
+    message_id: z.string().nullable().optional().describe(
+      "The message ID you sent, if any",
+    ),
+    uuid: z.string().describe("Unique ID for the trace"),
+  });

package/src/models/tracemetadataentry.ts

@@ -0,0 +1,13 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type TraceMetadataEntry = { key: string; value: string };
+
+export const TraceMetadataEntry$zodSchema: z.ZodType<TraceMetadataEntry> = z
+  .object({
+    key: z.string().describe("Name of the metadata entry"),
+    value: z.string().describe("Value of the metadata entry"),
+  });

package/src/models/traceoutput.ts

@@ -0,0 +1,20 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { TraceToolCall, TraceToolCall$zodSchema } from "./tracetoolcall.js";
+
+export type TraceOutput = {
+  response?: string | null | undefined;
+  tool_calls?: Array<TraceToolCall> | null | undefined;
+};
+
+export const TraceOutput$zodSchema: z.ZodType<TraceOutput> = z.object({
+  response: z.string().nullable().optional().describe(
+    "The assistant reply text for this turn. Omit for turns that only issued tool calls",
+  ),
+  tool_calls: z.array(TraceToolCall$zodSchema).nullable().optional().describe(
+    "Tool calls the agent issued for this turn. Omit for plain text replies",
+  ),
+});

package/src/models/tracetoolcall.ts

@@ -0,0 +1,17 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type TraceToolCall = {
+  tool: string;
+  arguments?: { [k: string]: any } | null | undefined;
+};
+
+export const TraceToolCall$zodSchema: z.ZodType<TraceToolCall> = z.object({
+  arguments: z.record(z.string(), z.any()).nullable().optional().describe(
+    "Argument values the agent passed to the tool. Omit when the call had none",
+  ),
+  tool: z.string().describe("Name of the tool the agent called"),
+});

package/src/models/traceturn.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { collectExtraKeys as collectExtraKeys$ } from "../lib/schemas.js";
+
+export type TraceTurn = {
+  role: string;
+  content?: string | null | undefined;
+  AdditionalProperties?: { [k: string]: any };
+};
+
+export const TraceTurn$zodSchema: z.ZodType<TraceTurn> = collectExtraKeys$(
+  z.object({
+    content: z.string().nullable().optional().describe(
+      "Message text. Omit for turns that only carry tool calls",
+    ),
+    role: z.string().describe(
+      "Message author role in the conversation history",
+    ),
+  }).catchall(z.any()),
+  "AdditionalProperties",
+  true,
+);
+
+export const TraceTurn$zodSchemaOutbound: z.ZodType<any> = z.object({
+  AdditionalProperties: z.record(z.string(), z.any()).optional(),
+  content: z.nullable(z.string()).optional(),
+  role: z.string(),
+}).transform((v) => {
+  const { AdditionalProperties, ...rest } = v;
+  return {
+    ...rest,
+    ...AdditionalProperties,
+  };
+});

package/src/tool-names.ts

@@ -151,5 +151,9 @@ export const toolNames: Array<{ name: string; description: string }>= [
   {
     "name": "update-annotator",
     "description": "Rename an annotator in your workspace.\n"
+  },
+  {
+    "name": "create-trace",
+    "description": "Store one production agent turn against an agent in the caller's org:\nthe conversation history as input, what the agent produced as output,\nand optional metadata. Use this to capture live traffic for later\nreview and conversion into tests. Fails with 429 once the workspace\nhits its trace limit.\n"
   }
 ];