@botbotgo/agent-harness 0.0.290 → 0.0.291

package/README.md

@@ -162,7 +162,7 @@ What you get on day one:
 
 - a runtime that keeps `requests`, `sessions`, `approvals`, and `events` as inspectable product records
 - a recovery path that survives interruption, restart, and operator decisions
-- stable run correlation and continuity metadata so operators can join one persisted run to logs, traces, and fallback transitions
+- stable request correlation and continuity metadata so operators can join one persisted request to logs, traces, and fallback transitions
 - approval defaults for sensitive durable memory writes and write-like MCP calls instead of relying on each tool definition to remember governance
 - one workspace-shaped assembly model instead of app-specific runtime glue
 - one stable runtime contract even when execution backends change underneath
@@ -291,7 +291,7 @@ Recommended orchestration shape for long-running flows:
 These scenarios map most directly to what the runtime is built for:
 
 - Enterprise internal agent runtime: approvals, restart-safe recovery, operator evidence, and policy-owned MCP access.
-- Code modernization runtime: long-running coding flows, approval checkpoints, resumable runs, and exported evidence packages.
+- Code modernization runtime: long-running coding flows, approval checkpoints, resumable requests, and exported evidence packages.
 - Agent-ops and remediation workflow runtime: parallel agent attempts, human review gates, durable evidence, and operator visibility for security or maintenance work.
 - Protocol bridge runtime: ACP, A2A, AG-UI, and runtime MCP on one stable control plane instead of bespoke per-surface glue.
 
@@ -426,7 +426,7 @@ import { AgentHarnessRuntime, createAgentHarness } from "@botbotgo/agent-harness
 const runtime: AgentHarnessRuntime = await createAgentHarness("/absolute/path/to/workspace");
 ```
 
-`createAgentHarness(...)` loads the workspace, resolves `resources/`, initializes persistence under `runRoot`, and starts runtime maintenance.
+`createAgentHarness(...)` loads the workspace, resolves `resources/`, initializes persistence under `runtimeRoot`, and starts runtime maintenance.
 
 `runtime.spec.resources` may attach multiple extra resource packages. Each entry may point either to a package root that contains `resources/`, or directly to a resource folder that contains its own `package.json`.
 
@@ -496,7 +496,7 @@ Use `invocation` as the runtime-facing request envelope:
 For multimodal chat turns, keep the user-visible content in `input`.
 
 - if the product would show the image or text in the chat transcript, it belongs in `input`
-- if the payload is auxiliary run-scoped data rather than the chat turn itself, it belongs in `invocation.attachments`
+- if the payload is auxiliary request-scoped data rather than the chat turn itself, it belongs in `invocation.attachments`
 - persistence, replay, and transcript inspection should treat `input` as the source of truth for user-visible multimodal chat content
 
 ```ts
@@ -711,7 +711,7 @@ Example workspaces:
 - `examples/02_subagent-planning/` is the Subagent Planning Example: a compact planning flow with one subagent, tools, and trace output
 - `examples/03_protocol-surfaces/` is the Protocol Surfaces Example: the same minimal direct agent wired to ACP, ACP stdio, A2A, AG-UI, and runtime MCP
 - `examples/04_local-model-tool-calling/` is the Local Model Tool Calling Example: one local GGUF-backed task loop plus one local tool
-- `examples/05_runtime-trace-export/` is the Runtime Trace Export Example: one real run plus Mermaid flow export from runtime and upstream events
+- `examples/05_runtime-trace-export/` is the Runtime Trace Export Example: one real request plus Mermaid flow export from runtime and upstream events
 - `examples/06_repository-analysis/` is the Repository Analysis Example: repo analysis around one workspace-local tool plus embedding-backed indexing
 - `examples/07_multi-agent-research/` is the Multi-Agent Research Example: the most complete multi-agent research workspace with reusable backends, skills, and local tools
 - `examples/08_long-term-memory-learning/` is the Long-Term Memory Learning Example: repeated requests that store durable memory, inspect recall, and make later answers more context-aware
@@ -738,7 +738,7 @@ There are three main configuration layers:
 
 ### Backend Guidance
 
-At the moment, the most stable path for complex production-style runs is `backend: deepagent`.
+At the moment, the most stable path for complex production-style requests is `backend: deepagent`.
 
 Current temporary limits on the `backend: langchain-v1` path are:
 
@@ -764,18 +764,18 @@ Use this file for workspace-wide runtime policy.
 
 Important fields:
 
-- `runRoot`
-- `concurrency.maxConcurrentRuns`
+- `runtimeRoot`
+- `concurrency.maxConcurrentRequests`
 - `routing.defaultAgentId`
 - `routing.rules`
 - `toolModuleDiscovery.scope`
 - `maintenance.checkpoints`
 - `maintenance.records`
 - `recovery.enabled`
-- `recovery.resumeResumingRunsOnStartup`
+- `recovery.resumeResumingRequestsOnStartup`
 - `recovery.maxRecoveryAttempts`
 
