jeopi-cli 16.4.1 → 16.4.3

package/dist/types/advisor/config.d.ts

@@ -3,9 +3,10 @@
  * with an optional `:level` thinking suffix (e.g. `x-ai/grok-code-fast:high`),
  * resolved exactly like any other model override; `tools` is a subset of
  * `BUILTIN_TOOL_NAMES` — any built-in name, including mutating tools such as
- * `edit`/`write`/`bash` (the advisor is a full agent). Omitted or empty falls
- * back to the default `read`/`grep`/`glob` subset. `instructions` is the
- * advisor's specialization, appended to the shared baseline.
+ * `edit`/`write`/`bash` (the advisor is a full agent). Omitted falls back to
+ * the default `read`/`grep`/`glob` subset; an explicit empty list grants no
+ * tools. `instructions` is the advisor's specialization, appended to the shared
+ * baseline.
  */
 export interface AdvisorConfig {
     name: string;

package/dist/types/cli/args.d.ts

@@ -76,5 +76,7 @@ export declare function parseArgs(inputArgs: string[], extensionFlags?: Map<stri
  * process (issue #2459).
  */
 export declare function reportUnrecognizedFlags(args: Pick<Args, "unrecognizedFlags">, write?: (text: string) => void): boolean;
+/** Emit a clean CLI usage error without an internal stack trace. */
+export declare function reportCliUsageError(error: unknown, write?: (text: string) => void): boolean;
 export declare function getExtraHelpText(): string;
 export declare function printHelp(): void;

package/dist/types/cli/update-cli.d.ts

@@ -42,11 +42,12 @@ export declare function parseUpdateArgs(args: string[]): {
     force: boolean;
     check: boolean;
 } | undefined;
-type UpdateMethod = "brew" | "mise" | "bun" | "binary";
+type UpdateMethod = "brew" | "mise" | "bun" | "npm" | "binary";
 interface UpdateMethodResolutionOptions {
     homebrewPrefix?: string;
     miseBinDirs?: readonly string[];
     miseDataDir?: string;
+    npmBinDir?: string;
 }
 export declare function resolveUpdateMethodForTest(jeopiPath: string, bunBinDir: string | undefined, options?: UpdateMethodResolutionOptions): UpdateMethod;
 /**
@@ -162,6 +163,8 @@ export declare function replaceBinaryForUpdate(options: BinaryReplacementOptions
  * See #1824.
  */
 export declare function buildBunInstallArgs(expectedVersion: string, nativeTag?: string): string[];
+/** Build the npm argv used to update npm-managed global installs. */
+export declare function buildNpmInstallArgs(expectedVersion: string, nativeTag?: string): string[];
 export declare function buildHomebrewUpdateArgs(force: boolean): string[];
 export declare function buildMiseUpgradeArgs(): string[];
 export declare function buildMiseForceInstallArgs(expectedVersion: string): string[];

package/dist/types/cli/usage-error.d.ts

@@ -0,0 +1,4 @@
+/** Command-line input error that should be rendered without a stack trace. */
+export declare class CliUsageError extends Error {
+    constructor(message: string);
+}

package/dist/types/commit/agentic/agent.d.ts

@@ -20,6 +20,7 @@ export interface CommitAgentInput {
     requireChangelog: boolean;
     diffText?: string;
     existingChangelogEntries?: ExistingChangelogEntries[];
+    onComplete?: (state: CommitAgentState) => Promise<void> | void;
 }
 export interface ExistingChangelogEntries {
     path: string;

package/dist/types/config/model-resolver.d.ts

@@ -144,6 +144,7 @@ export declare function resolveModelOverride(modelPatterns: string[], modelRegis
     model?: Model<Api>;
     thinkingLevel?: ConfiguredThinkingLevel;
     explicitThinkingLevel: boolean;
+    warning?: string;
 };
 /**
  * Resolve a list of override patterns to the first matching model, with an
@@ -156,6 +157,10 @@ export declare function resolveModelOverride(modelPatterns: string[], modelRegis
  * `modelRoles.task` pointing at an unqualified id whose only available
  * provider variant has no configured credentials — see #985).
  *
+ * `sessionId` is forwarded to `getApiKey` so that session-sticky OAuth
+ * credentials resolve correctly during the pre-flight auth check. Without it,
+ * providers with multiple OAuth accounts may return `undefined` even though
+ * the credential is usable once the subagent session starts — see #5325.
  * Keyless-by-design providers (llama.cpp, ollama, lm-studio) advertise the
  * `kNoAuth` sentinel from `getApiKey` to signal that they do not require
  * credentials. Those are treated as authenticated here so an explicitly
@@ -166,11 +171,12 @@ export declare function resolveModelOverride(modelPatterns: string[], modelRegis
  * primary resolution unchanged so the existing error path still surfaces
  * a meaningful failure downstream.
  */
-export declare function resolveModelOverrideWithAuthFallback(modelPatterns: string[], parentActiveModelPattern: string | undefined, modelRegistry: ModelLookupRegistry & Pick<ModelRegistry, "getApiKey">, settings?: Settings): Promise<{
+export declare function resolveModelOverrideWithAuthFallback(modelPatterns: string[], parentActiveModelPattern: string | undefined, modelRegistry: ModelLookupRegistry & Pick<ModelRegistry, "getApiKey">, settings?: Settings, sessionId?: string): Promise<{
     model?: Model<Api>;
     thinkingLevel?: ConfiguredThinkingLevel;
     explicitThinkingLevel: boolean;
     authFallbackUsed: boolean;
+    warning?: string;
 }>;
 /**
  * Resolve a list of role patterns to the first matching model.

package/dist/types/config/settings-schema.d.ts

@@ -1262,7 +1262,7 @@ export declare const SETTINGS_SCHEMA: {
     readonly textVerbosity: {
         readonly type: "enum";
         readonly values: readonly ["low", "medium", "high"];
-        readonly default: "high";
+        readonly default: "medium";
         readonly ui: {
             readonly tab: "model";
             readonly group: "Sampling";
@@ -1275,11 +1275,11 @@ export declare const SETTINGS_SCHEMA: {
             }, {
                 readonly value: "medium";
                 readonly label: "Medium";
-                readonly description: "Balance brevity and detail";
+                readonly description: "Balance brevity and detail (default)";
             }, {
                 readonly value: "high";
                 readonly label: "High";
-                readonly description: "Prefer detailed responses (default)";
+                readonly description: "Prefer detailed responses";
             }];
         };
     };

package/dist/types/eval/py/tool-bridge.d.ts

@@ -4,6 +4,7 @@ export interface PyToolBridgeEntry {
     toolSession: ToolSession;
     signal?: AbortSignal;
     emitStatus?: (event: JsStatusEvent) => void;
+    abortRequested?: () => boolean;
 }
 export interface PyToolBridgeInfo {
     url: string;

package/dist/types/extensibility/custom-tools/types.d.ts

@@ -17,6 +17,7 @@ import type { Settings } from "../../config/settings";
 import type { ExecOptions, ExecResult } from "../../exec/exec";
 import type { HookUIContext } from "../../extensibility/hooks/types";
 import type * as PiCodingAgent from "../../index";
+import type { LocalProtocolOptions } from "../../internal-urls/local-protocol";
 import type { Theme } from "../../modes/theme/theme";
 import type { ReadonlySessionManager } from "../../session/session-manager";
 import type { TodoItem } from "../../tools/todo";
@@ -83,6 +84,8 @@ export interface CustomToolContext {
     settings?: Settings;
     /** Fetch implementation for outbound HTTP; defaults to global fetch when omitted. */
     fetch?: FetchImpl;
+    /** Calling session's `local://` root mapping for tools that bridge out of the OMP process. */
+    localProtocolOptions?: LocalProtocolOptions;
     /** Whether to auto-approve all destructive tool operations (--auto-approve CLI flag) */
     autoApprove?: boolean;
 }

package/dist/types/extensibility/extensions/runner.d.ts

@@ -6,6 +6,7 @@ import type { CredentialDisabledEvent, ImageContent, Model, ProviderResponseMeta
 import type { KeyId } from "jeopi-tui";
 import type { ModelRegistry } from "../../config/model-registry";
 import type { Settings } from "../../config/settings";
+import type { LocalProtocolOptions } from "../../internal-urls/local-protocol";
 import type { MemoryRuntimeContext } from "../../memory-backend";
 import type { SessionManager } from "../../session/session-manager";
 import type { BranchHandler, NavigateTreeHandler, NewSessionHandler } from "../session-handler-types";
@@ -65,7 +66,8 @@ export declare class ExtensionRunner {
     private readonly sessionManager;
     private readonly modelRegistry;
     private readonly settings?;
-    constructor(extensions: Extension[], runtime: ExtensionRuntime, cwd: string, sessionManager: SessionManager, modelRegistry: ModelRegistry, getMemory?: () => MemoryRuntimeContext | undefined, settings?: Settings | undefined);
+    private readonly localProtocolOptions?;
+    constructor(extensions: Extension[], runtime: ExtensionRuntime, cwd: string, sessionManager: SessionManager, modelRegistry: ModelRegistry, getMemory?: () => MemoryRuntimeContext | undefined, settings?: Settings | undefined, localProtocolOptions?: LocalProtocolOptions | undefined);
     initialize(actions: ExtensionActions, contextActions: ExtensionContextActions, commandContextActions?: ExtensionCommandContextActions, uiContext?: ExtensionUIContext): void;
     /**
      * Forward a `credential_disabled` event from `AuthStorage` to extension handlers.

package/dist/types/extensibility/extensions/types.d.ts

@@ -22,6 +22,7 @@ import type { PythonResult } from "../../eval/py/executor";
 import type { BashResult } from "../../exec/bash-executor";
 import type { ExecOptions, ExecResult } from "../../exec/exec";
 import type * as PiCodingAgent from "../../index";
+import type { LocalProtocolOptions } from "../../internal-urls/local-protocol";
 import type { MemoryRuntimeContext } from "../../memory-backend";
 import type { CustomEditor } from "../../modes/components/custom-editor";
 import type { Theme } from "../../modes/theme/theme";
@@ -222,6 +223,8 @@ export interface ExtensionContext {
     sessionManager: ReadonlySessionManager;
     /** Model registry for API key resolution */
     modelRegistry: ModelRegistry;
+    /** Calling session's `local://` root mapping for external tool bridges. */
+    localProtocolOptions?: LocalProtocolOptions;
     /** Current model (may be undefined) */
     model: Model | undefined;
     /** Read-only model query facade: list / current / resolve / family. */

package/dist/types/internal-urls/memory-protocol.d.ts

@@ -1,4 +1,4 @@
-import type { InternalResource, InternalUrl, ProtocolHandler, UrlCompletion } from "./types";
+import type { InternalResource, InternalUrl, ProtocolHandler, ResolveContext, UrlCompletion } from "./types";
 /**
  * Snapshot of memory roots for every registered session, deduped.
  * Each session has its own cwd (possibly a worktree), so subagents and main
@@ -12,13 +12,13 @@ export declare function resolveMemoryUrlToPath(url: InternalUrl, memoryRoot: str
 /**
  * Protocol handler for memory:// URLs.
  *
- * Walks every active session's memory root. Worktree-based subagents have
- * their own root; first one containing the file wins. Parent and subagent
- * sharing a cwd see the same file regardless of order.
+ * Resolves file-backed roots against the calling session cwd when provided.
+ * Contextless callers fall back to the live-session registry for legacy
+ * cross-session lookups.
  */
 export declare class MemoryProtocolHandler implements ProtocolHandler {
     readonly scheme = "memory";
     readonly immutable = true;
-    resolve(url: InternalUrl): Promise<InternalResource>;
-    complete(): Promise<UrlCompletion[]>;
+    resolve(url: InternalUrl, context?: ResolveContext): Promise<InternalResource>;
+    complete(_query?: string, context?: ResolveContext): Promise<UrlCompletion[]>;
 }

package/dist/types/internal-urls/types.d.ts

@@ -102,6 +102,13 @@ export interface ResolveContext {
      * reject directory resources, so they never need the listing.
      */
     skipDirectoryListing?: boolean;
+    /**
+     * When set, handlers that support both a "document" and a "directory" form
+     * for the same bare URL (e.g. `skill://name` vs `skill://name/SKILL.md`)
+     * resolve to the directory instead of the document. Used by `glob`'s
+     * internal-URL find path, which needs a directory to walk.
+     */
+    pathOnly?: boolean;
 }
 /**
  * Caller context for write operations dispatched to host-owned URI handlers.

package/dist/types/irc/bus.d.ts

@@ -76,6 +76,10 @@ export declare class IrcBus {
         from?: string;
     }, timeoutMs: number, signal?: AbortSignal, options?: {
         drainPending?: boolean;
+        liveness?: {
+            registry: AgentRegistry;
+            senderId: string;
+        };
     }): Promise<IrcMessage | null>;
     /** Drain (or peek) pending messages for `agentId`. */
     inbox(agentId: string, opts?: {

package/dist/types/lsp/deferred-diagnostics.d.ts

@@ -0,0 +1,11 @@
+import type { ToolSession } from "../tools";
+import type { WritethroughDeferredHandle } from "./index";
+/** Coordinates late LSP diagnostics for one mutation tool instance. */
+export declare class DeferredDiagnostics {
+    #private;
+    private readonly session;
+    private readonly deduplicate;
+    constructor(session: ToolSession, deduplicate: boolean);
+    /** Begin a file mutation and return the handle consumed by LSP writethrough. */
+    begin(path: string): WritethroughDeferredHandle;
+}

package/dist/types/modes/components/move-overlay.d.ts

@@ -18,6 +18,6 @@ export declare class MoveOverlay implements Component, Focusable {
     get focused(): boolean;
     set focused(value: boolean);
     handleInput(data: string): void;
-    render(_width: number): readonly string[];
+    render(width: number): readonly string[];
     invalidate(): void;
 }

package/dist/types/modes/components/plan-review-overlay.d.ts

@@ -25,6 +25,8 @@ export interface PlanReviewOverlayCallbacks {
     onCancel: () => void;
     /** Invoked when the external-editor key is pressed (overlay stays open). */
     onExternalEditor?: () => void;
+    /** Invoked with the current full plan text when the copy hotkey is pressed. */
+    onCopyPlan?: (content: string) => void | Promise<void>;
     /** Invoked when the external-editor key edits the active annotation draft. */
     onAnnotationExternalEditor?: (draft: string, commit: (text: string | null) => void) => void;
     /** Invoked with the new full plan text after an in-overlay delete/undo. */

package/dist/types/modes/components/welcome.d.ts

@@ -9,6 +9,10 @@ export declare const WELCOME_SESSION_SLOTS = 4;
  * the box height is constant regardless of how many servers a project has.
  */
 export declare const WELCOME_LSP_SLOTS = 4;
+/** Pick a tip from `tips`, biased toward "[NEW]" tips by {@link NEW_TIP_WEIGHT};
+ *  `r` is a uniform sample in [0, 1). Returns "" when `tips` is empty.
+ *  Exported for tests. */
+export declare function pickWeightedTip(tips: readonly string[], r: number): string;
 export declare function renderWelcomeTip(tip: string, boxWidth: number, phase?: number): string[];
 export interface RecentSession {
     name: string;

package/dist/types/modes/magic-keyword-boundary.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Build a case-sensitive magic-keyword matcher for prose punctuation boundaries.
+ *
+ * Sentence punctuation and quotes may touch the keyword, but letters, digits,
+ * underscores, slashes, backslashes, hyphens, file-extension dots, symbol
+ * references (`foo::keyword`), and immediate call parentheses (`keyword()`)
+ * keep the occurrence embedded in code rather than prose.
+ */
+export declare function magicKeywordRegex(keyword: string, flags?: string): RegExp;

package/dist/types/modes/orchestrate.d.ts

@@ -3,7 +3,7 @@ import { type KeywordHighlighter } from "./gradient-highlight";
 export declare const ORCHESTRATE_NOTICE: string;
 /**
  * Whether `text` contains the standalone keyword "orchestrate" (lowercase,
- * whitespace-delimited) in prose — never inside a code block, inline code span,
+ * prose-delimited) in prose — never inside a code block, inline code span,
  * or XML/HTML section.
  */
 export declare function containsOrchestrate(text: string): boolean;

package/dist/types/modes/ultrathink.d.ts

@@ -3,7 +3,7 @@ import { type KeywordHighlighter } from "./gradient-highlight";
 export declare const ULTRATHINK_NOTICE: string;
 /**
  * Whether `text` contains the standalone keyword "ultrathink" (lowercase,
- * whitespace-delimited) in prose — never inside a code block, inline code span,
+ * prose-delimited) in prose — never inside a code block, inline code span,
  * or XML/HTML section.
  */
 export declare function containsUltrathink(text: string): boolean;

package/dist/types/modes/workflow.d.ts

@@ -3,7 +3,7 @@ import { type KeywordHighlighter } from "./gradient-highlight";
 export declare const WORKFLOW_NOTICE: string;
 /**
  * Whether `text` contains the standalone keyword "workflowz"
- * (lowercase, whitespace-delimited) in prose — never inside a code block, inline
+ * (lowercase, prose-delimited) in prose — never inside a code block, inline
  * code span, or XML/HTML section.
  */
 export declare function containsWorkflow(text: string): boolean;

package/dist/types/session/agent-session.d.ts

@@ -754,6 +754,11 @@ export declare class AgentSession {
      * from role configuration (e.g., "anthropic/claude-sonnet-4-5:xhigh").
      */
     resolveRoleModelWithThinking(role: string): ResolvedModelRoleValue;
+    /**
+     * Resolve the explicit thinking suffix that should apply when a temporary
+     * picker selects a model already assigned to a configured role.
+     */
+    resolveTemporaryModelThinkingLevel(model: Model): ConfiguredThinkingLevel | undefined;
     get promptTemplates(): ReadonlyArray<PromptTemplate>;
     /** Replace file-based slash commands used for prompt expansion. */
     setSlashCommands(slashCommands: FileSlashCommand[]): void;

package/dist/types/session/auth-broker-config.d.ts

@@ -9,13 +9,13 @@
  * Precedence (highest first):
  *   1. `JEOPI_AUTH_BROKER_URL` / `JEOPI_AUTH_BROKER_TOKEN` env vars.
  *   2. `auth.broker.url` / `auth.broker.token` in `~/.jeopi/agent/config.yml`
- *      (hidden from the settings UI; `!command` resolution supported).
+ *      or `~/.jeopi/agent/config.yaml` (hidden from the settings UI; `!command` resolution supported).
  *   3. Token file `~/.jeopi/auth-broker.token` (paired with URL from env or config).
  *
  * Returns null when no broker URL is configured — caller falls back to the
  * local SQLite store.
  *
- * Reads config.yml directly (instead of going through `Settings.init`) because
+ * Reads config YAML directly (instead of going through `Settings.init`) because
  * `discoverAuthStorage` runs before the settings singleton is initialized in
  * `runRootCommand`, and we want hand-edited config entries to be honoured at
  * boot without forcing a startup reorder.

package/dist/types/tools/bash-skill-urls.d.ts

@@ -1,15 +1,16 @@
 import type { Skill } from "../extensibility/skills";
 import { type LocalProtocolOptions } from "../internal-urls";
-import type { InternalResource } from "../internal-urls/types";
+import type { InternalResource, ResolveContext } from "../internal-urls/types";
 interface InternalUrlResolver {
     canHandle(input: string): boolean;
-    resolve(input: string): Promise<InternalResource>;
+    resolve(input: string, context?: ResolveContext): Promise<InternalResource>;
 }
 export interface InternalUrlExpansionOptions {
     skills: readonly Skill[];
     noEscape?: boolean;
     internalRouter?: InternalUrlResolver;
     localOptions?: LocalProtocolOptions;
+    cwd?: string;
     ensureLocalParentDirs?: boolean;
 }
 /**

package/dist/types/tools/browser/cmux/cmux-tab.d.ts

@@ -2,6 +2,7 @@ import { JsRuntime } from "../../../eval/js/shared/runtime";
 import type { ToolSession } from "../../index";
 import { type AriaSnapshotOptions } from "../aria/aria-snapshot";
 import { type ReadableFormat } from "../readable";
+import { RunOutput } from "../run-output";
 import type { Observation, ReadyInfo, RunResultOk, ScreenshotResult, SessionSnapshot } from "../tab-protocol";
 import type { CmuxSocketClient } from "./socket-client";
 interface ScreenshotOptions {
@@ -17,7 +18,7 @@ interface ObserveOptions {
 }
 interface RunContext {
     session: SessionSnapshot;
-    displays: RunResultOk["displays"];
+    output: RunOutput;
     screenshots: ScreenshotResult[];
     signal: AbortSignal;
     timeoutMs: number;
@@ -142,6 +143,7 @@ declare class CmuxElementHandle {
     click(): Promise<void>;
     type(text: string): Promise<void>;
     fill(value: string): Promise<void>;
+    press(key: string): Promise<void>;
     focus(): Promise<void>;
     hover(): Promise<void>;
     evaluate<TResult, TArgs extends unknown[]>(fn: (element: unknown, ...args: TArgs) => TResult | Promise<TResult>, ...args: TArgs): Promise<TResult>;

package/dist/types/tools/browser/cmux/rpc.d.ts

@@ -62,6 +62,26 @@ export interface CmuxGeometry {
 export declare const GEOMETRY_SCRIPT = "(() => ({ innerWidth: window.innerWidth, innerHeight: window.innerHeight, dpr: window.devicePixelRatio||1, scrollX: window.scrollX, scrollY: window.scrollY, scrollWidth: document.documentElement.scrollWidth, scrollHeight: document.documentElement.scrollHeight }))()";
 export declare function cmuxSnapshotToObservation(result: CmuxSnapshotResult, viewport: Observation["viewport"], geometry: CmuxGeometry): Observation;
 export declare function serializeEval(fn: string | ((...args: unknown[]) => unknown), args: unknown[]): string;
+/**
+ * Like {@link serializeEval}, but wraps the expression in a page-side
+ * try/catch envelope so a throwing script surfaces its message + stack
+ * instead of the daemon's opaque `js_error: A JavaScript exception occurred`,
+ * and a Promise return (which the daemon cannot serialize) is flagged
+ * explicitly rather than failing as "unsupported type".
+ *
+ * String scripts run through indirect eval to keep global-scope semantics;
+ * function sources are already expressions and are invoked directly.
+ * `undefined` results come back as `null` (JSON cannot carry `undefined`).
+ * Decode with {@link unwrapEvalEnvelope}.
+ */
+export declare function serializeEvalWithEnvelope(fn: string | ((...args: unknown[]) => unknown), args: unknown[]): string;
+/**
+ * Decode a {@link serializeEvalWithEnvelope} result: rethrow page-side
+ * exceptions as rich {@link ToolError}s, reject unserializable Promise
+ * returns with an actionable message, and pass through values from daemons
+ * that did not run the wrapper.
+ */
+export declare function unwrapEvalEnvelope<TResult>(value: unknown, label: string): TResult;
 export declare function mapWaitUntil(waitUntil: string | undefined): "interactive" | "complete";
 export interface ResolveCmuxKindOptions {
     surface?: string;

package/dist/types/tools/browser/launch.d.ts

@@ -13,6 +13,7 @@ export declare const DEFAULT_VIEWPORT: {
 export declare const BROWSER_PROTOCOL_TIMEOUT_MS = 60000;
 export declare function loadPuppeteer(): Promise<typeof Puppeteer>;
 export declare function loadPuppeteerInWorker(safeDir: string): Promise<typeof Puppeteer>;
+export declare function ensureChromiumExecutable(): Promise<string | undefined>;
 export interface LaunchHeadlessOptions {
     headless: boolean;
     viewport?: {

package/dist/types/tools/browser/run-cancellation.d.ts

@@ -1,4 +1,19 @@
-/** Sleeps inside evaluated browser code while honoring the owning run's cancellation signal. */
-export declare function waitForBrowserRun(ms: number, signal: AbortSignal): Promise<void>;
+/** Options for the predicate form of the run-scoped `wait()` helper. */
+export interface WaitPredicateOptions {
+    /** Max time to poll before failing, in ms (default 30_000). */
+    timeout?: number;
+    /** Poll interval in ms (default 100, floor 10). */
+    interval?: number;
+}
+/**
+ * Run-scoped `wait()` helper for evaluated browser code, honoring the owning run's
+ * cancellation signal.
+ *
+ * - `wait(ms)` sleeps for `ms` milliseconds.
+ * - `wait(fn, { timeout?, interval? })` polls `fn` (sync or async) until it returns a
+ *   truthy value and resolves with that value; throws a named `ToolError` on timeout
+ *   instead of stalling into the whole-cell deadline. Predicate errors propagate.
+ */
+export declare function waitForBrowserRun(msOrPredicate: number | (() => unknown), signal: AbortSignal, opts?: WaitPredicateOptions): Promise<unknown>;
 /** Binds a long-lived browser facade to one evaluated run's abort signal. */
 export declare function bindBrowserRunFacade<T extends object>(target: T, signal: AbortSignal): T;

package/dist/types/tools/browser/run-output.d.ts

@@ -0,0 +1,25 @@
+import type { ImageContent, TextContent } from "jeopi-ai";
+import type { JsDisplayOutput } from "../../eval/js/shared/types";
+/**
+ * Accumulates a browser run's result entries: explicit `display()` payloads,
+ * screenshot captions/images, and buffered stream text (`console.*`, `print`,
+ * `display()` of strings/primitives — `JsRuntime.displayValue` emits those via
+ * `onText`). Stream text is buffered and flushed as one entry before the next
+ * display/screenshot (and on `finish()`) so it reaches the tool result in
+ * order instead of vanishing into the debug log.
+ */
+export declare class RunOutput {
+    #private;
+    /** Buffer a stream-text chunk; it joins the entries at the next push or on finish(). */
+    pushText(chunk: string): void;
+    /** Append a `display()` payload (image/json/status), flushing buffered text first. */
+    pushDisplay(output: JsDisplayOutput): void;
+    /** Append a pre-built entry (e.g. a screenshot caption/image), flushing buffered text first. */
+    push(entry: TextContent | ImageContent): void;
+    /** Flush any remaining stream text and return the ordered entries. */
+    finish(): Array<TextContent | ImageContent>;
+}
+/** JSON.stringify that never throws (cycles/BigInt → String(value)). */
+export declare function safeJsonStringify(value: unknown): string;
+/** Pass a return value across the run boundary: structured-cloneable as-is, else JSON round-trip, else String. */
+export declare function cloneSafe(value: unknown): unknown;

package/dist/types/tools/browser/tab-worker.d.ts

@@ -1,6 +1,12 @@
 import type { HTMLElement } from "linkedom";
 import type { ElementHandle, ImageFormat } from "puppeteer-core";
 import type { Transport } from "./tab-protocol";
+declare module "puppeteer-core" {
+    interface Frame {
+        /** Puppeteer's main JavaScript realm, retained by our pinned runtime patch. */
+        mainRealm(): Realm;
+    }
+}
 declare global {
     interface Element extends HTMLElement {
     }
@@ -37,6 +43,22 @@ interface ScreenshotOptions {
     silent?: boolean;
 }
 export declare function normalizeSelector(selector: string): string;
+/** ElementHandle enriched with the `fill()` the tool docs promise on handles from `tab.id()`/`tab.ref()`/`tab.waitFor()`. */
+export type ActionableHandle = ElementHandle & {
+    fill(value: string): Promise<void>;
+};
+/**
+ * Attach `fill()` to a puppeteer ElementHandle before handing it to user code.
+ * Puppeteer handles expose `type()` but no `fill()`; the semantics mirror the
+ * selector-based `tab.fill()`: focus, clear any existing value, then type.
+ */
+export declare function toActionableHandle(handle: ElementHandle): ActionableHandle;
+/**
+ * Hint appended to a selector op's fail-fast timeout, given the selector's current
+ * match count: a missing element (consent wall, wrong page) reads differently from
+ * a present-but-unactionable one.
+ */
+export declare function formatSelectorMatchHint(count: number): string;
 export interface InflightOp {
     label: string;
     startedAt: number;

package/dist/types/utils/changelog.d.ts

@@ -4,6 +4,24 @@ export interface ChangelogEntry {
     patch: number;
     content: string;
 }
+/** Number of changelog releases shown by automatic and default recent views. */
+export declare const RECENT_CHANGELOG_ENTRY_LIMIT = 3;
+/** Maximum Markdown source bytes allowed in automatic startup release notes. */
+export declare const STARTUP_CHANGELOG_MAX_BYTES: number;
+/** Hint appended when automatic startup release notes are truncated. */
+export declare const STARTUP_CHANGELOG_FULL_HINT = "Use `/changelog full` to view the complete changelog.";
+/** Markdown generated from selected changelog entries and whether it hit a size cap. */
+export interface RenderedChangelog {
+    markdown: string;
+    truncated: boolean;
+}
+/** Automatic startup changelog decision, including whether the marker should advance. */
+export interface StartupChangelogSelection {
+    markdown: string | undefined;
+    persistCurrentVersion: boolean;
+    truncated: boolean;
+    selectedEntries: number;
+}
 /**
  * Parse changelog entries from the file at `changelogPath`. Scans for `## [x.y.z]`
  * headings and collects each block until the next heading or EOF.
@@ -19,9 +37,25 @@ export declare function parseChangelog(changelogPath: string | undefined): Promi
  */
 export declare function compareVersions(v1: ChangelogEntry, v2: ChangelogEntry): number;
 /**
- * Get entries newer than lastVersion
+ * Parse an omp changelog marker version into comparable parts.
+ */
+export declare function parseChangelogVersion(version: string | undefined): ChangelogEntry | undefined;
+/**
+ * Get entries newer than lastVersion.
  */
 export declare function getNewEntries(entries: ChangelogEntry[], lastVersion: string): ChangelogEntry[];
+/**
+ * Render changelog entries oldest-first by default and optionally cap the Markdown source size.
+ */
+export declare function renderChangelogEntries(entries: ChangelogEntry[], options?: {
+    maxBytes?: number;
+    truncationHint?: string;
+    oldestFirst?: boolean;
+}): RenderedChangelog;
+/**
+ * Select bounded release notes for interactive startup.
+ */
+export declare function selectStartupChangelog(entries: ChangelogEntry[], lastVersion: string | undefined, currentVersion: string): StartupChangelogSelection;
 export { getChangelogPath } from "../config";
 /**
  * Last jeopi version whose changelog the user has seen. Stored as a plain-text

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "jeopi-cli",
-	"version": "16.4.1",
+	"version": "16.4.3",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/akillness/jeopi",
 	"author": "Can Boluk",
@@ -57,17 +57,17 @@
 		"@agentclientprotocol/sdk": "0.25.0",
 		"@babel/parser": "^7.29.7",
 		"@mozilla/readability": "^0.6.0",
-		"jeopi-hashline": "16.4.1",
-		"jeopi-stats": "16.4.1",
-		"jeopi-agent-core": "16.4.1",
-		"jeopi-ai": "16.4.1",
-		"jeopi-catalog": "16.4.1",
-		"jeopi-mnemopi": "16.4.1",
-		"jeopi-natives": "16.4.1",
-		"jeopi-tui": "16.4.1",
-		"jeopi-utils": "16.4.1",
-		"jeopi-wire": "16.4.1",
-		"jeopi-snapcompact": "16.4.1",
+		"jeopi-hashline": "16.4.3",
+		"jeopi-stats": "16.4.3",
+		"jeopi-agent-core": "16.4.3",
+		"jeopi-ai": "16.4.3",
+		"jeopi-catalog": "16.4.3",
+		"jeopi-mnemopi": "16.4.3",
+		"jeopi-natives": "16.4.3",
+		"jeopi-tui": "16.4.3",
+		"jeopi-utils": "16.4.3",
+		"jeopi-wire": "16.4.3",
+		"jeopi-snapcompact": "16.4.3",
 		"@opentelemetry/api": "^1.9.1",
 		"@opentelemetry/context-async-hooks": "^2.7.1",
 		"@opentelemetry/exporter-trace-otlp-proto": "^0.218.0",

package/src/advisor/__tests__/advisor.test.ts

@@ -1839,6 +1839,19 @@ describe("advisor", () => {
 			expect(text).toContain("read, grep, glob (default)");
 		});
 
+		it("renders an explicit no-tools advisor distinctly from the omitted default", async () => {
+			const uiTheme = await getThemeByName("dark");
+			if (!uiTheme) throw new Error("theme unavailable");
+			setThemeInstance(uiTheme);
+			const overlay = make({
+				advisors: [{ name: "Blank", tools: [] }],
+			});
+
+			const text = strip(overlay.render(200));
+			expect(text.toLowerCase()).toContain("no tools");
+			expect(text).not.toContain("read, grep, glob (default)");
+		});
+
 		it("moves the preview with keyboard selection and preserves an explicit tool set", async () => {
 			const uiTheme = await getThemeByName("dark");
 			if (!uiTheme) throw new Error("theme unavailable");