@graview/primitives 0.1.63 → 0.1.65

package/dist/quick-ask-plan.js

@@ -0,0 +1,112 @@
+import { nounOf, pluralOf, Store } from "@graview/core";
+import { planEdits } from "@graview/core/catalog";
+const capital = (words) => words.charAt(0).toUpperCase() + words.slice(1);
+const vowel = (word) => /^(?:[aeio]|u(?![sn]i|se|ser))/i.test(word);
+const slug = (words) => words.toLowerCase().normalize("NFKD").replace(/[̀-ͯ]/g, "").replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "one";
+const range = (from, to) => (from === to ? `step ${from}` : `steps ${from}–${to}`);
+/** The app's kinds as a document reads them, for an app declared in code with none remembered: their words, fields and links, no acts. */
+function documentOfSchema(env) {
+    const schema = env.store.schema;
+    const kinds = Object.fromEntries(schema.definitions.map((definition) => [
+        definition.kind,
+        { noun: nounOf(definition, definition.kind), plural: pluralOf(schema, definition.kind), fields: Object.fromEntries(Object.keys(definition.fields.shape ?? {}).map((field) => [field, { type: "string" }])), edges: definition.edges ?? {} },
+    ]));
+    return { name: env.app.name ?? "app", kinds, acts: {} };
+}
+/** Who may change the app, in words: the roles every act is granted to ("an owner"), else whoever may. */
+function whoMayChange(env) {
+    const owners = (env.store.policy?.grants ?? []).filter((grant) => grant.mutations === "*" && !grant.self && grant.roles !== "*").flatMap((grant) => grant.roles);
+    const named = [...new Set(owners)];
+    return named.length > 0 ? `${vowel(named[0]) ? "an" : "a"} ${named.join(" or ")}` : "whoever may change this app";
+}
+/** The place the list is, as the steps say it: "in This week", else "here". */
+function whereOf(env) {
+    const place = env.place ? env.places.find((one) => one.as === env.place) : undefined;
+    return place ? `in ${place.title}` : "here";
+}
+/** The plan for a missing capability, or a refusal in words when it could not be composed or would fail. */
+export async function planFor(env, options) {
+    const { missing } = options;
+    if (!missing.need)
+        return { refused: missing.said };
+    const reshape = await import("@graview/tools/reshape");
+    const remembered = reshape.documentOfApp(env.app);
+    const document = remembered ?? documentOfSchema(env);
+    const planned = planEdits(document, missing.need);
+    if ("refused" in planned)
+        return { refused: `${missing.said} ${planned.refused}` };
+    const steps = planned.steps.map((said) => ({ part: "app", said }));
+    const appSteps = steps.length;
+    /* THE RECORDS THE PLAN ACTS ON are of the kind it changes: a list given where its tasks were meant is retargeted by code to the records it holds, never refused in words. */
+    const ofKind = (ids) => ids.filter((id) => env.store.graph.getNode(id)?.kind === planned.on);
+    const heldOfKind = (id) => [...env.store.graph.in(id), ...env.store.graph.out(id)].filter((node) => node.kind === planned.on).map((node) => node.id);
+    const members = ofKind(options.members).length > 0 ? ofKind(options.members) : [...new Set(options.members.flatMap(heldOfKind))];
+    /* THE RECORDS THAT FINISH THE ASK, each said as it will happen. */
+    const records = [];
+    const count = members.length;
+    const kindDoc = (kind) => document.kinds[kind] ?? undefined;
+    const plural = (kind) => (kindDoc(kind)?.plural ?? `${kindDoc(kind)?.noun ?? kind}s`).toLowerCase();
+    const noun = (kind) => (kindDoc(kind)?.noun ?? kind).toLowerCase();
+    const where = options.where ? `in ${options.where}` : whereOf(env);
+    if (count === 0)
+        return { refused: `${missing.said} There is nothing here to do it to.` };
+    const these = count === 1 ? `the ${noun(planned.on)} ${where}` : `the ${count} ${plural(planned.on)} ${where}`;
+    const called = capital(planned.called);
+    if (planned.relation && planned.to) {
+        const who = missing.who;
+        if (!who)
+            return { refused: `${missing.said} Say whom to give them to.` };
+        const toPlural = planned.made ? capital(planned.edits[0].plural ?? "people") : capital(plural(planned.to));
+        const found = planned.made ? undefined : env.store.graph.allNodes().find((node) => node.kind === planned.to && Object.values(node).some((value) => typeof value === "string" && value.toLowerCase() === who.toLowerCase()));
+        let whom = found?.id;
+        if (!whom) {
+            whom = `${planned.to}-${slug(who)}`;
+            const makes = planned.makes ?? env.store.allMutations().find((mutation) => mutation.creates?.includes(planned.to))?.name;
+            if (!makes) {
+                const some = env.store.graph.allNodes().filter((node) => node.kind === planned.to).slice(0, 3).map((node) => String(node["label"] ?? node["name"] ?? "")).filter(Boolean);
+                return { refused: `${missing.said} There is nobody called ${who} among the ${toPlural.toLowerCase()} here${some.length > 0 ? ` (${some.join(", ")})` : ""}, and no way to add one from here.` };
+            }
+            records.push({ name: makes, args: { name: who }, mintedHint: whom });
+            steps.push({ part: "record", said: `Add ${who} to ${toPlural}.` });
+        }
+        for (const id of members)
+            records.push({ name: planned.act, args: { id, [planned.arg]: whom } });
+        // "assigned to" → "Assign Nick to the 5 tasks in This week."; any other link, said as setting it.
+        const verb = /^(\w+?)ed to$/i.exec(planned.called)?.[1];
+        steps.push({ part: "record", said: verb ? `${capital(verb.toLowerCase())} ${who} to ${these}.` : `Set “${called}” to ${who} on ${these}.` });
+    }
+    else if (planned.field) {
+        const value = missing.value;
+        if (value === undefined)
+            return { refused: `${missing.said} Say what to set it to.` };
+        for (const id of members)
+            records.push({ name: planned.act, args: { id, [planned.arg]: value } });
+        steps.push({ part: "record", said: `Set “${called}” to ${value} on ${these}.` });
+    }
+    const numbered = steps.length;
+    /* WHO MAKES THE FIRST STEPS: this seat, through the host — or, said once, whoever may. */
+    const may = Boolean(remembered) && options.host && options.compose !== undefined && reshape.mayChangeDeclaration(env.store, env.principal);
+    if (!may) {
+        const whoMay = !remembered ? "whoever develops this app" : !options.host || !options.compose ? "whoever hosts this app" : whoMayChange(env);
+        return { question: `${missing.said} ${capital(whoMay)} would add ${range(1, appSteps)}; then I can do ${range(appSteps + 1, numbered)}.`, parts: steps, whoMay };
+    }
+    /* COMPOSED AND REHEARSED WHOLE before it is offered: the changed app, judged by the checker, and these records in it, as this person. */
+    const composed = options.compose({ document: remembered, edits: planned.edits });
+    // A checker's sentence is never a person's: the change could not be made, said plainly.
+    if (!composed.ok)
+        return { refused: `${missing.said} That change could not be made here.` };
+    const app = composed.app;
+    try {
+        const scratch = new Store({ schema: app.schema, mutations: app.mutations ?? [], invariants: app.invariants ?? [], ...(app.policy ? { policy: app.policy } : {}), snapshot: env.store.graph.snapshot() });
+        scratch.previewAll(records, { author: env.principal });
+    }
+    catch {
+        return { refused: `${missing.said} I could not make that work here.` };
+    }
+    return {
+        question: `${missing.said} I can do it in ${numbered} steps. Should I?`,
+        parts: steps,
+        proposal: { said: options.said, add: [], drop: [], card: { said: steps.map((one) => one.said).join(" "), adds: [], keeps: [], drops: [], breaking: [] }, edits: planned.edits, records, via: `ai:${env.ai.name ?? "model"}` },
+    };
+}
+//# sourceMappingURL=quick-ask-plan.js.map

