@erdoai/cli 0.79.0 → 0.81.0

package/dist/index.js

@@ -508,6 +508,32 @@ var ErdoClient = class {
       { session_id: sessionID, ...widget ? { widget } : {} }
     );
   }
+  // Text conversations on those same numbers. A conversation is one Erdo number
+  // and one person, for as long as they keep texting — so it is addressed by its
+  // session id rather than by a message id, and narrowed by the two numbers
+  // rather than by an agent slug and a direction.
+  listSMSConversations(params) {
+    const q = new URLSearchParams();
+    if (params?.phone_number) q.set("phone_number", params.phone_number);
+    if (params?.address) q.set("address", params.address);
+    if (params?.limit !== void 0) q.set("limit", String(params.limit));
+    if (params?.cursor) q.set("cursor", params.cursor);
+    const qs = q.toString();
+    return this.request(
+      "GET",
+      `/v1/voice/sms-conversations${qs ? `?${qs}` : ""}`
+    );
+  }
+  getSMSConversation(sessionID, params) {
+    const q = new URLSearchParams();
+    if (params?.limit !== void 0) q.set("limit", String(params.limit));
+    if (params?.cursor) q.set("cursor", params.cursor);
+    const qs = q.toString();
+    return this.request(
+      "GET",
+      `/v1/voice/sms-conversations/${encodeURIComponent(sessionID)}${qs ? `?${qs}` : ""}`
+    );
+  }
   // Run a read-only HogQL query against the org's page-analytics events. Rows are
   // positional per columns; enabled:false means page analytics is off for the org
   // (not zero traffic). A rejected query surfaces PostHog's message as the error.
@@ -1093,9 +1119,21 @@ var ErdoClient = class {
     const qs = schemaName ? `?schema_name=${encodeURIComponent(schemaName)}` : "";
     return this.request("GET", `/v1/integrations/${encodeURIComponent(integration)}/tables${qs}`);
   }
+  // `provided_by_organization_slug` marks a connection your manager
+  // organization lends to you rather than one this org connected. It is usable
+  // exactly like your own for as long as the management link lives, and is not
+  // yours to rotate or disconnect.
   listIntegrations() {
     return this.request("GET", "/v1/integrations");
   }
+  // Start or stop lending a connection to the organizations this one manages.
+  // `managed_organizations` names the orgs it now serves — empty when this org
+  // manages nobody yet, which is a truthful answer rather than a failure.
+  setIntegrationManagedAccess(integrationId, managedAccess) {
+    return this.request("POST", `/v1/integrations/${encodeURIComponent(integrationId)}/managed-access`, {
+      managed_access: managedAccess
+    });
+  }
   // For a Pipedream-backed integration this is the full disconnect: the
   // credential is released at the provider and the connection removed, not just
   // the integration row deleted.
@@ -4834,7 +4872,7 @@ sentEmailsCmd.command("get <emailID>").description("Read one sent email, includi
     fail(e);
   }
 });
-var voiceCmd = program.command("voice").description("Read voice agent phone calls and website widget conversations");
+var voiceCmd = program.command("voice").description("Read a voice agent's phone calls, text conversations and website widget conversations");
 function contactLabel(contact) {
   if (!contact) return "-";
   const name = [contact.first_name, contact.last_name].filter(Boolean).join(" ");
@@ -4980,6 +5018,103 @@ widgetConversationsCmd.command("get <sessionID>").description(
     fail(e);
   }
 });
