hoomanjs 1.36.0 → 1.37.1

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":"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"}