odai-dsh-agent 0.2.3 → 0.2.6

package/preset/odai/runtime/runtime-config.mjs

@@ -0,0 +1,181 @@
+import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { CONFIGURABLE_ROLES, resolveRoleRoute, resolveRoutingConfigPath } from "./routing-config.mjs";
+import { resolveOutputConfigPath } from "./output-config.mjs";
+import { resolveCompactionConfigPath } from "./compaction-config.mjs";
+import { resolveSkillSourceConfigPath } from "./skill-source-config.mjs";
+import { SKILL_SOURCE_MODES, loadSkillBundle } from "./skill-bundle.mjs";
+import { resolveSkillEvolutionRoot } from "./skill-evolution.mjs";
+import { MEMORY_MODES, resolveMemoryStorePath } from "./semantic-memory-store.mjs";
+import { isUnknownRecord } from "./runtime-types.mjs";
+const PLUGIN_DIR = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+const ROUTING_MODES = new Set(["off", "observe", "auto", "execute"]);
+const COMPACTION_CACHE_RETENTIONS = new Set(["provider-default", "short", "long", "none"]);
+export const ROUTED_ROLES = CONFIGURABLE_ROLES;
+const DEFAULT_ROUTING_MODE = "auto";
+function isRoutingMode(value) {
+    return typeof value === "string" && ROUTING_MODES.has(value);
+}
+function isMemoryMode(value) {
+    return typeof value === "string" && MEMORY_MODES.includes(value);
+}
+function isCacheRetention(value) {
+    return typeof value === "string" && COMPACTION_CACHE_RETENTIONS.has(value);
+}
+function isSkillSource(value) {
+    return typeof value === "string" && SKILL_SOURCE_MODES.includes(value);
+}
+function assertPlainObject(value, field) {
+    if (value === undefined)
+        return {};
+    if (!isUnknownRecord(value))
+        throw new TypeError(`${field} must be an object`);
+    return value;
+}
+export function resolveConfig(rawConfig = {}) {
+    const raw = assertPlainObject(rawConfig, "config");
+    const routing = assertPlainObject(raw.routing, "config.routing");
+    const roles = assertPlainObject(routing.roles, "config.routing.roles");
+    const governance = assertPlainObject(raw.governance, "config.governance");
+    const output = assertPlainObject(raw.output, "config.output");
+    const compaction = assertPlainObject(raw.compaction, "config.compaction");
+    const memory = assertPlainObject(raw.memory, "config.memory");
+    const mode = routing.mode ?? DEFAULT_ROUTING_MODE;
+    const provider = routing.provider ?? "spawn";
+    const maxInputChars = routing.maxInputChars ?? 12_000;
+    const configPath = resolveRoutingConfigPath(routing.configPath);
+    const additionalDeniedTools = governance.additionalDeniedTools ?? [];
+    const skillSource = governance.skillSource ?? "bundled";
+    const skillConfigPath = resolveSkillSourceConfigPath(governance.skillConfigPath);
+    const evolutionRoot = resolveSkillEvolutionRoot(governance.evolutionRoot);
+    const outputConfigPath = resolveOutputConfigPath(output.configPath);
+    const compactionConfigPath = resolveCompactionConfigPath(compaction.configPath);
+    const memoryStorePath = resolveMemoryStorePath(memory.storePath);
+    const memoryMode = memory.mode ?? "auto";
+    const memoryMaxRetrieved = memory.maxRetrieved ?? 6;
+    const compactionCacheRetention = compaction.cacheRetention
+        ?? process.env.ODAI_COMPACTION_CACHE_RETENTION
+        ?? "provider-default";
+    const unknownRoles = Object.keys(roles).filter((role) => !ROUTED_ROLES.includes(role));
+    const unknownOutputFields = Object.keys(output).filter((field) => field !== "configPath");
+    const unknownCompactionFields = Object.keys(compaction).filter((field) => !["cacheRetention", "configPath"].includes(field));
+    const unknownMemoryFields = Object.keys(memory).filter((field) => !["mode", "storePath", "maxRetrieved"].includes(field));
+    if (!isRoutingMode(mode)) {
+        throw new TypeError("config.routing.mode must be off, observe, auto, or execute");
+    }
+    if (typeof provider !== "string" || provider.trim() === "") {
+        throw new TypeError("config.routing.provider must be a non-empty string");
+    }
+    if (typeof maxInputChars !== "number" || !Number.isSafeInteger(maxInputChars) || maxInputChars < 256) {
+        throw new TypeError("config.routing.maxInputChars must be an integer of at least 256");
+    }
+    if (unknownRoles.length > 0) {
+        throw new TypeError(`config.routing.roles has unknown roles: ${unknownRoles.join(", ")}`);
+    }
+    if (unknownOutputFields.length > 0) {
+        throw new TypeError(`config.output has unknown fields: ${unknownOutputFields.join(", ")}`);
+    }
+    if (unknownCompactionFields.length > 0) {
+        throw new TypeError(`config.compaction has unknown fields: ${unknownCompactionFields.join(", ")}`);
+    }
+    if (unknownMemoryFields.length > 0) {
+        throw new TypeError(`config.memory has unknown fields: ${unknownMemoryFields.join(", ")}`);
+    }
+    if (!isMemoryMode(memoryMode)) {
+        throw new TypeError("config.memory.mode must be auto or off");
+    }
+    if (typeof memoryMaxRetrieved !== "number" || !Number.isSafeInteger(memoryMaxRetrieved) || memoryMaxRetrieved < 1 || memoryMaxRetrieved > 12) {
+        throw new TypeError("config.memory.maxRetrieved must be an integer from 1 to 12");
+    }
+    if (!isCacheRetention(compactionCacheRetention)) {
+        throw new TypeError("config.compaction.cacheRetention must be provider-default, short, long, or none");
+    }
+    if (!Array.isArray(additionalDeniedTools)
+        || additionalDeniedTools.some((tool) => typeof tool !== "string" || tool.trim() === "")) {
+        throw new TypeError("config.governance.additionalDeniedTools must be an array of non-empty strings");
+    }
+    if (!isSkillSource(skillSource)) {
+        throw new TypeError("config.governance.skillSource must be bundled, auto, or user");
+    }
+    if (raw.skillPath !== undefined && (typeof raw.skillPath !== "string" || raw.skillPath.trim() === "")) {
+        throw new TypeError("config.skillPath must be a non-empty string");
+    }
+    const deniedTools = additionalDeniedTools;
+    return Object.freeze({
+        skillPath: raw.skillPath,
+        routing: Object.freeze({
+            mode,
+            provider: provider.trim(),
+            maxInputChars,
+            configPath,
+            roles: Object.freeze(Object.fromEntries(ROUTED_ROLES.map((role) => [
+                role,
+                resolveRoleRoute(roles[role], role),
+            ]))),
+        }),
+        governance: Object.freeze({
+            additionalDeniedTools: Object.freeze(deniedTools.map((tool) => tool.trim())),
+            skillSource,
+            skillConfigPath,
+            evolutionRoot,
+        }),
+        output: Object.freeze({ configPath: outputConfigPath }),
+        compaction: Object.freeze({
+            cacheRetention: compactionCacheRetention,
+            configPath: compactionConfigPath,
+        }),
+        memory: Object.freeze({
+            mode: memoryMode,
+            storePath: memoryStorePath,
+            maxRetrieved: memoryMaxRetrieved,
+        }),
+    });
+}
+/** Mutate exact-route compaction options; returns true only when an option changed. */
+export function inheritCompactionReasoning(options, sessions, cacheRetention = "provider-default") {
+    if (options?.purpose !== "compaction"
+        || options.sessionId === undefined
+        || !Object.isExtensible(options)) {
+        return false;
+    }
+    const route = sessions?.get?.(options.sessionId)?.requestHeader?.()?.config;
+    if (!route
+        || route.provider !== options.provider
+        || route.model !== options.model
+        || typeof route.reasoningEffort !== "string"
+        || route.reasoningEffort.length === 0) {
+        return false;
+    }
+    let changed = false;
+    if (options.reasoningEffort === undefined) {
+        options.reasoningEffort = route.reasoningEffort;
+        changed = true;
+    }
+    if (options.cacheRetention === undefined && cacheRetention !== "provider-default") {
+        options.cacheRetention = cacheRetention;
+        changed = true;
+    }
+    return changed;
+}
+export function resolveSkillPath(configuredPath, env = process.env) {
+    const explicit = configuredPath ?? env.ODAI_SKILL_PATH;
+    if (explicit !== undefined) {
+        const path = resolve(explicit);
+        if (!existsSync(path))
+            throw new Error(`explicit Odai canonical skill not found: ${path}`);
+        return path;
+    }
+    const candidates = [
+        resolve(PLUGIN_DIR, "skills/odai/SKILL.md"),
+        resolve(PLUGIN_DIR, "../../skills/odai/SKILL.md"),
+    ];
+    const found = candidates.find((candidate) => existsSync(candidate));
+    if (found)
+        return found;
+    throw new Error(`Odai bundled canonical skill not found; checked: ${candidates.join(", ")}`);
+}
+export function loadRoleContracts(skillPath) {
+    return loadSkillBundle(skillPath).roleContracts;
+}
+//# sourceMappingURL=runtime-config.mjs.map

