@erdoai/cli 0.117.1 → 0.119.0

package/README.md

@@ -11,7 +11,7 @@ npx @erdoai/cli --help       # or run without installing
 erdo update                  # self-update to the latest published version
 ```
 
-Requires Node.js 18+. User-facing install docs: https://docs.erdo.ai/cli
+Requires Node.js 22.13+. User-facing install docs: https://docs.erdo.ai/cli
 
 When a newer version is published, every command prints one line on **stderr**
 naming the installed version and `erdo update`. It is on stderr so stdout stays

package/dist/index.js

@@ -1075,6 +1075,25 @@ var ErdoClient = class {
       throw err;
     }
   }
+  // The thread owns the current invocation identity. Approval resumes create a
+  // new invocation while deliberately reusing the original agent run, so the
+  // run list is not an authoritative source for cancellation.
+  getThreadCompletionStatus(threadID) {
+    return this.request(
+      "GET",
+      `/v1/threads/${encodeURIComponent(threadID)}/completion-status`
+    );
+  }
+  // cancelThreadInvocation names the invocation being stopped. The thread
+  // service refuses (HTTP 400, "the run already changed") when the thread has
+  // moved on to another invocation, so a replacement run is never cancelled.
+  cancelThreadInvocation(threadID, invocationID) {
+    return this.request(
+      "POST",
+      `/v1/threads/${encodeURIComponent(threadID)}/cancel-invocation`,
+      { invocation_id: invocationID }
+    );
+  }
   sendMessage(threadID, input) {
     return this.request(
       "POST",
@@ -1149,6 +1168,13 @@ var ErdoClient = class {
     const qs = q.toString();
     return this.request("GET", `/v1/datasets-purposes${qs ? `?${qs}` : ""}`);
   }
+  // Reads the declared write contract through the slug-addressed fetch route's
+  // declared_schema view. That route is the one a dataset-scoped API key can
+  // reach (and is confined to its own datasets there); the dataset-details
+  // route is not, because its response also names other datasets.
+  getDatasetDeclaredSchema(slug) {
+    return this.request("POST", `/v1/datasets/${encodeURIComponent(slug)}/fetch`, { view: "declared_schema" });
+  }
   // Create an empty dataset with its declared columns. The server refuses a
   // create without a schema unless the purpose's columns are platform-defined.
   createDataset(input) {
@@ -1583,6 +1609,15 @@ var ErdoClient = class {
     );
   }
   // --- knowledge ---
+  getKnowledge(id) {
+    return this.request("GET", `/v1/knowledge/${encodeURIComponent(id)}`);
+  }
+  updateKnowledge(id, input) {
+    return this.request("POST", `/v1/knowledge/${encodeURIComponent(id)}/actions`, {
+      action: "update",
+      ...input
+    });
+  }
   listKnowledge(visibility, options) {
     const params = new URLSearchParams();
     if (visibility) params.set("visibility", visibility);
@@ -1719,6 +1754,7 @@ var ErdoClient = class {
   // what the evidence said afterwards. Referenced by slug, never UUID.
   listDecisions(opts) {
     const params = new URLSearchParams();
+    if (opts.organization_slug) params.set("organization_slug", opts.organization_slug);
     if (opts.workstream_slug) params.set("workstream_slug", opts.workstream_slug);
     if (opts.source) params.set("source", opts.source);
     if (opts.decision_class) params.set("decision_class", opts.decision_class);
@@ -3974,6 +4010,24 @@ agentCmd.command("send <threadId> <message>").description("Send a message to a t
     fail(e);
   }
 });
+agentCmd.command("cancel <threadId>").description("Request cancellation of a thread's active invocation; read the run to confirm it has stopped").option("--invocation <id>", "invocation to cancel (default: the thread's current invocation)").action(async (threadId, opts) => {
+  try {
+    const client = new ErdoClient();
+    let invocationID = opts.invocation;
+    if (!invocationID) {
+      const current = await client.getThreadCompletionStatus(threadId);
+      invocationID = current.invocation_id;
+      if (!invocationID) throw new Error(`thread ${threadId} has no invocation to cancel`);
+    }
+    const result = await client.cancelThreadInvocation(threadId, invocationID);
+    if (!result.success) {
+      throw new Error("cancellation could not be confirmed; inspect the thread's latest run and retry");
+    }
+    console.log(JSON.stringify(result, null, 2));
+  } catch (e) {
+    fail(e);
+  }
+});
 agentCmd.command("wait <threadId>").description("Re-attach to a thread's latest run and wait for it to finish; prints the answer").action(async (threadId) => {
   try {
     const client = new ErdoClient();
@@ -4254,7 +4308,7 @@ function renderReportEffect(e) {
     console.log(`    outcome: ${e.outcome_label}`);
   }
 }
-decisionsCmd.command("list").description("List decisions, newest first").option("--workstream <slug>", "only decisions filed under this workstream/Strategy").option(
+decisionsCmd.command("list").description("List decisions, newest first").option("--organization <slug>", "read an authorized client organization (default: active organization)").option("--workstream <slug>", "only decisions filed under this workstream/Strategy").option(
   "--source <source>",
   "producer family: approval | escalation | engine_gate | allocator | experiment | workstream_commitment"
 ).option("--class <class>", "decision class, e.g. paid_media.ad_group.pause").option("--subject-kind <kind>", "only decisions about this kind of subject").option("--subject-ref <id>", "only decisions about this exact subject").option(
@@ -4267,6 +4321,7 @@ decisionsCmd.command("list").description("List decisions, newest first").option(
   async (opts) => {
     try {
       const res = await new ErdoClient().listDecisions({
+        organization_slug: opts.organization,
         workstream_slug: opts.workstream,
         source: opts.source,
         decision_class: opts.class,
@@ -6747,10 +6802,36 @@ Read one with: erdo datasets fetch ${res.dataset_slug} --revision <id> --sql "SE
   }
 });
 datasetsCmd.command("schema <slug>").alias("describe").description(
-  "Show a dataset's physical columns \u2014 the names and types you can reference in `datasets fetch --sql`, read from the stored `data` table itself (DuckDB DESCRIBE) so they are what is actually there, not what was declared. For a database or warehouse dataset, DESCRIBE its real table names instead: `datasets fetch <slug> --sql 'DESCRIBE <table>'`."
-).option("--json", "print the raw JSON result instead of a table").action(async (slug, opts) => {
+  "Show physical columns by default, or the declared write contract with --declared. Physical columns are the names and types you can reference in `datasets fetch --sql`, read from the stored `data` table itself (DuckDB DESCRIBE) so they are what is actually there, not what was declared. For a database or warehouse dataset, DESCRIBE its real table names instead: `datasets fetch <slug> --sql 'DESCRIBE <table>'`."
+).option("--json", "print the raw JSON result instead of a table").option("--declared", "read the declared write contract (column names, type hints, required flags, semantic roles) instead of the physical columns").action(async (slug, opts) => {
   try {
-    const res = await new ErdoClient().fetchDatasetContents(slug, { sql_query: "DESCRIBE data" });
+    const client = new ErdoClient();
+    if (opts.declared) {
+      const res2 = await client.getDatasetDeclaredSchema(slug);
+      if (!res2 || typeof res2 !== "object" || res2.view !== "declared_schema")
+        throw new Error("Invalid dataset schema response: the server did not answer the declared_schema view");
+      const schema = res2.declared_schema;
+      if (schema != null && (!Array.isArray(schema.columns) || schema.columns.some((column) => !column || typeof column.name !== "string" || !column.name.trim())))
+        throw new Error("Invalid dataset schema response: declared columns are malformed");
+      if (opts.json) {
+        print(res2);
+        return;
+      }
+      if (schema == null) {
+        console.log(`${slug} has no declared column contract. Use datasets schema ${slug} to inspect physical columns.`);
+        return;
+      }
+      if (!schema.columns.length) {
+        console.log(`${slug}'s declared column contract contains no columns.`);
+        return;
+      }
+      printAlignedTable(
+        ["column", "type", "required", "semantic role", "description"],
+        schema.columns.map((column) => [column.name, column.type || "", column.required ? "yes" : "no", column.semantic_role || "", column.description || ""])
+      );
+      return;
+    }
+    const res = await client.fetchDatasetContents(slug, { sql_query: "DESCRIBE data" });
     if (opts.json) {
       print(res);
       return;
@@ -8142,6 +8223,36 @@ pipelinesCmd.command("executions <slug>").description("Show an event pipeline's
   }
 });
 var knowledgeCmd = program.command("knowledge").description("Knowledge objects");
