@copado/agentia-cli 0.43.0-alpha.0 → 0.45.0-alpha.0

package/oclif.manifest.json

@@ -59,6 +59,7 @@
       "description": "Show stored authentication credentials from the system keychain",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --ai",
         "<%= config.bin %> <%= command.id %> --cicd",
         "<%= config.bin %> <%= command.id %> --crt",
         "<%= config.bin %> <%= command.id %> --cicd --crt",
@@ -72,6 +73,12 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "ai": {
+          "description": "Show PAT token for Copado AI authentication",
+          "name": "ai",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "cicd": {
           "description": "Show Copado API key for CICD authentication",
           "name": "cicd",
@@ -106,6 +113,10 @@
       "args": {},
       "description": "Store authentication credentials securely in the system keychain",
       "examples": [
+        "<%= config.bin %> <%= command.id %> --ai <pat-token> --ai-domain robotic.copado.com --ai-org 42888",
+        "<%= config.bin %> <%= command.id %> --ai <pat-token> --ai-domain robotic.copado.com --ai-org 42888 --ai-workspace 42d0b908-37b7-4565-9ec9-86eda40c9782",
+        "<%= config.bin %> <%= command.id %> --ai <pat-token> --ai-gateway-url http://localhost:8080/organizations/42888",
+        "<%= config.bin %> <%= command.id %> --ai-workspace 42d0b908-37b7-4565-9ec9-86eda40c9782",
         "<%= config.bin %> <%= command.id %> --cicd <copado-api-key> --region na",
         "<%= config.bin %> <%= command.id %> --cicd <copado-api-key> --custom-url https://dev.api.copado.com",
         "<%= config.bin %> <%= command.id %> --cicd <copado-api-key>",
@@ -123,6 +134,41 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "ai": {
+          "description": "PAT token for Copado AI authentication",
+          "name": "ai",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ai-domain": {
+          "description": "Copado AI domain hostname used to derive the gateway URL, for example robotic.copado.com",
+          "name": "ai-domain",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ai-gateway-url": {
+          "description": "Full Copado AI gateway base URL used instead of deriving from domain and organization; HTTP is allowed for local testing",
+          "name": "ai-gateway-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ai-org": {
+          "description": "Copado AI organization ID used with --ai-domain",
+          "name": "ai-org",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ai-workspace": {
+          "description": "Copado AI workspace UUID to validate and store as the default",
+          "name": "ai-workspace",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "cicd": {
           "description": "Copado API key for CICD authentication",
           "name": "cicd",
@@ -195,6 +241,7 @@
       "description": "Remove stored authentication credentials from the system keychain",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --ai",
         "<%= config.bin %> <%= command.id %> --cicd",
         "<%= config.bin %> <%= command.id %> --crt",
         "<%= config.bin %> <%= command.id %> --cicd --crt --yes",
@@ -208,6 +255,12 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "ai": {
+          "description": "Remove Copado AI PAT, domain, organization, workspace, and gateway URL configuration",
+          "name": "ai",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "cicd": {
           "description": "Remove Copado API key and CICD endpoint configuration",
           "name": "cicd",
@@ -795,6 +848,305 @@
         "update.js"
       ]
     },
+    "ai:agent:ask": {
+      "aliases": [],
+      "args": {},
+      "description": "Send a single-turn prompt to a Copado AI agent",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --plan -p \"Break this requirement into implementation steps\"",
+        "<%= config.bin %> <%= command.id %> --build -p \"Generate an Apex handler outline\" --sf-org test14 --user-story US-1042",
+        "<%= config.bin %> <%= command.id %> --test -p \"Create regression checks\" --component LeadScoringHandler --json",
+        "<%= config.bin %> <%= command.id %> --operate -p \"Diagnose this deployment error\" --timeout 240"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "build": {
+          "description": "Target the Build agent",
+          "name": "build",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "component": {
+          "description": "Metadata component name to include in prompt context",
+          "name": "component",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dialogue": {
+          "description": "Copado AI dialogue UUID to reuse",
+          "name": "dialogue",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "domain": {
+          "description": "Copado AI domain hostname used to derive the gateway URL, for example robotic.copado.com",
+          "name": "domain",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "gateway-url": {
+          "description": "Full Copado AI gateway base URL used instead of deriving from domain and organization; HTTP is allowed for local testing",
+          "name": "gateway-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-stream": {
+          "description": "Buffer the full response before printing in human mode",
+          "name": "no-stream",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "operate": {
+          "description": "Target the Operate agent",
+          "name": "operate",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "org": {
+          "description": "Copado AI organization ID used with --domain",
+          "name": "org",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "pat": {
+          "description": "Copado AI PAT token override",
+          "name": "pat",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "plan": {
+          "description": "Target the Plan agent",
+          "name": "plan",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "prompt": {
+          "char": "p",
+          "description": "Natural language instruction for the agent",
+          "name": "prompt",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "release": {
+          "description": "Target the Release agent",
+          "name": "release",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "sf-org": {
+          "description": "Salesforce org or environment name to include in prompt context",
+          "name": "sf-org",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "test": {
+          "description": "Target the Test agent",
+          "name": "test",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "AI gateway timeout in seconds for workspace, dialogue, and message calls",
+          "name": "timeout",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "user-story": {
+          "description": "User story identifier to include in prompt context",
+          "name": "user-story",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "work-item": {
+          "description": "Work item identifier to include in prompt context",
+          "name": "work-item",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "workspace": {
+          "description": "Copado AI workspace UUID to reuse for a new dialogue",
+          "name": "workspace",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "ai:agent:ask",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "ai",
+        "agent",
+        "ask.js"
+      ]
+    },
+    "ai:agent:chat": {
+      "aliases": [],
+      "args": {},
+      "description": "Start an interactive Copado AI agent chat session",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --plan --sf-org test14",
+        "<%= config.bin %> <%= command.id %> --build --user-story US-1042 --timeout 240",
+        "<%= config.bin %> <%= command.id %> --orchestrate --workspace 42d0b908-37b7-4565-9ec9-86eda40c9782"
+      ],
+      "flags": {
+        "build": {
+          "description": "Target the Build agent",
+          "name": "build",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "component": {
+          "description": "Metadata component name to include in prompt context",
+          "name": "component",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dialogue": {
+          "description": "Copado AI dialogue UUID to reuse",
+          "name": "dialogue",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "domain": {
+          "description": "Copado AI domain hostname used to derive the gateway URL, for example robotic.copado.com",
+          "name": "domain",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "gateway-url": {
+          "description": "Full Copado AI gateway base URL used instead of deriving from domain and organization; HTTP is allowed for local testing",
+          "name": "gateway-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "operate": {
+          "description": "Target the Operate agent",
+          "name": "operate",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "orchestrate": {
+          "description": "Target the Orchestrate agent",
+          "name": "orchestrate",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "org": {
+          "description": "Copado AI organization ID used with --domain",
+          "name": "org",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "pat": {
+          "description": "Copado AI PAT token override",
+          "name": "pat",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "plan": {
+          "description": "Target the Plan agent",
+          "name": "plan",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "release": {
+          "description": "Target the Release agent",
+          "name": "release",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "sf-org": {
+          "description": "Salesforce org or environment name to include in prompt context",
+          "name": "sf-org",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "test": {
+          "description": "Target the Test agent",
+          "name": "test",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "AI gateway timeout in seconds for workspace, dialogue, and message calls",
+          "name": "timeout",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "user-story": {
+          "description": "User story identifier to include in prompt context",
+          "name": "user-story",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "work-item": {
+          "description": "Work item identifier to include in prompt context",
+          "name": "work-item",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "workspace": {
+          "description": "Copado AI workspace UUID to reuse for a new dialogue",
+          "name": "workspace",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "ai:agent:chat",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "ai",
+        "agent",
+        "chat.js"
+      ]
+    },
     "cicd:environment:create": {
       "aliases": [],
       "args": {
@@ -7144,6 +7496,90 @@
         "list.js"
       ]
     },
+    "cicd:metadata:index:compare": {
+      "aliases": [],
+      "args": {},
+      "description": "Compare metadata between orgs or Git branches",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --comparison-mode BRANCH_COMPARE --pipeline-id <id> --source-org-id <id> --source-credential-id <id> --target-org-id <id>",
+        "<%= config.bin %> <%= command.id %> --comparison-mode INDEX_FILE --filter-type ApexClass --pipeline-id <id> --source-org-id <id> --source-credential-id <id> --target-org-id <id>",
+        "<%= config.bin %> <%= command.id %> --comparison-mode MIX --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "comparison-mode": {
+          "description": "Comparison mode",
+          "name": "comparison-mode",
+          "default": "BRANCH_COMPARE",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "BRANCH_COMPARE",
+            "INDEX_FILE",
+            "MIX"
+          ],
+          "type": "option"
+        },
+        "filter-type": {
+          "description": "Optional metadata type filter, for example ApexClass",
+          "name": "filter-type",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "pipeline-id": {
+          "description": "Pipeline Id",
+          "name": "pipeline-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "source-credential-id": {
+          "description": "Source org credential Id",
+          "name": "source-credential-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "source-org-id": {
+          "description": "Source org Id",
+          "name": "source-org-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-org-id": {
+          "description": "Target org Id",
+          "name": "target-org-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:metadata:index:compare",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "metadata",
+        "index",
+        "compare.js"
+      ]
+    },
     "cicd:metadata:refresh:deleted": {
       "aliases": [],
       "args": {},
@@ -7450,90 +7886,6 @@
         "list.js"
       ]
     },
-    "cicd:metadata:index:compare": {
-      "aliases": [],
-      "args": {},
-      "description": "Compare metadata between orgs or Git branches",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --comparison-mode BRANCH_COMPARE --pipeline-id <id> --source-org-id <id> --source-credential-id <id> --target-org-id <id>",
-        "<%= config.bin %> <%= command.id %> --comparison-mode INDEX_FILE --filter-type ApexClass --pipeline-id <id> --source-org-id <id> --source-credential-id <id> --target-org-id <id>",
-        "<%= config.bin %> <%= command.id %> --comparison-mode MIX --json"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "comparison-mode": {
-          "description": "Comparison mode",
-          "name": "comparison-mode",
-          "default": "BRANCH_COMPARE",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "BRANCH_COMPARE",
-            "INDEX_FILE",
-            "MIX"
-          ],
-          "type": "option"
-        },
-        "filter-type": {
-          "description": "Optional metadata type filter, for example ApexClass",
-          "name": "filter-type",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "pipeline-id": {
-          "description": "Pipeline Id",
-          "name": "pipeline-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "source-credential-id": {
-          "description": "Source org credential Id",
-          "name": "source-credential-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "source-org-id": {
-          "description": "Source org Id",
-          "name": "source-org-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "target-org-id": {
-          "description": "Target org Id",
-          "name": "target-org-id",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "cicd:metadata:index:compare",
-      "pluginAlias": "@copado/agentia-cli",
-      "pluginName": "@copado/agentia-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "cicd",
-        "metadata",
-        "index",
-        "compare.js"
-      ]
-    },
     "cicd:project:default:get": {
       "aliases": [],
       "args": {},
@@ -8103,5 +8455,5 @@
       ]
     }
   },
-  "version": "0.43.0-alpha.0"
+  "version": "0.45.0-alpha.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@copado/agentia-cli",
   "description": "Command-line interface for Agentia",
-  "version": "0.43.0-alpha.0",
+  "version": "0.45.0-alpha.0",
   "author": "Copado Solutions",
   "bin": {
     "agentia": "./bin/run.js"
@@ -60,6 +60,12 @@
     ],
     "topicSeparator": " ",
     "topics": {
+      "ai": {
+        "description": "Use Copado AI agents"
+      },
+      "ai:agent": {
+        "description": "Prompt and chat with Copado AI agents"
+      },
       "auth": {
         "description": "Manage authentication credentials"
       },