jeopi-cli 16.2.13 → 16.2.14

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

@@ -1,149 +0,0 @@
-/**
- * Feature definition for selective plugin installation.
- * Features allow plugins to expose optional functionality.
- */
-export interface PluginFeature {
-    /** Human-readable description */
-    description?: string;
-    /** Whether this feature is enabled by default */
-    default?: boolean;
-    /** Additional extension entry points provided by this feature */
-    extensions?: string[];
-    /** Additional tool entry points provided by this feature */
-    tools?: string[];
-    /** Additional hook entry points provided by this feature */
-    hooks?: string[];
-    /** Additional command files provided by this feature */
-    commands?: string[];
-}
-/**
- * Plugin manifest from package.json omp or pi field.
- */
-export interface PluginManifest {
-    /** Plugin display name (defaults to package name) */
-    name?: string;
-    /** Plugin version (copied from package.json version) */
-    version: string;
-    /** Human-readable description */
-    description?: string;
-    /** Entry point for base tools (relative path from package root) */
-    tools?: string;
-    /** Entry point for base hooks (relative path from package root) */
-    hooks?: string;
-    /** Extension entry points (relative paths from package root) */
-    extensions?: string[];
-    /** Command files (relative paths from package root) */
-    commands?: string[];
-    /** Feature definitions for selective installation */
-    features?: Record<string, PluginFeature>;
-    /** Settings schema for plugin configuration */
-    settings?: Record<string, PluginSettingSchema>;
-}
-export type PluginSettingType = "string" | "number" | "boolean" | "enum";
-interface PluginSettingBase {
-    /** Setting type */
-    type: PluginSettingType;
-    /** Human-readable description */
-    description?: string;
-    /** If true, mask value in UI and logs */
-    secret?: boolean;
-    /** Environment variable to use as fallback value */
-    env?: string;
-}
-export interface StringSetting extends PluginSettingBase {
-    type: "string";
-    default?: string;
-}
-export interface NumberSetting extends PluginSettingBase {
-    type: "number";
-    default?: number;
-    min?: number;
-    max?: number;
-    step?: number;
-}
-export interface BooleanSetting extends PluginSettingBase {
-    type: "boolean";
-    default?: boolean;
-}
-export interface EnumSetting extends PluginSettingBase {
-    type: "enum";
-    /** Allowed values */
-    values: string[];
-    default?: string;
-}
-export type PluginSettingSchema = StringSetting | NumberSetting | BooleanSetting | EnumSetting;
-/**
- * Represents an installed plugin with full metadata.
- */
-export interface InstalledPlugin {
-    /** npm package name */
-    name: string;
-    /** Installed version */
-    version: string;
-    /** Absolute path to package directory */
-    path: string;
-    /** Parsed omp/pi manifest */
-    manifest: PluginManifest;
-    /**
-     * Enabled features:
-     * - null: use defaults (all features with default: true)
-     * - string[]: specific features enabled
-     */
-    enabledFeatures: string[] | null;
-    /** Whether the plugin is enabled */
-    enabled: boolean;
-}
-/**
- * Per-plugin runtime state stored in lock file.
- */
-export interface PluginRuntimeState {
-    /** Installed version */
-    version: string;
-    /** Enabled features (null = defaults) */
-    enabledFeatures: string[] | null;
-    /** Whether the plugin is enabled */
-    enabled: boolean;
-}
-/**
- * Runtime configuration persisted to omp-plugins.lock.json.
- * Tracks plugin states and settings across sessions.
- */
-export interface PluginRuntimeConfig {
-    /** Plugin states keyed by package name */
-    plugins: Record<string, PluginRuntimeState>;
-    /** Plugin settings keyed by package name, then setting key */
-    settings: Record<string, Record<string, unknown>>;
-}
-/**
- * Project-local plugin overrides (stored in .omp/plugin-overrides.json).
- * Allows per-project plugin configuration without modifying global state.
- */
-export interface ProjectPluginOverrides {
-    /** Plugins to disable in this project */
-    disabled?: string[];
-    /** Per-plugin feature overrides */
-    features?: Record<string, string[]>;
-    /** Per-plugin setting overrides */
-    settings?: Record<string, Record<string, unknown>>;
-}
-export interface DoctorCheck {
-    /** Check identifier */
-    name: string;
-    /** Check result status */
-    status: "ok" | "warning" | "error";
-    /** Human-readable message */
-    message: string;
-    /** Whether --fix resolved this issue */
-    fixed?: boolean;
-}
-export interface InstallOptions {
-    /** Overwrite existing without prompting */
-    force?: boolean;
-    /** Preview changes without applying */
-    dryRun?: boolean;
-}
-export interface DoctorOptions {
-    /** Attempt automatic fixes */
-    fix?: boolean;
-}
-export {};

