Usage gating & limits

# A denied run returns the flat DenialEnvelope (no "detail" wrapper).
curl -sS -X POST 'https://api.modulex.dev/workflows/run' \
  -H 'Authorization: Bearer mx_live_8Kf2pQ7nR4tV9wXz' \
  -H 'X-Organization-ID: org_2a1f9c4e7b8d' \
  -H 'Content-Type: application/json' \
  -d '{
    "workflow_id": "wf_3d8b1a2c",
    "input": { "topic": "quarterly report" },
    "stream": false
  }'

# Example 402 response body when the plan allowance is exhausted:
# {
#   "code": "credit_plan_exhausted",
#   "layer": "credit",
#   "key": "org_2a1f9c4e7b8d",
#   "current": null,
#   "limit": 5000.0,
#   "reason": "credit_plan_exhausted"
# }

from modulex import Modulex
from modulex import (
    CreditExhaustedError,
    WalletError,
    QuotaExceededError,
    RateLimitError,
)

async with Modulex(
    api_key="mx_live_8Kf2pQ7nR4tV9wXz",
    organization_id="org_2a1f9c4e7b8d",
) as client:
    try:
        run = await client.executions.run(
            workflow_id="wf_3d8b1a2c",
            input={"topic": "quarterly report"},
            stream=False,
        )
        print(run.run_id, run.status)
    except CreditExhaustedError as exc:        # 402, layer="credit"
        print("Out of credits:", exc.code, exc.limit)
    except WalletError as exc:                 # 402, layer="wallet"
        print("Wallet problem:", exc.code, exc.reason)
    except QuotaExceededError as exc:          # 403, layer="quota"
        print("Quota hit:", exc.key, exc.current, "/", exc.limit)
    except RateLimitError as exc:              # 429, header path
        print("Rate limited, retry after", exc.retry_after, "s")

import { Modulex, ModulexError, RateLimitError } from 'modulex-js';

const client = new Modulex({
  apiKey: 'mx_live_8Kf2pQ7nR4tV9wXz',
  organizationId: 'org_2a1f9c4e7b8d',
});

try {
  const run = await client.executions.run({
    workflowId: 'wf_3d8b1a2c',
    input: { topic: 'quarterly report' },
    stream: false,
  });
  console.log(run.run_id, run.status);
} catch (err) {
  if (err instanceof RateLimitError) {
    console.log('Rate limited, retry after', err.retryAfter, 's');
  } else if (err instanceof ModulexError && err.layer) {
    // Billing denials (402/403) carry .code, .layer, and .reason.
    console.log('Denied:', err.layer, err.code, err.reason);
  } else {
    throw err;
  }
}