@agenticprimitives/orchestration 0.0.0-alpha.1 → 0.0.0-alpha.11

package/dist/outcome.js

@@ -0,0 +1,325 @@
+// OUTCOME-DIRECTED INTENT — spec 417. A person does not want a skill; they want an OUTCOME, and the domain's data graph
+// already says which skill PRODUCES which class and which classes it CONSUMES. So selection splits by logic:
+//
+//   what outcome is wanted   a JUDGMENT (probabilistic): the terminal skill, read as the outcome it produces, and — in
+//                            the same call — which consumed classes the request itself supplies (typed yes-no, J9);
+//   how it is reached        a RULE (exact): back from the terminal skill through `consumes` — a class the request
+//                            supplies or the asker HOLDS needs nothing; one another skill produces prepends that skill;
+//                            anything else is MISSING and named. Context shortens the path; it never lengthens it.
+//
+// A judge picks the outcome; a rule over the ontology builds the path; neither allows — every step of a chain still runs
+// every gate. Pure: the harness passes the asker's held classes in; nothing is read here.
+import { judgeQuestions, structuredCallDecisionModel, applyDecisionRule, explainAnswer, NOT_APPLICABLE } from './judgment.js';
+import { inferIntent, renderReading, skillCard } from './intent.js';
+export const OUTCOME_JUDGE = { name: 'ap.outcome-judge.v1', kind: 'model' };
+/** The dataflow graph of a skill set. Deterministic: the same tools give the same graph. */
+export function outcomeGraphOf(tools) {
+    const producersOf = {};
+    const consumesOf = {};
+    const labels = {};
+    const parties = {};
+    const necessity = {};
+    for (const t of [...tools].sort((a, b) => a.id.localeCompare(b.id))) {
+        for (const c of t.produces ?? []) {
+            (producersOf[c.iri] ??= []).push(t.id);
+            labels[c.iri] = c.label;
+            if (c.about)
+                parties[`${t.id}|produces|${c.iri}`] = c.about.iri;
+        }
+        consumesOf[t.id] = (t.consumes ?? []).map((c) => { labels[c.iri] = c.label; if (c.about)
+            parties[`${t.id}|consumes|${c.iri}`] = c.about.iri; if (c.necessity)
+            necessity[`${t.id}|${c.iri}`] = c.necessity; return c.iri; }).sort();
+    }
+    return { producersOf, consumesOf, labels, parties, necessity };
+}
+/** Every arrow of the graph: `producer` makes the `class` that `consumer` works from. What a request may confirm. */
+export function edgesOf(graph) {
+    return Object.entries(graph.consumesOf).flatMap(([consumer, cs]) => cs.flatMap((c) => (graph.producersOf[c] ?? []).filter((p) => p !== consumer).map((producer) => ({ producer, class: c, consumer }))));
+}
+export const edgeKey = (e) => `${e.producer}|${e.class}|${e.consumer}`;
+/** Spec 418 §1 — THE RULE ON AN ARROW, from whose each end is: both ends qualified ⇒ the arrow holds exactly when the
+ *  parties agree (our own scorecard never feeds a grantee's diligence); either end unqualified ⇒ undecided (`null`), and
+ *  only then is the request asked. */
+export function edgeByParty(graph, e) {
+    const made = graph.parties[`${e.producer}|produces|${e.class}`];
+    const wanted = graph.parties[`${e.consumer}|consumes|${e.class}`];
+    return made && wanted ? made === wanted : null;
+}
+/** Every class some skill consumes — what "does the request supply it?" is asked about. */
+export function consumedClassesOf(graph) {
+    return [...new Set(Object.values(graph.consumesOf).flat())].sort();
+}
+export const DEFAULT_OUTCOME_BOUNDS = { maxDepth: 3, maxSteps: 4 };
+/**
+ * THE RULE: the minimal path to `terminal`'s outcome. Each consumed class is satisfied, in this order, by the request,
+ * by what the asker holds, by a producer already on the path, by a new producer (recursing, bounded, no cycles), or
+ * named missing. Deterministic.
+ */
+export function planForOutcome(graph, terminal, have, bounds = DEFAULT_OUTCOME_BOUNDS) {
+    const steps = [];
+    const satisfied = {};
+    const missing = new Set();
+    const ambiguous = new Set();
+    const optional = new Set();
+    let tooLong = false;
+    const onPath = new Set();
+    const visit = (tool, depth, forClass) => {
+        onPath.add(tool);
+        const from = [];
+        for (const c of graph.consumesOf[tool] ?? []) {
+            const was = satisfied[c];
+            if (was !== undefined) {
+                if (typeof was === 'object')
+                    from.push({ tool: was.step, class: c });
+                continue;
+            }
+            if (have.supplied.has(c)) {
+                satisfied[c] = 'request';
+                continue;
+            }
+            if (have.held.has(c)) {
+                satisfied[c] = 'held';
+                continue;
+            }
+            // An ENRICHING input is produced only when the request says it is absent; otherwise the step stands without it.
+            const enriching = graph.necessity[`${tool}|${c}`] === 'enriching';
+            if (enriching && !have.absent?.has(c)) {
+                optional.add(c);
+                continue;
+            }
+            // A TYPE says a producer could make the class; the REQUEST says whether it would make THIS one (the grantee's
+            // scorecard is not the one our own assessment produces). An edge the request does not confirm is not taken.
+            const producers = (graph.producersOf[c] ?? []).filter((p) => p !== tool && !onPath.has(p) && (have.edgeFits?.({ producer: p, class: c, consumer: tool }) ?? true));
+            if (!producers.length) {
+                if (enriching)
+                    optional.add(c);
+                else
+                    missing.add(c);
+                continue;
+            }
+            if (depth + 1 > bounds.maxDepth) {
+                tooLong = true;
+                continue;
+            }
+            if (producers.length > 1)
+                ambiguous.add(c);
+            const p = producers[0];
+            visit(p, depth + 1, c);
+            satisfied[c] = { step: p };
+            from.push({ tool: p, class: c });
+        }
+        steps.push({ tool, ...(forClass ? { for: forClass } : {}), ...(from.length ? { from } : {}) });
+    };
+    visit(terminal, 0);
+    if (steps.length > bounds.maxSteps)
+        tooLong = true;
+    return { kind: tooLong ? 'too-long' : 'plan', steps, satisfied, missing: [...missing].sort(), ambiguous: [...ambiguous].sort(), ...(optional.size ? { optional: [...optional].sort() } : {}) };
+}
+/** A class named for a light model: its label and — from the domain lexicon — up to three of its other words
+ *  ("Deployment Inventory (also: inventory of AI, list of AI tools)"). A bare class name is opaque without the cards. */
+export function glossOf(iri, label, lexicon) {
+    const e = lexicon?.find((x) => x.iri === iri);
+    const also = (e?.terms ?? []).filter((t) => t.toLowerCase() !== label.toLowerCase()).slice(0, 3);
+    return also.length ? `${label} (also: ${also.join(', ')})` : label;
+}
+/** The enriching-input question, by wording version. */
+export function absenceStatement(classText, wording = 'v1') {
+    return wording === 'v2'
+        ? `The request wants the ${classText} made or worked out as a step of its own before the rest — it asks for it to be taken stock of, listed, sorted or built first — or says it does not exist yet or is unknown (not merely that it was not mentioned).`
+        : `The request says the ${classText} does not exist yet, is unknown, or has to be worked out first (not merely that it was not mentioned).`;
+}
+// The supplied and edge floors sit ABOVE 0.5: an unrelated arrow comes back at exactly 0.5 ("can't tell"), and a coin is not a
+// confirmation (probe 2026-09-27, before any measured run).
+export const DEFAULT_OUTCOME_PARAMS = { floor: 0.5, margin: 0.15, suppliedFloor: 0.6, edgeFloor: 0.6, bounds: DEFAULT_OUTCOME_BOUNDS, maxEdgeQuestions: 12, partyRule: true };
+const outcomeOption = (c) => {
+    const card = skillCard(c);
+    const makes = (c.produces ?? []).map((k) => k.label).join(', ');
+    const needs = (c.consumes ?? []).map((k) => k.label).join(', ');
+    return `${card}${makes ? ` Results in: ${makes}.` : ''}${needs ? ` Works from: ${needs}.` : ''}`;
+};
+/**
+ * THE OUTCOME SELECTION: one structured call (the light model; the cards the stable prefix) answering
+ *   outcome        choice over the outcomes the skills produce (+ none)       — what the person wants to end up with;
+ *   supplied:<c>   yes-no per consumed class                                   — does the request itself give it?
+ * then the rule builds the path from the asker's held classes. One model call, whatever the chain's length.
+ */
+export async function selectByOutcome(ask, candidates, call, params = {}, ctx = {}) {
+    const p = { ...DEFAULT_OUTCOME_PARAMS, ...params };
+    const base = { judge: OUTCOME_JUDGE, params: { floor: p.floor, margin: p.margin, suppliedFloor: p.suppliedFloor, edgeFloor: p.edgeFloor } };
+    if (!call)
+        return { chose: null, hold: 'judge-error', error: 'no model is configured', distribution: {}, supplied: {}, ...base };
+    const graph = outcomeGraphOf(candidates);
+    const consumed = consumedClassesOf(graph);
+    const absentAsked = consumed.filter((c) => Object.entries(graph.necessity).some(([k, v]) => v === 'enriching' && k.endsWith(`|${c}`)) && (graph.producersOf[c]?.length ?? 0) > 0);
+    // Arrows the ontology decides (both ends qualified) are not asked: the rule answers them exactly, for no tokens.
+    const allEdges = edgesOf(graph);
+    const ruled = new Map(allEdges.map((e) => [edgeKey(e), p.partyRule ? edgeByParty(graph, e) : null]));
+    const edges = allEdges.filter((e) => ruled.get(edgeKey(e)) === null);
+    const purposeOf = new Map(candidates.map((c) => [c.id, c.description.split(/[.—]/)[0].replace(/\s+/g, ' ').trim().slice(0, 70)]));
+    const nameOf = (id) => `${id} ("${purposeOf.get(id) ?? id}")`;
+    const labels = new Map([...(ctx.lexicon ?? []).map((e) => [e.iri, e.label]), ...Object.entries(graph.labels), ...candidates.flatMap((c) => [...(c.covers ?? []), ...(c.excludes ?? [])].map((k) => [k.iri, k.label]))]);
+    const labelOf = (iri) => labels.get(iri) ?? iri.split('#').pop() ?? iri;
+    const reading = inferIntent(ask, candidates.map((c) => ({ id: c.id, covers: c.covers ?? [], ...(c.excludes ? { excludes: c.excludes } : {}) })), ctx.lexicon, ctx.asker);
+    const questions = [
+        { id: 'outcome', kind: 'choice', question: 'What does the person want to END UP WITH? Choose the ONE skill whose result that is.', options: candidates.map((c) => ({ id: c.id, describe: outcomeOption(c) })), notApplicable: 'Nothing these skills result in — the request is for something else.' },
+        // Question ids are SHORT and neutral (`s1`, `e1`): a provider's tool schema takes them as property names, and an IRI's
+        // `/` and `#` there made the light model answer in prose (2026-09-27, every run). Mapped back below.
+        ...consumed.map((c, i) => ({ id: `s${i + 1}`, kind: 'yes-no', statement: `The request itself gives the ${glossOf(c, labelOf(c), ctx.lexicon)} (its actual details — not merely a mention that one exists).` })),
+        // Spec 418 D4 — for each ENRICHING input some skill can produce: does the request say it is ABSENT? (Only then is it
+        // worth a chain step; "not mentioned" is not "absent".)
+        ...absentAsked.map((c, i) => ({ id: `a${i + 1}`, kind: 'yes-no', statement: absenceStatement(glossOf(c, labelOf(c), ctx.lexicon), p.absenceWording) })),
+        // Each arrow, confirmed for THIS request — asked in the same call (a domain with more arrows than the bound asks none,
+        // and every type-level arrow stands: said on the result).
+        ...(edges.length <= p.maxEdgeQuestions ? edges.map((e, i) => ({ id: `e${i + 1}`, kind: 'yes-no', statement: `If the outcome is the result of ${nameOf(e.consumer)}, the ${labelOf(e.class)} it works from would be one that ${nameOf(e.producer)} produces when run for this same request — the same organization and situation (not, say, another organization's).` })) : []),
+    ];
+    const j = await judgeQuestions(renderReading(ask, reading, labelOf), questions, structuredCallDecisionModel(call, { name: OUTCOME_JUDGE.name, stablePrefix: true }));
+    if (j.error !== undefined)
+        return { chose: null, hold: 'judge-error', error: j.error, distribution: {}, supplied: {}, ...base };
+    const a = j.answers['outcome'];
+    if (!a)
+        return { chose: null, hold: 'malformed', distribution: {}, supplied: {}, ...base };
+    const distribution = Object.fromEntries(Object.entries(a.distribution).map(([k, v]) => [k === NOT_APPLICABLE ? 'none' : k, v]));
+    const supplied = Object.fromEntries(consumed.flatMap((c, i) => { const s = j.answers[`s${i + 1}`]; return s ? [[c, Number((s.distribution['true'] ?? 0).toFixed(4))]] : []; }));
+    const absentP = Object.fromEntries(absentAsked.flatMap((c, i) => { const x = j.answers[`a${i + 1}`]; return x ? [[c, Number((x.distribution['true'] ?? 0).toFixed(4))]] : []; }));
+    const edgeP = Object.fromEntries(edges.flatMap((e, i) => { const x = j.answers[`e${i + 1}`]; return x ? [[edgeKey(e), Number((x.distribution['true'] ?? 0).toFixed(4))]] : []; }));
+    const reason = explainAnswer(a, (o) => (o === NOT_APPLICABLE ? 'none' : o));
+    const d = applyDecisionRule(a, p);
+    if (d.decided === null) {
+        const hold = d.because === 'not-applicable' ? 'none-fits' : d.because === 'unreadable' ? 'malformed' : d.because;
+        return { chose: null, hold, distribution, supplied, ...(Object.keys(edgeP).length ? { edges: edgeP } : {}), reason, ...base };
+    }
+    const held = new Set((ctx.asker?.heldClasses ?? []).filter((c) => consumed.includes(c)));
+    const edgeFits = (e) => { const r = ruled.get(edgeKey(e)); return r !== null && r !== undefined ? r : edgeP[edgeKey(e)] !== undefined ? edgeP[edgeKey(e)] >= p.edgeFloor : true; };
+    const absent = new Set(Object.entries(absentP).filter(([, v]) => v >= p.suppliedFloor).map(([k]) => k));
+    const plan = planForOutcome(graph, d.decided, { supplied: new Set(Object.entries(supplied).filter(([, v]) => v >= p.suppliedFloor).map(([k]) => k)), held, edgeFits, absent }, p.bounds);
+    const byRule = Object.fromEntries([...ruled].filter(([, v]) => v !== null));
+    const ex = { ...(Object.keys(absentP).length ? { absent: absentP } : {}), ...(Object.keys(edgeP).length ? { edges: edgeP } : {}), ...(Object.keys(byRule).length ? { edgesByRule: byRule } : {}) };
+    if (plan.kind === 'too-long')
+        return { chose: null, hold: 'too-long', plan, distribution, supplied, ...ex, reason, ...base };
+    return { chose: d.decided, plan, distribution, supplied, ...ex, reason, ...base };
+}
+/** The plan as orchestration steps: each producer's answer is `$ref`'d into the next step as its material. */
+export function outcomeSteps(plan, ask, labelOf, opts = {}) {
+    const held = Object.entries(plan.satisfied).filter(([, s]) => s === 'held').map(([c]) => labelOf(c));
+    const heldNote = held.length ? `\n\n(The person already holds, in their own records: ${held.join(', ')}.)` : '';
+    const missingNote = plan.missing.length ? `\n\n(Not given and not produced here: ${plan.missing.map(labelOf).join(', ')} — ask for it rather than invent it.)` : '';
+    const refOf = new Map(plan.steps.map((s, i) => [s.tool, `o${i}`]));
+    return plan.steps.map((s, i) => {
+        const from = s.from ?? [];
+        const fromNote = from.length ? `\n\n(The material is what earlier steps produced for this request: ${from.map((f) => `the ${labelOf(f.class)}`).join('; ')}.)` : '';
+        const question = s.for
+            ? `Produce the ${labelOf(s.for)} this request will need${opts.briefIntermediate ? ` — ONLY that ${labelOf(s.for)}, as a compact working artifact the next step builds on (no introduction, no guidance beyond it)` : ''}.\n\nThe request: ${ask}${heldNote}${fromNote}`
+            : `${ask}${heldNote}${missingNote}${fromNote}`;
+        const material = from.map((f) => ({ $ref: `${refOf.get(f.tool)}.answer` }));
+        return { toolId: s.tool, id: `s${i}`, ref: `o${i}`, args: { question, ...(material.length === 1 ? { material: material[0] } : material.length ? { material } : {}), ...(opts.briefIntermediate && s.for ? { brief: true } : {}) } };
+    });
+}
+// ── SELECTIVE OUTCOME READING (spec 418 D6). The full outcome judgment pays for the dataflow questions on EVERY ask,
+// but across three sets a chain or a missing input mattered in a handful of cases (ledger, 2026-09-27: +124–174% pick
+// tokens for no significant gain). So: the cheap one-skill pick first; the dataflow questions only when the PICKED
+// skill has an input some other skill can produce for it (after the party rule) that the asker does not already hold —
+// and then only about that skill's inputs, in one small call. No such input ⇒ no second call at all.
+export const OUTCOME_JUDGE_SELECTIVE = { name: 'ap.outcome-judge.selective.v1', kind: 'model' };
+/** Spec 418 — the picked skill's DOWNSTREAM: skills that consume what the pick produces (the party rule not refusing the
+ *  arrow). A request that names the first step ("work out which deadline is next") may want the next one ("and draft it"). */
+export function downstreamOf(graph, pick) {
+    const out = [];
+    for (const [consumer, cs] of Object.entries(graph.consumesOf)) {
+        if (consumer === pick)
+            continue;
+        for (const c of cs)
+            if ((graph.producersOf[c] ?? []).includes(pick) && edgeByParty(graph, { producer: pick, class: c, consumer }) !== false)
+                out.push({ consumer, class: c });
+    }
+    return out.sort((a, b) => (a.consumer + a.class).localeCompare(b.consumer + b.class));
+}
+/** The picked skill's inputs worth asking about: a producer exists whose arrow the party rule does not refuse. */
+export function upstreamInputsOf(graph, pick, held) {
+    return (graph.consumesOf[pick] ?? []).filter((c) => !held.has(c) && (graph.producersOf[c] ?? []).some((p) => p !== pick && edgeByParty(graph, { producer: p, class: c, consumer: pick }) !== false));
+}
+/** Selective reading asks only about producible inputs, so it names nothing missing it did not ask about (a measured
+ *  trade-off: the full outcome judgment also names missing REQUIRED inputs). */
+const askedOnly = (plan, asked) => ({ ...plan, missing: plan.missing.filter((c) => asked.includes(c)) });
+/** Given the one-skill pick, decide its plan: no call when nothing upstream is producible; else one call about only its inputs. */
+export async function planForPicked(ask, pick, candidates, call, params = {}, ctx = {}) {
+    const p = { ...DEFAULT_OUTCOME_PARAMS, ...params };
+    const graph = outcomeGraphOf(candidates);
+    const held = new Set(ctx.asker?.heldClasses ?? []);
+    const upstream = upstreamInputsOf(graph, pick, held);
+    const down = params.downstream ? downstreamOf(graph, pick) : [];
+    const ruled = Object.fromEntries(edgesOf(graph).filter((e) => e.consumer === pick).flatMap((e) => { const r = edgeByParty(graph, e); return r === null ? [] : [[edgeKey(e), r]]; }));
+    const base = { judge: OUTCOME_JUDGE_SELECTIVE, ...(Object.keys(ruled).length ? { edgesByRule: ruled } : {}) };
+    if ((!upstream.length && !down.length) || !call) {
+        return { asked: false, plan: askedOnly(planForOutcome(graph, pick, { supplied: new Set(), held, absent: new Set(), edgeFits: (e) => edgeByParty(graph, e) ?? true }, p.bounds), []), supplied: {}, ...base };
+    }
+    const labels = new Map([...(ctx.lexicon ?? []).map((e) => [e.iri, e.label]), ...Object.entries(graph.labels)]);
+    const labelOf = (iri) => labels.get(iri) ?? iri.split('#').pop() ?? iri;
+    const enriching = (c) => graph.necessity[`${pick}|${c}`] === 'enriching';
+    const undecided = edgesOf(graph).filter((e) => e.consumer === pick && upstream.includes(e.class) && edgeByParty(graph, e) === null);
+    const nameOf = (id) => `${id} ("${(candidates.find((c) => c.id === id)?.description ?? id).split(/[.—]/)[0].replace(/\s+/g, ' ').trim().slice(0, 70)}")`;
+    const questions = [
+        ...upstream.map((c, i) => ({ id: `s${i + 1}`, kind: 'yes-no', statement: `The request itself gives the ${glossOf(c, labelOf(c), ctx.lexicon)} (its actual details — not merely a mention that one exists).` })),
+        ...upstream.filter(enriching).map((c, i) => ({ id: `a${i + 1}`, kind: 'yes-no', statement: absenceStatement(glossOf(c, labelOf(c), ctx.lexicon), p.absenceWording) })),
+        ...down.map((x, i) => ({ id: `d${i + 1}`, kind: 'yes-no', statement: `Beyond the ${glossOf(x.class, labelOf(x.class), ctx.lexicon)}, the request also asks for what ${nameOf(x.consumer)} makes from it (the next step, not only this one).` })),
+        ...undecided.map((e, i) => ({ id: `e${i + 1}`, kind: 'yes-no', statement: `The ${labelOf(e.class)} that ${nameOf(pick)} works from would be one that ${nameOf(e.producer)} produces when run for this same request — the same organization and situation.` })),
+    ];
+    const j = await judgeQuestions(`Request:\n${ask}\n\nThe skill chosen for it: ${nameOf(pick)}.`, questions, structuredCallDecisionModel(call, { name: OUTCOME_JUDGE_SELECTIVE.name, stablePrefix: true }));
+    if (j.error !== undefined)
+        return { asked: true, plan: askedOnly(planForOutcome(graph, pick, { supplied: new Set(), held, absent: new Set(), edgeFits: (e) => edgeByParty(graph, e) ?? true }, p.bounds), []), supplied: {}, error: j.error, ...base };
+    const yes = (id) => Number((j.answers[id]?.distribution['true'] ?? 0).toFixed(4));
+    const supplied = Object.fromEntries(upstream.map((c, i) => [c, yes(`s${i + 1}`)]));
+    const absent = Object.fromEntries(upstream.filter(enriching).map((c, i) => [c, yes(`a${i + 1}`)]));
+    const edges = Object.fromEntries(undecided.map((e, i) => [edgeKey(e), yes(`e${i + 1}`)]));
+    const downstream = Object.fromEntries(down.map((x, i) => [`${x.consumer}|${x.class}`, yes(`d${i + 1}`)]));
+    const next = down.map((x, i) => ({ ...x, p: yes(`d${i + 1}`) })).filter((x) => x.p >= p.suppliedFloor).sort((a, b) => b.p - a.p)[0];
+    if (next) {
+        // The request wants the downstream result: the plan ends there, and its input is produced by the pick (declared absent).
+        const ext = planForOutcome(graph, next.consumer, { supplied: new Set(), held, absent: new Set([next.class]), edgeFits: (e) => (e.class === next.class ? e.producer === pick : edgeByParty(graph, e) ?? true) }, p.bounds);
+        return { asked: true, plan: askedOnly(ext, upstream), supplied: Object.fromEntries(upstream.map((c, i) => [c, yes(`s${i + 1}`)])), downstream, extendedTo: next.consumer, ...base };
+    }
+    const plan = planForOutcome(graph, pick, {
+        supplied: new Set(Object.entries(supplied).filter(([, v]) => v >= p.suppliedFloor).map(([k]) => k)), held,
+        absent: new Set(Object.entries(absent).filter(([, v]) => v >= p.suppliedFloor).map(([k]) => k)),
+        edgeFits: (e) => { const r = edgeByParty(graph, e); return r !== null ? r : edges[edgeKey(e)] !== undefined ? edges[edgeKey(e)] >= p.edgeFloor : true; },
+    }, p.bounds);
+    return { asked: true, plan: askedOnly(plan, upstream), supplied, ...(Object.keys(absent).length ? { absent } : {}), ...(Object.keys(edges).length ? { edges } : {}), ...(Object.keys(downstream).length ? { downstream } : {}), ...base };
+}
+// ── PLAN CHOICE (spec 418 §11). Yes-no questions around a single pick failed both ways on the chain panels: the pick
+// lands on the FIRST step of a chain ("list the deadlines, then draft") as often as on the LAST ("…then build the response
+// plan" picked with no upstream step). So the RULE enumerates the few plans the ontology allows around the pick — the pick
+// alone, producer → pick, pick → consumer (party rule applied, held inputs pruned) — and the JUDGE picks ONE plan, in words.
+export const PLAN_CHOICE_JUDGE = { name: 'ap.plan-choice-judge.v1', kind: 'model' };
+/** The candidate plans around a pick: alone, each allowed upstream producer, each allowed downstream consumer. */
+export function planOptionsAround(graph, pick, held, purposeOf, labelOf) {
+    const opts = [{ id: 'p0', steps: [pick], describe: `Only this: ${purposeOf(pick)}.` }];
+    for (const c of upstreamInputsOf(graph, pick, held)) {
+        for (const p of (graph.producersOf[c] ?? []).filter((x) => x !== pick && edgeByParty(graph, { producer: x, class: c, consumer: pick }) !== false)) {
+            opts.push({ id: `p${opts.length}`, steps: [p, pick], via: c, describe: `Two steps: first ${purposeOf(p)} — to make the ${labelOf(c)} — then ${purposeOf(pick)} from it.` });
+        }
+    }
+    for (const d of downstreamOf(graph, pick)) {
+        opts.push({ id: `p${opts.length}`, steps: [pick, d.consumer], via: d.class, describe: `Two steps: first ${purposeOf(pick)} — making the ${labelOf(d.class)} — then ${purposeOf(d.consumer)} from it.` });
+    }
+    return opts;
+}
+/** One choice among the rule's candidate plans; a single option (nothing connected) makes no call. */
+export async function choosePlanAround(ask, pick, candidates, call, ctx = {}) {
+    const graph = outcomeGraphOf(candidates);
+    const held = new Set(ctx.asker?.heldClasses ?? []);
+    const labels = new Map([...(ctx.lexicon ?? []).map((e) => [e.iri, e.label]), ...Object.entries(graph.labels)]);
+    const labelOf = (iri) => glossOf(iri, labels.get(iri) ?? iri.split('#').pop() ?? iri, ctx.lexicon);
+    const purposeOf = (id) => (candidates.find((c) => c.id === id)?.description ?? id).split(/[.—]/)[0].replace(/\s+/g, ' ').trim().toLowerCase().slice(0, 90);
+    const options = planOptionsAround(graph, pick, held, purposeOf, labelOf);
+    const toPlan = (o) => ({ kind: 'plan', steps: o.steps.map((t, i) => (i < o.steps.length - 1 ? { tool: t, for: o.via } : { tool: t, ...(i > 0 ? { from: [{ tool: o.steps[i - 1], class: o.via }] } : {}) })), satisfied: o.via && o.steps.length > 1 ? { [o.via]: { step: o.steps[0] } } : {}, missing: [], ambiguous: [] });
+    const base = { options, judge: PLAN_CHOICE_JUDGE };
+    if (options.length === 1 || !call)
+        return { asked: false, chosen: options[0], plan: toPlan(options[0]), ...base };
+    const q = { id: 'plan', kind: 'choice', question: 'Which plan does the request ask for? A two-step plan only if the request wants BOTH results (or needs the first to make the second); otherwise only the one step.', options: options.map((o) => ({ id: o.id, describe: o.describe })) };
+    const j = await judgeQuestions(`Request:\n${ask}`, [q], structuredCallDecisionModel(call, { name: PLAN_CHOICE_JUDGE.name, stablePrefix: true }));
+    const a = j.answers['plan'];
+    if (j.error !== undefined || !a)
+        return { asked: true, chosen: options[0], plan: toPlan(options[0]), ...base, ...(j.error ? { error: j.error } : {}) };
+    const chosen = options.find((o) => o.id === a.top) ?? options[0];
+    return { asked: true, distribution: { ...a.distribution }, chosen, plan: toPlan(chosen), ...base };
+}
+//# sourceMappingURL=outcome.js.map

