@fieldwork-ai/cli 0.19.0 → 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.
@@ -65,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,26 +71,6 @@ async function followRun(automationId, runId, intervalSeconds, json) {
     }
 }
 export function registerAutomationCommands(program) {
-    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) => {
-        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("Create, manage and inspect automations");
@@ -101,7 +81,7 @@ export function registerAutomationCommands(program) {
         });
         printData(response.result, true);
     };
-    for (const operation of ["publish", "validate", "test", "update"]) {
+    for (const operation of ["publish", "update"]) {
         automations
             .command(operation)
             .description(`${operation} an automation`)
@@ -116,17 +96,13 @@ export function registerAutomationCommands(program) {
     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;
+        .action(async (name) => {
         await confirm(`Run "${name}" now?`, getContext().yes);
-        await callTool("automations_run", { name, input });
+        await callTool("automations_run", { name });
     });
     automations
         .command("examples")
-        .description("Working automation definitions and tests")
+        .description("A working code automation")
         .action(() => callTool("automations_examples", {}));
     for (const operation of ["get-run", "wait"]) {
         automations
@@ -138,16 +114,6 @@ export function registerAutomationCommands(program) {
             ...(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")

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,
@@ -226,14 +226,14 @@ export function registerConnectorCommands(program) {
     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);
+        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()}/connector-definitions/${id}`;
+        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);

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.19.0",
+  "version": "0.23.0",
   "description": "Fieldwork asset-management CLI",
   "license": "UNLICENSED",
   "type": "module",