jeopi-cli 16.2.13 → 16.2.14

package/dist/types/modes/utils/ui-helpers.d.ts

@@ -1,55 +0,0 @@
-import type { AgentMessage } from "jeopi-agent-core";
-import type { AssistantMessage, ImageContent, Message } from "jeopi-ai";
-import { type Component } from "jeopi-tui";
-import type { InteractiveModeContext } from "../../modes/types";
-import type { SessionContext } from "../../session/session-context";
-interface RenderInitialMessagesOptions {
-    preserveExistingChat?: boolean;
-    clearTerminalHistory?: boolean;
-}
-export declare class UiHelpers {
-    #private;
-    private ctx;
-    constructor(ctx: InteractiveModeContext);
-    /** Extract text content from a user message */
-    getUserMessageText(message: Message): string;
-    /**
-     * Show a status message in the chat.
-     *
-     * If multiple status messages are emitted back-to-back (without anything else being added to the chat),
-     * we update the previous status line instead of appending new ones to avoid log spam.
-     */
-    showStatus(message: string, options?: {
-        dim?: boolean;
-    }): void;
-    addMessageToChat(message: AgentMessage, options?: {
-        populateHistory?: boolean;
-        imageLinks?: readonly (string | undefined)[];
-    }): Component[];
-    /**
-     * Render session context to chat. Used for initial load and rebuild after compaction.
-     * @param sessionContext Session context to render
-     * @param options.updateFooter Update footer state
-     * @param options.populateHistory Add user messages to editor history
-     */
-    renderSessionContext(sessionContext: SessionContext, options?: {
-        updateFooter?: boolean;
-        populateHistory?: boolean;
-    }): void;
-    renderInitialMessages(options?: RenderInitialMessagesOptions): void;
-    clearEditor(): void;
-    showError(errorMessage: string): void;
-    showWarning(warningMessage: string): void;
-    showNewVersionNotification(newVersion: string): void;
-    updatePendingMessagesDisplay(): void;
-    queueCompactionMessage(text: string, mode: "steer" | "followUp", images?: ImageContent[]): void;
-    isKnownSlashCommand(text: string): boolean;
-    flushCompactionQueue(options?: {
-        willRetry?: boolean;
-    }): Promise<void>;
-    /** Move pending bash components from pending area to chat */
-    flushPendingBashComponents(): void;
-    findLastAssistantMessage(): AssistantMessage | undefined;
-    extractAssistantText(message: AssistantMessage): string;
-}
-export {};

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

@@ -1,15 +0,0 @@
-import { type KeywordHighlighter } from "./gradient-highlight";
-/** Hidden system notice appended after a user message that mentions "workflowz". */
-export declare const WORKFLOW_NOTICE: string;
-/**
- * Whether `text` contains the standalone keyword "workflowz"
- * (lowercase, whitespace-delimited) in prose — never inside a code block, inline
- * code span, or XML/HTML section.
- */
-export declare function containsWorkflow(text: string): boolean;
-/**
- * Highlight every standalone "workflowz" in `text` for editor display
- * with a warm amber→green gradient (hue 30..150), visually distinct from
- * ultrathink's rainbow and orchestrate's teal→violet.
- */
-export declare const highlightWorkflow: KeywordHighlighter;

package/dist/types/plan-mode/approved-plan-prompt.test.d.ts

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

package/dist/types/plan-mode/approved-plan.d.ts

