@overaihq/cli 0.14.3 → 0.14.5

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);
@@ -27812,6 +27835,112 @@ var runAutomation = async (args) => {
   process.exitCode = 1;
 };
 
+// ../common/src/agent.ts
+var agentVersionConfigSchema = external_exports.object({
+  systemPrompt: external_exports.string(),
+  model: external_exports.string(),
+  temperature: external_exports.number(),
+  maxTokens: external_exports.number(),
+  rateLimitRequestsPerMinute: external_exports.number(),
+  rateLimitTokensPerMinute: external_exports.number()
+});
+var defaultAgentVersionConfig = {
+  systemPrompt: "You are a helpful assistant.",
+  model: "claude-sonnet-4-6",
+  temperature: 0.7,
+  maxTokens: 4096,
+  rateLimitRequestsPerMinute: 20,
+  rateLimitTokensPerMinute: 2e5
+};
+var agentTableSpaceAccessModeSchema = external_exports.enum(["read", "read_write"]);
+var BUILTIN_TOOL_SETS = {
+  web: {
+    label: "Web search",
+    description: "Search the web. Runs on the model provider's infrastructure; not every model offers it."
+  },
+  documents: {
+    label: "Read documents",
+    description: "Read PDFs, Word documents, spreadsheets and text files from this organization's storage."
+  },
+  storage: {
+    label: "Save files",
+    description: "Write text files to this organization's storage for other tools and people to use."
+  }
+};
+var isBuiltinToolSetName = (name2) => Object.hasOwn(BUILTIN_TOOL_SETS, name2);
+var agentEditableConfigSchema = agentVersionConfigSchema.extend({
+  agentVersionFunctionsByAgentIdAndVersionNumber: external_exports.object({
+    nodes: external_exports.array(
+      external_exports.object({
+        functionId: external_exports.string()
+      })
+    )
+  }),
+  agentVersionTableSpacesByAgentIdAndVersionNumber: external_exports.object({
+    nodes: external_exports.array(
+      external_exports.object({
+        tableSpaceId: external_exports.string(),
+        accessMode: agentTableSpaceAccessModeSchema
+      })
+    )
+  }),
+  agentVersionAgentsByAgentIdAndVersionNumber: external_exports.object({
+    nodes: external_exports.array(
+      external_exports.object({
+        attachedAgentId: external_exports.string()
+      })
+    )
+  }),
+  agentVersionKnowledgeBasesByAgentIdAndVersionNumber: external_exports.object({
+    nodes: external_exports.array(
+      external_exports.object({
+        knowledgeBaseId: external_exports.string()
+      })
+    )
+  }),
+  // Prefaulted: configs from before built-ins (stale clients, saved drafts)
+  // still parse.
+  agentVersionBuiltinToolSetsByAgentIdAndVersionNumber: external_exports.object({
+    nodes: external_exports.array(
+      external_exports.object({
+        toolSet: external_exports.string()
+      })
+    )
+  }).prefault({ nodes: [] })
+});
+var agentToolHttpMethodSchema = external_exports.enum([
+  "GET",
+  "POST",
+  "PUT",
+  "PATCH",
+  "DELETE"
+]);
+var agentToolRequestSchema = external_exports.object({
+  method: agentToolHttpMethodSchema,
+  // Sub-path under the function base URL; functions route on it
+  path: external_exports.string().prefault("/").transform((p) => p.startsWith("/") ? p : `/${p}`),
+  headers: external_exports.record(external_exports.string(), external_exports.string()).prefault({}),
+  queryParams: external_exports.record(external_exports.string(), external_exports.union([external_exports.string(), external_exports.number(), external_exports.boolean()])).prefault({}),
+  body: external_exports.unknown()
+});
+var agentToolRequestJsonSchemaSchema = external_exports.object({
+  type: external_exports.literal("object"),
+  properties: external_exports.object({
+    method: external_exports.object({ type: external_exports.literal("string") }).loose(),
+    headers: external_exports.object({ type: external_exports.literal("object") }).loose(),
+    queryParams: external_exports.object({ type: external_exports.literal("object") }).loose(),
+    body: external_exports.object({}).loose()
+  }).loose(),
+  required: external_exports.array(external_exports.string()).refine(
+    (arr) => ["method", "headers", "queryParams", "body"].every(
+      (key) => arr.includes(key)
+    ),
+    {
+      message: "required array must include: method, headers, queryParams, body"
+    }
+  )
+}).loose();
+
 // src/workspace/validateElements.ts
 var findings = (parsed) => parsed.success ? [] : parsed.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`);
 var validateAutomationElements = async (elements) => {
@@ -27824,40 +27953,46 @@ var validateWebPageConfig = async (config) => {
 };
 
 // ../common/src/function.ts
-var defaultAgentFunctionInputSchema = `{
-    "type": "object",
-    "properties": {
-      "method": {
-        "type": "string",
-        "enum": ["GET", "POST", "PUT", "PATCH", "DELETE"],
-        "default": "POST",
-        "description": "HTTP method for this function call."
+var agentToolPathJsonSchema = {
+  type: "string",
+  default: "/",
+  description: 'Sub-path under the function URL, e.g. "/notes". Use "/" for the base.'
+};
+var defaultAgentFunctionInputSchema = JSON.stringify(
+  {
+    type: "object",
+    properties: {
+      method: {
+        type: "string",
+        enum: ["GET", "POST", "PUT", "PATCH", "DELETE"],
+        default: "POST",
+        description: "HTTP method for this function call."
       },
-      "headers": {
-        "type": "object",
-        "description": "Request headers. Use {} when none are needed.",
-        "default": {},
-        "additionalProperties": {
-          "type": "string"
-        }
+      path: agentToolPathJsonSchema,
+      headers: {
+        type: "object",
+        description: "Request headers. Use {} when none are needed.",
+        default: {},
+        additionalProperties: { type: "string" }
       },
-      "queryParams": {
-        "type": "object",
-        "description": "URL query params. Use {} when none are needed.",
-        "default": {},
-        "additionalProperties": {
-          "type": ["string", "number", "boolean"]
-        }
+      queryParams: {
+        type: "object",
+        description: "URL query params. Use {} when none are needed.",
+        default: {},
+        additionalProperties: { type: ["string", "number", "boolean"] }
       },
-      "body": {
-        "type": "object",
-        "description": "Request body payload. Use {} when none is needed.",
-        "default": {},
-        "additionalProperties": true
+      body: {
+        type: "object",
+        description: "Request body payload. Use {} when none is needed.",
+        default: {},
+        additionalProperties: true
       }
     },
-    "required": ["method", "headers", "queryParams", "body"]
-  }`;
+    required: ["method", "headers", "queryParams", "body"]
+  },
+  null,
+  2
+);
 var DEFAULT_FUNCTION_EXECUTION_TIMEOUT_MS = 3e4;
 var DEFAULT_FUNCTION_EXECUTION_MEMORY_MB = 512;
 
@@ -28259,6 +28394,9 @@ var agentFiles = (id, name2, version) => ({
     ),
     knowledgeBaseIds: version.agentVersionKnowledgeBasesByAgentIdAndVersionNumber.nodes.map(
       (link) => link.knowledgeBaseId
+    ),
+    builtinToolSets: version.agentVersionBuiltinToolSetsByAgentIdAndVersionNumber.nodes.map(
+      (link) => link.toolSet
     )
   })
 });
@@ -28277,6 +28415,9 @@ var agentVersionFields = `
   agentVersionKnowledgeBasesByAgentIdAndVersionNumber(orderBy: [KNOWLEDGE_BASE_ID_ASC]) {
     nodes { knowledgeBaseId }
   }
+  agentVersionBuiltinToolSetsByAgentIdAndVersionNumber(orderBy: [TOOL_SET_ASC]) {
+    nodes { toolSet }
+  }
 `;
 var agentAdapter = {
   type: "agent",
@@ -28342,13 +28483,21 @@ var agentAdapter = {
   },
   push: async (id, files, message, expectedLatestVersion) => {
     const config = JSON.parse(fileBySuffix(files, ".json"));
+    const unknownToolSets = (config.builtinToolSets ?? []).filter(
+      (name2) => !isBuiltinToolSetName(name2)
+    );
+    if (unknownToolSets.length > 0) {
+      throw new Error(
+        `Unknown builtinToolSets: ${unknownToolSets.join(", ")}. Known: ${Object.keys(BUILTIN_TOOL_SETS).join(", ")}. If the name is new, upgrade the CLI.`
+      );
+    }
     const data = await gqlRequest(
       `mutation CliCreateAgentVersion($expectedLatestVersion: Int,
         $agentId: String!, $message: String!, $systemPrompt: String!,
         $model: String!, $temperature: Float!, $maxTokens: Int!,
         $rateLimitRequestsPerMinute: Int!, $rateLimitTokensPerMinute: Int!,
         $functionIds: [String], $tableSpaceBindings: JSON, $agentIds: [String],
-        $knowledgeBaseIds: [String]
+        $knowledgeBaseIds: [String], $builtinToolSets: [String]
       ) {
         createAgentVersionWithAttachments(input: { expectedLatestVersion: $expectedLatestVersion,
           agentId: $agentId, message: $message, systemPrompt: $systemPrompt,
@@ -28356,7 +28505,8 @@ var agentAdapter = {
           rateLimitRequestsPerMinute: $rateLimitRequestsPerMinute,
           rateLimitTokensPerMinute: $rateLimitTokensPerMinute,
           functionIds: $functionIds, tableSpaceBindings: $tableSpaceBindings,
-          agentIds: $agentIds, knowledgeBaseIds: $knowledgeBaseIds
+          agentIds: $agentIds, knowledgeBaseIds: $knowledgeBaseIds,
+          builtinToolSets: $builtinToolSets
         }) { result { versionNumber } }
       }`,
       {
@@ -28366,6 +28516,7 @@ var agentAdapter = {
         tableSpaceBindings: config.tableSpaceBindings ?? [],
         agentIds: config.agentIds ?? [],
         knowledgeBaseIds: config.knowledgeBaseIds ?? [],
+        builtinToolSets: config.builtinToolSets ?? null,
         expectedLatestVersion
       }
     );
@@ -28554,86 +28705,6 @@ var runRunner = async (args) => {
   process.exitCode = 1;
 };
 
-// ../common/src/agent.ts
-var agentVersionConfigSchema = external_exports.object({
-  systemPrompt: external_exports.string(),
-  model: external_exports.string(),
-  temperature: external_exports.number(),
-  maxTokens: external_exports.number(),
-  rateLimitRequestsPerMinute: external_exports.number(),
-  rateLimitTokensPerMinute: external_exports.number()
-});
-var defaultAgentVersionConfig = {
-  systemPrompt: "You are a helpful assistant.",
-  model: "claude-sonnet-4-6",
-  temperature: 0.7,
-  maxTokens: 4096,
-  rateLimitRequestsPerMinute: 20,
-  rateLimitTokensPerMinute: 2e5
-};
-var agentTableSpaceAccessModeSchema = external_exports.enum(["read", "read_write"]);
-var agentEditableConfigSchema = agentVersionConfigSchema.extend({
-  agentVersionFunctionsByAgentIdAndVersionNumber: external_exports.object({
-    nodes: external_exports.array(
-      external_exports.object({
-        functionId: external_exports.string()
-      })
-    )
-  }),
-  agentVersionTableSpacesByAgentIdAndVersionNumber: external_exports.object({
-    nodes: external_exports.array(
-      external_exports.object({
-        tableSpaceId: external_exports.string(),
-        accessMode: agentTableSpaceAccessModeSchema
-      })
-    )
-  }),
-  agentVersionAgentsByAgentIdAndVersionNumber: external_exports.object({
-    nodes: external_exports.array(
-      external_exports.object({
-        attachedAgentId: external_exports.string()
-      })
-    )
-  }),
-  agentVersionKnowledgeBasesByAgentIdAndVersionNumber: external_exports.object({
-    nodes: external_exports.array(
-      external_exports.object({
-        knowledgeBaseId: external_exports.string()
-      })
-    )
-  })
-});
-var agentToolHttpMethodSchema = external_exports.enum([
-  "GET",
-  "POST",
-  "PUT",
-  "PATCH",
-  "DELETE"
-]);
-var agentToolRequestSchema = external_exports.object({
-  method: agentToolHttpMethodSchema,
-  headers: external_exports.record(external_exports.string(), external_exports.string()).prefault({}),
-  queryParams: external_exports.record(external_exports.string(), external_exports.union([external_exports.string(), external_exports.number(), external_exports.boolean()])).prefault({}),
-  body: external_exports.unknown()
-});
-var agentToolRequestJsonSchemaSchema = external_exports.object({
-  type: external_exports.literal("object"),
-  properties: external_exports.object({
-    method: external_exports.object({ type: external_exports.literal("string") }).loose(),
-    headers: external_exports.object({ type: external_exports.literal("object") }).loose(),
-    queryParams: external_exports.object({ type: external_exports.literal("object") }).loose(),
-    body: external_exports.object({}).loose()
-  }).loose(),
-  required: external_exports.array(external_exports.string()).refine(
-    (arr) => ["method", "headers", "queryParams", "body"].every(
-      (key) => arr.includes(key)
-    ),
-    {
-      message: "required array must include: method, headers, queryParams, body"
-    }
-  )
-}).loose();
-
 // ../common/src/liquidjs/liquidjs.ts
 var import_jmespath = __toESM(require_jmespath(), 1);
 
@@ -34773,14 +34844,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");
@@ -35373,6 +35450,9 @@ var ID_PREFIXES = {
   agent: { prefix: "agt", body: 10 },
   agent_conversation: { prefix: "agcv", body: 20 },
   agent_message: { prefix: "agmsg", body: 20 },
+  agent_message_part: { prefix: "amp", body: 16 },
+  agent_tool_invocation: { prefix: "ati", body: 16 },
+  agent_turn: { prefix: "atn", body: 16 },
   architect_chat: {
     prefix: "ac",
     body: 12,
@@ -36262,6 +36342,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];
@@ -36680,7 +36761,9 @@ Rules that keep graphs healthy:
 - Keep TYPESCRIPT_CODE nodes small and focused \u2014 split logic across nodes and
   let the graph orchestrate, rather than one big code block.
 - Write TYPESCRIPT_CODE as a module:
-  \`export default async function step(state: StepState, ctx, env) { const s1 = await state.get("S1"); return s1.rows; }\`.
+  \`export default async function step(state: StepState, ctx: StepContext, env: Env) { const s1 = await state.get("S1"); return s1.rows; }\`.
+  Annotate every parameter you declare \u2014 module code is checked with
+  noImplicitAny, so an unannotated one is an error.
   \`state.get\` fetches one step's output on first read (cached for that node's execution),
   resolves undefined for a skipped step, and rejects for an id not visible
   from the node. Bare snippets (STATE/OUTPUT globals) are legacy, being retired.
@@ -37843,13 +37926,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")
@@ -38006,8 +38120,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.3",
+  "version": "0.14.5",
   "description": "Create, edit, deploy, and run OverAI workspace resources from the command line",
   "type": "module",
   "homepage": "https://overai.com",