phenoml 13.0.0 → 14.0.0

package/dist/esm/api/resources/tools/types/McpServer.d.mts

@@ -0,0 +1,10 @@
+export interface McpServer {
+    /** ID of the MCP server */
+    id?: string | undefined;
+    /** Name of the MCP server */
+    name?: string | undefined;
+    /** Description of the MCP server */
+    description?: string | undefined;
+    /** URL of the MCP server */
+    mcp_server_url?: string | undefined;
+}

package/dist/esm/api/resources/tools/types/McpServerResponse.d.mts

@@ -1,23 +1,19 @@
+import type * as phenoml from "../../../index.mjs";
 export interface McpServerResponse {
-    /** Whether the MCP server was created successfully */
+    /** Whether the operation succeeded */
     success?: boolean | undefined;
     /** Status message */
     message?: string | undefined;
-    /** MCP server data */
-    data?: McpServerResponse.Data | undefined;
-}
-export declare namespace McpServerResponse {
+    /** Single MCP server (returned by GET /tools/mcp-server/{mcp_server_id}). */
+    data?: phenoml.tools.McpServer | undefined;
+    /**
+     * List of MCP servers. Returned by /tools/mcp-server/create (the
+     * newly created server) and /tools/mcp-server/list (all servers).
+     */
+    mcp_servers?: phenoml.tools.McpServer[] | undefined;
     /**
-     * MCP server data
+     * Tools loaded from the MCP server. Returned by /tools/mcp-server/create
+     * alongside the server record, since tool discovery happens at create time.
      */
-    interface Data {
-        /** ID of the MCP server */
-        id?: string | undefined;
-        /** Name of the MCP server */
-        name?: string | undefined;
-        /** Description of the MCP server */
-        description?: string | undefined;
-        /** URL of the MCP server */
-        mcp_server_url?: string | undefined;
-    }
+    mcp_server_tools?: phenoml.tools.McpServerTool[] | undefined;
 }

package/dist/esm/api/resources/tools/types/McpServerTool.d.mts

@@ -0,0 +1,14 @@
+export interface McpServerTool {
+    /** ID of the MCP server tool */
+    id?: string | undefined;
+    /** Name of the MCP server tool */
+    name?: string | undefined;
+    /** Description of the MCP server tool */
+    description?: string | undefined;
+    /** Input schema of the MCP server tool */
+    input_schema?: Record<string, unknown> | undefined;
+    /** ID of the MCP server that the tool belongs to */
+    mcp_server_id?: string | undefined;
+    /** URL of the MCP server */
+    mcp_server_url?: string | undefined;
+}

package/dist/esm/api/resources/tools/types/McpServerToolResponse.d.mts

@@ -1,27 +1,14 @@
+import type * as phenoml from "../../../index.mjs";
 export interface McpServerToolResponse {
-    /** Whether the MCP server tool was created successfully */
+    /** Whether the operation succeeded */
     success?: boolean | undefined;
     /** Status message */
     message?: string | undefined;
-    /** MCP server tool data */
-    data?: McpServerToolResponse.Data | undefined;
-}
-export declare namespace McpServerToolResponse {
+    /** Single MCP server tool (returned by GET /tools/mcp-server/tool/{mcp_server_tool_id}). */
+    data?: phenoml.tools.McpServerTool | undefined;
     /**
-     * MCP server tool data
+     * List of MCP server tools. Returned by
+     * /tools/mcp-server/{mcp_server_id}/list.
      */
-    interface Data {
-        /** ID of the MCP server tool */
-        id?: string | undefined;
-        /** Name of the MCP server tool */
-        name?: string | undefined;
-        /** Description of the MCP server tool */
-        description?: string | undefined;
-        /** Input schema of the MCP server tool */
-        input_schema?: Record<string, unknown> | undefined;
-        /** ID of the MCP server that the tool belongs to */
-        mcp_server_id?: string | undefined;
-        /** URL of the MCP server */
-        mcp_server_url?: string | undefined;
-    }
+    mcp_server_tools?: phenoml.tools.McpServerTool[] | undefined;
 }

