@fieldwork-ai/cli 0.17.2 → 0.19.0

package/README.md

@@ -43,6 +43,8 @@ Mutations prompt for confirmation on a TTY; pass `--yes` to skip (required in no
 
 The connector development loop end to end: `connectors pull acme_erp` → edit the adapter → `connectors publish acme_erp --message "…" --base-revision N` (a new key creates the definition from the tree's `connector.json`) → `connectors connect acme_erp --spec spec.json` → `connectors secrets set <id>` → `automations run-now <sync> --follow` to watch the logs.
 
+Publishing initializes a new connector from `connector.json`, but subsequent action revisions leave `connector_definitions` metadata unchanged. To edit its display name, description, branding, or REST secret-name hints, use `fieldwork connectors metadata <definition-id>`, then `fieldwork connectors update-metadata <definition-id> --changes changes.json --expected-updated-at '<exact updated_at from the read>'`. The update requires connector edit access and rejects stale reads; credential values are managed separately through `secrets`.
+
 ## Auth and configuration
 
 Credential resolution order: the injected container file (`~/.fieldwork/credentials`) → `FIELDWORK_TOKEN` / `FIELDWORK_API_URL` environment variables → the `fieldwork login` config (`~/.config/fieldwork/config.json`). One token binds one organization; `fieldwork orgs use` re-runs the browser flow to switch. Revoke a login anytime in Fieldwork under Settings → Connected apps.

package/dist/commands/automations.js

@@ -71,7 +71,9 @@ async function followRun(automationId, runId, intervalSeconds, json) {
     }
 }
 export function registerAutomationCommands(program) {
-    const graph = program.command("automation-graph").description("Publish and inspect automation graphs");
+    const graph = program
+        .command("automation-graph", { hidden: true })
+        .description("Publish and inspect automation graphs");
     graph.command("get <automation-id>").action(async (id) => printData(await apiJson(`/api/organizations/${requireOrgId()}/automations/${encodeURIComponent(id)}/graph`), true));
     graph.command("trace <automation-id> <run-id>").action(async (id, runId) => printData(await apiJson(`/api/organizations/${requireOrgId()}/automations/${encodeURIComponent(id)}/runs/${encodeURIComponent(runId)}/steps`), true));
     graph.command("configure <automation-id>").requiredOption("--file <path>").action(async (id, options) => {
@@ -91,7 +93,61 @@ export function registerAutomationCommands(program) {
     });
     const automations = program
         .command("automations")
-        .description("Standing instructions that run unattended (schedules, webhooks)");
+        .description("Create, manage and inspect automations");
+    const callTool = async (name, args) => {
+        const response = await apiJson("/api/tools/run", {
+            method: "POST",
+            body: JSON.stringify({ name, args }),
+        });
+        printData(response.result, true);
+    };
+    for (const operation of ["publish", "validate", "test", "update"]) {
+        automations
+            .command(operation)
+            .description(`${operation} an automation`)
+            .requiredOption("--file <path>")
+            .action(async (options) => {
+            const input = JSON.parse(await readFile(options.file, "utf8"));
+            if (operation === "publish" || operation === "update")
+                await confirm(`Apply this automation ${operation}?`, getContext().yes);
+            await callTool(`automations_${operation}`, input);
+        });
+    }
+    automations
+        .command("run <name>")
+        .description("Start a real automation run")
+        .option("--input <path>", "File containing the run input")
+        .action(async (name, options) => {
+        const input = options.input
+            ? JSON.parse(await readFile(options.input, "utf8"))
+            : undefined;
+        await confirm(`Run "${name}" now?`, getContext().yes);
+        await callTool("automations_run", { name, input });
+    });
+    automations
+        .command("examples")
+        .description("Working automation definitions and tests")
+        .action(() => callTool("automations_examples", {}));
+    for (const operation of ["get-run", "wait"]) {
+        automations
+            .command(`${operation} <name> <run-id>`)
+            .description(operation === "wait" ? "Wait briefly for a run" : "Inspect one run")
+            .action((name, runId) => callTool(`automations_${operation.replaceAll("-", "_")}`, {
+            name,
+            automation_run_id: runId,
+            ...(operation === "get-run" ? { detail: "full" } : {}),
+        }));
+    }
+    automations
+        .command("control <name> <run-id>")
+        .description("Cancel, retry, or reconcile a run")
+        .requiredOption("--file <path>")
+        .action(async (name, runId, options) => {
+        const found = await resolveAutomation(name);
+        const body = await readFile(options.file, "utf8");
+        await confirm("Apply this run control? Verify external results before reconciliation.", getContext().yes);
+        printData(await apiJson(`/api/organizations/${requireOrgId()}/automations/${found.automation_id}/runs/${encodeURIComponent(runId)}/steps`, { method: "POST", body }), true);
+    });
     automations
         .command("list")
         .description("List the automations you can see")
@@ -112,12 +168,8 @@ export function registerAutomationCommands(program) {
     });
     automations
         .command("get <name>")
-        .description("One automation in full (includes the webhook URL — treat as a credential)")
-        .action(async (name) => {
-        const found = await resolveAutomation(name);
-        const body = await apiJson(`/api/organizations/${requireOrgId()}/automations/${found.automation_id}`);
-        printData(body, getContext().json);
-    });
+        .description("Read an automation definition, settings and recent runs")
+        .action((name) => callTool("automations_get", { name }));
     const setEnabled = (enabled) => async (name) => {
         const { json, yes } = getContext();
         const found = await resolveAutomation(name);
@@ -171,10 +223,14 @@ export function registerAutomationCommands(program) {
         .action(async (name, opts) => {
         const { json } = getContext();
         const found = await resolveAutomation(name);
-        const query = opts.run ? `?run=${encodeURIComponent(opts.run)}` : "?limit=1";
+        const query = opts.run
+            ? `?run=${encodeURIComponent(opts.run)}`
+            : "?limit=1";
         const run = (await fetchRuns(found.automation_id, query))[0];
         if (!run) {
-            fail(opts.run ? `no run ${opts.run} for "${name}"` : `"${name}" has no runs yet`, EXIT.notFound);
+            fail(opts.run
+                ? `no run ${opts.run} for "${name}"`
+                : `"${name}" has no runs yet`, EXIT.notFound);
         }
         printRun(run, json);
     });

package/dist/commands/connectors.js

@@ -223,6 +223,26 @@ export function registerConnectorCommands(program) {
         });
         printData(body, json);
     });
+    connectors.command("metadata <definition-id>")
+        .description("Read an org-private connector definition's editable metadata")
+        .action(async (id) => {
+        printData(await apiJson(`/api/organizations/${requireOrgId()}/connector-definitions/${id}`), getContext().json);
+    });
+    connectors.command("update-metadata <definition-id>")
+        .description("Edit connector metadata separately from action code")
+        .requiredOption("--changes <json-file>", "metadata fields to change")
+        .requiredOption("--expected-updated-at <timestamp>", "exact updated_at from metadata read")
+        .action(async (id, opts) => {
+        const url = `/api/organizations/${requireOrgId()}/connector-definitions/${id}`;
+        const before = await apiJson(url);
+        if (before.updated_at !== opts.expectedUpdatedAt)
+            fail("Connector metadata changed; read it again before updating", EXIT.conflict);
+        const changes = JSON.parse(readFileSync(opts.changes, "utf8"));
+        await confirm(`Update connector metadata? Before: ${JSON.stringify(before.metadata)} Changes: ${JSON.stringify(changes)}`, getContext().yes);
+        printData(await apiJson(url, {
+            method: "PATCH", body: JSON.stringify({ expected_updated_at: opts.expectedUpdatedAt, changes }),
+        }), getContext().json);
+    });
     const secrets = connectors
         .command("secrets")
         .description("Connector credentials (values never transit argv or stdout)");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fieldwork-ai/cli",
-  "version": "0.17.2",
+  "version": "0.19.0",
   "description": "Fieldwork asset-management CLI",
   "license": "UNLICENSED",
   "type": "module",