@zhushanwen/subagent-engine-sdk 0.2.0

package/dist/index.d.cts

@@ -0,0 +1,23 @@
+export { CANCEL_SETTLE_GRACE_MS, CRASH_REBUILD_BACKOFF_MS, CRASH_REBUILD_MAX_ATTEMPTS, CancelParams, CancelResult, DisposeParams, DisposeResult, ENGINE_EVENT_COALESCE_DEFAULT, ENGINE_EVENT_COALESCE_ENV, ENGINE_PROTOCOL_SCHEMAS, ENGINE_PROTOCOL_VERSION, FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS, HANDSHAKE_TIMEOUT_MS, HostAskUserParams, HostAskUserResult, HostChildSpawnedParams, HostChildStateChangedParams, HostHandleReadyParams, HostLogParams, HostPermissionParams, HostPermissionResult, HostPoolResolvedParams, HostRoundLifecycleParams, HostStreamDeltaParams, InitializeParams, InitializeResult, InteractParams, ListModelsParams, ListModelsResult, PROTOCOL_METHODS, PingParams, PingResult, ProbeParams, ProtocolMethod, ProtocolParamsMap, ProtocolResultMap, REVERSE_CHANNELS, REVERSE_CHANNEL_NAMES, REVERSE_CHANNEL_TIMEOUT_CLASS, REVERSE_REQUEST_TIMEOUT_MS, ReadParams, ReverseChannel, ReverseChannelParamsMap, ReverseChannelResultMap, ReverseRequestTimeoutClass, RoundFailedPhase, RoundIdlePhase, RoundKeyedByRecord, RoundKeyedByRun, RoundLifecyclePhase, RoundSettledPhase, RunChatParams, RunContextParams, RunParams, RunResult, STDERR_TAIL_CHARS, SUPPORTED_PROTOCOL_RANGE, ValidateModelParams, ValidateModelResult, errorResponseFrameSchema, isHostRoundLifecycleParams, isHostStreamDeltaParams, isProtocolVersionCompatible, notificationFrameSchema, protocolErrorSchema, requestFrameSchema, reverseRequestFrameSchema, successResponseFrameSchema } from './protocol/index.cjs';
+export { A as AnyFrame, E as ENGINE_ERROR_CODE_PREFIX, a as ENGINE_PROTOCOL_ERROR_CODES, b as ENGINE_TIMEOUT_RECOVERY, c as EngineProtocolErrorCode, d as EngineSdkError, e as ErrorResponseFrame, f as EventNotificationParams, N as NotificationFrame, P as ProtocolError, R as RequestFrame, g as ResponseFrame, h as ReverseRequestFrame, i as ReverseResponseResult, S as STDOUT_TAIL_ECHO_CHARS, j as SuccessResponseFrame, k as assertChatConversationSupported, l as engineConversationUnsupportedError, m as engineProtocolMismatchError, n as engineTimeoutDetail, o as isEngineErrorPassthroughCode, p as isEngineProtocolErrorCode, q as isNotificationFrame, r as isRequestFrame, s as isResponseFrame, t as isReverseRequestFrame, u as schemaEmulationFailedDetail } from './error-codes-DHco5-i_.cjs';
+export { A as AgentCallOpts, a as AgentEvent, b as AgentFailureKind, c as AgentOutcome, d as AgentOutcomeUsage, e as AgentUsage, f as AgentUsageTotal, g as AssertMutuallyAssignable, E as EngineCapabilities, h as EngineHandleData, I as InteractAction, i as InteractResult, j as InternalToolCall, M as ModelCatalogEntry, P as ProbeReport, R as ReplayedTurn, k as ResumeAnchor, S as SessionView, T as ToolCall, l as ToolCallEntry, m as ToolCallResult, n as Turn, W as WorktreeHandle } from './contract-types-sSlgppBC.cjs';
+export { SCHEMA_EMULATION_TAIL_CHARS, StructuredOutputResult, buildSchemaEmulationSegment, extractAndValidateStructuredOutput } from './schema-emulation.cjs';
+export { ExecutionNestingContext, ExecutionNestingState, NESTED_SPAWN_ENV, NestedSpawnRejectedError, SpawnEnv, assertNotNestedSpawn, buildNestedSpawnEnv } from './nesting-guard.cjs';
+export { CoreLogger, LogLevel, LoggerSink, configureLoggerSink, getLogger, resetLoggerSinkForTests } from './logger.cjs';
+export { DEFAULT_KILL_GRACE_MS, DEFAULT_NATIVE_INTERRUPT_GRACE_MS, HOST_TIMEOUT_ABORT_REASON, KillChainOptions, KillableChild, abortWithFallback, killChain, synthesizeTimeoutOutcome } from './kill-chain.cjs';
+export { ReplayRecordView, aggregateUsage, createReplayRecord, eventsToSessionView, sessionIdFromHandle, toReplayedTurn, updateFromEvent } from './journal-replay.cjs';
+export { XYZ_DATA_DIR_ENV, resetDataDirWarnForTests, resolveEngineDataDir } from './data-dir.cjs';
+export { resolveEngineDir, resolveEnginesRoot, resolveJournalPath, resolvePoolDir, sanitizeSeg } from './paths.cjs';
+export { UiMethod, UiRequest, UiRequestHandler, UiResponse } from './ui-types.cjs';
+export { ChannelHandler, ExtensionUiRequestLike, ParsedChannel, UiChannelRegistry, createUiChannelRegistry, parseChannel } from './ui-channels.cjs';
+export { BuildOutboundChildEnvOptions, ENGINE_ENV_DENY_LIST, ENGINE_ENV_L0_INFRA_KEYS, ENGINE_ENV_PREFIXES, EngineChildEnvOptions, EngineRelayEnv, buildEngineChildEnv, buildOutboundChildEnv } from './env.cjs';
+export { DEFAULT_ENGINE_HOST_REQUEST_TIMEOUT_MS, ENGINE_HOST_REQUEST_TIMEOUT_ENV, EngineChildEnv, EngineSelfDestructOptions, ReverseRequestClock, SpawnEngineChildOptions, armEngineSelfDestruct, pumpNdjsonLines, spawnEngineChild } from './spawn.cjs';
+export { ENGINE_NODE_ENV, EngineNodeHostKind, EngineNodeLaunch, EngineNodeLaunchOptions, hostKindOf, probeNodeExecutor, resetEngineNodeProbeCache, resolveEngineNodeLaunch } from './node-executor.cjs';
+export { CleanupResult, DEFAULT_STDERR_KEEP_DAYS, DEFAULT_STDERR_MAX_BYTES, StderrRotationParams, cleanupSiblingStderrLogs, cleanupStaleStderrLogs, isPidAlive, rotateStderrLogIfNeeded, stderrLogPathFor, stderrLogPidOf, stderrRotationParams } from './logs/stderr-rotation.cjs';
+export { RELAY_ENV_NODE, RELAY_ENV_RECORD_ID, RELAY_ENV_SCRIPT, RELAY_ENV_SESSION_ID, RELAY_ENV_SOCKET, RELAY_EXIT_CODES, RELAY_PROTOCOL_VERSION, isRelayActive, readRelayForwardEnv } from './relay-env.cjs';
+export { toErrorMessage } from './error-message.cjs';
+export { BestEffortLevel, bestEffort } from './best-effort.cjs';
+export { replayJournal } from './journal-io.cjs';
+export { EngineAgentCallOpts, EngineCtxModel, EngineHandle, EnginePort, EngineRunResult, EngineStream, RunContext, parseCtxModel } from './port-contract.cjs';
+export { CliProtocolServerSink, RunEngineCliEntryOptions, runEngineCliEntry } from './cli-entry.cjs';
+import 'node:child_process';

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+export { CANCEL_SETTLE_GRACE_MS, CRASH_REBUILD_BACKOFF_MS, CRASH_REBUILD_MAX_ATTEMPTS, CancelParams, CancelResult, DisposeParams, DisposeResult, ENGINE_EVENT_COALESCE_DEFAULT, ENGINE_EVENT_COALESCE_ENV, ENGINE_PROTOCOL_SCHEMAS, ENGINE_PROTOCOL_VERSION, FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS, HANDSHAKE_TIMEOUT_MS, HostAskUserParams, HostAskUserResult, HostChildSpawnedParams, HostChildStateChangedParams, HostHandleReadyParams, HostLogParams, HostPermissionParams, HostPermissionResult, HostPoolResolvedParams, HostRoundLifecycleParams, HostStreamDeltaParams, InitializeParams, InitializeResult, InteractParams, ListModelsParams, ListModelsResult, PROTOCOL_METHODS, PingParams, PingResult, ProbeParams, ProtocolMethod, ProtocolParamsMap, ProtocolResultMap, REVERSE_CHANNELS, REVERSE_CHANNEL_NAMES, REVERSE_CHANNEL_TIMEOUT_CLASS, REVERSE_REQUEST_TIMEOUT_MS, ReadParams, ReverseChannel, ReverseChannelParamsMap, ReverseChannelResultMap, ReverseRequestTimeoutClass, RoundFailedPhase, RoundIdlePhase, RoundKeyedByRecord, RoundKeyedByRun, RoundLifecyclePhase, RoundSettledPhase, RunChatParams, RunContextParams, RunParams, RunResult, STDERR_TAIL_CHARS, SUPPORTED_PROTOCOL_RANGE, ValidateModelParams, ValidateModelResult, errorResponseFrameSchema, isHostRoundLifecycleParams, isHostStreamDeltaParams, isProtocolVersionCompatible, notificationFrameSchema, protocolErrorSchema, requestFrameSchema, reverseRequestFrameSchema, successResponseFrameSchema } from './protocol/index.js';
+export { A as AnyFrame, E as ENGINE_ERROR_CODE_PREFIX, a as ENGINE_PROTOCOL_ERROR_CODES, b as ENGINE_TIMEOUT_RECOVERY, c as EngineProtocolErrorCode, d as EngineSdkError, e as ErrorResponseFrame, f as EventNotificationParams, N as NotificationFrame, P as ProtocolError, R as RequestFrame, g as ResponseFrame, h as ReverseRequestFrame, i as ReverseResponseResult, S as STDOUT_TAIL_ECHO_CHARS, j as SuccessResponseFrame, k as assertChatConversationSupported, l as engineConversationUnsupportedError, m as engineProtocolMismatchError, n as engineTimeoutDetail, o as isEngineErrorPassthroughCode, p as isEngineProtocolErrorCode, q as isNotificationFrame, r as isRequestFrame, s as isResponseFrame, t as isReverseRequestFrame, u as schemaEmulationFailedDetail } from './error-codes-Dhss2Kmk.js';
+export { A as AgentCallOpts, a as AgentEvent, b as AgentFailureKind, c as AgentOutcome, d as AgentOutcomeUsage, e as AgentUsage, f as AgentUsageTotal, g as AssertMutuallyAssignable, E as EngineCapabilities, h as EngineHandleData, I as InteractAction, i as InteractResult, j as InternalToolCall, M as ModelCatalogEntry, P as ProbeReport, R as ReplayedTurn, k as ResumeAnchor, S as SessionView, T as ToolCall, l as ToolCallEntry, m as ToolCallResult, n as Turn, W as WorktreeHandle } from './contract-types-sSlgppBC.js';
+export { SCHEMA_EMULATION_TAIL_CHARS, StructuredOutputResult, buildSchemaEmulationSegment, extractAndValidateStructuredOutput } from './schema-emulation.js';
+export { ExecutionNestingContext, ExecutionNestingState, NESTED_SPAWN_ENV, NestedSpawnRejectedError, SpawnEnv, assertNotNestedSpawn, buildNestedSpawnEnv } from './nesting-guard.js';
+export { CoreLogger, LogLevel, LoggerSink, configureLoggerSink, getLogger, resetLoggerSinkForTests } from './logger.js';
+export { DEFAULT_KILL_GRACE_MS, DEFAULT_NATIVE_INTERRUPT_GRACE_MS, HOST_TIMEOUT_ABORT_REASON, KillChainOptions, KillableChild, abortWithFallback, killChain, synthesizeTimeoutOutcome } from './kill-chain.js';
+export { ReplayRecordView, aggregateUsage, createReplayRecord, eventsToSessionView, sessionIdFromHandle, toReplayedTurn, updateFromEvent } from './journal-replay.js';
+export { XYZ_DATA_DIR_ENV, resetDataDirWarnForTests, resolveEngineDataDir } from './data-dir.js';
+export { resolveEngineDir, resolveEnginesRoot, resolveJournalPath, resolvePoolDir, sanitizeSeg } from './paths.js';
+export { UiMethod, UiRequest, UiRequestHandler, UiResponse } from './ui-types.js';
+export { ChannelHandler, ExtensionUiRequestLike, ParsedChannel, UiChannelRegistry, createUiChannelRegistry, parseChannel } from './ui-channels.js';
+export { BuildOutboundChildEnvOptions, ENGINE_ENV_DENY_LIST, ENGINE_ENV_L0_INFRA_KEYS, ENGINE_ENV_PREFIXES, EngineChildEnvOptions, EngineRelayEnv, buildEngineChildEnv, buildOutboundChildEnv } from './env.js';
+export { DEFAULT_ENGINE_HOST_REQUEST_TIMEOUT_MS, ENGINE_HOST_REQUEST_TIMEOUT_ENV, EngineChildEnv, EngineSelfDestructOptions, ReverseRequestClock, SpawnEngineChildOptions, armEngineSelfDestruct, pumpNdjsonLines, spawnEngineChild } from './spawn.js';
+export { ENGINE_NODE_ENV, EngineNodeHostKind, EngineNodeLaunch, EngineNodeLaunchOptions, hostKindOf, probeNodeExecutor, resetEngineNodeProbeCache, resolveEngineNodeLaunch } from './node-executor.js';
+export { CleanupResult, DEFAULT_STDERR_KEEP_DAYS, DEFAULT_STDERR_MAX_BYTES, StderrRotationParams, cleanupSiblingStderrLogs, cleanupStaleStderrLogs, isPidAlive, rotateStderrLogIfNeeded, stderrLogPathFor, stderrLogPidOf, stderrRotationParams } from './logs/stderr-rotation.js';
+export { RELAY_ENV_NODE, RELAY_ENV_RECORD_ID, RELAY_ENV_SCRIPT, RELAY_ENV_SESSION_ID, RELAY_ENV_SOCKET, RELAY_EXIT_CODES, RELAY_PROTOCOL_VERSION, isRelayActive, readRelayForwardEnv } from './relay-env.js';
+export { toErrorMessage } from './error-message.js';
+export { BestEffortLevel, bestEffort } from './best-effort.js';
+export { replayJournal } from './journal-io.js';
+export { EngineAgentCallOpts, EngineCtxModel, EngineHandle, EnginePort, EngineRunResult, EngineStream, RunContext, parseCtxModel } from './port-contract.js';
+export { CliProtocolServerSink, RunEngineCliEntryOptions, runEngineCliEntry } from './cli-entry.js';
+import 'node:child_process';

