@miadi/connector 0.1.22 → 0.1.24

package/README.md

@@ -128,6 +128,19 @@ In a client that renders MCP Apps (ChatGPT among them), `show_decisions` draws o
 
 A decision is recorded once. An approved run that calls another service (a review operation, Deep Diver, an episode door, a steer) is written to the ledger as approved and running before the call, so a restart can never offer the request for a second approval; a run the connector was recording when it stopped reads as failed and may be run again. A decision whose run takes longer than `MIADI_CONNECTOR_DECISION_WAIT_MS` is answered as recorded and running, and the card reads `get_run_result` every 3 seconds until the outcome is in. The same decision sent again (a host retrying a call, a second click, the page form sent twice) answers with the first one's receipt, marked `replayed`, and runs nothing. A different decision is refused as `decision_conflict`, with where the request stands. When the host gives up on a call, the card reads where the request stands before it offers the buttons again.
 
+**A created review gets its transcript (jgwill/Miadi#925).** An approved `create` calls the review service, then reads the video's original-language YouTube captions with a local `uvx yt-dlp` and stores them on the review as `[mm:ss] text`, so an agent reads them through `fetch` and the factory's kind briefs find them with `miadi_review.py transcript`. No model is called for the transcript. The service answers an empty `POST /api/reviews/:id/transcript` by asking Gemini, so an empty one is never sent. `completion_receipt.transcript` says where it stands, and the card and the approval page say the same:
+
+| outcome | meaning |
+|---|---|
+| `stored` | stored, with its source, word count, sha256 and the range the captions cover |
+| `already_present` | the review already held a transcript, which stays |
+| `waiting_for_captions` | YouTube has no captions yet or refused the read. The connector tries again every 15 minutes for three days, from the ledger, so a restart loses nothing |
+| `held_source_withheld` | the video's `source_intent` is `withheld`, so the captions are neither read nor stored. The transcript lands within 15 minutes of the source being released with `register_source_intent`, because a stored transcript is public at `/review/<id>/json` |
+| `no_captions` | three days passed with no captions |
+| `no_review` | the create left no review. Running the request again retries it |
+
+A transcript supplied with the request is stored instead of the captions. The captions hold what YouTube heard: they may stop before the video does, and they may hold a synthetic voice and not the person's. Their first line says what they are and the range they cover. The host needs `uvx` on the service's `PATH`.
+
 The model that asked cannot decide for the person:
 - `decide_request` is declared for the card only (`_meta.ui.visibility: ["app"]`), so the host does not offer it to the model.
 - It requires a decision token that travels only in the `_meta` of the `show_decisions` result. Hosts deliver that metadata to the card and keep it from the model. The token is bound to one request at the version its card shows, one person and one OAuth client, and expires after 7 days (`MIADI_CONNECTOR_DECISION_TOKEN_TTL`). A decided request no longer awaits a decision, so a token works once. The request itself does not expire: a card whose token expired names the request's approval page, and `show_decisions` gives a fresh card for the same request.

package/dist/approve.d.ts

@@ -19,6 +19,7 @@ import { type RequestProjection } from "./request-state.js";
 import type { DraftReviewService } from "./draft-review.js";
 import type { RuntimeDeps } from "./runtime-steer.js";
 import { type TmuxLike } from "./steer.js";
+import { type FetchCaptions } from "./captions.js";
 import { type ProviderAuthorization } from "./provider-policy.js";
 export { factoryDir, runBriefFile, readQueueState } from "./queue-state.js";
 export interface ApprovalDeps {
@@ -38,6 +39,8 @@ export interface ApprovalDeps {
     steerSettleMs?: number;
     /** Where sessions and their steering inboxes live (jgwill/Miadi#930). Absent, no runtime route is known. */
     steeringRuntime?: RuntimeDeps;
+    /** Reads a video's captions for an approved create; without it a create stores no transcript (tests, other embedders). */
+    captions?: FetchCaptions;
     /** Where decision events go (default: one JSON line on stdout, the service journal); tests collect them. */
     log?: (event: Record<string, unknown>) => void;
 }
@@ -66,12 +69,15 @@ export declare function runBrief(record: ConnectorRecord, approver: MiadiPerson,
     aspect: string;
     name: string;
     ask: string;
+    settled_by?: string;
 }[]): {
     to: string;
     brief: string;
 };
 /** A request's refs as episode references: an `owner/repo#n` becomes its issue link, anything else stays as written. */
 export declare function episodeReferences(record: ConnectorRecord): string[];
+/** Whether the owner of this video's source registered it as withheld. */
+export declare function sourceWithheld(records: ConnectorRecord[], videoId: unknown): boolean;
 export declare function executeApproved(record: ConnectorRecord, approver: MiadiPerson, deps: ApprovalDeps, instructions?: string): Promise<Record<string, unknown>>;
 /**
  * Record a person's decision on a request and, when approved, run it once as
@@ -136,6 +142,14 @@ export declare const INTERRUPTED_MESSAGE = "The connector stopped while this ran
  * starts; a run this process is still recording is left alone.
  */
 export declare function reconcileInterrupted(deps: Pick<ApprovalDeps, "ledger" | "log">): string[];
+/**
+ * Try again the transcripts an approved create could not store: captions YouTube had not made yet, a
+ * source that was withheld and may be released since. The ledger holds what waits, so a restart loses
+ * nothing. A new record is written only when the answer changes.
+ */
+export declare function settleTranscripts(deps: ApprovalDeps): Promise<string[]>;
+/** Runs settleTranscripts while the connector runs, one pass at a time. */
+export declare function startTranscriptSettling(deps: ApprovalDeps): void;
 /** Whether a request was approved and its run failed, so a person may run it again. */
 export declare function isRerunnable(r: ConnectorRecord | undefined): boolean;
 /**
@@ -154,7 +168,7 @@ export declare function rerun(r: ConnectorRecord, person: MiadiPerson, deps: App
 }>;
 export declare function isApprovable(r: ConnectorRecord | undefined): r is ConnectorRecord;
 /** What approving a request does, in one sentence, for the card a person decides on. */
-export declare function consequenceOf(r: ConnectorRecord, authorization?: ProviderAuthorization): string;
+export declare function consequenceOf(r: ConnectorRecord, authorization?: ProviderAuthorization, records?: 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). */
 /**

package/dist/approve.js

@@ -24,6 +24,8 @@ import { factoryDir, runBriefFile, readQueueState } from "./queue-state.js";
 import { factoryLedgerPath, readFactoryReceipts, receiptsForRecord } from "./factory-receipt.js";
 import { steerAttempts, steerSession, tmuxAdapter } from "./steer.js";
 import { contentHash, versionOf } from "./revisions.js";
+import { TRANSCRIPT_RETRY_MS, transcriptStep } from "./captions.js";
+import { ReviewClient } from "./reviews.js";
 import { canReadReading } from "./reading/privacy.js";
 import { authorizationReceipt, authorizeProvider, briefAttributes, CHOICE_TTL_MS, CODEX_POLICIES, isPersonId, needsPersonChoice, providerPolicyOf, } from "./provider-policy.js";
 export { factoryDir, runBriefFile, readQueueState } from "./queue-state.js";
@@ -147,7 +149,7 @@ export function runBrief(record, approver, sessions, instructions, providerAttrs
             : []),
         // A person may approve past an open question: the worker reads it, and says in its result what it could not settle (jgwill/Miadi#939).
         ...(openAspects.length
-            ? ["", "These questions were open against the mission standard when it was approved. Settle what reading can settle, and say in your result what you could not:", "", "<open_questions>", ...openAspects.map((f) => text(`${f.aspect} ${f.name}: ${f.ask}`)), "</open_questions>"]
+            ? ["", "These questions were open against the mission standard when it was approved. Settle what reading can settle, and say in your result what you could not:", "", "<open_questions>", ...openAspects.map((f) => text(`${f.aspect} ${f.name}: ${f.ask}${f.settled_by === "person" ? " Only the person can answer this: ask them, and do not assume it." : ""}`)), "</open_questions>"]
             : []),
         ...(instructions
             ? [
@@ -180,28 +182,55 @@ export function episodeReferences(record) {
         return m ? `https://github.com/${m[1]}/${m[2]}/issues/${m[3]}` : ref;
     });
 }
+async function callReview(deps, method, path, payload) {
+    const f = deps.fetchImpl ?? fetch;
+    if (!deps.config.reviewToken)
+        throw new Error("The connector host has no review service token");
+    const res = await f(`${deps.config.reviewUrl}${path}`, {
+        method,
+        headers: { accept: "application/json", "content-type": "application/json", authorization: `Bearer ${deps.config.reviewToken}` },
+        body: JSON.stringify(payload),
+        signal: AbortSignal.timeout(290_000),
+    });
+    const text = await res.text();
+    let parsed = text;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        /* text */
+    }
+    return { status: res.status, ok: res.ok, response: parsed };
+}
+/** Whether the owner of this video's source registered it as withheld. */
+export function sourceWithheld(records, videoId) {
+    return records.some((r) => r.kind === "source_intent" && r.body.video_id === videoId && r.body.readiness === "withheld");
+}
+function transcriptIo(deps) {
+    return {
+        withheld: (video) => sourceWithheld(current(deps.ledger.all()), video),
+        captions: deps.captions,
+        store: (reviewId, transcript) => callReview(deps, "POST", `/api/reviews/${reviewId}/transcript`, { transcript }),
+    };
+}
+/** The review a create left: its answer names it, also when generation failed and a stub stands; else search by video. */
+async function reviewLeftBy(deps, response, videoId) {
+    const id = response?.id;
+    if (typeof id === "string")
+        return id;
+    try {
+        const rows = await new ReviewClient(deps.config.reviewUrl, deps.config.reviewToken, deps.fetchImpl ?? fetch).search(videoId, 100);
+        const match = rows.find((row) => row.video_id === videoId);
+        return typeof match?.id === "string" ? match.id : null;
+    }
+    catch {
+        return null;
+    }
+}
 export async function executeApproved(record, approver, deps, instructions) {
     const f = deps.fetchImpl ?? fetch;
     const b = record.body;
-    const reviewCall = async (method, path, payload) => {
-        if (!deps.config.reviewToken)
-            throw new Error("The connector host has no review service token");
-        const res = await f(`${deps.config.reviewUrl}${path}`, {
-            method,
-            headers: { accept: "application/json", "content-type": "application/json", authorization: `Bearer ${deps.config.reviewToken}` },
-            body: JSON.stringify(payload),
-            signal: AbortSignal.timeout(290_000),
-        });
-        const text = await res.text();
-        let parsed = text;
-        try {
-            parsed = JSON.parse(text);
-        }
-        catch {
-            /* text */
-        }
-        return { status: res.status, ok: res.ok, response: parsed };
-    };
+    const reviewCall = (method, path, payload) => callReview(deps, method, path, payload);
     const queueBrief = () => {
         // Checked again where the brief is written: an approval, and every rerun of it (jgwill/Miadi#926).
         const authorization = record.kind === "run_request" ? authorizeProvider(record, deps.ledger.all()) : undefined;
@@ -241,7 +270,12 @@ export async function executeApproved(record, approver, deps, instructions) {
                     : b.operation === "new_version"
                         ? await reviewCall("POST", `/api/reviews/${b.review_id}/versions`, b.transcript ? { transcript: b.transcript } : {})
                         : await reviewCall("POST", `/api/reviews/${b.review_id}/transcript`, { transcript: b.transcript });
-            return { outcome: r.ok ? "done" : "failed", operation: b.operation, status: r.status, response: r.response };
+            const result = { outcome: r.ok ? "done" : "failed", operation: b.operation, status: r.status, response: r.response };
+            if (b.operation !== "create" || !deps.captions)
+                return result;
+            const transcript = await transcriptStep({ video_id: b.video_id, review_id: await reviewLeftBy(deps, r.response, b.video_id), since: new Date().toISOString(), ...(b.transcript ? { supplied: b.transcript } : {}) }, transcriptIo(deps));
+            logDecision(deps, { phase: "transcript", record: record.id, video: b.video_id, outcome: transcript.outcome });
+            return { ...result, transcript };
         }
         case "deep_diver_request": {
             const r = await reviewCall("PUT", `/api/reviews/${b.review_id}/diver`, { ready: true, version: b.version, by: plainName(approver.name) });
@@ -535,6 +569,68 @@ export function reconcileInterrupted(deps) {
     }
     return out;
 }
+/**
+ * Try again the transcripts an approved create could not store: captions YouTube had not made yet, a
+ * source that was withheld and may be released since. The ledger holds what waits, so a restart loses
+ * nothing. A new record is written only when the answer changes.
+ */
+export async function settleTranscripts(deps) {
+    const out = [];
+    if (!deps.captions)
+        return out;
+    for (const r of current(deps.ledger.all())) {
+        const receipt = (r.completion_receipt ?? {});
+        const waiting = receipt.transcript;
+        if (r.kind !== "review_operation_request" || deciding.has(r.id))
+            continue;
+        if (waiting?.outcome !== "waiting_for_captions" && waiting?.outcome !== "held_source_withheld")
+            continue;
+        const b = r.body;
+        const next = await transcriptStep({
+            video_id: waiting.video_id,
+            review_id: waiting.review_id ?? null,
+            // The three days start when the source is released, not when it was held.
+            since: waiting.outcome === "held_source_withheld" ? new Date().toISOString() : waiting.since,
+            ...(b.transcript ? { supplied: b.transcript } : {}),
+        }, transcriptIo(deps));
+        if (next.outcome === waiting.outcome)
+            continue;
+        deps.ledger.append({
+            id: newRecordId(r.kind),
+            kind: r.kind,
+            created_at: new Date().toISOString(),
+            actor: { person_id: "system:miadi-connector", name: "Miadi connector", client_id: "captions" },
+            refs: r.refs,
+            evidence_refs: [],
+            supersedes: r.id,
+            approval_state: r.approval_state,
+            state: r.state,
+            completion_receipt: { ...receipt, transcript: next },
+            body: { decision: "transcript" },
+        });
+        logDecision(deps, { phase: "transcript", record: r.id, video: waiting.video_id, outcome: next.outcome });
+        out.push(r.id);
+    }
+    return out;
+}
+/** Runs settleTranscripts while the connector runs, one pass at a time. */
+export function startTranscriptSettling(deps) {
+    if (!deps.captions)
+        return;
+    let busy = false;
+    const pass = () => {
+        if (busy)
+            return;
+        busy = true;
+        settleTranscripts(deps)
+            .catch((error) => logDecision(deps, { phase: "transcript", error: error instanceof Error ? error.message : String(error) }))
+            .finally(() => {
+            busy = false;
+        });
+    };
+    setTimeout(pass, 30_000).unref();
+    setInterval(pass, TRANSCRIPT_RETRY_MS).unref();
+}
 /** Whether a request was approved and its run failed, so a person may run it again. */
 export function isRerunnable(r) {
     return !!r && r.approval_state === "approved" && r.state === "blocked";
@@ -676,7 +772,7 @@ export function isApprovable(r) {
     return Boolean(r && APPROVABLE.has(r.kind));
 }
 /** What approving a request does, in one sentence, for the card a person decides on. */
-export function consequenceOf(r, authorization) {
+export function consequenceOf(r, authorization, records = []) {
     const b = r.body;
     switch (r.kind) {
         case "run_request":
@@ -686,6 +782,11 @@ export function consequenceOf(r, authorization) {
         case "work_proposal":
             return "Approving starts the work: a brief written from the proposal and your instructions is queued for an agent session.";
         case "review_operation_request":
+            if (b.operation === "create") {
+                return `Approving calls the review service once to create the review, then stores the video's YouTube captions as its transcript, with no model call for the transcript. ${sourceWithheld(records, b.video_id)
+                    ? "This source is registered as withheld: the review is still created, and the transcript waits until the source is released."
+                    : "If YouTube has no captions yet, it tries again every 15 minutes for three days."}`;
+            }
             return `Approving calls the review service once: ${String(b.operation ?? "operation").replace(/_/g, " ")}.`;
         case "deep_diver_request":
             return `Approving marks review version ${b.version ?? "?"} ready for Deep Diver, which queues its pass.`;
@@ -956,7 +1057,12 @@ function draftReviewSection(r, review, canAnswer = false) {
         .join("");
     const openCodes = new Set(open.map((f) => f.aspect));
     const unchecked = review.not_checked.filter((n) => !openCodes.has(n.aspect));
-    const uncheckedLine = unchecked.length ? stateLine("Read it yourself", EYE_PATHS, `No check covers these, so read the mission for them: ${unchecked.map((n) => `<span class="code">${escapeHtml(n.aspect)}</span> ${escapeHtml(n.name)}`).join(" · ")}`) : "";
+    const partly = unchecked.filter((n) => n.in_part);
+    const uncovered = unchecked.filter((n) => !n.in_part);
+    const uncheckedLine = [
+        ...partly.map((n) => stateLine("Checked in part", EYE_PATHS, `Checked in part: <span class="code">${escapeHtml(n.aspect)}</span> ${escapeHtml(n.name)} (${escapeHtml(n.in_part)})`)),
+        ...(uncovered.length ? [stateLine("Read it yourself", EYE_PATHS, `No check covers these, so read the mission for them: ${uncovered.map((n) => `<span class="code">${escapeHtml(n.aspect)}</span> ${escapeHtml(n.name)}`).join(" · ")}`)] : []),
+    ].join("\n");
     const heading = open.length ? `${open.length} open on the mission standard v${review.standard.version}` : `The mission standard v${review.standard.version}`;
     return `<section class="standard" aria-label="The mission standard">
 <h2>${escapeHtml(heading)}</h2>
@@ -976,7 +1082,7 @@ function approvePage(deps, r, o = {}) {
     const authorization = r.kind === "run_request" ? authorizeProvider(r, deps.ledger.all(), { requireFresh: open }) : undefined;
     const blocked = Boolean(authorization && !authorization.authorized);
     return page("Approve a Miadi request", `<h1>${open ? "Approve a request" : "A decided request"}</h1>
-${actionable ? `<p>${escapeHtml(consequenceOf(r, authorization))} Declining records your refusal. Either is kept in the ledger with your name.</p>` : ""}
+${actionable ? `<p>${escapeHtml(consequenceOf(r, authorization, current(deps.ledger.all())))} Declining records your refusal. Either is kept in the ledger with your name.</p>` : ""}
 ${authorization ? providerSection(r, authorization, actionable ? o.chooserToken : undefined) : ""}
 ${summary(r)}
 ${open ? draftReviewSection(r, deps.draftReview?.stored(r), Boolean(actionable && o.token && !blocked)) : ""}

package/dist/bin.js

@@ -5,6 +5,7 @@ import { identifyThroughMiadi } from "./people.js";
 import { steeringTransport } from "./tools.js";
 import { tmuxAdapter } from "./steer.js";
 import { defaultRuntime } from "./runtime-steer.js";
+import { youtubeCaptions } from "./captions.js";
 import { VERSION } from "./version.js";
 const config = configFromEnv();
 // The host's steering surface (jgwill/Miadi#909): the tmux server of the user the service runs as,
@@ -16,6 +17,8 @@ const { app } = createConnectorApp(config, {
     tmuxSessions: () => tmux.listSessions(),
     // Each session's own steering inbox and Claude Code's registry of running sessions (jgwill/Miadi#930).
     steeringRuntime: defaultRuntime(),
+    // An approved create stores the video's YouTube captions as the review's transcript, with no model call.
+    captions: youtubeCaptions,
 });
 app.listen(config.port, config.host, () => {
     console.log(`@miadi/connector ${VERSION} on http://${config.host}:${config.port}`);

package/dist/captions.d.ts

@@ -0,0 +1,68 @@
+export declare const TRANSCRIPT_RETRY_MS: number;
+export declare const TRANSCRIPT_WINDOW_MS: number;
+export type CaptionsAnswer = {
+    state: "found";
+    text: string;
+    language: string;
+    track: string;
+    words: number;
+    first_ms: number;
+    last_ms: number;
+    duration_s?: number;
+    fetched_at: string;
+} | {
+    state: "none_yet";
+    message?: string;
+};
+export type FetchCaptions = (videoId: string) => Promise<CaptionsAnswer>;
+export interface TranscriptReceipt {
+    outcome: "stored" | "already_present" | "waiting_for_captions" | "held_source_withheld" | "no_captions" | "no_review";
+    video_id: string;
+    review_id?: string;
+    since: string;
+    source?: string;
+    language?: string;
+    chars?: number;
+    words?: number;
+    sha256?: string;
+    covers?: string;
+    stored_at?: string;
+    message?: string;
+}
+export interface TranscriptIo {
+    withheld: (videoId: string) => boolean;
+    captions: FetchCaptions;
+    store: (reviewId: string, transcript: string) => Promise<{
+        status: number;
+        ok: boolean;
+    }>;
+    now?: () => number;
+}
+/**
+ * YouTube's json3 captions as the plain `[mm:ss] text` paragraphs the review service parses into turns.
+ * The words stay as YouTube wrote them. The first line says what they are. Null when they hold no words.
+ */
+export declare function transcriptFromJson3(raw: string, o: {
+    language: string;
+    duration_s?: number;
+    fetched_at: string;
+}): {
+    text: string;
+    words: number;
+    first_ms: number;
+    last_ms: number;
+} | null;
+/** The video's original-language automatic captions, through a local yt-dlp in a directory of its own. */
+export declare const youtubeCaptions: FetchCaptions;
+/**
+ * One attempt at the transcript of a created review. A source its owner registered as withheld is
+ * neither read nor stored until it is released: the transcript the service holds is public.
+ */
+export declare function transcriptStep(input: {
+    video_id: string;
+    review_id: string | null;
+    since: string;
+    supplied?: string;
+}, io: TranscriptIo): Promise<TranscriptReceipt>;
+/** What a transcript receipt says on a request's card and approval page. */
+export declare function transcriptLines(transcript: unknown): string[];

package/dist/captions.js

@@ -0,0 +1,185 @@
+/**
+ * The transcript of a reviewed video, taken from the video's own YouTube captions.
+ *
+ * Guillaume, 2026-11-06: "when this gets triggered and I approve it, the actual transcript of the
+ * video will be available ... And I don't want us to call the API for Gemini to do it because it
+ * costs too much." So an approved `create` reads the captions with a local yt-dlp and stores them.
+ * Nothing here calls a model, and `store` is never sent an empty transcript, because the review
+ * service answers an empty one by asking Gemini (`POST /api/reviews/:id/transcript`).
+ *
+ * YouTube gives a video its address before its captions exist (Episode 550, thread beat 01f2e53e),
+ * so a transcript that cannot be stored yet stays in the request's receipt and is tried again.
+ */
+import { execFile } from "node:child_process";
+import { createHash } from "node:crypto";
+import { mkdtempSync, readdirSync, readFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { promisify } from "node:util";
+const VIDEO_ID = /^[A-Za-z0-9_-]{11}$/;
+/** A silence this long, or a paragraph this long, starts the next timestamped paragraph. */
+const PAUSE_MS = 3000;
+const PARAGRAPH_CHARS = 900;
+export const TRANSCRIPT_RETRY_MS = 15 * 60_000;
+export const TRANSCRIPT_WINDOW_MS = 72 * 3_600_000;
+function clock(ms) {
+    const total = Math.floor(ms / 1000);
+    const h = Math.floor(total / 3600);
+    const m = Math.floor((total % 3600) / 60);
+    const s = String(total % 60).padStart(2, "0");
+    return h ? `${h}:${String(m).padStart(2, "0")}:${s}` : `${String(m).padStart(2, "0")}:${s}`;
+}
+/** The covered range in words a person reads: "00:02 to 33:03 of 62:38". */
+function coverage(a) {
+    return `${clock(a.first_ms)} to ${clock(a.last_ms)}${a.duration_s ? ` of ${clock(a.duration_s * 1000)}` : ""}`;
+}
+/**
+ * YouTube's json3 captions as the plain `[mm:ss] text` paragraphs the review service parses into turns.
+ * The words stay as YouTube wrote them. The first line says what they are. Null when they hold no words.
+ */
+export function transcriptFromJson3(raw, o) {
+    const events = JSON.parse(raw).events ?? [];
+    const paragraphs = [];
+    let end = 0;
+    let first = -1;
+    let last = 0;
+    for (const e of events) {
+        const words = (e.segs ?? []).map((s) => s.utf8 ?? "").join("").replace(/\s+/g, " ").trim();
+        if (!words)
+            continue;
+        const start = e.tStartMs ?? 0;
+        const open = paragraphs[paragraphs.length - 1];
+        if (!open || start - end >= PAUSE_MS || words.startsWith(">>") || open.text.length >= PARAGRAPH_CHARS)
+            paragraphs.push({ at: start, text: words });
+        else
+            open.text += ` ${words}`;
+        end = Math.max(end, start + (e.dDurationMs ?? 0));
+        if (first < 0)
+            first = start;
+        last = end;
+    }
+    if (!paragraphs.length)
+        return null;
+    const covered = { first_ms: first, last_ms: last, duration_s: o.duration_s };
+    const header = `(YouTube automatic captions, language ${o.language}, uncorrected, fetched ${o.fetched_at.slice(0, 10)}. They run from ${coverage(covered)}. Names may be misheard, and a voice the captions did not catch is absent.)`;
+    const body = paragraphs.map((p) => `[${clock(p.at)}] ${p.text}`).join("\n\n");
+    return { text: `${header}\n\n${body}\n`, words: paragraphs.reduce((n, p) => n + p.text.split(" ").length, 0), first_ms: first, last_ms: last };
+}
+const run = promisify(execFile);
+/** The video's original-language automatic captions, through a local yt-dlp in a directory of its own. */
+export const youtubeCaptions = async (videoId) => {
+    if (!VIDEO_ID.test(videoId))
+        return { state: "none_yet", message: "Not a YouTube video id." };
+    const dir = mkdtempSync(join(tmpdir(), "miadi-captions-"));
+    try {
+        await run("uvx", [
+            "--quiet",
+            "yt-dlp@latest",
+            "--ignore-config",
+            "--js-runtimes",
+            `node:${process.execPath}`,
+            "--skip-download",
+            "--no-playlist",
+            "--no-warnings",
+            "--write-auto-subs",
+            "--sub-langs",
+            ".*-orig",
+            "--sub-format",
+            "json3",
+            "--write-info-json",
+            "--output",
+            "video.%(ext)s",
+            `https://youtu.be/${videoId}`,
+        ], { cwd: dir, timeout: 180_000, maxBuffer: 16 * 1024 * 1024 });
+        const file = readdirSync(dir).find((f) => /^video\.[\w-]+-orig\.json3$/.test(f));
+        if (!file)
+            return { state: "none_yet" };
+        const track = file.slice("video.".length, -".json3".length);
+        const language = track.slice(0, -"-orig".length);
+        let duration_s;
+        try {
+            const d = JSON.parse(readFileSync(join(dir, "video.info.json"), "utf8")).duration;
+            if (typeof d === "number" && d > 0)
+                duration_s = d;
+        }
+        catch {
+            /* the length is only said when it is known */
+        }
+        const fetched_at = new Date().toISOString();
+        const rendered = transcriptFromJson3(readFileSync(join(dir, file), "utf8"), { language, fetched_at, ...(duration_s ? { duration_s } : {}) });
+        if (!rendered)
+            return { state: "none_yet", message: "The caption track holds no words." };
+        return { state: "found", ...rendered, language, track, ...(duration_s ? { duration_s } : {}), fetched_at };
+    }
+    catch (error) {
+        // A refusal or a timeout today may answer tomorrow, so it waits with the captions that are not there yet.
+        const message = error instanceof Error ? error.message : String(error);
+        return { state: "none_yet", message: message.split("\n").filter(Boolean).pop()?.slice(0, 300) ?? "yt-dlp failed" };
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+};
+/**
+ * One attempt at the transcript of a created review. A source its owner registered as withheld is
+ * neither read nor stored until it is released: the transcript the service holds is public.
+ */
+export async function transcriptStep(input, io) {
+    const { video_id, since } = input;
+    const review_id = input.review_id ?? undefined;
+    const base = { video_id, since, ...(review_id ? { review_id } : {}) };
+    if (!review_id)
+        return { ...base, outcome: "no_review", message: "The review service left no review for this video, so nothing holds a transcript. Running the request again retries it." };
+    if (io.withheld(video_id)) {
+        return { ...base, outcome: "held_source_withheld", message: "The source is registered as withheld. The transcript is stored once the source is released." };
+    }
+    const now = (io.now ?? Date.now)();
+    const expired = now - Date.parse(since) >= TRANSCRIPT_WINDOW_MS;
+    const waiting = (message) => expired ? { ...base, outcome: "no_captions", message: `No transcript after three days of trying, and no model was called. Last answer: ${message}` } : { ...base, outcome: "waiting_for_captions", message };
+    const supplied = input.supplied?.trim();
+    const answer = supplied ? undefined : await io.captions(video_id);
+    if (answer && answer.state !== "found")
+        return waiting(answer.message ?? "YouTube has no captions for this video yet.");
+    const text = (supplied ?? answer.text).trim();
+    if (!text)
+        return waiting("The captions hold no words.");
+    let stored;
+    try {
+        stored = await io.store(review_id, text);
+    }
+    catch (error) {
+        return waiting(`The review service could not be reached: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (stored.status === 409)
+        return { ...base, outcome: "already_present", message: "The review already holds a transcript, which stays." };
+    if (!stored.ok)
+        return waiting(`The review service answered ${stored.status}.`);
+    return {
+        ...base,
+        outcome: "stored",
+        source: supplied ? "supplied with the request" : `YouTube captions (${answer.track})`,
+        chars: text.length,
+        sha256: createHash("sha256").update(text).digest("hex"),
+        stored_at: new Date(now).toISOString(),
+        ...(answer?.state === "found" ? { language: answer.language, words: answer.words, covers: coverage(answer) } : {}),
+    };
+}
+/** What a transcript receipt says on a request's card and approval page. */
+export function transcriptLines(transcript) {
+    const t = transcript;
+    switch (t?.outcome) {
+        case "stored":
+            return [`Transcript: stored from ${t.source}${t.words ? `, ${t.words} words, ${t.covers}` : ""}. No model was called for it.`];
+        case "already_present":
+            return ["Transcript: the review already held one, which stays."];
+        case "waiting_for_captions":
+            return [`Transcript: not stored yet. ${t.message ?? ""} It is tried again every 15 minutes for three days, with no model call.`.trim()];
+        case "held_source_withheld":
+            return ["Transcript: held. The source is registered as withheld, and the transcript is stored once the source is released."];
+        case "no_captions":
+        case "no_review":
+            return [`Transcript: not stored. ${t.message ?? ""}`.trim()];
+        default:
+            return [];
+    }
+}

package/dist/decisions.d.ts

@@ -19,4 +19,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.std{border-top:1px solid var(--line);margin:8px 0;padding-top:8px;display:grid;gap:8px}\nh3{font-size:14px;margin:0;font-weight:600}\n.aspects{list-style:none;margin:4px 0;padding:0;display:grid;gap:14px}\n.asp{display:grid;grid-template-columns:16px 1fr;gap:6px;font-size:14px;overflow-wrap:anywhere}\n.asp .gl{margin-top:3px;color:var(--muted);display:block}\n.asp p{margin:1px 0}\n.asp .nm{color:var(--muted)}\n.asp .ask{font-weight:600}\n.asp details{margin:0}\n.asp details[open]{border-left:2px solid var(--accent);padding-left:8px;margin-top:2px}\n.asp summary{padding:8px 0}\n.who{display:flex;gap:8px;align-items:center}\n.who .settler{flex:1}\n.yours .settler{color:var(--fg);font-weight:600}\n.yours .gl{color:var(--accent)}\n.iconbtn{min-height:34px;width:34px;padding:0;display:inline-grid;place-items:center;flex:none;border-color:var(--accent);color:var(--accent)}\n.openL{display:none}\ndetails[open]>summary .openL{display:inline}\ndetails[open]>summary .closedL{display:none}\n.fact{margin:0;font-size:14px;overflow-wrap:anywhere}\n.code{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:13px}\n.small{font-size:13px;color:var(--muted);margin:0;overflow-wrap:anywhere}\nblockquote{margin:4px 0 0;padding-left:8px;border-left:2px solid var(--line);font-size:14px;overflow-wrap:anywhere}\nsummary:focus-visible{outline:2px solid var(--accent);outline-offset:2px}\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  // A decision still running is followed to its outcome (jgwill/Miadi#924): one read every POLL_MS, at most POLL_MAX.\n  var POLL_MS=3000,POLL_MAX=100,polls={};\n  // An error that leaves the request open offers its approval page under it.\n  var relink={};\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\":[\"recording\",\"dispatching\"].indexOf(p.stage)!==-1?\"note\":\"done\",stage:p.stage,label:p.label,lines:p.lines||[],url:p.receipt_url||null,note:note||null};}\n  // Read where a request stands. Still running: read again later. Never decided (the call was lost on the way): offer the decision again.\n  function follow(r,lost){\n    if(!host()||!host().callTool)return;\n    polls[r.id]=(polls[r.id]||0)+1;\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){if(lost){delete decided[r.id];errors[r.id]=lost;}render();return;}\n      if(p.stage===\"awaiting_decision\"){delete decided[r.id];if(lost)errors[r.id]=lost+\" Nothing was decided; decide again.\";render();return;}\n      var note=decided[r.id]&&decided[r.id].note;\n      decided[r.id]=projectionView(p,note);delete errors[r.id];render();\n      if(p.stage===\"recording\"&&polls[r.id]<POLL_MAX)setTimeout(function(){follow(r);},POLL_MS);\n    },function(err){\n      if(lost){decided[r.id]={cls:\"note\",stage:\"recording\",label:\"Your decision may be recorded. Checking again\u2026\",lines:[],url:null,note:null};render();}\n      if(polls[r.id]<POLL_MAX)setTimeout(function(){follow(r,lost);},POLL_MS);\n    });\n  }\n  var SETTLED={drafter:\"The drafting agent can answer this.\",person:\"Only you can answer this. Write it under Instructions.\",bystander:\"Only the person deciding can answer this, in their instructions.\",local_agent:\"A local agent can settle this from the running system.\"};\n  var ARROW='<svg aria-hidden=\"true\" viewBox=\"0 0 24 24\" width=\"16\" height=\"16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.9\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"M12 17V3\"/><path d=\"m6 11 6 6 6-6\"/><path d=\"M19 21H5\"/></svg>';\n  var DASHED='<path d=\"M10.1 2.182a10 10 0 0 1 3.8 0\"/><path d=\"M13.9 21.818a10 10 0 0 1-3.8 0\"/><path d=\"M17.609 3.721a10 10 0 0 1 2.69 2.7\"/><path d=\"M2.182 13.9a10 10 0 0 1 0-3.8\"/><path d=\"M20.279 17.609a10 10 0 0 1-2.7 2.69\"/><path d=\"M21.818 10.1a10 10 0 0 1 0 3.8\"/><path d=\"M3.721 6.391a10 10 0 0 1 2.7-2.69\"/><path d=\"M6.391 20.279a10 10 0 0 1-2.69-2.7\"/>';var EYE='<path d=\"M2.062 12.348a1 1 0 0 1 0-.696 10.75 10.75 0 0 1 19.876 0 1 1 0 0 1 0 .696 10.75 10.75 0 0 1-19.876 0\"/><circle cx=\"12\" cy=\"12\" r=\"3\"/>';\n  function glyph(label,paths){return '<svg role=\"img\" aria-label=\"'+label+'\" viewBox=\"0 0 24 24\" width=\"16\" height=\"16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.9\" stroke-linecap=\"round\" stroke-linejoin=\"round\">'+paths+'</svg>';}\n  // A redraw rebuilds the card: what the person typed and which reasons they opened stay.\n  var typed={};var whyOpen={};var boxes={};\n  function stateLine(label,paths,build){var row=el(\"div\",{class:\"asp state\"});var g=el(\"span\",{class:\"gl\"});g.innerHTML=glyph(label,paths);row.appendChild(g);var t=el(\"p\",{class:\"small\"});build(t);row.appendChild(t);return row;}\n  // The mission standard's open aspects, for the person deciding: what only they can answer first, and no verdict (jgwill/Miadi#939).\n  function standardBlock(r,token){\n    var rv=r.draft_review;\n    var canAnswer=Boolean(token&&host()&&host().callTool);\n    var s=el(\"section\",{class:\"std\",\"aria-label\":\"The mission standard\"});\n    var list=rv?(rv.needs_revision||[]).slice().sort(function(a,b){var p=(b.settled_by===\"person\"?1:0)-(a.settled_by===\"person\"?1:0);return p||String(a.aspect).localeCompare(String(b.aspect));}):[];\n    var version=rv&&rv.standard?\" v\"+rv.standard.version:\"\";\n    s.appendChild(el(\"h3\",null,list.length?list.length+\" open on the mission standard\"+version:\"The mission standard\"+version));\n    if(r.delivery){\n      var place=el(\"p\",{class:\"fact\"});place.appendChild(el(\"span\",{class:\"small\"},\"The result lands at: \"));var disputed=list.some(function(f){return f.aspect===\"S1\";});\n      place.appendChild(el(\"span\",disputed?{class:\"small\"}:null,r.delivery));\n      if(disputed)place.appendChild(el(\"span\",{class:\"small\"},\" (S1 below asks about this)\"));\n      s.appendChild(place);\n    }\n    if(r.person_words){var w=el(\"div\");w.appendChild(el(\"p\",{class:\"small\"},\"The person's words, as the drafting agent quoted them:\"));w.appendChild(el(\"blockquote\",null,r.person_words));s.appendChild(w);}\n    if(!rv){s.appendChild(stateLine(\"Read it yourself\",EYE,function(t){t.textContent=\"No check ran on this version of the mission. Read it yourself.\";}));return s;}\n    if(!list.length)s.appendChild(stateLine(\"Nothing flagged\",DASHED,function(t){t.textContent=\"Nothing flagged on the aspects checked.\";}));\n    else{\n      var ul=el(\"ul\",{class:\"aspects\"});\n      list.forEach(function(f){\n        var mine=f.settled_by===\"person\"&&canAnswer;\n        var row=el(\"li\",{class:\"asp\"+(mine?\" yours\":\"\")});\n        var g=el(\"span\",{class:\"gl\"});g.innerHTML=glyph(\"Open aspect\",DASHED);row.appendChild(g);\n        var t=el(\"div\");\n        var name=el(\"p\",{class:\"nm\"});name.appendChild(el(\"span\",{class:\"code\"},f.aspect));name.appendChild(el(\"span\",null,\" \"+f.name));t.appendChild(name);\n        t.appendChild(el(\"p\",{class:\"ask\"},f.ask));\n        if(f.span&&f.span!==r.delivery)t.appendChild(el(\"p\",{class:\"small\"},\"The mission says: \"+f.span));\n        if(f.note)t.appendChild(el(\"p\",{class:\"small\"},f.note));\n        var who=el(\"div\",{class:\"who\"});\n        who.appendChild(el(\"p\",{class:\"small settler\"},(f.settled_by===\"person\"&&!canAnswer?SETTLED.bystander:SETTLED[f.settled_by])||f.settled_by));\n        if(mine){\n          var go=el(\"button\",{type:\"button\",class:\"iconbtn\",\"aria-label\":\"Go to Instructions\",title:\"Go to Instructions\"});go.innerHTML=ARROW;\n          go.addEventListener(\"click\",function(){var box=boxes[r.id];if(box){if(box.scrollIntoView)box.scrollIntoView({block:\"center\"});box.focus();}});\n          who.appendChild(go);\n        }\n        t.appendChild(who);\n        var key=r.id+\"/\"+f.aspect;\n        var why=el(\"details\");if(whyOpen[key])why.setAttribute(\"open\",\"\");\n        why.addEventListener(\"toggle\",function(){whyOpen[key]=why.open;});\n        var sum=el(\"summary\");sum.appendChild(el(\"span\",{class:\"closedL\"},\"Why\"));sum.appendChild(el(\"span\",{class:\"openL\"},\"Hide why\"));why.appendChild(sum);\n        why.appendChild(el(\"p\",{class:\"small\"},f.why));\n        var by=String(f.checked_by||\"\").split(\" \")[0]===\"jev\"?\"Jev\":f.checked_by===\"code\"?\"a check in code\":\"the \"+f.checked_by;\n        why.appendChild(el(\"p\",{class:\"small\"},\"Flagged by \"+by+\".\"));\n        t.appendChild(why);\n        row.appendChild(t);ul.appendChild(row);\n      });\n      s.appendChild(ul);\n    }\n    var open={};list.forEach(function(f){open[f.aspect]=true;});\n    var rest=(rv.not_checked||[]).filter(function(n){return !open[n.aspect];});\n    if(rest.length)s.appendChild(stateLine(\"Read it yourself\",EYE,function(t){\n      t.appendChild(el(\"span\",null,\"No check covers these, so read the mission for them: \"));\n      rest.forEach(function(n,i){if(i)t.appendChild(el(\"span\",null,\" \u00B7 \"));t.appendChild(el(\"span\",{class:\"code\"},n.aspect));t.appendChild(el(\"span\",null,\" \"+n.name));});\n    }));\n    if(canAnswer&&list.some(function(f){return f.settled_by===\"drafter\";}))s.appendChild(el(\"p\",{class:\"small\"},\"To put the drafting agent's questions to it, say what to revise under Instructions and send it back.\"));\n    if(canAnswer&&list.length)s.appendChild(el(\"p\",{class:\"small\"},\"Approving as it stands starts the session, and the worker reads these questions with the task.\"));\n    return s;\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    if(!decided[r.id]&&!pending[r.id]&&r.projection&&r.projection.stage===\"awaiting_decision\"&&(r.kind===\"run_request\"||r.kind===\"work_proposal\"||r.draft_review||r.delivery||r.person_words))a.appendChild(standardBlock(r,token));\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(shown.stage===\"recording\"&&polls[r.id]===undefined&&host()&&host().callTool){polls[r.id]=0;setTimeout(function(){follow(r);},POLL_MS);}\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    function approvalLink(){var p=el(\"p\",{class:\"note\"});p.appendChild(document.createTextNode(\"Decide on its approval page: \"));p.appendChild(el(\"a\",{href:r.approval_url,target:\"_blank\",rel:\"noopener\"},\"open the approval page\"));return p;}\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){a.appendChild(approvalLink());return a;}\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    ta.value=typed[r.id]||\"\";boxes[r.id]=ta;\n    ta.addEventListener(\"input\",function(){typed[r.id]=ta.value;});\n    a.appendChild(ta);\n    var row=el(\"div\",{class:\"row\"});\n    // The ring on a mission would move with its report and read as a verdict, so a mission's buttons carry none (jgwill/Miadi#939).\n    var mission=r.kind===\"run_request\"||r.kind===\"work_proposal\";\n    var buttons=[[\"approve\",\"Approve\",mission?\"\":\"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];if(relink[r.id])a.appendChild(approvalLink());}\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||(out.detail&&out.detail.projection));\n        var code=out&&out.error;\n        delete pending[r.id];\n        // The token expired or the request was revised, and it still awaits a decision: say so and keep it open.\n        if(code&&(!proj||proj.stage===\"awaiting_decision\")){errors[r.id]=(out&&out.message)||\"Not recorded.\";relink[r.id]=true;render();return;}\n        var note=out&&out.replayed?\"This decision was already recorded. Nothing ran again.\":code===\"decision_conflict\"?\"A different decision was recorded first. Here is where it stands.\":code===\"already_decided\"?\"This request was already decided. Here is where it stands.\":null;\n        if(proj){decided[r.id]=projectionView(proj,note);}\n        else{decided[r.id]={cls:code?\"fail\":\"done\",label:code?((out&&out.message)||\"Not recorded.\"):((out&&out.summary)||\"Recorded.\"),lines:[],url:null,note:null};}\n        render();\n      },function(err){\n        // The host gave up waiting; the connector may still have recorded it. Read before offering the buttons again (#924).\n        delete pending[r.id];\n        decided[r.id]={cls:\"note\",stage:\"recording\",label:\"Checking whether your decision was recorded\u2026\",lines:[],url:null,note:null};\n        polls[r.id]=0;render();\n        follow(r,\"Not recorded: \"+(err&&err.message?err.message:String(err))+\".\");\n      });\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.std{border-top:1px solid var(--line);margin:8px 0;padding-top:8px;display:grid;gap:8px}\nh3{font-size:14px;margin:0;font-weight:600}\n.aspects{list-style:none;margin:4px 0;padding:0;display:grid;gap:14px}\n.asp{display:grid;grid-template-columns:16px 1fr;gap:6px;font-size:14px;overflow-wrap:anywhere}\n.asp .gl{margin-top:3px;color:var(--muted);display:block}\n.asp p{margin:1px 0}\n.asp .nm{color:var(--muted)}\n.asp .ask{font-weight:600}\n.asp details{margin:0}\n.asp details[open]{border-left:2px solid var(--accent);padding-left:8px;margin-top:2px}\n.asp summary{padding:8px 0}\n.who{display:flex;gap:8px;align-items:center}\n.who .settler{flex:1}\n.yours .settler{color:var(--fg);font-weight:600}\n.yours .gl{color:var(--accent)}\n.iconbtn{min-height:34px;width:34px;padding:0;display:inline-grid;place-items:center;flex:none;border-color:var(--accent);color:var(--accent)}\n.openL{display:none}\ndetails[open]>summary .openL{display:inline}\ndetails[open]>summary .closedL{display:none}\n.fact{margin:0;font-size:14px;overflow-wrap:anywhere}\n.code{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:13px}\n.small{font-size:13px;color:var(--muted);margin:0;overflow-wrap:anywhere}\nblockquote{margin:4px 0 0;padding-left:8px;border-left:2px solid var(--line);font-size:14px;overflow-wrap:anywhere}\nsummary:focus-visible{outline:2px solid var(--accent);outline-offset:2px}\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  // A decision still running is followed to its outcome (jgwill/Miadi#924): one read every POLL_MS, at most POLL_MAX.\n  var POLL_MS=3000,POLL_MAX=100,polls={};\n  // An error that leaves the request open offers its approval page under it.\n  var relink={};\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\":[\"recording\",\"dispatching\"].indexOf(p.stage)!==-1?\"note\":\"done\",stage:p.stage,label:p.label,lines:p.lines||[],url:p.receipt_url||null,note:note||null};}\n  // Read where a request stands. Still running: read again later. Never decided (the call was lost on the way): offer the decision again.\n  function follow(r,lost){\n    if(!host()||!host().callTool)return;\n    polls[r.id]=(polls[r.id]||0)+1;\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){if(lost){delete decided[r.id];errors[r.id]=lost;}render();return;}\n      if(p.stage===\"awaiting_decision\"){delete decided[r.id];if(lost)errors[r.id]=lost+\" Nothing was decided; decide again.\";render();return;}\n      var note=decided[r.id]&&decided[r.id].note;\n      decided[r.id]=projectionView(p,note);delete errors[r.id];render();\n      if(p.stage===\"recording\"&&polls[r.id]<POLL_MAX)setTimeout(function(){follow(r);},POLL_MS);\n    },function(err){\n      if(lost){decided[r.id]={cls:\"note\",stage:\"recording\",label:\"Your decision may be recorded. Checking again\u2026\",lines:[],url:null,note:null};render();}\n      if(polls[r.id]<POLL_MAX)setTimeout(function(){follow(r,lost);},POLL_MS);\n    });\n  }\n  var SETTLED={drafter:\"The drafting agent can answer this.\",person:\"Only you can answer this. Write it under Instructions.\",bystander:\"Only the person deciding can answer this, in their instructions.\",local_agent:\"A local agent can settle this from the running system.\"};\n  var ARROW='<svg aria-hidden=\"true\" viewBox=\"0 0 24 24\" width=\"16\" height=\"16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.9\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"M12 17V3\"/><path d=\"m6 11 6 6 6-6\"/><path d=\"M19 21H5\"/></svg>';\n  var DASHED='<path d=\"M10.1 2.182a10 10 0 0 1 3.8 0\"/><path d=\"M13.9 21.818a10 10 0 0 1-3.8 0\"/><path d=\"M17.609 3.721a10 10 0 0 1 2.69 2.7\"/><path d=\"M2.182 13.9a10 10 0 0 1 0-3.8\"/><path d=\"M20.279 17.609a10 10 0 0 1-2.7 2.69\"/><path d=\"M21.818 10.1a10 10 0 0 1 0 3.8\"/><path d=\"M3.721 6.391a10 10 0 0 1 2.7-2.69\"/><path d=\"M6.391 20.279a10 10 0 0 1-2.69-2.7\"/>';var EYE='<path d=\"M2.062 12.348a1 1 0 0 1 0-.696 10.75 10.75 0 0 1 19.876 0 1 1 0 0 1 0 .696 10.75 10.75 0 0 1-19.876 0\"/><circle cx=\"12\" cy=\"12\" r=\"3\"/>';\n  function glyph(label,paths){return '<svg role=\"img\" aria-label=\"'+label+'\" viewBox=\"0 0 24 24\" width=\"16\" height=\"16\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.9\" stroke-linecap=\"round\" stroke-linejoin=\"round\">'+paths+'</svg>';}\n  // A redraw rebuilds the card: what the person typed and which reasons they opened stay.\n  var typed={};var whyOpen={};var boxes={};\n  function stateLine(label,paths,build){var row=el(\"div\",{class:\"asp state\"});var g=el(\"span\",{class:\"gl\"});g.innerHTML=glyph(label,paths);row.appendChild(g);var t=el(\"p\",{class:\"small\"});build(t);row.appendChild(t);return row;}\n  // The mission standard's open aspects, for the person deciding: what only they can answer first, and no verdict (jgwill/Miadi#939).\n  function standardBlock(r,token){\n    var rv=r.draft_review;\n    var canAnswer=Boolean(token&&host()&&host().callTool);\n    var s=el(\"section\",{class:\"std\",\"aria-label\":\"The mission standard\"});\n    var list=rv?(rv.needs_revision||[]).slice().sort(function(a,b){var p=(b.settled_by===\"person\"?1:0)-(a.settled_by===\"person\"?1:0);return p||String(a.aspect).localeCompare(String(b.aspect));}):[];\n    var version=rv&&rv.standard?\" v\"+rv.standard.version:\"\";\n    s.appendChild(el(\"h3\",null,list.length?list.length+\" open on the mission standard\"+version:\"The mission standard\"+version));\n    if(r.delivery){\n      var place=el(\"p\",{class:\"fact\"});place.appendChild(el(\"span\",{class:\"small\"},\"The result lands at: \"));var disputed=list.some(function(f){return f.aspect===\"S1\";});\n      place.appendChild(el(\"span\",disputed?{class:\"small\"}:null,r.delivery));\n      if(disputed)place.appendChild(el(\"span\",{class:\"small\"},\" (S1 below asks about this)\"));\n      s.appendChild(place);\n    }\n    if(r.person_words){var w=el(\"div\");w.appendChild(el(\"p\",{class:\"small\"},\"The person's words, as the drafting agent quoted them:\"));w.appendChild(el(\"blockquote\",null,r.person_words));s.appendChild(w);}\n    if(!rv){s.appendChild(stateLine(\"Read it yourself\",EYE,function(t){t.textContent=\"No check ran on this version of the mission. Read it yourself.\";}));return s;}\n    if(!list.length)s.appendChild(stateLine(\"Nothing flagged\",DASHED,function(t){t.textContent=\"Nothing flagged on the aspects checked.\";}));\n    else{\n      var ul=el(\"ul\",{class:\"aspects\"});\n      list.forEach(function(f){\n        var mine=f.settled_by===\"person\"&&canAnswer;\n        var row=el(\"li\",{class:\"asp\"+(mine?\" yours\":\"\")});\n        var g=el(\"span\",{class:\"gl\"});g.innerHTML=glyph(\"Open aspect\",DASHED);row.appendChild(g);\n        var t=el(\"div\");\n        var name=el(\"p\",{class:\"nm\"});name.appendChild(el(\"span\",{class:\"code\"},f.aspect));name.appendChild(el(\"span\",null,\" \"+f.name));t.appendChild(name);\n        t.appendChild(el(\"p\",{class:\"ask\"},f.ask));\n        if(f.span&&f.span!==r.delivery)t.appendChild(el(\"p\",{class:\"small\"},\"The mission says: \"+f.span));\n        if(f.note)t.appendChild(el(\"p\",{class:\"small\"},f.note));\n        var who=el(\"div\",{class:\"who\"});\n        who.appendChild(el(\"p\",{class:\"small settler\"},(f.settled_by===\"person\"&&!canAnswer?SETTLED.bystander:SETTLED[f.settled_by])||f.settled_by));\n        if(mine){\n          var go=el(\"button\",{type:\"button\",class:\"iconbtn\",\"aria-label\":\"Go to Instructions\",title:\"Go to Instructions\"});go.innerHTML=ARROW;\n          go.addEventListener(\"click\",function(){var box=boxes[r.id];if(box){if(box.scrollIntoView)box.scrollIntoView({block:\"center\"});box.focus();}});\n          who.appendChild(go);\n        }\n        t.appendChild(who);\n        var key=r.id+\"/\"+f.aspect;\n        var why=el(\"details\");if(whyOpen[key])why.setAttribute(\"open\",\"\");\n        why.addEventListener(\"toggle\",function(){whyOpen[key]=why.open;});\n        var sum=el(\"summary\");sum.appendChild(el(\"span\",{class:\"closedL\"},\"Why\"));sum.appendChild(el(\"span\",{class:\"openL\"},\"Hide why\"));why.appendChild(sum);\n        why.appendChild(el(\"p\",{class:\"small\"},f.why));\n        var by=String(f.checked_by||\"\").split(\" \")[0]===\"jev\"?\"Jev\":f.checked_by===\"code\"?\"a check in code\":\"the \"+f.checked_by;\n        why.appendChild(el(\"p\",{class:\"small\"},\"Flagged by \"+by+\".\"));\n        t.appendChild(why);\n        row.appendChild(t);ul.appendChild(row);\n      });\n      s.appendChild(ul);\n    }\n    var open={};list.forEach(function(f){open[f.aspect]=true;});\n    var unseen=(rv.not_checked||[]).filter(function(n){return !open[n.aspect];});\n    var rest=unseen.filter(function(n){return !n.in_part;});\n    unseen.filter(function(n){return n.in_part;}).forEach(function(n){\n      s.appendChild(stateLine(\"Checked in part\",EYE,function(t){t.appendChild(el(\"span\",null,\"Checked in part: \"));t.appendChild(el(\"span\",{class:\"code\"},n.aspect));t.appendChild(el(\"span\",null,\" \"+n.name+\" (\"+n.in_part+\")\"));}));\n    });\n    if(rest.length)s.appendChild(stateLine(\"Read it yourself\",EYE,function(t){\n      t.appendChild(el(\"span\",null,\"No check covers these, so read the mission for them: \"));\n      rest.forEach(function(n,i){if(i)t.appendChild(el(\"span\",null,\" \u00B7 \"));t.appendChild(el(\"span\",{class:\"code\"},n.aspect));t.appendChild(el(\"span\",null,\" \"+n.name));});\n    }));\n    if(canAnswer&&list.some(function(f){return f.settled_by===\"drafter\";}))s.appendChild(el(\"p\",{class:\"small\"},\"To put the drafting agent's questions to it, say what to revise under Instructions and send it back.\"));\n    var refused=r.provider_authorization&&r.provider_authorization.authorized===false;\n    if(canAnswer&&list.length&&!refused)s.appendChild(el(\"p\",{class:\"small\"},\"Approving as it stands starts the session, and the worker reads these questions with the task.\"));\n    return s;\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    if(!decided[r.id]&&!pending[r.id]&&r.projection&&r.projection.stage===\"awaiting_decision\"&&(r.kind===\"run_request\"||r.kind===\"work_proposal\"||r.draft_review||r.delivery||r.person_words))a.appendChild(standardBlock(r,token));\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(shown.stage===\"recording\"&&polls[r.id]===undefined&&host()&&host().callTool){polls[r.id]=0;setTimeout(function(){follow(r);},POLL_MS);}\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    function approvalLink(){var p=el(\"p\",{class:\"note\"});p.appendChild(document.createTextNode(\"Decide on its approval page: \"));p.appendChild(el(\"a\",{href:r.approval_url,target:\"_blank\",rel:\"noopener\"},\"open the approval page\"));return p;}\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){a.appendChild(approvalLink());return a;}\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    ta.value=typed[r.id]||\"\";boxes[r.id]=ta;\n    ta.addEventListener(\"input\",function(){typed[r.id]=ta.value;});\n    a.appendChild(ta);\n    var row=el(\"div\",{class:\"row\"});\n    // The ring on a mission would move with its report and read as a verdict, so a mission's buttons carry none (jgwill/Miadi#939).\n    var mission=r.kind===\"run_request\"||r.kind===\"work_proposal\";\n    var buttons=[[\"approve\",\"Approve\",mission?\"\":\"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];if(relink[r.id])a.appendChild(approvalLink());}\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||(out.detail&&out.detail.projection));\n        var code=out&&out.error;\n        delete pending[r.id];\n        // The token expired or the request was revised, and it still awaits a decision: say so and keep it open.\n        if(code&&(!proj||proj.stage===\"awaiting_decision\")){errors[r.id]=(out&&out.message)||\"Not recorded.\";relink[r.id]=true;render();return;}\n        var note=out&&out.replayed?\"This decision was already recorded. Nothing ran again.\":code===\"decision_conflict\"?\"A different decision was recorded first. Here is where it stands.\":code===\"already_decided\"?\"This request was already decided. Here is where it stands.\":null;\n        if(proj){decided[r.id]=projectionView(proj,note);}\n        else{decided[r.id]={cls:code?\"fail\":\"done\",label:code?((out&&out.message)||\"Not recorded.\"):((out&&out.summary)||\"Recorded.\"),lines:[],url:null,note:null};}\n        render();\n      },function(err){\n        // The host gave up waiting; the connector may still have recorded it. Read before offering the buttons again (#924).\n        delete pending[r.id];\n        decided[r.id]={cls:\"note\",stage:\"recording\",label:\"Checking whether your decision was recorded\u2026\",lines:[],url:null,note:null};\n        polls[r.id]=0;render();\n        follow(r,\"Not recorded: \"+(err&&err.message?err.message:String(err))+\".\");\n      });\n    }\n    return a;\n  }\n  window.addEventListener(\"openai:set_globals\",render);\n  render();\n})();\n</script></body></html>";

package/dist/decisions.js

@@ -234,13 +234,18 @@ summary:focus-visible{outline:2px solid var(--accent);outline-offset:2px}
       s.appendChild(ul);
     }
     var open={};list.forEach(function(f){open[f.aspect]=true;});
-    var rest=(rv.not_checked||[]).filter(function(n){return !open[n.aspect];});
+    var unseen=(rv.not_checked||[]).filter(function(n){return !open[n.aspect];});
+    var rest=unseen.filter(function(n){return !n.in_part;});
+    unseen.filter(function(n){return n.in_part;}).forEach(function(n){
+      s.appendChild(stateLine("Checked in part",EYE,function(t){t.appendChild(el("span",null,"Checked in part: "));t.appendChild(el("span",{class:"code"},n.aspect));t.appendChild(el("span",null," "+n.name+" ("+n.in_part+")"));}));
+    });
     if(rest.length)s.appendChild(stateLine("Read it yourself",EYE,function(t){
       t.appendChild(el("span",null,"No check covers these, so read the mission for them: "));
       rest.forEach(function(n,i){if(i)t.appendChild(el("span",null," · "));t.appendChild(el("span",{class:"code"},n.aspect));t.appendChild(el("span",null," "+n.name));});
     }));
     if(canAnswer&&list.some(function(f){return f.settled_by==="drafter";}))s.appendChild(el("p",{class:"small"},"To put the drafting agent's questions to it, say what to revise under Instructions and send it back."));
-    if(canAnswer&&list.length)s.appendChild(el("p",{class:"small"},"Approving as it stands starts the session, and the worker reads these questions with the task."));
+    var refused=r.provider_authorization&&r.provider_authorization.authorized===false;
+    if(canAnswer&&list.length&&!refused)s.appendChild(el("p",{class:"small"},"Approving as it stands starts the session, and the worker reads these questions with the task."));
     return s;
   }
   function card(r,token){

package/dist/draft-review.d.ts

@@ -43,6 +43,7 @@ export interface DraftReview {
         aspect: string;
         name: string;
         reason: string;
+        in_part?: string;
     }[];
     running_missions: RunningMission[];
     preferences: string[];

package/dist/draft-review.js

@@ -194,7 +194,7 @@ export async function reviewDraft({ record, records, standard, adapter, now = Da
             notChecked.push({ aspect: a.code, name: a.name, reason: "This version of the connector runs no check for it." });
         }
         if (a.not_checked)
-            notChecked.push({ aspect: a.code, name: a.name, reason: a.not_checked });
+            notChecked.push({ aspect: a.code, name: a.name, reason: a.not_checked, ...(a.checked_in_part ? { in_part: a.checked_in_part } : {}) });
     }
     // For a finding Jev raised on the mission, the sentence it is about. A failure leaves the finding without one.
     const raised = needs.flatMap((f) => {

package/dist/mission-standard.d.ts

@@ -39,6 +39,8 @@ export interface StandardAspect {
     jev?: JevCheck;
     /** Why this version of the connector does not check it, or checks only part of it. */
     not_checked?: string;
+    /** What is checked when only part of the aspect is, in words for the person deciding. */
+    checked_in_part?: string;
 }
 export interface MissionStandard {
     name: string;

package/dist/mission-standard.js

@@ -57,6 +57,7 @@ export const BUILT_IN_STANDARD = {
             fix: "Say which in the mission.",
             settled_by: "drafter",
             not_checked: "Only shared issues are compared. The local reviewer judges other overlap, and it does not run yet (jgwill/Miadi#939 A3).",
+            checked_in_part: "only shared issues are compared",
         },
         {
             code: "S4",
@@ -127,7 +128,7 @@ export function parseStandard(text, version) {
         if (!["drafter", "person", "local_agent"].includes(a.settled_by))
             throw new Error(`aspect ${a.code}: settled_by is drafter, person or local_agent`);
         const jev = checkOf(a.jev);
-        return { code: a.code, name: a.name, requires: a.requires, why: a.why, ask: a.ask, ...(isText(a.fix) ? { fix: a.fix } : {}), settled_by: a.settled_by, ...(jev ? { jev } : {}), ...(isText(a.not_checked) ? { not_checked: a.not_checked } : {}) };
+        return { code: a.code, name: a.name, requires: a.requires, why: a.why, ask: a.ask, ...(isText(a.fix) ? { fix: a.fix } : {}), settled_by: a.settled_by, ...(jev ? { jev } : {}), ...(isText(a.not_checked) ? { not_checked: a.not_checked } : {}), ...(isText(a.checked_in_part) ? { checked_in_part: a.checked_in_part } : {}) };
     });
     const preferences = {};
     for (const [person, list] of Object.entries(raw.preferences ?? {})) {

package/dist/reading/contract.d.ts

@@ -35,9 +35,9 @@ export declare const sourcePart: z.ZodObject<{
     locator: z.ZodString;
     provider: z.ZodString;
     caption_kind: z.ZodEnum<{
+        supplied: "supplied";
         manual: "manual";
         automatic: "automatic";
-        supplied: "supplied";
         local_stt: "local_stt";
     }>;
     fetched_at: z.ZodString;

package/dist/request-state.d.ts

@@ -1,23 +1,3 @@
-/**
- * Where a request stands, read once for every surface that shows it: the
- * decision card in the conversation, the approval page, get_run_result and
- * Miadi's /research (jgwill/Miadi#889, Mission A). A surface shows the
- * projection's `label` and `lines`. It does not read the record's state,
- * approval state or receipt by itself.
- *
- * Stages, from the ledger's folded record (see `current()`):
- * - awaiting_decision: awaiting_approval, nothing decided
- * - recording: a decision is being recorded, or it was approved and its run is
- *   going (written ahead as outcome `running`, jgwill/Miadi#924)
- * - declined, sent_back: decided, nothing ran
- * - dispatching: approved, and its brief is queued or running (state in_progress)
- * - completed: approved, and its run finished (state completed)
- * - failed: approved, and its run failed (state blocked); the same approval may run it again
- *
- * Approving with changes keeps the changes with the decision. A kind whose run
- * does not carry instructions (approve.ts runBrief carries them only for runs and
- * work proposals) lists them as outstanding. The projection never says they ran.
- */
 import type { ConnectorRecord } from "./records.js";
 export declare const APPROVABLE_KINDS: readonly ["run_request", "review_operation_request", "deep_diver_request", "review_episode_link_request", "work_proposal", "session_completion_proposal", "inquiry_episode_request", "session_steer_request"];
 export declare const APPROVABLE: ReadonlySet<string>;

package/dist/request-state.js

@@ -1,3 +1,24 @@
+/**
+ * Where a request stands, read once for every surface that shows it: the
+ * decision card in the conversation, the approval page, get_run_result and
+ * Miadi's /research (jgwill/Miadi#889, Mission A). A surface shows the
+ * projection's `label` and `lines`. It does not read the record's state,
+ * approval state or receipt by itself.
+ *
+ * Stages, from the ledger's folded record (see `current()`):
+ * - awaiting_decision: awaiting_approval, nothing decided
+ * - recording: a decision is being recorded, or it was approved and its run is
+ *   going (written ahead as outcome `running`, jgwill/Miadi#924)
+ * - declined, sent_back: decided, nothing ran
+ * - dispatching: approved, and its brief is queued or running (state in_progress)
+ * - completed: approved, and its run finished (state completed)
+ * - failed: approved, and its run failed (state blocked); the same approval may run it again
+ *
+ * Approving with changes keeps the changes with the decision. A kind whose run
+ * does not carry instructions (approve.ts runBrief carries them only for runs and
+ * work proposals) lists them as outstanding. The projection never says they ran.
+ */
+import { transcriptLines } from "./captions.js";
 export const APPROVABLE_KINDS = [
     "run_request",
     "review_operation_request",
@@ -134,6 +155,7 @@ function projectCore(record, ctx = {}) {
         const lines = [...decisionLines(decision), `Failure: ${failure}`];
         if (receipt.outcome)
             lines.push(`Outcome: ${outcomeWord}.`);
+        lines.push(...transcriptLines(receipt.transcript));
         lines.push(...outstanding);
         return finish({
             ...base,
@@ -183,6 +205,7 @@ function projectCore(record, ctx = {}) {
         lines.push(`Outcome: ${outcomeWord}.`);
     if (receiptUrl)
         lines.push(`Review: ${receiptUrl}`);
+    lines.push(...transcriptLines(receipt.transcript));
     lines.push(...outstanding);
     return finish({
         ...base,

package/dist/server.d.ts

@@ -12,6 +12,7 @@
 import type { RuntimeDeps } from "./runtime-steer.js";
 import { MiadiOAuthProvider } from "./oauth.js";
 import type { MiadiPerson } from "./people.js";
+import type { FetchCaptions } from "./captions.js";
 import { Ledger } from "./store.js";
 import type { ConnectorRecord } from "./records.js";
 import type { ConnectorConfig } from "./config.js";
@@ -40,6 +41,8 @@ export interface ConnectorDeps {
     steerSettleMs?: number;
     /** Where sessions and their steering inboxes live (jgwill/Miadi#930). */
     steeringRuntime?: RuntimeDeps;
+    /** Reads a video's captions for an approved create; the service passes youtubeCaptions, tests their own. */
+    captions?: FetchCaptions;
     /** Person-token attempts allowed per address in 15 minutes on each sign-in form (default 30). */
     tokenAttemptsPerWindow?: number;
     /** Where decision events go (default: one JSON line on stdout, the service journal); tests collect them (jgwill/Miadi#924). */

package/dist/server.js

@@ -5,7 +5,7 @@ import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/
 import { mcpAuthRouter, createOAuthMetadata, getOAuthProtectedResourceMetadataUrl } from "@modelcontextprotocol/sdk/server/auth/router.js";
 import { requireBearerAuth } from "@modelcontextprotocol/sdk/server/auth/middleware/bearerAuth.js";
 import { MiadiOAuthProvider, SCOPES, SCOPE_CONTRIBUTE, SCOPE_READ, emptyOAuthState } from "./oauth.js";
-import { reconcileInterrupted, registerApprovalRoutes, registerProviderPolicyRoutes } from "./approve.js";
+import { reconcileInterrupted, registerApprovalRoutes, registerProviderPolicyRoutes, startTranscriptSettling } from "./approve.js";
 import { DecisionTokens } from "./decisions.js";
 import { JsonFile, Ledger, ensureStateDir, statePaths } from "./store.js";
 import { registerTools } from "./tools.js";
@@ -80,10 +80,12 @@ export function createConnectorApp(config, deps) {
         tmux: deps.tmux,
         steerSettleMs: deps.steerSettleMs,
         ...(deps.steeringRuntime ? { steeringRuntime: deps.steeringRuntime } : {}),
+        ...(deps.captions ? { captions: deps.captions } : {}),
         log: deps.log,
     };
     // A run the connector was recording when it last stopped is failed now, so a person may run it again (#924).
     reconcileInterrupted(approvalDeps);
+    startTranscriptSettling(approvalDeps);
     registerApprovalRoutes(app, approvalDeps);
     registerProviderPolicyRoutes(app, approvalDeps);
     const decisionTokens = new DecisionTokens(config.stateDir, config.decisionTokenTtl);

package/dist/tools.js

@@ -1066,7 +1066,16 @@ export function registerTools(server, ctx) {
             const r = await reviews.get(reviewId);
             if (!r)
                 return { id, state: "not_found" };
-            return { id, title: r.title, text: r.version?.markdown ?? "", url: `${config.reviewUrl}/review/${reviewId}`, metadata: { latest_version: r.latest_version, video_id: r.video_id } };
+            // The review's stored transcript comes with it, so the agent that asked for the review can read what was said.
+            const turns = Array.isArray(r.transcript?.turns) ? r.transcript.turns : [];
+            const said = turns.map((t) => `${t.at ? `[${t.at}] ` : ""}${t.speaker || t.label ? `${t.speaker || t.label}: ` : ""}${t.text}`).join("\n\n");
+            return {
+                id,
+                title: r.title,
+                text: `${r.version?.markdown ?? ""}${said ? `\n\n## Transcript\n\n${said}\n` : ""}`,
+                url: `${config.reviewUrl}/review/${reviewId}`,
+                metadata: { latest_version: r.latest_version, video_id: r.video_id, has_transcript: Boolean(said), ...(r.transcript?.source ? { transcript_source: r.transcript.source } : {}) },
+            };
         }
         const rec = records().find((x) => x.id === id);
         if (!rec)
@@ -1946,7 +1955,7 @@ export function registerTools(server, ctx) {
     }));
     server.registerTool("request_review_operation", {
         title: "Request a review operation",
-        description: "Ask for one review-service operation: create (a review from a YouTube URL), import_markdown (a hand-written version), new_version (regenerate), store_transcript. It waits for a person's approval; check review_lookup first so nothing is duplicated.",
+        description: "Ask for one review-service operation: create (a review from a YouTube URL; once approved it also stores the video's YouTube captions as the review's transcript, with no model call), import_markdown (a hand-written version), new_version (regenerate), store_transcript. It waits for a person's approval; check review_lookup first so nothing is duplicated.",
         inputSchema: {
             operation: z.enum(["create", "import_markdown", "new_version", "store_transcript"]),
             review_id: z.string().optional(),
@@ -2290,7 +2299,7 @@ export function registerTools(server, ctx) {
                 created_at: r.created_at,
                 circle: r.circle,
                 intention: r.intention,
-                consequence: consequenceOf(r, providerAuthorizationOf(r)),
+                consequence: consequenceOf(r, providerAuthorizationOf(r), records()),
                 detail: detailOf(r),
                 ...(r.kind === "run_request" || r.kind === "work_proposal"
                     ? {
@@ -2513,7 +2522,7 @@ export const TOOL_STATUS = {
     supersede_pending_requests: "live, contribute (retires named earlier requests still waiting and joins them as earlier versions of the one that stands)",
     request_session_steer: "live, contribute, write tier (one correction to a working agent, forwarded to its runtime; runs inside an approved run's steering grant, else one scoped human decision; get_capabilities.steering says whether the transport works now and which providers have an adapter)",
     revoke_session_steering: "live, contribute, write tier (stops a run's steering, or one steer not yet consumed)",
-    request_review_operation: "live, contribute, needs_approval",
+    request_review_operation: "live, contribute, needs_approval (create also stores the video's YouTube captions as the review's transcript, no model call)",
     request_screenwalk_reading: "live, contribute, needs_approval (host provider adapter required; stops at editorial decision)",
     request_reading_import: "live, contribute, needs_approval (exact public import; atomic service contract required)",
     request_deep_diver: "live, contribute, needs_approval",

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "0.1.22";
+export declare const VERSION = "0.1.24";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = "0.1.22";
+export const VERSION = "0.1.24";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miadi/connector",
-  "version": "0.1.22",
+  "version": "0.1.24",
   "description": "The Miadi connector: one remote MCP service through which a person signed in with their Miadi person token, from ChatGPT or any MCP client, reads sessions, reviews, episodes and circles and records observations, inquiries, handoffs and proposals with their name on each record.",
   "license": "MIT",
   "author": "Miadi",