@overaihq/cli 0.14.4 → 0.14.6

package/dist/index.js

@@ -27166,6 +27166,29 @@ import { hostname } from "os";
 
 // src/args.ts
 import { readFileSync as readFileSync2 } from "fs";
+var usageFor = (help, command2) => {
+  const out = [];
+  let inSection = false;
+  for (const line of help.split("\n")) {
+    const body = line.trimStart();
+    if (body.startsWith("overai "))
+      inSection = body === `overai ${command2}` || body.startsWith(`overai ${command2} `);
+    else if (line === body) inSection = false;
+    if (inSection) out.push(line);
+  }
+  return out.length === 0 ? "" : `${out.join("\n")}
+`;
+};
+var unknownFlags = (args, known, valueFlags = []) => {
+  const out = [];
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg == null || !arg.startsWith("-")) continue;
+    if (!known.includes(arg)) out.push(arg);
+    else if (valueFlags.includes(arg)) i++;
+  }
+  return out;
+};
 var flagValue = (args, ...names) => {
   for (const name2 of names) {
     const i = args.indexOf(name2);
@@ -27680,22 +27703,7 @@ var whoami = (args = []) => {
 };
 
 // src/commands/agent.ts
-var runAgent = async (args) => {
-  const [operation, id] = args;
-  if (operation !== "generate" || id == null) throw new Error("Usage: overai agent generate <id> --message <text|@file|@->");
-  const message = await readValue(flagValue(args, "--message", "-m"), "--message");
-  if (message == null) throw new Error("Agent generate requires --message.");
-  const { organizationId } = await getAccessToken();
-  const response = await v2Fetch(`/v2/agents/${organizationId}/${id}/generate/text`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({ message })
-  });
-  const raw2 = await response.text();
-  if (!response.ok) throw v2Error("agent generate", response, raw2);
-  const body = JSON.parse(raw2);
-  printResult(body, resolveFormat(flagValue(args, "-o", "--output")));
-};
+import { createInterface } from "readline";
 
 // src/gql.ts
 var gqlRequest = async (query, variables) => {
@@ -27725,6 +27733,283 @@ var gqlRequest = async (query, variables) => {
   return body.data;
 };
 
+// src/commands/agent.ts
+var USAGE = [
+  "Usage:",
+  "  overai agent generate <id> --message <text|@file|@->",
+  "  overai agent tools <id> [--version <n>] [-o json|table|csv]",
+  "  overai agent chat <id> [--conversation <id>] [--message <text>]"
+].join("\n");
+var generate = async (args, id) => {
+  const message = await readValue(
+    flagValue(args, "--message", "-m"),
+    "--message"
+  );
+  if (message == null) throw new Error("Agent generate requires --message.");
+  const { organizationId } = await getAccessToken();
+  const response = await v2Fetch(
+    `/v2/agents/${organizationId}/${id}/generate/text`,
+    {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ message })
+    }
+  );
+  const raw2 = await response.text();
+  if (!response.ok) throw v2Error("agent generate", response, raw2);
+  printResult(
+    JSON.parse(raw2),
+    resolveFormat(flagValue(args, "-o", "--output"))
+  );
+};
+var deployedVersionNumber = async (id) => {
+  const deployed = await gqlRequest(
+    `query CliAgentDeployedVersion($id: String!) {
+      agentDeployedVersions(condition: { agentId: $id }) { nodes { versionNumber } }
+    }`,
+    { id }
+  );
+  const versionNumber = deployed.agentDeployedVersions?.nodes[0]?.versionNumber;
+  if (versionNumber == null) {
+    throw new Error(
+      `Agent ${id} has no deployed version; pass --version <n> to inspect a saved one.`
+    );
+  }
+  return versionNumber;
+};
+var tools = async (args, id) => {
+  const versionFlag = flagValue(args, "--version", "-v");
+  if (versionFlag != null && !Number.isInteger(Number(versionFlag))) {
+    throw new Error("--version must be an integer.");
+  }
+  const version = versionFlag == null ? await deployedVersionNumber(id) : Number(versionFlag);
+  const data = await gqlRequest(
+    `query CliAgentTools($id: String!, $version: Int!) {
+      agent(id: $id) {
+        name
+        agentVersions(first: 1, condition: { versionNumber: $version }) {
+          nodes {
+            versionNumber
+            model
+            agentVersionFunctionsByAgentIdAndVersionNumber(orderBy: [FUNCTION_ID_ASC]) {
+              nodes { functionId function { name } }
+            }
+            agentVersionTableSpacesByAgentIdAndVersionNumber(orderBy: [TABLE_SPACE_ID_ASC]) {
+              nodes { tableSpaceId accessMode }
+            }
+            agentVersionAgentsByAgentIdAndVersionNumber(orderBy: [ATTACHED_AGENT_ID_ASC]) {
+              nodes { attachedAgentId }
+            }
+            agentVersionKnowledgeBasesByAgentIdAndVersionNumber(orderBy: [KNOWLEDGE_BASE_ID_ASC]) {
+              nodes { knowledgeBaseId }
+            }
+            agentVersionBuiltinToolSetsByAgentIdAndVersionNumber(orderBy: [TOOL_SET_ASC]) {
+              nodes { toolSet }
+            }
+          }
+        }
+      }
+    }`,
+    { id, version }
+  );
+  if (data.agent == null) throw new Error(`Agent ${id} not found.`);
+  const agentVersion = data.agent.agentVersions.nodes[0];
+  if (agentVersion == null) {
+    throw new Error(`Agent ${id} has no version ${String(version)}.`);
+  }
+  const rows = [
+    ...agentVersion.agentVersionFunctionsByAgentIdAndVersionNumber.nodes.map(
+      (link) => ({
+        kind: "function",
+        name: link.function?.name ?? link.functionId,
+        detail: link.functionId
+      })
+    ),
+    ...agentVersion.agentVersionTableSpacesByAgentIdAndVersionNumber.nodes.map(
+      (link) => ({
+        kind: "table space",
+        name: link.tableSpaceId,
+        detail: link.accessMode
+      })
+    ),
+    ...agentVersion.agentVersionAgentsByAgentIdAndVersionNumber.nodes.map(
+      (link) => ({
+        kind: "sub-agent",
+        name: link.attachedAgentId,
+        detail: ""
+      })
+    ),
+    ...agentVersion.agentVersionKnowledgeBasesByAgentIdAndVersionNumber.nodes.map(
+      (link) => ({
+        kind: "knowledge base",
+        name: link.knowledgeBaseId,
+        detail: ""
+      })
+    ),
+    ...agentVersion.agentVersionBuiltinToolSetsByAgentIdAndVersionNumber.nodes.map(
+      (link) => ({ kind: "built-in", name: link.toolSet, detail: "" })
+    )
+  ];
+  const format2 = resolveFormat(flagValue(args, "-o", "--output"));
+  if (format2 === "json") {
+    printResult(
+      {
+        agent: data.agent.name,
+        version: agentVersion.versionNumber,
+        model: agentVersion.model,
+        tools: rows
+      },
+      format2
+    );
+    return;
+  }
+  if (format2 === "table") {
+    process.stdout.write(
+      `${data.agent.name} \xB7 version ${String(agentVersion.versionNumber)} \xB7 ${agentVersion.model}
+`
+    );
+  }
+  printResult(rows, format2);
+};
+var printStreamLine = (line) => {
+  if (!line.startsWith("data: ")) return;
+  const payload = line.slice(6);
+  if (payload === "[DONE]") return;
+  let event;
+  try {
+    event = JSON.parse(payload);
+  } catch {
+    return;
+  }
+  if (event.type === "text-delta" && event.delta != null) {
+    process.stdout.write(event.delta);
+  }
+  if (event.type === "error") {
+    process.stderr.write(`
+${event.errorText ?? "agent turn failed"}
+`);
+  }
+};
+var streamReply = async (response) => {
+  const body = response.body;
+  if (body == null) return;
+  const decoder = new TextDecoder();
+  let buffer = "";
+  for await (const chunk of body) {
+    buffer += decoder.decode(chunk, { stream: true });
+    const lines = buffer.split("\n");
+    buffer = lines.pop() ?? "";
+    lines.forEach(printStreamLine);
+  }
+  printStreamLine(buffer + decoder.decode());
+};
+var send = async (organizationId, id, message, conversationId) => {
+  const response = await v2Fetch(`/v2/agents/${organizationId}/${id}`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      messages: [{ role: "user", parts: [{ type: "text", text: message }] }],
+      conversationId
+    })
+  });
+  if (!response.ok) {
+    throw v2Error("agent chat", response, await response.text());
+  }
+  await streamReply(response);
+  process.stdout.write("\n");
+};
+var createConversation = async (id, firstMessage) => {
+  const versionNumber = await deployedVersionNumber(id);
+  const created = await gqlRequest(
+    `mutation CliCreateAgentConversation($input: CreateAgentConversationInput!) {
+      createAgentConversation(input: $input) { agentConversation { id } }
+    }`,
+    {
+      input: {
+        agentConversation: {
+          agentId: id,
+          versionNumber,
+          title: firstMessage.length > 50 ? `${firstMessage.slice(0, 47)}...` : firstMessage
+        }
+      }
+    }
+  );
+  const conversationId = created.createAgentConversation?.agentConversation?.id;
+  if (conversationId == null)
+    throw new Error("Failed to create a conversation.");
+  return conversationId;
+};
+var chat = async (args, id) => {
+  const { organizationId } = await getAccessToken();
+  let conversationId = flagValue(args, "--conversation", "-c") ?? null;
+  const single = await readValue(
+    flagValue(args, "--message", "-m"),
+    "--message"
+  );
+  if (single != null) {
+    conversationId ??= await createConversation(id, single);
+    try {
+      await send(organizationId, id, single, conversationId);
+    } finally {
+      process.stderr.write(`Conversation: ${conversationId}
+`);
+    }
+    return;
+  }
+  const interactive = process.stdin.isTTY;
+  const rl = createInterface({
+    input: process.stdin,
+    ...interactive ? { output: process.stdout, historySize: 1e3, terminal: true } : {}
+  });
+  if (interactive) {
+    process.stdout.write(
+      `Chatting with ${id}. Ctrl-C to leave; each reply prints as it streams.
+`
+    );
+    rl.setPrompt("> ");
+    rl.prompt();
+  }
+  for await (const line of rl) {
+    const message = line.trim();
+    if (message.length === 0) {
+      if (interactive) rl.prompt();
+      continue;
+    }
+    try {
+      conversationId ??= await createConversation(id, message);
+      await send(organizationId, id, message, conversationId);
+    } catch (error) {
+      process.stderr.write(
+        `${error instanceof Error ? error.message : String(error)}
+`
+      );
+    }
+    if (interactive) rl.prompt();
+  }
+  if (conversationId != null) {
+    process.stderr.write(`
+Conversation: ${conversationId}
+`);
+  }
+};
+var runAgent = async (args) => {
+  const [operation, id] = args;
+  if (id == null) throw new Error(USAGE);
+  switch (operation) {
+    case "generate":
+      await generate(args, id);
+      return;
+    case "tools":
+      await tools(args, id);
+      return;
+    case "chat":
+      await chat(args, id);
+      return;
+    default:
+      throw new Error(USAGE);
+  }
+};
+
 // src/commands/automation.ts
 var runRuns = async (automationId, args) => {
   const limit2 = Number(flagValue(args, "--limit") ?? 20);
@@ -28670,7 +28955,7 @@ var runList = async (args) => {
     resolveFormat(flagValue(args, "-o", "--output"))
   );
 };
