@pocketcoder/shared 0.0.2

package/dist/types/messages.d.ts

@@ -0,0 +1,821 @@
+/**
+ * WebSocket message types for communication between daemon, relay, and client.
+ * All types match the PRD exactly.
+ */
+/** All known message type strings */
+export type MessageType = "fs_list" | "fs_list_response" | "fs_read" | "fs_read_response" | "fs_write" | "fs_write_response" | "fs_create" | "fs_create_response" | "fs_delete" | "fs_delete_response" | "fs_search" | "fs_search_response" | "fs_replace" | "fs_replace_response" | "fs_changed" | "git_status" | "git_status_response" | "git_branches" | "git_branches_response" | "git_branch_create" | "git_branch_create_response" | "git_checkout" | "git_checkout_response" | "git_stage" | "git_stage_response" | "git_unstage" | "git_unstage_response" | "git_commit" | "git_commit_response" | "git_push" | "git_push_response" | "git_pull" | "git_pull_response" | "git_file_base" | "git_file_base_response" | "git_discard" | "git_discard_response" | "git_diff" | "git_diff_response" | "command_exec" | "command_output" | "command_exit" | "command_cancel" | "terminal_create" | "terminal_create_response" | "terminal_stdin" | "terminal_stdout" | "terminal_resize" | "terminal_kill" | "terminal_exit" | "agent_sessions_list" | "agent_sessions_list_response" | "agent_session_new" | "agent_session_new_response" | "agent_message" | "agent_message_response" | "agent_event" | "agent_cancel" | "agent_prompt_response" | "daemon_register" | "project_added" | "project_removed" | "machines_list" | "machines_list_response" | "projects_list" | "projects_list_response" | "project_create" | "project_create_response" | "project_delete" | "project_delete_response" | "credential_prompt" | "credential_response" | "sse_event" | "permission_reply" | "permission_reply_response" | "error";
+export interface MessageError {
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+}
+export interface FsNode {
+    name: string;
+    path: string;
+    type: "file" | "dir";
+    size?: number;
+    mtime?: string;
+    children?: FsNode[];
+    expanded?: boolean;
+}
+export interface FsChange {
+    kind: "create" | "modify" | "delete";
+    path: string;
+}
+export interface FsListRequest {
+    type: "fs_list";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        path: string;
+        depth?: number;
+    };
+}
+export interface FsListResponse {
+    type: "fs_list_response";
+    requestId: string;
+    sessionId: string;
+    payload?: {
+        path: string;
+        children: FsNode[];
+        seq: number;
+    };
+    error?: MessageError;
+}
+export interface FsReadRequest {
+    type: "fs_read";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        path: string;
+    };
+}
+export interface FsReadResponse {
+    type: "fs_read_response";
+    requestId: string;
+    payload?: {
+        path: string;
+        content: string;
+        encoding: string;
+        size: number;
+        mtime: string;
+    };
+    error?: MessageError;
+}
+export interface FsWriteRequest {
+    type: "fs_write";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        path: string;
+        content: string;
+        createDirs?: boolean;
+    };
+}
+export interface FsWriteResponse {
+    type: "fs_write_response";
+    requestId: string;
+    payload?: {
+        path: string;
+        size: number;
+        mtime: string;
+    };
+    error?: MessageError;
+}
+export interface FsCreateRequest {
+    type: "fs_create";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        path: string;
+        itemType: "file" | "directory";
+        createDirs?: boolean;
+    };
+}
+export interface FsCreateResponse {
+    type: "fs_create_response";
+    requestId: string;
+    payload?: {
+        path: string;
+        itemType: "file" | "directory";
+    };
+    error?: MessageError;
+}
+export interface FsDeleteRequest {
+    type: "fs_delete";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        path: string;
+    };
+}
+export interface FsDeleteResponse {
+    type: "fs_delete_response";
+    requestId: string;
+    payload?: {
+        path: string;
+    };
+    error?: MessageError;
+}
+export interface FsSearchMatch {
+    line: number;
+    content: string;
+    column?: number;
+}
+export interface FsSearchFileResult {
+    path: string;
+    matches: FsSearchMatch[];
+}
+export interface FsSearchRequest {
+    type: "fs_search";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        query: string;
+        glob?: string;
+        caseSensitive?: boolean;
+        regex?: boolean;
+    };
+}
+export interface FsSearchResponse {
+    type: "fs_search_response";
+    requestId: string;
+    payload?: {
+        query: string;
+        totalMatches: number;
+        truncated: boolean;
+        files: FsSearchFileResult[];
+    };
+    error?: MessageError;
+}
+export interface FsReplaceFileResult {
+    path: string;
+    replacements: number;
+}
+export interface FsReplaceRequest {
+    type: "fs_replace";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        find: string;
+        replace: string;
+        glob?: string;
+        caseSensitive?: boolean;
+        regex?: boolean;
+    };
+}
+export interface FsReplaceResponse {
+    type: "fs_replace_response";
+    requestId: string;
+    payload?: {
+        totalReplacements: number;
+        filesModified: FsReplaceFileResult[];
+    };
+    error?: MessageError;
+}
+export interface FsChangedEvent {
+    type: "fs_changed";
+    sessionId: string;
+    payload: {
+        seq: number;
+        changes: FsChange[];
+        changesTruncated?: boolean;
+    };
+}
+export interface GitFileStatus {
+    path: string;
+    status: string;
+}
+export interface GitBranch {
+    name: string;
+    remote: string | null;
+    ahead: number;
+    behind: number;
+}
+export interface GitStatusRequest {
+    type: "git_status";
+    requestId: string;
+    sessionId: string;
+    payload: Record<string, never>;
+}
+export interface GitStatusResponse {
+    type: "git_status_response";
+    requestId: string;
+    payload?: {
+        branch: string;
+        clean: boolean;
+        staged: GitFileStatus[];
+        unstaged: GitFileStatus[];
+        conflicts: GitFileStatus[];
+    };
+    error?: MessageError;
+}
+export interface GitBranchesRequest {
+    type: "git_branches";
+    requestId: string;
+    sessionId: string;
+    payload: Record<string, never>;
+}
+export interface GitBranchesResponse {
+    type: "git_branches_response";
+    requestId: string;
+    payload?: {
+        current: string;
+        branches: GitBranch[];
+    };
+    error?: MessageError;
+}
+export interface GitBranchCreateRequest {
+    type: "git_branch_create";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        name: string;
+        startPoint?: string;
+    };
+}
+export interface GitBranchCreateResponse {
+    type: "git_branch_create_response";
+    requestId: string;
+    payload?: {
+        name: string;
+        created: boolean;
+    };
+    error?: MessageError;
+}
+export interface GitCheckoutRequest {
+    type: "git_checkout";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        ref: string;
+    };
+}
+export interface GitCheckoutResponse {
+    type: "git_checkout_response";
+    requestId: string;
+    payload?: {
+        ref: string;
+        switched: boolean;
+    };
+    error?: MessageError;
+}
+export interface GitStageRequest {
+    type: "git_stage";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        paths: string[];
+    };
+}
+export interface GitStageResponse {
+    type: "git_stage_response";
+    requestId: string;
+    payload?: {
+        staged: string[];
+    };
+    error?: MessageError;
+}
+export interface GitUnstageRequest {
+    type: "git_unstage";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        paths: string[];
+    };
+}
+export interface GitUnstageResponse {
+    type: "git_unstage_response";
+    requestId: string;
+    payload?: {
+        unstaged: string[];
+    };
+    error?: MessageError;
+}
+export interface GitCommitRequest {
+    type: "git_commit";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        message: string;
+    };
+}
+export interface GitCommitResponse {
+    type: "git_commit_response";
+    requestId: string;
+    payload?: {
+        sha: string;
+        message: string;
+    };
+    error?: MessageError;
+}
+export interface GitPushRequest {
+    type: "git_push";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        remote?: string;
+        branch?: string;
+        force?: boolean;
+    };
+}
+export interface GitPushResponse {
+    type: "git_push_response";
+    requestId: string;
+    payload?: {
+        remote: string;
+        branch: string;
+        pushed: boolean;
+    };
+    error?: MessageError;
+}
+export interface GitPullRequest {
+    type: "git_pull";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        remote?: string;
+        branch?: string;
+    };
+}
+export interface GitPullResponse {
+    type: "git_pull_response";
+    requestId: string;
+    payload?: {
+        remote: string;
+        branch: string;
+        pulled: boolean;
+        conflicts?: string[];
+    };
+    error?: MessageError;
+}
+export interface GitFileBaseRequest {
+    type: "git_file_base";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        path: string;
+        ref?: string;
+    };
+}
+export interface GitFileBaseResponse {
+    type: "git_file_base_response";
+    requestId: string;
+    payload?: {
+        path: string;
+        ref: string;
+        content: string | null;
+    };
+    error?: MessageError;
+}
+export interface GitDiscardRequest {
+    type: "git_discard";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        paths?: string[];
+        all?: boolean;
+    };
+}
+export interface GitDiscardResponse {
+    type: "git_discard_response";
+    requestId: string;
+    payload?: {
+        discarded: number;
+    };
+    error?: MessageError;
+}
+export interface GitDiffRequest {
+    type: "git_diff";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        path?: string;
+        staged?: boolean;
+    };
+}
+export interface GitDiffFileResult {
+    path: string;
+    status: string;
+    additions: number;
+    deletions: number;
+    diff: string;
+}
+export interface GitDiffResponse {
+    type: "git_diff_response";
+    requestId: string;
+    payload?: {
+        files: GitDiffFileResult[];
+    };
+    error?: MessageError;
+}
+export type CredentialPromptType = "password" | "passphrase" | "username" | "pin";
+export interface CredentialPromptEvent {
+    type: "credential_prompt";
+    requestId: string;
+    payload: {
+        promptType: CredentialPromptType;
+        prompt: string;
+    };
+}
+export interface CredentialResponseRequest {
+    type: "credential_response";
+    requestId: string;
+    payload: {
+        value: string;
+        cancelled: boolean;
+    };
+}
+export interface SseEventMessage {
+    type: "sse_event";
+    payload: {
+        event: string;
+        data: string;
+        sessionId?: string;
+    };
+}
+export type PermissionReplyValue = "once" | "always" | "reject";
+export interface PermissionReplyRequest {
+    type: "permission_reply";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        permissionId: string;
+        reply: PermissionReplyValue;
+    };
+}
+export interface PermissionReplyResponse {
+    type: "permission_reply_response";
+    requestId: string;
+    payload?: {
+        status: number;
+        body?: unknown;
+    };
+    error?: MessageError;
+}
+export interface CommandExecRequest {
+    type: "command_exec";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        command: string;
+    };
+}
+export interface CommandOutputEvent {
+    type: "command_output";
+    requestId: string;
+    payload: {
+        stdoutChunk?: string;
+        stderrChunk?: string;
+    };
+}
+export interface CommandExitEvent {
+    type: "command_exit";
+    requestId: string;
+    payload: {
+        exitCode: number | null;
+        signal?: string;
+        durationMs: number;
+    };
+}
+export interface CommandCancelRequest {
+    type: "command_cancel";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        requestId: string;
+    };
+}
+export interface TerminalCreateRequest {
+    type: "terminal_create";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        cols?: number;
+        rows?: number;
+    };
+}
+export interface TerminalCreateResponse {
+    type: "terminal_create_response";
+    requestId: string;
+    payload: {
+        terminalId: string;
+    };
+    error?: MessageError;
+}
+export interface TerminalStdinRequest {
+    type: "terminal_stdin";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        terminalId: string;
+        data: string;
+    };
+}
+export interface TerminalStdoutEvent {
+    type: "terminal_stdout";
+    payload: {
+        terminalId: string;
+        data: string;
+    };
+}
+export interface TerminalResizeRequest {
+    type: "terminal_resize";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        terminalId: string;
+        cols: number;
+        rows: number;
+    };
+}
+export interface TerminalKillRequest {
+    type: "terminal_kill";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        terminalId: string;
+    };
+}
+export interface TerminalExitEvent {
+    type: "terminal_exit";
+    payload: {
+        terminalId: string;
+        exitCode: number;
+        signal?: number;
+    };
+}
+export type AgentEvent = {
+    type: "init";
+    sessionId: string;
+    tools: string[];
+    model: string;
+} | {
+    type: "thinking";
+    content: string;
+} | {
+    type: "text";
+    content: string;
+} | {
+    type: "tool_use";
+    tool: string;
+    input: Record<string, unknown>;
+} | {
+    type: "tool_complete";
+    toolUseId: string;
+} | {
+    type: "file_edit";
+    path: string;
+    diff?: string;
+} | {
+    type: "file_create";
+    path: string;
+} | {
+    type: "file_delete";
+    path: string;
+} | {
+    type: "prompt";
+    questions: Array<{
+        question: string;
+        header: string;
+        options: Array<{
+            label: string;
+            description: string;
+        }>;
+        multiSelect: boolean;
+    }>;
+} | {
+    type: "done";
+    usage?: {
+        input_tokens: number;
+        output_tokens: number;
+    };
+    cancelled?: boolean;
+    error?: string;
+};
+export interface AgentSessionInfo {
+    agentSessionId: string;
+    lastUsedAt: string;
+    title: string | null;
+}
+export interface AgentSessionsListRequest {
+    type: "agent_sessions_list";
+    requestId: string;
+    sessionId: string;
+    payload: Record<string, never>;
+}
+export interface AgentSessionsListResponse {
+    type: "agent_sessions_list_response";
+    requestId: string;
+    payload?: {
+        sessions: AgentSessionInfo[];
+    };
+    error?: MessageError;
+}
+export interface AgentSessionNewRequest {
+    type: "agent_session_new";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        content: string;
+    };
+}
+export interface AgentSessionNewResponse {
+    type: "agent_session_new_response";
+    requestId: string;
+    payload?: {
+        agentSessionId: string;
+    };
+    error?: MessageError;
+}
+export interface AgentMessageRequest {
+    type: "agent_message";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        agentSessionId: string;
+        content: string;
+    };
+}
+export interface AgentMessageResponse {
+    type: "agent_message_response";
+    requestId: string;
+    payload?: {
+        queued?: boolean;
+        started?: boolean;
+    };
+    error?: MessageError;
+}
+export interface AgentEventMessage {
+    type: "agent_event";
+    sessionId: string;
+    payload: {
+        agentSessionId: string;
+        event: AgentEvent;
+    };
+}
+export interface AgentCancelRequest {
+    type: "agent_cancel";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        agentSessionId: string;
+    };
+}
+export interface AgentPromptResponseRequest {
+    type: "agent_prompt_response";
+    requestId: string;
+    sessionId: string;
+    payload: {
+        agentSessionId: string;
+        response: string;
+    };
+}
+export interface MachineMetadata {
+    os: "darwin" | "linux" | "win32";
+    osVersion: string;
+    hostname: string;
+    username: string;
+    label: string | null;
+}
+export interface RegisterProject {
+    projectId: string;
+    name: string;
+    path?: string;
+}
+export interface DaemonRegisterMessage {
+    type: "daemon_register";
+    payload: {
+        machineKey: string;
+        token: string;
+        machine: MachineMetadata;
+        projects: RegisterProject[];
+    };
+}
+export interface ProjectAddedMessage {
+    type: "project_added";
+    payload: {
+        projectId: string;
+        name: string;
+        path: string;
+    };
+}
+export interface ProjectRemovedMessage {
+    type: "project_removed";
+    payload: {
+        projectId: string;
+    };
+}
+export interface MachinesListRequest {
+    type: "machines_list";
+    requestId: string;
+    payload: Record<string, never>;
+}
+export interface MachineInfo {
+    machineKey: string;
+    label: string;
+    os: string;
+    osVersion: string;
+    username: string;
+    online: boolean;
+    lastSeen: string;
+    projectCount: number;
+}
+export interface MachinesListResponse {
+    type: "machines_list_response";
+    requestId: string;
+    payload?: {
+        machines: MachineInfo[];
+    };
+    error?: MessageError;
+}
+export interface ProjectsListRequest {
+    type: "projects_list";
+    requestId: string;
+    payload: {
+        machineKey: string;
+    };
+}
+export interface ProjectInfo {
+    projectId: string;
+    name: string;
+    path: string;
+    hasActiveSession: boolean;
+    lastAccessed: string;
+}
+export interface ProjectsListResponse {
+    type: "projects_list_response";
+    requestId: string;
+    payload?: {
+        projects: ProjectInfo[];
+    };
+    error?: MessageError;
+}
+export interface ProjectCreateRequest {
+    type: "project_create";
+    requestId: string;
+    payload: {
+        path: string;
+    };
+}
+export interface ProjectCreateResponse {
+    type: "project_create_response";
+    requestId: string;
+    payload?: {
+        project: {
+            projectId: string;
+            name: string;
+            path: string;
+        };
+    };
+    error?: MessageError;
+}
+export interface ProjectDeleteRequest {
+    type: "project_delete";
+    requestId: string;
+    payload: {
+        projectId: string;
+    };
+}
+export interface ProjectDeleteResponse {
+    type: "project_delete_response";
+    requestId: string;
+    payload?: {
+        success: boolean;
+    };
+    error?: MessageError;
+}
+export interface ErrorResponse {
+    type: "error";
+    requestId: string;
+    error: MessageError;
+}
+export type RequestMessage = FsListRequest | FsReadRequest | FsWriteRequest | FsCreateRequest | FsDeleteRequest | FsSearchRequest | FsReplaceRequest | GitStatusRequest | GitBranchesRequest | GitBranchCreateRequest | GitCheckoutRequest | GitStageRequest | GitUnstageRequest | GitCommitRequest | GitPushRequest | GitPullRequest | GitFileBaseRequest | GitDiscardRequest | GitDiffRequest | CommandExecRequest | CommandCancelRequest | TerminalCreateRequest | TerminalStdinRequest | TerminalResizeRequest | TerminalKillRequest | AgentSessionsListRequest | AgentSessionNewRequest | AgentMessageRequest | AgentCancelRequest | AgentPromptResponseRequest | MachinesListRequest | ProjectsListRequest | ProjectCreateRequest | ProjectDeleteRequest | CredentialResponseRequest | PermissionReplyRequest;
+export type ResponseMessage = FsListResponse | FsReadResponse | FsWriteResponse | FsCreateResponse | FsDeleteResponse | FsSearchResponse | FsReplaceResponse | GitStatusResponse | GitBranchesResponse | GitBranchCreateResponse | GitCheckoutResponse | GitStageResponse | GitUnstageResponse | GitCommitResponse | GitPushResponse | GitPullResponse | GitFileBaseResponse | GitDiscardResponse | GitDiffResponse | AgentSessionsListResponse | AgentSessionNewResponse | AgentMessageResponse | MachinesListResponse | ProjectsListResponse | ProjectCreateResponse | ProjectDeleteResponse | TerminalCreateResponse | PermissionReplyResponse | ErrorResponse;
+export type EventMessage = FsChangedEvent | CommandOutputEvent | TerminalStdoutEvent | TerminalExitEvent | CommandExitEvent | AgentEventMessage | CredentialPromptEvent | SseEventMessage;
+export type Message = RequestMessage | ResponseMessage | EventMessage | DaemonRegisterMessage | ProjectAddedMessage | ProjectRemovedMessage;
+/** Validate that value looks like an fs_list request */
+export declare function isFsListRequest(value: unknown): value is FsListRequest;
+/** Validate that value looks like an fs_read request */
+export declare function isFsReadRequest(value: unknown): value is FsReadRequest;
+/** Validate that value looks like a git_status request */
+export declare function isGitStatusRequest(value: unknown): value is GitStatusRequest;
+/** Validate that value looks like an agent_message request */
+export declare function isAgentMessageRequest(value: unknown): value is AgentMessageRequest;
+/** Validate that value looks like an error response */
+export declare function isErrorResponse(value: unknown): value is ErrorResponse;
+/** Validate that value is a valid message (has at least a type field) */
+export declare function isMessage(value: unknown): value is Message;
+/** Validate that value is a request message (has type, requestId, and usually sessionId) */
+export declare function isRequestMessage(value: unknown): value is RequestMessage;
+/** Validate that value is an AgentEvent with type 'init' */
+export declare function isAgentInitEvent(value: unknown): value is Extract<AgentEvent, {
+    type: "init";
+}>;
+/** Validate that value is an AgentEvent with type 'done' */
+export declare function isAgentDoneEvent(value: unknown): value is Extract<AgentEvent, {
+    type: "done";
+}>;
+/** Validate that value is any valid AgentEvent (has a recognized type) */
+export declare function isAgentEvent(value: unknown): value is AgentEvent;
+//# sourceMappingURL=messages.d.ts.map