@punica/editor 1.9.0 → 1.9.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@punica/editor",
-  "version": "1.9.0",
+  "version": "1.9.1",
   "description": "Punica Editor",
   "private": false,
   "type": "module",

package/types/punica.module.runtime.host.d.ts

@@ -290,6 +290,52 @@ declare module 'punica' {
         reply(requestId: string, response: unknown): void;
       }
 
+      /**
+       * What the machine has, as the host measured it.
+       *
+       * Exists because "will this fit" is a question the user cannot answer and
+       * the substrate must not guess: a 18 GB model download onto a disk with
+       * 4 GB free is a failure that takes twenty minutes to arrive. Numbers are
+       * reported, never interpreted — whether a given model fits is a product
+       * judgement and belongs in whatever extension is offering the download.
+       */
+      export interface HostSystemInfo {
+        /** Node's `os.platform()` value; matched against, not displayed. */
+        platform: 'darwin' | 'win32' | 'linux' | string;
+        /** Node's `os.arch()` value (`arm64`, `x64`, ...). */
+        arch: string;
+        cpuCount: number;
+        totalMemoryBytes: number;
+        /**
+         * Memory not in use right now. Far less useful than it looks on a
+         * machine with a unified/compressed memory manager, where most of RAM
+         * reads as "used" by the page cache; size a workload against
+         * `totalMemoryBytes` and treat this as a hint.
+         */
+        freeMemoryBytes: number;
+        /**
+         * Free bytes on the filesystem holding the requested path. ABSENT
+         * rather than zero when the host cannot measure it — zero would read as
+         * "full disk" and block downloads that would have worked.
+         */
+        freeDiskBytes?: number;
+        /** The path `freeDiskBytes` was measured for. */
+        diskPath?: string;
+      }
+
+      /**
+       * Read-only machine facts. Optional: a browser host has no honest answer
+       * for any of these, and inventing one is worse than the surface being
+       * absent, which callers can feature-detect.
+       */
+      export interface HostSystemApi {
+        /**
+         * @param opts.path Which filesystem to measure free space on. The host
+         *   picks its own default (typically the user's home) when omitted.
+         */
+        info(opts?: { path?: string }): Promise<HostSystemInfo>;
+      }
+
       /**
        * Host-injected surface for the host's persistent data directory — the
        * place for large artifacts that must NOT pollute the workspace. Provided
@@ -320,6 +366,13 @@ declare module 'punica' {
          * a local listener (browser) omit it; the facade throws on use.
          */
         mcpServer?: HostMcpServerApi;
+        /**
+         * Optional machine-facts surface (Electron). Absent on hosts that
+         * cannot measure the machine (browser); callers feature-detect with
+         * `runtime.host.system` rather than catching an error, because "we do
+         * not know how much disk you have" is a state the UI can render.
+         */
+        system?: HostSystemApi;
       }
     }
   }