@copado/agentia-cli 0.108.0-alpha.0 → 0.110.0-alpha.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@copado/agentia-cli",
   "description": "Command-line interface for Agentia",
-  "version": "0.108.0-alpha.0",
+  "version": "0.110.0-alpha.0",
   "author": "Copado Solutions",
   "bin": {
     "agentia": "./bin/run.js"
@@ -14,7 +14,11 @@
     "@oclif/core": "^4",
     "@oclif/plugin-help": "^6",
     "@oclif/plugin-plugins": "^5",
+    "@resvg/resvg-js": "^2.6.2",
     "@xmldom/xmldom": "^0.9.12",
+    "beautiful-mermaid": "^1.1.3",
+    "ink": "5.2.1",
+    "react": "18.3.1",
     "semver": "^7.8.5",
     "tty-table": "^5.0.0",
     "uuid": "^14.0.1",
@@ -27,11 +31,13 @@
     "@types/chai": "^4",
     "@types/mocha": "^10",
     "@types/node": "^18",
+    "@types/react": "18.3.18",
     "@types/semver": "^7.8.0",
     "chai": "^4",
     "eslint": "^9",
     "eslint-config-oclif": "^6",
     "eslint-config-prettier": "^10",
+    "ink-testing-library": "4.0.0",
     "mocha": "^11",
     "oclif": "^4",
     "shx": "^0.3.3",
@@ -83,6 +89,9 @@
       "ai:quota": {
         "description": "Inspect Copado AI quota"
       },
+      "ai:session": {
+        "description": "List and resume Copado AI dialogue sessions"
+      },
       "ai:workspace": {
         "description": "Manage Copado AI workspaces"
       },

package/templates/skills/agentia-ai/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: agentia-ai
-description: Use this skill when prompting Copado AI agents through the Agentia CLI or MCP, including `agentia ai agent ask`, `agentia ai agent chat`, Plan, Build, Test, Release, Operate, Knowledge, workspace, dialogue, user story, Salesforce org, and component context.
+description: Use this skill when prompting Copado AI agents through the Agentia CLI or MCP, including `agentia ai agent ask`, `agentia ai agent chat`, `agentia ai session list`, `agentia ai session start`, Plan, Build, Test, Release, Operate, Knowledge, workspace, dialogue, user story, Salesforce org, and component context.
 ---
 
 <!-- Agentia managed skill file: agentia setup skills -->
@@ -9,14 +9,14 @@ description: Use this skill when prompting Copado AI agents through the Agentia
 
 Use this skill to ask Copado AI agents through Agentia with the right agent selector, workspace context, and output mode.
 
-Prefer the `agentia_ai_ask` MCP tool when it is available for single-turn prompts. Use CLI examples as the fallback. Use `agentia ai agent chat` only for interactive terminal sessions.
+Prefer the `agentia_ai_ask` MCP tool when it is available for single-turn prompts. Use CLI examples as the fallback. Use `agentia ai session start` for the interactive Ink session UI, or `agentia ai agent chat` for the readline chat loop. List prior Context Hub dialogues with `agentia ai session list`.
 
 ## Start Here
 
 1. Confirm AI auth with `agentia auth get --ai --json`. Configure missing credentials with `agentia auth set --ai ...` or the supported `AGENTIA_AI_*` environment variables.
-2. Choose exactly one agent selector for `ask`: `--plan`, `--build`, `--test`, `--release`, `--operate`, or `--knowledge`.
-3. Add useful context flags when available: `--workspace`, `--dialogue`, `--user-story`, `--sf-org`, and `--component`.
-4. Use `--json` for automation. Use `--no-stream` when the caller needs a buffered response.
+2. Choose exactly one agent selector for `ask`: `--plan`, `--build`, `--test`, `--release`, `--operate`, or `--knowledge`. `session start` uses `--agent plan|build|test|release|operate|knowledge|orchestrate` and defaults to Orchestrate.
+3. Add useful context flags when available: `--workspace` (overrides the authenticated workspace), `--dialogue`, `--user-story`, `--sf-org`, and `--component`.
+4. Use `--json` for automation. Use `--no-stream` when the caller needs a buffered response. List dialogues with `agentia ai session list`.
 
 ## Reference
 

package/templates/skills/agentia-ai/references/ai-agents.md

@@ -2,7 +2,7 @@
 
 # AI Agents Reference
 
-Use this reference for `agentia ai agent ask`, `agentia ai agent chat`, and the matching `agentia_ai_ask` MCP tool.
+Use this reference for `agentia ai agent ask`, `agentia ai agent chat`, `agentia ai session list`, `agentia ai session start`, and the matching `agentia_ai_ask` MCP tool.
 
 ## Authentication And Context
 
@@ -52,6 +52,20 @@ agentia ai agent chat --orchestrate --workspace <workspace-id>
 
 Chat creates or reuses one dialogue for the session and supports session slash commands. It is not suitable for headless JSON workflows.
 
+## Sessions
+
+Prefer `session list` and `session start` for human terminal use. A session is a Copado GPT Gateway dialogue (Context Hub). `--dialogue` is that UUID, same flag as `ask` / `chat`.
+
+```sh
+agentia ai session list
+agentia ai session list --page-size 15 --workspace <workspace-id> --json
+agentia ai session start
+agentia ai session start --dialogue <dialogue-uuid>
+agentia ai session start --agent build --user-story US-1042
+```
+
+`session list` defaults to 15 rows (max 200) from `GET /dialogues`, newest first. `session start` is TTY-only and opens an Ink session UI (header, wrapping scrolling transcript, sticky composer, syntax-colored fences, Mermaid diagrams as filled flowchart chips (diamond / stadium / rectangle), or a pixel PNG in Kitty). Type `/` for command autocomplete (Tab completes, Enter runs, Esc dismisses). Esc cancels an in-flight turn. `/clear` wipes the local transcript; `/new` starts a new dialogue after confirm; `/copy` copies the last fenced block without `│` gutters. Drag-select still copies the screen (mouse tracking is off so the terminal can select). ←/→ move the composer cursor; ↑/↓ scroll the transcript; PgUp/PgDn (Fn+↑ / Fn+↓ on a Mac) recall previous prompts. After a reply, numbered Follow-ups can be sent with 1–5 on an empty prompt. The terminal scrollbar is not the history. Without `--dialogue` it shows a CopadoContextHub welcome; `/session` (or Resume) opens an overlay picker. Agent slash commands stay on the current dialogue: `/plan`, `/build`, `/test`, `/release`, `/operate`, `/knowledge`, `/orchestrate`, plus `/help`, `/copy`, `/clear`, `/exit`. Esc or `/cancel` dismisses the overlay. `ai agent chat` still uses the readline loop. There is no MCP tool for list or start.
+
 ## Workspace And Quota Helpers
 
 Use these adjacent commands when the prompt workflow needs context setup:
@@ -64,7 +78,8 @@ Use these adjacent commands when the prompt workflow needs context setup:
 
 ## Gotchas
 
-- `--workspace` selects the workspace; `--dialogue` reuses a conversation inside that workspace.
-- `--user-story`, `--sf-org`, and `--component` enrich prompt context but do not replace a clear prompt.
+- `--workspace` on `session start` overrides the workspace stored by `auth set --ai-workspace` or `AGENTIA_AI_WORKSPACE`; omit it to use that default. `--dialogue` resumes a conversation, same flag as `ask`/`chat`.
+- `--user-story`, `--sf-org`, and `--component` prepend labeled context to the first prompt so you do not have to paste those ids by hand. They do not fetch Copado records.
 - Streaming is human-friendly. For tools, CI, or follow-up parsing, use `--json` and consider `--no-stream`.
 - `chat` has no MCP equivalent and should not be used in non-interactive shells.
+- `session start` also has no MCP equivalent. Use `session list --json` to inspect dialogue IDs from scripts.