@ubiquity-os/plugin-sdk 1.0.11 → 1.1.1

package/dist/index.d.mts

@@ -1,53 +1,48 @@
 import * as hono_types from 'hono/types';
 import { EmitterWebhookEventName, EmitterWebhookEvent } from '@octokit/webhooks';
-import { TAnySchema } from '@sinclair/typebox';
-import { Logs, LogLevel, LogReturn } from '@ubiquity-os/ubiquity-os-logger';
 import { Hono } from 'hono';
-import * as _octokit_core_dist_types_types from '@octokit/core/dist-types/types';
-import * as _octokit_plugin_paginate_graphql from '@octokit/plugin-paginate-graphql';
-import * as _octokit_plugin_rest_endpoint_methods from '@octokit/plugin-rest-endpoint-methods';
-import * as _octokit_plugin_paginate_rest from '@octokit/plugin-paginate-rest';
-import * as _octokit_request_error from '@octokit/request-error';
-import { Octokit } from '@octokit/core';
+import { Logs, LogLevel, LogReturn } from '@ubiquity-os/ubiquity-os-logger';
+import { customOctokit } from './octokit.mjs';
 import { Manifest } from './manifest.mjs';
+import { TAnySchema } from '@sinclair/typebox';
+import '@octokit/core/dist-types/types';
+import '@octokit/plugin-paginate-graphql';
+import '@octokit/plugin-rest-endpoint-methods';
+import '@octokit/plugin-paginate-rest';
+import '@octokit/request-error';
+import '@octokit/core';
 