-var USAGE = "Usage: overai runner create <workspaceId> [--name <name>]\n       overai runner token <runnerId> [--note <note>]\n       overai runner run <runnerId> [--interpreter shell|powershell] --code '<code>'\n       overai runner upload <runnerId> --path '<path>'\n       overai runner list [workspaceId] [--limit <n>]\n";
+var USAGE2 = "Usage: overai runner create <workspaceId> [--name <name>]\n       overai runner token <runnerId> [--note <note>]\n       overai runner run <runnerId> [--interpreter shell|powershell] --code '<code>'\n       overai runner upload <runnerId> --path '<path>'\n       overai runner list [workspaceId] [--limit <n>]\n";
 var runRunner = async (args) => {
   const [sub, id, ...rest] = args;
   if (sub === "create" && id != null) return runCreate(id, rest);
@@ -28678,7 +28963,7 @@ var runRunner = async (args) => {
   if (sub === "run" && id != null) return runRun(id, rest);
   if (sub === "upload" && id != null) return runUpload(id, rest);
   if (sub === "list") return runList([id, ...rest].filter((a) => a != null));
-  process.stderr.write(USAGE);
+  process.stderr.write(USAGE2);
   process.exitCode = 1;
 };
 
@@ -34821,14 +35106,20 @@ var positionals = (args) => {
   }
   return out;
 };
