@guyghost/swarm-dao-core 0.3.0 → 0.4.0

package/dist/intelligence/delegation.js

@@ -0,0 +1,162 @@
+// ============================================================
+// Swarm DAO Core — Delegation Orchestrator (DFI thin slice)
+// ------------------------------------------------------------
+// I/O layer ONLY. Drives the two delegation machines through their events.
+// Owns: parse parent LLM signal, evaluate the pure gate, spawn child via
+// `HostAdapter.spawnAgent`, fold child reasoning into the parent output, and
+// run the drain/cancel cascade. Emits NO decision the machines do not
+// authorize (INV-3). Child outputs fold into parent REASONING only — never
+// into votes (INV-6, enforced structurally: weight 0, separate section).
+//
+// Fold integrity (B2): the request machine commits to a fold hash on
+// CHILD_REPORTED (FNV-1a over the child output content) and the orchestrator
+// must echo the identical hash on FOLD_COMPLETE. This binds the fold ack to
+// the observed child report. A request cannot leave `reported` otherwise.
+// ============================================================
+import { buildChildAgent, computeMergedFoldHash, evaluateDelegationGate, extractDelegationSignals, normalizeFacet, } from "../governance/delegation.machine.js";
+import { createCoordinatorState, createRequestState, dispatchCoordinatorEvent, dispatchDelegationEvent, profileFor, registeredArchetypes, } from "../governance/delegation.utils.js";
+import { buildChildModelResolutionContext, resolveAgentModel } from "./model.js";
+/**
+ * Run all declared delegations for a parent agent after it has produced an
+ * output. Returns the (possibly folded) parent content and the live machine
+ * states. No-op when delegation is disabled, the agent declares no delegates,
+ * or the parent emitted no recognizable signal.
+ */
+export async function runDelegations(params) {
+    const { parent, parentOutput, proposal, adapter, config, parentModelContext } = params;
+    const content = parentOutput.content ?? "";
+    const coordinators = [];
+    const requests = [];
+    const delegation = config.delegation;
+    const declared = parent.delegates ?? [];
+    const signals = delegation?.enabled === true && declared.length > 0 ? extractDelegationSignals(content) : [];
+    if (signals.length === 0) {
+        return { foldedContent: content, coordinators, requests, delegated: false };
+    }
+    const coordinator = createCoordinatorState(parent, config);
+    coordinators.push(coordinator);
+    params.onCoordinatorCreated?.(coordinator);
+    const archetypes = registeredArchetypes(config);
+    const parentResolvedModel = resolveAgentModel(parent, parentModelContext);
+    let counter = 0;
+    let delegated = false;
+    let foldedContent = content;
+    for (const signal of signals) {
+        const requestId = `${parent.id}:${normalizeFacet(signal.facet)}:${counter++}`;
+        const arrived = dispatchCoordinatorEvent(coordinator, {
+            type: "REQUEST_ARRIVED",
+            requestId,
+            facet: signal.facet,
+            archetype: signal.archetype,
+        });
+        if (!arrived.ok || arrived.ack?.accepted === false) {
+            // Coordinator-level refusal (budget / disabled / depth). Record a blocked
+            // request for audit; no child is spawned (INV-2, W4).
+            const req = createRequestState(requestId, coordinator, signal.facet, signal.archetype);
+            requests.push(req);
+            dispatchDelegationEvent(req, {
+                type: "GATE_DECIDED",
+                ok: false,
+                reasons: [arrived.ok ? (arrived.ack?.reason ?? "rejected by coordinator") : arrived.error],
+            });
+            continue;
+        }
+        const req = createRequestState(requestId, coordinator, signal.facet, signal.archetype);
+        requests.push(req);
+        // Per-request gate (pure). Single authority for facet/archetype/depth.
+        const gate = evaluateDelegationGate({
+            facet: signal.facet,
+            archetype: signal.archetype,
+            parentDepth: coordinator.parentDepth,
+            maxDepth: delegation?.maxDepth ?? 0,
+            declared,
+            registeredArchetypes: archetypes,
+        });
+        dispatchDelegationEvent(req, { type: "GATE_DECIDED", ok: gate.ok, reasons: gate.reasons });
+        if (!gate.ok) {
+            // Resolve the coordinator slot we consumed: a blocked request is terminal.
+            dispatchCoordinatorEvent(coordinator, { type: "REQUEST_RESOLVED", requestId, terminalStatus: "blocked" });
+            continue;
+        }
+        dispatchDelegationEvent(req, {
+            type: "SPAWN_ACKED",
+            childAgentId: `${parent.id}:delegate:${normalizeFacet(signal.facet)}`,
+        });
+        const spec = declared.find((d) => normalizeFacet(d.facet) === normalizeFacet(signal.facet));
+        const childAgent = buildChildAgent(parent, spec ?? { facet: signal.facet, archetype: signal.archetype });
+        const profile = profileFor(config, signal.archetype);
+        const childModel = resolveAgentModel(childAgent, buildChildModelResolutionContext(config.defaultModel, {
+            parentAgentModel: parentResolvedModel,
+            profile,
+            parentSessionModel: parentModelContext.parentSessionModel,
+            hostDefaultModel: parentModelContext.hostDefaultModel,
+        }));
+        try {
+            const childOutput = await adapter.spawnAgent({
+                agent: childAgent,
+                proposal,
+                systemPrompt: profile?.promptId ? `[prompt:${profile.promptId}]` : childAgent.systemPrompt,
+                model: childModel,
+                timeoutMs: delegation?.foldTimeoutMs,
+            });
+            if (childOutput.error) {
+                dispatchDelegationEvent(req, { type: "CHILD_FAILED", error: childOutput.error });
+                dispatchCoordinatorEvent(coordinator, { type: "REQUEST_RESOLVED", requestId, terminalStatus: "failed" });
+                continue;
+            }
+            dispatchDelegationEvent(req, { type: "CHILD_REPORTED", output: childOutput });
+            // Fold: merge child reasoning into the parent's content (INV-6).
+            foldedContent = foldChildIntoParent(foldedContent, signal, childOutput);
+            // Echo the machine's commitment hash to acknowledge the fold (B2).
+            dispatchDelegationEvent(req, {
+                type: "FOLD_COMPLETE",
+                foldedInto: parent.id,
+                mergedAgentOutputHash: computeMergedFoldHash(childOutput.content ?? ""),
+            });
+            delegated = true;
+            dispatchCoordinatorEvent(coordinator, { type: "REQUEST_RESOLVED", requestId, terminalStatus: "delegated" });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : "spawn failed";
+            dispatchDelegationEvent(req, { type: "SPAWN_FAILED", error: message });
+            dispatchCoordinatorEvent(coordinator, { type: "REQUEST_RESOLVED", requestId, terminalStatus: "failed" });
+        }
+    }
+    return { foldedContent, coordinators, requests, delegated };
+}
+/**
+ * Append the child's investigation under a `## Delegated Facets` section.
+ * Pure. The parent's `## Vote` section is never touched (INV-6).
+ */
+export function foldChildIntoParent(parentContent, signal, childOutput) {
+    const childBlock = [
+        "",
+        "## Delegated Facets",
+        `### facet: ${signal.facet} | archetype: ${signal.archetype}`,
+        childOutput.content?.trim() ?? "_(no output)_",
+        "",
+    ].join("\n");
+    return `${parentContent.replace(/\n*$/, "")}\n${childBlock}`;
+}
+/**
+ * Drain/cancel cascade (B3). Emit DRAIN to each coordinator, then CANCEL to
+ * every non-terminal request. Idempotent: terminal states ignore events.
+ */
+export function drainDelegations(coordinators, requests) {
+    for (const c of coordinators) {
+        dispatchCoordinatorEvent(c, { type: "DRAIN", reason: "proposal-terminal" });
+    }
+    const byParent = new Map(coordinators.map((c) => [c.parentAgentId, c]));
+    for (const r of requests) {
+        dispatchDelegationEvent(r, { type: "CANCEL", reason: "proposal-terminal" });
+        const owner = byParent.get(r.parentAgentId) ?? coordinators[0];
+        if (owner) {
+            dispatchCoordinatorEvent(owner, {
+                type: "REQUEST_RESOLVED",
+                requestId: r.requestId,
+                terminalStatus: "cancelled",
+            });
+        }
+    }
+}
+//# sourceMappingURL=delegation.js.map