package/dist/esm/api/resources/tools/types/index.d.mts

@@ -2,7 +2,9 @@ export * from "./CohortResponse.mjs";
 export * from "./Lang2FhirAndCreateMultiResponse.mjs";
 export * from "./Lang2FhirAndCreateResponse.mjs";
 export * from "./Lang2FhirAndSearchResponse.mjs";
+export * from "./McpServer.mjs";
 export * from "./McpServerResponse.mjs";
+export * from "./McpServerTool.mjs";
 export * from "./McpServerToolCallResponse.mjs";
 export * from "./McpServerToolResponse.mjs";
 export * from "./SearchConcept.mjs";

package/dist/esm/api/resources/tools/types/index.mjs

@@ -2,7 +2,9 @@ export * from "./CohortResponse.mjs";
 export * from "./Lang2FhirAndCreateMultiResponse.mjs";
 export * from "./Lang2FhirAndCreateResponse.mjs";
 export * from "./Lang2FhirAndSearchResponse.mjs";
+export * from "./McpServer.mjs";
 export * from "./McpServerResponse.mjs";
+export * from "./McpServerTool.mjs";
 export * from "./McpServerToolCallResponse.mjs";
 export * from "./McpServerToolResponse.mjs";
 export * from "./SearchConcept.mjs";

package/dist/esm/api/resources/workflows/client/Client.d.mts