package/dist/types/extensibility/session-handler-types.d.ts

@@ -1,23 +0,0 @@
-/**
- * Session-lifecycle handler types shared by the extension runner and the hook
- * loader/runner. Both surfaces wire the same new-session / branch / navigate
- * handlers into their command contexts; this is the single source of truth.
- */
-import type { SessionManager } from "../session/session-manager";
-/** Handler for `ctx.newSession()` — creates (and optionally seeds) a session. */
-export type NewSessionHandler = (options?: {
-    parentSession?: string;
-    setup?: (sessionManager: SessionManager) => Promise<void>;
-}) => Promise<{
-    cancelled: boolean;
-}>;
-/** Handler for `ctx.branch()` — branches from a transcript entry. */
-export type BranchHandler = (entryId: string) => Promise<{
-    cancelled: boolean;
-}>;
-/** Handler for `ctx.navigateTree()` — navigates the session tree. */
-export type NavigateTreeHandler = (targetId: string, options?: {
-    summarize?: boolean;
-}) => Promise<{
-    cancelled: boolean;
-}>;

package/dist/types/extensibility/shared-events.d.ts

@@ -1,301 +0,0 @@
-/**
- * Event payload and result shapes shared between the extensions and hooks
- * subsystems.
- *
- * Both subsystems observe the same agent/session lifecycle, so the *event*
- * payloads (what happened) and the simpler *result* shapes (handler return
- * values that don't depend on subsystem-specific identifiers like
- * `AgentMessage` vs `Message`) are intentionally identical.
- *
- * Anything that diverges between the two subsystems — UI context, runtime
- * context, command context, tool-call discrimination, or return shapes that
- * carry subsystem-specific message types — lives in the per-subsystem
- * `types.ts` files and is documented there.
- */
-import type { AgentMessage } from "jeopi-agent-core";
-import type { CompactionPreparation, CompactionResult } from "jeopi-agent-core/compaction";
-import type { ImageContent, TextContent, ToolResultMessage } from "jeopi-ai";
-import type { Rule } from "../capability/rule";
-import type { Goal, GoalModeState } from "../goals/state";
-import type { BranchSummaryEntry, CompactionEntry, SessionEntry } from "../session/session-entries";
-import type { TodoItem } from "../tools/todo";
-/** Fired on initial session load */
-export interface SessionStartEvent {
-    type: "session_start";
-}
-/** Fired before switching to another session (can be cancelled) */
-export interface SessionBeforeSwitchEvent {
-    type: "session_before_switch";
-    /** Reason for the switch */
-    reason: "new" | "resume" | "fork";
-    /** Session file we're switching to (only for "resume") */
-    targetSessionFile?: string;
-}
-/** Fired after switching to another session */
-export interface SessionSwitchEvent {
-    type: "session_switch";
-    /** Reason for the switch */
-    reason: "new" | "resume" | "fork";
-    /** Session file we came from */
-    previousSessionFile: string | undefined;
-}
-/** Fired before branching a session (can be cancelled) */
-export interface SessionBeforeBranchEvent {
-    type: "session_before_branch";
-    /** ID of the entry to branch from */
-    entryId: string;
-}
-/** Fired after branching a session */
-export interface SessionBranchEvent {
-    type: "session_branch";
-    previousSessionFile: string | undefined;
-}
-/** Fired before context compaction (can be cancelled or customized) */
-export interface SessionBeforeCompactEvent {
-    type: "session_before_compact";
-    /** Compaction preparation with messages to summarize, file ops, previous summary, etc. */
-    preparation: CompactionPreparation;
-    /** Branch entries (root to current leaf). Use to inspect custom state or previous compactions. */
-    branchEntries: SessionEntry[];
-    /** Optional user-provided instructions for the summary */
-    customInstructions?: string;
-    /** Abort signal - handlers should pass this to LLM calls and check it periodically */
-    signal: AbortSignal;
-}
-/** Fired before compaction summarization to customize prompts/context */
-export interface SessionCompactingEvent {
-    type: "session.compacting";
-    sessionId: string;
-    messages: AgentMessage[];
-}
-/** Fired after context compaction */
-export interface SessionCompactEvent {
-    type: "session_compact";
-    compactionEntry: CompactionEntry;
-    /** Whether the compaction entry was provided by an extension/hook */
-    fromExtension: boolean;
-}
-/** Fired on process exit (SIGINT/SIGTERM) */
-export interface SessionShutdownEvent {
-    type: "session_shutdown";
-}
-/** Fired when a main-agent turn is about to settle; handlers may request one continuation turn. */
-export interface SessionStopEvent {
-    type: "session_stop";
-    messages: AgentMessage[];
-    turn_id: number;
-    last_assistant_message?: AgentMessage;
-    session_id: string;
-    session_file?: string;
-    stop_hook_active: boolean;
-}
-/** Preparation data for tree navigation (used by session_before_tree event) */
-export interface TreePreparation {
-    /** Node being switched to */
-    targetId: string;
-    /** Current active leaf (being abandoned), null if no current position */
-    oldLeafId: string | null;
-    /** Common ancestor of target and old leaf, null if no common ancestor */
-    commonAncestorId: string | null;
-    /** Entries to summarize (old leaf back to common ancestor or compaction) */
-    entriesToSummarize: SessionEntry[];
-    /** Whether user chose to summarize */
-    userWantsSummary: boolean;
-}
-/** Fired before navigating to a different node in the session tree (can be cancelled) */
-export interface SessionBeforeTreeEvent {
-    type: "session_before_tree";
-    /** Preparation data for the navigation */
-    preparation: TreePreparation;
-    /** Abort signal - honors Escape during summarization (model available via ctx.model) */
-    signal: AbortSignal;
-}
-/** Fired after navigating to a different node in the session tree */
-export interface SessionTreeEvent {
-    type: "session_tree";
-    /** The new active leaf, null if navigated to before first entry */
-    newLeafId: string | null;
-    /** Previous active leaf, null if there was no position */
-    oldLeafId: string | null;
-    /** Branch summary entry if one was created */
-    summaryEntry?: BranchSummaryEntry;
-    /** Whether summary came from extension/hook */
-    fromExtension?: boolean;
-}
-/** Union of all session event types */
-export interface GoalUpdatedEvent {
-    type: "goal_updated";
-    goal: Goal | null;
-    state?: GoalModeState;
-}
-export type SessionEvent = SessionStartEvent | SessionBeforeSwitchEvent | SessionSwitchEvent | SessionBeforeBranchEvent | SessionBranchEvent | SessionBeforeCompactEvent | SessionCompactingEvent | SessionCompactEvent | SessionStopEvent | SessionShutdownEvent | SessionBeforeTreeEvent | SessionTreeEvent | GoalUpdatedEvent;
-/**
- * Fired before each LLM call.
- *
- * Original session messages are NOT modified - only the messages sent to the
- * LLM are affected when a handler returns a replacement (the return shape
- * differs between extensions and hooks; see each subsystem's
- * `ContextEventResult`).
- */
-export interface ContextEvent {
-    type: "context";
-    /** Messages about to be sent to the LLM (deep copy, safe to modify) */
-    messages: AgentMessage[];
-}
-/**
- * Fired when an agent loop starts (once per user prompt).
- */
-export interface AgentStartEvent {
-    type: "agent_start";
-}
-/** Fired when an agent loop ends */
-export interface AgentEndEvent {
-    type: "agent_end";
-    messages: AgentMessage[];
-}
-/** Fired at the start of each turn */
-export interface TurnStartEvent {
-    type: "turn_start";
-    turnIndex: number;
-    timestamp: number;
-}
-/** Fired at the end of each turn */
-export interface TurnEndEvent {
-    type: "turn_end";
-    turnIndex: number;
-    message: AgentMessage;
-    toolResults: ToolResultMessage[];
-}
-/** Fired when auto-compaction starts */
-export interface AutoCompactionStartEvent {
-    type: "auto_compaction_start";
-    reason: "threshold" | "overflow" | "idle" | "incomplete";
-    action: "context-full" | "handoff" | "shake" | "snapcompact";
-}
-/** Fired when auto-compaction ends */
-export interface AutoCompactionEndEvent {
-    type: "auto_compaction_end";
-    action: "context-full" | "handoff" | "shake" | "snapcompact";
-    result: CompactionResult | undefined;
-    aborted: boolean;
-    willRetry: boolean;
-    errorMessage?: string;
-    /** True when compaction was skipped for a benign reason (no model, no candidates, nothing to compact). */
-    skipped?: boolean;
-}
-/** Fired when auto-retry starts */
-export interface AutoRetryStartEvent {
-    type: "auto_retry_start";
-    attempt: number;
-    maxAttempts: number;
-    delayMs: number;
-    errorMessage: string;
-    errorId?: number;
-}
-/** Fired when auto-retry ends */
-export interface AutoRetryEndEvent {
-    type: "auto_retry_end";
-    success: boolean;
-    attempt: number;
-    finalError?: string;
-}
-/** Fired when TTSR rule matching interrupts generation */
-export interface TtsrTriggeredEvent {
-    type: "ttsr_triggered";
-    rules: Rule[];
-}
-/** Fired when todo reminder logic detects unfinished todos */
-export interface TodoReminderEvent {
-    type: "todo_reminder";
-    todos: TodoItem[];
-    attempt: number;
-    maxAttempts: number;
-}
-/**
- * Return type for `tool_call` handlers.
- * Allows handlers to block tool execution.
- */
-export interface ToolCallEventResult {
-    /** If true, block the tool from executing */
-    block?: boolean;
-    /** Reason for blocking (returned to LLM as error) */
-    reason?: string;
-}
-/**
- * Return type for `tool_result` handlers.
- * Allows handlers to modify tool results.
- */
-export interface ToolResultEventResult {
-    /** Replacement content array (text and images) */
-    content?: (TextContent | ImageContent)[];
-    /** Replacement details */
-    details?: unknown;
-    /** Override isError flag */
-    isError?: boolean;
-}
-/** Return type for `session_before_switch` handlers */
-export interface SessionBeforeSwitchResult {
-    /** If true, cancel the switch */
-    cancel?: boolean;
-}
-/** Return type for `session_before_branch` handlers */
-export interface SessionBeforeBranchResult {
-    /**
-     * If true, abort the branch entirely. No new session file is created,
-     * conversation stays unchanged.
-     */
-    cancel?: boolean;
-    /**
-     * If true, the branch proceeds (new session file created, session state updated)
-     * but the in-memory conversation is NOT rewound to the branch point.
-     *
-     * Use case: git-checkpoint handler that restores code state separately.
-     * The handler handles state restoration itself, so it doesn't want the
-     * agent's conversation to be rewound (which would lose recent context).
-     *
-     * - `cancel: true` → nothing happens, user stays in current session
-     * - `skipConversationRestore: true` → branch happens, but messages stay as-is
-     * - neither → branch happens AND messages rewind to branch point (default)
-     */
-    skipConversationRestore?: boolean;
-}
-/** Return type for `session_before_compact` handlers */
-export interface SessionBeforeCompactResult {
-    /** If true, cancel the compaction */
-    cancel?: boolean;
-    /** Custom compaction result - SessionManager adds id/parentId */
-    compaction?: CompactionResult;
-}
-/** Return type for `session.compacting` handlers */
-export interface SessionCompactingResult {
-    /** Additional context lines to include in summary */
-    context?: string[];
-    /** Override the default compaction prompt */
-    prompt?: string;
-    /** Custom data to store in compaction entry */
-    preserveData?: Record<string, unknown>;
-}
-/** Return type for `session_stop` handlers */
-export interface SessionStopEventResult {
-    /** Continue the main session with additional context before settling */
-    continue?: boolean;
-    /** OMP-native model-visible context for the continuation */
-    additionalContext?: string;
-    /** Claude/Codex-compatible block decision; maps to a continuation */
-    decision?: "block";
-    /** Claude/Codex-compatible model-visible continuation reason */
-    reason?: string;
-}
-/** Return type for `session_before_tree` handlers */
-export interface SessionBeforeTreeResult {
-    /** If true, cancel the navigation entirely */
-    cancel?: boolean;
-    /**
-     * Custom summary (skips default summarizer).
-     * Only used if preparation.userWantsSummary is true.
-     */
-    summary?: {
-        summary: string;
-        details?: unknown;
-    };
-}

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

