toolroll 0.9.84 → 0.9.86

package/dist/browser-workspace.d.ts

@@ -198,6 +198,12 @@ export type BrowserTasksView = {
         detail: string | null;
         problem: string | null;
         notes: string[];
+        /** Put away, or Restore in Archived (task-tidy.md): a POST to the task's own route; null for a viewer or live work. */
+        tidy?: {
+            action: string;
+            label: 'Put away' | 'Restore';
+            returnTo: string;
+        } | null;
     }[];
     empty: {
         text: string;
@@ -209,6 +215,8 @@ export type BrowserTasksView = {
     };
     tools: BrowserLink[];
     newTask: BrowserLink;
+    /** Put away old tasks (an approver's): the preview page. */
+    putAway?: BrowserLink | null;
     /** v105: subscription windows and monthly budgets, one tile each (an instance operator's; null when there are none). */
     limits: BrowserLimits | null;
     /** The stored-state filter (Any state, Queued, Running, Done, Failed, Cancelled), each a real link starting on page one. */
@@ -449,6 +457,15 @@ export type BrowserTaskView = {
         label: string;
         current: BrowserLink;
     } | null;
+    /** Put away (task-tidy.md): "Archived by tidy: <why>", when, and Restore for an approver. */
+    archived?: {
+        words: string;
+        at: string;
+        restore: {
+            action: string;
+            returnTo: string;
+        } | null;
+    } | null;
     /** The status card; `statusHtml` stands in when no assignment projection exists. */
     status: AssignmentCard | null;
     statusHtml: string;
@@ -624,6 +641,10 @@ export type BrowserProjectRow = {
 };
 export type BrowserProjectsView = {
     kind: 'projects';
+    activity?: {
+        project: string;
+        report: import('./project-outcomes.js').ProjectOutcomes | null;
+    };
     /** Arrived from New task: choosing where the task belongs. */
     choosing: boolean;
     problem: string | null;
@@ -711,6 +732,7 @@ export type BrowserCheckItem = {
         src: string;
         href: string;
         caption: string;
+        image?: import("./result-review.js").FeedbackImage;
     }[];
 };
 /** The result's one decision: what Accept is called, why it isn't plain
@@ -972,6 +994,8 @@ export type BrowserFlowStage = {
     }[] | undefined;
     /** A Build zone in another project: its path. */
     repo?: string | undefined;
+    /** v144: a script zone that starts a browser (Playwright's Chromium); it runs only once a person allows browser use for the flow. */
+    browser?: true | undefined;
     next: string | null;
     onFail: string | null;
 };
