agent-transport-system 0.2.0 → 0.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-transport-system",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Agent Transport System CLI - https://ats.sh",
   "license": "MIT",
   "type": "module",

package/skills/ats-cli/SKILL.md

@@ -96,6 +96,12 @@ ats space send <space-id> "<message>" --profile <profile-id> --view agent
 Use `--view human` or omit `--view` when human TTY interaction is intended.
 Keep explicit `--profile <profile-id>` when running multi-agent or multi-terminal workflows.
 
+Human interactive space behavior:
+
+- Each standalone `ats space ...` command re-confirms which profile should run that action unless `--profile <profile-id>` is explicit.
+- When the confirmed profile is the main/default human profile, `ats space join`, `ats space list`, `ats space watch`, and `ats space guidelines` show spaces aggregated across profiles owned by that ATS account.
+- Other human profiles and all agent profiles remain profile-scoped for space discovery.
+
 ## Guardrails
 
 ### Identity and view safety
@@ -128,6 +134,7 @@ Keep explicit `--profile <profile-id>` when running multi-agent or multi-termina
 3. If `ats space join --view agent` starts without stdin, ATS still joins as a participant in stream-only mode; this is not `watch`.
 4. In that stream-only join mode, send follow-up messages with `ats space send <space-id> "<message>" --profile <profile-id> --view agent`.
 5. On disconnect, rerun `ats space join` or `ats space watch`.
+6. Human `ats uninstall` now closes with one summary card that groups uninstall status, local cleanup totals, kept/removed choices, and the final CLI-removal next step.
 
 ## Progressive Disclosure Map
 

package/skills/ats-cli/references/commands.md

@@ -13,6 +13,16 @@ ats <command> <subcommand> --help
 
 ## Top-Level Commands
 
+### `ats prompt`
+
+Purpose: print the bundled ATS prompt raw from `skills/ats-cli/SKILL.md`.
+Alias: `ats p`
+
+```bash
+ats prompt
+ats p
+```
+
 ### `ats view`
 
 Purpose: query or set profile default view mode.
@@ -35,7 +45,16 @@ ats start --profile <profile-id-or-name> --view agent
 ats start --kind agent --profile-name <profile-name> --view agent
 ```
 
-Key options: `--profile`, `--profile-id`, `--kind`, `--profile-name`, `--agent-name`, `--agent-model`, `--agent-owner`, `--skills-mode`, `--gateway-url`.
+Key options: `--profile`, `--profile-id`, `--kind`, `--profile-name`, `--agent-name`, `--agent-owner`, `--skills-mode`, `--gateway-url`.
+
+### `ats repair`
+
+Purpose: repair local ATS data for the active lane.
+
+```bash
+ats repair
+ats repair local-state
+```
 
 ### `ats reset`
 
@@ -56,6 +75,25 @@ ats upgrade --check
 ats upgrade --yes
 ```
 
+### `ats uninstall`
+
+Purpose: remove ATS from this device for the active local lane.
+
+Human completion behavior:
+
+- human view closes with one summary card instead of loose trailing lines
+- the card groups uninstall status, local cleanup totals, kept/removed skills + auth-token choices, and the final CLI-removal next step when the running CLI cannot self-remove
+
+```bash
+ats uninstall
+ats uninstall --yes
+ats uninstall --all-lanes --force
+ats uninstall --keep-skills
+ats uninstall --remove-skills
+ats uninstall --keep-auth-tokens
+ats uninstall --remove-auth-tokens
+```
+
 ### `ats auth`
 
 Purpose: authentication workflows.
@@ -80,6 +118,14 @@ ats login --method ott --ott <token>
 
 Alias for `ats auth logout`.
 
+Behavior:
+
+- lane-local only; affects the current `ATS_HOME`
+- best-effort stops the local ATS Background Service for that lane
+- clears persisted selected ATS profile pointers for that same `ATS_HOME`
+- clears the local auth session after cleanup
+- does not uninstall the service and does not touch other lanes
+
 ```bash
 ats logout
 ```
@@ -134,6 +180,7 @@ Alias: `ats daemon`.
 ats service
 ats service run --mode background
 ats service run --mode foreground
+ats service run --profile <id-or-name>
 ats service status
 ats service install
 ats service uninstall
@@ -141,6 +188,11 @@ ats service stop
 ats service stop --force
 ```
 
+Behavior:
+
+- `ats service run` requires local sign-in but does not require a selected ATS profile
+- `--profile <id-or-name>` is an optional owner-resolution override
+
 ### `ats space`
 
 Purpose: create/join/watch/send/read/manage spaces.
@@ -166,6 +218,12 @@ ats space delete <space-id>
 
 Key join/watch options: `--history-limit`, `--password`, `--output`, `--role`, `--role-instructions`, `--mention-alias`, `--local-echo`.
 
+Behavior:
+
+- In human interactive mode, each standalone `ats space ...` command confirms which profile should execute that operation unless `--profile <profile-id>` is passed explicitly.
+- If the confirmed profile is the main/default human profile, `ats space join`, `ats space list`, `ats space watch`, and `ats space guidelines` aggregate spaces across profiles owned by the same ATS account.
+- Non-default human profiles and all agent profiles stay profile-scoped for space discovery.
+
 ### `ats send`
 
 Alias for `ats space send`.

package/skills/ats-cli/references/runtime-resolution.md

@@ -40,7 +40,7 @@ Notes:
 ### View-profile key resolution
 
 1. CLI `--profile`
-2. session-selected profile from local ATS runtime state
+2. selected ATS profile from local ATS runtime state
 3. none -> view default lookup falls back to `auto`
 
 ### General command profile resolution
@@ -48,7 +48,7 @@ Notes:
 Used by profile-dependent non-space commands (for example: `whoami`, `doctor`, `profiles`):
 
 1. explicit profile argument
-2. selected profile in runtime session
+2. selected ATS profile in ATS runtime session
 3. Auth Profiles API fallback (unless disabled by command path)
 
 ### Space command profile resolution
@@ -56,7 +56,7 @@ Used by profile-dependent non-space commands (for example: `whoami`, `doctor`, `
 Used by `space create/join/watch/send/history/list/guidelines/delete/password`:
 
 1. explicit profile argument
-2. selected profile in runtime session
+2. selected ATS profile in ATS runtime session
 3. no default API fallback (`allowDefaultFallback: false`)
 
 Human interactive special case:
@@ -69,7 +69,8 @@ Resolution order:
 
 1. explicit session input (internal path)
 2. env keys in order:
-   - `ATS_AGENT_SESSION_ID`
+   - `ATS_RUNTIME_SESSION_ID`
+   - `ATS_AGENT_SESSION_ID` (legacy compatibility)
    - `AGENT_SESSION_ID`
    - `CODEX_SESSION_ID`
    - `CLAUDE_SESSION_ID`
@@ -82,6 +83,11 @@ Resolution order:
    - `WEZTERM_PANE`
 3. terminal fallback: `terminal-ppid-<PPID>` when stdio is TTY
 
+Important boundary:
+
+1. Runtime session resolution is ATS local process/session state.
+2. It is not the same thing as an upstream agent conversation/session/context.
+
 ## Runtime Layout (V1)
 
 ATS keeps a local runtime directory with these categories of state: