@fieldwork-ai/cli 0.17.2 → 0.23.0

package/README.md

@@ -16,11 +16,11 @@ Inside a Fieldwork compute container the CLI is preinstalled and pre-authenticat
 Every tool your account can use in chat (platform reads plus your org's connected integrations) is invocable by name. Arguments are one JSON object:
 
 ```bash
-fieldwork tool describe kb_search                 # description + input schema
-fieldwork tool run kb_search --args '{"query": "replenishment thresholds"}'
+fieldwork tool describe kb_grep                   # description + input schema
+fieldwork tool run kb_grep --args '{"pattern": "replenishment|reorder point", "-i": true}'
 echo '{"database": "Metrics DB", "sql": "select count(*) from orders"}' \
   | fieldwork tool run db_query --args -          # stdin for large payloads
-fieldwork tool run kb_search --args '{"query": "x"}' --arg query=override
+fieldwork tool run kb_grep --args '{"pattern": "x"}' --arg pattern=override
 ```
 
 `--arg key=value` overlays a string field; `--arg key:=json` parses the value as JSON. Tool-level errors (strings starting `Error:`) are data and exit 0; transport and auth failures use the exit codes below.
@@ -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.
@@ -63,6 +65,3 @@ Source stays in the private app repository under `cli/`. Run `pnpm install --fro
 
 The terminal chat client is the separate public `@fieldwork-ai/fieldwork-code` package (`fwcode`).
 
-## Graph authoring diagnostics
-
-Use `fieldwork tool run automations_graph_examples --json` for executable examples and the coordinated code/graph publication format. `automations_graph_validate` takes the publication input without committing it. `automations_graph_test` uses isolated editable-table fixtures and captured notifications; it does not execute authored code or send email. `automations_graph_wait` returns bounded, compact progress, and `automations_graph_trace` accepts `detail: "full"` when saved payloads are needed. Contract failures include source/destination paths, required coordinated changes and retryability on stderr with a nonzero exit code.

package/dist/commands/assets.js

@@ -155,12 +155,12 @@ const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/
  * a global system, its id for an org-authored one. Mirrors `connectorAddress`
  * in the app; the CLI is its own package and shares no code with it. */
 function dbAddressOf(c) {
-    return c.definition_is_global ? c.definition_key : c.connector_definition_id;
+    return c.definition_is_global ? c.definition_key : c.connector_id;
 }
 async function resolveDbConnector(database) {
     const body = await apiJson(`/api/organizations/${requireOrgId()}/db-connectors`);
     const found = UUID_RE.test(database)
-        ? body.connectors.find((c) => c.connector_definition_id === database)
+        ? body.connectors.find((c) => c.connector_id === database)
         : (body.connectors.find((c) => c.definition_key === database) ??
             body.connectors.find((c) => c.name === database) ??
             body.connectors.find((c) => c.display_name === database));

package/dist/commands/automations.js

@@ -71,27 +71,49 @@ async function followRun(automationId, runId, intervalSeconds, json) {
     }
 }
 export function registerAutomationCommands(program) {
-    const graph = program.command("automation-graph").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) => {
-        const body = await readFile(options.file, "utf8");
-        await confirm("Apply these triggers and enabled state?", getContext().yes);
-        printData(await apiJson(`/api/organizations/${requireOrgId()}/automations/${encodeURIComponent(id)}/graph`, { method: "PATCH", body }), true);
-    });
-    graph.command("control <automation-id> <run-id>").requiredOption("--file <path>", "Cancel, retry, or confirmed reconciliation").action(async (id, runId, options) => {
-        const body = await readFile(options.file, "utf8");
-        await confirm("Apply this run control? Confirm external results before reconciliation.", getContext().yes);
-        printData(await apiJson(`/api/organizations/${requireOrgId()}/automations/${encodeURIComponent(id)}/runs/${encodeURIComponent(runId)}/steps`, { method: "POST", body }), true);
-    });
-    graph.command("publish").requiredOption("--file <path>").action(async (options) => {
-        const body = await readFile(options.file, "utf8");
-        await confirm("Publish this graph and delegate its listed resource access?", getContext().yes);
-        printData(await apiJson(`/api/organizations/${requireOrgId()}/automations/graphs`, { method: "POST", body }), true);
-    });
     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", "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")
+        .action(async (name) => {
+        await confirm(`Run "${name}" now?`, getContext().yes);
+        await callTool("automations_run", { name });
+    });
+    automations
+        .command("examples")
+        .description("A working code automation")
+        .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("list")
         .description("List the automations you can see")
@@ -112,12 +134,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 +189,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

@@ -4,7 +4,7 @@ import { readBundle, writeBundle } from "../bundle.js";
 import { apiJson, getContext, requireOrgId } from "../http.js";
 import { EXIT, confirm, fail, note, printData } from "../output.js";
 async function resolveDefinition(key) {
-    const body = await apiJson(`/api/organizations/${requireOrgId()}/connector-definitions?include_drafts=true`);
+    const body = await apiJson(`/api/organizations/${requireOrgId()}/connectors/library?include_drafts=true`);
     const matches = (body.definitions ?? []).filter((d) => d.key === key);
     const definition = matches.find((d) => d.org_private) ?? matches[0];
     if (!definition) {
@@ -95,7 +95,7 @@ export function writeSecretsFile(out, secrets, opts) {
  * a global system, its id for an org-authored one whose key is only unique
  * within the org. Mirrors `connectorAddress` in the app. */
 function addressOf(c) {
-    return c.definition_is_global ? c.definition_key : c.connector_definition_id;
+    return c.definition_is_global ? c.definition_key : c.connector_id;
 }
 async function listConnectors() {
     const body = await apiJson(`/api/organizations/${requireOrgId()}/connectors`);
@@ -179,7 +179,7 @@ export function registerConnectorCommands(program) {
         if (opts.actionName)
             query.set("action_name", opts.actionName);
         const suffix = query.size ? `?${query}` : "";
-        const body = await apiJson(`/api/organizations/${requireOrgId()}/connector-definitions/${definition.connector_definition_id}/source${suffix}`);
+        const body = await apiJson(`/api/organizations/${requireOrgId()}/connectors/${definition.connector_id}/source${suffix}`);
         const dir = opts.out ?? key;
         const pulled = writeBundle(dir, body.files);
         if (json) {
@@ -212,7 +212,7 @@ export function registerConnectorCommands(program) {
             fail('the tree\'s connector.json must carry a "key" field', EXIT.usage);
         }
         await confirm(`Publish ${Object.keys(files).length} files to connector "${key}"${opts.actionName ? `, action "${opts.actionName}"` : ""}?`, yes);
-        const body = await apiJson(`/api/organizations/${requireOrgId()}/connector-definitions/publish`, {
+        const body = await apiJson(`/api/organizations/${requireOrgId()}/connectors/publish`, {
             method: "POST",
             body: JSON.stringify({
                 message: opts.message,
@@ -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()}/connectors/${id}/metadata`), 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()}/connectors/${id}/metadata`;
+        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/dist/commands/tables.d.ts

@@ -1,2 +1,3 @@
 import { Command } from "commander";
-export declare function tablesCommand(): Command;
+/** `fieldwork sheets`; also registered, hidden, under its old name `tables`. */
+export declare function sheetsCommand(name?: string): Command;

package/dist/commands/tables.js

@@ -2,18 +2,19 @@ import { readFile } from "node:fs/promises";
 import { Command } from "commander";
 import { apiJson, requireOrgId, getContext } from "../http.js";
 import { confirm, printData } from "../output.js";
-export function tablesCommand() {
-    const command = new Command("tables").description("Fieldwork Tables and editable records");
+/** `fieldwork sheets`; also registered, hidden, under its old name `tables`. */
+export function sheetsCommand(name = "sheets") {
+    const command = new Command(name).description("Sheets and their editable records");
     const base = () => `/api/organizations/${requireOrgId()}/tables`;
     command
         .command("list")
         .action(async () => printData(await apiJson(base()), true));
     command
         .command("create")
-        .requiredOption("--file <path>", "Table definition file")
+        .requiredOption("--file <path>", "Sheet definition file")
         .action(async (options) => {
         const body = await readFile(options.file, "utf8");
-        await confirm("Create this Fieldwork Table?", getContext().yes);
+        await confirm("Create this sheet?", getContext().yes);
         printData(await apiJson(base(), { method: "POST", body }), true);
     });
     command

package/dist/http.js

@@ -121,16 +121,6 @@ export async function apiJson(pathname, init = {}) {
             const { path, message } = issue;
             return typeof message === "string" ? [`${Array.isArray(path) ? path.join(".") + ": " : ""}${message}`] : [];
         }) : [];
-        if (body?.code === "invalid_graph" && body.details && typeof body.details === "object" && !Array.isArray(body.details)) {
-            const diagnostic = body.details;
-            for (const key of ["action_definition_id", "automation_id", "automation_revision_id", "node_id", "source", "destination", "input", "output", "source_schema", "target_schema", "effect_changed", "credential_changed", "required_action"]) {
-                const value = diagnostic[key];
-                if (value !== undefined && value !== null)
-                    details.push(`${key}: ${typeof value === "string" ? value : JSON.stringify(value)}`);
-            }
-            if (typeof body.retryable === "boolean")
-                details.push(`retryable: ${body.retryable}`);
-        }
         const prefix = typeof body?.tool === "string" ? `${body.tool}: ` : "";
         fail([prefix + message, ...details].join("\n"), exitCodeFor(res.status));
     }

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { tablesCommand } from "./commands/tables.js";
+import { sheetsCommand } from "./commands/tables.js";
 import { Command } from "commander";
 import { createRequire } from "node:module";
 import { initContext } from "./http.js";
@@ -41,7 +41,8 @@ registerAppCommands(program);
 registerAutomationCommands(program);
 registerTaskCommands(program);
 registerConnectorCommands(program);
-program.addCommand(tablesCommand());
+program.addCommand(sheetsCommand());
+program.addCommand(sheetsCommand("tables"), { hidden: true });
 program.parseAsync(process.argv).catch((err) => {
     process.stderr.write(`fieldwork: ${err instanceof Error ? err.message : String(err)}\n`);
     process.exit(1);

package/package.json

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