opencode-autoresearch 3.1.0-beta.2

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAGA,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEhD;AAED,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEnD;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUtF;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvF;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMtE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAK5G;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAO3E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAOtE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAOjG;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CA0BpF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CASxD;AAED,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG,MAAM,EAAE,CAO3E;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAGpF"}

package/dist/helpers.js

@@ -0,0 +1,137 @@
+import { writeFileSync, mkdirSync, readFileSync, renameSync, unlinkSync, existsSync } from "fs";
+import { resolve, dirname } from "path";
+export class AutoresearchError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "AutoresearchError";
+    }
+}
+export function printJson(payload) {
+    console.log(JSON.stringify(payload, null, 2));
+}
+export function utcNow() {
+    return new Date().toISOString().replace("Z", "+00:00").split("+")[0] + "Z";
+}
+export function resolveRepo(repo) {
+    return repo ?? process.cwd();
+}
+export function ensureParent(filePath) {
+    mkdirSync(dirname(filePath), { recursive: true });
+}
+export async function atomicWriteText(filePath, content) {
+    ensureParent(filePath);
+    const tmp = filePath + ".tmp." + Date.now();
+    writeFileSync(tmp, content, "utf-8");
+    try {
+        renameSync(tmp, filePath);
+    }
+    catch {
+        try {
+            unlinkSync(tmp);
+        }
+        catch { /* ignore */ }
+        throw new AutoresearchError("Failed to write " + filePath);
+    }
+}
+export async function atomicWriteJson(filePath, payload) {
+    await atomicWriteText(filePath, JSON.stringify(payload, null, 2) + "\n");
+}
+export function readJsonFile(filePath) {
+    try {
+        return JSON.parse(readFileSync(filePath, "utf-8"));
+    }
+    catch {
+        throw new AutoresearchError("Missing file: " + filePath);
+    }
+}
+export function resolvePath(repo, value, defaultName) {
+    if (value) {
+        return value.startsWith("/") ? value : resolve(repo ?? ".", value);
+    }
+    return resolve(repo ?? ".", defaultName);
+}
+export function normalizeDirection(value) {
+    if (!value)
+        return "lower";
+    const normalized = value.trim().toLowerCase();
+    if (normalized !== "lower" && normalized !== "higher") {
+        throw new AutoresearchError("Unsupported direction: " + value);
+    }
+    return normalized;
+}
+export function normalizeMode(value) {
+    if (!value)
+        return "foreground";
+    const normalized = value.trim().toLowerCase();
+    if (normalized !== "foreground" && normalized !== "background") {
+        throw new AutoresearchError("Unsupported mode: " + value);
+    }
+    return normalized;
+}
+export function normalizeResultStatus(value, fieldName) {
+    if (!value)
+        throw new AutoresearchError("Missing " + fieldName);
+    const normalized = value.trim().toLowerCase();
+    if (!["pass", "fail", "skip"].includes(normalized)) {
+        throw new AutoresearchError("Unsupported " + fieldName + ": " + value);
+    }
+    return normalized;
+}
+export function parseDurationSeconds(value) {
+    if (!value)
+        return null;
+    const normalized = value.trim().toLowerCase();
+    if (!normalized)
+        return null;
+    if (/^\d+$/.test(normalized)) {
+        const n = parseInt(normalized);
+        if (n <= 0)
+            throw new AutoresearchError("Invalid duration: " + value);
+        return n;
+    }
+    const tokens = [...normalized.matchAll(/(\d+)([smhd])/g)];
+    let total = 0;
+    let pos = 0;
+    for (const match of tokens) {
+        if (match.index !== pos) {
+            throw new AutoresearchError("Invalid duration: " + value);
+        }
+        const amount = parseInt(match[1]);
+        const unit = match[2];
+        const multiplier = { s: 1, m: 60, h: 3600, d: 86400 };
+        total += amount * (multiplier[unit] ?? 0);
+        pos += match[0].length;
+    }
+    if (pos !== normalized.length || total <= 0) {
+        throw new AutoresearchError("Invalid duration: " + value);
+    }
+    return total;
+}
+export function inferVerifyCommand(repo) {
+    const base = repo ?? ".";
+    const hasPkg = existsSync(resolve(base, "package.json"));
+    if (hasPkg)
+        return "npm test";
+    const makeFile = resolve(base, "Makefile");
+    if (existsSync(makeFile))
+        return "make test";
+    const hasPy = existsSync(resolve(base, "pytest.ini")) || existsSync(resolve(base, "tests"));
+    if (hasPy)
+        return "pytest";
+    return "<set verify command>";
+}
+export function normalizeLabels(values) {
+    if (!values)
+        return [];
+    if (typeof values === "string") {
+        return [...new Set(values.split(",").map((s) => s.trim()).filter(Boolean))];
+    }
+    if (!Array.isArray(values))
+        return [];
+    return [...new Set(values.map((v) => v.trim()).filter(Boolean))];
+}
+export function missingRequiredLabels(labels, required) {
+    const labelSet = new Set(labels);
+    return required.filter((l) => !labelSet.has(l));
+}
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import { VERSION, PACKAGE_NAME, PRODUCT_BRAND, SKILL_NAME } from "./constants.js";
+export { VERSION, PACKAGE_NAME, PRODUCT_BRAND, SKILL_NAME };
+export type { RunConfig, WizardConfig, SupervisorSnapshot, RunState } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,YAAY,EACZ,aAAa,EACb,UAAU,EACX,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC;AAC5D,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+import { VERSION, PACKAGE_NAME, PRODUCT_BRAND, SKILL_NAME, } from "./constants.js";
+export { VERSION, PACKAGE_NAME, PRODUCT_BRAND, SKILL_NAME };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,YAAY,EACZ,aAAa,EACb,UAAU,GACX,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC"}