@@ -1,97 +0,0 @@
-import type { SourceMeta } from "../capability/types";
-import type { SkillsSettings } from "../config/settings";
-import type { SkillPromptDetails } from "../session/messages";
-export interface Skill {
-    name: string;
-    description: string;
-    filePath: string;
-    baseDir: string;
-    source: string;
-    /**
-     * When `true`, the skill is loaded and reachable via `skill://<name>` and
-     * (when enabled) `/skill:<name>`, but is excluded from the rendered system
-     * prompt's `<skills>` listing.
-     */
-    hide?: boolean;
-    /** Source metadata for display */
-    _source?: SourceMeta;
-}
-export interface SkillWarning {
-    skillPath: string;
-    message: string;
-}
-export interface LoadSkillsResult {
-    skills: Skill[];
-    warnings: SkillWarning[];
-}
-/**
- * Process-global snapshot of skills the active session loaded.
- * Read by internal URL protocol handlers (skill://).
- */
-export declare function getActiveSkills(): readonly Skill[];
-/** Replace the active skill snapshot. Called once per top-level session. */
-export declare function setActiveSkills(value: readonly Skill[]): void;
-/** Reset the active skill snapshot. Test-only. */
-export declare function resetActiveSkillsForTests(): void;
-/**
- * Whether `name` is already claimed by an active authored (non-managed) skill.
- *
- * Managed (auto-learn) skills resolve dead-last in discovery, so an authored
- * skill of the same name always wins (see `loadSkills`) and a managed skill
- * written under an authored name is silently dropped — it never surfaces.
- * `manage_skill` create consults this to refuse the write up front instead of
- * reporting a false "Created" for a skill that can never appear.
- */
-export declare function isNameClaimedByAuthoredSkill(name: string): boolean;
-export interface LoadSkillsFromDirOptions {
-    /** Directory to scan for skills */
-    dir: string;
-    /** Source identifier for these skills */
-    source: string;
-}
-export declare function loadSkillsFromDir(options: LoadSkillsFromDirOptions): Promise<LoadSkillsResult>;
-export interface LoadSkillsOptions extends SkillsSettings {
-    /** Working directory for project-local skills. Default: getProjectDir() */
-    cwd?: string;
-}
-/**
- * Load skills from all configured locations.
- * Returns skills and any validation warnings.
- */
-export declare function loadSkills(options?: LoadSkillsOptions): Promise<LoadSkillsResult>;
-export interface BuiltSkillPromptMessage {
-    message: string;
-    details: SkillPromptDetails;
-}
-export declare function getSkillSlashCommandName(skill: Pick<Skill, "name">): string;
-/**
- * Parsed `/skill:<name>` invocation: either at the start of the draft (the
- * traditional slash-command position) or as a `/skill:<name>` token embedded
- * mid-prompt. For the mid-prompt form the surrounding prose is threaded
- * through as `args` so the skill sees the full user request.
- */
-export interface ParsedSkillInvocation {
-    /** Bare skill name without the leading `skill:` prefix. */
-    name: string;
-    /** User-supplied arguments (everything outside the `/skill:<name>` token). */
-    args: string;
-}
-/**
- * Detect a `/skill:<name>` invocation in a user draft.
- *
- * Returns `undefined` when the text contains no skill token. Otherwise:
- *   - Leading form (`/skill:foo bar baz`): name=`foo`, args=`bar baz`.
- *   - Mid-prompt form (`fix the bug /skill:foo focus on auth`): name=`foo`,
- *     args=`fix the bug focus on auth` — the surrounding prose collapsed
- *     into a single args string.
- *
- * Mid-prompt detection is disabled when the draft itself starts with a
- * different slash command (e.g. `/compact /skill:foo`) or a local-execution
- * sigil — `!cmd` / `!!cmd` for the bash tool and `$ cmd` / `$$ cmd` for the
- * python tool. Those handlers run after the skill-command dispatcher and
- * their bodies routinely contain `/skill:<name>` references that are not
- * meant as skill invocations.
- */
-export declare function parseSkillInvocation(text: string): ParsedSkillInvocation | undefined;
-export type SkillInvocationKind = "user" | "autoload";
-export declare function buildSkillPromptMessage(skill: Pick<Skill, "name" | "filePath" | "baseDir">, args: string, invocation?: SkillInvocationKind): Promise<BuiltSkillPromptMessage>;

