hoomanjs 1.37.0 → 1.37.2

package/dist/core/agent/turn-steering.js.map

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

package/dist/core/approvals/channel-ask.d.ts

@@ -0,0 +1,27 @@
+import type { Manager as McpManager } from "../mcp/index.js";
+import type { ToolApprovalAsk } from "./intervention.js";
+/** Metadata a channel-driven job (daemon, bot, etc.) stashes on `appState.origin`. */
+export type ChannelOrigin = {
+    server?: string;
+    source?: string;
+    user?: string;
+    session?: string;
+    thread?: string;
+};
+/** Reads the `origin` an {@link McpManager}-backed channel job stashes on `appState`. */
+export declare function readChannelOrigin(rawAgent: {
+    appState: {
+        get(key: string): unknown;
+    };
+}): ChannelOrigin | null;
+/**
+ * Builds a {@link ToolApprovalAsk} that resolves tool approvals over
+ * `hooman/channel/permission` — the remote-approval capability MCP servers
+ * advertise for channel-driven jobs (daemon mode, chat bots, etc.) that have
+ * no local human to prompt. Pair with {@link HoomanToolApprovalIntervention}.
+ *
+ * Requires the job's `appState.origin` to carry the originating channel
+ * server name (see {@link readChannelOrigin}); jobs without one, or servers
+ * that don't support the capability, are rejected.
+ */
+export declare function createChannelPermissionAsk(manager: McpManager): ToolApprovalAsk;

package/dist/core/approvals/channel-ask.js

@@ -0,0 +1,104 @@
+const TOOL_DESCRIPTION_PREVIEW_LIMIT = 50;
+const TOOL_ARGS_PREVIEW_LIMIT = 50;
+function randomRequestId() {
+    return crypto.randomUUID();
+}
+function truncateWithEllipsis(text, max) {
+    return text.length > max ? `${text.slice(0, max)}…` : text;
+}
+function truncateWithHiddenCharCount(text, max) {
+    if (text.length <= max) {
+        return text;
+    }
+    const hidden = text.length - max;
+    return `${text.slice(0, max)}…(${hidden} chars)`;
+}
+function inputPreview(input) {
+    try {
+        const text = JSON.stringify(input) ?? "null";
+        return truncateWithHiddenCharCount(text, TOOL_ARGS_PREVIEW_LIMIT);
+    }
+    catch {
+        return truncateWithHiddenCharCount(String(input), TOOL_ARGS_PREVIEW_LIMIT);
+    }
+}
+/** Reads the `origin` an {@link McpManager}-backed channel job stashes on `appState`. */
+export function readChannelOrigin(rawAgent) {
+    const raw = rawAgent.appState.get("origin");
+    if (!raw || typeof raw !== "object") {
+        return null;
+    }
+    const entry = raw;
+    const text = (value) => {
+        if (typeof value !== "string") {
+            return undefined;
+        }
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : undefined;
+    };
+    return {
+        server: text(entry.server),
+        source: text(entry.source),
+        user: text(entry.user),
+        session: text(entry.session),
+        thread: text(entry.thread),
+    };
+}
+/**
+ * Builds a {@link ToolApprovalAsk} that resolves tool approvals over
+ * `hooman/channel/permission` — the remote-approval capability MCP servers
+ * advertise for channel-driven jobs (daemon mode, chat bots, etc.) that have
+ * no local human to prompt. Pair with {@link HoomanToolApprovalIntervention}.
+ *
+ * Requires the job's `appState.origin` to carry the originating channel
+ * server name (see {@link readChannelOrigin}); jobs without one, or servers
+ * that don't support the capability, are rejected.
+ */
+export function createChannelPermissionAsk(manager) {
+    return async (request, event) => {
+        const origin = readChannelOrigin(event.agent);
+        if (!origin?.server) {
+            return {
+                decision: "reject",
+                reason: `Tool "${request.toolName}" was denied: missing channel origin context.`,
+            };
+        }
+        const supported = await manager.supportsChannelPermission(origin.server);
+        if (!supported) {
+            return {
+                decision: "reject",
+                reason: `Tool "${request.toolName}" was denied: MCP server "${origin.server}" does not support hooman/channel/permission.`,
+            };
+        }
+        try {
+            const behavior = await manager.requestChannelPermission(origin.server, {
+                requestId: randomRequestId(),
+                tool: request.toolName,
+                description: truncateWithEllipsis(request.description?.trim() ??
+                    `Run tool "${request.toolName}" via channel.`, TOOL_DESCRIPTION_PREVIEW_LIMIT),
+                preview: inputPreview(request.input),
+                source: origin.source,
+                user: origin.user,
+                session: origin.session,
+                thread: origin.thread,
+            });
+            if (behavior === "allow_once") {
+                return "allow";
+            }
+            if (behavior === "allow_always") {
+                return "always";
+            }
+            return {
+                decision: "reject",
+                reason: `Tool "${request.toolName}" was rejected by remote approval.`,
+            };
+        }
+        catch (error) {
+            return {
+                decision: "reject",
+                reason: `Tool "${request.toolName}" was denied: failed to request permission (${error instanceof Error ? error.message : String(error)}).`,
+            };
+        }
+    };
+}
+//# sourceMappingURL=channel-ask.js.map