package/dist/run-manager.d.ts

@@ -0,0 +1,9 @@
+import type { RunConfig, RunState } from "./types.js";
+export declare function initializeRun(repo: string | undefined, resultsPathValue: string | undefined, statePathValue: string | undefined, config: RunConfig, freshStart: boolean): Promise<RunState>;
+export declare function appendIteration(repo: string | undefined, resultsPathValue: string | undefined, statePathValue: string | undefined, decision: string, metricValue: string | undefined, verifyStatus: string, guardStatus: string, hypothesis: string | undefined, changeSummary: string, labels: string[] | undefined, note: string | undefined, iteration: number | undefined): Promise<RunState>;
+export declare function makeStatePayload(config: RunConfig, resultsPath: string, statePath: string): RunState;
+export declare function setStopRequested(repo: string | undefined, statePathValue: string | undefined): Promise<RunState>;
+export declare function resumeBackgroundRun(repo: string | undefined, statePathValue: string | undefined): Promise<RunState>;
+export declare function completeRun(repo: string | undefined, statePathValue: string | undefined): Promise<RunState>;
+export declare function buildSupervisorSnapshot(repo: string | undefined, _resultsPath: string | undefined, statePathValue: string | undefined): Promise<Record<string, unknown>>;
+//# sourceMappingURL=run-manager.d.ts.map

package/dist/run-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-manager.d.ts","sourceRoot":"","sources":["../src/run-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAiBtD,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,QAAQ,CAAC,CAmBnB;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,EAC5B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,OAAO,CAAC,QAAQ,CAAC,CA0EnB;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,QAAQ,CA8DV;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,OAAO,CAAC,QAAQ,CAAC,CAYnB;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,OAAO,CAAC,QAAQ,CAAC,CAgBnB;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,OAAO,CAAC,QAAQ,CAAC,CAYnB;AAED,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAwClC"}

package/dist/run-manager.js

