@h-rig/contracts 0.0.6-alpha.157 → 0.0.6-alpha.158

package/dist/src/ipc.d.ts

@@ -1,248 +0,0 @@
-import type { GitCheckoutInput, GitCreateBranchInput, GitCreateWorktreeInput, GitCreateWorktreeResult, GitInitInput, GitListBranchesInput, GitListBranchesResult, GitPullInput, GitPullResult, GitReadWorkingTreePatchInput, GitReadWorkingTreePatchResult, GitRemoveWorktreeInput, GitRunStackedActionInput, GitRunStackedActionResult, GitStatusInput, GitStatusResult } from "./git";
-import type { ProjectListDirectoryInput, ProjectListDirectoryResult, ProjectSearchEntriesInput, ProjectSearchEntriesResult, ProjectReadFileInput, ProjectReadFileResult, ProjectWriteFileInput, ProjectWriteFileResult } from "./project";
-import type { ServerConfig } from "./server";
-import type { RigCreateAdhocRunInput, RigCreateTaskRunInput, RigDeleteRunInput, RigEnqueueTaskInput, RigGetRunLogsInput, RigGetRunLogsResult, RigGetTaskArtifactsResult, RigRunLogAppendedPayload, RigGetWorkspaceInput, RigGetWorkspaceResult, RigListWorkspacesResult, RigMutationResult, RigInterruptRunInput, RigQueueRunSteeringInput, RigQueueRunSteeringResult, RigResumeRunInput, RigResolveApprovalInput, RigResolveUserInputInput, RigSnapshot, RigStopRunInput, RigSubmitRunMessageInput } from "./rig";
-import type { TerminalClearInput, TerminalCloseInput, TerminalEvent, TerminalOpenInput, TerminalResizeInput, TerminalSessionSnapshot, TerminalWriteInput } from "./terminal";
-import type { ServerUpsertKeybindingInput, ServerUpsertKeybindingResult } from "./server";
-import type { ClientOrchestrationCommand, OrchestrationGetFullThreadDiffInput, OrchestrationGetFullThreadDiffResult, OrchestrationGetTurnDiffInput, OrchestrationGetTurnDiffResult, OrchestrationEvent, OrchestrationReadModel } from "./orchestration";
-import type { EngineEvent } from "./engine";
-import { EditorId } from "./editor";
-export interface ContextMenuItem<T extends string = string> {
-    id: T;
-    label: string;
-    destructive?: boolean;
-}
-export type DesktopUpdateStatus = "disabled" | "idle" | "checking" | "up-to-date" | "available" | "downloading" | "downloaded" | "error";
-export interface DesktopUpdateState {
-    enabled: boolean;
-    status: DesktopUpdateStatus;
-    currentVersion: string;
-    availableVersion: string | null;
-    downloadedVersion: string | null;
-    downloadPercent: number | null;
-    checkedAt: string | null;
-    message: string | null;
-    errorContext: "check" | "download" | "install" | null;
-    canRetry: boolean;
-}
-export interface DesktopUpdateActionResult {
-    accepted: boolean;
-    completed: boolean;
-    state: DesktopUpdateState;
-}
-export type RigProjectConfigStatus = "rig-config-ts" | "rig-config-json" | "legacy-task-config" | "missing";
-export interface DesktopRigSetupState {
-    rootPath: string | null;
-    ready: boolean;
-    wsUrl: string | null;
-    /**
-     * What kind of Rig configuration the project at `rootPath` has. The
-     * desktop main process probes the filesystem at boot and on
-     * `setRigRoot`; the renderer reads this to decide whether to show an
-     * onboarding banner ("Run `rig init`") or the normal dashboard.
-     */
-    configStatus: RigProjectConfigStatus;
-}
-export interface RigConfigWriteResult {
-    ok: boolean;
-    /** Absolute path to the file that was written. */
-    configPath: string;
-    /** Filesystem error message when `ok === false`. */
-    error?: string;
-    /** Updated setup state — `configStatus` reflects the post-write probe. */
-    setup: DesktopRigSetupState;
-}
-export interface RigConfigReadResult {
-    /** The raw rig.config.{ts,json} source, or null if none exists. */
-    source: string | null;
-    /** Which file was read; null when no config exists. */
-    configPath: string | null;
-}
-export interface ProjectGitRemoteInfo {
-    /** The raw origin URL, e.g. `git@github.com:humanity-org/humanwork.git`. */
-    url: string;
-    /** Parsed host, e.g. `github.com`. */
-    host: string | null;
-    /** Parsed owner/org, e.g. `humanity-org`. */
-    owner: string | null;
-    /** Parsed repository name (no `.git` suffix), e.g. `humanwork`. */
-    repo: string | null;
-}
-export interface DesktopBridge {
-    getWsUrl: () => string | null;
-    getRigSetup: () => Promise<DesktopRigSetupState>;
-    setRigRoot: (rootPath: string) => Promise<DesktopRigSetupState>;
-    /**
-     * Read the raw rig.config.{ts,json} from the project at `rootPath`.
-     * Returns `{ source: null }` when no config exists. Used by the in-app
-     * Settings screen to populate the form from the existing file.
-     */
-    readRigConfigRaw: (rootPath: string) => Promise<RigConfigReadResult>;
-    /**
-     * Write rig.config.ts to the project root atomically (temp-file + rename).
-     * Refreshes the cached setup state and returns it post-write so callers
-     * can route past the setup gate. Used by both the in-app setup wizard
-     * and the Settings → Project section.
-     */
-    writeRigConfig: (rootPath: string, source: string) => Promise<RigConfigWriteResult>;
-    /**
-     * Inspect the project's git origin to auto-fill setup wizard fields.
-     * Runs `git -C <rootPath> remote get-url origin` and parses owner/repo.
-     * Returns null when the project isn't a git repo, has no origin, or the
-     * URL doesn't match a recognized GitHub-style pattern. The wizard uses
-     * this to prefill the GitHub owner/repo step instead of making the
-     * operator type values that are already in `.git/config`.
-     */
-    getProjectGitRemote: (rootPath: string) => Promise<ProjectGitRemoteInfo | null>;
-    pickFolder: () => Promise<string | null>;
-    confirm: (message: string) => Promise<boolean>;
-    showContextMenu: <T extends string>(items: readonly ContextMenuItem<T>[], position?: {
-        x: number;
-        y: number;
-    }) => Promise<T | null>;
-    openExternal: (url: string) => Promise<boolean>;
-    onMenuAction: (listener: (action: string) => void) => () => void;
-    getUpdateState: () => Promise<DesktopUpdateState>;
-    downloadUpdate: () => Promise<DesktopUpdateActionResult>;
-    installUpdate: () => Promise<DesktopUpdateActionResult>;
-    onUpdateState: (listener: (state: DesktopUpdateState) => void) => () => void;
-}
-export interface NativeApi {
-    dialogs: {
-        pickFolder: () => Promise<string | null>;
-        confirm: (message: string) => Promise<boolean>;
-    };
-    terminal: {
-        open: (input: TerminalOpenInput) => Promise<TerminalSessionSnapshot>;
-        write: (input: TerminalWriteInput) => Promise<void>;
-        resize: (input: TerminalResizeInput) => Promise<void>;
-        clear: (input: TerminalClearInput) => Promise<void>;
-        restart: (input: TerminalOpenInput) => Promise<TerminalSessionSnapshot>;
-        close: (input: TerminalCloseInput) => Promise<void>;
-        onEvent: (callback: (event: TerminalEvent) => void) => () => void;
-    };
-    projects: {
-        listDirectory: (input: ProjectListDirectoryInput) => Promise<ProjectListDirectoryResult>;
-        searchEntries: (input: ProjectSearchEntriesInput) => Promise<ProjectSearchEntriesResult>;
-        readFile: (input: ProjectReadFileInput) => Promise<ProjectReadFileResult>;
-        writeFile: (input: ProjectWriteFileInput) => Promise<ProjectWriteFileResult>;
-    };
-    shell: {
-        openInEditor: (cwd: string, editor: EditorId) => Promise<void>;
-        openExternal: (url: string) => Promise<void>;
-    };
-    git: {
-        listBranches: (input: GitListBranchesInput) => Promise<GitListBranchesResult>;
-        createWorktree: (input: GitCreateWorktreeInput) => Promise<GitCreateWorktreeResult>;
-        removeWorktree: (input: GitRemoveWorktreeInput) => Promise<void>;
-        createBranch: (input: GitCreateBranchInput) => Promise<void>;
-        checkout: (input: GitCheckoutInput) => Promise<void>;
-        init: (input: GitInitInput) => Promise<void>;
-        pull: (input: GitPullInput) => Promise<GitPullResult>;
-        status: (input: GitStatusInput) => Promise<GitStatusResult>;
-        readWorkingTreePatch: (input: GitReadWorkingTreePatchInput) => Promise<GitReadWorkingTreePatchResult>;
-        runStackedAction: (input: GitRunStackedActionInput) => Promise<GitRunStackedActionResult>;
-    };
-    contextMenu: {
-        show: <T extends string>(items: readonly ContextMenuItem<T>[], position?: {
-            x: number;
-            y: number;
-        }) => Promise<T | null>;
-    };
-    server: {
-        getConfig: () => Promise<ServerConfig>;
-        upsertKeybinding: (input: ServerUpsertKeybindingInput) => Promise<ServerUpsertKeybindingResult>;
-    };
-    rig: {
-        getSnapshot: () => Promise<RigSnapshot>;
-        listWorkspaces: () => Promise<RigListWorkspacesResult>;
-        getWorkspace: (input: RigGetWorkspaceInput) => Promise<RigGetWorkspaceResult>;
-        getRunLogs: (input: RigGetRunLogsInput) => Promise<RigGetRunLogsResult>;
-        replayEvents: (fromSequenceExclusive: number) => Promise<EngineEvent[]>;
-        createAdhocRun: (input: RigCreateAdhocRunInput) => Promise<RigMutationResult>;
-        createTaskRun: (input: RigCreateTaskRunInput) => Promise<RigMutationResult>;
-        deleteRun: (input: RigDeleteRunInput) => Promise<RigMutationResult>;
-        enqueueTask: (input: RigEnqueueTaskInput) => Promise<RigMutationResult>;
-        resumeRun: (input: RigResumeRunInput) => Promise<RigMutationResult>;
-        submitRunMessage: (input: RigSubmitRunMessageInput) => Promise<RigMutationResult>;
-        queueRunSteering: (input: RigQueueRunSteeringInput) => Promise<RigQueueRunSteeringResult>;
-        interruptRun: (input: RigInterruptRunInput) => Promise<RigMutationResult>;
-        stopRun: (input: RigStopRunInput) => Promise<RigMutationResult>;
-        resolveApproval: (input: RigResolveApprovalInput) => Promise<RigMutationResult>;
-        resolveUserInput: (input: RigResolveUserInputInput) => Promise<RigMutationResult>;
-        getTaskArtifacts: (taskId: string) => Promise<RigGetTaskArtifactsResult>;
-        onEvent: (callback: (event: EngineEvent) => void) => () => void;
-        onRunLogAppended: (callback: (payload: RigRunLogAppendedPayload) => void) => () => void;
-    };
-    orchestration: {
-        getSnapshot: () => Promise<OrchestrationReadModel>;
-        dispatchCommand: (command: ClientOrchestrationCommand) => Promise<{
-            sequence: number;
-        }>;
-        getTurnDiff: (input: OrchestrationGetTurnDiffInput) => Promise<OrchestrationGetTurnDiffResult>;
-        getFullThreadDiff: (input: OrchestrationGetFullThreadDiffInput) => Promise<OrchestrationGetFullThreadDiffResult>;
-        replayEvents: (fromSequenceExclusive: number) => Promise<OrchestrationEvent[]>;
-        onDomainEvent: (callback: (event: OrchestrationEvent) => void) => () => void;
-    };
-    remote: {
-        testEndpoint: (input: {
-            host: string;
-            port: number;
-            token?: string;
-        }) => Promise<{
-            latencyMs: number;
-        }>;
-        listEndpoints: () => Promise<unknown[]>;
-        registerEndpoint: (input: {
-            alias: string;
-            host: string;
-            port: number;
-            token?: string;
-            autoConnect?: boolean;
-        }) => Promise<unknown>;
-        removeEndpoint: (input: {
-            endpointId: string;
-        }) => Promise<void>;
-        connect: (input: {
-            endpointId: string;
-        }) => Promise<void>;
-        disconnect: (input: {
-            endpointId: string;
-        }) => Promise<void>;
-        createRunForTask: (input: {
-            endpointId: string;
-            taskId: string;
-            runId: string;
-            workspaceId: string;
-            runtimeMode?: string;
-            interactionMode?: string;
-        }) => Promise<{
-            ok: boolean;
-        }>;
-        terminalOpen: (input: {
-            endpointId: string;
-            threadId: string;
-            terminalId: string;
-            cwd?: string;
-            env?: Record<string, string>;
-        }) => Promise<unknown>;
-        terminalWrite: (input: {
-            endpointId: string;
-            threadId: string;
-            terminalId: string;
-            data: string;
-        }) => Promise<void>;
-        terminalResize: (input: {
-            endpointId: string;
-            threadId: string;
-            terminalId: string;
-            cols: number;
-            rows: number;
-        }) => Promise<void>;
-        terminalClose: (input: {
-            endpointId: string;
-            threadId: string;
-            terminalId: string;
-        }) => Promise<void>;
-    };
-}