package/dist/index.js

@@ -0,0 +1,268 @@
+import {
+  bestEffort
+} from "./chunk-EJMF63R5.js";
+import {
+  replayJournal
+} from "./chunk-RDH3ZOV6.js";
+import {
+  parseCtxModel
+} from "./chunk-RULLX6C6.js";
+import {
+  runEngineCliEntry
+} from "./chunk-N3RL6OVM.js";
+import {
+  resolveEngineDir,
+  resolveEnginesRoot,
+  resolveJournalPath,
+  resolvePoolDir,
+  sanitizeSeg
+} from "./chunk-OPMY4G4M.js";
+import "./chunk-2DIMPZCQ.js";
+import {
+  createUiChannelRegistry,
+  parseChannel
+} from "./chunk-7I4XGL5J.js";
+import {
+  ENGINE_ENV_DENY_LIST,
+  ENGINE_ENV_L0_INFRA_KEYS,
+  ENGINE_ENV_PREFIXES,
+  buildEngineChildEnv,
+  buildOutboundChildEnv
+} from "./chunk-ZXEAW25V.js";
+import {
+  DEFAULT_ENGINE_HOST_REQUEST_TIMEOUT_MS,
+  ENGINE_HOST_REQUEST_TIMEOUT_ENV,
+  armEngineSelfDestruct,
+  pumpNdjsonLines,
+  spawnEngineChild
+} from "./chunk-3K2P2CM2.js";
+import {
+  ENGINE_NODE_ENV,
+  hostKindOf,
+  probeNodeExecutor,
+  resetEngineNodeProbeCache,
+  resolveEngineNodeLaunch
+} from "./chunk-ZOFFJNJD.js";
+import {
+  DEFAULT_STDERR_KEEP_DAYS,
+  DEFAULT_STDERR_MAX_BYTES,
+  cleanupSiblingStderrLogs,
+  cleanupStaleStderrLogs,
+  isPidAlive,
+  rotateStderrLogIfNeeded,
+  stderrLogPathFor,
+  stderrLogPidOf,
+  stderrRotationParams
+} from "./chunk-HYES77BR.js";
+import {
+  RELAY_ENV_NODE,
+  RELAY_ENV_RECORD_ID,
+  RELAY_ENV_SCRIPT,
+  RELAY_ENV_SESSION_ID,
+  RELAY_ENV_SOCKET,
+  RELAY_EXIT_CODES,
+  RELAY_PROTOCOL_VERSION,
+  isRelayActive,
+  readRelayForwardEnv
+} from "./chunk-DSQ7JQKM.js";
+import {
+  ENGINE_PROTOCOL_SCHEMAS,
+  FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS,
+  PROTOCOL_METHODS,
+  REVERSE_CHANNELS,
+  REVERSE_CHANNEL_NAMES,
+  REVERSE_CHANNEL_TIMEOUT_CLASS,
+  errorResponseFrameSchema,
+  isHostRoundLifecycleParams,
+  isHostStreamDeltaParams,
+  isNotificationFrame,
+  isRequestFrame,
+  isResponseFrame,
+  isReverseRequestFrame,
+  notificationFrameSchema,
+  protocolErrorSchema,
+  requestFrameSchema,
+  reverseRequestFrameSchema,
+  successResponseFrameSchema
+} from "./chunk-YFSN3D5N.js";
+import {
+  SCHEMA_EMULATION_TAIL_CHARS,
+  buildSchemaEmulationSegment,
+  extractAndValidateStructuredOutput
+} from "./chunk-X24SFZYW.js";
+import {
+  ExecutionNestingContext,
+  NESTED_SPAWN_ENV,
+  NestedSpawnRejectedError,
+  assertNotNestedSpawn,
+  buildNestedSpawnEnv
+} from "./chunk-365AUV6N.js";
+import {
+  DEFAULT_KILL_GRACE_MS,
+  DEFAULT_NATIVE_INTERRUPT_GRACE_MS,
+  HOST_TIMEOUT_ABORT_REASON,
+  abortWithFallback,
+  killChain,
+  synthesizeTimeoutOutcome
+} from "./chunk-LEOBWKRM.js";
+import {
+  toErrorMessage
+} from "./chunk-PYO3YR7W.js";
+import {
+  CANCEL_SETTLE_GRACE_MS,
+  CRASH_REBUILD_BACKOFF_MS,
+  CRASH_REBUILD_MAX_ATTEMPTS,
+  ENGINE_ERROR_CODE_PREFIX,
+  ENGINE_EVENT_COALESCE_DEFAULT,
+  ENGINE_EVENT_COALESCE_ENV,
+  ENGINE_PROTOCOL_ERROR_CODES,
+  ENGINE_PROTOCOL_VERSION,
+  ENGINE_TIMEOUT_RECOVERY,
+  EngineSdkError,
+  HANDSHAKE_TIMEOUT_MS,
+  REVERSE_REQUEST_TIMEOUT_MS,
+  STDERR_TAIL_CHARS,
+  STDOUT_TAIL_ECHO_CHARS,
+  SUPPORTED_PROTOCOL_RANGE,
+  assertChatConversationSupported,
+  engineConversationUnsupportedError,
+  engineProtocolMismatchError,
+  engineTimeoutDetail,
+  isEngineErrorPassthroughCode,
+  isEngineProtocolErrorCode,
+  isProtocolVersionCompatible,
+  schemaEmulationFailedDetail
+} from "./chunk-PPEPBVCC.js";
+import {
+  aggregateUsage,
+  createReplayRecord,
+  eventsToSessionView,
+  sessionIdFromHandle,
+  toReplayedTurn,
+  updateFromEvent
+} from "./chunk-A75XDJIC.js";
+import {
+  XYZ_DATA_DIR_ENV,
+  resetDataDirWarnForTests,
+  resolveEngineDataDir
+} from "./chunk-GT6YLLN4.js";
+import {
+  configureLoggerSink,
+  getLogger,
+  resetLoggerSinkForTests
+} from "./chunk-75QEMUGV.js";
+import "./chunk-JSBRDJBE.js";
+export {
+  CANCEL_SETTLE_GRACE_MS,
+  CRASH_REBUILD_BACKOFF_MS,
+  CRASH_REBUILD_MAX_ATTEMPTS,
+  DEFAULT_ENGINE_HOST_REQUEST_TIMEOUT_MS,
+  DEFAULT_KILL_GRACE_MS,
+  DEFAULT_NATIVE_INTERRUPT_GRACE_MS,
+  DEFAULT_STDERR_KEEP_DAYS,
+  DEFAULT_STDERR_MAX_BYTES,
+  ENGINE_ENV_DENY_LIST,
+  ENGINE_ENV_L0_INFRA_KEYS,
+  ENGINE_ENV_PREFIXES,
+  ENGINE_ERROR_CODE_PREFIX,
+  ENGINE_EVENT_COALESCE_DEFAULT,
+  ENGINE_EVENT_COALESCE_ENV,
+  ENGINE_HOST_REQUEST_TIMEOUT_ENV,
+  ENGINE_NODE_ENV,
+  ENGINE_PROTOCOL_ERROR_CODES,
+  ENGINE_PROTOCOL_SCHEMAS,
+  ENGINE_PROTOCOL_VERSION,
+  ENGINE_TIMEOUT_RECOVERY,
+  EngineSdkError,
+  ExecutionNestingContext,
+  FORBIDDEN_CREDENTIAL_KEY_FRAGMENTS,
+  HANDSHAKE_TIMEOUT_MS,
+  HOST_TIMEOUT_ABORT_REASON,
+  NESTED_SPAWN_ENV,
+  NestedSpawnRejectedError,
+  PROTOCOL_METHODS,
+  RELAY_ENV_NODE,
+  RELAY_ENV_RECORD_ID,
+  RELAY_ENV_SCRIPT,
+  RELAY_ENV_SESSION_ID,
+  RELAY_ENV_SOCKET,
+  RELAY_EXIT_CODES,
+  RELAY_PROTOCOL_VERSION,
+  REVERSE_CHANNELS,
+  REVERSE_CHANNEL_NAMES,
+  REVERSE_CHANNEL_TIMEOUT_CLASS,
+  REVERSE_REQUEST_TIMEOUT_MS,
+  SCHEMA_EMULATION_TAIL_CHARS,
+  STDERR_TAIL_CHARS,
+  STDOUT_TAIL_ECHO_CHARS,
+  SUPPORTED_PROTOCOL_RANGE,
+  XYZ_DATA_DIR_ENV,
+  abortWithFallback,
+  aggregateUsage,
+  armEngineSelfDestruct,
+  assertChatConversationSupported,
+  assertNotNestedSpawn,
+  bestEffort,
+  buildEngineChildEnv,
+  buildNestedSpawnEnv,
+  buildOutboundChildEnv,
+  buildSchemaEmulationSegment,
+  cleanupSiblingStderrLogs,
+  cleanupStaleStderrLogs,
+  configureLoggerSink,
+  createReplayRecord,
+  createUiChannelRegistry,
+  engineConversationUnsupportedError,
+  engineProtocolMismatchError,
+  engineTimeoutDetail,
+  errorResponseFrameSchema,
+  eventsToSessionView,
+  extractAndValidateStructuredOutput,
+  getLogger,
+  hostKindOf,
+  isEngineErrorPassthroughCode,
+  isEngineProtocolErrorCode,
+  isHostRoundLifecycleParams,
+  isHostStreamDeltaParams,
+  isNotificationFrame,
+  isPidAlive,
+  isProtocolVersionCompatible,
+  isRelayActive,
+  isRequestFrame,
+  isResponseFrame,
+  isReverseRequestFrame,
+  killChain,
+  notificationFrameSchema,
+  parseChannel,
+  parseCtxModel,
+  probeNodeExecutor,
+  protocolErrorSchema,
+  pumpNdjsonLines,
+  readRelayForwardEnv,
+  replayJournal,
+  requestFrameSchema,
+  resetDataDirWarnForTests,
+  resetEngineNodeProbeCache,
+  resetLoggerSinkForTests,
+  resolveEngineDataDir,
+  resolveEngineDir,
+  resolveEngineNodeLaunch,
+  resolveEnginesRoot,
+  resolveJournalPath,
+  resolvePoolDir,
+  reverseRequestFrameSchema,
+  rotateStderrLogIfNeeded,
+  runEngineCliEntry,
+  sanitizeSeg,
+  schemaEmulationFailedDetail,
+  sessionIdFromHandle,
+  spawnEngineChild,
+  stderrLogPathFor,
+  stderrLogPidOf,
+  stderrRotationParams,
+  successResponseFrameSchema,
+  synthesizeTimeoutOutcome,
+  toErrorMessage,
+  toReplayedTurn,
+  updateFromEvent
+};