package/dist/quick-ask-plan.js.map

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

package/dist/quick-ask.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quick-ask.d.ts","sourceRoot":"","sources":["../src/quick-ask.tsx"],"names":[],"mappings":"AAUA,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEzE,OAAO,YAAY,CAAC;AAEpB;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAkCD,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,iBAAiB,+BAmVvE"}
+{"version":3,"file":"quick-ask.d.ts","sourceRoot":"","sources":["../src/quick-ask.tsx"],"names":[],"mappings":"AAUA,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAMzE,OAAO,YAAY,CAAC;AAiBpB;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAiED,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,iBAAiB,+BA2kBvE"}

package/dist/quick-ask.js

@@ -1,16 +1,63 @@
-import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
-import { layer, pluralOf } from "@graview/core";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { layer, nameOfAuthor, pluralOf } from "@graview/core";
 import { aiTargetOf, catalogOf, existingViewsOf, recordsOfTarget } from "@graview/core/catalog";
 import { search } from "@graview/core/search";
 import { useAiDeskState, useGraview } from "@graview/react/provider";
 import { applyAffordance, deriveAffordances, previewAffordance } from "@graview/tools/derive";
-import { answerHere, targetWords } from "@graview/tools/inline-ai";
+import { answerHere, plainly, targetWords } from "@graview/tools/inline-ai";
 import { useCallback, useEffect, useId, useLayoutEffect, useMemo, useRef, useState } from "react";
 import { askOf, drawPanel, GhostTray, takeOffer } from "./inline-ai-menu.js";
 import { useInlineEnv } from "./inline-ai-env.js";
 import { openQuickAsk } from "./quick-ask-desk.js";
 import { VISUALLY_HIDDEN } from "./primitives/measure.js";
+import { retryingImport } from "@graview/core/retry";
+import { lazyModule } from "@graview/react/provider";
 import "./frame.js"; // A door: tied to what the page drew first (TIED DOORS, packages/primitives/src/frame.ts).
