@veolab/discoverylab 1.2.1 → 1.3.0

package/dist/index.d.ts

@@ -1593,6 +1593,128 @@ declare function nextEventSeq(): number;
  */
 declare function resetEventSeq(): void;
 
+interface ESVPResolvedConnection {
+    mode: 'remote' | 'local';
+    serverUrl: string;
+}
+
+/**
+ * ESVP Public Client
+ *
+ * Thin HTTP adapter for the public ESVP contract.
+ * This client intentionally depends only on the open contract and does not
+ * embed any private Entropy Lab implementation details.
+ *
+ * Connection modes:
+ * - remote: explicit serverUrl or ESVP_BASE_URL
+ * - local: embedded OSS runtime via @entropylab/esvp-local or DISCOVERYLAB_ESVP_LOCAL_MODULE
+ */
+
+type ESVPExecutor = 'fake' | 'adb' | 'ios-sim' | 'maestro-ios';
+interface ESVPArtifactSummary {
+    t?: number;
+    kind?: string;
+    path?: string;
+    sha256?: string;
+    bytes?: number;
+    meta?: Record<string, unknown> | null;
+    abs_path?: string | null;
+    [key: string]: unknown;
+}
+interface ESVPManagedProxyState {
+    id?: string | null;
+    active?: boolean;
+    bind_host?: string | null;
+    host?: string | null;
+    port?: number | null;
+    url?: string | null;
+    started_at?: string | null;
+    entry_count?: number | null;
+    capture_mode?: string | null;
+    [key: string]: unknown;
+}
+interface ESVPSessionNetworkState {
+    supported?: boolean;
+    capabilities?: Record<string, unknown> | null;
+    active_profile?: Record<string, unknown> | null;
+    effective_profile?: Record<string, unknown> | null;
+    managed_proxy?: ESVPManagedProxyState | null;
+    configured_at?: string | null;
+    cleared_at?: string | null;
+    trace_count?: number;
+    trace_kinds?: string[];
+    last_result?: Record<string, unknown> | null;
+    last_error?: string | null;
+    [key: string]: unknown;
+}
+interface ESVPCreateSessionInput {
+    executor: ESVPExecutor;
+    deviceId?: string;
+    meta?: Record<string, unknown>;
+    crash_clip?: {
+        enabled?: boolean;
+        pre_seconds?: number;
+        post_seconds?: number;
+        chunk_seconds?: number;
+    };
+}
+interface ESVPAction {
+    name: string;
+    args?: Record<string, unknown>;
+    checkpointAfter?: boolean;
+    checkpointLabel?: string;
+}
+declare function getESVPBaseUrl(serverUrl?: string): string;
+declare function resolveESVPBaseUrl(serverUrl?: string): Promise<string>;
+declare function getESVPConnection(serverUrl?: string): Promise<ESVPResolvedConnection>;
+declare function getESVPHealth(serverUrl?: string): Promise<any>;
+declare function listESVPSessions(serverUrl?: string): Promise<any>;
+declare function createESVPSession(input: ESVPCreateSessionInput, serverUrl?: string): Promise<any>;
+declare function getESVPSession(sessionId: string, serverUrl?: string): Promise<any>;
+declare function getESVPTranscript(sessionId: string, serverUrl?: string): Promise<any>;
+declare function listESVPArtifacts(sessionId: string, serverUrl?: string): Promise<any>;
+declare function runESVPActions(sessionId: string, input: {
+    actions: ESVPAction[];
+    finish?: boolean;
+    captureLogcat?: boolean;
+    checkpointAfterEach?: boolean;
+}, serverUrl?: string): Promise<any>;
+declare function finishESVPSession(sessionId: string, input?: {
+    captureLogcat?: boolean;
+}, serverUrl?: string): Promise<any>;
+interface ESVPPreflightRule {
+    kind: 'permission' | 'dismiss_dialog' | 'wait_for_stable' | 'clear_data' | 'set_setting';
+    [key: string]: unknown;
+}
+interface ESVPPreflightConfig {
+    policy?: string;
+    appId?: string;
+    rules?: ESVPPreflightRule[];
+    [key: string]: unknown;
+}
+declare function runESVPPreflight(sessionId: string, config: ESVPPreflightConfig, serverUrl?: string): Promise<any>;
+declare function inspectESVPSession(sessionId: string, input?: {
+    includeTranscript?: boolean;
+    includeArtifacts?: boolean;
+}, serverUrl?: string): Promise<any>;
+declare function getESVPArtifactContent(sessionId: string, artifactPath: string, serverUrl?: string): Promise<any>;
+declare function getESVPSessionNetwork(sessionId: string, serverUrl?: string): Promise<any>;
+declare function replayESVPSession(sessionId: string, input?: {
+    executor?: ESVPExecutor;
+    deviceId?: string;
+    captureLogcat?: boolean;
+    meta?: Record<string, unknown>;
+}, serverUrl?: string): Promise<any>;
+declare function getESVPReplayConsistency(sessionId: string, serverUrl?: string): Promise<any>;
+declare function validateESVPReplay(sessionId: string, serverUrl?: string): Promise<any>;
+declare function captureESVPCheckpoint(sessionId: string, input?: {
+    label?: string;
+}, serverUrl?: string): Promise<any>;
+declare function configureESVPNetwork(sessionId: string, input: Record<string, unknown>, serverUrl?: string): Promise<any>;
+declare function clearESVPNetwork(sessionId: string, serverUrl?: string): Promise<any>;
+declare function attachESVPNetworkTrace(sessionId: string, input: Record<string, unknown>, serverUrl?: string): Promise<any>;
+declare function listESVPDevices(platform?: 'adb' | 'ios-sim' | 'maestro-ios' | 'all', serverUrl?: string): Promise<any>;
+
 /**
  * DiscoveryLab Skills System - Types
  *
@@ -1814,4 +1936,4 @@ declare function formatSkillInfo(skill: Skill): string;
  */
 declare function formatSkillList(skills: Skill[]): string;
 