package/dist/outcome.js.map

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

package/dist/plan-digest.d.ts

@@ -0,0 +1,6 @@
+import type { Plan, PlanStep } from './types.js';
+/** The part of a step that is the person's to approve: never a result, never a resolved value. */
+export declare function planStepAsWritten(step: PlanStep, index: number): Record<string, unknown>;
+/** `0x` + 64 hex: the digest of the plan as written. Deterministic across runtimes for the same plan. */
+export declare function planDigest(plan: Plan): Promise<`0x${string}`>;
+//# sourceMappingURL=plan-digest.d.ts.map

package/dist/plan-digest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-digest.d.ts","sourceRoot":"","sources":["../src/plan-digest.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAoBjD,kGAAkG;AAClG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWxF;AAED,yGAAyG;AACzG,wBAAsB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC,CAEnE"}

package/dist/plan-digest.js

@@ -0,0 +1,35 @@
+const sha256 = async (s) => {
+    const bytes = new Uint8Array(await crypto.subtle.digest('SHA-256', new TextEncoder().encode(s)));
+    return Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('');
+};
+const canonical = (v) => JSON.stringify(v, (_k, x) => {
+    if (typeof x === 'bigint')
+        return x.toString();
+    if (x && typeof x === 'object' && !Array.isArray(x)) {
+        return Object.keys(x).sort().reduce((o, k) => {
+            const val = x[k];
+            if (val !== undefined)
+                o[k] = val;
+            return o;
+        }, {});
+    }
+    return x;
+});
+/** The part of a step that is the person's to approve: never a result, never a resolved value. */
+export function planStepAsWritten(step, index) {
+    return {
+        id: step.id ?? `s${index}`,
+        toolId: step.toolId,
+        args: step.args ?? {},
+        ...(step.ref ? { ref: step.ref } : {}),
+        ...(step.executor ? { executor: step.executor } : {}),
+        ...(step.forEach ? { forEach: step.forEach } : {}),
+        ...(step.after?.length ? { after: [...step.after] } : {}),
+        ...(step.when ? { when: step.when } : {}),
+    };
+}
+/** `0x` + 64 hex: the digest of the plan as written. Deterministic across runtimes for the same plan. */
+export async function planDigest(plan) {
+    return `0x${await sha256(canonical({ steps: plan.steps.map(planStepAsWritten) }))}`;
+}
+//# sourceMappingURL=plan-digest.js.map

