vigthoria-cli 1.13.18 → 1.13.22

package/dist/utils/api.d.ts

@@ -4,6 +4,12 @@
  */
 import { Config } from './config.js';
 import { Logger } from './logger.js';
+import { type PreviewScreenshotPort } from './preview-screenshot-adapter.js';
+import { type OperatorWorkflowResponse } from './operator-client.js';
+import { type FrontendPreviewGateResult } from './frontend-preview-service.js';
+import { type APIHealthStatus, type CapabilityTruthStatus, type EndpointHealthStatus } from './capability-health-service.js';
+import { type ChatMessage, type ChatResponse } from './model-transport-service.js';
+import { type ResolvedVigFlowWorkflowTarget, type VigFlowExecutionResult, type VigFlowExecutionStatus, type VigFlowTemplateSummary, type VigFlowWorkflowCreation, type VigFlowWorkflowSummary } from './vigflow-client.js';
 export type CLIErrorCategory = 'auth' | 'repo_session' | 'model_backend' | 'bridge' | 'network' | 'timeout' | 'parsing' | 'tool_execution' | 'credits';
 export declare const VIGTHORIA_HUB_CREDITS_URL = "https://hub.vigthoria.io/credits";
 export declare const VIGTHORIA_SERVER_TEMPORARILY_UNAVAILABLE_MESSAGE = "Vigthoria Server is temporarily not available. Please try again later. If the issue persists, please contact support.";
@@ -21,6 +27,9 @@ export type ChatRequestOptions = {
     onRouteAttempt?: (routeLabel: string) => void;
     onStreamDelta?: (chunk: string) => void;
 };