@@ -1,68 +0,0 @@
-/** Shape forwarded from the plan-mode resolve handler to InteractiveMode's
- *  approval popup. Populated by the standing handler that the resolve tool
- *  dispatches to when the agent submits `resolve { action: "apply" }`.
- *  `planFilePath` is the agent-chosen `local://<slug>-plan.md` artifact — it is
- *  never renamed on approval, so links to it stay valid for the session. */
-export interface PlanApprovalDetails {
-    planFilePath: string;
-    title: string;
-    planExists: boolean;
-}
-/** Validate and normalize the agent-supplied plan title into a safe filename stem.
- *  Spaces and other URL-safe punctuation are replaced with hyphens so models that
- *  produce natural-language titles (e.g. "My feature plan") still succeed.
- *  Characters that cannot be safely represented after replacement are dropped.
- *  The result is restricted to letters, numbers, underscores, and hyphens so it
- *  is safe to splice into a `local://` URL without escaping. */
-export declare function normalizePlanTitle(title: string): {
-    title: string;
-    fileName: string;
-};
-/** Best-effort derivation of a plan title from inputs the agent already produced.
- *  Returns the first non-empty candidate that survives `normalizePlanTitle`:
- *    1. an explicit `suppliedTitle` (e.g. `extra.title` from the resolve call),
- *    2. the first level-1 markdown heading inside `planContent`,
- *    3. the filename stem of `planFilePath` (e.g. `PLAN` from `local://PLAN.md`),
- *    4. the literal `"plan"` so callers never have to handle `null`.
- *  The fallback exists because some grammar-constrained models cannot emit a
- *  string into the open `extra` schema and instead drop in `{}` (issue #1179);
- *  plan-mode would otherwise loop forever on an unreachable validation. */
-export declare function resolvePlanTitle(input: {
-    suppliedTitle?: unknown;
-    planContent: string;
-    planFilePath: string;
-}): {
-    title: string;
-    fileName: string;
-    source: "supplied" | "heading" | "filename" | "default";
-};
-/** Humanize a normalized plan title for use as a session display name.
- *  Replaces `-`/`_` separators with spaces and capitalizes the first letter.
- *  Returns an empty string when the input collapses to whitespace. */
-export declare function humanizePlanTitle(title: string): string;
-/** The `local://` URL a plan slug maps to. The agent writes the plan here and
- *  passes the slug to `resolve`; the file is never renamed, so this URL — and
- *  any hyperlink to it — stays valid for the life of the session. */
-export declare function planFileUrlForSlug(slug: string): string;
-export interface ResolveApprovedPlanInput {
-    /** The agent's `extra.title` from the `resolve` call, if any. */
-    suppliedTitle?: unknown;
-    /** The plan path recorded in plan-mode state (the entry default or a prior plan). */
-    statePlanFilePath: string;
-    /** Read a plan `local://` URL, returning null when the file does not exist. */
-    readPlan: (planUrl: string) => Promise<string | null>;
-    /** Optional fallback: list candidate plan `local://` URLs (newest first) so a
-     *  plan whose name can't be reconstructed (e.g. a dropped `extra.title`) is
-     *  still found. */
-    listPlanFiles?: () => Promise<string[]>;
-}
-export interface ResolvedApprovedPlan {
-    planFilePath: string;
-    planContent: string;
-    title: string;
-}
-/** Locate the plan file the agent wrote and finalize its title — without
- *  renaming anything. Tries, in order: the slug derived from `extra.title`
- *  (`local://<slug>-plan.md`), the plan path from plan-mode state, then a scan
- *  of recent plan files. Throws a `ToolError` guiding the agent when none exist. */
-export declare function resolveApprovedPlan(input: ResolveApprovedPlanInput): Promise<ResolvedApprovedPlan>;

package/dist/types/plan-mode/plan-handoff.d.ts

@@ -1,20 +0,0 @@
-import { type LocalProtocolOptions } from "../internal-urls";
-/** The session's active plan, resolved for handoff into a subagent's context. */
-export interface OverallPlanReference {
-    /** The `local://` reference path (e.g. `local://my-feature.md`), kept for display. */
-    path: string;
-    /** The full plan markdown, as written to disk. */
-    content: string;
-}
-/**
- * Load the session's active overall plan for subagent handoff.
- *
- * Returns the plan referenced by `planReferencePath` when it exists on disk with
- * non-empty content, or `undefined` when there is no plan (the file is absent or
- * empty). This mirrors `AgentSession.#buildPlanReferenceMessage`'s gating so a
- * subagent sees exactly the plan the main agent treats as its active reference.
- *
- * Callers MUST skip this during plan mode itself — read-only plan exploration
- * uses a different prompt and a draft plan should not be handed off as approved.
- */
-export declare function loadOverallPlanReference(planReferencePath: string, localProtocolOptions: LocalProtocolOptions): Promise<OverallPlanReference | undefined>;

package/dist/types/plan-mode/plan-protection.d.ts

