@cotal-ai/runtime 0.90.1 → 0.92.0

package/dist/offline-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offline-command.js","sourceRoot":"","sources":["../src/offline-command.ts"],"names":[],"mappings":"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"}

package/dist/run-command.d.ts

@@ -1,4 +1,40 @@
 import { EpEnvelopeError, type ParsedArgs } from "@cotal-ai/core";
+interface RunValues {
+    space?: string;
+    server?: string;
+    creds?: string;
+    file?: string;
+    endpoint?: string;
+    on?: string;
+    timeout?: string;
+    by?: string;
+    value?: string;
+    artifact?: string;
+    local?: boolean;
+    /** `--local start` only: the channel ceiling the operator admits the run under (SPEC 14.8),
+     *  comma-separated channel patterns; `none` is deny-all. Both are REQUIRED for a local start:
+     *  a local run never defaults to the host's own scope. */
+    "admit-read"?: string;
+    "admit-publish"?: string;
+    /** `revoke --local` only: why the run's admission is being revoked, recorded on the marker. */
+    reason?: string;
+    /** `migrate` only: commit-side overrides, parsed so the verb can REFUSE them by name rather than
+     *  let the dispatcher reject them as unknown flags. Each decides what a commit does with an
+     *  orphan; this verb only checks, so none is taken. */
+    adopt?: string;
+    release?: string;
+    "discard-approvals"?: boolean;
+    /** `ps` and `journal` only: one JSON object per row per line on stdout. */
+    json?: boolean;
+    page?: boolean;
+    limit?: string;
+    cursor?: string;
+    plain?: boolean;
+    handler?: string;
+    status?: string;
+    to?: string;
+    note?: string;
+}
 /**
  * What a hosted `run` verb prints when its manager describe drew no answer, SCOPED TO THE RAIL the
  * describe rode ({@link unansweredRail}, SPEC 13.15).
@@ -23,4 +59,12 @@ export declare function unansweredManagerRefusal(e: EpEnvelopeError): string;
 /** `cotal run <start|resume|ps|journal|answer|amend>` — dispatch. The manager hosts by default;
  *  `--local` drives in this process over one connection per invocation. */
 export declare function runWorkflow(args: ParsedArgs): Promise<void>;
+/** Public workflow grammar, before catalog preparation or native requests. */
+export declare function workflowArguments(args: ParsedArgs): {
+    values: RunValues;
+    verb: string;
+    a?: string;
+    b?: string;
+};
+export {};
 //# sourceMappingURL=run-command.d.ts.map

package/dist/run-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-command.d.ts","sourceRoot":"","sources":["../src/run-command.ts"],"names":[],"mappings":"AAuBA,OAAO,EAEL,eAAe,EA8Bf,KAAK,UAAU,EAOhB,MAAM,gBAAgB,CAAC;AA+fxB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,eAAe,GAAG,MAAM,CAMnE;AAgQD;2EAC2E;AAC3E,wBAAsB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA6DjE"}
+{"version":3,"file":"run-command.d.ts","sourceRoot":"","sources":["../src/run-command.ts"],"names":[],"mappings":"AAuBA,OAAO,EAEL,eAAe,EA8Bf,KAAK,UAAU,EAOhB,MAAM,gBAAgB,CAAC;AAiBxB,UAAU,SAAS;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;8DAE0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+FAA+F;IAC/F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;2DAEuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,2EAA2E;IAC3E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAqdD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,eAAe,GAAG,MAAM,CAMnE;AAiKD;2EAC2E;AAC3E,wBAAsB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCjE;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAgE/G"}

package/dist/run-command.js

