The Comp Desk Builder

Compose a WHOLE Pro Workspace page instead of one tile: several tiles (published slugs and/or inline declarative specs) over one shared global AWW and date of accident, each with its own inputs, in a saved layout. Returns the page object plus a self-contained HTML file that renders it with the live workspace renderer — the same no-eval whitelisted evaluator, so the numbers are the workspace's numbers, not this API's. Code tiles are never auto-run. Nothing publishes: create the calculators in your sandbox and submit_for_review as usual. Statutory max/min come from the date of accident via calc-core and cannot be supplied.

A schedule loss of use apportioned across two to six established claims of one claimant: each case uses its own AWW and date of accident (its own max and min) and its APPORTIONED loss of use for each member, with any protracted healing period, prior payments and credits; returns each case's award, 15% fee rounded down to $5 and net, and the totals. Cases are numbered; no names. New York State only. Computes with The Comp Desk calc-core (the engine behind the app, the website calculators and the Pro Workspace); it never estimates. If an input is missing it returns status "missing" with every input still needed and calculates nothing. Returns the figures, the rate year used, the formulas with their citations (each flagged with whether it has been attorney-reviewed), and the not-legal-advice notice. Needs your builder key. Same engine the Pro Workspace tiles call through CD.Calc, so a figure here matches the app to the cent.

The average weekly wage from earnings in the year before the accident: earnings_method "steady" (WCL §14(1)–(2): earnings ÷ days worked × 200/260/300 for a 4-/5-/6-day week, 365 for 7) or "irregular" for new, seasonal or irregular work (§14(3)–(4): earnings ÷ weeks worked). With a date of accident it also gives the weekly rate. New York State only. Computes with The Comp Desk calc-core (the engine behind the app, the website calculators and the Pro Workspace); it never estimates. If an input is missing it returns status "missing" with every input still needed and calculates nothing. Returns the figures, the rate year used, the formulas with their citations (each flagged with whether it has been attorney-reviewed), and the not-legal-advice notice. Needs your builder key. Same engine the Pro Workspace tiles call through CD.Calc, so a figure here matches the app to the cent.

The average weekly wage the way the Pro Workspace's global AWW works it out: earnings_method "steady" (earnings ÷ days worked × the 200/260/300/365 multiplier for a 4-/5-/6-/7-day week ÷ 52) or "irregular" (earnings ÷ weeks worked), plus weekly tips, the weekly value of board, and a concurrent employer's weekly wage. With a date of accident it adds the two-thirds weekly rate within the max and min. For a 1–3 day week use calculate_aww. New York State only. Computes with The Comp Desk calc-core, the same engine as the app and the Pro Workspace; it never estimates. A missing input returns status "missing" and nothing is calculated. Returns the figures, the steps with the rule and engine function behind each, and the not-legal-advice notice. Needs your builder key. Same engine the Pro Workspace tiles call through CD.Calc, so a figure here matches the app to the cent.

Weeks between dates the way The Comp Desk's CCP / Award calculator counts them: both end dates count; a period that starts the day the previous one ended counts that day once; a period held in abeyance counts no weeks; weeks rounded down to none / tenth / whole. Returns per period the inclusive days, exact and rounded weeks, whether the shared boundary day was dropped, and the next day after the end. Dates only, no money. New York State only. Computes with The Comp Desk calc-core, the same engine as the app and the Pro Workspace; it never estimates. A missing input returns status "missing" and nothing is calculated. Returns the figures, the steps with the rule and engine function behind each, and the not-legal-advice notice. Needs your builder key. Same engine the Pro Workspace tiles call through CD.Calc, so a figure here matches the app to the cent.

The carrier's equitable share of litigation costs on its workers' compensation lien when a third-party action recovers (WCL §29; Kelly; Burns): gross lien (indemnity + medical), the cost-share rate (attorney fee + disbursements ÷ gross recovery), the carrier's share and the net to the plaintiff. For a motor-vehicle case, give the no-fault threshold that comes off the lien first. New York State only. Computes with The Comp Desk calc-core (the engine behind the app, the website calculators and the Pro Workspace); it never estimates. If an input is missing it returns status "missing" with every input still needed and calculates nothing. Returns the figures, the rate year used, the formulas with their citations (each flagged with whether it has been attorney-reviewed), and the not-legal-advice notice. Needs your builder key. Same engine the Pro Workspace tiles call through CD.Calc, so a figure here matches the app to the cent.