package/dist/plan-digest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-digest.js","sourceRoot":"","sources":["../src/plan-digest.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,GAAG,KAAK,EAAE,CAAS,EAAmB,EAAE;IAClD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjG,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC5E,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,CAAU,EAAU,EAAE,CACvC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE;IAC1B,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC/C,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,OAAO,MAAM,CAAC,IAAI,CAAC,CAA4B,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACtE,MAAM,GAAG,GAAI,CAA6B,CAAC,CAAC,CAAC,CAAC;YAC9C,IAAI,GAAG,KAAK,SAAS;gBAAG,CAA6B,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;YAC/D,OAAO,CAAC,CAAC;QACX,CAAC,EAAE,EAA6B,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC,CAAC,CAAC;AAEL,kGAAkG;AAClG,MAAM,UAAU,iBAAiB,CAAC,IAAc,EAAE,KAAa;IAC7D,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,IAAI,KAAK,EAAE;QAC1B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;QACrB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,yGAAyG;AACzG,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAU;IACzC,OAAO,KAAK,MAAM,MAAM,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACtF,CAAC"}

package/dist/planner-wire.d.ts

@@ -0,0 +1,11 @@
+import { type PlanStep, type ToolSpec } from './types.js';
+/** The API-safe name for a tool id. Deterministic; not unique on its own — see `toolNameMap`. */
+export declare function wireNameFor(id: string): string;
+/** Both directions of the id ↔ wire-name map for one tool set. Throws `planner_failed` on a collision. */
+export declare function toolNameMap(tools: ToolSpec[]): {
+    toWire: Map<string, string>;
+    fromWire: Map<string, string>;
+};
+/** One `PlanStep` from a tool call's raw arguments: the convention keys lifted out, the rest kept as args. */
+export declare function planStepFromToolArgs(toolId: string, raw: Record<string, unknown>): PlanStep;
+//# sourceMappingURL=planner-wire.d.ts.map

