@orion-agents/orion-code 0.1.0

package/dist/runtime/subagents/types.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Subagent runtime types.
+ *
+ * v0.2.20 introduces a read-only subagent runtime: the root Agent may request
+ * 1-3 independent investigation packets that a Supervisor runs as isolated
+ * child agents under a unified budget, permission boundary and trace.
+ *
+ * These types are renderer- and protocol-agnostic. The runtime event shape
+ * lives here so terminal/Ink/TUI consume one definition.
+ */
+/** Built-in child roles. v0.2.20 ships only read-only investigation roles. */
+export type SubagentRole = 'research' | 'review' | 'test-investigate';
+/** Whether the `subtask` capability is exposed to the root Agent at all. */
+export type SubagentMode = 'off' | 'explicit' | 'auto';
+/**
+ * Renderer-independent subtask lifecycle state.
+ *
+ * `requested` is a pre-queue state. `rejected` is emitted as a runtime event
+ * (via finalizeTask) when policy denies a task before it runs.
+ */
+export type RuntimeSubtaskState = 'queued' | 'running' | 'completed' | 'failed' | 'cancelled' | 'timed_out' | 'rejected';
+export interface SubagentConfig {
+    /** `off` hides the capability; `explicit` requires clear delegation intent; `auto` lets the model propose. */
+    mode: SubagentMode;
+    /** Maximum child agents running concurrently within one batch. */
+    maxParallel: number;
+    /** Maximum packets accepted in a single `subtask` call. */
+    maxTasksPerTurn: number;
+    /** Maximum root-turns a single child may consume. */
+    maxTurnsPerTask: number;
+    /** Maximum model requests a single child may spend. */
+    maxModelRequestsPerTask: number;
+    /** Aggregate model requests allowed across all children in one batch. */
+    maxModelRequestsPerTurn: number;
+    /** Maximum tool calls a single child may perform. */
+    maxToolCallsPerTask: number;
+    /** Hard wall-clock timeout per child. */
+    timeoutMs: number;
+    /** Enabled roles. A role not listed here is always rejected. */
+    roles: SubagentRole[];
+}
+export declare const DEFAULT_SUBAGENT_CONFIG: SubagentConfig;
+/** Minimum/maximum bounds enforced regardless of user config. */
+export declare const SUBAGENT_LIMITS: {
+    readonly maxParallel: {
+        readonly min: 1;
+        readonly max: 3;
+    };
+    readonly maxTasksPerTurn: {
+        readonly min: 1;
+        readonly max: 3;
+    };
+    readonly maxTurnsPerTask: {
+        readonly min: 1;
+        readonly max: 12;
+    };
+    readonly maxModelRequestsPerTask: {
+        readonly min: 1;
+        readonly max: 24;
+    };
+    readonly maxModelRequestsPerTurn: {
+        readonly min: 1;
+        readonly max: 48;
+    };
+    readonly maxToolCallsPerTask: {
+        readonly min: 1;
+        readonly max: 96;
+    };
+    readonly timeoutMs: {
+        readonly min: 5000;
+        readonly max: 600000;
+    };
+};
+export interface SubtaskScope {
+    /** Canonical, in-project paths the child is scoped to. */
+    paths?: string[];
+    /** Symbols / identifiers the child should focus on. */
+    symbols?: string[];
+}
+export interface SubtaskPacket {
+    /** Caller-proposed id. Runtime generates the authoritative id and ignores this. */
+    id?: string;
+    role: SubagentRole;
+    /** What the child must produce a conclusion about. */
+    objective: string;
+    /** Why this is independently delegable (used by policy + trace). */
+    reason: string;
+    scope?: SubtaskScope;
+    /** Extra context the root Agent wants the child to consider. */
+    contextHints?: string[];
+    /** What a good result looks like. */
+    expectedOutput?: string;
+}
+export interface SubtaskRequest {
+    tasks: SubtaskPacket[];
+    /** `parallel` runs concurrently; `serial` runs in order. */
+    execution: 'parallel' | 'serial';
+}
+export interface SubtaskUsage {
+    modelRequests: number;
+    toolCalls: number;
+    promptTokens: number;
+    completionTokens: number;
+    durationMs: number;
+    /** Sum of provider-reported costs, present only when every child call reported cost. */
+    costUsd?: number;
+}
+export declare const EMPTY_SUBTASK_USAGE: SubtaskUsage;
+export interface SubtaskFinding {
+    severity?: 'critical' | 'high' | 'medium' | 'low' | 'info';
+    title: string;
+    evidence: string;
+    file?: string;
+    line?: number;
+}
+export interface SubtaskCommandSuggestion {
+    command: string;
+    purpose: string;
+    /** Always false in v0.2.20: children never execute, only suggest. */
+    executed: false;
+}
+export type SubtaskResultStatus = 'completed' | 'failed' | 'cancelled' | 'timed_out' | 'rejected';
+export interface SubtaskResult {
+    id: string;
+    role: SubagentRole;
+    status: SubtaskResultStatus;
+    summary: string;
+    findings: SubtaskFinding[];
+    files: string[];
+    commands: SubtaskCommandSuggestion[];
+    verification: string[];
+    risks: string[];
+    usage: SubtaskUsage;
+}
+export interface SubtaskBatchResult {
+    batchId: string;
+    results: SubtaskResult[];
+    aggregateUsage: SubtaskUsage;
+}
+/** Renderer-independent subtask lifecycle event. */
+export interface RuntimeSubtaskEvent {
+    batchId: string;
+    taskId: string;
+    role: SubagentRole;
+    state: RuntimeSubtaskState;
+    objective: string;
+    summary?: string;
+    durationMs?: number;
+    usage?: SubtaskUsage;
+}
+export declare function sumSubtaskUsage(usages: SubtaskUsage[]): SubtaskUsage;
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime/subagents/types.d.ts.map

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

