@harborclient/core 0.1.1

package/dist/types/api/git.d.ts

@@ -0,0 +1,392 @@
+import type { GitCommitDetail, GitGraphLogResult, GitIdentity, GitLogEntry, GitOAuthFinishedEvent, GitRequestFileStatus, SourceControlStatus } from '../storage';
+/**
+ * IPC methods for git.
+ */
+export interface ApiGit {
+    /**
+     * Returns source-control status for each mounted git-backed connection.
+     */
+    listGitStatuses: () => Promise<Record<string, SourceControlStatus>>;
+    /**
+     * Subscribes to working-tree changes for git-backed connections (pull, external edits).
+     *
+     * @param callback - Handler invoked with the connection id whose tree changed.
+     * @returns Unsubscribe function.
+     */
+    onGitWorkingTreeChanged: (callback: (connectionId: string) => void) => () => void;
+    /**
+     * Subscribes to background GitHub OAuth completion for a git-backed connection.
+     *
+     * @param callback - Handler invoked when OAuth polling finishes or fails.
+     * @returns Unsubscribe function.
+     */
+    onGitOAuthFinished: (callback: (event: GitOAuthFinishedEvent) => void) => () => void;
+    /**
+     * Commits local changes for one git-backed collection.
+     *
+     * @param connectionId - Git connection id.
+     * @param collectionUuid - Stable collection uuid.
+     * @param message - Commit message.
+     * @param createHarborRoot - When true, creates the HarborClient subdirectory layout if missing.
+     */
+    gitCommit: (connectionId: string, collectionUuid: string, message: string, createHarborRoot?: boolean) => Promise<void>;
+    /**
+     * Returns local branch names for a git-backed connection.
+     *
+     * @param connectionId - Git connection id.
+     */
+    gitListBranches: (connectionId: string) => Promise<string[]>;
+    /**
+     * Creates a new branch from the current commit and checks it out.
+     *
+     * @param connectionId - Git connection id.
+     * @param name - Branch name to create.
+     */
+    gitCreateBranch: (connectionId: string, name: string) => Promise<void>;
+    /**
+     * Deletes a local branch that is not currently checked out.
+     *
+     * @param connectionId - Git connection id.
+     * @param name - Branch name to delete.
+     */
+    gitDeleteBranch: (connectionId: string, name: string) => Promise<void>;
+    /**
+     * Checks out an existing local branch when the working tree is clean.
+     *
+     * @param connectionId - Git connection id.
+     * @param name - Branch name to check out.
+     */
+    gitCheckoutBranch: (connectionId: string, name: string) => Promise<void>;
+    /**
+     * Merges another local branch into the current branch.
+     *
+     * @param connectionId - Git connection id.
+     * @param name - Local branch name to merge.
+     * @returns Conflict count after the merge attempt.
+     */
+    gitMergeBranch: (connectionId: string, name: string) => Promise<{
+        conflictCount: number;
+    }>;
+    /**
+     * Reads raw text from one repository-relative file in a git connection.
+     *
+     * @param args - Git connection id and repository-relative file path.
+     */
+    gitReadConflictFile: (args: {
+        connectionId: string;
+        filePath: string;
+    }) => Promise<{
+        path: string;
+        content: string;
+    }>;
+    /**
+     * Writes raw text to one repository-relative file and stages it.
+     *
+     * @param args - Git connection id, file path, and resolved file contents.
+     */
+    gitWriteConflictFile: (args: {
+        connectionId: string;
+        filePath: string;
+        content: string;
+    }) => Promise<void>;
+    /**
+     * Launches the configured external merge editor for one conflicted file.
+     *
+     * @param args - Git connection id and repository-relative file path.
+     */
+    gitOpenExternalMergeEditor: (args: {
+        connectionId: string;
+        filePath: string;
+    }) => Promise<void>;
+    /**
+     * Fetches from the configured remote without merging.
+     *
+     * @param connectionId - Git connection id.
+     */
+    gitFetch: (connectionId: string) => Promise<void>;
+    /**
+     * Validates credentials against the connection's remote URL.
+     *
+     * @param connectionId - Git connection id.
+     * @returns Whether the remote is empty and whether push access was confirmed.
+     */
+    gitTestConnection: (connectionId: string) => Promise<{
+        emptyRemote: boolean;
+        canPush?: boolean;
+    }>;
+    /**
+     * Pulls (fetch + merge) for a git-backed connection.
+     *
+     * @param connectionId - Git connection id.
+     */
+    gitPull: (connectionId: string) => Promise<void>;
+    /**
+     * Pushes commits to the remote for a git-backed connection.
+     *
+     * @param connectionId - Git connection id.
+     */
+    gitPush: (connectionId: string) => Promise<void>;
+    /**
+     * Suggests commit author name and email from repo-local and global git config.
+     *
+     * @param connectionId - Optional git connection id for repo-local lookup.
+     */
+    gitSuggestedAuthor: (connectionId?: string) => Promise<{
+        name: string;
+        email: string;
+    }>;
+    /**
+     * Permanently removes the local git clone directory for a git-backed connection.
+     *
+     * @param connectionId - Git connection id whose repoPath should be deleted.
+     */
+    gitDeleteRepoDirectory: (connectionId: string) => Promise<void>;
+    /**
+     * Returns recent commits for a git-backed connection.
+     *
+     * @param connectionId - Git connection id.
+     * @param depth - Maximum number of commits to return.
+     */
+    gitLog: (connectionId: string, depth?: number) => Promise<GitLogEntry[]>;
+    /**
+     * Returns graph-ready commit history for a git-backed connection.
+     *
+     * @param connectionId - Git connection id.
+     * @param depth - Maximum number of commits to include.
+     */
+    gitGraphLog: (connectionId: string, depth?: number) => Promise<GitGraphLogResult>;
+    /**
+     * Returns detailed metadata and changed files for one commit.
+     *
+     * @param connectionId - Git connection id.
+     * @param oid - Commit object id.
+     */
+    gitCommitDetail: (connectionId: string, oid: string) => Promise<GitCommitDetail>;
+    /**
+     * Returns a diff for one HarborClient file in a specific commit.
+     *
+     * @param args - Git connection id, commit oid, file path, and optional display metadata.
+     */
+    gitCommitFileDiff: (args: {
+        connectionId: string;
+        commitOid: string;
+        filePath: string;
+        status: 'added' | 'modified' | 'deleted';
+        displayName?: string;
+        resourceKind?: 'request' | 'document' | 'collection';
+        method?: string;
+        maxChars?: number;
+    }) => Promise<import('../../types').GitRequestDiffFileEntry>;
+    /**
+     * Returns uncommitted HarborClient-tree diffs for a git-backed collection.
+     *
+     * @param args - Collection uuid and optional diff output caps.
+     */
+    gitDiff: (args: {
+        collectionUuid: string;
+        maxFiles?: number;
+        maxCharsPerFile?: number;
+        maxTotalChars?: number;
+        /**
+         * When true, includes only staged changes (HEAD vs index). Defaults to working-tree changes.
+         */
+        stagedOnly?: boolean;
+        /**
+         * When true, omits untracked files (not yet added to git) from the diff payload.
+         */
+        excludeUntracked?: boolean;
+    }) => Promise<string>;
+    /**
+     * Returns git repository metadata for one git-backed collection.
+     *
+     * @param args - Collection uuid used to resolve the git-backed repository connection.
+     */
+    gitRepoInfo: (args: {
+        collectionUuid: string;
+    }) => Promise<string>;
+    /**
+     * Returns recent commit history for the repository that contains a collection.
+     *
+     * @param args - Collection uuid and optional commit depth.
+     */
+    gitCollectionCommits: (args: {
+        collectionUuid: string;
+        depth?: number;
+    }) => Promise<string>;
+    /**
+     * Returns per-file git metadata and commit history for one saved request.
+     *
+     * @param args - Collection uuid, request uuid, and optional history depth.
+     */
+    gitFileInfo: (args: {
+        collectionUuid: string;
+        requestUuid: string;
+        depth?: number;
+    }) => Promise<string>;
+    /**
+     * Returns a diff of one saved request file between two commits.
+     *
+     * @param args - Collection uuid, request uuid, commit range, and optional diff cap.
+     */
+    gitFileDiff: (args: {
+        collectionUuid: string;
+        requestUuid: string;
+        commitA: string;
+        commitB: string;
+        maxChars?: number;
+    }) => Promise<string>;
+    /**
+     * Returns per-request and per-document git status for one git-backed collection.
+     *
+     * @param connectionId - Git connection id.
+     * @param collectionUuid - Stable collection uuid.
+     */
+    gitListItemStatuses: (connectionId: string, collectionUuid: string) => Promise<Record<string, GitRequestFileStatus>>;
+    /**
+     * Returns the number of changed request/document files in one git-backed collection.
+     *
+     * @param connectionId - Git connection id.
+     * @param collectionUuid - Stable collection uuid.
+     */
+    gitChangedItemCount: (connectionId: string, collectionUuid: string) => Promise<number>;
+    /**
+     * Stages one request or markdown document in a git-backed collection.
+     *
+     * @param connectionId - Git connection id.
+     * @param collectionUuid - Stable collection uuid.
+     * @param itemUuid - Stable request or document uuid.
+     */
+    gitStageItem: (connectionId: string, collectionUuid: string, itemUuid: string) => Promise<void>;
+    /**
+     * Stages every untracked request and markdown document in a git-backed collection.
+     *
+     * @param connectionId - Git connection id.
+     * @param collectionUuid - Stable collection uuid.
+     * @returns Number of items staged.
+     */
+    gitStageAllUntrackedItems: (connectionId: string, collectionUuid: string) => Promise<number>;
+    /**
+     * Unstages one request or markdown document in a git-backed collection.
+     *
+     * @param connectionId - Git connection id.
+     * @param collectionUuid - Stable collection uuid.
+     * @param itemUuid - Stable request or document uuid.
+     */
+    gitUnstageItem: (connectionId: string, collectionUuid: string, itemUuid: string) => Promise<void>;
+    /**
+     * Discards working-tree changes for one request or markdown file in a git-backed collection.
+     *
+     * @param connectionId - Git connection id.
+     * @param collectionUuid - Stable collection uuid.
+     * @param filePath - Repository-relative changed file path.
+     * @param previousPaths - Optional deleted paths to restore when reverting a rename.
+     */
+    gitRevertFile: (connectionId: string, collectionUuid: string, filePath: string, previousPaths?: string[]) => Promise<void>;
+    /**
+     * Stores a PAT for a git-backed connection and validates credentials via fetch.
+     *
+     * @param connectionId - Git connection id.
+     * @param username - Basic Auth username.
+     * @param token - Personal access token.
+     */
+    gitSetPat: (connectionId: string, username: string, token: string) => Promise<void>;
+    /**
+     * Starts GitHub OAuth device flow for a git-backed connection.
+     *
+     * Returns the device-flow user code so the user can copy it before the browser
+     * opens. Call {@link gitCompleteOAuth} to open the verification URI and start polling.
+     *
+     * @param connectionId - Git connection id.
+     * @returns Device flow code and verification URL for the user to approve in a browser.
+     */
+    gitStartOAuth: (connectionId: string) => Promise<{
+        userCode: string;
+        verificationUri: string;
+    }>;
+    /**
+     * Opens the GitHub verification URI and starts background OAuth polling for a connection.
+     *
+     * Resolves immediately without waiting for GitHub approval.
+     *
+     * @param connectionId - Git connection id.
+     * @param verificationUri - Device-flow verification URL from {@link gitStartOAuth}.
+     */
+    gitCompleteOAuth: (connectionId: string, verificationUri: string) => Promise<void>;
+    /**
+     * Removes stored GitHub OAuth tokens and resets auth metadata for a git connection.
+     *
+     * @param connectionId - Git connection id.
+     */
+    gitRevokeOAuth: (connectionId: string) => Promise<void>;
+    /**
+     * Reads the origin remote URL from a local git repository path.
+     *
+     * SSH remotes are normalized to HTTPS. Returns null when the path is not a git
+     * repository or has no configured remotes.
+     *
+     * @param repoPath - Absolute path to a local git working tree.
+     */
+    gitReadRemoteUrl: (repoPath: string) => Promise<string | null>;
+    /**
+     * Lists saved git host identities.
+     */
+    listGitIdentities: () => Promise<GitIdentity[]>;
+    /**
+     * Stores a PAT for a git host and optionally validates credentials.
+     *
+     * @param host - Normalized lowercase git host key.
+     * @param username - Basic Auth username.
+     * @param token - Personal access token.
+     * @param testUrl - Optional repository URL used to validate the token.
+     * @param branch - Optional branch name used when validating against testUrl.
+     * @returns Empty-remote and push capability when validation ran; otherwise empty.
+     */
+    gitSetHostPat: (host: string, username: string, token: string, testUrl?: string, branch?: string) => Promise<{
+        emptyRemote?: boolean;
+        canPush?: boolean;
+    }>;
+    /**
+     * Starts GitHub OAuth device flow for a git host.
+     *
+     * Returns the device-flow user code so the user can copy it before the browser
+     * opens. Call {@link gitCompleteHostOAuth} to open the verification URI and start polling.
+     *
+     * @param host - Normalized lowercase git host key.
+     * @param testUrl - Optional repository URL used to validate after completion.
+     * @param branch - Optional branch name used when validating against testUrl.
+     */
+    gitStartHostOAuth: (host: string, testUrl?: string, branch?: string) => Promise<{
+        userCode: string;
+        verificationUri: string;
+    }>;
+    /**
+     * Opens the GitHub verification URI and starts background OAuth polling for a host.
+     *
+     * @param host - Normalized lowercase git host key.
+     * @param verificationUri - Device-flow verification URL from {@link gitStartHostOAuth}.
+     * @param testUrl - Optional repository URL used to validate after completion.
+     * @param branch - Optional branch name used when validating against testUrl.
+     */
+    gitCompleteHostOAuth: (host: string, verificationUri: string, testUrl?: string, branch?: string) => Promise<void>;
+    /**
+     * Revokes stored credentials for a git host.
+     *
+     * @param host - Normalized lowercase git host key.
+     */
+    gitRevokeHost: (host: string) => Promise<void>;
+    /**
+     * Returns whether a directory path is the root of a git working tree.
+     *
+     * @param repoPath - Absolute directory path to inspect.
+     */
+    gitIsRepo: (repoPath: string) => Promise<boolean>;
+    /**
+     * Initializes a git repository and optionally adds an origin remote.
+     *
+     * @param repoPath - Absolute directory path to initialize.
+     * @param url - HTTPS remote URL for origin, or empty to skip.
+     * @param branch - Default branch name.
+     */
+    gitInitRepo: (repoPath: string, url: string, branch: string) => Promise<void>;
+}
+//# sourceMappingURL=git.d.ts.map