package/dist/planner-wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner-wire.d.ts","sourceRoot":"","sources":["../src/planner-wire.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAsB,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE9E,iGAAiG;AACjG,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,0GAA0G;AAC1G,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG;IAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAW7G;AAED,8GAA8G;AAC9G,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,CAe3F"}

package/dist/planner-wire.js

@@ -0,0 +1,53 @@
+// THE PLAN-SHAPE CONVENTION ON A VENDOR'S WIRE — shared by every LLM adapter (spec 377 §2).
+//
+// Two things every tool-calling API forces on a planner, neither of which is a vendor detail:
+//
+//   1. Tool NAMES on the wire are restricted (`^[a-zA-Z0-9_-]{1,128}$` on every serious API), while capability
+//      ids are DOTTED by vocabulary (`treasury.payment.execute`, ADR-0051). The wire name is derived here and
+//      mapped BACK on the way out, so the plan still names the tool by its id. Bijective by construction: two
+//      ids that derive the same wire name are refused rather than silently merged.
+//   2. A tool call carries ONLY arguments, so the plan-shape fields the loop reads — `$ref` (bind this result
+//      under a name), `$forEach` (fan out over a prior result's array), `$after` (ids of steps this one waits
+//      for), `$when` (a declared branch on a prior result) — ride INSIDE the args (spec 358 W4, spec 370 P3).
+//      They are lifted into the `PlanStep` fields here; `$item` placeholders stay in args for the loop's
+//      per-item substitution. A malformed form is ignored, and admission then refuses the undecidable step.
+//
+// This lived in the Anthropic adapter first. It moved here the day a second adapter needed it verbatim: the
+// convention belongs to the loop that reads it, not to whichever vendor shipped first.
+import { OrchestrationError } from './types.js';
+/** The API-safe name for a tool id. Deterministic; not unique on its own — see `toolNameMap`. */
+export function wireNameFor(id) {
+    return id.replace(/[^a-zA-Z0-9_-]/g, '_').slice(0, 128) || '_';
+}
+/** Both directions of the id ↔ wire-name map for one tool set. Throws `planner_failed` on a collision. */
+export function toolNameMap(tools) {
+    const toWire = new Map();
+    const fromWire = new Map();
+    for (const t of tools) {
+        const w = wireNameFor(t.id);
+        const prior = fromWire.get(w);
+        if (prior && prior !== t.id)
+            throw new OrchestrationError('planner_failed', `tool ids "${prior}" and "${t.id}" collide on the API tool name "${w}"`);
+        toWire.set(t.id, w);
+        fromWire.set(w, t.id);
+    }
+    return { toWire, fromWire };
+}
+/** One `PlanStep` from a tool call's raw arguments: the convention keys lifted out, the rest kept as args. */
+export function planStepFromToolArgs(toolId, raw) {
+    const { $ref, $forEach, $after, $when, $executor, ...args } = raw;
+    const after = Array.isArray($after) ? $after.filter((x) => typeof x === 'string') : typeof $after === 'string' ? [$after] : [];
+    const when = $when && typeof $when === 'object' && typeof $when.ref === 'string' ? $when : undefined;
+    return {
+        toolId,
+        args,
+        ...(typeof $ref === 'string' && $ref ? { ref: $ref } : {}),
+        ...(typeof $forEach === 'string' && $forEach ? { forEach: { ref: $forEach } } : {}),
+        ...(after.length ? { after } : {}),
+        // Spec 376 W2 — WHO IS TO DO IT, as the person said it ("have runtime-c3s0.svc pay …"): the words, which
+        // the harness resolves in the asker's own tier before the step runs, never an address the model chose.
+        ...(typeof $executor === 'string' && $executor.trim() ? { executor: $executor.trim() } : {}),
+        ...(when ? { when: { ref: when.ref, ...(when.exists !== undefined ? { exists: !!when.exists } : {}), ...(when.equals !== undefined ? { equals: when.equals } : {}) } } : {}),
+    };
+}
+//# sourceMappingURL=planner-wire.js.map

