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

package/dist/messaging/board.d.ts

@@ -1,23 +1,95 @@
 import type { CanonicalAgentId } from '@agenticprimitives/types';
-import type { ConversationDescriptorV1, MessageEnvelopeV1 } from './types.js';
+import type { ContextRefV1, ConversationDescriptorV1, MessageEnvelopeV1 } from './types.js';
+import { type ConsultProvenanceV1 } from './consult.js';
 export interface ChannelMessageEntryV1 {
     envelope: MessageEnvelopeV1;
     authorName: string;
+    /** spec 324 §9 acting-agent provenance (spec 327): WHO performed the authoring move when it was
+     *  not a human session — for org-assistant posts, the org SA (CAIP-10). Absent ⇒ human-session
+     *  post. Never erased; the UI renders an "agent" badge from it. */
+    actor?: CanonicalAgentId;
+    /** spec 329 §6 — PROV attribution on a turn-2 synthesis post (consulted agents + the contributing
+     *  ConsultationIntent record ids). Absent on every non-synthesis post. */
+    prov?: ConsultProvenanceV1;
+}
+/** Steward-controlled org-assistant enablement for one topic (spec 327; 318 §8.1 slice — the org's
+ *  OWN agent, not a participant bot). Handle + display name are captured AT ENABLE TIME so trigger
+ *  matching and attribution need no per-post chain read (ADR-0012); re-enabling refreshes both
+ *  after a name rotation. */
+export interface TopicAssistantV1 {
+    /** 'mention' — reply only when a post @-mentions the org. 'all' — reply to every member post. */
+    trigger: 'mention' | 'all';
+    /** Lowercased mention label, e.g. 'grace' for grace.impact — matched as @grace / @grace.impact.
+     *  Empty ONLY for trigger:'all' (a nameless org cannot be mentioned). */
+    mentionHandle: string;
+    /** Author display name stamped on assistant posts (org primary name / profile display name). */
+    displayName: string;
+    enabledBy: string;
+    enabledAt: string;
+}
+/** Steward-controlled member ROUTING enablement for one topic (spec 329 §7): the org's assistant
+ *  may consult opted-in member agents in this topic. Requires the assistant ON (routing is a mode
+ *  of the 327 assistant, never a second bot); the org-level consult wire (§3.1) is custodied
+ *  separately at the org's execution point — flag without wire ⇒ routing stays inert. */
+export interface TopicRoutingV1 {
+    /** Fan-out K per routed question (1..5, default 3 — spec 329 §4). */
+    maxFanout: number;
+    enabledBy: string;
+    enabledAt: string;
 }
 export interface ChannelV1 {
     descriptor: ConversationDescriptorV1;
     title: string;
     createdBy: string;
     messages: ChannelMessageEntryV1[];
+    /** apmsg:participationPolicy — `open` (every org MEMBER automatically participates; derived, never a
+     *  stored list) or `restricted` (invite-only; `participants` is the projection of accepted
+     *  DiscussionParticipation situations). Absent ⇒ resolved from legacy `visibility` (public→open,
+     *  private→restricted); absent both ⇒ open. */
+    participationPolicy?: 'open' | 'restricted';
     visibility?: 'public' | 'private';
-    /** For a private topic: the member SAs (lowercased 0x) allowed to see/post. The creator is always included. */
+    /** For a restricted topic: the PARTICIPANT SAs (lowercased 0x) allowed to see/post — a projection of
+     *  accepted participations (the creator is always included). Legacy field name `members` kept on the
+     *  wire; these are discussion PARTICIPANTS, not the org member roster. */
     members?: string[];
+    /** Present ⇔ the org's own agent participates in this topic (spec 327). */
+    assistant?: TopicAssistantV1;
+    /** Present ⇔ member routing is steward-enabled on this topic (spec 329; requires `assistant`). */
+    routing?: TopicRoutingV1;
 }
-/** Can `viewerSa` (0x) see this topic? Public ⇒ always; private ⇒ only if listed in `members`. `isSteward`
- *  overrides (a steward manages every topic). One mechanism — used by the store list + the UI. */
+/** Resolve a topic's participation policy, mapping the legacy `visibility` wire field
+ *  (public→open, private→restricted). Absent both ⇒ open (the default + all legacy topics). */
+export declare function channelParticipationPolicy(channel: Pick<ChannelV1, 'participationPolicy' | 'visibility'>): 'open' | 'restricted';
+/** Can `viewerSa` (0x) see this topic? OPEN ⇒ always (every org member; the caller already gated org
+ *  membership). RESTRICTED ⇒ only listed participants. `isSteward` overrides (a steward/custodian is a
+ *  facilitator of every topic). One mechanism — used by the store list + the UI. */
 export declare function canSeeChannel(channel: ChannelV1, viewerSa: string, isSteward?: boolean): boolean;
 /** Bounded per-channel history in the board doc (projection only — bodies live in the vault). */
 export declare const BOARD_HISTORY_LIMIT = 200;
