@agenticprimitives/fabric 0.0.0-alpha.1 → 0.0.0-alpha.4

package/dist/messaging/consult-routing.js

@@ -0,0 +1,455 @@
+// Org-side member routing — pure substrate (spec 329 W2/W3; the org sibling of ./consult.ts).
+// This module owns validated PURE decisions only: candidate ELIGIBILITY (roster ∩ topic
+// participants ∩ consultable hint ∩ grant-present — consent is structural, never planner
+// authority), the spec-281 filter→score→surface RANKING over public discovery facets (degrading
+// fail-open to FEWER signals, never to more candidates), the depth-1 routing-tools guard, the
+// consult-request builder (bounded context), and the turn-2 synthesis attribution/PROV shapes.
+// Discovery I/O, DO custody, rate buckets, signing, and audit are the EXECUTION POINT's (demo-a2a).
+import { CONSULT_QUESTION_MAX_CHARS, CONSULT_TAIL_CLIP, CONSULT_TAIL_MAX_ROWS, CONSULT_MEMBER_TIMEOUT_MS, consultGrantRecordKey, } from './consult.js';
+import { channelParticipationPolicy } from './board.js';
+/** Org-DO pending-consult ring key (spec 329 §4.1). */
+export const routingPendingKey = (topicId, questionId) => `routing.pending:${topicId}:${questionId}`;
+/** ConsultationIntent description-record key (spec 329 §5) — one per consulted member. */
+export const consultationIntentKey = (questionId, memberSA) => `routing.consult:${questionId}:${memberSA.toLowerCase()}`;
+/**
+ * roster ∩ topic participants ∩ consultable-hinted ∩ grant-present. Fail-closed on consent from
+ * BOTH directions (spec 329 §2.2): flag without grant ⇒ excluded; grant without flag ⇒ excluded.
+ * Restricted topics consult `canSeeChannel` participants only (a member is never asked about a
+ * conversation they cannot see); the org itself is never a candidate (org agents are not
+ * consultable — §4 loop prevention).
+ */
+export function eligibleConsultMembers(args) {
+    const grants = new Set(args.grantMembers.map((m) => m.toLowerCase()));
+    const org = args.orgSA.toLowerCase();
+    const restricted = channelParticipationPolicy(args.channel) === 'restricted';
+    const participants = new Set((args.channel.members ?? []).map((m) => m.toLowerCase()));
+    const out = [];
+    const seen = new Set();
+    for (const row of args.roster) {
+        if (!row.current || row.consultable !== true)
+            continue;
+        const memberSA = (row.subject.match(/0x[0-9a-fA-F]{40}$/)?.[0] ?? '').toLowerCase();
+        if (!memberSA || memberSA === org || seen.has(memberSA))
+            continue;
+        if (!grants.has(memberSA))
+            continue; // hint without authority ⇒ not consultable (fail-closed)
+        if (restricted && !participants.has(memberSA))
+            continue; // §2.3 structural topic scope
+        seen.add(memberSA);
+        const orgRole = row.orgRole?.trim();
+        out.push({ memberSA, displayName: row.displayName || memberSA, ...(orgRole ? { orgRole } : {}) });
+    }
+    return out;
+}
+const W_FIT = 0.6;
+const W_TRUST = 0.4;
+/** Parse a comma-separated on-chain code list into a lowercased set. Empty/absent ⇒ empty set — an
+ *  agent that has not published a facet is UNKNOWN, not universal (spec 331 §4.3). */
+const codeSet = (v) => (v ?? '').split(',').map((s) => s.trim().toLowerCase()).filter(Boolean);
+/** BCP-47: a member publishing `pt-br` satisfies a request for `pt`, never the reverse. Substring
+ *  comparison is forbidden here — it makes `en` match `zh-Hant` via no meaningful relation, which is
+ *  the class of accident this migration removes. */
+const langMatches = (have, want) => have.some((h) => h === want || h.startsWith(`${want}-`));
+/** Parse the spec-282 comma-joined `atl:skills` assertion into clean labels (bounded). */
+function skillLabels(csv) {
+    if (!csv)
+        return [];
+    return csv.split(',').map((s) => s.trim()).filter(Boolean).slice(0, 32);
+}
+/**
+ * Structured fit (spec 331 §4.2), mirroring demo-discovery-a2a's `fitScore` term for term:
+ *
+ *   0.55 capabilityMatch · 0.15 specializationMatch · 0.10 regionMatch
+ * · 0.10 languageMatch   · 0.10 focusMatch          · 0.15 lexicalFallback (gated)
+ *
+ * WHY THE CATALOG IS NOT LOADED HERE. `need` resolution is an org-side act performed once per
+ * question against a catalog this package must not own — an advisory vocabulary is a downstream
+ * domain artifact. So the caller hands in `StructuredNeedV1` already resolved and DAG-expanded, and
+ * this function scores structure it is given. A caller that resolves nothing gets exactly the old
+ * lexical behaviour, which is why adopting this is not a flag day.
+ *
+ * Absence is never a penalty: a member who published no regions scores 0 on `regionMatch`, the same
+ * as one whose regions did not match. Not matching costs the boost, never the seat.
+ */
+function fitOf(f, need, skillHints, cites, structured = {}) {
+    const declared = (f.capabilityIds ?? []).map((x) => x.toLowerCase());
+    const needed = (structured.capabilityIds ?? []).map((x) => x.toLowerCase());
+    let s = 0;
+    const exact = needed.filter((id) => declared.includes(id));
+    if (needed.length && exact.length) {
+        s += 0.55 * (exact.length / needed.length);
+        for (const id of exact)
+            cites.push(`declared ${id} (exact)`);
+    }
+    const specIds = (structured.specializationIds ?? []).map((x) => x.toLowerCase());
+    const specHits = declared.filter((id) => specIds.includes(id) && !exact.includes(id));
+    if (specHits.length) {
+        s += 0.15;
+        for (const id of specHits)
+            cites.push(`declared ${id}, specializes a requested capability`);
+    }
+    // Claimed-capability tier — declared AND independently endorsed beats a bare declaration. Only a
+    // capability the member DECLARED and that was ASKED FOR (`exact`) can be boosted; the endorsement's
+    // independence (self ignored, volume deduped, same-org discounted, staleness decayed) was settled by the
+    // transport, so `endorsedCapabilityIds` is already trustworthy. Capped HARD (+0.05 each, ≤0.10 total):
+    // endorsement corroborates a declared capability, never manufactures one — a gameable boost is worse than
+    // none (the explicit bar), and the cap also contains any same-org collusion the transport could not see.
+    const endorsed = new Set((f.endorsedCapabilityIds ?? []).map((x) => x.toLowerCase()));
+    const endorsedHits = exact.filter((id) => endorsed.has(id));
+    if (endorsedHits.length) {
+        s += Math.min(0.10, 0.05 * endorsedHits.length);
+        for (const id of endorsedHits)
+            cites.push(`declared ${id} AND independently endorsed (claimed tier)`);
+    }
+    const regions = codeSet(f.regions);
+    const wantRegions = (structured.regions ?? []).map((r) => r.toLowerCase());
+    const matchedRegions = [...new Set(wantRegions.filter((r) => regions.includes(r)))];
+    if (wantRegions.length && matchedRegions.length) {
+        s += 0.10 * Math.min(1, matchedRegions.length / wantRegions.length);
+        cites.push(`covers ${matchedRegions.map((r) => r.toUpperCase()).join(', ')} (requested)`);
+    }
+    const langs = codeSet(f.languages);
+    const wantLangs = (structured.languages ?? []).map((l) => l.toLowerCase());
+    const matchedLangs = wantLangs.filter((l) => langMatches(langs, l));
+    if (wantLangs.length && matchedLangs.length) {
+        s += 0.10 * Math.min(1, matchedLangs.length / wantLangs.length);
+        cites.push(`speaks ${matchedLangs.join(', ')} (requested)`);
+    }
+    const focus = codeSet(f.focusAreas);
+    const matchedFocus = (structured.focusAreas ?? []).map((x) => x.toLowerCase())
+        .filter((x) => focus.some((y) => y.includes(x) || x.includes(y)));
+    if (matchedFocus.length) {
+        s += Math.min(0.10, 0.05 * matchedFocus.length);
+        cites.push(`focus: ${matchedFocus.join(', ')}`);
+    }
+    // Hack #3 demoted, not deleted. Fires ONLY when the caller resolved no capability id, and says so
+    // in the evidence — so a result carried by a substring coincidence is inspectable rather than
+    // indistinguishable from a structured one (ADR-0013).
+    const lexicalOnly = needed.length === 0;
+    if (lexicalOnly) {
+        const hay = [f.name, f.displayName, f.description, f.skills].filter(Boolean).join(' ').toLowerCase();
+        const wanted = need.trim().toLowerCase();
+        let lex = 0;
+        if (!wanted)
+            lex = 0.15;
+        else {
+            const toks = wanted.split(/\s+/).filter((t) => t.length > 2);
+            const hits = toks.filter((t) => hay.includes(t)).length;
+            lex = toks.length ? hits / toks.length : 0.15;
+        }
+        for (const sk of skillHints)
+            if (hay.includes(sk.toLowerCase()))
+                lex = Math.min(1, lex + 0.2);
+        if (lex > 0) {
+            s += 0.15 * lex;
+            cites.push('— no capability id resolved from the question; lexical fallback only');
+        }
+    }
+    return {
+        score: Math.min(s, 1),
+        capabilityHits: exact.length + specHits.length,
+        regionHits: matchedRegions.length,
+        lexicalOnly,
+        endorsedCapabilityIds: endorsedHits,
+    };
+}
+function trustOf(f, cites) {
+    let s = 0;
+    if (f.registered) {
+        s += 0.5;
+        cites.push('active registry entry');
+    }
+    if (f.shaclConforms) {
+        s += 0.2;
+        cites.push('SHACL-conformant');
+    }
+    const n = f.facets?.length ?? 0;
+    s += Math.min(n, 5) * 0.06;
+    if (n)
+        cites.push(`${n} on-chain facet(s)`);
+    // Claimed-capability tier corroboration — DISTINCT non-self endorsers (self & volume already excluded).
+    // Capped below registration and saturating fast: an endorsement is cheap, so it corroborates, never
+    // authorises (ADR-0040), and undetected same-org collusion is contained by the cap.
+    const e = f.independentEndorsers ?? 0;
+    if (e > 0) {
+        s += Math.min(0.10, 0.05 * e);
+        cites.push(`${e} independent endorser(s)`);
+    }
+    return Math.min(s, 1);
+}
+/**
+ * Rank the ELIGIBLE set (spec 281 verbatim: mandates filter, `0.6·fit + 0.4·trust` scores,
+ * top-`max` surfaced with evidence). `facets === null` ⇒ discovery unreachable ⇒ degraded mode:
+ * the eligible set passes through un-ranked with `enriched:false`. A candidate discovery does not
+ * know keeps its consent-derived seat (fewer signals, never fewer rights) but ranks below enriched
+ * peers and is exempt from skill mandates it cannot prove or disprove — eligibility (consent) was
+ * already settled structurally.
+ */
+export function rankConsultCandidates(args) {
+    const max = Math.max(1, args.max ?? args.eligible.length);
+    if (!args.facets) {
+        return {
+            enriched: false,
+            droppedByMandates: 0,
+            candidates: args.eligible.slice(0, max).map((m) => ({
+                ...m, skills: [], score: 0, enriched: false, satisfiedMandates: [],
+                evidence: ['discovery unreachable — eligibility (consent) only, roster order'],
+            })),
+        };
+    }
+    const hints = args.skillHints ?? [];
+    let dropped = 0;
+    const scored = [];
+    for (const m of args.eligible) {
+        const f = args.facets[m.memberSA];
+        if (!f) {
+            scored.push({ ...m, skills: [], score: 0, enriched: false, satisfiedMandates: [], evidence: ['not in discovery — roster signals only'] });
+            continue;
+        }
+        // Person agents only (spec 329 §4): an org-kind candidate is dropped, mandate-style.
+        if (f.kind && /org/i.test(f.kind)) {
+            dropped++;
+            continue;
+        }
+        const satisfied = [];
+        let failedMandate = false;
+        for (const hint of hints) {
+            const hay = [f.skills, f.description, f.displayName, f.name].filter(Boolean).join(' ').toLowerCase();
+            if (!hay.includes(hint.toLowerCase())) {
+                failedMandate = true;
+                break;
+            }
+            satisfied.push(`skill:${hint}`);
+        }
+        if (failedMandate) {
+            dropped++;
+            continue;
+        }
+        const cites = [];
+        const fit = fitOf(f, args.need, hints, cites, args.structured ?? {});
+        const trust = trustOf(f, cites);
+        const score = Math.round(Math.min(W_FIT * fit.score + W_TRUST * trust, 1) * 100) / 100;
+        scored.push({
+            ...m,
+            ...(f.name ? { handle: f.name } : {}),
+            skills: skillLabels(f.skills),
+            capabilityIds: f.capabilityIds ?? [],
+            capabilityHits: fit.capabilityHits, regionHits: fit.regionHits, lexicalOnly: fit.lexicalOnly,
+            endorsedCapabilityIds: fit.endorsedCapabilityIds,
+            score, enriched: true, satisfiedMandates: satisfied, evidence: cites,
+        });
+    }
+    // DETERMINISTIC ordering — ties break on STRUCTURE, never on array order. Region participates as a
+    // tie-break only: it can reorder candidates but can never eliminate one, which is the whole
+    // difference between this and the `mandates.geo` substring hard-filter it replaces.
+    scored.sort((a, b) => b.score - a.score
+        || (b.capabilityHits ?? 0) - (a.capabilityHits ?? 0)
+        || (b.regionHits ?? 0) - (a.regionHits ?? 0)
+        || Number(a.lexicalOnly ?? false) - Number(b.lexicalOnly ?? false)
+        || a.displayName.localeCompare(b.displayName));
+    return { enriched: true, droppedByMandates: dropped, candidates: scored.slice(0, max) };
+}
+// ── Depth-1 guard (spec 329 §4 loop prevention) ────────────────────────────────────────────────
+/**
+ * May THIS trigger offer the routing tools (find_members / ask_member)? False unless the topic's
+ * routing flag AND assistant are on, the org consult wire is custodied, and the triggering post is
+ * HUMAN-authored — an actor-marked (agent-authored) post can NEVER re-trigger routing, which with
+ * the consult handler's empty routing toolset makes consults depth-1 by construction.
+ */
+export function routingToolsAllowed(args) {
+    if (!args.routing || !args.assistant)
+        return false;
+    if (!args.wirePresent)
+        return false;
+    if (args.triggerActor)
+        return false; // depth-1: agent-authored triggers never route
+    return true;
+}
+/** The degrade verdict for a finished (or thrown) ROUTED turn. Fail-closed toward the member:
+ *  every branch ends with a posted reply. */
+export function routedTurnDegrade(s) {
+    if (s.posted) {
+        return s.outcome === 'completed'
+            ? { action: 'none' }
+            : { action: 'none', cause: `reply posted; routed residue failed: ${s.error ?? 'unknown error'}` };
+    }
+    const cause = s.outcome === 'completed'
+        ? 'routed plan completed without post_topic_message (read-only plan)'
+        : `routed turn failed: ${s.error ?? 'unknown error'}`;
+    return s.askedCount > 0 ? { action: 'post-status', cause } : { action: 'plain-turn', cause };
+}
+// ── Consult request builder (bounded context — spec 329 §2.3) ──────────────────────────────────
+/** Build the ConsultRequestV1 the org puts on the task rail, clipping question + tail to the
+ *  member-side parse bounds so what is sent IS what the member's gate accepts. */
+export function buildConsultRequest(args) {
+    const tail = (args.tail ?? [])
+        .filter((r) => r.bodyText.trim())
+        .slice(-CONSULT_TAIL_MAX_ROWS)
+        .map((r) => ({ author: r.author.slice(0, 120) || 'member', bodyText: r.bodyText.slice(0, CONSULT_TAIL_CLIP) }));
+    const topicTitle = args.topicTitle?.trim() ? args.topicTitle.trim().slice(0, 200) : undefined;
+    return {
+        goal: args.question.trim().slice(0, CONSULT_QUESTION_MAX_CHARS),
+        context: {
+            orgSA: args.orgSA.toLowerCase(),
+            topicId: args.topicId,
+            questionId: args.questionId,
+            ...(topicTitle ? { topicTitle } : {}),
+            ...(tail.length ? { topicTail: tail } : {}),
+        },
+    };
+}
+/** Build the drafted→expressed ConsultationIntent description record (spec 329 §5). */
+export function buildConsultationIntentRecord(args) {
+    return {
+        version: 'ap.consultation-intent.v1',
+        id: `${args.questionId}:${args.memberSA.toLowerCase()}`,
+        direction: 'receive',
+        object: '',
+        expressedBy: args.orgSA,
+        addressedTo: [args.memberSA],
+        constraints: { timeoutMs: args.timeoutMs ?? CONSULT_MEMBER_TIMEOUT_MS, topicId: args.topicId },
+        status: 'expressed',
+        createdAt: args.now ?? new Date().toISOString(),
+    };
+}
+/** Deterministic attribution buckets — the synthesis post + audit derive from THIS, never from
+ *  planner output (the LLM words the reply; the harness owns who-said-what). */
+export function consultAttribution(outcomes) {
+    const names = (s) => outcomes.filter((o) => o.status === s).map((o) => o.displayName);
+    return {
+        consulted: outcomes.map((o) => o.displayName),
+        contributed: names('answered'),
+        declined: names('declined'),
+        timedOut: names('timedOut'),
+        failed: names('failed'),
+        revoked: names('revoked'),
+    };
+}
+/** PROV fields for the synthesis post (spec 329 §6): every consulted agent, derived-from ONLY the
+ *  contributing answers' ConsultationIntent record ids. */
+export function buildConsultProvenance(questionId, outcomes) {
+    return {
+        consultedAgent: outcomes.map((o) => o.memberSA),
+        wasDerivedFrom: outcomes
+            .filter((o) => o.status === 'answered')
+            .map((o) => consultationIntentKey(questionId, o.memberSA)),
+    };
+}
+/** The harness-read context block the synthesis goal embeds (answers quoted WITH names — the
+ *  approved quoting decision; non-answers stated plainly so the model can attribute honestly). */
+export function synthesisOutcomeLines(outcomes) {
+    const lines = outcomes.map((o) => {
+        switch (o.status) {
+            case 'answered':
+                return `- ${o.displayName}'s agent answered: "${(o.answer?.answer ?? '').slice(0, 1200)}"`;
+            case 'declined':
+                return `- ${o.displayName}'s agent declined${o.answer?.declineReason ? ` (${o.answer.declineReason.slice(0, 200)})` : ''}.`;
+            case 'timedOut':
+                return `- ${o.displayName}'s agent didn't respond in time.`;
+            case 'revoked':
+                return `- ${o.displayName} withdrew their consult opt-in before the reply — their answer was discarded.`;
+            default:
+                return `- ${o.displayName}'s agent could not be reached.`;
+        }
+    });
+    return lines.join('\n');
+}
+/** The deterministic (rule-based) synthesis body — exact attribution, no model required. */
+export function deterministicSynthesisBody(question, outcomes) {
+    const a = consultAttribution(outcomes);
+    const head = `I asked ${a.consulted.length} member agent${a.consulted.length === 1 ? '' : 's'} (${a.consulted.join(', ')}) about: "${question.slice(0, 200)}".`;
+    const answers = outcomes
+        .filter((o) => o.status === 'answered')
+        .map((o) => `${o.displayName}'s agent: "${(o.answer?.answer ?? '').slice(0, 600)}"`);
+    const misses = [];
+    if (a.declined.length)
+        misses.push(`${a.declined.join(', ')} declined`);
+    if (a.timedOut.length)
+        misses.push(`${a.timedOut.join(', ')} didn't respond in time`);
+    if (a.failed.length)
+        misses.push(`${a.failed.join(', ')} could not be reached`);
+    if (a.revoked.length)
+        misses.push(`${a.revoked.join(', ')} withdrew their opt-in (answer discarded)`);
+    return [head, ...answers, misses.length ? `(${misses.join('; ')}.)` : '']
+        .filter(Boolean)
+        .join('\n\n');
+}
+/** The one-phrase SELECTION BASIS for a candidate (spec 329 §4 skill-based auto-selection):
+ *  the turn-1 status post and the goal's candidate lines both state WHY a member is (or may be)
+ *  consulted — published capabilities when they exist, and the honest lesser basis when they don't.
+ *  Prose says CAPABILITY (capability-architecture.md §1); the `skills` field name is the legacy
+ *  `atl:skills` projection key and is immutable. */
+export function consultSelectionBasis(c, matchedRole = false) {
+    // Claimed-capability tier — when a member is DECLARED AND independently ENDORSED for a requested
+    // capability, the basis says so: a declaration corroborated by a third party is a stronger reason to
+    // pick them than a bare self-declaration, and the copy must not hide the difference (capability-
+    // architecture.md §2 — three assertion strengths, presented distinctly).
+    const endorsed = (c.endorsedCapabilityIds ?? []).map(humanizeCapability);
+    const endorseClause = endorsed.length ? ` — declared AND endorsed for ${endorsed.join(', ')}` : '';
+    // spec 329 §12 — a ROLE match outranks a generic skill match, so when the role drove the pick the
+    // basis SAYS the role (and only the role). Never claimed without an asserted role.
+    if (matchedRole && c.orgRole?.trim())
+        return `org role: ${c.orgRole.trim()}${endorseClause}`;
+    // Humanized: this string is quoted verbatim into a member-facing discussion post, so it must read
+    // as English rather than as a CURIE list. The identity is unchanged — only its rendering.
+    if (c.skills.length)
+        return `published capabilities: ${c.skills.map(humanizeCapability).join(', ')}${endorseClause}`;
+    return c.enriched
+        ? 'no published capabilities — matched on name/description'
+        : 'no capability data readable — consent-based eligibility only';
+}
+/** One compact goal line per candidate — published skills FIRST (the model matches the question's
+ *  subject against these), an EXPLICIT no-skills marker (never hallucinated expertise), then the
+ *  ranking-evidence hint. */
+/**
+ * Render a published capability for a HUMAN: `adv:succession-plan-design` → "succession plan
+ * design". Presentation only — the id string is the identity and is never rewritten (ADR-0051's
+ * prose/key split: the prose says "capability", the key stays exactly as published).
+ *
+ * This is a pure transform on the CURIE, deliberately NOT a catalog lookup: the catalog is a
+ * downstream domain artifact and this package must not depend on one. A canonical prefLabel would
+ * read slightly better; a substrate dependency on an advisory vocabulary would cost much more than
+ * that is worth. A token that is not CURIE-shaped (a legacy free-text label) passes through
+ * untouched.
+ */
+export function humanizeCapability(id) {
+    const local = /^[a-z][a-z0-9]*:([a-z0-9][a-z0-9-]*)$/i.exec(id.trim())?.[1];
+    return local ? local.replace(/-/g, ' ') : id.trim();
+}
+export function consultCandidateLine(c) {
+    const who = c.handle ? `${c.displayName} (${c.handle})` : c.displayName;
+    // spec 329 §12 — the org role leads when asserted: it is the stronger, member-signed signal and
+    // the model is instructed to prefer it over a generic skill match.
+    const role = c.orgRole?.trim() ? `role: ${c.orgRole.trim()} — ` : '';
+    const skills = c.skills.length
+        ? `published capabilities: [${c.skills.map(humanizeCapability).join(', ')}]`
+        : c.enriched
+            ? 'NO published capabilities (match only on displayName/description, and say that basis if you consult them)'
+            : 'NO capability data (discovery unreachable — consent-based eligibility only)';
+    const ev = c.evidence.length ? ` — ${c.evidence.slice(0, 3).join('; ')}` : '';
+    return `- ${who} — memberSA ${c.memberSA} — ${role}${skills}${ev}`;
+}
+/**
+ * Does the question ADDRESS this candidate's org role (spec 329 §12)? Pure, deterministic, and
+ * conservative: a normalized substring match of the asserted role phrase in the question
+ * ("@ask tax advisor …", "ask our tax advisor about …" both hit "tax advisor"). Used by the
+ * DETERMINISTIC (no-LLM) routed turn to state an honest basis; the LLM turn does its own matching
+ * under ROUTING_CONTRACT. No role asserted ⇒ false (a role is never inferred from skills).
+ */
+export function questionAddressesRole(question, orgRole) {
+    const role = orgRole?.trim().toLowerCase().replace(/\s+/g, ' ');
+    if (!role)
+        return false;
+    return question.toLowerCase().replace(/\s+/g, ' ').includes(role);
+}
+/** The deterministic turn-1 status body — the honest "asking N members" post (spec 329 §4.1).
+ *  Entries may carry a selection `basis` (see consultSelectionBasis), rendered in parentheses:
+ *  "Asking 1 member's agent (alice (published skills: water systems)) — …". Plain strings keep
+ *  the pre-329-§4 shape. */
+export function deterministicStatusBody(members) {
+    const names = members.map((m) => (typeof m === 'string' ? m : m.basis ? `${m.displayName} (${m.basis})` : m.displayName));
+    return `Asking ${names.length} member${names.length === 1 ? '' : 's'}' agent${names.length === 1 ? '' : 's'} (${names.join(', ')}) — I'll follow up here with what they say.`;
+}
+/** Re-export the grant-store key so execution points scanning eligibility import ONE name. */
+export { consultGrantRecordKey };
+//# sourceMappingURL=consult-routing.js.map

