@corvio/cli 0.1.0-beta.6 → 0.1.0-beta.7

package/dist/cli.js

@@ -35,7 +35,7 @@ import {
   writeTextFile,
 } from "./core.js";
 
-const VERSION = "0.1.0-beta.6";
+const VERSION = "0.1.0-beta.7";
 const DEFAULT_API_BASE = "https://api.corvio.ai/v1";
 const DEFAULT_APP_BASE = "https://corvio.ai";
 const USER_AGENT = `corvio-cli/${VERSION}`;
@@ -64,6 +64,7 @@ const COMMAND_OPTIONS = Object.freeze({
   "capabilities:": [],
   "ask:": ["prompt", "conversation-id", "sources", "allow-actions", "context-file", "idempotency-key"],
   "agents:list": ["include-revoked"],
+  "agents:connect": ["handle", "avatar-url", "provider", "permissions"],
   "agents:create": ["handle", "display-name", "avatar-url", "provider", "permissions"],
   "agents:update": ["id", "display-name", "avatar-url", "status", "permissions"],
   "agents:rotate": ["id"],
@@ -112,7 +113,7 @@ Usage:
   corvio workspaces list|use|current|create [id]
   corvio capabilities
   corvio ask --prompt <text> [--conversation-id <id>] [--allow-actions]
-  corvio agents list|create|update|rotate [id]
+  corvio agents list|connect|create|update|rotate [id]
   corvio agent claim|renew|complete|fail|comments|comment|reply|status|run [id]
   corvio questions list|get [id]
   corvio conversations list|get [id]
@@ -139,7 +140,7 @@ const COMMAND_HELP = Object.freeze({
   workspaces: `Usage:\n  corvio workspaces list\n  corvio workspaces use <workspace-id>\n  corvio workspaces current\n  corvio workspaces create --name <name> [--kind personal|team]\n\nWorkspace status and blocked capability reasons are returned with each item.`,
   capabilities: `Usage: corvio capabilities [--json]\n\nShow live API resources, principal scopes, selected Workspace status, and CLI compatibility.`,
   ask: `Usage: corvio ask --prompt <text> [--conversation-id <id>] [--sources workspace,web,memory] [--allow-actions] [--context-file <json>] [--idempotency-key <key>]`,
-  agents: `Usage:\n  corvio agents list\n  corvio agents create --handle <handle> --display-name <name> [--provider codex|claude_code|custom] [--permissions read,comment,edit]\n  corvio agents update <id> [--display-name <name>] [--status active|paused|revoked] [--permissions <list>]\n  corvio agents rotate <id>\n\nAgent creation and rotation print the cvg_ secret once.`,
+  agents: `Usage:\n  corvio agents list\n  corvio agents connect --handle <handle> [--provider codex|claude_code|custom] [--permissions read,comment,edit]\n  corvio agents create --handle <handle> --display-name <name> [--provider codex|claude_code|custom] [--permissions read,comment,edit]\n  corvio agents update <id> [--display-name <name>] [--status active|paused|revoked] [--permissions <list>]\n  corvio agents rotate <id>\n\n'connect' explicitly creates a separate cvg_ Agent principal after user authentication and leaves naming pending in Workspace. It never converts the human cvu_ login into an Agent. Creation and rotation print the cvg_ secret once.`,
   agent: `Usage:\n  corvio agent claim [--worker-id <id>] [--wait-seconds <0-30>]\n  corvio agent renew <event-id> --lease-token <token> [--lease-seconds <30-900>]\n  corvio agent complete <event-id> --lease-token <token> [--result-file <json>]\n  corvio agent fail <event-id> --lease-token <token> --error <message>\n  corvio agent comments --document-id <id>\n  corvio agent comment --document-id <id> --body <text> [--selection-file <json>]\n  corvio agent reply <thread-id> --document-id <id> --body <text>\n  corvio agent status <thread-id> --document-id <id> --status open|resolved\n  corvio agent run --handler <executable> [--once]\n\nThe runner leases durable events and renews its lease while work is active. The handler reads event JSON from stdin and returns {"instruction":"...","reply":"..."}; Corvio Query owns document changes and returns the durable receipt.`,
   questions: `Usage:\n  corvio questions list [--limit <n>] [--cursor <cursor>] [--conversation-id <id>]\n  corvio questions get <question-id>`,
   conversations: `Usage:\n  corvio conversations list [--limit <n>] [--cursor <cursor>]\n  corvio conversations get <conversation-id>`,
@@ -550,6 +551,17 @@ async function agents(options, action, id) {
   let result;
   if (action === "list") {
     result = await api.request("/agents", { query: { include_revoked: options["include-revoked"] || undefined } });
+  } else if (action === "connect") {
+    result = await api.request("/agents", {
+      method: "POST",
+      body: {
+        handle: option(options, "handle", { required: true }),
+        avatar_url: options["avatar-url"] || null,
+        provider: options.provider || "custom",
+        permissions: listOption(options, "permissions", ["read", "comment"]),
+        pending_naming: true,
+      },
+    });
   } else if (action === "create") {
     result = await api.request("/agents", {
       method: "POST",
@@ -574,7 +586,7 @@ async function agents(options, action, id) {
     const agentId = id || option(options, "id", { required: true });
     result = await api.request(`/agents/${resourcePath(agentId)}/credentials:rotate`, { method: "POST" });
   } else {
-    throw new CliError("agents action must be list, create, update, or rotate.");
+    throw new CliError("agents action must be list, connect, create, update, or rotate.");
   }
   writeResult(result, { json: options.json });
 }
@@ -712,10 +724,12 @@ async function processClaimedAgentEvent(api, event, options) {
     let commentEntryId = null;
     if (documentId && threadId) {
       const reply = String(decision.reply || question.answer || "Completed the requested review.").trim().slice(0, 12_000);
+      const mentionTargets = await resolveAgentMentionTargets(api, documentId, reply);
       const thread = await api.request(`/documents/${resourcePath(documentId)}/comments/${resourcePath(threadId)}/replies`, {
         method: "POST",
         body: {
           body: reply,
+          mention_targets: mentionTargets,
           entry_point: "external_agent_runner",
           source_event_id: event.id,
           source_event_lease_token: leaseToken,
@@ -773,6 +787,24 @@ async function runAgent(options) {
   }
 }
 
+async function resolveAgentMentionTargets(api, documentId, body) {
+  const aliases = Array.from(String(body || "").matchAll(/(?:^|\s)@([a-z0-9][a-z0-9._-]{0,63})/gi))
+    .map((match) => String(match[1] || "").toLowerCase());
+  if (!aliases.length) return [];
+  const response = await api.request(`/documents/${resourcePath(documentId)}/mention-candidates`);
+  const byHandle = new Map((Array.isArray(response?.data) ? response.data : []).map((candidate) => [
+    String(candidate.handle || "").toLowerCase(),
+    candidate,
+  ]));
+  const seen = new Set();
+  return aliases.flatMap((alias) => {
+    const candidate = byHandle.get(alias);
+    if (!candidate?.id || seen.has(candidate.id)) return [];
+    seen.add(candidate.id);
+    return [{ kind: "agent", principal_id: candidate.id, alias: candidate.handle }];
+  });
+}
+
 async function agentCommand(options, action, id) {
   if (action === "run") return runAgent(options);
   const api = agentClient(options);
@@ -815,13 +847,16 @@ async function agentCommand(options, action, id) {
   } else if (action === "comments") {
     result = await api.request(`/documents/${resourcePath(option(options, "document-id", { required: true }))}/comments`);
   } else if (action === "comment") {
+    const documentId = option(options, "document-id", { required: true });
+    const body = option(options, "body", { required: true });
     const selection = options["selection-file"]
       ? await readJsonObject(options["selection-file"], "--selection-file")
       : { target_scope: "document" };
-    result = await api.request(`/documents/${resourcePath(option(options, "document-id", { required: true }))}/comments`, {
+    result = await api.request(`/documents/${resourcePath(documentId)}/comments`, {
       method: "POST",
       body: {
-        body: option(options, "body", { required: true }),
+        body,
+        mention_targets: await resolveAgentMentionTargets(api, documentId, body),
         selection,
         entry_point: "external_agent_cli",
         start_new_chain: Boolean(options["start-new-chain"]),
@@ -829,6 +864,8 @@ async function agentCommand(options, action, id) {
     });
   } else if (action === "reply") {
     const threadId = id || option(options, "id", { required: true });
+    const documentId = option(options, "document-id", { required: true });
+    const bodyText = option(options, "body", { required: true });
     const hasSourceEventId = Boolean(options["source-event-id"]);
     const hasSourceEventLease = Boolean(options["source-event-lease-token"]);
     if (hasSourceEventId !== hasSourceEventLease) {
@@ -841,10 +878,11 @@ async function agentCommand(options, action, id) {
         code: "agent_reply_source_conflict",
       });
     }
-    result = await api.request(`/documents/${resourcePath(option(options, "document-id", { required: true }))}/comments/${resourcePath(threadId)}/replies`, {
+    result = await api.request(`/documents/${resourcePath(documentId)}/comments/${resourcePath(threadId)}/replies`, {
       method: "POST",
       body: {
-        body: option(options, "body", { required: true }),
+        body: bodyText,
+        mention_targets: await resolveAgentMentionTargets(api, documentId, bodyText),
         entry_point: "external_agent_cli_reply",
         ...(options["source-event-id"] ? { source_event_id: options["source-event-id"] } : {}),
         ...(options["source-event-lease-token"] ? { source_event_lease_token: options["source-event-lease-token"] } : {}),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@corvio/cli",
-  "version": "0.1.0-beta.6",
+  "version": "0.1.0-beta.7",
   "description": "Official Corvio Workspace CLI for questions, knowledge search, documents, and Agent workflows.",
   "type": "module",
   "bin": {