executor 1.4.7 → 1.4.8
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 +28 -13
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -48,15 +48,15 @@ Open `http://127.0.0.1:4788`, go to **Add Source**, paste a URL, and Executor wi
|
|
|
48
48
|
### Via the CLI
|
|
49
49
|
|
|
50
50
|
```bash
|
|
51
|
-
executor call
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
auth: { kind: "none" }
|
|
57
|
-
})'
|
|
51
|
+
executor call openapi addSource '{
|
|
52
|
+
"spec": "https://petstore3.swagger.io/api/v3/openapi.json",
|
|
53
|
+
"namespace": "petstore",
|
|
54
|
+
"baseUrl": "https://petstore3.swagger.io/api/v3"
|
|
55
|
+
}'
|
|
58
56
|
```
|
|
59
57
|
|
|
58
|
+
Use `baseUrl` when the OpenAPI document has relative `servers` entries (for example `"/api/v3"`).
|
|
59
|
+
|
|
60
60
|
## Use tools
|
|
61
61
|
|
|
62
62
|
Agents discover and call tools through a typed TypeScript runtime:
|
|
@@ -78,13 +78,21 @@ const issues = await tools.github.issues.list({
|
|
|
78
78
|
});
|
|
79
79
|
```
|
|
80
80
|
|
|
81
|
-
|
|
81
|
+
Use tools via the CLI:
|
|
82
82
|
|
|
83
83
|
```bash
|
|
84
|
-
executor
|
|
85
|
-
executor call
|
|
84
|
+
executor tools search "send email"
|
|
85
|
+
executor call --help
|
|
86
|
+
executor call github --help
|
|
87
|
+
executor call github issues --help
|
|
88
|
+
executor call cloudflare --help --match dns --limit 20
|
|
89
|
+
executor call github issues create '{"owner":"octocat","repo":"Hello-World","title":"Hi"}'
|
|
90
|
+
executor call gmail send '{"to":"alice@example.com","subject":"Hi"}'
|
|
86
91
|
```
|
|
87
92
|
|
|
93
|
+
`executor call`, `executor resume`, and `executor tools ...` commands auto-start a local daemon if needed.
|
|
94
|
+
If the default port is busy, the CLI will pick an available local port and track it automatically.
|
|
95
|
+
|
|
88
96
|
If an execution pauses for auth or approval, resume it:
|
|
89
97
|
|
|
90
98
|
```bash
|
|
@@ -95,11 +103,18 @@ executor resume --execution-id exec_123
|
|
|
95
103
|
|
|
96
104
|
```bash
|
|
97
105
|
executor web # start runtime + web UI
|
|
106
|
+
executor daemon run # run persistent local daemon
|
|
107
|
+
executor daemon status # show daemon status
|
|
108
|
+
executor daemon stop # stop daemon
|
|
109
|
+
executor daemon restart # restart daemon
|
|
98
110
|
executor mcp # start MCP endpoint
|
|
99
|
-
executor call
|
|
100
|
-
executor call
|
|
101
|
-
executor call --
|
|
111
|
+
executor call <path...> '{"k":"v"}' # invoke a tool by path segments
|
|
112
|
+
executor call <path...> --help # browse namespaces/resources/methods
|
|
113
|
+
executor call <path...> --help --match "<text>" --limit <n> # narrow huge namespaces
|
|
102
114
|
executor resume --execution-id <id> # resume paused execution
|
|
115
|
+
executor tools search "<query>" # search tools by intent
|
|
116
|
+
executor tools sources # list configured sources + tool counts
|
|
117
|
+
executor tools describe <path> # show tool TypeScript/JSON schema
|
|
103
118
|
```
|
|
104
119
|
|
|
105
120
|
## Developing locally
|