@specrun/cli 0.1.0-beta1 → 0.1.0-beta2
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/README.md +13 -12
- package/dist/index.js +14679 -312
- package/package.json +3 -2
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# specrun
|
|
2
2
|
|
|
3
3
|
A lightweight CLI framework for building and executing agentic workflows using the [Oracle Agent Spec](https://docs.oracle.com/en/cloud/paas/digital-assistant/agent-spec/) (v26.1.0).
|
|
4
4
|
|
|
@@ -12,23 +12,24 @@ Define multi-step AI workflows as JSON, wire up LLM-powered agents and external
|
|
|
12
12
|
- **External tools** - Tools are standalone executables (shell scripts, Python, etc.) that communicate via JSON over stdin/stdout
|
|
13
13
|
- **Branching logic** - Conditional routing with `BranchingNode` for dynamic workflows
|
|
14
14
|
- **Validation** - Spec-level and graph-level validation catches errors before execution
|
|
15
|
-
- **Scaffolding** - `
|
|
15
|
+
- **Scaffolding** - `specrun init` generates a project template to get started quickly
|
|
16
16
|
|
|
17
17
|
## Installation
|
|
18
18
|
|
|
19
19
|
```bash
|
|
20
|
-
npm
|
|
21
|
-
npm
|
|
22
|
-
```
|
|
20
|
+
# npm
|
|
21
|
+
npm install -g @specrun/cli
|
|
23
22
|
|
|
24
|
-
|
|
23
|
+
# Homebrew
|
|
24
|
+
brew install spichen/tap/specrun
|
|
25
|
+
```
|
|
25
26
|
|
|
26
27
|
## Quick Start
|
|
27
28
|
|
|
28
29
|
### 1. Scaffold a new project
|
|
29
30
|
|
|
30
31
|
```bash
|
|
31
|
-
|
|
32
|
+
specrun init my-project
|
|
32
33
|
```
|
|
33
34
|
|
|
34
35
|
This creates:
|
|
@@ -42,7 +43,7 @@ my-project/
|
|
|
42
43
|
### 2. Run a flow
|
|
43
44
|
|
|
44
45
|
```bash
|
|
45
|
-
|
|
46
|
+
specrun run my-project/flow.json \
|
|
46
47
|
--tools-dir my-project/tools \
|
|
47
48
|
--input '{"query": "hello"}'
|
|
48
49
|
```
|
|
@@ -50,13 +51,13 @@ agentflow run my-project/flow.json \
|
|
|
50
51
|
### 3. Validate a flow
|
|
51
52
|
|
|
52
53
|
```bash
|
|
53
|
-
|
|
54
|
+
specrun validate my-project/flow.json --tools-dir my-project/tools
|
|
54
55
|
```
|
|
55
56
|
|
|
56
57
|
## CLI Reference
|
|
57
58
|
|
|
58
59
|
```
|
|
59
|
-
|
|
60
|
+
specrun [options] <command>
|
|
60
61
|
|
|
61
62
|
Options:
|
|
62
63
|
-v, --verbose Enable verbose logging
|
|
@@ -69,7 +70,7 @@ Commands:
|
|
|
69
70
|
validate <flow.json> Validate a flow definition
|
|
70
71
|
--tools-dir <dir> Directory containing tool executables
|
|
71
72
|
|
|
72
|
-
init <project-name> Scaffold a new
|
|
73
|
+
init <project-name> Scaffold a new specrun project
|
|
73
74
|
```
|
|
74
75
|
|
|
75
76
|
## How It Works
|
|
@@ -188,4 +189,4 @@ npm run build
|
|
|
188
189
|
|
|
189
190
|
## License
|
|
190
191
|
|
|
191
|
-
See [LICENSE](LICENSE) for details.
|
|
192
|
+
MIT - See [LICENSE](LICENSE) for details.
|