package/dist/journal-io.cjs

@@ -0,0 +1,70 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/journal-io.ts
+var journal_io_exports = {};
+__export(journal_io_exports, {
+  replayJournal: () => replayJournal
+});
+module.exports = __toCommonJS(journal_io_exports);
+var import_node_fs = require("fs");
+function replayJournal(path) {
+  let raw;
+  try {
+    raw = (0, import_node_fs.readFileSync)(path, "utf8");
+  } catch {
+    return [];
+  }
+  const lines = [];
+  for (const row of raw.split("\n")) {
+    const trimmed = row.trim();
+    if (trimmed === "") continue;
+    const parsed = parseLine(trimmed);
+    if (parsed !== void 0) lines.push(parsed);
+  }
+  lines.sort((a, b) => a.seq - b.seq);
+  return lines.map((l) => l.event);
+}
+function parseLine(trimmed) {
+  let parsed;
+  try {
+    parsed = JSON.parse(trimmed);
+  } catch {
+    return void 0;
+  }
+  if (typeof parsed !== "object" || parsed === null) return void 0;
+  const rec = parsed;
+  const event = rec.event;
+  if (rec.v !== 1 || typeof rec.ts !== "number" || typeof rec.seq !== "number") return void 0;
+  if (typeof event !== "object" || event === null || typeof event.type !== "string") {
+    return void 0;
+  }
+  return {
+    v: 1,
+    ts: rec.ts,
+    taskId: typeof rec.taskId === "string" ? rec.taskId : "",
+    engineId: typeof rec.engineId === "string" ? rec.engineId : "",
+    seq: rec.seq,
+    event
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  replayJournal
+});