package/dist/core/approvals/channel-ask.js.map

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

package/dist/core/models/reasoning-effort.d.ts

@@ -0,0 +1,55 @@
+import type { Config } from "../config.js";
+/**
+ * Shared reasoning-effort helpers used by both the chat TUI and the ACP agent
+ * so the two front-ends cycle/set/persist effort identically.
+ *
+ * Effort is stored under a provider's `options.reasoning.effort`. Its presence
+ * enables thinking; the level is forwarded where the backend supports it. The
+ * `undefined` rung means "off" (no reasoning), so a single control can also
+ * disable thinking.
+ */
+/**
+ * Ordered effort rungs cycled by the chat Shift+Tab shortcut and `/effort`.
+ * `undefined` is the "off" (no reasoning) rung.
+ */
+export declare const REASONING_EFFORT_CYCLE: readonly [undefined, "minimal", "low", "medium", "high"];
+/** Selectable effort levels (the {@link REASONING_EFFORT_CYCLE} minus "off"). */
+export declare const REASONING_EFFORT_LEVELS: readonly ["minimal", "low", "medium", "high"];
+/** Sentinel value used to represent the "off" rung in pickers/config options. */
+export declare const REASONING_EFFORT_OFF = "off";
+/** Advance one rung through {@link REASONING_EFFORT_CYCLE}, wrapping around. */
+export declare function nextReasoningEffort(current: string | undefined, direction: 1 | -1): string | undefined;
+/**
+ * Returns provider options with `reasoning.effort` set to `nextEffort`,
+ * preserving sibling reasoning keys and collapsing to `undefined` when the
+ * reasoning object would end up empty (so we never persist `"reasoning": {}`).
+ */
+export declare function withReasoningEffort(options: unknown, nextEffort: string | undefined): Record<string, unknown>;
+/** Read `reasoning.effort` out of a provider's raw options object. */
+export declare function readProviderEffort(options: unknown): string | undefined;
+/** The active (default) named LLM, falling back to the first configured one. */
+export declare function activeLlm(config: Config): {
+    name: string;
+    provider: string;
+    options: {
+        model: string;
+        temperature?: number | undefined;
+        maxTokens?: number | undefined;
+    };
+    default: boolean;
+} | undefined;
+/** Provider name backing the active LLM, if any is configured. */
+export declare function activeProviderName(config: Config): string | undefined;
+/**
+ * The effort currently applied to the active model, read from the fully
+ * resolved provider options (so overlay/session values are reflected).
+ */
+export declare function currentReasoningEffort(config: Config): string | undefined;
+/**
+ * Parse a user-typed effort argument. Recognizes the four levels plus a set of
+ * "off" aliases (mapped to `undefined`). Returns `null` for unrecognized input.
+ * Callers should handle the empty-argument case before calling this.
+ */
+export declare function parseReasoningEffortArg(raw: string): {
+    value: string | undefined;
+} | null;

