@voltius/plugin-types 0.17.0 → 0.18.0

package/index.d.ts

@@ -87,6 +87,16 @@ export interface AppTheme {
 
 export type Locale = "en" | "fr" | "ru" | "zh";
 
+export type PluginAuditAction =
+  | "agent.grant_created"
+  | "agent.grant_revoked"
+  | "agent.mode_changed"
+  | "agent.session_opened"
+  | "agent.session_closed"
+  | "agent.command_run"
+  | "agent.action_denied";
+
+
 
 // ─── Types exposés aux plugins ─────────────────────────────────────────────
 
@@ -215,6 +225,19 @@ export interface GlobalPanel {
   component: React.FC<{ open: boolean; onClose: () => void }>;
 }
 
+/** Controls the panel it was returned from. Calling it disposes, as before. */
+export interface GlobalPanelHandle {
+  (): void;
+  /** Host-prefixed id, e.g. "ai-agent:drawer". */
+  readonly id: string;
+  open(): void;
+  close(): void;
+  toggle(): void;
+  isOpen(): boolean;
+  /** Width (px) the app shell reserves while this panel is docked. */
+  setDockedWidth(width: number): void;
+}
+
 export interface PluginSession {
   id: string;
   connectionId: string;
@@ -497,6 +520,24 @@ export interface PluginAPI {
     delete(key: string): Promise<void>;
   };
 
+  // Audit — record what this plugin did (requires "audit")
+  audit: {
+    /**
+     * Record an action against the connection it targets. A team-vault
+     * connection additionally posts to that team's server; "local", unknown
+     * and deleted ids fail closed to the on-device sink.
+     *
+     * `localMetadata` never leaves the device. Never pass captured terminal
+     * output to either channel.
+     */
+    record(
+      connectionId: string | null,
+      action: PluginAuditAction,
+      metadata?: Record<string, unknown>,
+      localMetadata?: Record<string, unknown>,
+    ): void;
+  };
+
   // Themes (requires "themes")
   themes: {
     register(theme: PluginTheme): void;
@@ -514,7 +555,7 @@ export interface PluginAPI {
     registerSettingsPage(page: SettingsPage): () => void;
     registerRightPanelSection(section: RightPanelSection): () => void;
     /** Mount a global, shell-level panel (not session-scoped). Returns cleanup. */
-    registerGlobalPanel(panel: GlobalPanel): () => void;
+    registerGlobalPanel(panel: GlobalPanel): GlobalPanelHandle;
     /** Contribute a full-screen mobile view for `screen.kind`. Uninstalling or
      *  disabling the plugin removes it, same as registerRightPanelSection does
      *  on desktop. Returns cleanup. */

package/package.json

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

package/ui.d.ts

@@ -2,8 +2,27 @@
 // the host's own instances — see the build script in package.json.
 declare module "@voltius/ui" {
   import type { ComponentType, ReactNode } from "react";
+  import type { PluginAPI, PluginSession } from "@voltius/plugin-types";
   export const Icon: ComponentType<{ icon: string; width?: number | string; className?: string }>;
   export const InfoTooltip: ComponentType<{ text: string; children?: ReactNode }>;
   export const BottomSheet: ComponentType<{ title?: string; onClose: () => void; children?: ReactNode }>;
   export function useAutosave<T>(value: T, save: (v: T) => void | Promise<void>, delayMs?: number): void;
+  export function useT(api: PluginAPI): PluginAPI["i18n"]["t"];
+  export function useSessionById(api: PluginAPI, sessionId: string): PluginSession | null;
+  export const ConnectionAvatar: ComponentType<{
+    connection: {
+      connection_type?: "ssh" | "serial" | "ftp";
+      serial_port?: string;
+      icon?: string;
+      distro?: string;
+    };
+    size: number;
+  }>;
+  export const ConfirmModal: ComponentType<{
+    title: string;
+    message: string;
+    confirmLabel?: string;
+    onConfirm: () => void;
+    onCancel: () => void;
+  }>;
 }