What is owed for one or more benefit periods (types TT total, TP partial with a disability %, RE reduced earnings with weekly earnings), the way The Comp Desk's CCP/Award calculator works it out: weeks from the dates (both ends count; a period starting the day the last ended counts it once; weeks rounded down to the tenth by default), each period's rate within the max and min, and the total award. With prior_payments (0 if none) it adds the claimant's money, the 15% fee exact to the cent, the OC-400.1 amount rounded down to $5 and the net; an employer reimbursement out of the whole award is split as on SLU. New York State only. Computes with The Comp Desk calc-core (the engine behind the app, the website calculators and the Pro Workspace); it never estimates. If an input is missing it returns status "missing" with every input still needed and calculates nothing. Returns the figures, the rate year used, the formulas with their citations (each flagged with whether it has been attorney-reviewed), and the not-legal-advice notice. Needs your builder key. Same engine the Pro Workspace tiles call through CD.Calc, so a figure here matches the app to the cent.

The full Pro Workspace CCP / Award engine: periods of type TT (total), RE (reduced earnings, with current weekly earnings), TR / TP (a disability percentage of two-thirds of the wage, or a typed weekly rate), NCLT / NME ($0) and HIA (held in abeyance, no weeks); weeks counted with both ends, the shared boundary day once, rounded down to none / tenth / whole (default tenth); each rate within the max and min for the date of accident (RE capped, never raised); an amending period paid at its rate less a prior percentage or prior weekly rate; already-paid periods kept in the award but out of the money moving and fee; employer reimbursements per period with scope "period", "all" or a "specific" date range (or amount unknown); the CCP fee (the weekly CCP amount ÷ 3); prior payments; and the prior-counsel split. Returns every period, the award, the exact fee, the OC-400.1 amount rounded down to $5 and both nets. calculate_ccp_award is the simpler TT/TP/RE version. New York State only. Computes with The Comp Desk calc-core, the same engine as the app and the Pro Workspace; it never estimates. A missing input returns status "missing" and nothing is calculated. Returns the figures, the steps with the rule and engine function behind each, and the not-legal-advice notice. Needs your builder key. Same engine the Pro Workspace tiles call through CD.Calc, so a figure here matches the app to the cent.

Divides an attorney fee between the current attorney and one or two prior counsel the way every Comp Desk tile does: each prior counsel gets the dollar amount given, the current attorney the rest, worked in whole cents; prior amounts above the fee are flagged as over-allocated (nothing can be requested). Also gives the OC-400.1 amount: the current attorney's share rounded down to the nearest $5. The fee the Board approves can differ. New York State only. Computes with The Comp Desk calc-core, the same engine as the app and the Pro Workspace; it never estimates. A missing input returns status "missing" and nothing is calculated. Returns the figures, the steps with the rule and engine function behind each, and the not-legal-advice notice. Needs your builder key. Same engine the Pro Workspace tiles call through CD.Calc, so a figure here matches the app to the cent.

A permanent partial disability (non-schedule) award from a loss of wage-earning capacity percentage: the weekly rate (the bounded two-thirds rate × the LWEC %, kept within the max and min), the number of weeks for that LWEC bracket (§15(3)(w): 225 to 525 weeks depending on the bracket), the award, and, with the weeks of temporary benefits already paid, the credit for weeks beyond 130. New York State only. Computes with The Comp Desk calc-core (the engine behind the app, the website calculators and the Pro Workspace); it never estimates. If an input is missing it returns status "missing" with every input still needed and calculates nothing. Returns the figures, the rate year used, the formulas with their citations (each flagged with whether it has been attorney-reviewed), and the not-legal-advice notice. Needs your builder key. Same engine the Pro Workspace tiles call through CD.Calc, so a figure here matches the app to the cent.

How a Section 32 settlement divides: any Medicare set-aside comes off first, the attorney fee is 15% of the rest rounded down to $5, and the remainder is the claimant's net. Optional prior-counsel fee split (the OC-400.1 requests only the current attorney's share). The fee the Judge approves can differ. New York State only. Computes with The Comp Desk calc-core (the engine behind the app, the website calculators and the Pro Workspace); it never estimates. If an input is missing it returns status "missing" with every input still needed and calculates nothing. Returns the figures, the rate year used, the formulas with their citations (each flagged with whether it has been attorney-reviewed), and the not-legal-advice notice. Needs your builder key. Same engine the Pro Workspace tiles call through CD.Calc, so a figure here matches the app to the cent.

