@orion-agents/orion-code 0.1.0

package/dist/runtime/tool-output-presentation.js

@@ -0,0 +1,329 @@
+"use strict";
+/**
+ * v0.2.23 — Tool Output Presentation Policy.
+ *
+ * Renderer-neutral pure function that creates a ToolOutputView from raw
+ * tool output. Terminal adapter continues to use full output; only TUI
+ * applies the adaptive/collapsed/full collapse policy.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TOOL_OUTPUT_POLICY = void 0;
+exports.createToolOutputView = createToolOutputView;
+exports.tryParseAggregateOutput = tryParseAggregateOutput;
+const redaction_1 = require("../services/redaction");
+exports.DEFAULT_TOOL_OUTPUT_POLICY = {
+    mode: 'adaptive',
+    inlineMaxLines: 3,
+    inlineMaxBytes: 512,
+    previewMaxLines: 4,
+    previewMaxBytes: 1024,
+    errorPreviewMaxLines: 8,
+    errorPreviewMaxBytes: 2048,
+};
+// ============================================================================
+// Known noisy aggregate tool names — always collapsed.
+// ============================================================================
+const ALWAYS_COLLAPSE_TOOLS = new Set([
+    'batch_read',
+    'batch_write',
+    'batch_edit',
+]);
+function createToolOutputView(input) {
+    const { toolName, success, summary, rawOutput, outputBytes, callId, sequence, policy } = input;
+    const contentKind = classifyContent(toolName, rawOutput);
+    const sanitized = sanitizeForPreview(rawOutput);
+    const outputLines = countLines(sanitized);
+    const detailRef = {
+        callId,
+        sequence,
+        turnId: input.turnId,
+        artifactId: input.artifactRef?.id,
+        outputBytes,
+        outputLines,
+    };
+    const defaultSummary = (0, redaction_1.redactTraceText)(summary ?? `${success ? '✓' : '✗'} ${toolName}`);
+    const aggregate = tryParseAggregateOutput(toolName, rawOutput, detailRef);
+    // Full mode: everything inline.
+    if (policy.mode === 'full') {
+        return {
+            mode: 'inline',
+            contentKind,
+            summary: defaultSummary,
+            preview: sanitized,
+            previewBytes: outputBytes,
+            omittedBytes: 0,
+            omittedLines: 0,
+            detailRef,
+            aggregate: aggregate ?? undefined,
+        };
+    }
+    // Collapsed mode: no preview.
+    if (policy.mode === 'collapsed') {
+        return {
+            mode: 'collapsed',
+            contentKind,
+            summary: defaultSummary,
+            preview: '',
+            previewBytes: 0,
+            omittedBytes: outputBytes,
+            omittedLines: outputLines,
+            detailRef,
+            aggregate: aggregate ?? undefined,
+        };
+    }
+    // Adaptive mode: decide based on size and tool type.
+    const view = computeAdaptiveView({
+        toolName,
+        success,
+        defaultSummary,
+        sanitized,
+        outputBytes,
+        outputLines,
+        detailRef,
+        policy,
+    });
+    return aggregate ? { ...view, contentKind: 'batch', aggregate } : view;
+}
+function computeAdaptiveView(input) {
+    const { toolName, success, defaultSummary, sanitized, outputBytes, outputLines, detailRef, policy } = input;
+    // Empty output.
+    if (!sanitized || outputBytes === 0) {
+        return {
+            mode: 'collapsed',
+            contentKind: 'text',
+            summary: defaultSummary,
+            preview: '',
+            previewBytes: 0,
+            omittedBytes: 0,
+            omittedLines: 0,
+            detailRef,
+        };
+    }
+    // Always collapse known noisy tools.
+    if (ALWAYS_COLLAPSE_TOOLS.has(toolName)) {
+        const preview = truncatePreview(sanitized, policy.previewMaxLines, policy.previewMaxBytes);
+        return {
+            mode: 'collapsed',
+            contentKind: 'batch',
+            summary: defaultSummary,
+            preview,
+            previewBytes: Buffer.byteLength(preview, 'utf8'),
+            omittedBytes: Math.max(0, outputBytes - Buffer.byteLength(preview, 'utf8')),
+            omittedLines: Math.max(0, outputLines - countLines(preview)),
+            detailRef,
+        };
+    }
+    // Error: larger preview.
+    if (!success) {
+        const maxLines = policy.errorPreviewMaxLines;
+        const maxBytes = policy.errorPreviewMaxBytes;
+        const preview = truncatePreview(sanitized, maxLines, maxBytes);
+        const previewBytes = Buffer.byteLength(preview, 'utf8');
+        return {
+            mode: 'preview',
+            contentKind: classifyContent(toolName, sanitized),
+            summary: defaultSummary,
+            preview,
+            previewBytes,
+            omittedBytes: Math.max(0, outputBytes - previewBytes),
+            omittedLines: Math.max(0, outputLines - countLines(preview)),
+            detailRef,
+        };
+    }
+    // Small output: inline full.
+    if (outputLines <= policy.inlineMaxLines && outputBytes <= policy.inlineMaxBytes) {
+        return {
+            mode: 'inline',
+            contentKind: classifyContent(toolName, sanitized),
+            summary: defaultSummary,
+            preview: sanitized,
+            previewBytes: outputBytes,
+            omittedBytes: 0,
+            omittedLines: 0,
+            detailRef,
+        };
+    }
+    // Large output: preview.
+    const preview = truncatePreview(sanitized, policy.previewMaxLines, policy.previewMaxBytes);
+    const previewBytes = Buffer.byteLength(preview, 'utf8');
+    return {
+        mode: 'preview',
+        contentKind: classifyContent(toolName, sanitized),
+        summary: defaultSummary,
+        preview,
+        previewBytes,
+        omittedBytes: Math.max(0, outputBytes - previewBytes),
+        omittedLines: Math.max(0, outputLines - countLines(preview)),
+        detailRef,
+    };
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function classifyContent(toolName, output) {
+    if (ALWAYS_COLLAPSE_TOOLS.has(toolName))
+        return 'batch';
+    if (!output.trim())
+        return 'text';
+    const trimmed = output.trimStart();
+    if (trimmed.startsWith('{') || trimmed.startsWith('['))
+        return 'json';
+    if (trimmed.startsWith('diff ') || trimmed.includes('\n@@ '))
+        return 'diff';
+    return 'text';
+}
+/**
+ * Strip terminal control sequences but preserve safe SGR.
+ * OSC, cursor movement, erase, and alternate-screen sequences are removed.
+ */
+function sanitizeForPreview(text) {
+    return (0, redaction_1.redactTraceText)(text)
+        .replace(/\x1b\][^\x07\x1b]*(\x07|\x1b\\)/g, '') // OSC
+        .replace(/\x1b\[[0-?]*[ -/]*[@-~]/g, match => {
+        // Keep only SGR (final 'm').
+        if (match.endsWith('m'))
+            return match;
+        return '';
+    })
+        .replace(/[\x00-\x08\x0b\x0c\x0e-\x1f\x7f]/g, '');
+}
+function countLines(text) {
+    if (!text)
+        return 0;
+    return text.split('\n').length;
+}
+/**
+ * Truncate text to fit within line and byte limits without splitting
+ * grapheme clusters or producing lone surrogates.
+ */
+function truncatePreview(text, maxLines, maxBytes) {
+    if (!text)
+        return '';
+    // Truncate by lines first.
+    const lines = text.split('\n');
+    const visibleLines = lines.slice(0, maxLines);
+    const result = visibleLines.join('\n');
+    // Truncate by bytes.
+    let byteCount = 0;
+    let output = '';
+    for (const char of result) {
+        const charBytes = Buffer.byteLength(char, 'utf8');
+        if (byteCount + charBytes > maxBytes)
+            break;
+        output += char;
+        byteCount += charBytes;
+    }
+    // Avoid lone surrogate at boundary.
+    if (output.length > 0) {
+        const lastCode = output.charCodeAt(output.length - 1);
+        if (lastCode >= 0xd800 && lastCode <= 0xdbff) {
+            output = output.slice(0, -1);
+        }
+    }
+    return output;
+}
+/**
+ * Try to parse a known aggregate tool result into a structured view.
+ * Returns null if the output doesn't match any known schema.
+ */
+function tryParseAggregateOutput(toolName, rawOutput, detailRef) {
+    if (toolName === 'batch_read') {
+        return parseBatchReadOutput(rawOutput, detailRef);
+    }
+    if (toolName === 'subtask' || toolName === 'subtask_batch') {
+        return parseSubtaskBatchOutput(rawOutput, detailRef);
+    }
+    return null;
+}
+function parseBatchReadOutput(rawOutput, parentDetailRef) {
+    try {
+        const parsed = JSON.parse(rawOutput);
+        if (!parsed || typeof parsed !== 'object')
+            return null;
+        // Expected shape: { success: boolean, output: string, summary: string, steps?: [...] }
+        const steps = Array.isArray(parsed.steps) ? parsed.steps : [];
+        if (steps.length === 0 && !parsed.summary)
+            return null;
+        const stepSummaries = steps.map((step, index) => {
+            const skipped = step.skipped === true || step.state === 'skipped';
+            const success = !skipped && step.success !== false;
+            const args = isRecord(step.args) ? step.args : undefined;
+            const target = firstString(step.target, args?.path, args?.filePath, args?.directory);
+            const output = typeof step.output === 'string' ? step.output : '';
+            return {
+                index: typeof step.index === 'number' ? step.index : index + 1,
+                toolName: String(step.tool ?? step.toolName ?? 'unknown'),
+                state: skipped ? 'skipped' : success ? 'success' : 'error',
+                target: target ? (0, redaction_1.redactTraceText)(target) : undefined,
+                summary: (0, redaction_1.redactTraceText)(String(step.summary ?? summarizeOutput(output))),
+                outputBytes: typeof step.outputBytes === 'number'
+                    ? step.outputBytes
+                    : Buffer.byteLength(output, 'utf8'),
+                detailRef: parentDetailRef,
+            };
+        });
+        const succeeded = stepSummaries.filter(s => s.state === 'success').length;
+        const failed = stepSummaries.filter(s => s.state === 'error').length;
+        const skipped = stepSummaries.filter(s => s.state === 'skipped').length;
+        return {
+            version: 1,
+            kind: 'batch_read',
+            total: stepSummaries.length,
+            succeeded,
+            failed,
+            skipped,
+            steps: stepSummaries,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function parseSubtaskBatchOutput(rawOutput, parentDetailRef) {
+    try {
+        const parsed = JSON.parse(rawOutput);
+        if (!isRecord(parsed) || !Array.isArray(parsed.results))
+            return null;
+        const steps = parsed.results.map((value, index) => {
+            const result = isRecord(value) ? value : {};
+            const status = String(result.status ?? 'completed');
+            const state = status === 'skipped'
+                ? 'skipped'
+                : status === 'completed' || status === 'success'
+                    ? 'success'
+                    : 'error';
+            const summary = typeof result.summary === 'string' ? result.summary : status;
+            return {
+                index: index + 1,
+                toolName: String(result.role ?? 'subtask'),
+                state,
+                target: typeof result.id === 'string' ? (0, redaction_1.redactTraceText)(result.id) : undefined,
+                summary: (0, redaction_1.redactTraceText)(summarizeOutput(summary)),
+                outputBytes: Buffer.byteLength(summary, 'utf8'),
+                detailRef: parentDetailRef,
+            };
+        });
+        return {
+            version: 1,
+            kind: 'subtask_batch',
+            total: steps.length,
+            succeeded: steps.filter(step => step.state === 'success').length,
+            failed: steps.filter(step => step.state === 'error').length,
+            skipped: steps.filter(step => step.state === 'skipped').length,
+            steps,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function firstString(...values) {
+    return values.find(value => typeof value === 'string' && value.trim().length > 0);
+}
+function summarizeOutput(output) {
+    return output.split(/\r?\n/u).find(line => line.trim())?.trim().slice(0, 160) ?? '';
+}
+//# sourceMappingURL=tool-output-presentation.js.map

package/dist/runtime/tool-output-presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-output-presentation.js","sourceRoot":"","sources":["../../src/runtime/tool-output-presentation.ts"],"names":[],"mappings":"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"}

package/dist/runtime/turn-controller.d.ts

@@ -0,0 +1,41 @@
+export type TurnStatus = 'idle' | 'running' | 'aborting';
+export interface TurnHandle {
+    id: number;
+    input: string;
+    abortController: AbortController;
+    abortSignal: AbortSignal;
+}
+export interface TurnSnapshot {
+    status: TurnStatus;
+    activeTurnId?: number;
+    pendingRevision?: string;
+    verificationState?: 'pending' | 'running' | 'passed' | 'failed' | 'gated';
+}
+export interface TurnControllerOptions {
+    exitConfirmWindowMs?: number;
+}
+/**
+ * Owns the single active CLI turn. It prevents concurrent agent runs and keeps
+ * live revision semantics independent from terminal rendering details.
+ */
+export declare class TurnController {
+    private nextTurnId;
+    private activeTurn;
+    private status;
+    private pendingRevision;
+    private verificationState;
+    private lastExitIntentAt;
+    private readonly exitConfirmWindowMs;
+    constructor(options?: TurnControllerOptions);
+    beginTurn(input: string): TurnHandle;
+    requestRevision(input: string): boolean;
+    interruptActiveTurn(): boolean;
+    finishTurn(turnId: number): string | undefined;
+    setVerificationState(state: 'pending' | 'running' | 'passed' | 'failed' | 'gated'): void;
+    getVerificationState(): 'pending' | 'running' | 'passed' | 'failed' | 'gated' | undefined;
+    hasActiveTurn(): boolean;
+    getSnapshot(): TurnSnapshot;
+    registerExitIntent(now?: number): boolean;
+    clearExitIntent(): void;
+}
+//# sourceMappingURL=turn-controller.d.ts.map

package/dist/runtime/turn-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-controller.d.ts","sourceRoot":"","sources":["../../src/runtime/turn-controller.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAEzD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,eAAe,CAAC;IACjC,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;CAC3E;AAED,MAAM,WAAW,qBAAqB;IACpC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAID;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,iBAAiB,CAAoE;IAC7F,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;gBAEjC,OAAO,GAAE,qBAA0B;IAI/C,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAqBpC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAWvC,mBAAmB,IAAI,OAAO;IAU9B,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAY9C,oBAAoB,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,IAAI;IAIxF,oBAAoB,IAAI,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS;IAIzF,aAAa,IAAI,OAAO;IAIxB,WAAW,IAAI,YAAY;IAS3B,kBAAkB,CAAC,GAAG,SAAa,GAAG,OAAO;IAS7C,eAAe,IAAI,IAAI;CAGxB"}

package/dist/runtime/turn-controller.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TurnController = void 0;
+const DEFAULT_EXIT_CONFIRM_WINDOW_MS = 2000;
+/**
+ * Owns the single active CLI turn. It prevents concurrent agent runs and keeps
+ * live revision semantics independent from terminal rendering details.
+ */
+class TurnController {
+    constructor(options = {}) {
+        this.nextTurnId = 1;
+        this.activeTurn = null;
+        this.status = 'idle';
+        this.lastExitIntentAt = 0;
+        this.exitConfirmWindowMs = options.exitConfirmWindowMs ?? DEFAULT_EXIT_CONFIRM_WINDOW_MS;
+    }
+    beginTurn(input) {
+        if (this.activeTurn) {
+            throw new Error('A turn is already running');
+        }
+        const abortController = new AbortController();
+        const turn = {
+            id: this.nextTurnId++,
+            input,
+            abortController,
+            abortSignal: abortController.signal,
+        };
+        this.activeTurn = turn;
+        this.status = 'running';
+        this.pendingRevision = undefined;
+        this.verificationState = undefined;
+        this.clearExitIntent();
+        return turn;
+    }
+    requestRevision(input) {
+        if (!this.activeTurn)
+            return false;
+        this.pendingRevision = input;
+        this.status = 'aborting';
+        if (!this.activeTurn.abortController.signal.aborted) {
+            this.activeTurn.abortController.abort();
+        }
+        return true;
+    }
+    interruptActiveTurn() {
+        if (!this.activeTurn)
+            return false;
+        this.status = 'aborting';
+        if (!this.activeTurn.abortController.signal.aborted) {
+            this.activeTurn.abortController.abort();
+        }
+        return true;
+    }
+    finishTurn(turnId) {
+        if (!this.activeTurn || this.activeTurn.id !== turnId) {
+            return undefined;
+        }
+        this.activeTurn = null;
+        this.status = 'idle';
+        const revision = this.pendingRevision;
+        this.pendingRevision = undefined;
+        return revision;
+    }
+    setVerificationState(state) {
+        this.verificationState = state;
+    }
+    getVerificationState() {
+        return this.verificationState;
+    }
+    hasActiveTurn() {
+        return this.activeTurn !== null;
+    }
+    getSnapshot() {
+        return {
+            status: this.status,
+            activeTurnId: this.activeTurn?.id,
+            pendingRevision: this.pendingRevision,
+            verificationState: this.verificationState,
+        };
+    }
+    registerExitIntent(now = Date.now()) {
+        const shouldExit = this.lastExitIntentAt > 0 &&
+            now - this.lastExitIntentAt <= this.exitConfirmWindowMs;
+        this.lastExitIntentAt = shouldExit ? 0 : now;
+        return shouldExit;
+    }
+    clearExitIntent() {
+        this.lastExitIntentAt = 0;
+    }
+}
+exports.TurnController = TurnController;
+//# sourceMappingURL=turn-controller.js.map

package/dist/runtime/turn-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-controller.js","sourceRoot":"","sources":["../../src/runtime/turn-controller.ts"],"names":[],"mappings":"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"}

package/dist/runtime/ui-events.d.ts

@@ -0,0 +1,188 @@
+import type { OpenHorseRuntime } from '../init';
+import type { Store } from '../framework/store';
+import type { LoopStats } from '../framework';
+import type { LLMService } from '../services/llm';
+import type { CompactCoordinator } from '../services/compact';
+import type { OpenHorseCLIConfig } from '../services/config';
+import type { SessionMeta, SessionTraceEvent } from '../services/session-storage';
+import type { RuntimeSubtaskEvent } from './subagents/types';
+/** Re-export so the runtime event protocol can reference subtask events. */
+export type { RuntimeSubtaskEvent } from './subagents/types';
+export type TranscriptRole = 'user' | 'assistant' | 'tool' | 'system' | 'command' | 'error' | 'status';
+export type ErrorLayer = 'renderer' | 'runtime' | 'provider' | 'tool' | 'session' | 'memory' | 'mcp' | 'skills' | 'unknown';
+export interface StructuredToolActivity {
+    state: 'queued' | 'running' | 'success' | 'error' | 'skipped' | 'requested';
+    name: string;
+    detail: string;
+    command?: string;
+    duration?: string;
+    summary?: string;
+    outputBytes?: number;
+    /** Structured display body. When present, TUI ignores legacy TranscriptEntry.content. */
+    body?: string;
+    error?: string;
+    seq?: number;
+    artifactHint?: string;
+    callId?: string;
+    turnId?: string;
+    /** v0.2.23: Renderer-neutral tool output view for adaptive collapse. */
+    outputView?: import('./tool-output-presentation').ToolOutputView;
+}
+export interface TranscriptEntry {
+    id: string;
+    role: TranscriptRole;
+    content: string;
+    title?: string;
+    errorLayer?: ErrorLayer;
+    statusTone?: 'neutral' | 'warning';
+    /** Structured tool activity — set by tool event presenter so renderers
+     *  consume typed data instead of parsing transcript text. */
+    toolActivity?: StructuredToolActivity;
+}
+export interface TranscriptAppendEntry extends Omit<TranscriptEntry, 'id'> {
+    live?: boolean;
+}
+export interface SessionPickerRequest {
+    sessions: SessionMeta[];
+    title: string;
+    showProject?: boolean;
+    allProjects?: boolean;
+    maxVisibleItems?: number;
+    moreCount?: number;
+}
+export interface EditPreviewCandidate {
+    index: number;
+    line: number;
+    match: string;
+    contextBefore: string;
+    contextAfter: string;
+    isReplaceAll: boolean;
+}
+export interface EditPreviewRequest {
+    path: string;
+    newString: string;
+    kind: 'exact' | 'fuzzy';
+    strategy?: string;
+    candidates: EditPreviewCandidate[];
+    width?: number;
+}
+export interface UiRendererCapabilities {
+    structuredPickers?: boolean;
+    inlineProgress?: boolean;
+    suppressLegacyTokenMeta?: boolean;
+    extraAssistantSpacing?: boolean;
+    suppressAbortNotice?: boolean;
+}
+export type ResolvedUiRendererCapabilities = Required<UiRendererCapabilities>;
+export declare function resolveUiRendererCapabilities(capabilities?: UiRendererCapabilities, renderer?: unknown): ResolvedUiRendererCapabilities;
+export interface ToolPermissionRequest {
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+    reason?: string;
+    abortSignal?: AbortSignal;
+}
+export interface RuntimeToolStartedEvent {
+    callId: string;
+    name: string;
+    args: Record<string, unknown>;
+    /** Monotonic tool invocation sequence across the session (1-based). */
+    sequence: number;
+    batchCount?: number;
+    batchIndex?: number;
+}
+export interface RuntimeToolFinishedEvent {
+    callId: string;
+    name: string;
+    args: Record<string, unknown>;
+    success: boolean;
+    skipped?: boolean;
+    duration: number;
+    summary?: string;
+    error?: string;
+    outputBytes?: number;
+    artifactRef?: {
+        id: string;
+        outputBytes: number;
+    };
+    /** Monotonic tool invocation sequence across the session (1-based). */
+    sequence: number;
+    batchCount?: number;
+    batchIndex?: number;
+}
+export interface RuntimeSessionRestoredEvent {
+    sessionId: string;
+    projectPath: string;
+    model: string;
+    restoredMessages: number;
+    messageCount?: number;
+    summary?: string;
+    summaryGeneratedAt?: number;
+    summarySource?: 'llm' | 'heuristic' | 'resume_heuristic';
+    summaryCoveredMessages?: number;
+    checkpointId?: string;
+    transcriptMessages?: number;
+}
+export type RuntimeLoopStats = LoopStats;
+export type RuntimeTraceEvent = SessionTraceEvent;
+export interface RuntimeHarnessDiagnostics {
+    taskEpoch?: number;
+    rootObjective?: string;
+    activeInstruction?: string;
+    openQuestions?: string[];
+    diagnostics?: string[];
+    ledgerSize: number;
+    evidenceSize: number;
+    turnSummaryCount: number;
+    promptAssembly?: {
+        modelId: string;
+        estimatedTokens: number;
+        budgetTokens: number;
+        sections: string[];
+        includedEvidence: number;
+        omittedEvidence: number;
+    };
+}
+export interface RuntimeSessionAccessors {
+    ensureSession: () => SessionMeta;
+    setSession: (session: SessionMeta | null) => void;
+    getSession: () => SessionMeta | null;
+}
+export interface OrionCodeUiRuntime extends RuntimeSessionAccessors {
+    cwd: string;
+    version: string;
+    config: OpenHorseCLIConfig;
+    store: Store;
+    llm: LLMService | null;
+    compactCoordinator?: CompactCoordinator;
+    runtime: OpenHorseRuntime;
+    isConfigured: boolean;
+    mcpReady?: Promise<void>;
+    shutdown: () => Promise<void>;
+}
+/** @deprecated Use OrionCodeUiRuntime. */
+export type OpenHorseUiRuntime = OrionCodeUiRuntime;
+/** @deprecated Use OrionCodeUiRuntime. Runtime context is shared by every renderer. */
+export type OpenHorseInkRuntime = OrionCodeUiRuntime;
+export interface UiEventSink {
+    append: (entry: TranscriptAppendEntry) => string;
+    update: (id: string, patch: Partial<Omit<TranscriptEntry, 'id'>>) => void;
+    finalize: (id: string, patch?: Partial<Omit<TranscriptEntry, 'id'>>) => void;
+    remove: (id: string) => void;
+    replaceTranscript: (entries: TranscriptEntry[]) => void;
+    clearTranscript: () => void;
+    setStatus: (message: string) => void;
+    showSessionPicker: (request: SessionPickerRequest) => void;
+    showEditPreview: (request: EditPreviewRequest) => void;
+    showPermissionRequest?: (request: ToolPermissionRequest) => void;
+    toolStarted?: (event: RuntimeToolStartedEvent) => void;
+    toolFinished?: (event: RuntimeToolFinishedEvent) => void;
+    sessionRestored?: (event: RuntimeSessionRestoredEvent) => void;
+    loopStatsUpdated?: (stats: LoopStats) => void;
+    traceEventRecorded?: (event: SessionTraceEvent) => void;
+    harnessDiagnosticsUpdated?: (diagnostics: RuntimeHarnessDiagnostics) => void;
+    /** Subagent lifecycle event (queued/running/completed/...). Renderer-independent. */
+    subtaskEvent?: (event: RuntimeSubtaskEvent) => void;
+    setProcessing: (processing: boolean) => void;
+}
+//# sourceMappingURL=ui-events.d.ts.map