@termix-ssh/plugin-sdk 1.0.22 → 1.0.23

package/dist/testing.js

@@ -146,6 +146,8 @@ export function createFakeContext(options = {}) {
     const createdSshKeys = [];
     const notifications = [];
     const notifyHub = { current: null };
+    const operationHandlers = new Map();
+    const operationEvents = [];
     const fetches = [];
     const processRuns = [];
     const binaries = [];
@@ -855,6 +857,47 @@ export function createFakeContext(options = {}) {
                 });
             },
         },
+        operations: {
+            register: (id, handler) => {
+                operationHandlers.set(id, handler);
+            },
+            run: async (actionId, options = {}) => {
+                const handler = operationHandlers.get(actionId);
+                if (!handler)
+                    throw new Error(`No action "${actionId}"`);
+                const result = await handler.run(options.input ?? {}, {
+                    hostId: options.hostId,
+                    resourceKey: options.resourceKey,
+                    runId: null,
+                    dryRun: options.dryRun === true,
+                    signal: new AbortController().signal,
+                    log: () => { },
+                });
+                return { runId: null, status: "success", ...result };
+            },
+            invoke: async (actionId, options = {}) => {
+                const handler = operationHandlers.get(actionId);
+                if (!handler)
+                    throw new Error(`No action "${actionId}"`);
+                const result = await handler.run(options.input ?? {}, {
+                    hostId: options.hostId,
+                    resourceKey: options.resourceKey,
+                    runId: null,
+                    dryRun: options.dryRun === true,
+                    signal: new AbortController().signal,
+                    log: () => { },
+                });
+                return { runId: null, status: "success", ...result };
+            },
+            list: async () => ({
+                actions: manifest.contributes?.operations?.actions ?? [],
+            }),
+            emit: async (eventId, payload, options) => {
+                operationEvents.push({ eventId, payload, hostId: options?.hostId });
+            },
+            onEvent: () => () => { },
+            approvals: { provide: () => () => { } },
+        },
         notify: {
             channels: async () => {
                 if (!actor)
@@ -1016,6 +1059,8 @@ export function createFakeContext(options = {}) {
         createdSshKeys,
         notifications,
         notifyHub,
+        operationHandlers,
+        operationEvents,
         fetches,
         processRuns,
         binaries,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@termix-ssh/plugin-sdk",
-  "version": "1.0.22",
+  "version": "1.0.23",
   "description": "The contract between Termix core and a plugin: types, the capability catalog and the manifest schema.",
   "license": "Apache-2.0",
   "repository": {
@@ -61,6 +61,10 @@
       "types": "./dist/openapi.d.ts",
       "default": "./dist/openapi.js"
     },
+    "./operations": {
+      "types": "./dist/operations.d.ts",
+      "default": "./dist/operations.js"
+    },
     "./settings": {
       "types": "./dist/settings.d.ts",
       "default": "./dist/settings.js"

package/schema/manifest.schema.json

@@ -536,6 +536,31 @@
             }
           }
         },
+        "hostSections": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "titleKey"],
+            "properties": {
+              "id": { "type": "string", "minLength": 1 },
+              "titleKey": { "type": "string", "minLength": 1 },
+              "icon": { "type": "string", "minLength": 1 }
+            }
+          }
+        },
+        "operations": {
+          "type": "object",
+          "description": "What this plugin can do. Every surface finds these on its own. See the operations section of PLUGIN-GUIDE.md.",
+          "additionalProperties": false,
+          "properties": {
+            "actions": { "type": "array", "items": { "type": "object" } },
+            "events": { "type": "array", "items": { "type": "object" } },
+            "resources": { "type": "array", "items": { "type": "object" } },
+            "signals": { "type": "array", "items": { "type": "object" } },
+            "invokes": { "type": "array", "items": { "type": "string" } }
+          }
+        },
         "dashboardCards": {
           "type": "array",
           "items": {