@mono-agent/agent-app 0.6.2 → 0.9.0

package/dist/recipes/types.js

@@ -0,0 +1,15 @@
+/** Resolve declared input defaults, then layer CLI overrides on top. */
+export function resolveRecipeInputs(recipe, overrides = {}) {
+    const values = {};
+    for (const input of recipe.inputs) {
+        values[input.id] = overrides[input.id] ?? input.default;
+    }
+    // Preserve overrides that don't correspond to a declared input (forward-compat).
+    for (const [key, value] of Object.entries(overrides)) {
+        if (!(key in values)) {
+            values[key] = value;
+        }
+    }
+    return values;
+}
+//# sourceMappingURL=types.js.map

package/dist/recipes/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/recipes/types.ts"],"names":[],"mappings":"AA0EA,wEAAwE;AACxE,MAAM,UAAU,mBAAmB,CACjC,MAAmB,EACnB,YAA+B,EAAE;IAEjC,MAAM,MAAM,GAAuC,EAAE,CAAC;IACtD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC;IAC1D,CAAC;IACD,iFAAiF;IACjF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,EAAE,CAAC;YACrB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/request-model-override.d.ts

@@ -1,4 +1,4 @@
-import type { LocalProviderDefinition, LocalProviderRuntimeOptions, RuntimeModelReference } from "@mono-agent/runtime-adapter";
+import type { LocalProviderDefinition, LocalProviderRuntimeOptions, RuntimeModelReference, SandboxPolicy } from "@mono-agent/runtime-adapter";
 /**
  * Per-request runtime-options extension that applies a per-turn model/effort
  * override carried on webhook (`metadata.webhook`), cron (`metadata.cron`), or
@@ -10,6 +10,15 @@ import type { LocalProviderDefinition, LocalProviderRuntimeOptions, RuntimeModel
  * harness default) rather than failing — a bad dynamic webhook `model` must not
  * 500 the request.
  *
+ * The extension ALSO scans every turn's message text for effort trigger
+ * phrases ("think"/"extra think"/"ultra think") and escalates the turn's
+ * effort — see `applyEffortKeywordEscalation`. This lives here rather than in
+ * a sibling extension because siblings compose later-wins in parallel: only
+ * this extension knows the metadata effort the keyword must be compared
+ * against (escalation-only), and it already owns the direct-OpenCode guard.
+ * Effort-only writes keep the shared session (the harness isolates on MODEL
+ * overrides only).
+ *
  * Execution mode is NOT set here: the harness derives it from the effective model
  * plus the host's configured executionMode (keeping a compatible host mode, e.g.
  * claude in `cli`, and only falling back to the model default for an incompatible
@@ -35,9 +44,33 @@ import type { LocalProviderDefinition, LocalProviderRuntimeOptions, RuntimeModel
  */
 export interface RequestModelOverrideLogger {
     warn?(message: string, metadata?: Record<string, unknown>): void;
+    info?(message: string, metadata?: Record<string, unknown>): void;
 }
 export interface RequestModelOverrideOptions {
     readonly logger?: RequestModelOverrideLogger;
+    /** Host primary used to prevent unsafe direct-Codex ↔ non-Codex family changes. */
+    readonly baseModel?: RuntimeModelReference;
+    /** Host fallback chain retained behind a request-level primary override. */
+    readonly fallbackModels?: readonly RuntimeModelReference[];
+    /** Host effort inherited by model-only overrides unless the override supplies one. */
+    readonly baseEffort?: string;
+    /** Host hard turn cap inherited by request-level model overrides. */
+    readonly baseMaxTurns?: number;
+    /** Effective configured/auto-provisioned MCP sources inherited by the turn. */
+    readonly mcpSources?: readonly string[];
+    /** Whether progressive index disclosure would inject runtime skill metadata. */
+    readonly indexSkillsActive?: boolean;
+    /**
+     * Host mono-agent sandbox policy. Claude and direct OpenCode provider-owned
+     * tool loops do not consume this policy, so a request cannot dynamically
+     * switch to either runtime while a non-off policy is active.
+     */
+    readonly sandboxPolicy?: Pick<SandboxPolicy, "mode">;
+    /** Effective host tool policy used to reject direct OpenCode overrides it cannot enforce. */
+    readonly toolPolicy?: {
+        readonly allowedTools: readonly string[];
+        readonly disallowedTools: readonly string[];
+    };
     /**
      * Configured local providers (`config.providers?.local`). When an override
      * names a model one of these serves, the extension recomputes the provider
@@ -49,6 +82,7 @@ export interface RequestModelOverrideOptions {
 interface RequestModelOverrideInput {
     readonly request: {
         readonly metadata?: Record<string, unknown>;
+        readonly userMessage?: string;
     };
 }
 interface RequestModelOverrideResult {
@@ -63,5 +97,13 @@ interface RequestModelOverrideResult {
     readonly cleanup: () => Promise<void>;
 }
 export declare function createRequestModelOverrideRuntimeExtension(options?: RequestModelOverrideOptions): (input: RequestModelOverrideInput) => Promise<RequestModelOverrideResult>;
+/**
+ * Whether the request-level override will actually switch this turn to direct
+ * OpenCode under the supplied host constraints. Adapter MCP injection uses the
+ * same decision as the model extension: a merely parseable OpenCode string is
+ * not enough, because a sandbox/tool/MCP/effort/turn-cap rejection must retain
+ * both the Pi model and its interaction tools.
+ */
+export declare function requestModelOverrideTargetsDirectOpenCode(metadata: Record<string, unknown> | undefined, options?: RequestModelOverrideOptions): boolean;
 export {};
 //# sourceMappingURL=request-model-override.d.ts.map

package/dist/request-model-override.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-model-override.d.ts","sourceRoot":"","sources":["../src/request-model-override.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,uBAAuB,EACvB,2BAA2B,EAC3B,qBAAqB,EACtB,MAAM,6BAA6B,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAClE;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,0BAA0B,CAAC;IAC7C;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;CAC9D;AAED,UAAU,yBAAyB;IACjC,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CACnE;AAED,UAAU,0BAA0B;IAClC,QAAQ,CAAC,cAAc,EAAE;QACvB,KAAK,CAAC,EAAE,qBAAqB,CAAC;QAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;QAIhB,cAAc,CAAC,EAAE,2BAA2B,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;QACtE,WAAW,CAAC,EAAE,2BAA2B,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;QAChE,iBAAiB,CAAC,EAAE,2BAA2B,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAAC;QAC5E,iBAAiB,CAAC,EAAE,2BAA2B,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAAC;KAC7E,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAID,wBAAgB,0CAA0C,CACxD,OAAO,CAAC,EAAE,2BAA2B,GACpC,CAAC,KAAK,EAAE,yBAAyB,KAAK,OAAO,CAAC,0BAA0B,CAAC,CAoC3E"}
+{"version":3,"file":"request-model-override.d.ts","sourceRoot":"","sources":["../src/request-model-override.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,uBAAuB,EACvB,2BAA2B,EAC3B,qBAAqB,EACrB,aAAa,EACd,MAAM,6BAA6B,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACjE,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAClE;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,0BAA0B,CAAC;IAC7C,mFAAmF;IACnF,QAAQ,CAAC,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAC3C,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC3D,sFAAsF;IACtF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,qEAAqE;IACrE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,+EAA+E;IAC/E,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,gFAAgF;IAChF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACrD,6FAA6F;IAC7F,QAAQ,CAAC,UAAU,CAAC,EAAE;QACpB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;QACzC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;KAC7C,CAAC;IACF;;;;;OAKG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;CAC9D;AAED,UAAU,yBAAyB;IACjC,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;CACH;AAED,UAAU,0BAA0B;IAClC,QAAQ,CAAC,cAAc,EAAE;QACvB,KAAK,CAAC,EAAE,qBAAqB,CAAC;QAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;QAIhB,cAAc,CAAC,EAAE,2BAA2B,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;QACtE,WAAW,CAAC,EAAE,2BAA2B,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;QAChE,iBAAiB,CAAC,EAAE,2BAA2B,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAAC;QAC5E,iBAAiB,CAAC,EAAE,2BAA2B,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAAC;KAC7E,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAID,wBAAgB,0CAA0C,CACxD,OAAO,CAAC,EAAE,2BAA2B,GACpC,CAAC,KAAK,EAAE,yBAAyB,KAAK,OAAO,CAAC,0BAA0B,CAAC,CAoD3E;AAiDD;;;;;;GAMG;AACH,wBAAgB,yCAAyC,CACvD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC7C,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAET"}

package/dist/request-model-override.js

@@ -1,31 +1,35 @@
-import { EFFORT_LEVELS } from "@mono-agent/config";
+import { detectEffortKeyword, EFFORT_LEVELS, effortRank } from "@mono-agent/config";
 import { parseMonoRuntimeModelReference, runtimeOptionsForLocalProvider } from "@mono-agent/runtime-adapter";
 const EFFORT_SET = new Set(EFFORT_LEVELS);
 export function createRequestModelOverrideRuntimeExtension(options) {
     const logger = options?.logger;
     const localProviders = options?.localProviders;
+    const baseModel = options?.baseModel;
+    const fallbackModels = options?.fallbackModels ?? [];
     return async (input) => {
-        const { model: rawModel, effort: rawEffort } = readOverride(input.request.metadata);
+        const { rawModel, rawEffort, model } = resolveAcceptedModelOverride(input.request.metadata, options, logger);
         const runtimeOptions = {};
-        if (rawModel !== undefined) {
-            let parsed;
-            try {
-                parsed = parseMonoRuntimeModelReference(rawModel);
-            }
-            catch (error) {
-                logger?.warn?.("Ignoring invalid per-request model override.", {
-                    model: rawModel,
-                    reason: error instanceof Error ? error.message : String(error),
-                });
-            }
-            if (parsed !== undefined) {
-                runtimeOptions.model = parsed;
-                applyLocalProviderBlock(runtimeOptions, parsed, rawModel, localProviders, logger);
-            }
+        const effectiveModelForEffort = model ?? baseModel;
+        // Shared by the metadata effort override AND keyword escalation below: any
+        // direct OpenCode model in the resulting chain means no run-level effort.
+        const directOpenCodeModels = [effectiveModelForEffort, ...fallbackModels]
+            .filter((entry) => entry?.sdk === "opencode");
+        if (model !== undefined && rawModel !== undefined) {
+            runtimeOptions.model = model;
+            applyLocalProviderBlock(runtimeOptions, model, rawModel, localProviders, logger);
         }
         if (rawEffort !== undefined) {
             if (EFFORT_SET.has(rawEffort)) {
-                runtimeOptions.effort = rawEffort;
+                if (directOpenCodeModels.length > 0) {
+                    logger?.warn?.("Ignoring per-request effort override for direct OpenCode anywhere in the resulting model chain.", {
+                        effort: rawEffort,
+                        reason: "The direct OpenCode SDK does not expose runtime effort control.",
+                        directOpenCodeModels: directOpenCodeModels.map(runtimeModelReferenceLabel),
+                    });
+                }
+                else {
+                    runtimeOptions.effort = rawEffort;
+                }
             }
             else {
                 logger?.warn?.("Ignoring invalid per-request effort override.", {
@@ -34,9 +38,164 @@ export function createRequestModelOverrideRuntimeExtension(options) {
                 });
             }
         }
+        applyEffortKeywordEscalation(runtimeOptions, input.request.userMessage, options?.baseEffort, directOpenCodeModels, logger);
         return { runtimeOptions, cleanup: async () => { } };
     };
 }
+/**
+ * Always-on background escalation: a trigger phrase in the turn's message text
+ * ("think" → high, "extra think" → xhigh, "ultra think" → max) RAISES this
+ * turn's effort, never lowers it. The baseline is the effort the turn would
+ * otherwise run at — an accepted metadata override, else the host default — so
+ * a webhook `effort:"max"` survives a bare "think" and an equal-or-lower
+ * keyword writes nothing (no spurious `run_config.overridden`). Direct
+ * OpenCode anywhere in the effective chain skips escalation (same reason as
+ * the metadata effort guard above: the SDK has no runtime effort control), and
+ * the warn fires only when the keyword would actually have escalated. The
+ * message text itself is never mutated — trigger words reach the model.
+ */
+function applyEffortKeywordEscalation(runtimeOptions, userMessage, baseEffort, directOpenCodeModels, logger) {
+    if (typeof userMessage !== "string" || userMessage.length === 0) {
+        return;
+    }
+    const match = detectEffortKeyword(userMessage);
+    if (match === undefined) {
+        return;
+    }
+    const resolvedEffort = runtimeOptions.effort ?? baseEffort;
+    if (effortRank(match.effort) <= effortRank(resolvedEffort)) {
+        return;
+    }
+    if (directOpenCodeModels.length > 0) {
+        logger?.warn?.("Skipping keyword effort escalation for direct OpenCode anywhere in the resulting model chain.", {
+            keyword: match.keyword,
+            effort: match.effort,
+            reason: "The direct OpenCode SDK does not expose runtime effort control.",
+            directOpenCodeModels: directOpenCodeModels.map(runtimeModelReferenceLabel),
+        });
+        return;
+    }
+    runtimeOptions.effort = match.effort;
+    logger?.info?.("Escalating per-turn effort from message keyword.", {
+        keyword: match.keyword,
+        from: resolvedEffort ?? null,
+        to: match.effort,
+    });
+}
+/**
+ * Whether the request-level override will actually switch this turn to direct
+ * OpenCode under the supplied host constraints. Adapter MCP injection uses the
+ * same decision as the model extension: a merely parseable OpenCode string is
+ * not enough, because a sandbox/tool/MCP/effort/turn-cap rejection must retain
+ * both the Pi model and its interaction tools.
+ */
+export function requestModelOverrideTargetsDirectOpenCode(metadata, options) {
+    return resolveAcceptedModelOverride(metadata, options, undefined).model?.sdk === "opencode";
+}
+function resolveAcceptedModelOverride(metadata, options, logger) {
+    const { model: rawModel, effort: rawEffort } = readOverride(metadata);
+    if (rawModel === undefined) {
+        return { ...(rawEffort === undefined ? {} : { rawEffort }) };
+    }
+    let parsed;
+    try {
+        parsed = parseMonoRuntimeModelReference(rawModel);
+    }
+    catch (error) {
+        logger?.warn?.("Ignoring invalid per-request model override.", {
+            model: rawModel,
+            reason: error instanceof Error ? error.message : String(error),
+        });
+        return { rawModel, ...(rawEffort === undefined ? {} : { rawEffort }) };
+    }
+    const baseModel = options?.baseModel;
+    const baseEffort = options?.baseEffort;
+    const baseMaxTurns = options?.baseMaxTurns;
+    const mcpSources = options?.mcpSources ?? [];
+    const sandboxPolicy = options?.sandboxPolicy;
+    const toolPolicy = options?.toolPolicy;
+    const sandboxBypassRuntime = monoSandboxBypassRuntime(parsed);
+    const directOpenCodeWouldReceiveEffort = parsed.sdk === "opencode"
+        && (baseEffort !== undefined || (rawEffort !== undefined && EFFORT_SET.has(rawEffort)));
+    const directOpenCodeWouldReceiveTurnCap = parsed.sdk === "opencode"
+        && Number.isFinite(Number(baseMaxTurns))
+        && Number(baseMaxTurns) > 0;
+    const directOpenCodeWouldReceiveMcp = parsed.sdk === "opencode" && mcpSources.length > 0;
+    const directOpenCodeWouldReceiveIndexSkills = parsed.sdk === "opencode" && options?.indexSkillsActive === true;
+    if (baseModel !== undefined && isDirectCodex(parsed) !== isDirectCodex(baseModel)) {
+        logger?.warn?.("Ignoring per-request model override across the direct-Codex runtime boundary.", {
+            model: rawModel,
+            baseModel: baseModel.reference ?? `${baseModel.sdk}:${baseModel.model}`,
+            reason: "Direct Codex and non-Codex runtimes use different tool and sandbox contracts.",
+        });
+    }
+    else if (sandboxBypassRuntime !== undefined && sandboxPolicy?.mode !== undefined && sandboxPolicy.mode !== "off") {
+        logger?.warn?.(`Ignoring per-request ${sandboxBypassRuntime} model override while the mono-agent sandbox is active.`, {
+            model: rawModel,
+            sandboxMode: sandboxPolicy.mode,
+            reason: `${sandboxBypassRuntime}'s provider-owned tool loop does not consume the mono-agent sandbox policy.`,
+        });
+    }
+    else if (parsed.sdk === "opencode" && toolPolicy !== undefined && !isExactAllowAllToolPolicy(toolPolicy)) {
+        logger?.warn?.("Ignoring per-request direct OpenCode model override under a restrictive tool policy.", {
+            model: rawModel,
+            reason: "Direct OpenCode does not consume mono-agent allowedTools/disallowedTools.",
+        });
+    }
+    else if (directOpenCodeWouldReceiveMcp) {
+        logger?.warn?.("Ignoring per-request direct OpenCode model override because MCP runtime options are unsupported.", {
+            model: rawModel,
+            mcpSources,
+            reason: "Direct OpenCode cannot safely receive configured or auto-provisioned MCP servers.",
+        });
+    }
+    else if (directOpenCodeWouldReceiveIndexSkills) {
+        logger?.warn?.("Ignoring per-request direct OpenCode model override because index skill disclosure is unsupported.", {
+            model: rawModel,
+            reason: "Direct OpenCode disables runtime/external skills; use full disclosure or a Pi runtime.",
+        });
+    }
+    else if (directOpenCodeWouldReceiveEffort) {
+        logger?.warn?.("Ignoring per-request direct OpenCode model override because runtime effort is unsupported.", {
+            model: rawModel,
+            ...(baseEffort === undefined ? {} : { baseEffort }),
+            ...(rawEffort === undefined || !EFFORT_SET.has(rawEffort) ? {} : { requestedEffort: rawEffort }),
+        });
+    }
+    else if (directOpenCodeWouldReceiveTurnCap) {
+        logger?.warn?.("Ignoring per-request direct OpenCode model override because runtime.maxTurns is unsupported.", {
+            model: rawModel,
+            baseMaxTurns,
+            reason: "Direct OpenCode does not expose an enforceable hard turn cap.",
+        });
+    }
+    else {
+        return {
+            rawModel,
+            ...(rawEffort === undefined ? {} : { rawEffort }),
+            model: parsed,
+        };
+    }
+    return { rawModel, ...(rawEffort === undefined ? {} : { rawEffort }) };
+}
+function isDirectCodex(model) {
+    return model.sdk === "codex";
+}
+function runtimeModelReferenceLabel(model) {
+    return model.reference ?? `${model.sdk}:${model.provider === undefined ? "" : `${model.provider}:`}${model.model}`;
+}
+function monoSandboxBypassRuntime(model) {
+    if (model.sdk === "claude")
+        return "Claude";
+    if (model.sdk === "opencode")
+        return "direct OpenCode";
+    return undefined;
+}
+function isExactAllowAllToolPolicy(policy) {
+    return policy.allowedTools.length === 1
+        && policy.allowedTools[0] === "*"
+        && policy.disallowedTools.length === 0;
+}
 /**
  * OWN the endpoint block for a valid model override. For a model served by a
  * configured LOCAL provider, `runtimeOptionsForLocalProvider` yields the block and
@@ -69,7 +228,7 @@ function applyLocalProviderBlock(runtimeOptions, model, rawModel, localProviders
  * Read model/effort from webhook, cron, or TUI request metadata. Webhook takes
  * precedence, then cron, then an interactive TUI per-session override — a turn
  * is only ever one of the three. A turn carrying none of these blocks (e.g. an
- * ordinary chat turn) returns `{}` and the extension is a no-op.
+ * ordinary chat turn) returns `{}`, leaving only the keyword escalation scan.
  */
 function readOverride(metadata) {
     if (!isRecord(metadata)) {

package/dist/request-model-override.js.map

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

package/dist/run-history.d.ts

@@ -0,0 +1,32 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ToolPolicyInput } from "@mono-agent/agent-harness";
+import type { RuntimeOptionsExtension } from "./runtime-option-extensions.js";
+export declare const RUN_HISTORY_MCP_SERVER_NAME = "mono-agent-run-history";
+export declare const RUN_HISTORY_TOOL_NAME = "RunHistory";
+export interface RunHistoryBinding {
+    readonly artifactDir: string;
+    /** Exact, already-bucketed conversation id for the active request. */
+    readonly conversationId: string;
+    /** Run id for the active request. It is never listable or inspectable. */
+    readonly runId: string;
+}
+export interface RunHistoryRuntimeExtensionOptions {
+    readonly artifactDir: string;
+    /** Best-effort diagnostic when the loopback MCP endpoint cannot start. */
+    readonly onUnavailable?: (error: unknown) => void;
+}
+export interface RunHistoryRuntimeExtension {
+    readonly runtimeOptions: {
+        readonly mcpServers: Record<string, unknown>;
+    };
+    readonly cleanup: () => Promise<void>;
+}
+type RunHistoryToolPolicy = Pick<ToolPolicyInput, "allowedTools" | "disallowedTools">;
+/** Resolve the canonical, legacy, MCP-prefixed, and server-wildcard policy spellings. */
+export declare function isRunHistoryToolAllowed(policy: RunHistoryToolPolicy | undefined): boolean;
+/** Build a read-only RunHistory server bound to one exact conversation bucket and active run. */
+export declare function createRunHistoryServer(binding: RunHistoryBinding): McpServer;
+/** Create a per-request loopback MCP endpoint bound to the harness's bucketed conversation id. */
+export declare function createRunHistoryRuntimeExtension(options: RunHistoryRuntimeExtensionOptions): RuntimeOptionsExtension;
+export {};
+//# sourceMappingURL=run-history.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run-history.d.ts","sourceRoot":"","sources":["../src/run-history.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAWjE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAE9E,eAAO,MAAM,2BAA2B,2BAA2B,CAAC;AACpE,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAiDlD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,cAAc,EAAE;QACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC9C,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,KAAK,oBAAoB,GAAG,IAAI,CAAC,eAAe,EAAE,cAAc,GAAG,iBAAiB,CAAC,CAAC;AAEtF,yFAAyF;AACzF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,oBAAoB,GAAG,SAAS,GAAG,OAAO,CAOzF;AAED,iGAAiG;AACjG,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,CAc5E;AAED,kGAAkG;AAClG,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,iCAAiC,GACzC,uBAAuB,CA2EzB"}