@@ -0,0 +1,239 @@
+import { utcNow, ensureParent, atomicWriteJson, readJsonFile, resolvePath, normalizeDirection, parseDurationSeconds, normalizeLabels, missingRequiredLabels, AutoresearchError, } from "./helpers.js";
+import { RESULTS_DEFAULT, STATE_DEFAULT } from "./constants.js";
+import { buildSubagentPoolPlan, buildContinuationPolicy } from "./subagent-pool.js";
+import { writeFileSync, appendFileSync, existsSync } from "fs";
+export async function initializeRun(repo, resultsPathValue, statePathValue, config, freshStart) {
+    const resultsPath = resolvePath(repo, resultsPathValue, RESULTS_DEFAULT);
+    const statePath = resolvePath(repo, statePathValue, STATE_DEFAULT);
+    if (existsSync(statePath) && !freshStart) {
+        throw new AutoresearchError(`${statePath} already exists. Use --fresh-start to archive.`);
+    }
+    const header = "timestamp\titeration\tdecision\tmetric_value\tverify_status\tguard_status\thypothesis\tchange_summary\tlabels\tnote\n";
+    ensureParent(resultsPath);
+    if (!existsSync(resultsPath)) {
+        writeFileSync(resultsPath, header, "utf-8");
+    }
+    else {
+        appendFileSync(resultsPath, header, "utf-8");
+    }
+    const state = makeStatePayload(config, resultsPath, statePath);
+    await atomicWriteJson(statePath, state);
+    return state;
+}
+export async function appendIteration(repo, resultsPathValue, statePathValue, decision, metricValue, verifyStatus, guardStatus, hypothesis, changeSummary, labels, note, iteration) {
+    const resultsPath = resolvePath(repo, resultsPathValue, RESULTS_DEFAULT);
+    const statePath = resolvePath(repo, statePathValue, STATE_DEFAULT);
+    const state = readJsonFile(statePath);
+    const currentIteration = iteration ?? state.stats.total_iterations + 1;
+    const now = utcNow();
+    const labelList = normalizeLabels(labels ?? []);
+    const labelReqs = state.label_requirements ?? { keep: [], stop: [] };
+    const requiredKeep = normalizeLabels(labelReqs.keep ?? []);
+    const requiredStop = normalizeLabels(labelReqs.stop ?? []);
+    const missingKeep = missingRequiredLabels(labelList, requiredKeep);
+    const missingStop = missingRequiredLabels(labelList, requiredStop);
+    if (decision === "keep" && missingKeep.length > 0) {
+        throw new AutoresearchError(`Keep requires labels: ${missingKeep.join(", ")}`);
+    }
+    const resultRow = [
+        now,
+        String(currentIteration),
+        decision,
+        metricValue ?? "",
+        verifyStatus,
+        guardStatus,
+        hypothesis ?? "",
+        changeSummary,
+        labelList.join(","),
+        note ?? "",
+    ].join("\t") + "\n";
+    appendFileSync(resultsPath, resultRow, "utf-8");
+    const newState = {
+        ...state,
+        updated_at: now,
+        status: "running",
+        stats: {
+            ...state.stats,
+            total_iterations: currentIteration,
+        },
+        flags: {
+            ...state.flags,
+            stop_ready: decision === "keep" && missingStop.length === 0,
+        },
+    };
+    if (decision === "keep") {
+        newState.stats.kept = (newState.stats.kept ?? 0) + 1;
+        newState.stats.consecutive_discards = 0;
+    }
+    else if (decision === "discard") {
+        newState.stats.discarded = (newState.stats.discarded ?? 0) + 1;
+        newState.stats.consecutive_discards = (newState.stats.consecutive_discards ?? 0) + 1;
+    }
+    else if (decision === "needs_human") {
+        newState.stats.needs_human = (newState.stats.needs_human ?? 0) + 1;
+        newState.flags.needs_human = true;
+        newState.stats.consecutive_discards = 0;
+    }
+    newState.last_iteration = {
+        iteration: currentIteration,
+        decision,
+        metric_value: metricValue,
+        change_summary: changeSummary,
+        labels: labelList,
+        timestamp: now,
+        keep_labels_satisfied: missingKeep.length === 0,
+        stop_labels_satisfied: missingStop.length === 0,
+        missing_keep_labels: missingKeep,
+        missing_stop_labels: missingStop,
+    };
+    await atomicWriteJson(statePath, newState);
+    return newState;
+}
+export function makeStatePayload(config, resultsPath, statePath) {
+    const now = utcNow();
+    const durationSeconds = parseDurationSeconds(config.duration);
+    const deadlineAt = durationSeconds != null
+        ? new Date(Date.now() + durationSeconds * 1000).toISOString().split(".")[0] + "Z"
+        : undefined;
+    const subagentPool = buildSubagentPoolPlan({
+        goal: config.goal,
+        scope: config.scope ?? "current repository",
+        mode: config.mode,
+    });
+    const continuationPolicy = buildContinuationPolicy(config.mode);
+    return {
+        schema_version: 1,
+        run_id: config.run_tag ?? `run-${Date.now().toString(36)}`,
+        created_at: now,
+        updated_at: now,
+        status: "initialized",
+        mode: config.mode,
+        goal: config.goal,
+        scope: config.scope ?? "current repository",
+        metric: {
+            name: config.metric,
+            direction: normalizeDirection(config.direction),
+            baseline: config.baseline,
+            best: config.baseline,
+            latest: config.baseline,
+        },
+        verify: config.verify,
+        guard: config.guard,
+        iterations_cap: config.iterations,
+        duration: config.duration,
+        duration_seconds: durationSeconds ?? undefined,
+        deadline_at: deadlineAt,
+        label_requirements: {
+            keep: normalizeLabels(config.required_keep_labels ?? []),
+            stop: normalizeLabels(config.required_stop_labels ?? []),
+        },
+        stop_condition: config.stop_condition,
+        artifact_paths: {
+            results: resultsPath,
+            state: statePath,
+        },
+        stats: {
+            total_iterations: 0,
+            kept: 0,
+            discarded: 0,
+            needs_human: 0,
+            consecutive_discards: 0,
+            best_iteration: undefined,
+        },
+        flags: {
+            stop_requested: false,
+            needs_human: false,
+            background_active: config.mode === "background",
+            stop_ready: false,
+        },
+        subagent_pool: subagentPool,
+        continuation_policy: continuationPolicy,
+    };
+}
+export async function setStopRequested(repo, statePathValue) {
+    const statePath = resolvePath(repo, statePathValue, STATE_DEFAULT);
+    const state = readJsonFile(statePath);
+    if (state.mode !== "background") {
+        throw new AutoresearchError("Only background runs can be stopped.");
+    }
+    state.updated_at = utcNow();
+    state.flags.stop_requested = true;
+    state.flags.background_active = false;
+    state.status = "stopping";
+    await atomicWriteJson(statePath, state);
+    return state;
+}
+export async function resumeBackgroundRun(repo, statePathValue) {
+    const statePath = resolvePath(repo, statePathValue, STATE_DEFAULT);
+    const state = readJsonFile(statePath);
+    if (state.mode !== "background") {
+        throw new AutoresearchError("Only background runs can be resumed.");
+    }
+    if (state.status === "completed") {
+        throw new AutoresearchError("Completed runs cannot be resumed.");
+    }
+    state.updated_at = utcNow();
+    state.flags.stop_requested = false;
+    state.flags.needs_human = false;
+    state.flags.background_active = true;
+    state.status = "running";
+    await atomicWriteJson(statePath, state);
+    return state;
+}
+export async function completeRun(repo, statePathValue) {
+    const statePath = resolvePath(repo, statePathValue, STATE_DEFAULT);
+    const state = readJsonFile(statePath);
+    if (state.status === "completed")
+        return state;
+    state.updated_at = utcNow();
+    state.status = "completed";
+    state.flags.background_active = false;
+    state.flags.needs_human = false;
+    state.flags.stop_requested = false;
+    state.flags.stop_ready = false;
+    await atomicWriteJson(statePath, state);
+    return state;
+}
+export async function buildSupervisorSnapshot(repo, _resultsPath, statePathValue) {
+    const statePath = resolvePath(repo, statePathValue, STATE_DEFAULT);
+    const state = readJsonFile(statePath);
+    void _resultsPath; // used for snapshot, results path tracked separately
+    let decision = "relaunch";
+    let reason = "ready_for_next_iteration";
+    if (state.flags.stop_requested) {
+        decision = "stop";
+        reason = "stop_requested";
+    }
+    else if (state.flags.needs_human) {
+        decision = "needs_human";
+        reason = "human_input_required";
+    }
+    else if (state.deadline_at && new Date() >= new Date(state.deadline_at)) {
+        decision = "stop";
+        reason = "duration_elapsed";
+    }
+    else if (state.iterations_cap != null && state.stats.total_iterations >= state.iterations_cap) {
+        decision = "stop";
+        reason = "iteration_cap_reached";
+    }
+    else if (state.status === "completed" || state.status === "stopped") {
+        decision = "stop";
+        reason = `state_${state.status}`;
+    }
+    return {
+        decision,
+        reason,
+        run_id: state.run_id,
+        status: state.status,
+        mode: state.mode,
+        goal: state.goal,
+        metric: state.metric,
+        stats: state.stats,
+        last_iteration: state.last_iteration,
+        results_rows: 0,
+        artifact_paths: state.artifact_paths,
+        flags: state.flags,
+        label_requirements: state.label_requirements,
+    };
+}
+//# sourceMappingURL=run-manager.js.map