package/dist/types/api/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../src/types/api/git.ts"],"names":[],"mappings":"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"}

package/dist/types/api/git.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=git.js.map

package/dist/types/api/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../../src/types/api/git.ts"],"names":[],"mappings":""}

package/dist/types/api/http.d.ts

@@ -0,0 +1,47 @@
+import type { KeyValue } from '../common';
+import type { ScriptRunInput, ScriptRunResult } from '../script';
+import type { SendRequestInput, SendResult } from '../request';
+/**
+ * IPC methods for http.
+ */
+export interface ApiHttp {
+    /**
+     * Sends an HTTP request via the main process.
+     *
+     * @param req - Request configuration to execute.
+     * @param requestId - Optional ID used to cancel the in-flight request.
+     * @returns Response metadata from the main process.
+     */
+    sendRequest: (req: SendRequestInput, requestId?: string) => Promise<SendResult>;
+    /**
+     * Cancels an in-flight HTTP request by ID.
+     *
+     * @param requestId - ID passed to sendRequest when the request was started.
+     */
+    cancelRequest: (requestId: string) => Promise<void>;
+    /**
+     * Returns cookies stored for a hostname.
+     *
+     * @param domain - Hostname to query.
+     */
+    getCookies: (domain: string) => Promise<KeyValue[]>;
+    /**
+     * Returns all hostnames with saved cookies.
+     */
+    listCookieDomains: () => Promise<string[]>;
+    /**
+     * Persists cookies for a hostname.
+     *
+     * @param domain - Hostname to update.
+     * @param cookies - Cookie rows to store.
+     */
+    setCookies: (domain: string, cookies: KeyValue[]) => Promise<void>;
+    /**
+     * Runs a pre/post script in a sandboxed JavaScript context.
+     *
+     * @param input - Script source, phase, request/response context, and variables.
+     * @returns Mutated request, variable sets, tests, and logs from the sandbox.
+     */
+    runScript: (input: ScriptRunInput) => Promise<ScriptRunResult>;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/types/api/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/types/api/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB;;;;;;OAMG;IACH,WAAW,EAAE,CAAC,GAAG,EAAE,gBAAgB,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAChF;;;;OAIG;IACH,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD;;;;OAIG;IACH,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACpD;;OAEG;IACH,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C;;;;;OAKG;IACH,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE;;;;;OAKG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;CAChE"}

package/dist/types/api/http.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=http.js.map

package/dist/types/api/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/types/api/http.ts"],"names":[],"mappings":""}

package/dist/types/api/index.d.ts

@@ -0,0 +1,28 @@
+import type { ApiDocuments } from './documents';
+import type { ApiCollections } from './collections';
+import type { ApiEnvironments } from './environments';
+import type { ApiSnippets } from './snippets';
+import type { ApiRequests } from './requests';
+import type { ApiHttp } from './http';
+import type { ApiWindow } from './window';
+import type { ApiSettings } from './settings';
+import type { ApiChats } from './chats';
+import type { ApiStorage } from './storage';
+import type { ApiTeamHub } from './teamHub';
+import type { ApiGit } from './git';
+import type { ApiSharing } from './sharing';
+import type { ApiBackup } from './backup';
+import type { ApiPlugins } from './plugins';
+import type { ApiCustomThemes } from './customThemes';
+import type { ApiDocs } from './docs';
+import type { ApiMcp } from './mcp';
+import type { ApiRequestHistory } from './requestHistory';
+import type { ApiTabGroups } from './tabGroup';
+import type { ApiTrash } from './trash';
+import type { ApiTerminal } from './terminal';
+/**
+ * IPC bridge API exposed to the renderer via contextBridge.
+ */
+export interface Api extends ApiCollections, ApiEnvironments, ApiSnippets, ApiRequests, ApiDocuments, ApiHttp, ApiWindow, ApiSettings, ApiChats, ApiStorage, ApiTeamHub, ApiGit, ApiSharing, ApiBackup, ApiPlugins, ApiDocs, ApiMcp, ApiRequestHistory, ApiTabGroups, ApiTrash, ApiTerminal, ApiCustomThemes {
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,GACf,SACE,cAAc,EACd,eAAe,EACf,WAAW,EACX,WAAW,EACX,YAAY,EACZ,OAAO,EACP,SAAS,EACT,WAAW,EACX,QAAQ,EACR,UAAU,EACV,UAAU,EACV,MAAM,EACN,UAAU,EACV,SAAS,EACT,UAAU,EACV,OAAO,EACP,MAAM,EACN,iBAAiB,EACjB,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,eAAe;CAAG"}

package/dist/types/api/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/api/index.ts"],"names":[],"mappings":""}

package/dist/types/api/mcp.d.ts

@@ -0,0 +1,77 @@
+import type { McpClientServer, McpClientServerListItem, McpClientServerStatus, McpClientToolInfo, McpServerSettings, McpServerStatus } from '../mcp';
+/**
+ * IPC methods for MCP server and client configuration.
+ */
+export interface ApiMcp {
+    /**
+     * Returns persisted MCP server settings.
+     */
+    getMcpServerSettings: () => Promise<McpServerSettings>;
+    /**
+     * Persists MCP server settings and applies the HTTP listener lifecycle.
+     *
+     * @param settings - Server enable flag, bind address, port, token, and exposed tools.
+     */
+    setMcpServerSettings: (settings: McpServerSettings) => Promise<McpServerSettings>;
+    /**
+     * Returns whether the local MCP HTTP server is running.
+     */
+    getMcpServerStatus: () => Promise<McpServerStatus>;
+    /**
+     * Generates a new MCP server bearer token and persists it.
+     */
+    regenerateMcpServerToken: () => Promise<McpServerSettings>;
+    /**
+     * Lists configured remote MCP client servers, including plugin registrations.
+     */
+    listMcpClientServers: () => Promise<McpClientServerListItem[]>;
+    /**
+     * Creates or updates a remote MCP client server and reconnects when enabled.
+     *
+     * @param server - Client server record; blank id inserts a new row.
+     */
+    saveMcpClientServer: (server: McpClientServer) => Promise<McpClientServerListItem[]>;
+    /**
+     * Deletes a remote MCP client server by id.
+     *
+     * @param id - Client server id to remove.
+     */
+    deleteMcpClientServer: (id: string) => Promise<McpClientServerListItem[]>;
+    /**
+     * Subscribes to MCP client server list changes from plugin registration lifecycle.
+     */
+    onMcpClientServersChanged: (callback: () => void) => () => void;
+    /**
+     * Returns connection status for each configured MCP client server.
+     */
+    listMcpClientServerStatuses: () => Promise<McpClientServerStatus[]>;
+    /**
+     * Lists cached MCP client tools available to the chat agent.
+     */
+    listMcpClientTools: () => Promise<McpClientToolInfo[]>;
+    /**
+     * Invokes a prefixed MCP client tool on the matching remote server.
+     *
+     * @param prefixedName - Tool name with mcp__ prefix from the model.
+     * @param args - Parsed tool arguments object.
+     */
+    mcpCallTool: (prefixedName: string, args: unknown) => Promise<string>;
+    /**
+     * Subscribes to MCP server tool invocations routed from external MCP clients.
+     */
+    onMcpServerToolInvoke: (callback: (message: {
+        requestId: number;
+        name: string;
+        args: unknown;
+    }) => void) => () => void;
+    /**
+     * Completes an MCP server tool invocation with a result or error.
+     */
+    completeMcpServerTool: (message: {
+        requestId: number;
+        ok: boolean;
+        result?: string;
+        error?: string;
+    }) => void;
+}
+//# sourceMappingURL=mcp.d.ts.map

package/dist/types/api/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/types/api/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EAChB,MAAM,QAAQ,CAAC;AAEhB;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,oBAAoB,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEvD;;;;OAIG;IACH,oBAAoB,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAElF;;OAEG;IACH,kBAAkB,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;IAEnD;;OAEG;IACH,wBAAwB,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE3D;;OAEG;IACH,oBAAoB,EAAE,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAE/D;;;;OAIG;IACH,mBAAmB,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAErF;;;;OAIG;IACH,qBAAqB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAE1E;;OAEG;IACH,yBAAyB,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAEhE;;OAEG;IACH,2BAA2B,EAAE,MAAM,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAEpE;;OAEG;IACH,kBAAkB,EAAE,MAAM,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAEvD;;;;;OAKG;IACH,WAAW,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAEtE;;OAEG;IACH,qBAAqB,EAAE,CACrB,QAAQ,EAAE,CAAC,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,KAC5E,MAAM,IAAI,CAAC;IAEhB;;OAEG;IACH,qBAAqB,EAAE,CAAC,OAAO,EAAE;QAC/B,SAAS,EAAE,MAAM,CAAC;QAClB,EAAE,EAAE,OAAO,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,KAAK,IAAI,CAAC;CACZ"}

package/dist/types/api/mcp.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp.js.map

package/dist/types/api/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../../src/types/api/mcp.ts"],"names":[],"mappings":""}