@voltius/plugin-types 0.49.1 → 0.50.0

package/index.d.ts

@@ -87,7 +87,7 @@ export interface AppTheme {
   terminal: TerminalTheme;
 }
 
-export type Locale = "en" | "fr" | "ru" | "zh" | "tr";
+export type Locale = "en" | "fr" | "ru" | "zh" | "tr" | "cs";
 
 export type PluginAuditAction =
   | "agent.grant_created"
@@ -370,6 +370,8 @@ export interface PluginPane {
   paneId: string;
   sessionId: string;
   connectionName: string;
+  /** The session's user-given name, or null when its label is the connection name. */
+  title: string | null;
   active: boolean;
   maximized: boolean;
 }
@@ -379,6 +381,8 @@ export interface PluginPane {
 export interface PluginPaneTab {
   tabId: string;
   kind: "split" | "session";
+  /** A split tab's own name (null: the label follows the active pane); a standalone tab's session name. */
+  title: string | null;
   active: boolean;
   panes: PluginPane[];
   broadcastActive: boolean;
@@ -594,6 +598,8 @@ export interface PluginSession {
   type: string;
   /** Local sessions only: the shell path/name to use for a spawned exec PTY. */
   localShell?: string;
+  /** The user-given name its tab shows; unset, the tab shows `connectionName`. */
+  title?: string;
 }
 
 // ─── Files (SFTP / FTP / local) ────────────────────────────────────────────
@@ -1101,6 +1107,10 @@ export interface PluginAPI {
    * strictly less than the ungated sessions:write, and detaching a pane leaves
    * the session open. Writes never throw — they return a PluginPaneResult whose
    * `error` says why, because every underlying store method fails silently.
+   *
+   * `rename` names a session, `renameTab` a split tab; a blank title clears the
+   * name. A title escape the remote program writes (OSC 0/2) never reaches
+   * either name — Voltius does not read them — so a name set here always holds.
    */
   panes: {
     list(): PluginPaneTab[];
@@ -1108,6 +1118,8 @@ export interface PluginAPI {
     move(input: { sessionId: string; targetSessionId: string; position: PluginPanePosition }): PluginPaneResult;
     detach(sessionId: string): PluginPaneResult;
     focus(sessionId: string, maximize?: boolean): PluginPaneResult;
+    rename(sessionId: string, title: string | null): PluginPaneResult;
+    renameTab(tabId: string, title: string | null): PluginPaneResult;
   };
 
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltius/plugin-types",
-  "version": "0.49.1",
+  "version": "0.50.0",
   "description": "TypeScript definitions for the Voltius plugin API",
   "types": "index.d.ts",
   "files": [