@ai-matrx/agents 0.37.1 → 0.38.2

package/dist/generated/api-types.d.cts

@@ -41223,7 +41223,7 @@ interface paths {
          *     challenge; this is the door for the challenge nobody could detect — a
          *     person or an agent that can SEE the block says so, and the session is
          *     checkpointed and reopened through their computer with the same run id.
-         *     Contract: ``common-docs/systems/platform/residential-egress/FEATURE.md``.
+         *     Contract: ``common-docs/systems/architecture/residential-egress/FEATURE.md``.
          */
         post: operations["retry_through_home_computer_browser_manager_runs__run_id__retry_through_home_computer_post"];
         delete?: never;
@@ -58558,7 +58558,7 @@ interface components {
              */
             change_role: "apply" | "edit" | "revert";
             /** Actor Tier */
-            actor_tier?: ("ai" | "code" | "human") | null;
+            actor_tier?: ("agent" | "system" | "user") | null;
             /** Actor System */
             actor_system?: string | null;
             /** Actor Id */
@@ -62438,7 +62438,7 @@ interface components {
          *     sets it: only the Browser Manager knows that a blocked page was retried
          *     through the person's own computer. It rides the command reply because that
          *     is where the agent and the panel read the answer, and rule 5 of
-         *     ``common-docs/systems/platform/residential-egress/FEATURE.md`` says a page
+         *     ``common-docs/systems/architecture/residential-egress/FEATURE.md`` says a page
          *     fetched through a person's computer always says so.
          */
         CommandEgress: {
@@ -187733,7 +187733,7 @@ interface operations {
                 unit_token?: ("agent" | "tool" | "workflow") | null;
                 unit_id?: string | null;
                 change_role?: ("apply" | "edit" | "revert") | null;
-                actor_tier?: ("ai" | "code" | "human") | null;
+                actor_tier?: ("agent" | "ai" | "code" | "human" | "system" | "user") | null;
                 /** @description Only changes a Hindsight finding caused. */
                 with_findings_only?: boolean;
                 limit?: number;

package/dist/generated/api-types.d.ts

@@ -41223,7 +41223,7 @@ interface paths {
          *     challenge; this is the door for the challenge nobody could detect — a
          *     person or an agent that can SEE the block says so, and the session is
          *     checkpointed and reopened through their computer with the same run id.
-         *     Contract: ``common-docs/systems/platform/residential-egress/FEATURE.md``.
+         *     Contract: ``common-docs/systems/architecture/residential-egress/FEATURE.md``.
          */
         post: operations["retry_through_home_computer_browser_manager_runs__run_id__retry_through_home_computer_post"];
         delete?: never;
@@ -58558,7 +58558,7 @@ interface components {
              */
             change_role: "apply" | "edit" | "revert";
             /** Actor Tier */
-            actor_tier?: ("ai" | "code" | "human") | null;
+            actor_tier?: ("agent" | "system" | "user") | null;
             /** Actor System */
             actor_system?: string | null;
             /** Actor Id */
@@ -62438,7 +62438,7 @@ interface components {
          *     sets it: only the Browser Manager knows that a blocked page was retried
          *     through the person's own computer. It rides the command reply because that
          *     is where the agent and the panel read the answer, and rule 5 of
-         *     ``common-docs/systems/platform/residential-egress/FEATURE.md`` says a page
+         *     ``common-docs/systems/architecture/residential-egress/FEATURE.md`` says a page
          *     fetched through a person's computer always says so.
          */
         CommandEgress: {
@@ -187733,7 +187733,7 @@ interface operations {
                 unit_token?: ("agent" | "tool" | "workflow") | null;
                 unit_id?: string | null;
                 change_role?: ("apply" | "edit" | "revert") | null;
-                actor_tier?: ("ai" | "code" | "human") | null;
+                actor_tier?: ("agent" | "ai" | "code" | "human" | "system" | "user") | null;
                 /** @description Only changes a Hindsight finding caused. */
                 with_findings_only?: boolean;
                 limit?: number;

package/dist/index.cjs

@@ -122,6 +122,7 @@ __export(index_exports, {
   readLiveStreamUnavailable: () => readLiveStreamUnavailable,
   readMatrxErrorCode: () => readMatrxErrorCode,
   readMatrxErrorCodeFromMessage: () => readMatrxErrorCodeFromMessage,
+  readMatrxJsonResponse: () => readMatrxJsonResponse,
   readMatrxNdjsonStream: () => readMatrxNdjsonStream,
   readMatrxSseStream: () => readMatrxSseStream,
   redactUrlForRequestLog: () => redactUrlForRequestLog,
@@ -141,6 +142,7 @@ __export(index_exports, {
   runWaitKnobKey: () => runWaitKnobKey,
   runWaitTimeoutMessage: () => runWaitTimeoutMessage,
   runtimeOperationRejoinPath: () => runtimeOperationRejoinPath,
+  sendMatrxRequest: () => sendMatrxRequest,
   settleRunPickup: () => settleRunPickup,
   shouldReportMatrxCallError: () => shouldReportMatrxCallError,
   startAgentRun: () => startAgentRun,
@@ -1492,13 +1494,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;
 }
@@ -1682,6 +1686,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) {