@botbotgo/agent-harness 0.0.125 → 0.0.127

package/README.md

@@ -281,9 +281,9 @@ const result = await run(runtime, {
 });
 ```
 
-`run(runtime, { ... })` creates or continues a persisted thread and returns `threadId`, `runId`, `state`, and compact text `output`. Richer upstream result shapes stay available through `outputContent`, `contentBlocks`, and `structuredResponse`.
+`run(runtime, { ... })` creates or continues a persisted session and returns `sessionId`, `requestId`, `state`, and compact text `output`. Richer upstream result shapes stay available through `outputContent`, `contentBlocks`, and `structuredResponse`.
 
-Use `listRuns(runtime)` and `getRun(runtime, runId)` when a product needs a run-centric operations surface such as a review queue or execution dashboard.
+Use `listRequests(runtime)` and `getRequest(runtime, requestId)` when a product needs a request-centric operations surface such as a review queue or execution dashboard.
 
 Use `invocation` as the runtime-facing request envelope:
 
@@ -334,19 +334,19 @@ The runtime event stream includes:
 - `approval.resolved`
 - `output.delta`
 
-### Inspect Threads And Approvals
+### Inspect Sessions And Approvals
 
 ```ts
 import {
+  getSession,
   getApproval,
-  getThread,
+  listSessions,
   listApprovals,
-  listThreads,
   resolveApproval,
 } from "@botbotgo/agent-harness";
 
-const threads = await listThreads(runtime);
-const thread = await getThread(runtime, threads[0]!.threadId);
+const sessions = await listSessions(runtime);
+const session = await getSession(runtime, sessions[0]!.sessionId);
 const approvals = await listApprovals(runtime, { status: "pending" });
 const approval = approvals[0] ? await getApproval(runtime, approvals[0].approvalId) : null;
 
@@ -690,11 +690,11 @@ Primary exports:
 - `run`
 - `resolveApproval`
 - `subscribe`
-- `listRuns`
-- `getRun`
-- `listThreads`
-- `getThread`
-- `deleteThread`
+- `listRequests`
+- `getRequest`
+- `listSessions`
+- `getSession`
+- `deleteSession`
 - `listApprovals`
 - `getApproval`
 - `createToolMcpServer`

package/README.zh.md

@@ -281,9 +281,9 @@ const result = await run(runtime, {
 });
 ```
 
-`run(runtime, { ... })` 会创建或延续持久化线程，并返回 `threadId`、`runId`、`state` 以及紧凑文本 `output`。更丰富的上游结果形态仍可通过 `outputContent`、`contentBlocks`、`structuredResponse` 等获得。
+`run(runtime, { ... })` 会创建或延续持久化会话，并返回 `sessionId`、`requestId`、`state` 以及紧凑文本 `output`。更丰富的上游结果形态仍可通过 `outputContent`、`contentBlocks`、`structuredResponse` 等获得。
 
-如果产品需要 run 视角的操作界面，例如 review queue 或执行看板，可使用 `listRuns(runtime)` 与 `getRun(runtime, runId)`。
+如果产品需要 request 视角的操作界面，例如 review queue 或执行看板，可使用 `listRequests(runtime)` 与 `getRequest(runtime, requestId)`。
 
 将 `invocation` 作为面向运行时的请求信封：
 
@@ -339,14 +339,14 @@ const result = await run(runtime, {
 ```ts
 import {
   getApproval,
-  getThread,
+  getSession,
   listApprovals,
-  listThreads,
+  listSessions,
   resolveApproval,
 } from "@botbotgo/agent-harness";
 
-const threads = await listThreads(runtime);
-const thread = await getThread(runtime, threads[0]!.threadId);
+const sessions = await listSessions(runtime);
+const session = await getSession(runtime, sessions[0]!.sessionId);
 const approvals = await listApprovals(runtime, { status: "pending" });
 const approval = approvals[0] ? await getApproval(runtime, approvals[0].approvalId) : null;
 
