@rudderhq/agent-runtime-gemini-local 0.3.5-canary.21 → 0.3.5-canary.23

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.
Files changed (3) hide show
  1. package/package.json +2 -2
  2. package/skills/rudder/SKILL.md +1 -1
  3. package/skills/rudder/references/cli-reference.md +2 -1
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rudderhq/agent-runtime-gemini-local",
3
- "version": "0.3.5-canary.21",
3
+ "version": "0.3.5-canary.23",
4
4
  "license": "SEE LICENSE IN LICENSE",
5
5
  "homepage": "https://github.com/Undertone0809/rudder",
6
6
  "bugs": {
@@ -67,7 +67,7 @@
67
67
  "typecheck": "tsc --noEmit"
68
68
  },
69
69
  "dependencies": {
70
- "@rudderhq/agent-runtime-utils": "0.3.5-canary.21",
70
+ "@rudderhq/agent-runtime-utils": "0.3.5-canary.23",
71
71
  "picocolors": "^1.1.1"
72
72
  },
73
73
  "devDependencies": {
package/skills/rudder/SKILL.md CHANGED
@@ -21,7 +21,7 @@ organization-skill operations.
21
21
 
22
22
  ## Control-Plane Interface
23
23
 
24
- - Use `rudder ... --json` for normal control-plane work.
24
+ - Use `rudder ... --json` for normal control-plane work. CLI output renders IDs as short IDs by default; `rudder runs ...` commands accept short run IDs. Add `--full-ids` only for debugging or compatibility checks that need raw UUIDs.
25
25
  - Use `rudder agent capabilities --json` when you need machine-readable discovery of supported commands.
26
26
  - Use `references/cli-reference.md` for the stable command catalog.
27
27
  - Treat `references/api-reference.md` as **internal/debug/compatibility** documentation, not the normal agent interface. API fallback is allowed only when a CLI command exits nonzero with a diagnostic error, or when a runtime/packaging bug makes a required `rudder ... --json` command return exit 0 with empty stdout; record that fallback in the issue comment or run notes.
package/skills/rudder/references/cli-reference.md CHANGED
@@ -5,13 +5,14 @@ Stable CLI contract for agents using the bundled `rudder` skill. Prefer these co
5
5
  ## Defaults
6
6
 
7
7
  - All commands support `--json`.
8
+ - CLI output renders IDs as short IDs by default; `rudder runs ...` commands accept short run IDs. Add `--full-ids` only when a debugging or compatibility workflow needs raw UUIDs.
8
9
  - `--org-id` defaults to `RUDDER_ORG_ID` when relevant.
9
10
  - `--run-id` defaults to `RUDDER_RUN_ID` and is attached to mutating requests when available.
10
11
  - `issue checkout` defaults `--agent-id` from `RUDDER_AGENT_ID`.
11
12
 
12
13
  ## JSON Output Contract
13
14
 
14
- `rudder ... --json` commands must write valid JSON to stdout on success. If a command cannot produce the requested JSON, it must exit nonzero and write a diagnostic error to stderr. An exit-0 command with empty stdout is a CLI/runtime defect, not a valid empty result.
15
+ `rudder ... --json` commands must write valid JSON to stdout on success. ID fields in CLI JSON use short display IDs by default; pass `--full-ids` to preserve raw UUIDs. Short run IDs returned by CLI output can be passed back into `rudder runs get`, `events`, `log`, `transcript`, `errors`, `cancel`, and `retry`. If a command cannot produce the requested JSON, it must exit nonzero and write a diagnostic error to stderr. An exit-0 command with empty stdout is a CLI/runtime defect, not a valid empty result.
15
16
 
16
17
  Direct API fallback is allowed for heartbeat close-out only when a required CLI command fails diagnostically or returns exit 0 with empty stdout. When using fallback, note the affected command and reason in the issue comment or run notes so the CLI path can be fixed.
17
18