@floegence/redevplugin-ui 3.0.33 → 3.0.35

package/dist/openapi.gen.d.ts

@@ -1790,6 +1790,23 @@ export interface components {
             memory_limit_bytes: number;
             idle_timeout_ms: number;
         };
+        ExternalPackageProcessMethodAccessSummary: {
+            method: string;
+            operations: ("start" | "attach" | "status" | "write_stdin" | "close_stdin" | "read_stdout" | "read_stderr" | "wait" | "terminate" | "kill" | "close")[];
+        };
+        ExternalPackageProcessResourceLimits: {
+            output_buffer_bytes: number;
+            max_runtime_ms: number;
+        };
+        ExternalPackageProcessSummary: {
+            resource_limits: components["schemas"]["ExternalPackageProcessResourceLimits"];
+            method_access: components["schemas"]["ExternalPackageProcessMethodAccessSummary"][];
+        };
+        ExternalPackageBackgroundSummary: {
+            /** @enum {string} */
+            strategy: "runtime_start" | "on_demand";
+            worker_id: string;
+        };
         ExternalPackageNetworkMethodAccessSummary: {
             method: string;
             operations: ("http" | "http_stream" | "websocket_round_trip" | "tcp_round_trip" | "udp_round_trip")[];
@@ -1856,6 +1873,8 @@ export interface components {
             methods: components["schemas"]["ExternalPackageMethodSummary"][];
             capability_contracts: components["schemas"]["ExternalPackageCapabilityContractSummary"][];
             workers: components["schemas"]["ExternalPackageWorkerSummary"][];
+            process?: components["schemas"]["ExternalPackageProcessSummary"];
+            background?: components["schemas"]["ExternalPackageBackgroundSummary"];
             network: components["schemas"]["ExternalPackageNetworkSummary"][];
             storage: components["schemas"]["ExternalPackageStorageSummary"][];
             secret_refs: components["schemas"]["ExternalPackageSecretRefSummary"][];
@@ -2608,6 +2627,9 @@ export interface components {
                         operations: ("http" | "http_stream" | "websocket_round_trip" | "tcp_round_trip" | "udp_round_trip")[];
                         http_methods?: ("GET" | "HEAD" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS")[];
                     } & unknown)[];
+                    process?: {
+                        operations: ("start" | "attach" | "status" | "write_stdin" | "close_stdin" | "read_stdout" | "read_stderr" | "wait" | "terminate" | "kill" | "close")[];
+                    }[];
                 };
                 route: {
                     /** @enum {unknown} */
@@ -2678,6 +2700,17 @@ export interface components {
                     tls?: Record<string, never>;
                 }[];
             };
+            process?: {
+                resource_limits?: {
+                    output_buffer_bytes?: number;
+                    max_runtime_ms?: number;
+                };
+            };
+            background?: {
+                /** @enum {unknown} */
+                strategy: "runtime_start" | "on_demand";
+                worker_id: string;
+            };
             settings?: {
                 schema_version: number;
                 fields?: {
@@ -2703,7 +2736,7 @@ export interface components {
                 required_features?: components["schemas"]["ManifestV9RequiredFeatures"];
                 optional_features?: components["schemas"]["ManifestV9OptionalFeatures"];
             };
-            permissions: ("fs.workspace.read" | "fs.workspace.write" | "fs.home.read" | "fs.home.write" | "fs.environment.read" | "fs.environment.write" | "network.client" | "network.listen")[];
+            permissions: ("fs.workspace.read" | "fs.workspace.write" | "fs.home.read" | "fs.home.write" | "fs.environment.read" | "fs.environment.write" | "network.client" | "network.listen" | "process.local")[];
         };
         ManifestV9Locale: string;
         ManifestV9Summary: string;
@@ -2773,7 +2806,7 @@ export interface components {
             minProperties?: number;
             maxProperties?: number;
         } & (unknown & unknown)) | unknown | unknown | unknown | unknown | unknown | unknown | unknown | unknown | unknown | unknown | unknown | unknown | unknown);