package/dist/core/models/reasoning-effort.js

@@ -0,0 +1,91 @@
+/**
+ * Shared reasoning-effort helpers used by both the chat TUI and the ACP agent
+ * so the two front-ends cycle/set/persist effort identically.
+ *
+ * Effort is stored under a provider's `options.reasoning.effort`. Its presence
+ * enables thinking; the level is forwarded where the backend supports it. The
+ * `undefined` rung means "off" (no reasoning), so a single control can also
+ * disable thinking.
+ */
+/**
+ * Ordered effort rungs cycled by the chat Shift+Tab shortcut and `/effort`.
+ * `undefined` is the "off" (no reasoning) rung.
+ */
+export const REASONING_EFFORT_CYCLE = [
+    undefined,
+    "minimal",
+    "low",
+    "medium",
+    "high",
+];
+/** Selectable effort levels (the {@link REASONING_EFFORT_CYCLE} minus "off"). */
+export const REASONING_EFFORT_LEVELS = [
+    "minimal",
+    "low",
+    "medium",
+    "high",
+];
+/** Sentinel value used to represent the "off" rung in pickers/config options. */
+export const REASONING_EFFORT_OFF = "off";
+/** Advance one rung through {@link REASONING_EFFORT_CYCLE}, wrapping around. */
+export function nextReasoningEffort(current, direction) {
+    const currentIndex = REASONING_EFFORT_CYCLE.indexOf((current ?? undefined));
+    const from = currentIndex === -1 ? 0 : currentIndex;
+    const length = REASONING_EFFORT_CYCLE.length;
+    const nextIndex = (from + direction + length) % length;
+    return REASONING_EFFORT_CYCLE[nextIndex];
+}
+/**
+ * Returns provider options with `reasoning.effort` set to `nextEffort`,
+ * preserving sibling reasoning keys and collapsing to `undefined` when the
+ * reasoning object would end up empty (so we never persist `"reasoning": {}`).
+ */
+export function withReasoningEffort(options, nextEffort) {
+    const base = (options ?? {});
+    const reasoning = base.reasoning;
+    const merged = { ...(reasoning ?? {}), effort: nextEffort };
+    const hasValues = Object.values(merged).some((value) => value !== undefined);
+    return { ...base, reasoning: hasValues ? merged : undefined };
+}
+/** Read `reasoning.effort` out of a provider's raw options object. */
+export function readProviderEffort(options) {
+    const reasoning = options
+        ?.reasoning;
+    return reasoning?.effort;
+}
+/** The active (default) named LLM, falling back to the first configured one. */
+export function activeLlm(config) {
+    return config.llms.find((entry) => entry.default) ?? config.llms[0];
+}
+/** Provider name backing the active LLM, if any is configured. */
+export function activeProviderName(config) {
+    return activeLlm(config)?.provider;
+}
+/**
+ * The effort currently applied to the active model, read from the fully
+ * resolved provider options (so overlay/session values are reflected).
+ */
+export function currentReasoningEffort(config) {
+    const active = activeLlm(config);
+    if (!active) {
+        return undefined;
+    }
+    const resolved = config.resolveLlm(active.name);
+    return readProviderEffort(resolved?.providerOptions);
+}
+/**
+ * Parse a user-typed effort argument. Recognizes the four levels plus a set of
+ * "off" aliases (mapped to `undefined`). Returns `null` for unrecognized input.
+ * Callers should handle the empty-argument case before calling this.
+ */
+export function parseReasoningEffortArg(raw) {
+    const t = raw.trim().toLowerCase();
+    if (["off", "none", "disable", "disabled", "0"].includes(t)) {
+        return { value: undefined };
+    }
+    if (REASONING_EFFORT_LEVELS.includes(t)) {
+        return { value: t };
+    }
+    return null;
+}
+//# sourceMappingURL=reasoning-effort.js.map

