@botbotgo/agent-harness 0.0.118 → 0.0.120

package/dist/runtime/harness/run/routing.js

@@ -10,8 +10,12 @@ export function getDefaultHostAgentId(workspace, preferredHostAgentId) {
     }
     return inferRoutingBindings(workspace).primaryBinding?.agent.id ?? "agent";
 }
+export function getDefaultRuntimeEntryAgentId(workspace, preferredRuntimeEntryAgentId) {
+    return getDefaultHostAgentId(workspace, preferredRuntimeEntryAgentId);
+}
 export async function resolveSelectedAgentId(options) {
-    const { workspace, input, requestedAgentId, threadId, preferredHostAgentId, getThreadSummary } = options;
+    const { workspace, input, requestedAgentId, threadId, preferredHostAgentId, preferredRuntimeEntryAgentId, getThreadSummary, } = options;
+    const preferredEntryAgentId = preferredRuntimeEntryAgentId ?? preferredHostAgentId;
     if (!requestedAgentId || requestedAgentId === AUTO_AGENT_ID) {
         if (threadId) {
             const thread = await getThreadSummary(threadId);
@@ -20,7 +24,7 @@ export async function resolveSelectedAgentId(options) {
                 return thread.agentId;
             }
         }
-        return getDefaultHostAgentId(workspace, preferredHostAgentId);
+        return getDefaultRuntimeEntryAgentId(workspace, preferredEntryAgentId);
     }
     return requestedAgentId;
 }
@@ -40,5 +44,5 @@ export function routeAgentId(options) {
     if (defaultBinding) {
         return defaultBinding.agent.id;
     }
-    return getDefaultHostAgentId(workspace, routingDefaultAgentId);
+    return getDefaultRuntimeEntryAgentId(workspace, routingDefaultAgentId);
 }

package/dist/runtime/harness/run/start-run.js

@@ -3,7 +3,7 @@ import { createPersistentId } from "../../../utils/id.js";
 import { normalizeMessageContent } from "../../../utils/message-content.js";
 import { buildPersistedRunRequest, normalizeRunPriority } from "./helpers.js";
 import { getRequiredWorkspaceBinding } from "../bindings.js";