+export interface APIClientDependencies {
+    screenshotAdapter?: PreviewScreenshotPort;
+}
 export declare class CLIError extends Error {
     category: CLIErrorCategory;
     statusCode?: number;
@@ -43,23 +52,9 @@ export declare function classifyError(error: unknown, fallbackCategory?: CLIErro
 export declare function formatCLIError(err: CLIError): string;
 export declare function sanitizeUserFacingPathText(input: string): string;
 export declare function sanitizeUserFacingErrorText(input: string): string;
-export declare function isServerRuntime(): boolean;
 export declare function describeUpstreamStatus(status: number): string;
 export declare function propagateError(err: any): never;
-export interface ChatMessage {
-    role: 'user' | 'assistant' | 'system';
-    content: string;
-}
-export interface ChatResponse {
-    id: string;
-    message: string;
-    model: string;
-    usage?: {
-        prompt_tokens: number;
-        completion_tokens: number;
-        total_tokens: number;
-    };
-}
+export type { ChatMessage, ChatResponse } from './model-transport-service.js';
 export interface V3AgentWorkflowResponse {
     content: string;
     taskId: string | null;
@@ -69,135 +64,10 @@ export interface V3AgentWorkflowResponse {
     metadata?: Record<string, unknown>;
     changedFiles?: Record<string, string>;
 }
-export interface FrontendPreviewGateResult {
-    required: boolean;
-    passed: boolean;
-    backendUrl?: string;
-    entryPath?: string;
-    assetPaths?: {
-        css: string[];
-        js: string[];
-    };
-    artifacts?: {
-        manifestPath?: string;
-        screenshotPath?: string;
-        previewFileUrl?: string;
-        screenshotCaptured?: boolean;
-        screenshotError?: string;
-    };
-    modes?: {
-        design?: {
-            ready: boolean;
-            devices?: string[];
-            variantCount?: number;
-        };
-        live?: {
-            ready: boolean;
-            entryPoint?: string;
-        };
-        production?: {
-            ready: boolean;
-            deploymentTarget?: string;
-            recommendedCommand?: string;
-        };
-    };
-    summary?: Record<string, unknown>;
-    processingTimeMs?: number;
-    error?: string;
-}
-export interface OperatorWorkflowResponse {
-    content: string;
-    workflowId: string | null;
-    contextId?: string | null;
-    backendUrl: string;
-    savedWorkflow?: {
-        id: string;
-        name?: string | null;
-        sourceWorkflowId?: string | null;
-    } | null;
-    metadata?: Record<string, unknown>;
-    changedFiles?: Record<string, string>;
-}
-export interface StreamChunk {
-    type: 'content' | 'done' | 'error';
-    content?: string;
-    error?: string;
-}
-export interface EndpointHealthStatus {
-    name: string;
-    endpoint: string;
-    ok: boolean;
-    error?: string;
-    details?: Record<string, unknown>;
-}
-export interface APIHealthStatus {
-    overallOk: boolean;
-    coder: EndpointHealthStatus;
-    models: EndpointHealthStatus;
-    selfHosted: EndpointHealthStatus | null;
-}
-export interface CapabilityTruthStatus {
-    overallOk: boolean;
-    v3Agent: EndpointHealthStatus;
-    hyperLoop: EndpointHealthStatus;
-    repoMemory: EndpointHealthStatus;
-    devtoolsBridge: EndpointHealthStatus;
-}
-export interface VigFlowTemplateSummary {
-    id: string;
-    name: string;
-    description: string;
-    category: string;
-    icon?: string;
-    tags: string[];
-    isBuiltin: boolean;
-    source: string;
-    createdAt?: string;
-}
-export interface VigFlowWorkflowSummary {
-    id: string;
-    name: string;
-    description: string;
-    isActive: boolean;
-    version: string;
-    tags: string[];
-    nodeCount: number;
-    executionCount: number;
-    lastExecutedAt?: string;
-    createdAt?: string;
-    updatedAt?: string;
-}
-export interface VigFlowWorkflowCreation {
-    id: string;
-    name: string;
-    fromTemplate?: string;
-}
-export interface ResolvedVigFlowWorkflowTarget {
-    id: string;
-    name: string;
-    selector: string;
-    matchedBy: 'id' | 'name' | 'search';
-}
-export interface VigFlowExecutionResult {
-    executionId: string;
-    status: string;
-    result?: unknown;
-    error?: string;
-    nodesExecuted?: number;
-}
-export interface VigFlowExecutionStatus {
-    id: string;
-    workflowId: string;
-    status: string;
-    startedAt?: string;
-    completedAt?: string;
-    nodesExecuted?: number;
-    totalNodes?: number;
-    result?: unknown;
-    error?: string;
-    progress?: Record<string, unknown>;
-    duration?: number;
-}
+export type { FrontendPreviewGateResult } from './frontend-preview-service.js';
+export type { OperatorWorkflowResponse } from './operator-client.js';
+export type { APIHealthStatus, CapabilityTruthStatus, EndpointHealthStatus } from './capability-health-service.js';
+export type { ResolvedVigFlowWorkflowTarget, VigFlowExecutionResult, VigFlowExecutionStatus, VigFlowTemplateSummary, VigFlowWorkflowCreation, VigFlowWorkflowSummary, } from './vigflow-client.js';
 export interface VigthoriUser {
     id: string;
     username: string;
@@ -219,17 +89,29 @@ export declare class APIClient {
     private modelRouterClient;
     private selfHostedModelRouterClient;
     private config;
+    private authSession;
+    private unsubscribeAuthInvalidation;
     private logger;
-    private ws;
-    private vigFlowTokens;
+    private readonly modelGovernance;
+    private readonly codeOperations;
+    private readonly mcpContextClient;
+    private readonly v3AgentClient;
+    private readonly v3WorkspaceService;
+    private readonly capabilityHealthService;
+    private readonly modelTransportService;
+    private readonly operatorClient;
+    private readonly vigFlowClient;
     private _httpsAgent;
     private lastChatTransportErrors;
     private clientToolErrors;
     private pendingV3ClientToolTasks;
     /** Tracks files mutated via client_tool_request during an active V3 SSE stream. */
     private activeV3StreamedFiles;
-    private activeV3StreamContext;
-    constructor(config: Config, logger: Logger);
+    private lifecycleAbortController;
+    private readonly frontendPreviewService;
+    private withLifecycleSignal;
+    private fetch;
+    constructor(config: Config, logger: Logger, dependencies?: APIClientDependencies);
     /**
      * Destroy keep-alive sockets so the Node.js event loop can drain
      * naturally.  Call this before exiting commands that run HTTP probes
@@ -241,7 +123,6 @@ export declare class APIClient {
     getSelfHostedModelsApiUrl(): string | null;
     login(email: string, password: string): Promise<boolean>;
     loginWithToken(token: string): Promise<boolean>;
-    private extractUserProfile;
     private refreshToken;
     getSubscriptionStatus(): Promise<void>;
     private getAccessToken;
@@ -263,54 +144,14 @@ export declare class APIClient {
     getV3AgentBackgroundUrl(baseUrl: string, suffix?: string): string;
     getV3AgentApprovalUrl(baseUrl: string): string;
     getOperatorBaseUrls(): string[];
-    getOperatorStreamUrl(baseUrl: string): string;
     getMcpBaseUrls(): string[];
     getVigFlowBaseUrls(): string[];
     getTemplateServiceBaseUrls(): string[];
-    private isFrontendTask;
-    /**
-     * Returns true when the prompt describes a read-only / analysis task.
-     * Used to suppress preview gate and other write-oriented side effects.
-     */
     isAnalysisOnlyTask(message?: string, context?: Record<string, any>): boolean;
+    runTemplateServicePreviewGate(message?: string, context?: Record<string, any>): Promise<FrontendPreviewGateResult>;
     private normalizeWorkspaceRelativePath;
     private collectAgentStateSyncPaths;
-    private listFrontendWorkspaceFiles;
-    private chooseFrontendPreviewEntry;
     private extractLinkedFrontendAssets;
-    private buildFrontendForPreview;
-    private gatherFrontendPreviewArtifacts;
-    private captureFrontendPreviewScreenshot;
-    private evaluateFrontendVisualProof;
-    private persistFrontendPreviewArtifacts;
-    runTemplateServicePreviewGate(message?: string, context?: Record<string, any>): Promise<FrontendPreviewGateResult>;
-    private getMcpContextCreateUrl;
-    private getMcpContextUrl;
-    private getMcpHeaders;
-    getV3AgentHeaders(): Promise<Record<string, string>>;
-    /**
-     * Ensure the V3 service key is available in config.
-     * If not already set via env or stored config, fetches it from the Coder API
-     * using the current user's auth token and caches it for this session and beyond.
-     */
-    ensureV3ServiceKey(): Promise<void>;
-    runV3HealthCheck(): Promise<{
-        healthy: boolean;
-        endpoint: string;
-        error?: string;
-    }>;
-    private runV3AgentAuthPreflight;
-    private executeV3AgentRunRequest;
-    private getVigFlowAccessToken;
-    private getVigFlowHeaders;
-    private withVigFlow;
-    /**
-     * Build the correct sub-path for VigFlow endpoints.
-     * Local servers (e.g. localhost:5060) need `/api/…` prefix.
-     * The remote gateway URL already ends with `/api/vigflow`, so appending
-     * another `/api/…` would double the prefix and cause 404s.
-     */
-    private vigFlowEndpoint;
     listVigFlowTemplates(options?: {
         category?: string;
         search?: string;
@@ -326,8 +167,15 @@ export declare class APIClient {
         executionOptions?: Record<string, unknown>;
     }): Promise<VigFlowExecutionResult>;
     getVigFlowExecutionStatus(executionId: string): Promise<VigFlowExecutionStatus>;
-    /** Legacy cap — prefer resolveV3ContextCharLimit() for token-aligned budgets. */
-    private static readonly V3_CONTEXT_CHAR_LIMIT;
+    getV3AgentHeaders(): Promise<Record<string, string>>;
+    ensureV3ServiceKey(): Promise<void>;
+    runV3HealthCheck(): Promise<{
+        healthy: boolean;
+        endpoint: string;
+        error?: string;
+    }>;
+    private runV3AgentAuthPreflight;
+    private executeV3AgentRunRequest;
     private static readonly HYDRATION_PRIORITY_BASENAMES;
     /** Keep critical workspace files for server hydration when context must shrink. */
     private compactWorkspaceFilesToBudget;
@@ -342,8 +190,8 @@ export declare class APIClient {
      *   5. Drop readmeExcerpt
      */
     private compactV3Context;
-    /** Normalize common Unix-only commands before Windows cmd/powershell execution. */
-    private normalizeWindowsRunCommand;
+    /** Remove server-side workspace aliases before delegated local execution. */
+    private normalizePortableRunCommand;
     private resolveRunCommandCwd;
     /** Remove duplicate functionIndex entries that poison model context after compaction. */
     private dedupeBrainPayload;
@@ -362,8 +210,7 @@ export declare class APIClient {
     private buildLocalWorkspaceSummary;
     /**
      * Build complete workspace hydration separately from model context.
-     * Remote audits must inspect the same byte-complete assets the user has
-     * locally; context compaction must never become filesystem compaction.
+     * Context compaction must not become filesystem compaction.
      */
     private buildOutOfBandWorkspaceFiles;
     /**
@@ -386,7 +233,6 @@ export declare class APIClient {
     private executeV3ClientToolRequest;
     private handleV3ClientToolRequest;
     private writeV3AgentWorkspaceFile;
-    private deleteV3AgentWorkspaceFile;
     recoverAgentWorkspaceFiles(context?: Record<string, any>, streamedFiles?: Record<string, string>, expectedFiles?: string[]): void;
     normalizeAgentWorkspaceRelativePath(rawPath: string, rootPath?: string): string;
     ensureAgentFrontendPolish(message?: string, context?: Record<string, any>): Promise<void>;
@@ -417,7 +263,6 @@ export declare class APIClient {
         status: string;
         files: Record<string, string>;
         file_count: number;
-        confirmed_mutations?: string[];
         local_workspace_path?: string;
     }>;
     applyV3BackgroundJobFiles(jobId: string, context?: Record<string, any>): Promise<{
@@ -425,7 +270,6 @@ export declare class APIClient {
         skipped: string[];
         status: string;
     }>;
-    private formatOperatorResponse;
     runOperatorWorkflow(message: string, context?: Record<string, any>): Promise<OperatorWorkflowResponse>;
     /**
      * Chat API - Direct Vigthoria Models API Architecture
@@ -438,51 +282,10 @@ export declare class APIClient {
      *
      * NO localhost fallbacks - CLI is for external users, not server-side!
      */
-    chat(messages: ChatMessage[], model: string, useLocal?: boolean): Promise<ChatResponse>;
-    private shouldSkipCloudRoutes;
-    private tryChatWithModel;
-    private trySelfHostedChatWithModel;
-    private getFallbackModelId;
-    private isCloudModelId;
-    private canUseCloudModel;
+    chat(messages: ChatMessage[], model: string, _useLocal?: boolean): Promise<ChatResponse>;
     private resolvePermittedModelId;
-    private shouldSimulateCloudFailure;
-    private shouldTrySelfHostedFallback;
-    private isSelfHostedPreferredModel;
-    private getSelfHostedFallbackModelId;
-    chatStream(messages: ChatMessage[], model: string): AsyncGenerator<StreamChunk>;
-    chatWithCallback(messages: ChatMessage[], model: string, onChunk: (chunk: string) => void, onDone: () => void, onError: (error: Error) => void): Promise<void>;
     private chatComplete;
     generateCode(prompt: string, language: string, model: string): Promise<string>;
-    /**
-     * Ensure code has balanced curly braces by appending missing closing braces.
-     */
-    private ensureBalancedBraces;
-    /**
-     * Quick JS/TS syntax validation using Node's built-in parser.
-     * Returns true if the code parses without errors.
-     */
-    private validateJsSyntax;
-    /**
-     * Extract the first complete function/class from code.
-     * Used as last-resort when the model keeps over-producing.
-     */
-    private extractFirstFunction;
-    /**
-     * Detect if code is excessively over-engineered for a short prompt.
-     * E.g. a "multiply function" request producing 20+ lines.
-     */
-    private codeIsOverEngineered;
-    /**
-     * Detect if generated code contains DOM/HTML pollution inappropriate
-     * for a pure programming language like JavaScript, Python, etc.
-     */
-    private codeContainsDomPollution;
-    /**
-     * Strip DOM pollution from generated code, keeping only the pure logic.
-     * Used as last-resort fallback when the model repeatedly ignores constraints.
-     */
-    private stripDomPollution;
     generateProject(prompt: string, projectType: string, model: string): Promise<{
         code: string;
         plan?: any;
@@ -509,11 +312,6 @@ export declare class APIClient {
         }[];
         suggestions: string[];
     }>;
-    /**
-     * Lightweight client-side heuristic scan: catches common code smells
-     * AND logic/arithmetic bugs so review never returns "score 30, no issues".
-     */
-    private heuristicCodeIssues;
     fixCode(code: string, language: string, fixType: string): Promise<{
         fixed: string;
         changes: {
@@ -523,29 +321,6 @@ export declare class APIClient {
             reason: string;
         }[];
     }>;
-    /**
-     * Compute a semantic diff between original and fixed code using
-     * Longest Common Subsequence (LCS) to avoid the line-shift inflation
-     * bug where inserting one line flags all subsequent lines as changed.
-     */
-    private computeSemanticDiff;
-    /**
-     * Lightweight client-side syntax error detection.
-     * Returns a human-readable description of obvious errors, or empty string.
-     */
-    private detectSyntaxErrors;
-    /**
-     * Strip comment lines that the model added during a fix but were not
-     * present in the original code.  Used for syntax-only fixes where the
-     * model tends to annotate its changes with "// Fixed ..." comments.
-     */
-    private stripInjectedComments;
-    /**
-     * Ensure the fixed code hasn't lost closing delimiters relative to the
-     * original.  Counts {, }, (, ), [, ] outside strings/comments and if
-     * the fix has fewer closers than the original, appends the missing ones.
-     */
-    private repairBracketBalance;
     private resolveModelId;
     private getCoderHealth;
     /**
@@ -589,6 +364,7 @@ export declare class APIClient {
         recovered: boolean;
         message: string;
     }>;
+    private probeDevtoolsBridgeStatus;
     getDevtoolsBridgeStatus(): Promise<EndpointHealthStatus>;
     getCapabilityTruthStatus(context?: Record<string, any>): Promise<CapabilityTruthStatus>;
     getHealthStatus(): Promise<APIHealthStatus>;