A schedule loss of use award for one or more scheduled members: weeks on the schedule × loss of use % × the weekly rate for the date of accident, plus any protracted healing period credit (weeks at temporary total beyond the longest healing period, §15(4-a)). With prior_payments (0 if none) it adds the money moving, the 15% attorney fee rounded down to $5 (the OC-400.1 amount) and the net. With an employer reimbursement it splits the money and the fees between claimant and employer, exact to the cent; the fee on the reimbursement comes from the claimant's money when it is enough. Optional prior-counsel fee split. No 130-week credit on SLU. New York State only. Computes with The Comp Desk calc-core (the engine behind the app, the website calculators and the Pro Workspace); it never estimates. If an input is missing it returns status "missing" with every input still needed and calculates nothing. Returns the figures, the rate year used, the formulas with their citations (each flagged with whether it has been attorney-reviewed), and the not-legal-advice notice. Needs your builder key. Same engine the Pro Workspace tiles call through CD.Calc, so a figure here matches the app to the cent.

The schedule loss of use percentage for a shoulder, hip or knee replacement on its own scoring track (2018 NY Impairment Guidelines Tables 5.5 / 6.5 / 7.5, as the app's engine encodes them): the base, plus the value that most closely matches the deficit in each column (range of motion, position, atrophy, chronic complications), up to the table maximum. A failed replacement is reported as not schedulable. Shoulder takes flexion/abduction; hip takes flexion, leg-length discrepancy, mal-rotation, hip_fracture; knee takes flexion, extension contracture, malalignment, ML laxity, AP motion, leg length. New York State only. Computes with The Comp Desk calc-core, the same engine as the app and the Pro Workspace; it never estimates. A missing input returns status "missing" and nothing is calculated. Returns the figures, the steps with the rule and engine function behind each, and the not-legal-advice notice. Needs your builder key. Same engine the Pro Workspace tiles call through CD.Calc, so a figure here matches the app to the cent.

A schedule loss of use percentage range from measured range of motion, scored by the app's SLU range-of-motion engine (2018 NY Impairment Guidelines): each joint's deficit by severity band with proportional adjustment, the paired-motion rule (both_motions), the ankylosis cap for the body part, an optional special consideration (added or stand-alone, as the engine marks it), an optional contralateral baseline, and the shoulder muscle-atrophy finding. Joints per body part: Thumb IP/MCP/CMC (CMC is the opposition grade 1–3), Finger DIP/PIP/MCP, Wrist Palmar Flex/Dorsi Flex/Pron/Sup, Elbow Extension/Flexion, Shoulder Forward Flexion/Abduction/Int Rotation/Ext Rotation/Adduction/Post Extension, Hip Abduction/Adduction/Int Rotation/Ext Rotation/Flexion/Post Extension, Knee Flexion/Extension, Ankle/Foot Plantar Flex/Dorsi Flex/Inversion/Eversion, Great Toe IP/MTP Flex/MTP Ext, Smaller Toes DIP/PIP/MTP. Returns a percentage, not an award: pass the percentage to calculate_slu_award. New York State only. Computes with The Comp Desk calc-core, the same engine as the app and the Pro Workspace; it never estimates. A missing input returns status "missing" and nothing is calculated. Returns the figures, the steps with the rule and engine function behind each, and the not-legal-advice notice. Needs your builder key. Same engine the Pro Workspace tiles call through CD.Calc, so a figure here matches the app to the cent.

A weekly benefit rate under the NY Workers' Compensation Law: kind "total" (temporary total: two-thirds of the AWW within the max and min for the date of accident; a wage below the minimum is paid in full), "partial" (temporary partial at a degree of disability, with the same bounds) or "reduced_earnings" (two-thirds of the wage loss, capped at the max, never raised to the min). New York State only. Computes with The Comp Desk calc-core (the engine behind the app, the website calculators and the Pro Workspace); it never estimates. If an input is missing it returns status "missing" with every input still needed and calculates nothing. Returns the figures, the rate year used, the formulas with their citations (each flagged with whether it has been attorney-reviewed), and the not-legal-advice notice. Needs your builder key. Same engine the Pro Workspace tiles call through CD.Calc, so a figure here matches the app to the cent.

Create a draft calculator in your sandbox (declarative spec or reviewed code tile).

Create a draft skill (SKILL.md bundle) in your sandbox. Skills must be self-sufficient: they cannot assume the attorney has a case-management system. A skill that needs external data (e.g. a claimant's wages) must drive the browser Claude is connected to — open the source like the WCB eCase portal, have the user log in, and fetch the document (e.g. the C-240) itself — or read the attorney's local files, or ask the user.

Copy an approved published calculator into your sandbox as a new draft to improve. Give the slug (or id) of the published calculator; optionally new_name / new_slug.

Fill an OC-400.1 (Application for Fee by Claimant's Attorney) from computed award numbers and return it as an UNSIGNED PDF, through the same field map the Pro Workspace fills. It will NOT accept a signature and will NOT fill any attorney-identity field (Representative ID, firm, address, phone) — those are completed in the workspace by the attorney whose fee it is. It reads nothing from the database and does no fee math: pass feeRequestedDollar, or pass feeRequested and it is floored to the nearest $5 by the same rule the workspace uses. Owner-restricted. The result is a DRAFT, not a filing: check every figure against the tile it came from.

Return a starter declarative calculator spec to fill in.

The real NYS WC formula catalog behind the Comp Desk calculators: algebraic form, symbol table (what every symbol means), plain-language explanation, statutory/case citation, and a per-entry verified flag. Served from the SAME module the Pro Workspace shows, so the API and the app cannot disagree. Filter by id, by group (aww, rate, slu, lwec, perm, settle, fee), or by a free-text term; omit everything for the whole catalog. An entry with verified:false has NOT been through legal review — never present its citation as settled law.

The New York maximum and minimum weekly workers' compensation benefit for a date of accident (the rate year runs July 1 to June 30; the maximum is fixed by the date of accident, never by today's date). Use for "what is the max rate for a 2025 injury". New York State only. Computes with The Comp Desk calc-core (the engine behind the app, the website calculators and the Pro Workspace); it never estimates. If an input is missing it returns status "missing" with every input still needed and calculates nothing. Returns the figures, the rate year used, the formulas with their citations (each flagged with whether it has been attorney-reviewed), and the not-legal-advice notice. Needs your builder key. Same engine the Pro Workspace tiles call through CD.Calc, so a figure here matches the app to the cent.

The date written notice of the injury to the employer is due under the NY Workers' Compensation Law, counted from the date of accident, or from the date of disablement for an occupational condition that built up over time, with the days left from today in New York and the statute it comes from. New York State only; not a substitute for checking the facts. Needs your builder key. Same engine the Pro Workspace tiles call through CD.Calc, so a figure here matches the app to the cent.

The existing Comp Desk calculators (SLU, LWEC, CCP, AWW/concurrent employment, Burns, etc.): the calc-core function and statute behind each, the canonical source URL, and the ids of the formula-catalog entries that document each one. Start here, then call get_formula for the algebra. Use this to build on or improve an existing calculation instead of starting from scratch.

Check the status (submitted/changes_requested/approved/rejected/published) of your submissions.

List the calculators already approved and published into the Pro Workspace, so you can fork one as a starting point.

List your sandbox: calculators, skills, and recent submissions with their review status.

Generate a self-contained HTML file that renders this calculator as a real tile (same look as the live workspace). Save the returned html and open it in your browser to test before submitting.

Return a valid, self-sufficient SKILL.md scaffold (autonomy: standalone + browser/local-files/user-input data sources + a no-backend fallback section) to start a new skill.

The cervical or lumbar radiculopathy severity ranking, scored the way the Pro Workspace Radiculopathy tile scores it, from the 2012 NYS Impairment Guidelines tables as calc-core carries them: imaging 16, EMG 6, muscle weakness by grade (0–1: 20, 2: 18, 3: 6, 4–5: 0) plus atrophy 6 under the root's weakness cap, sensory (compromised 4, anesthesia 6) under the root's sensory cap, reflex (diminished 4, absent 6), tension signs 4; the letter from Table S11.7. Give the findings (unlisted findings count as normal / no), or instead total_points to rank a total already scored. A total with no row on Table S11.7 (1–3 points, or above the top row) is refused with the reason, never given a letter. Cervical roots C5–T1, lumbar L3–S1. New York State only. Computes with The Comp Desk calc-core, the same engine as the app and the Pro Workspace; it never estimates. A missing input returns status "missing" and nothing is calculated. Returns the figures, the steps with the rule and engine function behind each, and the not-legal-advice notice. Needs your builder key. Same engine the Pro Workspace tiles call through CD.Calc, so a figure here matches the app to the cent.

Submit a sandbox calculator or skill to the owner for review. Nothing publishes without approval. Skills are gated by the Self-Sufficiency Contract — a backend-dependent skill is rejected at submit AND at approval; run validate_build first and fix any self_sufficient failures.

Update one of your draft calculators by id.

Validate a calculator spec or a skill SKILL.md before submitting. For skills this also runs the Self-Sufficiency Contract: the skill must complete its task with NO case-management backend — declare "autonomy: standalone", name a no-backend data source (browser / local-files / user-input), and document the fallback in a heading. Returns errors/warnings + self_sufficient.