-import { getBindingAdapterKind } from "../../support/compiled-binding.js";
+import { getBindingAdapterKind, getBindingRuntimeExecutionMode } from "../../support/compiled-binding.js";
 export async function ensureThreadStarted(runtime, input) {
     const { selectedAgentId, binding, message, runRequest, existingThreadId } = input;
     const threadId = existingThreadId ?? createPersistentId();
@@ -23,7 +23,7 @@ export async function ensureThreadStarted(runtime, input) {
             runId,
             status: "running",
             createdAt,
-            executionMode: getBindingAdapterKind(binding),
+            executionMode: getBindingRuntimeExecutionMode(binding),
             adapterKind: getBindingAdapterKind(binding),
             userMessage,
             runRequest,
@@ -46,7 +46,7 @@ export async function ensureThreadStarted(runtime, input) {
                 threadId,
                 runId,
                 agentId: binding.agent.id,
-                executionMode: getBindingAdapterKind(binding),
+                executionMode: getBindingRuntimeExecutionMode(binding),
                 adapterKind: getBindingAdapterKind(binding),
                 createdAt,
             }),

package/dist/runtime/harness.d.ts

@@ -14,8 +14,8 @@ export declare class AgentHarnessRuntime {
     private readonly stores;
     private readonly embeddingModels;
     private readonly vectorStores;
-    private readonly hostBindings;
-    private readonly defaultHostBinding?;
+    private readonly runtimeEntryBindings;
+    private readonly defaultRuntimeEntryBinding?;
     private readonly defaultRunRootValue;
     private readonly defaultStore;
     private readonly runtimeMemoryStore;
@@ -38,7 +38,7 @@ export declare class AgentHarnessRuntime {
     private readonly backgroundEventRuntime;
     private readonly runtimeEventOperations;
     private defaultRunRoot;
-    private getDefaultHostAgentId;
+    private getDefaultRuntimeEntryAgentId;
     private resolveSelectedAgentId;
     private createPrepareRunStartRuntime;
     constructor(workspace: WorkspaceBundle, runtimeAdapterOptions?: RuntimeAdapterOptions);

package/dist/runtime/harness.js

@@ -18,10 +18,10 @@ import { buildResumePayload as buildHarnessResumePayload, resolveApprovalRecord
 import { cancelRunOperation, executeQueuedRunOperation, resumeRun } from "./harness/run/run-operations.js";
 import { acquireRunSlot as acquireHarnessRunSlot } from "./harness/run/run-slot-acquisition.js";
 import { dropPendingRunSlot, enqueuePendingRunSlot } from "./harness/run/run-queue.js";
-import { getDefaultHostAgentId, resolveSelectedAgentId, routeAgentId } from "./harness/run/routing.js";
+import { getDefaultRuntimeEntryAgentId, resolveSelectedAgentId, routeAgentId } from "./harness/run/routing.js";
 import { resolveStoreFromConfig, } from "./harness/run/resources.js";
 import { createToolMcpServerFromTools, serveToolsOverStdioFromHarness } from "../mcp.js";
-import { getBindingAdapterKind } from "./support/compiled-binding.js";
+import { getBindingRuntimeExecutionMode, } from "./support/compiled-binding.js";
 import { bindingSupportsRunningReplay, getWorkspaceBinding, resolveWorkspaceAgentTools, } from "./harness/bindings.js";
 import { describeWorkspaceInventory, listAgentSkills as listWorkspaceAgentSkills, } from "./harness/system/inventory.js";
 import { createDefaultHealthSnapshot, isInventoryEnabled, isThreadMemorySyncEnabled, } from "./harness/runtime-defaults.js";
@@ -48,8 +48,8 @@ export class AgentHarnessRuntime {
     stores = new Map();
     embeddingModels = new Map();
     vectorStores = new Map();
-    hostBindings;
-    defaultHostBinding;
+    runtimeEntryBindings;
+    defaultRuntimeEntryBinding;
     defaultRunRootValue;
     defaultStore;
     runtimeMemoryStore;
@@ -74,8 +74,8 @@ export class AgentHarnessRuntime {
     defaultRunRoot() {
         return this.defaultRunRootValue;
     }
-    getDefaultHostAgentId() {
-        return getDefaultHostAgentId(this.workspace, this.routingDefaultAgentId);
+    getDefaultRuntimeEntryAgentId() {
+        return getDefaultRuntimeEntryAgentId(this.workspace, this.routingDefaultAgentId);
     }
     async resolveSelectedAgentId(input, requestedAgentId, threadId) {
         return resolveSelectedAgentId({
@@ -83,7 +83,7 @@ export class AgentHarnessRuntime {
             input,
             requestedAgentId,
             threadId,
-            preferredHostAgentId: this.routingDefaultAgentId,
+            preferredRuntimeEntryAgentId: this.routingDefaultAgentId,
             getThreadSummary: (currentThreadId) => this.getSession(currentThreadId),
         });
     }
@@ -100,16 +100,16 @@ export class AgentHarnessRuntime {
     constructor(workspace, runtimeAdapterOptions = {}) {
         this.workspace = workspace;
         this.runtimeAdapterOptions = runtimeAdapterOptions;
-        this.hostBindings = inferRoutingBindings(this.workspace).hostBindings;
-        this.defaultHostBinding = this.hostBindings[0];
-        this.defaultRunRootValue = this.defaultHostBinding?.harnessRuntime.runRoot ?? `${this.workspace.workspaceRoot}/run-data`;
+        this.runtimeEntryBindings = inferRoutingBindings(this.workspace).runtimeEntryBindings;
+        this.defaultRuntimeEntryBinding = this.runtimeEntryBindings[0];
+        this.defaultRunRootValue = this.defaultRuntimeEntryBinding?.harnessRuntime.runRoot ?? `${this.workspace.workspaceRoot}/run-data`;
         const runRoot = this.defaultRunRoot();
         this.persistence = new SqlitePersistence(runRoot);
-        const defaultStoreConfig = this.defaultHostBinding?.harnessRuntime.store;
+        const defaultStoreConfig = this.defaultRuntimeEntryBinding?.harnessRuntime.store;
         this.defaultStore = resolveStoreFromConfig(this.stores, defaultStoreConfig, runRoot) ?? new FileBackedStore(`${runRoot}/store.json`);
-        const runtimeMemoryStoreConfig = typeof this.defaultHostBinding?.harnessRuntime.runtimeMemory?.store === "object" &&
-            this.defaultHostBinding?.harnessRuntime.runtimeMemory?.store
-            ? this.defaultHostBinding.harnessRuntime.runtimeMemory.store
+        const runtimeMemoryStoreConfig = typeof this.defaultRuntimeEntryBinding?.harnessRuntime.runtimeMemory?.store === "object" &&
+            this.defaultRuntimeEntryBinding?.harnessRuntime.runtimeMemory?.store
+            ? this.defaultRuntimeEntryBinding.harnessRuntime.runtimeMemory.store
             : undefined;
         this.runtimeMemoryStore = resolveStoreFromConfig(this.stores, runtimeMemoryStoreConfig, runRoot) ?? this.defaultStore;
         this.resolvedRuntimeAdapterOptions = resolveRuntimeAdapterOptions({
@@ -438,7 +438,7 @@ export class AgentHarnessRuntime {
                 agentId: activeBinding.agent.id,
                 requestedAgentId: defaultRequestedAgentId(options.agentId),
                 selectedAgentId: activeSelectedAgentId,
-                executionMode: getBindingAdapterKind(activeBinding),
+                executionMode: getBindingRuntimeExecutionMode(activeBinding),
             }),
         });
         await runCreatedEventPromise;

package/dist/runtime/parsing/index.d.ts

@@ -1,2 +1,3 @@
 export { extractReasoningText, extractToolFallbackContext, extractVisibleOutput, hasToolCalls, isLikelyToolArgsObject, readTextContent, sanitizeVisibleText, tryParseJson, wrapResolvedModel, } from "./output-parsing.js";
-export { extractAgentStep, extractInterruptPayload, extractReasoningStreamOutput, extractTerminalStreamOutput, extractToolResult, normalizeTerminalOutputKey, readStreamDelta, type RuntimeStreamChunk, } from "./stream-event-parsing.js";
+export { extractInterruptPayload, extractReasoningStreamOutput, extractTerminalStreamOutput, extractToolResult, normalizeTerminalOutputKey, readStreamDelta, type RuntimeStreamChunk, } from "./stream-event-parsing.js";
+export type { CompatibleStreamPart, NormalizedUpstreamEvent, UpstreamRuntimeEvent, } from "./stream-event-types.js";

package/dist/runtime/parsing/index.js

@@ -1,2 +1,2 @@
 export { extractReasoningText, extractToolFallbackContext, extractVisibleOutput, hasToolCalls, isLikelyToolArgsObject, readTextContent, sanitizeVisibleText, tryParseJson, wrapResolvedModel, } from "./output-parsing.js";
-export { extractAgentStep, extractInterruptPayload, extractReasoningStreamOutput, extractTerminalStreamOutput, extractToolResult, normalizeTerminalOutputKey, readStreamDelta, } from "./stream-event-parsing.js";
+export { extractInterruptPayload, extractReasoningStreamOutput, extractTerminalStreamOutput, extractToolResult, normalizeTerminalOutputKey, readStreamDelta, } from "./stream-event-parsing.js";

package/dist/runtime/parsing/stream-event-parsing.d.ts

@@ -1,4 +1,4 @@
-import type { CompatibleStreamPart, UpstreamRuntimeEvent } from "../../contracts/types.js";
+import type { CompatibleStreamPart, UpstreamRuntimeEvent } from "./stream-event-types.js";
 export type RuntimeStreamChunk = {
     kind: "upstream-event";
     event: UpstreamRuntimeEvent;
@@ -26,7 +26,6 @@ export declare function extractTerminalStreamOutput(event: unknown): string;
 export declare function extractReasoningStreamOutput(event: unknown): string;
 export declare function extractVisibleStreamOutput(event: unknown): string;
 export declare function extractStateStreamOutput(event: unknown): string;
-export declare function extractAgentStep(event: unknown): string | null;
 export declare function extractToolResult(event: unknown): {
     toolName: string;
     output: unknown;

package/dist/runtime/parsing/stream-event-parsing.js

@@ -129,15 +129,6 @@ function normalizeUpstreamEventShape(event) {
             ...(nodeName ? { nodeName } : {}),
         };
     }
-    const agentStep = extractAgentStep(event.raw);
-    if (agentStep) {
-        return {
-            kind: "agent-step",
-            label: agentStep,
-            ...(ns && ns.length > 0 ? { ns } : {}),
-            ...(nodeName ? { nodeName } : {}),
-        };
-    }
     return {
         kind: "run-event",
         eventName: event.event ?? "unknown",
@@ -230,25 +221,6 @@ export function extractCustomCompatibleStreamPart(event) {
         data: custom.data,
     };
 }
-function formatStepValue(value, maxLength = 120) {
-    if (value == null)
-        return "";
-    const normalized = typeof value === "string"
-        ? parseMaybeJson(value)
-        : value;
-    const summarized = summarizeStepValue(normalized);
-    const serialized = typeof summarized === "string"
-        ? summarized
-        : (() => {
-            try {
-                return JSON.stringify(summarized);
-            }
-            catch {
-                return String(summarized);
-            }
-        })();
-    return serialized.length > maxLength ? serialized.slice(0, maxLength) + "…" : serialized;
-}
 function parseMaybeJson(value) {
     const trimmed = value.trim();
     if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) {
@@ -261,26 +233,6 @@ function parseMaybeJson(value) {
         return value;
     }
 }
-function summarizeStepValue(value) {
-    if (typeof value !== "object" || !value) {
-        return value;
-    }
-    const record = value;
-    if (typeof record.url === "string" && typeof record.status === "number") {
-        const warnings = Array.isArray(record.warnings) ? record.warnings.filter((item) => typeof item === "string") : [];
-        return {
-            status: record.status,
-            ok: record.ok,
-            quality: record.quality,
-            source: record.source,
-            warnings,
-        };
-    }
-    return value;
-}
-function humanizeEventName(name) {
-    return name.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[._-]+/g, " ").replace(/\s+/g, " ").trim().toLowerCase();
-}
 function readToolErrorText(value) {
     if (typeof value === "string") {
         return value;
@@ -352,57 +304,6 @@ export function extractStateStreamOutput(event) {
     }
     return extractVisibleOutput(chunk);
 }
-export function extractAgentStep(event) {
-    if (typeof event !== "object" || !event)
-        return null;
-    const typed = event;
-    const name = typeof typed.name === "string" ? typed.name : "";
-    if (typed.event === "on_tool_start" || (typed.event === "on_chain_start" && typed.run_type === "tool")) {
-        const inputSummary = formatStepValue(typed.data?.input);
-        return inputSummary ? `tool ${name || "tool"}  ${inputSummary}` : `tool ${name || "tool"}`;
-    }
-    if (typed.event === "on_tool_end" || (typed.event === "on_chain_end" && typed.run_type === "tool")) {
-        const outputSummary = formatStepValue(typed.data?.output, 80);
-        return outputSummary ? `tool ${name || "tool"} done  ${outputSummary}` : `tool ${name || "tool"} done`;
-    }
-    if (typed.event === "on_tool_error" || (typed.event === "on_chain_error" && typed.run_type === "tool")) {
-        const errorSummary = formatStepValue(typed.data?.error ?? typed.data?.output, 80);
-        return errorSummary ? `tool ${name || "tool"} error  ${errorSummary}` : `tool ${name || "tool"} error`;
-    }
-    if (typed.event === "on_chat_model_start") {
-        const inputTools = typed.data?.input?.tools;
-        const tools = typed.invocation_params?.tools ?? inputTools ?? [];
-        const toolNames = tools.map((tool) => tool.name ?? tool.function?.name).filter((toolName) => typeof toolName === "string").join(", ");
-        return toolNames ? `calling model  tools: [${toolNames}]` : "calling model…";
-    }
-    if (typed.event === "on_chain_start") {
-        if (/SkillsMiddleware/i.test(name))
-            return "loading skills…";
-        if (/MemoryMiddleware/i.test(name))
-            return "loading memory…";
-        if (/patchToolCallsMiddleware/i.test(name))
-            return "normalizing tool calls…";
-        if (/HumanInTheLoopMiddleware/i.test(name))
-            return "checking approvals…";
-        if (/todoListMiddleware/i.test(name))
-            return "updating plan…";
-        if (/model_request/i.test(name))
-            return "preparing model request…";
-        if (/RunnableLambda/i.test(name) || /^__start__$/.test(name))
-            return null;
-        if (/(subagent|specialist)/i.test(name))
-            return `starting ${humanizeEventName(name)}…`;
-        if (/agent$/i.test(name))
-            return `running ${humanizeEventName(name)}…`;
-    }
-    if (typed.event === "on_chain_end") {
-        if (/(subagent|specialist)/i.test(name))
-            return `${humanizeEventName(name)} done`;
-        if (/agent$/i.test(name) && !/^__start__$/.test(name))
-            return `${humanizeEventName(name)} done`;
-    }
-    return null;
-}
 export function extractToolResult(event) {
     if (typeof event !== "object" || !event)
         return null;

package/dist/runtime/parsing/stream-event-types.d.ts

@@ -0,0 +1,62 @@
+export type NormalizedUpstreamEvent = {
+    kind: "text-delta";
+    source: "model" | "state";
+    text: string;
+    ns?: string[];
+    nodeName?: string;
+} | {
+    kind: "reasoning-delta";
+    text: string;
+    ns?: string[];
+    nodeName?: string;
+} | {
+    kind: "tool-start";
+    toolName: string;
+    input?: unknown;
+    ns?: string[];
+    nodeName?: string;
+} | {
+    kind: "tool-end";
+    toolName: string;
+    output?: unknown;
+    isError?: boolean;
+    ns?: string[];
+    nodeName?: string;
+} | {
+    kind: "interrupt";
+    interrupt: unknown;
+    ns?: string[];
+    nodeName?: string;
+} | {
+    kind: "run-event";
+    eventName: string;
+    data?: Record<string, unknown>;
+    ns?: string[];
+    nodeName?: string;
+};
+export type CompatibleStreamPart = {
+    type: "messages";
+    ns: string[];
+    data: [unknown, Record<string, unknown>];
+} | {
+    type: "updates";
+    ns: string[];
+    data: Record<string, unknown>;
+} | {
+    type: "custom";
+    ns: string[];
+    data: unknown;
+};
+export type UpstreamRuntimeEvent = {
+    format: "langgraph-v2";
+    normalized: NormalizedUpstreamEvent;
+    streamPart: CompatibleStreamPart;
+    raw: unknown;
+    event?: string;
+    name?: string;
+    runType?: string;
+    data?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    tags?: string[];
+    ns?: string[];
+};

package/dist/runtime/parsing/stream-event-types.js

@@ -0,0 +1 @@
+export {};

package/dist/runtime/support/compiled-binding.d.ts

@@ -1,8 +1,8 @@
-import type { CompiledAgentBinding, CompiledModel, CompiledSubAgent, CompiledTool, DeepAgentParams, LangChainAgentParams } from "../../contracts/types.js";
+import type { CompiledAgentBinding, CompiledExecutionBinding, CompiledModel, CompiledSubAgent, CompiledTool, DeepAgentParams, LegacyDeepAgentParams, LegacyLangChainAgentParams, LangChainAgentParams } from "../../contracts/types.js";
 export type BindingExecutionView = {
     adapterKind: string;
-    langchainParams?: LangChainAgentParams;
-    deepAgentParams?: DeepAgentParams;
+    langchainParams?: LegacyLangChainAgentParams;
+    deepAgentParams?: LegacyDeepAgentParams;
     executionParams?: LangChainAgentParams | DeepAgentParams;
     primaryTools: CompiledTool[];
     primaryModel?: CompiledModel;
@@ -17,8 +17,10 @@ export type BindingExecutionView = {
 };
 export declare function getBindingExecutionView(binding: CompiledAgentBinding): BindingExecutionView;
 export declare function getBindingAdapterKind(binding: CompiledAgentBinding): string;
-export declare function getBindingLangChainParams(binding: CompiledAgentBinding): LangChainAgentParams | undefined;
-export declare function getBindingDeepAgentParams(binding: CompiledAgentBinding): DeepAgentParams | undefined;
+export declare function getBindingCanonicalExecution(binding: CompiledAgentBinding): CompiledExecutionBinding | undefined;
+export declare function getBindingRuntimeExecutionMode(binding: CompiledAgentBinding): string;
+export declare function getBindingLangChainParams(binding: CompiledAgentBinding): LegacyLangChainAgentParams | undefined;
+export declare function getBindingDeepAgentParams(binding: CompiledAgentBinding): LegacyDeepAgentParams | undefined;
 export declare function getBindingExecutionParams(binding: CompiledAgentBinding): LangChainAgentParams | DeepAgentParams | undefined;
 export declare function getBindingExecutionKind(binding: CompiledAgentBinding): "langchain-v1" | "deepagent" | undefined;
 export declare function withUpdatedBindingExecutionParams(binding: CompiledAgentBinding, updater: (params: LangChainAgentParams | DeepAgentParams) => LangChainAgentParams | DeepAgentParams): CompiledAgentBinding;