Errors

import { AgentReinUnavailableError } from 'agentrein';

try {
  const session = await agentrein.newSession({ agentId: 'my-agent' });
} catch (err) {
  if (err instanceof AgentReinUnavailableError) {
    // backend is down
  }
}

from agentrein import AgentReinUnavailableError

try:
    session = agentrein.new_session(agent_id="my-agent")
except AgentReinUnavailableError:
    # backend is down
    pass

import { AgentRein, ApprovalRejectedError } from 'agentrein';

const agentStripe = agentrein.wrap(stripe, session, {
    connector: 'stripe',
    requiresApproval: ['subscriptions.cancel'],
});

try {
    await agentStripe.subscriptions.cancel({ id: 'sub_123' });
} catch (err) {
    if (err instanceof ApprovalRejectedError) {
        // err.reason — the reason string provided by the human reviewer
        // err.message — "Action rejected by reviewer: <reason>"
        console.log('Rejected:', err.reason);
        // session has already been rolled back
    }
}

from agentrein import AgentRein, ApprovalRejectedError

agent_stripe = agentrein.wrap(
    stripe_client, session,
    connector="stripe",
    requires_approval=["subscriptions.cancel"],
)

try:
    agent_stripe.subscriptions.cancel(id="sub_123")
except ApprovalRejectedError as err:
    # err.reason — the reason string provided by the human reviewer
    # str(err) — "Approval <id> was rejected: <reason>"
    print(f"Rejected: {err.reason}")
    # session has already been rolled back

import { AgentRein, ApprovalTimeoutError, ApprovalRejectedError } from 'agentrein';

try {
  await agentStripe.subscriptions.cancel({ id: 'sub_123' });
} catch (err) {
  if (err instanceof ApprovalTimeoutError) {
    // err.approvalId — the ID of the approval request
    // err.timeoutMs  — the timeout duration that was exceeded
    console.log(`Approval ${err.approvalId} timed out after ${err.timeoutMs}ms`);
    // AgentRein has triggered the session rollback flow
  }
  if (err instanceof ApprovalRejectedError) {
    // session already rolled back automatically
  }
}

from agentrein import AgentRein, ApprovalTimeoutError, ApprovalRejectedError

try:
    agent_stripe.subscriptions.cancel(id="sub_123")
except ApprovalTimeoutError as err:
    # err.approval_id — the ID of the approval request
    # err.timeout_ms  — the timeout duration that was exceeded
    print(f"Approval {err.approval_id} timed out after {err.timeout_ms}ms")
    # AgentRein has triggered the session rollback flow
except ApprovalRejectedError:
    # session already rolled back automatically
    pass

import { AgentRein, WrapOptionsValidationError } from 'agentrein';

try {
  const agentOctokit = agentrein.wrap(octokit, session, {
    connector: 'github',
    pollIntervalMs: 500,   // too low — minimum is 1000
    timeoutMs: 3000,       // too low — minimum is 5000
  });
} catch (err) {
  if (err instanceof WrapOptionsValidationError) {
    console.error('Invalid wrap options:', err.message);
  }
}

from agentrein import AgentRein, WrapOptionsValidationError

try:
    agent_repo = agentrein.wrap(
        repo, session,
        connector="github",
        poll_interval_ms=500,   # too low — minimum is 1000
        timeout_ms=3000,        # too low — minimum is 5000
    )
except WrapOptionsValidationError as err:
    print(f"Invalid wrap options: {err}")