@claypi/cli 0.1.4 → 0.1.5

package/dist/index.js

@@ -82972,6 +82972,13 @@ function readJsonFlag(flagName, source) {
     throw new InvalidArgumentError(`${flagName}: not valid JSON (${err.message})`);
   }
 }
+function readJsonObjectFlag(flagName, source) {
+  const parsed = readJsonFlag(flagName, source);
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    throw new InvalidArgumentError(`${flagName}: must be a JSON object`);
+  }
+  return parsed;
+}
 
 // src/commands/tables/list.ts
 function buildListCommand() {
@@ -92203,6 +92210,7 @@ var BlockSettings = external_exports.discriminatedUnion("blockType", [
   AdSyncBlockSettings
 ]);
 var AutoRunMode = external_exports.enum(["all", "keep_existing"]);
+var TableColorLabels = external_exports.record(external_exports.nativeEnum(DataTypeColor), external_exports.string());
 var TableSettingsBase = external_exports.object({
   AUTO_RUN_ON: external_exports.boolean().optional(),
   AUTO_RUN_MODE: AutoRunMode.optional(),
@@ -92237,7 +92245,8 @@ var TableSettingsBase = external_exports.object({
   PASS_THROUGH_TABLE_SUCCESS_CRITERIA: GridViewFilterConfigGroup.optional(),
   PASS_THROUGH_TABLE_DELETE_EXCESS_RECORDS_LIMIT: external_exports.number().optional(),
   /** When true, table data is synced for ClayQL queries (cross-table, NL queries). */
-  CLAYQL_SYNC_ENABLED: external_exports.boolean().optional()
+  CLAYQL_SYNC_ENABLED: external_exports.boolean().optional(),
+  COLOR_LABELS: TableColorLabels.optional()
 });
 var TableSettings = TableSettingsBase.refine(
   (data) => {
@@ -92288,7 +92297,7 @@ var TableSettingsKeys = Object.freeze(
 );
 
 // ../../libs/shared/src/tools/tool-id.ts
-var ToolType = external_exports.enum(["function", "enrichment"]);
+var ToolType = external_exports.enum(["function", "enrichment", "workflow"]);
 
 // ../../libs/shared/src/tools/tool-input-schemas.ts
 var ToolSurface = external_exports.enum(["api", "mcp", "claygent"]);
@@ -93998,6 +94007,89 @@ var terracottaClayActionsContract = {
   }
 };
 
+// src/commands/workflows/actions/dynamic-fields.ts
+function prefixRevealedFieldNames(responses, parameterPath) {
+  const prefix = parameterPath.split(".").pop() ?? parameterPath;
+  return responses.map((response) => ({
+    ...response,
+    dynamicData: (response.dynamicData ?? []).map((field) => {
+      if (typeof field === "object" && field !== null && "name" in field) {
+        const named = field;
+        if (typeof named.name === "string") {
+          return { ...field, name: `${prefix}|${named.name}` };
+        }
+      }
+      return field;
+    })
+  }));
+}
+function buildDynamicFieldsCommand() {
+  const cmd = new Command("dynamic-fields");
+  cmd.description("Resolve an action parameter whose options or fields depend on other inputs.").argument("<packageId>", "Action package id, from `workflows actions list`").argument("<actionKey>", "Action key, from `workflows actions list`").argument("<parameterPath>", "Parameter name; dot-notation for grouped params (e.g. objectSchema.stage)").addOption(
+    new Option(
+      "--type <type>",
+      "select = resolve a dependent dropdown\u2019s values; input = resolve a revealed field set."
+    ).choices(["select", "input"]).default("select")
+  ).option("--account <id>", "Connected account id (authAccountId) for actions that need auth.").option(
+    "--inputs <json|file|->",
+    "Already-chosen input values as a JSON object keyed by parameter name: inline JSON, a file path, or - for stdin."
+  ).addHelpText(
+    "after",
+    `
+Output (success, exit 0):
+  [ { "parameterPath": <string>,
+      "dynamicData": [ ... ],   // shape depends on --type, see below
+      "errors": [ { "errorMessage": <string>, "errorDetails": <string>?,
+                    "errorStatus": <string>, "isBlocking": <boolean> } ]?,
+      "logUrl": <string>? } ]
+
+  --type select  dynamicData: [ { "value": <string>, "displayName": <string> } ]
+                 \u2014 "value" is what you pass back in a later --inputs call.
+  --type input   dynamicData: revealed input-parameter schema objects forwarded from the
+                 server; each "name" is prefixed to pipe notation (<parameterPath>|<field>)
+                 so it can be bound directly \u2014 the bare name drops the value at run time.
+
+  "errors[].isBlocking" is load-bearing: when true, abort cascading input resolution.
+
+Configuring cascading inputs is iterative: resolve and fill one input, then re-run
+with it in --inputs to resolve the next dependent parameter.
+
+Common errors:
+  validation_error (exit 2)  Required arguments missing, or --inputs is unreadable, not valid JSON, or not a JSON object.
+  auth_forbidden   (exit 3)  API key lacks permission for this command (insufficient scope).
+
+Examples:
+  $ clay workflows actions dynamic-fields <packageId> create-object objectType --account acc_123 | jq '.[0].dynamicData'
+  $ clay workflows actions dynamic-fields <packageId> create-object property --account acc_123 --inputs '{"objectType":"companies"}' | jq -r '.[0].dynamicData[].value'
+`
+  ).action(
+    async (packageId, actionKey, parameterPath, opts) => {
+      const inputs = opts.inputs === void 0 ? {} : readJsonObjectFlag("--inputs", opts.inputs);
+      const workspaceId = await currentWorkspaceId();
+      const client = await v3Client(terracottaClayActionsContract);
+      const result = await unwrap(
+        client.getClayActionDynamicFields({
+          params: { workspaceId },
+          body: {
+            dynamicRequests: [
+              {
+                actionPackageId: packageId,
+                actionKey,
+                parameterPath,
+                type: opts.type,
+                authAccountId: opts.account,
+                inputs
+              }
+            ]
+          }
+        })
+      );
+      writeJson(opts.type === "input" ? prefixRevealedFieldNames(result, parameterPath) : result);
+    }
+  );
+  return cmd;
+}
+
 // src/commands/workflows/actions/projection.ts
 var ACTION_FIELDS = [
   "type",
@@ -94149,8 +94241,9 @@ function buildActionsCommand() {
     "after",
     `
 Subcommands:
-  list      Dump the full action catalog (greppable JSON).
-  schema    Fetch one action\u2019s input schema by packageId + actionKey.
+  list            Dump the full action catalog (greppable JSON).
+  schema          Fetch one action\u2019s input schema by packageId + actionKey.
+  dynamic-fields  Resolve a parameter whose options/fields depend on other inputs.
 
 These are workflow building blocks (actions you add to a node\u2019s "tools"). For
 workspace *function tools*, a different concept, see \`clay tools\`.
@@ -94158,10 +94251,12 @@ workspace *function tools*, a different concept, see \`clay tools\`.
 Examples:
   $ clay workflows actions list > catalog.json
   $ clay workflows actions schema <packageId> <actionKey> | jq '.inputParameters'
+  $ clay workflows actions dynamic-fields <packageId> <actionKey> <param> --inputs '{"objectType":"companies"}'
 `
   );
   cmd.addCommand(applyClaySettings(buildListCommand5()));
   cmd.addCommand(applyClaySettings(buildSchemaCommand()));
+  cmd.addCommand(applyClaySettings(buildDynamicFieldsCommand()));
   return cmd;
 }
 
@@ -95014,7 +95109,10 @@ var ActionToolParameters = external_exports.record(
     type: external_exports.string(),
     description: external_exports.string(),
     required: external_exports.boolean(),
-    displayName: external_exports.string()
+    // Optional: it's a human label that static action params carry, but fields resolved
+    // dynamically and merged into the snapshot (parent|child) have none; consumers fall
+    // back to the param name. Required here rejected those runs with contract_mismatch.
+    displayName: external_exports.string().optional()
   })
 );
 var ActionToolData = external_exports.object({
@@ -96682,11 +96780,7 @@ Examples:
 
 // src/commands/workflows/runs/input.ts
 function readRunInputs(source) {
-  const parsed = readJsonFlag("--input", source);
-  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
-    throw new InvalidArgumentError("--input: must be a JSON object of workflow inputs");
-  }
-  return parsed;
+  return readJsonObjectFlag("--input", source);
 }
 
 // src/commands/workflows/runs/start.ts