@ai-matrx/agents 0.37.0 → 0.38.1

package/dist/index.d.cts

@@ -4,11 +4,11 @@ export { projectAgentResultForDisplay } from './presentation/result.cjs';
 export { AgentProjectionEvent, AgentProjectionOperation, AgentProjectionRenderBlock, AgentProjectionStatus, AgentProjectionTool, AgentRequestProjection, createAgentRequestProjection, projectAgentEvent, projectAgentEvents } from './projection/request.cjs';
 export { DEFAULT_WORKFLOW_PROJECTION_LIMITS, WorkflowNodeProjection, WorkflowNodeStreamEvent, WorkflowProjectionLimits, WorkflowRenderBlockIssue, WorkflowRenderBlockIssueCode, WorkflowRenderFrameSet, createWorkflowNodeProjection, projectWorkflowNodeEvent } from './projection/workflow.cjs';
 export { a as MatrxApiError, M as MatrxTransport, b as MatrxTransportRequest, e as extractMatrxErrorCode, c as extractMatrxErrorMessage } from './transport-CxD0fL8p.cjs';
-export { ApiTargetLogContext, BackendApiError, BackendApiErrorData, BackendErrorCode, BackendFailureExplanation, CreateMatrxTransportOptions, ENDPOINTS, EndpointOverrideConfig, ExecuteMatrxCallHooks, ExecuteMatrxCallRequest, FollowUnavailableRejoinOptions, MATRX_AI_API_VERSION_DEFAULT, MATRX_LIVE_STREAM_UNAVAILABLE, MATRX_RESUME_CONFLICT, MATRX_RUN_IN_PROGRESS, MATRX_UI_ONLY_BODY_FIELDS, MatrxAiApiVersion, MatrxCallError, MatrxCallResult, MatrxCallScope, MatrxClientSessionProvider, MatrxClientToolResult, MatrxFollowedOutcome, MatrxHttpErrorLike, MatrxHttpMethod, MatrxLiveRunRejoin, MatrxLiveStreamUnavailable, MatrxPendingCallSummary, MatrxProtocolDowngrade, MatrxProtocolFallbackOptions, MatrxQueryParams, MatrxRequestInfo, MatrxRunPickup, MatrxRunPickupSettlement, MatrxStreamIds, MatrxStreamParse, MatrxToolResultsResponse, MatrxTransportDiagnostics, MatrxTransportTarget, OrganizationContextError, OrganizationContextErrorCode, OrganizationOperation, ParseMatrxNdjsonResponseHooks, ProviderSessionFailure, ProviderSessionFailureVerdict, RUN_OUTPUT_KINDS, RUN_STREAM_LIFETIME_BACKSTOP_MS, RUN_WAIT_KNOB_FEATURE, ResumeOrRejoinOptions, ResumeOrRejoinOutcome, RunOutputKind, RunWait, RunWaitKnobReader, SettleRunPickupOptions, StreamTransportError, UpstreamErrorPayload, V2_COVERED_AI_PATH_TEMPLATES, aiVersionPathOverrides, applyAiApiVersion, applyDesktopTargetToRequestBody, applyOrganizationContextHeader, assertOrganizationMatchesOperation, assertQueryOrganizationMatchesContext, bareStatusSentence, buildMatrxRequestBody, buildMatrxRequestUrl, buildSafeRequestLog, createMatrxTransport, createOrganizationOperation, describeBackendFailure, executeMatrxCall, fetchWithMatrxProtocolFallback, followUnavailableRejoin, followWorkflowRunEvents, getUserMessage, honestTransportMessage, isBareTransportCode, isCoveredAiPath, isGenericUserMessage, isJobOutputKind, isLiveStreamUnavailable, isResumeConflict, isStreamTransportLost, isV2Path, listConversationPendingToolCalls, listUserPendingToolCalls, logApiTarget, normalizeMatrxError, openMatrxStream, parseCallApiError, parseHttpError, parseHttpErrorBody, parseMatrxNdjsonResponse, parsePersistedBackendError, parseStreamError, providerSessionFailureBody, readConversationOrganizationId, readLiveRunRejoin, readLiveRunRequestId, readLiveStreamUnavailable, readMatrxErrorCode, readMatrxErrorCodeFromMessage, redactUrlForRequestLog, reportProviderSessionFailure, requireOrganizationContext, resolveEndpointPath, resolveRunWaitWith, resumeOrRejoin, runJobLabel, runOutputKindFromModalities, runWaitKnobKey, runWaitTimeoutMessage, runtimeOperationRejoinPath, settleRunPickup, shouldReportMatrxCallError, streamErrorText, submitAgentToolResults, toV1FallbackUrl, toV2Path, unwrapUpstreamError, warmAgent, withRunOrganization } from './matrx/index.cjs';
+export { ApiTargetLogContext, BackendApiError, BackendApiErrorData, BackendErrorCode, BackendFailureExplanation, CreateMatrxTransportOptions, ENDPOINTS, EndpointOverrideConfig, ExecuteMatrxCallHooks, ExecuteMatrxCallRequest, FollowUnavailableRejoinOptions, MATRX_AI_API_VERSION_DEFAULT, MATRX_LIVE_STREAM_UNAVAILABLE, MATRX_RESUME_CONFLICT, MATRX_RUN_IN_PROGRESS, MATRX_UI_ONLY_BODY_FIELDS, MatrxAiApiVersion, MatrxCallError, MatrxCallResult, MatrxCallScope, MatrxClientSessionProvider, MatrxClientToolResult, MatrxFollowedOutcome, MatrxHttpErrorLike, MatrxHttpMethod, MatrxLiveRunRejoin, MatrxLiveStreamUnavailable, MatrxPendingCallSummary, MatrxProtocolDowngrade, MatrxProtocolFallbackOptions, MatrxQueryParams, MatrxRequestInfo, MatrxRunPickup, MatrxRunPickupSettlement, MatrxStreamIds, MatrxStreamParse, MatrxToolResultsResponse, MatrxTransportDiagnostics, MatrxTransportTarget, OrganizationContextError, OrganizationContextErrorCode, OrganizationOperation, ParseMatrxNdjsonResponseHooks, ProviderSessionFailure, ProviderSessionFailureVerdict, RUN_OUTPUT_KINDS, RUN_STREAM_LIFETIME_BACKSTOP_MS, RUN_WAIT_KNOB_FEATURE, ResumeOrRejoinOptions, ResumeOrRejoinOutcome, RunOutputKind, RunWait, RunWaitKnobReader, SendMatrxRequestOptions, SettleRunPickupOptions, StreamTransportError, UpstreamErrorPayload, V2_COVERED_AI_PATH_TEMPLATES, aiVersionPathOverrides, applyAiApiVersion, applyDesktopTargetToRequestBody, applyOrganizationContextHeader, assertOrganizationMatchesOperation, assertQueryOrganizationMatchesContext, bareStatusSentence, buildMatrxRequestBody, buildMatrxRequestUrl, buildSafeRequestLog, createMatrxTransport, createOrganizationOperation, describeBackendFailure, executeMatrxCall, fetchWithMatrxProtocolFallback, followUnavailableRejoin, followWorkflowRunEvents, getUserMessage, honestTransportMessage, isBareTransportCode, isCoveredAiPath, isGenericUserMessage, isJobOutputKind, isLiveStreamUnavailable, isResumeConflict, isStreamTransportLost, isV2Path, listConversationPendingToolCalls, listUserPendingToolCalls, logApiTarget, normalizeMatrxError, openMatrxStream, parseCallApiError, parseHttpError, parseHttpErrorBody, parseMatrxNdjsonResponse, parsePersistedBackendError, parseStreamError, providerSessionFailureBody, readConversationOrganizationId, readLiveRunRejoin, readLiveRunRequestId, readLiveStreamUnavailable, readMatrxErrorCode, readMatrxErrorCodeFromMessage, readMatrxJsonResponse, redactUrlForRequestLog, reportProviderSessionFailure, requireOrganizationContext, resolveEndpointPath, resolveRunWaitWith, resumeOrRejoin, runJobLabel, runOutputKindFromModalities, runWaitKnobKey, runWaitTimeoutMessage, runtimeOperationRejoinPath, sendMatrxRequest, settleRunPickup, shouldReportMatrxCallError, streamErrorText, submitAgentToolResults, toV1FallbackUrl, toV2Path, unwrapUpstreamError, warmAgent, withRunOrganization } from './matrx/index.cjs';
 export { F as FollowRuntimeOperationOptions, a as FollowRuntimeOperationToEndOptions, b as FollowRuntimeOperationToEndResult, M as MatrxAgentStartRequest, c as MatrxCancelResponse, d as MatrxChatMessage, e as MatrxCompletedRun, f as MatrxContextAnchor, g as MatrxConversationContinueRequest, h as MatrxConversationResumeRequest, i as MatrxConversationStart, j as MatrxEphemeralConversation, k as MatrxJsonObject, l as MatrxJsonValue, m as MatrxMandateStartRequest, n as MatrxOperationEventsPage, o as MatrxOperationFollowEvent, p as MatrxOperationStatusResponse, q as MatrxOperationsByLinkResponse, r as MatrxRequestScope, s as MatrxRunError, t as MatrxRunHandle, u as MatrxRuntimeExecutionStatus, v as MatrxRuntimeOperationEvent, w as MatrxRuntimeOperationView, x as MatrxStoredConversationContinue, y as MatrxStoredConversationCreate, z as MatrxStreamCallOptions, A as MatrxTurnFields, R as RunAgentToCompletionOptions, T as TERMINAL_MATRX_RUNTIME_STATUSES, B as cancelAgentRun, C as continueAgentConversation, D as continueEphemeralConversationStart, E as continueStoredConversationStart, G as followRuntimeOperationEvents, H as followRuntimeOperationToEnd, I as getRuntimeOperationStatus, J as getRuntimeOperationsByLink, K as listRuntimeOperationEvents, L as mintMatrxConversationId, N as newEphemeralConversationStart, O as newStoredConversationStart, P as rejoinRuntimeOperation, Q as resumeAgentConversation, S as runAgentToCompletion, U as startAgentRun, V as startMandateRun } from './operations-C9QvBH_2.cjs';
 import '@ai-matrx/data';
 import '@ai-matrx/data/net';