+var voiceSMSCmd = voiceCmd.command("sms").description("Text conversations on a voice agent's own number");
+voiceSMSCmd.command("list").description("List the organization's SMS conversations, most recently active first").option("--phone-number <number>", "only conversations on this Erdo number (any format)").option("--address <number>", "only the conversation with this person (any format)").option("--limit <n>", "page size (default 25, max 100)").option("--cursor <cursor>", "next_cursor from the preceding page (stable paging)").option("--json", "print the raw JSON result instead of a table").action(
+  async (opts) => {
+    try {
+      const res = await new ErdoClient().listSMSConversations({
+        phone_number: opts.phoneNumber,
+        address: opts.address,
+        limit: opts.limit ? Number(opts.limit) : void 0,
+        cursor: opts.cursor
+      });
+      if (opts.json) {
+        print(res);
+        return;
+      }
+      const conversations = res.conversations ?? [];
+      if (conversations.length === 0) {
+        console.log("No SMS conversations match those filters.");
+        return;
+      }
+      printAlignedTable(
+        ["session id", "phone", "address", "msgs", "last inbound", "last outbound", "summary"],
+        conversations.map((c) => [
+          c.session_id,
+          c.phone_number,
+          // An opted-out conversation is marked on the person, since that is
+          // what the flag governs: nothing may text THEM until they send START.
+          c.suppressed ? `${c.address} (suppressed)` : c.address,
+          c.message_count,
+          c.last_inbound_at ?? "",
+          c.last_outbound_at ?? "",
+          c.summary
+        ])
+      );
+      process.stderr.write(`showing ${conversations.length} conversation(s)
+`);
+      if (res.next_cursor) {
+        process.stderr.write(`more available \u2014 re-run with --cursor ${res.next_cursor}
+`);
+      }
+    } catch (e) {
+      fail(e);
+    }
+  }
+);
+voiceSMSCmd.command("get <sessionID>").description("Read one SMS conversation: its metadata, then every text oldest first").option("--limit <n>", "texts per page (default 50, max 200)").option("--cursor <cursor>", "next_cursor from the preceding page of texts").option("--json", "print the raw JSON result instead of a table").action(
+  async (sessionID, opts) => {
+    try {
+      const res = await new ErdoClient().getSMSConversation(sessionID, {
+        limit: opts.limit ? Number(opts.limit) : void 0,
+        cursor: opts.cursor
+      });
+      if (opts.json) {
+        print(res);
+        return;
+      }
+      const c = res.conversation;
+      printAlignedTable(
+        ["session id", "phone", "address", "msgs", "last inbound", "last outbound", "summary"],
+        [
+          [
+            c.session_id,
+            c.phone_number,
+            c.suppressed ? `${c.address} (suppressed)` : c.address,
+            c.message_count,
+            c.last_inbound_at ?? "",
+            c.last_outbound_at ?? "",
+            c.summary
+          ]
+        ]
+      );
+      const messages = res.messages ?? [];
+      if (messages.length === 0) {
+        console.log("\nNo texts have been recorded in this conversation yet.");
+        return;
+      }
+      console.log("");
+      printAlignedTable(
+        ["at", "direction", "status", "media", "body"],
+        messages.map((m) => [
+          m.created_at,
+          m.direction,
+          m.status,
+          m.num_media > 0 ? m.num_media : "",
+          m.body
+        ])
+      );
+      process.stderr.write(`showing ${messages.length} text(s), oldest first
+`);
+      if (res.next_cursor) {
+        process.stderr.write(`more available \u2014 re-run with --cursor ${res.next_cursor}
+`);
+      }
+    } catch (e) {
+      fail(e);
+    }
+  }
+);
 var datasetsCmd = program.command("datasets").description("Datasets");
 datasetsCmd.command("list").description("List datasets").option(
   "--class <class>",
@@ -5296,7 +5431,10 @@ var integrationsCmd = program.command("integrations").description("Connect and i
 integrationsCmd.command("list").description("List connected integrations").action(async () => {
   try {
     const { integrations } = await new ErdoClient().listIntegrations();
-    for (const i of integrations) console.log(`${i.app}	${i.status}	${i.auth_type}	${i.name}`);
+    for (const i of integrations) {
+      const provided = i.provided_by_organization_slug ? `	provided by ${i.provided_by_organization_slug}` : "";
+      console.log(`${i.app}	${i.status}	${i.auth_type}	${i.name}${provided}`);
+    }
   } catch (e) {
     fail(e);
   }
@@ -5309,7 +5447,10 @@ integrationsCmd.command("apps [query]").description("Search connectable apps (na
     fail(e);
   }
 });
-integrationsCmd.command("connect <app>").description("Connect an app \u2014 pass its API key or other credentials with -c, or omit them to get a browser connect URL for OAuth apps").option("-c, --credential <key=value...>", "credential field, e.g. -c api_key=\u2026 (repeatable); rejected by OAuth apps, which have no credential to pass", (v, acc) => acc.concat(v), []).option("-n, --name <name>", "display name for the connection").option("--rotate", "replace the credentials of the app's existing connection instead of adding a second one \u2014 for a key that was rotated at the provider; requires -c").option("--share", "share the connection with the whole organization instead of keeping it private to you \u2014 for org-level credentials teammates and agents should see").action(async (app, opts) => {
+integrationsCmd.command("connect <app>").description("Connect an app \u2014 pass its API key or other credentials with -c, or omit them to get a browser connect URL for OAuth apps").option("-c, --credential <key=value...>", "credential field, e.g. -c api_key=\u2026 (repeatable); rejected by OAuth apps, which have no credential to pass", (v, acc) => acc.concat(v), []).option("-n, --name <name>", "display name for the connection").option("--rotate", "replace the credentials of the app's existing connection instead of adding a second one \u2014 for a key that was rotated at the provider; requires -c").option("--share", "share the connection with the whole organization instead of keeping it private to you \u2014 for org-level credentials teammates and agents should see").option(
+  "--provide-to-managed",
+  "let the organizations you manage use this connection as if it were their own \u2014 for a vendor key your agency pays for. Key-authenticated native integrations only, connected in a manager organization"
+).action(async (app, opts) => {
   try {
     let credentials;
     if (opts.credential.length) {
@@ -5325,7 +5466,8 @@ integrationsCmd.command("connect <app>").description("Connect an app \u2014 pass
       name: opts.name,
       credentials,
       rotate_credentials: opts.rotate || void 0,
-      share_with_org: opts.share || void 0
+      share_with_org: opts.share || void 0,
+      managed_access: opts.provideToManaged ? "managed_organizations" : void 0
     });
     print(res);
     const notes = [];
@@ -5340,6 +5482,27 @@ ${notes.join("\n")}`);
     fail(e);
   }
 });
+integrationsCmd.command("managed-access <integration-id> <owner_only|managed_organizations>").description(
+  "Start or stop providing a connection to the organizations you manage \u2014 a vendor key your agency pays for, spendable by every client for as long as you manage it. Key-authenticated connections only"
+).action(async (integrationId, managedAccess) => {
+  try {
+    const res = await new ErdoClient().setIntegrationManagedAccess(integrationId, managedAccess);
+    print(res);
+    if (res.managed_access !== "managed_organizations") return;
+    const orgs = res.managed_organizations ?? [];
+    if (!orgs.length) {
+      console.error(
+        "\nNo organizations are managed by this one yet, so nothing uses it today \u2014 a client you link later picks it up with nothing further to do here."
+      );
+      return;
+    }
+    console.error(`
+Provided to ${orgs.length} organization${orgs.length === 1 ? "" : "s"}:`);
+    for (const o of orgs) console.error(`  ${o.slug}	${o.name}`);
+  } catch (e) {
+    fail(e);
+  }
+});
 integrationsCmd.command("disconnect <app>").description("Disconnect an app \u2014 releases the stored credential and removes the connection; org admins can disconnect any of the org's connections").action(async (app) => {
   try {
     const client = new ErdoClient();

package/package.json

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