@guyghost/swarm-dao-core 0.2.0 → 0.4.0

package/dist/host-tools/messages.js

@@ -0,0 +1,34 @@
+import { buildDaoCommandHelp } from "../commands/registry.js";
+export const DAO_ONBOARDING_MESSAGE = [
+    "# DAO not initialized",
+    "",
+    "1. Run `dao_setup` to create the default governance agents.",
+    "2. Run `dao_help` to see the full workflow and available commands.",
+    '3. Start your first proposal with `dao_propose title="..." type="product-feature" description="..."`.',
+].join("\n");
+export function buildDaoHelpMessage(options = {}) {
+    const manualDeliberation = options.manualDeliberation ?? true;
+    const controlTool = options.controlTool ?? "dao_control";
+    const deliberationSteps = manualDeliberation
+        ? [
+            "3. `dao_deliberate proposalId=1`",
+            "4. Spawn sub-agents via your host's task/agent tool using the dispatch plan",
+            "5. `dao_record_outputs proposalId=1 outputs='[...]'`",
+            `6. \`${controlTool} proposalId=1\``,
+            "7. `dao_execute proposalId=1`",
+        ]
+        : ["3. `dao_deliberate proposalId=1`", `4. \`${controlTool} proposalId=1\``, "5. `dao_execute proposalId=1`"];
+    const flow = [
+        "# DAO Help",
+        "",
+        "Recommended flow:",
+        "1. `dao_setup`",
+        '2. `dao_propose title="..." type="product-feature" description="..."`',
+        ...deliberationSteps,
+    ];
+    if (options.hideCatalogue)
+        return flow.join("\n");
+    const catalogue = buildDaoCommandHelp({ host: options.host, title: "Full command reference" });
+    return `${flow.join("\n")}\n\n${catalogue}`;
+}
+//# sourceMappingURL=messages.js.map

package/dist/host-tools/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/host-tools/messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAuB,MAAM,yBAAyB,CAAC;AAEnF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,uBAAuB;IACvB,EAAE;IACF,6DAA6D;IAC7D,oEAAoE;IACpE,uGAAuG;CACxG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAWb,MAAM,UAAU,mBAAmB,CAAC,UAAsC,EAAE;IAC1E,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,IAAI,IAAI,CAAC;IAC9D,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,aAAa,CAAC;IAEzD,MAAM,iBAAiB,GAAG,kBAAkB;QAC1C,CAAC,CAAC;YACE,kCAAkC;YAClC,6EAA6E;YAC7E,sDAAsD;YACtD,QAAQ,WAAW,iBAAiB;YACpC,+BAA+B;SAChC;QACH,CAAC,CAAC,CAAC,kCAAkC,EAAE,QAAQ,WAAW,iBAAiB,EAAE,+BAA+B,CAAC,CAAC;IAEhH,MAAM,IAAI,GAAG;QACX,YAAY;QACZ,EAAE;QACF,mBAAmB;QACnB,gBAAgB;QAChB,uEAAuE;QACvE,GAAG,iBAAiB;KACrB,CAAC;IAEF,IAAI,OAAO,CAAC,aAAa;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAElD,MAAM,SAAS,GAAG,mBAAmB,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,wBAAwB,EAAE,CAAC,CAAC;IAC/F,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,SAAS,EAAE,CAAC;AAC9C,CAAC"}

package/dist/host-tools/utils.d.ts

@@ -0,0 +1,3 @@
+export declare function assertSafeJsonValue(value: unknown, context: string): void;
+export declare function parseSafeJson<T>(input: string, context: string): T;
+//# sourceMappingURL=utils.d.ts.map

package/dist/host-tools/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/host-tools/utils.ts"],"names":[],"mappings":"AAEA,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAczE;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,CASlE"}

package/dist/host-tools/utils.js