+var pushMessage = (args) => {
+  const message = flagValue(args, "-m", "--message");
+  if (message == null || message.startsWith("-"))
+    throw new Error("Usage: overai push [filter] -m <message>. -m names the version this push creates.");
+  return message;
+};
 var runPush = async (args, clone) => {
   if (clone != null && args.includes("--deploy")) throw new Error("Recursive push cannot deploy.");
+  const message = pushMessage(args);
   const { root, manifest } = clone ?? openClone();
   let incomplete = false;
   const currentIds = clone == null ? null : new Set((await Promise.all(
     allAdapters.map((adapter) => adapter.fetchAll(manifest.workspaceId))
   )).flat().map((resource) => resource.id));
-  const message = flagValue(args, "-m", "--message") ?? "Pushed via overai CLI";
   const deploy = args.includes("--deploy");
   const force = args.includes("--force");
   const allowBreaking = args.includes("--allow-breaking");
@@ -35268,7 +35559,7 @@ var runGraphql = async (args) => {
 };
 
 // src/commands/integration.ts
-var USAGE2 = "Usage: overai integration configure <id> --config <json|@file|@-> | integration config <id> | integration secret set <id> <KEY> --value <@file|@-> | integration secret unset <id> <KEY>";
+var USAGE3 = "Usage: overai integration configure <id> --config <json|@file|@-> | integration config <id> | integration secret set <id> <KEY> --value <@file|@-> | integration secret unset <id> <KEY>";
 var setSecret = async (integrationId, key, rawValue) => {
   if (rawValue == null) {
     throw new Error("Integration secret set requires --value.");
@@ -35302,7 +35593,7 @@ var runIntegration = async (args) => {
   if (operation === "secret") {
     const [, action, id2, key] = args;
     if (action !== "set" && action !== "unset" || id2 == null || key == null || key.startsWith("-")) {
-      throw new Error(USAGE2);
+      throw new Error(USAGE3);
     }
     if (action === "set") {
       await setSecret(id2, key, flagValue(args, "--value"));
@@ -35318,7 +35609,7 @@ var runIntegration = async (args) => {
   }
   const [, id] = args;
   if (id == null || operation !== "configure" && operation !== "config") {
-    throw new Error(USAGE2);
+    throw new Error(USAGE3);
   }
   if (operation === "configure") {
     const raw2 = await readValue(flagValue(args, "--config"), "--config");
@@ -35611,7 +35902,7 @@ var runOpen = async (args) => {
 };
 
 // src/commands/org.ts
-import { createInterface } from "readline/promises";
+import { createInterface as createInterface2 } from "readline/promises";
 var USER_ORGS_QUERY = `
   query UserOrganizations($identityId: String!) {
     identityOrganizations(condition: { identityId: $identityId }) {
@@ -35741,7 +36032,7 @@ var promptForOrg = async () => {
 `
     );
   });
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  const rl = createInterface2({ input: process.stdin, output: process.stdout });
   try {
     const answer = await rl.question("Switch to: ");
     const chosen = rows[Number(answer.trim()) - 1];
@@ -36313,6 +36604,7 @@ var runDiff = async (args, clone) => {
 var runRecursiveSync = async (command2, args) => {
   if (command2 === "push" && args.includes("--deploy"))
     throw new Error("Recursive push saves versions only. Deploy from an individual workspace.");
+  if (command2 === "push") pushMessage(args);
   const origin = openClone();
   const local = /* @__PURE__ */ new Map([[origin.manifest.workspaceId, origin]]);
   const folders = [origin];
@@ -37142,7 +37434,7 @@ var runReview = async () => {
 };
 
 // src/commands/sql.ts
-import { createInterface as createInterface2 } from "readline";
+import { createInterface as createInterface3 } from "readline";
 
 // src/commands/sqlCredential.ts
 var connectionString = async (tableSpaceId, secret) => {
@@ -37286,7 +37578,7 @@ transaction \u2014 BEGIN/SET/temp tables don't carry across statements.
 `;
 var runRepl = async (organizationId, tableSpaceId, format2) => {
   const interactive = process.stdin.isTTY;
-  const rl = createInterface2({
+  const rl = createInterface3({
     input: process.stdin,
     ...interactive ? { output: process.stdout, historySize: 1e3, terminal: true } : {}
   });
@@ -37432,10 +37724,10 @@ var runSql = async (args) => {
 
 // src/commands/storage.ts
 import { openAsBlob, writeFileSync as writeFileSync6 } from "fs";
-var USAGE3 = "Usage: overai storage upload <path> [--no-random-prefix] | storage download <key> [path|-] | storage exists <key> | storage head <key> [--lines N] | storage presign <key> [--expires-in <seconds>]";
+var USAGE4 = "Usage: overai storage upload <path> [--no-random-prefix] | storage download <key> [path|-] | storage exists <key> | storage head <key> [--lines N] | storage presign <key> [--expires-in <seconds>]";
 var runStorage = async (args) => {
   const [operation, first2, second] = args;
-  if (operation == null) throw new Error(USAGE3);
+  if (operation == null) throw new Error(USAGE4);
   const { organizationId } = await getAccessToken();
   const segment = (key) => encodeURIComponent(key);
   if (operation === "upload") {
@@ -37466,7 +37758,7 @@ var runStorage = async (args) => {
 `);
     return;
   }
-  if (first2 == null) throw new Error(USAGE3);
+  if (first2 == null) throw new Error(USAGE4);
   if (operation === "download") {
     const response = await v2Fetch(
       `/v2/storage/${organizationId}/${segment(first2)}`,
@@ -37523,7 +37815,7 @@ var runStorage = async (args) => {
 `);
     return;
   }
-  throw new Error(USAGE3);
+  throw new Error(USAGE4);
 };
 
 // src/commands/workspace.ts
@@ -37609,7 +37901,7 @@ var listWorkspaceUsers = async (args) => {
     resolveFormat(flagValue(args, "-o", "--output"))
   );
 };
-var USAGE4 = `Usage:
+var USAGE5 = `Usage:
   overai workspace list [--archived] [--limit <n>]
   overai workspace show [workspaceId]
   overai workspace users [workspaceId]
@@ -37627,7 +37919,7 @@ var runWorkspace = async (args) => {
     await listWorkspaceUsers(args.slice(1));
     return;
   }
-  process.stderr.write(USAGE4);
+  process.stderr.write(USAGE5);
   process.exitCode = 1;
 };
 
@@ -37785,6 +38077,8 @@ Automations:
 
 Other resources:
   overai agent generate <agentId> --message <text|@file|@->
+  overai agent tools <agentId> [--version <n>]
+  overai agent chat <agentId> [--conversation <id>] [--message <text>]
   overai data-stream append <id> <json|@file|@->
   overai data-stream query <id> --start <date> --end <date> [--query <filter>]
   overai data-file upload <id> <path> [-m <message>]
@@ -37896,13 +38190,44 @@ var withoutLeadingFlags = (argv) => {
   }
   return argv.slice(index);
 };
+var COMMAND_ALIASES = {
+  login: "signin",
+  logout: "signout",
+  ws: "workspace",
+  upgrade: "update"
+};
+var WRITE_COMMAND_FLAGS = /* @__PURE__ */ new Map([
+  ["pull", { flags: ["--recursive"] }],
+  [
+    "push",
+    {
+      flags: ["-m", "--message", "--deploy", "--force", "--allow-breaking", "--recursive"],
+      valueFlags: ["-m", "--message"]
+    }
+  ],
+  // --recursive stays listed for deploy and restore so the --recursive branch
+  // below can explain that they are single-workspace, instead of "unknown flag".
+  ["deploy", { flags: ["--all", "--allow-breaking", "--recursive"] }],
+  ["restore", { flags: ["--all", "--recursive"] }]
+]);
+var usageOrHelp = (command2) => usageFor(HELP, COMMAND_ALIASES[command2] ?? command2) || HELP;
 var run = async () => {
   const [command2, ...rest] = withoutLeadingFlags(process.argv.slice(2));
+  if (command2 != null && (rest.includes("--help") || rest.includes("-h"))) {
+    process.stdout.write(usageOrHelp(command2));
+    return;
+  }
   const misplaced = rest.find((arg) => LEADING_FLAGS.includes(arg));
   if (misplaced != null)
     throw new Error(
       `${misplaced} goes before the command: overai ${misplaced} <ref> ${command2 ?? "<command>"} ...`
     );
+  const writeFlags = command2 == null ? void 0 : WRITE_COMMAND_FLAGS.get(command2);
+  const unknown = writeFlags == null ? [] : unknownFlags(rest, writeFlags.flags, writeFlags.valueFlags);
+  if (unknown.length > 0)
+    throw new Error(
+      `Unknown flag ${unknown.join(", ")} for ${command2 ?? ""}. See: overai ${command2 ?? ""} --help`
+    );
   const orgFromFolder = command2 != null && !ORG_AGNOSTIC_COMMANDS.has(command2);
   if (orgFromFolder) pinOrgFromClone();
   if (requireExplicitOrg && command2 != null && !ORG_OPTIONAL_COMMANDS.has(command2) && orgScopeSource() === "saved default")
@@ -38059,8 +38384,10 @@ var run = async () => {
       process.stdout.write(`${cliVersion()}
 `);
       return;
-    case void 0:
     case "help":
+      process.stdout.write(rest[0] == null ? HELP : usageOrHelp(rest[0]));
+      return;
+    case void 0:
     case "--help":
     case "-h":
       process.stdout.write(HELP);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@overaihq/cli",
-  "version": "0.14.4",
+  "version": "0.14.6",
   "description": "Create, edit, deploy, and run OverAI workspace resources from the command line",
   "type": "module",
   "homepage": "https://overai.com",