@erdoai/cli 0.55.3 → 0.57.0

package/dist/index.js

@@ -694,8 +694,15 @@ var ErdoClient = class {
     const { runs } = await this.listAgentRuns({ thread: threadID, limit: 1 });
     return runs[0]?.id;
   }
-  listThreads() {
-    return this.request("GET", "/v1/threads");
+  listThreads(params) {
+    const q = new URLSearchParams();
+    if (params?.scope) q.set("scope", params.scope);
+    if (params?.orderBy) q.set("order_by", params.orderBy);
+    if (params?.includeAutomation) q.set("include_automation", "true");
+    if (params?.limit !== void 0) q.set("limit", String(params.limit));
+    if (params?.offset !== void 0) q.set("offset", String(params.offset));
+    const qs = q.toString();
+    return this.request("GET", `/v1/threads${qs ? `?${qs}` : ""}`);
   }
   getThreadMessages(threadId) {
     return this.request("GET", `/v1/threads/${encodeURIComponent(threadId)}/messages`);
@@ -880,6 +887,11 @@ var ErdoClient = class {
   setKnowledgeVisibility(id, visibility) {
     return this.request("PATCH", `/v1/knowledge/${id}/visibility`, { visibility });
   }
+  // asset_id is what a page's `assetId` field takes — attaching an image here
+  // is how it becomes something a published page can render.
+  attachKnowledgeAsset(objectID, input) {
+    return this.request("POST", `/v1/knowledge/${encodeURIComponent(objectID)}/attachments`, input);
+  }
   // --- automations (heartbeats) ---
   listHeartbeats() {
     return this.request("GET", "/v1/heartbeats");
@@ -2583,16 +2595,30 @@ agentCmd.command("thread").description("Create a thread; prints its id").option(
     fail(e);
   }
 });
-agentCmd.command("threads").description("List your threads").action(async () => {
-  try {
-    const { threads } = await new ErdoClient().listThreads();
-    for (const t of threads) {
-      console.log(`${t.id}	${t.name}	${t.created_by_user_name || t.created_by_user_id}	${t.source || "unrecorded"}`);
+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"
+).option(
+  "--include-automation",
+  "include automation/heartbeat-sourced threads, excluded by default \u2014 scope=org/shared only"
+).option("-l, --limit <n>", "max threads (default 20, max 100)", (v) => parseInt(v, 10)).option("--offset <n>", "pagination offset", (v) => parseInt(v, 10)).action(
+  async (opts) => {
+    try {
+      const { threads, total } = await new ErdoClient().listThreads(opts);
+      for (const t of threads) {
+        console.log(`${t.id}	${t.name}	${t.created_by_user_name || t.created_by_user_id}	${t.source || "unrecorded"}`);
+      }
+      const shown = (opts.offset ?? 0) + threads.length;
+      if (total > shown) {
+        console.error(`(showing ${threads.length} of ${total} \u2014 use --limit/--offset for more)`);
+      } else {
+        console.error(`(${total} thread${total === 1 ? "" : "s"})`);
+      }
+    } catch (e) {
+      fail(e);
     }
-  } catch (e) {
-    fail(e);
   }
-});
+);
 function contentBlockLabel(c) {
   const type = c.ui_content_type || c.content_type;
   const payload = c.content;
@@ -3338,7 +3364,10 @@ function grantList(v) {
   }
   return slugs;
 }
-pagesCmd.command("deploy").description("Deploy a page (HTML/React); --html/--js/--css accept @file").requiredOption("--title <title>", "page title").requiredOption("--html <htmlOr@file>", "HTML (or @path to a file)").option("--js <jsOr@file>", "JS/JSX (or @path)").option("--css <cssOr@file>", "CSS (or @path)").option("--runtime <runtime>", "react-tailwind (default) or none").option("--datasets <csv>", "dataset slugs the page reads").option("--writable-datasets <csv>", "dataset slugs the page may write via erdo.insertRows").option("--kv <csv>", "named KV-store slugs the page reads").option("--writable-kv <csv>", "named KV-store slugs the page may write").option("--public", "make the page publicly viewable").action(
+pagesCmd.command("deploy").description("Deploy a page (HTML/React); --html/--js/--css accept @file").requiredOption("--title <title>", "page title").requiredOption("--html <htmlOr@file>", "HTML (or @path to a file)").option("--js <jsOr@file>", "JS/JSX (or @path)").option("--css <cssOr@file>", "CSS (or @path)").option("--runtime <runtime>", "react-tailwind (default) or none").option(
+  "--meta-title <title>",
+  "public SEO title (browser tab + shared-link headline) \u2014 distinct from --title, the internal name"
+).option("--meta-description <description>", "public SEO description (shared-link preview / search result blurb)").option("--datasets <csv>", "dataset slugs the page reads").option("--writable-datasets <csv>", "dataset slugs the page may write via erdo.insertRows").option("--kv <csv>", "named KV-store slugs the page reads").option("--writable-kv <csv>", "named KV-store slugs the page may write").option("--public", "make the page publicly viewable").action(
   async (opts) => {
     try {
       const csv = (v) => v ? v.split(",").map((s) => s.trim()) : void 0;
@@ -3348,6 +3377,8 @@ pagesCmd.command("deploy").description("Deploy a page (HTML/React); --html/--js/
         js: readMaybeFile(opts.js),
         css: readMaybeFile(opts.css),
         runtime: opts.runtime,
+        meta_title: opts.metaTitle,
+        meta_description: opts.metaDescription,
         dataset_slugs: csv(opts.datasets),
         writable_dataset_slugs: csv(opts.writableDatasets),
         kv_slugs: csv(opts.kv),
@@ -3363,7 +3394,10 @@ pagesCmd.command("deploy").description("Deploy a page (HTML/React); --html/--js/
 );
 pagesCmd.command("update <id>").description(
   "Update an existing page by id; provided fields are merged (update just --js to keep html/css). --html/--js/--css accept @file"
-).option("--title <title>", "new title").option("--html <htmlOr@file>", "HTML (or @path to a file)").option("--js <jsOr@file>", "JS/JSX (or @path)").option("--css <cssOr@file>", "CSS (or @path)").option("--datasets <csv>", 'replacement read-dataset slugs ("[]" clears)').option("--writable-datasets <csv>", 'replacement writable-dataset slugs ("[]" clears)').option("--kv <csv>", 'replacement read KV-store slugs ("[]" clears)').option("--writable-kv <csv>", 'replacement writable KV-store slugs ("[]" clears)').option("--public", "make the page publicly viewable").option("--private", "make the page private").action(
+).option("--title <title>", "new title").option("--html <htmlOr@file>", "HTML (or @path to a file)").option("--js <jsOr@file>", "JS/JSX (or @path)").option("--css <cssOr@file>", "CSS (or @path)").option(
+  "--meta-title <title>",
+  'new public SEO title (omit to keep current; pass "" to clear back to the default)'
+).option("--meta-description <description>", 'new public SEO description (omit to keep current; pass "" to clear)').option("--datasets <csv>", 'replacement read-dataset slugs ("[]" clears)').option("--writable-datasets <csv>", 'replacement writable-dataset slugs ("[]" clears)').option("--kv <csv>", 'replacement read KV-store slugs ("[]" clears)').option("--writable-kv <csv>", 'replacement writable KV-store slugs ("[]" clears)').option("--public", "make the page publicly viewable").option("--private", "make the page private").action(
   async (id, opts) => {
     try {
       const res = await new ErdoClient().updatePage(id, {
@@ -3371,6 +3405,8 @@ pagesCmd.command("update <id>").description(
         html: readMaybeFile(opts.html),
         js: readMaybeFile(opts.js),
         css: readMaybeFile(opts.css),
+        meta_title: opts.metaTitle,
+        meta_description: opts.metaDescription,
         dataset_slugs: grantList(opts.datasets),
         writable_dataset_slugs: grantList(opts.writableDatasets),
         kv_slugs: grantList(opts.kv),
@@ -4031,6 +4067,30 @@ knowledgeCmd.command("visibility <id> <visibility>").description(
     fail(e);
   }
 });
+knowledgeCmd.command("attach <objectId> <file>").description(
+  "Attach an image or other small binary to a knowledge object as an org-hosted asset, and print its asset id \u2014 the value a page's assetId field takes. Pass a local path, or --url to have the service download it (the only path for video)."
+).option("--url <sourceUrl>", "download from this URL instead of reading a local file").option(
+  "-d, --description <text>",
+  "caption for the asset; for an image this is the only text search can match, so describe what is in the picture"
+).option("--media-type <mime>", "MIME type hint, e.g. image/jpeg; detected from the filename otherwise").action(
+  async (objectId, file, opts) => {
+    try {
+      const body = opts.url ? { filename: basename(file), source_url: opts.url } : {
+        filename: basename(file),
+        content_base64: readFileSync3(file).toString("base64")
+      };
+      print(
+        await new ErdoClient().attachKnowledgeAsset(objectId, {
+          ...body,
+          description: opts.description,
+          media_type: opts.mediaType
+        })
+      );
+    } catch (e) {
+      fail(e);
+    }
+  }
+);
 var autoCmd = program.command("automations").description("Scheduled automations (heartbeats)");
 autoCmd.command("list").description("List automations").action(async () => {
   try {

package/package.json

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