@evalops/maestro 0.10.17 → 0.10.20

package/dist/server/hosted-agent-runtime-progress.d.ts

@@ -0,0 +1,144 @@
+import type { SwarmEvent } from "../agent/swarm/types.js";
+import type { AgentEvent } from "../agent/types.js";
+import { delegateAgentWithPlatform, resolveAgentDelegationWithPlatform } from "../platform/agent-registry-client.js";
+import { PlatformAgentRunStepKindValue, PlatformAgentWorkItemKindValue, completeAgentRuntimeRun, failAgentRuntimeRun, recordAgentRuntimeRunCost, recordAgentRuntimeRunEvent, recordAgentRuntimeRunStep, recordAgentRuntimeRunWorkItem, resumeAgentRuntimeRun, updateAgentRuntimeRunWorkItem, waitAgentRuntimeRun } from "../platform/agent-runtime-client.js";
+import type { ServerRequestLifecycleEvent } from "./server-request-manager.js";
+type HostedAgentRuntimeTaskSource = "todo" | "background" | "swarm" | "checkpoint";
+type HostedAgentRuntimeTaskStatus = "pending" | "running" | "waiting" | "blocked" | "succeeded" | "failed" | "cancelled";
+export interface HostedAgentRuntimeTaskProgressEvent {
+    source: HostedAgentRuntimeTaskSource;
+    id: string;
+    status: HostedAgentRuntimeTaskStatus;
+    title: string;
+    goal?: string;
+    parentId?: string;
+    ownerChildRunId?: string;
+    workItemKind?: PlatformAgentWorkItemKindValue | string;
+    stepKind?: PlatformAgentRunStepKindValue | string;
+    nextAction?: string;
+    blocker?: string;
+    errorMessage?: string;
+    toolCallId?: string;
+    toolExecutionId?: string;
+    approvalRequestId?: string;
+    completionGate?: string;
+    evidenceRefs?: string[];
+    payload?: Record<string, unknown>;
+    recordStep?: boolean;
+}
+export interface HostedAgentRuntimeProgressContext {
+    enabled: true;
+    agentRunId?: string;
+    agentRuntimeLeaseToken?: string;
+    agentRuntimeWorkerQueue?: string;
+    agentRuntimeCorrelationPath?: string;
+    workspaceId?: string;
+    runnerSessionId?: string;
+    ownerInstanceId?: string;
+    agentId?: string;
+}
+export interface HostedAgentRuntimeProgressRecorderOperations {
+    recordStep?: typeof recordAgentRuntimeRunStep;
+    recordEvent?: typeof recordAgentRuntimeRunEvent;
+    recordCost?: typeof recordAgentRuntimeRunCost;
+    recordWorkItem?: typeof recordAgentRuntimeRunWorkItem;
+    updateWorkItem?: typeof updateAgentRuntimeRunWorkItem;
+    waitRun?: typeof waitAgentRuntimeRun;
+    resumeRun?: typeof resumeAgentRuntimeRun;
+    completeRun?: typeof completeAgentRuntimeRun;
+    failRun?: typeof failAgentRuntimeRun;
+    delegateAgent?: typeof delegateAgentWithPlatform;
+    resolveDelegation?: typeof resolveAgentDelegationWithPlatform;
+}
+export interface HostedAgentRuntimeProgressRecorderOptions {
+    sessionId: string;
+    hostedRunner?: HostedAgentRuntimeProgressContext;
+    workspaceRoot?: string;
+    operations?: HostedAgentRuntimeProgressRecorderOperations;
+}
+export interface HostedAgentRuntimeCompleteInput {
+    reason?: string;
+    requestedBy?: string;
+    flushStatus?: string;
+    manifestPath?: string;
+}
+export interface HostedAgentRuntimeFailInput {
+    errorMessage: string;
+    reason?: string;
+    requestedBy?: string;
+    retryable?: boolean;
+    manifestPath?: string;
+    flushStatus?: string;
+}
+export interface HostedAgentRuntimeDrainInput {
+    status: "drained" | "interrupted" | string;
+    reason?: string;
+    requestedBy?: string;
+    flushStatus?: string;
+    manifestPath?: string;
+    platformEvidence?: unknown;
+    errorMessage?: string;
+}
+export declare class HostedAgentRuntimeProgressRecorder {
+    private readonly sessionId;
+    private readonly hostedRunner?;
+    private readonly workspaceRoot?;
+    private readonly operations;
+    private readonly pendingWaitIds;
+    private readonly resumedWaitIds;
+    private readonly codexSubagentReceiverThreadIds;
+    private readonly codexSubagentToolChildRunIds;
+    private readonly codexSubagentToolWorkGraphs;
+    private readonly codexSubagentThreadWorkItemIds;
+    private readonly codexSubagentDelegationIds;
+    private readonly codexSubagentDelegationIdsByThreadId;
+    private readonly codexSubagentDelegationIdsByChildRunId;
+    private readonly recordedModelUsageTurnIds;
+    private readonly toolArgsByCallId;
+    private readonly recordedTaskWorkItemIds;
+    private pending;
+    private turnIndex;
+    private terminalRecorded;
+    constructor(options: HostedAgentRuntimeProgressRecorderOptions);
+    recordAgentEvent(event: AgentEvent): void;
+    recordServerRequestEvent(event: ServerRequestLifecycleEvent): void;
+    recordPromptFailure(message: string): void;
+    recordTaskProgressEvent(event: HostedAgentRuntimeTaskProgressEvent): void;
+    recordSwarmEvent(event: SwarmEvent): void;
+    flush(): Promise<void>;
+    completeRun(input?: HostedAgentRuntimeCompleteInput): Promise<void>;
+    failRun(input: HostedAgentRuntimeFailInput): Promise<void>;
+    recordHostedRunnerDrain(input: HostedAgentRuntimeDrainInput): Promise<void>;
+    private recordApprovalWait;
+    private resumeWait;
+    private recordStep;
+    private recordModelUsageEvent;
+    private recordDrainManifestEvent;
+    private recordEvent;
+    private recordCost;
+    private recordCodexSubagentWorkItem;
+    private recordCodexSubagentDelegation;
+    private updateCodexSubagentWorkItem;
+    private rememberCodexSubagentDelegation;
+    private codexSubagentDelegationIdsFor;
+    private clearCodexSubagentDelegationLinks;
+    private codexSubagentLinkedWorkItemIds;
+    private recordToolDerivedTaskProgress;
+    private recordTodoTaskProgress;
+    private recordBackgroundTaskProgress;
+    private enqueue;
+    private handles;
+    private basePayload;
+    private stepId;
+    private taskProgressId;
+    private toolStepId;
+    private workItemId;
+    private waitId;
+    private checkpointId;
+    private resumeEventId;
+    private costId;
+    private meterRef;
+}
+export declare function createHostedAgentRuntimeProgressRecorder(options: HostedAgentRuntimeProgressRecorderOptions): HostedAgentRuntimeProgressRecorder | undefined;
+export {};
+//# sourceMappingURL=hosted-agent-runtime-progress.d.ts.map

package/dist/server/hosted-agent-runtime-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-agent-runtime-progress.d.ts","sourceRoot":"","sources":["../../src/server/hosted-agent-runtime-progress.ts"],"names":[],"mappings":"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"}