@mutagent/sdk 0.4.0 → 0.4.2

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.0",
-  genVersion: "2.924.0",
-  userAgent: "speakeasy-sdk/typescript 0.3.0 2.924.0 2.0.0 @mutagent/sdk",
+  sdkVersion: "0.4.2",
+  genVersion: "2.935.1",
+  userAgent: "speakeasy-sdk/typescript 0.4.2 2.935.1 2.0.0 @mutagent/sdk",
 } as const;

package/src/lib/encodings.ts

@@ -12,10 +12,41 @@ export class EncodingError extends Error {
   }
 }
 
+export type CharEncoding = "percent" | "percentExceptReserved" | "none";
+
+const reservedEscapes = /%(2[346bcf]|3[abdf]|40|5[bd])/gi;
+
+function encodeKeyChars(
+  v: string,
+  charEncoding: CharEncoding | undefined,
+): string {
+  return encodeChars(
+    v,
+    charEncoding === "percentExceptReserved" ? "percent" : charEncoding,
+  );
+}
+
+function encodeChars(
+  v: string,
+  charEncoding: CharEncoding | undefined,
+): string {
+  switch (charEncoding) {
+    case "percent":
+      return encodeURIComponent(v);
+    case "percentExceptReserved":
+      return encodeURIComponent(v).replace(
+        reservedEscapes,
+        (m) => decodeURIComponent(m),
+      );
+    default:
+      return v;
+  }
+}
+
 export function encodeMatrix(
   key: string,
   value: unknown,
-  options?: { explode?: boolean; charEncoding?: "percent" | "none" },
+  options?: { explode?: boolean; charEncoding?: CharEncoding },
 ): string | undefined {
   let out = "";
   const pairs: [string, unknown][] = options?.explode
@@ -27,7 +58,7 @@ export function encodeMatrix(
   }
 
   const encodeString = (v: string) => {
-    return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+    return encodeChars(v, options?.charEncoding);
   };
   const encodeValue = (v: unknown) => encodeString(serializeValue(v));
 
@@ -52,7 +83,7 @@ export function encodeMatrix(
       return;
     }
 
-    const keyPrefix = encodeString(pk);
+    const keyPrefix = encodeKeyChars(pk, options?.charEncoding);
     tmp = `${keyPrefix}=${encValue}`;
     // trim trailing '=' if value was empty
     if (tmp === `${keyPrefix}=`) {
@@ -73,7 +104,7 @@ export function encodeMatrix(
 export function encodeLabel(
   key: string,
   value: unknown,
-  options?: { explode?: boolean; charEncoding?: "percent" | "none" },
+  options?: { explode?: boolean; charEncoding?: CharEncoding },
 ): string | undefined {
   let out = "";
   const pairs: [string, unknown][] = options?.explode
@@ -85,7 +116,7 @@ export function encodeLabel(
   }
 
   const encodeString = (v: string) => {
-    return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+    return encodeChars(v, options?.charEncoding);
   };
   const encodeValue = (v: unknown) => encodeString(serializeValue(v));
 
@@ -103,7 +134,7 @@ export function encodeLabel(
       encValue = mapped?.join("").slice(1);
     } else {
       const k = options?.explode && isPlainObject(value)
-        ? `${encodeString(pk)}=`
+        ? `${encodeKeyChars(pk, options?.charEncoding)}=`
         : "";
       encValue = `${k}${encodeValue(pv)}`;
     }
@@ -117,14 +148,14 @@ export function encodeLabel(
 type FormEncoder = (
   key: string,
   value: unknown,
-  options?: { explode?: boolean; charEncoding?: "percent" | "none" },
+  options?: { explode?: boolean; charEncoding?: CharEncoding },
 ) => string | undefined;
 
 function formEncoder(sep: string): FormEncoder {
   return (
     key: string,
     value: unknown,
-    options?: { explode?: boolean; charEncoding?: "percent" | "none" },
+    options?: { explode?: boolean; charEncoding?: CharEncoding },
   ) => {
     let out = "";
     const pairs: [string, unknown][] = options?.explode
@@ -136,7 +167,7 @@ function formEncoder(sep: string): FormEncoder {
     }
 
     const encodeString = (v: string) => {
-      return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+      return encodeChars(v, options?.charEncoding);
     };
 
     const encodeValue = (v: unknown) => encodeString(serializeValue(v));
@@ -163,7 +194,7 @@ function formEncoder(sep: string): FormEncoder {
         return;
       }
 
-      tmp = `${encodeString(pk)}=${encValue}`;
+      tmp = `${encodeKeyChars(pk, options?.charEncoding)}=${encValue}`;
 
       // If we end up with the nothing then skip forward
       if (!tmp || tmp === "=") {
@@ -184,7 +215,7 @@ export const encodePipeDelimited = formEncoder("|");
 export function encodeBodyForm(
   key: string,
   value: unknown,
-  options?: { explode?: boolean; charEncoding?: "percent" | "none" },
+  options?: { explode?: boolean; charEncoding?: CharEncoding },
 ): string {
   let out = "";
   const pairs: [string, unknown][] = options?.explode
@@ -192,7 +223,7 @@ export function encodeBodyForm(
     : [[key, value]];
 
   const encodeString = (v: string) => {
-    return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+    return encodeChars(v, options?.charEncoding);
   };
 
   const encodeValue = (v: unknown) => encodeString(serializeValue(v));
@@ -211,7 +242,7 @@ export function encodeBodyForm(
       encValue = `${encodeValue(pv)}`;
     }
 
-    tmp = `${encodeString(pk)}=${encValue}`;
+    tmp = `${encodeKeyChars(pk, options?.charEncoding)}=${encValue}`;
 
     // If we end up with the nothing then skip forward
     if (!tmp || tmp === "=") {
@@ -227,7 +258,7 @@ export function encodeBodyForm(
 export function encodeDeepObject(
   key: string,
   value: unknown,
-  options?: { charEncoding?: "percent" | "none" },
+  options?: { charEncoding?: CharEncoding },
 ): string | undefined {
   if (value == null) {
     return;
@@ -245,7 +276,7 @@ export function encodeDeepObject(
 export function encodeDeepObjectObject(
   key: string,
   value: unknown,
-  options?: { charEncoding?: "percent" | "none" },
+  options?: { charEncoding?: CharEncoding },
 ): string | undefined {
   if (value == null) {
     return;
@@ -254,7 +285,7 @@ export function encodeDeepObjectObject(
   let out = "";
 
   const encodeString = (v: string) => {
-    return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+    return encodeChars(v, options?.charEncoding);
   };
 
   if (!isPlainObject(value)) {
@@ -278,7 +309,9 @@ export function encodeDeepObjectObject(
 
     const pairs: unknown[] = Array.isArray(cv) ? cv : [cv];
     const encoded = mapDefined(pairs, (v) => {
-      return `${encodeString(pk)}=${encodeString(serializeValue(v))}`;
+      return `${encodeKeyChars(pk, options?.charEncoding)}=${
+        encodeString(serializeValue(v))
+      }`;
     })?.join("&");
 
     out += encoded == null ? "" : `&${encoded}`;
@@ -290,25 +323,27 @@ export function encodeDeepObjectObject(
 export function encodeJSON(
   key: string,
   value: unknown,
-  options?: { explode?: boolean; charEncoding?: "percent" | "none" },
+  options?: { explode?: boolean; charEncoding?: CharEncoding },
 ): string | undefined {
   if (typeof value === "undefined") {
     return;
   }
 
   const encodeString = (v: string) => {
-    return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+    return encodeChars(v, options?.charEncoding);
   };
 
   const encVal = encodeString(JSON.stringify(value, jsonReplacer));
 
-  return options?.explode ? encVal : `${encodeString(key)}=${encVal}`;
+  return options?.explode
+    ? encVal
+    : `${encodeKeyChars(key, options?.charEncoding)}=${encVal}`;
 }
 
 export const encodeSimple = (
   key: string,
   value: unknown,
-  options?: { explode?: boolean; charEncoding?: "percent" | "none" },
+  options?: { explode?: boolean; charEncoding?: CharEncoding },
 ): string | undefined => {
   let out = "";
   const pairs: [string, unknown][] = options?.explode
@@ -320,7 +355,7 @@ export const encodeSimple = (
   }
 
   const encodeString = (v: string) => {
-    return options?.charEncoding === "percent" ? encodeURIComponent(v) : v;
+    return encodeChars(v, options?.charEncoding);
   };
   const encodeValue = (v: unknown) => encodeString(serializeValue(v));
 
@@ -426,7 +461,7 @@ export function queryJoin(...args: (string | undefined)[]): string {
 
 type QueryEncoderOptions = {
   explode?: boolean;
-  charEncoding?: "percent" | "none";
+  charEncoding?: CharEncoding;
   allowEmptyValue?: string[];
 };
 

package/src/models/agent-list.ts

@@ -8,8 +8,6 @@ import { Result as SafeParseResult } from "../types/fp.js";
 import * as types from "../types/primitives.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
 
-export type AgentListMetadata = {};
-
 export type AgentListData = {
   id: number;
   workspaceId: string;
@@ -24,7 +22,7 @@ export type AgentListData = {
   disallowedTools: Array<string> | null;
   status: string;
   isPublic: boolean;
-  metadata: AgentListMetadata | null;
+  metadata: { [k: string]: any } | null;
   tags: Array<string> | null;
   createdBy: string | null;
   createdAt: Date;
@@ -38,22 +36,6 @@ export type AgentList = {
   offset: number;
 };
 
-/** @internal */
-export const AgentListMetadata$inboundSchema: z.ZodMiniType<
-  AgentListMetadata,
-  unknown
-> = z.object({});
-
-export function agentListMetadataFromJSON(
-  jsonString: string,
-): SafeParseResult<AgentListMetadata, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => AgentListMetadata$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'AgentListMetadata' from JSON`,
-  );
-}
-
 /** @internal */
 export const AgentListData$inboundSchema: z.ZodMiniType<
   AgentListData,
@@ -72,7 +54,7 @@ export const AgentListData$inboundSchema: z.ZodMiniType<
   disallowedTools: types.nullable(z.array(types.string())),
   status: types.string(),
   isPublic: types.boolean(),
-  metadata: types.nullable(z.lazy(() => AgentListMetadata$inboundSchema)),
+  metadata: types.nullable(z.record(z.string(), z.any())),
   tags: types.nullable(z.array(types.string())),
   createdBy: types.nullable(types.string()),
   createdAt: types.date(),

package/src/models/agent.ts

@@ -8,8 +8,6 @@ import { Result as SafeParseResult } from "../types/fp.js";
 import * as types from "../types/primitives.js";
 import { SDKValidationError } from "./errors/sdk-validation-error.js";
 
-export type AgentMetadata = {};
-
 export type Agent = {
   id: number;
   workspaceId: string;
@@ -24,29 +22,13 @@ export type Agent = {
   disallowedTools: Array<string> | null;
   status: string;
   isPublic: boolean;
-  metadata: AgentMetadata | null;
+  metadata: { [k: string]: any } | null;
   tags: Array<string> | null;
   createdBy: string | null;
   createdAt: Date;
   updatedAt: Date;
 };
 
-/** @internal */
-export const AgentMetadata$inboundSchema: z.ZodMiniType<
-  AgentMetadata,
-  unknown
-> = z.object({});
-
-export function agentMetadataFromJSON(
-  jsonString: string,
-): SafeParseResult<AgentMetadata, SDKValidationError> {
-  return safeParse(
-    jsonString,
-    (x) => AgentMetadata$inboundSchema.parse(JSON.parse(x)),
-    `Failed to parse 'AgentMetadata' from JSON`,
-  );
-}
-
 /** @internal */
 export const Agent$inboundSchema: z.ZodMiniType<Agent, unknown> = z.object({
   id: types.number(),
@@ -62,7 +44,7 @@ export const Agent$inboundSchema: z.ZodMiniType<Agent, unknown> = z.object({
   disallowedTools: types.nullable(z.array(types.string())),
   status: types.string(),
   isPublic: types.boolean(),
-  metadata: types.nullable(z.lazy(() => AgentMetadata$inboundSchema)),
+  metadata: types.nullable(z.record(z.string(), z.any())),
   tags: types.nullable(z.array(types.string())),
   createdBy: types.nullable(types.string()),
   createdAt: types.date(),

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),
+  );
+}