@botbotgo/agent-harness 0.0.89 → 0.0.90

package/dist/contracts/types.d.ts

@@ -200,7 +200,7 @@ export type CompiledAgentBinding = {
     harnessRuntime: {
         runRoot: string;
         workspaceRoot?: string;
-        hostFacing: boolean;
+        runtimeEntry: boolean;
         capabilities?: RuntimeCapabilities;
         resilience?: Record<string, unknown>;
         checkpointer?: Record<string, unknown> | boolean;

package/dist/package-version.d.ts

@@ -1 +1 @@
-export declare const AGENT_HARNESS_VERSION = "0.0.88";
+export declare const AGENT_HARNESS_VERSION = "0.0.89";

package/dist/package-version.js

@@ -1 +1 @@
-export const AGENT_HARNESS_VERSION = "0.0.88";
+export const AGENT_HARNESS_VERSION = "0.0.89";

package/dist/runtime/harness.js

@@ -18,6 +18,7 @@ import { HealthMonitor } from "./health-monitor.js";
 import { extractMessageText, normalizeMessageContent } from "../utils/message-content.js";
 import { createToolMcpServerFromTools, serveToolsOverStdioFromHarness } from "../mcp.js";
 import { getBindingAdapterKind, getBindingPrimaryTools, getBindingStoreConfig, isDeepAgentBinding } from "./support/compiled-binding.js";
+import { isRuntimeEntryBinding } from "./support/runtime-entry.js";
 import { describeWorkspaceInventory, listAgentSkills as listWorkspaceAgentSkills, } from "./inventory.js";
 export class AgentHarnessRuntime {
     workspace;
@@ -87,7 +88,7 @@ export class AgentHarnessRuntime {
     }
     getDefaultHostAgentId() {
         const orchestraBinding = this.workspace.bindings.get(AgentHarnessRuntime.DEFAULT_HOST_AGENT_ID);
-        if (orchestraBinding && orchestraBinding.harnessRuntime.hostFacing !== false) {
+        if (orchestraBinding && isRuntimeEntryBinding(orchestraBinding)) {
             return orchestraBinding.agent.id;
         }
         return this.heuristicRoute("");
@@ -119,7 +120,7 @@ export class AgentHarnessRuntime {
             if (threadId) {
                 const thread = await this.getSession(threadId);
                 const threadBinding = thread ? this.workspace.bindings.get(thread.agentId) : undefined;
-                if (thread?.agentId && threadBinding?.harnessRuntime.hostFacing !== false) {
+                if (thread?.agentId && threadBinding && isRuntimeEntryBinding(threadBinding)) {
                     return thread.agentId;
                 }
             }
@@ -394,7 +395,7 @@ export class AgentHarnessRuntime {
         const configuredRule = this.routingRules.find((rule) => matchRoutingRule(rawInput, rule, options));
         if (configuredRule) {
             const configuredBinding = this.workspace.bindings.get(configuredRule.agentId);
-            if (configuredBinding && configuredBinding.harnessRuntime.hostFacing !== false) {
+            if (configuredBinding && isRuntimeEntryBinding(configuredBinding)) {
                 return configuredBinding.agent.id;
             }
         }
@@ -402,7 +403,7 @@ export class AgentHarnessRuntime {
             const defaultBinding = this.routingDefaultAgentId
                 ? this.workspace.bindings.get(this.routingDefaultAgentId)
                 : primaryBinding;
-            if (defaultBinding && defaultBinding.harnessRuntime.hostFacing !== false) {
+            if (defaultBinding && isRuntimeEntryBinding(defaultBinding)) {
                 return defaultBinding.agent.id;
             }
         }

package/dist/runtime/inventory.d.ts

@@ -20,7 +20,7 @@ export type InventorySkillRecord = {
 export type InventoryAgentRecord = {
     id: string;
     description: string;
-    role: "host" | "specialist";
+    role: "runtime-entry" | "specialist";
     tools: InventoryToolRecord[];
     skills: InventorySkillRecord[];
 };

package/dist/runtime/inventory.js

@@ -2,8 +2,9 @@ import { readSkillMetadata } from "./support/skill-metadata.js";
 import { getBindingPrimaryTools } from "./support/compiled-binding.js";
 import { assessSkillRequirements, } from "./skill-requirements.js";
 import { createRuntimeEnv } from "./support/runtime-env.js";
+import { isRuntimeEntryBinding } from "./support/runtime-entry.js";
 function listHostBindings(workspace) {
-    return Array.from(workspace.bindings.values()).filter((binding) => binding.harnessRuntime.hostFacing);
+    return Array.from(workspace.bindings.values()).filter((binding) => isRuntimeEntryBinding(binding));
 }
 export function findAgentBinding(workspace, agentId) {
     return workspace.bindings.get(agentId);
@@ -95,7 +96,7 @@ export function listAvailableAgents(workspace, options = {}) {
     const topLevel = listHostBindings(workspace).map((binding) => ({
         id: binding.agent.id,
         description: binding.agent.description,
-        role: "host",
+        role: "runtime-entry",
         tools: listAgentTools(workspace, binding.agent.id),
         skills: listAgentSkills(workspace, binding.agent.id, options),
     }));

package/dist/runtime/policy-engine.js

@@ -1,11 +1,12 @@
 import { getPolicyEvaluators } from "../extensions.js";
+import { isRuntimeEntryBinding } from "./support/runtime-entry.js";
 export class PolicyEngine {
     evaluate(binding) {
         const reasons = [];
         let allowed = true;
-        if (!binding.harnessRuntime.hostFacing) {
+        if (!isRuntimeEntryBinding(binding)) {
             allowed = false;
-            reasons.push("internal subagents cannot be used as host-facing entrypoints");
+            reasons.push("internal subagents cannot be used as runtime entry agents");
         }
         for (const evaluator of getPolicyEvaluators()) {
             const decision = evaluator.evaluate(binding);

package/dist/runtime/support/harness-support.js

@@ -1,5 +1,6 @@
 import { createPersistentId } from "../../utils/id.js";
 import { isDelegationCapableBinding } from "../../workspace/support/agent-capabilities.js";
+import { isRuntimeEntryBinding } from "./runtime-entry.js";
 export function renderRuntimeFailure(error) {
     const message = error instanceof Error ? error.message : String(error);
     return `runtime_error=${message}`.trim();
@@ -129,9 +130,9 @@ export function createPendingApproval(threadId, runId, checkpointRef, input, int
     };
 }
 export function inferRoutingBindings(workspace) {
-    const hostBindings = Array.from(workspace.bindings.values()).filter((binding) => binding.harnessRuntime.hostFacing);
-    const deepAgentHosts = hostBindings.filter((binding) => binding.agent.executionMode === "deepagent" || Boolean(binding.deepAgentParams));
-    const routingHosts = deepAgentHosts.length > 0 ? deepAgentHosts : hostBindings;
+    const runtimeEntryBindings = Array.from(workspace.bindings.values()).filter((binding) => isRuntimeEntryBinding(binding));
+    const deepAgentHosts = runtimeEntryBindings.filter((binding) => binding.agent.executionMode === "deepagent" || Boolean(binding.deepAgentParams));
+    const routingHosts = deepAgentHosts.length > 0 ? deepAgentHosts : runtimeEntryBindings;
     const researchBinding = routingHosts.find((binding) => binding.agent.id === "research-lite" || binding.agent.id === "research");
     const directBinding = routingHosts.find((binding) => binding.agent.id === "direct");
     const delegationHosts = routingHosts.filter((binding) => isDelegationCapableBinding(binding));
@@ -142,7 +143,7 @@ export function inferRoutingBindings(workspace) {
     const delegationPreferredSecondary = delegationHosts.find((binding) => (binding.deepAgentParams?.subagents.length ?? 0) > 0) ??
         delegationHosts[0];
     const genericLightweightHost = lightweightHosts.find((binding) => binding.agent.id !== researchBinding?.agent.id);
-    const primaryBinding = defaultOrchestratingHost ?? directBinding ?? genericLightweightHost ?? routingHosts[0] ?? hostBindings[0];
+    const primaryBinding = defaultOrchestratingHost ?? directBinding ?? genericLightweightHost ?? routingHosts[0] ?? runtimeEntryBindings[0];
     const secondaryBinding = genericLightweightHost && genericLightweightHost.agent.id !== primaryBinding?.agent.id
         ? genericLightweightHost
         : directBinding && directBinding.agent.id !== primaryBinding?.agent.id
@@ -150,6 +151,6 @@ export function inferRoutingBindings(workspace) {
             : delegationPreferredSecondary && delegationPreferredSecondary.agent.id !== primaryBinding?.agent.id
                 ? delegationPreferredSecondary
                 : routingHosts.find((binding) => binding.agent.id !== primaryBinding?.agent.id) ??
-                    (deepAgentHosts.length > 0 ? undefined : hostBindings.find((binding) => binding.agent.id !== primaryBinding?.agent.id));
-    return { primaryBinding, secondaryBinding, researchBinding, hostBindings };
+                    (deepAgentHosts.length > 0 ? undefined : runtimeEntryBindings.find((binding) => binding.agent.id !== primaryBinding?.agent.id));
+    return { primaryBinding, secondaryBinding, researchBinding, hostBindings: runtimeEntryBindings };
 }

package/dist/runtime/support/runtime-entry.d.ts

@@ -0,0 +1,2 @@
+import type { CompiledAgentBinding } from "../../contracts/types.js";
+export declare function isRuntimeEntryBinding(binding: CompiledAgentBinding): boolean;

package/dist/runtime/support/runtime-entry.js

@@ -0,0 +1,3 @@
+export function isRuntimeEntryBinding(binding) {
+    return binding.harnessRuntime.runtimeEntry;
+}

package/dist/workspace/agent-binding-compiler.js

@@ -263,7 +263,7 @@ export function compileBinding(workspaceRoot, agent, agents, referencedSubagentI
         harnessRuntime: {
             runRoot,
             workspaceRoot,
-            hostFacing: !internalSubagent,
+            runtimeEntry: !internalSubagent,
             capabilities: inferAgentCapabilities(agent),
             resilience,
             ...(checkpointer ? { checkpointer: checkpointer.config } : {}),

package/dist/workspace/compile.js

@@ -71,16 +71,16 @@ function compileBindings(workspaceRoot, refs, agentsList, models, tools) {
     return bindings;
 }
 function validateRoutingTargets(refs, agentsList) {
-    const hostFacingAgentIds = new Set(agentsList
+    const runtimeEntryAgentIds = new Set(agentsList
         .filter((agent) => !agentsList.some((owner) => owner.subagentRefs.some((ref) => resolveRefId(ref) === agent.id)))
         .map((agent) => agent.id));
     const defaultAgentId = getRoutingDefaultAgentId(refs);
-    if (defaultAgentId && !hostFacingAgentIds.has(defaultAgentId)) {
-        throw new Error(`Runtime routing.defaultAgentId references unknown host-facing agent ${defaultAgentId}`);
+    if (defaultAgentId && !runtimeEntryAgentIds.has(defaultAgentId)) {
+        throw new Error(`Runtime routing.defaultAgentId references unknown runtime entry agent ${defaultAgentId}`);
     }
     for (const rule of getRoutingRules(refs)) {
-        if (!hostFacingAgentIds.has(rule.agentId)) {
-            throw new Error(`Runtime routing.rules references unknown host-facing agent ${rule.agentId}`);
+        if (!runtimeEntryAgentIds.has(rule.agentId)) {
+            throw new Error(`Runtime routing.rules references unknown runtime entry agent ${rule.agentId}`);
         }
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botbotgo/agent-harness",
-  "version": "0.0.89",
+  "version": "0.0.90",
   "description": "Workspace runtime for multi-agent applications",
   "type": "module",
   "packageManager": "npm@10.9.2",