ocsmarttools 0.1.6 → 0.1.8

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to `ocsmarttools` are documented here.
 
+## [0.1.8] - 2026-02-22
+
+### Changed
+- Improved `tool_search` fallback discovery for skill-driven workflows by adding relevance keywords for browser/playwright/stealth-style usage.
+- Added explicit skill-compatibility note in search results and README.
+
+## [0.1.7] - 2026-02-22
+
+### Fixed
+- CLI command compatibility on older OpenClaw builds by avoiding nested CLI subcommands that could collide.
+- Replaced nested CLI forms with stable commands:
+  - `stats-reset`
+  - `config-keys`
+  - `config-set`
+  - `config-reset`
+
 ## [0.1.6] - 2026-02-22
 
 ### Changed

package/README.md

@@ -11,6 +11,10 @@ Provider-agnostic tool orchestration for lower latency and lower token cost.
 - `tool_batch`: runs bounded multi-step workflows (`call` + `foreach`)
 - `tool_result_get`: retrieves large stored outputs by handle
 
+Skills compatibility:
+- Works with OpenClaw skills because skills are instructions layered on top of tools.
+- For blocked websites, skill workflows that use `browser`/Playwright-style flows are compatible with `tool_dispatch` and `tool_batch`.
+
 ## Why It Helps
 
 ```mermaid
@@ -93,13 +97,13 @@ Model note:
 | `openclaw ocsmarttools strict <on\|off>` | Turns strict routing on/off |
 | `openclaw ocsmarttools sync` | Rewrites the managed routing block in `AGENTS.md` |
 | `openclaw ocsmarttools stats` | Shows calls, errors, timeouts, latency, and estimated savings |
-| `openclaw ocsmarttools stats reset` | Resets plugin stats |
+| `openclaw ocsmarttools stats-reset` | Resets plugin stats |
 | `openclaw ocsmarttools setup [safe\|standard]` | Applies recommended defaults |
 | `openclaw ocsmarttools mode <safe\|standard>` | Changes mode only |
 | `openclaw ocsmarttools config` | Shows plugin config |
-| `openclaw ocsmarttools config keys` | Lists editable config keys |
-| `openclaw ocsmarttools config set <key> <value>` | Changes one config value |
-| `openclaw ocsmarttools config reset [key]` | Resets one key or all keys |
+| `openclaw ocsmarttools config-keys` | Lists editable config keys |
+| `openclaw ocsmarttools config-set <key> <value>` | Changes one config value |
+| `openclaw ocsmarttools config-reset [key]` | Resets one key or all keys |
 | `openclaw ocsmarttools version` | Shows installed plugin version |
 
 ## Common Config Actions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ocsmarttools",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Provider-agnostic advanced tool orchestration plugin for OpenClaw with search, dispatch, and batching",
   "type": "module",
   "scripts": {

package/src/commands/cli.ts

@@ -59,8 +59,8 @@ export function registerCliCommands(api: OpenClawPluginApi, metrics: MetricsStor
         // eslint-disable-next-line no-console
         console.log(renderStats(metrics));
       });
-      statsCmd
-        .command("reset")
+      adv
+        .command("stats-reset")
         .description("Reset usage/savings metrics window")
         .action(() => {
           // eslint-disable-next-line no-console
@@ -126,7 +126,7 @@ export function registerCliCommands(api: OpenClawPluginApi, metrics: MetricsStor
         });
 
       adv
-        .command("config keys")
+        .command("config-keys")
         .description("List editable plugin config keys")
         .action(() => {
           // eslint-disable-next-line no-console
@@ -134,7 +134,7 @@ export function registerCliCommands(api: OpenClawPluginApi, metrics: MetricsStor
         });
 
       adv
-        .command("config set <key> <value>")
+        .command("config-set <key> <value>")
         .description("Set one plugin config key")
         .action(async (key: string, value: string) => {
           const text = await setConfigKey(api, key, value);
@@ -143,7 +143,7 @@ export function registerCliCommands(api: OpenClawPluginApi, metrics: MetricsStor
         });
 
       adv
-        .command("config reset [key]")
+        .command("config-reset [key]")
         .description("Reset all plugin config to defaults or reset one key")
         .action(async (key?: string) => {
           const text = await resetConfig(api, key);

package/src/lib/tool-catalog.ts

@@ -5,11 +5,19 @@ export type ToolEntry = {
   group: string;
   description: string;
   paramsHint?: string;
+  keywords?: string[];
   source: "builtin" | "policy" | "live";
 };
 
 const BUILTIN: ToolEntry[] = [
-  { name: "exec", group: "runtime", description: "Run shell commands.", paramsHint: "{ command }", source: "builtin" },
+  {
+    name: "exec",
+    group: "runtime",
+    description: "Run shell commands.",
+    paramsHint: "{ command }",
+    keywords: ["script", "python", "node", "playwright", "stealth", "scrape"],
+    source: "builtin",
+  },
   { name: "bash", group: "runtime", description: "Alias for exec in many contexts.", paramsHint: "{ command }", source: "builtin" },
   { name: "process", group: "runtime", description: "Manage background command sessions.", paramsHint: "{ action, sessionId? }", source: "builtin" },
   { name: "read", group: "fs", description: "Read files.", paramsHint: "{ path }", source: "builtin" },
@@ -23,9 +31,30 @@ const BUILTIN: ToolEntry[] = [
   { name: "session_status", group: "sessions", description: "Show current session status.", paramsHint: "{}", source: "builtin" },
   { name: "memory_search", group: "memory", description: "Search memory snippets.", paramsHint: "{ query }", source: "builtin" },
   { name: "memory_get", group: "memory", description: "Read memory entries.", paramsHint: "{ key }", source: "builtin" },
-  { name: "web_search", group: "web", description: "Search the web.", paramsHint: "{ query }", source: "builtin" },
-  { name: "web_fetch", group: "web", description: "Fetch and extract web page content.", paramsHint: "{ url }", source: "builtin" },
-  { name: "browser", group: "ui", description: "Browser automation.", paramsHint: "{ action, ... }", source: "builtin" },
+  {
+    name: "web_search",
+    group: "web",
+    description: "Search the web.",
+    paramsHint: "{ query }",
+    keywords: ["research", "discover", "find"],
+    source: "builtin",
+  },
+  {
+    name: "web_fetch",
+    group: "web",
+    description: "Fetch and extract web page content.",
+    paramsHint: "{ url }",
+    keywords: ["read page", "extract", "html"],
+    source: "builtin",
+  },
+  {
+    name: "browser",
+    group: "ui",
+    description: "Browser automation.",
+    paramsHint: "{ action, ... }",
+    keywords: ["playwright", "stealth", "anti-bot", "captcha", "dynamic site", "javascript page"],
+    source: "builtin",
+  },
   { name: "canvas", group: "ui", description: "Canvas/artifact rendering actions.", paramsHint: "{ action, ... }", source: "builtin" },
   { name: "cron", group: "automation", description: "Manage scheduled jobs.", paramsHint: "{ action, ... }", source: "builtin" },
   { name: "gateway", group: "automation", description: "Gateway control-plane actions.", paramsHint: "{ action, ... }", source: "builtin" },
@@ -298,6 +327,7 @@ function score(query: string, entry: ToolEntry): number {
   const n = entry.name.toLowerCase();
   const d = entry.description.toLowerCase();
   const g = entry.group.toLowerCase();
+  const keywords = (entry.keywords ?? []).map((v) => v.toLowerCase());
 
   let s = 0;
   if (n === q) s += 100;
@@ -305,10 +335,13 @@ function score(query: string, entry: ToolEntry): number {
   if (n.includes(q)) s += 30;
   if (g.includes(q)) s += 15;
   if (d.includes(q)) s += 10;
+  if (keywords.includes(q)) s += 25;
 
   for (const token of q.split(/\s+/).filter(Boolean)) {
     if (n.includes(token)) s += 12;
     if (d.includes(token)) s += 4;
+    if (g.includes(token)) s += 4;
+    if (keywords.some((k) => k.includes(token))) s += 8;
   }
   return s;
 }

package/src/tools/tool-search.ts

@@ -65,6 +65,8 @@ export function createToolSearchTool(api: OpenClawPluginApi): AnyAgentTool {
         liveCount: built.liveCount,
         totalCatalogSize: catalog.length,
         count: matches.length,
+        note:
+          "Skills are instruction layers. OCSmartTools can still dispatch/batch-call runtime and browser tools used by those skills.",
         tools: matches,
       });
     },