Feature/full plugin docs (elizaOS#52)

* feat: add support for agentic plugin documentation * feat: add support for agentic plugin documentation (#5) * feat: add support for agentic plugin documentation * Feature/full plugin docs (#7) * feat: add support for agentic plugin documentation * feat: add support for agentic plugin documentation * feat: add support for agentic plugin documentation * feat: add support for agentic plugin documentation * feat: add support for agentic plugin documentation * feat: add support for agentic plugin documentation * feat: add support for agentic plugin documentation * feat: add support for agentic plugin documentation
apollodao · Jan 2, 2025 · 54f2bc7 · 54f2bc7
1 parent 07191f6
commit 54f2bc7
Show file tree

Hide file tree

Showing 16 changed files with 2,595 additions and 92 deletions.
diff --git a/.github/workflows/jsdoc-automation.yml b/.github/workflows/jsdoc-automation.yml
@@ -3,22 +3,32 @@ name: JSDoc Automation
 on:
   workflow_dispatch:
     inputs:
+      jsdoc:
+        description: 'Generate JSDoc comments (T/F)'
+        required: true
+        default: 'T'
+        type: string
+      readme:
+        description: 'Generate README documentation (T/F)'
+        required: true
+        default: 'T'
+        type: string
       pull_number:
         description: 'Pull Request Number (if not provided, scans root_directory) - PR must be merged to develop branch'
         required: false
         type: string
       root_directory:
         description: 'Only scans files in this directory (relative to repository root, e.g., packages/core/src)'
         required: true
-        default: 'packages/core/src/test_resources'
+        default: 'packages/plugin-near/'
         type: string
       excluded_directories:
         description: 'Directories to exclude from scanning (comma-separated, relative to root_directory)'
         required: true
         default: 'node_modules,dist,test'
         type: string
       reviewers:
-        description: 'Pull Request Reviewers (comma-separated GitHub usernames)'
+        description: 'Pull Request Reviewers (Must be collaborator on the repository) comma-separated GitHub usernames'
         required: true
         default: ''
         type: string
@@ -27,6 +37,11 @@ on:
         required: false
         default: 'develop'
         type: string
+      language:
+        description: 'Documentation language (e.g., English, Spanish, French)'
+        required: true
+        default: 'English'
+        type: string
 
 jobs:
   generate-docs:

diff --git a/packages/plugin-near/src/actions/swap.ts b/packages/plugin-near/src/actions/swap.ts
@@ -39,6 +39,7 @@ async function checkStorageBalance(
     }
 }
 
+// TODO: add functionality to support multiple networks
 async function swapToken(
     runtime: IAgentRuntime,
     inputTokenId: string,

diff --git a/scripts/jsdoc-automation/package.json b/scripts/jsdoc-automation/package.json
@@ -3,10 +3,13 @@
     "name": "plugin-audix",
     "version": "1.0.0",
     "description": "",
-    "main": "index.ts",
+    "main": "dist/index.js",
+    "module": "dist/index.mjs",
+    "types": "dist/index.d.ts",
     "scripts": {
-        "start": "NODE_OPTIONS='--loader ts-node/esm' node src/index.ts",
-        "test": "echo \"Error: no test specified\" && exit 1",
+        "build": "tsup",
+        "dev": "tsup --watch",
+        "start": "node dist/index.js",
         "clean": "rm -rf node_modules dist"
     },
     "keywords": [],
@@ -16,15 +19,16 @@
         "@langchain/openai": "^0.3.16",
         "@octokit/rest": "^21.0.2",
         "@types/node": "^20.11.0",
-        "dotenv": "^16.4.7",
-        "langchain": "^0.3.7",
         "@typescript-eslint/parser": "6.18.1",
         "@typescript-eslint/types": "6.18.1",
         "@typescript-eslint/typescript-estree": "6.18.1",
+        "dotenv": "^16.4.7",
+        "langchain": "^0.3.7",
         "yaml": "^2.3.4"
     },
     "devDependencies": {
         "ts-node": "^10.9.2",
+        "tsup": "^8.3.5",
         "typescript": "5.3.3"
     }
 }