package/dist/run-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-manager.js","sourceRoot":"","sources":["../src/run-manager.ts"],"names":[],"mappings":"AACA,OAAO,EACL,MAAM,EACN,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAE/D,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAwB,EACxB,gBAAoC,EACpC,cAAkC,EAClC,MAAiB,EACjB,UAAmB;IAEnB,MAAM,WAAW,GAAG,WAAW,CAAC,IAAI,EAAE,gBAAgB,EAAE,eAAe,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;IAEnE,IAAI,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACzC,MAAM,IAAI,iBAAiB,CAAC,GAAG,SAAS,gDAAgD,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,MAAM,GAAG,uHAAuH,CAAC;IACvI,YAAY,CAAC,WAAW,CAAC,CAAC;IAC1B,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;SAAM,CAAC;QACN,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IAC/D,MAAM,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAwB,EACxB,gBAAoC,EACpC,cAAkC,EAClC,QAAgB,EAChB,WAA+B,EAC/B,YAAoB,EACpB,WAAmB,EACnB,UAA8B,EAC9B,aAAqB,EACrB,MAA4B,EAC5B,IAAwB,EACxB,SAA6B;IAE7B,MAAM,WAAW,GAAG,WAAW,CAAC,IAAI,EAAE,gBAAgB,EAAE,eAAe,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,CAAwB,CAAC;IAE7D,MAAM,gBAAgB,GAAG,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,gBAAgB,GAAG,CAAC,CAAC;IACvE,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,KAAK,CAAC,kBAAkB,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACrE,MAAM,YAAY,GAAG,eAAe,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,eAAe,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC3D,MAAM,WAAW,GAAG,qBAAqB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACnE,MAAM,WAAW,GAAG,qBAAqB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAEnE,IAAI,QAAQ,KAAK,MAAM,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,iBAAiB,CAAC,yBAAyB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,SAAS,GAAG;QAChB,GAAG;QACH,MAAM,CAAC,gBAAgB,CAAC;QACxB,QAAQ;QACR,WAAW,IAAI,EAAE;QACjB,YAAY;QACZ,WAAW;QACX,UAAU,IAAI,EAAE;QAChB,aAAa;QACb,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;QACnB,IAAI,IAAI,EAAE;KACX,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEpB,cAAc,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAEhD,MAAM,QAAQ,GAAa;QACzB,GAAG,KAAK;QACR,UAAU,EAAE,GAAG;QACf,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE;YACL,GAAG,KAAK,CAAC,KAAK;YACd,gBAAgB,EAAE,gBAAgB;SACnC;QACD,KAAK,EAAE;YACL,GAAG,KAAK,CAAC,KAAK;YACd,UAAU,EAAE,QAAQ,KAAK,MAAM,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;SAC5D;KACF,CAAC;IAEF,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACxB,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACrD,QAAQ,CAAC,KAAK,CAAC,oBAAoB,GAAG,CAAC,CAAC;IAC1C,CAAC;SAAM,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClC,QAAQ,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC/D,QAAQ,CAAC,KAAK,CAAC,oBAAoB,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,oBAAoB,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACvF,CAAC;SAAM,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;QACtC,QAAQ,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACnE,QAAQ,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;QAClC,QAAQ,CAAC,KAAK,CAAC,oBAAoB,GAAG,CAAC,CAAC;IAC1C,CAAC;IAED,QAAQ,CAAC,cAAc,GAAG;QACxB,SAAS,EAAE,gBAAgB;QAC3B,QAAQ;QACR,YAAY,EAAE,WAAW;QACzB,cAAc,EAAE,aAAa;QAC7B,MAAM,EAAE,SAAS;QACjB,SAAS,EAAE,GAAG;QACd,qBAAqB,EAAE,WAAW,CAAC,MAAM,KAAK,CAAC;QAC/C,qBAAqB,EAAE,WAAW,CAAC,MAAM,KAAK,CAAC;QAC/C,mBAAmB,EAAE,WAAW;QAChC,mBAAmB,EAAE,WAAW;KACjC,CAAC;IAEF,MAAM,eAAe,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC3C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,MAAiB,EACjB,WAAmB,EACnB,SAAiB;IAEjB,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IACrB,MAAM,eAAe,GAAG,oBAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,eAAe,IAAI,IAAI;QACxC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,eAAe,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG;QACjF,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,YAAY,GAAG,qBAAqB,CAAC;QACzC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,oBAAoB;QAC3C,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAC,CAAC;IACH,MAAM,kBAAkB,GAAG,uBAAuB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAEhE,OAAO;QACL,cAAc,EAAE,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC,OAAO,IAAI,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE;QAC1D,UAAU,EAAE,GAAG;QACf,UAAU,EAAE,GAAG;QACf,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,oBAAoB;QAC3C,MAAM,EAAE;YACN,IAAI,EAAE,MAAM,CAAC,MAAM;YACnB,SAAS,EAAE,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC;YAC/C,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI,EAAE,MAAM,CAAC,QAAQ;YACrB,MAAM,EAAE,MAAM,CAAC,QAAQ;SACxB;QACD,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,cAAc,EAAE,MAAM,CAAC,UAAU;QACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,gBAAgB,EAAE,eAAe,IAAI,SAAS;QAC9C,WAAW,EAAE,UAAU;QACvB,kBAAkB,EAAE;YAClB,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,oBAAoB,IAAI,EAAE,CAAC;YACxD,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,oBAAoB,IAAI,EAAE,CAAC;SACzD;QACD,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,cAAc,EAAE;YACd,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,SAAS;SACjB;QACD,KAAK,EAAE;YACL,gBAAgB,EAAE,CAAC;YACnB,IAAI,EAAE,CAAC;YACP,SAAS,EAAE,CAAC;YACZ,WAAW,EAAE,CAAC;YACd,oBAAoB,EAAE,CAAC;YACvB,cAAc,EAAE,SAAS;SAC1B;QACD,KAAK,EAAE;YACL,cAAc,EAAE,KAAK;YACrB,WAAW,EAAE,KAAK;YAClB,iBAAiB,EAAE,MAAM,CAAC,IAAI,KAAK,YAAY;YAC/C,UAAU,EAAE,KAAK;SAClB;QACD,aAAa,EAAE,YAAY;QAC3B,mBAAmB,EAAE,kBAAkB;KACxC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAwB,EACxB,cAAkC;IAElC,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,CAAwB,CAAC;IAC7D,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAChC,MAAM,IAAI,iBAAiB,CAAC,sCAAsC,CAAC,CAAC;IACtE,CAAC;IACD,KAAK,CAAC,UAAU,GAAG,MAAM,EAAE,CAAC;IAC5B,KAAK,CAAC,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC;IAClC,KAAK,CAAC,KAAK,CAAC,iBAAiB,GAAG,KAAK,CAAC;IACtC,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC;IAC1B,MAAM,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAwB,EACxB,cAAkC;IAElC,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,CAAwB,CAAC;IAC7D,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAChC,MAAM,IAAI,iBAAiB,CAAC,sCAAsC,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QACjC,MAAM,IAAI,iBAAiB,CAAC,mCAAmC,CAAC,CAAC;IACnE,CAAC;IACD,KAAK,CAAC,UAAU,GAAG,MAAM,EAAE,CAAC;IAC5B,KAAK,CAAC,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC;IACnC,KAAK,CAAC,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC;IAChC,KAAK,CAAC,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAAC;IACrC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;IACzB,MAAM,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAwB,EACxB,cAAkC;IAElC,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,CAAwB,CAAC;IAC7D,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IAC/C,KAAK,CAAC,UAAU,GAAG,MAAM,EAAE,CAAC;IAC5B,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC;IAC3B,KAAK,CAAC,KAAK,CAAC,iBAAiB,GAAG,KAAK,CAAC;IACtC,KAAK,CAAC,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC;IAChC,KAAK,CAAC,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC;IACnC,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC;IAC/B,MAAM,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,IAAwB,EACxB,YAAgC,EAChC,cAAkC;IAElC,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,CAAwB,CAAC;IAC7D,KAAK,YAAY,CAAC,CAAC,qDAAqD;IAExE,IAAI,QAAQ,GAAG,UAAU,CAAC;IAC1B,IAAI,MAAM,GAAG,0BAA0B,CAAC;IAExC,IAAI,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;QAC/B,QAAQ,GAAG,MAAM,CAAC;QAClB,MAAM,GAAG,gBAAgB,CAAC;IAC5B,CAAC;SAAM,IAAI,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACnC,QAAQ,GAAG,aAAa,CAAC;QACzB,MAAM,GAAG,sBAAsB,CAAC;IAClC,CAAC;SAAM,IAAI,KAAK,CAAC,WAAW,IAAI,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QAC1E,QAAQ,GAAG,MAAM,CAAC;QAClB,MAAM,GAAG,kBAAkB,CAAC;IAC9B,CAAC;SAAM,IAAI,KAAK,CAAC,cAAc,IAAI,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,gBAAgB,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QAChG,QAAQ,GAAG,MAAM,CAAC;QAClB,MAAM,GAAG,uBAAuB,CAAC;IACnC,CAAC;SAAM,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACtE,QAAQ,GAAG,MAAM,CAAC;QAClB,MAAM,GAAG,SAAS,KAAK,CAAC,MAAM,EAAE,CAAC;IACnC,CAAC;IAED,OAAO;QACL,QAAQ;QACR,MAAM;QACN,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,YAAY,EAAE,CAAC;QACf,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;KAC7C,CAAC;AACJ,CAAC"}

