@botbotgo/agent-harness 0.0.130 → 0.0.132

package/README.md

@@ -114,6 +114,8 @@ Boundary documents live in:
 - `docs/acp-support-plan.md`
 - `docs/recovery-policy-matrix.md`
 - `docs/operator-timeline.md`
+- `docs/queue-concurrency-inspection.md`
+- `docs/tool-execution-policy.md`
 - `docs/feature-checklist.md`
 - `docs/long-term-memory.md`
 - `docs/app-task-pattern.md`

package/README.zh.md

@@ -114,6 +114,8 @@ AI 让 agent 逻辑、工具调用和工作流代码更容易生成，真正变
 - `docs/acp-support-plan.md`
 - `docs/recovery-policy-matrix.md`
 - `docs/operator-timeline.md`
+- `docs/queue-concurrency-inspection.md`
+- `docs/tool-execution-policy.md`
 - `docs/feature-checklist.md`
 - `docs/long-term-memory.md`
 - `docs/app-task-pattern.md`

package/dist/contracts/runtime.d.ts

@@ -59,6 +59,46 @@ export type RuntimeTimelineProjectionOptions = {
     threadId?: string;
     runId?: string;
 };
+export type RuntimeQueueDiagnostics = {
+    status: HealthStatus;
+    activeRunSlots: number;
+    pendingRunSlots: number;
+    stuckRuns: number;
+    queueEvents: RuntimeTimelineItem[];
+    summary: string;
+};
+export type RuntimeToolExecutionToolPolicy = {
+    toolId: string;
+    name: string;
+    retryable: boolean;
+    hasInputSchema: boolean;
+    requiresApproval: boolean;
+};
+/**
+ * Operator-facing projection of tool execution policy already compiled into a binding.
+ * This summarizes existing timeout, retry, validation, and retry-safety hints without
+ * introducing a second tool framework or stronger guarantees than the runtime provides.
+ */
+export type RuntimeToolExecutionPolicy = {
+    agentId: string;
+    invokeTimeoutMs?: number;
+    streamIdleTimeoutMs: number;
+    providerRetries: {
+        maxAttempts: number;
+        backoffMs: number;
+        retryableMessages: string[];
+    };
+    validation: {
+        schemaBoundToolCount: number;
+        allToolsHaveSchemas: boolean;
+    };
+    idempotencyHints: {
+        replayEligible: boolean;
+        retryableToolCount: number;
+        nonRetryableToolCount: number;
+    };
+    tools: RuntimeToolExecutionToolPolicy[];
+};
 export type RuntimeEventSink = {
     publish: (event: HarnessEvent) => void;
     subscribe: (listener: HarnessEventListener) => () => void;

package/dist/package-version.d.ts

@@ -1 +1 @@
-export declare const AGENT_HARNESS_VERSION = "0.0.129";
+export declare const AGENT_HARNESS_VERSION = "0.0.131";

package/dist/package-version.js

@@ -1 +1 @@
-export const AGENT_HARNESS_VERSION = "0.0.129";
+export const AGENT_HARNESS_VERSION = "0.0.131";

package/dist/runtime/harness/bindings.d.ts

@@ -1,4 +1,4 @@
-import type { CompiledTool, RuntimeAdapterOptions, WorkspaceBundle } from "../../contracts/types.js";
+import type { CompiledTool, RuntimeAdapterOptions, RuntimeToolExecutionPolicy, WorkspaceBundle } from "../../contracts/types.js";
 type Binding = WorkspaceBundle["bindings"] extends Map<any, infer T> ? T : never;
 export declare function getWorkspaceBinding(workspace: WorkspaceBundle, agentId: string): Binding | undefined;
 export declare function getRequiredWorkspaceBinding(workspace: WorkspaceBundle, agentId: string): Binding;
@@ -11,4 +11,9 @@ export declare function resolveWorkspaceAgentTools(input: {
     resolvedTool: unknown;
 }>;
 export declare function bindingSupportsRunningReplay(binding: Binding): boolean;
+export declare function projectBindingToolExecutionPolicy(binding: Binding): RuntimeToolExecutionPolicy;
+export declare function projectWorkspaceAgentToolExecutionPolicy(input: {
+    workspace: WorkspaceBundle;
+    agentId: string;
+}): RuntimeToolExecutionPolicy;
 export {};

package/dist/runtime/harness/bindings.js

@@ -1,3 +1,4 @@
+import { resolveBindingTimeout, resolveProviderRetryPolicy, resolveStreamIdleTimeout } from "../adapter/resilience.js";
 import { getBindingPrimaryTools } from "../support/compiled-binding.js";
 export function getWorkspaceBinding(workspace, agentId) {
     return workspace.bindings.get(agentId);
@@ -21,3 +22,33 @@ export function resolveWorkspaceAgentTools(input) {
 export function bindingSupportsRunningReplay(binding) {
     return getBindingPrimaryTools(binding).every((tool) => tool.retryable === true);
 }
+export function projectBindingToolExecutionPolicy(binding) {
+    const tools = getBindingPrimaryTools(binding);
+    const projectedTools = tools.map((tool) => ({
+        toolId: tool.id,
+        name: tool.name,
+        retryable: tool.retryable === true,
+        hasInputSchema: typeof tool.inputSchemaRef === "string" && tool.inputSchemaRef.trim().length > 0,
+        requiresApproval: tool.hitl?.enabled === true,
+    }));
+    const retryableToolCount = projectedTools.filter((tool) => tool.retryable).length;
+    return {
+        agentId: binding.agent.id,
+        invokeTimeoutMs: resolveBindingTimeout(binding),
+        streamIdleTimeoutMs: resolveStreamIdleTimeout(binding) ?? 60_000,
+        providerRetries: resolveProviderRetryPolicy(binding),
+        validation: {
+            schemaBoundToolCount: projectedTools.filter((tool) => tool.hasInputSchema).length,
+            allToolsHaveSchemas: projectedTools.length > 0 && projectedTools.every((tool) => tool.hasInputSchema),
+        },
+        idempotencyHints: {
+            replayEligible: bindingSupportsRunningReplay(binding),
+            retryableToolCount,
+            nonRetryableToolCount: projectedTools.length - retryableToolCount,
+        },
+        tools: projectedTools,
+    };
+}
+export function projectWorkspaceAgentToolExecutionPolicy(input) {
+    return projectBindingToolExecutionPolicy(getRequiredWorkspaceBinding(input.workspace, input.agentId));
+}

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

@@ -2,8 +2,10 @@ export * from "./events/event-bus.js";
 export * from "./events/event-sink.js";
 export * from "./events/events.js";
 export * from "./events/timeline.js";
+export * from "./bindings.js";
 export * from "./system/health-monitor.js";
 export * from "./run/helpers.js";
+export * from "./run/queue-diagnostics.js";
 export * from "./system/inventory.js";
 export * from "./system/policy-engine.js";
 export * from "./run/resources.js";

package/dist/runtime/harness/index.js

@@ -2,8 +2,10 @@ export * from "./events/event-bus.js";
 export * from "./events/event-sink.js";
 export * from "./events/events.js";
 export * from "./events/timeline.js";
+export * from "./bindings.js";
 export * from "./system/health-monitor.js";
 export * from "./run/helpers.js";
+export * from "./run/queue-diagnostics.js";
 export * from "./system/inventory.js";
 export * from "./system/policy-engine.js";
 export * from "./run/resources.js";

package/dist/runtime/harness/run/queue-diagnostics.d.ts

@@ -0,0 +1,2 @@
+import type { RuntimeHealthSnapshot, RuntimeQueueDiagnostics, RuntimeTimelineItem } from "../../../contracts/types.js";
+export declare function projectQueueDiagnostics(snapshot: RuntimeHealthSnapshot, timeline: readonly RuntimeTimelineItem[]): RuntimeQueueDiagnostics;

package/dist/runtime/harness/run/queue-diagnostics.js

@@ -0,0 +1,15 @@
+export function projectQueueDiagnostics(snapshot, timeline) {
+    const queueEvents = timeline.filter((item) => item.kind === "queue" || item.kind === "recovery");
+    const summary = `active=${snapshot.stats.activeRunSlots} ` +
+        `pending=${snapshot.stats.pendingRunSlots} ` +
+        `stuck=${snapshot.stats.stuckRuns} ` +
+        `workload=${snapshot.checks.workload.status}`;
+    return {
+        status: snapshot.checks.workload.status,
+        activeRunSlots: snapshot.stats.activeRunSlots,
+        pendingRunSlots: snapshot.stats.pendingRunSlots,
+        stuckRuns: snapshot.stats.stuckRuns,
+        queueEvents,
+        summary,
+    };
+}

package/package.json

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