@ai-matrx/agents 0.25.3 → 0.27.0

package/dist/matrx/index.d.cts

@@ -354,6 +354,22 @@ interface MatrxHttpErrorLike {
  * `error`) from `detail`, `details`, or the top level. Null when absent.
  */
 declare function readMatrxErrorCode(error: unknown): string | null;
+/**
+ * The machine code a server message carries as a PREFIX
+ * (`"resume_conflict: another run is live"` → `resume_conflict`), for envelope
+ * variants that pass the message but map `error` to a generic status word.
+ * Only the known resume/turn-lock codes match; null for anything else.
+ */
+declare function readMatrxErrorCodeFromMessage(message: string | null | undefined): string | null;
+/**
+ * The conversation's own organization id, for scoping a resume/rejoin to the
+ * RUN's organization instead of the session's selection. Transport-agnostic:
+ * the host injects `read` (a supabase select, a REST call, …) returning the raw
+ * `organization_id` (or throwing). Null — with `onUnreadable(reason)` — when it
+ * is missing or unreadable, so the caller keeps the active organization and
+ * says so.
+ */
+declare function readConversationOrganizationId(conversationId: string, read: (conversationId: string) => Promise<unknown>, onUnreadable?: (reason: string | null) => void): Promise<string | null>;
 /** Where to rejoin a live run, read from a resume door's 409. */
 interface MatrxLiveRunRejoin {
     /** The live request (`GET /runtime/operations/{id}`); null for doors outside the spine (SEO). */
@@ -731,4 +747,4 @@ declare function listUserPendingToolCalls(transport: MatrxTransport, options?: {
     signal?: AbortSignal;
 }): Promise<MatrxPendingCallSummary[]>;
 
-export { type CreateMatrxTransportOptions, FollowRuntimeOperationToEndOptions, type FollowUnavailableRejoinOptions, MATRX_AI_API_VERSION_DEFAULT, MATRX_LIVE_STREAM_UNAVAILABLE, MATRX_RESUME_CONFLICT, MATRX_RUN_IN_PROGRESS, type MatrxAiApiVersion, MatrxApiError, type MatrxCallError, type MatrxClientSessionProvider, type MatrxClientToolResult, type MatrxFollowedOutcome, type MatrxHttpErrorLike, MatrxJsonObject, MatrxJsonValue, type MatrxLiveRunRejoin, type MatrxLiveStreamUnavailable, type MatrxPendingCallSummary, type MatrxProtocolDowngrade, type MatrxProtocolFallbackOptions, type MatrxRequestInfo, MatrxRunHandle, type MatrxRunPickup, type MatrxRunPickupSettlement, MatrxRuntimeExecutionStatus, MatrxRuntimeOperationEvent, MatrxStreamCallOptions, type MatrxToolResultsResponse, MatrxTransport, type MatrxTransportDiagnostics, type MatrxTransportTarget, OrganizationContextError, type OrganizationContextErrorCode, type OrganizationOperation, type ProviderSessionFailure, type ProviderSessionFailureVerdict, type ResumeOrRejoinOptions, type ResumeOrRejoinOutcome, type SettleRunPickupOptions, V2_COVERED_AI_PATH_TEMPLATES, applyAiApiVersion, applyOrganizationContextHeader, assertOrganizationMatchesOperation, assertQueryOrganizationMatchesContext, createMatrxTransport, createOrganizationOperation, fetchWithMatrxProtocolFallback, followUnavailableRejoin, followWorkflowRunEvents, isCoveredAiPath, isLiveStreamUnavailable, isResumeConflict, isV2Path, listConversationPendingToolCalls, listUserPendingToolCalls, normalizeMatrxError, openMatrxStream, providerSessionFailureBody, readLiveRunRejoin, readLiveRunRequestId, readLiveStreamUnavailable, readMatrxErrorCode, reportProviderSessionFailure, requireOrganizationContext, resumeOrRejoin, runtimeOperationRejoinPath, settleRunPickup, streamErrorText, submitAgentToolResults, toV1FallbackUrl, toV2Path, withRunOrganization };
+export { type CreateMatrxTransportOptions, FollowRuntimeOperationToEndOptions, type FollowUnavailableRejoinOptions, MATRX_AI_API_VERSION_DEFAULT, MATRX_LIVE_STREAM_UNAVAILABLE, MATRX_RESUME_CONFLICT, MATRX_RUN_IN_PROGRESS, type MatrxAiApiVersion, MatrxApiError, type MatrxCallError, type MatrxClientSessionProvider, type MatrxClientToolResult, type MatrxFollowedOutcome, type MatrxHttpErrorLike, MatrxJsonObject, MatrxJsonValue, type MatrxLiveRunRejoin, type MatrxLiveStreamUnavailable, type MatrxPendingCallSummary, type MatrxProtocolDowngrade, type MatrxProtocolFallbackOptions, type MatrxRequestInfo, MatrxRunHandle, type MatrxRunPickup, type MatrxRunPickupSettlement, MatrxRuntimeExecutionStatus, MatrxRuntimeOperationEvent, MatrxStreamCallOptions, type MatrxToolResultsResponse, MatrxTransport, type MatrxTransportDiagnostics, type MatrxTransportTarget, OrganizationContextError, type OrganizationContextErrorCode, type OrganizationOperation, type ProviderSessionFailure, type ProviderSessionFailureVerdict, type ResumeOrRejoinOptions, type ResumeOrRejoinOutcome, type SettleRunPickupOptions, V2_COVERED_AI_PATH_TEMPLATES, applyAiApiVersion, applyOrganizationContextHeader, assertOrganizationMatchesOperation, assertQueryOrganizationMatchesContext, createMatrxTransport, createOrganizationOperation, fetchWithMatrxProtocolFallback, followUnavailableRejoin, followWorkflowRunEvents, isCoveredAiPath, isLiveStreamUnavailable, isResumeConflict, isV2Path, listConversationPendingToolCalls, listUserPendingToolCalls, normalizeMatrxError, openMatrxStream, providerSessionFailureBody, readConversationOrganizationId, readLiveRunRejoin, readLiveRunRequestId, readLiveStreamUnavailable, readMatrxErrorCode, readMatrxErrorCodeFromMessage, reportProviderSessionFailure, requireOrganizationContext, resumeOrRejoin, runtimeOperationRejoinPath, settleRunPickup, streamErrorText, submitAgentToolResults, toV1FallbackUrl, toV2Path, withRunOrganization };

package/dist/matrx/index.d.ts

@@ -354,6 +354,22 @@ interface MatrxHttpErrorLike {
  * `error`) from `detail`, `details`, or the top level. Null when absent.
  */
 declare function readMatrxErrorCode(error: unknown): string | null;
+/**
+ * The machine code a server message carries as a PREFIX
+ * (`"resume_conflict: another run is live"` → `resume_conflict`), for envelope
+ * variants that pass the message but map `error` to a generic status word.
+ * Only the known resume/turn-lock codes match; null for anything else.
+ */
+declare function readMatrxErrorCodeFromMessage(message: string | null | undefined): string | null;
+/**
+ * The conversation's own organization id, for scoping a resume/rejoin to the
+ * RUN's organization instead of the session's selection. Transport-agnostic:
+ * the host injects `read` (a supabase select, a REST call, …) returning the raw
+ * `organization_id` (or throwing). Null — with `onUnreadable(reason)` — when it
+ * is missing or unreadable, so the caller keeps the active organization and
+ * says so.
+ */
+declare function readConversationOrganizationId(conversationId: string, read: (conversationId: string) => Promise<unknown>, onUnreadable?: (reason: string | null) => void): Promise<string | null>;
 /** Where to rejoin a live run, read from a resume door's 409. */
 interface MatrxLiveRunRejoin {
     /** The live request (`GET /runtime/operations/{id}`); null for doors outside the spine (SEO). */
@@ -731,4 +747,4 @@ declare function listUserPendingToolCalls(transport: MatrxTransport, options?: {
     signal?: AbortSignal;
 }): Promise<MatrxPendingCallSummary[]>;
 
-export { type CreateMatrxTransportOptions, FollowRuntimeOperationToEndOptions, type FollowUnavailableRejoinOptions, MATRX_AI_API_VERSION_DEFAULT, MATRX_LIVE_STREAM_UNAVAILABLE, MATRX_RESUME_CONFLICT, MATRX_RUN_IN_PROGRESS, type MatrxAiApiVersion, MatrxApiError, type MatrxCallError, type MatrxClientSessionProvider, type MatrxClientToolResult, type MatrxFollowedOutcome, type MatrxHttpErrorLike, MatrxJsonObject, MatrxJsonValue, type MatrxLiveRunRejoin, type MatrxLiveStreamUnavailable, type MatrxPendingCallSummary, type MatrxProtocolDowngrade, type MatrxProtocolFallbackOptions, type MatrxRequestInfo, MatrxRunHandle, type MatrxRunPickup, type MatrxRunPickupSettlement, MatrxRuntimeExecutionStatus, MatrxRuntimeOperationEvent, MatrxStreamCallOptions, type MatrxToolResultsResponse, MatrxTransport, type MatrxTransportDiagnostics, type MatrxTransportTarget, OrganizationContextError, type OrganizationContextErrorCode, type OrganizationOperation, type ProviderSessionFailure, type ProviderSessionFailureVerdict, type ResumeOrRejoinOptions, type ResumeOrRejoinOutcome, type SettleRunPickupOptions, V2_COVERED_AI_PATH_TEMPLATES, applyAiApiVersion, applyOrganizationContextHeader, assertOrganizationMatchesOperation, assertQueryOrganizationMatchesContext, createMatrxTransport, createOrganizationOperation, fetchWithMatrxProtocolFallback, followUnavailableRejoin, followWorkflowRunEvents, isCoveredAiPath, isLiveStreamUnavailable, isResumeConflict, isV2Path, listConversationPendingToolCalls, listUserPendingToolCalls, normalizeMatrxError, openMatrxStream, providerSessionFailureBody, readLiveRunRejoin, readLiveRunRequestId, readLiveStreamUnavailable, readMatrxErrorCode, reportProviderSessionFailure, requireOrganizationContext, resumeOrRejoin, runtimeOperationRejoinPath, settleRunPickup, streamErrorText, submitAgentToolResults, toV1FallbackUrl, toV2Path, withRunOrganization };
+export { type CreateMatrxTransportOptions, FollowRuntimeOperationToEndOptions, type FollowUnavailableRejoinOptions, MATRX_AI_API_VERSION_DEFAULT, MATRX_LIVE_STREAM_UNAVAILABLE, MATRX_RESUME_CONFLICT, MATRX_RUN_IN_PROGRESS, type MatrxAiApiVersion, MatrxApiError, type MatrxCallError, type MatrxClientSessionProvider, type MatrxClientToolResult, type MatrxFollowedOutcome, type MatrxHttpErrorLike, MatrxJsonObject, MatrxJsonValue, type MatrxLiveRunRejoin, type MatrxLiveStreamUnavailable, type MatrxPendingCallSummary, type MatrxProtocolDowngrade, type MatrxProtocolFallbackOptions, type MatrxRequestInfo, MatrxRunHandle, type MatrxRunPickup, type MatrxRunPickupSettlement, MatrxRuntimeExecutionStatus, MatrxRuntimeOperationEvent, MatrxStreamCallOptions, type MatrxToolResultsResponse, MatrxTransport, type MatrxTransportDiagnostics, type MatrxTransportTarget, OrganizationContextError, type OrganizationContextErrorCode, type OrganizationOperation, type ProviderSessionFailure, type ProviderSessionFailureVerdict, type ResumeOrRejoinOptions, type ResumeOrRejoinOutcome, type SettleRunPickupOptions, V2_COVERED_AI_PATH_TEMPLATES, applyAiApiVersion, applyOrganizationContextHeader, assertOrganizationMatchesOperation, assertQueryOrganizationMatchesContext, createMatrxTransport, createOrganizationOperation, fetchWithMatrxProtocolFallback, followUnavailableRejoin, followWorkflowRunEvents, isCoveredAiPath, isLiveStreamUnavailable, isResumeConflict, isV2Path, listConversationPendingToolCalls, listUserPendingToolCalls, normalizeMatrxError, openMatrxStream, providerSessionFailureBody, readConversationOrganizationId, readLiveRunRejoin, readLiveRunRequestId, readLiveStreamUnavailable, readMatrxErrorCode, readMatrxErrorCodeFromMessage, reportProviderSessionFailure, requireOrganizationContext, resumeOrRejoin, runtimeOperationRejoinPath, settleRunPickup, streamErrorText, submitAgentToolResults, toV1FallbackUrl, toV2Path, withRunOrganization };

package/dist/matrx/index.js

@@ -965,6 +965,30 @@ function readMatrxErrorCode(error) {
   }
   return null;
 }
+var PREFIXED_ERROR_CODES = [
+  "resume_conflict",
+  "not_resumable",
+  "outstanding_delegated_calls",
+  "user_request_not_found",
+  "run_in_flight"
+];
+function readMatrxErrorCodeFromMessage(message) {
+  if (typeof message !== "string") return null;
+  for (const code of PREFIXED_ERROR_CODES) {
+    if (message.startsWith(`${code}:`)) return code;
+  }
+  return null;
+}
+async function readConversationOrganizationId(conversationId, read, onUnreadable) {
+  try {
+    const value = await read(conversationId);
+    if (typeof value === "string" && value.trim()) return value;
+    onUnreadable?.(null);
+  } catch (error) {
+    onUnreadable?.(error instanceof Error ? error.message : String(error));
+  }
+  return null;
+}
 function firstString(candidates, key) {
   for (const candidate of candidates) {
     const value = nonBlank(candidate[key]);
@@ -1438,10 +1462,12 @@ export {
   normalizeMatrxError,
   openMatrxStream,
   providerSessionFailureBody,
+  readConversationOrganizationId,
   readLiveRunRejoin,
   readLiveRunRequestId,
   readLiveStreamUnavailable,
   readMatrxErrorCode,
+  readMatrxErrorCodeFromMessage,
   rejoinRuntimeOperation,
   reportProviderSessionFailure,
   requireOrganizationContext,