@@ -22,7 +22,10 @@ import { jetstream, jetstreamManager } from "@nats-io/jetstream";
 import { Kvm } from "@nats-io/kv";
 import { BASELINE_LIFECYCLE_ENDPOINT, EpEnvelopeError, assertLifecycleToken, LANG_PROBLEM_DETAIL_KIND, dialerFor, invokeRepairingSplit, newTakeoverId, newIdentity, mintCreds, issuedUserCaller, openRecordsBucket, admissionBucket, createRunAdmission, readRunAdmission, revokeRunAdmission, chatSubject, DEV_OWNER, readRunProgram, readRunRecord, renderLifecycleBlocked, replayRunJournal, resolveService, runDriverCaller, RUN_LAUNCH_DEADLINE_MS, standaloneConnectOpts, unansweredRail, unansweredRequest, } from "@cotal-ai/core";
 import { RunHeld } from "@cotal-ai/lang";
-import { connectOrExit, controlCaller, endpointAuth, resolveControlTarget, resolveSeatControlTarget } from "@cotal-ai/workspace";
+import { CommandFailure, presentationOf, recordOperationSpace, connectOrExit, controlCaller, endpointAuth, resolveControlTarget, resolveSeatControlTarget } from "@cotal-ai/workspace";
+import { offlineWorkflow } from "./offline-command.js";
+import { seatTurnCommand } from "./seat-turn-command.js";
+import { printRunDetail, printRunList, runReceipt } from "./workflow-views.js";
 import { startRun, driveRun } from "./run-driver.js";
 import { migrateRun } from "./migrate.js";
 import { cotalLangRunHost as runHost, journalRows } from "./run-host.js";