@@ -1,12 +0,0 @@
-import { type ProtectedToolContext } from "jeopi-agent-core/compaction/tool-protection";
-/**
- * Build a compaction protection matcher that keeps `read` results for the active
- * plan file intact through prune/shake — the plan analog of skill-read
- * protection. Matches both the canonical `local://PLAN.md` alias and the
- * session's current plan reference path (the agent-chosen `local://<slug>-plan.md`),
- * so the plan survives compaction whether the agent reads it by alias or by name.
- *
- * `getPlanReferencePath` is evaluated at match time so the plan path set on
- * approval is honored immediately.
- */
-export declare function createPlanReadMatcher(getPlanReferencePath: () => string): (context: ProtectedToolContext) => boolean;

package/dist/types/plan-mode/state.d.ts

@@ -1,6 +0,0 @@
-export interface PlanModeState {
-    enabled: boolean;
-    planFilePath: string;
-    workflow?: "parallel" | "iterative";
-    reentry?: boolean;
-}

package/dist/types/registry/agent-lifecycle.d.ts

@@ -1,66 +0,0 @@
-/**
- * AgentLifecycleManager - Owns the idle → parked → revived lifecycle of
- * adopted subagents.
- *
- * The task executor hands a finished agent over via {@link AgentLifecycleManager.adopt};
- * from then on the manager arms a TTL timer whenever the agent goes `idle`,
- * parks it on expiry (disposes the live session, keeps the AgentRef +
- * sessionFile), and revives it on demand through
- * {@link AgentLifecycleManager.ensureLive}. Only this manager flips
- * `parked` ↔ `idle`.
- */
-import type { AgentSession } from "../session/agent-session";
-import { type AgentRef, AgentRegistry } from "./agent-registry";
-export type AgentReviver = () => Promise<AgentSession>;
-/**
- * Builds a reviver for a `parked` ref restored from disk (Agent Hub scan,
- * collab mirror, resumed process) that carries a sessionFile but no in-memory
- * adoption. Returns undefined when the ref cannot be faithfully rebuilt (no
- * persisted session contract, or its workspace is gone). Injected from the
- * top-level session so this manager stays free of sdk/SessionManager imports.
- */
-export type PersistedSubagentReviverFactory = (ref: AgentRef) => Promise<AgentReviver | undefined>;
-export interface AdoptOptions {
-    /** TTL before an idle agent is parked. <= 0 disables parking. */
-    idleTtlMs: number;
-    /** Recreates a live AgentSession from the ref's sessionFile. Absent => not resumable after park (e.g. isolated runs). */
-    revive?: AgentReviver;
-}
-export declare class AgentLifecycleManager {
-    #private;
-    static global(): AgentLifecycleManager;
-    /** Reset the global manager. Test-only. */
-    static resetGlobalForTests(): void;
-    constructor(registry?: AgentRegistry);
-    /**
-     * Install the factory used to cold-revive `parked` refs restored from disk
-     * (Agent Hub scan, collab mirror, resumed process) — they carry a sessionFile
-     * but no adoption. Set by the top-level session, which owns the ambient deps
-     * (auth, models, MCP, artifacts) the factory needs at revive time.
-     */
-    setPersistedSubagentReviverFactory(factory: PersistedSubagentReviverFactory, idleTtlMs: number): void;
-    /**
-     * Take ownership of a finished subagent. Caller has already set registry
-     * status to "idle". Arms the TTL timer (idleTtlMs <= 0 adopts without one).
-     */
-    adopt(id: string, opts: AdoptOptions): void;
-    /** True if the id is adopted (parked or live). */
-    has(id: string): boolean;
-    /** True while {@link park} is disposing this agent's session (lets dispose hooks distinguish park from teardown). */
-    isParking(id: string): boolean;
-    /**
-     * Dispose the live session, detach it from the registry, and mark the
-     * agent `parked`. No-op unless the id is adopted and live.
-     */
-    park(id: string): Promise<void>;
-    /**
-     * Return the live session, reviving from the sessionFile if parked.
-     * Throws a plain Error if the id is unknown or parked without a reviver.
-     * Concurrent calls share one in-flight revive.
-     */
-    ensureLive(id: string): Promise<AgentSession>;
-    /** Hard removal: dispose if live, unregister from registry, drop timers. */
-    release(id: string): Promise<void>;
-    /** Teardown everything (process exit / main session dispose). */
-    dispose(): Promise<void>;
-}

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