package/dist/runtime/subagents/types.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * Subagent runtime types.
+ *
+ * v0.2.20 introduces a read-only subagent runtime: the root Agent may request
+ * 1-3 independent investigation packets that a Supervisor runs as isolated
+ * child agents under a unified budget, permission boundary and trace.
+ *
+ * These types are renderer- and protocol-agnostic. The runtime event shape
+ * lives here so terminal/Ink/TUI consume one definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EMPTY_SUBTASK_USAGE = exports.SUBAGENT_LIMITS = exports.DEFAULT_SUBAGENT_CONFIG = void 0;
+exports.sumSubtaskUsage = sumSubtaskUsage;
+exports.DEFAULT_SUBAGENT_CONFIG = {
+    mode: 'auto',
+    maxParallel: 3,
+    maxTasksPerTurn: 3,
+    maxTurnsPerTask: 6,
+    maxModelRequestsPerTask: 6,
+    maxModelRequestsPerTurn: 12,
+    maxToolCallsPerTask: 24,
+    timeoutMs: 120000,
+    roles: ['research', 'review', 'test-investigate'],
+};
+/** Minimum/maximum bounds enforced regardless of user config. */
+exports.SUBAGENT_LIMITS = {
+    maxParallel: { min: 1, max: 3 },
+    maxTasksPerTurn: { min: 1, max: 3 },
+    maxTurnsPerTask: { min: 1, max: 12 },
+    maxModelRequestsPerTask: { min: 1, max: 24 },
+    maxModelRequestsPerTurn: { min: 1, max: 48 },
+    maxToolCallsPerTask: { min: 1, max: 96 },
+    timeoutMs: { min: 5000, max: 600000 },
+};
+exports.EMPTY_SUBTASK_USAGE = {
+    modelRequests: 0,
+    toolCalls: 0,
+    promptTokens: 0,
+    completionTokens: 0,
+    durationMs: 0,
+};
+function sumSubtaskUsage(usages) {
+    const aggregate = usages.reduce((acc, u) => ({
+        modelRequests: acc.modelRequests + u.modelRequests,
+        toolCalls: acc.toolCalls + u.toolCalls,
+        promptTokens: acc.promptTokens + u.promptTokens,
+        completionTokens: acc.completionTokens + u.completionTokens,
+        durationMs: acc.durationMs + u.durationMs,
+    }), { ...exports.EMPTY_SUBTASK_USAGE });
+    if (usages.length > 0 && usages.every(usage => usage.costUsd !== undefined)) {
+        aggregate.costUsd = usages.reduce((sum, usage) => sum + (usage.costUsd ?? 0), 0);
+    }
+    return aggregate;
+}
+//# sourceMappingURL=types.js.map