@@ -65,7 +68,9 @@ async function openPlanes(values, role, mint) {
  *  file can supply neither, and is refused by name before any other local check. */
 function refuseSingleCredential(conn) {
     if (conn.creds !== undefined && conn.auth === undefined)
-        throw new Error("run --local needs the space signer to mint a separate mediator; a single --creds file cannot supply both roles. From the project with the recorded static-auth mesh and signer, omit --creds and run cotal run start --local --space <space> --file <program>. If you only have caller credentials, ask the mesh operator to host the run.");
+        throw new CommandFailure("refused", "USAGE_INVALID", "run --local needs the space signer to mint a separate mediator; a single --creds file cannot supply both roles", {
+            remedy: "From the project with the recorded static-auth mesh and signer, omit --creds and run cotal run start --local --space <space> --file <program>. If you only have caller credentials, ask the mesh operator to host the run.",
+        });
 }
 /** Mint from the same resolved target as the driver, preserving its broker and TLS intent. */
 async function openMediator(driver, pin) {
@@ -319,7 +324,7 @@ async function ps(values, planes) {
     // the record's state beside its revocation marker (SPEC 14.8), so `--local` and hosted agree
     // row for row, `--json` included.
     const rows = await runHost.list(planes, values.endpoint !== undefined ? { endpoint: values.endpoint } : {});
-    printRuns(planes.space, rows, values.json === true);
+    printRunList(planes.space, rows, values);
 }
 async function journal(values, planes, endpoint, runId, takeoverId) {
     if (runId === undefined) {
@@ -327,8 +332,10 @@ async function journal(values, planes, endpoint, runId, takeoverId) {
         process.exit(1);
     }
     // The replay durable is named by the takeover id this call's credential was minted for.
-    const replay = await replayRunJournal(planes.js, planes.jsm, planes.space, runId, takeoverId);
-    printJournal(runId, await journalRows(planes.kv, endpoint, replay.records), values.json === true);
+    const view = await runHost.status(planes, { endpoint, runId, takeoverId });
+    if (!view)
+        throw new CommandFailure("refused", "TARGET_NOT_FOUND", "no workflow record was returned for this run", { target: { space: planes.space, endpoint, run: runId } });
+    printRunDetail(planes.space, view, values);
 }
 /** `answer --local`: the pause is found under the READ credential this call was opened on, then
  *  the answer rides a second, one-shot credential pinned to that pause's token. */
@@ -493,8 +500,9 @@ export function unansweredManagerRefusal(e) {
  *  fetch, digest-verified recompile), then the invoke, re-issued after a bind split
  *  ({@link invokeRepairingSplit}). The reply's data on success; on a refusal the manager's own
  *  sentence, printed, and a non-zero exit. */
-async function askHost(values, command, args) {
+async function askHost(values, command, args, resolved) {
     const t = await resolveRunControlTarget(values);
+    resolved?.(t.space);
     const who = controlCaller(t.auth);
     if ("refusal" in who) {
         console.error(who.refusal);
@@ -549,120 +557,24 @@ async function askHost(values, command, args) {
  *  target resolution unchanged. `--on` reaches the mint on every path and becomes the instance the
  *  call addresses; a user-mode view already carries the instance its issuer bound. */
 async function resolveRunControlTarget(values) {
-    const on = onInstanceOrExit(values.on);
+    const on = values.on;
     const seat = values.creds === undefined ? await resolveSeatControlTarget(values, on) : undefined;
-    const t = seat?.mode === "auth" ? seat : await resolveControlTarget(values, "control-caller-privileged", on);
+    const target = seat?.mode === "auth" ? seat : await resolveControlTarget(values, "control-caller-privileged", on);
+    recordOperationSpace(target.space);
     if (on === undefined)
-        return t;
-    if (t.auth.managerInstanceId !== undefined && t.auth.managerInstanceId !== on) {
-        console.error("run: the manager pin differs from this credential's instance authority");
-        process.exit(1);
-    }
-    return { ...t, auth: { ...t.auth, managerInstanceId: on } };
-}
-/** `--on <instance>`, checked as the CLI's other pinning commands check it: an empty value (an unset
- *  shell variable) is refused rather than read as absent, and the id must be a lifecycle token. */
-function onInstanceOrExit(on) {
-    if (on === undefined)
-        return undefined;
-    try {
-        return assertLifecycleToken(on, "instanceId");
-    }
-    catch (e) {
-        console.error(`run: ${e.message}. --on wants the whole manager instance id as \`cotal ps\` prints it`);
-        process.exit(1);
-    }
+        return target;
+    if (target.auth.managerInstanceId !== undefined && target.auth.managerInstanceId !== on)
+        throw new CommandFailure("refused", "CONFLICT", "the requested manager instance differs from this credential's instance authority; no other manager was selected");
+    return { ...target, auth: { ...target.auth, managerInstanceId: on } };
 }
 function renderLangProblem(d) {
     const where = d.where;
     const at = where ? `${where.file ?? "<program>"}:${where.line ?? "?"}:${where.column ?? "?"}` : "<program>";
     return `  ${String(d.code ?? "L????")} ${String(d.title ?? "")} (${at})\n    ${String(d.cause ?? "")}\n    fix: ${String(d.fix ?? "")}`;
 }
-/** `--json` prints each row unchanged as one JSON object per line, as `cotal ps --json` does for
- *  seats: stdout carries rows only, so an empty journal prints nothing there. */
-function printJournal(runId, rows, json) {
-    if (json) {
-        for (const r of rows)
-            console.log(JSON.stringify(r));
-        return;
-    }
-    if (rows.length === 0) {
-        console.log(`run ${runId}: no journal records (never started, or retired)`);
-        return;
-    }
-    for (const r of rows) {
-        if (r.kind === "activation") {
-            console.log(`#${r.n}  activation  holder=${r.holder} epoch=${r.epoch} replayedTo=${r.replayedTo}`);
-            continue;
-        }
-        console.log(`#${r.n}  step        ${r.step}  ${r.outcome}`);
-        if (r.asks !== undefined)
-            console.log(`            asks        ${r.asks}${r.addressee !== undefined ? `  (escalates to ${r.addressee})` : ""}`);
-        if (r.answer !== undefined) {
-            const facts = [
-                ...(Object.hasOwn(r.answer, "value") ? [`value=${JSON.stringify(r.answer.value)}`] : []),
-                ...(r.answer.by !== undefined ? [`by=${JSON.stringify(r.answer.by)}`] : []),
-                ...(r.answer.artifact !== undefined ? [`artifact=${JSON.stringify(r.answer.artifact)}`] : []),
-                ...(r.answer.at !== undefined ? [`at=${JSON.stringify(r.answer.at)}`] : []),
-                `answerId=${JSON.stringify(r.answer.answerId)}`,
-            ];
-            console.log(`            answered    ${facts.join("  ")}`);
-        }
-        for (const m of r.amendments ?? []) {
-            const facts = [
-                ...(Object.hasOwn(m, "value") ? [`value=${JSON.stringify(m.value)}`] : []),
-                `by=${JSON.stringify(m.by)}`,
-                ...(m.artifact !== undefined ? [`artifact=${JSON.stringify(m.artifact)}`] : []),
-                `at=${JSON.stringify(m.at)}`,
-                `supersedes=${JSON.stringify(m.supersedes)}`,
-                `answerId=${JSON.stringify(m.answerId)}`,
-            ];
-            console.log(`            amended     ${facts.join("  ")}`);
-        }
-    }
-}
-function printRuns(space, rows, json) {
-    // A marker the host could not read fails the listing after every row is printed, under `--json`
-    // as in the table: its reason and the record's word on stderr, and exit 1.
-    const unchecked = rows.filter((r) => r.revocationUnreadable !== undefined);
-    const reportUnchecked = () => {
-        for (const r of unchecked)
-            console.error(`${r.endpoint}/${r.runId}: revocation marker could not be read (${r.revocationUnreadable}); its record reads ${r.state ?? "(no status)"}`);
-        if (unchecked.length > 0)
-            process.exitCode = 1;
-    };
-    if (json) {
-        for (const r of rows)
-            console.log(JSON.stringify(r));
-        reportUnchecked();
-        return;
-    }
-    if (rows.length === 0) {
-        console.log(`no workflow runs recorded in space ${space}`);
-        return;
-    }
-    // The same reading as `run ps --local`: a marker wins over the record's state, and a marker the
-    // host could not read prints `unchecked` with the record's word on stderr and exit 1.
-    const table = rows.map((r) => [
-        r.runId,
-        r.endpoint,
-        r.revoked !== undefined ? "revoked" : r.revocationUnreadable !== undefined ? "unchecked" : r.state ?? "(no status)",
-        r.holder ?? "-",
-        r.journalHigh === undefined ? "-" : String(r.journalHigh),
-        r.forkedFrom === undefined ? "-" : `${r.forkedFrom.run}@${r.forkedFrom.step}`,
-    ]);
-    const header = ["RUN", "ENDPOINT", "STATE", "HOLDER", "JOURNAL", "FORKED-FROM"];
-    const widths = header.map((h, i) => Math.max(h.length, ...table.map((r) => r[i].length)));
-    const line = (r) => r.map((cell, i) => cell.padEnd(widths[i])).join("  ");
-    console.log(line(header));
-    for (const r of table)
-        console.log(line(r));
-    for (const r of rows)
-        if (r.revoked !== undefined)
-            console.log(`${r.endpoint}/${r.runId}: revoked by ${r.revoked.by} (${r.revoked.reason}); the status record is left as its driver last wrote it`);
-    reportUnchecked();
-}
 async function hosted(values, verb, a, b) {
+    let space;
+    const ask = (command, args) => askHost(values, command, args, (resolved) => { space = resolved; });
     const endpoint = values.endpoint !== undefined ? { endpoint: values.endpoint } : {};
     // A hosted drive is recorded under the manager's own endpoint; a caller cannot choose another,
     // so an `--endpoint` here is refused rather than dropped.
@@ -682,13 +594,12 @@ async function hosted(values, verb, a, b) {
     }
     if (verb === "start") {
         const source = readProgram(values);
-        const started = await askHost(values, "run-start", {
+        const started = await ask("run-start", {
             source,
             file: values.file,
             ...(values.timeout !== undefined ? { timeout: values.timeout } : {}),
         });
-        console.log(`started run ${started.runId} on the manager; it runs there until it completes or is held`);
-        console.log(`  cotal run journal ${started.runId}    # follow its steps`);
+        runReceipt("start", space, started, values);
         return;
     }
     if (verb === "resume") {
@@ -700,13 +611,13 @@ async function hosted(values, verb, a, b) {
             console.error(`run resume: the manager resumes a run from its recorded program, so --file is not taken; a run with no recorded program is resumed with \`cotal run resume ${a} --local --file <program>\``);
             process.exit(1);
         }
-        const resumed = await askHost(values, "run-resume", { runId: a, ...(values.timeout !== undefined ? { timeout: values.timeout } : {}) });
-        console.log(`resumed run ${resumed.runId} on the manager`);
+        const resumed = await ask("run-resume", { runId: a, ...(values.timeout !== undefined ? { timeout: values.timeout } : {}) });
+        runReceipt("resume", space, resumed, values);
         return;
     }
     if (verb === "ps") {
         if (values.page === true) {
-            const page = await askHost(values, "run-ps", { ...endpoint, page: {
+            const page = await ask("run-ps", { ...endpoint, page: {
                     ...(values.limit !== undefined ? { limit: Number(values.limit) } : {}),
                     ...(values.cursor !== undefined ? { cursor: values.cursor } : {}),
                 } });
@@ -719,9 +630,8 @@ async function hosted(values, verb, a, b) {
             }
             return;
         }
-        const rows = await askHost(values, "run-ps", Object.keys(endpoint).length ? endpoint : undefined);
-        const t = values.space ?? "(the resolved mesh)";
-        printRuns(t, rows, values.json === true);
+        const rows = await ask("run-ps", Object.keys(endpoint).length ? endpoint : undefined);
+        printRunList(space, rows, values);
         return;
     }
     if (verb === "journal") {
@@ -729,11 +639,10 @@ async function hosted(values, verb, a, b) {
             console.error(USAGE);
             process.exit(1);
         }
-        const view = await askHost(values, "run-status", { runId: a, ...endpoint });
-        const st = view.status;
-        // Under --json the run's header line is structure, not a row: it goes to stderr.
-        (values.json === true ? console.error : console.log)(`run ${view.runId} on ${view.endpoint}: ${st === undefined ? "(no status)" : `${st.state}, holder ${st.holder}, epoch ${st.epoch}`}`);
-        printJournal(view.runId, view.journal, values.json === true);
+        const view = await ask("run-status", { runId: a, ...endpoint });
+        if (space === undefined)
+            throw new Error("the native run target was not reported");
+        printRunDetail(space, view, values);
         return;
     }
     // answer and amend: the manager records the caller as the answerer (SPEC 14.5), so no `--by`
@@ -744,7 +653,7 @@ async function hosted(values, verb, a, b) {
         process.exit(1);
     }
     const value = parseAnswerValue(values);
-    const result = await askHost(values, "run-answer", {
+    const result = await ask("run-answer", {
         runId: a,
         stepKey: b,
         ...endpoint,
@@ -752,39 +661,16 @@ async function hosted(values, verb, a, b) {
         ...(values.artifact !== undefined ? { artifact: values.artifact } : {}),
         ...(verb === "amend" ? { amend: true } : {}),
     });
-    console.log(JSON.stringify(result, null, 2));
+    runReceipt(verb, space, result, values);
 }
 /** `cotal run <start|resume|ps|journal|answer|amend>` — dispatch. The manager hosts by default;
  *  `--local` drives in this process over one connection per invocation. */
 export async function runWorkflow(args) {
-    const values = args.values;
-    const [verb, a, b] = args.positionals;
-    if (verb === undefined || !["start", "resume", "ps", "journal", "answer", "amend", "revoke", "migrate"].includes(verb)) {
-        console.error(USAGE);
-        process.exit(1);
-    }
-    if (values.page !== undefined || values.limit !== undefined || values.cursor !== undefined) {
-        if (verb !== "ps" || values.local === true || values.page !== true || values.on === undefined) {
-            console.error("diagnostic paging requires run ps --page --on <instance> without --local");
-            process.exit(1);
-        }
-        if (values.limit !== undefined && (!/^[1-9][0-9]*$/.test(values.limit) || Number(values.limit) > 16)) {
-            console.error("run ps --page: --limit must be between 1 and 16");
-            process.exit(1);
-        }
-        if (values.cursor !== undefined && (values.cursor.length > 3072 || !/^[A-Za-z0-9_-]+$/.test(values.cursor))) {
-            console.error("run ps --page: invalid cursor encoding");
-            process.exit(1);
-        }
-    }
-    if (values.json === true && verb !== "ps" && verb !== "journal") {
-        console.error(`run ${verb}: --json is taken by \`ps\` and \`journal\` only`);
-        process.exit(1);
-    }
-    if (values.on !== undefined && values.local === true) {
-        console.error(`run ${verb}: --on pins a hosted verb to one manager instance and --local drives in this process, so pass one of them`);
-        process.exit(1);
-    }
+    const { values, verb, a, b } = workflowArguments(args);
+    if (verb === "validate" || verb === "plan" || verb === "simulate")
+        return offlineWorkflow(verb, a, values);
+    if (verb === "turns" || verb === "yield")
+        return seatTurnCommand(verb, a, values);
     if (verb === "revoke") {
         // Revocation is an operator act on the admission store, never a served command: the marker is
         // written from the folder's trust material, so it is `--local` only.
@@ -826,4 +712,111 @@ export async function runWorkflow(args) {
         await planes.close();
     }
 }
+/** Public workflow grammar, before catalog preparation or native requests. */
+export function workflowArguments(args) {
+    const values = { ...args.values };
+    presentationOf(values);
+    const [raw = "list", first, second, ...extra] = args.positionals;
+    const verb = { list: "ps", show: "journal", check: "migrate" }[raw] ?? raw;
+    const usage = (message) => { throw new CommandFailure("refused", "USAGE_INVALID", message); };
+    if (extra.length || !["start", "resume", "ps", "journal", "answer", "amend", "revoke", "migrate", "validate", "plan", "simulate", "turns", "yield"].includes(verb))
+        usage("choose a declared run command; run it bare to list workflows");
+    let a = first;
+    let b = second;
+    if (verb === "start") {
+        if (second !== undefined || (first !== undefined && values.file !== undefined))
+            usage("run start takes one source file");
+        values.file = first ?? values.file;
+        if (!values.file?.trim())
+            usage("run start requires a workflow source file");
+        a = undefined;
+    }
+    else if (verb === "migrate") {
+        if (!first || (second !== undefined && values.file !== undefined))
+            usage("run check takes a run id and one edited source file");
+        values.file = second ?? values.file;
+        if (!values.file?.trim())
+            usage("run check requires the edited source file");
+        values.local = true;
+        b = undefined;
+    }
+    else if (["validate", "plan", "simulate"].includes(verb)) {
+        if (!first || second !== undefined || values.file !== undefined)
+            usage(`run ${verb} takes one positional source file`);
+        if (values.space !== undefined || values.server !== undefined || values.creds !== undefined || values.endpoint !== undefined || values.local !== undefined)
+            usage(`run ${verb} is offline and takes no mesh or caller selection`);
+    }
+    else if (verb === "ps" || verb === "turns") {
+        if (first !== undefined)
+            usage(`run ${raw} takes no positional argument`);
+    }
+    else if (verb === "answer" || verb === "amend") {
+        if (!first || !second)
+            usage(`run ${verb} requires a run id and step key`);
+    }
+    else if (!first || second !== undefined)
+        usage(`run ${raw} takes one identifier`);
+    const scopes = {
+        timeout: ["start", "resume"], by: ["answer", "amend", "revoke"], reason: ["revoke"], value: ["answer", "amend"], artifact: ["answer", "amend"],
+        "admit-read": ["start"], "admit-publish": ["start"], adopt: ["migrate"], release: ["migrate"], "discard-approvals": ["migrate"],
+    };
+    for (const [flag, modes] of Object.entries(scopes))
+        if (args.values[flag] !== undefined && !modes.includes(verb))
+            usage(`--${flag} is not taken by this run command`);
+    if (values.page !== undefined || values.limit !== undefined || values.cursor !== undefined) {
+        if (verb !== "ps" || values.local === true || values.page !== true || values.on === undefined)
+            usage("diagnostic paging requires run --page --on <instance> without --local");
+        if (values.limit !== undefined && (!/^[1-9][0-9]*$/.test(values.limit) || Number(values.limit) > 16))
+            usage("run --page: --limit must be between 1 and 16");
+        if (values.cursor !== undefined && (values.cursor.length > 3072 || !/^[A-Za-z0-9_-]+$/.test(values.cursor)))
+            usage("run --page: invalid cursor encoding");
+        if (values.plain)
+            usage("diagnostic pages produce bounded JSON and take no --plain");
+    }
+    if ((values["admit-read"] !== undefined || values["admit-publish"] !== undefined) && values.local !== true)
+        usage("admission ceilings belong to the explicit local start");
+    if (values.by !== undefined && values.local !== true)
+        usage("the hosted manager records the authenticated caller; --by is only for the local path");
+    if ((verb === "start" || verb === "resume") && values.endpoint !== undefined && values.local !== true)
+        usage("a hosted run uses the manager's endpoint; --endpoint is only for the local path");
+    if (verb === "revoke" && (values.local !== true || !values.by?.trim() || !values.reason?.trim()))
+        usage("run revoke requires --local --by <actor> --reason <text> under the existing trust checks");
+    if (values.value !== undefined) {
+        try {
+            JSON.parse(values.value);
+        }
+        catch {
+            usage("--value must be valid JSON");
+        }
+    }
+    if (values.handler !== undefined && verb !== "simulate")
+        usage("--handler belongs to run simulate");
+    if ((values.status !== undefined || values.to !== undefined || values.note !== undefined) && verb !== "yield")
+        usage("--status, --to and --note belong to run yield");
+    if (verb === "yield") {
+        if (!["done", "blocked", "handoff"].includes(values.status ?? ""))
+            usage("run yield requires --status done, blocked or handoff");
+        if (values.status === "handoff" ? !values.to?.trim() : values.to !== undefined)
+            usage("--to is required only for a handoff yield");
+    }
+    if (verb === "turns" || verb === "yield") {
+        if (values.creds !== undefined || values.endpoint !== undefined || values.local !== undefined || values.by !== undefined)
+            usage("run turns/yield use the managed seat's own identity, not an operator override");
+    }
+    if (values.file !== undefined && !["start", "resume", "migrate"].includes(verb))
+        usage("this run command takes no --file");
+    if (values.on !== undefined) {
+        if (values.local === true || ["validate", "plan", "simulate", "turns", "yield", "revoke"].includes(verb))
+            usage("--on pins a hosted run command; local and offline commands take no manager instance");
+        try {
+            assertLifecycleToken(values.on, "instanceId");
+        }
+        catch {
+            usage("--on requires the full manager instance id as cotal ps prints it");
+        }
+    }
+    if ((values.json || values.plain) && values.local && !["ps", "journal"].includes(verb))
+        usage("the local drive does not implement structured or plain receipts; use the hosted form");
+    return { values, verb, ...(a === undefined ? {} : { a }), ...(b === undefined ? {} : { b }) };
+}
 //# sourceMappingURL=run-command.js.map