package/dist/journal-io.d.cts

@@ -0,0 +1,12 @@
+import { a as AgentEvent } from './contract-types-sSlgppBC.cjs';
+
+/**
+ * 重放 journal：读取路径下全部事件，重放即得 AgentEvent 流（read 第②级）。
+ *
+ * - 文件不存在 → []（降级链语义：②级不可达不算错误，调用方落 ③级）；
+ * - 损坏行跳过（追加写产物末行可能截断；跳过优于整体失败——设计 C5「三级都不 throw」）；
+ * - 按 seq 稳定排序后返回（重放顺序权威是 seq，不依赖文件行序的隐式保证，§3.3.6）。
+ */
+declare function replayJournal(path: string): AgentEvent[];
+
+export { replayJournal };

package/dist/journal-io.d.ts

@@ -0,0 +1,12 @@
+import { a as AgentEvent } from './contract-types-sSlgppBC.js';
+
+/**
+ * 重放 journal：读取路径下全部事件，重放即得 AgentEvent 流（read 第②级）。
+ *
+ * - 文件不存在 → []（降级链语义：②级不可达不算错误，调用方落 ③级）；
+ * - 损坏行跳过（追加写产物末行可能截断；跳过优于整体失败——设计 C5「三级都不 throw」）；
+ * - 按 seq 稳定排序后返回（重放顺序权威是 seq，不依赖文件行序的隐式保证，§3.3.6）。
+ */
+declare function replayJournal(path: string): AgentEvent[];
+
+export { replayJournal };