-declare const customOctokit: typeof Octokit & _octokit_core_dist_types_types.Constructor<{
-    retry: {
-        retryRequest: (error: _octokit_request_error.RequestError, retries: number, retryAfter: number) => _octokit_request_error.RequestError;
-    };
-} & {
-    paginate: _octokit_plugin_paginate_rest.PaginateInterface;
-} & _octokit_plugin_rest_endpoint_methods.Api & _octokit_plugin_paginate_graphql.paginateGraphQLInterface>;
-
-interface Context<TConfig = unknown, TEnv = unknown, TSupportedEvents extends EmitterWebhookEventName = EmitterWebhookEventName> {
+interface Context<TConfig = unknown, TEnv = unknown, TCommand = unknown, TSupportedEvents extends EmitterWebhookEventName = EmitterWebhookEventName> {
     eventName: TSupportedEvents;
     payload: {
         [K in TSupportedEvents]: K extends EmitterWebhookEventName ? EmitterWebhookEvent<K> : never;
     }[TSupportedEvents]["payload"];
+    command: TCommand | null;
     octokit: InstanceType<typeof customOctokit>;
     config: TConfig;
     env: TEnv;
     logger: Logs;
 }
 
-interface Options$1 {
+type Return = Record<string, unknown> | undefined | void;
+type HandlerReturn = Promise<Return> | Return;
+
+interface Options {
     kernelPublicKey?: string;
     logLevel?: LogLevel;
     postCommentOnError?: boolean;
     settingsSchema?: TAnySchema;
     envSchema?: TAnySchema;
+    commandSchema?: TAnySchema;
+    /**
+     * @deprecated This disables signature verification - only for local development
+     */
     bypassSignatureVerification?: boolean;
 }
-declare function createPlugin<TConfig = unknown, TEnv = unknown, TSupportedEvents extends EmitterWebhookEventName = EmitterWebhookEventName>(handler: (context: Context<TConfig, TEnv, TSupportedEvents>) => Promise<Record<string, unknown> | undefined>, manifest: Manifest, options?: Options$1): Hono<hono_types.BlankEnv, hono_types.BlankSchema, "/">;
 
-interface Options {
-    logLevel?: LogLevel;
-    postCommentOnError?: boolean;
-    settingsSchema?: TAnySchema;
-    envSchema?: TAnySchema;
-    kernelPublicKey?: string;
-}
-declare function createActionsPlugin<TConfig = unknown, TEnv = unknown, TSupportedEvents extends EmitterWebhookEventName = EmitterWebhookEventName>(handler: (context: Context<TConfig, TEnv, TSupportedEvents>) => Promise<Record<string, unknown> | undefined>, options?: Options): Promise<void>;
+declare function createPlugin<TConfig = unknown, TEnv = unknown, TCommand = unknown, TSupportedEvents extends EmitterWebhookEventName = EmitterWebhookEventName>(handler: (context: Context<TConfig, TEnv, TCommand, TSupportedEvents>) => HandlerReturn, manifest: Manifest, options?: Options): Hono<hono_types.BlankEnv, hono_types.BlankSchema, "/">;
+
+declare function createActionsPlugin<TConfig = unknown, TEnv = unknown, TCommand = unknown, TSupportedEvents extends EmitterWebhookEventName = EmitterWebhookEventName>(handler: (context: Context<TConfig, TEnv, TCommand, TSupportedEvents>) => HandlerReturn, options?: Options): Promise<void>;
 
 /**
  * Posts a comment on a GitHub issue if the issue exists in the context payload, embedding structured metadata to it.

package/dist/index.d.ts

@@ -1,53 +1,48 @@
 import * as hono_types from 'hono/types';
 import { EmitterWebhookEventName, EmitterWebhookEvent } from '@octokit/webhooks';
-import { TAnySchema } from '@sinclair/typebox';
-import { Logs, LogLevel, LogReturn } from '@ubiquity-os/ubiquity-os-logger';
 import { Hono } from 'hono';
-import * as _octokit_core_dist_types_types from '@octokit/core/dist-types/types';
-import * as _octokit_plugin_paginate_graphql from '@octokit/plugin-paginate-graphql';
-import * as _octokit_plugin_rest_endpoint_methods from '@octokit/plugin-rest-endpoint-methods';
-import * as _octokit_plugin_paginate_rest from '@octokit/plugin-paginate-rest';
-import * as _octokit_request_error from '@octokit/request-error';
-import { Octokit } from '@octokit/core';
+import { Logs, LogLevel, LogReturn } from '@ubiquity-os/ubiquity-os-logger';
+import { customOctokit } from './octokit.js';
 import { Manifest } from './manifest.js';
+import { TAnySchema } from '@sinclair/typebox';
+import '@octokit/core/dist-types/types';
+import '@octokit/plugin-paginate-graphql';
+import '@octokit/plugin-rest-endpoint-methods';
+import '@octokit/plugin-paginate-rest';
+import '@octokit/request-error';
+import '@octokit/core';
 
-declare const customOctokit: typeof Octokit & _octokit_core_dist_types_types.Constructor<{
-    retry: {
-        retryRequest: (error: _octokit_request_error.RequestError, retries: number, retryAfter: number) => _octokit_request_error.RequestError;
-    };
-} & {
-    paginate: _octokit_plugin_paginate_rest.PaginateInterface;
-} & _octokit_plugin_rest_endpoint_methods.Api & _octokit_plugin_paginate_graphql.paginateGraphQLInterface>;
-
-interface Context<TConfig = unknown, TEnv = unknown, TSupportedEvents extends EmitterWebhookEventName = EmitterWebhookEventName> {
+interface Context<TConfig = unknown, TEnv = unknown, TCommand = unknown, TSupportedEvents extends EmitterWebhookEventName = EmitterWebhookEventName> {
     eventName: TSupportedEvents;
     payload: {
         [K in TSupportedEvents]: K extends EmitterWebhookEventName ? EmitterWebhookEvent<K> : never;
     }[TSupportedEvents]["payload"];
+    command: TCommand | null;
     octokit: InstanceType<typeof customOctokit>;
     config: TConfig;
     env: TEnv;
     logger: Logs;
 }
 
-interface Options$1 {
+type Return = Record<string, unknown> | undefined | void;
+type HandlerReturn = Promise<Return> | Return;
+
+interface Options {
     kernelPublicKey?: string;
     logLevel?: LogLevel;
     postCommentOnError?: boolean;
     settingsSchema?: TAnySchema;
     envSchema?: TAnySchema;
+    commandSchema?: TAnySchema;
+    /**
+     * @deprecated This disables signature verification - only for local development
+     */
     bypassSignatureVerification?: boolean;
 }
-declare function createPlugin<TConfig = unknown, TEnv = unknown, TSupportedEvents extends EmitterWebhookEventName = EmitterWebhookEventName>(handler: (context: Context<TConfig, TEnv, TSupportedEvents>) => Promise<Record<string, unknown> | undefined>, manifest: Manifest, options?: Options$1): Hono<hono_types.BlankEnv, hono_types.BlankSchema, "/">;
 
-interface Options {
-    logLevel?: LogLevel;
-    postCommentOnError?: boolean;
-    settingsSchema?: TAnySchema;
-    envSchema?: TAnySchema;
-    kernelPublicKey?: string;
-}
-declare function createActionsPlugin<TConfig = unknown, TEnv = unknown, TSupportedEvents extends EmitterWebhookEventName = EmitterWebhookEventName>(handler: (context: Context<TConfig, TEnv, TSupportedEvents>) => Promise<Record<string, unknown> | undefined>, options?: Options): Promise<void>;
+declare function createPlugin<TConfig = unknown, TEnv = unknown, TCommand = unknown, TSupportedEvents extends EmitterWebhookEventName = EmitterWebhookEventName>(handler: (context: Context<TConfig, TEnv, TCommand, TSupportedEvents>) => HandlerReturn, manifest: Manifest, options?: Options): Hono<hono_types.BlankEnv, hono_types.BlankSchema, "/">;
+
+declare function createActionsPlugin<TConfig = unknown, TEnv = unknown, TCommand = unknown, TSupportedEvents extends EmitterWebhookEventName = EmitterWebhookEventName>(handler: (context: Context<TConfig, TEnv, TCommand, TSupportedEvents>) => HandlerReturn, options?: Options): Promise<void>;
 
 /**
  * Posts a comment on a GitHub issue if the issue exists in the context payload, embedding structured metadata to it.

package/dist/index.js

@@ -39,15 +39,42 @@ module.exports = __toCommonJS(src_exports);
 // src/server.ts
 var import_typebox = require("@sinclair/typebox");
 var import_value = require("@sinclair/typebox/value");
-var import_ubiquity_os_logger = require("@ubiquity-os/ubiquity-os-logger");
+var import_ubiquity_os_logger2 = require("@ubiquity-os/ubiquity-os-logger");
 var import_hono = require("hono");
 var import_adapter = require("hono/adapter");
 var import_http_exception = require("hono/http-exception");
 
+// src/util.ts
+var import_ubiquity_os_logger = require("@ubiquity-os/ubiquity-os-logger");
+
+// src/constants.ts
+var KERNEL_PUBLIC_KEY = `-----BEGIN PUBLIC KEY-----
+MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAs96DOU+JqM8SyNXOB6u3
+uBKIFiyrcST/LZTYN6y7LeJlyCuGPqSDrWCfjU9Ph5PLf9TWiNmeM8DGaOpwEFC7
+U3NRxOSglo4plnQ5zRwIHHXvxyK400sQP2oISXymISuBQWjEIqkC9DybQrKwNzf+
+I0JHWPqmwMIw26UvVOtXGOOWBqTkk+N2+/9f8eDIJP5QQVwwszc8s1rXOsLMlVIf
+wShw7GO4E2jyK8TSJKpyjV8eb1JJMDwFhPiRrtZfQJUtDf2mV/67shQww61BH2Y/
+Plnalo58kWIbkqZoq1yJrL5sFb73osM5+vADTXVn79bkvea7W19nSkdMiarYt4Hq
+JQIDAQAB
+-----END PUBLIC KEY-----
+`;
+
 // src/util.ts
 function sanitizeMetadata(obj) {
   return JSON.stringify(obj, null, 2).replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/--/g, "&#45;&#45;");
 }
+function getPluginOptions(options) {
+  return {
+    // Important to use || and not ?? to not consider empty strings
+    kernelPublicKey: options?.kernelPublicKey || KERNEL_PUBLIC_KEY,
+    logLevel: options?.logLevel ?? import_ubiquity_os_logger.LOG_LEVEL.INFO,
+    postCommentOnError: options?.postCommentOnError ?? true,
+    settingsSchema: options?.settingsSchema,
+    envSchema: options?.envSchema,
+    commandSchema: options?.commandSchema,
+    bypassSignatureVerification: options?.bypassSignatureVerification || false
+  };
+}
 
 // src/comment.ts
 var HEADER_NAME = "Ubiquity";
@@ -85,18 +112,6 @@ ${metadataSerialized}
 `;
 }
 
-// src/constants.ts
-var KERNEL_PUBLIC_KEY = `-----BEGIN PUBLIC KEY-----
-MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAs96DOU+JqM8SyNXOB6u3
-uBKIFiyrcST/LZTYN6y7LeJlyCuGPqSDrWCfjU9Ph5PLf9TWiNmeM8DGaOpwEFC7
-U3NRxOSglo4plnQ5zRwIHHXvxyK400sQP2oISXymISuBQWjEIqkC9DybQrKwNzf+
-I0JHWPqmwMIw26UvVOtXGOOWBqTkk+N2+/9f8eDIJP5QQVwwszc8s1rXOsLMlVIf
-wShw7GO4E2jyK8TSJKpyjV8eb1JJMDwFhPiRrtZfQJUtDf2mV/67shQww61BH2Y/
-Plnalo58kWIbkqZoq1yJrL5sFb73osM5+vADTXVn79bkvea7W19nSkdMiarYt4Hq
-JQIDAQAB
------END PUBLIC KEY-----
-`;
-
 // src/octokit.ts
 var import_core = require("@octokit/core");
 var import_plugin_paginate_rest = require("@octokit/plugin-paginate-rest");
@@ -133,7 +148,8 @@ async function verifySignature(publicKeyPem, inputs, signature) {
       eventPayload: inputs.eventPayload,
       settings: inputs.settings,
       authToken: inputs.authToken,
-      ref: inputs.ref
+      ref: inputs.ref,
+      command: inputs.command
     };
     const pemContents = publicKeyPem.replace("-----BEGIN PUBLIC KEY-----", "").replace("-----END PUBLIC KEY-----", "").trim();
     const binaryDer = Uint8Array.from(atob(pemContents), (c) => c.charCodeAt(0));
@@ -161,25 +177,14 @@ var inputSchema = import_typebox.Type.Object({
   stateId: import_typebox.Type.String(),
   eventName: import_typebox.Type.String(),
   eventPayload: import_typebox.Type.Record(import_typebox.Type.String(), import_typebox.Type.Any()),
+  command: import_typebox.Type.Union([import_typebox.Type.Null(), import_typebox.Type.Object({ name: import_typebox.Type.String(), parameters: import_typebox.Type.Unknown() })]),
   authToken: import_typebox.Type.String(),
   settings: import_typebox.Type.Record(import_typebox.Type.String(), import_typebox.Type.Any()),
   ref: import_typebox.Type.String(),
-  signature: import_typebox.Type.String(),
-  bypassSignatureVerification: import_typebox.Type.Optional(
-    import_typebox.Type.Boolean({
-      default: false,
-      description: "Bypass signature verification (caution: only use this if you know what you're doing)"
-    })
-  )
+  signature: import_typebox.Type.String()
 });
 function createPlugin(handler, manifest, options) {
-  const pluginOptions = {
-    kernelPublicKey: options?.kernelPublicKey ?? KERNEL_PUBLIC_KEY,
-    logLevel: options?.logLevel ?? import_ubiquity_os_logger.LOG_LEVEL.INFO,
-    postCommentOnError: options?.postCommentOnError ?? true,
-    settingsSchema: options?.settingsSchema,
-    envSchema: options?.envSchema
-  };
+  const pluginOptions = getPluginOptions(options);
   const app = new import_hono.Hono();
   app.get("/manifest.json", (ctx) => {
     return ctx.json(manifest);
@@ -191,12 +196,12 @@ function createPlugin(handler, manifest, options) {
     const body = await ctx.req.json();
     const inputSchemaErrors = [...import_value.Value.Errors(inputSchema, body)];
     if (inputSchemaErrors.length) {
-      console.dir(inputSchemaErrors, { depth: null });
+      console.log(inputSchemaErrors, { depth: null });
       throw new import_http_exception.HTTPException(400, { message: "Invalid body" });
     }
     const inputs = import_value.Value.Decode(inputSchema, body);
     const signature = inputs.signature;
-    if (!options?.bypassSignatureVerification && !await verifySignature(pluginOptions.kernelPublicKey, inputs, signature)) {
+    if (!pluginOptions.bypassSignatureVerification && !await verifySignature(pluginOptions.kernelPublicKey, inputs, signature)) {
       throw new import_http_exception.HTTPException(400, { message: "Invalid signature" });
     }
     let config2;
@@ -204,7 +209,7 @@ function createPlugin(handler, manifest, options) {
       try {
         config2 = import_value.Value.Decode(pluginOptions.settingsSchema, import_value.Value.Default(pluginOptions.settingsSchema, inputs.settings));
       } catch (e) {
-        console.dir(...import_value.Value.Errors(pluginOptions.settingsSchema, inputs.settings), { depth: null });
+        console.log(...import_value.Value.Errors(pluginOptions.settingsSchema, inputs.settings), { depth: null });
         throw e;
       }
     } else {
@@ -216,29 +221,41 @@ function createPlugin(handler, manifest, options) {
       try {
         env = import_value.Value.Decode(pluginOptions.envSchema, import_value.Value.Default(pluginOptions.envSchema, honoEnvironment));
       } catch (e) {
-        console.dir(...import_value.Value.Errors(pluginOptions.envSchema, honoEnvironment), { depth: null });
+        console.log(...import_value.Value.Errors(pluginOptions.envSchema, honoEnvironment), { depth: null });
         throw e;
       }
     } else {
       env = ctx.env;
     }
+    let command = null;
+    if (inputs.command && pluginOptions.commandSchema) {
+      try {
+        command = import_value.Value.Decode(pluginOptions.commandSchema, import_value.Value.Default(pluginOptions.commandSchema, inputs.command));
+      } catch (e) {
+        console.log(...import_value.Value.Errors(pluginOptions.commandSchema, inputs.command), { depth: null });
+        throw e;
+      }
+    } else if (inputs.command) {
+      command = inputs.command;
+    }
     const context2 = {
       eventName: inputs.eventName,
       payload: inputs.eventPayload,
+      command,
       octokit: new customOctokit({ auth: inputs.authToken }),
       config: config2,
       env,
-      logger: new import_ubiquity_os_logger.Logs(pluginOptions.logLevel)
+      logger: new import_ubiquity_os_logger2.Logs(pluginOptions.logLevel)
     };
     try {
       const result = await handler(context2);
-      return ctx.json({ stateId: inputs.stateId, output: result });
+      return ctx.json({ stateId: inputs.stateId, output: result ?? {} });
     } catch (error) {
       console.error(error);
       let loggerError;
       if (error instanceof Error) {
         loggerError = context2.logger.error(`Error: ${error}`, { error });
-      } else if (error instanceof import_ubiquity_os_logger.LogReturn) {
+      } else if (error instanceof import_ubiquity_os_logger2.LogReturn) {
         loggerError = error;
       } else {
         loggerError = context2.logger.error(`Error: ${error}`);
@@ -255,75 +272,99 @@ function createPlugin(handler, manifest, options) {
 // src/actions.ts
 var core = __toESM(require("@actions/core"));
 var github = __toESM(require("@actions/github"));
+var import_typebox4 = require("@sinclair/typebox");
+var import_value3 = require("@sinclair/typebox/value");
+var import_ubiquity_os_logger3 = require("@ubiquity-os/ubiquity-os-logger");
+var import_dotenv = require("dotenv");
+
+// src/types/command.ts
 var import_typebox2 = require("@sinclair/typebox");
+var commandCallSchema = import_typebox2.Type.Union([import_typebox2.Type.Null(), import_typebox2.Type.Object({ name: import_typebox2.Type.String(), parameters: import_typebox2.Type.Unknown() })]);
+
+// src/types/util.ts
+var import_typebox3 = require("@sinclair/typebox");
 var import_value2 = require("@sinclair/typebox/value");
-var import_ubiquity_os_logger2 = require("@ubiquity-os/ubiquity-os-logger");
-var import_dotenv = require("dotenv");
+function jsonType(type) {
+  return import_typebox3.Type.Transform(import_typebox3.Type.String()).Decode((value) => {
+    const parsed = JSON.parse(value);
+    return import_value2.Value.Decode(type, import_value2.Value.Default(type, parsed));
+  }).Encode((value) => JSON.stringify(value));
+}
+
+// src/actions.ts
 (0, import_dotenv.config)();
-var inputSchema2 = import_typebox2.Type.Object({
-  stateId: import_typebox2.Type.String(),
-  eventName: import_typebox2.Type.String(),
-  eventPayload: import_typebox2.Type.String(),
-  authToken: import_typebox2.Type.String(),
-  settings: import_typebox2.Type.String(),
-  ref: import_typebox2.Type.String(),
-  signature: import_typebox2.Type.String()
+var inputSchema2 = import_typebox4.Type.Object({
+  stateId: import_typebox4.Type.String(),
+  eventName: import_typebox4.Type.String(),
+  eventPayload: jsonType(import_typebox4.Type.Record(import_typebox4.Type.String(), import_typebox4.Type.Any())),
+  command: jsonType(commandCallSchema),
+  authToken: import_typebox4.Type.String(),
+  settings: jsonType(import_typebox4.Type.Record(import_typebox4.Type.String(), import_typebox4.Type.Any())),
+  ref: import_typebox4.Type.String(),
+  signature: import_typebox4.Type.String()
 });
 async function createActionsPlugin(handler, options) {
-  const pluginOptions = {
-    logLevel: options?.logLevel ?? import_ubiquity_os_logger2.LOG_LEVEL.INFO,
-    postCommentOnError: options?.postCommentOnError ?? true,
-    settingsSchema: options?.settingsSchema,
-    envSchema: options?.envSchema,
-    kernelPublicKey: options?.kernelPublicKey ?? KERNEL_PUBLIC_KEY
-  };
+  const pluginOptions = getPluginOptions(options);
   const pluginGithubToken = process.env.PLUGIN_GITHUB_TOKEN;
   if (!pluginGithubToken) {
     core.setFailed("Error: PLUGIN_GITHUB_TOKEN env is not set");
     return;
   }
+  const body = github.context.payload.inputs;
+  const signature = body.signature;
+  if (!pluginOptions.bypassSignatureVerification && !await verifySignature(pluginOptions.kernelPublicKey, body, signature)) {
+    core.setFailed(`Error: Invalid signature`);
+    return;
+  }
   const inputPayload = github.context.payload.inputs;
-  const inputSchemaErrors = [...import_value2.Value.Errors(inputSchema2, inputPayload)];
+  const inputSchemaErrors = [...import_value3.Value.Errors(inputSchema2, inputPayload)];
   if (inputSchemaErrors.length) {
     console.dir(inputSchemaErrors, { depth: null });
     core.setFailed(`Error: Invalid inputs payload: ${inputSchemaErrors.join(",")}`);
     return;
   }
-  const inputs = import_value2.Value.Decode(inputSchema2, inputPayload);
-  const signature = inputs.signature;
-  if (!await verifySignature(pluginOptions.kernelPublicKey, inputs, signature)) {
-    core.setFailed(`Error: Invalid signature`);
-    return;
-  }
+  const inputs = import_value3.Value.Decode(inputSchema2, inputPayload);
   let config2;
   if (pluginOptions.settingsSchema) {
     try {
-      config2 = import_value2.Value.Decode(pluginOptions.settingsSchema, import_value2.Value.Default(pluginOptions.settingsSchema, JSON.parse(inputs.settings)));
+      config2 = import_value3.Value.Decode(pluginOptions.settingsSchema, import_value3.Value.Default(pluginOptions.settingsSchema, inputs.settings));
     } catch (e) {
-      console.dir(...import_value2.Value.Errors(pluginOptions.settingsSchema, JSON.parse(inputs.settings)), { depth: null });
+      console.dir(...import_value3.Value.Errors(pluginOptions.settingsSchema, inputs.settings), { depth: null });
       throw e;
     }
   } else {
-    config2 = JSON.parse(inputs.settings);
+    config2 = inputs.settings;
   }
   let env;
   if (pluginOptions.envSchema) {
     try {
-      env = import_value2.Value.Decode(pluginOptions.envSchema, import_value2.Value.Default(pluginOptions.envSchema, process.env));
+      env = import_value3.Value.Decode(pluginOptions.envSchema, import_value3.Value.Default(pluginOptions.envSchema, process.env));
     } catch (e) {
-      console.dir(...import_value2.Value.Errors(pluginOptions.envSchema, process.env), { depth: null });
+      console.dir(...import_value3.Value.Errors(pluginOptions.envSchema, process.env), { depth: null });
       throw e;
     }
   } else {
     env = process.env;
   }
+  let command = null;
+  if (inputs.command && pluginOptions.commandSchema) {
+    try {
+      command = import_value3.Value.Decode(pluginOptions.commandSchema, import_value3.Value.Default(pluginOptions.commandSchema, inputs.command));
+    } catch (e) {
+      console.dir(...import_value3.Value.Errors(pluginOptions.commandSchema, inputs.command), { depth: null });
+      throw e;
+    }
+  } else if (inputs.command) {
+    command = inputs.command;
+  }
   const context2 = {
     eventName: inputs.eventName,
-    payload: JSON.parse(inputs.eventPayload),
+    payload: inputs.eventPayload,
+    command,
     octokit: new customOctokit({ auth: inputs.authToken }),
     config: config2,
     env,
-    logger: new import_ubiquity_os_logger2.Logs(pluginOptions.logLevel)
+    logger: new import_ubiquity_os_logger3.Logs(pluginOptions.logLevel)
   };
   try {
     const result = await handler(context2);
@@ -335,7 +376,7 @@ async function createActionsPlugin(handler, options) {
     if (error instanceof Error) {
       core.setFailed(error);
       loggerError = context2.logger.error(`Error: ${error}`, { error });
-    } else if (error instanceof import_ubiquity_os_logger2.LogReturn) {
+    } else if (error instanceof import_ubiquity_os_logger3.LogReturn) {
       core.setFailed(error.logMessage.raw);
       loggerError = error;
     } else {

package/dist/index.mjs

@@ -1,15 +1,42 @@
 // src/server.ts
 import { Type as T } from "@sinclair/typebox";
 import { Value } from "@sinclair/typebox/value";
-import { LOG_LEVEL, LogReturn, Logs } from "@ubiquity-os/ubiquity-os-logger";
+import { LogReturn as LogReturn2, Logs } from "@ubiquity-os/ubiquity-os-logger";
 import { Hono } from "hono";
 import { env as honoEnv } from "hono/adapter";
 import { HTTPException } from "hono/http-exception";
 
+// src/util.ts
+import { LOG_LEVEL } from "@ubiquity-os/ubiquity-os-logger";
+
+// src/constants.ts
+var KERNEL_PUBLIC_KEY = `-----BEGIN PUBLIC KEY-----
+MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAs96DOU+JqM8SyNXOB6u3
+uBKIFiyrcST/LZTYN6y7LeJlyCuGPqSDrWCfjU9Ph5PLf9TWiNmeM8DGaOpwEFC7
+U3NRxOSglo4plnQ5zRwIHHXvxyK400sQP2oISXymISuBQWjEIqkC9DybQrKwNzf+
+I0JHWPqmwMIw26UvVOtXGOOWBqTkk+N2+/9f8eDIJP5QQVwwszc8s1rXOsLMlVIf
+wShw7GO4E2jyK8TSJKpyjV8eb1JJMDwFhPiRrtZfQJUtDf2mV/67shQww61BH2Y/
+Plnalo58kWIbkqZoq1yJrL5sFb73osM5+vADTXVn79bkvea7W19nSkdMiarYt4Hq
+JQIDAQAB
+-----END PUBLIC KEY-----
+`;
+
 // src/util.ts
 function sanitizeMetadata(obj) {
   return JSON.stringify(obj, null, 2).replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/--/g, "&#45;&#45;");
 }
+function getPluginOptions(options) {
+  return {
+    // Important to use || and not ?? to not consider empty strings
+    kernelPublicKey: options?.kernelPublicKey || KERNEL_PUBLIC_KEY,
+    logLevel: options?.logLevel ?? LOG_LEVEL.INFO,
+    postCommentOnError: options?.postCommentOnError ?? true,
+    settingsSchema: options?.settingsSchema,
+    envSchema: options?.envSchema,
+    commandSchema: options?.commandSchema,
+    bypassSignatureVerification: options?.bypassSignatureVerification || false
+  };
+}
 
 // src/comment.ts
 var HEADER_NAME = "Ubiquity";
@@ -47,18 +74,6 @@ ${metadataSerialized}
 `;
 }
 
-// src/constants.ts
-var KERNEL_PUBLIC_KEY = `-----BEGIN PUBLIC KEY-----
-MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAs96DOU+JqM8SyNXOB6u3
-uBKIFiyrcST/LZTYN6y7LeJlyCuGPqSDrWCfjU9Ph5PLf9TWiNmeM8DGaOpwEFC7
-U3NRxOSglo4plnQ5zRwIHHXvxyK400sQP2oISXymISuBQWjEIqkC9DybQrKwNzf+
-I0JHWPqmwMIw26UvVOtXGOOWBqTkk+N2+/9f8eDIJP5QQVwwszc8s1rXOsLMlVIf
-wShw7GO4E2jyK8TSJKpyjV8eb1JJMDwFhPiRrtZfQJUtDf2mV/67shQww61BH2Y/
-Plnalo58kWIbkqZoq1yJrL5sFb73osM5+vADTXVn79bkvea7W19nSkdMiarYt4Hq
-JQIDAQAB
------END PUBLIC KEY-----
-`;
-
 // src/octokit.ts
 import { Octokit } from "@octokit/core";
 import { paginateRest } from "@octokit/plugin-paginate-rest";
@@ -95,7 +110,8 @@ async function verifySignature(publicKeyPem, inputs, signature) {
       eventPayload: inputs.eventPayload,
       settings: inputs.settings,
       authToken: inputs.authToken,
-      ref: inputs.ref
+      ref: inputs.ref,
+      command: inputs.command
     };
     const pemContents = publicKeyPem.replace("-----BEGIN PUBLIC KEY-----", "").replace("-----END PUBLIC KEY-----", "").trim();
     const binaryDer = Uint8Array.from(atob(pemContents), (c) => c.charCodeAt(0));
@@ -123,25 +139,14 @@ var inputSchema = T.Object({
   stateId: T.String(),
   eventName: T.String(),
   eventPayload: T.Record(T.String(), T.Any()),
+  command: T.Union([T.Null(), T.Object({ name: T.String(), parameters: T.Unknown() })]),
   authToken: T.String(),
   settings: T.Record(T.String(), T.Any()),
   ref: T.String(),
-  signature: T.String(),
-  bypassSignatureVerification: T.Optional(
-    T.Boolean({
-      default: false,
-      description: "Bypass signature verification (caution: only use this if you know what you're doing)"
-    })
-  )
+  signature: T.String()
 });
 function createPlugin(handler, manifest, options) {
-  const pluginOptions = {
-    kernelPublicKey: options?.kernelPublicKey ?? KERNEL_PUBLIC_KEY,
-    logLevel: options?.logLevel ?? LOG_LEVEL.INFO,
-    postCommentOnError: options?.postCommentOnError ?? true,
-    settingsSchema: options?.settingsSchema,
-    envSchema: options?.envSchema
-  };
+  const pluginOptions = getPluginOptions(options);
   const app = new Hono();
   app.get("/manifest.json", (ctx) => {
     return ctx.json(manifest);
@@ -153,12 +158,12 @@ function createPlugin(handler, manifest, options) {
     const body = await ctx.req.json();
     const inputSchemaErrors = [...Value.Errors(inputSchema, body)];
     if (inputSchemaErrors.length) {
-      console.dir(inputSchemaErrors, { depth: null });
+      console.log(inputSchemaErrors, { depth: null });
       throw new HTTPException(400, { message: "Invalid body" });
     }
     const inputs = Value.Decode(inputSchema, body);
     const signature = inputs.signature;
-    if (!options?.bypassSignatureVerification && !await verifySignature(pluginOptions.kernelPublicKey, inputs, signature)) {
+    if (!pluginOptions.bypassSignatureVerification && !await verifySignature(pluginOptions.kernelPublicKey, inputs, signature)) {
       throw new HTTPException(400, { message: "Invalid signature" });
     }
     let config2;
@@ -166,7 +171,7 @@ function createPlugin(handler, manifest, options) {
       try {
         config2 = Value.Decode(pluginOptions.settingsSchema, Value.Default(pluginOptions.settingsSchema, inputs.settings));
       } catch (e) {
-        console.dir(...Value.Errors(pluginOptions.settingsSchema, inputs.settings), { depth: null });
+        console.log(...Value.Errors(pluginOptions.settingsSchema, inputs.settings), { depth: null });
         throw e;
       }
     } else {
@@ -178,15 +183,27 @@ function createPlugin(handler, manifest, options) {
       try {
         env = Value.Decode(pluginOptions.envSchema, Value.Default(pluginOptions.envSchema, honoEnvironment));
       } catch (e) {
-        console.dir(...Value.Errors(pluginOptions.envSchema, honoEnvironment), { depth: null });
+        console.log(...Value.Errors(pluginOptions.envSchema, honoEnvironment), { depth: null });
         throw e;
       }
     } else {
       env = ctx.env;
     }
+    let command = null;
+    if (inputs.command && pluginOptions.commandSchema) {
+      try {
+        command = Value.Decode(pluginOptions.commandSchema, Value.Default(pluginOptions.commandSchema, inputs.command));
+      } catch (e) {
+        console.log(...Value.Errors(pluginOptions.commandSchema, inputs.command), { depth: null });
+        throw e;
+      }
+    } else if (inputs.command) {
+      command = inputs.command;
+    }
     const context2 = {
       eventName: inputs.eventName,
       payload: inputs.eventPayload,
+      command,
       octokit: new customOctokit({ auth: inputs.authToken }),
       config: config2,
       env,
@@ -194,13 +211,13 @@ function createPlugin(handler, manifest, options) {
     };
     try {
       const result = await handler(context2);
-      return ctx.json({ stateId: inputs.stateId, output: result });
+      return ctx.json({ stateId: inputs.stateId, output: result ?? {} });
     } catch (error) {
       console.error(error);
       let loggerError;
       if (error instanceof Error) {
         loggerError = context2.logger.error(`Error: ${error}`, { error });
-      } else if (error instanceof LogReturn) {
+      } else if (error instanceof LogReturn2) {
         loggerError = error;
       } else {
         loggerError = context2.logger.error(`Error: ${error}`);
@@ -217,71 +234,95 @@ function createPlugin(handler, manifest, options) {
 // src/actions.ts
 import * as core from "@actions/core";
 import * as github from "@actions/github";
+import { Type as T3 } from "@sinclair/typebox";
+import { Value as Value3 } from "@sinclair/typebox/value";
+import { LogReturn as LogReturn3, Logs as Logs2 } from "@ubiquity-os/ubiquity-os-logger";
+import { config } from "dotenv";
+
+// src/types/command.ts
 import { Type as T2 } from "@sinclair/typebox";
+var commandCallSchema = T2.Union([T2.Null(), T2.Object({ name: T2.String(), parameters: T2.Unknown() })]);
+
+// src/types/util.ts
+import { Type } from "@sinclair/typebox";
 import { Value as Value2 } from "@sinclair/typebox/value";
-import { LOG_LEVEL as LOG_LEVEL2, LogReturn as LogReturn2, Logs as Logs2 } from "@ubiquity-os/ubiquity-os-logger";
-import { config } from "dotenv";
+function jsonType(type) {
+  return Type.Transform(Type.String()).Decode((value) => {
+    const parsed = JSON.parse(value);
+    return Value2.Decode(type, Value2.Default(type, parsed));
+  }).Encode((value) => JSON.stringify(value));
+}
+
+// src/actions.ts
 config();
-var inputSchema2 = T2.Object({
-  stateId: T2.String(),
-  eventName: T2.String(),
-  eventPayload: T2.String(),
-  authToken: T2.String(),
-  settings: T2.String(),
-  ref: T2.String(),
-  signature: T2.String()
+var inputSchema2 = T3.Object({
+  stateId: T3.String(),
+  eventName: T3.String(),
+  eventPayload: jsonType(T3.Record(T3.String(), T3.Any())),
+  command: jsonType(commandCallSchema),
+  authToken: T3.String(),
+  settings: jsonType(T3.Record(T3.String(), T3.Any())),
+  ref: T3.String(),
+  signature: T3.String()
 });
 async function createActionsPlugin(handler, options) {
-  const pluginOptions = {
-    logLevel: options?.logLevel ?? LOG_LEVEL2.INFO,
-    postCommentOnError: options?.postCommentOnError ?? true,
-    settingsSchema: options?.settingsSchema,
-    envSchema: options?.envSchema,
-    kernelPublicKey: options?.kernelPublicKey ?? KERNEL_PUBLIC_KEY
-  };
+  const pluginOptions = getPluginOptions(options);
   const pluginGithubToken = process.env.PLUGIN_GITHUB_TOKEN;
   if (!pluginGithubToken) {
     core.setFailed("Error: PLUGIN_GITHUB_TOKEN env is not set");
     return;
   }
+  const body = github.context.payload.inputs;
+  const signature = body.signature;
+  if (!pluginOptions.bypassSignatureVerification && !await verifySignature(pluginOptions.kernelPublicKey, body, signature)) {
+    core.setFailed(`Error: Invalid signature`);
+    return;
+  }
   const inputPayload = github.context.payload.inputs;
-  const inputSchemaErrors = [...Value2.Errors(inputSchema2, inputPayload)];
+  const inputSchemaErrors = [...Value3.Errors(inputSchema2, inputPayload)];
   if (inputSchemaErrors.length) {
     console.dir(inputSchemaErrors, { depth: null });
     core.setFailed(`Error: Invalid inputs payload: ${inputSchemaErrors.join(",")}`);
     return;
   }
-  const inputs = Value2.Decode(inputSchema2, inputPayload);
-  const signature = inputs.signature;
-  if (!await verifySignature(pluginOptions.kernelPublicKey, inputs, signature)) {
-    core.setFailed(`Error: Invalid signature`);
-    return;
-  }
+  const inputs = Value3.Decode(inputSchema2, inputPayload);
   let config2;
   if (pluginOptions.settingsSchema) {
     try {
-      config2 = Value2.Decode(pluginOptions.settingsSchema, Value2.Default(pluginOptions.settingsSchema, JSON.parse(inputs.settings)));
+      config2 = Value3.Decode(pluginOptions.settingsSchema, Value3.Default(pluginOptions.settingsSchema, inputs.settings));
     } catch (e) {
-      console.dir(...Value2.Errors(pluginOptions.settingsSchema, JSON.parse(inputs.settings)), { depth: null });
+      console.dir(...Value3.Errors(pluginOptions.settingsSchema, inputs.settings), { depth: null });
       throw e;
     }
   } else {
-    config2 = JSON.parse(inputs.settings);
+    config2 = inputs.settings;
   }
   let env;
   if (pluginOptions.envSchema) {
     try {
-      env = Value2.Decode(pluginOptions.envSchema, Value2.Default(pluginOptions.envSchema, process.env));
+      env = Value3.Decode(pluginOptions.envSchema, Value3.Default(pluginOptions.envSchema, process.env));
     } catch (e) {
-      console.dir(...Value2.Errors(pluginOptions.envSchema, process.env), { depth: null });
+      console.dir(...Value3.Errors(pluginOptions.envSchema, process.env), { depth: null });
       throw e;
     }
   } else {
     env = process.env;
   }
+  let command = null;
+  if (inputs.command && pluginOptions.commandSchema) {
+    try {
+      command = Value3.Decode(pluginOptions.commandSchema, Value3.Default(pluginOptions.commandSchema, inputs.command));
+    } catch (e) {
+      console.dir(...Value3.Errors(pluginOptions.commandSchema, inputs.command), { depth: null });
+      throw e;
+    }
+  } else if (inputs.command) {
+    command = inputs.command;
+  }
   const context2 = {
     eventName: inputs.eventName,
-    payload: JSON.parse(inputs.eventPayload),
+    payload: inputs.eventPayload,
+    command,
     octokit: new customOctokit({ auth: inputs.authToken }),
     config: config2,
     env,
@@ -297,7 +338,7 @@ async function createActionsPlugin(handler, options) {
     if (error instanceof Error) {
       core.setFailed(error);
       loggerError = context2.logger.error(`Error: ${error}`, { error });
-    } else if (error instanceof LogReturn2) {
+    } else if (error instanceof LogReturn3) {
       core.setFailed(error.logMessage.raw);
       loggerError = error;
     } else {

package/dist/manifest.d.mts

@@ -5,6 +5,7 @@ declare const runEvent: _sinclair_typebox.TUnion<_sinclair_typebox.TLiteral<"bra
 declare const commandSchema: _sinclair_typebox.TObject<{
     description: _sinclair_typebox.TString;
     "ubiquity:example": _sinclair_typebox.TString;
+    parameters: _sinclair_typebox.TOptional<_sinclair_typebox.TRecord<_sinclair_typebox.TString, _sinclair_typebox.TAny>>;
 }>;
 declare const manifestSchema: _sinclair_typebox.TObject<{
     name: _sinclair_typebox.TString;
@@ -12,9 +13,11 @@ declare const manifestSchema: _sinclair_typebox.TObject<{
     commands: _sinclair_typebox.TOptional<_sinclair_typebox.TRecord<_sinclair_typebox.TString, _sinclair_typebox.TObject<{
         description: _sinclair_typebox.TString;
         "ubiquity:example": _sinclair_typebox.TString;
+        parameters: _sinclair_typebox.TOptional<_sinclair_typebox.TRecord<_sinclair_typebox.TString, _sinclair_typebox.TAny>>;
     }>>>;
     "ubiquity:listeners": _sinclair_typebox.TOptional<_sinclair_typebox.TArray<_sinclair_typebox.TUnion<_sinclair_typebox.TLiteral<"branch_protection_configuration" | "branch_protection_configuration.disabled" | "branch_protection_configuration.enabled" | "branch_protection_rule" | "branch_protection_rule.created" | "branch_protection_rule.deleted" | "branch_protection_rule.edited" | "check_run" | "check_run.completed" | "check_run.created" | "check_run.requested_action" | "check_run.rerequested" | "check_suite" | "check_suite.completed" | "check_suite.requested" | "check_suite.rerequested" | "code_scanning_alert" | "code_scanning_alert.appeared_in_branch" | "code_scanning_alert.closed_by_user" | "code_scanning_alert.created" | "code_scanning_alert.fixed" | "code_scanning_alert.reopened" | "code_scanning_alert.reopened_by_user" | "commit_comment" | "commit_comment.created" | "create" | "custom_property" | "custom_property.created" | "custom_property.deleted" | "custom_property.updated" | "custom_property_values" | "custom_property_values.updated" | "delete" | "dependabot_alert" | "dependabot_alert.auto_dismissed" | "dependabot_alert.auto_reopened" | "dependabot_alert.created" | "dependabot_alert.dismissed" | "dependabot_alert.fixed" | "dependabot_alert.reintroduced" | "dependabot_alert.reopened" | "deploy_key" | "deploy_key.created" | "deploy_key.deleted" | "deployment" | "deployment.created" | "deployment_protection_rule" | "deployment_protection_rule.requested" | "deployment_review" | "deployment_review.approved" | "deployment_review.rejected" | "deployment_review.requested" | "deployment_status" | "deployment_status.created" | "discussion" | "discussion.answered" | "discussion.category_changed" | "discussion.closed" | "discussion.created" | "discussion.deleted" | "discussion.edited" | "discussion.labeled" | "discussion.locked" | "discussion.pinned" | "discussion.reopened" | "discussion.transferred" | "discussion.unanswered" | "discussion.unlabeled" | "discussion.unlocked" | "discussion.unpinned" | "discussion_comment" | "discussion_comment.created" | "discussion_comment.deleted" | "discussion_comment.edited" | "fork" | "github_app_authorization" | "github_app_authorization.revoked" | "gollum" | "installation" | "installation.created" | "installation.deleted" | "installation.new_permissions_accepted" | "installation.suspend" | "installation.unsuspend" | "installation_repositories" | "installation_repositories.added" | "installation_repositories.removed" | "installation_target" | "installation_target.renamed" | "issue_comment" | "issue_comment.created" | "issue_comment.deleted" | "issue_comment.edited" | "issues" | "issues.assigned" | "issues.closed" | "issues.deleted" | "issues.demilestoned" | "issues.edited" | "issues.labeled" | "issues.locked" | "issues.milestoned" | "issues.opened" | "issues.pinned" | "issues.reopened" | "issues.transferred" | "issues.unassigned" | "issues.unlabeled" | "issues.unlocked" | "issues.unpinned" | "label" | "label.created" | "label.deleted" | "label.edited" | "marketplace_purchase" | "marketplace_purchase.cancelled" | "marketplace_purchase.changed" | "marketplace_purchase.pending_change" | "marketplace_purchase.pending_change_cancelled" | "marketplace_purchase.purchased" | "member" | "member.added" | "member.edited" | "member.removed" | "membership" | "membership.added" | "membership.removed" | "merge_group" | "merge_group.checks_requested" | "merge_group.destroyed" | "meta" | "meta.deleted" | "milestone" | "milestone.closed" | "milestone.created" | "milestone.deleted" | "milestone.edited" | "milestone.opened" | "org_block" | "org_block.blocked" | "org_block.unblocked" | "organization" | "organization.deleted" | "organization.member_added" | "organization.member_invited" | "organization.member_removed" | "organization.renamed" | "package" | "package.published" | "package.updated" | "page_build" | "personal_access_token_request" | "personal_access_token_request.approved" | "personal_access_token_request.cancelled" | "personal_access_token_request.created" | "personal_access_token_request.denied" | "ping" | "project" | "project.closed" | "project.created" | "project.deleted" | "project.edited" | "project.reopened" | "project_card" | "project_card.converted" | "project_card.created" | "project_card.deleted" | "project_card.edited" | "project_card.moved" | "project_column" | "project_column.created" | "project_column.deleted" | "project_column.edited" | "project_column.moved" | "projects_v2" | "projects_v2.closed" | "projects_v2.created" | "projects_v2.deleted" | "projects_v2.edited" | "projects_v2.reopened" | "projects_v2_item" | "projects_v2_item.archived" | "projects_v2_item.converted" | "projects_v2_item.created" | "projects_v2_item.deleted" | "projects_v2_item.edited" | "projects_v2_item.reordered" | "projects_v2_item.restored" | "public" | "pull_request" | "pull_request.assigned" | "pull_request.auto_merge_disabled" | "pull_request.auto_merge_enabled" | "pull_request.closed" | "pull_request.converted_to_draft" | "pull_request.demilestoned" | "pull_request.dequeued" | "pull_request.edited" | "pull_request.enqueued" | "pull_request.labeled" | "pull_request.locked" | "pull_request.milestoned" | "pull_request.opened" | "pull_request.ready_for_review" | "pull_request.reopened" | "pull_request.review_request_removed" | "pull_request.review_requested" | "pull_request.synchronize" | "pull_request.unassigned" | "pull_request.unlabeled" | "pull_request.unlocked" | "pull_request_review" | "pull_request_review.dismissed" | "pull_request_review.edited" | "pull_request_review.submitted" | "pull_request_review_comment" | "pull_request_review_comment.created" | "pull_request_review_comment.deleted" | "pull_request_review_comment.edited" | "pull_request_review_thread" | "pull_request_review_thread.resolved" | "pull_request_review_thread.unresolved" | "push" | "registry_package" | "registry_package.published" | "registry_package.updated" | "release" | "release.created" | "release.deleted" | "release.edited" | "release.prereleased" | "release.published" | "release.released" | "release.unpublished" | "repository" | "repository.archived" | "repository.created" | "repository.deleted" | "repository.edited" | "repository.privatized" | "repository.publicized" | "repository.renamed" | "repository.transferred" | "repository.unarchived" | "repository_advisory" | "repository_advisory.published" | "repository_advisory.reported" | "repository_dispatch" | "repository_dispatch.sample.collected" | "repository_import" | "repository_ruleset" | "repository_ruleset.created" | "repository_ruleset.deleted" | "repository_ruleset.edited" | "repository_vulnerability_alert" | "repository_vulnerability_alert.create" | "repository_vulnerability_alert.dismiss" | "repository_vulnerability_alert.reopen" | "repository_vulnerability_alert.resolve" | "secret_scanning_alert" | "secret_scanning_alert.created" | "secret_scanning_alert.reopened" | "secret_scanning_alert.resolved" | "secret_scanning_alert.revoked" | "secret_scanning_alert.validated" | "secret_scanning_alert_location" | "secret_scanning_alert_location.created" | "security_advisory" | "security_advisory.published" | "security_advisory.updated" | "security_advisory.withdrawn" | "security_and_analysis" | "sponsorship" | "sponsorship.cancelled" | "sponsorship.created" | "sponsorship.edited" | "sponsorship.pending_cancellation" | "sponsorship.pending_tier_change" | "sponsorship.tier_changed" | "star" | "star.created" | "star.deleted" | "status" | "team" | "team.added_to_repository" | "team.created" | "team.deleted" | "team.edited" | "team.removed_from_repository" | "team_add" | "watch" | "watch.started" | "workflow_dispatch" | "workflow_job" | "workflow_job.completed" | "workflow_job.in_progress" | "workflow_job.queued" | "workflow_job.waiting" | "workflow_run" | "workflow_run.completed" | "workflow_run.in_progress" | "workflow_run.requested">[]>>>;
     configuration: _sinclair_typebox.TOptional<_sinclair_typebox.TRecord<_sinclair_typebox.TString, _sinclair_typebox.TAny>>;
+    skipBotEvents: _sinclair_typebox.TOptional<_sinclair_typebox.TBoolean>;
 }>;
 type Manifest = Static<typeof manifestSchema>;
 

package/dist/manifest.d.ts

@@ -5,6 +5,7 @@ declare const runEvent: _sinclair_typebox.TUnion<_sinclair_typebox.TLiteral<"bra
 declare const commandSchema: _sinclair_typebox.TObject<{
     description: _sinclair_typebox.TString;
     "ubiquity:example": _sinclair_typebox.TString;
+    parameters: _sinclair_typebox.TOptional<_sinclair_typebox.TRecord<_sinclair_typebox.TString, _sinclair_typebox.TAny>>;
 }>;
 declare const manifestSchema: _sinclair_typebox.TObject<{
     name: _sinclair_typebox.TString;
@@ -12,9 +13,11 @@ declare const manifestSchema: _sinclair_typebox.TObject<{
     commands: _sinclair_typebox.TOptional<_sinclair_typebox.TRecord<_sinclair_typebox.TString, _sinclair_typebox.TObject<{
         description: _sinclair_typebox.TString;
         "ubiquity:example": _sinclair_typebox.TString;
+        parameters: _sinclair_typebox.TOptional<_sinclair_typebox.TRecord<_sinclair_typebox.TString, _sinclair_typebox.TAny>>;
     }>>>;
     "ubiquity:listeners": _sinclair_typebox.TOptional<_sinclair_typebox.TArray<_sinclair_typebox.TUnion<_sinclair_typebox.TLiteral<"branch_protection_configuration" | "branch_protection_configuration.disabled" | "branch_protection_configuration.enabled" | "branch_protection_rule" | "branch_protection_rule.created" | "branch_protection_rule.deleted" | "branch_protection_rule.edited" | "check_run" | "check_run.completed" | "check_run.created" | "check_run.requested_action" | "check_run.rerequested" | "check_suite" | "check_suite.completed" | "check_suite.requested" | "check_suite.rerequested" | "code_scanning_alert" | "code_scanning_alert.appeared_in_branch" | "code_scanning_alert.closed_by_user" | "code_scanning_alert.created" | "code_scanning_alert.fixed" | "code_scanning_alert.reopened" | "code_scanning_alert.reopened_by_user" | "commit_comment" | "commit_comment.created" | "create" | "custom_property" | "custom_property.created" | "custom_property.deleted" | "custom_property.updated" | "custom_property_values" | "custom_property_values.updated" | "delete" | "dependabot_alert" | "dependabot_alert.auto_dismissed" | "dependabot_alert.auto_reopened" | "dependabot_alert.created" | "dependabot_alert.dismissed" | "dependabot_alert.fixed" | "dependabot_alert.reintroduced" | "dependabot_alert.reopened" | "deploy_key" | "deploy_key.created" | "deploy_key.deleted" | "deployment" | "deployment.created" | "deployment_protection_rule" | "deployment_protection_rule.requested" | "deployment_review" | "deployment_review.approved" | "deployment_review.rejected" | "deployment_review.requested" | "deployment_status" | "deployment_status.created" | "discussion" | "discussion.answered" | "discussion.category_changed" | "discussion.closed" | "discussion.created" | "discussion.deleted" | "discussion.edited" | "discussion.labeled" | "discussion.locked" | "discussion.pinned" | "discussion.reopened" | "discussion.transferred" | "discussion.unanswered" | "discussion.unlabeled" | "discussion.unlocked" | "discussion.unpinned" | "discussion_comment" | "discussion_comment.created" | "discussion_comment.deleted" | "discussion_comment.edited" | "fork" | "github_app_authorization" | "github_app_authorization.revoked" | "gollum" | "installation" | "installation.created" | "installation.deleted" | "installation.new_permissions_accepted" | "installation.suspend" | "installation.unsuspend" | "installation_repositories" | "installation_repositories.added" | "installation_repositories.removed" | "installation_target" | "installation_target.renamed" | "issue_comment" | "issue_comment.created" | "issue_comment.deleted" | "issue_comment.edited" | "issues" | "issues.assigned" | "issues.closed" | "issues.deleted" | "issues.demilestoned" | "issues.edited" | "issues.labeled" | "issues.locked" | "issues.milestoned" | "issues.opened" | "issues.pinned" | "issues.reopened" | "issues.transferred" | "issues.unassigned" | "issues.unlabeled" | "issues.unlocked" | "issues.unpinned" | "label" | "label.created" | "label.deleted" | "label.edited" | "marketplace_purchase" | "marketplace_purchase.cancelled" | "marketplace_purchase.changed" | "marketplace_purchase.pending_change" | "marketplace_purchase.pending_change_cancelled" | "marketplace_purchase.purchased" | "member" | "member.added" | "member.edited" | "member.removed" | "membership" | "membership.added" | "membership.removed" | "merge_group" | "merge_group.checks_requested" | "merge_group.destroyed" | "meta" | "meta.deleted" | "milestone" | "milestone.closed" | "milestone.created" | "milestone.deleted" | "milestone.edited" | "milestone.opened" | "org_block" | "org_block.blocked" | "org_block.unblocked" | "organization" | "organization.deleted" | "organization.member_added" | "organization.member_invited" | "organization.member_removed" | "organization.renamed" | "package" | "package.published" | "package.updated" | "page_build" | "personal_access_token_request" | "personal_access_token_request.approved" | "personal_access_token_request.cancelled" | "personal_access_token_request.created" | "personal_access_token_request.denied" | "ping" | "project" | "project.closed" | "project.created" | "project.deleted" | "project.edited" | "project.reopened" | "project_card" | "project_card.converted" | "project_card.created" | "project_card.deleted" | "project_card.edited" | "project_card.moved" | "project_column" | "project_column.created" | "project_column.deleted" | "project_column.edited" | "project_column.moved" | "projects_v2" | "projects_v2.closed" | "projects_v2.created" | "projects_v2.deleted" | "projects_v2.edited" | "projects_v2.reopened" | "projects_v2_item" | "projects_v2_item.archived" | "projects_v2_item.converted" | "projects_v2_item.created" | "projects_v2_item.deleted" | "projects_v2_item.edited" | "projects_v2_item.reordered" | "projects_v2_item.restored" | "public" | "pull_request" | "pull_request.assigned" | "pull_request.auto_merge_disabled" | "pull_request.auto_merge_enabled" | "pull_request.closed" | "pull_request.converted_to_draft" | "pull_request.demilestoned" | "pull_request.dequeued" | "pull_request.edited" | "pull_request.enqueued" | "pull_request.labeled" | "pull_request.locked" | "pull_request.milestoned" | "pull_request.opened" | "pull_request.ready_for_review" | "pull_request.reopened" | "pull_request.review_request_removed" | "pull_request.review_requested" | "pull_request.synchronize" | "pull_request.unassigned" | "pull_request.unlabeled" | "pull_request.unlocked" | "pull_request_review" | "pull_request_review.dismissed" | "pull_request_review.edited" | "pull_request_review.submitted" | "pull_request_review_comment" | "pull_request_review_comment.created" | "pull_request_review_comment.deleted" | "pull_request_review_comment.edited" | "pull_request_review_thread" | "pull_request_review_thread.resolved" | "pull_request_review_thread.unresolved" | "push" | "registry_package" | "registry_package.published" | "registry_package.updated" | "release" | "release.created" | "release.deleted" | "release.edited" | "release.prereleased" | "release.published" | "release.released" | "release.unpublished" | "repository" | "repository.archived" | "repository.created" | "repository.deleted" | "repository.edited" | "repository.privatized" | "repository.publicized" | "repository.renamed" | "repository.transferred" | "repository.unarchived" | "repository_advisory" | "repository_advisory.published" | "repository_advisory.reported" | "repository_dispatch" | "repository_dispatch.sample.collected" | "repository_import" | "repository_ruleset" | "repository_ruleset.created" | "repository_ruleset.deleted" | "repository_ruleset.edited" | "repository_vulnerability_alert" | "repository_vulnerability_alert.create" | "repository_vulnerability_alert.dismiss" | "repository_vulnerability_alert.reopen" | "repository_vulnerability_alert.resolve" | "secret_scanning_alert" | "secret_scanning_alert.created" | "secret_scanning_alert.reopened" | "secret_scanning_alert.resolved" | "secret_scanning_alert.revoked" | "secret_scanning_alert.validated" | "secret_scanning_alert_location" | "secret_scanning_alert_location.created" | "security_advisory" | "security_advisory.published" | "security_advisory.updated" | "security_advisory.withdrawn" | "security_and_analysis" | "sponsorship" | "sponsorship.cancelled" | "sponsorship.created" | "sponsorship.edited" | "sponsorship.pending_cancellation" | "sponsorship.pending_tier_change" | "sponsorship.tier_changed" | "star" | "star.created" | "star.deleted" | "status" | "team" | "team.added_to_repository" | "team.created" | "team.deleted" | "team.edited" | "team.removed_from_repository" | "team_add" | "watch" | "watch.started" | "workflow_dispatch" | "workflow_job" | "workflow_job.completed" | "workflow_job.in_progress" | "workflow_job.queued" | "workflow_job.waiting" | "workflow_run" | "workflow_run.completed" | "workflow_run.in_progress" | "workflow_run.requested">[]>>>;
     configuration: _sinclair_typebox.TOptional<_sinclair_typebox.TRecord<_sinclair_typebox.TString, _sinclair_typebox.TAny>>;
+    skipBotEvents: _sinclair_typebox.TOptional<_sinclair_typebox.TBoolean>;
 }>;
 type Manifest = Static<typeof manifestSchema>;
 

package/dist/manifest.js

@@ -30,14 +30,16 @@ var import_webhooks = require("@octokit/webhooks");
 var runEvent = import_typebox.Type.Union(import_webhooks.emitterEventNames.map((o) => import_typebox.Type.Literal(o)));
 var commandSchema = import_typebox.Type.Object({
   description: import_typebox.Type.String({ minLength: 1 }),
-  "ubiquity:example": import_typebox.Type.String({ minLength: 1 })
+  "ubiquity:example": import_typebox.Type.String({ minLength: 1 }),
+  parameters: import_typebox.Type.Optional(import_typebox.Type.Record(import_typebox.Type.String(), import_typebox.Type.Any()))
 });
 var manifestSchema = import_typebox.Type.Object({
   name: import_typebox.Type.String({ minLength: 1 }),
   description: import_typebox.Type.Optional(import_typebox.Type.String({ default: "" })),
-  commands: import_typebox.Type.Optional(import_typebox.Type.Record(import_typebox.Type.String(), commandSchema, { default: {} })),
+  commands: import_typebox.Type.Optional(import_typebox.Type.Record(import_typebox.Type.String({ pattern: "^[A-Za-z-_]+$" }), commandSchema, { default: {} })),
   "ubiquity:listeners": import_typebox.Type.Optional(import_typebox.Type.Array(runEvent, { default: [] })),
-  configuration: import_typebox.Type.Optional(import_typebox.Type.Record(import_typebox.Type.String(), import_typebox.Type.Any(), { default: {} }))
+  configuration: import_typebox.Type.Optional(import_typebox.Type.Record(import_typebox.Type.String(), import_typebox.Type.Any(), { default: {} })),
+  skipBotEvents: import_typebox.Type.Optional(import_typebox.Type.Boolean({ default: true }))
 });
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/manifest.mjs

@@ -4,14 +4,16 @@ import { emitterEventNames } from "@octokit/webhooks";
 var runEvent = T.Union(emitterEventNames.map((o) => T.Literal(o)));
 var commandSchema = T.Object({
   description: T.String({ minLength: 1 }),
-  "ubiquity:example": T.String({ minLength: 1 })
+  "ubiquity:example": T.String({ minLength: 1 }),
+  parameters: T.Optional(T.Record(T.String(), T.Any()))
 });
 var manifestSchema = T.Object({
   name: T.String({ minLength: 1 }),
   description: T.Optional(T.String({ default: "" })),
-  commands: T.Optional(T.Record(T.String(), commandSchema, { default: {} })),
+  commands: T.Optional(T.Record(T.String({ pattern: "^[A-Za-z-_]+$" }), commandSchema, { default: {} })),
   "ubiquity:listeners": T.Optional(T.Array(runEvent, { default: [] })),
-  configuration: T.Optional(T.Record(T.String(), T.Any(), { default: {} }))
+  configuration: T.Optional(T.Record(T.String(), T.Any(), { default: {} })),
+  skipBotEvents: T.Optional(T.Boolean({ default: true }))
 });
 export {
   commandSchema,

package/dist/octokit.d.mts

@@ -0,0 +1,16 @@
+import * as _octokit_core_dist_types_types from '@octokit/core/dist-types/types';
+import * as _octokit_plugin_paginate_graphql from '@octokit/plugin-paginate-graphql';
+import * as _octokit_plugin_rest_endpoint_methods from '@octokit/plugin-rest-endpoint-methods';
+import * as _octokit_plugin_paginate_rest from '@octokit/plugin-paginate-rest';
+import * as _octokit_request_error from '@octokit/request-error';
+import { Octokit } from '@octokit/core';
+
+declare const customOctokit: typeof Octokit & _octokit_core_dist_types_types.Constructor<{
+    retry: {
+        retryRequest: (error: _octokit_request_error.RequestError, retries: number, retryAfter: number) => _octokit_request_error.RequestError;
+    };
+} & {
+    paginate: _octokit_plugin_paginate_rest.PaginateInterface;
+} & _octokit_plugin_rest_endpoint_methods.Api & _octokit_plugin_paginate_graphql.paginateGraphQLInterface>;
+
+export { customOctokit };

package/dist/octokit.d.ts

@@ -0,0 +1,16 @@
+import * as _octokit_core_dist_types_types from '@octokit/core/dist-types/types';
+import * as _octokit_plugin_paginate_graphql from '@octokit/plugin-paginate-graphql';
+import * as _octokit_plugin_rest_endpoint_methods from '@octokit/plugin-rest-endpoint-methods';
+import * as _octokit_plugin_paginate_rest from '@octokit/plugin-paginate-rest';
+import * as _octokit_request_error from '@octokit/request-error';
+import { Octokit } from '@octokit/core';
+
+declare const customOctokit: typeof Octokit & _octokit_core_dist_types_types.Constructor<{
+    retry: {
+        retryRequest: (error: _octokit_request_error.RequestError, retries: number, retryAfter: number) => _octokit_request_error.RequestError;
+    };
+} & {
+    paginate: _octokit_plugin_paginate_rest.PaginateInterface;
+} & _octokit_plugin_rest_endpoint_methods.Api & _octokit_plugin_paginate_graphql.paginateGraphQLInterface>;
+
+export { customOctokit };

package/dist/octokit.js

@@ -0,0 +1,54 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/octokit.ts
+var octokit_exports = {};
+__export(octokit_exports, {
+  customOctokit: () => customOctokit
+});
+module.exports = __toCommonJS(octokit_exports);
+var import_core = require("@octokit/core");
+var import_plugin_paginate_rest = require("@octokit/plugin-paginate-rest");
+var import_plugin_rest_endpoint_methods = require("@octokit/plugin-rest-endpoint-methods");
+var import_plugin_retry = require("@octokit/plugin-retry");
+var import_plugin_throttling = require("@octokit/plugin-throttling");
+var import_plugin_paginate_graphql = require("@octokit/plugin-paginate-graphql");
+var defaultOptions = {
+  throttle: {
+    onAbuseLimit: (retryAfter, options, octokit) => {
+      octokit.log.warn(`Abuse limit hit with "${options.method} ${options.url}", retrying in ${retryAfter} seconds.`);
+      return true;
+    },
+    onRateLimit: (retryAfter, options, octokit) => {
+      octokit.log.warn(`Rate limit hit with "${options.method} ${options.url}", retrying in ${retryAfter} seconds.`);
+      return true;
+    },
+    onSecondaryRateLimit: (retryAfter, options, octokit) => {
+      octokit.log.warn(`Secondary rate limit hit with "${options.method} ${options.url}", retrying in ${retryAfter} seconds.`);
+      return true;
+    }
+  }
+};
+var customOctokit = import_core.Octokit.plugin(import_plugin_throttling.throttling, import_plugin_retry.retry, import_plugin_paginate_rest.paginateRest, import_plugin_rest_endpoint_methods.restEndpointMethods, import_plugin_paginate_graphql.paginateGraphQL).defaults((instanceOptions) => {
+  return { ...defaultOptions, ...instanceOptions };
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  customOctokit
+});

package/dist/octokit.mjs

@@ -0,0 +1,29 @@
+// src/octokit.ts
+import { Octokit } from "@octokit/core";
+import { paginateRest } from "@octokit/plugin-paginate-rest";
+import { restEndpointMethods } from "@octokit/plugin-rest-endpoint-methods";
+import { retry } from "@octokit/plugin-retry";
+import { throttling } from "@octokit/plugin-throttling";
+import { paginateGraphQL } from "@octokit/plugin-paginate-graphql";
+var defaultOptions = {
+  throttle: {
+    onAbuseLimit: (retryAfter, options, octokit) => {
+      octokit.log.warn(`Abuse limit hit with "${options.method} ${options.url}", retrying in ${retryAfter} seconds.`);
+      return true;
+    },
+    onRateLimit: (retryAfter, options, octokit) => {
+      octokit.log.warn(`Rate limit hit with "${options.method} ${options.url}", retrying in ${retryAfter} seconds.`);
+      return true;
+    },
+    onSecondaryRateLimit: (retryAfter, options, octokit) => {
+      octokit.log.warn(`Secondary rate limit hit with "${options.method} ${options.url}", retrying in ${retryAfter} seconds.`);
+      return true;
+    }
+  }
+};
+var customOctokit = Octokit.plugin(throttling, retry, paginateRest, restEndpointMethods, paginateGraphQL).defaults((instanceOptions) => {
+  return { ...defaultOptions, ...instanceOptions };
+});
+export {
+  customOctokit
+};

package/dist/signature.d.mts

@@ -5,6 +5,7 @@ interface Inputs {
     authToken: unknown;
     settings: unknown;
     ref: unknown;
+    command: unknown;
 }
 declare function verifySignature(publicKeyPem: string, inputs: Inputs, signature: string): Promise<boolean>;
 declare function signPayload(payload: string, privateKey: string): Promise<string>;

package/dist/signature.d.ts

@@ -5,6 +5,7 @@ interface Inputs {
     authToken: unknown;
     settings: unknown;
     ref: unknown;
+    command: unknown;
 }
 declare function verifySignature(publicKeyPem: string, inputs: Inputs, signature: string): Promise<boolean>;
 declare function signPayload(payload: string, privateKey: string): Promise<string>;

package/dist/signature.js

@@ -32,7 +32,8 @@ async function verifySignature(publicKeyPem, inputs, signature) {
       eventPayload: inputs.eventPayload,
       settings: inputs.settings,
       authToken: inputs.authToken,
-      ref: inputs.ref
+      ref: inputs.ref,
+      command: inputs.command
     };
     const pemContents = publicKeyPem.replace("-----BEGIN PUBLIC KEY-----", "").replace("-----END PUBLIC KEY-----", "").trim();
     const binaryDer = Uint8Array.from(atob(pemContents), (c) => c.charCodeAt(0));

package/dist/signature.mjs

@@ -7,7 +7,8 @@ async function verifySignature(publicKeyPem, inputs, signature) {
       eventPayload: inputs.eventPayload,
       settings: inputs.settings,
       authToken: inputs.authToken,
-      ref: inputs.ref
+      ref: inputs.ref,
+      command: inputs.command
     };
     const pemContents = publicKeyPem.replace("-----BEGIN PUBLIC KEY-----", "").replace("-----END PUBLIC KEY-----", "").trim();
     const binaryDer = Uint8Array.from(atob(pemContents), (c) => c.charCodeAt(0));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubiquity-os/plugin-sdk",
-  "version": "1.0.11",
+  "version": "1.1.1",
   "description": "SDK for plugin support.",
   "author": "Ubiquity DAO",
   "license": "MIT",
@@ -21,6 +21,9 @@
       ],
       "signature": [
         "dist/signature.d.ts"
+      ],
+      "octokit": [
+        "dist/octokit.d.ts"
       ]
     }
   },
@@ -44,6 +47,11 @@
       "types": "./dist/signature.d.ts",
       "import": "./dist/signature.mjs",
       "require": "./dist/signature.js"
+    },
+    "./octokit": {
+      "types": "./dist/octokit.d.ts",
+      "import": "./dist/octokit.mjs",
+      "require": "./dist/octokit.js"
     }
   },
   "files": [
@@ -79,11 +87,13 @@
     "@octokit/rest": "^21.0.2",
     "@octokit/types": "^13.6.1",
     "@octokit/webhooks": "^13.3.0",
-    "@sinclair/typebox": "^0.33.21",
     "@ubiquity-os/ubiquity-os-logger": "^1.3.2",
     "dotenv": "^16.4.5",
     "hono": "^4.6.9"
   },
+  "peerDependencies": {
+    "@sinclair/typebox": "0.34.3"
+  },
   "devDependencies": {
     "@commitlint/cli": "^18.6.1",
     "@commitlint/config-conventional": "^18.6.2",