@guyghost/swarm-dao-core 0.3.0 → 0.5.0

package/dist/governance/delegation.machine.js

@@ -0,0 +1,387 @@
+// ============================================================
+// Swarm DAO Core — Delegation Lifecycle State Machines
+// ------------------------------------------------------------
+// Source of truth for Delegated Facet Investigation (DFI, thin slice,
+// depth = 1). Two coordinated XState v5 machines:
+//
+//   • DelegationCoordinator — one per (parent agent, deliberation). Owns the
+//     parent-scoped budget counters atomically (INV-7), the enabled check
+//     (parentEnabled), and the drain/cancel cascade entry point.
+//   • DelegationRequest     — one per request. Owns the per-request lifecycle
+//     (requested → gated → spawned → reported → delegated | blocked |
+//      cancelled | failed). Pure permission guards only.
+//
+// Discipline (unchanged from proposal.machine.ts): "Le modèle décide." The
+// LLM produces ONE signal — `FACET_REQUESTED` — extracted by the orchestrator
+// from the parent agent's output. That signal feeds `REQUEST_ARRIVED`. Every
+// other transition is decided by guards + the coordinator. No call site
+// chooses a target status; it emits the event that matches what happened.
+//
+// The orchestrator owns I/O only (parse, spawn child via adapter, fold output,
+// run timers). It emits no decision the machines do not authorize. The
+// proposal machine is untouched.
+//
+// Invariants enforced here: INV-1 (depth cap), INV-2 (no ungated spawn),
+// INV-4 (terminal immutability), INV-5 (exact facet match), INV-7 (atomic
+// budget). INV-3 (LLM boundary) is structural. INV-6 (child does not vote)
+// is enforced in `intelligence/synthesis`. INV-8 (ordering) is enforced at
+// the deliberation orchestrator via `allCoordinatorsClosed()`.
+// ============================================================
+import { assign, setup } from "xstate";
+export const COORDINATOR_FINAL_STATUSES = new Set([
+    "blocked_signal",
+    "closed",
+]);
+export const REQUEST_FINAL_STATUSES = new Set([
+    "delegated",
+    "blocked",
+    "cancelled",
+    "failed",
+]);
+export function isCoordinatorFinal(status) {
+    return COORDINATOR_FINAL_STATUSES.has(status);
+}
+export function isDelegationRequestFinal(status) {
+    return REQUEST_FINAL_STATUSES.has(status);
+}
+// ── Pure helpers (INV-3, INV-5; W2, W5) ──────────────────────
+/**
+ * Normalize a facet token. Pure. The orchestrator MUST call this before
+ * emitting REQUEST_ARRIVED; guards match on the normalized value exactly.
+ */
+export function normalizeFacet(facet) {
+    return facet.trim().toLowerCase();
+}
+export function evaluateDelegationGate(input) {
+    const reasons = [];
+    const normalized = normalizeFacet(input.facet);
+    const declared = input.declared.find((d) => normalizeFacet(d.facet) === normalized);
+    if (!declared) {
+        reasons.push(`facet "${normalized}" is not declared by the parent agent`);
+    }
+    else if (normalizeFacet(declared.archetype) !== normalizeFacet(input.archetype)) {
+        reasons.push(`facet "${normalized}" is declared for archetype "${declared.archetype}", not "${input.archetype}"`);
+    }
+    if (!input.registeredArchetypes.has(normalizeFacet(input.archetype))) {
+        reasons.push(`archetype "${input.archetype}" has no registered delegation profile`);
+    }
+    if (input.parentDepth + 1 > input.maxDepth) {
+        reasons.push(`depth cap exceeded (parentDepth ${input.parentDepth} + 1 > maxDepth ${input.maxDepth})`);
+    }
+    return { ok: reasons.length === 0, reasons };
+}
+/**
+ * INV-6 boundary marker — the hash the orchestrator must compute when it
+ * merges a child output into the parent's reasoning. Verified by the
+ * `reported → delegated` guard before the fold is acknowledged.
+ */
+export function computeMergedFoldHash(mergedContent) {
+    // FNV-1a 32-bit over UTF-8. Deterministic, dependency-free; sufficient as a
+    // tampering/integrity check for the fold ack (not a security boundary).
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < mergedContent.length; i++) {
+        hash ^= mergedContent.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return `fnv1a:${(hash >>> 0).toString(16).padStart(8, "0")}`;
+}
+export function extractDelegationSignals(content) {
+    if (!content)
+        return [];
+    const signals = [];
+    const section = content.match(/##\s*Delegation Requests\s*\n([\s\S]*?)(?=\n##\s|$)/i);
+    if (!section?.[1])
+        return [];
+    for (const line of section[1].split("\n")) {
+        const m = line.match(/^\s*[-*]\s*facet:\s*([^|]+?)\s*\|\s*archetype:\s*(.+?)\s*$/i);
+        if (!m?.[1] || !m[2])
+            continue;
+        const facet = m[1].trim();
+        const archetype = m[2].trim();
+        if (facet.length > 0 && archetype.length > 0) {
+            signals.push({ facet: normalizeFacet(facet), archetype: normalizeFacet(archetype) });
+        }
+    }
+    return signals;
+}
+const coordinatorSetup = setup({
+    types: {
+        context: {},
+        input: {},
+        events: {},
+    },
+    guards: {
+        slotAvailable: ({ context }) => context.activeRequests < context.maxChildren,
+        parentEnabled: ({ context }) => context.parentEnabled === true,
+        depthWithinBudget: ({ context }) => context.parentDepth + 1 <= context.maxDepth,
+        requestAccepted: ({ context }) => context.activeRequests < context.maxChildren &&
+            context.parentEnabled === true &&
+            context.parentDepth + 1 <= context.maxDepth,
+        // "Last in flight" — this REQUEST_RESOLVED brings activeRequests to 0, so
+        // the coordinator can close. Guards evaluate BEFORE actions, hence the `<= 1`
+        // (current count minus one == zero). Without this the coordinator could never
+        // reach `closed` during a drain while children were still in flight.
+        lastInFlight: ({ context }) => context.activeRequests <= 1,
+    },
+});
+function buildCoordinatorMachine(initial) {
+    return coordinatorSetup.createMachine({
+        id: "delegationCoordinator",
+        initial,
+        context: ({ input }) => ({
+            parentAgentId: input.parentAgentId,
+            parentDepth: input.parentDepth,
+            parentEnabled: input.parentEnabled,
+            maxChildren: input.maxChildren,
+            maxDepth: input.maxDepth,
+            activeRequests: input.activeRequests,
+            lastTransitionTime: input.lastTransitionTime ?? new Date().toISOString(),
+        }),
+        states: {
+            open: {
+                on: {
+                    REQUEST_ARRIVED: [
+                        {
+                            guard: "requestAccepted",
+                            target: "open",
+                            actions: assign({
+                                activeRequests: ({ context }) => context.activeRequests + 1,
+                                lastTransitionTime: () => new Date().toISOString(),
+                            }),
+                        },
+                        // Guards failed: stay open, no budget consumed. COORD_ACK{ok:false}
+                        // is synthesized by the dispatch service from the unchanged
+                        // context + the guard outcome (see delegation.utils.ts).
+                        { target: "open" },
+                    ],
+                    REQUEST_RESOLVED: {
+                        target: "open",
+                        actions: assign({
+                            activeRequests: ({ context }) => Math.max(0, context.activeRequests - 1),
+                            lastTransitionTime: () => new Date().toISOString(),
+                        }),
+                    },
+                    DRAIN: {
+                        target: "draining",
+                        actions: assign({ lastTransitionTime: () => new Date().toISOString() }),
+                    },
+                    ERROR: {
+                        target: "blocked_signal",
+                        actions: assign({
+                            lastTransitionTime: () => new Date().toISOString(),
+                            errorMessage: ({ event }) => (event.type === "ERROR" ? event.message : ""),
+                        }),
+                    },
+                },
+            },
+            draining: {
+                on: {
+                    REQUEST_RESOLVED: [
+                        {
+                            guard: "lastInFlight",
+                            target: "closed",
+                            actions: assign({
+                                activeRequests: ({ context }) => Math.max(0, context.activeRequests - 1),
+                                lastTransitionTime: () => new Date().toISOString(),
+                            }),
+                        },
+                        {
+                            target: "draining",
+                            actions: assign({
+                                activeRequests: ({ context }) => Math.max(0, context.activeRequests - 1),
+                                lastTransitionTime: () => new Date().toISOString(),
+                            }),
+                        },
+                    ],
+                },
+            },
+            blocked_signal: { type: "final" },
+            closed: { type: "final" },
+        },
+    });
+}
+const coordinatorCache = new Map();
+export function createDelegationCoordinatorMachine(initial) {
+    let machine = coordinatorCache.get(initial);
+    if (!machine) {
+        machine = buildCoordinatorMachine(initial);
+        coordinatorCache.set(initial, machine);
+    }
+    return machine;
+}
+const requestSetup = setup({
+    types: {
+        context: {},
+        input: {},
+        events: {},
+    },
+    guards: {
+        gateApproved: ({ event }) => event.type === "GATE_DECIDED" && event.ok === true,
+        foldHashMatches: ({ event, context }) => event.type === "FOLD_COMPLETE" &&
+            typeof event.mergedAgentOutputHash === "string" &&
+            event.mergedAgentOutputHash === context.mergedAgentOutputHash,
+    },
+});
+function buildRequestMachine(initial) {
+    return requestSetup.createMachine({
+        id: "delegationRequest",
+        initial,
+        context: ({ input }) => ({
+            requestId: input.requestId,
+            parentAgentId: input.parentAgentId,
+            facet: input.facet,
+            archetype: input.archetype,
+            childAgentId: input.childAgentId,
+            mergedAgentOutputHash: input.mergedAgentOutputHash,
+            errorMessage: input.errorMessage,
+            gateReasons: input.gateReasons,
+            lastTransitionTime: input.lastTransitionTime ?? new Date().toISOString(),
+        }),
+        states: {
+            requested: {
+                on: {
+                    GATE_DECIDED: [
+                        {
+                            guard: "gateApproved",
+                            target: "gated",
+                            actions: assign({ lastTransitionTime: () => new Date().toISOString() }),
+                        },
+                        {
+                            target: "blocked",
+                            actions: assign({
+                                gateReasons: ({ event }) => (event.type === "GATE_DECIDED" ? event.reasons : []),
+                                lastTransitionTime: () => new Date().toISOString(),
+                            }),
+                        },
+                    ],
+                    CANCEL: { target: "cancelled", actions: assign({ lastTransitionTime: () => new Date().toISOString() }) },
+                    ERROR: {
+                        target: "failed",
+                        actions: assign({
+                            lastTransitionTime: () => new Date().toISOString(),
+                            errorMessage: ({ event }) => (event.type === "ERROR" ? event.message : ""),
+                        }),
+                    },
+                },
+            },
+            gated: {
+                on: {
+                    SPAWN_ACKED: {
+                        target: "spawned",
+                        actions: assign({
+                            childAgentId: ({ event }) => (event.type === "SPAWN_ACKED" ? event.childAgentId : ""),
+                            lastTransitionTime: () => new Date().toISOString(),
+                        }),
+                    },
+                    CANCEL: { target: "cancelled", actions: assign({ lastTransitionTime: () => new Date().toISOString() }) },
+                    ERROR: {
+                        target: "failed",
+                        actions: assign({
+                            lastTransitionTime: () => new Date().toISOString(),
+                            errorMessage: ({ event }) => (event.type === "ERROR" ? event.message : ""),
+                        }),
+                    },
+                },
+            },
+            spawned: {
+                on: {
+                    CHILD_REPORTED: {
+                        target: "reported",
+                        actions: assign({
+                            // The orchestrator computes the fold hash when it merges the
+                            // child output into the parent's reasoning and stores it here.
+                            // The `reported → delegated` guard verifies FOLD_COMPLETE carries
+                            // the same hash (INV-6 integrity check, B2).
+                            mergedAgentOutputHash: ({ event }) => event.type === "CHILD_REPORTED" ? computeMergedFoldHash(event.output.content ?? "") : "",
+                        }),
+                    },
+                    CHILD_FAILED: {
+                        target: "failed",
+                        actions: assign({
+                            lastTransitionTime: () => new Date().toISOString(),
+                            errorMessage: ({ event }) => (event.type === "CHILD_FAILED" ? event.error : ""),
+                        }),
+                    },
+                    SPAWN_FAILED: {
+                        target: "failed",
+                        actions: assign({
+                            lastTransitionTime: () => new Date().toISOString(),
+                            errorMessage: ({ event }) => (event.type === "SPAWN_FAILED" ? event.error : ""),
+                        }),
+                    },
+                    CANCEL: { target: "cancelled", actions: assign({ lastTransitionTime: () => new Date().toISOString() }) },
+                    ERROR: {
+                        target: "failed",
+                        actions: assign({
+                            lastTransitionTime: () => new Date().toISOString(),
+                            errorMessage: ({ event }) => (event.type === "ERROR" ? event.message : ""),
+                        }),
+                    },
+                },
+            },
+            reported: {
+                on: {
+                    FOLD_COMPLETE: {
+                        guard: "foldHashMatches",
+                        target: "delegated",
+                        actions: assign({ lastTransitionTime: () => new Date().toISOString() }),
+                    },
+                    FOLD_TIMEOUT: {
+                        target: "failed",
+                        actions: assign({
+                            lastTransitionTime: () => new Date().toISOString(),
+                            errorMessage: "fold timeout",
+                        }),
+                    },
+                    CANCEL: { target: "cancelled", actions: assign({ lastTransitionTime: () => new Date().toISOString() }) },
+                    ERROR: {
+                        target: "failed",
+                        actions: assign({
+                            lastTransitionTime: () => new Date().toISOString(),
+                            errorMessage: ({ event }) => (event.type === "ERROR" ? event.message : ""),
+                        }),
+                    },
+                },
+            },
+            delegated: { type: "final" },
+            blocked: { type: "final" },
+            cancelled: { type: "final" },
+            failed: { type: "final" },
+        },
+    });
+}
+const requestCache = new Map();
+export function createDelegationRequestMachine(initial) {
+    let machine = requestCache.get(initial);
+    if (!machine) {
+        machine = buildRequestMachine(initial);
+        requestCache.set(initial, machine);
+    }
+    return machine;
+}
+// ── Child agent + model resolution helpers ───────────────────
+/**
+ * Build the child agent descriptor for a declared delegation spec. Pure.
+ * The orchestrator spawns this via `HostAdapter.spawnAgent` using the model
+ * resolved through `buildChildModelResolutionContext`.
+ */
+export function buildChildAgent(parent, spec) {
+    return {
+        id: `${parent.id}:delegate:${normalizeFacet(spec.facet)}`,
+        name: `${parent.name} → ${spec.facet}`,
+        role: `Delegated facet investigation (${spec.archetype})`,
+        description: `Sub-agent spawned by ${parent.id} to investigate the "${spec.facet}" facet.`,
+        weight: 0, // INV-6: a child never votes.
+        systemPrompt: "", // resolved from delegationProfile[archetype].promptId by the orchestrator
+        model: spec.model && spec.model !== "inherit" ? spec.model : undefined,
+        enabled: true,
+    };
+}
+/**
+ * Resolve the profile entry for an archetype from a DAO config. Returns
+ * undefined when no profile is registered (the gate then rejects the request).
+ */
+export function resolveDelegationProfile(profiles, archetype) {
+    return profiles?.[archetype];
+}
+//# sourceMappingURL=delegation.machine.js.map

package/dist/governance/delegation.machine.js.map

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

package/dist/governance/delegation.utils.d.ts

@@ -0,0 +1,55 @@
+import type { DAOAgent, DAOConfig, DelegationProfileEntry } from "../types/index.js";
+import { type DelegationCoordinatorEvent, type DelegationCoordinatorStatus, type DelegationRequestEvent, type DelegationRequestStatus } from "./delegation.machine.js";
+export interface DelegationCoordinatorState {
+    parentAgentId: string;
+    parentDepth: number;
+    parentEnabled: boolean;
+    maxChildren: number;
+    maxDepth: number;
+    activeRequests: number;
+    status: DelegationCoordinatorStatus;
+    lastTransitionTime: string;
+    errorMessage?: string;
+}
+export interface DelegationRequestState {
+    requestId: string;
+    parentAgentId: string;
+    facet: string;
+    archetype: string;
+    status: DelegationRequestStatus;
+    childAgentId?: string;
+    mergedAgentOutputHash?: string;
+    errorMessage?: string;
+    gateReasons: string[];
+    lastTransitionTime: string;
+}
+export declare function createCoordinatorState(parent: DAOAgent, config: DAOConfig, now?: string): DelegationCoordinatorState;
+export declare function createRequestState(requestId: string, coordinator: DelegationCoordinatorState, facet: string, archetype: string, now?: string): DelegationRequestState;
+export interface CoordinatorAck {
+    requestId: string;
+    accepted: boolean;
+    reason?: string;
+}
+export type CoordinatorDispatchResult = {
+    ok: true;
+    status: DelegationCoordinatorStatus;
+    ack?: CoordinatorAck;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function dispatchCoordinatorEvent(state: DelegationCoordinatorState, event: DelegationCoordinatorEvent): CoordinatorDispatchResult;
+export type RequestDispatchResult = {
+    ok: true;
+    status: DelegationRequestStatus;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function dispatchDelegationEvent(state: DelegationRequestState, event: DelegationRequestEvent): RequestDispatchResult;
+export declare function registeredArchetypes(config: DAOConfig): Set<string>;
+export declare function profileFor(config: DAOConfig, archetype: string): DelegationProfileEntry | undefined;
+export declare function registerProposalCoordinators(proposalId: number, states: DelegationCoordinatorState[]): void;
+export declare function clearProposalCoordinators(proposalId: number): void;
+export declare function allCoordinatorsClosed(proposalId: number): boolean;
+//# sourceMappingURL=delegation.utils.d.ts.map

package/dist/governance/delegation.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegation.utils.d.ts","sourceRoot":"","sources":["../../src/governance/delegation.utils.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,EAIL,KAAK,0BAA0B,EAE/B,KAAK,2BAA2B,EAEhC,KAAK,sBAAsB,EAE3B,KAAK,uBAAuB,EAG7B,MAAM,yBAAyB,CAAC;AAQjC,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,2BAA2B,CAAC;IACpC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,uBAAuB,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAID,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,SAAS,EACjB,GAAG,GAAE,MAAiC,GACrC,0BAA0B,CAY5B;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,0BAA0B,EACvC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,MAAiC,GACrC,sBAAsB,CAUxB;AAID,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,yBAAyB,GACjC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,2BAA2B,CAAC;IAAC,GAAG,CAAC,EAAE,cAAc,CAAA;CAAE,GACvE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AASjC,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,0BAA0B,EACjC,KAAK,EAAE,0BAA0B,GAChC,yBAAyB,CA4C3B;AAID,MAAM,MAAM,qBAAqB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,uBAAuB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,sBAAsB,EAC7B,KAAK,EAAE,sBAAsB,GAC5B,qBAAqB,CAsCvB;AAID,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,CAInE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,sBAAsB,GAAG,SAAS,CAEnG;AAYD,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,0BAA0B,EAAE,GAAG,IAAI,CAE3G;AAED,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAElE;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAIjE"}

package/dist/governance/delegation.utils.js

@@ -0,0 +1,157 @@
+// ============================================================
+// Swarm DAO Core — Delegation Dispatch Service
+// ------------------------------------------------------------
+// The only sanctioned way to mutate a delegation lifecycle. Mirrors
+// `dispatchProposalEvent`: rehydrate an actor at the persisted status,
+// ask the machine whether the event is permitted (guards included),
+// and only then write the new status + context back. No other writer.
+//
+// Two services, one per machine:
+//   • dispatchCoordinatorEvent — mutates a DelegationCoordinatorState
+//   • dispatchDelegationEvent  — mutates a DelegationRequestState
+//
+// The orchestrator (intelligence layer) owns these state objects and drives
+// them through the cascade: signal → REQUEST_ARRIVED → COORD_ACK →
+// GATE_DECIDED → SPAWN_ACKED → CHILD_REPORTED → FOLD_COMPLETE. It never
+// names a target status; it emits events.
+// ============================================================
+import { createActor } from "xstate";
+import { createDelegationCoordinatorMachine, createDelegationRequestMachine, isCoordinatorFinal, isDelegationRequestFinal, } from "./delegation.machine.js";
+// ── Factories ────────────────────────────────────────────────
+export function createCoordinatorState(parent, config, now = new Date().toISOString()) {
+    const delegation = config.delegation;
+    return {
+        parentAgentId: parent.id,
+        parentDepth: 0, // thin slice: the council member is always depth 0
+        parentEnabled: Boolean(parent.enabled !== false && delegation?.enabled === true),
+        maxChildren: delegation?.maxChildrenPerParent ?? 0,
+        maxDepth: delegation?.maxDepth ?? 0,
+        activeRequests: 0,
+        status: "open",
+        lastTransitionTime: now,
+    };
+}
+export function createRequestState(requestId, coordinator, facet, archetype, now = new Date().toISOString()) {
+    return {
+        requestId,
+        parentAgentId: coordinator.parentAgentId,
+        facet,
+        archetype,
+        status: "requested",
+        gateReasons: [],
+        lastTransitionTime: now,
+    };
+}
+function coordinatorReason(state) {
+    if (!state.parentEnabled)
+        return "delegation is disabled for this parent";
+    if (state.parentDepth + 1 > state.maxDepth)
+        return "depth cap reached";
+    if (state.activeRequests >= state.maxChildren)
+        return "children budget exhausted";
+    return "rejected";
+}
+export function dispatchCoordinatorEvent(state, event) {
+    if (isCoordinatorFinal(state.status)) {
+        return { ok: false, error: `Coordinator is in terminal status "${state.status}"; no transitions are permitted.` };
+    }
+    const machine = createDelegationCoordinatorMachine(state.status);
+    const actor = createActor(machine, {
+        input: {
+            parentAgentId: state.parentAgentId,
+            parentDepth: state.parentDepth,
+            parentEnabled: state.parentEnabled,
+            maxChildren: state.maxChildren,
+            maxDepth: state.maxDepth,
+            activeRequests: state.activeRequests,
+            lastTransitionTime: state.lastTransitionTime,
+            errorMessage: state.errorMessage,
+        },
+    });
+    actor.start();
+    if (!actor.getSnapshot().can(event)) {
+        return { ok: false, error: `Event "${event.type}" is not permitted from coordinator status "${state.status}".` };
+    }
+    const before = state.activeRequests;
+    actor.send(event);
+    const snapshot = actor.getSnapshot();
+    const status = snapshot.value;
+    const ctx = snapshot.context;
+    state.status = status;
+    state.activeRequests = ctx.activeRequests;
+    state.lastTransitionTime = ctx.lastTransitionTime;
+    state.errorMessage = ctx.errorMessage;
+    let ack;
+    if (event.type === "REQUEST_ARRIVED") {
+        const accepted = ctx.activeRequests > before;
+        ack = accepted
+            ? { requestId: event.requestId, accepted: true }
+            : { requestId: event.requestId, accepted: false, reason: coordinatorReason(state) };
+    }
+    return { ok: true, status, ack };
+}
+export function dispatchDelegationEvent(state, event) {
+    if (isDelegationRequestFinal(state.status)) {
+        return { ok: false, error: `Request is in terminal status "${state.status}"; no transitions are permitted.` };
+    }
+    const machine = createDelegationRequestMachine(state.status);
+    const actor = createActor(machine, {
+        input: {
+            requestId: state.requestId,
+            parentAgentId: state.parentAgentId,
+            facet: state.facet,
+            archetype: state.archetype,
+            childAgentId: state.childAgentId,
+            mergedAgentOutputHash: state.mergedAgentOutputHash,
+            errorMessage: state.errorMessage,
+            gateReasons: state.gateReasons,
+            lastTransitionTime: state.lastTransitionTime,
+        },
+    });
+    actor.start();
+    if (!actor.getSnapshot().can(event)) {
+        return { ok: false, error: `Event "${event.type}" is not permitted from request status "${state.status}".` };
+    }
+    actor.send(event);
+    const snapshot = actor.getSnapshot();
+    const status = snapshot.value;
+    const ctx = snapshot.context;
+    state.status = status;
+    state.childAgentId = ctx.childAgentId;
+    state.mergedAgentOutputHash = ctx.mergedAgentOutputHash;
+    state.errorMessage = ctx.errorMessage;
+    state.gateReasons = ctx.gateReasons;
+    state.lastTransitionTime = ctx.lastTransitionTime;
+    return { ok: true, status };
+}
+// ── Convenience: is this archetype registered? ───────────────
+export function registeredArchetypes(config) {
+    const set = new Set();
+    for (const key of Object.keys(config.delegationProfile ?? {}))
+        set.add(key);
+    return set;
+}
+export function profileFor(config, archetype) {
+    return config.delegationProfile?.[archetype];
+}
+// ── Proposal ↔ coordinator registry (INV-8) ──────────────────
+//
+// The deliberation orchestrator owns DelegationCoordinator states. For the
+// `delegation-closed` control gate to enforce INV-8 (no APPROVE while a
+// delegation is in flight), the orchestrator registers the live coordinators
+// for a proposal; the gate reads this registry. Cleared when a proposal leaves
+// the deliberation phase.
+const proposalCoordinators = new Map();
+export function registerProposalCoordinators(proposalId, states) {
+    proposalCoordinators.set(proposalId, states);
+}
+export function clearProposalCoordinators(proposalId) {
+    proposalCoordinators.delete(proposalId);
+}
+export function allCoordinatorsClosed(proposalId) {
+    const states = proposalCoordinators.get(proposalId);
+    if (!states || states.length === 0)
+        return true;
+    return states.every((s) => s.status === "closed" || s.status === "blocked_signal");
+}
+//# sourceMappingURL=delegation.utils.js.map

package/dist/governance/delegation.utils.js.map

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