@cargo-ai/cli 1.0.54 → 1.0.55
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/build/agentSkills.d.ts +34 -0
- package/build/agentSkills.d.ts.map +1 -0
- package/build/agentSkills.js +37 -0
- package/build/commands/auth/email.d.ts.map +1 -1
- package/build/commands/auth/email.js +2 -0
- package/build/commands/auth/index.d.ts.map +1 -1
- package/build/commands/auth/index.js +3 -0
- package/build/index.js +4 -6
- package/package.json +2 -2
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Where this CLI tells a coding agent that the skill bundles exist.
|
|
3
|
+
*
|
|
4
|
+
* WHY THIS IS ITS OWN MODULE. The pointer used to live as a const inside
|
|
5
|
+
* `index.ts`, reachable only from `--help` and from the footer of an
|
|
6
|
+
* unknown-subcommand error. Both are paths an agent takes while it is still
|
|
7
|
+
* *exploring*. The moment someone has decided to use Cargo, and the only moment
|
|
8
|
+
* we know for certain a human or agent is watching, is the line right after
|
|
9
|
+
* sign-in succeeds, and that line said nothing.
|
|
10
|
+
*
|
|
11
|
+
* That gap is measurable and it is large: `@cargo-ai/cli` runs at roughly 1,900
|
|
12
|
+
* npm downloads a week while `getcargohq/cargo-skills` gains on the order of 35
|
|
13
|
+
* installs a week. People are already running this binary and almost none of
|
|
14
|
+
* them install the skills that make it usable by an agent.
|
|
15
|
+
*
|
|
16
|
+
* Keep the strings here rather than at each call site, so a change to how the
|
|
17
|
+
* bundles are named or installed cannot land in `--help` and miss sign-in.
|
|
18
|
+
*/
|
|
19
|
+
/** One line, for a footer where vertical space is somebody else's error. */
|
|
20
|
+
export declare const AGENT_SKILLS_HINT = "Coding agents: install the Cargo skills with `npx skills add getcargohq/cargo-skills`";
|
|
21
|
+
/**
|
|
22
|
+
* Printed after a successful sign-in.
|
|
23
|
+
*
|
|
24
|
+
* Deliberately two lines and no more. A sign-in banner that scrolls is a banner
|
|
25
|
+
* people configure away, and this fires at most a handful of times per machine
|
|
26
|
+
* because signing in is rare, so it does not need a suppression flag to be
|
|
27
|
+
* polite.
|
|
28
|
+
*
|
|
29
|
+
* No skill count. The help epilogue carried "sixteen skills" while the bundle
|
|
30
|
+
* held seventeen: a hand-maintained number in prose goes stale the next time
|
|
31
|
+
* somebody adds one, and nothing in CI was ever going to catch it here.
|
|
32
|
+
*/
|
|
33
|
+
export declare const AGENT_SKILLS_NEXT_STEP: string;
|
|
34
|
+
//# sourceMappingURL=agentSkills.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"agentSkills.d.ts","sourceRoot":"","sources":["../src/agentSkills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,0FAC2D,CAAC;AAE1F;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,QAIvB,CAAC"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Where this CLI tells a coding agent that the skill bundles exist.
|
|
3
|
+
*
|
|
4
|
+
* WHY THIS IS ITS OWN MODULE. The pointer used to live as a const inside
|
|
5
|
+
* `index.ts`, reachable only from `--help` and from the footer of an
|
|
6
|
+
* unknown-subcommand error. Both are paths an agent takes while it is still
|
|
7
|
+
* *exploring*. The moment someone has decided to use Cargo, and the only moment
|
|
8
|
+
* we know for certain a human or agent is watching, is the line right after
|
|
9
|
+
* sign-in succeeds, and that line said nothing.
|
|
10
|
+
*
|
|
11
|
+
* That gap is measurable and it is large: `@cargo-ai/cli` runs at roughly 1,900
|
|
12
|
+
* npm downloads a week while `getcargohq/cargo-skills` gains on the order of 35
|
|
13
|
+
* installs a week. People are already running this binary and almost none of
|
|
14
|
+
* them install the skills that make it usable by an agent.
|
|
15
|
+
*
|
|
16
|
+
* Keep the strings here rather than at each call site, so a change to how the
|
|
17
|
+
* bundles are named or installed cannot land in `--help` and miss sign-in.
|
|
18
|
+
*/
|
|
19
|
+
/** One line, for a footer where vertical space is somebody else's error. */
|
|
20
|
+
export const AGENT_SKILLS_HINT = "Coding agents: install the Cargo skills with `npx skills add getcargohq/cargo-skills`";
|
|
21
|
+
/**
|
|
22
|
+
* Printed after a successful sign-in.
|
|
23
|
+
*
|
|
24
|
+
* Deliberately two lines and no more. A sign-in banner that scrolls is a banner
|
|
25
|
+
* people configure away, and this fires at most a handful of times per machine
|
|
26
|
+
* because signing in is rare, so it does not need a suppression flag to be
|
|
27
|
+
* polite.
|
|
28
|
+
*
|
|
29
|
+
* No skill count. The help epilogue carried "sixteen skills" while the bundle
|
|
30
|
+
* held seventeen: a hand-maintained number in prose goes stale the next time
|
|
31
|
+
* somebody adds one, and nothing in CI was ever going to catch it here.
|
|
32
|
+
*/
|
|
33
|
+
export const AGENT_SKILLS_NEXT_STEP = [
|
|
34
|
+
"Next: teach your coding agent this CLI.",
|
|
35
|
+
" npx skills add getcargohq/cargo-skills every command, as agent skills",
|
|
36
|
+
" npx skills add getcargohq/gtm-skills standalone one-job GTM skills",
|
|
37
|
+
].join("\n");
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/email.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/email.ts"],"names":[],"mappings":"AAcA,6EAA6E;AAC7E,eAAO,MAAM,UAAU,MAAM,CAAC;AAE9B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8C1E"}
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { AGENT_SKILLS_NEXT_STEP } from "../../agentSkills.js";
|
|
1
2
|
import { getCredentialsPath } from "../../credentials.js";
|
|
2
3
|
import { askQuestion, openPromptInput } from "../../utils/prompt.js";
|
|
3
4
|
import { ExitCodes, failWith, info, outputJson, startSpinner, success, } from "../runHandler.js";
|
|
@@ -38,6 +39,7 @@ export async function runEmailLogin(opts) {
|
|
|
38
39
|
workspaceName: opts.workspaceName,
|
|
39
40
|
});
|
|
40
41
|
success(`Signed in as ${email}. Workspace: ${workspace.name}.`);
|
|
42
|
+
info(AGENT_SKILLS_NEXT_STEP);
|
|
41
43
|
outputJson({
|
|
42
44
|
ok: true,
|
|
43
45
|
status: "signedIn",
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,WAAW,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/auth/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,WAAW,CAAC;AAGjD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAwBxD,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,GAAG,GAChB,IAAI,CAkGN;AAmFD,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,WAAW,GAAG,SAAS,EACpC,IAAI,EAAE,aAAa,GAClB,cAAc,CAchB"}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { revokeSession } from "@cargo-ai/cdk/cli";
|
|
2
2
|
import { Option } from "commander";
|
|
3
|
+
import { AGENT_SKILLS_NEXT_STEP } from "../../agentSkills.js";
|
|
3
4
|
import { getConfig } from "../../config.js";
|
|
4
5
|
import { clearCredentials, getCredentialsPath, loadCredentials, saveCredentials, } from "../../credentials.js";
|
|
5
6
|
import { ExitCodes, failWith, handleApiCall, info, outputJson, success, } from "../runHandler.js";
|
|
@@ -89,6 +90,7 @@ async function runLogin(opts) {
|
|
|
89
90
|
baseUrl: opts.baseUrl,
|
|
90
91
|
});
|
|
91
92
|
success("Signed in with API token.");
|
|
93
|
+
info(AGENT_SKILLS_NEXT_STEP);
|
|
92
94
|
outputJson({
|
|
93
95
|
ok: true,
|
|
94
96
|
status: "signedIn",
|
|
@@ -107,6 +109,7 @@ async function runLogin(opts) {
|
|
|
107
109
|
workspaceName: opts.workspaceName,
|
|
108
110
|
});
|
|
109
111
|
success(`Signed in. Default workspace: ${workspace.name}.`);
|
|
112
|
+
info(AGENT_SKILLS_NEXT_STEP);
|
|
110
113
|
outputJson({
|
|
111
114
|
ok: true,
|
|
112
115
|
status: "signedIn",
|
package/build/index.js
CHANGED
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
import { createRequire } from "node:module";
|
|
3
3
|
import { registerCommands as registerCdkCommands, registerManifestCommands, SessionExpiredError, } from "@cargo-ai/cdk/cli";
|
|
4
4
|
import { Command } from "commander";
|
|
5
|
+
import { AGENT_SKILLS_HINT } from "./agentSkills.js";
|
|
5
6
|
import { createApi } from "./api.js";
|
|
6
7
|
import { registerAiCommands } from "./commands/ai/index.js";
|
|
7
8
|
import { registerAuthCommands } from "./commands/auth/index.js";
|
|
@@ -29,11 +30,6 @@ import { maybeNotifyUpdate } from "./updateNotifier.js";
|
|
|
29
30
|
const require = createRequire(import.meta.url);
|
|
30
31
|
const { version } = require("../package.json");
|
|
31
32
|
const program = new Command();
|
|
32
|
-
// Coding agents meet this CLI cold and explore it by running `--help` or by
|
|
33
|
-
// guessing a subcommand and reading the error. Both paths are the only chance to
|
|
34
|
-
// tell them the skill bundle exists, so the pointer lives in the help epilogue
|
|
35
|
-
// and in the error footer rather than in a command they would have to know to run.
|
|
36
|
-
const AGENT_SKILLS_HINT = "Coding agents: install the Cargo skills with `npx skills add getcargohq/cargo-skills`";
|
|
37
33
|
program
|
|
38
34
|
.name("cargo-ai")
|
|
39
35
|
.description("Cargo API CLI")
|
|
@@ -41,12 +37,14 @@ program
|
|
|
41
37
|
.showHelpAfterError(`${AGENT_SKILLS_HINT}\nRun "cargo-ai --help" for the full command list.`)
|
|
42
38
|
.addHelpText("after", `
|
|
43
39
|
Agent skills:
|
|
44
|
-
Teach your coding agent this CLI —
|
|
40
|
+
Teach your coding agent this CLI — skills covering sourcing, enrichment,
|
|
45
41
|
orchestration, storage, connectors, workspace-as-code (CDK), diagnostics and alerts.
|
|
46
42
|
Any agent (skills.sh): npx skills add getcargohq/cargo-skills
|
|
47
43
|
Claude Code: /plugin marketplace add getcargohq/cargo-skills
|
|
48
44
|
Codex: codex plugin marketplace add getcargohq/cargo-skills
|
|
49
45
|
Source: https://github.com/getcargohq/cargo-skills
|
|
46
|
+
Standalone one-job GTM skills (find leads, work emails, TAM, signals):
|
|
47
|
+
Any agent (skills.sh): npx skills add getcargohq/gtm-skills
|
|
50
48
|
|
|
51
49
|
Authentication:
|
|
52
50
|
Emailed code: cargo-ai login --email you@company.com (no browser; signs you up on first use)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@cargo-ai/cli",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.55",
|
|
4
4
|
"private": false,
|
|
5
5
|
"license": "UNLICENSED",
|
|
6
6
|
"homepage": "https://getcargo.ai",
|
|
@@ -61,7 +61,7 @@
|
|
|
61
61
|
"dependencies": {
|
|
62
62
|
"@cargo-ai/api": "^1.0.60",
|
|
63
63
|
"@cargo-ai/app-sdk": "^1.0.6",
|
|
64
|
-
"@cargo-ai/cdk": "^1.0.
|
|
64
|
+
"@cargo-ai/cdk": "^1.0.45",
|
|
65
65
|
"@cargo-ai/types": "^1.0.57",
|
|
66
66
|
"@cargo-ai/worker-sdk": "^1.0.12",
|
|
67
67
|
"@modelcontextprotocol/sdk": "1.29.0",
|