@botbotgo/agent-harness 0.0.290 → 0.0.291

package/dist/flow/build-flow-graph.js

@@ -28,20 +28,7 @@ function extractUpstreamEventEnvelope(value) {
     };
 }
 function normalizeRuntimeEventType(eventType) {
-    switch (eventType) {
-        case "request.created":
-            return "run.created";
-        case "request.queued":
-            return "run.queued";
-        case "request.dequeued":
-            return "run.dequeued";
-        case "request.state.changed":
-            return "run.state.changed";
-        case "request.resumed":
-            return "run.resumed";
-        default:
-            return eventType;
-    }
+    return eventType;
 }
 function normalizeRuntimeEvents(events) {
     return events.map((event) => {
@@ -133,15 +120,15 @@ function deriveStatusFromProjection(projection) {
     return projection.category === "approval" && projection.status === "started" ? "waiting" : projection.status;
 }
 function deriveRuntimeNode(input) {
-    if (input.eventType === "run.created") {
+    if (input.eventType === "request.created") {
         return {
-            kind: "run",
+            kind: "request",
             status: "started",
-            label: "Run created",
+            label: "Request created",
             detail: input.payload,
         };
     }
-    if (input.eventType === "run.queued") {
+    if (input.eventType === "request.queued") {
         return {
             kind: "queue",
             status: "waiting",
@@ -149,7 +136,7 @@ function deriveRuntimeNode(input) {
             detail: input.payload,
         };
     }
-    if (input.eventType === "run.dequeued") {
+    if (input.eventType === "request.dequeued") {
         return {
             kind: "queue",
             status: "completed",
@@ -173,11 +160,11 @@ function deriveRuntimeNode(input) {
             detail: input.payload,
         };
     }
-    if (input.eventType === "run.resumed") {
+    if (input.eventType === "request.resumed") {
         return {
             kind: "recovery",
             status: "completed",
-            label: "Run resumed",
+            label: "Request resumed",
             detail: input.payload,
         };
     }
@@ -189,7 +176,7 @@ function deriveRuntimeNode(input) {
             detail: input.payload,
         };
     }
-    if (input.eventType === "run.state.changed") {
+    if (input.eventType === "request.state.changed") {
         const state = typeof input.payload.state === "string" ? input.payload.state : "";
         if (state === "waiting_for_approval") {
             return {
@@ -201,24 +188,24 @@ function deriveRuntimeNode(input) {
         }
         if (state === "failed") {
             return {
-                kind: "run",
+                kind: "request",
                 status: "failed",
-                label: "Run failed",
+                label: "Request failed",
                 detail: input.payload,
             };
         }
         if (state === "completed") {
             return {
-                kind: "run",
+                kind: "request",
                 status: "completed",
-                label: "Run completed",
+                label: "Request completed",
                 detail: input.payload,
             };
         }
         return {
-            kind: "run",
+            kind: "request",
             status: "started",
-            label: state ? `Run ${state}` : "Run state changed",
+            label: state ? `Request ${state}` : "Request state changed",
             detail: input.payload,
         };
     }
@@ -259,7 +246,7 @@ function buildRuntimeNodes(timeline) {
         if (previousNode) {
             const kind = item.eventType === "approval.resolved"
                 ? "approval"
-                : item.eventType === "run.resumed"
+                : item.eventType === "request.resumed"
                     ? "resume"
                     : "sequence";
             edges.push({
@@ -272,14 +259,14 @@ function buildRuntimeNodes(timeline) {
             });
         }
         previousNode = node;
-        if (item.eventType === "run.created" || item.eventType === "run.dequeued" || item.eventType === "run.resumed") {
+        if (item.eventType === "request.created" || item.eventType === "request.dequeued" || item.eventType === "request.resumed") {
             segmentOrdinal += 1;
             activeExecutionGroup = {
                 id: `group:${item.requestId}:segment:${segmentOrdinal}`,
                 kind: "segment",
-                label: item.eventType === "run.created"
+                label: item.eventType === "request.created"
                     ? `Execution segment ${segmentOrdinal}`
-                    : item.eventType === "run.resumed"
+                    : item.eventType === "request.resumed"
                         ? `Resumed segment ${segmentOrdinal}`
                         : `Dequeued segment ${segmentOrdinal}`,
                 nodeIds: [node.id],
@@ -915,7 +902,7 @@ export function buildFlowGraph(input) {
     }));
     return {
         graphId: `${sessionId}/${requestId}`,
-        scope: input.scope ?? "run",
+        scope: input.scope === "session" || input.scope === "request" ? input.scope : "request",
         sessionId,
         requestId,
         nodes: [...runtimeNodes, ...attemptNodes],

package/dist/flow/export-sequence-mermaid.js

@@ -122,7 +122,7 @@ function selectNodes(graph, options) {
         if (includedKinds) {
             return includedKinds.has(node.kind);
         }
-        return node.kind === "run"
+        return node.kind === "request"
             || node.kind === "agent"
             || node.kind === "approval"
             || node.kind === "recovery"
@@ -150,7 +150,7 @@ function getParticipantsForNode(node) {
         alias: sanitizeAlias(`Agent_${node.agentId ?? "agent"}`),
         label: formatAgentParticipantLabel(node),
     };
-    if (node.kind === "run") {
+    if (node.kind === "request") {
         return [
             { id: "user", alias: "User", label: "User" },
             runtimeParticipant,
@@ -219,10 +219,10 @@ function getParticipantsForNode(node) {
     return [runtimeParticipant, agentParticipant];
 }
 function renderArrowForNode(node) {
-    if (node.kind === "run" && node.status === "started") {
+    if (node.kind === "request" && node.status === "started") {
         return { from: "User", to: "Runtime", text: node.label };
     }
-    if (node.kind === "run" && (node.status === "completed" || node.status === "failed")) {
+    if (node.kind === "request" && (node.status === "completed" || node.status === "failed")) {
         return { from: "Runtime", to: "User", text: node.label };
     }
     if (node.kind === "agent") {

package/dist/flow/types.d.ts

@@ -11,7 +11,7 @@ export type BuildFlowGraphRuntimeEvent = HarnessEvent | {
     payload: Record<string, unknown>;
 };
 export type FlowNodeLayer = "runtime" | "execution" | "attempt" | "detail";
-export type FlowNodeKind = "run" | "agent" | "queue" | "approval" | "recovery" | "artifact" | "llm" | "tool" | "skill" | "memory" | "chain" | "result" | "thinking" | "other";
+export type FlowNodeKind = "request" | "agent" | "queue" | "approval" | "recovery" | "artifact" | "llm" | "tool" | "skill" | "memory" | "chain" | "result" | "thinking" | "other";
 export type FlowNodeStatus = "pending" | "started" | "completed" | "failed" | "waiting" | "resolved" | "skipped";
 export type FlowEdgeKind = "sequence" | "contains" | "approval" | "resume" | "retry" | "fallback" | "result" | "spawn";
 export type FlowGroupKind = "segment" | "approval-window" | "attempt-set" | "agent-scope";
@@ -54,7 +54,7 @@ export type FlowGroup = {
 };
 export type FlowGraph = {
     graphId: string;
-    scope: "run" | "thread";
+    scope: "request" | "session";
     sessionId: string;
     requestId: string;
     nodes: FlowNode[];

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-export { AgentHarnessAcpServer, AgentHarnessRuntime, cancelRun, createAgentHarness, createAcpServer, createAcpStdioClient, createRuntimeMcpServer, createUpstreamTimelineReducer, createToolMcpServer, deleteSession, describeInventory, exportEvaluationBundle, exportFlow, exportSequence, exportRequestPackage, exportSessionPackage, replayEvaluationBundle, getArtifact, getAgent, getApproval, getOperatorOverview, getRequest, getHealth, listMemories, listRequestTraceItems, getSession, listAgentSkills, listArtifacts, listApprovals, listRequests, listRequestEvents, listSessionSummaries, listSessions, memorize, normalizeUserChatInput, recordArtifact, request, recall, removeMemory, resolveApproval, serveA2aHttp, serveAcpHttp, serveAcpStdio, serveAgUiHttp, serveRuntimeMcpOverStdio, serveToolsOverStdio, subscribe, stop, updateMemory, } from "./api.js";
+export { AgentHarnessAcpServer, AgentHarnessRuntime, cancelRequest, createAgentHarness, createAcpServer, createAcpStdioClient, createRuntimeMcpServer, createUpstreamTimelineReducer, createToolMcpServer, deleteSession, describeInventory, exportEvaluationBundle, exportFlow, exportSequence, exportRequestPackage, exportSessionPackage, replayEvaluationBundle, getArtifact, getAgent, getApproval, getOperatorOverview, getRequest, getHealth, listMemories, listRequestTraceItems, getSession, listAgentSkills, listRequestArtifacts, listApprovals, listRequests, listRequestEvents, listSessionSummaries, listSessions, memorize, normalizeUserChatInput, recordArtifact, request, recall, removeMemory, resolveApproval, serveA2aHttp, serveAcpHttp, serveAcpStdio, serveAgUiHttp, serveRuntimeMcpOverStdio, serveToolsOverStdio, subscribe, stop, updateMemory, } from "./api.js";
 export { createKnowledgeModule, readKnowledgeRuntimeConfig } from "./knowledge/index.js";
-export type { AcpApproval, AcpArtifact, AcpEventNotification, AcpJsonRpcError, AcpJsonRpcRequest, AcpJsonRpcResponse, AcpJsonRpcSuccess, AcpRequestRecord, AcpRunRequestParams, AcpServerCapabilities, AcpSessionRecord, AcpStdioClient, AcpStdioClientOptions, } from "./acp.js";
-export type { Approval, ListMemoriesInput, ListMemoriesResult, MemoryDecision, MemoryKind, MemoryRecord, MemoryScope, MemorizeInput, MemorizeResult, NormalizeUserChatInputOptions, OperatorOverview, PublicRunListeners, RecordArtifactInput, RequestArtifactListing, RequestEvent, RequestEventType, RequestPackage, RequestPackageInput, RequestFlowGraphInput, RequestResult, RequestTraceItem, RecallInput, RecallResult, RemoveMemoryInput, RuntimeEvaluationExport, RuntimeEvaluationExportInput, RuntimeEvaluationReplayInput, RuntimeEvaluationReplayResult, SessionListSummary, RuntimeSessionPackage, RuntimeSessionPackageInput, UpdateMemoryInput, UserChatInput, UserChatMessage, } from "./api.js";
+export type { AcpApproval, AcpArtifact, AcpEventNotification, AcpJsonRpcError, AcpJsonRpcRequest, AcpJsonRpcResponse, AcpJsonRpcSuccess, AcpRequestRecord, AcpRequestParams, AcpServerCapabilities, AcpSessionRecord, AcpStdioClient, AcpStdioClientOptions, } from "./acp.js";
+export type { Approval, ListMemoriesInput, ListMemoriesResult, MemoryDecision, MemoryKind, MemoryRecord, MemoryScope, MemorizeInput, MemorizeResult, NormalizeUserChatInputOptions, OperatorOverview, RecordArtifactInput, PublicRequestListeners, RequestArtifactListing, RequestEvent, RequestEventType, RequestPackage, RequestPackageInput, RequestFlowGraphInput, RequestResult, RequestTraceItem, RecallInput, RecallResult, RemoveMemoryInput, RuntimeEvaluationExport, RuntimeEvaluationExportInput, RuntimeEvaluationReplayInput, RuntimeEvaluationReplayResult, SessionListSummary, RuntimeSessionPackage, RuntimeSessionPackageInput, UpdateMemoryInput, UserChatInput, UserChatMessage, } from "./api.js";
 export type { KnowledgeListInput, KnowledgeMemorizeInput, KnowledgeModule, KnowledgeModuleDependencies, KnowledgeRecallInput, KnowledgeRuntimeConfig, KnowledgeRuntimeContext, } from "./knowledge/index.js";
-export type { A2aAgentCard, A2aHttpServer, A2aHttpServerOptions, A2aTask, A2aTaskState, AcpHttpServer, AcpHttpServerOptions, AcpStdioServer, AcpStdioServerOptions, AgUiEvent, AgUiHttpServer, AgUiHttpServerOptions, AgUiRunAgentInput, } from "./api.js";
+export type { A2aAgentCard, A2aHttpServer, A2aHttpServerOptions, A2aTask, A2aTaskState, AcpHttpServer, AcpHttpServerOptions, AcpStdioServer, AcpStdioServerOptions, AgUiEvent, AgUiHttpServer, AgUiHttpServerOptions, AgUiRequestAgentInput, } from "./api.js";
 export type { RuntimeMcpServerOptions, ToolMcpServerOptions } from "./mcp.js";
 export { tool } from "./tools.js";
 export type { UpstreamTimelineProjection, UpstreamTimelineReducer } from "./upstream-events.js";

package/dist/index.js

@@ -1,3 +1,3 @@
-export { AgentHarnessAcpServer, AgentHarnessRuntime, cancelRun, createAgentHarness, createAcpServer, createAcpStdioClient, createRuntimeMcpServer, createUpstreamTimelineReducer, createToolMcpServer, deleteSession, describeInventory, exportEvaluationBundle, exportFlow, exportSequence, exportRequestPackage, exportSessionPackage, replayEvaluationBundle, getArtifact, getAgent, getApproval, getOperatorOverview, getRequest, getHealth, listMemories, listRequestTraceItems, getSession, listAgentSkills, listArtifacts, listApprovals, listRequests, listRequestEvents, listSessionSummaries, listSessions, memorize, normalizeUserChatInput, recordArtifact, request, recall, removeMemory, resolveApproval, serveA2aHttp, serveAcpHttp, serveAcpStdio, serveAgUiHttp, serveRuntimeMcpOverStdio, serveToolsOverStdio, subscribe, stop, updateMemory, } from "./api.js";
+export { AgentHarnessAcpServer, AgentHarnessRuntime, cancelRequest, createAgentHarness, createAcpServer, createAcpStdioClient, createRuntimeMcpServer, createUpstreamTimelineReducer, createToolMcpServer, deleteSession, describeInventory, exportEvaluationBundle, exportFlow, exportSequence, exportRequestPackage, exportSessionPackage, replayEvaluationBundle, getArtifact, getAgent, getApproval, getOperatorOverview, getRequest, getHealth, listMemories, listRequestTraceItems, getSession, listAgentSkills, listRequestArtifacts, listApprovals, listRequests, listRequestEvents, listSessionSummaries, listSessions, memorize, normalizeUserChatInput, recordArtifact, request, recall, removeMemory, resolveApproval, serveA2aHttp, serveAcpHttp, serveAcpStdio, serveAgUiHttp, serveRuntimeMcpOverStdio, serveToolsOverStdio, subscribe, stop, updateMemory, } from "./api.js";
 export { createKnowledgeModule, readKnowledgeRuntimeConfig } from "./knowledge/index.js";
 export { tool } from "./tools.js";

package/dist/init-project.js

@@ -169,7 +169,7 @@ spec:
   ingestion:
     backgroundConsolidation: true
     writeOnApprovalResolution: true
-    writeOnRunCompletion: true
+    writeOnRequestCompletion: true
   formation:
     hotPath:
       enabled: true
@@ -180,19 +180,19 @@ spec:
     background:
       enabled: true
       scopes:
-        - thread
+        - session
       stateStorePath: knowledge/formation-state.json
-      maxMessagesPerRun: 40
+      maxMessagesPerRequest: 40
       writeOnApprovalResolution: true
-      writeOnRunCompletion: true
-  threadMemorySync:
+      writeOnRequestCompletion: true
+  sessionMemorySync:
     enabled: true
   mem0:
     enabled: false
     apiKeyEnv: MEM0_API_KEY
     appId: ${projectSlug}
     stateStorePath: knowledge/mem0-sync-state.json
-    maxMessagesPerRun: 200
+    maxMessagesPerRequest: 200
 `;
 }
 function renderKnowledgeRuntimeYaml(projectSlug) {
@@ -224,17 +224,17 @@ spec:
     background:
       enabled: true
       scopes:
-        - thread
+        - session
       stateStorePath: knowledge/formation-state.json
-      maxMessagesPerRun: 40
+      maxMessagesPerRequest: 40
       writeOnApprovalResolution: true
-      writeOnRunCompletion: true
+      writeOnRequestCompletion: true
   mem0:
     enabled: false
     apiKeyEnv: MEM0_API_KEY
     appId: ${projectSlug}
     stateStorePath: knowledge/mem0-sync-state.json
-    maxMessagesPerRun: 200
+    maxMessagesPerRequest: 200
 `;
 }
 function renderToolsYaml(options) {

package/dist/knowledge/module.js

@@ -3,9 +3,9 @@ import { findMemoryRecordById, getMemoryRecord, listMemoryRecordsForScopes, pers
 import { consolidateStructuredMemoryScope } from "../runtime/harness/system/runtime-memory-consolidation.js";
 import { renderMemoryCandidatesMarkdown } from "../runtime/harness/system/runtime-memory-candidates.js";
 import { normalizeLangMemMemoryKind, scoreMemoryText, } from "../runtime/harness/system/runtime-memory-policy.js";
-const ALL_SCOPES = ["thread", "agent", "workspace", "user", "project"];
+const ALL_SCOPES = ["session", "agent", "workspace", "user", "project"];
 const TITLE_BY_SCOPE = {
-    thread: "Thread Structured Memory",
+    session: "Session Structured Memory",
     agent: "Agent Structured Memory",
     workspace: "Workspace Structured Memory",
     user: "User Structured Memory",
@@ -29,7 +29,7 @@ function resolveRecallScopes(input, context) {
     if (Array.isArray(input.scopes) && input.scopes.length > 0) {
         return Array.from(new Set(input.scopes));
     }
-    const scopes = new Set(["thread", "agent", "workspace"]);
+    const scopes = new Set(["session", "agent", "workspace"]);
     if (context.userId) {
         scopes.add("user");
     }
@@ -39,8 +39,8 @@ function resolveRecallScopes(input, context) {
     return Array.from(scopes);
 }
 function matchesMemoryFilters(record, filters) {
-    const sessionId = String(record.provenance.sessionId ?? record.provenance.threadId ?? "");
-    if (filters.threadId && sessionId !== filters.threadId) {
+    const sessionId = String(record.provenance.sessionId ?? "");
+    if (filters.sessionId && sessionId !== filters.sessionId) {
         return false;
     }
     if (filters.agentId && record.provenance.agentId !== filters.agentId) {
@@ -58,9 +58,9 @@ function matchesMemoryFilters(record, filters) {
     return true;
 }
 function matchesRecallScope(record, filters) {
-    if (record.scope === "thread") {
-        return typeof filters.threadId === "string"
-            && String(record.provenance.sessionId ?? record.provenance.threadId ?? "") === filters.threadId;
+    if (record.scope === "session") {
+        return typeof filters.sessionId === "string"
+            && String(record.provenance.sessionId ?? "") === filters.sessionId;
     }
     if (record.scope === "agent") {
         return String(record.provenance.agentId ?? "") === filters.agentId;
@@ -74,7 +74,7 @@ function matchesRecallScope(record, filters) {
     return String(record.provenance.projectId ?? filters.workspaceId) === filters.projectId;
 }
 function getMemoryScopeBoost(scope) {
-    if (scope === "thread") {
+    if (scope === "session") {
         return 4;
     }
     if (scope === "agent") {
@@ -112,11 +112,11 @@ function inferMem0MemoryKind(hit) {
 }
 function inferMem0MemoryScope(hit, filters) {
     const metadataScope = typeof hit.metadata.scope === "string" ? hit.metadata.scope : undefined;
-    if (metadataScope === "thread" || metadataScope === "agent" || metadataScope === "workspace" || metadataScope === "user" || metadataScope === "project") {
+    if (metadataScope === "session" || metadataScope === "agent" || metadataScope === "workspace" || metadataScope === "user" || metadataScope === "project") {
         return metadataScope;
     }
-    if (typeof hit.metadata.threadId === "string" && filters.threadId && hit.metadata.threadId === filters.threadId) {
-        return "thread";
+    if (typeof hit.metadata.sessionId === "string" && filters.sessionId && hit.metadata.sessionId === filters.sessionId) {
+        return "session";
     }
     if (hit.agentId === filters.agentId || hit.metadata.agentId === filters.agentId) {
         return "agent";
@@ -144,16 +144,8 @@ function createMem0MemoryRecord(hit, filters) {
         tags: hit.categories,
         provenance: {
             source: "mem0",
-            sessionId: typeof hit.metadata.sessionId === "string"
-                ? hit.metadata.sessionId
-                : typeof hit.metadata.threadId === "string"
-                    ? hit.metadata.threadId
-                    : filters.threadId,
-            requestId: (typeof hit.metadata.requestId === "string"
-                ? hit.metadata.requestId
-                : typeof hit.metadata.runId === "string"
-                    ? hit.metadata.runId
-                    : undefined),
+            sessionId: typeof hit.metadata.sessionId === "string" ? hit.metadata.sessionId : filters.sessionId,
+            requestId: typeof hit.metadata.requestId === "string" ? hit.metadata.requestId : undefined,
             agentId: hit.agentId ?? (typeof hit.metadata.agentId === "string" ? hit.metadata.agentId : filters.agentId),
             workspaceId: filters.workspaceId,
             userId: filters.userId,
@@ -184,8 +176,8 @@ export class DefaultKnowledgeModule {
         if (candidates.some((record) => typeof record.content !== "string" || record.content.trim().length === 0)) {
             throw new Error("memorize requires every record to include non-empty content.");
         }
-        if (candidates.some((record) => (record.scope ?? "thread") === "thread") && !normalizedContext.sessionId) {
-            throw new Error("memorize requires sessionId when storing thread-scoped memory.");
+        if (candidates.some((record) => (record.scope ?? "session") === "session") && !normalizedContext.sessionId) {
+            throw new Error("memorize requires sessionId when storing session-scoped memory.");
         }
         const recordedAt = normalizedContext.recordedAt ?? new Date().toISOString();
         const requestId = normalizedContext.requestId ?? createPersistentId(new Date(recordedAt));
@@ -230,7 +222,7 @@ export class DefaultKnowledgeModule {
             context: normalizedContext,
         }))
             .map((item) => {
-            const scopeBoost = item.record.scope === "thread"
+            const scopeBoost = item.record.scope === "session"
                 ? 4
                 : item.record.scope === "agent"
                     ? 3
@@ -274,7 +266,7 @@ export class DefaultKnowledgeModule {
             .filter((record) => statuses.has(record.status))
             .filter((record) => !kinds || kinds.has(record.kind))
             .filter((record) => matchesMemoryFilters(record, {
-            threadId: normalizedContext.sessionId,
+            sessionId: normalizedContext.sessionId,
             agentId: normalizedContext.agentId,
             workspaceId: normalizedContext.workspaceId,
             userId: normalizedContext.userId,
@@ -353,8 +345,8 @@ export class DefaultKnowledgeModule {
             : validCandidates;
         if (options.storeCandidateLog) {
             await this.deps.store.put(["memories", "candidates", normalizedContext.sessionId ?? `memory-api-${normalizedContext.requestId ?? "unknown"}`], `${normalizedContext.requestId}.json`, {
-                runId: normalizedContext.requestId,
-                threadId: normalizedContext.sessionId,
+                requestId: normalizedContext.requestId,
+                sessionId: normalizedContext.sessionId,
                 storedAt: normalizedContext.recordedAt,
                 candidates: transformedCandidates,
             });
@@ -362,8 +354,8 @@ export class DefaultKnowledgeModule {
         const persisted = await persistStructuredMemoryRecords({
             store: this.deps.store,
             candidates: transformedCandidates,
-            threadId: normalizedContext.sessionId ?? `memory-api-${normalizedContext.requestId ?? "unknown"}`,
-            runId: normalizedContext.requestId ?? createPersistentId(new Date(normalizedContext.recordedAt ?? new Date().toISOString())),
+            sessionId: normalizedContext.sessionId ?? `memory-api-${normalizedContext.requestId ?? "unknown"}`,
+            requestId: normalizedContext.requestId ?? createPersistentId(new Date(normalizedContext.recordedAt ?? new Date().toISOString())),
             agentId: normalizedContext.agentId,
             workspaceId: normalizedContext.workspaceId,
             userId: normalizedContext.userId ?? "default",
@@ -376,18 +368,18 @@ export class DefaultKnowledgeModule {
     }
     async refreshAfterWrite(candidates, context) {
         const buckets = {
-            thread: candidates.filter((candidate) => (candidate.scope ?? "thread") === "thread"),
-            agent: candidates.filter((candidate) => (candidate.scope ?? "thread") === "agent"),
-            workspace: candidates.filter((candidate) => (candidate.scope ?? "thread") === "workspace"),
-            user: candidates.filter((candidate) => (candidate.scope ?? "thread") === "user"),
-            project: candidates.filter((candidate) => (candidate.scope ?? "thread") === "project"),
+            session: candidates.filter((candidate) => (candidate.scope ?? "session") === "session"),
+            agent: candidates.filter((candidate) => (candidate.scope ?? "session") === "agent"),
+            workspace: candidates.filter((candidate) => (candidate.scope ?? "session") === "workspace"),
+            user: candidates.filter((candidate) => (candidate.scope ?? "session") === "user"),
+            project: candidates.filter((candidate) => (candidate.scope ?? "session") === "project"),
         };
         const writes = [];
         for (const scope of ALL_SCOPES) {
             if (buckets[scope].length === 0) {
                 continue;
             }
-            const maxEntries = scope === "thread" ? 12 : 20;
+            const maxEntries = scope === "session" ? 12 : 20;
             writes.push(this.appendMemoryDigest(this.deps.resolveNamespace(scope, context), "tool-memory.md", buckets[scope], maxEntries, TITLE_BY_SCOPE[scope].replace("Structured", "Tool")));
             writes.push(consolidateStructuredMemoryScope({
                 store: this.deps.store,
@@ -407,7 +399,7 @@ export class DefaultKnowledgeModule {
             : [];
         const merged = [...existingItems];
         for (const candidate of candidates) {
-            if (merged.some((entry) => entry.content === candidate.content && (entry.scope ?? "thread") === (candidate.scope ?? "thread"))) {
+            if (merged.some((entry) => entry.content === candidate.content && (entry.scope ?? "session") === (candidate.scope ?? "session"))) {
                 continue;
             }
             merged.push(candidate);
@@ -440,7 +432,7 @@ export class DefaultKnowledgeModule {
             userId: provenance.userId ?? context.userId,
             projectId: provenance.projectId ?? context.projectId,
         };
-        const maxEntries = record.scope === "thread" ? 12 : 20;
+        const maxEntries = record.scope === "session" ? 12 : 20;
         await consolidateStructuredMemoryScope({
             store: this.deps.store,
             namespace: this.deps.resolveNamespace(record.scope, normalizeRuntimeContext(namespaceContext)),
@@ -469,7 +461,7 @@ export class DefaultKnowledgeModule {
                     scope: record.scope,
                     kind: record.kind,
                     status: record.status,
-                    sessionId: record.provenance.sessionId ?? record.provenance.threadId,
+                    sessionId: record.provenance.sessionId,
                     agentId: record.provenance.agentId,
                     workspaceId: record.provenance.workspaceId,
                     userId: record.provenance.userId,
@@ -487,7 +479,7 @@ export class DefaultKnowledgeModule {
         const structuredRecords = await listMemoryRecordsForScopes(this.deps.store, input.scopes);
         const ranked = structuredRecords
             .filter((record) => matchesRecallScope(record, {
-            threadId: input.context.sessionId,
+            sessionId: input.context.sessionId,
             agentId: input.context.agentId,
             workspaceId: input.context.workspaceId,
             userId: input.context.userId ?? "default",
@@ -513,7 +505,7 @@ export class DefaultKnowledgeModule {
                         : {};
                     const recordId = typeof metadata.recordId === "string" ? metadata.recordId : undefined;
                     const scope = metadata.scope;
-                    if (!recordId || (scope !== "thread" && scope !== "agent" && scope !== "workspace" && scope !== "user" && scope !== "project")) {
+                    if (!recordId || (scope !== "session" && scope !== "agent" && scope !== "workspace" && scope !== "user" && scope !== "project")) {
                         continue;
                     }
                     const canonical = await getMemoryRecord(this.deps.store, scope, recordId);
@@ -521,7 +513,7 @@ export class DefaultKnowledgeModule {
                         continue;
                     }
                     if (!matchesRecallScope(canonical, {
-                        threadId: input.context.sessionId,
+                        sessionId: input.context.sessionId,
                         agentId: input.context.agentId,
                         workspaceId: input.context.workspaceId,
                         userId: input.context.userId ?? "default",
@@ -547,7 +539,7 @@ export class DefaultKnowledgeModule {
                 // Fail open to lexical/runtime ranking.
             }
         }
-        const supportsMem0Scope = input.scopes.some((scope) => scope === "thread" || scope === "agent" || scope === "workspace");
+        const supportsMem0Scope = input.scopes.some((scope) => scope === "session" || scope === "agent" || scope === "workspace");
         const mem0SemanticRecall = this.deps.getMem0SemanticRecall?.() ?? null;
         if (!mem0SemanticRecall || !supportsMem0Scope) {
             return Array.from(deduped.values()).sort((left, right) => right.score - left.score);
@@ -557,11 +549,11 @@ export class DefaultKnowledgeModule {
                 query: input.query,
                 topK: Math.max(input.topK, this.deps.policy?.retrieval.maxPromptMemories ?? input.topK),
                 agentId: input.context.agentId,
-                threadId: input.context.sessionId,
+                sessionId: input.context.sessionId,
             });
             for (const hit of hits) {
                 const record = createMem0MemoryRecord(hit, {
-                    threadId: input.context.sessionId,
+                    sessionId: input.context.sessionId,
                     agentId: input.context.agentId,
                     workspaceId: input.context.workspaceId,
                     userId: input.context.userId ?? "default",

package/dist/mcp.d.ts

@@ -1,5 +1,5 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import type { ApprovalRecord, ArtifactListing, CompiledTool, HarnessEvent, ParsedToolObject, RequestRecord, RunResult, RunState, RequestSummary, RuntimeSessionPackage, RuntimeSessionPackageInput, SessionRecord, SessionSummary } from "./contracts/types.js";
+import type { ApprovalRecord, ArtifactListing, CompiledTool, HarnessEvent, ParsedToolObject, RequestRecord, RequestResult, RequestState, RequestSummary, RuntimeSessionPackage, RuntimeSessionPackageInput, SessionRecord, SessionSummary } from "./contracts/types.js";
 export type ToolMcpServerOptions = {
     agentId: string;
     serverInfo?: {
@@ -27,24 +27,24 @@ type RuntimeMcpRuntime = {
     listRequests: (filter?: {
         agentId?: string;
         sessionId?: string;
-        state?: RunState;
+        state?: RequestState;
     }) => Promise<RequestSummary[]>;
     getRequest: (requestId: string) => Promise<RequestRecord | null>;
     listApprovals: (filter?: {
         status?: ApprovalRecord["status"];
-        threadId?: string;
-        runId?: string;
+        sessionId?: string;
+        requestId?: string;
     }) => Promise<ApprovalRecord[]>;
     getApproval: (approvalId: string) => Promise<ApprovalRecord | null>;
     resume: (options: {
         approvalId?: string;
-        threadId?: string;
-        runId?: string;
+        sessionId?: string;
+        requestId?: string;
         decision?: "approve" | "edit" | "reject";
         editedInput?: Record<string, unknown>;
-    }) => Promise<RunResult>;
-    listArtifacts: (sessionId: string, requestId: string) => Promise<ArtifactListing>;
-    readArtifact: (sessionId: string, requestId: string, artifactPath: string) => Promise<unknown>;
+    }) => Promise<RequestResult>;
+    listRequestArtifacts: (sessionId: string, requestId: string) => Promise<ArtifactListing>;
+    readRequestArtifact: (sessionId: string, requestId: string, artifactPath: string) => Promise<unknown>;
     listRequestEvents: (sessionId: string, requestId: string) => Promise<HarnessEvent[]>;
     exportRequestPackage: (input: {
         sessionId: string;

package/dist/mcp.js

@@ -162,8 +162,8 @@ export async function createRuntimeMcpServer(runtime, options = {}) {
                 type: "text",
                 text: renderToolOutput(await runtime.listApprovals({
                     ...(input.status ? { status: input.status } : {}),
-                    ...(input.sessionId ? { threadId: input.sessionId } : {}),
-                    ...(input.requestId ? { runId: input.requestId } : {}),
+                    ...(input.sessionId ? { sessionId: input.sessionId } : {}),
+                    ...(input.requestId ? { requestId: input.requestId } : {}),
                 })),
             }],
     }));
@@ -187,8 +187,8 @@ export async function createRuntimeMcpServer(runtime, options = {}) {
                 text: renderToolOutput(await runtime.resume({
                     approvalId: input.approvalId,
                     decision: input.decision,
-                    ...(input.sessionId ? { threadId: input.sessionId } : {}),
-                    ...(input.requestId ? { runId: input.requestId } : {}),
+                    ...(input.sessionId ? { sessionId: input.sessionId } : {}),
+                    ...(input.requestId ? { requestId: input.requestId } : {}),
                     ...(input.editedInput ? { editedInput: input.editedInput } : {}),
                 })),
             }],
@@ -199,7 +199,7 @@ export async function createRuntimeMcpServer(runtime, options = {}) {
     }, async (input) => ({
         content: [{
                 type: "text",
-                text: renderToolOutput(await runtime.listArtifacts(input.sessionId, input.requestId)),
+                text: renderToolOutput(await runtime.listRequestArtifacts(input.sessionId, input.requestId)),
             }],
     }));
     server.tool("read_artifact", "Read one runtime artifact.", {
@@ -209,7 +209,7 @@ export async function createRuntimeMcpServer(runtime, options = {}) {
     }, async (input) => ({
         content: [{
                 type: "text",
-                text: renderToolOutput(await runtime.readArtifact(input.sessionId, input.requestId, input.artifactPath)),
+                text: renderToolOutput(await runtime.readRequestArtifact(input.sessionId, input.requestId, input.artifactPath)),
             }],
     }));
     server.tool("list_request_events", "List persisted runtime events for one request.", {

package/dist/package-version.d.ts

@@ -1 +1 @@
-export declare const AGENT_HARNESS_VERSION = "0.0.289";
+export declare const AGENT_HARNESS_VERSION = "0.0.290";

package/dist/package-version.js

@@ -1 +1 @@
-export const AGENT_HARNESS_VERSION = "0.0.289";
+export const AGENT_HARNESS_VERSION = "0.0.290";