@stablebaseline/cli 0.7.1 → 0.9.0
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 +9 -8
- package/dist/sb.js +3 -3
- package/package.json +8 -6
package/README.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
# @stablebaseline/cli
|
|
1
|
+
# @stablebaseline/cli: `sb`
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/@stablebaseline/cli)
|
|
4
4
|
|
|
5
|
-
Command-line client for **[Stable Baseline](https://stablebaseline.io)
|
|
5
|
+
Command-line client for **[Stable Baseline](https://stablebaseline.io)**: the simplest, most complete, end-to-end agent-managed company brain. Drive 219 MCP tools (docs, diagrams, plans, databases, agents, Knowledge Graph, members, billing, settings) from your terminal.
|
|
6
6
|
|
|
7
7
|
## Install
|
|
8
8
|
|
|
@@ -19,7 +19,7 @@ npx @stablebaseline/cli auth login --api-key sta_...
|
|
|
19
19
|
## First-time setup
|
|
20
20
|
|
|
21
21
|
```bash
|
|
22
|
-
#
|
|
22
|
+
# Create a key at app.stablebaseline.io/settings/developers, then:
|
|
23
23
|
sb auth login --api-key sta_xxx
|
|
24
24
|
|
|
25
25
|
sb auth whoami
|
|
@@ -39,12 +39,13 @@ sb tool list # all categories grouped
|
|
|
39
39
|
sb tool list --category=documents # filter by category
|
|
40
40
|
sb tool search "schedule a task" # natural-language search
|
|
41
41
|
|
|
42
|
-
# Call any tool (
|
|
42
|
+
# Call any tool (219 of them)
|
|
43
43
|
sb tool call listOrganisations
|
|
44
44
|
sb tool call createDocument --json '{"folderId":"<uuid>","title":"X","cdmd":"# Hi"}'
|
|
45
45
|
sb tool call kg_search --json '{"query":"compliance posture","mode":"global"}' --pretty
|
|
46
|
+
sb tool call queryDatabaseRows --json '{"databaseId":"DB-12","table":"Deals","summaries":[{"fn":"count"}],"groupBy":["Stage"]}' --pretty
|
|
46
47
|
|
|
47
|
-
# JSON output is the default
|
|
48
|
+
# JSON output is the default: pipe into jq for filtering
|
|
48
49
|
sb tool call listProjects --json '{"workspaceId":"<uuid>"}' | jq '.[].name'
|
|
49
50
|
|
|
50
51
|
# Use a JSON file for big inputs
|
|
@@ -56,7 +57,7 @@ sb tool call insertDiagramInDocument --json-file diagram.json
|
|
|
56
57
|
| Source | How |
|
|
57
58
|
|---|---|
|
|
58
59
|
| **API key** (recommended for scripts/CI) | `sb auth login --api-key sta_...` writes to `~/.config/stablebaseline/auth.json` (0600 perms). |
|
|
59
|
-
| **Env override** | `SB_API_KEY=sta_...` or `SB_ACCESS_TOKEN=...`
|
|
60
|
+
| **Env override** | `SB_API_KEY=sta_...` or `SB_ACCESS_TOKEN=...` wins over the on-disk credential. Useful for CI. |
|
|
60
61
|
| **OAuth (browser)** | `sb auth login` opens the browser. Full PKCE-loopback in CLI v0.2; for now, paste the access token via `SB_ACCESS_TOKEN`. |
|
|
61
62
|
|
|
62
63
|
Forget the credential:
|
|
@@ -73,7 +74,7 @@ By default `sb tool call` prints compact JSON to stdout (machine-friendly). Use
|
|
|
73
74
|
|
|
74
75
|
## What this CLI is (and isn't)
|
|
75
76
|
|
|
76
|
-
It's a **thin formatter on top of the [Stable Baseline REST API](https://api.stablebaseline.io/functions/v1/cloud-serve/api/v1/docs)
|
|
77
|
+
It's a **thin formatter on top of the [Stable Baseline REST API](https://api.stablebaseline.io/functions/v1/cloud-serve/api/v1/docs)**: every command maps to a single REST call against the same handlers the MCP server uses. There is no business logic in this package; if a feature works on the MCP server, it works here on the same day, no CLI release needed.
|
|
77
78
|
|
|
78
79
|
## Companion packages
|
|
79
80
|
|
|
@@ -86,4 +87,4 @@ It's a **thin formatter on top of the [Stable Baseline REST API](https://api.sta
|
|
|
86
87
|
|
|
87
88
|
## License
|
|
88
89
|
|
|
89
|
-
MIT
|
|
90
|
+
MIT, see [LICENSE](../../LICENSE) at the repo root. The Stable Baseline product itself is proprietary SaaS at [stablebaseline.io](https://stablebaseline.io).
|
package/dist/sb.js
CHANGED
|
@@ -90,7 +90,7 @@ var NotAuthenticatedError = class extends Error {
|
|
|
90
90
|
|
|
91
91
|
// src/commands/auth.ts
|
|
92
92
|
var OAUTH_AUTHORIZE_URL = "https://app.stablebaseline.io/oauth/authorize";
|
|
93
|
-
var KEYS_PAGE = "https://app.stablebaseline.io/settings/
|
|
93
|
+
var KEYS_PAGE = "https://app.stablebaseline.io/settings/developers";
|
|
94
94
|
function registerAuthCommands(program) {
|
|
95
95
|
const auth = program.command("auth").description("Sign in / out and inspect the active credential.");
|
|
96
96
|
auth.command("login").description("Sign in. Default uses OAuth in the browser; pass --api-key to skip OAuth.").option("--api-key <key>", "Use an API key (sta_*) directly. Mint at " + KEYS_PAGE).action(async (opts) => {
|
|
@@ -153,7 +153,7 @@ function registerAuthCommands(program) {
|
|
|
153
153
|
import kleur2 from "kleur";
|
|
154
154
|
import { readFile as readFile2 } from "fs/promises";
|
|
155
155
|
function registerToolCommands(program) {
|
|
156
|
-
const tool = program.command("tool").description("Direct tool dispatch
|
|
156
|
+
const tool = program.command("tool").description("Direct tool dispatch: call any Stable Baseline MCP tool.");
|
|
157
157
|
tool.command("list").description("List all tools (catalogue summary).").option("--category <category>", "Filter by category (e.g. documents, plans, knowledge_graph)").option("--json", "Output JSON instead of a table").action(async (opts) => {
|
|
158
158
|
const sdk = await makeSdkClient();
|
|
159
159
|
const { tools } = await sdk.listTools();
|
|
@@ -173,7 +173,7 @@ function registerToolCommands(program) {
|
|
|
173
173
|
console.log(kleur2.bold(kleur2.cyan(cat)) + kleur2.dim(` (${byCategory.get(cat).length})`));
|
|
174
174
|
for (const t of byCategory.get(cat)) {
|
|
175
175
|
const desc = t.description.slice(0, 80) + (t.description.length > 80 ? "\u2026" : "");
|
|
176
|
-
console.log(` ${kleur2.green(t.name)}
|
|
176
|
+
console.log(` ${kleur2.green(t.name)} ${kleur2.dim(desc)}`);
|
|
177
177
|
}
|
|
178
178
|
console.log("");
|
|
179
179
|
}
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@stablebaseline/cli",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"description": "sb
|
|
3
|
+
"version": "0.9.0",
|
|
4
|
+
"description": "sb: command-line client for Stable Baseline. End-to-end agent-managed company brain (docs, diagrams, plans, databases, agents, Knowledge Graph). 219 tools across 20 categories, all exposed at the CLI.",
|
|
5
5
|
"homepage": "https://stablebaseline.io",
|
|
6
6
|
"repository": {
|
|
7
7
|
"type": "git",
|
|
@@ -22,7 +22,9 @@
|
|
|
22
22
|
"documentation",
|
|
23
23
|
"diagrams",
|
|
24
24
|
"plans",
|
|
25
|
-
"ai-agent"
|
|
25
|
+
"ai-agent",
|
|
26
|
+
"databases",
|
|
27
|
+
"agents"
|
|
26
28
|
],
|
|
27
29
|
"type": "module",
|
|
28
30
|
"bin": {
|
|
@@ -42,16 +44,16 @@
|
|
|
42
44
|
"pretest": "npm run build"
|
|
43
45
|
},
|
|
44
46
|
"dependencies": {
|
|
45
|
-
"@stablebaseline/sdk": "^0.
|
|
47
|
+
"@stablebaseline/sdk": "^0.9.0",
|
|
46
48
|
"commander": "^12.1.0",
|
|
47
49
|
"kleur": "^4.1.5",
|
|
48
50
|
"open": "^10.1.0"
|
|
49
51
|
},
|
|
50
52
|
"devDependencies": {
|
|
51
53
|
"tsup": "^8.3.5",
|
|
52
|
-
"tsx": "^4.23.
|
|
54
|
+
"tsx": "^4.23.15",
|
|
53
55
|
"typescript": "^5.6.3",
|
|
54
|
-
"@types/node": "^22.20.
|
|
56
|
+
"@types/node": "^22.20.5",
|
|
55
57
|
"vitest": "^4.1.11"
|
|
56
58
|
},
|
|
57
59
|
"engines": {
|