Render a caller-computed runway
well_render_runwayPut a runway YOU computed onto the runway card.
This tool measures nothing. It takes the figure and the two numbers behind it as input and returns them for rendering. Call it only after you have computed the cash and the burn yourself — never to "get" a runway.
A runway is one division, so this tool checks the one thing that can be checked: that the headline follows from the two figures you state with it. State them and it renders; state a headline they do not produce and it refuses.
Under the number the card draws nothing. It carries the months, the moment, the burn's own window when you send one (a bare month count when you do not) and a health badge. The cash amount, the burn amount and partial are REQUIRED and reach no pixel. All of it comes back in this tool's text result, which is what you write the prose from, the division included. The card is the measure; the explanation is yours.
REQUIRED:
months— months of cash left, capped at 36status— "ok", "capped", "infinite" or "insufficient_data"cash— the dividend, amount and currency. SIGNED: an overdrawn workspace is negative.nullONLY under "insufficient_data", so a half you could not measure is reported rather than invented.avg_burn— the divisor as a POSITIVE magnitude, its currency, and thetrailing_monthsit averagedas_of— the moment the reading is valid forpartial— whether the cash may be a floor (the skills'is_floor), because an account with no readable balance or no rate was left out of it. It never means a cut-short read: a cut-short balances read or sum stops the run before this call.
OPTIONAL, and send it whenever you are sending a burn:
window— the months the burn averaged, inclusive start and EXCLUSIVE end, each on a month start. The card names those months instead of a bare count, so a reader can see which months the figure stands on. Without it the card can only pair the cash moment with the number of months, which reads as a window ending at that moment whatever months you actually averaged. Send NONE whenavg_burnisnull.
The statuses carry two distinctions worth stating, because both are easy to collapse:
Zero months is DATA when the cash is gone. A workspace already underwater has a real runway of zero, status "ok" — not "insufficient_data", which means the inputs could not be measured at all.
Unbounded is not the same as long. "infinite" means the workspace is not burning; "capped" means it burns slowly enough that the figure passes the 36-month window the product reports in.
REFUSED rather than rendered, each because your own figures disagree:
monthsthat is notcash ÷ avg_burn— the division is the figure's whole claima cash currency that differs from the burn's; one division needs one currency
a negative
avg_burn; it is a magnitude, so a negative one means a subtotal was re-signed"infinite" with a non-zero burn, or a zero burn reported as anything else
"capped" whose division lands inside the window, or which reports a number other than 36
a division past the window reported as "ok" instead of "capped"
non-positive cash reported as anything but a real zero
"insufficient_data" carrying a months figure, or a null figure under any other status
an unbounded runway reporting anything but the 36-month sentinel
an
as_ofin the futurea
windowwhose bounds are not each the first of a month, or that spans no montha
windowthat spans a different number of months thanavg_burn.trailing_months— the two state one fact, and a reader cannot tell which is the liea
windowsent with no burn to average — an unmeasured burn averaged no monthsa
windowreaching into a month that has not ended yeta
windowbound naming no calendar month, or an unknown key on the object
When the token authorizes one workspace, call this directly — no other tool call is needed first. When it authorizes several, this read will not guess which one you mean: pass workspace_id on the call.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cash | Yes | ||
| as_of | Yes | ||
| months | Yes | ||
| status | Yes | ||
| window | No | Inclusive start and EXCLUSIVE end of the months the burn averaged, YYYY-MM-DD. | |
| partial | Yes | ||
| avg_burn | Yes | ||
| workspace_id | No | Target workspace. Omit when the token authorizes one workspace. Required when it authorizes several: this read reports one workspace's own figures and will not choose which. | |
| conversation_id | No | The conversation id returned by the previous Well result, in its meta under well/conversation_id, in its structuredContent, or in its JSON text block. Pass it back on every call in the same conversation, including a call a card makes, so the chosen workspace and the earlier answers still apply. It decides the conversation on its own: nothing the host states about the session replaces it. Omit it only on the first call of a conversation. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cash | Yes | ||
| as_of | Yes | ||
| months | Yes | ||
| status | Yes | ||
| window | No | ||
| partial | Yes | ||
| success | Yes | ||
| avg_burn | Yes | ||
| computed_by | Yes | ||
| conversation_id | No | The conversation this result belongs to. Pass it back as the conversation_id argument on every later Well call in the same conversation. | |
| resolved_workspace | No | The workspace that answered, when the caller named none and the token authorizes several. | |
| conversation_id_note | No | Present only when the server opened a fresh lane, stating that no choice recorded earlier was read. | |
| conversation_id_source | No | Where the conversation id came from: the host's own request meta, the caller's argument, or a fresh lane the server opened. |