@edenapp/types 0.5.1 → 0.6.0

package/AppManifest.d.ts

@@ -13,7 +13,8 @@ export type WindowMode = "floating" | "tiled" | "both";
  * - "tokens": Inject only CSS custom property definitions
  * - "none": Don't inject any CSS
  */
-export type CSSInjectionMode = "full" | "tokens" | "none";
+export type CSSInjectionMode = "none" | "tokens" | "full";
+export type AppFrameInjectionMode = "none" | "window-only" | "full" | boolean;
 
 export interface WindowInjectionOptions {
   /**
@@ -24,8 +25,13 @@ export interface WindowInjectionOptions {
    */
   css?: CSSInjectionMode;
 
-  /** Inject the Eden app frame with title bar controls (default: true) */
-  appFrame?: boolean;
+  /**
+   * Inject Eden app frame runtime and visuals (default: true).
+   * - true | "full": full Eden frame (rounded container + system top bar controls)
+   * - "window-only": keep frame runtime/container, but app renders its own top bar
+   * - false | "none": disable app frame injection entirely
+   */
+  appFrame?: AppFrameInjectionMode;
 }
 
 export interface WindowConfig {

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @edenapp/types
 
+## 0.6.0
+
+### Minor Changes
+
+- add fs/mv fs/cp
+  unify dialogs api through solid-kit
+  add process manager app
+
+## 0.5.2
+
+### Patch Changes
+
+- gate view and process endpoints and add "window-only" inejction mode to appframe
+
 ## 0.5.1
 
 ## 0.5.0

package/ProcessMetrics.d.ts

@@ -0,0 +1,127 @@
+/**
+ * CPU usage sample for a tracked Eden process.
+ */
+export interface EdenProcessCpuUsage {
+  /** CPU usage percentage since the previous sample. */
+  percentCPUUsage: number;
+
+  /** Total CPU time in seconds since process startup, when available. */
+  cumulativeCPUUsage?: number;
+
+  /** Average idle wakeups per second since the previous sample. */
+  idleWakeupsPerSecond: number;
+}
+
+/**
+ * Memory usage sample for a tracked Eden process.
+ *
+ * All values are reported in kilobytes.
+ */
+export interface EdenProcessMemoryUsage {
+  /** Memory currently pinned to physical RAM. */
+  workingSetSize: number;
+
+  /** Peak working set size. */
+  peakWorkingSetSize: number;
+
+  /** Memory private to the process, when available. */
+  privateBytes?: number;
+}
+
+/**
+ * A single Electron process attributed to an Eden app or to shared/system work.
+ */
+export interface EdenProcessMetric {
+  /** OS process id. */
+  pid: number;
+
+  /** Creation time in milliseconds since the Unix epoch. */
+  creationTime: number;
+
+  /** Eden-level grouping used by the task manager. */
+  category: "renderer" | "backend" | "shared";
+
+  /** Electron/Chromium process type, e.g. "Tab", "Utility", "GPU". */
+  processType: string;
+
+  /** Electron utility service name, when available. */
+  serviceName?: string;
+
+  /** Human-readable process name, when available. */
+  name?: string;
+
+  /** Eden app id if this process belongs to an app. */
+  appId?: string;
+
+  /** Eden view id for renderer processes. */
+  viewId?: number;
+
+  /** CPU usage snapshot. */
+  cpu: EdenProcessCpuUsage;
+
+  /** Memory usage snapshot. */
+  memory: EdenProcessMemoryUsage;
+}
+
+/**
+ * Aggregated resource usage for a running Eden app instance.
+ */
+export interface AppProcessMetrics {
+  /** Running app instance metadata. */
+  instance: import("./index").AppInstance;
+
+  /** Sum of CPU usage across app-owned processes. */
+  totalCPUPercent: number;
+
+  /** Sum of working set memory across app-owned processes, in KB. */
+  totalMemoryWorkingSetSize: number;
+
+  /** Sum of peak working set memory across app-owned processes, in KB. */
+  totalMemoryPeakWorkingSetSize: number;
+
+  /** Renderer process metrics, when the app has a frontend. */
+  renderer?: EdenProcessMetric;
+
+  /** Backend utility process metrics, when the app has a backend. */
+  backend?: EdenProcessMetric;
+}
+
+/**
+ * Aggregate totals for a process metrics snapshot.
+ */
+export interface ProcessMetricsTotals {
+  /** CPU used by tracked Eden app processes. */
+  appCPUPercent: number;
+
+  /** CPU used by unattributed Electron processes. */
+  sharedCPUPercent: number;
+
+  /** Total CPU usage across all Electron app metrics. */
+  overallCPUPercent: number;
+
+  /** Working set memory used by tracked Eden app processes, in KB. */
+  appMemoryWorkingSetSize: number;
+
+  /** Working set memory used by unattributed Electron processes, in KB. */
+  sharedMemoryWorkingSetSize: number;
+
+  /** Total working set memory across all Electron app metrics, in KB. */
+  overallMemoryWorkingSetSize: number;
+}
+
+/**
+ * Full snapshot used by the Eden task manager/profiler.
+ */
+export interface ProcessMetricsSnapshot {
+  /** ISO timestamp describing when the sample was created. */
+  sampledAt: string;
+
+  /** Per-app resource usage. */
+  apps: AppProcessMetrics[];
+
+  /** Electron processes that cannot be safely attributed to a single Eden app. */
+  sharedProcesses: EdenProcessMetric[];
+
+  /** Aggregate totals for the sample. */
+  totals: ProcessMetricsTotals;
+}

package/commands.generated.d.ts

@@ -357,6 +357,21 @@ export interface FsCommands {
     args: { path: string };
     response: void;
   };
+  /**
+   * Copy a file or directory.
+   * Directories are copied recursively.
+   */
+  "fs/cp": {
+    args: { from: string; to: string };
+    response: void;
+  };
+  /**
+   * Move or rename a file or directory.
+   */
+  "fs/mv": {
+    args: { from: string; to: string };
+    response: void;
+  };
 }
 
 /**
@@ -490,6 +505,7 @@ export interface PackageCommands {
 export interface ProcessCommands {
   /**
    * Launch an application instance.
+   * Requires "process/manage" permission.
    */
   "process/launch": {
     args: {
@@ -499,19 +515,44 @@ export interface ProcessCommands {
   };
   /**
    * Stop a running application instance.
+   * Requires "process/manage" permission.
    */
   "process/stop": {
     args: { appId: string };
     response: { success: boolean };
   };
+  /**
+   * Stop the caller app instance.
+   * No explicit permission required - this endpoint only allows self-exit.
+   */
+  "process/exit": {
+    args: { };
+    response: { success: boolean };
+  };
   /**
    * List all running application processes.
+   * Requires "process/read" permission.
    * @param showHidden - If true, includes overlay apps (hidden by default)
    */
   "process/list": {
     args: { showHidden?: boolean };
     response: import("./index").AppInstance[];
   };
+  /**
+   * Return CPU and memory metrics for running Eden apps.
+   * Requires "process/read" permission.
+   * @param showHidden - If true, includes overlay apps and backend-only apps
+   * @param pollingTimeoutMs - How long main should keep the shared sampler alive
+   * @param waitForAccurateCpu - If false, returns the current sample immediately,
+   * even before Electron has a full CPU interval
+   */
+  "process/metrics": {
+    args: {
+    showHidden?: boolean;
+    pollingTimeoutMs?: number;
+    waitForAccurateCpu?: boolean };
+    response: import("./index").ProcessMetricsSnapshot;
+  };
 }
 
 /**
@@ -730,7 +771,16 @@ export interface UserCommands {
  */
 export interface ViewCommands {
   /**
-   * Update the bounds (position and size) of a specific view.
+   * Update bounds for the caller's own view.
+   */
+  "view/update-bounds": {
+    args: {
+    bounds: import("./index").ViewBounds };
+    response: { success: boolean };
+  };
+  /**
+   * Update bounds for any app view.
+   * Requires "view/manage" permission.
    */
   "view/update-view-bounds": {
     args: {
@@ -739,7 +789,16 @@ export interface ViewCommands {
     response: { success: boolean };
   };
   /**
-   * Show or hide a specific view.
+   * Show or hide the caller's own view.
+   */
+  "view/set-visibility": {
+    args: {
+    visible: boolean };
+    response: { success: boolean };
+  };
+  /**
+   * Show or hide any app view.
+   * Requires "view/manage" permission.
    */
   "view/set-view-visibility": {
     args: {
@@ -748,14 +807,24 @@ export interface ViewCommands {
     response: { success: boolean };
   };
   /**
-   * Bring an application's view to the front and focus it.
+   * Bring caller's own view to the front and focus it.
    */
-  "view/focus-app": {
-    args: { appId: string };
+  "view/focus": {
+    args: { };
+    response: { success: boolean };
+  };
+  /**
+   * Bring any app view to the front and focus it.
+   * Requires "view/manage" permission.
+   */
+  "view/focus-view": {
+    args: {
+    appId: string };
     response: { success: boolean };
   };
   /**
    * Update the available workspace bounds (e.g. after taskbar resize).
+   * Requires "view/manage" permission for app callers.
    */
   "view/update-global-bounds": {
     args: {
@@ -764,7 +833,16 @@ export interface ViewCommands {
     response: { success: boolean };
   };
   /**
-   * Toggle between floating and tiled window modes.
+   * Toggle caller's own view between floating and tiled window modes.
+   */
+  "view/toggle-mode": {
+    args: {
+    mode?: "floating" | "tiled" };
+    response: { success: boolean };
+  };
+  /**
+   * Toggle any app view between floating and tiled window modes.
+   * Requires "view/manage" permission.
    */
   "view/toggle-view-mode": {
     args: {
@@ -773,45 +851,43 @@ export interface ViewCommands {
     response: { success: boolean };
   };
   /**
-   * Start dragging a window.
+   * Start dragging caller's own view.
    */
   "view/start-drag": {
     args: {
-    appId: string;
     startX: number;
     startY: number };
     response: { success: boolean };
   };
   /**
-   * End the current drag operation.
+   * End drag operation for caller's own view.
    */
   "view/end-drag": {
-    args: { appId: string };
+    args: { };
     response: { success: boolean };
   };
   /**
    * Handle global mouse up event to stop any active drag/resize operations.
+   * Requires "view/manage" permission for app callers.
    */
   "view/global-mouseup": {
     args: Record<string, never>;
     response: { success: boolean };
   };
   /**
-   * Start resizing a window.
+   * Start resizing caller's own view.
    */
   "view/start-resize": {
     args: {
-    appId: string;
     startX: number;
     startY: number };
     response: { success: boolean };
   };
   /**
-   * End the current resize operation.
+   * End resize operation for caller's own view.
    */
   "view/end-resize": {
-    args: {
-    appId: string };
+    args: { };
     response: { success: boolean };
   };
   /**

package/global.d.ts

@@ -1,11 +1,15 @@
 // Ambient declarations for renderer globals
 
+import type { AppFrameInjectionMode, CSSInjectionMode } from "./AppManifest";
 import type { EdenAPI, AppBusAPI, AppBusConnection } from "./ipc";
 
 export interface EdenFrame {
   // Public API
   setTitle: (title: string) => void;
   resetTitle: () => void;
+  close: () => Promise<void>;
+  minimize: () => Promise<void>;
+  toggleMode: () => Promise<void>;
 
   // Internal state (used by frame system)
   _internal: {
@@ -21,6 +25,10 @@ export interface EdenFrame {
       resizable?: boolean;
       minSize?: { width: number; height: number };
       maxSize?: { width: number; height: number };
+      injections?: {
+        css?: CSSInjectionMode;
+        appFrame?: AppFrameInjectionMode;
+      };
     };
     currentMode: "tiled" | "floating";
     bounds: {
@@ -53,6 +61,3 @@ declare global {
     edenFrame?: EdenFrame;
   }
 }
-
-// This export is important - it marks the file as a module
-export {};

package/index.d.ts

@@ -5,6 +5,7 @@ export * from "./EdenSeedConfig";
 export * from "./User";
 
 export * from "./AppManifest";
+export * from "./ProcessMetrics";
 
 export * from "./global";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edenapp/types",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "TypeScript type definitions for the Eden platform",
   "types": "index.d.ts",
   "author": "Dariusz Majnert",
@@ -17,6 +17,6 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/b0czek/eden.git",
-    "directory": "src/types"
+    "directory": "packages/types"
   }
 }