@haex-space/vault-sdk 2.5.126 → 2.6.0

package/dist/{client-Bjbn7M-G.d.mts → client-B_S7ntUI.d.mts}

@@ -1,4 +1,4 @@
-import { b as HaexHubEvent, c as EXTERNAL_EVENTS, D as DatabaseQueryResult, M as Migration, d as MigrationResult, W as WebRequestOptions, e as WebResponse, H as HaexHubConfig, a as ExtensionInfo, A as ApplicationContext, f as DatabasePermissionRequest, P as PermissionResponse, S as SearchResult, g as EventCallback } from './types-DkB9cExr.mjs';
+import { b as HaexHubEvent, c as EXTERNAL_EVENTS, D as DatabaseQueryResult, M as Migration, d as MigrationResult, W as WebRequestOptions, e as WebResponse, f as EventCallback, H as HaexHubConfig, a as ExtensionInfo, A as ApplicationContext, g as DatabasePermissionRequest, P as PermissionResponse, S as SearchResult } from './types-B1O6KckK.mjs';
 import { SqliteRemoteDatabase } from 'drizzle-orm/sqlite-proxy';
 
 /**
@@ -1095,6 +1095,72 @@ declare class SpacesAPI {
     listSyncBackendsAsync(): Promise<SyncBackendInfo[]>;
 }
 
+interface ShellCreateOptions {
+    /** Shell executable (e.g., "/bin/bash"). If omitted, uses $SHELL or /bin/sh. */
+    shell?: string;
+    /** Working directory. If omitted, uses home directory. */
+    cwd?: string;
+    /** Initial terminal columns (default: 80) */
+    cols?: number;
+    /** Initial terminal rows (default: 24) */
+    rows?: number;
+    /** Environment variables to set */
+    env?: Record<string, string>;
+}
+interface ShellCreateResponse {
+    sessionId: string;
+}
+interface ShellOutputEvent {
+    sessionId: string;
+    data: string;
+}
+interface ShellExitEvent {
+    sessionId: string;
+    exitCode: number | null;
+}
+declare class ShellAPI {
+    private readonly sdk;
+    constructor(sdk: HaexVaultSdk);
+    /**
+     * Create a new PTY shell session.
+     * Returns a session ID used for subsequent write/resize/close operations.
+     * Listen for shell output via `sdk.shell.onData()`.
+     */
+    create(options?: ShellCreateOptions): Promise<string>;
+    /**
+     * Write data to a shell session's stdin.
+     * Typically used to forward terminal keystrokes.
+     */
+    write(sessionId: string, data: string): Promise<void>;
+    /**
+     * Resize a shell session's terminal.
+     * Should be called when the terminal view is resized.
+     */
+    resize(sessionId: string, cols: number, rows: number): Promise<void>;
+    /**
+     * Close a shell session.
+     * This terminates the underlying PTY process.
+     */
+    close(sessionId: string): Promise<void>;
+    /**
+     * Register a callback for shell output data.
+     * The callback receives output from the PTY's stdout/stderr.
+     */
+    onData(callback: EventCallback): void;
+    /**
+     * Register a callback for shell session exit.
+     */
+    onExit(callback: EventCallback): void;
+    /**
+     * Remove a shell output callback.
+     */
+    offData(callback: EventCallback): void;
+    /**
+     * Remove a shell exit callback.
+     */
+    offExit(callback: EventCallback): void;
+}
+
 /**
  * HaexVault Client
  *
@@ -1128,6 +1194,7 @@ declare class HaexVaultSdk {
     readonly remoteStorage: RemoteStorageAPI;
     readonly localsend: LocalSendAPI;
     readonly spaces: SpacesAPI;
+    readonly shell: ShellAPI;
     constructor(config?: HaexHubConfig);
     ready(): Promise<void>;
     get setupCompleted(): boolean;
@@ -1171,4 +1238,4 @@ declare class HaexVaultSdk {
     private log;
 }
 
-export { type TransferState as $, type AuthorizedClient as A, type BlockedClient as B, type RequestedExtension as C, DatabaseAPI as D, type ExternalAuthDecision as E, type FileStat as F, type SelectFileOptions as G, HaexVaultSdk as H, type SelectFolderOptions as I, type ServerInfo as J, type ServerStatus as K, LOCALSEND_EVENTS as L, type SessionAuthorization as M, type SharedSpace as N, type SpaceAccessTokenInfo as O, type PendingAuthorization as P, type SpaceAssignment as Q, RemoteStorageAPI as R, StorageAPI as S, type SpaceInvite as T, type UpdateBackendRequest as U, type SpaceKeyGrantInfo as V, type SpaceMemberInfo as W, SpacesAPI as X, type SyncBackendInfo as Y, type TransferDirection as Z, type TransferProgress as _, type SpaceRole as a, WebAPI as a0, canExternalClientSendRequests as a1, isExternalClientConnected as a2, type DecryptedSpace as b, type Device as c, type DeviceInfo as d, type DeviceType as e, type DirEntry as f, type ExternalConnection as g, ExternalConnectionErrorCode as h, ExternalConnectionState as i, type ExternalRequest as j, type ExternalRequestEvent as k, type ExternalRequestHandler as l, type ExternalRequestPayload as m, type ExternalResponse as n, FilesystemAPI as o, LocalSendAPI as p, type LocalSendEvent as q, type FileInfo as r, type LocalSendSettings as s, type PendingTransfer as t, PermissionsAPI as u, type AddBackendRequest as v, type S3Config as w, type S3PublicConfig as x, type StorageBackendInfo as y, type StorageObjectInfo as z };
+export { type SpaceMemberInfo as $, type AuthorizedClient as A, type BlockedClient as B, type RequestedExtension as C, DatabaseAPI as D, type ExternalAuthDecision as E, type FileStat as F, type SelectFileOptions as G, HaexVaultSdk as H, type SelectFolderOptions as I, type ServerInfo as J, type ServerStatus as K, LOCALSEND_EVENTS as L, type SessionAuthorization as M, type SharedSpace as N, ShellAPI as O, type PendingAuthorization as P, type ShellCreateOptions as Q, RemoteStorageAPI as R, StorageAPI as S, type ShellCreateResponse as T, type UpdateBackendRequest as U, type ShellExitEvent as V, type ShellOutputEvent as W, type SpaceAccessTokenInfo as X, type SpaceAssignment as Y, type SpaceInvite as Z, type SpaceKeyGrantInfo as _, type SpaceRole as a, SpacesAPI as a0, type SyncBackendInfo as a1, type TransferDirection as a2, type TransferProgress as a3, type TransferState as a4, WebAPI as a5, canExternalClientSendRequests as a6, isExternalClientConnected as a7, type DecryptedSpace as b, type Device as c, type DeviceInfo as d, type DeviceType as e, type DirEntry as f, type ExternalConnection as g, ExternalConnectionErrorCode as h, ExternalConnectionState as i, type ExternalRequest as j, type ExternalRequestEvent as k, type ExternalRequestHandler as l, type ExternalRequestPayload as m, type ExternalResponse as n, FilesystemAPI as o, LocalSendAPI as p, type LocalSendEvent as q, type FileInfo as r, type LocalSendSettings as s, type PendingTransfer as t, PermissionsAPI as u, type AddBackendRequest as v, type S3Config as w, type S3PublicConfig as x, type StorageBackendInfo as y, type StorageObjectInfo as z };

package/dist/{client--kKvwWc0.d.ts → client-Bl2s5tIZ.d.ts}

@@ -1,4 +1,4 @@
-import { b as HaexHubEvent, c as EXTERNAL_EVENTS, D as DatabaseQueryResult, M as Migration, d as MigrationResult, W as WebRequestOptions, e as WebResponse, H as HaexHubConfig, a as ExtensionInfo, A as ApplicationContext, f as DatabasePermissionRequest, P as PermissionResponse, S as SearchResult, g as EventCallback } from './types-DkB9cExr.js';
+import { b as HaexHubEvent, c as EXTERNAL_EVENTS, D as DatabaseQueryResult, M as Migration, d as MigrationResult, W as WebRequestOptions, e as WebResponse, f as EventCallback, H as HaexHubConfig, a as ExtensionInfo, A as ApplicationContext, g as DatabasePermissionRequest, P as PermissionResponse, S as SearchResult } from './types-B1O6KckK.js';
 import { SqliteRemoteDatabase } from 'drizzle-orm/sqlite-proxy';
 
 /**
@@ -1095,6 +1095,72 @@ declare class SpacesAPI {
     listSyncBackendsAsync(): Promise<SyncBackendInfo[]>;
 }
 
+interface ShellCreateOptions {
+    /** Shell executable (e.g., "/bin/bash"). If omitted, uses $SHELL or /bin/sh. */
+    shell?: string;
+    /** Working directory. If omitted, uses home directory. */
+    cwd?: string;
+    /** Initial terminal columns (default: 80) */
+    cols?: number;
+    /** Initial terminal rows (default: 24) */
+    rows?: number;
+    /** Environment variables to set */
+    env?: Record<string, string>;
+}
+interface ShellCreateResponse {
+    sessionId: string;
+}
+interface ShellOutputEvent {
+    sessionId: string;
+    data: string;
+}
+interface ShellExitEvent {
+    sessionId: string;
+    exitCode: number | null;
+}
+declare class ShellAPI {
+    private readonly sdk;
+    constructor(sdk: HaexVaultSdk);
+    /**
+     * Create a new PTY shell session.
+     * Returns a session ID used for subsequent write/resize/close operations.
+     * Listen for shell output via `sdk.shell.onData()`.
+     */
+    create(options?: ShellCreateOptions): Promise<string>;
+    /**
+     * Write data to a shell session's stdin.
+     * Typically used to forward terminal keystrokes.
+     */
+    write(sessionId: string, data: string): Promise<void>;
+    /**
+     * Resize a shell session's terminal.
+     * Should be called when the terminal view is resized.
+     */
+    resize(sessionId: string, cols: number, rows: number): Promise<void>;
+    /**
+     * Close a shell session.
+     * This terminates the underlying PTY process.
+     */
+    close(sessionId: string): Promise<void>;
+    /**
+     * Register a callback for shell output data.
+     * The callback receives output from the PTY's stdout/stderr.
+     */
+    onData(callback: EventCallback): void;
+    /**
+     * Register a callback for shell session exit.
+     */
+    onExit(callback: EventCallback): void;
+    /**
+     * Remove a shell output callback.
+     */
+    offData(callback: EventCallback): void;
+    /**
+     * Remove a shell exit callback.
+     */
+    offExit(callback: EventCallback): void;
+}
+
 /**
  * HaexVault Client
  *
@@ -1128,6 +1194,7 @@ declare class HaexVaultSdk {
     readonly remoteStorage: RemoteStorageAPI;
     readonly localsend: LocalSendAPI;
     readonly spaces: SpacesAPI;
+    readonly shell: ShellAPI;
     constructor(config?: HaexHubConfig);
     ready(): Promise<void>;
     get setupCompleted(): boolean;
@@ -1171,4 +1238,4 @@ declare class HaexVaultSdk {
     private log;
 }
 
-export { type TransferState as $, type AuthorizedClient as A, type BlockedClient as B, type RequestedExtension as C, DatabaseAPI as D, type ExternalAuthDecision as E, type FileStat as F, type SelectFileOptions as G, HaexVaultSdk as H, type SelectFolderOptions as I, type ServerInfo as J, type ServerStatus as K, LOCALSEND_EVENTS as L, type SessionAuthorization as M, type SharedSpace as N, type SpaceAccessTokenInfo as O, type PendingAuthorization as P, type SpaceAssignment as Q, RemoteStorageAPI as R, StorageAPI as S, type SpaceInvite as T, type UpdateBackendRequest as U, type SpaceKeyGrantInfo as V, type SpaceMemberInfo as W, SpacesAPI as X, type SyncBackendInfo as Y, type TransferDirection as Z, type TransferProgress as _, type SpaceRole as a, WebAPI as a0, canExternalClientSendRequests as a1, isExternalClientConnected as a2, type DecryptedSpace as b, type Device as c, type DeviceInfo as d, type DeviceType as e, type DirEntry as f, type ExternalConnection as g, ExternalConnectionErrorCode as h, ExternalConnectionState as i, type ExternalRequest as j, type ExternalRequestEvent as k, type ExternalRequestHandler as l, type ExternalRequestPayload as m, type ExternalResponse as n, FilesystemAPI as o, LocalSendAPI as p, type LocalSendEvent as q, type FileInfo as r, type LocalSendSettings as s, type PendingTransfer as t, PermissionsAPI as u, type AddBackendRequest as v, type S3Config as w, type S3PublicConfig as x, type StorageBackendInfo as y, type StorageObjectInfo as z };
+export { type SpaceMemberInfo as $, type AuthorizedClient as A, type BlockedClient as B, type RequestedExtension as C, DatabaseAPI as D, type ExternalAuthDecision as E, type FileStat as F, type SelectFileOptions as G, HaexVaultSdk as H, type SelectFolderOptions as I, type ServerInfo as J, type ServerStatus as K, LOCALSEND_EVENTS as L, type SessionAuthorization as M, type SharedSpace as N, ShellAPI as O, type PendingAuthorization as P, type ShellCreateOptions as Q, RemoteStorageAPI as R, StorageAPI as S, type ShellCreateResponse as T, type UpdateBackendRequest as U, type ShellExitEvent as V, type ShellOutputEvent as W, type SpaceAccessTokenInfo as X, type SpaceAssignment as Y, type SpaceInvite as Z, type SpaceKeyGrantInfo as _, type SpaceRole as a, SpacesAPI as a0, type SyncBackendInfo as a1, type TransferDirection as a2, type TransferProgress as a3, type TransferState as a4, WebAPI as a5, canExternalClientSendRequests as a6, isExternalClientConnected as a7, type DecryptedSpace as b, type Device as c, type DeviceInfo as d, type DeviceType as e, type DirEntry as f, type ExternalConnection as g, ExternalConnectionErrorCode as h, ExternalConnectionState as i, type ExternalRequest as j, type ExternalRequestEvent as k, type ExternalRequestHandler as l, type ExternalRequestPayload as m, type ExternalResponse as n, FilesystemAPI as o, LocalSendAPI as p, type LocalSendEvent as q, type FileInfo as r, type LocalSendSettings as s, type PendingTransfer as t, PermissionsAPI as u, type AddBackendRequest as v, type S3Config as w, type S3PublicConfig as x, type StorageBackendInfo as y, type StorageObjectInfo as z };

package/dist/index.d.mts

@@ -1,7 +1,7 @@
-import { a as SpaceRole, H as HaexVaultSdk } from './client-Bjbn7M-G.mjs';
-export { A as AuthorizedClient, B as BlockedClient, D as DatabaseAPI, b as DecryptedSpace, c as Device, d as DeviceInfo, e as DeviceType, f as DirEntry, E as ExternalAuthDecision, g as ExternalConnection, h as ExternalConnectionErrorCode, i as ExternalConnectionState, j as ExternalRequest, k as ExternalRequestEvent, l as ExternalRequestHandler, m as ExternalRequestPayload, n as ExternalResponse, F as FileStat, o as FilesystemAPI, L as LOCALSEND_EVENTS, p as LocalSendAPI, q as LocalSendEvent, r as LocalSendFileInfo, s as LocalSendSettings, P as PendingAuthorization, t as PendingTransfer, u as PermissionsAPI, v as RemoteAddBackendRequest, w as RemoteS3Config, x as RemoteS3PublicConfig, R as RemoteStorageAPI, y as RemoteStorageBackendInfo, z as RemoteStorageObjectInfo, U as RemoteUpdateBackendRequest, C as RequestedExtension, G as SelectFileOptions, I as SelectFolderOptions, J as ServerInfo, K as ServerStatus, M as SessionAuthorization, N as SharedSpace, O as SpaceAccessTokenInfo, Q as SpaceAssignment, T as SpaceInvite, V as SpaceKeyGrantInfo, W as SpaceMemberInfo, X as SpacesAPI, Y as SyncBackendInfo, Z as TransferDirection, _ as TransferProgress, $ as TransferState, a0 as WebAPI, a1 as canExternalClientSendRequests, a2 as isExternalClientConnected } from './client-Bjbn7M-G.mjs';
-import { E as ExtensionManifest, h as SignedClaimPresentation, H as HaexHubConfig } from './types-DkB9cExr.mjs';
-export { A as ApplicationContext, C as ClaimRequirement, i as ContextChangedEvent, j as DEFAULT_TIMEOUT, k as DatabaseColumnInfo, l as DatabaseExecuteParams, m as DatabasePermission, f as DatabasePermissionRequest, n as DatabaseQueryParams, D as DatabaseQueryResult, o as DatabaseTableInfo, c as EXTERNAL_EVENTS, p as ErrorCode, g as EventCallback, a as ExtensionInfo, q as ExtensionRuntimeMode, r as ExternalEvent, F as FileChangeEvent, s as FileChangePayload, t as FileChangeType, u as FilteredSyncTablesResult, v as HAEXTENSION_EVENTS, b as HaexHubEvent, w as HaexHubRequest, x as HaexHubResponse, y as HaexVaultSdkError, z as HaextensionEvent, I as IdentityClaim, B as ManifestI18nEntry, G as PermissionDeniedError, J as PermissionErrorBase, K as PermissionErrorCode, L as PermissionPromptError, P as PermissionResponse, N as PermissionStatus, O as SearchQuery, Q as SearchRequestEvent, S as SearchResult, R as SyncTablesUpdatedEvent, T as TABLE_SEPARATOR, W as WebRequestOptions, e as WebResponse, U as getTableName, V as isPermissionDeniedError, X as isPermissionError, Y as isPermissionPromptError } from './types-DkB9cExr.mjs';
+import { a as SpaceRole, H as HaexVaultSdk } from './client-B_S7ntUI.mjs';
+export { A as AuthorizedClient, B as BlockedClient, D as DatabaseAPI, b as DecryptedSpace, c as Device, d as DeviceInfo, e as DeviceType, f as DirEntry, E as ExternalAuthDecision, g as ExternalConnection, h as ExternalConnectionErrorCode, i as ExternalConnectionState, j as ExternalRequest, k as ExternalRequestEvent, l as ExternalRequestHandler, m as ExternalRequestPayload, n as ExternalResponse, F as FileStat, o as FilesystemAPI, L as LOCALSEND_EVENTS, p as LocalSendAPI, q as LocalSendEvent, r as LocalSendFileInfo, s as LocalSendSettings, P as PendingAuthorization, t as PendingTransfer, u as PermissionsAPI, v as RemoteAddBackendRequest, w as RemoteS3Config, x as RemoteS3PublicConfig, R as RemoteStorageAPI, y as RemoteStorageBackendInfo, z as RemoteStorageObjectInfo, U as RemoteUpdateBackendRequest, C as RequestedExtension, G as SelectFileOptions, I as SelectFolderOptions, J as ServerInfo, K as ServerStatus, M as SessionAuthorization, N as SharedSpace, O as ShellAPI, Q as ShellCreateOptions, T as ShellCreateResponse, V as ShellExitEvent, W as ShellOutputEvent, X as SpaceAccessTokenInfo, Y as SpaceAssignment, Z as SpaceInvite, _ as SpaceKeyGrantInfo, $ as SpaceMemberInfo, a0 as SpacesAPI, a1 as SyncBackendInfo, a2 as TransferDirection, a3 as TransferProgress, a4 as TransferState, a5 as WebAPI, a6 as canExternalClientSendRequests, a7 as isExternalClientConnected } from './client-B_S7ntUI.mjs';
+import { E as ExtensionManifest, h as SignedClaimPresentation, H as HaexHubConfig } from './types-B1O6KckK.mjs';
+export { A as ApplicationContext, C as ClaimRequirement, i as ContextChangedEvent, j as DEFAULT_TIMEOUT, k as DatabaseColumnInfo, l as DatabaseExecuteParams, m as DatabasePermission, g as DatabasePermissionRequest, n as DatabaseQueryParams, D as DatabaseQueryResult, o as DatabaseTableInfo, c as EXTERNAL_EVENTS, p as ErrorCode, f as EventCallback, a as ExtensionInfo, q as ExtensionRuntimeMode, r as ExternalEvent, F as FileChangeEvent, s as FileChangePayload, t as FileChangeType, u as FilteredSyncTablesResult, v as HAEXTENSION_EVENTS, b as HaexHubEvent, w as HaexHubRequest, x as HaexHubResponse, y as HaexVaultSdkError, z as HaextensionEvent, I as IdentityClaim, B as ManifestI18nEntry, G as PermissionDeniedError, J as PermissionErrorBase, K as PermissionErrorCode, L as PermissionPromptError, P as PermissionResponse, N as PermissionStatus, O as SHELL_EVENTS, Q as SearchQuery, R as SearchRequestEvent, S as SearchResult, T as ShellEvent, U as SyncTablesUpdatedEvent, V as TABLE_SEPARATOR, W as WebRequestOptions, e as WebResponse, X as getTableName, Y as isPermissionDeniedError, Z as isPermissionError, _ as isPermissionPromptError } from './types-B1O6KckK.mjs';
 export { H as HaextensionConfig } from './config-D_HXjsEV.mjs';
 import 'drizzle-orm/sqlite-proxy';
 
@@ -530,6 +530,23 @@ declare const SPACE_COMMANDS: {
 };
 type SpaceCommand = (typeof SPACE_COMMANDS)[keyof typeof SPACE_COMMANDS];
 
+/**
+ * Shell Commands
+ *
+ * Commands for shell/PTY operations.
+ * Naming convention: `extension_shell_<action>`
+ */
+declare const SHELL_COMMANDS: {
+    /** Create a new PTY shell session */
+    readonly create: "extension_shell_create";
+    /** Write data to a shell session's stdin */
+    readonly write: "extension_shell_write";
+    /** Resize a shell session's terminal */
+    readonly resize: "extension_shell_resize";
+    /** Close a shell session */
+    readonly close: "extension_shell_close";
+};
+
 /**
  * Tauri Command Names
  *
@@ -656,8 +673,14 @@ declare const TAURI_COMMANDS: {
         readonly create: "extension_space_create";
         readonly listBackends: "extension_space_list_backends";
     };
+    readonly shell: {
+        readonly create: "extension_shell_create";
+        readonly write: "extension_shell_write";
+        readonly resize: "extension_shell_resize";
+        readonly close: "extension_shell_close";
+    };
 };
-type TauriCommand = (typeof DATABASE_COMMANDS)[keyof typeof DATABASE_COMMANDS] | (typeof PERMISSIONS_COMMANDS)[keyof typeof PERMISSIONS_COMMANDS] | (typeof WEB_COMMANDS)[keyof typeof WEB_COMMANDS] | (typeof WEB_STORAGE_COMMANDS)[keyof typeof WEB_STORAGE_COMMANDS] | (typeof FILESYSTEM_COMMANDS)[keyof typeof FILESYSTEM_COMMANDS] | (typeof EXTERNAL_BRIDGE_COMMANDS)[keyof typeof EXTERNAL_BRIDGE_COMMANDS] | (typeof EXTENSION_COMMANDS)[keyof typeof EXTENSION_COMMANDS] | (typeof REMOTE_STORAGE_COMMANDS)[keyof typeof REMOTE_STORAGE_COMMANDS] | (typeof LOCALSEND_COMMANDS)[keyof typeof LOCALSEND_COMMANDS] | (typeof SPACE_COMMANDS)[keyof typeof SPACE_COMMANDS];
+type TauriCommand = (typeof DATABASE_COMMANDS)[keyof typeof DATABASE_COMMANDS] | (typeof PERMISSIONS_COMMANDS)[keyof typeof PERMISSIONS_COMMANDS] | (typeof WEB_COMMANDS)[keyof typeof WEB_COMMANDS] | (typeof WEB_STORAGE_COMMANDS)[keyof typeof WEB_STORAGE_COMMANDS] | (typeof FILESYSTEM_COMMANDS)[keyof typeof FILESYSTEM_COMMANDS] | (typeof EXTERNAL_BRIDGE_COMMANDS)[keyof typeof EXTERNAL_BRIDGE_COMMANDS] | (typeof EXTENSION_COMMANDS)[keyof typeof EXTENSION_COMMANDS] | (typeof REMOTE_STORAGE_COMMANDS)[keyof typeof REMOTE_STORAGE_COMMANDS] | (typeof LOCALSEND_COMMANDS)[keyof typeof LOCALSEND_COMMANDS] | (typeof SPACE_COMMANDS)[keyof typeof SPACE_COMMANDS] | (typeof SHELL_COMMANDS)[keyof typeof SHELL_COMMANDS];
 
 interface VerifyResult {
     valid: boolean;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { a as SpaceRole, H as HaexVaultSdk } from './client--kKvwWc0.js';
-export { A as AuthorizedClient, B as BlockedClient, D as DatabaseAPI, b as DecryptedSpace, c as Device, d as DeviceInfo, e as DeviceType, f as DirEntry, E as ExternalAuthDecision, g as ExternalConnection, h as ExternalConnectionErrorCode, i as ExternalConnectionState, j as ExternalRequest, k as ExternalRequestEvent, l as ExternalRequestHandler, m as ExternalRequestPayload, n as ExternalResponse, F as FileStat, o as FilesystemAPI, L as LOCALSEND_EVENTS, p as LocalSendAPI, q as LocalSendEvent, r as LocalSendFileInfo, s as LocalSendSettings, P as PendingAuthorization, t as PendingTransfer, u as PermissionsAPI, v as RemoteAddBackendRequest, w as RemoteS3Config, x as RemoteS3PublicConfig, R as RemoteStorageAPI, y as RemoteStorageBackendInfo, z as RemoteStorageObjectInfo, U as RemoteUpdateBackendRequest, C as RequestedExtension, G as SelectFileOptions, I as SelectFolderOptions, J as ServerInfo, K as ServerStatus, M as SessionAuthorization, N as SharedSpace, O as SpaceAccessTokenInfo, Q as SpaceAssignment, T as SpaceInvite, V as SpaceKeyGrantInfo, W as SpaceMemberInfo, X as SpacesAPI, Y as SyncBackendInfo, Z as TransferDirection, _ as TransferProgress, $ as TransferState, a0 as WebAPI, a1 as canExternalClientSendRequests, a2 as isExternalClientConnected } from './client--kKvwWc0.js';
-import { E as ExtensionManifest, h as SignedClaimPresentation, H as HaexHubConfig } from './types-DkB9cExr.js';
-export { A as ApplicationContext, C as ClaimRequirement, i as ContextChangedEvent, j as DEFAULT_TIMEOUT, k as DatabaseColumnInfo, l as DatabaseExecuteParams, m as DatabasePermission, f as DatabasePermissionRequest, n as DatabaseQueryParams, D as DatabaseQueryResult, o as DatabaseTableInfo, c as EXTERNAL_EVENTS, p as ErrorCode, g as EventCallback, a as ExtensionInfo, q as ExtensionRuntimeMode, r as ExternalEvent, F as FileChangeEvent, s as FileChangePayload, t as FileChangeType, u as FilteredSyncTablesResult, v as HAEXTENSION_EVENTS, b as HaexHubEvent, w as HaexHubRequest, x as HaexHubResponse, y as HaexVaultSdkError, z as HaextensionEvent, I as IdentityClaim, B as ManifestI18nEntry, G as PermissionDeniedError, J as PermissionErrorBase, K as PermissionErrorCode, L as PermissionPromptError, P as PermissionResponse, N as PermissionStatus, O as SearchQuery, Q as SearchRequestEvent, S as SearchResult, R as SyncTablesUpdatedEvent, T as TABLE_SEPARATOR, W as WebRequestOptions, e as WebResponse, U as getTableName, V as isPermissionDeniedError, X as isPermissionError, Y as isPermissionPromptError } from './types-DkB9cExr.js';
+import { a as SpaceRole, H as HaexVaultSdk } from './client-Bl2s5tIZ.js';
+export { A as AuthorizedClient, B as BlockedClient, D as DatabaseAPI, b as DecryptedSpace, c as Device, d as DeviceInfo, e as DeviceType, f as DirEntry, E as ExternalAuthDecision, g as ExternalConnection, h as ExternalConnectionErrorCode, i as ExternalConnectionState, j as ExternalRequest, k as ExternalRequestEvent, l as ExternalRequestHandler, m as ExternalRequestPayload, n as ExternalResponse, F as FileStat, o as FilesystemAPI, L as LOCALSEND_EVENTS, p as LocalSendAPI, q as LocalSendEvent, r as LocalSendFileInfo, s as LocalSendSettings, P as PendingAuthorization, t as PendingTransfer, u as PermissionsAPI, v as RemoteAddBackendRequest, w as RemoteS3Config, x as RemoteS3PublicConfig, R as RemoteStorageAPI, y as RemoteStorageBackendInfo, z as RemoteStorageObjectInfo, U as RemoteUpdateBackendRequest, C as RequestedExtension, G as SelectFileOptions, I as SelectFolderOptions, J as ServerInfo, K as ServerStatus, M as SessionAuthorization, N as SharedSpace, O as ShellAPI, Q as ShellCreateOptions, T as ShellCreateResponse, V as ShellExitEvent, W as ShellOutputEvent, X as SpaceAccessTokenInfo, Y as SpaceAssignment, Z as SpaceInvite, _ as SpaceKeyGrantInfo, $ as SpaceMemberInfo, a0 as SpacesAPI, a1 as SyncBackendInfo, a2 as TransferDirection, a3 as TransferProgress, a4 as TransferState, a5 as WebAPI, a6 as canExternalClientSendRequests, a7 as isExternalClientConnected } from './client-Bl2s5tIZ.js';
+import { E as ExtensionManifest, h as SignedClaimPresentation, H as HaexHubConfig } from './types-B1O6KckK.js';
+export { A as ApplicationContext, C as ClaimRequirement, i as ContextChangedEvent, j as DEFAULT_TIMEOUT, k as DatabaseColumnInfo, l as DatabaseExecuteParams, m as DatabasePermission, g as DatabasePermissionRequest, n as DatabaseQueryParams, D as DatabaseQueryResult, o as DatabaseTableInfo, c as EXTERNAL_EVENTS, p as ErrorCode, f as EventCallback, a as ExtensionInfo, q as ExtensionRuntimeMode, r as ExternalEvent, F as FileChangeEvent, s as FileChangePayload, t as FileChangeType, u as FilteredSyncTablesResult, v as HAEXTENSION_EVENTS, b as HaexHubEvent, w as HaexHubRequest, x as HaexHubResponse, y as HaexVaultSdkError, z as HaextensionEvent, I as IdentityClaim, B as ManifestI18nEntry, G as PermissionDeniedError, J as PermissionErrorBase, K as PermissionErrorCode, L as PermissionPromptError, P as PermissionResponse, N as PermissionStatus, O as SHELL_EVENTS, Q as SearchQuery, R as SearchRequestEvent, S as SearchResult, T as ShellEvent, U as SyncTablesUpdatedEvent, V as TABLE_SEPARATOR, W as WebRequestOptions, e as WebResponse, X as getTableName, Y as isPermissionDeniedError, Z as isPermissionError, _ as isPermissionPromptError } from './types-B1O6KckK.js';
 export { H as HaextensionConfig } from './config-D_HXjsEV.js';
 import 'drizzle-orm/sqlite-proxy';
 
@@ -530,6 +530,23 @@ declare const SPACE_COMMANDS: {
 };
 type SpaceCommand = (typeof SPACE_COMMANDS)[keyof typeof SPACE_COMMANDS];
 
+/**
+ * Shell Commands
+ *
+ * Commands for shell/PTY operations.
+ * Naming convention: `extension_shell_<action>`
+ */
+declare const SHELL_COMMANDS: {
+    /** Create a new PTY shell session */
+    readonly create: "extension_shell_create";
+    /** Write data to a shell session's stdin */
+    readonly write: "extension_shell_write";
+    /** Resize a shell session's terminal */
+    readonly resize: "extension_shell_resize";
+    /** Close a shell session */
+    readonly close: "extension_shell_close";
+};
+
 /**
  * Tauri Command Names
  *
@@ -656,8 +673,14 @@ declare const TAURI_COMMANDS: {
         readonly create: "extension_space_create";
         readonly listBackends: "extension_space_list_backends";
     };
+    readonly shell: {
+        readonly create: "extension_shell_create";
+        readonly write: "extension_shell_write";
+        readonly resize: "extension_shell_resize";
+        readonly close: "extension_shell_close";
+    };
 };
-type TauriCommand = (typeof DATABASE_COMMANDS)[keyof typeof DATABASE_COMMANDS] | (typeof PERMISSIONS_COMMANDS)[keyof typeof PERMISSIONS_COMMANDS] | (typeof WEB_COMMANDS)[keyof typeof WEB_COMMANDS] | (typeof WEB_STORAGE_COMMANDS)[keyof typeof WEB_STORAGE_COMMANDS] | (typeof FILESYSTEM_COMMANDS)[keyof typeof FILESYSTEM_COMMANDS] | (typeof EXTERNAL_BRIDGE_COMMANDS)[keyof typeof EXTERNAL_BRIDGE_COMMANDS] | (typeof EXTENSION_COMMANDS)[keyof typeof EXTENSION_COMMANDS] | (typeof REMOTE_STORAGE_COMMANDS)[keyof typeof REMOTE_STORAGE_COMMANDS] | (typeof LOCALSEND_COMMANDS)[keyof typeof LOCALSEND_COMMANDS] | (typeof SPACE_COMMANDS)[keyof typeof SPACE_COMMANDS];
+type TauriCommand = (typeof DATABASE_COMMANDS)[keyof typeof DATABASE_COMMANDS] | (typeof PERMISSIONS_COMMANDS)[keyof typeof PERMISSIONS_COMMANDS] | (typeof WEB_COMMANDS)[keyof typeof WEB_COMMANDS] | (typeof WEB_STORAGE_COMMANDS)[keyof typeof WEB_STORAGE_COMMANDS] | (typeof FILESYSTEM_COMMANDS)[keyof typeof FILESYSTEM_COMMANDS] | (typeof EXTERNAL_BRIDGE_COMMANDS)[keyof typeof EXTERNAL_BRIDGE_COMMANDS] | (typeof EXTENSION_COMMANDS)[keyof typeof EXTENSION_COMMANDS] | (typeof REMOTE_STORAGE_COMMANDS)[keyof typeof REMOTE_STORAGE_COMMANDS] | (typeof LOCALSEND_COMMANDS)[keyof typeof LOCALSEND_COMMANDS] | (typeof SPACE_COMMANDS)[keyof typeof SPACE_COMMANDS] | (typeof SHELL_COMMANDS)[keyof typeof SHELL_COMMANDS];
 
 interface VerifyResult {
     valid: boolean;

package/dist/index.js

@@ -687,6 +687,12 @@ var EXTERNAL_EVENTS = {
   /** New external client requesting authorization */
   AUTHORIZATION_REQUEST: "external:authorization-request"
 };