@@ -42,11 +42,12 @@ export declare class WorkflowsClient {
      *     await client.workflows.create({
      *         verbose: true,
      *         name: "Patient Data Mapping Workflow",
-     *         workflow_instructions: "Given diagnosis data, find the patient and create condition record",
+     *         workflow_instructions: "Given diagnosis data, find the patient and create a condition record linked to their encounter",
      *         sample_data: {
      *             "patient_last_name": "Rippin",
      *             "patient_first_name": "Clay",
-     *             "diagnosis_code": "I10"
+     *             "diagnosis_code": "I10",
+     *             "encounter_date": "2024-01-15"
      *         },
      *         fhir_provider_id: "550e8400-e29b-41d4-a716-446655440000"
      *     })
@@ -88,12 +89,13 @@ export declare class WorkflowsClient {
      * @example
      *     await client.workflows.update("id", {
      *         verbose: true,
-     *         name: "Updated Patient Data Mapping Workflow",
-     *         workflow_instructions: "Given diagnosis data, find the patient and create condition record",
+     *         name: "Patient Data Mapping Workflow (v2)",
+     *         workflow_instructions: "Given diagnosis data, find the patient and create a condition record linked to their encounter",
      *         sample_data: {
-     *             "patient_last_name": "Smith",
-     *             "patient_first_name": "John",
-     *             "diagnosis_code": "E11"
+     *             "patient_last_name": "Rippin",
+     *             "patient_first_name": "Clay",
+     *             "diagnosis_code": "I10",
+     *             "encounter_date": "2024-01-15"
      *         },
      *         fhir_provider_id: "550e8400-e29b-41d4-a716-446655440000"
      *     })
@@ -130,14 +132,24 @@ export declare class WorkflowsClient {
      * @throws {@link phenoml.workflows.InternalServerError}
      *
      * @example
-     *     await client.workflows.execute("id", {
+     *     await client.workflows.execute("7a8b9c0d-1234-5678-abcd-ef9876543210", {
      *         input_data: {
      *             "patient_last_name": "Johnson",
      *             "patient_first_name": "Mary",
      *             "diagnosis_code": "M79.3",
-     *             "encounter_date": "2024-01-15"
+     *             "encounter_date": "2024-03-20"
      *         }
      *     })
+     *
+     * @example
+     *     await client.workflows.execute("7a8b9c0d-1234-5678-abcd-ef9876543210", {
+     *         input_data: {
+     *             "patient_last_name": "Johnson",
+     *             "patient_first_name": "Mary",
+     *             "diagnosis_code": "M79.3"
+     *         },
+     *         preview: true
+     *     })
      */
     execute(id: string, request: phenoml.workflows.ExecuteWorkflowRequest, requestOptions?: WorkflowsClient.RequestOptions): core.HttpResponsePromise<phenoml.workflows.ExecuteWorkflowResponse>;
     private __execute;

package/dist/esm/api/resources/workflows/client/Client.mjs

@@ -61,7 +61,11 @@ export class WorkflowsClient {
                 url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.phenomlEnvironment.Default, "workflows"),
                 method: "GET",
                 headers: _headers,
-                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                queryString: core.url
+                    .queryBuilder()
+                    .addMany(_queryParams)
+                    .mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams)
+                    .build(),
                 timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
                 maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -108,11 +112,12 @@ export class WorkflowsClient {
      *     await client.workflows.create({
      *         verbose: true,
      *         name: "Patient Data Mapping Workflow",
-     *         workflow_instructions: "Given diagnosis data, find the patient and create condition record",
+     *         workflow_instructions: "Given diagnosis data, find the patient and create a condition record linked to their encounter",
      *         sample_data: {
      *             "patient_last_name": "Rippin",
      *             "patient_first_name": "Clay",
-     *             "diagnosis_code": "I10"
+     *             "diagnosis_code": "I10",
+     *             "encounter_date": "2024-01-15"
      *         },
      *         fhir_provider_id: "550e8400-e29b-41d4-a716-446655440000"
      *     })
@@ -134,7 +139,11 @@ export class WorkflowsClient {
                 method: "POST",
                 headers: _headers,
                 contentType: "application/json",
-                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                queryString: core.url
+                    .queryBuilder()
+                    .addMany(_queryParams)
+                    .mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams)
+                    .build(),
                 requestType: "json",
                 body: _body,
                 timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
@@ -203,7 +212,11 @@ export class WorkflowsClient {
                 url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.phenomlEnvironment.Default, `workflows/${core.url.encodePathParam(id)}`),
                 method: "GET",
                 headers: _headers,
-                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                queryString: core.url
+                    .queryBuilder()
+                    .addMany(_queryParams)
+                    .mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams)
+                    .build(),
                 timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
                 maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -253,12 +266,13 @@ export class WorkflowsClient {
      * @example
      *     await client.workflows.update("id", {
      *         verbose: true,
-     *         name: "Updated Patient Data Mapping Workflow",
-     *         workflow_instructions: "Given diagnosis data, find the patient and create condition record",
+     *         name: "Patient Data Mapping Workflow (v2)",
+     *         workflow_instructions: "Given diagnosis data, find the patient and create a condition record linked to their encounter",
      *         sample_data: {
-     *             "patient_last_name": "Smith",
-     *             "patient_first_name": "John",
-     *             "diagnosis_code": "E11"
+     *             "patient_last_name": "Rippin",
+     *             "patient_first_name": "Clay",
+     *             "diagnosis_code": "I10",
+     *             "encounter_date": "2024-01-15"
      *         },
      *         fhir_provider_id: "550e8400-e29b-41d4-a716-446655440000"
      *     })
@@ -280,7 +294,11 @@ export class WorkflowsClient {
                 method: "PUT",
                 headers: _headers,
                 contentType: "application/json",
-                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                queryString: core.url
+                    .queryBuilder()
+                    .addMany(_queryParams)
+                    .mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams)
+                    .build(),
                 requestType: "json",
                 body: _body,
                 timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
@@ -344,7 +362,7 @@ export class WorkflowsClient {
                 url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.phenomlEnvironment.Default, `workflows/${core.url.encodePathParam(id)}`),
                 method: "DELETE",
                 headers: _headers,
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
                 timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
                 maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
@@ -392,14 +410,24 @@ export class WorkflowsClient {
      * @throws {@link phenoml.workflows.InternalServerError}
      *
      * @example
-     *     await client.workflows.execute("id", {
+     *     await client.workflows.execute("7a8b9c0d-1234-5678-abcd-ef9876543210", {
      *         input_data: {
      *             "patient_last_name": "Johnson",
      *             "patient_first_name": "Mary",
      *             "diagnosis_code": "M79.3",
-     *             "encounter_date": "2024-01-15"
+     *             "encounter_date": "2024-03-20"
      *         }
      *     })
+     *
+     * @example
+     *     await client.workflows.execute("7a8b9c0d-1234-5678-abcd-ef9876543210", {
+     *         input_data: {
+     *             "patient_last_name": "Johnson",
+     *             "patient_first_name": "Mary",
+     *             "diagnosis_code": "M79.3"
+     *         },
+     *         preview: true
+     *     })
      */
     execute(id, request, requestOptions) {
         return core.HttpResponsePromise.fromPromise(this.__execute(id, request, requestOptions));
@@ -414,7 +442,7 @@ export class WorkflowsClient {
                 method: "POST",
                 headers: _headers,
                 contentType: "application/json",
-                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                queryString: core.url.queryBuilder().mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams).build(),
                 requestType: "json",
                 body: request,
                 timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,

package/dist/esm/api/resources/workflows/client/requests/CreateWorkflowRequest.d.mts

@@ -3,11 +3,12 @@
  *     {
  *         verbose: true,
  *         name: "Patient Data Mapping Workflow",
- *         workflow_instructions: "Given diagnosis data, find the patient and create condition record",
+ *         workflow_instructions: "Given diagnosis data, find the patient and create a condition record linked to their encounter",
  *         sample_data: {
  *             "patient_last_name": "Rippin",
  *             "patient_first_name": "Clay",
- *             "diagnosis_code": "I10"
+ *             "diagnosis_code": "I10",
+ *             "encounter_date": "2024-01-15"
  *         },
  *         fhir_provider_id: "550e8400-e29b-41d4-a716-446655440000"
  *     }

package/dist/esm/api/resources/workflows/client/requests/ExecuteWorkflowRequest.d.mts

@@ -5,9 +5,19 @@
  *             "patient_last_name": "Johnson",
  *             "patient_first_name": "Mary",
  *             "diagnosis_code": "M79.3",
- *             "encounter_date": "2024-01-15"
+ *             "encounter_date": "2024-03-20"
  *         }
  *     }
+ *
+ * @example
+ *     {
+ *         input_data: {
+ *             "patient_last_name": "Johnson",
+ *             "patient_first_name": "Mary",
+ *             "diagnosis_code": "M79.3"
+ *         },
+ *         preview: true
+ *     }
  */
 export interface ExecuteWorkflowRequest {
     /** Input data for workflow execution */

package/dist/esm/api/resources/workflows/client/requests/UpdateWorkflowRequest.d.mts

@@ -2,12 +2,13 @@
  * @example
  *     {
  *         verbose: true,
- *         name: "Updated Patient Data Mapping Workflow",
- *         workflow_instructions: "Given diagnosis data, find the patient and create condition record",
+ *         name: "Patient Data Mapping Workflow (v2)",
+ *         workflow_instructions: "Given diagnosis data, find the patient and create a condition record linked to their encounter",
  *         sample_data: {
- *             "patient_last_name": "Smith",
- *             "patient_first_name": "John",
- *             "diagnosis_code": "E11"
+ *             "patient_last_name": "Rippin",
+ *             "patient_first_name": "Clay",
+ *             "diagnosis_code": "I10",
+ *             "encounter_date": "2024-01-15"
  *         },
  *         fhir_provider_id: "550e8400-e29b-41d4-a716-446655440000"
  *     }

package/dist/esm/core/auth/AuthProvider.d.mts

@@ -5,3 +5,4 @@ export interface AuthProvider {
         endpointMetadata?: EndpointMetadata;
     }): Promise<AuthRequest>;
 }
+export declare function isAuthProvider(value: unknown): value is AuthProvider;

package/dist/esm/core/auth/AuthProvider.mjs

@@ -1 +1,6 @@
-export {};
+export function isAuthProvider(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "getAuthRequest" in value &&
+        typeof value.getAuthRequest === "function");
+}

package/dist/esm/core/auth/BasicAuth.d.mts

@@ -1,6 +1,6 @@
 export interface BasicAuth {
-    username: string;
-    password: string;
+    username?: string;
+    password?: string;
 }
 export declare const BasicAuth: {
     toAuthorizationHeader: (basicAuth: BasicAuth | undefined) => string | undefined;

package/dist/esm/core/auth/BasicAuth.mjs

@@ -2,10 +2,16 @@ import { base64Decode, base64Encode } from "../base64.mjs";
 const BASIC_AUTH_HEADER_PREFIX = /^Basic /i;
 export const BasicAuth = {
     toAuthorizationHeader: (basicAuth) => {
+        var _a, _b;
         if (basicAuth == null) {
             return undefined;
         }
-        const token = base64Encode(`${basicAuth.username}:${basicAuth.password}`);
+        const username = (_a = basicAuth.username) !== null && _a !== void 0 ? _a : "";
+        const password = (_b = basicAuth.password) !== null && _b !== void 0 ? _b : "";
+        if (username === "" && password === "") {
+            return undefined;
+        }
+        const token = base64Encode(`${username}:${password}`);
         return `Basic ${token}`;
     },
     fromAuthorizationHeader: (header) => {

package/dist/esm/core/auth/index.d.mts

@@ -1,4 +1,4 @@
-export type { AuthProvider } from "./AuthProvider.mjs";
+export { type AuthProvider, isAuthProvider } from "./AuthProvider.mjs";
 export type { AuthRequest } from "./AuthRequest.mjs";
 export { BasicAuth } from "./BasicAuth.mjs";
 export { BearerToken } from "./BearerToken.mjs";

package/dist/esm/core/auth/index.mjs

@@ -1,3 +1,4 @@
+export { isAuthProvider } from "./AuthProvider.mjs";
 export { BasicAuth } from "./BasicAuth.mjs";
 export { BearerToken } from "./BearerToken.mjs";
 export { NoOpAuthProvider } from "./NoOpAuthProvider.mjs";

package/dist/esm/core/fetcher/Fetcher.d.mts

@@ -8,7 +8,13 @@ export declare namespace Fetcher {
         method: string;
         contentType?: string;
         headers?: Record<string, unknown>;
+        /**
+         * @deprecated Prefer `queryString` (produced by `core.url.queryBuilder()`).
+         * Retained for backwards compatibility with custom fetchers and callers that
+         * still construct request args with a query-parameter object.
+         */
         queryParameters?: Record<string, unknown>;
+        queryString?: string;
         body?: unknown;
         timeoutMs?: number;
         maxRetries?: number;
@@ -38,10 +44,12 @@ export declare namespace Fetcher {
     }
     interface TimeoutError {
         reason: "timeout";
+        cause?: unknown;
     }
     interface UnknownError {
         reason: "unknown";
         errorMessage: string;
+        cause?: unknown;
     }
 }
 export declare function fetcherImpl<R = unknown>(args: Fetcher.Args): Promise<APIResponse<R, Fetcher.Error>>;

package/dist/esm/core/fetcher/Fetcher.mjs

@@ -71,16 +71,11 @@ const SENSITIVE_QUERY_PARAMS = new Set([
 ]);
 function redactQueryParameters(queryParameters) {
     if (queryParameters == null) {
-        return queryParameters;
+        return undefined;
     }
     const redacted = {};
     for (const [key, value] of Object.entries(queryParameters)) {
-        if (SENSITIVE_QUERY_PARAMS.has(key.toLowerCase())) {
-            redacted[key] = "[REDACTED]";
-        }
-        else {
-            redacted[key] = value;
-        }
+        redacted[key] = SENSITIVE_QUERY_PARAMS.has(key.toLowerCase()) ? "[REDACTED]" : value;
     }
     return redacted;
 }
@@ -182,7 +177,13 @@ function getHeaders(args) {
 export function fetcherImpl(args) {
     return __awaiter(this, void 0, void 0, function* () {
         var _a, _b, _c;
-        const url = createRequestUrl(args.url, args.queryParameters);
+        let url = args.url;
+        if (args.queryString != null && args.queryString.length > 0) {
+            url = `${url}?${args.queryString}`;
+        }
+        else {
+            url = createRequestUrl(args.url, args.queryParameters);
+        }
         const requestBody = yield getRequestBody({
             body: args.body,
             type: (_a = args.requestType) !== null && _a !== void 0 ? _a : "other",
@@ -257,6 +258,7 @@ export function fetcherImpl(args) {
                     error: {
                         reason: "unknown",
                         errorMessage: "The user aborted a request",
+                        cause: error,
                     },
                     rawResponse: abortRawResponse,
                 };
@@ -274,6 +276,7 @@ export function fetcherImpl(args) {
                     ok: false,
                     error: {
                         reason: "timeout",
+                        cause: error,
                     },
                     rawResponse: abortRawResponse,
                 };
@@ -292,6 +295,7 @@ export function fetcherImpl(args) {
                     error: {
                         reason: "unknown",
                         errorMessage: error.message,
+                        cause: error,
                     },
                     rawResponse: unknownRawResponse,
                 };
@@ -309,6 +313,7 @@ export function fetcherImpl(args) {
                 error: {
                     reason: "unknown",
                     errorMessage: toJson(error),
+                    cause: error,
                 },
                 rawResponse: unknownRawResponse,
             };

package/dist/esm/core/fetcher/requestWithRetries.mjs

@@ -11,6 +11,9 @@ const INITIAL_RETRY_DELAY = 1000; // in milliseconds
 const MAX_RETRY_DELAY = 60000; // in milliseconds
 const DEFAULT_MAX_RETRIES = 2;
 const JITTER_FACTOR = 0.2; // 20% random jitter
+function isRetryableStatusCode(statusCode) {
+    return [408, 429].includes(statusCode) || statusCode >= 500;
+}
 function addPositiveJitter(delay) {
     const jitterMultiplier = 1 + Math.random() * JITTER_FACTOR;
     return delay * jitterMultiplier;
@@ -50,7 +53,7 @@ export function requestWithRetries(requestFn_1) {
     return __awaiter(this, arguments, void 0, function* (requestFn, maxRetries = DEFAULT_MAX_RETRIES) {
         let response = yield requestFn();
         for (let i = 0; i < maxRetries; ++i) {
-            if ([408, 429].includes(response.status) || response.status >= 500) {
+            if (isRetryableStatusCode(response.status)) {
                 const delay = getRetryDelayFromHeaders(response, i);
                 yield new Promise((resolve) => setTimeout(resolve, delay));
                 response = yield requestFn();

package/dist/esm/core/url/QueryStringBuilder.d.mts

@@ -0,0 +1,47 @@
+/**
+ * Creates a fluent builder for constructing URL query strings.
+ *
+ * Each `.add()` call serializes its value immediately (like C#'s builder),
+ * so no format tracking is needed — the style is applied at add-time.
+ *
+ * Usage (generated code):
+ *
+ *     const qs = core.url.queryBuilder()
+ *         .add("limit", limit)
+ *         .add("tags", tags, { style: "comma" })   // explode: false
+ *         .mergeAdditional(requestOptions?.queryParams)
+ *         .build();
+ */
+export declare function queryBuilder(): QueryStringBuilder;
+declare class QueryStringBuilder {
+    private parts;
+    /**
+     * Adds a query parameter, serializing it immediately.
+     *
+     * By default arrays use "repeat" format (`key=a&key=b`).
+     * Pass `{ style: "comma" }` for OpenAPI `explode: false` parameters
+     * to get comma-separated values (`key=a,b,c`).
+     *
+     * Null / undefined values are silently skipped.
+     */
+    add(key: string, value: unknown, options?: {
+        style?: "comma";
+    }): this;
+    /**
+     * Adds multiple query parameters at once from a record.
+     * All parameters use the default "repeat" array format.
+     * Null / undefined values are silently skipped.
+     */
+    addMany(params: Record<string, unknown>): this;
+    /**
+     * Merges additional query parameters supplied at call-time via
+     * `requestOptions.queryParams`. Overrides existing keys (last-write-wins).
+     */
+    mergeAdditional(additionalParams?: Record<string, unknown>): this;
+    /**
+     * Returns the assembled query string (without the leading `?`).
+     * Returns an empty string when no parameters were added.
+     */
+    build(): string;
+}
+export {};