jeopi-cli 16.2.13 → 16.2.14

package/dist/types/modes/runtime-init.d.ts

@@ -1,25 +0,0 @@
-import type { ExtensionError, ExtensionUIContext } from "../extensibility/extensions/types";
-import type { AgentSession } from "../session/agent-session";
-/** Action name for an extension-originated send failure. */
-export type ExtensionSendAction = "extension_send" | "extension_send_user";
-export interface InitializeExtensionsOptions {
-    /** Reports an error thrown by an extension-initiated send. */
-    reportSendError: (action: ExtensionSendAction, error: Error) => void;
-    /** Reports a runtime error surfaced through {@link ExtensionRunner.onError}. */
-    reportRuntimeError: (error: ExtensionError) => void;
-    /** Optional shutdown hook (rpc mode signals its loop; print mode is a no-op). */
-    onShutdown?: () => void;
-    /** Optional UI context (rpc supplies one; print runs headless). */
-    uiContext?: ExtensionUIContext;
-    /** Optional lifecycle hook for extension-originated messages that can start an agent turn. */
-    markAgentInvokingMessage?: () => void;
-    /** Optional lifecycle hook for extension-originated sends whose success/failure determines turn ownership. */
-    trackAgentInvokingMessage?: (task: Promise<unknown>) => void;
-}
-/**
- * Initialize the session's extension runner with the standard action set
- * shared by non-interactive modes, then emit `session_start`.
- *
- * No-op when the session was constructed without an extension runner.
- */
-export declare function initializeExtensions(session: AgentSession, options: InitializeExtensionsOptions): Promise<void>;

package/dist/types/modes/session-observer-registry.d.ts

@@ -1,35 +0,0 @@
-import type { AgentProgress } from "../task";
-import type { EventBus } from "../utils/event-bus";
-export interface ObservableSession {
-    id: string;
-    kind: "main" | "subagent";
-    label: string;
-    agent?: string;
-    description?: string;
-    status: "active" | "completed" | "failed" | "aborted";
-    sessionFile?: string;
-    parentToolCallId?: string;
-    /**
-     * Spawn runs as a detached background job (parent turn not blocked on it).
-     * The anchored subagent HUD only lists detached spawns: sync task spawns
-     * and eval `agent()` spawns are already rendered live by their own inline
-     * tool block / eval cell.
-     */
-    detached?: boolean;
-    index?: number;
-    lastUpdate: number;
-    /** Latest progress snapshot from the subagent executor */
-    progress?: AgentProgress;
-}
-export declare class SessionObserverRegistry {
-    #private;
-    /** Add a change listener. Returns unsubscribe function. */
-    onChange(cb: () => void): () => void;
-    setMainSession(sessionFile?: string): void;
-    getSessions(): ObservableSession[];
-    getActiveSubagentCount(): number;
-    /** Clear all tracked sessions (e.g. on session switch). Keeps EventBus subscriptions and listeners. */
-    resetSessions(): void;
-    dispose(): void;
-    subscribeToEventBus(eventBus: EventBus): void;
-}

package/dist/types/modes/session-teardown.d.ts

