@oni.bot/core 0.8.0 → 1.0.0

package/dist/oni-code/conductor.d.ts

@@ -0,0 +1,203 @@
+/**
+ * Conductor Agent — the core integration that wires ONIHarness with coding
+ * tools, dispatch tools, workspace awareness, and permissions.
+ *
+ * The Conductor is the main conversational agent for the `oni` CLI. It handles
+ * simple tasks directly and escalates to subagents/swarms for complex work.
+ *
+ * Unlike single-shot harness usage, the Conductor maintains conversation
+ * history across turns so the agent remembers prior context.
+ */
+import type { LoopMessage, ToolMetadataUpdate } from "../harness/types.js";
+import type { ONIModel } from "../models/types.js";
+import type { ToolDefinition } from "../tools/types.js";
+import { LSPManager } from "../lsp/index.js";
+import { type SwarmRunner } from "./tools/spawn-swarm.js";
+import { ChangeTracker } from "./workspace/change-tracker.js";
+import { PermissionManager, type PermissionMode, type PermissionDecision } from "./permissions.js";
+import { BackgroundScheduler } from "./scheduler.js";
+import { CronScheduler } from "./cron/index.js";
+import { LoopDetector } from "./loop-detector.js";
+import { AgentRegistry } from "./agent-registry.js";
+import type { ONICodeConfig } from "./config.js";
+import { SessionTree, type BranchInfo } from "./session-fork.js";
+import { TaskEvaluator } from "./task-evaluator.js";
+import { SessionStats } from "./session-stats.js";
+import { EventBus } from "../events/bus.js";
+import { FileWatcher } from "./file-watcher.js";
+import { FileSnapshots } from "./workspace/file-snapshots.js";
+import { SkillLoader } from "../harness/skill-loader.js";
+import { ProgressTracker } from "./progress-tracker.js";
+export interface ConductorConfig {
+    model: ONIModel;
+    fastModel?: ONIModel;
+    rootDir: string;
+    mode?: PermissionMode;
+    swarmRunner?: SwarmRunner;
+    eventBus?: EventBus;
+    maxTurns?: number;
+    maxTokens?: number;
+    debug?: boolean;
+    /** Resume a previous session by ID */
+    resumeSession?: string;
+    /** Loaded ONI config — applies agent definitions, permission rules, swarm defaults */
+    oniConfig?: ONICodeConfig;
+    /** Custom tools loaded from .oni/tools/ — passed in from bin.ts after async loading */
+    customTools?: ToolDefinition[];
+    /**
+     * Maximum time (ms) to wait for a single model inference call.
+     * Prevents the agent from hanging indefinitely on slow/stuck models.
+     * Default: 120_000 (2 minutes). Set to 0 to disable.
+     */
+    inferenceTimeoutMs?: number;
+}
+export declare class Conductor {
+    private readonly config;
+    private readonly rootDir;
+    private readonly permissions;
+    private readonly changeTracker;
+    private readonly fileSnapshots;
+    private readonly swarmRunner;
+    private readonly swarmRunnerPublishesLifecycle;
+    private readonly tools;
+    private readonly todoModule;
+    private readonly hooksEngine;
+    private readonly compactor;
+    private readonly scheduler;
+    private readonly loopDetector;
+    private readonly lspManager;
+    private readonly cronScheduler;
+    readonly agentRegistry: AgentRegistry;
+    private readonly taskEvaluator;
+    readonly sessionStats: SessionStats;
+    private readonly eventBus;
+    private readonly fileWatcher;
+    private readonly titleGenerator;
+    private readonly skillLoader;
+    private readonly progressTracker;
+    private readonly autoCompactionEnabled;
+    /** Cached context files content (CLAUDE.md, AGENTS.md, .cursorrules) */
+    private readonly contextFilesBlock;
+    /** Prebuilt tool set for subagents — coding + web + custom, no orchestration tools */
+    readonly subagentTools: ToolDefinition[];
+    /** Accumulated conversation history across turns */
+    private conversationHistory;
+    private turnCount;
+    /** Session tree for branch-based conversation management */
+    private readonly sessionTree;
+    /** Active agent name — determines system prompt and tool scoping */
+    private activeAgent;
+    /** Cached assembled system prompt (base + context files + skills). Invalidated on agent switch. */
+    private _cachedSystemPrompt;
+    private _cachedPromptAgent;
+    private _cachedSkillVersion;
+    private _projectMapDirty;
+    /** Guard: true while chat() generator is executing. Prevents the background
+     *  scheduler from compacting conversationHistory while the agentLoop holds
+     *  a reference to it — otherwise the scheduler's compaction gets silently
+     *  overwritten when the agentLoop yields finalMessages. */
+    private _chatActive;
+    private _stopNudgeCount;
+    /** Session-level circuit breaker: consecutive chat() calls that ended in inference error.
+     *  After 3 consecutive failures (9+ total retries), we stop attempting inference and
+     *  tell the user the provider appears down. Resets on any successful inference. */
+    private _consecutiveInferenceFailures;
+    private static readonly INFERENCE_FAILURE_THRESHOLD;
+    private permissionListener;
+    private questionListener;
+    private toolMetadataListener;
+    constructor(config: ConductorConfig);
+    chat(message: string, opts?: {
+        signal?: AbortSignal;
+    }): AsyncGenerator<LoopMessage>;
+    chatToResult(message: string): Promise<string>;
+    getPermissions(): PermissionManager;
+    setPermissionListener(listener: ((toolName: string, args: Record<string, unknown>, resolve: (decision: PermissionDecision) => void) => void) | null): void;
+    setQuestionListener(listener: ((question: string, resolve: (answer: string | null) => void) => void) | null): void;
+    setToolMetadataListener(listener: ((toolCallId: string, toolName: string, update: ToolMetadataUpdate) => void) | null): void;
+    /** Get the active agent name */
+    getActiveAgent(): string;
+    /** Switch the active agent. Takes effect on the next chat() call. */
+    switchAgent(name: string): void;
+    /** Get the auto-generated session title (null if not yet generated). */
+    getSessionTitle(): string | null;
+    getChangeTracker(): ChangeTracker;
+    getFileSnapshots(): FileSnapshots;
+    getTurnCount(): number;
+    /** Get loaded context files content (CLAUDE.md, AGENTS.md, .cursorrules). Empty string if none found. */
+    getContextFiles(): string;
+    /** Get the durable session progress snapshot used across restarts/compaction. */
+    getProgressTracker(): ProgressTracker;
+    /** Get the skill loader for external skill registration and invocation */
+    getSkillLoader(): SkillLoader;
+    /** Get the currently available tool names for UI display. */
+    getAvailableToolNames(): string[];
+    /** Get the currently loaded skill names for UI display. */
+    getAvailableSkillNames(): string[];
+    /** Get configured MCP server names from ONI config. */
+    getConfiguredMCPServerNames(): string[];
+    /** Invoke a skill by name with optional arguments — queues for next turn */
+    invokeSkill(name: string, args?: string): boolean;
+    getHistoryLength(): number;
+    clearHistory(): void;
+    /**
+     * Fork the current conversation at a specific message index.
+     * Creates a new branch with messages [0..atIndex-1].
+     * If atIndex is omitted, forks at the current end.
+     * Returns the new branch ID.
+     */
+    forkSession(atIndex?: number, label?: string): string;
+    /**
+     * Switch to a different conversation branch.
+     * Updates the internal history to the branch's messages.
+     */
+    switchBranch(branchId: string): void;
+    /**
+     * List all conversation branches with summary info.
+     */
+    listBranches(): BranchInfo[];
+    /**
+     * Get the active branch ID.
+     */
+    getActiveBranchId(): string;
+    /**
+     * Delete a branch. Cannot delete the root.
+     * If cascade is true, also deletes all children.
+     */
+    deleteBranch(branchId: string, cascade?: boolean): boolean;
+    /**
+     * Get the session tree for advanced operations (serialization, etc.).
+     */
+    getSessionTree(): SessionTree;
+    /** Get session statistics (tool calls, tokens, compactions, errors). */
+    getSessionStats(): SessionStats;
+    /** Get the background scheduler for registering periodic tasks. */
+    getScheduler(): BackgroundScheduler;
+    /** Get the loop detector for inspection or configuration. */
+    getLoopDetector(): LoopDetector;
+    /** Get the event bus for subscribing to lifecycle events. */
+    getEventBus(): EventBus;
+    /** Get the file watcher for reactive file change detection. */
+    getFileWatcher(): FileWatcher;
+    /** Get the cron scheduler for managing recurring prompts. */
+    getCronScheduler(): CronScheduler;
+    /** Stop all background tasks and release resources.
+     *  Each cleanup step is isolated — a failure in one (e.g. corrupted
+     *  file handle, dead LSP process) must not prevent the others from
+     *  running, or resources leak (timers, child processes, listeners). */
+    dispose(): void;
+    /** Get the LSP manager for inspection or external use. */
+    getLSPManager(): LSPManager;
+    /** Get the task evaluator for inspection or testing. */
+    getTaskEvaluator(): TaskEvaluator;
+    /** Manually trigger context compaction. Returns before/after message counts. */
+    compactContext(): Promise<{
+        before: number;
+        after: number;
+    } | null>;
+    private runSubagent;
+    private buildProjectMapTool;
+    private syncProgressSnapshot;
+    private persistProgressSnapshot;
+}
+//# sourceMappingURL=conductor.d.ts.map

package/dist/oni-code/conductor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conductor.d.ts","sourceRoot":"","sources":["../../src/oni-code/conductor.ts"],"names":[],"mappings":"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"}