-`recovery.resumeResumingRunsOnStartup` keeps checkpoint resume a runtime-owned lifecycle behavior instead of exposing checkpoint orchestration as public API.
+`recovery.resumeResumingRequestsOnStartup` keeps checkpoint resume a runtime-owned lifecycle behavior instead of exposing checkpoint orchestration as public API.
 
 `maintenance.checkpoints` and `maintenance.records` are separate retention layers:
 
@@ -797,7 +797,7 @@ kind: Runtime
 metadata:
   name: default
 spec:
-  runRoot: ./.agent
+  runtimeRoot: ./.agent
   toolModuleDiscovery:
     scope: top-level
   concurrency:
@@ -811,7 +811,7 @@ spec:
       enabled: false
   recovery:
     enabled: true
-    resumeResumingRunsOnStartup: true
+    resumeResumingRequestsOnStartup: true
     maxRecoveryAttempts: 3
 ```
 
@@ -875,7 +875,7 @@ Keep bootstrap context in `config/agent-context.md`. Keep resumable execution st
 
 - `formation.hotPath` for immediate write-time capture
 - `formation.manager` for rule-driven or model-driven candidate normalization before persistence
-- `formation.background` for reflection after run completion or approval resolution
+- `formation.background` for reflection after request completion or approval resolution
 
 ### `config/knowledge/knowledge-runtime.yaml`
 
@@ -941,7 +941,7 @@ Agent YAML can live anywhere under `config/`; `config/agents/*.yaml` is the reco
 
 Use two sections:
 
-- `spec.runtime` for harness-owned runtime placement such as `spec.runtime.runRoot`
+- `spec.runtime` for harness-owned runtime placement such as `spec.runtime.runtimeRoot`
 - top-level `spec` fields for upstream execution semantics and adapter-facing config
 
 Example direct host:
@@ -953,7 +953,7 @@ metadata:
   name: direct
 spec:
   runtime:
-    runRoot: ./.agent
+    runtimeRoot: ./.agent
   backend: langchain-v1
   modelRef: model/default
   tools:
@@ -974,7 +974,7 @@ spec:
       maxFileSizeMb: 10
       sessionStorage:
         enabled: true
-        rootDir: "{runRoot}/sessions/{sessionId}/filesystem"
+        rootDir: "{runtimeRoot}/sessions/{sessionId}/filesystem"
     middleware: []
     systemPrompt: Answer simple requests directly.
 ```
@@ -990,7 +990,7 @@ metadata:
   name: orchestra
 spec:
   runtime:
-    runRoot: ./.agent
+    runtimeRoot: ./.agent
   backend: deepagent
   modelRef: model/default
   memory:
@@ -1019,7 +1019,7 @@ For backend-specific options, prefer the upstream concept directly inside `spec.
 - the external protocol boundary should strictly conform to `deepagents-acp` instead of a parallel harness-only protocol
 - upstream execution-backend concepts should be expressed as directly as possible in YAML
 - when a feature can be expressed in YAML, prefer YAML over expanding the public API
-- recovery, approvals, threads, runs, and events are runtime concepts, not backend escape hatches
+- recovery, approvals, sessions, requests, and events are runtime concepts, not backend escape hatches
 - application task centers should be built on the existing store plus runtime ids instead of expanding the public runtime contract
 - new backend-specific config should land in YAML mapping and tests before adding public runtime APIs
 
@@ -1069,7 +1069,7 @@ Primary exports:
 Inspection helpers:
 
 - `createUpstreamTimelineReducer()` reduces raw upstream model/tool/chain events into ordered step-like projections for inspection and visualization.
-- `listRequestTraceItems(runtime, { sessionId, requestId })` returns the persisted request trace items that back runtime diagrams and post-run inspection. Each trace item carries the normalized runtime surface record plus the source upstream event.
+- `listRequestTraceItems(runtime, { sessionId, requestId })` returns the persisted request trace items that back runtime diagrams and post-request inspection. Each trace item carries the normalized runtime surface record plus the source upstream event.
 - `exportFlow(runtime, { sessionId, requestId })` loads one persisted request record from the runtime and renders it as Mermaid flowchart text. It uses the built-in product view defaults for direction, grouping, and visible kinds so callers do not need to carry visualization options in normal product code.
 - `exportSequence(runtime, { sessionId, requestId })` loads the same persisted request record and renders it as a Mermaid sequence diagram for the same persisted trace-backed request.
 
@@ -1090,5 +1090,5 @@ ACP transport notes:
 - `runtime/default.governance.remoteMcp` can now deny or allow specific MCP servers, raise approval requirements by transport, and stamp transport-based risk tiers into runtime governance bundles. MCP server catalogs can also declare trust tier, access mode, tenant scope, approval policy, prompt-injection risk, and OAuth scope metadata so governance bundles capture why one remote tool is treated as high-risk. Tool policy overrides can also set `decisionMode: manual | auto-approve | auto-reject | deny-and-continue` so operator evidence and execution behavior stay aligned.
 - Protocol responsibilities stay split on purpose: ACP is the primary editor/client runtime boundary, A2A is the streaming-capable agent-platform bridge with polling compatibility, AG-UI is the UI event surface, and runtime MCP is the operator-facing control plane exported as MCP tools.
 - `runtime/default.observability.tracing` can now describe exporter metadata such as OTLP endpoints and propagation mode, so frozen runtime snapshots keep trace-correlation plus operator-visible export context without exposing backend-private span internals.
-- `agent-harness runtime overview`, `agent-harness runtime health`, `agent-harness runtime approvals list|watch`, `agent-harness runtime runs list|tail`, and `agent-harness runtime export request|session` provide a thin operator CLI over persisted runtime health, queue pressure, governance risk, approval queues, active run state, and audit-ready evidence packages.
+- `agent-harness runtime overview`, `agent-harness runtime health`, `agent-harness runtime approvals list|watch`, `agent-harness runtime requests list|tail`, and `agent-harness runtime export request|session` provide a thin operator CLI over persisted runtime health, queue pressure, governance risk, approval queues, active request state, and audit-ready evidence packages.
 - detailed A2A adapter guidance lives in [`docs/a2a-bridge.md`](docs/a2a-bridge.md)

package/README.zh.md

@@ -158,7 +158,7 @@ try {
 
 - 把 `requests`、`sessions`、`approvals`、`events` 作为可查询产品记录保存下来的 runtime
 - 能跨中断、重启和人工决策继续推进的恢复路径
-- 稳定的 run 关联与连续性元数据，让一次持久化运行能和日志、trace、fallback 过程对齐
+- 稳定的 request 关联与连续性元数据，让一次持久化请求能和日志、trace、fallback 过程对齐
 - 对敏感 durable memory 写入和写类 MCP 调用默认走审批，而不是把治理责任留给每个工具定义自己记住
 - 一个工作区形态的装配模型，而不是每个应用各写一套运行时胶水
 - 即使底层 execution backend 变化，也尽量保持稳定的 runtime 契约
@@ -287,7 +287,7 @@ AI 让 agent 逻辑、工具调用和工作流代码更容易生成，真正更
 下面三类用法与 runtime 的设计目标最直接对应：
 
 - 企业内部智能体运行时：审批、重启恢复、运维侧证据链，以及由策略约束的 MCP 访问控制。
-- 代码现代化运行时：长链路 coding flow、审批检查点、可恢复 runs，以及可导出的运行证据包。
+- 代码现代化运行时：长链路 coding flow、审批检查点、可恢复 requests，以及可导出的运行证据包。
 - Agent ops 与 remediation workflow runtime：并行 agent 尝试、人工 review gate、持久证据包，以及面向安全或维护任务的 operator visibility。
 - 协议桥接运行时：ACP、A2A、AG-UI 与 runtime MCP 共用一套稳定控制面，而不是为每个对外入口各写一层集成胶水。
 
@@ -421,7 +421,7 @@ import { AgentHarnessRuntime, createAgentHarness } from "@botbotgo/agent-harness
 const runtime: AgentHarnessRuntime = await createAgentHarness("/absolute/path/to/workspace");
 ```
 
-`createAgentHarness(...)` 会加载工作区、解析 `resources/`、在 `runRoot` 下初始化持久化，并启动运行时维护任务。
+`createAgentHarness(...)` 会加载工作区、解析 `resources/`、在 `runtimeRoot` 下初始化持久化，并启动运行时维护任务。
 
 `runtime.spec.resources` 可以挂载多个额外资源包。每个条目既可以指向“包根目录下带有 `resources/` 的目录”，也可以直接指向“自身带有 `package.json` 的资源目录”。
 
@@ -721,8 +721,8 @@ await stop(runtime);
 
 重要字段：
 
-- `runRoot`
-- `concurrency.maxConcurrentRuns`
+- `runtimeRoot`
+- `concurrency.maxConcurrentRequests`
 - `routing.defaultAgentId`
 - `routing.rules`
 - `routing.systemPrompt`
@@ -730,10 +730,10 @@ await stop(runtime);
 - `maintenance.checkpoints`
 - `maintenance.records`
 - `recovery.enabled`
-- `recovery.resumeResumingRunsOnStartup`
+- `recovery.resumeResumingRequestsOnStartup`
 - `recovery.maxRecoveryAttempts`
 
-`recovery.resumeResumingRunsOnStartup` 将 checkpoint 恢复保持为运行时拥有的生命周期行为，而不是把 checkpoint 编排暴露为主 API。
+`recovery.resumeResumingRequestsOnStartup` 将 checkpoint 恢复保持为运行时拥有的生命周期行为，而不是把 checkpoint 编排暴露为主 API。
 
 `maintenance.checkpoints` 与 `maintenance.records` 是两层独立的保留策略：
 
@@ -755,7 +755,7 @@ kind: Runtime
 metadata:
   name: default
 spec:
-  runRoot: ./.agent
+  runtimeRoot: ./.agent
   toolModuleDiscovery:
     scope: top-level
   concurrency:
@@ -770,7 +770,7 @@ spec:
       enabled: false
   recovery:
     enabled: true
-    resumeResumingRunsOnStartup: true
+    resumeResumingRequestsOnStartup: true
     maxRecoveryAttempts: 3
 ```
 
@@ -898,7 +898,7 @@ Agent YAML 可以放在 `config/` 下任意位置；`config/agents/*.yaml` 是
 
 两个区块：
 
-- `spec.runtime`：harness 侧运行时放置，例如 `spec.runtime.runRoot`
+- `spec.runtime`：harness 侧运行时放置，例如 `spec.runtime.runtimeRoot`
 - `spec` 顶层字段：上游执行语义与面向适配器的配置
 
 direct 主机示例：
@@ -910,7 +910,7 @@ metadata:
   name: direct
 spec:
   runtime:
-    runRoot: ./.agent
+    runtimeRoot: ./.agent
   backend: langchain-v1
   modelRef: model/default
   tools:
@@ -931,7 +931,7 @@ spec:
       maxFileSizeMb: 10
       sessionStorage:
         enabled: true
-        rootDir: "{runRoot}/sessions/{sessionId}/filesystem"
+        rootDir: "{runtimeRoot}/sessions/{sessionId}/filesystem"
     middleware: []
     systemPrompt: Answer simple requests directly.
 ```
@@ -947,7 +947,7 @@ metadata:
   name: orchestra
 spec:
   runtime:
-    runRoot: ./.agent
+    runtimeRoot: ./.agent
   backend: deepagent
   modelRef: model/default
   memory:
@@ -1047,5 +1047,5 @@ ACP transport 说明：
 - `runtime/default.governance.remoteMcp` 现在可以按 MCP server 或 transport 做 allow/deny、审批升级，并把 transport 风险等级写进 runtime governance bundles。MCP server catalog 也可以声明 trust tier、access mode、tenant scope、approval policy、prompt-injection risk 与 OAuth scope 元数据，让治理快照能解释为什么某个远端工具被视为高风险。tool policy override 也可以声明 `decisionMode: manual | auto-approve | auto-reject | deny-and-continue`，让治理快照与实际执行路径保持一致。
 - 协议分工要继续保持清晰：ACP 是 editor / client 的主运行时边界，A2A 是支持 streaming 且兼容轮询的 agent-platform bridge，AG-UI 是 UI 事件面，runtime MCP 是以 MCP tools 暴露的 operator control plane。
 - `runtime/default.observability.tracing` 现在可描述 OTLP endpoint 和 propagation mode 这类 exporter 元数据，使冻结的 runtime snapshot 在保留 trace correlation 的同时，也能保留有用的导出上下文，而不暴露 backend 私有 span 细节。
-- `agent-harness runtime overview`、`agent-harness runtime health`、`agent-harness runtime approvals list|watch`、`agent-harness runtime runs list|tail` 与 `agent-harness runtime export request|session` 提供了一层轻量 CLI，可直接查看 runtime health、queue pressure、governance risk、审批队列、运行状态与可审计证据包。
+- `agent-harness runtime overview`、`agent-harness runtime health`、`agent-harness runtime approvals list|watch`、`agent-harness runtime requests list|tail` 与 `agent-harness runtime export request|session` 提供了一层轻量 CLI，可直接查看 runtime health、queue pressure、governance risk、审批队列、运行状态与可审计证据包。
 - 更详细的 A2A 适配层开发说明见 [`docs/a2a-bridge.md`](docs/a2a-bridge.md)

package/dist/acp.d.ts

@@ -1,6 +1,6 @@
-import type { ArtifactRecord, HarnessEvent, RequestRecord, RunOptions, SessionRecord } from "./contracts/types.js";
+import type { ArtifactRecord, HarnessEvent, RequestRecord, RequestOptions, SessionRecord } from "./contracts/types.js";
 import type { AgentHarnessRuntime } from "./runtime/harness.js";
-import { getApproval, type PublicRunListeners } from "./api.js";
+import { getApproval, type PublicRequestListeners } from "./api.js";
 type JsonRpcId = string | number | null;
 export type AcpJsonRpcRequest = {
     jsonrpc?: "2.0";
@@ -29,11 +29,11 @@ export type AcpApproval = Awaited<ReturnType<typeof getApproval>> extends infer
 export type AcpArtifact = ArtifactRecord & {
     content?: unknown;
 };
-export type AcpRunRequestParams = Omit<Extract<RunOptions, {
+export type AcpRequestParams = Omit<Extract<RequestOptions, {
     input: unknown;
-}>, "threadId" | "listeners"> & {
+}>, "listeners"> & {
     sessionId?: string;
-    listeners?: PublicRunListeners;
+    listeners?: PublicRequestListeners;
 };
 export type AcpServerCapabilities = {
     sessions: {

package/dist/acp.js

@@ -1,4 +1,4 @@
-import { getApproval, getArtifact, getRequest, getSession, listApprovals, listArtifacts, listRequests, listSessions, request, resolveApproval, } from "./api.js";
+import { getApproval, getArtifact, getRequest, getSession, listApprovals, listRequestArtifacts, listRequests, listSessions, request, resolveApproval, } from "./api.js";
 const CAPABILITIES = {
     sessions: { list: true, get: true },
     requests: { submit: true, list: true, get: true },
@@ -45,7 +45,7 @@ async function readArtifactContent(runtime, params) {
     const sessionId = readRequiredString(params.sessionId, "sessionId", method);
     const requestId = readRequiredString(params.requestId, "requestId", method);
     const artifactPath = readRequiredString(params.artifactPath, "artifactPath", method);
-    const listing = await listArtifacts(runtime, { sessionId, requestId });
+    const listing = await listRequestArtifacts(runtime, { sessionId, requestId });
     const artifact = listing.items.find((item) => item.path === artifactPath);
     if (!artifact) {
         throw new Error(`Artifact not found for ${requestId}: ${artifactPath}`);
@@ -191,7 +191,7 @@ export class AgentHarnessAcpServer {
             }
             case "artifacts.list": {
                 const payload = asObject(params, method);
-                return listArtifacts(this.runtime, {
+                return listRequestArtifacts(this.runtime, {
                     sessionId: readRequiredString(payload.sessionId, "sessionId", method),
                     requestId: readRequiredString(payload.requestId, "requestId", method),
                 });

package/dist/api.d.ts

@@ -1,11 +1,11 @@
-import type { ArtifactListing, CancelOptions, InvocationEnvelope, ListMemoriesInput, ListMemoriesResult, MemoryRecord, MemorizeInput, MemorizeResult, MessageContent, RecallInput, RecallResult, RemoveMemoryInput, RequestRecord, RequestSummary, RuntimeArtifactWriteInput, ResumeOptions, RunDecisionOptions, RunListeners, RunResult, RunStartOptions, RuntimeHealthSnapshot, RuntimeGovernanceEvidence, RuntimeGovernanceDiagnostics, RuntimeOperatorOverview, RuntimeQueueDiagnostics, RuntimeAdapterOptions, RuntimeEvaluationExport, RuntimeEvaluationExportInput, RuntimeEvaluationArtifact, RuntimeEvaluationReplayInput, RuntimeEvaluationReplayResult as InternalRuntimeEvaluationReplayResult, RuntimeSessionPackage, RuntimeSessionPackageInput, SessionListSummary, SessionRecord, SessionSummary, TranscriptMessage, UpdateMemoryInput, WorkspaceLoadOptions } from "./contracts/types.js";
+import type { ArtifactListing, CancelOptions, InvocationEnvelope, ListMemoriesInput, ListMemoriesResult, MemoryRecord, MemorizeInput, MemorizeResult, MessageContent, RecallInput, RecallResult, RemoveMemoryInput, RequestDecisionOptions, RequestRecord, RequestResult as InternalRequestResult, RequestStartOptions, RequestSummary, RuntimeArtifactWriteInput, ResumeOptions, RequestListeners, RuntimeHealthSnapshot, RuntimeGovernanceEvidence, RuntimeGovernanceDiagnostics, RuntimeOperatorOverview, RuntimeQueueDiagnostics, RuntimeAdapterOptions, RuntimeEvaluationExport, RuntimeEvaluationExportInput, RuntimeEvaluationArtifact, RuntimeEvaluationReplayInput, RuntimeEvaluationReplayResult as InternalRuntimeEvaluationReplayResult, RuntimeSessionPackage, RuntimeSessionPackageInput, SessionListSummary, SessionRecord, SessionSummary, TranscriptMessage, UpdateMemoryInput, WorkspaceLoadOptions } from "./contracts/types.js";
 import { AgentHarnessRuntime } from "./runtime/harness.js";
 import type { InventoryAgentRecord, InventorySkillRecord } from "./runtime/harness/system/inventory.js";
 import type { RequirementAssessmentOptions } from "./runtime/harness/system/skill-requirements.js";
 import type { RuntimeMcpServerOptions, ToolMcpServerOptions } from "./mcp.js";
 export { AgentHarnessAcpServer, createAcpServer } from "./acp.js";
 export { createAcpStdioClient } from "./protocol/acp/client.js";
-export type { AcpApproval, AcpArtifact, AcpEventNotification, AcpJsonRpcError, AcpJsonRpcRequest, AcpJsonRpcResponse, AcpJsonRpcSuccess, AcpRequestRecord, AcpRunRequestParams, AcpServerCapabilities, AcpSessionRecord, } from "./acp.js";
+export type { AcpApproval, AcpArtifact, AcpEventNotification, AcpJsonRpcError, AcpJsonRpcRequest, AcpJsonRpcResponse, AcpJsonRpcSuccess, AcpRequestRecord, AcpRequestParams, AcpServerCapabilities, AcpSessionRecord, } from "./acp.js";
 export { AgentHarnessRuntime } from "./runtime/harness.js";
 export { createUpstreamTimelineReducer } from "./upstream-events.js";
 export type { ListMemoriesInput, ListMemoriesResult, MemoryDecision, MemoryKind, MemoryRecord, MemoryScope, MemorizeInput, MemorizeResult, RecallInput, RecallResult, RemoveMemoryInput, RuntimeEvaluationExport, RuntimeEvaluationExportInput, RuntimeEvaluationReplayInput, SessionListSummary, RuntimeSessionPackageInput, RuntimeSessionPackage, UpdateMemoryInput, } from "./contracts/types.js";
@@ -13,10 +13,10 @@ export type { AcpHttpServer, AcpHttpServerOptions } from "./protocol/acp/http.js
 export type { AcpStdioClient, AcpStdioClientOptions } from "./protocol/acp/client.js";
 export type { A2aAgentCard, A2aHttpServer, A2aHttpServerOptions, A2aTask, A2aTaskState } from "./protocol/a2a/http.js";
 export type { AcpStdioServer, AcpStdioServerOptions } from "./protocol/acp/stdio.js";
-export type { AgUiEvent, AgUiHttpServer, AgUiHttpServerOptions, AgUiRunAgentInput } from "./protocol/ag-ui/http.js";
-export type RequestEventType = "request.created" | "request.queued" | "request.dequeued" | "request.state.changed" | "request.resumed" | Exclude<NonNullable<RunListeners["onEvent"]> extends (event: infer T) => unknown ? T extends {
+export type { AgUiEvent, AgUiHttpServer, AgUiHttpServerOptions, AgUiRequestAgentInput } from "./protocol/ag-ui/http.js";
+export type RequestEventType = "request.created" | "request.queued" | "request.dequeued" | "request.state.changed" | "request.resumed" | Exclude<NonNullable<RequestListeners["onEvent"]> extends (event: infer T) => unknown ? T extends {
     eventType: infer E;
-} ? E : never : never, "run.created" | "run.queued" | "run.dequeued" | "run.state.changed" | "run.resumed"> | (string & {});
+} ? E : never : never, never> | (string & {});
 export type RequestEvent = {
     eventId: string;
     eventType: RequestEventType;
@@ -37,9 +37,9 @@ export type RequestFlowGraphInput = {
     sessionId: string;
     requestId: string;
 };
-export type PublicRunListeners = {
+export type PublicRequestListeners = {
     onEvent?: (event: RequestEvent) => void | Promise<void>;
-    onUpstreamEvent?: RunListeners["onUpstreamEvent"];
+    onUpstreamEvent?: RequestListeners["onUpstreamEvent"];
     onTraceItem?: (item: RequestTraceItem) => void | Promise<void>;
 };
 export type Approval = {
@@ -78,14 +78,14 @@ export type RequestPackage = {
 };
 export type RecordArtifactInput = RuntimeArtifactWriteInput;
 export type RuntimeEvaluationReplayResult = Omit<InternalRuntimeEvaluationReplayResult, "result"> & {
-    result: PublicRunResult;
+    result: PublicRequestResult;
 };
-export type OperatorOverview = Omit<RuntimeOperatorOverview, "approvals" | "runs"> & {
+export type OperatorOverview = Omit<RuntimeOperatorOverview, "approvals" | "requests"> & {
     approvals: {
         total: number;
         items: Approval[];
     };
-    runs: {
+    requests: {
         total: number;
         states: Partial<Record<RequestSummary["state"], number>>;
         items: RequestSummary[];
@@ -98,21 +98,20 @@ type PublicApprovalFilter = {
     sessionId?: string;
     requestId?: string;
 };
-type PublicRequestStartOptions = Omit<RunStartOptions, "sessionId" | "listeners"> & {
+type PublicRequestStartOptions = Omit<RequestStartOptions, "sessionId" | "listeners"> & {
     sessionId?: string;
-    listeners?: PublicRunListeners;
+    listeners?: PublicRequestListeners;
 };
-type PublicRequestDecisionOptions = Omit<RunDecisionOptions, "sessionId" | "requestId" | "listeners"> & {
+type PublicRequestDecisionOptions = Omit<RequestDecisionOptions, "sessionId" | "requestId" | "listeners"> & {
     sessionId: string;
     requestId?: string;
-    listeners?: PublicRunListeners;
+    listeners?: PublicRequestListeners;
 };
-type PublicRequestOptions = PublicRequestStartOptions | PublicRequestDecisionOptions;
-type PublicRequestResult = Omit<RunResult, "sessionId" | "requestId"> & {
+export type PublicRequestOptions = PublicRequestStartOptions | PublicRequestDecisionOptions;
+export type PublicRequestResult = Omit<InternalRequestResult, "sessionId" | "requestId"> & {
     sessionId: string;
     requestId: string;
 };
-type PublicRunResult = PublicRequestResult;
 export type RequestResult = PublicRequestResult;
 export type UserChatMessage = {
     role: "user";
@@ -132,7 +131,7 @@ type CreateAgentHarnessOptions = {
 };
 export declare function createAgentHarness(): Promise<AgentHarnessRuntime>;
 export declare function createAgentHarness(workspaceRoot: string, options?: CreateAgentHarnessOptions): Promise<AgentHarnessRuntime>;
-export declare function normalizeUserChatInput(input: UserChatInput, options?: NormalizeUserChatInputOptions): Pick<RunStartOptions, "input" | "invocation">;
+export declare function normalizeUserChatInput(input: UserChatInput, options?: NormalizeUserChatInputOptions): Pick<RequestStartOptions, "input" | "invocation">;
 export declare function request(runtime: AgentHarnessRuntime, options: PublicRequestOptions): Promise<PublicRequestResult>;
 export declare function memorize(runtime: AgentHarnessRuntime, input: MemorizeInput): Promise<MemorizeResult>;
 export declare function recall(runtime: AgentHarnessRuntime, input: RecallInput): Promise<RecallResult>;
@@ -154,7 +153,7 @@ export declare function exportSequence(runtime: AgentHarnessRuntime, input: Requ
 export declare function deleteSession(runtime: AgentHarnessRuntime, sessionId: string): Promise<boolean>;
 export declare function listApprovals(runtime: AgentHarnessRuntime, filter?: PublicApprovalFilter): Promise<Approval[]>;
 export declare function getApproval(runtime: AgentHarnessRuntime, approvalId: string): Promise<Approval | null>;
-export declare function listArtifacts(runtime: AgentHarnessRuntime, input: {
+export declare function listRequestArtifacts(runtime: AgentHarnessRuntime, input: {
     sessionId: string;
     requestId: string;
 }): Promise<RequestArtifactListing>;
@@ -190,8 +189,8 @@ export declare function describeInventory(runtime: AgentHarnessRuntime, options?
     workspaceRoot: string;
     agents: InventoryAgentRecord[];
 };
-export declare function resolveApproval(runtime: AgentHarnessRuntime, options: ResumeOptions): Promise<PublicRunResult>;
-export declare function cancelRun(runtime: AgentHarnessRuntime, options: CancelOptions): Promise<PublicRunResult>;
+export declare function resolveApproval(runtime: AgentHarnessRuntime, options: ResumeOptions): Promise<PublicRequestResult>;
+export declare function cancelRequest(runtime: AgentHarnessRuntime, options: CancelOptions): Promise<PublicRequestResult>;
 export declare function stop(runtime: AgentHarnessRuntime): Promise<void>;
 export declare function createToolMcpServer(runtime: AgentHarnessRuntime, options: ToolMcpServerOptions): Promise<import("@modelcontextprotocol/sdk/server/mcp").McpServer>;
 export declare function serveToolsOverStdio(runtime: AgentHarnessRuntime, options: ToolMcpServerOptions): Promise<import("@modelcontextprotocol/sdk/server/mcp").McpServer>;

package/dist/api.js

@@ -27,20 +27,7 @@ function toApprovalRecord(record) {
     };
 }
 function toPublicEventType(eventType) {
-    switch (eventType) {
-        case "run.created":
-            return "request.created";
-        case "run.queued":
-            return "request.queued";
-        case "run.dequeued":
-            return "request.dequeued";
-        case "run.state.changed":
-            return "request.state.changed";
-        case "run.resumed":
-            return "request.resumed";
-        default:
-            return eventType;
-    }
+    return eventType;
 }
 function toPublicEvent(event) {
     return {
@@ -68,7 +55,7 @@ function toPublicTraceItem(input) {
         event: typed.event,
     };
 }
-function toPublicRunListeners(listeners) {
+function toPublicRequestListeners(listeners) {
     if (!listeners) {
         return undefined;
     }
@@ -104,7 +91,7 @@ function toRequestPackage(pkg) {
         ...(pkg.runtimeHealth ? { runtimeHealth: pkg.runtimeHealth } : {}),
     };
 }
-function toPublicRunResult(result) {
+function toPublicRequestResult(result) {
     return {
         sessionId: result.sessionId,
         requestId: result.requestId,
@@ -123,13 +110,13 @@ function toPublicRunResult(result) {
         metadata: result.metadata,
     };
 }
-function toInternalRunOptions(options) {
+function toInternalRequestOptions(options) {
     if ("decision" in options) {
         return {
             approvalId: options.approvalId,
             decision: options.decision,
             editedInput: options.editedInput,
-            listeners: toPublicRunListeners(options.listeners),
+            listeners: toPublicRequestListeners(options.listeners),
             requestId: options.requestId,
             sessionId: options.sessionId,
         };
@@ -138,7 +125,7 @@ function toInternalRunOptions(options) {
         agentId: options.agentId,
         input: options.input,
         invocation: options.invocation,
-        listeners: toPublicRunListeners(options.listeners),
+        listeners: toPublicRequestListeners(options.listeners),
         priority: options.priority,
         sessionId: options.sessionId,
     };
@@ -152,25 +139,25 @@ function toInternalResumeOptions(options) {
         sessionId: options.sessionId,
     };
 }
-function toPublicRequestSummary(run) {
+function toPublicRequestSummary(summary) {
     return {
-        requestId: run.requestId,
-        sessionId: run.sessionId,
-        agentId: run.agentId,
-        parentRunId: run.parentRunId,
-        executionMode: run.executionMode,
-        adapterKind: run.adapterKind,
-        createdAt: run.createdAt,
-        updatedAt: run.updatedAt,
-        state: run.state,
-        checkpointRef: run.checkpointRef,
-        resumable: run.resumable,
-        startedAt: run.startedAt,
-        endedAt: run.endedAt,
-        lastActivityAt: run.lastActivityAt,
-        currentAgentId: run.currentAgentId,
-        delegationChain: run.delegationChain,
-        runtimeSnapshot: run.runtimeSnapshot,
+        requestId: summary.requestId,
+        sessionId: summary.sessionId,
+        agentId: summary.agentId,
+        parentRequestId: summary.parentRequestId,
+        executionMode: summary.executionMode,
+        adapterKind: summary.adapterKind,
+        createdAt: summary.createdAt,
+        updatedAt: summary.updatedAt,
+        state: summary.state,
+        checkpointRef: summary.checkpointRef,
+        resumable: summary.resumable,
+        startedAt: summary.startedAt,
+        endedAt: summary.endedAt,
+        lastActivityAt: summary.lastActivityAt,
+        currentAgentId: summary.currentAgentId,
+        delegationChain: summary.delegationChain,
+        runtimeSnapshot: summary.runtimeSnapshot,
     };
 }
 export async function createAgentHarness(workspaceRoot = process.cwd(), options = {}) {
@@ -192,7 +179,7 @@ export function normalizeUserChatInput(input, options = {}) {
     return options.invocation ? { input: content, invocation: options.invocation } : { input: content };
 }
 export async function request(runtime, options) {
-    return toPublicRunResult(await runtime.run(toInternalRunOptions(options)));
+    return toPublicRequestResult(await runtime.run(toInternalRequestOptions(options)));
 }
 export async function memorize(runtime, input) {
     return runtime.memorize(input);
@@ -279,11 +266,11 @@ export async function getApproval(runtime, approvalId) {
     const record = await runtime.getApproval(approvalId);
     return record ? toApprovalRecord(record) : null;
 }
-export async function listArtifacts(runtime, input) {
-    return toRequestArtifactListing(await runtime.listArtifacts(input.sessionId, input.requestId));
+export async function listRequestArtifacts(runtime, input) {
+    return toRequestArtifactListing(await runtime.listRequestArtifacts(input.sessionId, input.requestId));
 }
 export async function getArtifact(runtime, input) {
-    return runtime.readArtifact(input.sessionId, input.requestId, input.artifactPath);
+    return runtime.readRequestArtifact(input.sessionId, input.requestId, input.artifactPath);
 }
 export async function recordArtifact(runtime, input) {
     return runtime.recordArtifact(input);
@@ -312,17 +299,18 @@ export async function getHealth(runtime) {
 }
 export async function getOperatorOverview(runtime, options) {
     const overview = await runtime.getOperatorOverview(options);
+    const requestOverview = {
+        total: overview.requests.total,
+        states: overview.requests.states,
+        items: overview.requests.items.map(toPublicRequestSummary),
+    };
     return {
         ...overview,
         approvals: {
             total: overview.approvals.total,
             items: overview.approvals.items.map(toApprovalRecord),
         },
-        runs: {
-            total: overview.runs.total,
-            states: overview.runs.states,
-            items: overview.runs.items.map(toPublicRequestSummary),
-        },
+        requests: requestOverview,
     };
 }
 export async function exportRequestPackage(runtime, input) {
@@ -338,7 +326,7 @@ export async function replayEvaluationBundle(runtime, input) {
     const replayed = await runtime.replayEvaluationBundle(input);
     return {
         ...replayed,
-        result: toPublicRunResult(replayed.result),
+        result: toPublicRequestResult(replayed.result),
     };
 }
 export function serveAcpStdio(runtime, options) {
@@ -363,10 +351,10 @@ export function describeInventory(runtime, options) {
     return runtime.describeWorkspaceInventory(options);
 }
 export async function resolveApproval(runtime, options) {
-    return toPublicRunResult(await runtime.resume(toInternalResumeOptions(options)));
+    return toPublicRequestResult(await runtime.resume(toInternalResumeOptions(options)));
 }
-export async function cancelRun(runtime, options) {
-    return toPublicRunResult(await runtime.cancelRun(options));
+export async function cancelRequest(runtime, options) {
+    return toPublicRequestResult(await runtime.cancelRequest(options));
 }
 export async function stop(runtime) {
     return runtime.stop();