@botbotgo/agent-harness 0.0.190 → 0.0.191

package/README.md

@@ -34,6 +34,7 @@
 <p align="center">
   <a href="./LICENSE">License</a> · <a href="./CONTRIBUTING.md">Contributing</a> ·
   <a href="./SECURITY.md">Security</a> · <a href="./CODE_OF_CONDUCT.md">Code of Conduct</a>
+  · <a href="https://github.com/sponsors/botbotgo">Sponsorship</a>
 </p>
 
 <p align="center">
@@ -984,5 +985,5 @@ ACP transport notes:
 - `exportRequestPackage(...)` and `exportSessionPackage(...)` package stable runtime records, transcript, approvals, events, and artifacts for operator tooling without reaching into persistence internals.
 - `runtime/default.governance.remoteMcp` can now deny or allow specific MCP servers, raise approval requirements by transport, and stamp transport-based risk tiers into runtime governance bundles. MCP server catalogs can also declare trust tier, access mode, tenant scope, approval policy, prompt-injection risk, and OAuth scope metadata so governance bundles capture why one remote tool is treated as high-risk.
 - `runtime/default.observability.tracing` can now describe exporter metadata such as OTLP endpoints and propagation mode, so frozen runtime snapshots keep trace-correlation plus operator-visible export context without exposing backend-private span internals.
-- `agent-harness runtime health`, `agent-harness runtime approvals list|watch`, and `agent-harness runtime runs list|tail` provide a thin operator CLI over persisted runtime health, approval queues, and active run state.
+- `agent-harness runtime overview`, `agent-harness runtime health`, `agent-harness runtime approvals list|watch`, and `agent-harness runtime runs list|tail` provide a thin operator CLI over persisted runtime health, queue pressure, governance risk, approval queues, and active run state.
 - detailed A2A adapter guidance lives in [`docs/a2a-bridge.md`](docs/a2a-bridge.md)

package/README.zh.md

@@ -34,6 +34,7 @@
 <p align="center">
   <a href="./LICENSE">许可证</a> · <a href="./CONTRIBUTING.md">贡献指南</a> ·
   <a href="./SECURITY.md">安全说明</a> · <a href="./CODE_OF_CONDUCT.md">行为准则</a>
+  · <a href="https://github.com/sponsors/botbotgo">赞助支持</a>
 </p>
 
 <p align="center">
@@ -943,5 +944,5 @@ ACP transport 说明：
 - `exportRequestPackage(...)` 与 `exportSessionPackage(...)` 可把稳定 runtime 记录、transcript、approvals、events 和 artifacts 打包给 operator tooling，而不必直接访问 persistence 内部实现。
 - `runtime/default.governance.remoteMcp` 现在可以按 MCP server 或 transport 做 allow/deny、审批升级，并把 transport 风险等级写进 runtime governance bundles。MCP server catalog 也可以声明 trust tier、access mode、tenant scope、approval policy、prompt-injection risk 与 OAuth scope 元数据，让治理快照能解释为什么某个远端工具被视为高风险。
 - `runtime/default.observability.tracing` 现在可描述 OTLP endpoint 和 propagation mode 这类 exporter 元数据，使冻结的 runtime snapshot 在保留 trace correlation 的同时，也能保留对 operator 有意义的导出上下文，而不暴露 backend 私有 span 细节。
-- `agent-harness runtime health`、`agent-harness runtime approvals list|watch` 与 `agent-harness runtime runs list|tail` 提供了一层轻量 operator CLI，可直接查看 runtime health、审批队列和运行状态。
+- `agent-harness runtime overview`、`agent-harness runtime health`、`agent-harness runtime approvals list|watch` 与 `agent-harness runtime runs list|tail` 提供了一层轻量 operator CLI，可直接查看 runtime health、queue pressure、governance risk、审批队列和运行状态。
 - 更详细的 A2A 适配层开发说明见 [`docs/a2a-bridge.md`](docs/a2a-bridge.md)