package/dist/journal-io.js

@@ -0,0 +1,7 @@
+import {
+  replayJournal
+} from "./chunk-RDH3ZOV6.js";
+import "./chunk-JSBRDJBE.js";
+export {
+  replayJournal
+};

package/dist/journal-replay.cjs

@@ -0,0 +1,256 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/journal-replay.ts
+var journal_replay_exports = {};
+__export(journal_replay_exports, {
+  aggregateUsage: () => aggregateUsage,
+  createReplayRecord: () => createReplayRecord,
+  eventsToSessionView: () => eventsToSessionView,
+  sessionIdFromHandle: () => sessionIdFromHandle,
+  toReplayedTurn: () => toReplayedTurn,
+  updateFromEvent: () => updateFromEvent
+});
+module.exports = __toCommonJS(journal_replay_exports);
+function sumUsageField(a, b) {
+  return (a ?? 0) + (b ?? 0);
+}
+function usageFromNext(next) {
+  return {
+    input: next.input ?? 0,
+    output: next.output ?? 0,
+    cacheRead: next.cacheRead ?? 0,
+    cacheWrite: next.cacheWrite ?? 0,
+    cost: next.cost
+  };
+}
+function addUsage(prev, next) {
+  if (prev === void 0) return usageFromNext(next);
+  return {
+    input: sumUsageField(prev.input, next.input),
+    output: sumUsageField(prev.output, next.output),
+    cacheRead: sumUsageField(prev.cacheRead, next.cacheRead),
+    cacheWrite: sumUsageField(prev.cacheWrite, next.cacheWrite),
+    cost: sumUsageField(prev.cost, next.cost)
+  };
+}
+function emptyTurn() {
+  return { text: "", thinking: "", toolCalls: [], usageDelta: void 0, closed: false };
+}
+function createReplayRecord() {
+  return {
+    // turns[] 初始化为 [空 turn]——第一个 turn 从创建即存在，
+    // updateFromEvent 直接往 turns[last] 累积，无需「无 turn」分支判断。
+    turns: [emptyTurn()],
+    turnCount: 0,
+    totalTokens: 0,
+    lastError: void 0
+  };
+}
+function currentTurn(record) {
+  const last = record.turns[record.turns.length - 1];
+  if (last !== void 0 && !last.closed) return last;
+  const fresh = emptyTurn();
+  record.turns.push(fresh);
+  return fresh;
+}
+function findRunningToolCall(record, toolName) {
+  for (let t = record.turns.length - 1; t >= 0; t--) {
+    const turn = record.turns[t];
+    if (turn === void 0) continue;
+    for (let i = turn.toolCalls.length - 1; i >= 0; i--) {
+      const tc = turn.toolCalls[i];
+      if (tc?._status === "running" && tc.toolName === toolName) {
+        return [turn, i];
+      }
+    }
+  }
+  return void 0;
+}
+var runningToolIndex = /* @__PURE__ */ new WeakMap();
+function indexToolStart(record, turn, toolName) {
+  let byName = runningToolIndex.get(record);
+  if (byName === void 0) {
+    byName = /* @__PURE__ */ new Map();
+    runningToolIndex.set(record, byName);
+  }
+  const arr = byName.get(toolName);
+  if (arr === void 0) {
+    byName.set(toolName, [{ turn, idx: turn.toolCalls.length - 1 }]);
+  } else {
+    arr.push({ turn, idx: turn.toolCalls.length - 1 });
+  }
+}
+function applyTextDelta(record, event) {
+  currentTurn(record).text += event.delta;
+}
+function applyThinkingDelta(record, event) {
+  currentTurn(record).thinking += event.delta;
+}
+function applyToolStart(record, event) {
+  const tc = {
+    toolName: event.toolName,
+    args: event.args,
+    result: void 0,
+    isError: false,
+    _status: "running",
+    startedTs: Date.now()
+  };
+  const turn = currentTurn(record);
+  turn.toolCalls.push(tc);
+  indexToolStart(record, turn, event.toolName);
+}
+function matchRunningToolCall(record, toolName) {
+  const byName = runningToolIndex.get(record);
+  const arr = byName?.get(toolName);
+  if (arr !== void 0 && arr.length > 0) {
+    const item = arr[arr.length - 1];
+    arr.pop();
+    const tc = item.turn.toolCalls[item.idx];
+    if (tc !== void 0 && tc._status === "running") {
+      return [item.turn, item.idx];
+    }
+  }
+  return findRunningToolCall(record, toolName);
+}
+function applyToolEnd(record, event) {
+  const matched = matchRunningToolCall(record, event.toolName);
+  if (matched !== void 0) {
+    const [turn, i] = matched;
+    const tc = turn.toolCalls[i];
+    tc.args = event.args ?? tc.args;
+    tc.result = event.result;
+    tc.isError = event.isError ?? false;
+    tc._status = event.isError ? "failed" : "done";
+    return;
+  }
+  currentTurn(record).toolCalls.push({
+    toolName: event.toolName,
+    args: event.args,
+    result: event.result,
+    isError: event.isError ?? false,
+    _status: event.isError ? "failed" : "done",
+    startedTs: Date.now()
+  });
+}
+function applyTurnEnd(record) {
+  const turn = currentTurn(record);
+  turn.closed = true;
+  turn.closedTs = Date.now();
+  record.turnCount += 1;
+  record.lastError = void 0;
+}
+function applyMessageEnd(record, event) {
+  if (event.usage) {
+    const turn = currentTurn(record);
+    turn.usageDelta = addUsage(turn.usageDelta, event.usage);
+    record.totalTokens += (event.usage.input ?? 0) + (event.usage.output ?? 0) + (event.usage.cacheRead ?? 0) + (event.usage.cacheWrite ?? 0);
+  }
+  if (event.error) {
+    record.lastError = event.error;
+  }
+}
+function applyErrorEvent(record, event) {
+  record.lastError = event.message;
+}
+function updateFromEvent(record, event) {
+  switch (event.type) {
+    // ── text / thinking：流式累积进当前 turn ──
+    case "text_delta":
+      return applyTextDelta(record, event);
+    case "thinking_delta":
+      return applyThinkingDelta(record, event);
+    // ── tool_start/end：push 进 currentTurn().toolCalls（含完整 result）──
+    case "tool_start":
+      return applyToolStart(record, event);
+    case "tool_end":
+      return applyToolEnd(record, event);
+    // ── turn_end：闭合当前 turn ──
+    case "turn_end":
+      return applyTurnEnd(record);
+    // ── message_end：usage 增量累加 + totalTokens 累加 ──
+    case "message_end":
+      return applyMessageEnd(record, event);
+    // ── error：存 record.lastError ──
+    case "error":
+      return applyErrorEvent(record, event);
+    // ── compaction：不产生数据（不变）──
+    case "compaction":
+      return;
+    default: {
+      const _exhaustive = event;
+      return _exhaustive;
+    }
+  }
+}
+function toExportedToolCall(tc) {
+  return {
+    toolName: tc.toolName,
+    ...tc.args !== void 0 ? { args: tc.args } : {},
+    ...tc.result !== void 0 ? { result: tc.result } : {},
+    ...tc.isError !== void 0 ? { isError: tc.isError } : {}
+  };
+}
+function toReplayedTurn(turn) {
+  return {
+    text: turn.text,
+    thinking: turn.thinking,
+    toolCalls: turn.toolCalls.map(toExportedToolCall),
+    closed: true
+  };
+}
+function aggregateUsage(turns) {
+  let acc;
+  for (const turn of turns) {
+    const d = turn.usageDelta;
+    if (!d) continue;
+    if (!acc) acc = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0, total: 0 };
+    acc.input += d.input;
+    acc.output += d.output;
+    acc.cacheRead += d.cacheRead;
+    acc.cacheWrite += d.cacheWrite;
+    acc.cost += d.cost ?? 0;
+  }
+  if (acc) acc.total = acc.input + acc.output + acc.cacheRead + acc.cacheWrite;
+  return acc;
+}
+function eventsToSessionView(events, engineId, sessionId) {
+  const record = createReplayRecord();
+  for (const ev of events) updateFromEvent(record, ev);
+  return {
+    engineId,
+    ...sessionId !== void 0 ? { sessionId } : {},
+    turns: record.turns.map(toReplayedTurn),
+    usage: aggregateUsage(record.turns),
+    source: "journal"
+  };
+}
+function sessionIdFromHandle(handle) {
+  const v = handle.sessionRef["sessionId"];
+  return typeof v === "string" ? v : void 0;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  aggregateUsage,
+  createReplayRecord,
+  eventsToSessionView,
+  sessionIdFromHandle,
+  toReplayedTurn,
+  updateFromEvent
+});