@ai-setting/roy-agent-core 1.4.1 → 1.4.4
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/dist/index.js +52 -52
- package/package.json +3 -2
package/dist/index.js
CHANGED
|
@@ -17563,37 +17563,37 @@ and using available skills - you can perceive them directly.
|
|
|
17563
17563
|
For complex, structured, or long-running tasks, leverage the **Roy Intelligent OS**
|
|
17564
17564
|
command line via bash:
|
|
17565
17565
|
\`\`\`bash
|
|
17566
|
-
roy <command>
|
|
17566
|
+
roy-agent <command>
|
|
17567
17567
|
\`\`\`
|
|
17568
17568
|
|
|
17569
17569
|
#### Core Commands
|
|
17570
17570
|
|
|
17571
17571
|
| Command | Description |
|
|
17572
17572
|
|---------|-------------|
|
|
17573
|
-
| \`roy act <message>\` | Natural language execution - start any task |
|
|
17574
|
-
| \`roy\` / \`roy interact\` | Interactive REPL mode for multi-turn conversations |
|
|
17575
|
-
| \`roy sessions\` | Manage conversation sessions |
|
|
17576
|
-
| \`roy tasks\` | Create, track, and complete tasks |
|
|
17577
|
-
| \`roy memory\` | Persistent knowledge storage |
|
|
17578
|
-
| \`roy skills\` | Extend capabilities with skills |
|
|
17579
|
-
| \`roy tools\` | Access built-in tools |
|
|
17580
|
-
| \`roy commands\` | Command library management |
|
|
17573
|
+
| \`roy-agent act <message>\` | Natural language execution - start any task |
|
|
17574
|
+
| \`roy-agent\` / \`roy-agent interact\` | Interactive REPL mode for multi-turn conversations |
|
|
17575
|
+
| \`roy-agent sessions\` | Manage conversation sessions |
|
|
17576
|
+
| \`roy-agent tasks\` | Create, track, and complete tasks |
|
|
17577
|
+
| \`roy-agent memory\` | Persistent knowledge storage |
|
|
17578
|
+
| \`roy-agent skills\` | Extend capabilities with skills |
|
|
17579
|
+
| \`roy-agent tools\` | Access built-in tools |
|
|
17580
|
+
| \`roy-agent commands\` | Command library management |
|
|
17581
17581
|
|
|
17582
17582
|
#### Advanced Commands
|
|
17583
17583
|
|
|
17584
17584
|
| Command | Description |
|
|
17585
17585
|
|---------|-------------|
|
|
17586
|
-
| \`roy workflow\` | Workflow DAG management and execution |
|
|
17587
|
-
| \`roy eventsource\` / \`roy es\` | Event source management (lark-cli, timer, websocket) |
|
|
17588
|
-
| \`roy mcp\` | MCP (Model Context Protocol) server management |
|
|
17589
|
-
| \`roy config\` / \`roy cfg\` | Configuration management |
|
|
17590
|
-
| \`roy debug\` | Debugging tools based on trace mechanism |
|
|
17591
|
-
| \`roy lsp\` | LSP (Language Server Protocol) server management |
|
|
17586
|
+
| \`roy-agent workflow\` | Workflow DAG management and execution |
|
|
17587
|
+
| \`roy-agent eventsource\` / \`roy-agent es\` | Event source management (lark-cli, timer, websocket) |
|
|
17588
|
+
| \`roy-agent mcp\` | MCP (Model Context Protocol) server management |
|
|
17589
|
+
| \`roy-agent config\` / \`roy-agent cfg\` | Configuration management |
|
|
17590
|
+
| \`roy-agent debug\` | Debugging tools based on trace mechanism |
|
|
17591
|
+
| \`roy-agent lsp\` | LSP (Language Server Protocol) server management |
|
|
17592
17592
|
|
|
17593
17593
|
#### Act Command Options
|
|
17594
17594
|
|
|
17595
17595
|
\`\`\`bash
|
|
17596
|
-
roy act <message> [options]
|
|
17596
|
+
roy-agent act <message> [options]
|
|
17597
17597
|
|
|
17598
17598
|
Options:
|
|
17599
17599
|
-c, --continue Continue last session
|
|
@@ -17610,74 +17610,74 @@ Options:
|
|
|
17610
17610
|
#### Sessions Command
|
|
17611
17611
|
|
|
17612
17612
|
\`\`\`bash
|
|
17613
|
-
roy sessions list|get|new|rename|delete|messages|grep|compact|checkpoints|active|add-message|mock
|
|
17613
|
+
roy-agent sessions list|get|new|rename|delete|messages|grep|compact|checkpoints|active|add-message|mock
|
|
17614
17614
|
\`\`\`
|
|
17615
17615
|
|
|
17616
|
-
- \`roy sessions list\` - List all sessions
|
|
17617
|
-
- \`roy sessions get <id>\` - Get session details
|
|
17618
|
-
- \`roy sessions new\` - Create new session
|
|
17619
|
-
- \`roy sessions compact <id>\` - Compact session context
|
|
17620
|
-
- \`roy sessions grep <query>\` - Search messages
|
|
17621
|
-
- \`roy sessions delete <ids...>\` - Delete sessions (support batch, --all, --older-than)
|
|
17616
|
+
- \`roy-agent sessions list\` - List all sessions
|
|
17617
|
+
- \`roy-agent sessions get <id>\` - Get session details
|
|
17618
|
+
- \`roy-agent sessions new\` - Create new session
|
|
17619
|
+
- \`roy-agent sessions compact <id>\` - Compact session context
|
|
17620
|
+
- \`roy-agent sessions grep <query>\` - Search messages
|
|
17621
|
+
- \`roy-agent sessions delete <ids...>\` - Delete sessions (support batch, --all, --older-than)
|
|
17622
17622
|
|
|
17623
17623
|
#### Tasks Command
|
|
17624
17624
|
|
|
17625
17625
|
\`\`\`bash
|
|
17626
|
-
roy tasks list|get|create|update|delete|complete|operations
|
|
17626
|
+
roy-agent tasks list|get|create|update|delete|complete|operations
|
|
17627
17627
|
\`\`\`
|
|
17628
17628
|
|
|
17629
|
-
- \`roy tasks create\` - Create task with title, description, goals
|
|
17630
|
-
- \`roy tasks list\` - List tasks (filter by status, priority)
|
|
17631
|
-
- \`roy tasks get <id>\` - Get task details with operations
|
|
17632
|
-
- \`roy tasks update\` - Update status, progress, priority
|
|
17633
|
-
- \`roy tasks complete <id>\` - Mark task as completed
|
|
17634
|
-
- \`roy tasks operations\` - Manage operation records
|
|
17629
|
+
- \`roy-agent tasks create\` - Create task with title, description, goals
|
|
17630
|
+
- \`roy-agent tasks list\` - List tasks (filter by status, priority)
|
|
17631
|
+
- \`roy-agent tasks get <id>\` - Get task details with operations
|
|
17632
|
+
- \`roy-agent tasks update\` - Update status, progress, priority
|
|
17633
|
+
- \`roy-agent tasks complete <id>\` - Mark task as completed
|
|
17634
|
+
- \`roy-agent tasks operations\` - Manage operation records
|
|
17635
17635
|
|
|
17636
17636
|
#### Memory Command
|
|
17637
17637
|
|
|
17638
17638
|
\`\`\`bash
|
|
17639
|
-
roy memory record|recall
|
|
17639
|
+
roy-agent memory record|recall
|
|
17640
17640
|
\`\`\`
|
|
17641
17641
|
|
|
17642
|
-
- \`roy memory record\` - Record knowledge (append, prepend, overwrite)
|
|
17643
|
-
- \`roy memory recall\` - Recall knowledge from memory files
|
|
17642
|
+
- \`roy-agent memory record\` - Record knowledge (append, prepend, overwrite)
|
|
17643
|
+
- \`roy-agent memory recall\` - Recall knowledge from memory files
|
|
17644
17644
|
|
|
17645
17645
|
#### Skills Command
|
|
17646
17646
|
|
|
17647
17647
|
\`\`\`bash
|
|
17648
|
-
roy skills list|get|search|reload|show-config
|
|
17648
|
+
roy-agent skills list|get|search|reload|show-config
|
|
17649
17649
|
\`\`\`
|
|
17650
17650
|
|
|
17651
17651
|
#### Tools Command
|
|
17652
17652
|
|
|
17653
17653
|
\`\`\`bash
|
|
17654
|
-
roy tools list|get|exec-tool
|
|
17654
|
+
roy-agent tools list|get|exec-tool
|
|
17655
17655
|
\`\`\`
|
|
17656
17656
|
|
|
17657
17657
|
#### Commands Library
|
|
17658
17658
|
|
|
17659
17659
|
\`\`\`bash
|
|
17660
|
-
roy commands list|add|remove|info|dirs
|
|
17660
|
+
roy-agent commands list|add|remove|info|dirs
|
|
17661
17661
|
\`\`\`
|
|
17662
17662
|
|
|
17663
|
-
- \`roy commands list\` - List saved commands
|
|
17664
|
-
- \`roy commands add <name> <command>\` - Save a command
|
|
17665
|
-
- \`roy commands info <name>\` - Show command details
|
|
17663
|
+
- \`roy-agent commands list\` - List saved commands
|
|
17664
|
+
- \`roy-agent commands add <name> <command>\` - Save a command
|
|
17665
|
+
- \`roy-agent commands info <name>\` - Show command details
|
|
17666
17666
|
|
|
17667
17667
|
#### Workflow Command
|
|
17668
17668
|
|
|
17669
17669
|
\`\`\`bash
|
|
17670
|
-
roy workflow list|add|nodes|get|update|remove|run|pause|resume|stop|status
|
|
17670
|
+
roy-agent workflow list|add|nodes|get|update|remove|run|pause|resume|stop|status
|
|
17671
17671
|
\`\`\`
|
|
17672
17672
|
|
|
17673
|
-
- \`roy workflow run <name>\` - Run a workflow
|
|
17674
|
-
- \`roy workflow status <run-id>\` - Check run status
|
|
17675
|
-
- \`roy workflow pause|resume|stop <run-id>\` - Control workflow execution
|
|
17673
|
+
- \`roy-agent workflow run <name>\` - Run a workflow
|
|
17674
|
+
- \`roy-agent workflow status <run-id>\` - Check run status
|
|
17675
|
+
- \`roy-agent workflow pause|resume|stop <run-id>\` - Control workflow execution
|
|
17676
17676
|
|
|
17677
17677
|
#### EventSource Command
|
|
17678
17678
|
|
|
17679
17679
|
\`\`\`bash
|
|
17680
|
-
roy eventsource|es list|add|remove|start|stop|status
|
|
17680
|
+
roy-agent eventsource|es list|add|remove|start|stop|status
|
|
17681
17681
|
\`\`\`
|
|
17682
17682
|
|
|
17683
17683
|
Supported event types: \`lark-cli\`, \`timer\`, \`websocket\`
|
|
@@ -17685,33 +17685,33 @@ Supported event types: \`lark-cli\`, \`timer\`, \`websocket\`
|
|
|
17685
17685
|
#### MCP Command
|
|
17686
17686
|
|
|
17687
17687
|
\`\`\`bash
|
|
17688
|
-
roy mcp list|tools|reload
|
|
17688
|
+
roy-agent mcp list|tools|reload
|
|
17689
17689
|
\`\`\`
|
|
17690
17690
|
|
|
17691
17691
|
#### Config Command
|
|
17692
17692
|
|
|
17693
17693
|
\`\`\`bash
|
|
17694
|
-
roy config|cfg list|export|import
|
|
17694
|
+
roy-agent config|cfg list|export|import
|
|
17695
17695
|
\`\`\`
|
|
17696
17696
|
|
|
17697
17697
|
#### Debug Command
|
|
17698
17698
|
|
|
17699
17699
|
\`\`\`bash
|
|
17700
|
-
roy debug list|trace|tree|repl
|
|
17700
|
+
roy-agent debug list|trace|tree|repl
|
|
17701
17701
|
\`\`\`
|
|
17702
17702
|
|
|
17703
17703
|
#### LSP Command
|
|
17704
17704
|
|
|
17705
17705
|
\`\`\`bash
|
|
17706
|
-
roy lsp install|list|check
|
|
17706
|
+
roy-agent lsp install|list|check
|
|
17707
17707
|
\`\`\`
|
|
17708
17708
|
|
|
17709
17709
|
### Progressive Discovery
|
|
17710
17710
|
|
|
17711
17711
|
When unsure about usage, use \`--help\` to self-learn:
|
|
17712
17712
|
\`\`\`bash
|
|
17713
|
-
roy <command> --help
|
|
17714
|
-
roy <command> <subcmd> --help
|
|
17713
|
+
roy-agent <command> --help
|
|
17714
|
+
roy-agent <command> <subcmd> --help
|
|
17715
17715
|
\`\`\`
|
|
17716
17716
|
|
|
17717
17717
|
## Behavioral Guidelines
|
|
@@ -17719,8 +17719,8 @@ roy <command> <subcmd> --help
|
|
|
17719
17719
|
1. **Built-in first**: Prefer your built-in tools and skills before external commands
|
|
17720
17720
|
2. **Use Roy OS for complex tasks**: Leverage \`roy\` commands for structured work
|
|
17721
17721
|
3. **Be proactive**: Anticipate needs and suggest next steps
|
|
17722
|
-
4. **Stay organized**: Use \`roy tasks\` for complex, multi-step work
|
|
17723
|
-
5. **Persist knowledge**: Save important information with \`roy memory\`
|
|
17722
|
+
4. **Stay organized**: Use \`roy-agent tasks\` for complex, multi-step work
|
|
17723
|
+
5. **Persist knowledge**: Save important information with \`roy-agent memory\`
|
|
17724
17724
|
6. **Think step-by-step**: Break down complex requests into manageable steps
|
|
17725
17725
|
|
|
17726
17726
|
## Code & Version Control
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ai-setting/roy-agent-core",
|
|
3
|
-
"version": "1.4.
|
|
3
|
+
"version": "1.4.4",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "Core SDK for roy-agent - Environment, Components, Tools, Sessions, Tasks",
|
|
6
6
|
"main": "./dist/index.js",
|
|
@@ -73,6 +73,7 @@
|
|
|
73
73
|
},
|
|
74
74
|
"scripts": {
|
|
75
75
|
"build": "bun run bunup",
|
|
76
|
-
"clean": "rm -rf dist"
|
|
76
|
+
"clean": "rm -rf dist",
|
|
77
|
+
"typecheck": "npx tsc --noEmit --skipLibCheck --project tsconfig.json"
|
|
77
78
|
}
|
|
78
79
|
}
|