+var SHELL_EVENTS = {
+  /** PTY output data from a shell session */
+  OUTPUT: "shell:output",
+  /** Shell session has exited */
+  EXIT: "shell:exit"
+};
 
 // src/types.ts
 var DEFAULT_TIMEOUT = 3e4;
@@ -993,6 +999,18 @@ var SPACE_COMMANDS = {
   listBackends: "extension_space_list_backends"
 };
 
+// src/commands/shell.ts
+var SHELL_COMMANDS = {
+  /** Create a new PTY shell session */
+  create: "extension_shell_create",
+  /** Write data to a shell session's stdin */
+  write: "extension_shell_write",
+  /** Resize a shell session's terminal */
+  resize: "extension_shell_resize",
+  /** Close a shell session */
+  close: "extension_shell_close"
+};
+
 // src/commands/index.ts
 var TAURI_COMMANDS = {
   database: DATABASE_COMMANDS,
@@ -1004,7 +1022,8 @@ var TAURI_COMMANDS = {
   extension: EXTENSION_COMMANDS,
   remoteStorage: REMOTE_STORAGE_COMMANDS,
   localsend: LOCALSEND_COMMANDS,
-  spaces: SPACE_COMMANDS
+  spaces: SPACE_COMMANDS,
+  shell: SHELL_COMMANDS
 };
 
 // src/api/storage.ts
@@ -1874,6 +1893,71 @@ var SpacesAPI = class {
   }
 };
 
