@aiagenta2z/onekey-gateway 0.1.1 → 0.1.3

package/README.md

@@ -12,11 +12,16 @@ you can eliminate multiple expensive subscriptions and maximize your benefits. M
 
 OneKey Gateway provides CLI tool, Restful API, MCP, Skills and Python/Typescript methods for Agent and human to use commercial Agent APIs.
 
-| Gateway Type | Description                                                                                                   | BASE URL                               | CLI            |         
-|-------------|---------------------------------------------------------------------------------------------------------------|----------------------------------------|----------------|   
-| Agent APIs  | Allow your AI Agent to Access APIs [OneKey Agent Router Doc](https://www.deepnlp.org/doc/onekey_agent_router) | https://agent.deepnlp.org/agent_router | `onekey agent` | 
-| MCP  | Allow your AI clients to connect to commercial Http MCP [OneKey MCP Router Doc](https://www.deepnlp.org/doc/onekey_mcp_router)                                                       | https://agent.deepnlp.org/mcp          | `onekey mcp`   | 
-| LLM | Allow your AI clients to call LLM endpoint proxy   [OneKey LLM Router Doc](https://www.deepnlp.org/doc/onekey_llm_router)                                                             | https://agent.deepnlp.org/llm          | `onekey llm`   |
+| Gateway Type | Description                                                                                                                    | BASE URL                               | CLI            |         
+|-------------|--------------------------------------------------------------------------------------------------------------------------------|----------------------------------------|----------------|   
+| Agent APIs  | Allow your AI Agent to Access APIs [OneKey Agent Router Doc](https://www.deepnlp.org/doc/onekey_agent_router)                  | https://agent.deepnlp.org/agent_router | `onekey agent` | 
+| MCP  | Allow your AI clients to connect to commercial Http MCP [OneKey MCP Router Doc](https://www.deepnlp.org/doc/onekey_mcp_router) | https://agent.deepnlp.org/mcp          | `onekey mcp`   | 
+| LLM | Allow your AI clients to call LLM endpoint proxy   [OneKey LLM Router Doc](https://www.deepnlp.org/doc/onekey_llm_router)      | https://agent.deepnlp.org/llm          | `onekey llm`   |
+
+
+| Gateway Type                                   | Description                                                                            |
+|---------------------------------------------------|----------------------------------------------------------------------------------------|
+| Register Your New API | [OneKey Gateway Registry Documents](https://www.deepnlp.org/doc/onekey_agent_registry) |
 
 
 ### Architecture
@@ -101,7 +106,7 @@ prompt: New York City Italian Restaurants
 
 ```bash
 
-onekey agent google-maps/google-maps maps_search_places '{"query":"New York City Italian Restaurants"}'
+npx onekey agent google-maps/google-maps maps_search_places '{"query":"New York City Italian Restaurants"}'
 ```
 Result
 ```shell
@@ -128,15 +133,26 @@ https://us-static.aiagenta2z.com/local/files-wd/user_2177/7629e198-b10c-4a8b-8f6
 
 <img src="https://raw.githubusercontent.com/aiagenta2z/onekey-agent-router/refs/heads/main/docs/onekey-gateway-example-gemini.jpg" style="width:500px" alt="Image generation">
 
+#### Example 3: 3D Generation Step By Step Assembly Charts Build Plans
+
+prompt: 
+
+```bash
+export DEEPNLP_ONEKEY_ROUTER_ACCESS=YOUR_ACCESS_KEY
+onekey agent craftsman-agent/craftsman-agent generate_lego_build_plan '{"prompt":"Build Lego yacht with 5 decks using blue and white bricks","images":[],"mode":"basic"}' --timeout 30000
+```
+
+3D Step by Step Assembly Charts
+
+<img src="https://raw.githubusercontent.com/AI-Hub-Admin/Craftsman-Agent/refs/heads/main/docs/craftsman_agent_2.jpg" style="width:500px" alt="Image generation">
+
+
 
 ## Tutorial
 
 ### CLI Usage
 ```bash
 onekey agent <unique_id> <api_id> <data_json|@file>
-onekey mcp <server_name> [--name config_name]
-onekey llm --provider <provider> --model <model> --messages <json|@file> [--temperature <num>] [--response-format <format>] [--options <json|@file>]
-onekey llm --payload <json|@file>
 ```
 
 Supported ids can be found in the table below.
@@ -146,15 +162,15 @@ Supported ids can be found in the table below.
 **CLI**
 
 ```bash
-onekey agent google-maps/google-maps maps_search_places '{"query":"New York City Italian Restaurants"}'
+onekey agent google-maps/google-maps maps_search_places '{"query":"New York City Italian Restaurants"}' --timeout 30000
 ```
 
 **Skills**
 
 `agtm` package
 ```bash
-npx agtm add https://github.com/aiagenta2z/onekey-gateway  ## add all onekey router skills
-npx agtm add aiagenta2z/onekey-gateway --skill google-maps -g  ## install to global path
+npx agtm skills add https://github.com/aiagenta2z/onekey-gateway  ## add all onekey router skills
+npx agtm skills add aiagenta2z/onekey-gateway --skill google-maps -g  ## install to global path
 ```
 `skills` package
 ```
@@ -163,6 +179,12 @@ npx skills add https://github.com/aiagenta2z/onekey-agent-router
 npx skills add https://github.com/aiagenta2z/onekey-agent-router --skill amap-maps-streamableHTTP
 ```
 
+Run onekey skills with hint
+```bash
+npx agtm run nano # -> guide you through gemini-nano-banana tools
+npx agtm run nano aiagenta2z/onekey-gateway nano # -> Find the cli of generation or generation with reference images
+```
+
 ### OneKey MCP Config
 
 ```bash
@@ -182,7 +204,7 @@ Put below config into your clients
 ### OneKey LLM Router
 Call Gemini 3 LLM and Image Nano Banana model
 ```bash
-onekey llm --provider gemini --model gemini-3-flash-preview --messages @messages.json --temperature 0.7 --response-format json
+onekey llm --provider gemini --model gemini-3-flash-preview --messages @messages.json --temperature 0.7 --response-format json --timeout 30000
 ```
 
 ## Gateway Categories
@@ -201,7 +223,9 @@ onekey llm --provider gemini --model gemini-3-flash-preview --messages @messages
 | Image Generation     | gemini-nano-banana/gemini-nano-banana      [Doc](./docs/gemini-nano-banana/README.md)              | gemini-nano-banana       | generate_image_gemini<br>generate_image_nano_banana<br>generate_image_nano_banana_with_reference<br>ocr_extract_text_from_image<br>list_items_from_image                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 
 | Charts               | mcp-server-chart/mcp-server-chart  [Doc](./docs/mcp-server-chart/README.md)                        | mcp-server-chart         | generate_area_chart<br>generate_bar_chart<br>generate_boxplot_chart<br>generate_column_chart<br>generate_district_map<br>generate_dual_axes_chart<br>generate_fishbone_diagram<br>generate_flow_diagram<br>generate_funnel_chart<br>generate_histogram_chart<br>generate_line_chart<br>generate_liquid_chart<br>generate_mind_map<br>generate_network_graph<br>generate_organization_chart<br>generate_path_map<br>generate_pie_chart<br>generate_pin_map<br>generate_radar_chart<br>generate_sankey_chart<br>generate_scatter_chart<br>generate_spreadsheet<br>generate_treemap_chart<br>generate_venn_chart<br>generate_violin_chart<br>generate_waterfall_chart<br>generate_word_cloud_chart | 
 | Research QA          | perplexity/perplexity  [Doc](./docs/perplexity/README.md)                                          | perplexity               | perplexity_ask<br>perplexity_reason<br>perplexity_research<br>perplexity_search                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 
-| 3D Generation        | craftsman-agent/craftsman-agent [Doc](./docs/craftsman-agent/README.md)                            | craftsman-agent          | generate_lego_build_plan<br>generate_minecraft_build_plan                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 
+| 3D Generation        | craftsman-agent/craftsman-agent [Doc](./docs/craftsman-agent/README.md)                            | craftsman-agent          | generate_lego_build_plan<br>generate_minecraft_build_plan<br>generate_tesla_wraps                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 
+| Finance              | aiagenta2z/financeagent [Doc](./docs//README.md)                                    | financeagent             | get_hk_stock_market_hkex<br>get_cn_stock_market_shanghai_shenzhen<br>get_us_stock_market_nyse_nasdaq_dow<br>get_uk_stock_market_lse<br>get_india_stock_market_nse_india                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 
+
 
 
 #### Example 1: Google Maps Search
@@ -242,4 +266,12 @@ https://us-static.aiagenta2z.com/local/files-wd/user_2177/7629e198-b10c-4a8b-8f6
 
 
 ### Related
+[OneKey Gateway Documentation](https://www.deepnlp.org/doc/onekey_gateway)   
+[AI Agent Marketplace](https://www.deepnlp.org/store/ai-agent)   
+[GitHub Agtm](https://github.com/aiagenta2z/agtm)   
+[Submit AI Agent](https://www.deepnlp.org/workspace/my_ai_services)
+[Agent Infra Deployment](https://www.deepnlp.org/workspace/deploy)  
+[A2Z Payment SDK](https://www.deepnlp.org/agent/agent-a2z-payment)
+
+
 

package/dist/cli.js

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const client_1 = require("./client");
 const fs_1 = require("fs");
+const DEFAULT_TIMEOUT_MS = 60000;
 function parseArgs(argv) {
     const flags = {};
     const positionals = [];
@@ -76,22 +77,44 @@ function printHelp() {
     const text = `OneKey Gateway CLI
 
 Usage:
-    onekey agent <unique_id> <api_id> <data_json|@file>
-    onekey mcp <server_name> [--name config_name]
-    onekey llm --provider <provider> --model <model> --messages <json|@file> [--temperature <num>] [--response-format <format>] [--options <json|@file>]
-    onekey llm --payload <json|@file>
+    onekey agent <unique_id> <api_id> <data_json|@file> [--timeout <ms>]
+    onekey mcp <server_name> [--name config_name] [--timeout <ms>]
+    onekey llm --provider <provider> --model <model> --messages <json|@file> [--temperature <num>] [--response-format <format>] [--options <json|@file>] [--timeout <ms>]
+    onekey llm --payload <json|@file> [--timeout <ms>]
 
 Flags:
       --key <access_key>           Override DEEPNLP_ONEKEY_ROUTER_ACCESS
+      --timeout <ms>               Request timeout in milliseconds (float, default ${DEFAULT_TIMEOUT_MS})
       --help                       Show help
 
 Examples:
       onekey agent google-maps/google-maps maps_search_places '{"query":"New York City Italian Restaurants"}'
       onekey mcp google-maps
-      onekey llm --provider gemini --model gemini-3-flash-preview --messages @messages.json --temperature 0.7 --response-format json
+      onekey llm --provider gemini --model gemini-3-flash-preview --messages @messages.json --temperature 0.7 --response-format json --timeout 30000
 `;
     process.stdout.write(text);
 }
+function parseTimeoutMs(flags) {
+    const raw = flags.timeout;
+    if (raw === undefined)
+        return DEFAULT_TIMEOUT_MS;
+    if (raw === true) {
+        throw new Error("--timeout requires a value (milliseconds)");
+    }
+    if (typeof raw !== "string") {
+        throw new Error("--timeout must be a number (milliseconds)");
+    }
+    const trimmed = raw.trim();
+    const normalized = trimmed.includes(",") && !trimmed.includes(".") ? trimmed.replace(",", ".") : trimmed;
+    const ms = Number(normalized);
+    if (!Number.isFinite(ms)) {
+        throw new Error("--timeout must be a finite number (milliseconds)");
+    }
+    if (ms <= 0) {
+        throw new Error("--timeout must be greater than 0");
+    }
+    return Math.ceil(ms);
+}
 async function runAgent(positionals, flags) {
     const [uniqueId, apiId, dataInput] = positionals;
     if (!uniqueId || !apiId || !dataInput) {
@@ -99,12 +122,13 @@ async function runAgent(positionals, flags) {
     }
     const accessKey = resolveAccessKey(flags);
     warnIfUsingDefault(accessKey, flags);
+    const timeoutMs = parseTimeoutMs(flags);
     const data = parseJsonInput(dataInput, "data");
     const result = await (0, client_1.agentRouter)({
         unique_id: uniqueId,
         api_id: apiId,
         data
-    }, accessKey);
+    }, accessKey, { timeoutMs });
     process.stdout.write(`${JSON.stringify(result)}\n`);
 }
 async function runMcp(positionals, flags) {
@@ -129,6 +153,7 @@ async function runLlm(positionals, flags) {
     //   }
     const accessKey = resolveAccessKey(flags);
     warnIfUsingDefault(accessKey, flags);
+    const timeoutMs = parseTimeoutMs(flags);
     let payload;
     if (typeof flags.payload === "string") {
         payload = parseJsonInput(flags.payload, "payload");
@@ -168,7 +193,7 @@ async function runLlm(positionals, flags) {
         }
     }
     // payload.request_id = requestId;
-    const result = await (0, client_1.llmRouter)(payload, accessKey);
+    const result = await (0, client_1.llmRouter)(payload, accessKey, { timeoutMs });
     process.stdout.write(`${JSON.stringify(result)}\n`);
 }
 async function main() {

package/dist/client.d.ts

@@ -25,8 +25,11 @@ export type McpConfigOptions = {
     accessKey?: string;
     configName?: string;
 };
-export declare function agentRouter(request: AgentRequest, accessKey?: string): Promise<RouterResponse>;
-export declare function llmRouter(request: LlmRequest, accessKey?: string): Promise<RouterResponse>;
+export type RequestOptions = {
+    timeoutMs?: number;
+};
+export declare function agentRouter(request: AgentRequest, accessKey?: string, options?: RequestOptions): Promise<RouterResponse>;
+export declare function llmRouter(request: LlmRequest, accessKey?: string, options?: RequestOptions): Promise<RouterResponse>;
 export declare function buildMcpConfig(options: McpConfigOptions): {
     mcpServers: {
         [x: string]: {
@@ -39,4 +42,5 @@ export declare const constants: {
     MCP_ROUTER_BASE_URL: string;
     LLM_ROUTER_URL: string;
     DEFAULT_ACCESS_KEY: string;
+    DEFAULT_TIMEOUT_MS: number;
 };

package/dist/client.js

@@ -5,22 +5,50 @@ exports.agentRouter = agentRouter;
 exports.llmRouter = llmRouter;
 exports.buildMcpConfig = buildMcpConfig;
 const DEFAULT_ACCESS_KEY = "BETA_TEST_KEY_MARCH_2026";
+const DEFAULT_TIMEOUT_MS = 30000;
 const AGENT_ROUTER_URL = "https://agent.deepnlp.org/agent_router";
 const MCP_ROUTER_BASE_URL = "https://agent.deepnlp.org/mcp";
 const LLM_ROUTER_URL = "https://agent.deepnlp.org/llm";
 function resolveAccessKey(accessKey) {
     return accessKey && accessKey.trim().length > 0 ? accessKey : DEFAULT_ACCESS_KEY;
 }
-async function postJson(url, body, accessKey) {
+async function postJson(url, body, accessKey, options) {
     const key = resolveAccessKey(accessKey);
-    const response = await fetch(url, {
-        method: "POST",
-        headers: {
-            "Content-Type": "application/json",
-            "X-OneKey": key
-        },
-        body: JSON.stringify(body)
-    });
+    const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    let response;
+    try {
+        response = await fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "X-OneKey": key
+            },
+            body: JSON.stringify(body),
+            signal: controller.signal
+        });
+    }
+    catch (error) {
+        clearTimeout(timer);
+        const isAbortError = !!error && typeof error === "object" && "name" in error && error.name === "AbortError";
+        if (isAbortError) {
+            return {
+                success: false,
+                data: null,
+                error: `Request timed out after ${timeoutMs} ms`
+            };
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            data: null,
+            error: message
+        };
+    }
+    finally {
+        clearTimeout(timer);
+    }
     const text = await response.text();
     try {
         return JSON.parse(text);
@@ -33,11 +61,11 @@ async function postJson(url, body, accessKey) {
         };
     }
 }
-async function agentRouter(request, accessKey) {
-    return postJson(AGENT_ROUTER_URL, request, accessKey);
+async function agentRouter(request, accessKey, options) {
+    return postJson(AGENT_ROUTER_URL, request, accessKey, options);
 }
-async function llmRouter(request, accessKey) {
-    return postJson(LLM_ROUTER_URL, request, accessKey);
+async function llmRouter(request, accessKey, options) {
+    return postJson(LLM_ROUTER_URL, request, accessKey, options);
 }
 function buildMcpConfig(options) {
     const key = resolveAccessKey(options.accessKey);
@@ -55,5 +83,6 @@ exports.constants = {
     AGENT_ROUTER_URL,
     MCP_ROUTER_BASE_URL,
     LLM_ROUTER_URL,
-    DEFAULT_ACCESS_KEY
+    DEFAULT_ACCESS_KEY,
+    DEFAULT_TIMEOUT_MS
 };

package/dist/index.d.ts

@@ -1 +1 @@
-export { agentRouter, llmRouter, buildMcpConfig, type AgentRequest, type LlmRequest, type McpConfigOptions, type RouterResponse } from "./client";
+export { agentRouter, llmRouter, buildMcpConfig, type AgentRequest, type LlmRequest, type McpConfigOptions, type RequestOptions, type RouterResponse } from "./client";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aiagenta2z/onekey-gateway",
-  "version": "0.1.1",
-  "description": "OneKey Gateway CLI and SDK for routing AI agent, MCP, and LLM requests by DeepNLP x AI Agent A2Z",
+  "version": "0.1.3",
+  "description": "OneKey Gateway CLI and SDK for routing AI agent, MCP, Skills and LLM requests by DeepNLP x AI Agent A2Z",
   "license": "MIT",
   "author": "aiagenta2z",
   "homepage": "https://www.deepnlp.org/doc/onekey_gateway",