@@ -687,11 +687,11 @@ spec:
 - `run`
 - `resolveApproval`
 - `subscribe`
-- `listRuns`
-- `getRun`
-- `listThreads`
-- `getThread`
-- `deleteThread`
+- `listRequests`
+- `getRequest`
+- `listSessions`
+- `getSession`
+- `deleteSession`
 - `listApprovals`
 - `getApproval`
 - `createToolMcpServer`

package/dist/api.d.ts

@@ -1,10 +1,39 @@
-import type { ApprovalRecord, CancelOptions, RunRecord, RunOptions, RunSummary, ResumeOptions, RuntimeHealthSnapshot, RuntimeAdapterOptions, ThreadSummary, ThreadRecord, WorkspaceLoadOptions } from "./contracts/types.js";
+import type { CancelOptions, RequestRecord, RequestSummary, ResumeOptions, RunDecisionOptions, RunResult, RunStartOptions, RuntimeHealthSnapshot, RuntimeAdapterOptions, SessionRecord, SessionSummary, 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";
 import type { ToolMcpServerOptions } from "./mcp.js";
 export { AgentHarnessRuntime } from "./runtime/harness.js";
 export { createUpstreamTimelineReducer } from "./upstream-events.js";
+type PublicApprovalRecord = {
+    approvalId: string;
+    pendingActionId: string;
+    sessionId: string;
+    requestId: string;
+    toolName: string;
+    status: "pending" | "approved" | "edited" | "rejected" | "expired";
+    requestedAt: string;
+    resolvedAt: string | null;
+    allowedDecisions: Array<"approve" | "edit" | "reject">;
+    inputPreview: Record<string, unknown>;
+};
+type PublicApprovalFilter = {
+    status?: PublicApprovalRecord["status"];
+    sessionId?: string;
+    requestId?: string;
+};
+type PublicRunStartOptions = Omit<RunStartOptions, "threadId"> & {
+    sessionId?: string;
+};
+type PublicRunDecisionOptions = Omit<RunDecisionOptions, "threadId" | "runId"> & {
+    sessionId: string;
+    requestId?: string;
+};
+type PublicRunOptions = PublicRunStartOptions | PublicRunDecisionOptions;
+type PublicRunResult = Omit<RunResult, "threadId" | "runId"> & {
+    sessionId: string;
+    requestId: string;
+};
 type CreateAgentHarnessOptions = {
     /**
      * Workspace loading behavior.
@@ -15,23 +44,33 @@ type CreateAgentHarnessOptions = {
 };
 export declare function createAgentHarness(): Promise<AgentHarnessRuntime>;
 export declare function createAgentHarness(workspaceRoot: string, options?: CreateAgentHarnessOptions): Promise<AgentHarnessRuntime>;
-export declare function run(runtime: AgentHarnessRuntime, options: RunOptions): Promise<import("./contracts/runtime.js").RunResult>;
+export declare function run(runtime: AgentHarnessRuntime, options: PublicRunOptions): Promise<PublicRunResult>;
 export declare function subscribe(runtime: AgentHarnessRuntime, listener: Parameters<AgentHarnessRuntime["subscribe"]>[0]): () => void;
-export declare function listThreads(runtime: AgentHarnessRuntime, filter?: Parameters<AgentHarnessRuntime["listThreads"]>[0]): Promise<ThreadSummary[]>;
-export declare function listRuns(runtime: AgentHarnessRuntime, filter?: Parameters<AgentHarnessRuntime["listRuns"]>[0]): Promise<RunSummary[]>;
-export declare function getThread(runtime: AgentHarnessRuntime, threadId: string): Promise<ThreadRecord | null>;
-export declare function getRun(runtime: AgentHarnessRuntime, runId: string): Promise<RunRecord | null>;
-export declare function deleteThread(runtime: AgentHarnessRuntime, threadId: string): Promise<boolean>;
-export declare function listApprovals(runtime: AgentHarnessRuntime, filter?: Parameters<AgentHarnessRuntime["listApprovals"]>[0]): Promise<ApprovalRecord[]>;
-export declare function getApproval(runtime: AgentHarnessRuntime, approvalId: string): Promise<ApprovalRecord | null>;
+export declare function listSessions(runtime: AgentHarnessRuntime, filter?: Parameters<AgentHarnessRuntime["listThreads"]>[0]): Promise<SessionSummary[]>;
+export declare function listRequests(runtime: AgentHarnessRuntime, filter?: {
+    agentId?: string;
+    sessionId?: string;
+    state?: RequestSummary["state"];
+}): Promise<RequestSummary[]>;
+export declare function getSession(runtime: AgentHarnessRuntime, sessionId: string): Promise<SessionRecord | null>;
+export declare function getRequest(runtime: AgentHarnessRuntime, requestId: string): Promise<RequestRecord | null>;
+export declare function deleteSession(runtime: AgentHarnessRuntime, sessionId: string): Promise<boolean>;
+export declare function listApprovals(runtime: AgentHarnessRuntime, filter?: PublicApprovalFilter): Promise<PublicApprovalRecord[]>;
+export declare function getApproval(runtime: AgentHarnessRuntime, approvalId: string): Promise<PublicApprovalRecord | null>;
 export declare function getHealth(runtime: AgentHarnessRuntime): Promise<RuntimeHealthSnapshot>;
 export declare function listAgentSkills(runtime: AgentHarnessRuntime, agentId: string, options?: RequirementAssessmentOptions): InventorySkillRecord[];
+export declare function getAgent(runtime: AgentHarnessRuntime, agentId: string, options?: RequirementAssessmentOptions): InventoryAgentRecord | null;
 export declare function describeInventory(runtime: AgentHarnessRuntime, options?: RequirementAssessmentOptions): {
     workspaceRoot: string;
     agents: InventoryAgentRecord[];
 };
-export declare function resolveApproval(runtime: AgentHarnessRuntime, options: ResumeOptions): Promise<import("./contracts/runtime.js").RunResult>;
-export declare function cancelRun(runtime: AgentHarnessRuntime, options: CancelOptions): Promise<import("./contracts/runtime.js").RunResult>;
+export declare function resolveApproval(runtime: AgentHarnessRuntime, options: ResumeOptions & {
+    sessionId?: string;
+    requestId?: string;
+}): Promise<PublicRunResult>;
+export declare function cancelRun(runtime: AgentHarnessRuntime, options: CancelOptions & {
+    requestId?: string;
+}): Promise<RunResult>;
 export declare function stop(runtime: AgentHarnessRuntime): Promise<void>;
 export declare function createToolMcpServer(runtime: AgentHarnessRuntime, options: ToolMcpServerOptions): Promise<import("@modelcontextprotocol/sdk/server/mcp.js").McpServer>;
 export declare function serveToolsOverStdio(runtime: AgentHarnessRuntime, options: ToolMcpServerOptions): Promise<import("@modelcontextprotocol/sdk/server/mcp.js").McpServer>;

package/dist/api.js

@@ -2,6 +2,108 @@ import { AgentHarnessRuntime } from "./runtime/harness.js";
 import { loadWorkspace } from "./workspace/compile.js";
 export { AgentHarnessRuntime } from "./runtime/harness.js";
 export { createUpstreamTimelineReducer } from "./upstream-events.js";
+function toSessionSummary(summary) {
+    return {
+        agentId: summary.agentId,
+        sessionId: summary.threadId,
+        latestRequestId: summary.latestRunId,
+        createdAt: summary.createdAt,
+        updatedAt: summary.updatedAt,
+        status: summary.status,
+    };
+}
+function toRequestSummary(summary) {
+    return {
+        requestId: summary.runId,
+        sessionId: summary.threadId,
+        agentId: summary.agentId,
+        executionMode: summary.executionMode,
+        adapterKind: summary.adapterKind,
+        createdAt: summary.createdAt,
+        updatedAt: summary.updatedAt,
+        state: summary.state,
+        checkpointRef: summary.checkpointRef,
+        resumable: summary.resumable,
+    };
+}
+function toSessionRecord(record) {
+    return {
+        sessionId: record.threadId,
+        entryAgentId: record.entryAgentId,
+        currentState: record.currentState,
+        latestRequestId: record.latestRunId,
+        createdAt: record.createdAt,
+        updatedAt: record.updatedAt,
+        messages: record.messages,
+        requests: record.runs.map(toRequestSummary),
+        pendingDecision: record.pendingDecision,
+    };
+}
+function toRequestRecord(record) {
+    return toRequestSummary(record);
+}
+function toApprovalRecord(record) {
+    return {
+        approvalId: record.approvalId,
+        pendingActionId: record.pendingActionId,
+        sessionId: record.threadId,
+        requestId: record.runId,
+        toolName: record.toolName,
+        status: record.status,
+        requestedAt: record.requestedAt,
+        resolvedAt: record.resolvedAt,
+        allowedDecisions: record.allowedDecisions,
+        inputPreview: record.inputPreview,
+    };
+}
+function toPublicRunResult(result) {
+    return {
+        sessionId: result.threadId,
+        requestId: result.runId,
+        state: result.state,
+        output: result.output,
+        finalMessageText: result.finalMessageText,
+        outputContent: result.outputContent,
+        contentBlocks: result.contentBlocks,
+        structuredResponse: result.structuredResponse,
+        interruptContent: result.interruptContent,
+        agentId: result.agentId,
+        approvalId: result.approvalId,
+        pendingActionId: result.pendingActionId,
+        delegationId: result.delegationId,
+        artifacts: result.artifacts,
+        metadata: result.metadata,
+    };
+}
+function toInternalRunOptions(options) {
+    if ("decision" in options) {
+        return {
+            approvalId: options.approvalId,
+            decision: options.decision,
+            editedInput: options.editedInput,
+            listeners: options.listeners,
+            runId: options.requestId,
+            threadId: options.sessionId,
+        };
+    }
+    return {
+        agentId: options.agentId,
+        input: options.input,
+        invocation: options.invocation,
+        listeners: options.listeners,
+        priority: options.priority,
+        threadId: options.sessionId,
+    };
+}
+function toInternalResumeOptions(options) {
+    return {
+        approvalId: options.approvalId,
+        decision: options.decision,
+        editedInput: options.editedInput,
+        runId: options.requestId ?? options.runId,
+        threadId: options.sessionId ?? options.threadId,
+    };
+}
 export async function createAgentHarness(workspaceRoot = process.cwd(), options = {}) {
     const workspace = await loadWorkspace(workspaceRoot, options.load ?? {});
     const harness = new AgentHarnessRuntime(workspace, options.adapter ?? {});
@@ -9,31 +111,42 @@ export async function createAgentHarness(workspaceRoot = process.cwd(), options
     return harness;
 }
 export async function run(runtime, options) {
-    return runtime.run(options);
+    return toPublicRunResult(await runtime.run(toInternalRunOptions(options)));
 }
 export function subscribe(runtime, listener) {
     return runtime.subscribe(listener);
 }
-export async function listThreads(runtime, filter) {
-    return runtime.listThreads(filter);
+export async function listSessions(runtime, filter) {
+    return (await runtime.listThreads(filter)).map(toSessionSummary);
 }
-export async function listRuns(runtime, filter) {
-    return runtime.listRuns(filter);
+export async function listRequests(runtime, filter) {
+    return (await runtime.listRuns({
+        agentId: filter?.agentId,
+        state: filter?.state,
+        threadId: filter?.sessionId,
+    })).map(toRequestSummary);
 }
-export async function getThread(runtime, threadId) {
-    return runtime.getThread(threadId);
+export async function getSession(runtime, sessionId) {
+    const record = await runtime.getThread(sessionId);
+    return record ? toSessionRecord(record) : null;
 }
-export async function getRun(runtime, runId) {
-    return runtime.getRun(runId);
+export async function getRequest(runtime, requestId) {
+    const record = await runtime.getRun(requestId);
+    return record ? toRequestRecord(record) : null;
 }
-export async function deleteThread(runtime, threadId) {
-    return runtime.deleteThread(threadId);
+export async function deleteSession(runtime, sessionId) {
+    return runtime.deleteThread(sessionId);
 }
 export async function listApprovals(runtime, filter) {
-    return runtime.listApprovals(filter);
+    return (await runtime.listApprovals({
+        runId: filter?.requestId,
+        status: filter?.status,
+        threadId: filter?.sessionId,
+    })).map(toApprovalRecord);
 }
 export async function getApproval(runtime, approvalId) {
-    return runtime.getApproval(approvalId);
+    const record = await runtime.getApproval(approvalId);
+    return record ? toApprovalRecord(record) : null;
 }
 export async function getHealth(runtime) {
     return runtime.getHealth();
@@ -41,14 +154,20 @@ export async function getHealth(runtime) {
 export function listAgentSkills(runtime, agentId, options) {
     return runtime.listAgentSkills(agentId, options);
 }
+export function getAgent(runtime, agentId, options) {
+    return runtime.getAgent(agentId, options);
+}
 export function describeInventory(runtime, options) {
     return runtime.describeWorkspaceInventory(options);
 }
 export async function resolveApproval(runtime, options) {
-    return runtime.resume(options);
+    return toPublicRunResult(await runtime.resume(toInternalResumeOptions(options)));
 }
 export async function cancelRun(runtime, options) {
-    return runtime.cancelRun(options);
+    return runtime.cancelRun({
+        ...options,
+        runId: options.requestId ?? options.runId,
+    });
 }
 export async function stop(runtime) {
     return runtime.stop();

package/dist/contracts/runtime.d.ts

@@ -13,7 +13,10 @@ export type ThreadSummary = {
     updatedAt: string;
     status: RunState;
 };
-export type SessionRecord = ThreadSummary;
+export type SessionSummary = Omit<ThreadSummary, "threadId" | "latestRunId"> & {
+    sessionId: string;
+    latestRequestId: string;
+};
 export type KnownHarnessEventType = "run.created" | "run.queued" | "run.dequeued" | "run.state.changed" | "run.resumed" | "approval.requested" | "approval.resolved" | "artifact.created" | "output.delta" | "runtime.health.changed" | "runtime.synthetic_fallback";
 export type HarnessEventType = KnownHarnessEventType | (string & {});
 /**
@@ -172,6 +175,11 @@ export type ThreadRunRecord = {
  */
 export type RunSummary = ThreadRunRecord;
 export type RunRecord = RunSummary;
+export type RequestSummary = Omit<RunSummary, "threadId" | "runId"> & {
+    sessionId: string;
+    requestId: string;
+};
+export type RequestRecord = RequestSummary;
 /**
  * Persisted thread inspection record assembled from runtime records.
  * This is an inspectable projection, not a second thread semantic model.
@@ -193,6 +201,11 @@ export type ThreadRecord = {
         requestedAt: string;
     };
 };
+export type SessionRecord = Omit<ThreadRecord, "threadId" | "latestRunId" | "runs"> & {
+    sessionId: string;
+    latestRequestId: string;
+    requests: RequestSummary[];
+};
 export type ResumeOptions = {
     threadId?: string;
     runId?: string;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { AgentHarnessRuntime, cancelRun, createAgentHarness, createUpstreamTimelineReducer, createToolMcpServer, deleteThread, describeInventory, getApproval, getHealth, getRun, getThread, listAgentSkills, listApprovals, listRuns, listThreads, resolveApproval, run, serveToolsOverStdio, subscribe, stop, } from "./api.js";
+export { AgentHarnessRuntime, cancelRun, createAgentHarness, createUpstreamTimelineReducer, createToolMcpServer, deleteSession, describeInventory, getAgent, getApproval, getRequest, getHealth, getSession, listAgentSkills, listApprovals, listRequests, listSessions, resolveApproval, run, serveToolsOverStdio, subscribe, stop, } from "./api.js";
 export type { ToolMcpServerOptions } from "./mcp.js";
 export { tool } from "./tools.js";
 export type { UpstreamTimelineProjection, UpstreamTimelineReducer } from "./upstream-events.js";

package/dist/index.js

@@ -1,2 +1,2 @@
-export { AgentHarnessRuntime, cancelRun, createAgentHarness, createUpstreamTimelineReducer, createToolMcpServer, deleteThread, describeInventory, getApproval, getHealth, getRun, getThread, listAgentSkills, listApprovals, listRuns, listThreads, resolveApproval, run, serveToolsOverStdio, subscribe, stop, } from "./api.js";
+export { AgentHarnessRuntime, cancelRun, createAgentHarness, createUpstreamTimelineReducer, createToolMcpServer, deleteSession, describeInventory, getAgent, getApproval, getRequest, getHealth, getSession, listAgentSkills, listApprovals, listRequests, listSessions, resolveApproval, run, serveToolsOverStdio, subscribe, stop, } from "./api.js";
 export { tool } from "./tools.js";

package/dist/package-version.d.ts

@@ -1 +1 @@
-export declare const AGENT_HARNESS_VERSION = "0.0.124";
+export declare const AGENT_HARNESS_VERSION = "0.0.126";

package/dist/package-version.js

@@ -1 +1 @@
-export const AGENT_HARNESS_VERSION = "0.0.124";
+export const AGENT_HARNESS_VERSION = "0.0.126";

package/dist/runtime/harness/system/inventory.d.ts

@@ -17,10 +17,17 @@ export type InventorySkillRecord = {
     openclaw?: OpenClawSkillMetadata;
     requirements?: SkillRequirementAssessment;
 };
+export type InventoryModelRecord = {
+    id: string;
+    provider: string;
+    model: string;
+    baseUrl?: string;
+};
 export type InventoryAgentRecord = {
     id: string;
     description: string;
     parentAgentId?: string;
+    model?: InventoryModelRecord;
     tools: InventoryToolRecord[];
     skills: InventorySkillRecord[];
 };
@@ -29,6 +36,7 @@ export declare function listAgentTools(workspace: WorkspaceBundle, agentId: stri
 export declare function listAgentSkills(workspace: WorkspaceBundle, agentId: string, options?: RequirementAssessmentOptions): InventorySkillRecord[];
 export declare function listSubagents(workspace: WorkspaceBundle, options?: RequirementAssessmentOptions): InventoryAgentRecord[];
 export declare function listAvailableAgents(workspace: WorkspaceBundle, options?: RequirementAssessmentOptions): InventoryAgentRecord[];
+export declare function getAgentInventoryRecord(workspace: WorkspaceBundle, agentId: string, options?: RequirementAssessmentOptions): InventoryAgentRecord | null;
 export declare function describeWorkspaceInventory(workspace: WorkspaceBundle, options?: RequirementAssessmentOptions): {
     workspaceRoot: string;
     agents: InventoryAgentRecord[];

package/dist/runtime/harness/system/inventory.js

@@ -1,5 +1,5 @@
 import { readSkillMetadata } from "../../support/skill-metadata.js";
-import { getBindingBackendConfig, getBindingPrimaryTools, getBindingSkills, getBindingSubagents } from "../../support/compiled-binding.js";
+import { getBindingBackendConfig, getBindingPrimaryModel, getBindingPrimaryTools, getBindingSkills, getBindingSubagents, } from "../../support/compiled-binding.js";
 import { assessSkillRequirements, } from "./skill-requirements.js";
 import { createRuntimeEnv } from "../../support/runtime-env.js";
 function listHostBindings(workspace) {
@@ -60,6 +60,23 @@ function toSkillRecords(skillPaths, options = {}) {
         };
     });
 }
+function toInventoryModelRecord(model) {
+    if (!model) {
+        return undefined;
+    }
+    const init = typeof model.init === "object" && model.init ? model.init : {};
+    const baseUrl = typeof init.baseUrl === "string" && init.baseUrl.trim().length > 0
+        ? init.baseUrl.trim()
+        : typeof init.baseURL === "string" && init.baseURL.trim().length > 0
+            ? init.baseURL.trim()
+            : undefined;
+    return {
+        id: model.id,
+        provider: model.provider,
+        model: model.model,
+        ...(baseUrl ? { baseUrl } : {}),
+    };
+}
 export function listAgentTools(workspace, agentId) {
     const binding = findAgentBinding(workspace, agentId);
     if (!binding) {
@@ -80,6 +97,7 @@ function describeSubagent(subagent, parentAgentId, options = {}) {
         id: subagent.name,
         description: subagent.description,
         parentAgentId,
+        model: toInventoryModelRecord(subagent.model),
         tools: dedupeTools(subagent.tools ?? []),
         skills: toSkillRecords(subagent.skills ?? [], options),
     };
@@ -94,11 +112,15 @@ export function listAvailableAgents(workspace, options = {}) {
     const topLevel = listHostBindings(workspace).map((binding) => ({
         id: binding.agent.id,
         description: binding.agent.description,
+        model: toInventoryModelRecord(getBindingPrimaryModel(binding)),
         tools: listAgentTools(workspace, binding.agent.id),
         skills: listAgentSkills(workspace, binding.agent.id, options),
     }));
     return [...topLevel, ...listSubagents(workspace, options)];
 }
+export function getAgentInventoryRecord(workspace, agentId, options = {}) {
+    return listAvailableAgents(workspace, options).find((agent) => agent.id === agentId) ?? null;
+}
 export function describeWorkspaceInventory(workspace, options = {}) {
     return {
         workspaceRoot: workspace.workspaceRoot,

package/dist/runtime/harness.d.ts

@@ -66,6 +66,7 @@ export declare class AgentHarnessRuntime {
     }): Promise<ApprovalRecord[]>;
     getApproval(approvalId: string): Promise<ApprovalRecord | null>;
     listAgentSkills(agentId: string, options?: RequirementAssessmentOptions): InventorySkillRecord[];
+    getAgent(agentId: string, options?: RequirementAssessmentOptions): InventoryAgentRecord | null;
     describeWorkspaceInventory(options?: RequirementAssessmentOptions): {
         workspaceRoot: string;
         agents: InventoryAgentRecord[];

package/dist/runtime/harness.js

@@ -23,7 +23,7 @@ import { resolveStoreFromConfig, } from "./harness/run/resources.js";
 import { createToolMcpServerFromTools, serveToolsOverStdioFromHarness } from "../mcp.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 { describeWorkspaceInventory, getAgentInventoryRecord, listAgentSkills as listWorkspaceAgentSkills, } from "./harness/system/inventory.js";
 import { createDefaultHealthSnapshot, isInventoryEnabled, isThreadMemorySyncEnabled, } from "./harness/runtime-defaults.js";
 import { resolveRuntimeAdapterOptions } from "./support/runtime-adapter-options.js";
 import { initializeHarnessRuntime, reclaimExpiredClaimedRuns as reclaimHarnessExpiredClaimedRuns, recoverStartupRuns as recoverHarnessStartupRuns, isStaleRunningRun as isHarnessStaleRunningRun, } from "./harness/run/startup-runtime.js";
@@ -220,6 +220,12 @@ export class AgentHarnessRuntime {
             ...options,
         });
     }
+    getAgent(agentId, options = {}) {
+        return getAgentInventoryRecord(this.workspace, agentId, {
+            assessRequirements: isInventoryEnabled(this.workspace),
+            ...options,
+        });
+    }
     describeWorkspaceInventory(options = {}) {
         return describeWorkspaceInventory(this.workspace, {
             assessRequirements: isInventoryEnabled(this.workspace),

package/package.json

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