@botbotgo/agent-harness 0.0.290 → 0.0.291

package/dist/cli.js

@@ -18,8 +18,8 @@ function renderUsage() {
   agent-harness runtime health [--workspace <path>] [--json]
   agent-harness runtime approvals list [--workspace <path>] [--status <pending|approved|edited|rejected|expired>] [--json]
   agent-harness runtime approvals watch [--workspace <path>] [--status <pending|approved|edited|rejected|expired>] [--poll-ms <ms>] [--once] [--json]
-  agent-harness runtime runs list [--workspace <path>] [--agent <agentId>] [--thread <threadId>] [--state <state>] [--json]
-  agent-harness runtime runs tail [--workspace <path>] [--agent <agentId>] [--thread <threadId>] [--state <state>] [--poll-ms <ms>] [--once] [--json]
+  agent-harness runtime requests list [--workspace <path>] [--agent <agentId>] [--session <sessionId>] [--state <state>] [--json]
+  agent-harness runtime requests tail [--workspace <path>] [--agent <agentId>] [--session <sessionId>] [--state <state>] [--poll-ms <ms>] [--once] [--json]
   agent-harness runtime export request --workspace <path> --session <sessionId> --request <requestId> [--artifacts] [--artifact-contents] [--health] [--json]
   agent-harness runtime export session --workspace <path> --session <sessionId> [--artifacts] [--artifact-contents] [--health] [--json]
   agent-harness runtime-mcp serve [--workspace <path>]
@@ -168,13 +168,13 @@ function parseRuntimeInspectOptions(args) {
     let status;
     let state;
     let agentId;
-    let threadId;
+    let sessionId;
     for (let index = 0; index < args.length; index += 1) {
         const arg = args[index];
-        if (arg === "--workspace" || arg === "--status" || arg === "--state" || arg === "--agent" || arg === "--thread" || arg === "--poll-ms" || arg === "--limit") {
+        if (arg === "--workspace" || arg === "--status" || arg === "--state" || arg === "--agent" || arg === "--session" || arg === "--poll-ms" || arg === "--limit") {
             const value = args[index + 1];
             if (!value) {
-                return { json, once, pollMs, limit, status, state, agentId, threadId, error: `Missing value for ${arg}` };
+                return { json, once, pollMs, limit, status, state, agentId, sessionId, error: `Missing value for ${arg}` };
             }
             if (arg === "--workspace") {
                 workspaceRoot = value;
@@ -188,20 +188,20 @@ function parseRuntimeInspectOptions(args) {
             else if (arg === "--agent") {
                 agentId = value;
             }
-            else if (arg === "--thread") {
-                threadId = value;
+            else if (arg === "--session") {
+                sessionId = value;
             }
             else if (arg === "--limit") {
                 const parsedLimit = Number.parseInt(value, 10);
                 if (!Number.isFinite(parsedLimit) || parsedLimit <= 0) {
-                    return { json, once, pollMs, limit, status, state, agentId, threadId, error: `Invalid limit: ${value}` };
+                    return { json, once, pollMs, limit, status, state, agentId, sessionId, error: `Invalid limit: ${value}` };
                 }
                 limit = parsedLimit;
             }
             else {
                 const parsedPoll = Number.parseInt(value, 10);
                 if (!Number.isFinite(parsedPoll) || parsedPoll <= 0) {
-                    return { json, once, pollMs, limit, status, state, agentId, threadId, error: `Invalid poll interval: ${value}` };
+                    return { json, once, pollMs, limit, status, state, agentId, sessionId, error: `Invalid poll interval: ${value}` };
                 }
                 pollMs = parsedPoll;
             }
@@ -216,9 +216,9 @@ function parseRuntimeInspectOptions(args) {
             once = true;
             continue;
         }
-        return { workspaceRoot, json, once, pollMs, limit, status, state, agentId, threadId, error: `Unknown option: ${arg}` };
+        return { workspaceRoot, json, once, pollMs, limit, status, state, agentId, sessionId, error: `Unknown option: ${arg}` };
     }
-    return { workspaceRoot, json, once, pollMs, limit, status, state, agentId, threadId };
+    return { workspaceRoot, json, once, pollMs, limit, status, state, agentId, sessionId };
 }
 function parseRuntimeExportOptions(args) {
     let workspaceRoot;
@@ -321,10 +321,10 @@ function renderHealthSnapshot(snapshot, workspacePath) {
     }
     const stats = isObject(snapshot.stats) ? snapshot.stats : {};
     const statEntries = [
-        ["activeRunSlots", stats.activeRunSlots],
-        ["pendingRunSlots", stats.pendingRunSlots],
+        ["activeRequestSlots", stats.activeRequestSlots],
+        ["pendingRequestSlots", stats.pendingRequestSlots],
         ["pendingApprovals", stats.pendingApprovals],
-        ["stuckRuns", stats.stuckRuns],
+        ["stuckRequests", stats.stuckRequests],
         ["llmSuccessRate1m", stats.llmSuccessRate1m],
         ["llmP95LatencyMs1m", stats.llmP95LatencyMs1m],
     ]
@@ -359,32 +359,32 @@ function renderApprovalList(approvals) {
         const status = typeof approval.status === "string" ? approval.status : "unknown";
         const toolName = typeof approval.toolName === "string" ? approval.toolName : "unknown_tool";
         const approvalId = typeof approval.approvalId === "string" ? approval.approvalId : "unknown";
-        const threadId = typeof approval.threadId === "string" ? ` thread=${approval.threadId}` : "";
-        const runId = typeof approval.runId === "string" ? ` run=${approval.runId}` : "";
+        const sessionId = typeof approval.sessionId === "string" ? ` session=${approval.sessionId}` : "";
+        const requestId = typeof approval.requestId === "string" ? ` request=${approval.requestId}` : "";
         const reason = typeof approval.approvalReason === "string" ? ` reason=${approval.approvalReason}` : "";
         const requestedAt = formatTimestamp(approval.requestedAt);
         const resolvedAt = formatTimestamp(approval.resolvedAt);
         const requested = requestedAt ? ` requested=${requestedAt}` : "";
         const resolved = resolvedAt ? ` resolved=${resolvedAt}` : "";
-        return `${approvalId} status=${status} tool=${toolName}${threadId}${runId}${reason}${requested}${resolved}`;
+        return `${approvalId} status=${status} tool=${toolName}${sessionId}${requestId}${reason}${requested}${resolved}`;
     }).join("\n") + "\n";
 }
-function renderRunList(runs) {
-    if (runs.length === 0) {
-        return "No runs matched.\n";
+function renderRequestList(requests) {
+    if (requests.length === 0) {
+        return "No requests matched.\n";
     }
-    return runs.map((run) => {
-        const runId = typeof run.runId === "string" ? run.runId : "unknown";
-        const threadId = typeof run.threadId === "string" ? run.threadId : "unknown";
-        const agentId = typeof run.agentId === "string" ? run.agentId : "unknown";
-        const state = typeof run.state === "string" ? run.state : "unknown";
-        const currentAgent = typeof run.currentAgentId === "string" ? ` current=${run.currentAgentId}` : "";
-        const resumable = typeof run.resumable === "boolean" ? ` resumable=${run.resumable}` : "";
-        const updatedAt = formatTimestamp(run.updatedAt);
-        const lastActivityAt = formatTimestamp(run.lastActivityAt);
+    return requests.map((request) => {
+        const requestId = typeof request.requestId === "string" ? request.requestId : "unknown";
+        const sessionId = typeof request.sessionId === "string" ? request.sessionId : "unknown";
+        const agentId = typeof request.agentId === "string" ? request.agentId : "unknown";
+        const state = typeof request.state === "string" ? request.state : "unknown";
+        const currentAgent = typeof request.currentAgentId === "string" ? ` current=${request.currentAgentId}` : "";
+        const resumable = typeof request.resumable === "boolean" ? ` resumable=${request.resumable}` : "";
+        const updatedAt = formatTimestamp(request.updatedAt);
+        const lastActivityAt = formatTimestamp(request.lastActivityAt);
         const updated = updatedAt ? ` updated=${updatedAt}` : "";
         const lastActivity = lastActivityAt ? ` activity=${lastActivityAt}` : "";
-        return `${runId} thread=${threadId} agent=${agentId}${currentAgent} state=${state}${resumable}${updated}${lastActivity}`;
+        return `${requestId} session=${sessionId} agent=${agentId}${currentAgent} state=${state}${resumable}${updated}${lastActivity}`;
     }).join("\n") + "\n";
 }
 function renderOperatorOverview(overview, workspacePath) {
@@ -415,11 +415,11 @@ function renderOperatorOverview(overview, workspacePath) {
     if (approvalItems.length > 0) {
         lines.push(renderApprovalList(approvalItems).trimEnd());
     }
-    const runs = isObject(overview.runs) ? overview.runs : {};
-    const runItems = Array.isArray(runs.items) ? runs.items.filter(isObject) : [];
-    lines.push(`Active runs: ${typeof runs.total === "number" ? runs.total : runItems.length}`);
-    if (runItems.length > 0) {
-        lines.push(renderRunList(runItems).trimEnd());
+    const requests = isObject(overview.requests) ? overview.requests : {};
+    const requestItems = Array.isArray(requests.items) ? requests.items.filter(isObject) : [];
+    lines.push(`Active requests: ${typeof requests.total === "number" ? requests.total : requestItems.length}`);
+    if (requestItems.length > 0) {
+        lines.push(renderRequestList(requestItems).trimEnd());
     }
     return `${lines.join("\n")}\n`;
 }
@@ -654,7 +654,7 @@ export async function runCli(argv, io = {}, deps = {}) {
                 return 1;
             }
         }
-        const nestedCommand = (subcommand === "approvals" || subcommand === "runs") && possibleNestedCommand
+        const nestedCommand = (subcommand === "approvals" || subcommand === "requests") && possibleNestedCommand
             ? possibleNestedCommand
             : undefined;
         const subcommandArgs = nestedCommand
@@ -696,20 +696,24 @@ export async function runCli(argv, io = {}, deps = {}) {
                 await runtime.stop();
                 return 0;
             }
-            if (subcommand === "runs" && (nestedCommand === "list" || nestedCommand === "tail")) {
-                const renderRuns = async () => {
-                    const runs = await runtime.listRuns({
+            if (subcommand === "requests" && (nestedCommand === "list" || nestedCommand === "tail")) {
+                const renderRequests = async () => {
+                    const listRequests = runtime.listRequests?.bind(runtime);
+                    if (!listRequests) {
+                        throw new Error("Runtime does not support request listing");
+                    }
+                    const requests = await listRequests({
                         ...(parsed.agentId ? { agentId: parsed.agentId } : {}),
-                        ...(parsed.threadId ? { threadId: parsed.threadId } : {}),
+                        ...(parsed.sessionId ? { sessionId: parsed.sessionId } : {}),
                         ...(parsed.state ? { state: parsed.state } : {}),
                     });
-                    stdout(parsed.json ? renderJson(runs) : renderRunList(runs));
+                    stdout(parsed.json ? renderJson(requests) : renderRequestList(requests));
                 };
-                await renderRuns();
+                await renderRequests();
                 if (nestedCommand === "tail" && !parsed.once) {
                     for (;;) {
                         await sleep(parsed.pollMs);
-                        await renderRuns();
+                        await renderRequests();
                     }
                 }
                 await runtime.stop();

package/dist/config/agents/orchestra.yaml

@@ -25,8 +25,8 @@ spec:
     # Treat this as agent-owned startup context, not as a dynamic long-term memory sink:
     # - keep `systemPrompt` for stable role, boundaries, and hard behavioral rules
     # - use `memory:` for stable project knowledge, operating conventions, and shared or agent-specific context files
-    # - use `/memories/*` via the backend/store below for durable knowledge learned from prior runs
-    # - use the harness checkpointer for resumable graph state for an in-flight run
+    # - use `/memories/*` via the backend/store below for durable knowledge learned from prior requests
+    # - use the harness checkpointer for resumable graph state for an in-flight request
     # Updating these files changes future agent constructions, but they are still bootstrap inputs rather than
     # self-updating runtime memory.
     - path: config/agent-context.md
@@ -102,7 +102,7 @@ spec:
     When the user asks about available tools, skills, or agents, use the attached inventory tools instead of
     inferring from memory.
 
-    Write to `/memories/*` only when the information is durable, reusable across future runs or threads, and likely
+    Write to `/memories/*` only when the information is durable, reusable across future requests or sessions, and likely
     to matter again: user preferences, project conventions, confirmed decisions, reusable summaries, and stable
     ownership facts are good candidates.
     Do not store transient reasoning, temporary plans, scratch work, one-off search results, or intermediate

package/dist/config/knowledge/knowledge-runtime.yaml

@@ -46,15 +46,15 @@ spec:
     background:
       enabled: true
       scopes:
-        - thread
+        - session
       stateStorePath: knowledge/formation-state.json
-      maxMessagesPerRun: 40
+      maxMessagesPerRequest: 40
       writeOnApprovalResolution: true
-      writeOnRunCompletion: true
+      writeOnRequestCompletion: true
   mem0:
     ## agent-harness feature: optional Mem0 OSS ingestion defaults for standalone knowledge extraction.
     enabled: false
     apiKeyEnv: MEM0_API_KEY
     appId: agent-harness
     stateStorePath: knowledge/mem0-sync-state.json
-    maxMessagesPerRun: 200
+    maxMessagesPerRequest: 200

package/dist/config/runtime/runtime-memory.yaml

@@ -64,7 +64,7 @@ spec:
   ingestion:
     backgroundConsolidation: true
     writeOnApprovalResolution: true
-    writeOnRunCompletion: true
+    writeOnRequestCompletion: true
 
   # agent-harness feature: LangMem-style memory formation defaults for hot-path and background reflection.
   formation:
@@ -77,14 +77,14 @@ spec:
     background:
       enabled: true
       scopes:
-        - thread
+        - session
       stateStorePath: knowledge/formation-state.json
-      maxMessagesPerRun: 40
+      maxMessagesPerRequest: 40
       writeOnApprovalResolution: true
-      writeOnRunCompletion: true
+      writeOnRequestCompletion: true
 
-  # agent-harness feature: optional thread snapshot projection for operational state and pending approvals.
-  threadMemorySync:
+  # agent-harness feature: optional session snapshot projection for operational state and pending approvals.
+  sessionMemorySync:
     enabled: true
 
   # agent-harness feature: optional Mem0 OSS ingestion engine for automatic long-term knowledge extraction.
@@ -93,4 +93,4 @@ spec:
     apiKeyEnv: MEM0_API_KEY
     appId: agent-harness
     stateStorePath: knowledge/mem0-sync-state.json
-    maxMessagesPerRun: 200
+    maxMessagesPerRequest: 200

package/dist/config/runtime/workspace.yaml

@@ -29,8 +29,8 @@ spec:
   # agent-harness feature: stable runtime profile identifier for this data folder.
   profile: default
 
-  # agent-harness feature: runtime-level task queue and maximum number of concurrent runs.
-  # Additional runs wait in the harness queue until a slot becomes available.
+  # agent-harness feature: runtime-level task queue and maximum number of concurrent requests.
+  # Additional requests wait in the harness queue until a slot becomes available.
   concurrency:
     maxConcurrentRuns: 3
 
@@ -60,7 +60,7 @@ spec:
     # - `regex`: regular-expression match (string or list)
     # - `minLength` / `maxLength`: request text length bounds
     # - `minLines` / `maxLines`: request line-count bounds
-    # - `hasThreadId`: require a new turn (`false`) or existing thread follow-up (`true`)
+    # - `hasSessionId`: require a new turn (`false`) or existing session follow-up (`true`)
     # - `caseSensitive`: default `false`
     #
     # Example:
@@ -98,7 +98,7 @@ spec:
   # coupling cleanup to user-triggered checkpoint reads or writes.
   #
   # Current support:
-  # - terminal runtime-record cleanup for structured thread/run metadata in `runtime.sqlite`
+  # - terminal runtime-record cleanup for structured session/request metadata in `runtime.sqlite`
   # - oldest-first deletion by time policy and/or size policy
   # - background scheduling inside the harness lifecycle
   #
@@ -124,17 +124,17 @@ spec:
         sweepBatchSize: 100
         vacuum: false
 
-  # agent-harness feature: runtime-managed recovery policy for interrupted runs.
+  # agent-harness feature: runtime-managed recovery policy for interrupted requests.
   # This keeps checkpoint resume as an internal lifecycle concern instead of a primary user-facing API concept.
   #
   # Current support:
-  # - startup recovery of runs already in `resuming` state
+  # - startup recovery of requests already in `resuming` state
   # - persisted approval-decision intent for cross-restart resume continuation
   # - bounded retry attempts to avoid infinite restart loops
   #
   recovery:
     enabled: true
-    resumeResumingRunsOnStartup: true
+    resumeResumingRequestsOnStartup: true
     maxRecoveryAttempts: 3
 
   # agent-harness feature: runtime-managed resilience policy for transient provider failures.

package/dist/contracts/core.d.ts

@@ -4,4 +4,4 @@ export type RuntimeCapabilities = {
     delegation?: boolean;
     memory?: boolean;
 };
-export type RunState = "queued" | "claimed" | "running" | "waiting_for_approval" | "resuming" | "cancelling" | "cancelled" | "completed" | "failed";
+export type RequestState = "queued" | "claimed" | "running" | "waiting_for_approval" | "resuming" | "cancelling" | "cancelled" | "completed" | "failed";

package/dist/contracts/runtime.d.ts

@@ -1,4 +1,4 @@
-import type { RunState } from "./core.js";
+import type { RequestState } from "./core.js";
 import type { CompiledAgentBinding, CompiledModel, CompiledTool, ParsedAgentObject, ParsedToolObject, WorkspaceBundle } from "./workspace.js";
 /**
  * Persisted runtime summary for an inspectable conversation session.
@@ -10,7 +10,7 @@ export type SessionSummary = {
     latestRequestId: string;
     createdAt: string;
     updatedAt: string;
-    status: RunState;
+    status: RequestState;
     currentAgentId?: string;
 };
 /**
@@ -25,9 +25,7 @@ export type SessionListSummary = SessionSummary & {
     title?: string;
     snippet?: string;
 };
-export type ThreadSummary = SessionSummary;
-export type ThreadListSummary = SessionListSummary;
-export type KnownHarnessEventType = "run.created" | "run.queued" | "run.dequeued" | "run.state.changed" | "run.resumed" | "approval.requested" | "approval.resolved" | "artifact.created" | "output.delta" | "runtime.health.changed" | "runtime.synthetic_fallback";
+export type KnownHarnessEventType = "request.created" | "request.queued" | "request.dequeued" | "request.state.changed" | "request.resumed" | "approval.requested" | "approval.resolved" | "artifact.created" | "output.delta" | "runtime.health.changed" | "runtime.synthetic_fallback";
 export type HarnessEventType = KnownHarnessEventType | (string & {});
 /**
  * Persisted runtime event recorded by the harness runtime.
@@ -62,7 +60,7 @@ export type RuntimeTimelineItem = {
     timestamp: string;
     sequence: number;
     source: HarnessEvent["source"];
-    kind: "run" | "queue" | "approval" | "recovery" | "artifact" | "other";
+    kind: "request" | "queue" | "approval" | "recovery" | "artifact" | "other";
     payload: Record<string, unknown>;
 };
 export type RuntimeTimelineProjectionOptions = {
@@ -109,9 +107,9 @@ export type AgentReference = {
 };
 export type RuntimeQueueDiagnostics = {
     status: HealthStatus;
-    activeRunSlots: number;
-    pendingRunSlots: number;
-    stuckRuns: number;
+    activeRequestSlots: number;
+    pendingRequestSlots: number;
+    stuckRequests: number;
     queueEvents: RuntimeTimelineItem[];
     summary: string;
 };
@@ -135,10 +133,10 @@ export type RuntimeOperatorOverview = {
         total: number;
         items: ApprovalRecord[];
     };
-    runs: {
+    requests: {
         total: number;
-        states: Partial<Record<RunState, number>>;
-        items: RunSummary[];
+        states: Partial<Record<RequestState, number>>;
+        items: RequestSummary[];
     };
     governance: RuntimeGovernanceDiagnostics;
 };
@@ -224,7 +222,7 @@ export type MemoryCandidate = {
     provenance?: Record<string, unknown>;
 };
 export type MemoryKind = "semantic" | "episodic" | "procedural";
-export type MemoryScope = "thread" | "agent" | "workspace" | "user" | "project";
+export type MemoryScope = "session" | "agent" | "workspace" | "user" | "project";
 export type MemoryRecordStatus = "active" | "stale" | "conflicted" | "archived" | "pending_review";
 export type MemoryDecisionAction = "reject" | "store" | "merge" | "refresh" | "supersede" | "archive" | "review";
 export type MemoryRecord = {
@@ -399,10 +397,10 @@ export type RuntimeHealthSnapshot = {
     };
     symptoms: RuntimeHealthSymptom[];
     stats: {
-        activeRunSlots: number;
-        pendingRunSlots: number;
+        activeRequestSlots: number;
+        pendingRequestSlots: number;
         pendingApprovals: number;
-        stuckRuns: number;
+        stuckRequests: number;
         checkpointBytes?: number;
         runtimeDbBytes?: number;
         artifactBytes?: number;
@@ -410,10 +408,10 @@ export type RuntimeHealthSnapshot = {
         llmP95LatencyMs1m?: number;
     };
 };
-export type RunResult = {
+export type RequestResult = {
     sessionId: string;
     requestId: string;
-    state: RunState;
+    state: RequestState;
     output: string;
     finalMessageText?: string;
     outputContent?: unknown;
@@ -439,7 +437,7 @@ export type RuntimeListeners = {
     onUpstreamEvent?: (event: UpstreamRuntimeEvent) => void | Promise<void>;
     onTraceItem?: (item: UpstreamRuntimeEventItem) => void | Promise<void>;
 };
-export type RunListeners = RuntimeListeners;
+export type RequestListeners = RuntimeListeners;
 export type MessageContentPart = {
     type: "text";
     text: string;
@@ -454,23 +452,23 @@ export type InvocationEnvelope = {
     attachments?: Record<string, unknown>;
     capabilities?: Record<string, unknown>;
 };
-export type RunStartOptions = {
+export type RequestStartOptions = {
     agentId?: string;
     input: MessageContent;
     sessionId?: string;
     priority?: number;
     invocation?: InvocationEnvelope;
-    listeners?: RunListeners;
+    listeners?: RequestListeners;
 };
-export type RunDecisionOptions = {
+export type RequestDecisionOptions = {
     sessionId: string;
     requestId?: string;
     approvalId?: string;
     decision: "approve" | "edit" | "reject";
     editedInput?: Record<string, unknown>;
-    listeners?: RunListeners;
+    listeners?: RequestListeners;
 };
-export type RunOptions = RunStartOptions | RunDecisionOptions;
+export type RequestOptions = RequestStartOptions | RequestDecisionOptions;
 export type HarnessStreamItem = {
     type: "event";
     event: HarnessEvent;
@@ -502,7 +500,7 @@ export type HarnessStreamItem = {
     event: UpstreamRuntimeEvent;
 } | {
     type: "result";
-    result: RunResult;
+    result: RequestResult;
 };
 export type TranscriptMessage = {
     role: "user" | "assistant";
@@ -510,16 +508,16 @@ export type TranscriptMessage = {
     requestId: string;
     createdAt: string;
 };
-export type ThreadRunRecord = {
+export type SessionRequestRecord = {
     requestId: string;
     sessionId: string;
     agentId: string;
-    parentRunId?: string;
+    parentRequestId?: string;
     executionMode: string;
     adapterKind?: string;
     createdAt: string;
     updatedAt: string;
-    state: RunState;
+    state: RequestState;
     checkpointRef: string | null;
     resumable: boolean;
     startedAt: string;
@@ -533,13 +531,11 @@ export type ThreadRunRecord = {
  * Persisted request summary projected from upstream execution state plus runtime lifecycle metadata.
  * This is the canonical runtime-facing execution record.
  */
-export type RequestSummary = ThreadRunRecord;
+export type RequestSummary = SessionRequestRecord;
 export type RequestRecord = RequestSummary & {
     traceItems?: unknown[];
     runtimeTimeline?: RuntimeTimelineItem[];
 };
-export type RunSummary = RequestSummary;
-export type RunRecord = RequestRecord;
 /**
  * Persisted session inspection record assembled from runtime records.
  * This is an inspectable projection, not a second session semantic model.
@@ -548,7 +544,7 @@ export type SessionRecord = {
     sessionId: string;
     entryAgentId: string;
     currentAgentId?: string;
-    currentState: RunState;
+    currentState: RequestState;
     latestRequestId: string;
     createdAt: string;
     updatedAt: string;
@@ -562,7 +558,6 @@ export type SessionRecord = {
         requestedAt: string;
     };
 };
-export type ThreadRecord = SessionRecord;
 export type ResumeOptions = {
     sessionId?: string;
     requestId?: string;
@@ -576,7 +571,7 @@ export type CancelOptions = {
 };
 export type RestartConversationOptions = {
     sessionId: string;
-    mode: "restart-in-thread" | "restart-new-thread";
+    mode: "restart-in-session" | "restart-new-session";
     input: string;
 };
 /**
@@ -714,7 +709,7 @@ export type RuntimeEvaluationArtifact = ArtifactRecord & {
 export type RuntimeEvaluationExport = {
     session: SessionRecord | null;
     request: RequestRecord | null;
-    runRequest: {
+    requestInput: {
         input: MessageContent;
         invocation?: InvocationEnvelope;
         priority?: number;
@@ -742,12 +737,12 @@ export type RuntimeEvaluationReplayResult = {
         invocation?: InvocationEnvelope;
         sessionId?: string;
     };
-    result: RunResult;
+    result: RequestResult;
     assertions: {
         expectedOutputMatched?: boolean;
     };
 };
-export type RuntimeRunPackageInput = {
+export type RuntimeRequestPackageInput = {
     sessionId: string;
     requestId: string;
     includeArtifacts?: boolean;
@@ -769,7 +764,7 @@ export type RuntimeGovernanceEvidence = {
     approvalSummary: RuntimeApprovalSummary;
     summary: string;
 };
-export type RuntimeRunPackage = {
+export type RuntimeRequestPackage = {
     session: SessionRecord | null;
     request: RequestRecord | null;
     approvals: ApprovalRecord[];
@@ -790,9 +785,9 @@ export type RuntimeSessionPackage = {
     requests: RequestRecord[];
     approvals: ApprovalRecord[];
     transcript: TranscriptMessage[];
-    runs: RuntimeRunPackage[];
+    requestsPackages: RuntimeRequestPackage[];
     governance: {
-        runs: Array<{
+        requests: Array<{
             requestId: string;
             evidence: RuntimeGovernanceEvidence;
         }>;

package/dist/contracts/workspace.d.ts

@@ -6,7 +6,7 @@ export type ParsedAgentObject = {
     capabilities?: RuntimeCapabilities;
     description: string;
     modelRef: string;
-    runRoot?: string;
+    runtimeRoot?: string;
     applicationRoot?: string;
     dataRoot?: string;
     runtimeProfile?: string;
@@ -266,7 +266,7 @@ export type CompiledAgentBinding = {
         applicationRoot?: string;
         dataRoot?: string;
         runtimeProfile?: string;
-        runRoot: string;
+        runtimeRoot: string;
         workspaceRoot?: string;
         capabilities?: RuntimeCapabilities;
         resilience?: Record<string, unknown>;