+/** Should a just-committed post trigger the topic's org assistant (spec 327 §3)? Pure predicate —
+ *  the caller supplies the posted body text (it never round-trips through the stored entry, whose
+ *  body is hash-bound in the vault). False when the assistant is off, when the post is itself
+ *  agent-authored (`actor` set), or when the author IS the org — the community contextRef, NOT
+ *  `descriptor.owner` (that is the topic CREATOR) — so the assistant NEVER triggers itself, even
+ *  in `trigger:'all'` topics. */
+export declare function assistantTrigger(channel: Pick<ChannelV1, 'assistant' | 'descriptor'>, post: {
+    from: CanonicalAgentId;
+    actor?: CanonicalAgentId;
+    bodyText: string;
+}): boolean;
+/** Enable/refresh (`assistant` set) or disable (`assistant` undefined) the org assistant on a topic
+ *  (mutates the channel on success). Steward gating + audit are the caller's, as with every board
+ *  mutation. `trigger:'mention'` requires a mention handle — a nameless org cannot be mentioned. */
+export declare function setTopicAssistant(board: ChannelV1[], channelId: string, assistant: TopicAssistantV1 | undefined): BoardResult<{
+    channel: ChannelV1;
+}>;
+/** Enable/refresh (`routing` set) or disable (`routing` undefined) member routing on a topic
+ *  (spec 329 §7). Enabling REQUIRES the 327 assistant to be on (routing is a mode of the
+ *  assistant's turn); fan-out is clamped fail-closed to the approved 1..5 window. Disabling the
+ *  ASSISTANT also disables routing transitively (setTopicAssistant clears it below). */
+export declare function setTopicRouting(board: ChannelV1[], channelId: string, routing: TopicRoutingV1 | undefined): BoardResult<{
+    channel: ChannelV1;
+}>;
 export type BoardResult<T> = {
     ok: true;
 } & T | {
@@ -33,6 +105,7 @@ export declare function createBoardChannel(board: ChannelV1[], opts: {
     title: string;
     createdBy: string;
     now?: string;
+    participationPolicy?: 'open' | 'restricted';
     visibility?: 'public' | 'private';
     members?: string[];
     creatorSa?: string;
@@ -48,6 +121,13 @@ export declare function appendBoardPost(board: ChannelV1[], opts: {
     authorName: string;
     bodyText: string;
     now?: string;
+    actor?: CanonicalAgentId;
+    /** spec 329 §6 — EXTRA context refs beyond the channel's own (the `routed-consultation` chip on
+     *  the turn-1 status + turn-2 synthesis). Appended after the descriptor refs, deduped by
+     *  kind+id; the envelope validator's MAX_CONTEXT_REFS bound still applies (fail-closed). */
+    contextRefs?: ContextRefV1[];
+    /** spec 329 §6 — PROV attribution stored on the entry (synthesis posts only). */
+    prov?: ConsultProvenanceV1;
 }): Promise<BoardResult<{
     envelope: MessageEnvelopeV1;
 }>>;

package/dist/messaging/board.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"board.d.ts","sourceRoot":"","sources":["../../src/messaging/board.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAKjE,OAAO,KAAK,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE9E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,wBAAwB,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAGlC,UAAU,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAClC,+GAA+G;IAC/G,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;kGACkG;AAClG,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,OAAO,CAK9F;AAED,iGAAiG;AACjG,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG,CAAC,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7E;;6FAE6F;AAC7F,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,EAAE,EAClB,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9K,WAAW,CAAC;IAAE,OAAO,EAAE,SAAS,CAAA;CAAE,CAAC,CA+BrC;AAED;;uFAEuF;AACvF,wBAAsB,eAAe,CACnC,KAAK,EAAE,SAAS,EAAE,EAClB,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACtG,OAAO,CAAC,WAAW,CAAC;IAAE,QAAQ,EAAE,iBAAiB,CAAA;CAAE,CAAC,CAAC,CA8BvD"}
+{"version":3,"file":"board.d.ts","sourceRoot":"","sources":["../../src/messaging/board.ts"],"names":[],"mappings":"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"}

package/dist/messaging/board.js

@@ -2,10 +2,19 @@ import { generateConversationId, generateMessageId, validateMessageEnvelope } fr
 import { sha256Hex32 } from './hash.js';
 import { validateConversationDescriptor } from './conversation.js';
 import { topicBodyResource } from './vault-store.js';
-/** Can `viewerSa` (0x) see this topic? Public ⇒ always; private ⇒ only if listed in `members`. `isSteward`
- *  overrides (a steward manages every topic). One mechanism — used by the store list + the UI. */
+import { ROUTING_FANOUT_DEFAULT, ROUTING_FANOUT_MAX, ROUTING_FANOUT_MIN } from './consult.js';
+/** Resolve a topic's participation policy, mapping the legacy `visibility` wire field
+ *  (public→open, private→restricted). Absent both ⇒ open (the default + all legacy topics). */
+export function channelParticipationPolicy(channel) {
+    if (channel.participationPolicy)
+        return channel.participationPolicy;
+    return channel.visibility === 'private' ? 'restricted' : 'open';
+}
+/** Can `viewerSa` (0x) see this topic? OPEN ⇒ always (every org member; the caller already gated org
+ *  membership). RESTRICTED ⇒ only listed participants. `isSteward` overrides (a steward/custodian is a
+ *  facilitator of every topic). One mechanism — used by the store list + the UI. */
 export function canSeeChannel(channel, viewerSa, isSteward = false) {
-    if (channel.visibility !== 'private')
+    if (channelParticipationPolicy(channel) === 'open')
         return true;
     if (isSteward)
         return true;
@@ -14,6 +23,82 @@ export function canSeeChannel(channel, viewerSa, isSteward = false) {
 }
 /** Bounded per-channel history in the board doc (projection only — bodies live in the vault). */
 export const BOARD_HISTORY_LIMIT = 200;
+/** Should a just-committed post trigger the topic's org assistant (spec 327 §3)? Pure predicate —
+ *  the caller supplies the posted body text (it never round-trips through the stored entry, whose
+ *  body is hash-bound in the vault). False when the assistant is off, when the post is itself
+ *  agent-authored (`actor` set), or when the author IS the org — the community contextRef, NOT
+ *  `descriptor.owner` (that is the topic CREATOR) — so the assistant NEVER triggers itself, even
+ *  in `trigger:'all'` topics. */
+export function assistantTrigger(channel, post) {
+    const assistant = channel.assistant;
+    if (!assistant)
+        return false;
+    if (post.actor)
+        return false;
+    const org = channel.descriptor.contextRefs?.find((r) => r.kind === 'community')?.id?.toLowerCase();
+    if (org && String(post.from).toLowerCase().endsWith(org))
+        return false;
+    if (assistant.trigger === 'all')
+        return true;
+    const handle = assistant.mentionHandle.trim().toLowerCase();
+    if (!handle)
+        return false;
+    // @handle, optionally with its dotted parent name (@handle.<parent>…) — TLD-agnostic (the parent
+    // registry is app config, never package vocabulary — ADR-0021). Case-insensitive, word-bounded
+    // (name labels are [a-z0-9-]); a preceding name char (e.g. an email local part) is not a mention.
+    const esc = handle.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const mention = new RegExp(`(?:^|[^a-z0-9-])@${esc}(?:\\.[a-z0-9-]+)*(?![a-z0-9-])`, 'i');
+    if (mention.test(post.bodyText))
+        return true;
+    // `@ask` — the universal, org-agnostic assistant alias: members shouldn't have to remember the
+    // org's handle to talk to its assistant. Same word-bounding rules; only meaningful where an
+    // assistant is enabled, so it can never mis-route across orgs.
+    return ASK_ALIAS.test(post.bodyText);
+}
+const ASK_ALIAS = /(?:^|[^a-z0-9-])@ask(?![a-z0-9-])/i;
+/** Enable/refresh (`assistant` set) or disable (`assistant` undefined) the org assistant on a topic
+ *  (mutates the channel on success). Steward gating + audit are the caller's, as with every board
+ *  mutation. `trigger:'mention'` requires a mention handle — a nameless org cannot be mentioned. */
+export function setTopicAssistant(board, channelId, assistant) {
+    const channel = board.find((c) => c.descriptor.id === channelId);
+    if (!channel)
+        return { ok: false, error: 'unknown channel' };
+    if (!assistant) {
+        delete channel.assistant;
+        // spec 329 §8 — assistant off ⇒ routing off transitively (routing is a mode of the assistant).
+        delete channel.routing;
+        return { ok: true, channel };
+    }
+    const mentionHandle = assistant.mentionHandle.trim().toLowerCase();
+    if (assistant.trigger === 'mention' && !mentionHandle) {
+        return { ok: false, error: 'mention trigger requires the org to have a primary name' };
+    }
+    if (!assistant.displayName.trim())
+        return { ok: false, error: 'displayName required' };
+    channel.assistant = { ...assistant, mentionHandle };
+    return { ok: true, channel };
+}
+/** Enable/refresh (`routing` set) or disable (`routing` undefined) member routing on a topic
+ *  (spec 329 §7). Enabling REQUIRES the 327 assistant to be on (routing is a mode of the
+ *  assistant's turn); fan-out is clamped fail-closed to the approved 1..5 window. Disabling the
+ *  ASSISTANT also disables routing transitively (setTopicAssistant clears it below). */
+export function setTopicRouting(board, channelId, routing) {
+    const channel = board.find((c) => c.descriptor.id === channelId);
+    if (!channel)
+        return { ok: false, error: 'unknown channel' };
+    if (!routing) {
+        delete channel.routing;
+        return { ok: true, channel };
+    }
+    if (!channel.assistant)
+        return { ok: false, error: 'routing requires the topic assistant to be enabled first' };
+    const raw = Number(routing.maxFanout);
+    const maxFanout = Number.isFinite(raw)
+        ? Math.min(Math.max(Math.round(raw), ROUTING_FANOUT_MIN), ROUTING_FANOUT_MAX)
+        : ROUTING_FANOUT_DEFAULT;
+    channel.routing = { ...routing, maxFanout };
+    return { ok: true, channel };
+}
 /** Create a channel on the board (mutates `board` on success). Title-unique per context.
  *  `contextId` is the org/context SA (substrate vocabulary — spec 322 §5; the wire literal
  *  `kind:'community'` is inside signed hashes and renames only at 316's envelope re-cut). */
@@ -24,7 +109,8 @@ export function createBoardChannel(board, opts) {
     if (board.some((c) => c.title.toLowerCase() === title.toLowerCase())) {
         return { ok: false, error: 'a channel with this title already exists' };
     }
-    const isPrivate = opts.visibility === 'private';
+    // New callers say participationPolicy; legacy callers say visibility. restricted ≡ private.
+    const isPrivate = opts.participationPolicy ? opts.participationPolicy === 'restricted' : opts.visibility === 'private';
     const descriptor = {
         version: 'ap.conversation.v1',
         id: generateConversationId(),
@@ -40,12 +126,14 @@ export function createBoardChannel(board, opts) {
     const errors = validateConversationDescriptor(descriptor);
     if (errors.length > 0)
         return { ok: false, error: `invalid channel: ${errors.join(', ')}` };
-    // The creator is always a member of a private topic; dedupe + lowercase.
+    // The creator is always a participant of a restricted topic; dedupe + lowercase.
     const members = isPrivate
         ? [...new Set([opts.creatorSa?.toLowerCase(), ...(opts.members ?? []).map((m) => m.toLowerCase())].filter((m) => !!m))]
         : undefined;
     const channel = {
         descriptor, title, createdBy: opts.createdBy, messages: [],
+        // Dual-write: participationPolicy is the vocabulary; visibility stays for legacy readers.
+        participationPolicy: isPrivate ? 'restricted' : 'open',
         ...(isPrivate ? { visibility: 'private', members } : {}),
     };
     board.push(channel);
@@ -63,6 +151,9 @@ export async function appendBoardPost(board, opts) {
         return { ok: false, error: 'unknown channel' };
     const now = opts.now ?? new Date().toISOString();
     const messageId = generateMessageId();
+    const baseRefs = channel.descriptor.contextRefs ?? [];
+    const extraRefs = (opts.contextRefs ?? []).filter((r) => !baseRefs.some((b) => b.kind === r.kind && b.id === r.id));
+    const contextRefs = [...baseRefs, ...extraRefs];
     const envelope = {
         version: 'ap.message.v1',
         id: messageId,
@@ -76,12 +167,12 @@ export async function appendBoardPost(board, opts) {
         body: { resource: topicBodyResource(channel.descriptor.id, messageId), classification: 'internal', updatedAt: now },
         bodyHash: await sha256Hex32(new TextEncoder().encode(bodyText)),
         bodyContentType: 'text/plain',
-        contextRefs: channel.descriptor.contextRefs,
+        contextRefs,
     };
     const errors = validateMessageEnvelope(envelope);
     if (errors.length > 0)
         return { ok: false, error: `invalid post: ${errors.join(', ')}` };
-    channel.messages.push({ envelope, authorName: opts.authorName });
+    channel.messages.push({ envelope, authorName: opts.authorName, ...(opts.actor ? { actor: opts.actor } : {}), ...(opts.prov ? { prov: opts.prov } : {}) });
     if (channel.messages.length > BOARD_HISTORY_LIMIT) {
         channel.messages.splice(0, channel.messages.length - BOARD_HISTORY_LIMIT);
     }

package/dist/messaging/board.js.map

@@ -1 +1 @@
-{"version":3,"file":"board.js","sourceRoot":"","sources":["../../src/messaging/board.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"board.js","sourceRoot":"","sources":["../../src/messaging/board.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACnG,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,8BAA8B,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,kBAAkB,EAA4B,MAAM,cAAc,CAAC;AAgExH;+FAC+F;AAC/F,MAAM,UAAU,0BAA0B,CAAC,OAA8D;IACvG,IAAI,OAAO,CAAC,mBAAmB;QAAE,OAAO,OAAO,CAAC,mBAAmB,CAAC;IACpE,OAAO,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;AAClE,CAAC;AAED;;oFAEoF;AACpF,MAAM,UAAU,aAAa,CAAC,OAAkB,EAAE,QAAgB,EAAE,SAAS,GAAG,KAAK;IACnF,IAAI,0BAA0B,CAAC,OAAO,CAAC,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAChE,IAAI,SAAS;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,EAAE,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAClC,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,iGAAiG;AACjG,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEvC;;;;;iCAKiC;AACjC,MAAM,UAAU,gBAAgB,CAC9B,OAAoD,EACpD,IAA4E;IAE5E,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACpC,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7B,IAAI,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC;IACnG,IAAI,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACvE,IAAI,SAAS,CAAC,OAAO,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAC7C,MAAM,MAAM,GAAG,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5D,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,iGAAiG;IACjG,+FAA+F;IAC/F,kGAAkG;IAClG,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,oBAAoB,GAAG,iCAAiC,EAAE,GAAG,CAAC,CAAC;IAC1F,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7C,+FAA+F;IAC/F,4FAA4F;IAC5F,+DAA+D;IAC/D,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,SAAS,GAAG,oCAAoC,CAAC;AAEvD;;oGAEoG;AACpG,MAAM,UAAU,iBAAiB,CAC/B,KAAkB,EAClB,SAAiB,EACjB,SAAuC;IAEvC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;IACjE,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC7D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,OAAO,CAAC,SAAS,CAAC;QACzB,+FAA+F;QAC/F,OAAO,OAAO,CAAC,OAAO,CAAC;QACvB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC/B,CAAC;IACD,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACnE,IAAI,SAAS,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,aAAa,EAAE,CAAC;QACtD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,yDAAyD,EAAE,CAAC;IACzF,CAAC;IACD,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,EAAE,CAAC;IACvF,OAAO,CAAC,SAAS,GAAG,EAAE,GAAG,SAAS,EAAE,aAAa,EAAE,CAAC;IACpD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC;AAED;;;wFAGwF;AACxF,MAAM,UAAU,eAAe,CAC7B,KAAkB,EAClB,SAAiB,EACjB,OAAmC;IAEnC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;IACjE,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,OAAO,CAAC,OAAO,CAAC;QACvB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC/B,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,SAAS;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,0DAA0D,EAAE,CAAC;IAChH,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACtC,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QACpC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;QAC7E,CAAC,CAAC,sBAAsB,CAAC;IAC3B,OAAO,CAAC,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,CAAC;IAC5C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC;AAID;;6FAE6F;AAC7F,MAAM,UAAU,kBAAkB,CAChC,KAAkB,EAClB,IAA4N;IAE5N,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAChC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,6BAA6B,EAAE,CAAC;IAC5F,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QACrE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC;IAC1E,CAAC;IACD,4FAA4F;IAC5F,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,mBAAmB,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC;IACvH,MAAM,UAAU,GAA6B;QAC3C,OAAO,EAAE,oBAAoB;QAC7B,EAAE,EAAE,sBAAsB,EAAE;QAC5B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,KAAK;QACL,YAAY,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;QAC1B,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC;QACtE,iBAAiB,EAAE,iBAAiB;QACpC,SAAS,EAAE,IAAI,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC/C,gGAAgG;QAChG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,cAAuB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvE,CAAC;IACF,MAAM,MAAM,GAAG,8BAA8B,CAAC,UAAU,CAAC,CAAC;IAC1D,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;IAC5F,iFAAiF;IACjF,MAAM,OAAO,GAAG,SAAS;QACvB,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpI,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,OAAO,GAAc;QACzB,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;QAC1D,0FAA0F;QAC1F,mBAAmB,EAAE,SAAS,CAAC,CAAC,CAAE,YAAsB,CAAC,CAAC,CAAE,MAAgB;QAC5E,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,SAAkB,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClE,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC;AAED;;uFAEuF;AACvF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAkB,EAClB,IAQC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IACtC,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,+BAA+B,EAAE,CAAC;IAC/F,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC;IACtE,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAE7D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACjD,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,WAAW,IAAI,EAAE,CAAC;IACtD,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,MAAM,CAC/C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CACjE,CAAC;IACF,MAAM,WAAW,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,SAAS,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAsB;QAClC,OAAO,EAAE,eAAe;QACxB,EAAE,EAAE,SAAS;QACb,cAAc,EAAE,OAAO,CAAC,UAAU,CAAC,EAAE;QACrC,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,sFAAsF;QACtF,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC;QAC9B,SAAS,EAAE,GAAG;QACd,cAAc,EAAE,UAAU;QAC1B,IAAI,EAAE,EAAE,QAAQ,EAAE,iBAAiB,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,CAAC,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,EAAE;QACnH,QAAQ,EAAE,MAAM,WAAW,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/D,eAAe,EAAE,YAAY;QAC7B,WAAW;KACZ,CAAC;IACF,MAAM,MAAM,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;IACzF,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC1J,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,mBAAmB,EAAE,CAAC;QAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,mBAAmB,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAChC,CAAC"}

package/dist/messaging/consult-routing.d.ts

@@ -0,0 +1,289 @@
+import { consultGrantRecordKey, type ConsultAnswerV1, type ConsultProvenanceV1, type ConsultRequestV1, type ConsultationIntentV1 } from './consult.js';
+import { type ChannelV1 } from './board.js';
+/** Org-DO pending-consult ring key (spec 329 §4.1). */
+export declare const routingPendingKey: (topicId: string, questionId: string) => string;
+/** ConsultationIntent description-record key (spec 329 §5) — one per consulted member. */
+export declare const consultationIntentKey: (questionId: string, memberSA: string) => string;
+/** One row of the org's directory as the eligibility filter consumes it (already gate-verified by
+ *  the execution point; `current` is the isListingCurrent verdict at read time). */
+export interface ConsultRosterRowV1 {
+    /** Listing subject (CAIP-10 or 0x). */
+    subject: string;
+    displayName: string;
+    /** The aporg:consultable listing HINT (spec 329 §2.2). Absent ⇒ false. */
+    consultable?: boolean;
+    /** The member's self-asserted PRIMARY ROLE in THIS org (spec 329 §12), from their signed
+     *  listing — e.g. 'tax advisor'. Absent ⇒ no role asserted (never inferred). */
+    orgRole?: string;
+    current: boolean;
+}
+export interface EligibleConsultMemberV1 {
+    /** Lowercased 0x member SA. */
+    memberSA: string;
+    displayName: string;
+    /** spec 329 §12 — the listing-sourced org role, carried through ranking to the candidate. */
+    orgRole?: string;
+}
+/**
+ * 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 declare function eligibleConsultMembers(args: {
+    roster: ConsultRosterRowV1[];
+    channel: Pick<ChannelV1, 'participationPolicy' | 'visibility' | 'members'>;
+    /** Member SAs (lowercased 0x) with a PRESENT consultability grant in the org's grant store. */
+    grantMembers: string[];
+    /** The org SA (0x) — excluded structurally. */
+    orgSA: string;
+}): EligibleConsultMemberV1[];
+/** The public discovery facets one candidate enriches with (ADR-0040 public tier only — the
+ *  demo-discovery-mcp `/agent` projection). All optional; missing facets mean fewer signals. */
+export interface ConsultCandidateFacetsV1 {
+    name?: string | null;
+    displayName?: string | null;
+    description?: string | null;
+    /** `atl:skills` public assertion (spec 282), comma-joined. Post-spec-331 this carries canonical
+     *  CAPABILITY IDS, not free text. */
+    skills?: string | null;
+    /** Spec 331 — the capability ids parsed out of `skills` by discovery. `[]` = declared nothing
+     *  structured; that is an answer, never a wildcard. */
+    capabilityIds?: string[];
+    /** Spec 331 — the three public facet predicates, comma-joined as published on chain.
+     *  languages = BCP-47 lowercase; regions = ISO 3166 / GeoFeatureRegistry uppercase;
+     *  focusAreas = open subject labels (soft boost ONLY, never a filter). */
+    languages?: string | null;
+    regions?: string | null;
+    focusAreas?: string | null;
+    facets?: string[];
+    shaclConforms?: boolean;
+    registered?: boolean;
+    /** Discovery agent kind, when known (e.g. 'person' | 'org'). Org-kind candidates are DROPPED —
+     *  person agents only (spec 329 §4 depth-1 rule). */
+    kind?: string | null;
+    /** Claimed-capability tier (capability-architecture.md §2 `aps:claimsCapability`) — the capability ids
+     *  this member is BOTH declared for AND INDEPENDENTLY endorsed for. The abuse rules (self-endorsement
+     *  ignored, volume deduped by issuer, same-org discounted, staleness decayed) are ALREADY applied by the
+     *  discovery transport that reads the raw attestations (demo-a2a discovery-facets), so this list is the
+     *  clean, trustworthy signal: an id here means "an independent third party vouched, and the subject also
+     *  claims it". The pure scorer never re-derives it — one policy, computed where the raw data lives. */
+    endorsedCapabilityIds?: string[];
+    /** DISTINCT non-self issuers of valid endorsements (self + volume already collapsed). Corroboration. */
+    independentEndorsers?: number;
+}
+/** One surfaced candidate (the apdisc:MatchCandidate shape, flattened): score + evidence path. */
+export interface ConsultCandidateV1 {
+    memberSA: string;
+    displayName: string;
+    /** Discovery handle (the `name` facet, e.g. 'alice.impact'), when known. */
+    handle?: string;
+    /** spec 329 §12 — the member's self-asserted PRIMARY ROLE in this org, sourced from their SIGNED
+     *  listing (NOT from discovery): a question addressing a role ("@ask tax advisor …") selects the
+     *  candidate(s) holding it, ahead of a generic skill match. Absent ⇒ none asserted; the routed
+     *  turn must then fall back to published skills (never invent a role). Survives degraded mode —
+     *  it is roster-sourced, so discovery being unreachable does not erase it. */
+    orgRole?: string;
+    /** The candidate's PUBLISHED `atl:skills` labels (spec 282, parsed from the comma-joined public
+     *  assertion). Empty ⇒ none published OR none readable — `enriched` says which (spec 329 §4:
+     *  the routed turn matches the question's subject against THESE; an empty list must be stated
+     *  explicitly so the model never hallucinates expertise). */
+    skills: string[];
+    /** 0..1 — `0.6·fit + 0.4·trust` (spec 281). 0 in degraded (un-enriched) mode. */
+    score: number;
+    /** Whether discovery facets informed this candidate (false ⇒ roster-only signals). */
+    enriched: boolean;
+    /** Human-readable evidence citations (audit + attribution basis). */
+    evidence: string[];
+    satisfiedMandates: string[];
+    /** Spec 331 — the capability ids this member declared (empty ⇒ none published/none readable). */
+    capabilityIds?: string[];
+    /** How many needed capability ids matched (exact + specialization). Tie-break + audit. */
+    capabilityHits?: number;
+    /** How many requested region codes matched. A BOOST and a tie-break — never a filter. */
+    regionHits?: number;
+    /** True ⇒ this candidate's fit rests on lexical matching alone, because the question resolved to
+     *  no capability id. Surfaced so "it still passes for the old reason" is visible, not silent. */
+    lexicalOnly?: boolean;
+    /** Claimed-capability tier — the requested capability ids this member is both declared for AND
+     *  independently endorsed for (the ones the endorsement boost fired on). Surfaced for the UI/evidence. */
+    endorsedCapabilityIds?: string[];
+}
+export interface ConsultRankingV1 {
+    /** False ⇔ discovery was unreachable — the un-enriched, un-ranked eligible set (spec 329 §4
+     *  degraded mode: fail-open to fewer signals, NEVER to more candidates). */
+    enriched: boolean;
+    candidates: ConsultCandidateV1[];
+    droppedByMandates: number;
+}
+/** A question resolved into structured need (spec 331 §4.1). Every field optional: a caller with no
+ *  catalog supplies none and the matcher degrades to the lexical fallback — VISIBLY, via evidence. */
+export interface StructuredNeedV1 {
+    /** Canonical capability ids the question resolved to. */
+    capabilityIds?: string[];
+    /** Their descendants in the catalog DAG, pre-expanded by the caller (downward walk only). */
+    specializationIds?: string[];
+    /** Uppercase region codes the question named. */
+    regions?: string[];
+    /** BCP-47 tags the question named. */
+    languages?: string[];
+    /** Focus-area labels the question named. */
+    focusAreas?: string[];
+}
+/**
+ * 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 declare function rankConsultCandidates(args: {
+    eligible: EligibleConsultMemberV1[];
+    facets: Record<string, ConsultCandidateFacetsV1> | null;
+    need: string;
+    /** requireSkill mandates (spec 281 hard filters) — applied only to enriched candidates. */
+    skillHints?: string[];
+    /** Spec 331 — the question resolved into structured need. Omit it and ranking is exactly the
+     *  pre-migration lexical behaviour, so adoption is incremental rather than a flag day. */
+    structured?: StructuredNeedV1;
+    max?: number;
+}): ConsultRankingV1;
+/**
+ * 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 declare function routingToolsAllowed(args: {
+    routing: unknown;
+    assistant: unknown;
+    wirePresent: boolean;
+    triggerActor?: string | null;
+}): boolean;
+/** How the routed turn actually ended (the harness's own counters — never planner claims). */
+export interface RoutedTurnStateV1 {
+    /** Did post_topic_message commit a reply this dispatch? */
+    posted: boolean;
+    /** Consults actually submitted (ask_member successes). */
+    askedCount: number;
+    /** The run's terminal outcome ('failed' also covers a thrown routed attempt). */
+    outcome: 'completed' | 'failed';
+    error?: string;
+}
+export type RoutedTurnDegradeV1 = 
+/** Reply posted — nothing to repair (`cause` present iff routed residue failed after the post: audit-only). */
+{
+    action: 'none';
+    cause?: string;
+}
+/** Consults ARE in flight but no reply landed ⇒ the harness posts the deterministic honest
+ *  status itself (determinism by construction — turn 2 will follow up). */
+ | {
+    action: 'post-status';
+    cause: string;
+}
+/** Nothing posted, nothing asked ⇒ degrade to the plain spec-327 single-tool turn
+ *  (routing inert for this dispatch, never a dead turn). */
+ | {
+    action: 'plain-turn';
+    cause: string;
+};
+/** The degrade verdict for a finished (or thrown) ROUTED turn. Fail-closed toward the member:
+ *  every branch ends with a posted reply. */
+export declare function routedTurnDegrade(s: RoutedTurnStateV1): RoutedTurnDegradeV1;
+/** 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 declare function buildConsultRequest(args: {
+    question: string;
+    orgSA: string;
+    topicId: string;
+    questionId: string;
+    topicTitle?: string;
+    tail?: Array<{
+        author: string;
+        bodyText: string;
+    }>;
+}): ConsultRequestV1;
+/** Build the drafted→expressed ConsultationIntent description record (spec 329 §5). */
+export declare function buildConsultationIntentRecord(args: {
+    questionId: string;
+    orgSA: string;
+    memberSA: string;
+    topicId: string;
+    timeoutMs?: number;
+    now?: string;
+}): ConsultationIntentV1;
+export type ConsultOutcomeStatus = 'answered' | 'declined' | 'timedOut' | 'failed' | 'revoked';
+/** One consulted member's terminal outcome, as the synthesis turn consumes it. */
+export interface ConsultOutcomeV1 {
+    memberSA: string;
+    displayName: string;
+    status: ConsultOutcomeStatus;
+    /** Present iff status === 'answered' (the validated ConsultAnswer body). */
+    answer?: ConsultAnswerV1;
+}
+export interface ConsultAttributionV1 {
+    /** Everyone consulted (display names, ask order). */
+    consulted: string[];
+    /** Whose answers contributed to the synthesis. */
+    contributed: string[];
+    declined: string[];
+    timedOut: string[];
+    failed: string[];
+    /** Revoked mid-flight (spec 329 W4 rule: their answer is discarded, attribution says so). */
+    revoked: string[];
+}
+/** 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 declare function consultAttribution(outcomes: ConsultOutcomeV1[]): ConsultAttributionV1;
+/** PROV fields for the synthesis post (spec 329 §6): every consulted agent, derived-from ONLY the
+ *  contributing answers' ConsultationIntent record ids. */
+export declare function buildConsultProvenance(questionId: string, outcomes: ConsultOutcomeV1[]): ConsultProvenanceV1;
+/** 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 declare function synthesisOutcomeLines(outcomes: ConsultOutcomeV1[]): string;
+/** The deterministic (rule-based) synthesis body — exact attribution, no model required. */
+export declare function deterministicSynthesisBody(question: string, outcomes: ConsultOutcomeV1[]): string;
+/** 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 declare function consultSelectionBasis(c: Pick<ConsultCandidateV1, 'skills' | 'enriched' | 'orgRole' | 'endorsedCapabilityIds'>, matchedRole?: boolean): string;
+/** 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 declare function humanizeCapability(id: string): string;
+export declare function consultCandidateLine(c: ConsultCandidateV1): string;
+/**
+ * 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 declare function questionAddressesRole(question: string, orgRole: string | undefined): boolean;
+/** 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 declare function deterministicStatusBody(members: Array<string | {
+    displayName: string;
+    basis?: string;
+}>): string;
+/** Re-export the grant-store key so execution points scanning eligibility import ONE name. */
+export { consultGrantRecordKey };
+//# sourceMappingURL=consult-routing.d.ts.map

package/dist/messaging/consult-routing.d.ts.map

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