@miadi/connector 0.1.8 → 0.1.10

package/README.md

@@ -20,9 +20,9 @@ Call `get_capabilities` first. It names the signed-in person, their Miadi API ti
 
 | kind | tools |
 |---|---|
-| reads | `get_capabilities` `get_context` `list_circles` `get_circle` `list_sessions` `get_session` `get_evidence` `get_evaluations` `get_narrative_beats` `review_lookup` `review_versions` `handoff_status` `list_records` `get_run_result` `search` `fetch` |
+| reads | `get_capabilities` `get_context` `list_circles` `get_circle` `list_sessions` `get_session` `get_evidence` `get_evaluations` `get_narrative_beats` `review_lookup` `review_versions` `handoff_status` `list_records` `get_run_result` `mission_status` `provider_capabilities` `search` `fetch` |
 | contributions | `append_observation` `open_inquiry` `link_records` `propose_narrative_beat` `record_evaluation` `register_source_intent` `record_handoff` `update_handoff` `prepare_calendar_event` `save_research` |
-| requests (approved by a person) | `propose_work` `propose_session_completion` `request_authorized_run` `request_review_operation` `request_deep_diver` `link_review_to_episode` `request_inquiry_episode` |
+| requests (approved by a person) | `propose_work` `propose_session_completion` `request_authorized_run` `request_session_steer` `request_review_operation` `request_deep_diver` `link_review_to_episode` `request_inquiry_episode` |
 | decisions in the conversation | `show_decisions` (cards), `decide_request` (called by the card only) |
 
 - **Reads** need Miadi's read tier and stay within it. A person Miadi gives no API tier reaches only `get_capabilities`. Sessions need the write tier, because a session's name and pane are operator data. For the same reason, below the write tier a record someone else made shows no session, working folder or seat, and no long bodies.
@@ -38,6 +38,16 @@ Call `get_capabilities` first. It names the signed-in person, their Miadi API ti
 
 The model that asked cannot approve its own request.
 