package/dist/intelligence/delegation.js.map

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

package/dist/intelligence/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./delegation.js";
 export * from "./model.js";
 export * from "./swarm.js";
 export * from "./synthesis.js";

package/dist/intelligence/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/intelligence/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/intelligence/index.ts"],"names":[],"mappings":"AACA,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/intelligence/index.js

@@ -1,4 +1,5 @@
 // Intelligence Layer (L2) — Swarm Dispatch, Synthesis
+export * from "./delegation.js";
 export * from "./model.js";
 export * from "./swarm.js";
 export * from "./synthesis.js";

package/dist/intelligence/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/intelligence/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/intelligence/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/intelligence/model.d.ts

@@ -1,16 +1,42 @@
-import type { DAOAgent } from "../types/index.js";
+import type { DAOAgent, DelegationProfileEntry } from "../types/index.js";
 export interface ModelResolutionContext {
+    /** Model set on a parent agent (delegation inheritance). */
+    parentAgentModel?: string;
+    /** Model declared by the delegation profile for the child's archetype. */
+    profileDefaultModel?: string;
     parentSessionModel?: string;
     configDefaultModel: string;
     hostDefaultModel?: string;
 }
 /**
  * Resolve the model for a DAO agent using the inheritance chain:
- * agent.model → parent session → config.defaultModel → host default
+ *
+ *     agent.model
+ *       → profile.defaultModel      (delegation profile, child archetype)
+ *       → parentAgent.resolvedModel (delegation parent — default behaviour)
+ *       → parentSessionModel
+ *       → config.defaultModel
+ *       → host default
+ *
+ * For a delegated child, `agent.model` carries the child's `DelegationSpec.model`
+ * (where `"inherit"` / omitted ⇒ fall through to the parent). The chain is
+ * strictly additive: every layer may only refine, never branch.
  */
 export declare function resolveAgentModel(agent: DAOAgent, ctx: ModelResolutionContext): string;
 export declare function describeModelResolution(agent: DAOAgent, resolved: string, ctx: ModelResolutionContext): string;
 export declare function buildModelResolutionContext(configDefaultModel: string, options?: {
+    parentAgentModel?: string;
+    parentSessionModel?: string;
+    hostDefaultModel?: string;
+}): ModelResolutionContext;
+/**
+ * Build a resolution context for a delegated child. `profileDefaultModel` is
+ * sourced from the DAO's delegation profile for the child's archetype; the
+ * parent agent's resolved model is the default the child inherits.
+ */
+export declare function buildChildModelResolutionContext(configDefaultModel: string, options: {
+    parentAgentModel: string;
+    profile?: DelegationProfileEntry;
     parentSessionModel?: string;
     hostDefaultModel?: string;
 }): ModelResolutionContext;