@@ -1,63 +0,0 @@
-/**
- * Signal-safe session teardown: persists the in-progress editor draft, then
- * disposes the session (which emits `session_shutdown`, cancels the session's
- * background async jobs, and closes the session manager). Shared by the TUI
- * Ctrl+C/Ctrl+D/`/exit` keypress path in `InteractiveMode.shutdown()` and by
- * the postmortem `SIGINT`/`SIGTERM`/`SIGHUP`/`uncaughtException` handlers so a
- * real kernel signal executes the exact same teardown as a keypress exit.
- *
- * Extracted (rather than inlined into `InteractiveMode`) so the callback body
- * is directly unit-testable without instantiating the full TUI stack.
- */
-import { type postmortem } from "jeopi-utils";
-/** Dependencies the teardown captures at construction time. */
-export interface SessionTeardownDeps {
-    /** Snapshot the current editor text; called once, before disposal touches session state. */
-    getDraftText: () => string;
-    /**
-     * Synchronously mark the session as disposing before any awaited teardown
-     * work. This closes the async gap where deferred jobs could otherwise start
-     * after a signal requested shutdown but before `disposeSession()` begins.
-     */
-    beginDispose: () => void;
-    /**
-     * Persist the snapshotted draft. Called even for an empty string so a
-     * previously-persisted draft sidecar is cleared on a clean exit.
-     */
-    saveDraft: (text: string) => Promise<void>;
-    /**
-     * Dispose the session — emits `session_shutdown`, drains async jobs, closes
-     * the manager. Receives the postmortem reason that triggered the teardown
-     * (undefined on the keypress/`/exit` path) so `AgentSession.dispose()` can
-     * persist the real exit reason instead of the generic `"dispose"`.
-     */
-    disposeSession: (reason?: postmortem.Reason) => Promise<void>;
-}
-/**
- * Idempotent teardown: concurrent/repeat invocations share one settled
- * promise. The optional `reason` is the postmortem reason that triggered the
- * teardown (`sigterm`, `sighup`, `uncaught_exception`, …); only the FIRST
- * call's reason is used — later callers await the same settled promise.
- */
-export type SessionTeardown = (reason?: postmortem.Reason) => Promise<void>;
-/**
- * Build a promise-memoized teardown function. The first call snapshots the
- * draft text, marks the session disposing synchronously, runs `saveDraft`
- * (draft-loss protection for `--resume`), then `disposeSession`; subsequent
- * calls await the same settled promise, so the keypress
- * `InteractiveMode.shutdown()` path and the postmortem signal callback cannot
- * double-emit `session_shutdown`, double-dispose the session's async-job
- * manager, or race each other.
- *
- * The postmortem callback forwards its `Reason` so the persisted
- * `session_exit` diagnostic carries the real trigger (`sigterm`, `sighup`,
- * `uncaught_exception`, …) instead of the generic `"dispose"` that plain
- * programmatic disposal records. First call wins: a signal arriving after a
- * keypress-initiated teardown awaits the in-flight promise and its reason is
- * dropped — by then the exit entry is already being written as a normal exit.
- *
- * `saveDraft` failures are logged but never abort the disposal chain — a
- * draft-write error must not leak background bash/task jobs or skip the
- * extension `session_shutdown` event.
- */
-export declare function createSessionTeardown(deps: SessionTeardownDeps): SessionTeardown;

package/dist/types/modes/session-teardown.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/modes/setup-version.d.ts

@@ -1,11 +0,0 @@
-/**
- * Setup version the wizard advances a fresh install to. Bump it whenever a new
- * setup scene lands (or an existing scene raises its `minVersion`).
- *
- * Kept in its own dependency-free module so the cold-launch gate in `main.ts`
- * can answer "is the stored setup version stale?" without statically importing
- * the full wizard — every scene (sign-in/OAuth, web search, theme previews) plus
- * the overlay component and their TUI deps. MUST equal `max(scene.minVersion)`
- * across `ALL_SCENES`; the `setup-wizard` barrel and test suite guard it.
- */
-export declare const CURRENT_SETUP_VERSION = 1;

package/dist/types/modes/setup-wizard/index.d.ts

@@ -1,22 +0,0 @@
-import type { Settings } from "../../config/settings";
-import { CURRENT_SETUP_VERSION } from "../setup-version";
-import type { InteractiveModeContext } from "../types";
-import type { SetupScene } from "./scenes/types";
-export type { SetupScene, SetupSceneController, SetupSceneHost, SetupSceneResult } from "./scenes/types";
-export { runStartupSplash } from "./startup-splash";
-export { CURRENT_SETUP_VERSION };
-export declare const ALL_SCENES: readonly [SetupScene, SetupScene, SetupScene];
-export interface SetupSceneSelectionOptions {
-    resuming?: boolean;
-    isTTY?: boolean;
-    skipEnv?: string;
-    setupWizardEnabled?: boolean;
-    force?: boolean;
-}
-export declare function selectSetupScenes(storedVersion: number, scenes: readonly SetupScene[], ctx?: InteractiveModeContext, options?: SetupSceneSelectionOptions): Promise<SetupScene[]>;
-export declare function markSetupWizardComplete(settings: Settings, version?: number): Promise<void>;
-export interface RunSetupWizardOptions {
-    markComplete?: boolean;
-    playWelcomeIntro?: boolean;
-}
-export declare function runSetupWizard(ctx: InteractiveModeContext, scenes?: readonly SetupScene[], options?: RunSetupWizardOptions): Promise<void>;

package/dist/types/modes/setup-wizard/lazy.d.ts

@@ -1,2 +0,0 @@
-import type { InteractiveModeContext } from "../types";
-export declare function runProviderSetupWizard(ctx: InteractiveModeContext): Promise<void>;

package/dist/types/modes/setup-wizard/scenes/glyph.d.ts

@@ -1,2 +0,0 @@
-import type { SetupScene } from "./types";
-export declare const glyphSetupScene: SetupScene;

package/dist/types/modes/setup-wizard/scenes/outro.d.ts

@@ -1,2 +0,0 @@
-export declare const SETUP_OUTRO_MS = 1200;
-export declare function renderSetupOutro(width: number, height: number, elapsedMs: number): string[];

package/dist/types/modes/setup-wizard/scenes/providers.d.ts

@@ -1,2 +0,0 @@
-import type { SetupScene } from "./types";
-export declare const providersSetupScene: SetupScene;

