@botbotgo/agent-harness 0.0.298 → 0.0.300

package/dist/api.d.ts

@@ -1,4 +1,4 @@
-import type { ArtifactListing, CancelOptions, InvocationEnvelope, ListMemoriesInput, ListMemoriesResult, MemoryRecord, MemorizeInput, MemorizeResult, MessageContent, RecallInput, RecallResult, RemoveMemoryInput, RequestDecisionOptions, RequestRecord, RequestResult as InternalRequestResult, RequestStartOptions, RequestSummary, RuntimeArtifactWriteInput, ResumeOptions, RequestListeners, RuntimeHealthSnapshot, RuntimeGovernanceEvidence, RuntimeGovernanceDiagnostics, RuntimeOperatorOverview, RuntimeQueueDiagnostics, RuntimeAdapterOptions, RuntimeEvaluationExport, RuntimeEvaluationExportInput, RuntimeEvaluationArtifact, RuntimeEvaluationReplayInput, RuntimeEvaluationReplayResult as InternalRuntimeEvaluationReplayResult, RuntimeSessionPackage, RuntimeSessionPackageInput, SessionListSummary, SessionRecord, SessionSummary, TranscriptMessage, UpdateMemoryInput, WorkspaceLoadOptions } from "./contracts/types.js";
+import type { ArtifactListing, CancelOptions, InvocationEnvelope, ListMemoriesInput, ListMemoriesResult, MemoryRecord, MemorizeInput, MemorizeResult, MessageContent, RequestDataEvent, RecallInput, RecallResult, RemoveMemoryInput, RequestEventSnapshot, RequestPlanState, RequestDecisionOptions, RequestRecord, RequestResult as InternalRequestResult, RequestStartOptions, RequestSummary, RuntimeArtifactWriteInput, ResumeOptions, RequestListeners, RuntimeHealthSnapshot, RuntimeGovernanceEvidence, RuntimeGovernanceDiagnostics, RuntimeOperatorOverview, RuntimeQueueDiagnostics, RuntimeAdapterOptions, RuntimeEvaluationExport, RuntimeEvaluationExportInput, RuntimeEvaluationArtifact, RuntimeEvaluationReplayInput, RuntimeEvaluationReplayResult as InternalRuntimeEvaluationReplayResult, RuntimeSessionPackage, RuntimeSessionPackageInput, SessionListSummary, 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";
@@ -8,7 +8,7 @@ export { createAcpStdioClient } from "./protocol/acp/client.js";
 export type { AcpApproval, AcpArtifact, AcpEventNotification, AcpNotification, AcpJsonRpcError, AcpJsonRpcRequest, AcpJsonRpcResponse, AcpJsonRpcSuccess, AcpRequestRecord, AcpRequestParams, AcpServerCapabilities, AcpSessionRecord, AcpStreamNotification, } from "./acp.js";
 export { AgentHarnessRuntime } from "./runtime/harness.js";
 export { createUpstreamTimelineReducer } from "./upstream-events.js";
-export type { ListMemoriesInput, ListMemoriesResult, MemoryDecision, MemoryKind, MemoryRecord, MemoryScope, MemorizeInput, MemorizeResult, RecallInput, RecallResult, RemoveMemoryInput, RuntimeEvaluationExport, RuntimeEvaluationExportInput, RuntimeEvaluationReplayInput, SessionListSummary, RuntimeSessionPackageInput, RuntimeSessionPackage, UpdateMemoryInput, } from "./contracts/types.js";
+export type { ListMemoriesInput, ListMemoriesResult, MemoryDecision, MemoryKind, MemoryRecord, MemoryScope, MemorizeInput, MemorizeResult, RecallInput, RecallResult, RemoveMemoryInput, RuntimeEvaluationExport, RuntimeEvaluationExportInput, RuntimeEvaluationReplayInput, RequestPlanState, SessionListSummary, RuntimeSessionPackageInput, RuntimeSessionPackage, UpdateMemoryInput, } from "./contracts/types.js";
 export type { AcpHttpServer, AcpHttpServerOptions } from "./protocol/acp/http.js";
 export type { AcpStdioClient, AcpStdioClientOptions } from "./protocol/acp/client.js";
 export type { A2aAgentCard, A2aHttpServer, A2aHttpServerOptions, A2aTask, A2aTaskState } from "./protocol/a2a/http.js";
@@ -41,6 +41,7 @@ export type PublicRequestListeners = {
     onEvent?: (event: RequestEvent) => void | Promise<void>;
     onUpstreamEvent?: RequestListeners["onUpstreamEvent"];
     onTraceItem?: (item: RequestTraceItem) => void | Promise<void>;
+    onPlanState?: RequestListeners["onPlanState"];
 };
 export type Approval = {
     approvalId: string;
@@ -69,6 +70,7 @@ export type RequestPackageInput = {
 export type RequestPackage = {
     session: SessionRecord | null;
     request: RequestRecord | null;
+    planState?: RequestPlanState | null;
     approvals: Approval[];
     transcript: TranscriptMessage[];
     events: RequestEvent[];
@@ -100,11 +102,15 @@ type PublicApprovalFilter = {
 };
 type PublicRequestStartOptions = Omit<RequestStartOptions, "sessionId" | "listeners"> & {
     sessionId?: string;
+    eventListener?: (snapshot: RequestEventSnapshot) => void | Promise<void>;
+    dataListener?: (event: RequestDataEvent) => void | Promise<void>;
     listeners?: PublicRequestListeners;
 };
 type PublicRequestDecisionOptions = Omit<RequestDecisionOptions, "sessionId" | "requestId" | "listeners"> & {
     sessionId: string;
     requestId?: string;
+    eventListener?: (snapshot: RequestEventSnapshot) => void | Promise<void>;
+    dataListener?: (event: RequestDataEvent) => void | Promise<void>;
     listeners?: PublicRequestListeners;
 };
 export type PublicRequestOptions = PublicRequestStartOptions | PublicRequestDecisionOptions;
@@ -113,6 +119,8 @@ export type PublicRequestResult = Omit<InternalRequestResult, "sessionId" | "req
     requestId: string;
 };
 export type RequestResult = PublicRequestResult;
+export type RequestSnapshot = RequestEventSnapshot;
+export type RequestData = RequestDataEvent;
 export type UserChatMessage = {
     role: "user";
     content: MessageContent;
@@ -162,6 +170,10 @@ export declare function getArtifact(runtime: AgentHarnessRuntime, input: {
     requestId: string;
     artifactPath: string;
 }): Promise<unknown>;
+export declare function getRequestPlanState(runtime: AgentHarnessRuntime, input: {
+    sessionId: string;
+    requestId: string;
+}): Promise<RequestPlanState | null>;
 export declare function recordArtifact(runtime: AgentHarnessRuntime, input: RecordArtifactInput): Promise<import("./contracts/types.js").ArtifactRecord>;
 export declare function listRequestEvents(runtime: AgentHarnessRuntime, input: {
     sessionId: string;

package/dist/api.js

@@ -70,6 +70,7 @@ function toPublicRequestListeners(listeners) {
                 event: item.event,
             })
             : undefined,
+        onPlanState: listeners.onPlanState,
     };
 }
 function toRequestArtifactListing(listing) {
@@ -111,12 +112,20 @@ function toPublicRequestResult(result) {
     };
 }
 function toInternalRequestOptions(options) {
+    const legacyListeners = toPublicRequestListeners(options.listeners);
+    const mergedListeners = legacyListeners || options.eventListener || options.dataListener
+        ? {
+            ...(legacyListeners ?? {}),
+            ...(options.eventListener ? { eventListener: options.eventListener } : {}),
+            ...(options.dataListener ? { dataListener: options.dataListener } : {}),
+        }
+        : undefined;
     if ("decision" in options) {
         return {
             approvalId: options.approvalId,
             decision: options.decision,
             editedInput: options.editedInput,
-            listeners: toPublicRequestListeners(options.listeners),
+            listeners: mergedListeners,
             requestId: options.requestId,
             sessionId: options.sessionId,
         };
@@ -125,7 +134,7 @@ function toInternalRequestOptions(options) {
         agentId: options.agentId,
         input: options.input,
         invocation: options.invocation,
-        listeners: toPublicRequestListeners(options.listeners),
+        listeners: mergedListeners,
         priority: options.priority,
         sessionId: options.sessionId,
     };
@@ -272,6 +281,9 @@ export async function listRequestArtifacts(runtime, input) {
 export async function getArtifact(runtime, input) {
     return runtime.readRequestArtifact(input.sessionId, input.requestId, input.artifactPath);
 }
+export async function getRequestPlanState(runtime, input) {
+    return runtime.getRequestPlanState(input.sessionId, input.requestId);
+}
 export async function recordArtifact(runtime, input) {
     return runtime.recordArtifact(input);
 }
@@ -314,7 +326,11 @@ export async function getOperatorOverview(runtime, options) {
     };
 }
 export async function exportRequestPackage(runtime, input) {
-    return toRequestPackage(await runtime.exportRequestPackage(input));
+    const pkg = await runtime.exportRequestPackage(input);
+    return {
+        ...toRequestPackage(pkg),
+        planState: await runtime.getRequestPlanState(input.sessionId, input.requestId),
+    };
 }
 export async function exportSessionPackage(runtime, input) {
     return runtime.exportSessionPackage(input);

package/dist/cli.d.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { type ChildProcessWithoutNullStreams } from "node:child_process";
 import { createInterface as createReadlineInterface } from "node:readline";
 import type { Readable } from "node:stream";
 import { createAgentHarness } from "./api.js";
@@ -34,6 +35,20 @@ type CliDeps = {
     serveAcpOverStdio?: typeof serveAcpOverStdio;
     serveRuntimeMcpOverStdio?: typeof serveRuntimeMcpOverStdio;
 };
+export declare function renderChatPromptLine(input: {
+    agentId?: string;
+    sessionId?: string;
+    requestId?: string;
+    color: boolean;
+}): string;
+export declare function renderChatBanner(input: {
+    workspacePath: string;
+    transport: "stdio" | "http";
+    agentId?: string;
+    sessionId?: string;
+    /** When true (TTY + default stdout), paint logo and accents in ANSI color */
+    color?: boolean;
+}): string;
 type ChatWorkspaceModelInfo = {
     provider?: string;
     model?: string;
@@ -45,6 +60,8 @@ export declare function probeChatWorkspace(input: {
     agentId?: string;
 }): Promise<string | undefined>;
 export declare function isChatServerNoiseLine(line: string): boolean;
-export declare function wrapChatClientForLifecycle(client: HarnessClient, onStop: () => Promise<void> | void): HarnessClient;
+type ProcessExitHookHost = Pick<NodeJS.Process, "on" | "off">;
+export declare function installChatSubprocessExitGuard(child: ChildProcessWithoutNullStreams, host?: ProcessExitHookHost): () => void;
 export declare function runCli(argv: string[], io?: CliIo, deps?: CliDeps): Promise<number>;
+export declare function resolveInvokedCliHref(argvPath?: string): string;
 export {};