-export { type ActionEventPayload, type ConnectedEventPayload, type ErrorEventPayload, type ExportDestination, type ExportRule, type Frame, type GatingResult, type LiveFrameEventPayload, type LiveStreamStartParams, type LiveStreamStartResponse, type LiveStreamStopParams, type LiveStreamStopResponse, type LiveStreamTapParams, type NewExportDestination, type NewExportRule, type NewFrame, type NewProject, type NewProjectExport, type NewSetting, type NewTestVariable, type ParsedSkillMd, type PingParams, type PingResponse, type Project, type ProjectCreateParams, type ProjectDeleteParams, type ProjectExport, type ProjectGetParams, type ProjectListParams, type RecorderStartParams, type RecorderStartResponse, type RecorderStatusParams, type RecorderStopParams, type RecorderStopResponse, type ScreenshotEventPayload, type SessionEventPayload, type Setting, type Skill, type SkillCategory, type SkillInstallInfo, type SkillLoadResult, type SkillMetadata, type SkillRegistry, type SkillRequirements, type StatusEventPayload, type SupportedOS, type TestVariable, type ValidationError, type ValidationResult, type WSEvent, type WSEventMap, type WSEventType, type WSMessage, type WSMethod, type WSMethodMap, type WSRequest, type WSResponse, availableEvents, availableMethods, checkBinaries, checkBinary, checkEnvVar, checkEnvVars, checkOS, checkSkillRequirements, closeDatabase, createEvent, createRequest, createResponse, createSkillRegistry, exportDestinations, exportRules, formatSkillInfo, formatSkillList, formatValidationErrors, frames, generateSkillMd, getCurrentOS, getDatabase, getInstallInstructions, getSkillRegistry, isWSEvent, isWSMessage, isWSRequest, isWSResponse, loadSkills, mcpServer, nextEventSeq, parseSkillMd, projectExports, projects, readSkillMd, reloadSkillRegistry, resetEventSeq, schemas, settings, startServer, stopServer, testVariables, validateEvent, validateMethodParams, validateRequest, validateResponse };
+export { type ActionEventPayload, type ConnectedEventPayload, type ESVPAction, type ESVPArtifactSummary, type ESVPCreateSessionInput, type ESVPExecutor, type ESVPManagedProxyState, type ESVPPreflightConfig, type ESVPPreflightRule, type ESVPSessionNetworkState, type ErrorEventPayload, type ExportDestination, type ExportRule, type Frame, type GatingResult, type LiveFrameEventPayload, type LiveStreamStartParams, type LiveStreamStartResponse, type LiveStreamStopParams, type LiveStreamStopResponse, type LiveStreamTapParams, type NewExportDestination, type NewExportRule, type NewFrame, type NewProject, type NewProjectExport, type NewSetting, type NewTestVariable, type ParsedSkillMd, type PingParams, type PingResponse, type Project, type ProjectCreateParams, type ProjectDeleteParams, type ProjectExport, type ProjectGetParams, type ProjectListParams, type RecorderStartParams, type RecorderStartResponse, type RecorderStatusParams, type RecorderStopParams, type RecorderStopResponse, type ScreenshotEventPayload, type SessionEventPayload, type Setting, type Skill, type SkillCategory, type SkillInstallInfo, type SkillLoadResult, type SkillMetadata, type SkillRegistry, type SkillRequirements, type StatusEventPayload, type SupportedOS, type TestVariable, type ValidationError, type ValidationResult, type WSEvent, type WSEventMap, type WSEventType, type WSMessage, type WSMethod, type WSMethodMap, type WSRequest, type WSResponse, attachESVPNetworkTrace, availableEvents, availableMethods, captureESVPCheckpoint, checkBinaries, checkBinary, checkEnvVar, checkEnvVars, checkOS, checkSkillRequirements, clearESVPNetwork, closeDatabase, configureESVPNetwork, createESVPSession, createEvent, createRequest, createResponse, createSkillRegistry, exportDestinations, exportRules, finishESVPSession, formatSkillInfo, formatSkillList, formatValidationErrors, frames, generateSkillMd, getCurrentOS, getDatabase, getESVPArtifactContent, getESVPBaseUrl, getESVPConnection, getESVPHealth, getESVPReplayConsistency, getESVPSession, getESVPSessionNetwork, getESVPTranscript, getInstallInstructions, getSkillRegistry, inspectESVPSession, isWSEvent, isWSMessage, isWSRequest, isWSResponse, listESVPArtifacts, listESVPDevices, listESVPSessions, loadSkills, mcpServer, nextEventSeq, parseSkillMd, projectExports, projects, readSkillMd, reloadSkillRegistry, replayESVPSession, resetEventSeq, resolveESVPBaseUrl, runESVPActions, runESVPPreflight, schemas, settings, startServer, stopServer, testVariables, validateESVPReplay, validateEvent, validateMethodParams, validateRequest, validateResponse };