@charzhu/openjaw-agent 0.2.9 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@charzhu/openjaw-agent",
3
- "version": "0.2.9",
3
+ "version": "0.3.1",
4
4
  "description": "OpenJaw Agent — Autonomous desktop AI assistant for the terminal. Rich Ink TUI, 100+ tools, multi-channel bridges (Telegram, Feishu, Teams, WeChat). Standalone, no MCP server required.",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -117,10 +117,19 @@ Prefer the most reliable / lowest-friction tool for the task:
117
117
  categories unless many tools from one category are required.
118
118
  4. **Graph API / structured APIs** before UI automation for data work.
119
119
  5. **COM / UIA** before browser DOM for desktop app control.
120
- 6. **Browser DOM** for web apps when no API exists.
121
- 7. **`computer` tool** (screenshot + click) only when no structured
120
+ 6. **Web tools before browser tools** for static information: use
121
+ `web_search` to discover current sources, `web_extract` to read
122
+ selected pages/articles/docs, and `web_fetch` for raw APIs, JSON, or
123
+ plain text endpoints.
124
+ 7. **Browser tools** for dynamic or interactive web apps. Start with
125
+ `browser_navigate`, use returned snapshot refs (`@e1`, `@e2`) or
126
+ `browser_snapshot`, then prefer `browser_click({ ref })` and
127
+ `browser_type({ ref, text })`. Use `browser_wait` for slow pages,
128
+ `browser_dismiss` for overlays, `browser_console` for page errors,
129
+ and `browser_get_images` / `browser_vision` for visual pages.
130
+ 8. **`computer` tool** (screenshot + click) only when no structured
122
131
  tool can do the job.
123
- 8. **`system_run`** only for shell / CLI / package managers / external
132
+ 9. **`system_run`** only for shell / CLI / package managers / external
124
133
  commands — NOT for code snippets (use `code_execute`).
125
134
 
126
135
  ## Planning Rules
@@ -2,6 +2,8 @@
2
2
  name: create-docx
3
3
  description: "Create, read, and edit Word documents (.docx) with professional formatting."
4
4
  whenToUse: "User asks to create a Word document, .docx file"
5
+ execution: fork
6
+ timeoutMs: 180000
5
7
  ---
6
8
 
7
9
  # Skill: Create Word Document (DOCX)
@@ -2,6 +2,8 @@
2
2
  name: create-pdf-report
3
3
  description: "Generate professional PDF reports with tables, charts, and styled layouts."
4
4
  whenToUse: "User asks to create a PDF document or report"
5
+ execution: fork
6
+ timeoutMs: 180000
5
7
  ---
6
8
 
7
9
  # Skill: Create PDF Report
@@ -2,6 +2,8 @@
2
2
  name: create-pptx
3
3
  description: "Generate professional PowerPoint presentations with bold design and structured layouts."
4
4
  whenToUse: "User asks to create a presentation, deck, or slides"
5
+ execution: fork
6
+ timeoutMs: 180000
5
7
  ---
6
8
 
7
9
  # Skill: Create PowerPoint Presentation
@@ -2,6 +2,8 @@
2
2
  name: daily-briefing
3
3
  description: "Gives a quick morning overview of emails, calendar, and Teams activity."
4
4
  whenToUse: "User asks for a morning briefing or daily summary of emails, calendar, and Teams"
5
+ execution: fork
6
+ timeoutMs: 180000
5
7
  ---
6
8
 
7
9
  # Skill: Daily Briefing
@@ -2,6 +2,8 @@
2
2
  name: data-analysis
3
3
  description: "Analyze data from various sources and generate visualizations with Chinese label support."
4
4
  whenToUse: "User asks to analyze data, metrics, or trends"
5
+ execution: fork
6
+ timeoutMs: 180000
5
7
  ---
6
8
 
7
9
  # Skill: Data Analysis & Visualization
@@ -1,7 +1,9 @@
1
1
  ---
2
2
  name: deep-research
3
3
  description: "Conduct in-depth, multi-step research by decomposing queries and synthesizing reports."
4
- whenToUse: "User asks for thorough research on a topic, technology, or competitor"
4
+ whenToUse: "User asks for thorough, in-depth, multi-step research on a topic, technology, market, or competitor. Do not use for quick news/headline/current-info lookups; use web_search directly."
5
+ execution: fork
6
+ timeoutMs: 180000
5
7
  ---
6
8
 
7
9
  # Skill: Deep Research
@@ -14,6 +16,7 @@ Conduct in-depth, multi-step research on a given topic by decomposing queries, g
14
16
  - User says "深入调研一下" or "do a deep dive on"
15
17
  - User needs more than a quick answer — needs analysis with sources
16
18
  - Replaces and enhances the basic web-research skill for complex queries
19
+ - Do NOT use for quick news/headline/current-info lookups; use `web_search` directly instead.
17
20
 
18
21
  ## Workflow
19
22
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: web-research
3
3
  description: "Conduct structured web research on topics, competitors, or technologies."
4
- whenToUse: "User asks to research a topic, product, or competitor"
4
+ whenToUse: "User asks for structured multi-source research on a topic, product, market, or competitor. Do not use for quick news/headline/current-info lookups; use web_search directly."
5
5
  ---
6
6
 
7
7
  # Skill: Web Research & Competitor Analysis
@@ -14,6 +14,7 @@ Conduct structured web research on topics, competitors, or technologies. Compile
14
14
  - User asks to compare products or technologies
15
15
  - User asks "帮我调研一下" or "看看竞品怎么做的"
16
16
  - Need to gather external information for decision-making
17
+ - Do NOT use for quick news/headline/current-info lookups; use `web_search` directly instead.
17
18
 
18
19
  ## Steps
19
20