@myagentroam/node 0.9.0 → 0.9.2

package/dist/runner/codex-runner.d.ts

@@ -44,7 +44,7 @@ export declare class CodexRunner extends AbstractRunner<'codex'> {
     readExternalActivity(session: NodeAgentSession): Promise<"UNAVAILABLE" | "MANAGED_ACTIVE" | "EXTERNAL_ACTIVE" | "IDLE" | undefined>;
     acceptsTruncatedNativeHistory(): boolean;
     readManagedRunnerTitle(session: NodeAgentSession, nativeSessionId: string): Promise<string | undefined>;
-    nativeImageRoot(session: NodeAgentSession): string | undefined;
+    nativeImageRoots(session: NodeAgentSession): readonly string[];
     managedRunForNativeTurn(nativeTurnId: string): string | undefined;
     protected profileForValidation(): RunnerProfile;
     defaultConfiguration(_workspace?: NodeWorkspace, environment?: Readonly<Record<string, string>>): RunnerDefaultConfiguration;

package/dist/runner/codex-runner.js

@@ -6,7 +6,7 @@ import { resolve } from 'node:path';
 import { createHash } from 'node:crypto';
 import { discoverAllNativeSessions } from '../native-session-history.js';
 import { readCodexNativeContextUsage } from '../native-session-history.js';
-import { codexActiveTurnId, codexOfficialConversationPage, codexThreadCwd, codexThreadActivity, deduplicateDirectSessions, externalResumeFailureDetail, extractCodexThreads, isWithinWorkspace, latestNativeActivity } from './codex/conversation-parser.js';
+import { codexActiveTurnId, codexOfficialConversationPage, codexThreadCwd, codexThreadActivity, deduplicateDirectSessions, extractCodexThreads, isWithinWorkspace, latestNativeActivity } from './codex/conversation-parser.js';
 import { codexSessionControl } from '../codex-app-server.js';
 import { extractId } from '../util/runner-native-session-parsers.js';
 import { nodeLog } from '../operational.js';
@@ -248,10 +248,13 @@ export class CodexRunner extends AbstractRunner {
         await this.start();
         return extractCodexThreads(await this.listThreads()).find((thread) => thread.id === nativeSessionId)?.title;
     }
-    nativeImageRoot(session) {
-        return session.externalSessionId === null
-            ? undefined
-            : resolve(homedir(), '.codex', 'generated_images', session.externalSessionId);
+    nativeImageRoots(session) {
+        return [
+            session.cwd,
+            ...(session.externalSessionId === null
+                ? []
+                : [resolve(homedir(), '.codex', 'generated_images', session.externalSessionId)])
+        ];
     }
     managedRunForNativeTurn(nativeTurnId) {
         return this.execution.managedTurns.get(nativeTurnId)?.runId;
@@ -313,11 +316,10 @@ export class CodexRunner extends AbstractRunner {
             }
             return { activity: 'IDLE', session: context.create(external) };
         }
-        catch (error) {
+        catch {
             return {
                 activity: 'UNAVAILABLE',
-                failureCode: 'RUNNER_RESUME_FAILED',
-                failureDetail: externalResumeFailureDetail(error)
+                failureCode: 'RUNNER_RESUME_FAILED'
             };
         }
     }

package/dist/runner/opencode/conversation-parser.d.ts

@@ -18,10 +18,14 @@ export declare function openCodeQuestions(value: unknown): {
     allowOther: boolean;
     multiSelect: boolean;
 }[];
-export declare function openCodePatchChanges(value: unknown): {
-    path: string;
-    change: string;
-    additions: null;
-    deletions: null;
-    diffAvailable: boolean;
-}[];
+export declare function openCodePatchToolPayload(): {
+    namespace: string;
+    toolName: string;
+    title: string;
+    inputSummary: null;
+    outputSummary: string;
+    outputSummaryCode: string;
+    progressLabel: null;
+    errorCode: null;
+    truncated: boolean;
+};

package/dist/runner/opencode/conversation-parser.js

@@ -1,4 +1,3 @@
-import { basename } from 'node:path';
 import { boundedConversationItemId, compactRunnerText, compactRunnerValue } from '../codex/conversation-parser.js';
 export function openCodeConversationPage(session, messages, input, managedTurn) {
     const records = messages.flatMap((value) => {
@@ -114,10 +113,11 @@ function partItem(session, turnId, raw, planMode, startedAt, completedAt, sequen
     if (part.type === 'compaction')
         return item(session, turnId, part.id, 'context_compaction', 'COMPLETED', {
             phase: 'COMPLETED',
-            summary: '上下文已整理'
+            summary: 'Context compacted',
+            summaryCode: 'CONTEXT_COMPACTED'
         }, startedAt, completedAt, sequence);
     if (part.type === 'patch')
-        return item(session, turnId, part.id, 'file_change', 'COMPLETED', { changes: openCodePatchChanges(part.files) }, startedAt, completedAt, sequence);
+        return item(session, turnId, part.id, 'tool_call', 'COMPLETED', openCodePatchToolPayload(), startedAt, completedAt, sequence);
     if (part.type === 'step-start' || part.type === 'step-finish')
         return undefined;
     if (part.type === 'text' || part.type === 'reasoning')
@@ -162,18 +162,18 @@ export function openCodeQuestions(value) {
         ];
     });
 }
-export function openCodePatchChanges(value) {
-    return (Array.isArray(value) ? value : []).flatMap((path) => typeof path === 'string' && path.length > 0
-        ? [
-            {
-                path: basename(path),
-                change: 'MODIFIED',
-                additions: null,
-                deletions: null,
-                diffAvailable: false
-            }
-        ]
-        : []);
+export function openCodePatchToolPayload() {
+    return {
+        namespace: 'opencode',
+        toolName: 'patch',
+        title: 'patch',
+        inputSummary: null,
+        outputSummary: 'OpenCode applied the patch',
+        outputSummaryCode: 'OPENCODE_PATCH_APPLIED',
+        progressLabel: null,
+        errorCode: null,
+        truncated: false
+    };
 }
 function item(session, turnId, nativeId, kind, status, payload, startedAt, completedAt, sequence) {
     return {

package/dist/runner/opencode/managed-run-controller.d.ts

@@ -7,6 +7,7 @@ interface OpenCodeManagedRunHost {
     intercepted(): boolean;
     readonly active: Set<string>;
     parseAttachments(value: unknown): readonly RunnerImageAttachment[];
+    persistAttachments(cwd: string, runId: string, attachments: readonly RunnerImageAttachment[]): Promise<readonly string[]>;
     emit(runId: string, eventType: string, payload: unknown, status?: FakeRunnerStatus): void;
     emitItem(runId: string, item: OpenCodePublicItem): void;
     adopt(input: {
@@ -40,7 +41,7 @@ interface OpenCodeManagedRunHost {
 }
 type OpenCodePublicItem = {
     readonly itemId: string;
-    readonly kind: 'assistant_message' | 'plan' | 'reasoning_summary' | 'tool_call' | 'user_input_request' | 'context_compaction' | 'file_change' | 'unknown';
+    readonly kind: 'assistant_message' | 'plan' | 'reasoning_summary' | 'tool_call' | 'user_input_request' | 'context_compaction' | 'unknown';
     readonly status: 'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED';
     readonly payload: Record<string, unknown>;
     readonly merge?: boolean;

package/dist/runner/opencode/managed-run-controller.js

@@ -1,6 +1,7 @@
 import { parseSecretEnvironment } from '../../util/secret-environment.js';
+import { safeErrorCode } from '../../util/safe-error.js';
 import { boundedConversationItemId, compactRunnerText, compactRunnerValue } from '../codex/conversation-parser.js';
-import { openCodePatchChanges, openCodeQuestions } from './conversation-parser.js';
+import { openCodePatchToolPayload, openCodeQuestions } from './conversation-parser.js';
 export class OpenCodeManagedRunController {
     runner;
     host;
@@ -29,10 +30,10 @@ export class OpenCodeManagedRunController {
                 commandId: 'plan',
                 active: true,
                 label: 'Plan Mode',
-                detail: '后续消息将由 OpenCode 原生 Plan Agent 只读分析并制定计划。',
+                detail: 'Subsequent messages use the OpenCode Plan Agent for read-only analysis.',
                 closable: true,
                 closeInput: '/plan',
-                continuation: { label: '执行', prompt: '请根据上述计划开始实施。' }
+                continuation: { label: 'Implement', prompt: 'Implement the plan above.' }
             });
         return { command: command.id, states: this.host.commandStates(session.id) };
     }
@@ -56,7 +57,7 @@ export class OpenCodeManagedRunController {
             attachments = this.host.parseAttachments(payload.attachments);
         }
         catch (error) {
-            this.host.emit(payload.runId, 'run.rejected', { code: error instanceof Error ? error.message : 'RUNNER_INPUT_INVALID' }, 'FAILED');
+            this.host.emit(payload.runId, 'run.rejected', { code: safeErrorCode(error, 'RUNNER_INPUT_INVALID') }, 'FAILED');
             return;
         }
         void this.run({
@@ -122,8 +123,8 @@ export class OpenCodeManagedRunController {
         return true;
     }
     async run(input) {
-        // OpenCode 的动态 MCP 注册属于 Server 进程状态。加载 MCP 的 Run 使用独立 Server，
-        // 避免同一工作区的并行会话共享 MCP 进程、配置或浏览器上下文。
+        // OpenCode dynamic MCP registration belongs to Server process state. Runs that load MCP use an
+        // isolated Server so parallel sessions in one workspace do not share MCP processes or context.
         const client = this.runner.managedClient(input.environment, hasMcpConfiguration(input.mcp) ? input.runId : undefined);
         this.startingClients.set(input.runId, client);
         this.startingCwds.set(input.runId, input.cwd);
@@ -181,17 +182,20 @@ export class OpenCodeManagedRunController {
                     return;
                 }
                 this.finish(input.runId, 'FAILED', 'run.failed', {
-                    code: error instanceof Error ? error.message : 'OPENCODE_EVENT_FAILED'
+                    code: safeErrorCode(error, 'OPENCODE_EVENT_FAILED')
                 });
             });
             await subscriptionReady;
             this.host.emit(input.runId, 'run.running', {}, 'RUNNING');
             // The initial SSE snapshot can contain an idle event from before this prompt.
             this.pendingIdle.delete(input.runId);
+            const attachmentPaths = input.attachments.length === 0
+                ? []
+                : await this.host.persistAttachments(input.cwd, input.runId, input.attachments);
             await client.prompt({
                 directory: input.cwd,
                 sessionID: nativeSessionId,
-                text: input.input,
+                text: openCodeImageInput(input.input, attachmentPaths),
                 model: input.model,
                 variant: input.effort,
                 agent: input.agent,
@@ -203,7 +207,7 @@ export class OpenCodeManagedRunController {
         }
         catch (error) {
             this.finish(input.runId, 'FAILED', 'run.failed', {
-                code: error instanceof Error ? error.message : 'OPENCODE_RUN_START_FAILED'
+                code: safeErrorCode(error, 'OPENCODE_RUN_START_FAILED')
             });
         }
     }
@@ -366,6 +370,12 @@ export class OpenCodeManagedRunController {
             void this.host.captureSnapshot(runId, cwd);
     }
 }
+function openCodeImageInput(input, attachmentPaths) {
+    if (attachmentPaths.length === 0)
+        return input;
+    const paths = attachmentPaths.map((path) => `- ${JSON.stringify(path)}`).join('\n');
+    return `${input}\n\nIf an inline image in this message is unavailable, use the read tool on the corresponding copy below. Do not read it again when the inline image is already visible:\n${paths}`;
+}
 function hasMcpConfiguration(value) {
     return value !== null && typeof value === 'object' && Object.keys(value).length > 0;
 }
@@ -425,14 +435,18 @@ function openCodePart(part, planMode = false) {
             itemId,
             kind: 'context_compaction',
             status: 'COMPLETED',
-            payload: { phase: 'COMPLETED', summary: '上下文已整理' }
+            payload: {
+                phase: 'COMPLETED',
+                summary: 'Context compacted',
+                summaryCode: 'CONTEXT_COMPACTED'
+            }
         };
     if (part.type === 'patch')
         return {
             itemId,
-            kind: 'file_change',
+            kind: 'tool_call',
             status: 'COMPLETED',
-            payload: { changes: openCodePatchChanges(part.files) },
+            payload: openCodePatchToolPayload(),
             merge: true
         };
     if (part.type === 'step-start' || part.type === 'step-finish')

package/dist/runner-command-engine.js

@@ -8,7 +8,7 @@ const CLAUDE_PLAN_TAG_CLOSE = '</plan_mode>';
  */
 export function withClaudePlanTag(input) {
     return `${CLAUDE_PLAN_TAG_OPEN}
-当前处于 Plan Mode。只做只读分析与规划，不得创建、修改或删除文件，不得执行有副作用的命令。完成分析后，把最终计划完整包裹在 <proposed_plan> 与 </proposed_plan> 标签中输出，不要在标签外重复计划正文。
+You are in Plan Mode. Perform only read-only analysis and planning. Do not create, modify, or delete files, and do not run commands with side effects. Wrap the complete final plan in <proposed_plan> and </proposed_plan> tags without repeating the plan outside those tags.
 ${CLAUDE_PLAN_TAG_CLOSE}
 
 ${input}`;

package/dist/runner-profiles.js

@@ -14,24 +14,28 @@ const definitions = {
         runner: 'codex',
         models: [],
         accessOptions: [
-            { id: 'on-request', label: 'On-request', description: '由 Codex 在需要额外权限时请求确认。' },
+            {
+                id: 'on-request',
+                label: 'On-request',
+                description: 'Ask when additional permission is required.'
+            },
             {
                 id: 'workspace-write',
                 label: 'Workspace write',
-                description: '允许 Codex 在当前工作区内写入文件。'
+                description: 'Allow writes in the current Workspace.'
             },
             {
                 id: 'full-access',
                 label: 'Full access',
-                description: '允许 Codex 以完整权限运行，且不再逐项确认。'
+                description: 'Allow full access without individual confirmations.'
             },
-            { id: 'read-only', label: 'Read-only', description: '限制 Codex 为只读沙箱。' }
+            { id: 'read-only', label: 'Read-only', description: 'Restrict Codex to a read-only sandbox.' }
         ],
         commands: [
             {
                 id: 'compact',
                 label: '/compact',
-                description: '立即压缩当前会话上下文。',
+                description: 'Compact the current session context.',
                 inputHint: '/compact',
                 interaction: 'IMMEDIATE_ACTION'
             },
@@ -39,14 +43,14 @@ const definitions = {
                 id: 'plan',
                 label: '/plan',
                 stateLabel: 'Plan Mode',
-                description: '开启或关闭协作规划模式。',
+                description: 'Toggle collaborative Plan Mode.',
                 inputHint: '/plan',
                 interaction: 'TOGGLE'
             },
             {
                 id: 'fast',
                 label: '/fast',
-                description: '开启或关闭当前模型可用的快速服务层。',
+                description: 'Toggle the fast service tier when supported.',
                 inputHint: '/fast',
                 interaction: 'TOGGLE'
             }
@@ -74,21 +78,25 @@ const definitions = {
             { id: 'haiku', label: 'Claude Haiku', supportedEfforts: ['low', 'medium'] }
         ],
         accessOptions: [
-            { id: 'default', label: 'Default', description: '按 Claude Code 默认规则确认危险操作。' },
+            { id: 'default', label: 'Default', description: 'Use Claude Code default confirmations.' },
             {
                 id: 'accept-edits',
                 label: 'Accept edits',
-                description: '自动接受当前工作区内的文件编辑。'
+                description: 'Automatically accept edits in the current Workspace.'
+            },
+            {
+                id: 'bypass',
+                label: 'Bypass permissions',
+                description: 'Bypass permission confirmations.'
             },
-            { id: 'bypass', label: 'Bypass permissions', description: '跳过 Claude Code 的权限确认。' },
-            { id: 'plan', label: 'Plan Mode', description: '以 Claude Code 的计划模式运行，不执行工具。' }
+            { id: 'plan', label: 'Plan Mode', description: 'Run in Plan Mode without executing tools.' }
         ],
         commands: [
             {
                 id: 'compact',
                 runner: 'claude-code',
                 label: '/compact',
-                description: '由 Claude Agent SDK 在当前会话中压缩上下文。',
+                description: 'Compact context through the Claude Agent SDK.',
                 inputHint: '/compact',
                 source: 'CLAUDE_AGENT_SDK',
                 interaction: 'IMMEDIATE_ACTION',
@@ -100,7 +108,7 @@ const definitions = {
                 runner: 'claude-code',
                 label: '/plan',
                 stateLabel: 'Plan Mode',
-                description: '开启或关闭标签式规划模式，只读规划并输出计划卡。',
+                description: 'Toggle read-only tagged Plan Mode.',
                 inputHint: '/plan',
                 source: 'CLAUDE_AGENT_SDK',
                 interaction: 'TOGGLE',
@@ -116,12 +124,12 @@ const definitions = {
             {
                 id: 'default',
                 label: 'Default',
-                description: '按 OpenCode 和当前 Workspace 配置确认权限。'
+                description: 'Use OpenCode and Workspace permission configuration.'
             },
             {
                 id: 'auto',
                 label: 'Auto approve',
-                description: '自动允许 OpenCode 请求的工具权限。'
+                description: 'Automatically allow requested tool permissions.'
             }
         ],
         commands: [
@@ -129,7 +137,7 @@ const definitions = {
                 id: 'compact',
                 runner: 'opencode',
                 label: '/compact',
-                description: '通过 OpenCode 压缩当前会话上下文。',
+                description: 'Compact context through OpenCode.',
                 inputHint: '/compact',
                 source: 'OPENCODE_SERVER',
                 interaction: 'IMMEDIATE_ACTION',
@@ -141,7 +149,7 @@ const definitions = {
                 runner: 'opencode',
                 label: '/plan',
                 stateLabel: 'Plan Mode',
-                description: '开启或关闭 OpenCode 原生 Plan Agent。',
+                description: 'Toggle the native OpenCode Plan Agent.',
                 inputHint: '/plan',
                 source: 'OPENCODE_SERVER',
                 interaction: 'TOGGLE',

package/dist/runner-usage.js

@@ -70,9 +70,9 @@ export class RunnerUsageReader {
             'Content-Type': 'application/json'
         });
         const windows = [
-            usageWindow(value, 'five_hour', '5 小时额度'),
-            usageWindow(value, 'seven_day', '7 天额度'),
-            usageWindow(value, 'seven_day_sonnet', '7 天 Sonnet 额度')
+            usageWindow(value, 'five_hour', '5-hour limit'),
+            usageWindow(value, 'seven_day', '7-day limit'),
+            usageWindow(value, 'seven_day_sonnet', '7-day Sonnet limit')
         ].filter((window) => window !== undefined);
         if (windows.length === 0)
             throw new Error('USAGE_RESPONSE_INVALID');
@@ -158,9 +158,9 @@ function codexUsageWindow(value, key) {
     const window = record(record(value)?.rate_limit)?.[key];
     const duration = number(record(window)?.limit_window_seconds);
     const label = duration !== undefined && approximately(duration, 5 * 60 * 60)
-        ? '5 小时额度'
+        ? '5-hour limit'
         : duration !== undefined && approximately(duration, 7 * 24 * 60 * 60)
-            ? '7 天额度'
+            ? '7-day limit'
             : undefined;
     return label === undefined ? undefined : usageWindow(value, key, label);
 }

package/dist/service/conversation-history-service.js

@@ -16,35 +16,66 @@ export class ConversationHistoryService {
     async read(session, input) {
         const snapshotSequence = this.options.snapshotSequence();
         const readAt = Date.now();
-        const official = await this.readOfficial(session, input);
+        let official = await this.readOfficial(session, input);
         if (official !== undefined) {
+            const limit = Math.min(Math.max(input.limit ?? 30, 1), 500);
+            const runtimeTurns = this.options.runtime.getAgentSession(session.id) === undefined
+                ? []
+                : this.options.runtime.listConversationTurns({ sessionId: session.id, limit: 500 }).turns;
+            const initialOfficialRunIds = new Set(official.turns.flatMap((turn) => (turn.runId === null ? [] : [turn.runId])));
+            const absentLocalTurns = runtimeTurns.filter((turn) => turn.runId === null || !initialOfficialRunIds.has(turn.runId));
+            const officialFloor = Math.min(...official.turns.map((turn) => Math.max(turn.startedAt ?? 0, turn.completedAt ?? 0)));
+            const missingLocalTurns = official.turns.length === 0
+                ? absentLocalTurns.slice(-limit)
+                : officialFloor > 0
+                    ? absentLocalTurns.filter((turn) => Math.max(turn.startedAt ?? 0, turn.completedAt ?? 0) >= officialFloor)
+                    : absentLocalTurns.slice(-1);
+            if (input.cursor === undefined &&
+                missingLocalTurns.length > 0 &&
+                official.turns.length + missingLocalTurns.length > limit) {
+                const reserved = Math.min(missingLocalTurns.length, Math.max(0, limit - 1));
+                const narrowed = await this.readOfficial(session, { ...input, limit: limit - reserved });
+                if (narrowed !== undefined)
+                    official = narrowed;
+            }
             const officialTurns = await this.attachNativeImages(session, official.turns);
             const officialRunIds = new Set(officialTurns.flatMap((turn) => (turn.runId === null ? [] : [turn.runId])));
-            const localTurns = this.options.runtime.getAgentSession(session.id) === undefined
-                ? []
-                : this.options.runtime
-                    .listConversationTurns({ sessionId: session.id, limit: 500 })
-                    .turns.flatMap((turn) => {
-                    if (turn.runId === null || !officialRunIds.has(turn.runId))
-                        return [turn];
-                    const pendingItems = turn.items.filter((item) => item.kind === 'user_input_request' && item.status === 'PENDING');
-                    return pendingItems.length === 0 ? [] : [{ ...turn, items: pendingItems }];
-                });
-            const localRequestIds = new Set(localTurns.flatMap((turn) => turn.items.flatMap((item) => {
-                const requestId = item.kind === 'user_input_request' && isPlainRecord(item.payload)
-                    ? item.payload.requestId
-                    : undefined;
-                return typeof requestId === 'string' ? [requestId] : [];
-            })));
+            const pendingItemsByRunId = new Map();
+            for (const turn of runtimeTurns) {
+                if (turn.runId === null || !officialRunIds.has(turn.runId))
+                    continue;
+                const pendingItems = turn.items.filter((item) => item.kind === 'user_input_request' && item.status === 'PENDING');
+                if (pendingItems.length > 0)
+                    pendingItemsByRunId.set(turn.runId, pendingItems);
+            }
+            const availableLocalSlots = Math.max(0, limit - officialTurns.length);
+            const localCandidates = (input.cursor === undefined ? missingLocalTurns : []).sort((left, right) => (left.startedAt ?? 0) - (right.startedAt ?? 0));
+            const localTurns = availableLocalSlots === 0 ? [] : localCandidates.slice(-availableLocalSlots);
+            const localRequestIds = new Set([
+                ...localTurns.flatMap((turn) => turn.items.flatMap((item) => {
+                    const requestId = item.kind === 'user_input_request' && isPlainRecord(item.payload)
+                        ? item.payload.requestId
+                        : undefined;
+                    return typeof requestId === 'string' ? [requestId] : [];
+                })),
+                ...[...pendingItemsByRunId.values()].flatMap((items) => items.flatMap((item) => {
+                    const requestId = isPlainRecord(item.payload) ? item.payload.requestId : undefined;
+                    return typeof requestId === 'string' ? [requestId] : [];
+                }))
+            ]);
             const turns = [
                 ...officialTurns
-                    .map((turn) => ({
-                    ...turn,
-                    items: turn.items.filter((item) => item.kind !== 'user_input_request' ||
-                        !isPlainRecord(item.payload) ||
-                        typeof item.payload.requestId !== 'string' ||
-                        !localRequestIds.has(item.payload.requestId))
-                }))
+                    .map((turn) => {
+                    const pendingItems = turn.runId === null ? [] : (pendingItemsByRunId.get(turn.runId) ?? []);
+                    const items = [
+                        ...turn.items.filter((item) => item.kind !== 'user_input_request' ||
+                            !isPlainRecord(item.payload) ||
+                            typeof item.payload.requestId !== 'string' ||
+                            !localRequestIds.has(item.payload.requestId)),
+                        ...pendingItems
+                    ];
+                    return { ...turn, items };
+                })
                     .filter((turn) => turn.items.length > 0),
                 ...localTurns
             ].sort((left, right) => (left.startedAt ?? 0) - (right.startedAt ?? 0));

package/dist/service/conversation-segment-service.d.ts

@@ -0,0 +1,20 @@
+import type { ConversationSegment, ConversationSegmentPage } from '@myagentroam/protocol';
+import type { NodeAgentSession, NodeConversationTurn } from '../database.js';
+import type { ConversationHistoryPage } from '../util/runner-native-session-parsers.js';
+export declare function conversationSegments(turn: NodeConversationTurn): ConversationSegment[];
+export declare function conversationSegmentIdentityForItem(turn: NodeConversationTurn, itemId: string, itemKind?: string): {
+    readonly id: string;
+    readonly index: number;
+};
+export declare class ConversationSegmentService {
+    private readonly readTurns;
+    constructor(readTurns: (session: NodeAgentSession, input: {
+        readonly cursor?: string;
+        readonly limit?: number;
+    }) => Promise<ConversationHistoryPage>);
+    projectInitial(session: NodeAgentSession, page: ConversationHistoryPage, limit: number): ConversationSegmentPage;
+    read(session: NodeAgentSession, input: {
+        readonly cursor?: string;
+        readonly limit?: number;
+    }): Promise<ConversationSegmentPage>;
+}