@mutagent/sdk 0.3.36 → 0.3.38

package/src/funcs/traces-list-trace-spans.ts

@@ -0,0 +1,180 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { MutagentCore } from "../core.js";
+import { 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 {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/http-client-errors.js";
+import * as errors from "../models/errors/index.js";
+import { MutagentError } from "../models/errors/mutagent-error.js";
+import { ResponseValidationError } from "../models/errors/response-validation-error.js";
+import { SDKValidationError } from "../models/errors/sdk-validation-error.js";
+import * as operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Get every span of one trace
+ *
+ * @remarks
+ * Not paginated: a trace is bounded by construction, and a partial span tree is not a useful thing to hand back.
+ */
+export function tracesListTraceSpans(
+  client: MutagentCore,
+  request: operations.ListTraceSpansRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    operations.ListTraceSpansResponse,
+    | errors.ErrorMessage
+    | errors.ErrorMessageStatusCode
+    | MutagentError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: MutagentCore,
+  request: operations.ListTraceSpansRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      operations.ListTraceSpansResponse,
+      | errors.ErrorMessage
+      | errors.ErrorMessageStatusCode
+      | MutagentError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) => z.parse(operations.ListTraceSpansRequest$outboundSchema, value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    traceId: encodeSimple("traceId", payload.traceId, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path = pathToFunc("/api/traces/{traceId}/spans")(pathParams);
+
+  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: "listTraceSpans",
+    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,
+    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 responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result] = await M.match<
+    operations.ListTraceSpansResponse,
+    | errors.ErrorMessage
+    | errors.ErrorMessageStatusCode
+    | MutagentError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, operations.ListTraceSpansResponse$inboundSchema),
+    M.jsonErr([400, 401, 403, 404], errors.ErrorMessage$inboundSchema),
+    M.jsonErr(500, errors.ErrorMessageStatusCode$inboundSchema),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/funcs/traces-list-traces.ts

@@ -0,0 +1,182 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+import { MutagentCore } from "../core.js";
+import { encodeFormQuery } 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 {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/http-client-errors.js";
+import * as errors from "../models/errors/index.js";
+import { MutagentError } from "../models/errors/mutagent-error.js";
+import { ResponseValidationError } from "../models/errors/response-validation-error.js";
+import { SDKValidationError } from "../models/errors/sdk-validation-error.js";
+import * as operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * List recent traces
+ *
+ * @remarks
+ * Most recent first, keyset-paginated. Pass the previous page's nextCursor as ?cursor to continue; a null nextCursor means the last page.
+ */
+export function tracesListTraces(
+  client: MutagentCore,
+  request?: operations.ListTracesRequest | undefined,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    operations.ListTracesResponse,
+    | errors.ErrorMessage
+    | errors.ErrorMessageStatusCode
+    | MutagentError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: MutagentCore,
+  request?: operations.ListTracesRequest | undefined,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      operations.ListTracesResponse,
+      | errors.ErrorMessage
+      | errors.ErrorMessageStatusCode
+      | MutagentError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      z.parse(z.optional(operations.ListTracesRequest$outboundSchema), value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const path = pathToFunc("/api/traces/")();
+
+  const query = encodeFormQuery({
+    "cursor": payload?.cursor,
+    "limit": payload?.limit,
+    "sessionId": payload?.sessionId,
+  });
+
+  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: "listTraces",
+    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,
+    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 responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result] = await M.match<
+    operations.ListTracesResponse,
+    | errors.ErrorMessage
+    | errors.ErrorMessageStatusCode
+    | MutagentError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, operations.ListTracesResponse$inboundSchema),
+    M.jsonErr([400, 401, 403, 404], errors.ErrorMessage$inboundSchema),
+    M.jsonErr(500, errors.ErrorMessageStatusCode$inboundSchema),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/lib/config.ts

@@ -13,9 +13,9 @@ import { Params, pathToFunc } from "./url.js";
  */
 export const ServerList = [
   /**
-   * Production server
+   * Development server
    */
-  "https://api.mutagent.io",
+  "http://localhost:3007",
 ] as const;
 
 export type SDKOptions = {
@@ -65,7 +65,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "2.0.0",
-  sdkVersion: "0.3.36",
+  sdkVersion: "0.3.38",
   genVersion: "2.935.1",
-  userAgent: "speakeasy-sdk/typescript 0.3.36 2.935.1 2.0.0 @mutagent/sdk",
+  userAgent: "speakeasy-sdk/typescript 0.3.38 2.935.1 2.0.0 @mutagent/sdk",
 } as const;

package/src/models/array-of-trace-id-session-id-name.ts

@@ -0,0 +1,103 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+
+export type Span = {
+  spanId: string;
+  name: string;
+  kind?: string | undefined;
+  startTime: string;
+  endTime?: string | undefined;
+  status?: string | undefined;
+  input?: string | undefined;
+  output?: string | undefined;
+  parentSpanId?: string | null | undefined;
+  metadata?: { [k: string]: any } | undefined;
+};
+
+export type ArrayOfTraceIdSessionIdName = {
+  traceId: string;
+  sessionId?: string | undefined;
+  name?: string | undefined;
+  source?: string | undefined;
+  startTime: string;
+  endTime?: string | undefined;
+  status?: string | undefined;
+  spans?: Array<Span> | undefined;
+  metadata?: { [k: string]: any } | undefined;
+};
+
+/** @internal */
+export type Span$Outbound = {
+  spanId: string;
+  name: string;
+  kind?: string | undefined;
+  startTime: string;
+  endTime?: string | undefined;
+  status?: string | undefined;
+  input?: string | undefined;
+  output?: string | undefined;
+  parentSpanId?: string | null | undefined;
+  metadata?: { [k: string]: any } | undefined;
+};
+
+/** @internal */
+export const Span$outboundSchema: z.ZodMiniType<Span$Outbound, Span> = z.object(
+  {
+    spanId: z.string(),
+    name: z.string(),
+    kind: z.optional(z.string()),
+    startTime: z.string(),
+    endTime: z.optional(z.string()),
+    status: z.optional(z.string()),
+    input: z.optional(z.string()),
+    output: z.optional(z.string()),
+    parentSpanId: z.optional(z.nullable(z.string())),
+    metadata: z.optional(z.record(z.string(), z.any())),
+  },
+);
+
+export function spanToJSON(span: Span): string {
+  return JSON.stringify(Span$outboundSchema.parse(span));
+}
+
+/** @internal */
+export type ArrayOfTraceIdSessionIdName$Outbound = {
+  traceId: string;
+  sessionId?: string | undefined;
+  name?: string | undefined;
+  source?: string | undefined;
+  startTime: string;
+  endTime?: string | undefined;
+  status?: string | undefined;
+  spans?: Array<Span$Outbound> | undefined;
+  metadata?: { [k: string]: any } | undefined;
+};
+
+/** @internal */
+export const ArrayOfTraceIdSessionIdName$outboundSchema: z.ZodMiniType<
+  ArrayOfTraceIdSessionIdName$Outbound,
+  ArrayOfTraceIdSessionIdName
+> = z.object({
+  traceId: z.string(),
+  sessionId: z.optional(z.string()),
+  name: z.optional(z.string()),
+  source: z.optional(z.string()),
+  startTime: z.string(),
+  endTime: z.optional(z.string()),
+  status: z.optional(z.string()),
+  spans: z.optional(z.array(z.lazy(() => Span$outboundSchema))),
+  metadata: z.optional(z.record(z.string(), z.any())),
+});
+
+export function arrayOfTraceIdSessionIdNameToJSON(
+  arrayOfTraceIdSessionIdName: ArrayOfTraceIdSessionIdName,
+): string {
+  return JSON.stringify(
+    ArrayOfTraceIdSessionIdName$outboundSchema.parse(
+      arrayOfTraceIdSessionIdName,
+    ),
+  );
+}

package/src/models/command-cwd-timeout-ms.ts

@@ -0,0 +1,36 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4-mini";
+
+export type CommandCwdTimeoutMs = {
+  command: Array<string>;
+  cwd?: string | undefined;
+  timeoutMs?: number | undefined;
+};
+
+/** @internal */
+export type CommandCwdTimeoutMs$Outbound = {
+  command: Array<string>;
+  cwd?: string | undefined;
+  timeoutMs?: number | undefined;
+};
+
+/** @internal */
+export const CommandCwdTimeoutMs$outboundSchema: z.ZodMiniType<
+  CommandCwdTimeoutMs$Outbound,
+  CommandCwdTimeoutMs
+> = z.object({
+  command: z.array(z.string()),
+  cwd: z.optional(z.string()),
+  timeoutMs: z.optional(z.number()),
+});
+
+export function commandCwdTimeoutMsToJSON(
+  commandCwdTimeoutMs: CommandCwdTimeoutMs,
+): string {
+  return JSON.stringify(
+    CommandCwdTimeoutMs$outboundSchema.parse(commandCwdTimeoutMs),
+  );
+}