package/preset/odai/runtime/runtime-config.mjs.map

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

package/preset/odai/runtime/runtime-support.d.mts

@@ -0,0 +1,91 @@
+import type { RouteDecision } from "./router.mjs";
+import type { SkillBundle } from "./skill-bundle.mjs";
+import type { ResponsibilityInterruption } from "./responsibility-scope.mjs";
+import type { DshAgent, DshContentBlock, DshEvent, DshMessage, ModelRoute, PromptAssembly, RuntimeLogger, ToolSchema, UnknownRecord } from "./runtime-types.mjs";
+interface RoutedRunResult {
+    stopReason: string;
+    output?: readonly DshContentBlock[];
+}
+interface RequestRouteAgent {
+    session?: {
+        events?: readonly DshEvent[];
+    };
+}
+interface RoutedRun {
+    result: Promise<RoutedRunResult>;
+    localAgent?: RequestRouteAgent;
+    dispose(): Promise<void>;
+}
+export interface SubagentsService {
+    start(provider: string, options: UnknownRecord): Promise<RoutedRun>;
+}
+export interface RoutedRoleOutcome extends UnknownRecord {
+    status: "completed" | "fallback";
+    stopReason: string;
+    output: readonly DshContentBlock[];
+    routeReceiptStatus?: "applied" | "mismatch" | "unverified";
+    routeReceiptError?: string;
+    actualRoute?: ModelRoute;
+    error?: string;
+    taskError?: string;
+}
+export interface SkillSelection {
+    mode: string;
+    status: string;
+    reasonCode: string;
+    detail?: string;
+    bundle: SkillBundle;
+    rejections: readonly {
+        source: string;
+        reasonCode: string;
+    }[];
+    evolution?: {
+        status?: string;
+        generationId?: string;
+        baseDigest?: string;
+        upstreamDigest?: string;
+        rebaseRequired?: boolean;
+    };
+}
+export interface RoutingSnapshotState {
+    error?: string;
+    detail?: string;
+    snapshot?: {
+        roles: Readonly<Record<string, ModelRoute | undefined>>;
+        sources: Readonly<Record<string, string>>;
+    };
+}
+export declare const RUNTIME_NAME = "odai-dsh-runtime";
+export declare function deepFreeze<T>(value: T): Readonly<T>;
+export declare function pluginMessage(text: string, summary: string, extraBlocks?: readonly DshContentBlock[]): Readonly<DshMessage>;
+export declare function renderOutputLimitInterruptionNotice(interruption: ResponsibilityInterruption): string;
+export declare function loggerFor(ctx: {
+    logger?: (name: string) => RuntimeLogger;
+}): RuntimeLogger;
+export declare function outputText(blocks: unknown): string;
+export declare function renderResearchTaskContract(taskText: string): string;
+export declare function roleAgentOptions(roleRoute?: ModelRoute): UnknownRecord | undefined;
+export declare function sameRequestModelRoute(left?: Partial<ModelRoute>, right?: Partial<ModelRoute>): boolean;
+export declare function currentAgentStep(agent: DshAgent): number | undefined;
+export declare function routeFromConfig(config: unknown): ModelRoute | undefined;
+export declare function latestRequestRoute(localAgent: RequestRouteAgent | undefined): ModelRoute | undefined;
+export declare function routeMismatchFor(expected: ModelRoute | undefined, actual: ModelRoute | undefined, subject: string): string | undefined;
+export declare function routeMismatch(expected?: ModelRoute, actual?: ModelRoute): string | undefined;
+export declare function runRoutedRole({ subagents, provider, decision, taskText, roleContract, agent, signal, roleRoute, }: {
+    subagents: SubagentsService;
+    provider: string;
+    decision: Pick<RouteDecision, "role">;
+    taskText: string;
+    roleContract: string;
+    agent: unknown;
+    signal: AbortSignal;
+    roleRoute?: ModelRoute;
+}): Promise<Readonly<RoutedRoleOutcome>>;
+export declare function canonicalPrompt(selection: SkillSelection): string;
+export declare function renderEffectiveRoutingContext(snapshotState: RoutingSnapshotState): string;
+export declare function latestRouteReceipt(events: readonly DshEvent[]): Readonly<UnknownRecord> | undefined;
+export declare function isSubagentSession(agent: DshAgent): boolean;
+export declare function routedRoleOf(agent: DshAgent): string | undefined;
+export declare function reconcileAdaptiveToolSchemas(assembly: PromptAssembly, activeNames: readonly string[], executableSchemas?: readonly ToolSchema[]): PromptAssembly;
+export {};
+//# sourceMappingURL=runtime-support.d.mts.map