-        ManifestV9RequiredFeatures: ("io.stream.v1" | "fs.workspace.v1" | "fs.home.v1" | "fs.environment.v1" | "fs.watch.v1" | "net.http.v1" | "net.websocket.v1" | "net.tcp.v1" | "net.udp.v1")[];
+        ManifestV9RequiredFeatures: ("io.stream.v1" | "fs.workspace.v1" | "fs.home.v1" | "fs.environment.v1" | "fs.watch.v1" | "net.http.v1" | "net.websocket.v1" | "net.tcp.v1" | "net.udp.v1" | "process.local.v1")[];
         ManifestV9OptionalFeatures: string[];
         HostCapabilityPinV1: {
             publisher_id: components["schemas"]["HostCapabilityPinV1Id"];

package/dist/plugin.d.ts

@@ -1,6 +1,8 @@
 export { PluginBridgeClient } from "./surface.js";
 export { PluginBridgeError } from "./errors.js";
 export { pluginAPIMajor } from "./contracts.gen.js";
+export { createPluginProcessClient } from "./process.js";
+export type { PluginProcessExitResult, PluginProcessMethodContracts, PluginProcessReadResult, PluginProcessResourceLimits, PluginProcessStartRequest, PluginProcessStatus, } from "./process.js";
 export { callCapabilityOperation, callCapabilityStream, callCapabilitySync, isCapabilityBusinessError, } from "./capability-client.js";
 export type { BridgeLifecycleEvent, MessagePortLike, PluginBridgeClientOptions, PluginBridgeRequestOptions, PluginCanvasAccessibilityState, PluginCanvasInputEvent, PluginCanvasKeyEvent, PluginCanvasPointerEvent, PluginCanvasWheelEvent, PluginCanvasResizeEvent, PluginCanvasSurface, PluginFileExportRequest, PluginSurfaceKeyboardBinding, PluginSurfaceKeyboardEvent, PluginSurfaceKeyboardTargetKind, PluginJSONObject, PluginJSONValue, PluginMethodResult, PluginExecutionFailureCode, PluginExecutionSnapshot, PluginExecutionProgress, PluginExecutionEvent, PluginExecutionEventList, PluginSurfaceContext, PluginSurfaceFileExportMediaType, PluginUIActionEvent, PluginUIAttributeValue, PluginUIElementVNode, PluginUIPatchOperation, PluginUIVNode, } from "./surface.js";
 export type { PluginCapabilitySchema, PluginCapabilityEffect, PluginCapabilityOperationContract, PluginCapabilityStreamContract, PluginCapabilitySyncContract, PluginCapabilityStreamEvent, PluginCapabilityStreamReadResult, PluginExecution, PluginExecutionTerminalStatus, PluginExecutionWaitOptions, PluginStream, } from "./capability-client.js";

package/dist/plugin.js

@@ -1,4 +1,5 @@
 export { PluginBridgeClient } from "./surface.js";
 export { PluginBridgeError } from "./errors.js";
 export { pluginAPIMajor } from "./contracts.gen.js";
+export { createPluginProcessClient } from "./process.js";
 export { callCapabilityOperation, callCapabilityStream, callCapabilitySync, isCapabilityBusinessError, } from "./capability-client.js";

package/dist/process.d.ts

@@ -0,0 +1,131 @@
+import { type PluginCapabilitySyncContract } from "./capability-client.js";
+import type { PluginBridgeClient, PluginBridgeRequestOptions } from "./surface.js";
+export type PluginProcessResourceLimits = Readonly<{
+    output_buffer_bytes?: number;
+    max_runtime_ms?: number;
+}>;
+export type PluginProcessStartRequest = Readonly<{
+    program: string;
+    argv?: readonly string[];
+    cwd?: string;
+    environment?: Readonly<Record<string, string>>;
+    environment_removals?: readonly string[];
+    secret_references?: Readonly<Record<string, string>>;
+    client_key: string;
+    resource_limits?: PluginProcessResourceLimits;
+}>;
+export type PluginProcessStatus = Readonly<{
+    handle: string;
+    client_key: string;
+    state: "starting" | "running" | "exited" | string;
+    exit_code?: number;
+    termination_reason?: string;
+}>;
+export type PluginProcessReadResult = Readonly<{
+    data_base64: string;
+    cursor: number;
+    eof: boolean;
+    process_exit: boolean;
+    stream_gap: boolean;
+    dropped_bytes?: number;
+}>;
+export type PluginProcessExitResult = Readonly<{
+    exit_code?: number;
+    termination_reason: string;
+}>;
+export type PluginProcessMethodContracts = Readonly<{
+    start: PluginCapabilitySyncContract;
+    attach: PluginCapabilitySyncContract;
+    status: PluginCapabilitySyncContract;
+    writeStdin: PluginCapabilitySyncContract;
+    closeStdin: PluginCapabilitySyncContract;
+    readStdout: PluginCapabilitySyncContract;
+    readStderr: PluginCapabilitySyncContract;
+    wait: PluginCapabilitySyncContract;
+    terminate: PluginCapabilitySyncContract;
+    kill: PluginCapabilitySyncContract;
+    close: PluginCapabilitySyncContract;
+}>;
+export declare function createPluginProcessClient(bridge: PluginBridgeClient, contracts: PluginProcessMethodContracts): {
+    start(request: PluginProcessStartRequest, options?: PluginBridgeRequestOptions): Promise<Readonly<{
+        handle: string;
+        client_key: string;
+        state: "starting" | "running" | "exited" | string;
+        exit_code?: number;
+        termination_reason?: string;
+    }>>;
+    attach(request: Readonly<{
+        client_key: string;
+    }>, options?: PluginBridgeRequestOptions): Promise<Readonly<{
+        handle: string;
+        client_key: string;
+        state: "starting" | "running" | "exited" | string;
+        exit_code?: number;
+        termination_reason?: string;
+    }>>;
+    status(request: Readonly<{
+        handle: string;
+    }>, options?: PluginBridgeRequestOptions): Promise<Readonly<{
+        handle: string;
+        client_key: string;
+        state: "starting" | "running" | "exited" | string;
+        exit_code?: number;
+        termination_reason?: string;
+    }>>;
+    writeStdin(request: Readonly<{
+        handle: string;
+        data_base64: string;
+    }>, options?: PluginBridgeRequestOptions): Promise<Readonly<{
+        written: number;
+    }>>;
+    closeStdin(request: Readonly<{
+        handle: string;
+    }>, options?: PluginBridgeRequestOptions): Promise<Readonly<{
+        ok: boolean;
+    }>>;
+    readStdout(request: Readonly<{
+        handle: string;
+        cursor?: number;
+        max_bytes: number;
+    }>, options?: PluginBridgeRequestOptions): Promise<Readonly<{
+        data_base64: string;
+        cursor: number;
+        eof: boolean;
+        process_exit: boolean;
+        stream_gap: boolean;
+        dropped_bytes?: number;
+    }>>;
+    readStderr(request: Readonly<{
+        handle: string;
+        cursor?: number;
+        max_bytes: number;
+    }>, options?: PluginBridgeRequestOptions): Promise<Readonly<{
+        data_base64: string;
+        cursor: number;
+        eof: boolean;
+        process_exit: boolean;
+        stream_gap: boolean;
+        dropped_bytes?: number;
+    }>>;
+    wait(request: Readonly<{
+        handle: string;
+    }>, options?: PluginBridgeRequestOptions): Promise<Readonly<{
+        exit_code?: number;
+        termination_reason: string;
+    }>>;
+    terminate(request: Readonly<{
+        handle: string;
+    }>, options?: PluginBridgeRequestOptions): Promise<Readonly<{
+        ok: boolean;
+    }>>;
+    kill(request: Readonly<{
+        handle: string;
+    }>, options?: PluginBridgeRequestOptions): Promise<Readonly<{
+        ok: boolean;
+    }>>;
+    close(request: Readonly<{
+        handle: string;
+    }>, options?: PluginBridgeRequestOptions): Promise<Readonly<{
+        ok: boolean;
+    }>>;
+};

package/dist/process.js

@@ -0,0 +1,38 @@
+import { callCapabilitySync } from "./capability-client.js";
+export function createPluginProcessClient(bridge, contracts) {
+    return {
+        start(request, options) {
+            return callCapabilitySync(bridge, contracts.start, request, options);
+        },
+        attach(request, options) {
+            return callCapabilitySync(bridge, contracts.attach, request, options);
+        },
+        status(request, options) {
+            return callCapabilitySync(bridge, contracts.status, request, options);
+        },
+        writeStdin(request, options) {
+            return callCapabilitySync(bridge, contracts.writeStdin, request, options);
+        },
+        closeStdin(request, options) {
+            return callCapabilitySync(bridge, contracts.closeStdin, request, options);
+        },
+        readStdout(request, options) {
+            return callCapabilitySync(bridge, contracts.readStdout, request, options);
+        },
+        readStderr(request, options) {
+            return callCapabilitySync(bridge, contracts.readStderr, request, options);
+        },
+        wait(request, options) {
+            return callCapabilitySync(bridge, contracts.wait, request, options);
+        },
+        terminate(request, options) {
+            return callCapabilitySync(bridge, contracts.terminate, request, options);
+        },
+        kill(request, options) {
+            return callCapabilitySync(bridge, contracts.kill, request, options);
+        },
+        close(request, options) {
+            return callCapabilitySync(bridge, contracts.close, request, options);
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@floegence/redevplugin-ui",
-  "version": "3.0.33",
+  "version": "3.0.35",
   "license": "MIT",
   "type": "module",
   "repository": {
@@ -40,7 +40,7 @@
     "dist"
   ],
   "dependencies": {
-    "@floegence/redevplugin-contracts": "3.0.33",
+    "@floegence/redevplugin-contracts": "3.0.35",
     "@noble/hashes": "2.4.0"
   },
   "publishConfig": {