package/dist/runtime/subagents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/runtime/subagents/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAsKH,0CAeC;AAzIY,QAAA,uBAAuB,GAAmB;IACrD,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,CAAC;IACd,eAAe,EAAE,CAAC;IAClB,eAAe,EAAE,CAAC;IAClB,uBAAuB,EAAE,CAAC;IAC1B,uBAAuB,EAAE,EAAE;IAC3B,mBAAmB,EAAE,EAAE;IACvB,SAAS,EAAE,MAAO;IAClB,KAAK,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,kBAAkB,CAAC;CAClD,CAAC;AAEF,iEAAiE;AACpD,QAAA,eAAe,GAAG;IAC7B,WAAW,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;IAC/B,eAAe,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;IACnC,eAAe,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IACpC,uBAAuB,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IAC5C,uBAAuB,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IAC5C,mBAAmB,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IACxC,SAAS,EAAE,EAAE,GAAG,EAAE,IAAK,EAAE,GAAG,EAAE,MAAO,EAAE;CAC/B,CAAC;AAwCE,QAAA,mBAAmB,GAAiB;IAC/C,aAAa,EAAE,CAAC;IAChB,SAAS,EAAE,CAAC;IACZ,YAAY,EAAE,CAAC;IACf,gBAAgB,EAAE,CAAC;IACnB,UAAU,EAAE,CAAC;CACd,CAAC;AAuDF,SAAgB,eAAe,CAAC,MAAsB;IACpD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAC7B,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,aAAa,EAAE,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC,aAAa;QAClD,SAAS,EAAE,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS;QACtC,YAAY,EAAE,GAAG,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY;QAC/C,gBAAgB,EAAE,GAAG,CAAC,gBAAgB,GAAG,CAAC,CAAC,gBAAgB;QAC3D,UAAU,EAAE,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU;KAC1C,CAAC,EACF,EAAE,GAAG,2BAAmB,EAAE,CAC3B,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,EAAE,CAAC;QAC5E,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/runtime/tool-detail-repository.d.ts

@@ -0,0 +1,45 @@
+/**
+ * v0.2.23 — Tool Detail Repository.
+ *
+ * Read-only interface for accessing tool output details from durable sources
+ * (artifacts, session traces). Supports paginated reads with byte-offset
+ * limits. Never loads full multi-MB artifacts into memory at once.
+ */
+export interface ToolDetailSummary {
+    callId: string;
+    sequence: number;
+    turnId?: string;
+    toolName: string;
+    state: 'success' | 'error' | 'skipped';
+    outputBytes: number;
+    artifactId?: string;
+    hasArtifact: boolean;
+}
+export interface ToolDetailPage {
+    content: string;
+    offsetBytes: number;
+    nextOffsetBytes?: number;
+    totalBytes: number;
+    redacted: boolean;
+}
+export interface ToolDetailRepository {
+    list(projectPath: string): Promise<ToolDetailSummary[]>;
+    read(ref: ToolDetailRef, options: {
+        offsetBytes: number;
+        limitBytes: number;
+    }, projectPath: string): Promise<ToolDetailPage>;
+}
+export interface ToolDetailRef {
+    callId: string;
+    sequence: number;
+    artifactId?: string;
+    outputBytes: number;
+}
+export declare class FileToolDetailRepository implements ToolDetailRepository {
+    list(projectPath: string): Promise<ToolDetailSummary[]>;
+    read(ref: ToolDetailRef, options: {
+        offsetBytes: number;
+        limitBytes: number;
+    }, projectPath: string): Promise<ToolDetailPage>;
+}
+//# sourceMappingURL=tool-detail-repository.d.ts.map

package/dist/runtime/tool-detail-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-detail-repository.d.ts","sourceRoot":"","sources":["../../src/runtime/tool-detail-repository.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxD,IAAI,CACF,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EACpD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AASD,qBAAa,wBAAyB,YAAW,oBAAoB;IAC7D,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAiBvD,IAAI,CACR,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EACpD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,CAAC;CAuD3B"}

package/dist/runtime/tool-detail-repository.js

