@audienti/cli 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+All notable changes to the Audienti CLI are documented here.
+
+## [Unreleased]
+
+## [0.1.0] - 2026-07-10
+
+### Added
+
+- Initial public release of the agent-first Audienti CLI.

package/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2026 OMALab, Inc.
+All rights reserved.
+
+This repository and its original source code, documentation, workflows,
+prompts, scripts, plugin metadata, and related materials are proprietary to
+OMALab, Inc.
+
+No permission is granted to use, copy, modify, merge, publish, distribute,
+sublicense, sell, or publish substantial portions of this repository or its
+contents without prior written permission from OMALab, Inc.
+
+Nothing in this notice limits rights available under applicable law, including
+fair use. Short quotations, references, summaries, links, commentary, and other
+legally permitted uses are allowed under those rights. If you quote or reference
+this work, attribution to OMALab, Inc. and a link to this repository are
+requested.
+
+Third-party content and dependencies remain owned by their respective owners
+and are governed by their own licenses.

package/README.md

@@ -0,0 +1,62 @@
+# Audienti CLI
+
+Audienti CLI is the agent-first command-line client for the Audienti production
+API. It lets local coding agents and operators inspect accounts, create and
+manage plays, import prospects, build lists, and work supported operator flows.
+
+## Install
+
+Requires Node.js 20 or newer.
+
+```bash
+npm install --global @audienti/cli
+audienti --help
+```
+
+For one-off use, run `npx @audienti/cli --help`.
+
+## Authenticate
+
+Create an Audienti API token through the product, then configure this machine:
+
+```bash
+audienti auth token <token>
+audienti accounts list --json
+audienti accounts select <acct_id>
+```
+
+The CLI writes its local configuration to `~/.config/audienti/config.json` with
+owner-only permissions. Do not place a production token in an agent prompt,
+repository file, issue, or CI secret.
+
+## Agent Workflows
+
+Start with the built-in, production-safe workflow guide:
+
+```bash
+audienti help agent-workflows
+```
+
+Use `--json` whenever another program or agent will consume the result. Inspect
+the target state before mutations, and use the command-specific help before
+creating, changing, or deleting data.
+
+## Compatibility
+
+The CLI talks to the versioned Audienti `/api/v1` contract at
+`https://app.audienti.com` by default. A release occurs only after the matching
+server deploy succeeds.
+
+The canonical source lives with the Audienti application under
+`packages/audienti-cli`. This public repository is a CI-managed mirror; direct
+changes are unsupported and cause the next source release to fail safely.
+
+## Plugins
+
+This repository includes Codex and Claude Code plugin manifests plus an
+`audienti` skill. The plugin provides workflow instructions; it does not grant
+credentials or silently authenticate an agent.
+
+## License
+
+Copyright (c) 2026 OMALab, Inc. All rights reserved. See [LICENSE](LICENSE).