package/dist/messaging/consult-routing.js.map

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

package/dist/messaging/consult.d.ts

@@ -0,0 +1,158 @@
+import type { CanonicalAgentId } from '@agenticprimitives/types';
+import type { ContextRefV1 } from './types.js';
+/** The consult A2A skill id — the delegation's `allowedMethods` selector derives from THIS string
+ *  (`skillSelector('discussion.consult')`, spec 269 FR-4.2). Never `A2A_ANY_SKILL`. */
+export declare const CONSULT_SKILL_ID: "discussion.consult";
+/** Member-side per-org fixed window (spec 329 §3.2): 12 consults / hour / org. Exceeding ⇒ the
+ *  task fails typed + audited (`a2a.consult.rateLimited`); decided with `fixedWindowAllow`. */
+export declare const CONSULT_RATE_WINDOW_MS: number;
+export declare const CONSULT_RATE_MAX = 12;
+/** Default consultability-delegation lifetime (spec 329 §2.1) — re-opt-in refreshes. */
+export declare const CONSULT_GRANT_VALIDITY_SECONDS: number;
+/** Fan-out per routed question: default 3, steward-tunable 1..5. */
+export declare const ROUTING_FANOUT_DEFAULT = 3;
+export declare const ROUTING_FANOUT_MIN = 1;
+export declare const ROUTING_FANOUT_MAX = 5;
+/** Per-topic routing bucket (on top of 327's dispatch bucket): 3 routed questions / 10 min. */
+export declare const ROUTING_RATE_WINDOW_MS: number;
+export declare const ROUTING_RATE_MAX = 3;
+/** Per-member consult timeout (spec 329 §4): a member agent that hasn't completed by then is
+ *  reported as timed out in the synthesis attribution. */
+export declare const CONSULT_MEMBER_TIMEOUT_MS = 60000;
+/** PROV-O provenance carried by the turn-2 synthesis post (spec 329 §6): `apmsg:consultedAgent`
+ *  (every agent consulted for this reply) + `prov:wasDerivedFrom` (the ConsultationIntent record
+ *  ids whose answers CONTRIBUTED). House rule: reuse PROV directly, no parallel terms. */
+export interface ConsultProvenanceV1 {
+    consultedAgent: string[];
+    wasDerivedFrom: string[];
+}
+/** contextRef kind carried by the turn-1 status post + turn-2 synthesis (spec 329 §6;
+ *  cbox/interaction-vocabulary.ttl `apmsg:routedConsultation`). */
+export declare const ROUTED_CONSULTATION_CONTEXT_KIND: "routed-consultation";
+/** The org-vault record name family holding member consultability grants (spec 329 §2.1) —
+ *  exported so W2's `find_members` eligibility read and the opt-in ceremony key identically. */
+export declare const consultGrantRecordKey: (memberSA: string) => string;
+/** Build the routed-consultation contextRef: id = `<orgSA>/<topicId>/<questionId>` (spec 329 §6). */
+export declare function routedConsultationContextRef(orgSA: string, topicId: string, questionId: string): ContextRefV1;
+/** One clipped topic-tail row carried with a routed question (spec 329 §2.3). */
+export interface ConsultTailRowV1 {
+    author: string;
+    bodyText: string;
+}
+/** Bounds on the carried context — the consult turn is small by construction. */
+export declare const CONSULT_QUESTION_MAX_CHARS = 2000;
+export declare const CONSULT_TAIL_MAX_ROWS = 8;
+export declare const CONSULT_TAIL_CLIP = 300;
+/**
+ * The consult task payload (spec 329 §5 EXECUTION framing): an orchestration Intent
+ * `{ goal, context }` — the goal IS the question; the context pins the org, topic, and
+ * question id. This is the ONLY executing intent machinery in spec 329.
+ */
+export interface ConsultRequestV1 {
+    /** The question text (the orchestration Intent's goal). */
+    goal: string;
+    context: {
+        /** The consulting org SA (0x, lowercased on parse). */
+        orgSA: string;
+        /** The triggering topic (`conv_*`). */
+        topicId: string;
+        /** The org-side routing id — `routing.pending` / ConsultationIntent records key on it. */
+        questionId: string;
+        topicTitle?: string;
+        /** Clipped topic tail (≤ CONSULT_TAIL_MAX_ROWS rows, bodies ≤ CONSULT_TAIL_CLIP chars). */
+        topicTail?: ConsultTailRowV1[];
+    };
+}
+export type ConsultParseResult = {
+    ok: true;
+    request: ConsultRequestV1;
+} | {
+    ok: false;
+    error: string;
+};
+/** Parse + bound an inbound consult payload, fail-closed. Unknown/oversized context is CLIPPED
+ *  (data, never authority — ADR-0041); a missing goal/org/topic/question id REJECTS. */
+export declare function parseConsultRequest(input: unknown): ConsultParseResult;
+/**
+ * The member agent's structured answer artifact (spec 329 §3.2/§6). Wire tag
+ * `ap.consult-answer.v1` ↔ apmsg:ConsultAnswer (tbox/messaging.ttl); validated by
+ * apmsg:ConsultAnswerShape's TS mirror below: exactly one actor, answered XOR declined.
+ * Rides the a2a task Artifact (the runtime binds apful:bodyHash over this body).
+ */
+export interface ConsultAnswerV1 {
+    version: 'ap.consult-answer.v1';
+    /** The org-side routing correlation id (from the request context). */
+    questionId: string;
+    /** The consulting org SA (0x, lowercased). */
+    orgSA: string;
+    topicId: string;
+    /** The question answered (echo, clipped — synthesis renders it without re-reading the task). */
+    question: string;
+    /** Present iff answered (xor `declined`). */
+    answer?: string;
+    /** Present (true) iff the member's agent explicitly declined (xor `answer`). */
+    declined?: true;
+    /** Optional free-text decline reason. */
+    declineReason?: string;
+    /** spec 324 §9 acting-agent provenance — ALWAYS the member SA (pinned by the builder). */
+    actor: CanonicalAgentId;
+    respondedAt: string;
+}
+export type ConsultAnswerBuildResult = {
+    ok: true;
+    answer: ConsultAnswerV1;
+} | {
+    ok: false;
+    error: string;
+};
+/** Max answer/decline-reason length carried back to the org. */
+export declare const CONSULT_ANSWER_MAX_CHARS = 4000;
+/**
+ * Build the ConsultAnswer artifact body (spec 329 §3.2). IDENTITY-PINNED by construction: the
+ * caller supplies only the outcome — `actor` is ALWAYS the member principal, and the request
+ * correlation (org/topic/question) comes from the PARSED request, never planner output.
+ * Enforces answered XOR declined, fail-closed (ADR-0013): an empty answer without an explicit
+ * decline is an error, never a silent empty artifact.
+ */
+export declare function buildConsultAnswer(request: ConsultRequestV1, opts: {
+    member: CanonicalAgentId;
+    answer?: string;
+    declined?: boolean;
+    declineReason?: string;
+    now?: string;
+}): ConsultAnswerBuildResult;
+export type ConsultAnswerValidationError = 'bad_version' | 'missing_question_id' | 'missing_org' | 'missing_topic' | 'missing_actor' | 'answered_and_declined' | 'neither_answered_nor_declined';
+/** TS mirror of apmsg:ConsultAnswerShape (structural; the bodyHash binding is the task rail's). */
+export declare function validateConsultAnswer(a: ConsultAnswerV1): ConsultAnswerValidationError[];
+/** Spine SKOS lifecycle for a ConsultationIntent (spec 329 §5 / spec 239). */
+export type ConsultationIntentStatus = 'drafted' | 'expressed' | 'fulfilled' | 'abandoned';
+/**
+ * The Layer-2 DESCRIPTION record the org keeps per routed consult (spec 329 §5; org vault
+ * `routing.consult:<questionId>:<memberSA>`). Wire tag `ap.consultation-intent.v1` ↔
+ * apint:ConsultationIntent (tbox/intents.ttl; apint:ConsultationIntentShape). This record never
+ * executes anything — the A2A task rail does; the marketplace resolver stays uninvolved.
+ */
+export interface ConsultationIntentV1 {
+    version: 'ap.consultation-intent.v1';
+    /** `<questionId>:<memberSA>` — one intent per consulted member. */
+    id: string;
+    /** Fixed for consultations: the org RECEIVES the answer. */
+    direction: 'receive';
+    /** The consult-answer ref/IRI once fulfilled (empty until then). */
+    object: string;
+    /** The consulting org SA (CAIP-10 or 0x). */
+    expressedBy: CanonicalAgentId;
+    /** Exactly ONE member agent (depth-1 by construction — SHACL maxCount 1). */
+    addressedTo: [CanonicalAgentId];
+    /** Anoma-CSP-shaped constraints (spec 329 §5: timeout + topic scope). */
+    constraints: {
+        timeoutMs: number;
+        topicId: string;
+    };
+    status: ConsultationIntentStatus;
+    createdAt: string;
+}
+export type ConsultationIntentValidationError = 'bad_version' | 'bad_direction' | 'missing_expressed_by' | 'bad_addressed_to' | 'missing_constraints' | 'bad_status';
+/** TS mirror of apint:ConsultationIntentShape. */
+export declare function validateConsultationIntent(i: ConsultationIntentV1): ConsultationIntentValidationError[];
+//# sourceMappingURL=consult.d.ts.map