package/dist/planner-wire.js.map

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

package/dist/planner.d.ts

@@ -1,3 +1,4 @@
+import type { EvidenceItemV1 } from './artifacts.js';
 import type { Intent, Plan, PlanStep, ToolSpec, StepObservation } from './types.js';
 /** What a planner is given to produce (or re-produce) a plan. */
 export interface PlanInput {
@@ -6,11 +7,61 @@ export interface PlanInput {
     tools: ToolSpec[];
     /** Prior step observations, present only on a re-plan (empty / undefined on the first plan). */
     observations?: StepObservation[];
+    /** Spec 421 W1 — this call CONTINUES a plan: `observations` are what the reads returned (successes included), shown
+     *  to the planner as data to plan the rest from — never as instructions (other people's words are data). A failure
+     *  re-plan leaves this unset. */
+    continuation?: boolean;
 }
+/**
+ * Spec 421 W1 — the continuation turn, rendered ONCE for every adapter: what the reads returned, each labelled by whose
+ * words it holds, framed as DATA. A result that carries `untrusted: true` (another person's message, a web page, a
+ * published work) is said to be so; nothing in any observation is an instruction — the Goal is the only instruction.
+ * Bounded per observation and in total so a long inbox cannot crowd out the goal.
+ */
+/** A result FITTED for a continuation: every array's items kept in order (each string field clipped), until `cap` characters;
+ *  what did not fit is counted, never silently dropped. A summary of the first three titles is what a re-plan gets
+ *  (spec 391) — a continuation that must find "who asked about Sunday" needs the items themselves. */
+export declare function fitForContinuation(result: unknown, cap: number, fieldClip?: number): string;
+export declare function renderContinuation(observations: ReadonlyArray<StepObservation>, opts?: {
+    perObservation?: number;
+    total?: number;
+}): string;
 /** The injected planning port: turn a goal + the available tools into an ordered tool composition. */
 export interface Planner {
     plan(input: PlanInput): Promise<Plan>;
 }
+/** What an answer is composed FROM. Deliberately only the ask and what the tools actually returned: an
+ *  answer that cannot be traced to an observation is a guess wearing a sentence. */
+export interface ComposeInput {
+    intent: Intent;
+    observations: StepObservation[];
+    /** Spec 358 W3 — a prior composition's claims exceeded its evidence, and these say exactly how. A
+     *  composer given corrections is being asked AGAIN, once; what it returns is re-checked, and the caller
+     *  falls back to stating the evidence rather than asking a third time. */
+    corrections?: string[];
+    /** Spec 391 — the evidence ALREADY FITTED to the composer's budget by the caller (`fitEvidence`), so the drops
+     *  are on the trace and the governor knows what the model saw. Absent ⇒ the composer fits the observations
+     *  itself (never slices). */
+    evidence?: EvidenceItemV1[];
+}
+/**
+ * The injected ANSWERING port — the other half of the loop's model use. `Planner` decides what to do;
+ * this turns what came back into something a person can read.
+ *
+ * Three rules it exists to enforce, none of which the loop can check for the implementer:
+ *   • GROUNDED — only what the observations contain. No recalled facts, no plausible filler; "the
+ *     directory does not say" is a correct answer and the expected one when the rows are empty.
+ *   • NOT EVIDENCE — the receipts are the evidence and the observations are the record. This produces a
+ *     RENDERING of them; nothing downstream may treat the prose as a fact that happened.
+ *   • ANSWERS ONLY — it never runs over an action's result. What an action did is stated from the
+ *     receipt (what was created, at what address, in which transaction), where precision is the point
+ *     and a paraphrase is a liability.
+ */
+export interface AnswerComposer {
+    compose(input: ComposeInput): Promise<string>;
+    /** Spec 391 — how many characters of evidence this composer will carry, so the caller can fit to it. */
+    evidenceBudget?: number;
+}
 /** One deterministic rule. When the goal matches, emit either a single step (`toolId` + `args`) OR a
  *  multi-step plan (`steps`) — later steps may reference earlier results via `{ $ref: 'name.path' }`. A rule
  *  is SKIPPED if any tool it names is not in the provided `tools` (fail-closed; the next rule is tried). */

package/dist/planner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../src/planner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGpF,iEAAiE;AACjE,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,8FAA8F;IAC9F,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,gGAAgG;IAChG,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;CAClC;AAED,sGAAsG;AACtG,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED;;4GAE4G;AAC5G,MAAM,WAAW,QAAQ;IACvB,kFAAkF;IAClF,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;IAC5C,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wFAAwF;IACxF,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7E,sFAAsF;IACtF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qGAAqG;IACrG,KAAK,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,QAAQ,EAAE,CAAC,CAAC;CACrD;AAKD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAqBjE"}
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../src/planner.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGpF,iEAAiE;AACjE,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,8FAA8F;IAC9F,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,gGAAgG;IAChG,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;IACjC;;qCAEiC;IACjC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH;;sGAEsG;AACtG,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CA0BxF;AAED,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,aAAa,CAAC,eAAe,CAAC,EAAE,IAAI,GAAE;IAAE,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAoB/I;AAED,sGAAsG;AACtG,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED;oFACoF;AACpF,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC;;8EAE0E;IAC1E,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;iCAE6B;IAC7B,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,wGAAwG;IACxG,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;4GAE4G;AAC5G,MAAM,WAAW,QAAQ;IACvB,kFAAkF;IAClF,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;IAC5C,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wFAAwF;IACxF,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7E,sFAAsF;IACtF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qGAAqG;IACrG,KAAK,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,QAAQ,EAAE,CAAC,CAAC;CACrD;AAKD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAqBjE"}