package/dist/core/models/reasoning-effort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning-effort.js","sourceRoot":"","sources":["../../../src/core/models/reasoning-effort.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,SAAS;IACT,SAAS;IACT,KAAK;IACL,QAAQ;IACR,MAAM;CACE,CAAC;AAEX,iFAAiF;AACjF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,SAAS;IACT,KAAK;IACL,QAAQ;IACR,MAAM;CACE,CAAC;AAEX,iFAAiF;AACjF,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAE1C,gFAAgF;AAChF,MAAM,UAAU,mBAAmB,CACjC,OAA2B,EAC3B,SAAiB;IAEjB,MAAM,YAAY,GAAG,sBAAsB,CAAC,OAAO,CACjD,CAAC,OAAO,IAAI,SAAS,CAA4C,CAClE,CAAC;IACF,MAAM,IAAI,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IACpD,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,CAAC;IAC7C,MAAM,SAAS,GAAG,CAAC,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;IACvD,OAAO,sBAAsB,CAAC,SAAS,CAAC,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAgB,EAChB,UAA8B;IAE9B,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,CAA4B,CAAC;IACxD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAgD,CAAC;IACxE,MAAM,MAAM,GAAG,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC5D,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IAC7E,OAAO,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;AAChE,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,MAAM,SAAS,GAAI,OAA2D;QAC5E,EAAE,SAAS,CAAC;IACd,OAAO,SAAS,EAAE,MAAM,CAAC;AAC3B,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,OAAO,SAAS,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAc;IACnD,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,kBAAkB,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;AACvD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,GAAW;IAEX,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACnC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAC9B,CAAC;IACD,IAAK,uBAA6C,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACtB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/core/prompts/harness/execution.md

@@ -10,6 +10,7 @@ Use a simple execution loop for non-trivial tasks: understand the request, gathe
 - Batch independent inspections when supported; keep dependent steps sequential.
 - Keep raw output small with scoped reads, bounded searches, and concise command output.
 - If a tool fails, inspect the error and adjust instead of retrying blindly.
+- When a tool result was offloaded to external storage, pass the reference back to the retrieval tool exactly as given — copy the full reference verbatim (including any path and file extension); do not shorten, rename, or reconstruct it.
 - Avoid destructive or broad actions when a focused inspection or edit is enough.
 - Verify important claims with available evidence before presenting them as facts.
 - Final replies should state the outcome, verification performed, and any remaining blocker or risk.

package/dist/core/sessions/tolerant-file-storage.d.ts

@@ -0,0 +1,24 @@
+import { type Storage } from "@strands-agents/sdk/vended-plugins/context-offloader";
+/**
+ * Host-filesystem offload storage that tolerates slightly-mangled references.
+ *
+ * The vended `FileStorage.retrieve` resolves the reference to an exact file
+ * path, so a model that copies the reference imperfectly — most commonly by
+ * dropping the content-type extension (`…_0.json` -> `…_0`) or the directory
+ * prefix — gets an unhelpful "reference not found" even though the artifact is
+ * on disk. This wrapper first tries the exact lookup, then falls back to a
+ * basename / extension-insensitive match within the artifact directory.
+ *
+ * It implements {@link Storage} directly (rather than extending `FileStorage`)
+ * so the `ContextOffloader` treats it as an opaque backend and uses it as-is
+ * (no per-agent sandbox rebinding), keeping retrieval on the host-fs path.
+ */
+export declare class TolerantFileStorage implements Storage {
+    #private;
+    constructor(artifactDir: string);
+    store(key: string, content: Uint8Array, contentType?: string): Promise<string>;
+    retrieve(reference: string): Promise<{
+        content: Uint8Array;
+        contentType: string;
+    }>;
+}

package/dist/core/sessions/tolerant-file-storage.js