+// src/api/shell.ts
+var ShellAPI = class {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+  /**
+   * Create a new PTY shell session.
+   * Returns a session ID used for subsequent write/resize/close operations.
+   * Listen for shell output via `sdk.shell.onData()`.
+   */
+  async create(options = {}) {
+    const result = await this.sdk.request(
+      SHELL_COMMANDS.create,
+      { options }
+    );
+    return result.sessionId;
+  }
+  /**
+   * Write data to a shell session's stdin.
+   * Typically used to forward terminal keystrokes.
+   */
+  async write(sessionId, data) {
+    await this.sdk.request(SHELL_COMMANDS.write, { sessionId, data });
+  }
+  /**
+   * Resize a shell session's terminal.
+   * Should be called when the terminal view is resized.
+   */
+  async resize(sessionId, cols, rows) {
+    await this.sdk.request(SHELL_COMMANDS.resize, { sessionId, cols, rows });
+  }
+  /**
+   * Close a shell session.
+   * This terminates the underlying PTY process.
+   */
+  async close(sessionId) {
+    await this.sdk.request(SHELL_COMMANDS.close, { sessionId });
+  }
+  /**
+   * Register a callback for shell output data.
+   * The callback receives output from the PTY's stdout/stderr.
+   */
+  onData(callback) {
+    this.sdk.on("shell:output", callback);
+  }
+  /**
+   * Register a callback for shell session exit.
+   */
+  onExit(callback) {
+    this.sdk.on("shell:exit", callback);
+  }
+  /**
+   * Remove a shell output callback.
+   */
+  offData(callback) {
+    this.sdk.off("shell:output", callback);
+  }
+  /**
+   * Remove a shell exit callback.
+   */
+  offExit(callback) {
+    this.sdk.off("shell:exit", callback);
+  }
+};
+
 // src/client/tableName.ts
 function validatePublicKey(publicKey) {
   if (!publicKey || typeof publicKey !== "string" || publicKey.trim() === "") {
@@ -2499,6 +2583,7 @@ var HaexVaultSdk = class {
     this.remoteStorage = new RemoteStorageAPI(this);
     this.localsend = new LocalSendAPI(this);
     this.spaces = new SpacesAPI(this);
+    this.shell = new ShellAPI(this);
     installConsoleForwarding(this.config.debug);
     this.readyPromise = new Promise((resolve) => {
       this.resolveReady = resolve;
@@ -3472,7 +3557,9 @@ exports.PermissionErrorCode = PermissionErrorCode;
 exports.PermissionStatus = PermissionStatus;
 exports.PermissionsAPI = PermissionsAPI;
 exports.RemoteStorageAPI = RemoteStorageAPI;
+exports.SHELL_EVENTS = SHELL_EVENTS;
 exports.SPACE_COMMANDS = SPACE_COMMANDS;
+exports.ShellAPI = ShellAPI;
 exports.SpacesAPI = SpacesAPI;
 exports.TABLE_SEPARATOR = TABLE_SEPARATOR;
 exports.TAURI_COMMANDS = TAURI_COMMANDS;