package/dist/api.d.ts

@@ -1,4 +1,4 @@
-import type { ArtifactListing, CancelOptions, InvocationEnvelope, ListMemoriesInput, ListMemoriesResult, MemoryRecord, MemorizeInput, MemorizeResult, MessageContent, RecallInput, RecallResult, RemoveMemoryInput, RequestRecord, RequestSummary, ResumeOptions, RunDecisionOptions, RunListeners, RunResult, RunStartOptions, RuntimeHealthSnapshot, RuntimeAdapterOptions, RuntimeEvaluationExport, RuntimeEvaluationExportInput, RuntimeEvaluationReplayInput, RuntimeEvaluationReplayResult as InternalRuntimeEvaluationReplayResult, RuntimeSessionPackage, RuntimeSessionPackageInput, SessionRecord, SessionSummary, TranscriptMessage, UpdateMemoryInput, WorkspaceLoadOptions } from "./contracts/types.js";
+import type { ArtifactListing, CancelOptions, InvocationEnvelope, ListMemoriesInput, ListMemoriesResult, MemoryRecord, MemorizeInput, MemorizeResult, MessageContent, RecallInput, RecallResult, RemoveMemoryInput, RequestRecord, RequestSummary, ResumeOptions, RunDecisionOptions, RunListeners, RunResult, RunStartOptions, RuntimeHealthSnapshot, RuntimeGovernanceDiagnostics, RuntimeOperatorOverview, RuntimeQueueDiagnostics, RuntimeAdapterOptions, RuntimeEvaluationExport, RuntimeEvaluationExportInput, RuntimeEvaluationReplayInput, RuntimeEvaluationReplayResult as InternalRuntimeEvaluationReplayResult, RuntimeSessionPackage, RuntimeSessionPackageInput, SessionRecord, SessionSummary, TranscriptMessage, UpdateMemoryInput, WorkspaceLoadOptions } from "./contracts/types.js";
 import { AgentHarnessRuntime } from "./runtime/harness.js";
 import type { InventoryAgentRecord, InventorySkillRecord } from "./runtime/harness/system/inventory.js";
 import type { RequirementAssessmentOptions } from "./runtime/harness/system/skill-requirements.js";