-import './keys.generated-klzs6I1T.cjs';
+import './keys.generated-DNRbtHNx.cjs';
 
 /**
  * Media reference roles — the builder's side of the one vocabulary.

package/dist/index.d.ts

@@ -4,11 +4,11 @@ export { projectAgentResultForDisplay } from './presentation/result.js';
 export { AgentProjectionEvent, AgentProjectionOperation, AgentProjectionRenderBlock, AgentProjectionStatus, AgentProjectionTool, AgentRequestProjection, createAgentRequestProjection, projectAgentEvent, projectAgentEvents } from './projection/request.js';
 export { DEFAULT_WORKFLOW_PROJECTION_LIMITS, WorkflowNodeProjection, WorkflowNodeStreamEvent, WorkflowProjectionLimits, WorkflowRenderBlockIssue, WorkflowRenderBlockIssueCode, WorkflowRenderFrameSet, createWorkflowNodeProjection, projectWorkflowNodeEvent } from './projection/workflow.js';
 export { a as MatrxApiError, M as MatrxTransport, b as MatrxTransportRequest, e as extractMatrxErrorCode, c as extractMatrxErrorMessage } from './transport-CxD0fL8p.js';
-export { ApiTargetLogContext, BackendApiError, BackendApiErrorData, BackendErrorCode, BackendFailureExplanation, CreateMatrxTransportOptions, ENDPOINTS, EndpointOverrideConfig, ExecuteMatrxCallHooks, ExecuteMatrxCallRequest, FollowUnavailableRejoinOptions, MATRX_AI_API_VERSION_DEFAULT, MATRX_LIVE_STREAM_UNAVAILABLE, MATRX_RESUME_CONFLICT, MATRX_RUN_IN_PROGRESS, MATRX_UI_ONLY_BODY_FIELDS, MatrxAiApiVersion, MatrxCallError, MatrxCallResult, MatrxCallScope, MatrxClientSessionProvider, MatrxClientToolResult, MatrxFollowedOutcome, MatrxHttpErrorLike, MatrxHttpMethod, MatrxLiveRunRejoin, MatrxLiveStreamUnavailable, MatrxPendingCallSummary, MatrxProtocolDowngrade, MatrxProtocolFallbackOptions, MatrxQueryParams, MatrxRequestInfo, MatrxRunPickup, MatrxRunPickupSettlement, MatrxStreamIds, MatrxStreamParse, MatrxToolResultsResponse, MatrxTransportDiagnostics, MatrxTransportTarget, OrganizationContextError, OrganizationContextErrorCode, OrganizationOperation, ParseMatrxNdjsonResponseHooks, ProviderSessionFailure, ProviderSessionFailureVerdict, RUN_OUTPUT_KINDS, RUN_STREAM_LIFETIME_BACKSTOP_MS, RUN_WAIT_KNOB_FEATURE, ResumeOrRejoinOptions, ResumeOrRejoinOutcome, RunOutputKind, RunWait, RunWaitKnobReader, SettleRunPickupOptions, StreamTransportError, UpstreamErrorPayload, V2_COVERED_AI_PATH_TEMPLATES, aiVersionPathOverrides, applyAiApiVersion, applyDesktopTargetToRequestBody, applyOrganizationContextHeader, assertOrganizationMatchesOperation, assertQueryOrganizationMatchesContext, bareStatusSentence, buildMatrxRequestBody, buildMatrxRequestUrl, buildSafeRequestLog, createMatrxTransport, createOrganizationOperation, describeBackendFailure, executeMatrxCall, fetchWithMatrxProtocolFallback, followUnavailableRejoin, followWorkflowRunEvents, getUserMessage, honestTransportMessage, isBareTransportCode, isCoveredAiPath, isGenericUserMessage, isJobOutputKind, isLiveStreamUnavailable, isResumeConflict, isStreamTransportLost, isV2Path, listConversationPendingToolCalls, listUserPendingToolCalls, logApiTarget, normalizeMatrxError, openMatrxStream, parseCallApiError, parseHttpError, parseHttpErrorBody, parseMatrxNdjsonResponse, parsePersistedBackendError, parseStreamError, providerSessionFailureBody, readConversationOrganizationId, readLiveRunRejoin, readLiveRunRequestId, readLiveStreamUnavailable, readMatrxErrorCode, readMatrxErrorCodeFromMessage, redactUrlForRequestLog, reportProviderSessionFailure, requireOrganizationContext, resolveEndpointPath, resolveRunWaitWith, resumeOrRejoin, runJobLabel, runOutputKindFromModalities, runWaitKnobKey, runWaitTimeoutMessage, runtimeOperationRejoinPath, settleRunPickup, shouldReportMatrxCallError, streamErrorText, submitAgentToolResults, toV1FallbackUrl, toV2Path, unwrapUpstreamError, warmAgent, withRunOrganization } from './matrx/index.js';
+export { ApiTargetLogContext, BackendApiError, BackendApiErrorData, BackendErrorCode, BackendFailureExplanation, CreateMatrxTransportOptions, ENDPOINTS, EndpointOverrideConfig, ExecuteMatrxCallHooks, ExecuteMatrxCallRequest, FollowUnavailableRejoinOptions, MATRX_AI_API_VERSION_DEFAULT, MATRX_LIVE_STREAM_UNAVAILABLE, MATRX_RESUME_CONFLICT, MATRX_RUN_IN_PROGRESS, MATRX_UI_ONLY_BODY_FIELDS, MatrxAiApiVersion, MatrxCallError, MatrxCallResult, MatrxCallScope, MatrxClientSessionProvider, MatrxClientToolResult, MatrxFollowedOutcome, MatrxHttpErrorLike, MatrxHttpMethod, MatrxLiveRunRejoin, MatrxLiveStreamUnavailable, MatrxPendingCallSummary, MatrxProtocolDowngrade, MatrxProtocolFallbackOptions, MatrxQueryParams, MatrxRequestInfo, MatrxRunPickup, MatrxRunPickupSettlement, MatrxStreamIds, MatrxStreamParse, MatrxToolResultsResponse, MatrxTransportDiagnostics, MatrxTransportTarget, OrganizationContextError, OrganizationContextErrorCode, OrganizationOperation, ParseMatrxNdjsonResponseHooks, ProviderSessionFailure, ProviderSessionFailureVerdict, RUN_OUTPUT_KINDS, RUN_STREAM_LIFETIME_BACKSTOP_MS, RUN_WAIT_KNOB_FEATURE, ResumeOrRejoinOptions, ResumeOrRejoinOutcome, RunOutputKind, RunWait, RunWaitKnobReader, SendMatrxRequestOptions, SettleRunPickupOptions, StreamTransportError, UpstreamErrorPayload, V2_COVERED_AI_PATH_TEMPLATES, aiVersionPathOverrides, applyAiApiVersion, applyDesktopTargetToRequestBody, applyOrganizationContextHeader, assertOrganizationMatchesOperation, assertQueryOrganizationMatchesContext, bareStatusSentence, buildMatrxRequestBody, buildMatrxRequestUrl, buildSafeRequestLog, createMatrxTransport, createOrganizationOperation, describeBackendFailure, executeMatrxCall, fetchWithMatrxProtocolFallback, followUnavailableRejoin, followWorkflowRunEvents, getUserMessage, honestTransportMessage, isBareTransportCode, isCoveredAiPath, isGenericUserMessage, isJobOutputKind, isLiveStreamUnavailable, isResumeConflict, isStreamTransportLost, isV2Path, listConversationPendingToolCalls, listUserPendingToolCalls, logApiTarget, normalizeMatrxError, openMatrxStream, parseCallApiError, parseHttpError, parseHttpErrorBody, parseMatrxNdjsonResponse, parsePersistedBackendError, parseStreamError, providerSessionFailureBody, readConversationOrganizationId, readLiveRunRejoin, readLiveRunRequestId, readLiveStreamUnavailable, readMatrxErrorCode, readMatrxErrorCodeFromMessage, readMatrxJsonResponse, redactUrlForRequestLog, reportProviderSessionFailure, requireOrganizationContext, resolveEndpointPath, resolveRunWaitWith, resumeOrRejoin, runJobLabel, runOutputKindFromModalities, runWaitKnobKey, runWaitTimeoutMessage, runtimeOperationRejoinPath, sendMatrxRequest, settleRunPickup, shouldReportMatrxCallError, streamErrorText, submitAgentToolResults, toV1FallbackUrl, toV2Path, unwrapUpstreamError, warmAgent, withRunOrganization } from './matrx/index.js';
 export { F as FollowRuntimeOperationOptions, a as FollowRuntimeOperationToEndOptions, b as FollowRuntimeOperationToEndResult, M as MatrxAgentStartRequest, c as MatrxCancelResponse, d as MatrxChatMessage, e as MatrxCompletedRun, f as MatrxContextAnchor, g as MatrxConversationContinueRequest, h as MatrxConversationResumeRequest, i as MatrxConversationStart, j as MatrxEphemeralConversation, k as MatrxJsonObject, l as MatrxJsonValue, m as MatrxMandateStartRequest, n as MatrxOperationEventsPage, o as MatrxOperationFollowEvent, p as MatrxOperationStatusResponse, q as MatrxOperationsByLinkResponse, r as MatrxRequestScope, s as MatrxRunError, t as MatrxRunHandle, u as MatrxRuntimeExecutionStatus, v as MatrxRuntimeOperationEvent, w as MatrxRuntimeOperationView, x as MatrxStoredConversationContinue, y as MatrxStoredConversationCreate, z as MatrxStreamCallOptions, A as MatrxTurnFields, R as RunAgentToCompletionOptions, T as TERMINAL_MATRX_RUNTIME_STATUSES, B as cancelAgentRun, C as continueAgentConversation, D as continueEphemeralConversationStart, E as continueStoredConversationStart, G as followRuntimeOperationEvents, H as followRuntimeOperationToEnd, I as getRuntimeOperationStatus, J as getRuntimeOperationsByLink, K as listRuntimeOperationEvents, L as mintMatrxConversationId, N as newEphemeralConversationStart, O as newStoredConversationStart, P as rejoinRuntimeOperation, Q as resumeAgentConversation, S as runAgentToCompletion, U as startAgentRun, V as startMandateRun } from './operations-C3iHFcnt.js';
 import '@ai-matrx/data';
 import '@ai-matrx/data/net';
-import './keys.generated-klzs6I1T.js';
+import './keys.generated-DNRbtHNx.js';
 
 /**
  * Media reference roles — the builder's side of the one vocabulary.

package/dist/index.js

@@ -1334,13 +1334,15 @@ function buildMatrxRequestUrl(baseUrl, pathTemplate, pathParams, queryParams) {
   }
   const fullPath = resolvedPath.startsWith("/api/") ? resolvedPath.slice(4) : resolvedPath;
   const url = `${baseUrl}${fullPath}`;
-  if (queryParams && Object.keys(queryParams).length > 0) {
-    const qs = new URLSearchParams(
-      Object.fromEntries(
-        Object.entries(queryParams).map(([k, v]) => [k, String(v)])
-      )
-    ).toString();
-    return `${url}?${qs}`;
+  if (queryParams) {
+    const search = new URLSearchParams();
+    for (const [key, value] of Object.entries(queryParams)) {
+      if (value === null || value === void 0) continue;
+      const values = Array.isArray(value) ? value : [value];
+      for (const entry of values) search.append(key, String(entry));
+    }
+    const qs = search.toString();
+    if (qs) return `${url}${url.includes("?") ? "&" : "?"}${qs}`;
   }
   return url;
 }
@@ -1524,6 +1526,44 @@ async function executeMatrxCall(request, hooks = {}) {
     ...parsed.conversationId !== null ? { conversationId: parsed.conversationId } : {}
   };
 }
+async function sendMatrxRequest(url, init = {}, options = {}) {
+  const callerSignal = options.signal ?? init.signal ?? void 0;
+  if (options.timeoutMs === void 0) {
+    return fetch(url, { ...init, ...callerSignal ? { signal: callerSignal } : {} });
+  }
+  const controller = new AbortController();
+  const onCallerAbort = () => controller.abort(callerSignal?.reason);
+  if (callerSignal) {
+    if (callerSignal.aborted) controller.abort(callerSignal.reason);
+    else callerSignal.addEventListener("abort", onCallerAbort, { once: true });
+  }
+  let timedOut = false;
+  const timer = setTimeout(() => {
+    timedOut = true;
+    controller.abort();
+  }, options.timeoutMs);
+  try {
+    return await fetch(url, { ...init, signal: controller.signal });
+  } catch (error) {
+    if (timedOut) {
+      throw new BackendApiError({
+        code: "request_timeout",
+        detail: `${init.method ?? "GET"} ${url} exceeded ${options.timeoutMs}ms`,
+        userMessage: "The request timed out \u2014 please retry.",
+        status: 504
+      });
+    }
+    throw error;
+  } finally {
+    clearTimeout(timer);
+    callerSignal?.removeEventListener("abort", onCallerAbort);
+  }
+}
+async function readMatrxJsonResponse(response) {
+  if (!response.ok) throw await parseHttpError(response);
+  if (response.status === 204) return null;
+  return await response.json();
+}
 
 // matrx/client.ts
 function classifyStatus(status) {
@@ -3411,6 +3451,7 @@ export {
   readLiveStreamUnavailable,
   readMatrxErrorCode,
   readMatrxErrorCodeFromMessage,
+  readMatrxJsonResponse,
   readMatrxNdjsonStream,
   readMatrxSseStream,
   redactUrlForRequestLog,
@@ -3430,6 +3471,7 @@ export {
   runWaitKnobKey,
   runWaitTimeoutMessage,
   runtimeOperationRejoinPath,
+  sendMatrxRequest,
   settleRunPickup,
   shouldReportMatrxCallError,
   startAgentRun,