@ubiquity-os/plugin-sdk 3.1.2 → 3.1.4

package/dist/helpers.d.mts

@@ -0,0 +1,59 @@
+type OpenRouterError = {
+    error: {
+        message: string;
+        code: number;
+        metadata?: {
+            provider_name: string;
+            raw: unknown;
+        } | {
+            reasons: string[];
+            flagged_input: string;
+            provider_name: string;
+            model_slug: string;
+        };
+    };
+};
+type OpenRouterModel = {
+    id: string;
+    name: string;
+    created: number;
+    description: string;
+    context_length: number;
+    architecture: {
+        modality: string;
+        tokenizer: string;
+        instruct_type?: string;
+    };
+    top_provider: {
+        context_length: number;
+        /** `null` means it's the same as the context_length */
+        max_completion_tokens: number | null;
+        is_moderated: boolean;
+    };
+    pricing: {
+        prompt: string;
+        completion: string;
+        image: string;
+        request: string;
+        input_cache_read: string;
+        input_cache_write: string;
+        web_search: string;
+        internal_reasoning: string;
+    };
+    per_request_limits?: Record<string, unknown>;
+};
+declare function getOpenRouterModels(): Promise<OpenRouterModel[]>;
+declare function getOpenRouterModelTokenLimits(modelId: string): Promise<{
+    contextLength: number;
+    maxCompletionTokens: number;
+} | null>;
+
+interface RetryOptions {
+    maxRetries: number;
+    onError?: (error: unknown) => Promise<void> | void;
+    /** Return `false` to stop retrying, `true` to automatically delay the next retry, or a number to set the delay before the next retry */
+    isErrorRetryable?: (error: unknown) => Promise<boolean | number> | boolean | number;
+}
+declare function retry<T>(fn: () => Promise<T>, options: RetryOptions): Promise<T>;
+
+export { type OpenRouterError, type OpenRouterModel, getOpenRouterModelTokenLimits, getOpenRouterModels, retry };

package/dist/helpers.d.ts

@@ -0,0 +1,59 @@
+type OpenRouterError = {
+    error: {
+        message: string;
+        code: number;
+        metadata?: {
+            provider_name: string;
+            raw: unknown;
+        } | {
+            reasons: string[];
+            flagged_input: string;
+            provider_name: string;
+            model_slug: string;
+        };
+    };
+};
+type OpenRouterModel = {
+    id: string;
+    name: string;
+    created: number;
+    description: string;
+    context_length: number;
+    architecture: {
+        modality: string;
+        tokenizer: string;
+        instruct_type?: string;
+    };
+    top_provider: {
+        context_length: number;
+        /** `null` means it's the same as the context_length */
+        max_completion_tokens: number | null;
+        is_moderated: boolean;
+    };
+    pricing: {
+        prompt: string;
+        completion: string;
+        image: string;
+        request: string;
+        input_cache_read: string;
+        input_cache_write: string;
+        web_search: string;
+        internal_reasoning: string;
+    };
+    per_request_limits?: Record<string, unknown>;
+};
+declare function getOpenRouterModels(): Promise<OpenRouterModel[]>;
+declare function getOpenRouterModelTokenLimits(modelId: string): Promise<{
+    contextLength: number;
+    maxCompletionTokens: number;
+} | null>;
+
+interface RetryOptions {
+    maxRetries: number;
+    onError?: (error: unknown) => Promise<void> | void;
+    /** Return `false` to stop retrying, `true` to automatically delay the next retry, or a number to set the delay before the next retry */
+    isErrorRetryable?: (error: unknown) => Promise<boolean | number> | boolean | number;
+}
+declare function retry<T>(fn: () => Promise<T>, options: RetryOptions): Promise<T>;
+
+export { type OpenRouterError, type OpenRouterModel, getOpenRouterModelTokenLimits, getOpenRouterModels, retry };

package/dist/helpers.js