@@ -0,0 +1,29 @@
+const FORBIDDEN_JSON_KEYS = new Set(["__proto__", "prototype", "constructor"]);
+export function assertSafeJsonValue(value, context) {
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            assertSafeJsonValue(item, context);
+        }
+        return;
+    }
+    if (typeof value !== "object" || value === null)
+        return;
+    for (const [key, nested] of Object.entries(value)) {
+        if (FORBIDDEN_JSON_KEYS.has(key)) {
+            throw new Error(`Unsafe key "${key}" in ${context}`);
+        }
+        assertSafeJsonValue(nested, context);
+    }
+}
+export function parseSafeJson(input, context) {
+    let parsed;
+    try {
+        parsed = JSON.parse(input);
+    }
+    catch (error) {
+        throw new Error(`Invalid JSON in ${context}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    assertSafeJsonValue(parsed, context);
+    return parsed;
+}
+//# sourceMappingURL=utils.js.map

package/dist/host-tools/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/host-tools/utils.ts"],"names":[],"mappings":"AAAA,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC;AAE/E,MAAM,UAAU,mBAAmB,CAAC,KAAc,EAAE,OAAe;IACjE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACrC,CAAC;QACD,OAAO;IACT,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO;IACxD,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClD,IAAI,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,eAAe,GAAG,QAAQ,OAAO,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAI,KAAa,EAAE,OAAe;IAC7D,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,mBAAmB,OAAO,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC3G,CAAC;IACD,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,MAAW,CAAC;AACrB,CAAC"}

package/dist/index.d.ts

@@ -1,9 +1,11 @@
 export * from "./agents/index.js";
+export * from "./commands/index.js";
 export * from "./config.js";
 export * from "./control/index.js";
 export * from "./delivery/index.js";
 export * from "./governance/index.js";
 export * from "./health-score.js";
+export * from "./host-tools/index.js";
 export * from "./integrations/index.js";
 export * from "./intelligence/index.js";
 export * from "./intelligence/roundtable.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,mBAAmB,CAAC;AAElC,cAAc,aAAa,CAAC;AAE5B,cAAc,oBAAoB,CAAC;AAEnC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,uBAAuB,CAAC;AAEtC,cAAc,mBAAmB,CAAC;AAElC,cAAc,yBAAyB,CAAC;AAExC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAE7C,cAAc,0BAA0B,CAAC;AAEzC,cAAc,kBAAkB,CAAC;AAEjC,cAAc,kBAAkB,CAAC;AAEjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,mBAAmB,CAAC;AAElC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,aAAa,CAAC;AAE5B,cAAc,oBAAoB,CAAC;AAEnC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,uBAAuB,CAAC;AAEtC,cAAc,mBAAmB,CAAC;AAElC,cAAc,uBAAuB,CAAC;AAEtC,cAAc,yBAAyB,CAAC;AAExC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAE7C,cAAc,0BAA0B,CAAC;AAEzC,cAAc,kBAAkB,CAAC;AAEjC,cAAc,kBAAkB,CAAC;AAEjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -3,6 +3,8 @@
 // ============================================================
 // Agents
 export * from "./agents/index.js";
+// Commands registry (`/dao` surface — source of truth for every adapter)
+export * from "./commands/index.js";
 // Configuration
 export * from "./config.js";
 // Control (L4)
@@ -13,6 +15,8 @@ export * from "./delivery/index.js";
 export * from "./governance/index.js";
 // Health Score
 export * from "./health-score.js";
+// Host tool handlers (shared across adapters)
+export * from "./host-tools/index.js";
 // Integrations
 export * from "./integrations/index.js";
 // Intelligence (L2)

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,8BAA8B;AAC9B,+DAA+D;AAE/D,SAAS;AACT,cAAc,mBAAmB,CAAC;AAClC,gBAAgB;AAChB,cAAc,aAAa,CAAC;AAC5B,eAAe;AACf,cAAc,oBAAoB,CAAC;AACnC,gBAAgB;AAChB,cAAc,qBAAqB,CAAC;AACpC,kBAAkB;AAClB,cAAc,uBAAuB,CAAC;AACtC,eAAe;AACf,cAAc,mBAAmB,CAAC;AAClC,eAAe;AACf,cAAc,yBAAyB,CAAC;AACxC,oBAAoB;AACpB,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,gBAAgB;AAChB,cAAc,0BAA0B,CAAC;AACzC,cAAc;AACd,cAAc,kBAAkB,CAAC;AACjC,QAAQ;AACR,cAAc,kBAAkB,CAAC;AACjC,QAAQ;AACR,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,8BAA8B;AAC9B,+DAA+D;AAE/D,SAAS;AACT,cAAc,mBAAmB,CAAC;AAClC,yEAAyE;AACzE,cAAc,qBAAqB,CAAC;AACpC,gBAAgB;AAChB,cAAc,aAAa,CAAC;AAC5B,eAAe;AACf,cAAc,oBAAoB,CAAC;AACnC,gBAAgB;AAChB,cAAc,qBAAqB,CAAC;AACpC,kBAAkB;AAClB,cAAc,uBAAuB,CAAC;AACtC,eAAe;AACf,cAAc,mBAAmB,CAAC;AAClC,8CAA8C;AAC9C,cAAc,uBAAuB,CAAC;AACtC,eAAe;AACf,cAAc,yBAAyB,CAAC;AACxC,oBAAoB;AACpB,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,gBAAgB;AAChB,cAAc,0BAA0B,CAAC;AACzC,cAAc;AACd,cAAc,kBAAkB,CAAC;AACjC,QAAQ;AACR,cAAc,kBAAkB,CAAC;AACjC,QAAQ;AACR,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}

package/dist/integrations/http.d.ts

@@ -4,13 +4,24 @@ interface JsonRequestOptions {
     body?: string;
     timeoutMs?: number;
     allowStatuses?: number[];
+    maxAttempts?: number;
+    _fetch?: FetchImplementation;
 }
 export declare class HttpRequestError extends Error {
     readonly status: number;
     readonly url: string;
     constructor(message: string, status: number, url: string);
 }
-export declare function requestJson<T>(url: string, { timeoutMs, allowStatuses, ...options }?: JsonRequestOptions): Promise<{
+interface HttpResponseLike {
+    ok: boolean;
+    status: number;
+    text(): Promise<string>;
+    headers: {
+        get(name: string): string | null;
+    };
+}
+type FetchImplementation = (url: string, init?: RequestInit) => Promise<HttpResponseLike>;
+export declare function requestJson<T>(url: string, { timeoutMs, allowStatuses, maxAttempts, _fetch, ...options }?: JsonRequestOptions): Promise<{
     status: number;
     data: T | null;
 }>;

package/dist/integrations/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/integrations/http.ts"],"names":[],"mappings":"AAAA,UAAU,kBAAkB;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,qBAAa,gBAAiB,SAAQ,KAAK;aAGvB,MAAM,EAAE,MAAM;aACd,GAAG,EAAE,MAAM;gBAF3B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM;CAK9B;AAMD,wBAAsB,WAAW,CAAC,CAAC,EACjC,GAAG,EAAE,MAAM,EACX,EAAE,SAAkB,EAAE,aAAkB,EAAE,GAAG,OAAO,EAAE,GAAE,kBAAuB,GAC9E,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;CAAE,CAAC,CAkC7C"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/integrations/http.ts"],"names":[],"mappings":"AAAA,UAAU,kBAAkB;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IAKrB,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED,qBAAa,gBAAiB,SAAQ,KAAK;aAGvB,MAAM,EAAE,MAAM;aACd,GAAG,EAAE,MAAM;gBAF3B,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM;CAK9B;AA4DD,UAAU,gBAAgB;IACxB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,OAAO,EAAE;QAAE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CAC/C;AAED,KAAK,mBAAmB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAoE1F,wBAAsB,WAAW,CAAC,CAAC,EACjC,GAAG,EAAE,MAAM,EACX,EAAE,SAAkB,EAAE,aAAkB,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,GAAE,kBAAuB,GACnG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;CAAE,CAAC,CA8C7C"}

package/dist/integrations/http.js

@@ -11,11 +11,58 @@ export class HttpRequestError extends Error {
 function truncate(text, maxLength) {
     return text.length > maxLength ? `${text.slice(0, maxLength)}...` : text;
 }
-export async function requestJson(url, { timeoutMs = 15_000, allowStatuses = [], ...options } = {}) {
+// HTTP keep-alive (connection reuse) is handled automatically by the Bun fetch
+// runtime, which pools and reuses TCP connections by default. There is no
+// standard, dependency-free fetch option to toggle this in Bun (the `dispatcher`
+// option is undici/Node-specific and unavailable here), so we rely on the runtime
+// and focus this change on idempotency-aware retry with backoff.
+// Backoff tuning. `Retry-After` is honoured but capped so retries stay fast.
+const MAX_RETRY_AFTER_MS = 5_000;
+const BACKOFF_BASE_MS = 200;
+const BACKOFF_CAP_MS = 1_000;
+const SNIPPET_MAX_LENGTH = 300;
+function isRetryableStatus(status) {
+    return status === 429 || (status >= 500 && status <= 599);
+}
+function isIdempotentMethod(method) {
+    return method === "GET" || method === "HEAD" || method === "OPTIONS" || method === "PUT" || method === "DELETE";
+}
+function parseRetryAfter(value) {
+    if (!value)
+        return null;
+    const trimmed = value.trim();
+    // Delta-seconds (non-negative integer).
+    if (/^\d+$/.test(trimmed)) {
+        const seconds = Number.parseInt(trimmed, 10);
+        return Math.min(seconds * 1000, MAX_RETRY_AFTER_MS);
+    }
+    // HTTP-date.
+    const dateMs = Date.parse(trimmed);
+    if (!Number.isNaN(dateMs)) {
+        return Math.min(Math.max(0, dateMs - Date.now()), MAX_RETRY_AFTER_MS);
+    }
+    return null;
+}
+// Exponential backoff with full jitter. `attempt` is 1-based.
+function exponentialBackoff(attempt) {
+    const capped = Math.min(BACKOFF_BASE_MS * 2 ** (attempt - 1), BACKOFF_CAP_MS);
+    return Math.floor(Math.random() * capped);
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function snippetFrom(text) {
+    const trimmed = text.trim();
+    return trimmed ? ` - ${truncate(trimmed, SNIPPET_MAX_LENGTH)}` : "";
+}
+// Runs a single fetch attempt. `timeoutMs` is the PER-ATTEMPT timeout: each
+// attempt owns its own AbortController, so a single attempt's observable
+// behaviour matches the pre-retry implementation exactly.
+async function performAttempt(url, options, allowStatuses, timeoutMs, fetchImpl) {
     const controller = new AbortController();
     const timeout = setTimeout(() => controller.abort(), timeoutMs);
     try {
-        const response = await fetch(url, {
+        const response = await fetchImpl(url, {
             method: options.method,
             headers: options.headers,
             body: options.body,
@@ -23,30 +70,80 @@ export async function requestJson(url, { timeoutMs = 15_000, allowStatuses = [],
         });
         const text = typeof response.text === "function" ? await response.text() : "";
         const isAllowedFailure = allowStatuses.includes(response.status);
-        if (!response.ok && !isAllowedFailure) {
-            const snippet = text.trim() ? ` - ${truncate(text.trim(), 300)}` : "";
-            throw new HttpRequestError(`HTTP ${response.status} for ${url}${snippet}`, response.status, url);
-        }
-        if (!text.trim()) {
-            return { status: response.status, data: null };
-        }
-        let data;
-        try {
-            data = JSON.parse(text);
+        if (response.ok || isAllowedFailure) {
+            if (!text.trim()) {
+                return { kind: "success", status: response.status, data: null };
+            }
+            let data;
+            try {
+                data = JSON.parse(text);
+            }
+            catch (error) {
+                return {
+                    kind: "json-error",
+                    error: new Error(`Invalid JSON response from ${url}: ${error instanceof Error ? error.message : String(error)}`),
+                };
+            }
+            return { kind: "success", status: response.status, data };
         }
-        catch (error) {
-            throw new Error(`Invalid JSON response from ${url}: ${error instanceof Error ? error.message : String(error)}`);
+        if (isRetryableStatus(response.status)) {
+            let retryAfterMs = null;
+            try {
+                retryAfterMs = parseRetryAfter(response.headers.get("retry-after"));
+            }
+            catch {
+                retryAfterMs = null;
+            }
+            return { kind: "retryable-status", status: response.status, text, retryAfterMs };
         }
-        return { status: response.status, data: data };
+        return { kind: "non-retryable-status", status: response.status, text };
     }
     catch (error) {
         if (error instanceof Error && error.name === "AbortError") {
-            throw new Error(`Request timed out after ${timeoutMs}ms for ${url}`);
+            return { kind: "abort" };
         }
-        throw error;
+        return { kind: "network-error", error };
     }
     finally {
         clearTimeout(timeout);
     }
 }
+export async function requestJson(url, { timeoutMs = 15_000, allowStatuses = [], maxAttempts, _fetch, ...options } = {}) {
+    const fetchImpl = _fetch ?? globalThis.fetch;
+    const method = options.method?.toUpperCase() ?? "GET";
+    const defaultAttempts = isIdempotentMethod(method) ? 3 : 1;
+    const attempts = Math.max(1, Math.trunc(maxAttempts ?? defaultAttempts));
+    for (let attempt = 1; attempt <= attempts; attempt++) {
+        const isLastAttempt = attempt === attempts;
+        const outcome = await performAttempt(url, options, allowStatuses, timeoutMs, fetchImpl);
+        switch (outcome.kind) {
+            case "success":
+                return { status: outcome.status, data: outcome.data };
+            case "json-error":
+                throw outcome.error;
+            case "non-retryable-status":
+                throw new HttpRequestError(`HTTP ${outcome.status} for ${url}${snippetFrom(outcome.text)}`, outcome.status, url);
+            case "retryable-status":
+                if (isLastAttempt) {
+                    throw new HttpRequestError(`HTTP ${outcome.status} for ${url}${snippetFrom(outcome.text)}`, outcome.status, url);
+                }
+                await sleep(outcome.retryAfterMs ?? exponentialBackoff(attempt));
+                break;
+            case "abort":
+                if (isLastAttempt) {
+                    throw new Error(`Request timed out after ${timeoutMs}ms for ${url}`);
+                }
+                await sleep(exponentialBackoff(attempt));
+                break;
+            case "network-error":
+                if (isLastAttempt) {
+                    throw outcome.error;
+                }
+                await sleep(exponentialBackoff(attempt));
+                break;
+        }
+    }
+    // Unreachable: the loop always returns or throws on the final attempt.
+    throw new Error(`requestJson: exhausted all attempts for ${url}`);
+}
 //# sourceMappingURL=http.js.map

package/dist/integrations/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/integrations/http.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/integrations/http.ts"],"names":[],"mappings":"AAcA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAGvB;IACA;IAHlB,YACE,OAAe,EACC,MAAc,EACd,GAAW;QAE3B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,WAAM,GAAN,MAAM,CAAQ;QACd,QAAG,GAAH,GAAG,CAAQ;QAG3B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,SAAiB;IAC/C,OAAO,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3E,CAAC;AAED,+EAA+E;AAC/E,0EAA0E;AAC1E,iFAAiF;AACjF,kFAAkF;AAClF,iEAAiE;AAEjE,6EAA6E;AAC7E,MAAM,kBAAkB,GAAG,KAAK,CAAC;AACjC,MAAM,eAAe,GAAG,GAAG,CAAC;AAC5B,MAAM,cAAc,GAAG,KAAK,CAAC;AAC7B,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B,SAAS,iBAAiB,CAAC,MAAc;IACvC,OAAO,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,IAAI,GAAG,IAAI,MAAM,IAAI,GAAG,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAc;IACxC,OAAO,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,QAAQ,CAAC;AAClH,CAAC;AAED,SAAS,eAAe,CAAC,KAAoB;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,wCAAwC;IACxC,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,EAAE,kBAAkB,CAAC,CAAC;IACtD,CAAC;IACD,aAAa;IACb,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,kBAAkB,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8DAA8D;AAC9D,SAAS,kBAAkB,CAAC,OAAe;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IAC9E,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,OAAO,OAAO,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACtE,CAAC;AAsBD,4EAA4E;AAC5E,yEAAyE;AACzE,0DAA0D;AAC1D,KAAK,UAAU,cAAc,CAC3B,GAAW,EACX,OAA6E,EAC7E,aAAuB,EACvB,SAAiB,EACjB,SAA8B;IAE9B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAChE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE;YACpC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,QAAQ,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,MAAM,gBAAgB,GAAG,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACjE,IAAI,QAAQ,CAAC,EAAE,IAAI,gBAAgB,EAAE,CAAC;YACpC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;gBACjB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAClE,CAAC;YACD,IAAI,IAAa,CAAC;YAClB,IAAI,CAAC;gBACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO;oBACL,IAAI,EAAE,YAAY;oBAClB,KAAK,EAAE,IAAI,KAAK,CACd,8BAA8B,GAAG,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC/F;iBACF,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;QAC5D,CAAC;QACD,IAAI,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACvC,IAAI,YAAY,GAAkB,IAAI,CAAC;YACvC,IAAI,CAAC;gBACH,YAAY,GAAG,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;YACtE,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY,GAAG,IAAI,CAAC;YACtB,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;QACnF,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,sBAAsB,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IACzE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC1D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC3B,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;IAC1C,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAW,EACX,EAAE,SAAS,GAAG,MAAM,EAAE,aAAa,GAAG,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,KAAyB,EAAE;IAEpG,MAAM,SAAS,GAAwB,MAAM,IAAI,UAAU,CAAC,KAAK,CAAC;IAClE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,KAAK,CAAC;IACtD,MAAM,eAAe,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,eAAe,CAAC,CAAC,CAAC;IACzE,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC;QACrD,MAAM,aAAa,GAAG,OAAO,KAAK,QAAQ,CAAC;QAC3C,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAExF,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,SAAS;gBACZ,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAgB,EAAE,CAAC;YACpE,KAAK,YAAY;gBACf,MAAM,OAAO,CAAC,KAAK,CAAC;YACtB,KAAK,sBAAsB;gBACzB,MAAM,IAAI,gBAAgB,CACxB,QAAQ,OAAO,CAAC,MAAM,QAAQ,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAC/D,OAAO,CAAC,MAAM,EACd,GAAG,CACJ,CAAC;YACJ,KAAK,kBAAkB;gBACrB,IAAI,aAAa,EAAE,CAAC;oBAClB,MAAM,IAAI,gBAAgB,CACxB,QAAQ,OAAO,CAAC,MAAM,QAAQ,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAC/D,OAAO,CAAC,MAAM,EACd,GAAG,CACJ,CAAC;gBACJ,CAAC;gBACD,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;gBACjE,MAAM;YACR,KAAK,OAAO;gBACV,IAAI,aAAa,EAAE,CAAC;oBAClB,MAAM,IAAI,KAAK,CAAC,2BAA2B,SAAS,UAAU,GAAG,EAAE,CAAC,CAAC;gBACvE,CAAC;gBACD,MAAM,KAAK,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;gBACzC,MAAM;YACR,KAAK,eAAe;gBAClB,IAAI,aAAa,EAAE,CAAC;oBAClB,MAAM,OAAO,CAAC,KAAK,CAAC;gBACtB,CAAC;gBACD,MAAM,KAAK,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;gBACzC,MAAM;QACV,CAAC;IACH,CAAC;IACD,uEAAuE;IACvE,MAAM,IAAI,KAAK,CAAC,2CAA2C,GAAG,EAAE,CAAC,CAAC;AACpE,CAAC"}

package/dist/intelligence/delegation.d.ts

@@ -0,0 +1,40 @@
+import { type DelegationSignal } from "../governance/delegation.machine.js";
+import { type DelegationCoordinatorState, type DelegationRequestState } from "../governance/delegation.utils.js";
+import type { AgentOutput, DAOAgent, DAOConfig, HostAdapter, Proposal } from "../types/index.js";
+import { type ModelResolutionContext } from "./model.js";
+export interface DelegationResult {
+    /** Parent content with folded child reasoning appended (INV-6: votes untouched). */
+    foldedContent: string;
+    /** Every coordinator created for this parent (for the registry / cascade). */
+    coordinators: DelegationCoordinatorState[];
+    /** Every request created for this parent (for audit). */
+    requests: DelegationRequestState[];
+    /** True when at least one request reached `delegated`. */
+    delegated: boolean;
+}
+/**
+ * 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 declare function runDelegations(params: {
+    parent: DAOAgent;
+    parentOutput: AgentOutput;
+    proposal: Proposal;
+    adapter: HostAdapter;
+    config: DAOConfig;
+    parentModelContext: ModelResolutionContext;
+    onCoordinatorCreated?: (coordinator: DelegationCoordinatorState) => void;
+}): Promise<DelegationResult>;
+/**
+ * Append the child's investigation under a `## Delegated Facets` section.
+ * Pure. The parent's `## Vote` section is never touched (INV-6).
+ */
+export declare function foldChildIntoParent(parentContent: string, signal: DelegationSignal, childOutput: AgentOutput): string;
+/**
+ * Drain/cancel cascade (B3). Emit DRAIN to each coordinator, then CANCEL to
+ * every non-terminal request. Idempotent: terminal states ignore events.
+ */
+export declare function drainDelegations(coordinators: DelegationCoordinatorState[], requests: DelegationRequestState[]): void;
+//# sourceMappingURL=delegation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delegation.d.ts","sourceRoot":"","sources":["../../src/intelligence/delegation.ts"],"names":[],"mappings":"AAgBA,OAAO,EAGL,KAAK,gBAAgB,EAItB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAGL,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAK5B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACjG,OAAO,EAAoC,KAAK,sBAAsB,EAAqB,MAAM,YAAY,CAAC;AAE9G,MAAM,WAAW,gBAAgB;IAC/B,oFAAoF;IACpF,aAAa,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,YAAY,EAAE,0BAA0B,EAAE,CAAC;IAC3C,yDAAyD;IACzD,QAAQ,EAAE,sBAAsB,EAAE,CAAC;IACnC,0DAA0D;IAC1D,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAC3C,MAAM,EAAE,QAAQ,CAAC;IACjB,YAAY,EAAE,WAAW,CAAC;IAC1B,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,SAAS,CAAC;IAClB,kBAAkB,EAAE,sBAAsB,CAAC;IAC3C,oBAAoB,CAAC,EAAE,CAAC,WAAW,EAAE,0BAA0B,KAAK,IAAI,CAAC;CAC1E,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkH5B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,GAAG,MAAM,CASrH;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,0BAA0B,EAAE,EAAE,QAAQ,EAAE,sBAAsB,EAAE,GAAG,IAAI,CAgBrH"}

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;