package/dist/subagent-pool.d.ts

@@ -0,0 +1,7 @@
+export declare function buildSubagentPoolPlan(params: {
+    goal: string;
+    scope?: string;
+    mode: string;
+}): Record<string, unknown>;
+export declare function buildContinuationPolicy(mode: string): Record<string, unknown>;
+//# sourceMappingURL=subagent-pool.d.ts.map

package/dist/subagent-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-pool.d.ts","sourceRoot":"","sources":["../src/subagent-pool.ts"],"names":[],"mappings":"AAoDA,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiD1B;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAW7E"}

package/dist/subagent-pool.js

@@ -0,0 +1,101 @@
+const ROLE_LIMIT = 6;
+const RESOURCE_TIERS = {
+    lite: ["orchestrator", "scout", "verifier"],
+    balanced: ["orchestrator", "scout", "analyst", "verifier"],
+    full: ["orchestrator", "scout", "analyst", "verifier", "synthesizer"],
+};
+const BASE_ROLES = [
+    { id: "orchestrator", name: "Orchestrator", focus: "Keep the goal, scope, and mode aligned; route work and merge results." },
+    { id: "scout", name: "Scout", focus: "Locate relevant files, docs, commands, and prior context in the repo." },
+    { id: "analyst", name: "Analyst", focus: "Turn evidence into options, tradeoffs, and a clear next-step recommendation." },
+    { id: "verifier", name: "Verifier", focus: "Check claims with commands, tests, or log reads before the pool settles." },
+    { id: "synthesizer", name: "Synthesizer", focus: "Condense the best evidence into a stable summary the orchestrator can reuse." },
+];
+const SPECIAL_ROLES = [
+    { id: "security_reviewer", name: "Security Reviewer", focus: "Look for safety, abuse, auth, and data-handling risks.", triggers: ["security", "vuln", "threat", "auth", "permission"] },
+    { id: "debugger", name: "Debugger", focus: "Reproduce failures, isolate causes, and narrow the repair path.", triggers: ["debug", "fix", "bug", "error", "fail", "failing"] },
+    { id: "release_guard", name: "Release Guard", focus: "Check ship-readiness, rollout risk, and user-visible regressions.", triggers: ["ship", "release", "deploy", "rollout"] },
+    { id: "research_tracker", name: "Research Tracker", focus: "Collect background, comparisons, and scenario coverage for the loop.", triggers: ["learn", "research", "predict", "scenario"] },
+];
+function chooseSpecialRole(goal, scope, mode) {
+    const lowered = `${goal} ${scope ?? ""} ${mode}`.toLowerCase();
+    return SPECIAL_ROLES.find((r) => r.triggers?.some((t) => lowered.includes(t)));
+}
+function chooseResourceTier(goal, scope, mode, specialRole) {
+    if (mode === "background")
+        return { tier: "full", reason: "Background runs need full standing pool alignment." };
+    if (specialRole)
+        return { tier: "full", reason: `Goal needs ${specialRole.name} coverage.` };
+    const tokens = `${goal} ${scope ?? ""}`.split(/\s+/).length;
+    if (tokens <= 8 && !scope)
+        return { tier: "lite", reason: "Short narrow work can use a smaller pool." };
+    if (tokens <= 20)
+        return { tier: "balanced", reason: "Moderate work benefits from balanced coverage." };
+    return { tier: "full", reason: "Broader work benefits from full standing pool." };
+}
+function buildRoleHandoffPrompt(template, goal, scope, mode) {
+    return `You are the ${template.name}. Focus: ${template.focus} Goal: ${goal}. Scope: ${scope ?? "current repository"}. Mode: ${mode}. Do not mutate autoresearch state. Return evidence and one next-step recommendation.`;
+}
+export function buildSubagentPoolPlan(params) {
+    const { goal, scope, mode } = params;
+    const specialRole = chooseSpecialRole(goal, scope, mode);
+    const { tier, reason } = chooseResourceTier(goal, scope, mode, specialRole);
+    const tierRoles = RESOURCE_TIERS[tier] ?? RESOURCE_TIERS.lite;
+    const allRoles = [...BASE_ROLES];
+    if (specialRole)
+        allRoles.push(specialRole);
+    const usedRoles = allRoles.slice(0, ROLE_LIMIT);
+    return {
+        kind: "autoresearch_subagent_pool",
+        version: 1,
+        pool_key: `autoresearch-pool-${Date.now().toString(36)}`,
+        role_limit: ROLE_LIMIT,
+        standing_pool: true,
+        reuse_across_iterations: true,
+        orchestrator_role_id: "orchestrator",
+        state_owner: "orchestrator",
+        fallback_mode: "serial",
+        resource_tier: tier,
+        recommended_active_role_ids: tierRoles,
+        activation: {
+            during_setup: tier !== "lite",
+            during_iterations: true,
+            during_resume: true,
+            reason,
+        },
+        handoff_contract: [
+            "Only the orchestrator records iterations or mutates state.",
+            "Non-orchestrator roles return evidence and concise recommendations.",
+            "Keep the pool stable across iterations.",
+        ],
+        reanchor_checklist: [
+            "Restate the goal, scope, metric, and verify command before the next handoff.",
+            "Summarize the latest kept or discarded iteration before asking the pool for more work.",
+            "Reuse current role ownership unless drift or repeated discards force a reset.",
+        ],
+        goal,
+        scope: scope ?? null,
+        mode,
+        roles: usedRoles.map((r) => ({
+            id: r.id,
+            name: r.name,
+            focus: r.focus,
+            active_by_default: tierRoles.includes(r.id),
+            handoff_prompt: buildRoleHandoffPrompt(r, goal, scope, mode),
+        })),
+        specialization: specialRole?.id ?? null,
+    };
+}
+export function buildContinuationPolicy(mode) {
+    return {
+        approval_boundary: "pre_launch",
+        post_launch_default: "continue",
+        completion_requires_review: mode === "foreground",
+        stop_conditions: [
+            "user_stop",
+            "configured_stop_condition",
+            "needs_human",
+        ],
+    };
+}
+//# sourceMappingURL=subagent-pool.js.map

package/dist/subagent-pool.js.map

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