package/dist/intelligence/model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/intelligence/model.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,WAAW,sBAAsB;IACrC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAWD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,sBAAsB,GAAG,MAAM,CAEtF;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,sBAAsB,GAAG,MAAM,CAc9G;AAED,wBAAgB,2BAA2B,CACzC,kBAAkB,EAAE,MAAM,EAC1B,OAAO,CAAC,EAAE;IACR,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GACA,sBAAsB,CAMxB"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/intelligence/model.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE1E,MAAM,WAAW,sBAAsB;IACrC,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0EAA0E;IAC1E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAWD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,sBAAsB,GAAG,MAAM,CAYtF;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,sBAAsB,GAAG,MAAM,CAqB9G;AAED,wBAAgB,2BAA2B,CACzC,kBAAkB,EAAE,MAAM,EAC1B,OAAO,CAAC,EAAE;IACR,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GACA,sBAAsB,CAOxB;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC9C,kBAAkB,EAAE,MAAM,EAC1B,OAAO,EAAE;IACP,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,sBAAsB,CAAC;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GACA,sBAAsB,CAQxB"}

package/dist/intelligence/model.js

@@ -11,15 +11,33 @@ function pickModel(...candidates) {
 }
 /**
  * Resolve the model for a DAO agent using the inheritance chain:
- * agent.model → parent session → config.defaultModel → host default
+ *
+ *     agent.model
+ *       → profile.defaultModel      (delegation profile, child archetype)
+ *       → parentAgent.resolvedModel (delegation parent — default behaviour)
+ *       → parentSessionModel
+ *       → config.defaultModel
+ *       → host default
+ *
+ * For a delegated child, `agent.model` carries the child's `DelegationSpec.model`
+ * (where `"inherit"` / omitted ⇒ fall through to the parent). The chain is
+ * strictly additive: every layer may only refine, never branch.
  */
 export function resolveAgentModel(agent, ctx) {
-    return pickModel(agent.model, ctx.parentSessionModel, ctx.configDefaultModel, ctx.hostDefaultModel) ?? "default";
+    const childOverride = agent.model && agent.model !== "inherit" ? agent.model : undefined;
+    return (pickModel(childOverride, ctx.profileDefaultModel, ctx.parentAgentModel, ctx.parentSessionModel, ctx.configDefaultModel, ctx.hostDefaultModel) ?? "default");
 }
 export function describeModelResolution(agent, resolved, ctx) {
-    if (agent.model) {
+    const childOverride = agent.model && agent.model !== "inherit" ? agent.model : undefined;
+    if (childOverride && resolved === childOverride) {
         return `${resolved} (agent override)`;
     }
+    if (ctx.profileDefaultModel && resolved === ctx.profileDefaultModel) {
+        return `${resolved} (delegation profile default)`;
+    }
+    if (ctx.parentAgentModel && resolved === ctx.parentAgentModel) {
+        return `${resolved} (inherited from parent agent)`;
+    }
     if (ctx.parentSessionModel && resolved === ctx.parentSessionModel) {
         return `${resolved} (inherited from parent session)`;
     }
@@ -33,9 +51,24 @@ export function describeModelResolution(agent, resolved, ctx) {
 }
 export function buildModelResolutionContext(configDefaultModel, options) {
     return {
+        parentAgentModel: options?.parentAgentModel,
         parentSessionModel: options?.parentSessionModel,
         configDefaultModel,
         hostDefaultModel: options?.hostDefaultModel,
     };
 }
+/**
+ * Build a resolution context for a delegated child. `profileDefaultModel` is
+ * sourced from the DAO's delegation profile for the child's archetype; the
+ * parent agent's resolved model is the default the child inherits.
+ */
+export function buildChildModelResolutionContext(configDefaultModel, options) {
+    return {
+        parentAgentModel: options.parentAgentModel,
+        profileDefaultModel: options.profile?.defaultModel,
+        parentSessionModel: options.parentSessionModel,
+        configDefaultModel,
+        hostDefaultModel: options.hostDefaultModel,
+    };
+}
 //# sourceMappingURL=model.js.map

package/dist/intelligence/model.js.map

@@ -1 +1 @@
-{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/intelligence/model.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,oCAAoC;AACpC,+DAA+D;AAU/D,SAAS,SAAS,CAAC,GAAG,UAAqC;IACzD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,SAAS,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAe,EAAE,GAA2B;IAC5E,OAAO,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,kBAAkB,EAAE,GAAG,CAAC,kBAAkB,EAAE,GAAG,CAAC,gBAAgB,CAAC,IAAI,SAAS,CAAC;AACnH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAe,EAAE,QAAgB,EAAE,GAA2B;IACpG,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,OAAO,GAAG,QAAQ,mBAAmB,CAAC;IACxC,CAAC;IACD,IAAI,GAAG,CAAC,kBAAkB,IAAI,QAAQ,KAAK,GAAG,CAAC,kBAAkB,EAAE,CAAC;QAClE,OAAO,GAAG,QAAQ,kCAAkC,CAAC;IACvD,CAAC;IACD,IAAI,QAAQ,KAAK,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACxC,OAAO,GAAG,QAAQ,gBAAgB,CAAC;IACrC,CAAC;IACD,IAAI,GAAG,CAAC,gBAAgB,IAAI,QAAQ,KAAK,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAC9D,OAAO,GAAG,QAAQ,iBAAiB,CAAC;IACtC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,kBAA0B,EAC1B,OAGC;IAED,OAAO;QACL,kBAAkB,EAAE,OAAO,EAAE,kBAAkB;QAC/C,kBAAkB;QAClB,gBAAgB,EAAE,OAAO,EAAE,gBAAgB;KAC5C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/intelligence/model.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,oCAAoC;AACpC,+DAA+D;AAc/D,SAAS,SAAS,CAAC,GAAG,UAAqC;IACzD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,SAAS,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAe,EAAE,GAA2B;IAC5E,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACzF,OAAO,CACL,SAAS,CACP,aAAa,EACb,GAAG,CAAC,mBAAmB,EACvB,GAAG,CAAC,gBAAgB,EACpB,GAAG,CAAC,kBAAkB,EACtB,GAAG,CAAC,kBAAkB,EACtB,GAAG,CAAC,gBAAgB,CACrB,IAAI,SAAS,CACf,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAe,EAAE,QAAgB,EAAE,GAA2B;IACpG,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACzF,IAAI,aAAa,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;QAChD,OAAO,GAAG,QAAQ,mBAAmB,CAAC;IACxC,CAAC;IACD,IAAI,GAAG,CAAC,mBAAmB,IAAI,QAAQ,KAAK,GAAG,CAAC,mBAAmB,EAAE,CAAC;QACpE,OAAO,GAAG,QAAQ,+BAA+B,CAAC;IACpD,CAAC;IACD,IAAI,GAAG,CAAC,gBAAgB,IAAI,QAAQ,KAAK,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAC9D,OAAO,GAAG,QAAQ,gCAAgC,CAAC;IACrD,CAAC;IACD,IAAI,GAAG,CAAC,kBAAkB,IAAI,QAAQ,KAAK,GAAG,CAAC,kBAAkB,EAAE,CAAC;QAClE,OAAO,GAAG,QAAQ,kCAAkC,CAAC;IACvD,CAAC;IACD,IAAI,QAAQ,KAAK,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACxC,OAAO,GAAG,QAAQ,gBAAgB,CAAC;IACrC,CAAC;IACD,IAAI,GAAG,CAAC,gBAAgB,IAAI,QAAQ,KAAK,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAC9D,OAAO,GAAG,QAAQ,iBAAiB,CAAC;IACtC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,kBAA0B,EAC1B,OAIC;IAED,OAAO;QACL,gBAAgB,EAAE,OAAO,EAAE,gBAAgB;QAC3C,kBAAkB,EAAE,OAAO,EAAE,kBAAkB;QAC/C,kBAAkB;QAClB,gBAAgB,EAAE,OAAO,EAAE,gBAAgB;KAC5C,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gCAAgC,CAC9C,kBAA0B,EAC1B,OAKC;IAED,OAAO;QACL,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,mBAAmB,EAAE,OAAO,CAAC,OAAO,EAAE,YAAY;QAClD,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,kBAAkB;QAClB,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;KAC3C,CAAC;AACJ,CAAC"}

package/dist/intelligence/swarm.d.ts

@@ -1,4 +1,4 @@
-import type { AgentOutput, DAOAgent, HostAdapter, Proposal } from "../types/index.js";
+import type { AgentOutput, DAOAgent, DAOConfig, HostAdapter, Proposal } from "../types/index.js";
 import { type ModelResolutionContext } from "./model.js";
 export interface SwarmProgressUpdate {
     agentId: string;
@@ -28,6 +28,17 @@ export declare function createDispatchModelContext(configDefaultModel: string, a
 /**
  * Dispatch swarm via a host adapter.
  * This is the host-agnostic version — adapters implement the actual spawning.
+ *
+ * Delegation (DFI) is opt-in: pass `delegation?.config` with
+ * `config.delegation.enabled === true` to activate. When active, after each
+ * parent agent produces an output, declared facets are investigated by child
+ * agents and folded into the parent's reasoning (INV-6: votes untouched). Live
+ * coordinators are registered for the `delegation-closed` gate (INV-8) and
+ * drained on completion.
  */
-export declare function dispatchSwarm(proposal: Proposal, agents: DAOAgent[], adapter: HostAdapter, maxConcurrent: number, modelContext: ModelResolutionContext, onUpdate?: (update: SwarmProgressUpdate) => void): Promise<AgentOutput[]>;
+export declare function dispatchSwarm(proposal: Proposal, agents: DAOAgent[], adapter: HostAdapter, maxConcurrent: number, modelContext: ModelResolutionContext, onUpdate?: (update: SwarmProgressUpdate) => void, delegation?: {
+    config: DAOConfig;
+}): Promise<AgentOutput[]>;
+/** Clear the coordinator registry for a proposal once deliberation is over. */
+export declare function resetDelegationRegistry(proposalId: number): void;
 //# sourceMappingURL=swarm.d.ts.map

package/dist/intelligence/swarm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"swarm.d.ts","sourceRoot":"","sources":["../../src/intelligence/swarm.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,EAGL,KAAK,sBAAsB,EAE5B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;IACrD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,QAAQ,EAAE,EAClB,YAAY,EAAE,sBAAsB,GACnC,mBAAmB,EAAE,CA8BvB;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,mBAAmB,EAAE,GAAG,MAAM,CAuBlG;AAED,wBAAgB,0BAA0B,CACxC,kBAAkB,EAAE,MAAM,EAC1B,OAAO,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,GACnE,sBAAsB,CAKxB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,QAAQ,EAAE,EAClB,OAAO,EAAE,WAAW,EACpB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,sBAAsB,EACpC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,GAC/C,OAAO,CAAC,WAAW,EAAE,CAAC,CAgExB"}
+{"version":3,"file":"swarm.d.ts","sourceRoot":"","sources":["../../src/intelligence/swarm.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEjG,OAAO,EAGL,KAAK,sBAAsB,EAE5B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;IACrD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,QAAQ,EAAE,EAClB,YAAY,EAAE,sBAAsB,GACnC,mBAAmB,EAAE,CA8BvB;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,mBAAmB,EAAE,GAAG,MAAM,CAuBlG;AAED,wBAAgB,0BAA0B,CACxC,kBAAkB,EAAE,MAAM,EAC1B,OAAO,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,GACnE,sBAAsB,CAKxB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,QAAQ,EAAE,EAClB,OAAO,EAAE,WAAW,EACpB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,sBAAsB,EACpC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,EAChD,UAAU,CAAC,EAAE;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACjC,OAAO,CAAC,WAAW,EAAE,CAAC,CAkGxB;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAEhE"}

package/dist/intelligence/swarm.js

@@ -1,6 +1,8 @@
 // ============================================================
 // Swarm DAO Core — Swarm Dispatch
 // ============================================================
+import { clearProposalCoordinators, registerProposalCoordinators } from "../governance/delegation.utils.js";
+import { drainDelegations, runDelegations } from "./delegation.js";
 import { buildModelResolutionContext, describeModelResolution, resolveAgentModel, } from "./model.js";
 /**
  * Build dispatch instructions for each agent.
@@ -65,61 +67,106 @@ export function createDispatchModelContext(configDefaultModel, adapter, options)
 /**
  * Dispatch swarm via a host adapter.
  * This is the host-agnostic version — adapters implement the actual spawning.
+ *
+ * Delegation (DFI) is opt-in: pass `delegation?.config` with
+ * `config.delegation.enabled === true` to activate. When active, after each
+ * parent agent produces an output, declared facets are investigated by child
+ * agents and folded into the parent's reasoning (INV-6: votes untouched). Live
+ * coordinators are registered for the `delegation-closed` gate (INV-8) and
+ * drained on completion.
  */
-export async function dispatchSwarm(proposal, agents, adapter, maxConcurrent, modelContext, onUpdate) {
+export async function dispatchSwarm(proposal, agents, adapter, maxConcurrent, modelContext, onUpdate, delegation) {
     const instructions = buildDispatchInstructions(proposal, agents, modelContext);
     const outputs = [];
-    // Process in batches based on maxConcurrent
-    for (let i = 0; i < instructions.length; i += maxConcurrent) {
-        const batch = instructions.slice(i, i + maxConcurrent);
-        const batchPromises = batch.map(async (inst) => {
-            const agent = agents.find((a) => a.id === inst.agentId);
-            if (!agent)
-                throw new Error(`Agent ${inst.agentId} not found`);
-            onUpdate?.({
-                agentId: inst.agentId,
-                agentName: inst.agentName,
-                phase: "started",
+    const agentById = new Map(agents.map((a) => [a.id, a]));
+    const delegationEnabled = delegation?.config?.delegation?.enabled === true;
+    const allCoordinators = [];
+    const allRequests = [];
+    // Register the mutable coordinators array up-front so the delegation-closed
+    // gate can observe in-flight coordinators as they are pushed during dispatch.
+    if (delegationEnabled) {
+        registerProposalCoordinators(proposal.id, allCoordinators);
+    }
+    try {
+        // Process in batches based on maxConcurrent
+        for (let i = 0; i < instructions.length; i += maxConcurrent) {
+            const batch = instructions.slice(i, i + maxConcurrent);
+            const batchPromises = batch.map(async (inst) => {
+                const agent = agentById.get(inst.agentId);
+                try {
+                    if (!agent)
+                        throw new Error(`Agent ${inst.agentId} not found`);
+                    onUpdate?.({
+                        agentId: inst.agentId,
+                        agentName: inst.agentName,
+                        phase: "started",
+                    });
+                    const output = await adapter.spawnAgent({
+                        agent,
+                        proposal,
+                        systemPrompt: inst.prompt,
+                        model: inst.model,
+                        timeoutMs: inst.timeoutMs,
+                    });
+                    // DFI hook: fold declared delegations into the parent reasoning.
+                    if (delegationEnabled && delegation && !output.error) {
+                        const result = await runDelegations({
+                            parent: agent,
+                            parentOutput: output,
+                            proposal,
+                            adapter,
+                            config: delegation.config,
+                            parentModelContext: modelContext,
+                            onCoordinatorCreated: (coordinator) => {
+                                allCoordinators.push(coordinator);
+                            },
+                        });
+                        allRequests.push(...result.requests);
+                        if (result.delegated)
+                            output.content = result.foldedContent;
+                    }
+                    outputs.push(output);
+                    onUpdate?.({
+                        agentId: inst.agentId,
+                        agentName: inst.agentName,
+                        phase: output.error ? "error" : "completed",
+                        output,
+                    });
+                    return output;
+                }
+                catch (err) {
+                    const message = err instanceof Error ? err.message : "Unknown error";
+                    const errorOutput = {
+                        agentId: inst.agentId,
+                        agentName: inst.agentName,
+                        role: agent?.role ?? "unknown",
+                        content: "",
+                        durationMs: 0,
+                        error: message,
+                    };
+                    outputs.push(errorOutput);
+                    onUpdate?.({
+                        agentId: inst.agentId,
+                        agentName: inst.agentName,
+                        phase: "error",
+                        output: errorOutput,
+                    });
+                    return errorOutput;
+                }
             });
-            try {
-                const output = await adapter.spawnAgent({
-                    agent,
-                    proposal,
-                    systemPrompt: inst.prompt,
-                    model: inst.model,
-                    timeoutMs: inst.timeoutMs,
-                });
-                outputs.push(output);
-                onUpdate?.({
-                    agentId: inst.agentId,
-                    agentName: inst.agentName,
-                    phase: output.error ? "error" : "completed",
-                    output,
-                });
-                return output;
-            }
-            catch (err) {
-                const message = err instanceof Error ? err.message : "Unknown error";
-                const errorOutput = {
-                    agentId: inst.agentId,
-                    agentName: inst.agentName,
-                    role: agent.role,
-                    content: "",
-                    durationMs: 0,
-                    error: message,
-                };
-                outputs.push(errorOutput);
-                onUpdate?.({
-                    agentId: inst.agentId,
-                    agentName: inst.agentName,
-                    phase: "error",
-                    output: errorOutput,
-                });
-                return errorOutput;
-            }
-        });
-        await Promise.all(batchPromises);
+            await Promise.all(batchPromises);
+        }
+    }
+    finally {
+        if (delegationEnabled) {
+            drainDelegations(allCoordinators, allRequests);
+            clearProposalCoordinators(proposal.id);
+        }
     }
     return outputs;
 }
+/** Clear the coordinator registry for a proposal once deliberation is over. */
+export function resetDelegationRegistry(proposalId) {
+    clearProposalCoordinators(proposalId);
+}
 //# sourceMappingURL=swarm.js.map

package/dist/intelligence/swarm.js.map

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

package/dist/persistence.d.ts

@@ -1,9 +1,8 @@
-import type { AgentOutput, AuditEntry, CompositeScore, ControlCheckResult, DAOAgent, DAOArtefacts, DAOState, DeliveryPlan, ExecutionSnapshot, ExecutionVerification, Proposal, ProposalOutcome, ProposalStatus, StorageSettings, Vote } from "./types/index.js";
+import type { AgentOutput, AuditEntry, CompositeScore, ControlCheckResult, DAOAgent, DAOArtefacts, DAOState, DeliveryPlan, ExecutionSnapshot, ExecutionVerification, Proposal, ProposalOutcome, StorageSettings, Vote } from "./types/index.js";
+export declare function sanitizeErrorMessage(message: string): string;
 export declare function getDaoRoot(cwd: string): string;
-export declare function getProposalsDir(daoRoot: string): string;
 export declare function getDecisionsDir(daoRoot: string): string;
 export declare function padId(id: number): string;
-export declare function getProposalPath(daoRoot: string, id: number): string;
 export declare function initStorage(cwd: string): Promise<string>;
 export declare function migrateFromLegacy(cwd: string, legacyDirectories?: string[]): Promise<boolean>;
 export declare function getState(): DAOState;
@@ -12,8 +11,6 @@ export declare function getOrCreateState(cwd: string): DAOState;
 export declare function loadState(cwd: string, options?: {
     legacyDirectories?: string[];
 }): Promise<DAOState | null>;
-export declare function loadProposalsFromDisk(daoRoot: string): Promise<Proposal[]>;
-export declare function saveProposal(proposalId: number): Promise<string | null>;
 export declare function saveState(): Promise<void>;
 export declare function saveDecisions(): Promise<void>;
 export declare function getStorageSettings(daoRoot: string): Promise<StorageSettings>;
@@ -32,7 +29,6 @@ export declare function createProposalsBatch(entries: Array<{
 }>): Promise<Proposal[]>;
 export declare function getProposal(proposalId: number): Proposal | undefined;
 export declare function listProposals(): Proposal[];
-export declare function updateProposalStatus(proposalId: number, status: ProposalStatus): Promise<boolean>;
 export declare function addVote(proposalId: number, vote: Vote): Promise<boolean>;
 export declare function storeAgentOutput(proposalId: number, output: AgentOutput): Promise<boolean>;
 export declare function storeDeliberationBatch(proposalId: number, votes: Vote[], outputs: AgentOutput[]): Promise<boolean>;

package/dist/persistence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../src/persistence.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,QAAQ,EACR,YAAY,EACZ,QAAQ,EAER,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EACrB,QAAQ,EACR,eAAe,EACf,cAAc,EACd,eAAe,EACf,IAAI,EACL,MAAM,kBAAkB,CAAC;AA8F1B,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAExC;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAEnE;AAmBD,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI9D;AA2DD,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,iBAAiB,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAyCvG;AAID,wBAAgB,QAAQ,IAAI,QAAQ,CAKnC;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAExD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAKtD;AAID,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAuDjH;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAuBhF;AAED,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAS7E;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAqC/C;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAwBnD;AAID,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAWlF;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAChC,OAAO,CAAC,eAAe,CAAC,CAoB1B;AAID,wBAAsB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7D;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAE9D;AAED,wBAAgB,UAAU,IAAI,QAAQ,EAAE,CAEvC;AAID,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,QAAQ,CAAC,CAiBnB;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC,GACD,OAAO,CAAC,QAAQ,EAAE,CAAC,CAqBrB;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAEpE;AAED,wBAAgB,aAAa,IAAI,QAAQ,EAAE,CAE1C;AAED,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAavG;AAED,wBAAsB,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ9E;AAED,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAOhG;AAED,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE,WAAW,EAAE,GACrB,OAAO,CAAC,OAAO,CAAC,CAWlB;AAED,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO5F;AAED,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAOjH;AAED,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAItG;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEnF;AAED,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7F;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE5E;AAID,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,EAC1B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,EAAE,CAE5D;AAED,wBAAgB,cAAc,IAAI,UAAU,EAAE,CAE7C;AAID,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE1E;AAED,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAgB9E;AAED,wBAAsB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAOxG;AAED,wBAAsB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxG;AAED,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKpE;AAID,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAIpG;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAE7E;AAID,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAI9G;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAErF;AAID,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/F;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEzE;AAGD,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../src/persistence.ts"],"names":[],"mappings":"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"}