@@ -72,6 +72,19 @@ export type RequestPackage = {
 export type RuntimeEvaluationReplayResult = Omit<InternalRuntimeEvaluationReplayResult, "result"> & {
     result: PublicRunResult;
 };
+export type OperatorOverview = Omit<RuntimeOperatorOverview, "approvals" | "runs"> & {
+    approvals: {
+        total: number;
+        items: Approval[];
+    };
+    runs: {
+        total: number;
+        states: Partial<Record<RequestSummary["state"], number>>;
+        items: RequestSummary[];
+    };
+    queue: RuntimeQueueDiagnostics;
+    governance: RuntimeGovernanceDiagnostics;
+};
 type PublicApprovalFilter = {
     status?: Approval["status"];
     sessionId?: string;
@@ -144,6 +157,9 @@ export declare function listRequestEvents(runtime: AgentHarnessRuntime, input: {
     requestId: string;
 }): Promise<RequestEvent[]>;
 export declare function getHealth(runtime: AgentHarnessRuntime): Promise<RuntimeHealthSnapshot>;
+export declare function getOperatorOverview(runtime: AgentHarnessRuntime, options?: {
+    limit?: number;
+}): Promise<OperatorOverview>;
 export declare function exportRequestPackage(runtime: AgentHarnessRuntime, input: RequestPackageInput): Promise<RequestPackage>;
 export declare function exportSessionPackage(runtime: AgentHarnessRuntime, input: RuntimeSessionPackageInput): Promise<RuntimeSessionPackage>;
 export declare function exportEvaluationBundle(runtime: AgentHarnessRuntime, input: RuntimeEvaluationExportInput): Promise<RuntimeEvaluationExport>;

package/dist/api.js

@@ -134,6 +134,26 @@ function toInternalResumeOptions(options) {
         threadId: options.sessionId ?? options.threadId,
     };
 }
+function toPublicRequestSummary(run) {
+    return {
+        requestId: run.runId,
+        sessionId: run.threadId,
+        agentId: run.agentId,
+        executionMode: run.executionMode,
+        adapterKind: run.adapterKind,
+        createdAt: run.createdAt,
+        updatedAt: run.updatedAt,
+        state: run.state,
+        checkpointRef: run.checkpointRef,
+        resumable: run.resumable,
+        startedAt: run.startedAt,
+        endedAt: run.endedAt,
+        lastActivityAt: run.lastActivityAt,
+        currentAgentId: run.currentAgentId,
+        delegationChain: run.delegationChain,
+        runtimeSnapshot: run.runtimeSnapshot,
+    };
+}
 export async function createAgentHarness(workspaceRoot = process.cwd(), options = {}) {
     const workspace = await loadWorkspace(workspaceRoot, options.load ?? {});
     const harness = new AgentHarnessRuntime(workspace, options.adapter ?? {});
@@ -207,6 +227,21 @@ export async function listRequestEvents(runtime, input) {
 export async function getHealth(runtime) {
     return runtime.getHealth();
 }
+export async function getOperatorOverview(runtime, options) {
+    const overview = await runtime.getOperatorOverview(options);
+    return {
+        ...overview,
+        approvals: {
+            total: overview.approvals.total,
+            items: overview.approvals.items.map(toApprovalRecord),
+        },
+        runs: {
+            total: overview.runs.total,
+            states: overview.runs.states,
+            items: overview.runs.items.map(toPublicRequestSummary),
+        },
+    };
+}
 export async function exportRequestPackage(runtime, input) {
     return toRequestPackage(await runtime.exportRequestPackage(input));
 }

package/dist/cli.js

@@ -14,6 +14,7 @@ function renderUsage() {
   agent-harness acp serve [--workspace <path>] [--transport stdio|http] [--host <hostname>] [--port <port>]
   agent-harness a2a serve [--workspace <path>] [--host <hostname>] [--port <port>]
   agent-harness ag-ui serve [--workspace <path>] [--host <hostname>] [--port <port>]
+  agent-harness runtime overview [--workspace <path>] [--limit <n>] [--json]
   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]
@@ -161,16 +162,17 @@ function parseRuntimeInspectOptions(args) {
     let json = false;
     let once = false;
     let pollMs = 1000;
+    let limit = 5;
     let status;
     let state;
     let agentId;
     let threadId;
     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") {
+        if (arg === "--workspace" || arg === "--status" || arg === "--state" || arg === "--agent" || arg === "--thread" || arg === "--poll-ms" || arg === "--limit") {
             const value = args[index + 1];
             if (!value) {
-                return { json, once, pollMs, status, state, agentId, threadId, error: `Missing value for ${arg}` };
+                return { json, once, pollMs, limit, status, state, agentId, threadId, error: `Missing value for ${arg}` };
             }
             if (arg === "--workspace") {
                 workspaceRoot = value;
@@ -187,10 +189,17 @@ function parseRuntimeInspectOptions(args) {
             else if (arg === "--thread") {
                 threadId = 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}` };
+                }
+                limit = parsedLimit;
+            }
             else {
                 const parsedPoll = Number.parseInt(value, 10);
                 if (!Number.isFinite(parsedPoll) || parsedPoll <= 0) {
-                    return { json, once, pollMs, status, state, agentId, threadId, error: `Invalid poll interval: ${value}` };
+                    return { json, once, pollMs, limit, status, state, agentId, threadId, error: `Invalid poll interval: ${value}` };
                 }
                 pollMs = parsedPoll;
             }
@@ -205,9 +214,9 @@ function parseRuntimeInspectOptions(args) {
             once = true;
             continue;
         }
-        return { workspaceRoot, json, once, pollMs, status, state, agentId, threadId, error: `Unknown option: ${arg}` };
+        return { workspaceRoot, json, once, pollMs, limit, status, state, agentId, threadId, error: `Unknown option: ${arg}` };
     }
-    return { workspaceRoot, json, once, pollMs, status, state, agentId, threadId };
+    return { workspaceRoot, json, once, pollMs, limit, status, state, agentId, threadId };
 }
 function renderJson(value) {
     return `${JSON.stringify(value, null, 2)}\n`;
@@ -302,6 +311,42 @@ function renderRunList(runs) {
         return `${runId} thread=${threadId} agent=${agentId}${currentAgent} state=${state}${resumable}${updated}${lastActivity}`;
     }).join("\n") + "\n";
 }
+function renderOperatorOverview(overview, workspacePath) {
+    const lines = [];
+    const summary = typeof overview.summary === "string" ? overview.summary : "";
+    lines.push(`Runtime overview ${workspacePath}`);
+    if (summary) {
+        lines.push(`Summary: ${summary}`);
+    }
+    const health = isObject(overview.health) ? overview.health : {};
+    if (Object.keys(health).length > 0) {
+        lines.push("");
+        lines.push(renderHealthSnapshot(health, workspacePath).trimEnd());
+    }
+    const queue = isObject(overview.queue) ? overview.queue : {};
+    if (Object.keys(queue).length > 0) {
+        lines.push("");
+        lines.push(`Queue: ${typeof queue.summary === "string" ? queue.summary : "unavailable"}`);
+    }
+    const governance = isObject(overview.governance) ? overview.governance : {};
+    if (Object.keys(governance).length > 0) {
+        lines.push("Governance:");
+        lines.push(`  - ${typeof governance.summary === "string" ? governance.summary : "unavailable"}`);
+    }
+    const approvals = isObject(overview.approvals) ? overview.approvals : {};
+    const approvalItems = Array.isArray(approvals.items) ? approvals.items.filter(isObject) : [];
+    lines.push(`Pending approvals: ${typeof approvals.total === "number" ? approvals.total : approvalItems.length}`);
+    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());
+    }
+    return `${lines.join("\n")}\n`;
+}
 export async function runCli(argv, io = {}, deps = {}) {
     const cwd = io.cwd ?? process.cwd();
     const stdout = io.stdout ?? ((message) => process.stdout.write(message));
@@ -496,6 +541,12 @@ export async function runCli(argv, io = {}, deps = {}) {
                 await runtime.stop();
                 return 0;
             }
+            if (subcommand === "overview") {
+                const overview = await runtime.getOperatorOverview({ limit: parsed.limit });
+                stdout(parsed.json ? renderJson(overview) : renderOperatorOverview(overview, workspacePath));
+                await runtime.stop();
+                return 0;
+            }
             if (subcommand === "approvals" && (nestedCommand === "list" || nestedCommand === "watch")) {
                 const renderApprovals = async () => {
                     const approvals = await runtime.listApprovals(parsed.status ? { status: parsed.status } : undefined);

package/dist/contracts/runtime.d.ts

@@ -70,6 +70,31 @@ export type RuntimeQueueDiagnostics = {
     queueEvents: RuntimeTimelineItem[];
     summary: string;
 };
+export type RuntimeGovernanceDiagnostics = {
+    runsWithGovernance: number;
+    highRiskTools: number;
+    approvalRequiredTools: number;
+    untrustedMcpTools: number;
+    crossTenantTools: number;
+    writeAccessMcpTools: number;
+    summary: string;
+};
+export type RuntimeOperatorOverview = {
+    updatedAt: string;
+    summary: string;
+    health: RuntimeHealthSnapshot;
+    queue: RuntimeQueueDiagnostics;
+    approvals: {
+        total: number;
+        items: ApprovalRecord[];
+    };
+    runs: {
+        total: number;
+        states: Partial<Record<RunState, number>>;
+        items: RunSummary[];
+    };
+    governance: RuntimeGovernanceDiagnostics;
+};
 export type RuntimeToolExecutionToolPolicy = {
     toolId: string;
     name: string;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export { AgentHarnessAcpServer, AgentHarnessRuntime, buildFlowGraph, cancelRun, createAgentHarness, createAcpServer, createRuntimeMcpServer, createUpstreamTimelineReducer, createToolMcpServer, deleteSession, describeInventory, exportEvaluationBundle, exportRequestPackage, exportSessionPackage, replayEvaluationBundle, getArtifact, getAgent, getApproval, getRequest, getHealth, listMemories, getSession, listAgentSkills, listArtifacts, listApprovals, listRequests, listRequestEvents, listSessions, memorize, normalizeUserChatInput, request, recall, removeMemory, resolveApproval, serveA2aHttp, serveAcpHttp, serveAcpStdio, serveAgUiHttp, serveRuntimeMcpOverStdio, serveToolsOverStdio, subscribe, stop, updateMemory, exportFlowGraphToMermaid, exportFlowGraphToSequenceMermaid, } from "./api.js";
+export { AgentHarnessAcpServer, AgentHarnessRuntime, buildFlowGraph, cancelRun, createAgentHarness, createAcpServer, createRuntimeMcpServer, createUpstreamTimelineReducer, createToolMcpServer, deleteSession, describeInventory, exportEvaluationBundle, exportRequestPackage, exportSessionPackage, replayEvaluationBundle, getArtifact, getAgent, getApproval, getOperatorOverview, getRequest, getHealth, listMemories, getSession, listAgentSkills, listArtifacts, listApprovals, listRequests, listRequestEvents, listSessions, memorize, normalizeUserChatInput, request, recall, removeMemory, resolveApproval, serveA2aHttp, serveAcpHttp, serveAcpStdio, serveAgUiHttp, serveRuntimeMcpOverStdio, serveToolsOverStdio, subscribe, stop, updateMemory, exportFlowGraphToMermaid, exportFlowGraphToSequenceMermaid, } from "./api.js";
 export type { AcpApproval, AcpArtifact, AcpEventNotification, AcpJsonRpcError, AcpJsonRpcRequest, AcpJsonRpcResponse, AcpJsonRpcSuccess, AcpRequestRecord, AcpRunRequestParams, AcpServerCapabilities, AcpSessionRecord, } from "./acp.js";
-export type { Approval, ListMemoriesInput, ListMemoriesResult, MemoryDecision, MemoryKind, MemoryRecord, MemoryScope, MemorizeInput, MemorizeResult, NormalizeUserChatInputOptions, PublicRunListeners, RequestArtifactListing, RequestEvent, RequestEventType, RequestPackage, RequestPackageInput, RequestResult, RequestUpstreamEventItem, RecallInput, RecallResult, RemoveMemoryInput, RuntimeEvaluationExport, RuntimeEvaluationExportInput, RuntimeEvaluationReplayInput, RuntimeEvaluationReplayResult, RuntimeSessionPackage, RuntimeSessionPackageInput, UpdateMemoryInput, UserChatInput, UserChatMessage, } from "./api.js";
+export type { Approval, ListMemoriesInput, ListMemoriesResult, MemoryDecision, MemoryKind, MemoryRecord, MemoryScope, MemorizeInput, MemorizeResult, NormalizeUserChatInputOptions, OperatorOverview, PublicRunListeners, RequestArtifactListing, RequestEvent, RequestEventType, RequestPackage, RequestPackageInput, RequestResult, RequestUpstreamEventItem, RecallInput, RecallResult, RemoveMemoryInput, RuntimeEvaluationExport, RuntimeEvaluationExportInput, RuntimeEvaluationReplayInput, RuntimeEvaluationReplayResult, RuntimeSessionPackage, RuntimeSessionPackageInput, UpdateMemoryInput, UserChatInput, UserChatMessage, } from "./api.js";
 export type { BuildFlowGraphInput, FlowEdge, FlowEdgeKind, FlowGraph, FlowGraphMermaidOptions, FlowGraphSequenceMermaidOptions, FlowGroup, FlowGroupKind, FlowNode, FlowNodeKind, FlowNodeLayer, FlowNodeStatus, } from "./flow/index.js";
 export type { A2aAgentCard, A2aHttpServer, A2aHttpServerOptions, A2aTask, A2aTaskState, AcpHttpServer, AcpHttpServerOptions, AcpStdioServer, AcpStdioServerOptions, AgUiEvent, AgUiHttpServer, AgUiHttpServerOptions, AgUiRunAgentInput, } from "./api.js";
 export type { RuntimeMcpServerOptions, ToolMcpServerOptions } from "./mcp.js";

package/dist/index.js

@@ -1,2 +1,2 @@
-export { AgentHarnessAcpServer, AgentHarnessRuntime, buildFlowGraph, cancelRun, createAgentHarness, createAcpServer, createRuntimeMcpServer, createUpstreamTimelineReducer, createToolMcpServer, deleteSession, describeInventory, exportEvaluationBundle, exportRequestPackage, exportSessionPackage, replayEvaluationBundle, getArtifact, getAgent, getApproval, getRequest, getHealth, listMemories, getSession, listAgentSkills, listArtifacts, listApprovals, listRequests, listRequestEvents, listSessions, memorize, normalizeUserChatInput, request, recall, removeMemory, resolveApproval, serveA2aHttp, serveAcpHttp, serveAcpStdio, serveAgUiHttp, serveRuntimeMcpOverStdio, serveToolsOverStdio, subscribe, stop, updateMemory, exportFlowGraphToMermaid, exportFlowGraphToSequenceMermaid, } from "./api.js";
+export { AgentHarnessAcpServer, AgentHarnessRuntime, buildFlowGraph, cancelRun, createAgentHarness, createAcpServer, createRuntimeMcpServer, createUpstreamTimelineReducer, createToolMcpServer, deleteSession, describeInventory, exportEvaluationBundle, exportRequestPackage, exportSessionPackage, replayEvaluationBundle, getArtifact, getAgent, getApproval, getOperatorOverview, getRequest, getHealth, listMemories, getSession, listAgentSkills, listArtifacts, listApprovals, listRequests, listRequestEvents, listSessions, memorize, normalizeUserChatInput, request, recall, removeMemory, resolveApproval, serveA2aHttp, serveAcpHttp, serveAcpStdio, serveAgUiHttp, serveRuntimeMcpOverStdio, serveToolsOverStdio, subscribe, stop, updateMemory, exportFlowGraphToMermaid, exportFlowGraphToSequenceMermaid, } from "./api.js";
 export { tool } from "./tools.js";

package/dist/package-version.d.ts

@@ -1 +1 @@
-export declare const AGENT_HARNESS_VERSION = "0.0.189";
+export declare const AGENT_HARNESS_VERSION = "0.0.190";

package/dist/package-version.js

@@ -1 +1 @@
-export const AGENT_HARNESS_VERSION = "0.0.189";
+export const AGENT_HARNESS_VERSION = "0.0.190";

package/dist/runtime/harness/run/operator-overview.d.ts

@@ -0,0 +1,7 @@
+import type { ApprovalRecord, RunSummary, RuntimeOperatorOverview, RuntimeHealthSnapshot } from "../../../contracts/types.js";
+export declare function projectOperatorOverview(input: {
+    health: RuntimeHealthSnapshot;
+    runs: RunSummary[];
+    approvals: ApprovalRecord[];
+    limit?: number;
+}): RuntimeOperatorOverview;

package/dist/runtime/harness/run/operator-overview.js

@@ -0,0 +1,73 @@
+import { projectQueueDiagnostics } from "./queue-diagnostics.js";
+const ACTIVE_RUN_STATES = new Set([
+    "queued",
+    "claimed",
+    "running",
+    "waiting_for_approval",
+    "resuming",
+    "cancelling",
+]);
+function sortNewestFirst(items, selectTimestamp) {
+    return [...items].sort((left, right) => {
+        const leftTs = selectTimestamp(left) ?? "";
+        const rightTs = selectTimestamp(right) ?? "";
+        return rightTs.localeCompare(leftTs);
+    });
+}
+function summarizeStates(runs) {
+    const states = {};
+    for (const run of runs) {
+        states[run.state] = (states[run.state] ?? 0) + 1;
+    }
+    return states;
+}
+function collectGovernanceToolPolicies(runs) {
+    return runs.flatMap((run) => run.runtimeSnapshot?.governance?.bundles ?? [])
+        .flatMap((bundle) => bundle.toolPolicies);
+}
+function projectGovernanceDiagnostics(runs) {
+    const toolPolicies = collectGovernanceToolPolicies(runs);
+    const highRiskTools = toolPolicies.filter((tool) => tool.risk === "high").length;
+    const approvalRequiredTools = toolPolicies.filter((tool) => tool.requiresApproval).length;
+    const untrustedMcpTools = toolPolicies.filter((tool) => tool.mcpTrustTier === "untrusted").length;
+    const crossTenantTools = toolPolicies.filter((tool) => tool.tenantScope === "cross-tenant").length;
+    const writeAccessMcpTools = toolPolicies.filter((tool) => tool.category === "mcp" && tool.mcpAccess === "read-write").length;
+    return {
+        runsWithGovernance: runs.filter((run) => (run.runtimeSnapshot?.governance?.bundles?.length ?? 0) > 0).length,
+        highRiskTools,
+        approvalRequiredTools,
+        untrustedMcpTools,
+        crossTenantTools,
+        writeAccessMcpTools,
+        summary: `highRisk=${highRiskTools} ` +
+            `approvalRequired=${approvalRequiredTools} ` +
+            `untrusted=${untrustedMcpTools} ` +
+            `crossTenant=${crossTenantTools}`,
+    };
+}
+export function projectOperatorOverview(input) {
+    const limit = typeof input.limit === "number" && Number.isFinite(input.limit) && input.limit > 0 ? Math.floor(input.limit) : 5;
+    const activeRuns = sortNewestFirst(input.runs.filter((run) => ACTIVE_RUN_STATES.has(run.state)), (run) => run.lastActivityAt ?? run.updatedAt);
+    const pendingApprovals = sortNewestFirst(input.approvals.filter((approval) => approval.status === "pending"), (approval) => approval.requestedAt);
+    const queue = projectQueueDiagnostics(input.health, []);
+    const governance = projectGovernanceDiagnostics(activeRuns);
+    return {
+        updatedAt: input.health.updatedAt,
+        summary: `${queue.summary} ` +
+            `pendingApprovals=${pendingApprovals.length} ` +
+            `activeRuns=${activeRuns.length} ` +
+            `${governance.summary}`,
+        health: input.health,
+        queue,
+        approvals: {
+            total: pendingApprovals.length,
+            items: pendingApprovals.slice(0, limit),
+        },
+        runs: {
+            total: activeRuns.length,
+            states: summarizeStates(activeRuns),
+            items: activeRuns.slice(0, limit),
+        },
+        governance,
+    };
+}

package/dist/runtime/harness.d.ts

@@ -1,4 +1,4 @@
-import type { ApprovalRecord, ArtifactListing, CancelOptions, HarnessEvent, HarnessStreamItem, RuntimeHealthSnapshot, ListMemoriesInput, ListMemoriesResult, MessageContent, RemoveMemoryInput, RunRecord, RunStartOptions, RestartConversationOptions, RuntimeAdapterOptions, RuntimeEvaluationExport, RuntimeEvaluationExportInput, RuntimeEvaluationReplayInput, RuntimeEvaluationReplayResult, RuntimeRunPackage, RuntimeRunPackageInput, RuntimeSessionPackage, RuntimeSessionPackageInput, ResumeOptions, RunOptions, RunResult, RunSummary, MemoryRecord, MemorizeInput, MemorizeResult, RecallInput, RecallResult, UpdateMemoryInput, SessionSummary, ThreadSummary, ThreadRecord, SessionRecord, RequestRecord, RequestSummary, WorkspaceBundle } from "../contracts/types.js";
+import type { ApprovalRecord, ArtifactListing, CancelOptions, HarnessEvent, HarnessStreamItem, RuntimeHealthSnapshot, RuntimeOperatorOverview, ListMemoriesInput, ListMemoriesResult, MessageContent, RemoveMemoryInput, RunRecord, RunStartOptions, RestartConversationOptions, RuntimeAdapterOptions, RuntimeEvaluationExport, RuntimeEvaluationExportInput, RuntimeEvaluationReplayInput, RuntimeEvaluationReplayResult, RuntimeRunPackage, RuntimeRunPackageInput, RuntimeSessionPackage, RuntimeSessionPackageInput, ResumeOptions, RunOptions, RunResult, RunSummary, MemoryRecord, MemorizeInput, MemorizeResult, RecallInput, RecallResult, UpdateMemoryInput, SessionSummary, ThreadSummary, ThreadRecord, SessionRecord, RequestRecord, RequestSummary, WorkspaceBundle } from "../contracts/types.js";
 import { type RuntimeMcpServerOptions, type ToolMcpServerOptions } from "../mcp.js";
 import { type InventoryAgentRecord, type InventorySkillRecord } from "./harness/system/inventory.js";
 import type { RequirementAssessmentOptions } from "./harness/system/skill-requirements.js";
@@ -60,6 +60,9 @@ export declare class AgentHarnessRuntime {
     initialize(): Promise<void>;
     subscribe(listener: (event: HarnessEvent) => void): () => void;
     getHealth(): Promise<RuntimeHealthSnapshot>;
+    getOperatorOverview(options?: {
+        limit?: number;
+    }): Promise<RuntimeOperatorOverview>;
     listSessions(filter?: {
         agentId?: string;
     }): Promise<SessionSummary[]>;

package/dist/runtime/harness.js

@@ -18,6 +18,7 @@ import { appendAssistantMessage as appendLifecycleAssistantMessage, finalizeCanc
 import { createListenerDispatchRuntime } from "./harness/events/listener-runtime.js";
 import { buildResumePayload as buildHarnessResumePayload, resolveApprovalRecord as resolveHarnessApprovalRecord, } from "./harness/run/resume.js";
 import { cancelRunOperation, executeQueuedRunOperation, resumeRun } from "./harness/run/run-operations.js";
+import { projectOperatorOverview } from "./harness/run/operator-overview.js";
 import { acquireRunSlot as acquireHarnessRunSlot } from "./harness/run/run-slot-acquisition.js";
 import { dropPendingRunSlot, enqueuePendingRunSlot } from "./harness/run/run-queue.js";
 import { getDefaultRuntimeEntryAgentId, resolveSelectedAgentId, routeAgentId } from "./harness/run/routing.js";
@@ -286,6 +287,19 @@ export class AgentHarnessRuntime {
         }
         return createDefaultHealthSnapshot(this.activeRunSlots, this.pendingRunSlots.length);
     }
+    async getOperatorOverview(options) {
+        const [health, runs, approvals] = await Promise.all([
+            this.getHealth(),
+            this.listRuns(),
+            this.listApprovals(),
+        ]);
+        return projectOperatorOverview({
+            health,
+            runs,
+            approvals,
+            limit: options?.limit,
+        });
+    }
     async listSessions(filter) {
         const sessions = await this.persistence.listSessions(filter);
         return sessions.map((session) => ({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botbotgo/agent-harness",
-  "version": "0.0.190",
+  "version": "0.0.191",
   "description": "Workspace runtime for multi-agent applications",
   "license": "MIT",
   "type": "module",