package/dist/types/modes/setup-wizard/scenes/sign-in.d.ts

@@ -1,22 +0,0 @@
-import { type SgrMouseEvent } from "jeopi-tui";
-import type { SetupSceneHost, SetupTab } from "./types";
-/**
- * "Sign in" panel: lets the user authenticate one or more model providers via
- * OAuth. Unlike a standalone scene it never auto-advances the wizard — the user
- * may sign in to several providers and then continue with Esc.
- */
-export declare class SignInTab implements SetupTab {
-    #private;
-    private readonly host;
-    readonly id = "sign-in";
-    readonly label = "Sign in";
-    constructor(host: SetupSceneHost);
-    /** Modal while an OAuth flow is running so the scene won't switch tabs or finish. */
-    get modal(): boolean;
-    dispose(): void;
-    invalidate(): void;
-    handleInput(data: string): void;
-    /** Forward mouse to the provider selector; pointer is inert during an active login or code prompt. */
-    routeMouse(event: SgrMouseEvent, line: number, col: number): void;
-    render(width: number): readonly string[];
-}

package/dist/types/modes/setup-wizard/scenes/splash.d.ts

@@ -1,11 +0,0 @@
-export declare const SETUP_SPLASH_MS = 2600;
-export declare const SETUP_TICK_MS = 33;
-export declare function renderStarfield(width: number, height: number, frame: number): string[];
-/**
- * Animated setup splash, in the spirit of the jeopi landing page: the brand
- * wordmark rendered with the live diagonal gradient + shine sweep, rising out of a
- * rippling, gradient-lit water surface, under a faint twinkling starfield. The
- * mark and water share one continuous gradient so the sweep reads across the
- * whole scene; the water surface drifts each frame.
- */
-export declare function renderSetupSplash(width: number, height: number, elapsedMs: number): string[];

package/dist/types/modes/setup-wizard/scenes/theme.d.ts

@@ -1,2 +0,0 @@
-import type { SetupScene } from "./types";
-export declare const themeSetupScene: SetupScene;

package/dist/types/modes/setup-wizard/scenes/types.d.ts

@@ -1,52 +0,0 @@
-import type { Component, SgrMouseEvent } from "jeopi-tui";
-import type { InteractiveModeContext } from "../../types";
-export type SetupSceneResult = "done" | "skipped";
-export interface SetupSceneHost {
-    ctx: InteractiveModeContext;
-    requestRender(): void;
-    finish(result: SetupSceneResult): void;
-    setFocus(component: Component | null): void;
-    restoreFocus(): void;
-}
-export interface SetupSceneController extends Component {
-    title: string;
-    subtitle?: string;
-    onMount?(): void | Promise<void>;
-    onUnmount?(): void;
-    dispose?(): void;
-    /**
-     * Route an SGR mouse report (tracking is on while the wizard holds the
-     * alternate screen). `line`/`col` are 0-based within this controller's
-     * last rendered output. When absent, the wizard falls back to synthesizing
-     * arrow keys from wheel notches.
-     */
-    routeMouse?(event: SgrMouseEvent, line: number, col: number): void;
-}
-/**
- * A single panel inside a tabbed setup scene. The host scene owns the tab bar
- * and forwards rendering/input to the active tab.
- */
-export interface SetupTab {
-    readonly id: string;
-    readonly label: string;
-    /**
-     * While `true` the tab owns all keyboard input (e.g. an in-progress OAuth
-     * login). The parent scene MUST NOT switch tabs or finish while modal.
-     */
-    readonly modal: boolean;
-    render(width: number): readonly string[];
-    handleInput(data: string): void;
-    invalidate(): void;
-    /** Called when the tab becomes active (including initial mount). */
-    onActivate?(): void;
-    /** Mouse routing at tab-local coordinates; see {@link SetupSceneController.routeMouse}. */
-    routeMouse?(event: SgrMouseEvent, line: number, col: number): void;
-    dispose(): void;
-}
-export interface SetupScene {
-    id: string;
-    title: string;
-    minVersion: number;
-    shouldRun?(ctx: InteractiveModeContext): boolean | Promise<boolean>;
-    mount(host: SetupSceneHost): SetupSceneController;
-}

package/dist/types/modes/setup-wizard/scenes/web-search.d.ts

