@ddwang/magnitude-core 0.3.1-ddwang.2 → 0.3.1-ddwang.4

package/dist/index.d.cts

@@ -201,7 +201,39 @@ interface ModelUsage {
     outputCost?: number;
 }
 
+interface OperationOptions {
+    signal?: AbortSignal;
+    /** Absolute Unix time in milliseconds, shared by every step, retry, and wait. */
+    deadline?: number;
+}
+type OperationKind = 'act' | 'query' | 'extract' | 'nav' | 'exec';
+type OperationPhase = 'preparing' | 'context' | 'observations' | 'model' | 'action' | 'screenshot' | 'stability' | 'cooldown' | 'retry' | 'paused' | 'cursor';
+interface OperationTiming {
+    count: number;
+    totalMs: number;
+}
+interface OperationDiagnostics {
+    id: string;
+    kind: OperationKind;
+    status: 'running' | 'draining' | 'finished';
+    outcome?: 'succeeded' | 'failed' | 'cancelled' | 'deadline';
+    phase: OperationPhase;
+    startedAt: number;
+    elapsedMs: number;
+    cancellationToDrainMs?: number;
+    cancellationToIdleMs?: number;
+    lastAction?: {
+        index: number;
+        name: string;
+        state: 'pending' | 'started' | 'completed' | 'failed';
+    };
+    /** Inclusive totals: nested and concurrent phases overlap and must not be summed. */
+    timings: Partial<Record<OperationPhase, OperationTiming>>;
+}
+
 interface AgentEvents {
+    /** Payload-free snapshots. Existing action/thought events retain their original payloads. */
+    'operation': (diagnostics: OperationDiagnostics) => void;
     'start': () => void;
     'stop': () => void;
     'thought': (thought: string) => void;
@@ -398,12 +430,6 @@ declare class AgentMemory {
     loadJSON(data: SerializedAgentMemory): Promise<void>;
 }
 
-interface OperationOptions {
-    signal?: AbortSignal;
-    /** Absolute Unix time in milliseconds, shared by every step, retry, and wait. */
-    deadline?: number;
-}
-
 type ActionContext<T> = {
     input: T;
     agent: Agent;
@@ -490,18 +516,30 @@ declare class Agent {
     private _paused;
     private _pauseResolve;
     private activeOperation?;
+    private latestOperation?;
     private idle;
-    private stopped;
+    private resolveIdle?;
+    private pendingWork;
+    private lifecycleTail;
+    private lifecycleRequest?;
+    private lifecycleState;
+    private telemetryStarted;
     protected latestTaskMemory: AgentMemory;
     constructor(baseConfig?: Partial<AgentOptions>);
     getConnector<C extends AgentConnector>(connectorClass: new (...args: any[]) => C): C | undefined;
     require<C extends AgentConnector>(connectorClass: new (...args: any[]) => C): C;
     start(): Promise<void>;
+    get lifecycle(): 'new' | 'starting' | 'ready' | 'stopping' | 'stopped';
+    private beginWork;
+    private endWork;
+    private scheduleLifecycle;
     identifyAction(action: Action): ActionDefinition<any>;
     /** True until underlying work settles, including after a cancelled caller returns. */
     get busy(): boolean;
     whenIdle(): Promise<void>;
-    protected runOperation<T>(options: OperationOptions, fn: () => Promise<T>): Promise<T>;
+    /** A payload-free snapshot of the active or most recent operation. */
+    get operation(): OperationDiagnostics | undefined;
+    protected runOperation<T>(options: OperationOptions, fn: () => Promise<T>, kind?: OperationKind): Promise<T>;
     exec(action: Action, memory?: AgentMemory, options?: OperationOptions): Promise<unknown>;
     private _exec;
     protected _recordConnectorObservations(memory: AgentMemory): Promise<void>;
@@ -518,10 +556,13 @@ declare class Agent {
     resume(): void;
     get paused(): boolean;
     stop(): Promise<void>;
+    private stopConnectors;
 }
 
 interface ActionVisualizerOptions {
     showCursor?: boolean;
+    /** Set false to skip the 300 ms movement animation. Defaults to true. */
+    animateCursor?: boolean;
     showHoverCircle?: boolean;
     showClickRipple?: boolean;
     showDragLine?: boolean;
@@ -686,6 +727,7 @@ interface BrowserBlock {
 }
 declare class BrowserBlockedError extends Error {
     readonly block: BrowserBlock;
+    readonly operation?: OperationDiagnostics;
     constructor(block: BrowserBlock);
 }
 interface HttpDiagnostic {
@@ -850,6 +892,7 @@ interface AgentErrorOptions {
     adaptable?: boolean;
 }
 declare class AgentError extends Error {
+    readonly operation?: OperationDiagnostics;
     readonly options: Required<AgentErrorOptions>;
     constructor(message: string, options?: AgentErrorOptions);
 }
@@ -1007,4 +1050,4 @@ declare function buildDefaultBrowserAgentOptions({ agentOptions, browserOptions
 declare const logger: pino.Logger<never, boolean>;
 
 export { ActionLimitError, Agent, AgentBusyError, AgentError, AgentMemory, BrowserAgent, BrowserBlockedError, BrowserConnector, BrowserProvider, DesktopConnector, Observation, OperationCancelledError, OperationDeadlineError, WebHarness, allBrowserAgentRoles, buildDefaultBrowserAgentOptions, createAction, createId, deepEquals, getCodebaseId, getMachineId, logger, mergeMessages, posthog, retryOnError, retryOnErrorIsSuccess, sendTelemetry, startBrowserAgent };
-export type { ActOptions, Action, ActionContext, ActionDefinition, ActionIntent, ActionPayload, AgentConnector, AgentErrorOptions, AgentEvents, AgentMemoryOptions, AgentOptions, AnthropicClient, ApiKeyFailure, AzureOpenAIClient, Base64Image, BasetenClient, BedrockClient, BlockReason, BrowserAgentRole, BrowserBlock, BrowserConnectorOptions, BrowserConnectorStateData, BrowserFailure, BrowserOptions, BugDetectedFailure, BugSeverity, CancelledFailure, CheckIntent, ClaudeCodeClient, ClickIntent, ClickWebAction, DesktopConnectorOptions, DesktopInterface, FailedTestCaseResult, FailureDescriptor, GoogleAIClient, GoogleVertexClient, HoverIntent, HoverWebAction, HttpDiagnostic, Intent, LLMClient, LLMClientIdentifier, MemoryRenderOptions, MisalignmentFailure, ModelUsage, NavigateWebAction, NetworkFailure, ObservableDataArray, ObservableDataObject, ObservableDataPrimitive, ObservationRetentionOptions, ObservationRole, ObservationSource, OpenAIClient, OpenAIGenericClient, OperationOptions, PixelCoordinate, RateLimitFailure, RecoveryOptions, RenderableContent, RetryMode, RetryOptions, RetryParams, ScrollIntent, ScrollWebAction, SerializedAgentMemory, SuccessfulTestCaseResult, SwitchTabIntent, SwitchTabWebAction, TestCaseDefinition, TestCaseResult, TestData, TestDataEntry, TestStepDefinition, TypeIntent, TypeWebAction, UnknownFailure, WebAction, WebHarnessEvents, WebHarnessOptions };
+export type { ActOptions, Action, ActionContext, ActionDefinition, ActionIntent, ActionPayload, AgentConnector, AgentErrorOptions, AgentEvents, AgentMemoryOptions, AgentOptions, AnthropicClient, ApiKeyFailure, AzureOpenAIClient, Base64Image, BasetenClient, BedrockClient, BlockReason, BrowserAgentRole, BrowserBlock, BrowserConnectorOptions, BrowserConnectorStateData, BrowserFailure, BrowserOptions, BugDetectedFailure, BugSeverity, CancelledFailure, CheckIntent, ClaudeCodeClient, ClickIntent, ClickWebAction, DesktopConnectorOptions, DesktopInterface, FailedTestCaseResult, FailureDescriptor, GoogleAIClient, GoogleVertexClient, HoverIntent, HoverWebAction, HttpDiagnostic, Intent, LLMClient, LLMClientIdentifier, MemoryRenderOptions, MisalignmentFailure, ModelUsage, NavigateWebAction, NetworkFailure, ObservableDataArray, ObservableDataObject, ObservableDataPrimitive, ObservationRetentionOptions, ObservationRole, ObservationSource, OpenAIClient, OpenAIGenericClient, OperationDiagnostics, OperationKind, OperationOptions, OperationPhase, OperationTiming, PixelCoordinate, RateLimitFailure, RecoveryOptions, RenderableContent, RetryMode, RetryOptions, RetryParams, ScrollIntent, ScrollWebAction, SerializedAgentMemory, SuccessfulTestCaseResult, SwitchTabIntent, SwitchTabWebAction, TestCaseDefinition, TestCaseResult, TestData, TestDataEntry, TestStepDefinition, TypeIntent, TypeWebAction, UnknownFailure, WebAction, WebHarnessEvents, WebHarnessOptions };

package/dist/index.d.ts

@@ -17,7 +17,7 @@ export { BrowserBlockedError } from '@/web/recovery';
 export type { BrowserBlock, BlockReason, RecoveryOptions, HttpDiagnostic } from '@/web/recovery';
 export * from "@/actions/types";
 export * from '@/common';
-export type { OperationOptions } from '@/common/operation';
+export type { OperationOptions, OperationDiagnostics, OperationKind, OperationPhase, OperationTiming } from '@/common/operation';
 export * from "@/telemetry";
 export { buildDefaultBrowserAgentOptions } from "@/ai/util";
 export { logger } from './logger';