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

package/README.md

@@ -1,5 +1,7 @@
 # @agenticprimitives/orchestration
 
+> Part of **[Agentic Primitives](https://agenticprimitives.dev)** — the open-source trust substrate for agentic applications: identity that can sign, authority checked at act time, evidence the owner carries. [Developer kit](https://github.com/agentictrustlabs/agentic-primitives) · [All packages](https://agenticprimitives.dev/developers)
+
 The Ring-0 **agentic orchestration core**: the intent → plan → execute → observe loop, the `Planner` and
 `ToolInvoker` ports, and a deterministic rule-based planner. A first-party app expresses a **goal**; this
 package plans which tools compose to satisfy it and runs them through an injected invoker — the web never

package/dist/admission.d.ts

@@ -0,0 +1,127 @@
+import type { Intent, Plan, ToolSpec } from './types.js';
+/** Spec 367 §4 — the violation codes. Each names the field at fault and the recovery it allows. */
+export type AdmissionCode = 'REQUIRED_ROLE_UNRESOLVED' | 'RESOURCE_SCOPE_MISMATCH' | 'CAPABILITY_UNAVAILABLE' | 'UNSUPPORTED_BINDING_SOURCE' | 'DEPENDENCY_NOT_SATISFIED' | 'OUTCOME_NOT_ESTABLISHED' | 'BRANCH_UNDECIDABLE' | 'QUESTION_NOT_ANSWERED' | 'EXTERNAL_EXECUTOR_ACT' | 'OUTCOME_NOT_ENTAILED' | 'OUTCOME_BOUND_EXCEEDED' | 'OUTCOME_DISCLOSURE';
+export interface AdmissionViolation {
+    code: AdmissionCode;
+    /** The sentence a planner is re-planned with, and a person is refused with. */
+    message: string;
+    stepIndex?: number;
+    toolId?: string;
+    /** The argument or plan field at fault, when there is one. */
+    field?: string;
+    /** What may fix it: re-plan the means, ask the person, resolve the binding, or refuse. */
+    /** `continue` (spec 421 W1): the plan read what the act needs and stopped — the loop appends `plan.continue` itself. */
+    recovery: 'replan' | 'ask' | 'resolve' | 'refuse' | 'continue';
+}
+export type AdmissionVerdict = {
+    admitted: true;
+} | {
+    admitted: false;
+    violations: AdmissionViolation[];
+};
+export interface AdmissionInput {
+    intent: Intent;
+    plan: Plan;
+    tools: ToolSpec[];
+}
+/** One rule. Pure over its input and whatever deps it closed over; returns the violations it found. */
+export type AdmissionRule = (input: AdmissionInput) => Promise<AdmissionViolation[]> | AdmissionViolation[];
+export interface PlanAdmission {
+    admit(input: AdmissionInput): Promise<AdmissionVerdict>;
+}
+/** Compose rules into the port. Every rule runs; the verdict carries every violation, so a re-plan is
+ *  told everything at once rather than one thing per round. */
+export declare function planAdmission(rules: readonly AdmissionRule[]): PlanAdmission;
+/** Letters only — "Missio Nexus", "missio-nexus" and the label of `missionexus.org` are one word to a person. */
+export declare const squash: (s: string) => string;
+/**
+ * AN INSTRUCTION IS ANSWERED BY AN ACT. A tool that declares a capability declares the verbs that name it
+ * (`ToolSpec.verbs`). A sentence that OPENS with one of those verbs is an instruction, and a plan for it
+ * that contains no capability-bearing step is a read pretending to act — the plan that told a person
+ * "nothing was sent" about a payment they asked for. Which act is not judged here (a message and a
+ * payment both open with "send"); that a step ACTS is.
+ */
+/** What a tool ESTABLISHES (spec 367 §6), with the declared default: a read establishes who was meant; an act
+ *  establishes its outcome unless its contract says it only submits. */
+export declare function outcomeClassOf(t: ToolSpec): 'lookup' | 'submission' | 'authoritative';
+export declare const instructionNeedsAct: AdmissionRule;
+/** A step that consumes `{ $ref: name }` must follow a step that provides `ref: name` (spec 367 §4:
+ *  typed unresolved dependencies — a later step may depend on an earlier one, never on nothing). */
+export declare const dependenciesProvided: AdmissionRule;
+/**
+ * Spec 370 P3 — a branch must be DECIDABLE and an edge must point BACKWARD. `when.ref` names a result an
+ * earlier step binds (`ref`); `after` names ids of earlier steps. A branch on a result nobody produces would
+ * be decided by absence — which is a guess dressed as a condition — and an edge to a later step is a cycle.
+ */
+export declare const branchesDecidable: AdmissionRule;
+export declare const questionAnsweredByRead: AdmissionRule;
+/** A step naming a tool this agent does not expose. Without this rule the loop hard-throws `unknown_tool` and the
+ *  run dies with a raw error and no recovery. As an admission rule it is a RE-PLAN, not a refusal: a missing
+ *  capability is exactly what one more planning round — told which tools the agent has — can fix (the model that
+ *  named `calendar.events.list` on a game persona recovers to a tool it offers, or to an honest "I don't have a
+ *  calendar"). If the re-plan names an unexposed tool again, the loop's second-admission path makes it terminal
+ *  with this same sentence. Recovery `refuse` would skip that round and is wrong here — a missing capability is
+ *  not something no re-plan can fix. */
+export declare const capabilitiesAvailable: AdmissionRule;
+/** A PLACEHOLDER IS NOT AN ARGUMENT. "<UNKNOWN>", "TBD", "n/a" inside a step is a value the person would be
+ *  asked to sign over. Omit the argument and it is asked for; a placeholder is refused. */
+export declare const noPlaceholders: AdmissionRule;
+/** The numbers a sentence states: digits (1,250.50 · 12.5 · $3) and the plain number words. */
+export declare function numbersSaid(sentence: string): number[];
+/**
+ * AN ACT NEVER CARRIES A NUMBER THE PERSON DID NOT SAY. "Pay nathan.treasury back for the hymnals" names no amount; the
+ * planner wrote 12.50, and only the balance check stopped a mandate for a sum she never said (act laboratory,
+ * 2026-09-28). A numeric argument of an ACT step whose value is not among the sentence's numbers is dropped — and the
+ * step then asks for it, as a missing argument always does. Reads are not held to this (a limit on a listing is not
+ * something anyone signs). Deterministic: numbers are compared by value, never by a model.
+ */
+export declare const numbersFromTheWords: AdmissionRule;
+/**
+ * ONE PARTY IS NOT BOTH SIDES OF AN ACT. "Pay nathan.treasury back for the hymnals" was planned with nathan.treasury as
+ * payee AND payer (act laboratory, 2026-09-28) — a mandate for the payee's own authority. The ontology declares each
+ * party argument's side (`PARTY_ROLES`: acting · counterparty · context); an acting argument that names the same party as
+ * a counterparty argument of the same step came from nowhere the person said. The ACTING one is dropped (recovery `ask`):
+ * the declared default then fills it and says why, or the person is asked. `sideOf` is the ontology's, supplied by the app.
+ */
+export declare function partiesDistinct(sideOf: (capability: string, arg: string) => 'acting' | 'counterparty' | 'context' | undefined): AdmissionRule;
+/**
+ * THE ACTING PARTY IS THE PERSON'S TO NAME. When she names no paying account the declared default decides it and says why
+ * (spec 363); a planner that writes one anyway ("my treasury", the payee itself) replaces that decision with words she
+ * never said — and the harness then asks her which treasury she meant by words that were not hers (act laboratory,
+ * 2026-09-28). An ACTING argument (the ontology's side, `sideOf`) with no word of its own in the sentence — words inside
+ * the counterparty's value do not count, nor filler like "my" — is dropped (recovery `ask`): decided or asked for.
+ * An address is left alone (it arrives from a surface or a resolved turn, never from a planner's paraphrase).
+ */
+export declare function actingPartyFromTheWords(sideOf: (capability: string, arg: string) => 'acting' | 'counterparty' | 'context' | undefined): AdmissionRule;
+/**
+ * THE KIND THE PERSON NAMED IS THE KIND CHARTERED. Asked to "start a team … under Missio Nexus" where no team tool was
+ * offered, the planner chartered an ORGANIZATION (act laboratory, 2026-09-28) — the nearest kind, which the tool's own
+ * description forbids in prose. Here it is a rule: `kinds` (the app's chartering capabilities and the words for each —
+ * its noun and its name suffix) — a step chartering kind A when the sentence names kind B and never A is re-planned
+ * with the reason; if nothing charters B, the plan says so rather than making the nearest thing. Dotted names
+ * ("missio-nexus.org") are not words the person used for a kind.
+ */
+export declare function kindNamedIsChartered(kinds: ReadonlyArray<{
+    capability: string;
+    noun: string;
+    words: readonly string[];
+}>): AdmissionRule;
+/**
+ * THE SUBJECT THE SENTENCE NAMES MUST BE IN THE STEP. A tool that declares a `subject` argument (spec 366)
+ * is answered by the agent that argument names. When the sentence contains the name of an agent the asker
+ * KNOWS — from their own links, supplied by the harness, never guessed from the directory — and the step
+ * leaves the subject empty, the step would run against the addressee's own records and answer for the
+ * wrong agent. That is the Missio Nexus incident, as a rule.
+ */
+export declare function subjectNamedInAsk(knownNames: (intent: Intent) => Promise<Array<{
+    name: string;
+    agent: string;
+}>>): AdmissionRule;
+/**
+ * Spec 379 (appendix M4) — AN OUTSIDE AGENT MAY ANSWER, NEVER ACT. A step whose `executor` is outside this
+ * deployment (the caller says which — an https card URL, an address not served here) may run only a
+ * tool that exercises no capability: its answer is an observation. A value-moving or record-changing
+ * step aimed at an outside agent is refused at admission, before any planner or verifier spends anything.
+ */
+export declare function externalExecutorsReadOnly(isExternal: (executor: string) => boolean): AdmissionRule;
+//# sourceMappingURL=admission.d.ts.map

package/dist/admission.d.ts.map

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

package/dist/admission.js

@@ -0,0 +1,355 @@
+import { CONTINUE_STEP_ID } from './types.js';
+/** Compose rules into the port. Every rule runs; the verdict carries every violation, so a re-plan is
+ *  told everything at once rather than one thing per round. */
+export function planAdmission(rules) {
+    return {
+        async admit(input) {
+            const violations = (await Promise.all(rules.map((r) => r(input)))).flat();
+            return violations.length ? { admitted: false, violations } : { admitted: true };
+        },
+    };
+}
+const lc = (s) => s.trim().toLowerCase();
+/** Letters only — "Missio Nexus", "missio-nexus" and the label of `missionexus.org` are one word to a person. */
+export const squash = (s) => lc(s).replace(/[^a-z0-9]+/g, '');
+/** The imperative opening of a sentence, with the polite wrappers stripped: "please send…", "can you pay…",
+ *  "i want to create…" all open with the verb. A question ("who did I send money to") does not. */
+function imperativeOf(goal) {
+    return lc(goal).replace(/^(please\s+|can you\s+|could you\s+|would you\s+|i want to\s+|i'd like to\s+|i would like to\s+|go ahead and\s+)+/, '');
+}
+/**
+ * AN INSTRUCTION IS ANSWERED BY AN ACT. A tool that declares a capability declares the verbs that name it
+ * (`ToolSpec.verbs`). A sentence that OPENS with one of those verbs is an instruction, and a plan for it
+ * that contains no capability-bearing step is a read pretending to act — the plan that told a person
+ * "nothing was sent" about a payment they asked for. Which act is not judged here (a message and a
+ * payment both open with "send"); that a step ACTS is.
+ */
+/** What a tool ESTABLISHES (spec 367 §6), with the declared default: a read establishes who was meant; an act
+ *  establishes its outcome unless its contract says it only submits. */
+export function outcomeClassOf(t) {
+    return t.establishes ?? (t.capability ? 'authoritative' : 'lookup');
+}
+export const instructionNeedsAct = ({ intent, plan, tools }) => {
+    const opening = imperativeOf(intent.goal);
+    const acts = tools.filter((t) => t.capability && t.verbs?.length);
+    // "TELL ME about…" / "message me when…" is the person asking HER OWN AGENT, not an instruction to reach someone: the
+    // verb's object is the speaker. A question in that form was refused as an unperformed act ("Tell me about the
+    // articles in my library" → plan messaging.direct.send — live 2026-09-21). "tell melissa" still claims the verb.
+    const selfDirected = (v) => new RegExp(`^${lc(v).replace(/[.*+?^${}()|[\]\\]/g, '\\$&')} (me|us)\\b`).test(opening);
+    // A clause may carry the verb too (spec 421): "read my latest message AND REPLY to whoever sent it" instructs a reply.
+    const clauses = [opening, ...opening.split(/\s*[—–;:,]\s*|\s+(?:and then|then|and)\s+/).slice(1)];
+    const claims = (t) => !!t.verbs?.some((v) => clauses.some((c) => (c === lc(v) || c.startsWith(`${lc(v)} `)) && !new RegExp(`^${lc(v).replace(/[.*+?^${}()|[\]\\]/g, '\\$&')} (me|us)\\b`).test(c)));
+    const named = acts.filter(claims);
+    if (!named.length)
+        return [];
+    const byId = new Map(tools.map((t) => [t.id, t]));
+    // A READ MAY CLAIM THE VERB TOO (spec 379): "ask the clock what time it is" opens with "ask", which an
+    // invitation act also claims. When a lookup in the plan declares that verb, the read IS what was
+    // instructed — consulting an outside agent — and the plan discharges the sentence by doing it.
+    if (plan.steps.some((s) => { const t = byId.get(s.toolId); return !!t && !t.capability && claims(t); }))
+        return [];
+    // The outcome rule (§6), not a "last tool" rule: a lookup may precede the act (who is "my daughter"), and
+    // a notification may follow it. What may not happen is a plan whose every step only ESTABLISHES WHO WAS
+    // MEANT — a lookup cannot discharge an instruction, however well it went.
+    const canDischarge = plan.steps.some((s) => { const t = byId.get(s.toolId); return !!t && outcomeClassOf(t) !== 'lookup'; });
+    if (canDischarge)
+        return [];
+    // Spec 421 W1 — A PLAN THAT READS AND THEN CONTINUES has deferred the act, not skipped it: the act is planned from what
+    // the reads return, and that continuation plan is admitted by this same rule before anything in it runs.
+    if (plan.steps[plan.steps.length - 1]?.toolId === CONTINUE_STEP_ID)
+        return [];
+    const canContinue = tools.some((t) => t.id === CONTINUE_STEP_ID);
+    // With continuation on and something READ, the plan has gathered what the act needs and stopped short: the recovery is to
+    // continue from what it reads (deterministic — the harness does not wait for a model to notice the option).
+    const readSomething = plan.steps.some((s) => { const t = byId.get(s.toolId); return !!t && !t.capability; });
+    return [{
+            code: 'OUTCOME_NOT_ESTABLISHED', recovery: canContinue && readSomething ? 'continue' : 'replan',
+            message: `"${intent.goal}" is an instruction (it opens with ${named.map((t) => `"${t.verbs[0]}"`).join(' / ')}) and every step in the plan only looks something up (${plan.steps.map((s) => s.toolId).join(', ') || 'nothing'}) — a lookup cannot establish that it was done. Plan the capability that performs it — ${named.map((t) => t.id).join(' or ')} — and pass the person's words as its arguments; it resolves who is meant itself.${canContinue ? ` If its arguments are in something you must read first (a message, a record), plan that read and end the plan with ${CONTINUE_STEP_ID}: you will be shown what it returned and plan the act from it.` : ''}`,
+        }];
+};
+/** A step that consumes `{ $ref: name }` must follow a step that provides `ref: name` (spec 367 §4:
+ *  typed unresolved dependencies — a later step may depend on an earlier one, never on nothing). */
+export const dependenciesProvided = ({ plan }) => {
+    const out = [];
+    const provided = new Set();
+    plan.steps.forEach((s, i) => {
+        const refs = new Set();
+        const walk = (v) => {
+            if (!v || typeof v !== 'object')
+                return;
+            if (Array.isArray(v)) {
+                v.forEach(walk);
+                return;
+            }
+            const o = v;
+            if (typeof o.$ref === 'string')
+                refs.add(o.$ref.split('.')[0]);
+            if (typeof o.$forEach === 'string')
+                refs.add(o.$forEach.split('.')[0]);
+            Object.values(o).forEach(walk);
+        };
+        walk(s.args);
+        // The fan-out form (spec 358 W4): `forEach: { ref: 'roster.members' }` names the enumerating step by ref.
+        const fe = s.forEach;
+        if (fe && typeof fe.ref === 'string')
+            refs.add(fe.ref.split('.')[0]);
+        for (const r of refs)
+            if (!provided.has(r))
+                out.push({ code: 'DEPENDENCY_NOT_SATISFIED', recovery: 'replan', stepIndex: i, toolId: s.toolId, field: r, message: `step ${i + 1} (${s.toolId}) uses "${r}" before any step provides it — order the step that produces "${r}" first, or drop the reference.` });
+        if (s.ref)
+            provided.add(s.ref);
+    });
+    return out;
+};
+/**
+ * Spec 370 P3 — a branch must be DECIDABLE and an edge must point BACKWARD. `when.ref` names a result an
+ * earlier step binds (`ref`); `after` names ids of earlier steps. A branch on a result nobody produces would
+ * be decided by absence — which is a guess dressed as a condition — and an edge to a later step is a cycle.
+ */
+export const branchesDecidable = ({ plan }) => {
+    const out = [];
+    const provided = new Set();
+    const ids = new Set();
+    plan.steps.forEach((s, i) => {
+        const w = s.when;
+        if (w && (typeof w.ref !== 'string' || !provided.has(w.ref.split('.')[0]))) {
+            out.push({ code: 'BRANCH_UNDECIDABLE', recovery: 'replan', stepIndex: i, toolId: s.toolId, field: 'when', message: `step ${i + 1} (${s.toolId}) branches on "${String(w.ref ?? '')}", which no earlier step produces — bind the producing step with $ref first, or drop the condition.` });
+        }
+        for (const id of s.after ?? []) {
+            if (typeof id !== 'string' || !ids.has(id))
+                out.push({ code: 'BRANCH_UNDECIDABLE', recovery: 'replan', stepIndex: i, toolId: s.toolId, field: 'after', message: `step ${i + 1} (${s.toolId}) waits for "${String(id)}", which is not an earlier step's id.` });
+        }
+        if (s.ref)
+            provided.add(s.ref);
+        ids.add(s.id ?? `s${i}`);
+    });
+    return out;
+};
+/**
+ * Spec 371 — THE QUESTION MUST BE ANSWERED BY THE READ THAT ANSWERS IT. A read declares the fact words a
+ * question uses to name what it establishes (`answers`: "balance", "how much"). When the sentence names
+ * such a fact and an exposed tool answers it, a plan without that tool is answering something else — a
+ * survey of receipts for a balance question. The rule reads declarations only, and it says which tool.
+ */
+/**
+ * WHAT SOMEBODY SAID, NOT WHAT WAS ATTACHED TO IT. An ask on the A2A surface carries its material in the
+ * same string as its sentence — a card table sends the seat's view, a mystery sends the character's whole
+ * night — and this rule strips punctuation before matching, so `"holds":["the register key"]` inside that
+ * payload reads exactly like the word "holds" in a question about money.
+ *
+ * Live, that cost a murder mystery 39% of its moments: `treasury.balance.read` answers "holds", a character
+ * carrying a clue has `holds` in her view, and every such ask was refused with "use treasury.balance.read
+ * for that" — a balance tool demanded of a woman in mourning in a hotel. The plan was right, the sentence
+ * never mentioned money, and `replanning: false` made it terminal, so the character simply went quiet.
+ *
+ * A tool's `answers` words are how a PERSON names what they want. A serialized object is not something
+ * anyone said, so it is removed before the sentence is read.
+ */
+const SENTENCE_ONLY = (goal) => {
+    let out = '';
+    let depth = 0;
+    for (const ch of goal) {
+        if (ch === '{' || ch === '[') {
+            depth++;
+            continue;
+        }
+        if (ch === '}' || ch === ']') {
+            if (depth > 0)
+                depth--;
+            continue;
+        }
+        if (depth === 0)
+            out += ch;
+    }
+    return out;
+};
+export const questionAnsweredByRead = ({ intent, plan, tools }) => {
+    // An INSTRUCTION names the thing it acts on: "add dave to my contacts" names "my contacts" because the contact invite
+    // changes them — refusing it for "a survey" (act laboratory, 2026-09-28) turned a valid act into a refusal. The rule
+    // guards a QUESTION answered by the wrong read; a plan that ACTS is not answering a question.
+    const byId = new Map(tools.map((t) => [t.id, t]));
+    if (plan.steps.some((s) => byId.get(s.toolId)?.capability))
+        return [];
+    const goal = ` ${lc(SENTENCE_ONLY(intent.goal)).replace(/[^a-z0-9]+/g, ' ')} `;
+    const out = [];
+    const inPlan = new Set(plan.steps.map((s) => s.toolId));
+    for (const t of tools) {
+        if (!t.answers?.length || inPlan.has(t.id))
+            continue;
+        const named = t.answers.find((w) => goal.includes(` ${lc(w).replace(/[^a-z0-9]+/g, ' ')} `));
+        if (!named)
+            continue;
+        out.push({ code: 'QUESTION_NOT_ANSWERED', recovery: 'replan', toolId: t.id, field: named, message: `the sentence asks about "${named}", which ${t.id} answers, and the plan does not use it — use ${t.id} for that, not a survey of other records.` });
+    }
+    return out;
+};
+/** A step naming a tool this agent does not expose. Without this rule the loop hard-throws `unknown_tool` and the
+ *  run dies with a raw error and no recovery. As an admission rule it is a RE-PLAN, not a refusal: a missing
+ *  capability is exactly what one more planning round — told which tools the agent has — can fix (the model that
+ *  named `calendar.events.list` on a game persona recovers to a tool it offers, or to an honest "I don't have a
+ *  calendar"). If the re-plan names an unexposed tool again, the loop's second-admission path makes it terminal
+ *  with this same sentence. Recovery `refuse` would skip that round and is wrong here — a missing capability is
+ *  not something no re-plan can fix. */
+export const capabilitiesAvailable = ({ plan, tools }) => {
+    const ids = new Set(tools.map((t) => t.id));
+    return plan.steps.flatMap((s, i) => ids.has(s.toolId) ? [] : [{ code: 'CAPABILITY_UNAVAILABLE', recovery: 'replan', stepIndex: i, toolId: s.toolId, message: `step ${i + 1} names "${s.toolId}", which this agent does not offer — choose among: ${[...ids].join(', ')}.` }]);
+};
+/** A PLACEHOLDER IS NOT AN ARGUMENT. "<UNKNOWN>", "TBD", "n/a" inside a step is a value the person would be
+ *  asked to sign over. Omit the argument and it is asked for; a placeholder is refused. */
+export const noPlaceholders = ({ plan }) => plan.steps.flatMap((s, i) => Object.entries(s.args)
+    .filter(([, v]) => typeof v === 'string' && /^<.*>$|^(unknown|tbd|n\/a|null|undefined|placeholder)$/i.test(v.trim()))
+    .map(([k, v]) => ({ code: 'UNSUPPORTED_BINDING_SOURCE', recovery: 'ask', stepIndex: i, toolId: s.toolId, field: k, message: `step ${i + 1} (${s.toolId}) carries a placeholder for "${k}" (${String(v)}); omit an argument the sentence did not give, and it will be asked for.` })));
+const NUMBER_WORDS = { zero: 0, one: 1, a: 1, an: 1, two: 2, three: 3, four: 4, five: 5, six: 6, seven: 7, eight: 8, nine: 9, ten: 10, eleven: 11, twelve: 12, fifteen: 15, twenty: 20, thirty: 30, forty: 40, fifty: 50, hundred: 100 };
+/** The numbers a sentence states: digits (1,250.50 · 12.5 · $3) and the plain number words. */
+export function numbersSaid(sentence) {
+    const out = [...sentence.replace(/(\d),(\d{3})/g, '$1$2').matchAll(/\d+(?:\.\d+)?/g)].map((m) => Number(m[0]));
+    for (const w of lc(sentence).split(/[^a-z]+/))
+        if (w in NUMBER_WORDS && w !== 'a' && w !== 'an')
+            out.push(NUMBER_WORDS[w]);
+    // "a dollar", "an usdc" — one, only where a unit follows.
+    if (/\ban?\s+(?:dollar|buck|usdc)\b/i.test(sentence))
+        out.push(1);
+    return out;
+}
+const NUMERIC = /^\s*\$?\d+(?:\.\d+)?\s*$/;
+/**
+ * AN ACT NEVER CARRIES A NUMBER THE PERSON DID NOT SAY. "Pay nathan.treasury back for the hymnals" names no amount; the
+ * planner wrote 12.50, and only the balance check stopped a mandate for a sum she never said (act laboratory,
+ * 2026-09-28). A numeric argument of an ACT step whose value is not among the sentence's numbers is dropped — and the
+ * step then asks for it, as a missing argument always does. Reads are not held to this (a limit on a listing is not
+ * something anyone signs). Deterministic: numbers are compared by value, never by a model.
+ */
+export const numbersFromTheWords = ({ intent, plan, tools }) => {
+    const byId = new Map(tools.map((t) => [t.id, t]));
+    const said = numbersSaid(SENTENCE_ONLY(intent.goal));
+    return plan.steps.flatMap((s, i) => (byId.get(s.toolId)?.capability ? Object.entries(s.args) : [])
+        .filter(([, v]) => (typeof v === 'number' && Number.isFinite(v)) || (typeof v === 'string' && NUMERIC.test(v)))
+        .filter(([, v]) => { const n = Number(String(v).replace(/[$\s]/g, '')); return !said.some((x) => Math.abs(x - n) < 1e-9); })
+        .map(([k, v]) => ({ code: 'UNSUPPORTED_BINDING_SOURCE', recovery: 'ask', stepIndex: i, toolId: s.toolId, field: k, message: `step ${i + 1} (${s.toolId}) carries ${k} = ${String(v)}, a number the sentence does not state; omit it and it will be asked for.` })));
+};
+/**
+ * ONE PARTY IS NOT BOTH SIDES OF AN ACT. "Pay nathan.treasury back for the hymnals" was planned with nathan.treasury as
+ * payee AND payer (act laboratory, 2026-09-28) — a mandate for the payee's own authority. The ontology declares each
+ * party argument's side (`PARTY_ROLES`: acting · counterparty · context); an acting argument that names the same party as
+ * a counterparty argument of the same step came from nowhere the person said. The ACTING one is dropped (recovery `ask`):
+ * the declared default then fills it and says why, or the person is asked. `sideOf` is the ontology's, supplied by the app.
+ */
+export function partiesDistinct(sideOf) {
+    return ({ plan, tools }) => {
+        const byId = new Map(tools.map((t) => [t.id, t]));
+        return plan.steps.flatMap((s, i) => {
+            const cap = byId.get(s.toolId)?.capability?.id;
+            if (!cap)
+                return [];
+            const named = Object.entries(s.args).filter(([, v]) => typeof v === 'string' && v.trim()).map(([k, v]) => ({ k, v: squash(String(v)), side: sideOf(cap, k) }));
+            return named.filter((a) => a.side === 'acting' && named.some((b) => b.side === 'counterparty' && b.v === a.v))
+                .map((a) => ({ code: 'UNSUPPORTED_BINDING_SOURCE', recovery: 'ask', stepIndex: i, toolId: s.toolId, field: a.k, message: `step ${i + 1} (${s.toolId}) names the same party as ${a.k} and as its counterparty; the ${a.k} was not said — omit it and it will be decided or asked for.` }));
+        });
+    };
+}
+const FILLER = new Set(['my', 'our', 'the', 'a', 'an', 'your', 'his', 'her', 'their', 'from', 'of', 'account', 'me', 'mine']);
+/** Words that name THE ROOM (the agent asked) — a planner writing them for an acting party is not inventing one; the resolver
+ *  turns them into the room (spec 418 §12 "us"). */
+const ROOM_WORDS = new Set(['us', 'we', 'our', 'ours', 'ourselves', 'self', 'itself', 'this agent', 'the agent', 'this organization', 'this org', 'the organization', 'the org', 'this team', 'the team', 'this household', 'this workspace']);
+const wordsOf = (v) => lc(v).split(/[^a-z0-9]+/).filter((w) => w && !FILLER.has(w));
+/**
+ * THE ACTING PARTY IS THE PERSON'S TO NAME. When she names no paying account the declared default decides it and says why
+ * (spec 363); a planner that writes one anyway ("my treasury", the payee itself) replaces that decision with words she
+ * never said — and the harness then asks her which treasury she meant by words that were not hers (act laboratory,
+ * 2026-09-28). An ACTING argument (the ontology's side, `sideOf`) with no word of its own in the sentence — words inside
+ * the counterparty's value do not count, nor filler like "my" — is dropped (recovery `ask`): decided or asked for.
+ * An address is left alone (it arrives from a surface or a resolved turn, never from a planner's paraphrase).
+ */
+export function actingPartyFromTheWords(sideOf) {
+    return ({ intent, plan, tools }) => {
+        const byId = new Map(tools.map((t) => [t.id, t]));
+        return plan.steps.flatMap((s, i) => {
+            const cap = byId.get(s.toolId)?.capability?.id;
+            if (!cap)
+                return [];
+            const strArgs = Object.entries(s.args).filter((e) => typeof e[1] === 'string' && !!e[1].trim());
+            let sentence = ` ${lc(SENTENCE_ONLY(intent.goal))} `;
+            for (const [k, v] of strArgs)
+                if (sideOf(cap, k) === 'counterparty')
+                    sentence = sentence.split(lc(v)).join(' ');
+            const said = new Set(wordsOf(sentence));
+            return strArgs.filter(([k, v]) => sideOf(cap, k) === 'acting' && !/^0x[0-9a-f]{40}$/i.test(v.trim()) && !ROOM_WORDS.has(lc(v).trim()) && !wordsOf(v).some((w) => said.has(w)))
+                .map(([k, v]) => ({ code: 'UNSUPPORTED_BINDING_SOURCE', recovery: 'ask', stepIndex: i, toolId: s.toolId, field: k, message: `step ${i + 1} (${s.toolId}) names ${k} "${v}", which the sentence does not; omit it and it will be decided or asked for.` }));
+        });
+    };
+}
+/**
+ * THE KIND THE PERSON NAMED IS THE KIND CHARTERED. Asked to "start a team … under Missio Nexus" where no team tool was
+ * offered, the planner chartered an ORGANIZATION (act laboratory, 2026-09-28) — the nearest kind, which the tool's own
+ * description forbids in prose. Here it is a rule: `kinds` (the app's chartering capabilities and the words for each —
+ * its noun and its name suffix) — a step chartering kind A when the sentence names kind B and never A is re-planned
+ * with the reason; if nothing charters B, the plan says so rather than making the nearest thing. Dotted names
+ * ("missio-nexus.org") are not words the person used for a kind.
+ */
+export function kindNamedIsChartered(kinds) {
+    const byCap = new Map(kinds.map((k) => [k.capability, k]));
+    return ({ intent, plan }) => {
+        const sentence = ` ${lc(SENTENCE_ONLY(intent.goal)).replace(/\S+\.[a-z0-9-]+\S*/g, ' ').replace(/[^a-z0-9]+/g, ' ')} `;
+        const said = (k) => k.words.some((w) => sentence.includes(` ${lc(w)} `) || sentence.includes(` ${lc(w)}s `));
+        return plan.steps.flatMap((s, i) => {
+            const mine = byCap.get(s.toolId);
+            if (!mine || said(mine))
+                return [];
+            const named = kinds.filter((k) => k.capability !== mine.capability && said(k));
+            return named.length ? [{ code: 'OUTCOME_NOT_ESTABLISHED', recovery: 'replan', stepIndex: i, toolId: s.toolId, message: `the sentence asks for a ${named[0].noun}; ${s.toolId} charters a ${mine.noun}. Use the tool that charters a ${named[0].noun}; if none is offered here, say this agent cannot — never charter the nearest kind.` }] : [];
+        });
+    };
+}
+/**
+ * THE SUBJECT THE SENTENCE NAMES MUST BE IN THE STEP. A tool that declares a `subject` argument (spec 366)
+ * is answered by the agent that argument names. When the sentence contains the name of an agent the asker
+ * KNOWS — from their own links, supplied by the harness, never guessed from the directory — and the step
+ * leaves the subject empty, the step would run against the addressee's own records and answer for the
+ * wrong agent. That is the Missio Nexus incident, as a rule.
+ */
+export function subjectNamedInAsk(knownNames) {
+    return async ({ intent, plan, tools }) => {
+        const byId = new Map(tools.map((t) => [t.id, t]));
+        const candidates = plan.steps.map((s, i) => ({ s, i, tool: byId.get(s.toolId) }))
+            .filter(({ s, tool }) => tool?.subject && !String(s.args[tool.subject] ?? '').trim());
+        if (!candidates.length)
+            return [];
+        const goal = squash(intent.goal);
+        const names = (await knownNames(intent).catch(() => [])).filter((n) => n.name && !/^0x[0-9a-f]{40}$/i.test(n.name));
+        const named = names.filter((n) => {
+            const full = squash(n.name);
+            const label = squash(n.name.split('.')[0] ?? '');
+            return (full.length >= 4 && goal.includes(full)) || (label.length >= 4 && goal.includes(label));
+        })
+            // The agent BEING ASKED is the room: an empty subject there already means it ("what is Missio Nexus's balance", asked
+            // at missio-nexus.org, was refused for leaving the account empty — 2026-09-28).
+            .filter((n) => String(n.agent).toLowerCase() !== String(intent.context?.addressee ?? '').toLowerCase());
+        if (!named.length)
+            return [];
+        return candidates.map(({ s, i, tool }) => ({
+            code: 'REQUIRED_ROLE_UNRESOLVED', recovery: 'resolve', stepIndex: i, toolId: s.toolId, field: tool.subject,
+            message: `the ask names ${named.map((n) => `"${n.name}"`).join(' / ')} and step ${i + 1} (${s.toolId}) names no ${tool.subject}; pass the name the person used as "${tool.subject}".`,
+        }));
+    };
+}
+/**
+ * Spec 379 (appendix M4) — AN OUTSIDE AGENT MAY ANSWER, NEVER ACT. A step whose `executor` is outside this
+ * deployment (the caller says which — an https card URL, an address not served here) may run only a
+ * tool that exercises no capability: its answer is an observation. A value-moving or record-changing
+ * step aimed at an outside agent is refused at admission, before any planner or verifier spends anything.
+ */
+export function externalExecutorsReadOnly(isExternal) {
+    return ({ plan, tools }) => {
+        const out = [];
+        plan.steps.forEach((st, i) => {
+            const ex = st.executor;
+            if (typeof ex !== 'string' || !ex || !isExternal(ex))
+                return;
+            const tool = tools.find((t) => t.id === st.toolId);
+            if (tool?.capability)
+                out.push({ code: 'EXTERNAL_EXECUTOR_ACT', recovery: 'refuse', stepIndex: i, toolId: st.toolId, field: 'executor', message: `step ${i + 1} (${st.toolId}) exercises ${tool.capability.id} and names ${ex} to run it — an outside agent may answer a question, never perform an act; run the step here or drop it.` });
+        });
+        return out;
+    };
+}
+//# sourceMappingURL=admission.js.map

package/dist/admission.js.map

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

package/dist/answer-quality.d.ts

@@ -0,0 +1,80 @@
+import type { StructuredCallLike } from './selection.js';
+export declare const ANSWER_QUALITY_JUDGE: {
+    name: string;
+    kind: "model";
+};
+/** The rubric: each a statement the judge gives P(true) for. Stable ids — a changed rubric is a new judge name (J5). */
+export declare const ANSWER_QUALITY_RUBRIC: ReadonlyArray<{
+    id: string;
+    statement: string;
+}>;
+export interface AnswerQualityV1 {
+    judge: typeof ANSWER_QUALITY_JUDGE;
+    /** P(true) per rubric question. */
+    scores: Record<string, number>;
+    /** Their mean — the quality number a comparison reads. */
+    score: number;
+    ms: number;
+    error?: string;
+}
+/** Judge one answer. The answer is truncated to `maxChars` (the judge reads a bounded state). */
+export declare function judgeAnswerQuality(input: {
+    request: string;
+    skillCard: string;
+    answer: string;
+    maxChars?: number;
+}, call: StructuredCallLike): Promise<AnswerQualityV1>;
+export declare const ANSWER_PREFERENCE_JUDGE: {
+    name: string;
+    kind: "model";
+};
+export interface AnswerPreferenceV1 {
+    judge: typeof ANSWER_PREFERENCE_JUDGE;
+    preference: Record<string, number>;
+    permutations: {
+        asked: number;
+        answered: number;
+    };
+    ms: number;
+    error?: string;
+}
+export declare function judgeAnswerPreference(input: {
+    request: string;
+    skillCard: string;
+    answers: Record<string, string>;
+    maxChars?: number;
+}, call: StructuredCallLike): Promise<AnswerPreferenceV1>;
+export declare const OUTCOME_CHECK_JUDGE: {
+    name: string;
+    kind: "model";
+};
+/** One scoring unit: a single class (`id` = its IRI), or an alternative group (`id` = `alternative:<group>`). */
+export interface OutcomeUnitV1 {
+    id: string;
+    members: string[];
+    requested: number;
+    delivered: number;
+    counted: boolean;
+    required?: true;
+}
+export interface OutcomeCheckV1 {
+    judge: typeof OUTCOME_CHECK_JUDGE;
+    classes: Record<string, number>;
+    requested: Record<string, number>;
+    units?: OutcomeUnitV1[];
+    score: number;
+    ms: number;
+    error?: string;
+}
+export declare function judgeOutcomeDelivered(input: {
+    request: string;
+    answer: string;
+    expected: ReadonlyArray<{
+        iri: string;
+        label: string;
+        required?: boolean;
+        alternative?: string;
+    }>;
+    maxChars?: number;
+}, call: StructuredCallLike): Promise<OutcomeCheckV1>;
+//# sourceMappingURL=answer-quality.d.ts.map

package/dist/answer-quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer-quality.d.ts","sourceRoot":"","sources":["../src/answer-quality.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,eAAO,MAAM,oBAAoB;;;CAAiE,CAAC;AAEnG,wHAAwH;AACxH,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAMlF,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,oBAAoB,CAAC;IACnC,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,iGAAiG;AACjG,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAS7K;AAKD,eAAO,MAAM,uBAAuB;;;CAAoE,CAAC;AACzG,MAAM,WAAW,kBAAkB;IAAG,KAAK,EAAE,OAAO,uBAAuB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AAEhM,wBAAsB,qBAAqB,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAQpM;AAkBD,eAAO,MAAM,mBAAmB;;;CAAgE,CAAC;AACjG,iHAAiH;AACjH,MAAM,WAAW,aAAa;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,IAAI,CAAA;CAAE;AACzI,MAAM,WAAW,cAAc;IAAG,KAAK,EAAE,OAAO,mBAAmB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AAE7M,wBAAsB,qBAAqB,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CAoC/P"}