package/preset/odai/runtime/runtime-support.d.mts.map

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

package/preset/odai/runtime/runtime-support.mjs

@@ -0,0 +1,371 @@
+import { randomUUID } from "node:crypto";
+import { renderDelegationPrompt } from "./router.mjs";
+import { CONFIGURABLE_ROLES } from "./routing-config.mjs";
+import { ODAI_CONTEXTUAL_TOOL_NAMES, ODAI_CORE_TOOL_NAMES } from "./context-activation.mjs";
+import { ROUTED_ROLES } from "./runtime-config.mjs";
+function isUnknownRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+export const RUNTIME_NAME = "odai-dsh-runtime";
+export function deepFreeze(value) {
+    if (value === null || typeof value !== "object" || Object.isFrozen(value))
+        return value;
+    for (const child of Object.values(value))
+        deepFreeze(child);
+    return Object.freeze(value);
+}
+export function pluginMessage(text, summary, extraBlocks = []) {
+    return deepFreeze({
+        id: randomUUID(),
+        role: "user",
+        content: [{ type: "text", text }, ...extraBlocks],
+        source: {
+            kind: "plugin",
+            plugin: RUNTIME_NAME,
+            form: "notice",
+            summary: summary.length <= 120 ? summary : `${summary.slice(0, 119)}…`,
+        },
+    });
+}
+export function renderOutputLimitInterruptionNotice(interruption) {
+    const route = interruption.effectiveRoute ?? interruption.requestedRoute;
+    return [
+        "Odai verified output-limit interruption",
+        `responsibility: ${interruption.responsibility}`,
+        `interrupted scope: ${interruption.scopeId}`,
+        `provider finish reason: ${interruption.reason}`,
+        ...(route ? [`effective route: ${route.provider}/${route.model}`] : []),
+        ...(interruption.effectiveMaxTokens === undefined ? [] : [`effective maxTokens: ${interruption.effectiveMaxTokens}`]),
+        ...(interruption.outputTokens === undefined ? [] : [`observed outputTokens: ${interruption.outputTokens}`]),
+        "This proves the responsibility output was interrupted, not that its task completed. Explain the verified cause without guessing. Resume only after an explicit user continuation.",
+    ].join("\n");
+}
+export function loggerFor(ctx) {
+    if (typeof ctx.logger !== "function")
+        return { info() { }, warn() { } };
+    return ctx.logger(RUNTIME_NAME);
+}
+export function outputText(blocks) {
+    if (!Array.isArray(blocks))
+        return "";
+    return blocks
+        .filter((block) => isUnknownRecord(block) && block.type === "text" && typeof block.text === "string")
+        .map((block) => block.text ?? "")
+        .join("\n")
+        .trim();
+}
+export function renderResearchTaskContract(taskText) {
+    return [
+        "Decision-blocking factual question: Determine whether the user's causal claim is supported and which existing repository facts govern the safety of the requested high-impact change.",
+        "Allowed source scope: the current project root only. Use repository-relative paths and read-only source tools; do not inspect parent, sibling, user, or unrelated directories.",
+        "Authority and freshness: label each current-checkout source by its actual role (for example runtime configuration, implementation, test, incident record, or documentation). Do not invent an authority hierarchy; report unresolved conflicts and missing freshness evidence as unknowns.",
+        "Stop condition: return the smallest packet with 2-6 source-backed facts from at least two files, or stop with the missing evidence boundary. Do not select a route or continue after additional reading cannot change this factual question.",
+        "For every fact, excerpt must exactly equal the complete cited source line after trimming leading and trailing whitespace.",
+        "",
+        "Original user request:",
+        taskText,
+    ].join("\n");
+}
+export function roleAgentOptions(roleRoute) {
+    if (!roleRoute)
+        return undefined;
+    return {
+        provider: roleRoute.provider,
+        model: roleRoute.model,
+        ...(roleRoute.maxTokens === undefined ? {} : { maxTokens: roleRoute.maxTokens }),
+    };
+}
+export function sameRequestModelRoute(left, right) {
+    return Boolean(left && right
+        && left.provider === right.provider
+        && left.model === right.model
+        && left.reasoningEffort === right.reasoningEffort);
+}
+export function currentAgentStep(agent) {
+    const events = agent?.session?.events;
+    if (!Array.isArray(events))
+        return undefined;
+    for (let index = events.length - 1; index >= 0; index -= 1) {
+        if (events[index]?.type === "step/start" && Number.isSafeInteger(events[index].data?.step))
+            return events[index].data.step;
+    }
+    return undefined;
+}
+export function routeFromConfig(config) {
+    if (!isUnknownRecord(config) || typeof config.provider !== "string" || typeof config.model !== "string")
+        return undefined;
+    return Object.freeze({
+        provider: config.provider,
+        model: config.model,
+        ...(typeof config.reasoningEffort === "string" ? { reasoningEffort: config.reasoningEffort } : {}),
+        ...(typeof config.maxTokens === "number" ? { maxTokens: config.maxTokens } : {}),
+    });
+}
+export function latestRequestRoute(localAgent) {
+    const events = localAgent?.session?.events;
+    if (!Array.isArray(events))
+        return undefined;
+    for (let index = events.length - 1; index >= 0; index -= 1) {
+        const event = events[index];
+        if (event?.type !== "request/header")
+            continue;
+        const header = isUnknownRecord(event.data.header) ? event.data.header : undefined;
+        return routeFromConfig(header?.config);
+    }
+    return undefined;
+}
+export function routeMismatchFor(expected, actual, subject) {
+    if (!expected)
+        return undefined;
+    if (!actual)
+        return `${subject} request/header did not expose an actual model route`;
+    for (const field of ["provider", "model", "reasoningEffort", "maxTokens"]) {
+        if (expected[field] !== undefined && expected[field] !== actual[field]) {
+            return `${subject} ${field} mismatch: expected ${expected[field]}, got ${actual[field] ?? "<absent>"}`;
+        }
+    }
+    return undefined;
+}
+export function routeMismatch(expected, actual) {
+    return routeMismatchFor(expected, actual, "child");
+}
+export async function runRoutedRole({ subagents, provider, decision, taskText, roleContract, agent, signal, roleRoute, }) {
+    let run;
+    let outcome;
+    try {
+        run = await subagents.start(provider, {
+            label: `odai-${decision.role}`,
+            prompt: [{ type: "text", text: renderDelegationPrompt(decision, taskText, roleContract) }],
+            parent: agent,
+            signal,
+            maxDepth: 1,
+            ...(roleRoute ? { agentOptions: roleAgentOptions(roleRoute) } : {}),
+        });
+        const result = await run.result;
+        const actualRoute = latestRequestRoute(run.localAgent);
+        const mismatch = routeMismatch(roleRoute, actualRoute);
+        const routeReceiptStatus = !actualRoute ? "unverified" : mismatch ? "mismatch" : "applied";
+        const routeEvidence = Object.freeze({
+            routeReceiptStatus,
+            ...(mismatch ? { routeReceiptError: mismatch } : {}),
+            ...(actualRoute ? { actualRoute } : {}),
+        });
+        if (result.stopReason !== "completed") {
+            outcome = Object.freeze({
+                status: "fallback",
+                stopReason: result.stopReason,
+                output: result.output ?? [],
+                ...routeEvidence,
+            });
+        }
+        else if (mismatch) {
+            outcome = Object.freeze({
+                status: "fallback",
+                stopReason: "route-unverified",
+                output: [],
+                error: mismatch,
+                ...routeEvidence,
+            });
+        }
+        else if (!outputText(result.output)) {
+            outcome = Object.freeze({
+                status: "fallback",
+                stopReason: "route-empty-output",
+                output: [],
+                error: "child completed without textual evidence",
+                taskError: "child completed without textual evidence",
+                ...routeEvidence,
+            });
+        }
+        else {
+            outcome = Object.freeze({
+                status: "completed",
+                stopReason: result.stopReason,
+                output: result.output ?? [],
+                ...routeEvidence,
+            });
+        }
+    }
+    catch (error) {
+        const taskError = error instanceof Error ? error.message : String(error);
+        outcome = Object.freeze({
+            status: "fallback",
+            stopReason: "infrastructure-error",
+            output: [],
+            routeReceiptStatus: "unverified",
+            error: taskError,
+            taskError,
+        });
+    }
+    if (run) {
+        try {
+            await run.dispose();
+        }
+        catch (error) {
+            const disposeError = error instanceof Error ? error.message : String(error);
+            const cleanupTaskError = outcome?.taskError
+                ? `${outcome.taskError}; provider cleanup failed: ${disposeError}`
+                : `provider cleanup failed: ${disposeError}`;
+            return Object.freeze({
+                status: "fallback",
+                stopReason: "infrastructure-error",
+                output: [],
+                routeReceiptStatus: outcome?.routeReceiptStatus ?? "unverified",
+                ...(outcome?.routeReceiptError ? { routeReceiptError: outcome.routeReceiptError } : {}),
+                ...(outcome?.actualRoute ? { actualRoute: outcome.actualRoute } : {}),
+                error: outcome?.error
+                    ? `${outcome.error}; provider cleanup failed: ${disposeError}`
+                    : cleanupTaskError,
+                taskError: cleanupTaskError,
+            });
+        }
+    }
+    return outcome;
+}
+export function canonicalPrompt(selection) {
+    const { bundle } = selection;
+    const fallback = selection.status === "fallback"
+        ? `Selection fallback: ${selection.reasonCode}${selection.detail ? ` (${selection.detail})` : ""}.`
+        : undefined;
+    const evolution = selection.evolution?.status === "active"
+        ? `User evolution: generation ${selection.evolution.generationId}; base digest ${selection.evolution.baseDigest}; current upstream digest ${selection.evolution.upstreamDigest}; rebase required: ${String(selection.evolution.rebaseRequired)}.`
+        : undefined;
+    return [
+        "## odai canonical governance",
+        `Canonical source: ${bundle.source} (${bundle.provider})`,
+        `Canonical skill: ${bundle.manifest.skillVersion}; runtime contract: ${bundle.manifest.runtimeContract}; digest: ${bundle.digest}.`,
+        ...(evolution ? [evolution] : []),
+        ...(fallback ? [fallback] : []),
+        "Apply this governance to every request. Keep the controller as the final delivery owner; use another role only for a real independent gap with observable net benefit.",
+        "Odai governance is already loaded by this runtime; do not call the skill tool or read SKILL.md to load odai again.",
+        "",
+        bundle.skillText,
+    ].join("\n");
+}
+export function renderEffectiveRoutingContext(snapshotState) {
+    if (snapshotState.error || !snapshotState.snapshot) {
+        return [
+            "Current effective responsibility mappings: unavailable because the saved routing configuration is invalid.",
+            `Configuration error: ${snapshotState.detail}`,
+            "Use odai_routing_config only when the user asks to inspect or repair it; do not infer any route.",
+        ].join("\n");
+    }
+    const snapshot = snapshotState.snapshot;
+    const mappings = CONFIGURABLE_ROLES.flatMap((role) => {
+        const route = snapshot.roles[role];
+        if (!route)
+            return [];
+        const options = [
+            ...(route.reasoningEffort ? [`reasoningEffort=${route.reasoningEffort}`] : []),
+            ...(route.maxTokens ? [`maxTokens=${route.maxTokens}`] : []),
+        ];
+        return [`${role}=${route.provider}/${route.model}${options.length > 0 ? ` (${options.join(", ")})` : ""} [${snapshot.sources[role]}]`];
+    });
+    return [
+        `Current effective responsibility mappings (runtime-owned; supersedes conversation summaries): ${mappings.join("; ") || "none"}.`,
+        "These are route targets, not evidence that a responsibility ran. Only an actual route receipt proves use; a generic subagent does not.",
+    ].join("\n");
+}
+export function latestRouteReceipt(events) {
+    for (let index = events.length - 1; index >= 0; index -= 1) {
+        const event = events[index];
+        const data = event?.data;
+        if (!data?.routeSource || !Number.isSafeInteger(data.turn) || !Number.isSafeInteger(data.step))
+            continue;
+        if (event.type === "odai/route-fallback") {
+            return Object.freeze({
+                turn: data.turn,
+                step: data.step,
+                responsibility: data.responsibility,
+                ...(data.responsibilityScopeId ? { responsibilityScopeId: data.responsibilityScopeId } : {}),
+                ...(data.routeCardId ? { routeCardId: data.routeCardId } : {}),
+                status: "fallback",
+                taskStatus: "fallback",
+                routeMode: data.routeMode,
+                routeSource: data.routeSource,
+                fallbackUsed: true,
+                requestedRoute: data.requestedRoute,
+                ...(data.fallbackRoute ? { actualRoute: data.fallbackRoute } : {}),
+                ...(data.error ? { error: data.error } : {}),
+            });
+        }
+        if (event.type === "odai/route-applied") {
+            return Object.freeze({
+                turn: data.turn,
+                step: data.step,
+                responsibility: data.responsibility,
+                ...(data.responsibilityScopeId ? { responsibilityScopeId: data.responsibilityScopeId } : {}),
+                ...(data.routeCardId ? { routeCardId: data.routeCardId } : {}),
+                status: data.status,
+                routeMode: data.routeMode,
+                routeSource: data.routeSource,
+                fallbackUsed: data.fallbackUsed,
+                requestedRoute: data.requestedRoute,
+                ...(data.actualRoute ? { actualRoute: data.actualRoute } : {}),
+                ...(data.stopReason ? { stopReason: data.stopReason } : {}),
+                ...(data.error ? { error: data.error } : {}),
+            });
+        }
+        if (["odai/route-result", "odai/research-result"].includes(event.type)) {
+            const routeReceiptStatus = data.routeReceiptStatus ?? "unverified";
+            return Object.freeze({
+                turn: data.turn,
+                step: data.step,
+                responsibility: data.role,
+                status: routeReceiptStatus,
+                taskStatus: data.status,
+                routeMode: "child",
+                routeSource: data.routeSource,
+                fallbackUsed: routeReceiptStatus !== "applied",
+                requestedRoute: data.requestedRoute,
+                ...(data.actualRoute ? { actualRoute: data.actualRoute } : {}),
+                ...(data.routeReceiptError ? { error: data.routeReceiptError } : {}),
+                ...(data.stopReason ? { taskStopReason: data.stopReason } : {}),
+                ...(data.error ? { taskError: data.error } : {}),
+            });
+        }
+    }
+    return undefined;
+}
+export function isSubagentSession(agent) {
+    const header = agent.session?.header;
+    return header?.origin === "subagent"
+        || (Number.isSafeInteger(header?.delegationDepth) && (header.delegationDepth ?? 0) > 0);
+}
+export function routedRoleOf(agent) {
+    const events = agent?.session?.events;
+    if (!Array.isArray(events))
+        return undefined;
+    for (let index = events.length - 1; index >= 0; index -= 1) {
+        const event = events[index];
+        if (event?.type !== "subagent/descriptor")
+            continue;
+        const label = event.data?.label;
+        if (typeof label !== "string")
+            return undefined;
+        const match = /^odai-(researcher|planner|executor|reviewer|frontend)(?:$|[\s:])/u.exec(label.trim());
+        return match && ROUTED_ROLES.includes(match[1]) ? match[1] : undefined;
+    }
+    return undefined;
+}
+const ODAI_ADAPTIVE_TOOL_NAMES = new Set([...ODAI_CONTEXTUAL_TOOL_NAMES, ...ODAI_CORE_TOOL_NAMES]);
+export function reconcileAdaptiveToolSchemas(assembly, activeNames, executableSchemas = []) {
+    if (!assembly || !Array.isArray(assembly.tools))
+        return assembly;
+    const active = new Set(activeNames);
+    const executableByName = new Map((Array.isArray(executableSchemas) ? executableSchemas : [])
+        .filter((tool) => active.has(tool?.name))
+        .map((tool) => [tool.name, tool]));
+    const tools = assembly.tools.filter((tool) => !ODAI_ADAPTIVE_TOOL_NAMES.has(tool?.name)
+        || (active.has(tool.name) && executableByName.has(tool.name)));
+    const present = new Set(tools.map((tool) => tool?.name));
+    const missing = activeNames
+        .filter((name) => !present.has(name) && executableByName.has(name))
+        .map((name) => executableByName.get(name));
+    if (missing.length > 0) {
+        const lastAdaptiveIndex = tools.reduce((last, tool, index) => ODAI_ADAPTIVE_TOOL_NAMES.has(tool?.name) ? index : last, -1);
+        tools.splice(lastAdaptiveIndex < 0 ? tools.length : lastAdaptiveIndex + 1, 0, ...missing);
+    }
+    return tools.length === assembly.tools.length && missing.length === 0 ? assembly : { ...assembly, tools };
+}
+//# sourceMappingURL=runtime-support.mjs.map