@erdoai/cli 0.109.1 → 0.111.0

package/dist/index.js

@@ -1067,6 +1067,14 @@ var ErdoClient = class {
       input
     );
   }
+  async deleteThread(threadID) {
+    try {
+      await this.request("DELETE", `/v1/threads/${encodeURIComponent(threadID)}`);
+    } catch (err) {
+      if (err instanceof ErdoApiError && err.status === 404) return;
+      throw err;
+    }
+  }
   sendMessage(threadID, input) {
     return this.request(
       "POST",
@@ -1141,6 +1149,11 @@ var ErdoClient = class {
     const qs = q.toString();
     return this.request("GET", `/v1/datasets-purposes${qs ? `?${qs}` : ""}`);
   }
+  // 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) {
+    return this.request("POST", "/v1/datasets-create", input);
+  }
   ensureDataset(input) {
     return this.request("POST", "/v1/datasets-ensure", input);
   }
@@ -3962,17 +3975,26 @@ agentCmd.command("wait <threadId>").description("Re-attach to a thread's latest
     fail(e);
   }
 });
-agentCmd.command("thread").description("Create a thread; prints its id").option("-n, --name <name>", "thread name").option("-d, --datasets <csv>", "dataset UUIDs to attach").action(async (opts) => {
+agentCmd.command("thread").description("Create a thread; prints its id").option("-n, --name <name>", "thread name").option("-d, --datasets <csv>", "dataset UUIDs to attach").option("--hidden", "keep the thread out of the organization's thread list (for diagnostic or scripted threads)").action(async (opts) => {
   try {
     const res = await new ErdoClient().createThread({
       name: opts.name,
-      dataset_ids: opts.datasets ? opts.datasets.split(",").map((s) => s.trim()) : void 0
+      dataset_ids: opts.datasets ? opts.datasets.split(",").map((s) => s.trim()) : void 0,
+      visibility: opts.hidden ? "hidden" : void 0
     });
     console.log(res.id);
   } catch (e) {
     fail(e);
   }
 });
+agentCmd.command("delete").description("Permanently delete a thread and its messages (needs admin on the thread: you created it, or you are an org admin)").argument("<threadId>", "thread UUID").action(async (threadId) => {
+  try {
+    await new ErdoClient().deleteThread(threadId);
+    console.log(`deleted ${threadId}`);
+  } catch (e) {
+    fail(e);
+  }
+});
 agentCmd.command("threads").description("List threads (default: your own; --scope org/shared for organization-wide)").option("-s, --scope <scope>", "own (default) | org | shared \u2014 org/shared require org membership").option(
   "--order-by <order>",
   "created_at (default) | activity (last message time) \u2014 scope=org/shared only"
@@ -6502,15 +6524,37 @@ datasetsCmd.command("purposes").description(
     fail(e);
   }
 });
+function readSchemaFile(path) {
+  const parsed = JSON.parse(readFileSync4(path, "utf8"));
+  const schema = Array.isArray(parsed) ? { columns: parsed } : parsed;
+  if (!schema || !Array.isArray(schema.columns)) {
+    throw new Error('--schema must contain a JSON columns array or {"columns": [...]} object');
+  }
+  return schema;
+}
+datasetsCmd.command("create <name>").description(
+  "Create an empty dataset with its columns declared up front. Every write is checked against the schema, which is set now rather than taken from the first rows. --schema is required unless the purpose is one whose columns Erdo defines (page events, widget events, widget leads)."
+).option("--schema <file>", "JSON file containing { columns: [...] } or a columns array").option("--purpose <purpose>", "the dataset's role in the org vocabulary, e.g. leads (see `erdo datasets purposes`)").option("--purpose-description <text>", "what writes and reads this purpose").option("--description <text>", "what the dataset holds").option("--separate", "deliberately create a second dataset for a purpose the org already has").action(async (name, opts) => {
+  try {
+    const result = await new ErdoClient().createDataset({
+      name,
+      ...opts.schema ? { schema: readSchemaFile(opts.schema) } : {},
+      ...opts.purpose ? { purpose: opts.purpose } : {},
+      ...opts.purposeDescription ? { purpose_description: opts.purposeDescription } : {},
+      ...opts.description ? { description: opts.description } : {},
+      ...opts.separate ? { separate_dataset: true } : {}
+    });
+    console.log(`${result.slug}	created${result.purpose ? `	${result.purpose}` : ""}`);
+    for (const warning of result.warnings ?? []) console.error(`warning: ${warning}`);
+  } catch (e) {
+    fail(e);
+  }
+});
 datasetsCmd.command("ensure <purpose>").description(
   "Create or reuse the one dataset for a purpose and verify its declared producer contract. Refuses legacy splits and incompatible populated datasets instead of choosing silently."
 ).requiredOption("--schema <file>", "JSON file containing { columns: [...] } or a columns array").option("--name <name>", "dataset name when creation is required").option("--description <text>", "dataset description when creation is required").option("--purpose-description <text>", "what writes and reads this purpose").option("--preferred-dataset <slug>", "existing bound dataset slug or id to adopt").option("--email-column <name>", "for a leads purpose: which declared column holds the email (default email)").option("--phone-column <name>", "for a leads purpose: which declared column holds the phone (default phone)").action(async (purpose, opts) => {
   try {
-    const parsed = JSON.parse(readFileSync4(opts.schema, "utf8"));
-    const declaredSchema = Array.isArray(parsed) ? { columns: parsed } : parsed;
-    if (!declaredSchema || !Array.isArray(declaredSchema.columns)) {
-      throw new Error('--schema must contain a JSON columns array or {"columns": [...]} object');
-    }
+    const declaredSchema = readSchemaFile(opts.schema);
     const result = await new ErdoClient().ensureDataset({
       purpose,
       ...opts.name ? { name: opts.name } : {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@erdoai/cli",
-  "version": "0.109.1",
+  "version": "0.111.0",
   "description": "Erdo CLI — drive datasets, pages, and evals from the terminal or CI",
   "type": "module",
   "bin": {