+/*
+ * WHAT WAS TOLD, FETCHED APART (Roadmap f-menu-learns): the telling, its
+ * thumbs and the like ones that worked are a chunk of their own, asked for
+ * once the card is open and the page is idle, and only where the host keeps
+ * tellings — never in the way of the bar, the answer or its first paint.
+ */
+const toldCard = /* @__PURE__ */ lazyModule(retryingImport(() => import("./told-ui.js")));
+const Rate = /* @__PURE__ */ toldCard.part((module, props) => _jsx(module.RateTelling, { ...props }), { quiet: true });
+/** After the next paint: what is kept never holds up what is drawn. */
+const afterPaint = (run) => {
+    if (typeof requestAnimationFrame === "function")
+        requestAnimationFrame(() => setTimeout(run, 0));
+    else
+        setTimeout(run, 0);
+};
+const freshTellingId = () => `tl-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+/** Words in the follow-up that say yes, or no, to a plan the card asks about. */
+const YES = /^(yes|yep|yeah|sure|ok(ay)?|do it|go ahead|please do)\b/i;
+const NO = /^(no|nope|don'?t|not now|never ?mind)\b/i;
+/**
+ * THE RECORDS A LIST OR A PLACE SHOWS (Roadmap f-menu-type-anything): what
+ * "these" and "all the tasks in this list" mean — the ones drawn on the
+ * page, of the target's kind where it has one; on the scene, every record
+ * of the kind this reader may see.
+ */
+function membersOf(store, target, face) {
+    const kind = target.on === "list" ? target.kind : target.on === "lens" ? target.kind : undefined;
+    // A selection is those records; what a record holds the Fast slot reads from the graph (`decideOverTheGraph`).
+    if (target.on === "selection")
+        return target.ids;
+    if (target.on !== "list" && target.on !== "lens")
+        return [];
+    if (face === "pages" && typeof document !== "undefined") {
+        const ids = new Set();
+        for (const element of document.querySelectorAll("main [data-graview-listed], main [data-graview-record], main [data-graview-pick]")) {
+            const id = element.getAttribute("data-graview-listed") ?? element.getAttribute("data-graview-record") ?? element.getAttribute("data-graview-pick");
+            const node = id ? store.graph.getNode(id) : undefined;
+            if (id && node && (kind === undefined || node.kind === kind))
+                ids.add(id);
+        }
+        if (ids.size > 0)
+            return [...ids];
+    }
+    return kind ? store.graph.allNodes().filter((node) => node.kind === kind).map((node) => node.id) : [];
+}
 /** Words that say what kind of row is wanted, not which: "show", "go to", "open". */
 const LEADING = new Set(["show", "go", "to", "open", "the", "a", "an", "me"]);
 const folded = (text) => text.toLowerCase().normalize("NFKD").replace(/[̀-ͯ]/g, "");
@@ -28,7 +75,8 @@ const WIDTH = 360;
 const GAP = 12;
 export function QuickAskCard({ face, opening, close }) {
     const env = useInlineEnv();
-    const { setMenuAt } = useGraview();
+    const { setMenuAt, aiHere, session, people, seats, onProposeChange, composeChange } = useGraview();
+    const [planState, setPlanState] = useState({ state: "offered" });
     const target = useMemo(() => opening.target ?? aiTargetOf(opening.pointed ?? { about: [] }, (id) => env.store.graph.has(id)), [opening, env.store]);
     const about = useMemo(() => targetWords(env.store, target, env.places), [env.store, target, env.places]);
     const [words, setWords] = useState("");
@@ -37,16 +85,77 @@ export function QuickAskCard({ face, opening, close }) {
     const [said, setSaid] = useState(null);
     const pane = useRef(null);
     const field = useRef(null);
+    const mark = useRef(null);
     const list = useId();
     const live = useRef(true);
     const { ghost: held } = useAiDeskState(env.desk);
+    /* WHAT WAS TOLD (Roadmap f-menu-learns): this card's latest telling, kept with the host's door, and the watch on how it ends. */
+    const [telling, setTelling] = useState(null);
+    const told = useRef(null);
+    /* A change to this card's telling: handed on once it is kept, held until then. */
+    const toldSay = useCallback((change) => {
+        const now = told.current;
+        if (!now || !env.ai.told)
+            return;
+        if (now.kept && toldCard.current)
+            toldCard.current.changeTelling(env.ai.told, now.id, change);
+        else
+            now.queued = { ...now.queued, ...change };
+    }, [env.ai.told]);
+    /* Open, and the page idle: the telling's chunk and what the host has kept, so an Enter has its examples at hand without waiting. */
+    useEffect(() => {
+        const keeps = env.ai.told;
+        if (!keeps)
+            return;
+        const idle = globalThis;
+        const go = () => void toldCard.load().then((module) => module.toldListed(keeps), () => undefined);
+        if (idle.requestIdleCallback) {
+            const asked = idle.requestIdleCallback(go, { timeout: 1500 });
+            return () => idle.cancelIdleCallback?.(asked);
+        }
+        const later = setTimeout(go, 200);
+        return () => clearTimeout(later);
+    }, [env.ai.told]);
     useEffect(() => () => {
         live.current = false;
+        // Put away with nothing done: abandoned — unless a change it proposed still waits on the tray, whose answer the watch hears.
+        const last = told.current;
+        const waitingOn = env.desk.get().ghost;
+        if (last && !(waitingOn && waitingOn.ghost.interaction === last.interaction && waitingOn.batch === undefined))
+            toldSay({ outcome: "abandoned" });
         // Put away with a change still proposed on it: the change waits on the tray at the foot instead.
         const waiting = env.desk.get().ghost;
         if (waiting?.onCard)
             env.desk.setGhost({ ...waiting, onCard: false });
     }, [env.desk]);
+    /*
+     * GRAVIEW IS HERE WHILE IT THINKS (Roadmap f-menu-type-anything): from the
+     * words asked until this card is put away — its close, Escape, a press
+     * away, an answer taken back — the app's AI stands among who is here, as
+     * a bot editing does: "Graview, for Ada", at what it was asked about, so
+     * the bar says it and the picture marks the thing; the others are told
+     * on the presence channel where there is one. A page that dies leaves it
+     * to lapse by the presence's own time.
+     */
+    const thinking = answering !== null;
+    useEffect(() => {
+        if (!thinking)
+            return;
+        const at = recordsOfTarget(target)[0] ?? (target.on === "list" ? `kind:${target.kind}` : target.on === "lens" && target.kind ? `kind:${target.kind}` : null);
+        const person = env.principal;
+        const name = person.id ? nameOfAuthor(person, { graph: env.store.graph, schema: env.store.schema, ...(seats ? { seats } : {}), ...(people ? { people } : {}) }) : undefined;
+        aiHere({
+            participant: `agent:graview-for-${person.id ?? "anyone"}:${session}`,
+            kind: "agent",
+            name: "Graview",
+            ...(person.id ? { onBehalfOf: person.id, ...(name ? { onBehalfOfName: name } : {}) } : {}),
+            over: at,
+            robot: { at, mode: "thinking" },
+        });
+        return () => aiHere(null);
+        // Stands from the ask to the card's close; where it is said once, as it began.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [thinking]);
     /* THE CATALOG OF THIS TARGET: its panels ("Show …") and places, and the acts the derivation offers this viewer on its records. */
     const catalog = useMemo(() => {
         const ask = askOf(env, target);
@@ -94,19 +203,119 @@ export function QuickAskCard({ face, opening, close }) {
         const asked = question.trim();
         if (!asked)
             return;
-        const before = answering?.result?.answer ? { said: answering.said, answer: answering.result.answer } : undefined;
+        // A reply carries what it replies to: the words, the answer, and which records they were read as being about.
+        const before = answering?.result?.answer ? { said: answering.said, answer: answering.result.answer, ...(answering.result.reading ? { reading: answering.result.reading.which } : {}) } : undefined;
+        const place = target.on === "lens" ? env.places.find((one) => one.as === target.place)?.title : target.on === "list" ? undefined : undefined;
         setWords("");
         setActive(-1);
         setSaid(null);
         setAnswering({ said: asked, result: null });
-        const result = await answerHere(env.ai, { ...askOf(env, target, asked), said: asked, ...(before ? { follows: before } : {}) });
+        setPlanState({ state: "offered" });
+        const members = membersOf(env.store, target, face);
+        /* A reply on the card follows the telling before it, in one conversation; one still only previewed was not taken. */
+        const earlier = told.current;
+        if (earlier)
+            toldSay({ outcome: "abandoned" });
+        const started = Date.now();
+        // The like 👍 tellings of this app, given to Jev and the light model as examples (Roadmap f-menu-learns): only what is at hand, never waited for.
+        // Already fetched (by the menu, or as this card opened) it is here in a tick; otherwise not waited for.
+        const toldHere = env.ai.told ? (toldCard.current ?? (await Promise.race([toldCard.load().catch(() => undefined), new Promise((resolve) => setTimeout(resolve, 50))]))) : undefined;
+        const like = env.ai.told && toldHere ? toldHere.examplesHere(env.ai.told, env.store, env.principal, asked, target) : { examples: [], ids: [] };
+        const examples = [...new Set([...(earlier ? [] : (opening.suggested ? [opening.suggested] : [])), ...like.ids])];
+        const result = await answerHere(env.ai, {
+            ...askOf(env, target, asked),
+            said: asked,
+            ...(before ? { follows: before } : {}),
+            ...(members.length > 0 ? { members } : {}),
+            ...(place ? { where: place } : {}),
+            ...(like.examples.length > 0 ? { examples: like.examples } : {}),
+        });
         env.desk.record(result.interaction);
         // Its proposed change is a ghost, drawn on this card: accepted there as one batch, with its one undo.
         if (result.ghost && result.ghost.proposals.length > 0)
             env.desk.setGhost({ ghost: result.ghost, onCard: true });
+        /* The app lacks it: the whole plan that would finish the ask, composed and rehearsed before it is said. */
+        let plan;
+        if (result.missing) {
+            try {
+                const { planFor } = await import("./quick-ask-plan.js");
+                // The records the words were read as being about, where the plan says it.
+                const from = Date.now();
+                const where = place ?? (result.reading && result.reading.which === "held" && target.on === "record" ? result.reading.words.replace(/^the \d+ \S+ in /, "") : undefined);
+                plan = await planFor(env, { said: asked, missing: result.missing, members: result.reading?.records ?? members, host: onProposeChange !== undefined, ...(composeChange ? { compose: composeChange } : {}), ...(where ? { where } : {}) });
+                // The plan composed and rehearsed, timed beside the slots' stages.
+                env.desk.record({ ...result.interaction, stages: [...(result.interaction.stages ?? []), { stage: "compose", ms: Date.now() - from }] });
+            }
+            catch (error) {
+                // The error is the pipeline's; the person is told plainly.
+                plan = { refused: `${result.missing.said} That change could not be made here.` };
+            }
+        }
         if (live.current)
-            setAnswering({ said: asked, result });
-    }, [answering, env, target]);
+            setAnswering({ said: asked, result, ...(plan ? { plan } : {}) });
+        /*
+         * KEPT AS A TELLING, AFTER THE ANSWER IS DRAWN: what was said and
+         * decided and how long it took, its id now so how it ends — said as
+         * the person goes on — is held until it is kept.
+         */
+        const keeps = env.ai.told;
+        if (!keeps)
+            return;
+        const ms = Date.now() - started;
+        told.current?.stop?.();
+        const now = { id: freshTellingId(), conversation: earlier?.conversation ?? "", interaction: result.interaction.id };
+        told.current = { ...now, conversation: now.conversation || now.id };
+        const mine = told.current;
+        afterPaint(() => void toldCard.load().then((module) => {
+            const kept = module.keepTelling(keeps, { ...module.tellingDraftOf(env.store, { words: asked, target, result, ...(plan ? { plan } : {}), ms, ...(earlier ? { conversation: earlier.conversation, follows: earlier.id } : {}), examples }), id: mine.id, conversation: mine.conversation }, env.principal);
+            if (!kept)
+                return;
+            mine.kept = true;
+            if (mine.queued)
+                module.changeTelling(keeps, kept.id, mine.queued);
+            mine.stop = module.watchTelling(env.desk, keeps, kept);
+            if (live.current && told.current === mine)
+                setTelling(kept);
+        }, () => undefined));
+    }, [answering, env, target, face, onProposeChange, composeChange, opening.suggested, toldSay]);
+    /*
+     * YES: THE PLAN LANDS AS ONE CHANGE. The host applies the change to the
+     * app and the records that finish the ask together, as the person, and
+     * hands back its one way back; a host that declines is said on the card.
+     */
+    const offered = answering?.plan && "question" in answering.plan ? answering.plan : undefined;
+    const yes = useCallback(async () => {
+        const proposal = offered?.proposal;
+        if (!proposal || !onProposeChange || planState.state !== "offered")
+            return;
+        setPlanState({ state: "applying" });
+        try {
+            const answered = await onProposeChange(proposal);
+            if (!live.current)
+                return;
+            toldSay({ outcome: answered === "declined" ? "declined" : "accepted" });
+            if (answered === "declined")
+                setPlanState({ state: "declined", said: "The host declined this change to the app." });
+            else
+                setPlanState({ state: "applied", ...(typeof answered === "object" ? { undo: answered.undo, ...(answered.note ? { note: answered.note } : {}) } : {}) });
+        }
+        catch (error) {
+            if (live.current)
+                setPlanState({ state: "declined", said: error instanceof Error ? error.message : String(error) });
+        }
+    }, [offered, onProposeChange, planState, toldSay]);
+    const no = useCallback(() => {
+        toldSay({ outcome: "declined" });
+        setPlanState({ state: "declined", said: "Left as it is." });
+    }, [toldSay]);
+    const undoPlan = useCallback(async () => {
+        if (planState.state !== "applied" || !planState.undo)
+            return;
+        await planState.undo();
+        toldSay({ outcome: "undone" });
+        if (live.current)
+            setPlanState({ state: "undone" });
+    }, [planState, toldSay]);
     /* Opened with words already (Find's "Ask: ‘…’", Activity's "Ask again"): asked at once. */
     const first = useRef(opening.asked);
     useEffect(() => {
@@ -202,13 +411,34 @@ export function QuickAskCard({ face, opening, close }) {
         }
         field.current?.focus({ preventScroll: true });
         let frame = 0;
+        let marked = null;
+        /* OPENED FROM THE MENU, IT OPENS WHERE THE MENU STOOD and never moves: placed once, before it is first painted. */
+        const from = opening.from;
+        if (from)
+            pinAt(element, from);
         const follow = () => {
-            placeBeside(element, anchorOf(element, target, face));
+            const anchor = anchorOf(element, target, face);
+            if (from)
+                sayBeside(element, anchor);
+            else
+                placeBeside(element, anchor);
+            // The thinking mark, on the thing itself while the answer is on its way.
+            const on = mark.current ? anchor : null;
+            if (marked !== on) {
+                marked?.removeAttribute("data-graview-ai-thinking");
+                on?.setAttribute("data-graview-ai-thinking", "");
+                marked = on;
+            }
+            if (mark.current)
+                placeOn(mark.current, on);
             frame = requestAnimationFrame(follow);
         };
         follow();
-        return () => cancelAnimationFrame(frame);
-    }, [target, face]);
+        return () => {
+            cancelAnimationFrame(frame);
+            marked?.removeAttribute("data-graview-ai-thinking");
+        };
+    }, [target, face, opening.from]);
     /* A press outside the bar puts it away; an answer stays until it is closed. */
     useEffect(() => {
         if (answering)
@@ -235,28 +465,52 @@ export function QuickAskCard({ face, opening, close }) {
             const row = rows[active];
             if (row)
                 row.take();
+            // A plan the card asks about takes its answer in words too: "yes", "no"; anything else revises it.
+            else if (offered?.proposal && planState.state === "offered" && YES.test(words.trim())) {
+                setWords("");
+                void yes();
+            }
+            else if (offered && planState.state === "offered" && NO.test(words.trim())) {
+                setWords("");
+                no();
+            }
             else if (words.trim())
                 void ask(words);
         }
     };
     const result = answering?.result ?? null;
     const lit = rows[active];
-    return (_jsxs("section", { ref: pane, popover: "manual", role: "region", "aria-label": answering ? `Answer about ${about}` : `Ask about ${about}`, "data-testid": "quick-ask", "data-quick-ask": answering ? "answer" : "bar", "data-quick-ask-face": face, "data-graview-offstage": "", "data-graview-overlay": "", onKeyDown: (event) => {
+    return (_jsxs("section", { ref: pane, popover: "manual", role: "region", "aria-label": answering ? `Answer about ${about}` : `Tell Graview about ${about}`, "data-testid": "quick-ask", "data-quick-ask": answering ? "answer" : "bar", "data-quick-ask-face": face, "data-graview-offstage": "", "data-graview-overlay": "", onKeyDown: (event) => {
             if (event.key !== "Escape")
                 return;
             // The card's Escape is the card's: the scene's back-out does not hear it too.
             event.preventDefault();
             event.stopPropagation();
             putAway();
-        }, onMouseDown: (event) => event.stopPropagation(), style: CARD, children: [_jsxs("div", { style: { display: "flex", alignItems: "baseline", gap: 8 }, children: [_jsxs("p", { "data-testid": "quick-ask-about", style: { margin: 0, flex: "1 1 auto", minWidth: 0, fontSize: "0.75rem", color: "var(--graview-ink-muted)", overflowWrap: "anywhere" }, children: ["About ", about] }), _jsx("button", { type: "button", "data-testid": "quick-ask-close", "aria-label": "Close", title: "Close", onClick: putAway, style: ICON, children: _jsx("span", { "aria-hidden": "true", children: "\u2715" }) })] }), answering ? (_jsxs("div", { "data-testid": "quick-answer", style: { display: "grid", gap: 8 }, children: [_jsxs("p", { "data-testid": "quick-answer-asked", style: { margin: 0, fontSize: "0.8125rem", color: "var(--graview-ink-muted)", fontStyle: "italic", overflowWrap: "anywhere" }, children: ["\u201C", answering.said, "\u201D"] }), _jsx("p", { "data-testid": "quick-answer-text", "aria-live": "polite", style: { margin: 0, fontSize: "0.9375rem", lineHeight: 1.45, color: result?.interaction.outcome === "failed" ? "var(--graview-warn)" : "var(--graview-ink)", overflowWrap: "anywhere" }, children: result === null ? "Thinking…" : result.interaction.outcome === "failed" ? (result.interaction.failed ?? "The AI could not answer that here.") : (result.answer ?? "") }), result && result.offers.length > 0 ? (_jsx("ul", { "aria-label": "What acts on it", style: { margin: 0, padding: 0, listStyle: "none", display: "flex", flexWrap: "wrap", gap: 6 }, children: result.offers.map((offer) => (_jsx("li", { children: _jsx("button", { type: "button", "data-testid": "quick-answer-offer", "data-ai-offer": offer.id, "data-ai-offer-type": offer.type, onClick: () => {
+        }, onMouseDown: (event) => event.stopPropagation(), style: CARD, children: [_jsxs("div", { style: { display: "flex", alignItems: "baseline", gap: 8 }, children: [_jsxs("p", { "data-testid": "quick-ask-about", style: { margin: 0, flex: "1 1 auto", minWidth: 0, fontSize: "0.75rem", color: "var(--graview-ink-muted)", overflowWrap: "anywhere" }, children: ["About ", about] }), _jsx("button", { type: "button", "data-testid": "quick-ask-close", "aria-label": "Close", title: "Close", onClick: putAway, style: ICON, children: _jsx("span", { "aria-hidden": "true", children: "\u2715" }) })] }), answering ? (_jsxs("div", { "data-testid": "quick-answer", style: { display: "grid", gap: 8 }, children: [_jsxs("p", { "data-testid": "quick-answer-asked", style: { margin: 0, fontSize: "0.8125rem", color: "var(--graview-ink-muted)", fontStyle: "italic", overflowWrap: "anywhere" }, children: ["\u201C", answering.said, "\u201D"] }), _jsx("p", { "data-testid": "quick-answer-text", "aria-live": "polite", style: { margin: 0, fontSize: "0.9375rem", lineHeight: 1.45, color: result?.interaction.outcome === "failed" ? "var(--graview-warn)" : "var(--graview-ink)", overflowWrap: "anywhere" }, children: result === null
+                            ? "Thinking…"
+                            : result.interaction.outcome === "failed"
+                                ? (result.interaction.failed ?? "The AI could not answer that here.")
+                                : /* Every answer the card shows is a whole sentence for the person, never the pipeline's own note. */
+                                    plainly(answering.plan
+                                        ? "question" in answering.plan
+                                            ? answering.plan.question
+                                            : answering.plan.refused
+                                        : result.answer, result.ghost && result.ghost.proposals.length > 0 ? "Here is what I would change." : result.offers.length > 0 ? "These may help." : undefined) }), result?.taken ? (
+                    /* A person said as a pronoun, and whom it was taken as, so a reply can correct it. */
+                    _jsxs("p", { "data-testid": "quick-ask-taken", style: { margin: 0, fontSize: "0.8125rem", color: "var(--graview-ink-muted)" }, children: ["Taking \u201C", result.taken.said, "\u201D as ", result.taken.as, "."] })) : null, result?.reading?.close ? (
+                    /* A close reading said, so a reply can flip it: "Taking this as the 6 tasks in This week." */
+                    _jsxs("p", { "data-testid": "quick-ask-reading", style: { margin: 0, fontSize: "0.8125rem", color: "var(--graview-ink-muted)" }, children: ["Taking this as ", result.reading.words, "."] })) : null, offered ? (
+                    /* The plan, whole, before it lands: each part said, Yes and No — or, for a seat that may not change the app, who could. */
+                    _jsxs("section", { "data-testid": "quick-ask-plan", "data-plan-state": planState.state, "aria-label": "What I would do", style: PLAN, children: [_jsx("ol", { style: { margin: 0, paddingInlineStart: 18, display: "grid", gap: 2 }, children: offered.parts.map((part, at) => (_jsx("li", { "data-plan-part": part.part, style: { fontStyle: planState.state === "applied" ? "normal" : "italic" }, children: part.said }, at))) }), offered.proposal && onProposeChange ? (planState.state === "offered" || planState.state === "applying" ? (_jsxs("div", { style: { display: "flex", gap: 6 }, children: [_jsx("button", { type: "button", "data-testid": "quick-ask-plan-yes", disabled: planState.state === "applying", onClick: () => void yes(), style: OFFER, children: "Yes" }), _jsx("button", { type: "button", "data-testid": "quick-ask-plan-no", disabled: planState.state === "applying", onClick: no, style: OFFER, children: "No" })] })) : planState.state === "applied" ? (_jsxs("div", { role: "status", style: { display: "flex", gap: 6, alignItems: "center" }, children: [_jsxs("span", { "data-testid": "quick-ask-plan-done", children: ["Done, as one change.", planState.note ? ` ${planState.note}` : ""] }), planState.undo ? (_jsx("button", { type: "button", "data-testid": "quick-ask-plan-undo", onClick: () => void undoPlan(), style: OFFER, children: "Undo" })) : null] })) : (_jsx("p", { role: "status", style: { margin: 0, color: "var(--graview-ink-muted)" }, children: planState.state === "undone" ? "Taken back." : planState.said }))) : null] })) : null, result && result.offers.length > 0 ? (_jsx("ul", { "aria-label": "What acts on it", style: { margin: 0, padding: 0, listStyle: "none", display: "flex", flexWrap: "wrap", gap: 6 }, children: result.offers.map((offer) => (_jsx("li", { children: _jsx("button", { type: "button", "data-testid": "quick-answer-offer", "data-ai-offer": offer.id, "data-ai-offer-type": offer.type, onClick: () => {
                                     // Put away as it lands, the way this face goes; a failure is said on the card that offered it.
-                                    void takeOffer(env, result, offer, close).then((failed) => {
+                                    void takeOffer(env, result, offer, close, { onCard: offer.type === "act" || offer.type === "fill" }).then((failed) => {
                                         if (failed && live.current)
                                             setSaid(failed);
                                     });
-                                }, style: OFFER, children: offer.type === "panel" ? `Show ${sentenceCase(offer.label)}` : offer.type === "place" ? `Go to ${offer.label}` : offer.label }) }, offer.id))) })) : null, held?.onCard && held.ghost.interaction === result?.interaction.id ? _jsx(GhostTray, { placement: "card" }) : null] })) : null, _jsxs("div", { style: { display: "grid", gap: 4 }, children: [_jsx("input", { ref: field, type: "text", role: "combobox", "data-testid": "quick-ask-input", "aria-label": answering ? `Ask a follow-up about ${about}` : `Ask about ${about}, or go somewhere`, "aria-expanded": rows.length > 0, "aria-controls": list, "aria-autocomplete": "list", ...(lit ? { "aria-activedescendant": `${list}-${active}` } : {}), autoComplete: "off", enterKeyHint: "go", placeholder: answering ? "Ask a follow-up…" : "Ask, or go to…", value: words, 
+                                }, style: OFFER, children: offer.type === "panel" ? `Show ${sentenceCase(offer.label)}` : offer.type === "place" ? `Go to ${offer.label}` : offer.type === "act" || offer.type === "fill" ? `${offer.label.replace(/[.?]$/, "")}?` : offer.label }) }, offer.id))) })) : null, held?.onCard && held.ghost.interaction === result?.interaction.id ? _jsx(GhostTray, { placement: "card" }) : null, result && telling && env.ai.told && telling.interaction === result.interaction.id ? _jsx(Rate, { told: env.ai.told, telling: telling }) : null] })) : null, _jsxs("div", { style: { display: "grid", gap: 4 }, children: [_jsx("input", { ref: field, type: "text", role: "combobox", "data-testid": "quick-ask-input", "aria-label": answering ? `Reply about ${about}` : `Tell Graview about ${about}, or go somewhere`, "aria-expanded": rows.length > 0, "aria-controls": list, "aria-autocomplete": "list", ...(lit ? { "aria-activedescendant": `${list}-${active}` } : {}), autoComplete: "off", enterKeyHint: "go", placeholder: answering ? "Reply…" : "Tell Graview, or go to…", value: words, 
                         // Read-only while it answers, never disabled: a disabled field lets go of the keyboard.
-                        readOnly: answering !== null && result === null, "aria-busy": answering !== null && result === null, onChange: (event) => setWords(event.target.value), onKeyDown: onKeyDown, style: FIELD }), _jsx("div", { id: list, role: "listbox", "aria-label": words.trim() ? `What “${words.trim()}” finds here` : "What can be done here", hidden: rows.length === 0, style: { display: rows.length === 0 ? "none" : "grid", gap: 1, maxHeight: 280, overflowY: "auto" }, children: rows.map((row, at) => (_jsx("div", { id: `${list}-${at}`, role: "option", "aria-selected": at === active, "data-testid": "quick-ask-option", "data-quick-ask-kind": row.kind, "data-quick-ask-row": row.id, onMouseEnter: () => setActive(at), onMouseDown: (event) => event.preventDefault(), onClick: row.take, style: { ...OPTION, background: at === active ? "var(--graview-panel-muted)" : "transparent", ...(row.kind === "ask" ? { borderTop: "1px solid var(--graview-edge)", marginTop: 2 } : {}) }, children: row.kind === "ask" ? (_jsxs("span", { children: ["Ask: ", _jsxs("span", { style: { fontWeight: 600 }, children: ["\u2018", row.label, "\u2019"] })] })) : (_jsxs("span", { children: [row.label, row.hint ? _jsxs("span", { style: { color: "var(--graview-ink-faint)" }, children: [" \u00B7 ", row.hint] }) : null] })) }, row.id))) })] }), said ? (_jsx("p", { role: "alert", "data-testid": "quick-ask-refused", style: { margin: 0, fontSize: "0.8125rem", color: "var(--graview-warn)" }, children: said })) : null, _jsx("span", { style: VISUALLY_HIDDEN, "aria-live": "polite", children: rows.length > 0 && words.trim() ? `${rows.length} ${rows.length === 1 ? "way" : "ways"} to go on` : "" })] }));
+                        readOnly: answering !== null && result === null, "aria-busy": answering !== null && result === null, onChange: (event) => setWords(event.target.value), onKeyDown: onKeyDown, style: FIELD }), _jsx("div", { id: list, role: "listbox", "aria-label": words.trim() ? `What “${words.trim()}” finds here` : "What can be done here", hidden: rows.length === 0, style: { display: rows.length === 0 ? "none" : "grid", gap: 1, maxHeight: 280, overflowY: "auto" }, children: rows.map((row, at) => (_jsx("div", { id: `${list}-${at}`, role: "option", "aria-selected": at === active, "data-testid": "quick-ask-option", "data-quick-ask-kind": row.kind, "data-quick-ask-row": row.id, onMouseEnter: () => setActive(at), onMouseDown: (event) => event.preventDefault(), onClick: row.take, style: { ...OPTION, background: at === active ? "var(--graview-panel-muted)" : "transparent", ...(row.kind === "ask" ? { borderTop: "1px solid var(--graview-edge)", marginTop: 2 } : {}) }, children: row.kind === "ask" ? (_jsxs("span", { children: ["Tell Graview: ", _jsxs("span", { style: { fontWeight: 600 }, children: ["\u2018", row.label, "\u2019"] })] })) : (_jsxs("span", { children: [row.label, row.hint ? _jsxs("span", { style: { color: "var(--graview-ink-faint)" }, children: [" \u00B7 ", row.hint] }) : null] })) }, row.id))) })] }), said ? (_jsx("p", { role: "alert", "data-testid": "quick-ask-refused", style: { margin: 0, fontSize: "0.8125rem", color: "var(--graview-warn)" }, children: said })) : null, _jsx("span", { style: VISUALLY_HIDDEN, "aria-live": "polite", children: rows.length > 0 && words.trim() ? `${rows.length} ${rows.length === 1 ? "way" : "ways"} to go on` : "" }), answering !== null && result === null ? (_jsxs("span", { ref: mark, role: "status", "data-testid": "ai-thinking-mark", style: THINKING, children: [_jsx("style", { children: "@keyframes graview-thinking{from{opacity:.35}to{opacity:1}}@media (prefers-reduced-motion:reduce){[data-testid=ai-thinking-mark]>span{animation:none!important}}" }), _jsx("span", { "aria-hidden": "true", style: THINKING_DOT }), _jsxs("span", { children: ["Thinking about ", about, "\u2026"] })] })) : null] }));
 }
 /**
  * WHAT THE CARD STANDS BESIDE: the record's card or the kind's district on
@@ -268,8 +522,8 @@ function anchorOf(pane, target, face) {
     const root = pane?.closest("[data-graview-embed]") ?? document;
     const ids = target.on === "list" ? [`aggregate:${target.kind}`, `kind:${target.kind}`] : target.on === "lens" && target.kind ? [`aggregate:${target.kind}`] : recordsOfTarget(target);
     for (const id of ids) {
-        // The record's own card where the picture draws one; else where it is picked from (a row of a district's list).
-        for (const element of root.querySelectorAll(`[data-graview-view="${CSS.escape(id)}"], [data-graview-pick="${CSS.escape(id)}"]`)) {
+        // The record's own card where the picture draws one; else where it is picked from (a row of a district's list, a page's row or card).
+        for (const element of root.querySelectorAll(`[data-graview-view="${CSS.escape(id)}"], [data-graview-pick="${CSS.escape(id)}"], [data-graview-record="${CSS.escape(id)}"], [data-graview-listed="${CSS.escape(id)}"]`)) {
             if (pane?.contains(element))
                 continue;
             const box = element.getBoundingClientRect();
@@ -322,15 +576,83 @@ function placeBeside(pane, anchor) {
         style.top = next.top;
     if (style.width !== next.width)
         style.width = next.width;
-    const beside = anchor?.getAttribute("data-graview-view") ?? anchor?.getAttribute("data-graview-pick") ?? (anchor ? "page" : "");
+    const beside = anchor?.getAttribute("data-graview-view") ?? anchor?.getAttribute("data-graview-pick") ?? anchor?.getAttribute("data-graview-record") ?? anchor?.getAttribute("data-graview-listed") ?? (anchor ? "page" : "");
     if (pane.getAttribute("data-quick-ask-beside") !== beside)
         pane.setAttribute("data-quick-ask-beside", beside);
     if (pane.getAttribute("data-quick-ask-side") !== side)
         pane.setAttribute("data-quick-ask-side", side);
 }
+/**
+ * WHERE THE MENU STOOD: the card's top-left corner is the menu's, growing
+ * down and right; it moves left only where it would leave the window, and
+ * up only where too little of the window is left below it — once, here,
+ * before it is painted. What it holds grows inside it and scrolls past the
+ * window's foot; nothing that arrives moves it.
+ */
+function pinAt(pane, from) {
+    const view = { width: document.documentElement.clientWidth || innerWidth, height: innerHeight };
+    const width = Math.min(WIDTH, view.width - 2 * GAP);
+    const left = from.left + width > view.width - GAP ? Math.max(GAP, view.width - GAP - width) : Math.max(GAP, from.left);
+    const room = 240;
+    const top = from.top + room > view.height - GAP ? Math.max(GAP, view.height - GAP - room) : Math.max(GAP, from.top);
+    pane.style.left = `${Math.round(left)}px`;
+    pane.style.top = `${Math.round(top)}px`;
+    pane.style.width = `${Math.round(width)}px`;
+    pane.style.maxHeight = `${Math.round(view.height - top - GAP)}px`;
+    pane.setAttribute("data-quick-ask-side", "where-the-menu-stood");
+    pane.setAttribute("data-quick-ask-from", `${Math.round(from.left)},${Math.round(from.top)}`);
+}
+/** What a pinned card is about, said on it without moving it. */
+function sayBeside(pane, anchor) {
+    const beside = anchor?.getAttribute("data-graview-view") ?? anchor?.getAttribute("data-graview-pick") ?? anchor?.getAttribute("data-graview-record") ?? anchor?.getAttribute("data-graview-listed") ?? (anchor ? "page" : "");
+    if (pane.getAttribute("data-quick-ask-beside") !== beside)
+        pane.setAttribute("data-quick-ask-beside", beside);
+}
+/** The thinking mark, at the top right of what it is on, inside its corner; hidden where there is nothing to stand on. */
+function placeOn(mark, anchor) {
+    const at = anchor?.getBoundingClientRect();
+    const on = anchor?.getAttribute("data-graview-view") ?? anchor?.getAttribute("data-graview-pick") ?? anchor?.getAttribute("data-graview-record") ?? anchor?.getAttribute("data-graview-listed") ?? (anchor ? "page" : "");
+    if (mark.getAttribute("data-thinking-on") !== on)
+        mark.setAttribute("data-thinking-on", on);
+    if (!at || at.width === 0) {
+        if (mark.style.visibility !== "hidden")
+            mark.style.visibility = "hidden";
+        return;
+    }
+    const width = mark.getBoundingClientRect().width;
+    const left = `${Math.round(Math.max(GAP / 2, at.right - width - 6))}px`;
+    const top = `${Math.round(Math.max(GAP / 2, at.top - 10))}px`;
+    if (mark.style.left !== left)
+        mark.style.left = left;
+    if (mark.style.top !== top)
+        mark.style.top = top;
+    if (mark.style.visibility !== "visible")
+        mark.style.visibility = "visible";
+}
+const THINKING = {
+    position: "fixed",
+    visibility: "hidden",
+    display: "inline-flex",
+    alignItems: "center",
+    gap: 6,
+    padding: "2px 8px",
+    borderRadius: 999,
+    fontSize: "0.75rem",
+    lineHeight: 1.4,
+    whiteSpace: "nowrap",
+    color: "var(--graview-ink)",
+    background: "var(--graview-float)",
+    border: "1px dashed var(--graview-accent)",
+    boxShadow: "var(--graview-lift-low)",
+    pointerEvents: "none",
+};
+const THINKING_DOT = { width: 7, height: 7, borderRadius: 999, background: "var(--graview-accent)", animation: "graview-thinking 1s ease-in-out infinite alternate" };
+const PLAN = { display: "grid", gap: 8, padding: 10, borderRadius: 10, border: "1px dashed var(--graview-accent)", fontSize: "0.875rem" };
 const CARD = {
     position: "fixed",
     inset: "auto",
+    // As tall as what it holds: WebKit's own popover height stretched the card to the window's (its max-height).
+    height: "auto",
     margin: 0,
     zIndex: layer("popover"),
     boxSizing: "border-box",