package/bin/audienti.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+
+import { run } from "../src/cli.js";
+
+const exitCode = await run(process.argv.slice(2));
+process.exitCode = exitCode;

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@audienti/cli",
+  "version": "0.1.0",
+  "description": "Agent-first command-line client for Audienti.",
+  "type": "module",
+  "bin": {
+    "audienti": "./bin/audienti.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "test": "node --test test/*.test.js",
+    "verify": "node scripts/verify-package.mjs",
+    "check": "npm run verify && npm test"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/audienti/cli.git"
+  },
+  "homepage": "https://github.com/audienti/cli#readme",
+  "bugs": {
+    "url": "https://github.com/audienti/cli/issues"
+  },
+  "license": "SEE LICENSE IN LICENSE",
+  "keywords": [
+    "audienti",
+    "cli",
+    "agents",
+    "go-to-market"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/api-client.js

@@ -0,0 +1,295 @@
+export const DEFAULT_HOST = "https://app.audienti.com";
+
+export class ApiError extends Error {
+  constructor(message, { status, body } = {}) {
+    super(message);
+    this.name = "ApiError";
+    this.status = status;
+    this.body = body;
+  }
+}
+
+export function normalizeHost(host = DEFAULT_HOST) {
+  const trimmed = String(host || DEFAULT_HOST).trim();
+  const withProtocol = /^https?:\/\//i.test(trimmed) ? trimmed : `https://${trimmed}`;
+  const url = new URL(withProtocol);
+  url.pathname = url.pathname.replace(/\/+$/, "");
+  url.search = "";
+  url.hash = "";
+
+  return url.toString().replace(/\/$/, "");
+}
+
+export class AudientiClient {
+  constructor({ host = DEFAULT_HOST, token, fetchImpl = globalThis.fetch } = {}) {
+    if (!fetchImpl) {
+      throw new Error("This Node runtime does not provide fetch.");
+    }
+
+    this.host = normalizeHost(host);
+    this.token = token;
+    this.fetchImpl = fetchImpl;
+  }
+
+  me() {
+    return this.requestJson("/api/v1/me.json");
+  }
+
+  accounts() {
+    return this.requestJson("/api/v1/accounts.json");
+  }
+
+  users(accountId) {
+    return this.requestJson(accountPath(accountId, ["users"]));
+  }
+
+  offers(accountId) {
+    return this.requestJson(accountPath(accountId, ["offers"]));
+  }
+
+  createOffer(accountId, body) {
+    return this.requestJson(accountPath(accountId, ["offers"]), {
+      method: "POST",
+      body
+    });
+  }
+
+  icps(accountId) {
+    return this.requestJson(accountPath(accountId, ["icps"]));
+  }
+
+  createIcp(accountId, body) {
+    return this.requestJson(accountPath(accountId, ["icps"]), {
+      method: "POST",
+      body
+    });
+  }
+
+  companies(accountId, query = {}) {
+    return this.requestJson(accountPath(accountId, ["companies"], query));
+  }
+
+  lists(accountId) {
+    return this.requestJson(accountPath(accountId, ["lists"]));
+  }
+
+  createList(accountId, body) {
+    return this.requestJson(accountPath(accountId, ["lists"]), {
+      method: "POST",
+      body
+    });
+  }
+
+  list(accountId, listId) {
+    return this.requestJson(accountPath(accountId, ["lists", listId]));
+  }
+
+  updateList(accountId, listId, body) {
+    return this.requestJson(accountPath(accountId, ["lists", listId]), {
+      method: "PATCH",
+      body
+    });
+  }
+
+  deleteList(accountId, listId) {
+    return this.requestJson(accountPath(accountId, ["lists", listId]), {
+      method: "DELETE"
+    });
+  }
+
+  listProspects(accountId, listId, query = {}) {
+    return this.requestJson(accountPath(accountId, ["lists", listId, "prospects"], query));
+  }
+
+  addListProspects(accountId, listId, body) {
+    return this.requestJson(accountPath(accountId, ["lists", listId, "prospects"]), {
+      method: "POST",
+      body
+    });
+  }
+
+  removeListProspects(accountId, listId, body) {
+    return this.requestJson(accountPath(accountId, ["lists", listId, "prospects"]), {
+      method: "DELETE",
+      body
+    });
+  }
+
+  motions(accountId) {
+    return this.requestJson(accountPath(accountId, ["motions"]));
+  }
+
+  motion(accountId, motionId) {
+    return this.requestJson(accountPath(accountId, ["motions", motionId]));
+  }
+
+  createMotion(accountId, body) {
+    return this.requestJson(accountPath(accountId, ["motions"]), {
+      method: "POST",
+      body
+    });
+  }
+
+  motionStatus(accountId, motionId) {
+    return this.requestJson(accountPath(accountId, ["motions", motionId, "status"]));
+  }
+
+  motionProspects(accountId, motionId, query = {}) {
+    return this.requestJson(accountPath(accountId, ["motions", motionId, "prospects"], query));
+  }
+
+  addMotionProspects(accountId, motionId, body) {
+    return this.requestJson(accountPath(accountId, ["motions", motionId, "prospects"]), {
+      method: "POST",
+      body
+    });
+  }
+
+  prospects(accountId, query = {}) {
+    return this.requestJson(accountPath(accountId, ["prospects"], query));
+  }
+
+  prospect(accountId, prospectId) {
+    return this.requestJson(accountPath(accountId, ["prospects", prospectId]));
+  }
+
+  prospectMessageTypes(accountId, prospectId) {
+    return this.requestJson(accountPath(accountId, ["prospects", prospectId, "message_types"]));
+  }
+
+  writeProspectMessage(accountId, prospectId, body) {
+    return this.requestJson(accountPath(accountId, ["prospects", prospectId, "write_message"]), {
+      method: "POST",
+      body
+    });
+  }
+
+  prospectSequencePreview(accountId, prospectId, body = {}) {
+    return this.requestJson(accountPath(accountId, ["prospects", prospectId, "sequence_preview"]), {
+      method: "POST",
+      body
+    });
+  }
+
+  addProspectNote(accountId, prospectId, body) {
+    return this.requestJson(accountPath(accountId, ["prospects", prospectId, "add_note"]), {
+      method: "POST",
+      body
+    });
+  }
+
+  prospectImport(accountId, body) {
+    return this.requestJson(accountPath(accountId, ["prospect_imports"]), {
+      method: "POST",
+      body
+    });
+  }
+
+  prospectImportStatus(accountId, importId) {
+    return this.requestJson(accountPath(accountId, ["prospect_imports", importId]));
+  }
+
+  operatorQueue(accountId, query = {}) {
+    return this.requestJson(accountPath(accountId, ["operator"], query));
+  }
+
+  operatorNext(accountId, query = {}) {
+    return this.requestJson(accountPath(accountId, ["operator", "next"], query));
+  }
+
+  operatorOutcome(accountId, body) {
+    return this.requestJson(accountPath(accountId, ["operator", "outcome"]), {
+      method: "POST",
+      body
+    });
+  }
+
+  async requestJson(path, { method = "GET", body } = {}) {
+    const response = await this.fetchImpl(new URL(path, `${this.host}/`), {
+      method,
+      headers: this.headers(body),
+      body: body === undefined ? undefined : JSON.stringify(body)
+    });
+
+    const responseBody = await parseBody(response);
+
+    if (!response.ok) {
+      throw new ApiError(errorMessage(response.status, responseBody), {
+        status: response.status,
+        body: responseBody
+      });
+    }
+
+    return responseBody;
+  }
+
+  headers(body) {
+    const headers = {
+      Accept: "application/json"
+    };
+
+    if (this.token) {
+      headers.Authorization = `Bearer ${this.token}`;
+    }
+
+    if (body !== undefined) {
+      headers["Content-Type"] = "application/json";
+    }
+
+    return headers;
+  }
+}
+
+function accountPath(accountId, segments, query = {}) {
+  const encodedSegments = [
+    "api",
+    "v1",
+    "accounts",
+    accountId,
+    ...segments
+  ].map((segment) => encodeURIComponent(segment));
+  const searchParams = new URLSearchParams();
+
+  for (const [key, value] of Object.entries(query)) {
+    if (value !== undefined && value !== null && String(value).trim() !== "") {
+      searchParams.set(key, String(value));
+    }
+  }
+
+  const path = `/${encodedSegments.join("/")}.json`;
+  const search = searchParams.toString();
+  return search ? `${path}?${search}` : path;
+}
+
+async function parseBody(response) {
+  const text = await response.text();
+  if (!text) return null;
+
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+
+function errorMessage(status, body) {
+  if (status === 401) {
+    return "Authentication failed. Run `audienti auth token <token>` with a valid API token.";
+  }
+
+  if (status === 403) {
+    return "The API token is not allowed to access that Audienti resource.";
+  }
+
+  if (status === 404) {
+    return "The requested Audienti resource was not found.";
+  }
+
+  if (status === 422) {
+    const reasons = [body?.errors, body?.details].find(Array.isArray);
+    const details = reasons?.length > 0 ? reasons.join(", ") : body?.error;
+    return details ? `Audienti rejected the request: ${details}` : "Audienti rejected the request.";
+  }
+
+  return `Audienti API request failed with HTTP ${status}.`;
+}