@@ -1,97 +0,0 @@
-/**
- * AgentRegistry - Process-global registry of agents (the main session plus
- * every subagent), keyed by stable id.
- *
- * Tracks each agent's status and (when live) its AgentSession so peers can be
- * addressed by id (`irc`, `task resume`, `history://`). Sessions are
- * registered explicitly at creation; finished agents stay registered as
- * `idle` (live) or `parked` (session disposed, ref + sessionFile retained for
- * revival) and are only removed on explicit release/teardown.
- */
-import type { AgentSession } from "../session/agent-session";
-export declare const MAIN_AGENT_ID = "Main";
-/**
- * - `running`: a turn is in flight.
- * - `idle`: live AgentSession in memory, awaiting work. Finished agents are
- *   `idle`, not removed.
- * - `parked`: session disposed; AgentRef + sessionFile retained, revivable.
- * - `aborted`: hard-killed, terminal.
- */
-export type AgentStatus = "running" | "idle" | "parked" | "aborted";
-/**
- * - `main`/`sub`: the user-facing agent tree (driving agent + task subagents).
- * - `advisor`: a passive review transcript persisted like a subagent for usage
- *   attribution and Agent Hub observability, but never a peer — hidden from
- *   agent-facing rosters (`irc`, `history://`) and not messageable/revivable.
- */
-export type AgentKind = "main" | "sub" | "advisor";
-export interface AgentRef {
-    id: string;
-    displayName: string;
-    kind: AgentKind;
-    parentId?: string;
-    status: AgentStatus;
-    /** Null exactly when parked/aborted. */
-    session: AgentSession | null;
-    sessionFile: string | null;
-    createdAt: number;
-    lastActivity: number;
-    /** Short gist of what the agent is currently doing (latest intent or tool), for the work-aware roster. Display-only. */
-    activity?: string;
-}
-export type RegistryEvent = {
-    type: "registered";
-    ref: AgentRef;
-} | {
-    type: "status_changed";
-    ref: AgentRef;
-} | {
-    type: "removed";
-    ref: AgentRef;
-};
-type RegistryListener = (event: RegistryEvent) => void;
-export interface RegisterInput {
-    id: string;
-    displayName: string;
-    kind: AgentKind;
-    parentId?: string;
-    session: AgentSession | null;
-    sessionFile?: string | null;
-    status?: AgentStatus;
-}
-export declare class AgentRegistry {
-    #private;
-    static global(): AgentRegistry;
-    /** Reset the global registry. Test-only. */
-    static resetGlobalForTests(): void;
-    register(input: RegisterInput): AgentRef;
-    setStatus(id: string, status: AgentStatus): void;
-    /**
-     * Record a short activity gist for the work-aware roster. Display-only and
-     * read on demand (`irc list`, peer roster), so it emits no event — keeping
-     * the per-tool-call update rate off the registry listener path (same as
-     * `attachSession`, which also bumps `lastActivity` without emitting). Only a
-     * `running` agent has current work: a heartbeat for any other status is
-     * dropped, so a late progress flush can't resurrect activity on a ref that
-     * `setStatus` just cleared. Every running heartbeat refreshes `lastActivity`
-     * — even when the gist text is unchanged — so the roster's "active … ago" and
-     * recency sort track real work, not just the last status change.
-     * The gist is normalized to one bounded line (`oneLineLabel`) so model-derived
-     * intent text can neither break the roster nor smuggle terminal escapes —
-     * every caller is safe without sanitizing at its own call site.
-     */
-    setActivity(id: string, activity: string): void;
-    attachSession(id: string, session: AgentSession, sessionFile?: string | null): void;
-    detachSession(id: string): void;
-    unregister(id: string): void;
-    get(id: string): AgentRef | undefined;
-    list(): AgentRef[];
-    /**
-     * Returns every alive agent (running | idle) except the caller. Advisor refs
-     * are observability-only transcripts, never peers, so they are excluded.
-     * Flat namespace: every other agent is visible.
-     */
-    listVisibleTo(id: string): AgentRef[];
-    onChange(listener: RegistryListener): () => void;
-}
-export {};