# renew-registered-agent

Paid (standard Exact-EVM rail, variable by state — `get-pricing` with `product: "ra-renewal"`). Extends the bundled Northwest registered-agent service by 12 months. **Owner-only** — deliberately diverging from `renew-domain`: a third party cannot renew someone else's entity.

Renewal continues the registered office, permitted business-address use, state/legal mail receipt and scanning, and five ordinary-mail scans per service year, subject to supplier terms and additional-mail charges. It does not purchase an annual report, premium mail forwarding, a virtual office, or digital identity services. The service overview explains mail limits and original-document handling.

## Input

| Field | Required | Notes |
|---|---|---|
| `entity` | yes | Handle of an entity you own, e.g. `"US-WY:daski-labs-llc"`. |
| `assetId` | no | Immutable UUID — disambiguates re-formed names. |

## Behavior

- Allowed while `active` or within the **14-day post-expiry grace** (`expired`). An `expired` entity returns to `active` on renewal.
- Extends from `max(paid-through, now)` + 12 months — renewing early never loses time; renewing in grace starts from today.
- The buyer-facing `raPaidThrough` updates **immediately** at settlement: the 12 months are Daski's obligation from that moment. Supplier-side invoice settlement is reconciled behind the scenes and never delays your entitlement.
- Re-screens the entity's stored parties before any supplier spend — every filing is a legally fresh dealing. A hold shows the neutral review message; a cleared hold resumes without re-screening.

## Timing

With `raPaidThrough: 2026-08-20`:

- Renew on **2026-07-04** (early, inside the 60-day window `get-entity-status` flags with `raRenewalDue`) → new paid-through **2027-08-20**. No time lost.
- Renew on **2026-08-30** (10 days into the 14-day grace, status `expired`) → extension runs from *now*: new paid-through **2027-08-30**, status back to `active`.
- On **2026-09-04** grace ends and the entity goes `ra_cancelled` — this skill refuses from then on.

Each call extends by another 12 months — deliberately **not** idempotent; do not retry a call that already completed.

## After the grace window

Once grace lapses the entity goes `ra_cancelled`: the supplier cancels the registered-agent service, this skill refuses, and **new documents arrive payment-locked**. Reinstatement is support-mediated — email `formation@sandbox-agent.bluetgroup.com`.

## Result artifact — `ra_renewal_details`

```jsonc
{
  "entity": "US-WY:daski-labs-llc",
  "assetId": "5f0c2f6a-…",
  "raPaidThrough": "2028-07-04",
  "invoiceSettled": true      // false = supplier invoice not yet issued; recorded as an
                              // entitlement and auto-paid on arrival — your paid-through
                              // is already extended either way
}
```

A confirmation email with the new paid-through date also goes to the entity's `contactEmail`.

## Failure modes

- `not_renewable` — the entity is `suspended`, `ra_cancelled`, `released`, or `dissolved`. For `ra_cancelled` the message names the support path (reinstatement is operator-mediated).
- Screening review: the task holds with the neutral message — no refund is triggered by the hold itself; resolution is operator-mediated.
- Unknown `entity`, or not owned by the calling agent: rejected before payment moves.

## Next step

- `get-entity-status` — `raPaidThrough` reflects the extension immediately; `raRenewalDue` clears.
- Done. The asset stays (or returns to) `active`.

## Address and mail benefits

Owner-authorized `get-entity-status` returns the actual `registeredAgent`,
`businessAddress` and `ordinaryMail` details. Availability is `active`, `inactive`
or `unknown`, with an observation time. An old address is historical evidence,
not permission to keep using it after cancellation. Filing profiles preserve
what was submitted even when the supplier office later changes.

Ordinary mail includes five pieces per supplier service year, excluding
state/legal mail. Activation is reported independently as `pending`, `active`,
`inactive` or `unknown`. Unavailable term dates and used/remaining allowance are
omitted until supplier evidence verifies them. `usageStatus` is `unknown`,
`verified` or `stale`; verified zero usage remains zero. `observedOrdinaryPieces` counts deduplicated
local scans across local history; it is not remaining supplier allowance.
Use the returned support email and entity/document reference for activation,
extra mail, locked scans or originals. A support request does not authorize a
supplier charge. Original-request deadlines are omitted until the applicable
account terms and time basis are confirmed.