@elizaos/plugin-nearai 2.0.3-beta.2

package/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2024 elizaOS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+

package/README.md

@@ -0,0 +1,43 @@
+# @elizaos/plugin-nearai
+
+First-party NEAR AI Cloud TEE inference provider plugin for elizaOS.
+
+This plugin targets **NEAR AI Cloud's OpenAI-compatible API** and supports:
+
+- `TEXT_SMALL`, `TEXT_LARGE`
+
+## Install
+
+```bash
+eliza plugins install @elizaos/plugin-nearai
+```
+
+## Configuration
+
+| Variable | Required | Default | Description |
+| --- | --- | --- | --- |
+| `NEARAI_API_KEY` | Yes | - | NEAR AI API key (not needed in browser; use a proxy) |
+| `NEARAI_BASE_URL` | No | `https://cloud-api.near.ai/v1` | OpenAI-compatible API base URL (Node only) |
+| `NEARAI_BROWSER_BASE_URL` | No | - | Proxy base URL for browser builds (omit API key in-browser) |
+| `NEARAI_SMALL_MODEL` | No | `Qwen/Qwen3.6-35B-A3B-FP8` | Small model id |
+| `NEARAI_LARGE_MODEL` | No | `zai-org/GLM-5.1-FP8` | Large model id |
+| `NEARAI_EXPERIMENTAL_TELEMETRY` | No | `false` | Set `true` to enable Vercel AI SDK telemetry |
+
+Model ids come from the public NEAR AI catalog at
+`https://cloud-api.near.ai/v1/model/list`. The default models were selected
+from TEE-verifiable text models in that catalog.
+
+## Usage
+
+```ts
+import { AgentRuntime, ModelType } from "@elizaos/core";
+import nearaiPlugin from "@elizaos/plugin-nearai";
+
+const runtime = new AgentRuntime({ plugins: [nearaiPlugin] });
+
+const text = await runtime.useModel(ModelType.TEXT_LARGE, {
+  prompt: "Write a haiku about local-first AI.",
+});
+
+console.log(text);
+```

package/auto-enable.ts

@@ -0,0 +1,14 @@
+// Auto-enable check for @elizaos/plugin-nearai.
+//
+// Plugin manifest entry point, referenced by package.json's
+// `elizaos.plugin.autoEnableModule`. Keep this module light: env reads only,
+// no service init, no transitive imports of the full plugin runtime.
+type PluginAutoEnableContext = {
+  env: Record<string, string | undefined>;
+};
+
+/** Enable when a NEAR AI API key is present in the environment. */
+export function shouldEnable(ctx: PluginAutoEnableContext): boolean {
+  const env = ctx.env;
+  return Boolean(env.NEARAI_API_KEY && env.NEARAI_API_KEY.trim() !== "");
+}

package/package.json

@@ -0,0 +1,145 @@
+{
+  "name": "@elizaos/plugin-nearai",
+  "version": "2.0.3-beta.2",
+  "type": "module",
+  "main": "dist/node/index.node.js",
+  "module": "dist/node/index.node.js",
+  "types": "dist/node/index.d.ts",
+  "browser": "dist/browser/index.browser.js",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/elizaos-plugins/plugin-nearai.git"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/node/index.d.ts",
+      "browser": {
+        "types": "./dist/browser/index.d.ts",
+        "import": "./dist/browser/index.browser.js",
+        "default": "./dist/browser/index.browser.js"
+      },
+      "node": {
+        "types": "./dist/node/index.d.ts",
+        "import": "./dist/node/index.node.js",
+        "default": "./dist/node/index.node.js"
+      },
+      "import": {
+        "types": "./dist/node/index.d.ts",
+        "default": "./dist/node/index.node.js"
+      },
+      "default": {
+        "types": "./dist/node/index.d.ts",
+        "default": "./dist/node/index.node.js"
+      }
+    },
+    "./*.css": "./dist/*.css",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
+    }
+  },
+  "files": [
+    "dist",
+    "auto-enable.ts"
+  ],
+  "elizaos": {
+    "plugin": {
+      "autoEnableModule": "./auto-enable.ts",
+      "capabilities": [
+        "text-large",
+        "text-small"
+      ]
+    }
+  },
+  "sideEffects": false,
+  "dependencies": {
+    "@ai-sdk/openai-compatible": "^2.0.51",
+    "@elizaos/core": "2.0.3-beta.2",
+    "ai": "^6.0.23"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.14",
+    "@types/bun": "^1.3.10",
+    "@types/node": "^25.0.3",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.4"
+  },
+  "scripts": {
+    "dev": "bun run build.ts --watch",
+    "clean": "rm -rf dist .turbo .turbo-tsconfig.json tsconfig.tsbuildinfo",
+    "format": "bunx @biomejs/biome format --write .",
+    "format:check": "bunx @biomejs/biome format .",
+    "lint": "bunx @biomejs/biome check --write --unsafe .",
+    "lint:check": "bunx @biomejs/biome check . --no-errors-on-unmatched",
+    "typecheck": "tsgo --noEmit -p tsconfig.json",
+    "test": "bunx vitest run --config vitest.config.ts",
+    "test:watch": "bunx vitest --config vitest.config.ts",
+    "build": "bun run build.ts",
+    "build:ts": "bun run build.ts"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "agentConfig": {
+    "pluginType": "elizaos:plugin:1.0.0",
+    "pluginParameters": {
+      "NEARAI_API_KEY": {
+        "type": "string",
+        "description": "API key used to authenticate requests to the NEAR AI Cloud OpenAI-compatible API.",
+        "required": true,
+        "sensitive": true
+      },
+      "NEARAI_BASE_URL": {
+        "type": "string",
+        "description": "Base URL for the NEAR AI Cloud OpenAI-compatible API.",
+        "required": false,
+        "default": "https://cloud-api.near.ai/v1",
+        "sensitive": false
+      },
+      "NEARAI_SMALL_MODEL": {
+        "type": "string",
+        "description": "Override the default NEAR AI small model identifier.",
+        "required": false,
+        "default": "Qwen/Qwen3.6-35B-A3B-FP8",
+        "sensitive": false
+      },
+      "NEARAI_LARGE_MODEL": {
+        "type": "string",
+        "description": "Override the default NEAR AI large model identifier.",
+        "required": false,
+        "default": "zai-org/GLM-5.1-FP8",
+        "sensitive": false
+      },
+      "NEARAI_EXPERIMENTAL_TELEMETRY": {
+        "type": "boolean",
+        "description": "Enable experimental telemetry features for enhanced debugging and usage analytics.",
+        "required": false,
+        "default": false,
+        "sensitive": false
+      },
+      "NEARAI_BROWSER_BASE_URL": {
+        "type": "string",
+        "description": "Browser-only proxy endpoint base URL for NEAR AI requests. Do not expose API keys in browser clients.",
+        "required": false,
+        "sensitive": false
+      }
+    }
+  },
+  "eliza": {
+    "platforms": [
+      "browser",
+      "node"
+    ],
+    "runtime": "both",
+    "platformDetails": {
+      "browser": "Browser-compatible build available via exports.browser",
+      "node": "Node.js build available via exports.node"
+    }
+  },
+  "peerDependencies": {
+    "@elizaos/core": "2.0.3-beta.2"
+  },
+  "gitHead": "82fe0f44215954c2417328203f5bd6510985c1fc"
+}