@@ -0,0 +1,131 @@
+"use strict";
+/**
+ * v0.2.23 — Tool Detail Repository.
+ *
+ * Read-only interface for accessing tool output details from durable sources
+ * (artifacts, session traces). Supports paginated reads with byte-offset
+ * limits. Never loads full multi-MB artifacts into memory at once.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileToolDetailRepository = void 0;
+const fs_1 = require("fs");
+const tool_artifacts_1 = require("../core/tool-artifacts");
+const config_dir_1 = require("../services/config-dir");
+const redaction_1 = require("../services/redaction");
+const path_1 = require("path");
+// ============================================================================
+// Implementation
+// ============================================================================
+const MAX_PAGE_BYTES = 1024 * 1024; // 1 MB max per page
+const DEFAULT_LIMIT_BYTES = 64 * 1024; // 64 KB default page
+class FileToolDetailRepository {
+    async list(projectPath) {
+        try {
+            const artifacts = (0, tool_artifacts_1.listArtifacts)(projectPath);
+            return artifacts.map(a => ({
+                callId: artifactIdToCallId(a.id),
+                sequence: 0, // sequence not stored in artifact metadata currently
+                toolName: a.toolName,
+                state: 'success',
+                outputBytes: a.outputBytes,
+                artifactId: a.id,
+                hasArtifact: true,
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+    async read(ref, options, projectPath) {
+        const limitBytes = Math.min(options.limitBytes || DEFAULT_LIMIT_BYTES, MAX_PAGE_BYTES);
+        const offsetBytes = Math.max(0, options.offsetBytes || 0);
+        // Try reading from artifact file on disk.
+        if (ref.artifactId) {
+            // v0.2.23: reject path traversal in artifact IDs.
+            if (ref.artifactId.includes('..') || ref.artifactId.includes('/') || ref.artifactId.includes('\\')) {
+                return { content: 'detail unavailable', offsetBytes: 0, totalBytes: 0, redacted: false };
+            }
+            try {
+                const artifactDir = (0, config_dir_1.getProjectArtifactsDir)(projectPath);
+                const filePath = (0, path_1.join)(artifactDir, `${ref.artifactId}.txt`);
+                if ((0, fs_1.existsSync)(filePath)) {
+                    const totalBytes = (0, fs_1.statSync)(filePath).size;
+                    if (offsetBytes >= totalBytes) {
+                        return { content: '', offsetBytes, totalBytes, redacted: false };
+                    }
+                    const requestedBytes = Math.min(limitBytes + 3, totalBytes - offsetBytes);
+                    const buffer = Buffer.allocUnsafe(requestedBytes);
+                    const fd = (0, fs_1.openSync)(filePath, 'r');
+                    let bytesRead = 0;
+                    try {
+                        bytesRead = (0, fs_1.readSync)(fd, buffer, 0, requestedBytes, offsetBytes);
+                    }
+                    finally {
+                        (0, fs_1.closeSync)(fd);
+                    }
+                    const targetBytes = Math.min(limitBytes, bytesRead);
+                    const safeBytes = utf8SafePrefixLength(buffer.subarray(0, targetBytes));
+                    const consumedBytes = safeBytes > 0
+                        ? safeBytes
+                        : Math.min(bytesRead, utf8SequenceLength(buffer[0]));
+                    const rawPage = buffer.subarray(0, consumedBytes).toString('utf8');
+                    const content = (0, redaction_1.redactTraceText)(rawPage);
+                    const nextOffset = offsetBytes + consumedBytes;
+                    return {
+                        content,
+                        offsetBytes,
+                        nextOffsetBytes: nextOffset < totalBytes ? nextOffset : undefined,
+                        totalBytes,
+                        redacted: content !== rawPage,
+                    };
+                }
+            }
+            catch {
+                // Fall through to unavailable.
+            }
+        }
+        return {
+            content: 'detail unavailable',
+            offsetBytes: 0,
+            totalBytes: 0,
+            redacted: false,
+        };
+    }
+}
+exports.FileToolDetailRepository = FileToolDetailRepository;
+function artifactIdToCallId(id) {
+    // artifact IDs look like "toolName-seq-random" — use as callId fallback.
+    return id;
+}
+function utf8SafePrefixLength(buffer) {
+    if (buffer.length === 0)
+        return 0;
+    let lead = buffer.length - 1;
+    while (lead >= 0 && (buffer[lead] & 0xc0) === 0x80)
+        lead -= 1;
+    if (lead < 0)
+        return 0;
+    const first = buffer[lead];
+    const expected = (first & 0x80) === 0
+        ? 1
+        : (first & 0xe0) === 0xc0
+            ? 2
+            : (first & 0xf0) === 0xe0
+                ? 3
+                : (first & 0xf8) === 0xf0
+                    ? 4
+                    : 1;
+    return buffer.length - lead < expected ? lead : buffer.length;
+}
+function utf8SequenceLength(first) {
+    if ((first & 0x80) === 0)
+        return 1;
+    if ((first & 0xe0) === 0xc0)
+        return 2;
+    if ((first & 0xf0) === 0xe0)
+        return 3;
+    if ((first & 0xf8) === 0xf0)
+        return 4;
+    return 1;
+}
+//# sourceMappingURL=tool-detail-repository.js.map

package/dist/runtime/tool-detail-repository.js.map

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

package/dist/runtime/tool-output-presentation.d.ts

@@ -0,0 +1,89 @@
+/**
+ * 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.
+ */
+export type ToolOutputViewMode = 'inline' | 'preview' | 'collapsed';
+export type ToolOutputContentKind = 'text' | 'json' | 'diff' | 'log' | 'table' | 'batch' | 'unknown';
+export interface ToolOutputDetailRef {
+    callId: string;
+    sequence: number;
+    turnId?: string;
+    artifactId?: string;
+    traceSessionId?: string;
+    outputBytes: number;
+    outputLines: number;
+}
+export interface ToolOutputStepSummary {
+    index: number;
+    toolName: string;
+    state: 'success' | 'error' | 'skipped';
+    target?: string;
+    summary: string;
+    outputBytes: number;
+    detailRef?: ToolOutputDetailRef;
+}
+export interface ToolAggregateView {
+    version: 1;
+    kind: 'batch_read' | 'subtask_batch' | 'generic_batch';
+    total: number;
+    succeeded: number;
+    failed: number;
+    skipped: number;
+    steps: ToolOutputStepSummary[];
+}
+export interface ToolOutputView {
+    mode: ToolOutputViewMode;
+    contentKind: ToolOutputContentKind;
+    summary: string;
+    preview: string;
+    previewBytes: number;
+    omittedBytes: number;
+    omittedLines: number;
+    detailRef?: ToolOutputDetailRef;
+    aggregate?: ToolAggregateView;
+}
+export type ToolTranscriptViewMode = 'adaptive' | 'collapsed' | 'full';
+export interface ResolvedToolOutputPolicy {
+    mode: ToolTranscriptViewMode;
+    inlineMaxLines: number;
+    inlineMaxBytes: number;
+    previewMaxLines: number;
+    previewMaxBytes: number;
+    errorPreviewMaxLines: number;
+    errorPreviewMaxBytes: number;
+}
+export declare const DEFAULT_TOOL_OUTPUT_POLICY: ResolvedToolOutputPolicy;
+export interface CreateToolOutputViewInput {
+    toolName: string;
+    success: boolean;
+    summary?: string;
+    rawOutput: string;
+    outputBytes: number;
+    artifactRef?: {
+        id: string;
+        outputBytes: number;
+    };
+    callId: string;
+    sequence: number;
+    turnId?: string;
+    policy: ResolvedToolOutputPolicy;
+}
+export declare function createToolOutputView(input: CreateToolOutputViewInput): ToolOutputView;
+export interface AggregateBatchReadResult {
+    steps: Array<{
+        tool: string;
+        target: string;
+        success: boolean;
+        summary: string;
+        outputBytes: number;
+    }>;
+}
+/**
+ * Try to parse a known aggregate tool result into a structured view.
+ * Returns null if the output doesn't match any known schema.
+ */
+export declare function tryParseAggregateOutput(toolName: string, rawOutput: string, detailRef?: ToolOutputDetailRef): ToolAggregateView | null;
+//# sourceMappingURL=tool-output-presentation.d.ts.map

package/dist/runtime/tool-output-presentation.d.ts.map

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