@@ -0,0 +1,86 @@
+"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/helpers/index.ts
+var helpers_exports = {};
+__export(helpers_exports, {
+  getOpenRouterModelTokenLimits: () => getOpenRouterModelTokenLimits,
+  getOpenRouterModels: () => getOpenRouterModels,
+  retry: () => retry
+});
+module.exports = __toCommonJS(helpers_exports);
+
+// src/helpers/openrouter.ts
+async function getOpenRouterModels() {
+  const response = await fetch("https://openrouter.ai/api/v1/models");
+  if (!response.ok) {
+    throw new Error("Failed to fetch models");
+  }
+  const result = await response.json();
+  return result.data;
+}
+async function getOpenRouterModelTokenLimits(modelId) {
+  const models = await getOpenRouterModels();
+  const model = models.find((m) => m.id === modelId);
+  if (!model) {
+    return null;
+  }
+  return {
+    contextLength: model.context_length,
+    maxCompletionTokens: model.top_provider.max_completion_tokens || model.context_length
+  };
+}
+
+// src/helpers/retry.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function retry(fn, options) {
+  let delay = 1e3;
+  let lastError = null;
+  for (let i = 0; i < options.maxRetries + 1; i++) {
+    try {
+      return await fn();
+    } catch (err) {
+      lastError = err;
+      if (options.onError) {
+        await options.onError(err);
+      }
+      let shouldRetry;
+      if (options.isErrorRetryable) {
+        shouldRetry = await options.isErrorRetryable(err);
+      }
+      if (shouldRetry === false) {
+        throw lastError;
+      } else if (typeof shouldRetry === "number" && Number.isFinite(shouldRetry)) {
+        await sleep(shouldRetry);
+      } else {
+        await sleep(delay);
+        delay *= 2;
+      }
+    }
+  }
+  throw lastError;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getOpenRouterModelTokenLimits,
+  getOpenRouterModels,
+  retry
+});

package/dist/helpers.mjs

@@ -0,0 +1,57 @@
+// src/helpers/openrouter.ts
+async function getOpenRouterModels() {
+  const response = await fetch("https://openrouter.ai/api/v1/models");
+  if (!response.ok) {
+    throw new Error("Failed to fetch models");
+  }
+  const result = await response.json();
+  return result.data;
+}
+async function getOpenRouterModelTokenLimits(modelId) {
+  const models = await getOpenRouterModels();
+  const model = models.find((m) => m.id === modelId);
+  if (!model) {
+    return null;
+  }
+  return {
+    contextLength: model.context_length,
+    maxCompletionTokens: model.top_provider.max_completion_tokens || model.context_length
+  };
+}
+
+// src/helpers/retry.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function retry(fn, options) {
+  let delay = 1e3;
+  let lastError = null;
+  for (let i = 0; i < options.maxRetries + 1; i++) {
+    try {
+      return await fn();
+    } catch (err) {
+      lastError = err;
+      if (options.onError) {
+        await options.onError(err);
+      }
+      let shouldRetry;
+      if (options.isErrorRetryable) {
+        shouldRetry = await options.isErrorRetryable(err);
+      }
+      if (shouldRetry === false) {
+        throw lastError;
+      } else if (typeof shouldRetry === "number" && Number.isFinite(shouldRetry)) {
+        await sleep(shouldRetry);
+      } else {
+        await sleep(delay);
+        delay *= 2;
+      }
+    }
+  }
+  throw lastError;
+}
+export {
+  getOpenRouterModelTokenLimits,
+  getOpenRouterModels,
+  retry
+};

package/dist/index.d.mts

@@ -132,4 +132,4 @@ declare function createPlugin<TConfig = unknown, TEnv = unknown, TCommand = unkn
 
 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>;
 
-export { CommentHandler, type Context, createActionsPlugin, createPlugin };
+export { CommentHandler, type Context, type Options, createActionsPlugin, createPlugin };

package/dist/index.d.ts

@@ -132,4 +132,4 @@ declare function createPlugin<TConfig = unknown, TEnv = unknown, TCommand = unkn
 
 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>;
 
-export { CommentHandler, type Context, createActionsPlugin, createPlugin };
+export { CommentHandler, type Context, type Options, createActionsPlugin, createPlugin };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubiquity-os/plugin-sdk",
-  "version": "3.1.2",
+  "version": "3.1.4",
   "description": "SDK for plugin support.",
   "author": "Ubiquity DAO",
   "license": "MIT",
@@ -24,6 +24,9 @@
       ],
       "octokit": [
         "dist/octokit.d.ts"
+      ],
+      "helpers": [
+        "dist/helpers.d.ts"
       ]
     }
   },
@@ -52,6 +55,11 @@
       "types": "./dist/octokit.d.ts",
       "import": "./dist/octokit.mjs",
       "require": "./dist/octokit.js"
+    },
+    "./helpers": {
+      "types": "./dist/helpers.d.ts",
+      "import": "./dist/helpers.mjs",
+      "require": "./dist/helpers.js"
     }
   },
   "files": [