@powerformer/refly-cli 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,637 @@
+import { z } from 'zod';
+
+/**
+ * Builder session schema and types
+ */
+
+declare const NodeSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodString;
+    input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    dependsOn: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    type: string;
+    dependsOn: string[];
+    input: Record<string, unknown>;
+}, {
+    id: string;
+    type: string;
+    dependsOn?: string[] | undefined;
+    input?: Record<string, unknown> | undefined;
+}>;
+type WorkflowNode = z.infer<typeof NodeSchema>;
+declare const WorkflowDraftSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    nodes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        dependsOn: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        type: string;
+        dependsOn: string[];
+        input: Record<string, unknown>;
+    }, {
+        id: string;
+        type: string;
+        dependsOn?: string[] | undefined;
+        input?: Record<string, unknown> | undefined;
+    }>, "many">>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        owner: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        tags?: string[] | undefined;
+        owner?: string | undefined;
+    }, {
+        tags?: string[] | undefined;
+        owner?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    nodes: {
+        id: string;
+        type: string;
+        dependsOn: string[];
+        input: Record<string, unknown>;
+    }[];
+    description?: string | undefined;
+    metadata?: {
+        tags?: string[] | undefined;
+        owner?: string | undefined;
+    } | undefined;
+}, {
+    name: string;
+    description?: string | undefined;
+    nodes?: {
+        id: string;
+        type: string;
+        dependsOn?: string[] | undefined;
+        input?: Record<string, unknown> | undefined;
+    }[] | undefined;
+    metadata?: {
+        tags?: string[] | undefined;
+        owner?: string | undefined;
+    } | undefined;
+}>;
+type WorkflowDraft = z.infer<typeof WorkflowDraftSchema>;
+declare const ValidationResultSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    errors: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+        nodeId: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        message: string;
+        nodeId?: string | undefined;
+        details?: Record<string, unknown> | undefined;
+    }, {
+        code: string;
+        message: string;
+        nodeId?: string | undefined;
+        details?: Record<string, unknown> | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    ok: boolean;
+    errors: {
+        code: string;
+        message: string;
+        nodeId?: string | undefined;
+        details?: Record<string, unknown> | undefined;
+    }[];
+}, {
+    ok: boolean;
+    errors?: {
+        code: string;
+        message: string;
+        nodeId?: string | undefined;
+        details?: Record<string, unknown> | undefined;
+    }[] | undefined;
+}>;
+type ValidationResult = z.infer<typeof ValidationResultSchema>;
+declare const BuilderState: {
+    readonly IDLE: "IDLE";
+    readonly DRAFT: "DRAFT";
+    readonly VALIDATED: "VALIDATED";
+    readonly COMMITTED: "COMMITTED";
+    readonly ABORTED: "ABORTED";
+};
+type BuilderStateType = (typeof BuilderState)[keyof typeof BuilderState];
+declare const BuilderSessionSchema: z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodDefault<z.ZodNumber>;
+    state: z.ZodEnum<["IDLE", "DRAFT", "VALIDATED", "COMMITTED", "ABORTED"]>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    workflowDraft: z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        nodes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodString;
+            input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            dependsOn: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            type: string;
+            dependsOn: string[];
+            input: Record<string, unknown>;
+        }, {
+            id: string;
+            type: string;
+            dependsOn?: string[] | undefined;
+            input?: Record<string, unknown> | undefined;
+        }>, "many">>;
+        metadata: z.ZodOptional<z.ZodObject<{
+            tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            owner: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            tags?: string[] | undefined;
+            owner?: string | undefined;
+        }, {
+            tags?: string[] | undefined;
+            owner?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        nodes: {
+            id: string;
+            type: string;
+            dependsOn: string[];
+            input: Record<string, unknown>;
+        }[];
+        description?: string | undefined;
+        metadata?: {
+            tags?: string[] | undefined;
+            owner?: string | undefined;
+        } | undefined;
+    }, {
+        name: string;
+        description?: string | undefined;
+        nodes?: {
+            id: string;
+            type: string;
+            dependsOn?: string[] | undefined;
+            input?: Record<string, unknown> | undefined;
+        }[] | undefined;
+        metadata?: {
+            tags?: string[] | undefined;
+            owner?: string | undefined;
+        } | undefined;
+    }>;
+    validation: z.ZodDefault<z.ZodObject<{
+        ok: z.ZodBoolean;
+        errors: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            code: z.ZodString;
+            message: z.ZodString;
+            nodeId: z.ZodOptional<z.ZodString>;
+            details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            message: string;
+            nodeId?: string | undefined;
+            details?: Record<string, unknown> | undefined;
+        }, {
+            code: string;
+            message: string;
+            nodeId?: string | undefined;
+            details?: Record<string, unknown> | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        ok: boolean;
+        errors: {
+            code: string;
+            message: string;
+            nodeId?: string | undefined;
+            details?: Record<string, unknown> | undefined;
+        }[];
+    }, {
+        ok: boolean;
+        errors?: {
+            code: string;
+            message: string;
+            nodeId?: string | undefined;
+            details?: Record<string, unknown> | undefined;
+        }[] | undefined;
+    }>>;
+    commit: z.ZodOptional<z.ZodObject<{
+        workflowId: z.ZodOptional<z.ZodString>;
+        committedAt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        workflowId?: string | undefined;
+        committedAt?: string | undefined;
+    }, {
+        workflowId?: string | undefined;
+        committedAt?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    version: number;
+    validation: {
+        ok: boolean;
+        errors: {
+            code: string;
+            message: string;
+            nodeId?: string | undefined;
+            details?: Record<string, unknown> | undefined;
+        }[];
+    };
+    state: "IDLE" | "DRAFT" | "VALIDATED" | "COMMITTED" | "ABORTED";
+    workflowDraft: {
+        name: string;
+        nodes: {
+            id: string;
+            type: string;
+            dependsOn: string[];
+            input: Record<string, unknown>;
+        }[];
+        description?: string | undefined;
+        metadata?: {
+            tags?: string[] | undefined;
+            owner?: string | undefined;
+        } | undefined;
+    };
+    commit?: {
+        workflowId?: string | undefined;
+        committedAt?: string | undefined;
+    } | undefined;
+}, {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    state: "IDLE" | "DRAFT" | "VALIDATED" | "COMMITTED" | "ABORTED";
+    workflowDraft: {
+        name: string;
+        description?: string | undefined;
+        nodes?: {
+            id: string;
+            type: string;
+            dependsOn?: string[] | undefined;
+            input?: Record<string, unknown> | undefined;
+        }[] | undefined;
+        metadata?: {
+            tags?: string[] | undefined;
+            owner?: string | undefined;
+        } | undefined;
+    };
+    commit?: {
+        workflowId?: string | undefined;
+        committedAt?: string | undefined;
+    } | undefined;
+    version?: number | undefined;
+    validation?: {
+        ok: boolean;
+        errors?: {
+            code: string;
+            message: string;
+            nodeId?: string | undefined;
+            details?: Record<string, unknown> | undefined;
+        }[] | undefined;
+    } | undefined;
+}>;
+type BuilderSession = z.infer<typeof BuilderSessionSchema>;
+interface NodeDiff {
+    action: 'add' | 'update' | 'remove';
+    nodeId: string;
+    before?: WorkflowNode;
+    after?: WorkflowNode;
+}
+interface ConnectionDiff {
+    action: 'connect' | 'disconnect';
+    from: string;
+    to: string;
+}
+type Diff = NodeDiff | ConnectionDiff;
+
+/**
+ * Unified output helpers for CLI commands.
+ * Supports multiple output formats: json, pretty, compact, plain.
+ * All CLI output MUST go through these functions.
+ */
+
+interface SuccessResponse<T = unknown> {
+    ok: true;
+    type: string;
+    version: string;
+    payload: T;
+}
+interface ErrorDetail {
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+    hint?: string;
+}
+interface ErrorResponse {
+    ok: false;
+    type: 'error';
+    version: string;
+    error: ErrorDetail;
+}
+type CLIResponse<T = unknown> = SuccessResponse<T> | ErrorResponse;
+/**
+ * Error codes used throughout the CLI
+ */
+declare const ErrorCodes: {
+    readonly AUTH_REQUIRED: "AUTH_REQUIRED";
+    readonly AUTH_INVALID: "AUTH_INVALID";
+    readonly AUTH_EXPIRED: "AUTH_EXPIRED";
+    readonly CLI_NOT_FOUND: "CLI_NOT_FOUND";
+    readonly CONFIG_ERROR: "CONFIG_ERROR";
+    readonly BUILDER_NOT_STARTED: "BUILDER_NOT_STARTED";
+    readonly BUILDER_ALREADY_STARTED: "BUILDER_ALREADY_STARTED";
+    readonly VALIDATION_REQUIRED: "VALIDATION_REQUIRED";
+    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+    readonly DUPLICATE_NODE_ID: "DUPLICATE_NODE_ID";
+    readonly NODE_NOT_FOUND: "NODE_NOT_FOUND";
+    readonly CYCLE_DETECTED: "CYCLE_DETECTED";
+    readonly INVALID_STATE: "INVALID_STATE";
+    readonly WORKFLOW_NOT_FOUND: "WORKFLOW_NOT_FOUND";
+    readonly WORKFLOW_EXISTS: "WORKFLOW_EXISTS";
+    readonly RUN_NOT_FOUND: "RUN_NOT_FOUND";
+    readonly INVALID_NODE_TYPE: "INVALID_NODE_TYPE";
+    readonly INVALID_NODE_INPUT: "INVALID_NODE_INPUT";
+    readonly NETWORK_ERROR: "NETWORK_ERROR";
+    readonly TIMEOUT: "TIMEOUT";
+    readonly API_ERROR: "API_ERROR";
+    readonly NOT_FOUND: "NOT_FOUND";
+    readonly CONFLICT: "CONFLICT";
+    readonly PERMISSION_DENIED: "PERMISSION_DENIED";
+    readonly INVALID_INPUT: "INVALID_INPUT";
+    readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+};
+type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];
+
+/**
+ * Custom error classes for CLI operations
+ */
+
+declare class CLIError extends Error {
+    readonly code: ErrorCode;
+    readonly details?: Record<string, unknown> | undefined;
+    readonly hint?: string | undefined;
+    constructor(code: ErrorCode, message: string, details?: Record<string, unknown> | undefined, hint?: string | undefined);
+}
+declare class AuthError extends CLIError {
+    constructor(message: string, hint?: string);
+}
+declare class BuilderError extends CLIError {
+}
+declare class ValidationError extends CLIError {
+    constructor(message: string, details?: Record<string, unknown>);
+}
+
+/**
+ * Builder session persistence with atomic writes
+ */
+
+/**
+ * Create a new builder session
+ */
+declare function createSession(name: string, description?: string): BuilderSession;
+/**
+ * Save session to disk atomically
+ */
+declare function saveSession(session: BuilderSession): void;
+/**
+ * Load session from disk
+ */
+declare function loadSession(sessionId: string): BuilderSession | null;
+/**
+ * Get current session (convenience function)
+ */
+declare function getCurrentSession(): BuilderSession | null;
+
+/**
+ * DAG validation for workflow drafts
+ */
+
+/**
+ * Validate a workflow draft
+ */
+declare function validateDraft(session: BuilderSession): ValidationResult;
+
+/**
+ * Graph utilities for visualizing workflow DAG
+ */
+
+interface Edge {
+    from: string;
+    to: string;
+}
+interface GraphOutput {
+    nodes: Array<{
+        id: string;
+        type: string;
+        dependsOn: string[];
+    }>;
+    edges: Edge[];
+    stats: {
+        nodeCount: number;
+        edgeCount: number;
+        rootNodes: string[];
+        leafNodes: string[];
+    };
+}
+/**
+ * Generate graph representation of the workflow
+ */
+declare function generateGraph(session: BuilderSession): GraphOutput;
+
+/**
+ * Configuration management with atomic writes and secure permissions.
+ */
+
+declare const ConfigSchema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodNumber>;
+    auth: z.ZodOptional<z.ZodObject<{
+        method: z.ZodOptional<z.ZodEnum<["oauth", "apikey"]>>;
+        accessToken: z.ZodOptional<z.ZodString>;
+        refreshToken: z.ZodOptional<z.ZodString>;
+        expiresAt: z.ZodOptional<z.ZodString>;
+        provider: z.ZodOptional<z.ZodEnum<["google", "github"]>>;
+        apiKey: z.ZodOptional<z.ZodString>;
+        apiKeyId: z.ZodOptional<z.ZodString>;
+        apiKeyName: z.ZodOptional<z.ZodString>;
+        user: z.ZodOptional<z.ZodObject<{
+            uid: z.ZodString;
+            email: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            uid: string;
+            email: string;
+            name?: string | undefined;
+        }, {
+            uid: string;
+            email: string;
+            name?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        method?: "oauth" | "apikey" | undefined;
+        accessToken?: string | undefined;
+        refreshToken?: string | undefined;
+        expiresAt?: string | undefined;
+        provider?: "google" | "github" | undefined;
+        apiKey?: string | undefined;
+        apiKeyId?: string | undefined;
+        apiKeyName?: string | undefined;
+        user?: {
+            uid: string;
+            email: string;
+            name?: string | undefined;
+        } | undefined;
+    }, {
+        method?: "oauth" | "apikey" | undefined;
+        accessToken?: string | undefined;
+        refreshToken?: string | undefined;
+        expiresAt?: string | undefined;
+        provider?: "google" | "github" | undefined;
+        apiKey?: string | undefined;
+        apiKeyId?: string | undefined;
+        apiKeyName?: string | undefined;
+        user?: {
+            uid: string;
+            email: string;
+            name?: string | undefined;
+        } | undefined;
+    }>>;
+    api: z.ZodOptional<z.ZodObject<{
+        endpoint: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        endpoint: string;
+    }, {
+        endpoint?: string | undefined;
+    }>>;
+    skill: z.ZodOptional<z.ZodObject<{
+        installedVersion: z.ZodOptional<z.ZodString>;
+        installedAt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        installedVersion?: string | undefined;
+        installedAt?: string | undefined;
+    }, {
+        installedVersion?: string | undefined;
+        installedAt?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    version: number;
+    auth?: {
+        method?: "oauth" | "apikey" | undefined;
+        accessToken?: string | undefined;
+        refreshToken?: string | undefined;
+        expiresAt?: string | undefined;
+        provider?: "google" | "github" | undefined;
+        apiKey?: string | undefined;
+        apiKeyId?: string | undefined;
+        apiKeyName?: string | undefined;
+        user?: {
+            uid: string;
+            email: string;
+            name?: string | undefined;
+        } | undefined;
+    } | undefined;
+    api?: {
+        endpoint: string;
+    } | undefined;
+    skill?: {
+        installedVersion?: string | undefined;
+        installedAt?: string | undefined;
+    } | undefined;
+}, {
+    version?: number | undefined;
+    auth?: {
+        method?: "oauth" | "apikey" | undefined;
+        accessToken?: string | undefined;
+        refreshToken?: string | undefined;
+        expiresAt?: string | undefined;
+        provider?: "google" | "github" | undefined;
+        apiKey?: string | undefined;
+        apiKeyId?: string | undefined;
+        apiKeyName?: string | undefined;
+        user?: {
+            uid: string;
+            email: string;
+            name?: string | undefined;
+        } | undefined;
+    } | undefined;
+    api?: {
+        endpoint?: string | undefined;
+    } | undefined;
+    skill?: {
+        installedVersion?: string | undefined;
+        installedAt?: string | undefined;
+    } | undefined;
+}>;
+type Config = z.infer<typeof ConfigSchema>;
+/**
+ * Load configuration from file
+ */
+declare function loadConfig(): Config;
+/**
+ * Save configuration atomically with secure permissions
+ */
+declare function saveConfig(config: Config): void;
+/**
+ * Get the API endpoint (with override support)
+ */
+declare function getApiEndpoint(override?: string): string;
+/**
+ * Check if authenticated (OAuth or API Key)
+ */
+declare function isAuthenticated(): boolean;
+
+interface RequestOptions {
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    body?: unknown;
+    query?: Record<string, string>;
+    timeout?: number;
+    requireAuth?: boolean;
+}
+/**
+ * Make an authenticated API request with automatic token refresh (for OAuth)
+ * or API Key authentication
+ */
+declare function apiRequest<T>(path: string, options?: RequestOptions): Promise<T>;
+/**
+ * Verify API connection and authentication
+ */
+declare function verifyConnection(): Promise<{
+    connected: boolean;
+    authenticated: boolean;
+    authMethod?: 'oauth' | 'apikey';
+    user?: {
+        uid: string;
+        name?: string;
+        email?: string;
+    };
+}>;
+
+/**
+ * Skill installer - copies SKILL.md and references to Claude Code directories.
+ */
+interface InstallResult {
+    skillInstalled: boolean;
+    skillPath: string | null;
+    commandsInstalled: boolean;
+    commandsPath: string | null;
+    version: string;
+}
+/**
+ * Install skill files to Claude Code directories
+ */
+declare function installSkill(): InstallResult;
+/**
+ * Check if skill is installed and up to date
+ */
+declare function isSkillInstalled(): {
+    installed: boolean;
+    upToDate: boolean;
+    currentVersion?: string;
+};
+
+export { AuthError, BuilderError, type BuilderSession, type BuilderStateType, CLIError, type CLIResponse, type Diff, ErrorCodes, type ErrorDetail, type ErrorResponse, type SuccessResponse, ValidationError, type ValidationResult, type WorkflowDraft, type WorkflowNode, apiRequest, createSession, generateGraph, getApiEndpoint, getCurrentSession, installSkill, isAuthenticated, isSkillInstalled, loadConfig, loadSession, saveConfig, saveSession, validateDraft, verifyConnection };