@@ -0,0 +1,81 @@
+import { basename, extname, join } from "node:path";
+import { readdir } from "node:fs/promises";
+import { FileStorage, } from "@strands-agents/sdk/vended-plugins/context-offloader";
+/** Sidecar file the vended {@link FileStorage} writes; never a real reference. */
+const METADATA_FILE = ".metadata.json";
+/**
+ * Host-filesystem offload storage that tolerates slightly-mangled references.
+ *
+ * The vended `FileStorage.retrieve` resolves the reference to an exact file
+ * path, so a model that copies the reference imperfectly — most commonly by
+ * dropping the content-type extension (`…_0.json` -> `…_0`) or the directory
+ * prefix — gets an unhelpful "reference not found" even though the artifact is
+ * on disk. This wrapper first tries the exact lookup, then falls back to a
+ * basename / extension-insensitive match within the artifact directory.
+ *
+ * It implements {@link Storage} directly (rather than extending `FileStorage`)
+ * so the `ContextOffloader` treats it as an opaque backend and uses it as-is
+ * (no per-agent sandbox rebinding), keeping retrieval on the host-fs path.
+ */
+export class TolerantFileStorage {
+    #artifactDir;
+    #inner;
+    constructor(artifactDir) {
+        this.#artifactDir = artifactDir;
+        this.#inner = new FileStorage(artifactDir);
+    }
+    store(key, content, contentType) {
+        return this.#inner.store(key, content, contentType);
+    }
+    async retrieve(reference) {
+        try {
+            return await this.#inner.retrieve(reference);
+        }
+        catch (error) {
+            const resolved = await this.#resolveReference(reference);
+            if (resolved && resolved !== reference) {
+                return this.#inner.retrieve(resolved);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Best-effort match of a mangled reference to an on-disk artifact filename.
+     * Returns the resolved filename (relative to the artifact dir) or `null`.
+     */
+    async #resolveReference(reference) {
+        let entries;
+        try {
+            entries = await readdir(this.#artifactDir);
+        }
+        catch {
+            return null;
+        }
+        const candidates = entries.filter((entry) => entry !== METADATA_FILE);
+        const wanted = basename(reference.trim());
+        if (!wanted) {
+            return null;
+        }
+        // Exact filename (reference had the right name but a wrong/absent dir).
+        if (candidates.includes(wanted)) {
+            return join(this.#artifactDir, wanted);
+        }
+        // Extension dropped: match on the filename stem (e.g. `…_0` -> `…_0.json`).
+        const stemMatches = candidates.filter((entry) => stripExt(entry) === wanted);
+        if (stemMatches.length === 1) {
+            return join(this.#artifactDir, stemMatches[0]);
+        }
+        // Reference itself carried an extension the model altered; match by stem.
+        const wantedStem = stripExt(wanted);
+        const bothStemMatches = candidates.filter((entry) => stripExt(entry) === wantedStem);
+        if (bothStemMatches.length === 1) {
+            return join(this.#artifactDir, bothStemMatches[0]);
+        }
+        return null;
+    }
+}
+function stripExt(filename) {
+    const ext = extname(filename);
+    return ext ? filename.slice(0, -ext.length) : filename;
+}
+//# sourceMappingURL=tolerant-file-storage.js.map

package/dist/core/sessions/tolerant-file-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tolerant-file-storage.js","sourceRoot":"","sources":["../../../src/core/sessions/tolerant-file-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EACL,WAAW,GAEZ,MAAM,sDAAsD,CAAC;AAE9D,kFAAkF;AAClF,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAEvC;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,mBAAmB;IACrB,YAAY,CAAS;IACrB,MAAM,CAAc;IAE7B,YAAY,WAAmB;QAC7B,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CACH,GAAW,EACX,OAAmB,EACnB,WAAoB;QAEpB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,SAAiB;QAEjB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;YACzD,IAAI,QAAQ,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACvC,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACxC,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,iBAAiB,CAAC,SAAiB;QACvC,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,aAAa,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QACd,CAAC;QACD,wEAAwE;QACxE,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC;QACD,4EAA4E;QAC5E,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CACnC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,MAAM,CACtC,CAAC;QACF,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,CAAE,CAAC,CAAC;QAClD,CAAC;QACD,0EAA0E;QAC1E,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM,CACvC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,UAAU,CAC1C,CAAC;QACF,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC,CAAE,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,QAAgB;IAChC,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9B,OAAO,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACzD,CAAC"}

package/dist/daemon/approvals.js

@@ -1,96 +1,8 @@
+import { createChannelPermissionAsk } from "../core/approvals/channel-ask.js";
 import { HoomanToolApprovalIntervention } from "../core/approvals/intervention.js";
-const TOOL_DESCRIPTION_PREVIEW_LIMIT = 50;
-const TOOL_ARGS_PREVIEW_LIMIT = 50;
-function randomRequestId() {
-    return crypto.randomUUID();
-}
-function truncateWithEllipsis(text, max) {
-    return text.length > max ? `${text.slice(0, max)}…` : text;
-}
-function truncateWithHiddenCharCount(text, max) {
-    if (text.length <= max) {
-        return text;
-    }
-    const hidden = text.length - max;
-    return `${text.slice(0, max)}…(${hidden} chars)`;
-}
-function inputPreview(input) {
-    try {
-        const text = JSON.stringify(input) ?? "null";
-        return truncateWithHiddenCharCount(text, TOOL_ARGS_PREVIEW_LIMIT);
-    }
-    catch {
-        return truncateWithHiddenCharCount(String(input), TOOL_ARGS_PREVIEW_LIMIT);
-    }
-}
-function readOrigin(rawAgent) {
-    const raw = rawAgent.appState.get("origin");
-    if (!raw || typeof raw !== "object") {
-        return null;
-    }
-    const entry = raw;
-    const text = (value) => {
-        if (typeof value !== "string") {
-            return undefined;
-        }
-        const trimmed = value.trim();
-        return trimmed.length > 0 ? trimmed : undefined;
-    };
-    return {
-        server: text(entry.server),
-        source: text(entry.source),
-        user: text(entry.user),
-        session: text(entry.session),
-        thread: text(entry.thread),
-    };
-}
 export function createDaemonApprovalIntervention(manager) {
     return new HoomanToolApprovalIntervention({
-        ask: async (request, event) => {
-            const origin = readOrigin(event.agent);
-            if (!origin?.server) {
-                return {
-                    decision: "reject",
-                    reason: `Tool "${request.toolName}" was denied: missing daemon origin context.`,
-                };
-            }
-            const supported = await manager.supportsChannelPermission(origin.server);
-            if (!supported) {
-                return {
-                    decision: "reject",
-                    reason: `Tool "${request.toolName}" was denied: MCP server "${origin.server}" does not support hooman/channel/permission.`,
-                };
-            }
-            try {
-                const behavior = await manager.requestChannelPermission(origin.server, {
-                    requestId: randomRequestId(),
-                    tool: request.toolName,
-                    description: truncateWithEllipsis(request.description?.trim() ??
-                        `Run tool "${request.toolName}" in daemon mode.`, TOOL_DESCRIPTION_PREVIEW_LIMIT),
-                    preview: inputPreview(request.input),
-                    source: origin.source,
-                    user: origin.user,
-                    session: origin.session,
-                    thread: origin.thread,
-                });
-                if (behavior === "allow_once") {
-                    return "allow";
-                }
-                if (behavior === "allow_always") {
-                    return "always";
-                }
-                return {
-                    decision: "reject",
-                    reason: `Tool "${request.toolName}" was rejected by remote approval.`,
-                };
-            }
-            catch (error) {
-                return {
-                    decision: "reject",
-                    reason: `Tool "${request.toolName}" was denied: failed to request permission (${error instanceof Error ? error.message : String(error)}).`,
-                };
-            }
-        },
+        ask: createChannelPermissionAsk(manager),
     });
 }
 //# sourceMappingURL=approvals.js.map

package/dist/daemon/approvals.js.map

@@ -1 +1 @@
-{"version":3,"file":"approvals.js","sourceRoot":"","sources":["../../src/daemon/approvals.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"approvals.js","sourceRoot":"","sources":["../../src/daemon/approvals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AAGnF,MAAM,UAAU,gCAAgC,CAAC,OAAmB;IAClE,OAAO,IAAI,8BAA8B,CAAC;QACxC,GAAG,EAAE,0BAA0B,CAAC,OAAO,CAAC;KACzC,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -1,7 +1,9 @@
 export { bootstrap } from "./core/index.js";
 export type { AcpMeta, BootstrapMeta, BootstrapMode } from "./core/index.js";
 export { Config as HoomanConfig, LlmProvider } from "./core/config.js";
-export type { CompactionConfig, ConfigData, LlmConfig, NamedLlmConfig, NamedProviderConfig, PromptsConfig, ProviderConfig, ResolvedNamedLlmConfig, SearchConfig, ToolsConfig, } from "./core/config.js";
+export type { CompactionConfig, ConfigData, ConfigOptions, LlmConfig, NamedLlmConfig, NamedProviderConfig, PromptsConfig, ProviderConfig, ResolvedNamedLlmConfig, SearchConfig, ToolsConfig, } from "./core/config.js";
+export { createRuntimeConfig, createRuntimeMcpConfig, runtimeConfigOptions, runtimeConfigSources, } from "./core/runtime-config.js";
+export type { RuntimeConfigSources } from "./core/runtime-config.js";
 export { attachmentsPath, basePath, configJsonPath, instructionsMdPath, mcpJsonPath, mcpOauthJsonPath, sessionsPath, skillsPath, } from "./core/utils/paths.js";
 export { openBrowser } from "./core/utils/browser.js";
 export { attachmentDiagnosticBlock, attachmentPathsToPromptBlocks, normalizeAttachmentPaths, readAttachmentAsBlocksOrBase64, } from "./core/utils/attachments.js";
@@ -9,8 +11,10 @@ export type { AttachmentBinaryFallback, AttachmentMediaBlocks, AttachmentReadRes
 export { detectDocumentFormat, detectImageFormat, detectVideoFormat, } from "./core/utils/file-formats.js";
 export { getCwd, runWithCwd } from "./core/utils/cwd-context.js";
 export { isResolvedPathInsideDir, normalizeUserPath, } from "./core/utils/normalize-user-path.js";
+export { candidateWalkUpPaths, discoverWalkUpFiles, findGitRoot, } from "./core/utils/discover-files.js";
 export { create as createAgent } from "./core/agent/index.js";
 export { applySessionMode } from "./core/agent/sync-tool-registry-mode.js";
+export { ModeAwareToolRegistry } from "./core/agent/mode-aware-tool-registry.js";
 export { HOOMAN_CHANNEL, HOOMAN_CHANNEL_PERMISSION, Manager as McpManager, createMcpConfig, createMcpManager, createMcpOAuthService, createMcpOAuthStore, } from "./core/mcp/index.js";
 export type { ChannelMessage, ChannelPermissionBehavior, ChannelSubscription, ChannelSubscriptionHandle, NamedMcpTransport, ServerAuthStatus, } from "./core/mcp/index.js";
 export { Config as McpConfig, type McpServersFile } from "./core/mcp/config.js";
@@ -21,6 +25,8 @@ export type { McpTransport, Sse, Stdio, StreamableHttp, } from "./core/mcp/types
 export { PrefixedMcpTool } from "./core/mcp/prefixed-mcp-tool.js";
 export { createByeTools, createFetchTools, createFilesystemTools, createGrepTools, createShellTools, createSleepTools, createThinkingTools, createTimeTools, createTodoTools, createWebSearchTools, } from "./core/tools/index.js";
 export { UPDATE_TODOS_TOOL_NAME } from "./core/tools/todo.js";
+export { getTerminalBackend, setTerminalBackend, type TerminalBackend, type TerminalRunRequest, type TerminalRunResult, } from "./core/tools/terminal-backend.js";
+export { getTextFsBackend, setTextFsBackend, type TextFsBackend, type TextFsReadOptions, } from "./core/tools/text-fs-backend.js";
 export { AGENT_SKILLS_STATE_KEY, Registry as SkillsRegistry, builtInSkillsPath, clearAgentSkillsPromptInjectionState, createAgentSkillsPlugin, createAgentSkillSources, createSkillsRegistry, } from "./core/skills/index.js";
 export type { SkillListEntry, SkillSearchResult, } from "./core/skills/registry.js";
 export { System as SystemPrompt, system as createSystemPrompt, } from "./core/prompts/index.js";
@@ -43,13 +49,22 @@ export { StrandsOllamaModel, type OllamaModelConfig, } from "./core/models/ollam
 export { createContext } from "./core/agent/index.js";
 export { FlatFileStorage } from "./core/sessions/flat-file-storage.js";
 export { LazySessionManager, type LazySessionManagerConfig, } from "./core/sessions/lazy-session-manager.js";
+export { TolerantFileStorage } from "./core/sessions/tolerant-file-storage.js";
+export { latestCliSessionForCwd, listCliSessions, type CliSessionSummary, } from "./core/sessions/list-cli-sessions.js";
 export { SUBAGENT_TOOL_NAME_PREFIX, createSubagentTools, loadSubagentRegistry, } from "./core/subagents/index.js";
 export type { SubagentKindConfig, SubagentKindDefinition, SubagentRegistry, } from "./core/subagents/index.js";
 export { EXIT_REQUESTED_CODE, EXIT_REQUESTED_STATE_KEY, consumeExitRequest, isExitRequested, requestExit, } from "./core/state/exit-request.js";
-export { INTERNAL_ALWAYS_ALLOWED as TOOL_APPROVAL_INTERNAL_ALWAYS_ALLOWED, isImplicitlyAllowed, planModeWriteEditRejectionMessage, } from "./core/state/tool-approvals.js";
+export { INTERNAL_ALWAYS_ALLOWED as TOOL_APPROVAL_INTERNAL_ALWAYS_ALLOWED, isImplicitlyAllowed, isToolVisible, planModeWriteEditRejectionMessage, } from "./core/state/tool-approvals.js";
 export { Allowlist, getAllowlist, type AllowlistOptions, type AllowlistRule, } from "./core/approvals/allowlist.js";
+export { arityPrefix, splitCommands, tokenize, } from "./core/approvals/bash-arity.js";
+export { matchWildcard } from "./core/approvals/wildcard.js";
+export { HoomanToolApprovalIntervention, type HoomanToolApprovalInterventionConfig, type ToolApprovalAsk, type ToolApprovalDecision, type ToolApprovalRequest, type ToolApprovalResult, } from "./core/approvals/intervention.js";
+export { createChannelPermissionAsk, readChannelOrigin, type ChannelOrigin as ToolApprovalChannelOrigin, } from "./core/approvals/channel-ask.js";
+export { ChatTurnSteeringController, ChatTurnSteeringIntervention, createChatTurnSteeringIntervention, type QueuedSteeringPrompt, } from "./core/agent/turn-steering.js";
 export { YOLO_STATE_KEY, isYoloEnabled, setYoloEnabled, } from "./core/state/yolo.js";
 export { MODE_STATE_KEY, getModeState, setSessionMode, type SessionMode, } from "./core/state/session-mode.js";
+export { DEFAULT_SESSION_MODE, MODE_DEFINITIONS, MODE_IDS, formatModeNames, getModeDefinition, getModeIds, getModeOptions, getModeTools, isKnownSessionMode, isModeDefinition, loadModeDefinitions, type KnownSessionMode, type ModeDefinition, } from "./core/modes/index.js";
+export type { LoadedModeDefinition } from "./core/modes/registry.js";
 export { TODO_ITEMS_STATE_KEY, TODO_VISIBLE_STATE_KEY, TodoItemSchema, TodoStatusSchema, clearTodoState, getTodoViewState, setTodoState, summarizeTodos, } from "./core/state/todos.js";
 export type { TodoItem, TodoStatus, TodoViewState, } from "./core/state/todos.js";
 export { readThinkingState, writeThinkingState, } from "./core/state/thought-process.js";