@@ -1,23 +0,0 @@
-import { type SgrMouseEvent } from "jeopi-tui";
-import type { SetupSceneHost, SetupTab } from "./types";
-/**
- * "Web search" panel: picks the provider the web_search tool should prefer and
- * reports whether the highlighted provider is ready to use given current
- * credentials (env keys or OAuth sign-ins from the Sign in tab) or an
- * unauthenticated fallback.
- */
-export declare class WebSearchTab implements SetupTab {
-    #private;
-    private readonly host;
-    readonly id = "web-search";
-    readonly label = "Web search";
-    readonly modal = false;
-    constructor(host: SetupSceneHost);
-    onActivate(): void;
-    handleInput(data: string): void;
-    /** Wheel moves the highlight; hover lights the row under the pointer; click confirms it. */
-    routeMouse(event: SgrMouseEvent, line: number, _col: number): void;
-    invalidate(): void;
-    dispose(): void;
-    render(width: number): readonly string[];
-}

package/dist/types/modes/setup-wizard/startup-splash.d.ts

@@ -1,7 +0,0 @@
-import type { InteractiveModeContext } from "../types";
-export interface RunStartupSplashOptions {
-    readonly durationMs?: number;
-    readonly tickMs?: number;
-    readonly now?: () => number;
-}
-export declare function runStartupSplash(ctx: InteractiveModeContext, options?: RunStartupSplashOptions): Promise<void>;

package/dist/types/modes/setup-wizard/wizard-overlay.d.ts

@@ -1,15 +0,0 @@
-import { type Component, type OverlayFocusOwner } from "jeopi-tui";
-import type { InteractiveModeContext } from "../types";
-import type { SetupScene } from "./scenes/types";
-export declare class SetupWizardComponent implements Component, OverlayFocusOwner {
-    #private;
-    readonly ctx: InteractiveModeContext;
-    readonly scenes: readonly SetupScene[];
-    constructor(ctx: InteractiveModeContext, scenes: readonly SetupScene[]);
-    run(): Promise<void>;
-    dispose(): void;
-    invalidate(): void;
-    ownsOverlayFocusTarget(component: Component): boolean;
-    handleInput(data: string): void;
-    render(width: number): readonly string[];
-}

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

@@ -1,15 +0,0 @@
-import type { TabBarTheme } from "jeopi-tui";
-/** Sanitize text for display in a single-line status. Strips ANSI/VT escape sequences, maps remaining C0/C1 control characters to spaces, collapses whitespace, trims. */
-export declare function sanitizeStatusText(text: string): string;
-/** Shared tab bar theme used by model-selector and settings-selector. */
-export declare function getTabBarTheme(): TabBarTheme;
-/**
- * Suffix appended to the loader's working message to remind users they can
- * abort with Esc. Rendered with the active theme's bracket glyphs so it stays
- * visually consistent with badges and other bracketed UI affordances.
- *
- * The leading space separates the hint from the message body and is consumed
- * by `endsWith`/`slice` matching in the loader renderer.
- */
-export declare function interruptHint(): string;
-export { parseCommandArgs } from "../utils/command-args";

package/dist/types/modes/skill-command.d.ts

@@ -1,32 +0,0 @@
-import type { ImageContent, TextContent } from "jeopi-ai";
-import { type CustomMessage, SKILL_PROMPT_MESSAGE_TYPE, type SkillPromptDetails } from "../session/messages";
-import type { InteractiveModeContext } from "./types";
-type SkillCommandHost = Pick<InteractiveModeContext, "skillCommands" | "session" | "showError">;
-type SkillPromptMessage = Pick<CustomMessage<SkillPromptDetails>, "customType" | "content" | "display" | "details" | "attribution"> & {
-    customType: typeof SKILL_PROMPT_MESSAGE_TYPE;
-    content: string | (TextContent | ImageContent)[];
-    display: true;
-    details: SkillPromptDetails;
-    attribution: "user";
-};
-type SkillPromptOptions = {
-    streamingBehavior: "steer" | "followUp";
-    queueChipText: string;
-};
-interface InvokeSkillCommandOptions {
-    propagateErrors?: boolean;
-    queueOnly?: boolean;
-    images?: ImageContent[];
-}
-/** Built custom-message payload and delivery options for a `/skill:` command. */
-export interface BuiltSkillCommandPrompt {
-    message: SkillPromptMessage;
-    options: SkillPromptOptions;
-}
-/** Return true when `text` invokes a registered `/skill:<name>` command. */
-export declare function isKnownSkillCommand(ctx: SkillCommandHost, text: string): boolean;
-/** Build the user-attributed custom message for a registered `/skill:<name>` command. */
-export declare function buildSkillCommandPrompt(ctx: SkillCommandHost, text: string, streamingBehavior: "steer" | "followUp", images?: ImageContent[]): Promise<BuiltSkillCommandPrompt | undefined>;
-/** Invoke a registered `/skill:<name>` command as a user-attributed custom message. */
-export declare function invokeSkillCommandFromText(ctx: SkillCommandHost, text: string, streamingBehavior: "steer" | "followUp", options?: InvokeSkillCommandOptions): Promise<boolean>;
-export {};