+`get_run_result` returns one `projection` of the decision, dispatch/completion state, receipt link and outstanding instructions. The in-chat card, approval page and Miadi's research page use that same read model. Asking `show_decisions` for an already-decided `record_id` shows its receipt without issuing another decision token. An in-flight card can refresh status without repeating the operation. A completed basic review with unapplied approval instructions remains open as **changes outstanding**, not falsely finished.
+
+### Following and steering a mission
+
+`mission_status` joins one mission read-only: its source request and decision, the sessions bound to it (each with how it is bound — a signed `session:` ref, the delivered brief's target, or the requested name), its issues and PRs, its steering grant, and where it stands stage by stage — approved, queued, delivered, running, merged, released, closed — each by its evidence, so an idle pane or a merge is never read as completion. Live panes and Miadi's session view are joined only for the write tier.
+
+`request_session_steer` sends one authorized follow-up to one existing live agent, within the steering grant an approved run carries (`steering: { max_attempts, expires_at, pane }` on `request_authorized_run`). It peeks at the bound pane — the grant's pane or the session's first pane, never whichever pane is active — refuses a busy agent or a pane that is not an agent, types the exact instruction literally, and re-peeks to verify the agent accepted it (`accepted`) or only holds it at the prompt (`submitted`). Every attempt leaves a durable artifact with the instruction's sha256, its grant, its target and both captures. A steer the grant does not cover waits for one explicit scoped human decision on its `approval_url`, which runs exactly that instruction once.
+
+`request_authorized_run` may name a `provider` (`codex`, `pi`, `copilot`, `claude`). The connector verifies it is installed on the host before recording anything; an unknown or unavailable provider answers `provider_unavailable` and the mission stays unstarted. With no provider named, the first installed provider in the preference order is resolved and named in the brief; Claude Code is never chosen silently — it runs only when named. `provider_capabilities` (write tier) reports what the host has installed, the sign-in evidence, the preference order, and the read-only Jev routing preflight (`unconfigured` without `MIADI_JEV_URL`). A provider name inside a task's text selects nothing.
+
 ### Deciding inside the conversation
 
 In a client that renders MCP Apps (ChatGPT among them), `show_decisions` draws one card per request awaiting a decision: what is asked, by whom, and what approving does. The person decides on the card with their own click: Approve, Approve with my changes, Send back for revision, or Decline. The card then shows the receipt.

package/dist/approve.d.ts

@@ -15,6 +15,9 @@ import type { Ledger } from "./store.js";
 import type { MiadiClient } from "./miadi.js";
 import { type MiadiPerson } from "./people.js";
 import { type ConnectorRecord } from "./records.js";
+import { type RequestProjection } from "./request-state.js";
+import { type TmuxLike } from "./steer.js";
+export { factoryDir, runBriefFile, readQueueState } from "./queue-state.js";
 export interface ApprovalDeps {
     config: ConnectorConfig;
     ledger: Ledger<ConnectorRecord>;
@@ -24,6 +27,10 @@ export interface ApprovalDeps {
     /** The factory directory holding queue/ (default ~/.miadi/factory). */
     factoryDir?: string;
     tmuxSessions?: () => string[];
+    /** The steering surface (jgwill/Miadi#893); tests inject a fake, production uses tmux. */
+    tmux?: TmuxLike;
+    /** Re-peek delay after a steer is typed (default 4000ms; tests pass 0). */
+    steerSettleMs?: number;
 }
 /**
  * What a person may decide on a request. Approving with changes runs it with the
@@ -32,20 +39,6 @@ export interface ApprovalDeps {
  */
 export declare const DECISIONS: readonly ["approve", "approve_with_changes", "request_revision", "decline"];
 export type Decision = (typeof DECISIONS)[number];
-export declare function factoryDir(env?: NodeJS.ProcessEnv): string;
-export declare function runBriefFile(record: {
-    id: string;
-}): string;
-/** Where a run request's brief is: waiting, delivered by the intake, cancelled, or not queued. */
-export declare function readQueueState(record: ConnectorRecord, dir?: string): {
-    state: string;
-    file: string;
-    note?: undefined;
-} | {
-    state: string;
-    file: string;
-    note: string;
-};
 /** The task a work proposal asks for, written from the proposal's own fields. */
 export declare function proposalTask(record: ConnectorRecord): string;
 export declare function runBrief(record: ConnectorRecord, approver: MiadiPerson, sessions: string[], instructions?: string): {
@@ -64,6 +57,8 @@ export declare function executeApproved(record: ConnectorRecord, approver: Miadi
 /** A request is decided once: a second decision while one runs, or after it, is refused. */
 export declare class AlreadyDecided extends Error {
 }
+/** Whether a decision on this request is being recorded now, its run may still be going. */
+export declare function isBeingDecided(recordId: string): boolean;
 export declare function decide(r: ConnectorRecord, person: MiadiPerson, choice: Decision, deps: ApprovalDeps, opts: {
     instructions?: string;
     note?: string;
@@ -93,5 +88,14 @@ export declare function isApprovable(r: ConnectorRecord | undefined): r is Conne
 /** What approving a request does, in one sentence, for the card a person decides on. */
 export declare function consequenceOf(r: ConnectorRecord): string;
 export declare function registerApprovalRoutes(app: Express, deps: ApprovalDeps): void;
+/** The request, and the decision form for a write-tier person (their token carried in the form they just signed into). */
+/**
+ * Where a request stands, as every surface of the connector reads it (request-state.ts):
+ * the factory queue is read for the two kinds that dispatch a brief.
+ */
+export declare function requestProjection(record: ConnectorRecord, opts?: {
+    reviewBase?: string;
+    factoryDir?: string;
+}): RequestProjection | null;
 /** How a request is named to a person. */
 export declare const KIND_LABELS: Record<string, string>;

package/dist/approve.js

@@ -10,49 +10,23 @@
  * is appended as a record that supersedes the request (state, approval, receipt).
  */
 import express from "express";
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { mkdirSync, writeFileSync } from "node:fs";
 import { execFileSync } from "node:child_process";
-import { homedir } from "node:os";
 import { join } from "node:path";
 import { escapeHtml } from "@miadi/node-service-kit/format";
 import { MiadiError } from "./miadi.js";
 import { MiadiUnavailable } from "./people.js";
 import { current, newRecordId } from "./records.js";
-const APPROVABLE = new Set([
-    "run_request",
-    "review_operation_request",
-    "deep_diver_request",
-    "review_episode_link_request",
-    "work_proposal",
-    "session_completion_proposal",
-    "inquiry_episode_request",
-]);
+import { APPROVABLE, projectRequest } from "./request-state.js";
+import { factoryDir, runBriefFile, readQueueState } from "./queue-state.js";
+import { steerAttempts, steerSession, tmuxAdapter } from "./steer.js";
+export { factoryDir, runBriefFile, readQueueState } from "./queue-state.js";
 /**
  * What a person may decide on a request. Approving with changes runs it with the
  * approver's instructions carried into what runs; a revision sends it back to
  * whoever asked, with instructions, and runs nothing.
  */
 export const DECISIONS = ["approve", "approve_with_changes", "request_revision", "decline"];
-export function factoryDir(env = process.env) {
-    return env.MIADI_FACTORY_DIR || join(homedir(), ".miadi", "factory");
-}
-export function runBriefFile(record) {
-    return `connector-${record.id.replace(/[^\w-]/g, "-")}.md`;
-}
-/** Where a run request's brief is: waiting, delivered by the intake, cancelled, or not queued. */
-export function readQueueState(record, dir = factoryDir()) {
-    const file = runBriefFile(record);
-    const queue = join(dir, "queue");
-    if (existsSync(join(queue, file)))
-        return { state: "queued", file };
-    if (existsSync(join(queue, "delivered", file)))
-        return { state: "delivered", file };
-    if (existsSync(join(queue, "cancelled", file)))
-        return { state: "cancelled", file };
-    if (existsSync(join(queue, "stale", file)))
-        return { state: "stale", file, note: "Its seat did not take it in time; the intake moved it aside." };
-    return { state: record.approval_state === "approved" ? "missing" : "not_queued", file };
-}
 function liveTmux() {
     try {
         return execFileSync("tmux", ["list-sessions", "-F", "#{session_name}"], { encoding: "utf8", timeout: 3000, stdio: ["ignore", "pipe", "ignore"] })
@@ -94,7 +68,15 @@ export function runBrief(record, approver, sessions, instructions) {
     const short = record.id.split(":")[1]?.slice(0, 8) ?? "run";
     const to = body.session && sessions.includes(body.session) ? body.session : `new:${body.session ?? `connector-${yymmdd()}-${short}`}`;
     const cwd = body.cwd || "/a/src/Miadi-18";
-    const open = [`to="${attr(to)}"`, 'status="send"', 'type="connector-run"', `record="${attr(record.id)}"`, ...(to.startsWith("new:") ? [`cwd="${attr(cwd)}"`] : [])];
+    const open = [
+        `to="${attr(to)}"`,
+        'status="send"',
+        'type="connector-run"',
+        `record="${attr(record.id)}"`,
+        // The provider the connector verified at request time (jgwill/Miadi#893); the intake may honour it or record why not.
+        ...(body.resolved_provider ? [`provider="${attr(body.resolved_provider)}"`] : []),
+        ...(to.startsWith("new:") ? [`cwd="${attr(cwd)}"`] : []),
+    ];
     const lines = [
         `<input ${open.join(" ")}>`,
         `A bounded task requested through the Miadi connector (jgwill/Miadi#815, #816).`,
@@ -229,6 +211,23 @@ export async function executeApproved(record, approver, deps, instructions) {
                 ending: b.ending,
                 note: "Recorded only. The witness seat writes it into the inventory record and closes the session by its own lifecycle.",
             };
+        case "session_steer_request": {
+            // The person's approval of this exact steer is its authorization; the
+            // grant record it cites still binds the session (jgwill/Miadi#893).
+            const grantId = record.refs.find((r) => r.startsWith("run_request:") || r.startsWith("work_proposal:"));
+            const grantRecord = grantId ? current(deps.ledger.all()).find((x) => x.id === grantId) : undefined;
+            if (!grantRecord)
+                return { outcome: "failed", message: "The run whose grant this steer cites is gone." };
+            const result = await steerSession({ tmux: deps.tmux ?? tmuxAdapter(), stateDir: deps.config.stateDir, ...(deps.steerSettleMs !== undefined ? { settleMs: deps.steerSettleMs } : {}) }, { record, grantRecord, priorAttempts: steerAttempts(current(deps.ledger.all()), grantRecord.id), authorized: true });
+            const delivered = result.status === "accepted" || result.status === "submitted";
+            return {
+                outcome: delivered ? result.status : "failed",
+                steer_status: result.status,
+                message: result.message,
+                ...(result.target ? { target: result.target } : {}),
+                ...(result.artifact ? { artifact: result.artifact } : {}),
+            };
+        }
         default:
             return { outcome: "nothing_to_run" };
     }
@@ -281,6 +280,10 @@ ${r.refs.length ? `<dt>References</dt><dd>${r.refs.map(escapeHtml).join("<br>")}
 export class AlreadyDecided extends Error {
 }
 const deciding = new Set();
+/** Whether a decision on this request is being recorded now, its run may still be going. */
+export function isBeingDecided(recordId) {
+    return deciding.has(recordId);
+}
 export async function decide(r, person, choice, deps, opts) {
     // Checked again here, with no await between the check and the claim: the
     // page and the card (or two cards) may decide the same request at once.
@@ -421,6 +424,8 @@ export function consequenceOf(r) {
             return b.new_episode ? "Approving mints a new episode with the inquiry woven in." : `Approving weaves the inquiry into episode ${b.episode ?? "?"}.`;
         case "session_completion_proposal":
             return `Approving records the ending (${b.ending ?? "?"}) for the session. No pane is closed.`;
+        case "session_steer_request":
+            return `Approving types exactly this instruction into the bound agent session (${b.session ?? "the run's session"}), once, and records whether the agent accepted it.`;
         default:
             return "Approving runs the request once, as you.";
     }
@@ -459,9 +464,9 @@ export function registerApprovalRoutes(app, deps) {
             return void res.status(403).type("html").send(signInToRead(r, `Reading and deciding this request needs Miadi's write tier; ${person.name} has ${person.api_tier ?? "no API tier"}.`));
         }
         if (!body.decision)
-            return void res.type("html").send(approvePage(r, { token: writer ? token : undefined }));
+            return void res.type("html").send(approvePage(deps, r, { token: writer ? token : undefined }));
         if (!writer)
-            return void res.status(403).type("html").send(approvePage(r, { error: `Deciding needs Miadi's write tier; ${person.name} has ${person.api_tier ?? "no API tier"}.` }));
+            return void res.status(403).type("html").send(approvePage(deps, r, { error: `Deciding needs Miadi's write tier; ${person.name} has ${person.api_tier ?? "no API tier"}.` }));
         if (body.decision === "rerun") {
             let ran;
             try {
@@ -469,14 +474,14 @@ export function registerApprovalRoutes(app, deps) {
             }
             catch (error) {
                 if (error instanceof AlreadyDecided)
-                    return void res.status(409).type("html").send(approvePage(find(r.id), { token, error: error.message }));
+                    return void res.status(409).type("html").send(approvePage(deps, find(r.id), { token, error: error.message }));
                 throw error;
             }
             const failedAgain = ran.receipt.outcome === "failed";
             return void res.type("html").send(page("Recorded", `<h1>${failedAgain ? "Run again, and it failed again" : "Run again"}</h1>${summary(find(r.id))}<pre>${escapeHtml(JSON.stringify(ran.receipt, null, 2))}</pre>`));
         }
         if (r.approval_state !== "awaiting_approval") {
-            return void res.status(409).type("html").send(approvePage(r, { error: `This request is already ${r.approval_state}.` }));
+            return void res.status(409).type("html").send(approvePage(deps, r, { error: `This request is already ${r.approval_state}.` }));
         }
         const choice = DECISIONS.includes(String(body.decision)) ? body.decision : "decline";
         const instructions = String(body.instructions ?? "").trim().slice(0, 20000) || undefined;
@@ -484,7 +489,7 @@ export function registerApprovalRoutes(app, deps) {
             return void res
                 .status(400)
                 .type("html")
-                .send(approvePage(r, { token, error: choice === "request_revision" ? "Say what to revise." : "Write the changes to apply." }));
+                .send(approvePage(deps, r, { token, error: choice === "request_revision" ? "Say what to revise." : "Write the changes to apply." }));
         }
         let decided;
         try {
@@ -492,13 +497,21 @@ export function registerApprovalRoutes(app, deps) {
         }
         catch (error) {
             if (error instanceof AlreadyDecided)
-                return void res.status(409).type("html").send(approvePage(find(r.id), { error: error.message }));
+                return void res.status(409).type("html").send(approvePage(deps, find(r.id), { error: error.message }));
             throw error;
         }
         const { decision, receipt } = decided;
-        const failed = receipt.outcome === "failed";
-        const heading = decision === "approved" ? (failed ? "Approved, but running it failed" : "Approved") : decision === "revision_requested" ? "Sent back for revision" : "Declined";
-        res.type("html").send(page("Recorded", `<h1>${heading}</h1>${summary(find(r.id))}<pre>${escapeHtml(JSON.stringify(receipt, null, 2))}</pre>`));
+        const p = projectionOf(find(r.id), deps);
+        const heading = decision === "approved"
+            ? p?.stage === "failed"
+                ? "Approved, but running it failed"
+                : p?.outstanding.length
+                    ? "Approved, changes still to do"
+                    : "Approved"
+            : decision === "revision_requested"
+                ? "Sent back for revision"
+                : "Declined";
+        res.type("html").send(page("Recorded", `<h1>${heading}</h1>${summary(find(r.id))}${projectionBlock(p, receipt)}`));
     });
     // A record's own page, for citations in ChatGPT: its author and anyone with Miadi's read tier may read it.
     app.get("/records/:id", (req, res) => {
@@ -532,9 +545,12 @@ ${error ? `<p class="err" role="alert">${escapeHtml(error)}</p>` : ""}
 <div class="row"><button class="primary" type="submit">Read</button></div></form>`;
 }
 function signInToRead(r, error) {
-    return page("A Miadi request awaits a decision", `<h1>A request awaits a decision</h1>
-<p>${escapeHtml(KIND_LABELS[r.kind] ?? r.kind)}, asked ${escapeHtml(r.created_at.slice(0, 16).replace("T", " "))} UTC. State: ${escapeHtml(r.approval_state ?? "—")}.</p>
-<p>Sign in to read it. A person with Miadi's write tier then decides; whoever asked can read it.</p>
+    // The label names no one and no instruction: this page is shown before sign-in.
+    const open = r.approval_state === "awaiting_approval";
+    const label = projectRequest(r, { recording: isBeingDecided(r.id) })?.label ?? r.approval_state ?? "";
+    return page(open ? "A Miadi request awaits a decision" : "A Miadi request was decided", `<h1>${open ? "A request awaits a decision" : "A request was decided"}</h1>
+<p>${escapeHtml(KIND_LABELS[r.kind] ?? r.kind)}, asked ${escapeHtml(r.created_at.slice(0, 16).replace("T", " "))} UTC. ${escapeHtml(label)}.</p>
+<p>${open ? "Sign in to read it. A person with Miadi's write tier then decides; whoever asked can read it." : "Sign in to read what was decided and what came of it. Whoever asked, and anyone with Miadi's write tier, can read it."}</p>
 ${error ? `<p class="err" role="alert">${escapeHtml(error)}</p>` : ""}
 <form method="post">
 <label for="t">Your Miadi person token</label>
@@ -543,13 +559,41 @@ ${error ? `<p class="err" role="alert">${escapeHtml(error)}</p>` : ""}
 </form>`);
 }
 /** The request, and the decision form for a write-tier person (their token carried in the form they just signed into). */
-function approvePage(r, o = {}) {
-    return page("Approve a Miadi request", `<h1>Approve a request</h1>
-<p>${escapeHtml(consequenceOf(r))} Declining records your refusal. Either is kept in the ledger with your name.</p>
+/**
+ * Where a request stands, as every surface of the connector reads it (request-state.ts):
+ * the factory queue is read for the two kinds that dispatch a brief.
+ */
+export function requestProjection(record, opts = {}) {
+    const queue = record.kind === "run_request" || record.kind === "work_proposal" ? readQueueState(record, opts.factoryDir ?? factoryDir()) : undefined;
+    return projectRequest(record, {
+        ...(opts.reviewBase ? { reviewBase: opts.reviewBase } : {}),
+        ...(queue ? { queue } : {}),
+        recording: isBeingDecided(record.id),
+    });
+}
+function projectionOf(r, deps) {
+    return requestProjection(r, { reviewBase: deps.config.reviewUrl, factoryDir: deps.factoryDir });
+}
+/** Where a request stands, as a page shows it: the label, each line, the review it produced, and the receipt for audit. */
+function projectionBlock(p, receipt) {
+    if (!p)
+        return "";
+    const lines = p.lines.map((l) => `<li>${escapeHtml(l)}</li>`).join("");
+    const review = p.receipt_url ? `<p><a href="${escapeHtml(p.receipt_url)}" rel="noopener">${escapeHtml(p.receipt_url)}</a></p>` : "";
+    const audit = receipt ? `<details><summary>Receipt</summary><pre>${escapeHtml(JSON.stringify(receipt, null, 2))}</pre></details>` : "";
+    return `<section aria-label="Where it stands"><p><strong>${escapeHtml(p.label)}</strong></p>${lines ? `<ul>${lines}</ul>` : ""}${review}${audit}</section>`;
+}
+/** The request, and the decision form for a write-tier person (their token carried in the form they just signed into). */
+function approvePage(deps, r, o = {}) {
+    const open = r.approval_state === "awaiting_approval";
+    // A decision being recorded offers no buttons: a second click would decide the same request again.
+    const actionable = open && !isBeingDecided(r.id);
+    return page("Approve a Miadi request", `<h1>${open ? "Approve a request" : "A decided request"}</h1>
+${actionable ? `<p>${escapeHtml(consequenceOf(r))} Declining records your refusal. Either is kept in the ledger with your name.</p>` : ""}
 ${summary(r)}
-${r.completion_receipt ? `<pre>${escapeHtml(JSON.stringify(r.completion_receipt, null, 2))}</pre>` : ""}
+${projectionBlock(projectionOf(r, deps), open ? undefined : r.completion_receipt)}
 ${o.error ? `<p class="err" role="alert">${escapeHtml(o.error)}</p>` : ""}
-${r.approval_state === "awaiting_approval" && o.token
+${actionable && o.token
         ? `<form method="post">
 <input type="hidden" name="person_token" value="${escapeHtml(o.token)}">
 <label for="i">Instructions (needed to approve with changes or to send back)</label>
@@ -560,7 +604,7 @@ ${r.approval_state === "awaiting_approval" && o.token
 <button type="submit" name="decision" value="request_revision">Send back for revision</button>
 <button type="submit" name="decision" value="decline">Decline</button>
 </div></form>`
-        : r.approval_state === "awaiting_approval"
+        : actionable
             ? "<p>A person with Miadi's write tier decides this request.</p>"
             : isRerunnable(r) && o.token
                 ? `<p>It was approved, and running it failed. When what it calls has been fixed, it can be run again with the same approval and instructions; the ledger records who ran it again.</p>
@@ -578,4 +622,5 @@ export const KIND_LABELS = {
     review_episode_link_request: "Review into an episode",
     inquiry_episode_request: "Inquiry into an episode",
     session_completion_proposal: "Session ending",
+    session_steer_request: "Session steer",
 };

package/dist/decisions.d.ts

@@ -15,4 +15,4 @@ export declare class DecisionTokens {
  * and calls `decide_request` through the host. In a host without that bridge it
  * shows each request's approval page instead.
  */
-export declare const DECISIONS_CARD_HTML = "<!doctype html>\n<html lang=\"en\"><head><meta charset=\"utf-8\"><meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">\n<style>\n:root{color-scheme:light dark;--fg:#1d1b18;--muted:#5b5650;--line:#d9d4cc;--accent:#7a4a00;--ok:#1d6b3a;--err:#b00020;--chip:#f1ede6}\n@media (prefers-color-scheme:dark){:root{--fg:#ece8e1;--muted:#b3ada4;--line:#3a3631;--accent:#ffd700;--ok:#7fd49b;--err:#ff8a80;--chip:#24211d}}\n*{box-sizing:border-box}\nbody{margin:0;color:var(--fg);font:15px/1.45 system-ui,sans-serif;background:transparent}\nmain{padding:12px;display:grid;gap:12px}\n.empty,.note{color:var(--muted)}\narticle{border:1px solid var(--line);border-radius:10px;padding:12px}\nh2{font-size:15px;margin:0 0 4px}\n.kind{display:inline-block;font-size:12px;padding:1px 8px;border-radius:999px;background:var(--chip);color:var(--muted);margin-bottom:6px}\n.meta{font-size:13px;color:var(--muted);margin:0 0 6px}\n.does{margin:6px 0;font-weight:600}\ndetails{margin:6px 0}\nsummary{cursor:pointer;color:var(--muted);font-size:13px}\npre{white-space:pre-wrap;overflow-wrap:anywhere;font-size:12px;margin:6px 0 0;max-height:240px;overflow:auto}\ntextarea{width:100%;min-height:64px;padding:8px;border:1px solid var(--line);border-radius:8px;background:transparent;color:var(--fg);font:inherit;margin-top:8px}\n.row{display:flex;flex-wrap:wrap;gap:8px;margin-top:8px}\nbutton{padding:8px 12px;border-radius:8px;border:1px solid var(--line);background:transparent;color:var(--fg);font:inherit;cursor:pointer;min-height:40px}\nbutton.primary{border-color:var(--accent);outline:1px solid var(--accent)}\nbutton:focus-visible,a:focus-visible,textarea:focus-visible{outline:2px solid var(--accent);outline-offset:2px}\nbutton[disabled]{opacity:.55;cursor:default}\na{color:inherit}\n.done{color:var(--ok);font-weight:600}\n.fail{color:var(--err);font-weight:600}\n</style></head><body><main id=\"root\" aria-live=\"polite\"><p class=\"note\">Loading requests\u2026</p></main>\n<script>\n(function(){\n  var root=document.getElementById(\"root\");\n  var decided={};\n  // A redraw while a decision is being recorded must not offer the buttons again.\n  var pending={};\n  var errors={};\n  function el(tag,attrs,text){var e=document.createElement(tag);if(attrs)for(var k in attrs){if(k===\"class\")e.className=attrs[k];else e.setAttribute(k,attrs[k]);}if(text!=null)e.textContent=text;return e;}\n  function host(){return window.openai||null;}\n  function data(){var h=host();return h&&h.toolOutput?h.toolOutput:null;}\n  function tokens(){var h=host();var m=h&&h.toolResponseMetadata;return (m&&m[\"miadi/decisionTokens\"])||{};}\n  function render(){\n    var d=data();root.textContent=\"\";\n    if(!d){root.appendChild(el(\"p\",{class:\"note\"},\"Waiting for the request list.\"));return;}\n    var list=d.decisions||[];\n    if(!list.length){root.appendChild(el(\"p\",{class:\"empty\"},d.message||\"No request is waiting for a decision.\"));return;}\n    if(!d.can_decide_here&&d.reason){root.appendChild(el(\"p\",{class:\"note\"},d.reason));}\n    var t=tokens();\n    list.forEach(function(r){root.appendChild(card(r,t[r.id]));});\n  }\n  function card(r,token){\n    var a=el(\"article\",{\"aria-label\":r.title});\n    a.appendChild(el(\"span\",{class:\"kind\"},r.kind_label||r.kind));\n    a.appendChild(el(\"h2\",null,r.title));\n    a.appendChild(el(\"p\",{class:\"meta\"},\"Asked by \"+r.by+(r.via?\" through \"+r.via:\"\")+\" \u00B7 \"+new Date(r.created_at).toLocaleString()+(r.circle?\" \u00B7 \"+r.circle+\" circle\":\"\")));\n    a.appendChild(el(\"p\",{class:\"does\"},r.consequence));\n    if(r.intention)a.appendChild(el(\"p\",null,r.intention));\n    var det=el(\"details\");det.appendChild(el(\"summary\",null,\"What exactly is asked\"));det.appendChild(el(\"pre\",null,r.detail||\"\"));a.appendChild(det);\n    var status=el(\"p\",{role:\"status\"});\n    if(decided[r.id]){status.className=decided[r.id].ok?\"done\":\"fail\";status.textContent=decided[r.id].text;a.appendChild(status);return a;}\n    if(pending[r.id]){status.className=\"note\";status.textContent=\"Recording your decision\u2026\";a.appendChild(status);return a;}\n    if(!token||!host()||!host().callTool){\n      var p=el(\"p\",{class:\"note\"});p.appendChild(document.createTextNode(\"Decide on its approval page: \"));\n      var link=el(\"a\",{href:r.approval_url,target:\"_blank\",rel:\"noopener\"},\"open the approval page\");p.appendChild(link);a.appendChild(p);return a;\n    }\n    var ta=el(\"textarea\",{\"aria-label\":\"Instructions or changes (needed to approve with changes or send back)\",placeholder:\"Instructions or changes (needed to approve with changes or send back)\"});\n    a.appendChild(ta);\n    var row=el(\"div\",{class:\"row\"});\n    var buttons=[[\"approve\",\"Approve\",\"primary\"],[\"approve_with_changes\",\"Approve with my changes\",\"\"],[\"request_revision\",\"Send back for revision\",\"\"],[\"decline\",\"Decline\",\"\"]];\n    var btns=[];\n    buttons.forEach(function(b){var x=el(\"button\",{type:\"button\",class:b[2]},b[1]);x.addEventListener(\"click\",function(){go(b[0]);});btns.push(x);row.appendChild(x);});\n    a.appendChild(row);a.appendChild(status);\n    if(errors[r.id]){status.className=\"fail\";status.textContent=errors[r.id];}\n    function go(choice){\n      var text=ta.value.trim();\n      if((choice===\"approve_with_changes\"||choice===\"request_revision\")&&!text){status.className=\"fail\";status.textContent=choice===\"request_revision\"?\"Say what to revise.\":\"Write the changes to apply.\";ta.focus();return;}\n      btns.forEach(function(x){x.disabled=true;});status.className=\"note\";status.textContent=\"Recording your decision\u2026\";pending[r.id]=true;delete errors[r.id];\n      host().callTool(\"decide_request\",{record_id:r.id,decision:choice,instructions:text||undefined,decision_token:token}).then(function(res){\n        var out=(res&&(res.structuredContent||res.structured_content))||null;\n        if(!out&&res&&res.content&&res.content[0]&&res.content[0].text){try{out=JSON.parse(res.content[0].text);}catch(e){out={message:res.content[0].text};}}\n        var ok=out&&!out.error;\n        delete pending[r.id];decided[r.id]={ok:ok,text:ok?(out.summary||\"Recorded.\"):((out&&out.message)||\"Not recorded.\")};render();\n      },function(err){delete pending[r.id];errors[r.id]=\"Not recorded: \"+(err&&err.message?err.message:String(err));render();});\n    }\n    return a;\n  }\n  window.addEventListener(\"openai:set_globals\",render);\n  render();\n})();\n</script></body></html>";
+export declare const DECISIONS_CARD_HTML = "<!doctype html>\n<html lang=\"en\"><head><meta charset=\"utf-8\"><meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">\n<style>\n:root{color-scheme:light dark;--fg:#1d1b18;--muted:#5b5650;--line:#d9d4cc;--accent:#7a4a00;--ok:#1d6b3a;--err:#b00020;--chip:#f1ede6}\n@media (prefers-color-scheme:dark){:root{--fg:#ece8e1;--muted:#b3ada4;--line:#3a3631;--accent:#ffd700;--ok:#7fd49b;--err:#ff8a80;--chip:#24211d}}\n*{box-sizing:border-box}\nbody{margin:0;color:var(--fg);font:15px/1.45 system-ui,sans-serif;background:transparent}\nmain{padding:12px;display:grid;gap:12px}\n.empty,.note{color:var(--muted)}\narticle{border:1px solid var(--line);border-radius:10px;padding:12px}\nh2{font-size:15px;margin:0 0 4px}\n.kind{display:inline-block;font-size:12px;padding:1px 8px;border-radius:999px;background:var(--chip);color:var(--muted);margin-bottom:6px}\n.meta{font-size:13px;color:var(--muted);margin:0 0 6px}\n.does{margin:6px 0;font-weight:600}\ndetails{margin:6px 0}\nsummary{cursor:pointer;color:var(--muted);font-size:13px}\npre{white-space:pre-wrap;overflow-wrap:anywhere;font-size:12px;margin:6px 0 0;max-height:240px;overflow:auto}\ntextarea{width:100%;min-height:64px;padding:8px;border:1px solid var(--line);border-radius:8px;background:transparent;color:var(--fg);font:inherit;margin-top:8px}\n.row{display:flex;flex-wrap:wrap;gap:8px;margin-top:8px}\nbutton{padding:8px 12px;border-radius:8px;border:1px solid var(--line);background:transparent;color:var(--fg);font:inherit;cursor:pointer;min-height:40px}\nbutton.primary{border-color:var(--accent);outline:1px solid var(--accent)}\nbutton:focus-visible,a:focus-visible,textarea:focus-visible{outline:2px solid var(--accent);outline-offset:2px}\nbutton[disabled]{opacity:.55;cursor:default}\na{color:inherit}\n.done{color:var(--ok);font-weight:600}\n.fail{color:var(--err);font-weight:600}\n</style></head><body><main id=\"root\" aria-live=\"polite\"><p class=\"note\">Loading requests\u2026</p></main>\n<script>\n(function(){\n  var root=document.getElementById(\"root\");\n  var decided={};\n  // A redraw while a decision is being recorded must not offer the buttons again.\n  var pending={};\n  var errors={};\n  function el(tag,attrs,text){var e=document.createElement(tag);if(attrs)for(var k in attrs){if(k===\"class\")e.className=attrs[k];else e.setAttribute(k,attrs[k]);}if(text!=null)e.textContent=text;return e;}\n  function host(){return window.openai||null;}\n  function data(){var h=host();return h&&h.toolOutput?h.toolOutput:null;}\n  function tokens(){var h=host();var m=h&&h.toolResponseMetadata;return (m&&m[\"miadi/decisionTokens\"])||{};}\n  function render(){\n    var d=data();root.textContent=\"\";\n    if(!d){root.appendChild(el(\"p\",{class:\"note\"},\"Waiting for the request list.\"));return;}\n    var list=d.decisions||[];\n    if(!list.length){root.appendChild(el(\"p\",{class:\"empty\"},d.message||\"No request is waiting for a decision.\"));return;}\n    if(!d.can_decide_here&&d.reason){root.appendChild(el(\"p\",{class:\"note\"},d.reason));}\n    var t=tokens();\n    list.forEach(function(r){root.appendChild(card(r,t[r.id]));});\n  }\n  // Where a request stands, as the connector projected it: the label, its lines, and the review it produced.\n  function decidedBlock(d){\n    var box=el(\"div\",{role:\"status\",class:d.cls});\n    if(d.note)box.appendChild(el(\"p\",{class:\"line\"},d.note));\n    box.appendChild(el(\"p\",{class:\"label\"},d.label));\n    (d.lines||[]).forEach(function(l){box.appendChild(el(\"p\",{class:\"line\"},l));});\n    if(d.url){var p=el(\"p\",{class:\"line\"});p.appendChild(el(\"a\",{href:d.url,target:\"_blank\",rel:\"noopener\"},d.url));box.appendChild(p);}\n    return box;\n  }\n  function toolResult(res){\n    var out=(res&&(res.structuredContent||res.structured_content))||null;\n    if(!out&&res&&res.content&&res.content[0]&&res.content[0].text){try{out=JSON.parse(res.content[0].text);}catch(e){out={message:res.content[0].text};}}\n    return out;\n  }\n  function projectionView(p,note){return {cls:p.stage===\"failed\"?\"fail\":\"done\",stage:p.stage,label:p.label,lines:p.lines||[],url:p.receipt_url||null,note:note||null};}\n  function card(r,token){\n    var a=el(\"article\",{\"aria-label\":r.title});\n    a.appendChild(el(\"span\",{class:\"kind\"},r.kind_label||r.kind));\n    a.appendChild(el(\"h2\",null,r.title));\n    a.appendChild(el(\"p\",{class:\"meta\"},\"Asked by \"+r.by+(r.via?\" through \"+r.via:\"\")+\" \u00B7 \"+new Date(r.created_at).toLocaleString()+(r.circle?\" \u00B7 \"+r.circle+\" circle\":\"\")));\n    a.appendChild(el(\"p\",{class:\"does\"},r.consequence));\n    if(r.intention)a.appendChild(el(\"p\",null,r.intention));\n    var det=el(\"details\");det.appendChild(el(\"summary\",null,\"What exactly is asked\"));det.appendChild(el(\"pre\",null,r.detail||\"\"));a.appendChild(det);\n    var status=el(\"p\",{role:\"status\"});\n    if(r.projection&&r.projection.stage!==\"awaiting_decision\"&&(!decided[r.id]||[\"recording\",\"dispatching\"].indexOf(r.projection.stage)===-1)){decided[r.id]=projectionView(r.projection);}\n    if(decided[r.id]){\n      var shown=decided[r.id];a.appendChild(decidedBlock(shown));\n      if([\"recording\",\"dispatching\"].indexOf(shown.stage)!==-1&&host()&&host().callTool){\n        var refresh=el(\"button\",{type:\"button\"},\"Refresh status\");\n        refresh.addEventListener(\"click\",function(){\n          refresh.disabled=true;\n          host().callTool(\"get_run_result\",{record_id:r.id}).then(function(res){\n            var out=toolResult(res);var p=out&&(out.projection||(out.data&&out.data.projection));\n            if(p){decided[r.id]=projectionView(p);delete errors[r.id];}\n            else{errors[r.id]=(out&&out.message)||\"Status could not be refreshed.\";}\n            render();\n          },function(err){errors[r.id]=\"Status could not be refreshed: \"+String(err&&err.message||err);render();});\n        });\n        a.appendChild(refresh);\n      }\n      if(errors[r.id])a.appendChild(el(\"p\",{class:\"fail\",role:\"status\"},errors[r.id]));\n      return a;\n    }\n    if(pending[r.id]){status.className=\"note\";status.textContent=\"Recording your decision\u2026\";a.appendChild(status);return a;}\n    if(!token||!host()||!host().callTool){\n      var p=el(\"p\",{class:\"note\"});p.appendChild(document.createTextNode(\"Decide on its approval page: \"));\n      var link=el(\"a\",{href:r.approval_url,target:\"_blank\",rel:\"noopener\"},\"open the approval page\");p.appendChild(link);a.appendChild(p);return a;\n    }\n    var ta=el(\"textarea\",{\"aria-label\":\"Instructions or changes (needed to approve with changes or send back)\",placeholder:\"Instructions or changes (needed to approve with changes or send back)\"});\n    a.appendChild(ta);\n    var row=el(\"div\",{class:\"row\"});\n    var buttons=[[\"approve\",\"Approve\",\"primary\"],[\"approve_with_changes\",\"Approve with my changes\",\"\"],[\"request_revision\",\"Send back for revision\",\"\"],[\"decline\",\"Decline\",\"\"]];\n    var btns=[];\n    buttons.forEach(function(b){var x=el(\"button\",{type:\"button\",class:b[2]},b[1]);x.addEventListener(\"click\",function(){go(b[0]);});btns.push(x);row.appendChild(x);});\n    a.appendChild(row);a.appendChild(status);\n    if(errors[r.id]){status.className=\"fail\";status.textContent=errors[r.id];}\n    function go(choice){\n      var text=ta.value.trim();\n      if((choice===\"approve_with_changes\"||choice===\"request_revision\")&&!text){status.className=\"fail\";status.textContent=choice===\"request_revision\"?\"Say what to revise.\":\"Write the changes to apply.\";ta.focus();return;}\n      btns.forEach(function(x){x.disabled=true;});status.className=\"note\";status.textContent=\"Recording your decision\u2026\";pending[r.id]=true;delete errors[r.id];\n      host().callTool(\"decide_request\",{record_id:r.id,decision:choice,instructions:text||undefined,decision_token:token}).then(function(res){\n        var out=toolResult(res);\n        // The connector answers with the request's projection, also when a click finds it decided already.\n        var proj=out&&out.projection;\n        var already=!!(out&&out.error===\"already_decided\");\n        var ok=out&&!out.error;\n        delete pending[r.id];\n        if(proj){decided[r.id]=projectionView(proj,already?\"This request was already decided. Here is where it stands.\":null);}\n        else{decided[r.id]={cls:ok?\"done\":\"fail\",label:ok?(out.summary||\"Recorded.\"):((out&&out.message)||\"Not recorded.\"),lines:[],url:null,note:null};}\n        render();\n      },function(err){delete pending[r.id];errors[r.id]=\"Not recorded: \"+(err&&err.message?err.message:String(err));render();});\n    }\n    return a;\n  }\n  window.addEventListener(\"openai:set_globals\",render);\n  render();\n})();\n</script></body></html>";

package/dist/decisions.js

@@ -102,6 +102,21 @@ a{color:inherit}
     var t=tokens();
     list.forEach(function(r){root.appendChild(card(r,t[r.id]));});
   }
+  // Where a request stands, as the connector projected it: the label, its lines, and the review it produced.
+  function decidedBlock(d){
+    var box=el("div",{role:"status",class:d.cls});
+    if(d.note)box.appendChild(el("p",{class:"line"},d.note));
+    box.appendChild(el("p",{class:"label"},d.label));
+    (d.lines||[]).forEach(function(l){box.appendChild(el("p",{class:"line"},l));});
+    if(d.url){var p=el("p",{class:"line"});p.appendChild(el("a",{href:d.url,target:"_blank",rel:"noopener"},d.url));box.appendChild(p);}
+    return box;
+  }
+  function toolResult(res){
+    var out=(res&&(res.structuredContent||res.structured_content))||null;
+    if(!out&&res&&res.content&&res.content[0]&&res.content[0].text){try{out=JSON.parse(res.content[0].text);}catch(e){out={message:res.content[0].text};}}
+    return out;
+  }
+  function projectionView(p,note){return {cls:p.stage==="failed"?"fail":"done",stage:p.stage,label:p.label,lines:p.lines||[],url:p.receipt_url||null,note:note||null};}
   function card(r,token){
     var a=el("article",{"aria-label":r.title});
     a.appendChild(el("span",{class:"kind"},r.kind_label||r.kind));
@@ -111,7 +126,25 @@ a{color:inherit}
     if(r.intention)a.appendChild(el("p",null,r.intention));
     var det=el("details");det.appendChild(el("summary",null,"What exactly is asked"));det.appendChild(el("pre",null,r.detail||""));a.appendChild(det);
     var status=el("p",{role:"status"});
-    if(decided[r.id]){status.className=decided[r.id].ok?"done":"fail";status.textContent=decided[r.id].text;a.appendChild(status);return a;}
+    if(r.projection&&r.projection.stage!=="awaiting_decision"&&(!decided[r.id]||["recording","dispatching"].indexOf(r.projection.stage)===-1)){decided[r.id]=projectionView(r.projection);}
+    if(decided[r.id]){
+      var shown=decided[r.id];a.appendChild(decidedBlock(shown));
+      if(["recording","dispatching"].indexOf(shown.stage)!==-1&&host()&&host().callTool){
+        var refresh=el("button",{type:"button"},"Refresh status");
+        refresh.addEventListener("click",function(){
+          refresh.disabled=true;
+          host().callTool("get_run_result",{record_id:r.id}).then(function(res){
+            var out=toolResult(res);var p=out&&(out.projection||(out.data&&out.data.projection));
+            if(p){decided[r.id]=projectionView(p);delete errors[r.id];}
+            else{errors[r.id]=(out&&out.message)||"Status could not be refreshed.";}
+            render();
+          },function(err){errors[r.id]="Status could not be refreshed: "+String(err&&err.message||err);render();});
+        });
+        a.appendChild(refresh);
+      }
+      if(errors[r.id])a.appendChild(el("p",{class:"fail",role:"status"},errors[r.id]));
+      return a;
+    }
     if(pending[r.id]){status.className="note";status.textContent="Recording your decision…";a.appendChild(status);return a;}
     if(!token||!host()||!host().callTool){
       var p=el("p",{class:"note"});p.appendChild(document.createTextNode("Decide on its approval page: "));
@@ -130,10 +163,15 @@ a{color:inherit}
       if((choice==="approve_with_changes"||choice==="request_revision")&&!text){status.className="fail";status.textContent=choice==="request_revision"?"Say what to revise.":"Write the changes to apply.";ta.focus();return;}
       btns.forEach(function(x){x.disabled=true;});status.className="note";status.textContent="Recording your decision…";pending[r.id]=true;delete errors[r.id];
       host().callTool("decide_request",{record_id:r.id,decision:choice,instructions:text||undefined,decision_token:token}).then(function(res){
-        var out=(res&&(res.structuredContent||res.structured_content))||null;
-        if(!out&&res&&res.content&&res.content[0]&&res.content[0].text){try{out=JSON.parse(res.content[0].text);}catch(e){out={message:res.content[0].text};}}
+        var out=toolResult(res);
+        // The connector answers with the request's projection, also when a click finds it decided already.
+        var proj=out&&out.projection;
+        var already=!!(out&&out.error==="already_decided");
         var ok=out&&!out.error;
-        delete pending[r.id];decided[r.id]={ok:ok,text:ok?(out.summary||"Recorded."):((out&&out.message)||"Not recorded.")};render();
+        delete pending[r.id];
+        if(proj){decided[r.id]=projectionView(proj,already?"This request was already decided. Here is where it stands.":null);}
+        else{decided[r.id]={cls:ok?"done":"fail",label:ok?(out.summary||"Recorded."):((out&&out.message)||"Not recorded."),lines:[],url:null,note:null};}
+        render();
       },function(err){delete pending[r.id];errors[r.id]="Not recorded: "+(err&&err.message?err.message:String(err));render();});
     }
     return a;

package/dist/index.d.ts

@@ -5,4 +5,7 @@ export { MiadiOAuthProvider, SCOPES, SCOPE_READ, SCOPE_CONTRIBUTE, type Person }
 export { CIRCLES, CIRCLE_IDS, CLAIM_CATEGORIES, DOMAINS, HANDOFF_STATES, RECORD_KINDS, current, type ConnectorRecord, type CircleId, type ClaimCategory, type RecordKind, } from "./records.js";
 export { TOOL_STATUS } from "./tools.js";
 export { runBrief, readQueueState } from "./approve.js";
+export { PROVIDERS, discoverProviders, resolveProvider, routerPreflight, type ProviderAvailability, type ProviderId, type ProviderResolution, type RouterPreflight, } from "./providers.js";
+export { missionStatus, resolveMissionSubject, type MissionStatus, type MissionStatusDeps } from "./mission-status.js";
+export { AGENT_COMMANDS, BUSY_PATTERNS, STEER_STATUSES, checkGrant, isBusy, readSteerArtifact, steerAttempts, steerSession, steeringGrantOf, tmuxAdapter, type SteerDeps, type SteerResult, type SteerStatus, type SteeringGrant, type TmuxLike, } from "./steer.js";
 export { VERSION } from "./version.js";

package/dist/index.js

@@ -5,4 +5,7 @@ export { MiadiOAuthProvider, SCOPES, SCOPE_READ, SCOPE_CONTRIBUTE } from "./oaut
 export { CIRCLES, CIRCLE_IDS, CLAIM_CATEGORIES, DOMAINS, HANDOFF_STATES, RECORD_KINDS, current, } from "./records.js";
 export { TOOL_STATUS } from "./tools.js";
 export { runBrief, readQueueState } from "./approve.js";
+export { PROVIDERS, discoverProviders, resolveProvider, routerPreflight, } from "./providers.js";
+export { missionStatus, resolveMissionSubject } from "./mission-status.js";
+export { AGENT_COMMANDS, BUSY_PATTERNS, STEER_STATUSES, checkGrant, isBusy, readSteerArtifact, steerAttempts, steerSession, steeringGrantOf, tmuxAdapter, } from "./steer.js";
 export { VERSION } from "./version.js";

package/dist/mission-status.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Read-only mission status (jgwill/Miadi#893, Phase 1A): where one mission
+ * stands, joined from the connector ledger, the factory queue, tmux, Miadi's
+ * session view and GitHub — with every stage named by its evidence, so an idle
+ * pane or a merge is never read as completion.
+ *
+ * The caller (tools.ts) decides the viewer's tier first: without the write
+ * tier there are no operator details (live panes, session internals); the
+ * record's own standing still answers.
+ */
+import type { ConnectorRecord } from "./records.js";
+import type { RequestProjection } from "./request-state.js";
+export interface MissionSession {
+    /** How this session is bound to the mission: signed_ref (a session: ref on the record), brief_target (the delivered brief's `to`), named (the requested name). */
+    association: "signed_ref" | "brief_target" | "named";
+    session: string;
+    live: "running" | "absent" | "unknown";
+    activity?: "busy" | "idle" | "unknown";
+    /** Present when Miadi's session view was joined (write tier). */
+    miadi?: unknown;
+}
+export interface MissionStageTruth {
+    approved: boolean;
+    queued: boolean;
+    delivered: boolean;
+    /** "evidence" only while a bound session is live; an idle pane proves nothing. */
+    running: "evidence" | "no_evidence";
+    pr_merged: "merged" | "open_or_absent" | "no_pr";
+    released: "evidence" | "no_evidence";
+    closed: boolean;
+}
+export interface MissionStatus {
+    ref: string;
+    found: boolean;
+    via?: string;
+    subject?: {
+        id: string;
+        kind: string;
+        created_at: string;
+        by: string;
+        circle?: string;
+        intention?: string;
+    };
+    standing?: RequestProjection;
+    queue?: {
+        state: string;
+    };
+    sessions?: MissionSession[];
+    issues?: {
+        ref: string;
+        state: string;
+        title?: string;
+        merged?: boolean;
+    }[];
+    steering?: {
+        grant: "none" | "active" | "expired_grant" | "exhausted";
+        attempts_used: number;
+        max_attempts?: number;
+    };
+    stage_truth?: MissionStageTruth;
+    next_authorized_action?: string;
+    notes: string[];
+}
+export interface MissionStatusDeps {
+    queueOf?: (record: ConnectorRecord) => {
+        state: string;
+    } | undefined;
+    projectOf: (record: ConnectorRecord) => RequestProjection | null;
+    /** Live tmux session names, when the host can list them (write tier only). */
+    tmuxSessions?: () => string[];
+    /** Read-only peek: is the named session's first pane mid-turn? (write tier only.) */
+    paneBusy?: (session: string) => "busy" | "idle" | "unknown";
+    /** Miadi's session view by session:<uuid> (write tier only). */
+    sessionOf?: (id: string) => Promise<unknown>;
+    issueOf?: (owner: string, repo: string, n: string) => Promise<{
+        state: string;
+        title?: string;
+        merged?: boolean;
+    }>;
+    now?: () => Date;
+}
+/** The record a mission reference resolves to, and how it was found. */
+export declare function resolveMissionSubject(ref: string, records: ConnectorRecord[]): {
+    record: ConnectorRecord;
+    via: string;
+} | null;
+export declare function missionStatus(ref: string, records: ConnectorRecord[], deps: MissionStatusDeps): Promise<MissionStatus>;