+knowledgeCmd.command("get <id>").description("Get one full typed Knowledge object, including links and related objects").action(async (id) => {
+  try {
+    print(await new ErdoClient().getKnowledge(id));
+  } catch (e) {
+    fail(e);
+  }
+});
+knowledgeCmd.command("update <id>").description("Update a Knowledge object while preserving fields omitted from the command").option("--body <value>", "new body text, or @file; pass an empty value to clear the body").option("--config <file>", "JSON object file containing the complete replacement config, or @file").option("--title <title>", "new title").action(async (id, opts) => {
+  try {
+    if (opts.title === void 0 && opts.body === void 0 && opts.config === void 0) {
+      throw new Error("provide at least one of --title, --body, or --config");
+    }
+    if (opts.title !== void 0 && !opts.title.trim()) {
+      throw new Error("title must not be empty");
+    }
+    const replacementConfig = opts.config === void 0 ? void 0 : readJSONObject(opts.config.startsWith("@") ? opts.config.slice(1) : opts.config, "--config");
+    const replacementBody = opts.body === void 0 ? void 0 : readMaybeFile(opts.body) ?? "";
+    const client = new ErdoClient();
+    const current = await client.getKnowledge(id);
+    const object = current.object;
+    print(await client.updateKnowledge(id, {
+      title: opts.title ?? object.title,
+      body_markdown: replacementBody ?? object.body_markdown,
+      config_json: replacementConfig ?? object.config_json,
+      expected_updated_at: object.updated_at
+    }));
+  } catch (e) {
+    fail(e);
+  }
+});
 knowledgeCmd.command("list").description("List knowledge objects").option(
   "--public",
   "only entries opted into anonymous external surfaces (website widgets)"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@erdoai/cli",
-  "version": "0.117.1",
+  "version": "0.119.0",
   "description": "Erdo CLI — drive datasets, pages, and evals from the terminal or CI",
   "type": "module",
   "bin": {
@@ -11,7 +11,7 @@
     "scripts/postinstall.mjs"
   ],
   "engines": {
-    "node": ">=18"
+    "node": "^22.13.0 || >=23.5.0"
   },
   "publishConfig": {
     "access": "public",
@@ -41,14 +41,14 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@inquirer/prompts": "^7.5.0",
-    "commander": "^12.1.0"
+    "@inquirer/prompts": "^8.7.3",
+    "commander": "^15.0.0"
   },
   "devDependencies": {
-    "@types/node": "^22.0.0",
-    "tsup": "^8.0.0",
-    "tsx": "^4.0.0",
-    "typescript": "^5.7.0"
+    "@types/node": "^26.6.4",
+    "tsup": "^8.5.1",
+    "tsx": "^4.23.15",
+    "typescript": "^7.0.2"
   },
   "overrides": {
     "esbuild": "^0.28.1"