@@ -995,6 +1019,8 @@ export type BrowserFlowCard = {
     stage: string;
     state: "active" | "done" | "cancelled";
     waiting: string | null;
+    /** It waits because browser use isn't allowed for the flow (flow-browser.ts): the card offers Allow browser. */
+    browserWait?: true;
     task: {
         id: string;
         href: string;
@@ -1289,6 +1315,25 @@ export type BrowserFlowView = {
         }[];
         schedulesDigest: string;
     };
+    /** Browser use (flow-browser.ts browserViewOf): null when no zone says it starts a browser. */
+    browser: {
+        status: "allowed" | "ended" | "none";
+        words: string;
+        signedBy: string | null;
+        signedAt: string | null;
+        zones: {
+            zone: string;
+            title: string;
+            script: string;
+            version: number;
+            digest: string;
+        }[];
+        terms: string[];
+        digest: string | null;
+        problem: string | null;
+        /** Whether this person may allow it here: an approver whose account reaches every project (as the route requires). */
+        canApprove: boolean;
+    } | null;
     approvers: string[];
     /** The projects a Build zone may work in: the flow's own first, then others the viewer can reach. */
     projects?: {

package/dist/chat-actions.d.ts

@@ -153,6 +153,16 @@ export declare const CHAT_ACTIONS: {
         readonly protected: false;
         readonly password: false;
     };
+    readonly flow_browser: {
+        readonly label: "Allow browser";
+        readonly protected: true;
+        readonly password: true;
+    };
+    readonly flow_browser_off: {
+        readonly label: "Turn off browser";
+        readonly protected: false;
+        readonly password: false;
+    };
     readonly subagent_create: {
         readonly label: "Add subagent";
         readonly protected: false;
@@ -266,7 +276,7 @@ export declare function sharedActionReviewPath(id: number): string;
 export declare function mintSharedActionReview(store: Store, who: VerifiedApprover, id: number, root: string, now: Date): {
     payload: {
         version: 1;
-        operation: "decision_record" | "decision_retire" | "flow_card_add" | "flow_card_approve" | "flow_card_assign" | "flow_card_cancel" | "flow_card_choose" | "flow_card_comment" | "flow_card_move" | "flow_card_send_back" | "flow_card_watch" | "flow_create" | "flow_edit" | "flow_script_save" | "flow_starter" | "flow_trigger_add" | "flow_trigger_pause" | "flow_trigger_remove" | "flow_trigger_resume" | "kit_setup" | "knowledge_instructions" | "knowledge_remove" | "knowledge_restore" | "knowledge_save" | "lead_about_you" | "result_accept" | "scope_approve" | "skill_disable" | "skill_enable" | "skill_import" | "skill_restore" | "skill_test" | "subagent_answer" | "subagent_ask" | "subagent_create" | "subagent_memory" | "subagent_note" | "subagent_routine" | "subagent_soul" | "subagent_state" | "subagent_tools" | "subagent_undo" | "sweep_cancel_rest" | "sweep_file" | "task_cancel" | "task_resume" | "tool_add" | "tool_remove";
+        operation: "decision_record" | "decision_retire" | "flow_browser" | "flow_browser_off" | "flow_card_add" | "flow_card_approve" | "flow_card_assign" | "flow_card_cancel" | "flow_card_choose" | "flow_card_comment" | "flow_card_move" | "flow_card_send_back" | "flow_card_watch" | "flow_create" | "flow_edit" | "flow_script_save" | "flow_starter" | "flow_trigger_add" | "flow_trigger_pause" | "flow_trigger_remove" | "flow_trigger_resume" | "kit_setup" | "knowledge_instructions" | "knowledge_remove" | "knowledge_restore" | "knowledge_save" | "lead_about_you" | "result_accept" | "scope_approve" | "skill_disable" | "skill_enable" | "skill_import" | "skill_restore" | "skill_test" | "subagent_answer" | "subagent_ask" | "subagent_create" | "subagent_memory" | "subagent_note" | "subagent_routine" | "subagent_soul" | "subagent_state" | "subagent_tools" | "subagent_undo" | "sweep_cancel_rest" | "sweep_file" | "task_cancel" | "task_resume" | "tool_add" | "tool_remove";
         request: {
             [x: string]: unknown;
         };

package/dist/chat-actions.js

@@ -25,6 +25,7 @@ import { saveScript, scriptDigest, validateScript } from "./flow-scripts.js";
 import { addCardToFlow, advanceFlows, cancelFlowCard, crossProjectProblem, decideFlowCard, flowCardHref, flowCardText, flowDefinitionOf, moveCardInFlow } from "./flow-engine.js";
 import { chooseFlowCard, flowPersonOf } from "./flow-send.js";
 import { assignFlowCard, commentOnFlowCard, flowPeople, mentionsIn, watchFlowCard } from "./flow-people.js";
+import { browserViewOf, liveBrowserGrant, revokeFlowBrowser, signFlowBrowser } from "./flow-browser.js";
 import { addFlowTriggerTo, describeTrigger, readLinearKey, removeFlowTrigger, takesDeliveries, triggerConfigOf, validateTriggerConfig } from "./flow-triggers.js";
 import { describeSchedule, parseSchedule } from "./flow-schedule.js";
 import { dirname } from "node:path";
@@ -109,6 +110,10 @@ export const CHAT_ACTIONS = {
     flow_trigger_pause: { label: "Pause trigger", protected: false, password: false },
     flow_trigger_resume: { label: "Turn trigger on", protected: false, password: false },
     flow_trigger_remove: { label: "Remove trigger", protected: false, password: false },
+    // Browser use widens a flow's sandbox (flow-browser.ts): the lead may only propose it; a person allows it with their
+    // own password on the secure screen, never on a chat card or a paired phone's tap. Turning it off lowers authority.
+    flow_browser: { label: "Allow browser", protected: true, password: true },
+    flow_browser_off: { label: "Turn off browser", protected: false, password: false },
     subagent_create: { label: "Add subagent", protected: false, password: false },
     subagent_soul: { label: "Update soul file", protected: false, password: false },
     subagent_state: { label: "Change subagent", protected: false, password: false },
@@ -710,6 +715,32 @@ export function prepareSharedAction(store, who, operation, input, root, now = ne
                 terms.push("Only what happens from now on counts; nothing already there is added.");
             terms.push("Work a card starts still waits for your usual approvals.");
         }
+        else if (operation === "flow_browser" || operation === "flow_browser_off") {
+            const { flow } = flowTarget;
+            const view = browserViewOf(store, flow);
+            if (view === null)
+                throw Error(`No zone in ${flow.name} says it starts a browser. Mark its script zone first (edit the flow), then propose this.`);
+            // As on the flow page (route table: instance access), a project-limited account can't allow browser use.
+            if (operation === "flow_browser" && store.accountOf(who.name)?.projects !== null)
+                throw Error("Allowing browser use needs an account with access to every project.");
+            if (operation === "flow_browser_off") {
+                if (liveBrowserGrant(store, flow.id) === null)
+                    throw Error(`Browser use isn't allowed for ${flow.name}.`);
+                state = { flow: flow.id, grant: liveBrowserGrant(store, flow.id).id };
+                title = `Turn off browser use in ${flow.name}`;
+                terms.push(`${flow.name}'s browser zones stop and wait until a person allows browser use again.`);
+            }
+            else {
+                if (view.status === "allowed")
+                    throw Error(`${view.words}.`);
+                if (view.digest === null)
+                    throw Error(view.problem ?? "This flow's browser zones can't be approved as they are.");
+                // The approval the person reads and the one their password signs: the digest is re-derived when they confirm.
+                state = { flow: flow.id, revision: flow.revision, digest: view.digest };
+                title = `Allow browser use in ${flow.name}`;
+                terms.push(`Flow: ${flow.name} · project ${project}`, ...view.zones.map(zone => `${zone.title} runs ${zone.script} v${zone.version}\nScript digest ${zone.digest}`), "Each run of these zones starts a headless Chromium.", ...view.terms, `Approval digest ${view.digest}`);
+            }
+        }
         else if (operation === "flow_trigger_pause" || operation === "flow_trigger_resume" || operation === "flow_trigger_remove") {
             const { flow, trigger } = flowTarget;
             const config = trigger === null ? null : triggerConfigOf(trigger);
@@ -1099,6 +1130,7 @@ export function executeSharedAction(store, who, id, payload, now, options) {
     }
     // The review nonce was minted against the saved proposal's stamp: it is checked against that, whoever reviews.
     const savedStamp = payload.stamp;
+    let personProved = null;
     payload = live;
     const config = CHAT_ACTIONS[live.operation], req = live.request;
     const challenged = options.via !== "web" &&
@@ -1113,10 +1145,14 @@ export function executeSharedAction(store, who, id, payload, now, options) {
         // A scope approval proves its person inside approve() (one transaction with the seal, under the same freshness
         // rule as the task page); here an empty field is only looked at, never spent (an explicit re-check is one-use).
         const emptyApproval = payload.operation === "scope_approve" && options.review.password === "";
+        const proved = config.password && !emptyApproval ? authenticateApprover(store, who.name, options.review.password, payload.repo) : null;
+        // How the person was proved, for an approval that records it (browser use: flow-browser.ts refuses any but a person's).
+        if (proved?.ok === true)
+            personProved = proved.method;
         if (config.password &&
             (emptyApproval
                 ? !passwordlessSessionFor(store, who.name) && !ssoNowAvailable(who.name) && withFreshness("approve-standard", () => freshnessFor(who.name)) === null
-                : !authenticateApprover(store, who.name, options.review.password, payload.repo).ok))
+                : proved?.ok !== true))
             return refuse("needs-confirm", "Confirm with your password in the secure screen.");
     }
     try {
@@ -1156,6 +1192,22 @@ export function executeSharedAction(store, who, id, payload, now, options) {
                         ? {}
                         : { restore: Number(req["restore"]) }),
                 }, now);
+            else if (payload.operation === "flow_browser") {
+                // Only through the secure screen with the person's own password (protected + password above); signFlowBrowser
+                // re-reads the flow, its zones and scripts in this transaction and refuses unless they are what the card showed.
+                const flow = Number(payload.state["flow"]);
+                // signFlowBrowser re-reads the account's generation and reach in its transaction (it may have narrowed since).
+                const signed = signFlowBrowser(store, { flow, signer: actor, proof: personProved, sawDigest: String(payload.state["digest"] ?? ""), console: { generation: who.generation } }, now);
+                if (!signed.ok)
+                    throw Error(signed.message);
+                return { ok: true, taskId: null, said: "Browser allowed. Its browser zones can start Chromium now.", href: `/flows/${flow}` };
+            }
+            else if (payload.operation === "flow_browser_off") {
+                const flow = Number(payload.state["flow"]);
+                if (!revokeFlowBrowser(store, flow, actor, now))
+                    throw Error("Browser use was already off.");
+                return { ok: true, taskId: null, said: "Browser turned off. Its browser zones wait until someone allows it again.", href: `/flows/${flow}` };
+            }
             else if (payload.operation.startsWith("flow_")) {
                 const done = runFlowAction(store, payload, actor, who.repos, options.root, now);
                 return { ok: true, taskId: null, said: done.said, href: done.href };

package/dist/chat-channel.d.ts

@@ -1,3 +1,4 @@
+import { type FeedbackImage } from "./result-review.js";
 import type { DoorOutcome } from "./lead-doors.js";
 import { type VerifiedApprover } from "./principal.js";
 import type { ChatConfig, LeadProposal, LeadSession, LeadThread, Store, SubscriptionChatProviderId } from "./store.js";
@@ -40,7 +41,7 @@ export declare function tooLongText(length: number): string;
 /** A reply to a message about several tasks is never guessed: it names them and says how to choose. */
 export declare function whichTaskText(titles: readonly string[]): string;
 /** The server-authored context a reply to a result message carries into the turn — the exact execution and run, never a guess. */
-export declare function replyContextFor(taskId: string, run: number | null): string;
+export declare function replyContextFor(taskId: string, run: number | null, image?: FeedbackImage): string;
 /** The context a chosen task (/tasks, /task <name>) carries into each turn from that chat. */
 export declare function focusContextFor(taskId: string): string;
 /** No trusted https origin is configured: one honest line, no localhost, no promise. */
@@ -69,6 +70,14 @@ export declare function armedCardText(proposal: LeadProposal, previewText: strin
 /** The "yes" button's label for an armed card. */
 export declare function armedYesLabel(proposal: LeadProposal): string;
 export declare function proposalLink(store: Store, proposal: LeadProposal, repos: readonly string[], channel?: ChatChannelName | null): PhoneLink | null;
+/** The personal Telegram card: the shared preview, or a handoff to the lead conversation when it cannot be shown in full. */
+export declare function phoneProposalPreview(store: Store, proposal: LeadProposal, repos: readonly string[]): {
+    text: string;
+    buttons: boolean;
+    closed?: true;
+};
+/** The personal Telegram card's link: the lead conversation holding a card too long to show, else the shared link. */
+export declare function phoneProposalLink(store: Store, proposal: LeadProposal, repos: readonly string[], channel?: ChatChannelName | null): PhoneLink | null;
 /**
  * The link a CONFIRMED card carries: the exact recorded task the outcome
  * names, where its remaining step lives — the approval control while the

package/dist/chat-channel.js

@@ -1,6 +1,7 @@
+import { parseFeedbackImage } from "./result-review.js";
 /** Shared membership-chat identity, proposal previews and result links. Transport adapters never grant authority. */
 import { FLOW_HREF } from "./flow-engine.js";
-import { closedQuestionWords } from "./decision.js";
+import { closedQuestionWords, LIMITS } from "./decision.js";
 import { createHash } from "node:crypto";
 import { sharedActionPayload, sharedActionNeedsReview, sharedActionReviewPath, sharedActionAllowsChallenge, CHAT_ACTIONS, } from "./chat-actions.js";
 import { isDirectChatProvider, subscriptionCredentialKey } from "./converse.js";
@@ -132,12 +133,13 @@ export function whichTaskText(titles) {
     ].join("\n");
 }
 /** The server-authored context a reply to a result message carries into the turn — the exact execution and run, never a guess. */
-export function replyContextFor(taskId, run) {
+export function replyContextFor(taskId, run, image) {
     return [
         `Current task: ${taskId}. Read it with get_task before answering or proposing changes. Read its currentExecution next and bind new actions to that exact execution. Never replace the target of a prior proposal with a newer revision. Keep this turn about that task unless the operator explicitly asks to broaden it.`,
         run === null
             ? `The operator is replying to a message about execution ${taskId}.`
             : `The operator is replying to result #${run} from execution ${taskId}. Use get_result for that exact execution and run when responding to feedback; do not substitute another result. If the operator asks for changes, use propose_review revise; use note only when they explicitly ask to save feedback without starting work.`,
+        ...(image === undefined ? [] : [`The reply targets screenshot ${image.artifact} on result #${image.run}. Retain image: ${image.artifact} in propose_review so the exact screenshot stays with new feedback; pass image: null only when the feedback is not about it. Read get_result_images for this result first.`]),
     ].join(" ");
 }
 /** The context a chosen task (/tasks, /task <name>) carries into each turn from that chat. */
@@ -146,6 +148,10 @@ export function focusContextFor(taskId) {
 }
 /** A step the phone cannot take itself: said once; the button (or its absence) says where. */
 const HANDOFF = "This step finishes in Toolroll.";
+/** One Telegram message; a card that cannot fit is never confirmed from a shortened copy. */
+const TELEGRAM_TEXT_MAX = 4_096;
+const PHONE_TOO_LONG = "This is too long to show in full here. It is waiting in your Toolroll chat to review and confirm.";
+const LEAD_CHAT_LINK = { label: "Open chat", path: "/chat" };
 /** No trusted https origin is configured: one honest line, no localhost, no promise. */
 export const NO_PHONE_LINK = "Phone access isn't configured. Open Toolroll on your computer.";
 /** An origin exists but the card's task is not one this phone may reach now: said as that, never as missing setup. */
@@ -229,6 +235,23 @@ export function proposalLink(store, proposal, repos, channel = null) {
     }
     return null;
 }
+/** A personal Telegram card fits one message, or it waits, whole, in the person's lead conversation in Toolroll. */
+function fitsPhone(preview) {
+    return !preview.buttons || preview.text.length <= TELEGRAM_TEXT_MAX;
+}
+/** The personal Telegram card: the shared preview, or a handoff to the lead conversation when it cannot be shown in full. */
+export function phoneProposalPreview(store, proposal, repos) {
+    const preview = proposalPreview(store, proposal, repos, "telegram");
+    return fitsPhone(preview)
+        ? preview
+        : { text: [preview.text.split("\n")[0], PHONE_TOO_LONG, "", HANDOFF].join("\n"), buttons: false };
+}
+/** The personal Telegram card's link: the lead conversation holding a card too long to show, else the shared link. */
+export function phoneProposalLink(store, proposal, repos, channel = null) {
+    return fitsPhone(proposalPreview(store, proposal, repos, "telegram"))
+        ? proposalLink(store, proposal, repos, channel)
+        : LEAD_CHAT_LINK;
+}
 /**
  * The link a CONFIRMED card carries: the exact recorded task the outcome
  * names, where its remaining step lives — the approval control while the
@@ -410,20 +433,22 @@ export function proposalPreview(store, proposal, repos, channel = null) {
                 ? payload["notes"]
                 : [];
             const saved = (snapshot?.notes ?? []).filter((one) => selected.includes(one.id));
-            const note = t("note", 1_000);
+            const note = t("note", LIMITS.note);
+            const image = parseFeedbackImage(payload["image"]);
             const path = t("path", 300);
             return card(`${revise ? "Request changes to" : "Save feedback on"} result #${String(payload["run"] ?? "?")} of ${taskName}`, [
                 ...(note === ""
                     ? []
                     : [
                         `Your feedback${path === "" ? "" : ` (${path}${typeof payload["line"] === "number" ? `:${payload["line"]}` : ""})`}:`,
-                        ...lines(note, 1_000),
+                        ...(image ? [`Screenshot ${image.artifact} · result #${image.run}`] : []),
+                        ...lines(note, LIMITS.note),
                     ]),
                 ...(saved.length === 0
                     ? []
                     : [
                         "Saved notes included:",
-                        ...saved.map((one) => `• ${one.path === null ? "" : `${phoneText(one.path, 120)}${one.line === null ? "" : `:${one.line}`}: `}${phoneText(one.note, 300)}`),
+                        ...saved.map((one) => `• ${one.image ? `Screenshot ${one.image.artifact} · result #${one.image.run}: ` : ""}${one.path === null ? "" : `${phoneText(one.path, 120)}${one.line === null ? "" : `:${one.line}`}: `}${phoneText(one.note, LIMITS.note)}`),
                     ]),
             ], revise
                 ? "Creates a revision of the same task. Its approval follows your settings."
@@ -484,6 +509,11 @@ export const CHAT_ACTION_PARITY = {
         how: "Reads current tasks, decisions, results and project knowledge from the local database through the shared engine, within the enrolled projects.",
         gap: "Dedicated Telegram and Slack journeys for this tool and live channel rendering remain unverified.",
     },
+    get_project_activity: {
+        support: "direct",
+        how: "Reads the project's Ready backlog, finished-to-decision elapsed time, explicit revisions and recorded cost for completed families in an accessible enrolled project through the shared engine.",
+        gap: "Dedicated Telegram and Slack journeys for this tool and live channel rendering remain unverified.",
+    },
     get_project_context: {
         support: "direct",
         how: "Reads bounded source excerpts or advisory import impact in an accessible enrolled project through the shared engine, with source-search fallback when its index is unavailable.",
@@ -548,6 +578,7 @@ export const CHAT_ACTION_PARITY = {
     ask_owner: { support: "direct", how: "One question with 2-4 options and Something else, drawn as buttons under the reply; the tapped option is sent as the person's next message.", gap: null },
     search_project_memory: { support: "direct", how: "Read during a turn: one search over decisions, references, lessons and the conversations the person may read.", gap: null },
     list_tasks: { support: "direct", how: "Read during a turn.", gap: null },
+    tidy_preview: { support: "direct", how: "Read during a turn: what Put away old tasks would put away now and why. Only a person puts tasks away, on the console or with the CLI command it names.", gap: null },
     get_task: {
         support: "direct",
         how: "Read during a turn; a reply to a result message pins the exact execution.",

package/dist/chat-decide.d.ts

@@ -4,6 +4,8 @@ import { type VerifiedApprover } from "./principal.js";
 import type { Scope } from "./scope.js";
 import { type ReleaseCard } from "./release-card.js";
 import type { Store } from "./store.js";
+import { permissionPlainWords } from "./chat-terms.js";
+export { permissionPlainWords };
 /** The tokens live in chat_decide_action and the open "What should change?" in chat_decide_prompt (store.ts). */
 export type DecideAct = (typeof DECIDE_ACTS)[number];
 export type DecideTarget = {
@@ -20,6 +22,11 @@ export type DecideTarget = {
     kind: "merge";
     taskId: string;
     run: number;
+}
+/** The tasks one youiyoux pass filed (youiyoux-intake.ts), named by any one of them. */
+ | {
+    kind: "requests";
+    taskId: string;
 };
 export type DecideChannel = "telegram" | "slack" | "discord" | "teams";
 /** Who is tapping, where: one paired person's binding on one channel, and the chat the card is in. */
@@ -56,11 +63,13 @@ export declare const DECIDE_LABELS: {
     readonly cancel: "Cancel";
 };
 export declare const WHAT_SHOULD_CHANGE = "What should change?";
+/** `taskId`: the task the button acts on, when it isn't the card's own (a youiyoux card's one-task Approve). */
 type ActSpec = {
     act: DecideAct;
     run: number | null;
     digest: string;
     label?: string;
+    taskId?: string;
 };
 /** What a card offers: an optional replacement text (the plan card) and rows of acts and links; a release card also
  * sends its full terms as a file with it (`file`), where the chat app can. */
@@ -85,11 +94,11 @@ export declare function chatApproveMode(store: Store, repo: string | null, appro
     ok: false;
     why: string;
 };
-/** What a plan's yes allows an agent to do, in a few plain words (the approval sheet's "You're allowing"). */
-export declare function permissionPlainWords(profile: Scope["profile"] | null | undefined): string | null;
 /** A plan this person's chat may approve now: the term, the plan's exact bytes, and none of the reasons it must open
  * Toolroll instead. `digest` binds the scope and the plan document the card shows. */
-export declare function planInChat(store: Store, taskId: string, approver: string, now: Date, channel: DecideChannel, root?: string): {
+export declare function planInChat(store: Store, taskId: string, approver: string, now: Date, channel: DecideChannel, root?: string, 
+/** A youiyoux card asking (requestsOffer): its own words are checked there, every one shown. */
+from?: "requests"): {
     ok: true;
     modeDigest: string;
     source: "setting" | "mode";
@@ -109,6 +118,10 @@ export declare function mergeInChat(store: Store, taskId: string, run: number, a
     ok: false;
     why: string;
 };
+/** Whether a card's words arrive as one message that shows each of them as written: within Telegram's part, Slack's and
+ * (after its escapes) Discord's limits, with room for the question a tap adds. Teams draws card text as Markdown, where
+ * a link's label hides its address, and Slack turns `:name:` into an emoji: there such words never approve. */
+export declare function shownWhole(text: string, channel: DecideChannel): boolean;
 /** The plan card: title, goal in two lines, what changes, done when, and what the yes allows. On Telegram the yes's
  * terms come second, under the title, and the steps are fewer: the full plan is behind Edit. */
 export declare function planCardText(store: Store, taskId: string, scope: Scope, root?: string, channel?: DecideChannel): string;
@@ -260,4 +273,3 @@ export declare function decideTargetOf(row: {
     taskId: string | null;
     run: number | null;
 }): DecideTarget | null;
-export {};