package/dist/types/extensibility/slash-commands.d.ts

@@ -1,38 +0,0 @@
-export type SlashCommandSource = "extension" | "prompt" | "skill";
-export type SlashCommandLocation = "user" | "project" | "path";
-export interface SlashCommandInfo {
-    name: string;
-    description?: string;
-    source: SlashCommandSource;
-    location?: SlashCommandLocation;
-    path?: string;
-}
-export type { BuiltinSlashCommand, SubcommandDef } from "../slash-commands/types";
-/**
- * Represents a custom slash command loaded from a file
- */
-export interface FileSlashCommand {
-    name: string;
-    description: string;
-    content: string;
-    source: string;
-    /** Source metadata for display */
-    _source?: {
-        providerName: string;
-        level: "user" | "project" | "native";
-    };
-}
-export interface LoadSlashCommandsOptions {
-    /** Working directory for project-local commands. Default: getProjectDir() */
-    cwd?: string;
-}
-/**
- * Load all custom slash commands using the capability API.
- * Loads from all registered providers (builtin, user, project).
- */
-export declare function loadSlashCommands(options?: LoadSlashCommandsOptions): Promise<FileSlashCommand[]>;
-/**
- * Expand a slash command if it matches a file-based command.
- * Returns the expanded content or the original text if not a slash command.
- */
-export declare function expandSlashCommand(text: string, fileCommands: FileSlashCommand[]): string;

package/dist/types/extensibility/tool-event-input.d.ts

@@ -1,9 +0,0 @@
-interface ToolEventInputResolver {
-    name: string;
-    resolveEventInput?: (input: string) => string;
-}
-/** Resolves mode-specific textual tool input before extension/hook event normalization. */
-export declare function resolveToolEventInput(tool: ToolEventInputResolver, input: Record<string, unknown>): Record<string, unknown>;
-/** Adds derived compatibility fields to tool event input without changing tool execution parameters. */
-export declare function normalizeToolEventInput(toolName: string, input: Record<string, unknown>): Record<string, unknown>;
-export {};

package/dist/types/extensibility/tool-proxy.d.ts

@@ -1,4 +0,0 @@
-/**
- * Defines lazy proxy properties on a wrapper so it forwards to the underlying tool.
- */
-export declare function applyToolProxy<TTool extends object>(tool: TTool, wrapper: object): void;