@oxygen-agent/cli 1.347.1 → 1.353.2

package/README.md

@@ -34,4 +34,4 @@ oxygen update
 
 For product documentation, visit https://oxygen-agent.com/docs. For support, visit https://oxygen-agent.com.
 
-Version: 1.347.1
+Version: 1.353.2

package/dist/index.js

@@ -1518,38 +1518,6 @@ function buildCrmAutomationAuditPath(options) {
     const query = params.toString();
     return query ? `/api/cli/crm/automation/audit?${query}` : "/api/cli/crm/automation/audit";
 }
-function buildCrmListCreateBody(slug, options) {
-    const body = {
-        slug,
-        base_object: options.base,
-        kind: options.kind,
-        mode: resolveLiveDryRunMode(options),
-    };
-    if (options.displayName)
-        body.display_name = options.displayName;
-    if (options.project)
-        body.project = options.project;
-    if (options.filterJson)
-        body.filter = parseJsonObject(options.filterJson);
-    return body;
-}
-function buildCrmListEntryBody(object, rowId, options) {
-    return {
-        object,
-        row_id: rowId,
-        mode: resolveLiveDryRunMode(options),
-    };
-}
-function buildCrmListMembersPath(list, options) {
-    const params = new URLSearchParams();
-    if (options.limit)
-        params.set("limit", options.limit);
-    if (options.cursor)
-        params.set("cursor", options.cursor);
-    const query = params.toString();
-    const base = `/api/cli/crm/lists/${encodeURIComponent(list)}/members`;
-    return query ? `${base}?${query}` : base;
-}
 function parseCrmIdentityOption(value) {
     const separator = value.indexOf("=");
     if (separator <= 0 || separator === value.length - 1) {
@@ -3168,68 +3136,6 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         .option("--json", "Print a JSON envelope.")
         .action(async (options) => {
         await handleAsyncAction("crm signals leads-today", options, () => requestOxygen(buildCrmLeadsTodayPath(options)));
-    })))
-        .addCommand(new Command("lists")
-        .description("Static and dynamic CRM lists over companies, people, deals, and custom objects.")
-        .addCommand(new Command("create")
-        .description("Create a static or dynamic CRM list. Defaults to dry-run.")
-        .argument("<slug>", "List slug, such as vip_accounts.")
-        .requiredOption("--base <object>", "Base CRM object slug the list draws from, such as people.")
-        .requiredOption("--kind <kind>", "List kind: static (materialized) or dynamic (filter-computed).")
-        .option("--filter-json <json>", "Dynamic-list filter as a JSON FilterTree object.")
-        .option("--display-name <name>", "Human-friendly list name.")
-        .option("--project <project>", "Project id or slug for the backing list table.")
-        .option("--dry-run", "Preview the list without creating it.")
-        .option("--live", "Create the list. Default is dry-run.")
-        .option("--json", "Print a JSON envelope.")
-        .action(async (slug, options) => {
-        await handleAsyncAction("crm lists create", options, () => requestOxygen("/api/cli/crm/lists", {
-            method: "POST",
-            body: buildCrmListCreateBody(slug, options),
-        }));
-    }))
-        .addCommand(new Command("add")
-        .description("Add a record to a static CRM list. Defaults to dry-run.")
-        .argument("<list>", "List slug.")
-        .argument("<object>", "Base CRM object slug, such as people.")
-        .argument("<row_id>", "Base record row id.")
-        .option("--dry-run", "Preview the add without writing it.")
-        .option("--live", "Write the membership. Default is dry-run.")
-        .option("--json", "Print a JSON envelope.")
-        .action(async (list, object, rowId, options) => {
-        await handleAsyncAction("crm lists add", options, () => requestOxygen(`/api/cli/crm/lists/${encodeURIComponent(list)}/entries`, {
-            method: "POST",
-            body: buildCrmListEntryBody(object, rowId, options),
-        }));
-    }))
-        .addCommand(new Command("remove")
-        .description("Remove a record from a static CRM list. Defaults to dry-run.")
-        .argument("<list>", "List slug.")
-        .argument("<object>", "Base CRM object slug, such as people.")
-        .argument("<row_id>", "Base record row id.")
-        .option("--dry-run", "Preview the removal without writing it.")
-        .option("--live", "Tombstone the membership. Default is dry-run.")
-        .option("--json", "Print a JSON envelope.")
-        .action(async (list, object, rowId, options) => {
-        await handleAsyncAction("crm lists remove", options, () => requestOxygen(`/api/cli/crm/lists/${encodeURIComponent(list)}/entries`, {
-            method: "DELETE",
-            body: buildCrmListEntryBody(object, rowId, options),
-        }));
-    }))
-        .addCommand(new Command("members")
-        .description("List a CRM list's members (the audience for sequence enrollment).")
-        .argument("<list>", "List slug.")
-        .option("--limit <limit>", "Maximum members to return.")
-        .option("--cursor <cursor>", "Pagination cursor from a previous page.")
-        .option("--json", "Print a JSON envelope.")
-        .action(async (list, options) => {
-        await handleAsyncAction("crm lists members", options, () => requestOxygen(buildCrmListMembersPath(list, options)));
-    }))
-        .addCommand(new Command("ls")
-        .description("List every configured CRM list.")
-        .option("--json", "Print a JSON envelope.")
-        .action(async (options) => {
-        await handleAsyncAction("crm lists ls", options, () => requestOxygen("/api/cli/crm/lists"));
     })))
         .addCommand(new Command("automation")
         .description("Arm / disarm standing CRM automation templates and read the audit trail.")
@@ -6136,7 +6042,7 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         .option("--from <iso>", "Only include ledger events at or after this ISO timestamp.")
         .option("--to <iso>", "Only include ledger events at or before this ISO timestamp.")
         .option("--limit <n>", "Maximum grouped rows to return. Defaults to 100.")
-        .option("--group-by <keys>", "Comma-separated grouping keys. Defaults to provider,source.")
+        .option("--group-by <keys>", "Comma-separated grouping keys (day, type, category, provider, source, tool, model, run, workspace). Defaults to provider,source.")
         .option("--type <type>", "Filter by transaction type, such as reserve, capture, release, grant, or byok_usage.")
         .option("--category <category>", "Filter by transaction category, such as managed_enrichment, managed_ai, byok, subscription, or admin.")
         .option("--provider <provider>", "Filter by provider id.")
@@ -6666,14 +6572,14 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
             return data;
         });
     }));
-    // Singular `agent`, deliberately: this is ONE governed roster surface — a lens
-    // over the built-in specialist agents that already run inside the workspace as
-    // approval-gated, workflow-owned behavior — not a 14th primitive and not a
-    // build-your-own-agent runtime. (Distinct from `oxygen knowledge agent`, which
-    // configures the knowledge-synthesis specialist itself.)
+    // The Agents primitive's roster surface (ADR 0011): governed workspace agents
+    // that run inside the workspace as approval-gated, observable runs. Lists only
+    // shipped agents — no placeholders; user-defined custom agents arrive with the
+    // unified runtime envelope (create/update land then). (Distinct from
+    // `oxygen knowledge agent`, which configures the AI Knowledge Agent itself.)
     program
         .command("agent")
-        .description("Workspace Agent roster: your built-in specialist agents (inbox reply drafts, meeting notetaker, knowledge synthesis) that run inside your workspace as approval-gated runs. List them, inspect run history, and enable or disable each one.")
+        .description("Agents: your workspace agents (AI Sales Agent, AI Meeting Notetaker, AI Knowledge Agent) that work inside your workspace as approval-gated runs. List them, inspect run history, and enable or disable each one; each agent's `configCommand` (e.g. `oxygen inbox reply-agent set` for the AI Sales Agent) tunes its behavior. Web: /agents.")
         .addCommand(new Command("list")
         .description("List the built-in specialist agents with their enabled state and recent run history.")
         .option("--json", "Print a JSON envelope.")
@@ -7582,30 +7488,27 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         });
     })));
     program.addCommand(new Command("followers")
-        .description("Read a LinkedIn account's followers into a Clay-like workspace table and an enrollable CRM list you can enrich, qualify, and enroll from. Imports run as a slow, durable background drip under a dedicated conservative read budget — they never burst and never starve the sequencer's own reads.")
+        .description("Read a LinkedIn account's followers into a Clay-like workspace table you can enrich, qualify, and enroll from. Imports run as a slow, durable background drip under a dedicated conservative read budget — they never burst and never starve the sequencer's own reads.")
         .addCommand(new Command("import")
-        .description("Start (or re-arm) a followers import. Followers drip into a workspace table + the deduped mirror over many ticks, and newly-seen people are bridged into an enrollable CRM static list; poll `followers status` to watch them accrue. The import keeps itself fresh by periodically re-walking followers in the background (new followers dedupe in). No messages are sent and no Oxygen credits are charged.")
+        .description("Start (or re-arm) a followers import. Followers drip into a workspace table + the deduped mirror over many ticks; poll `followers status` to watch them accrue. The import keeps itself fresh by periodically re-walking followers in the background (new followers dedupe in). No messages are sent and no Oxygen credits are charged.")
         .option("--account <ref>", "Sender account to import (sender id, connection id, or Unipile account id). Omit to import every active LinkedIn account.")
         .option("--table <ref>", "Existing workspace table (id or slug) to import into. Omit to create or reuse a 'LinkedIn Followers' table.")
-        .option("--list <slug>", "Enrollable CRM static list slug to bridge new followers into. Omit for the default 'linkedin-followers' list.")
         .option("--json", "Print a JSON envelope.")
         .action(async (options) => {
         await handleAsyncAction("followers import", options, () => {
             const account = readOption(options.account);
             const table = readOption(options.table);
-            const list = readOption(options.list);
             return requestOxygen("/api/cli/linkedin/followers/import", {
                 method: "POST",
                 body: {
                     ...(account ? { account } : {}),
                     ...(table ? { table } : {}),
-                    ...(list ? { list } : {}),
                 },
             });
         });
     }))
         .addCommand(new Command("status")
-        .description("Show followers-import progress (per-sender drip status, followers ingested, last error) plus a preview of the followers table, the enrollable CRM list, and a deep-link to open it.")
+        .description("Show followers-import progress (per-sender drip status, followers ingested, last error) plus a preview of the followers table and a deep-link to open it.")
         .option("--account <ref>", "Scope to one sender account (sender id, connection id, or Unipile account id).")
         .option("--json", "Print a JSON envelope.")
         .action(async (options) => {
@@ -7619,30 +7522,27 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         });
     })));
     program.addCommand(new Command("viewers")
-        .description("Read the named LinkedIn 'who viewed my profile' (WVMP) viewers into a Clay-like workspace table and an enrollable CRM list. Imports run as a slow, durable background drip under a dedicated conservative read budget. LinkedIn hides anonymous/private viewers, so the list is always a partial sample.")
+        .description("Read the named LinkedIn 'who viewed my profile' (WVMP) viewers into a Clay-like workspace table. Imports run as a slow, durable background drip under a dedicated conservative read budget. LinkedIn hides anonymous/private viewers, so the table is always a partial sample.")
         .addCommand(new Command("import")
-        .description("Start (or re-arm) a durable profile-viewers (WVMP) import. Named viewers drip into a workspace table + the deduped mirror (view_count / last_viewed_at accumulate) over many ticks, and newly-seen viewers are bridged into an enrollable CRM static list; poll `viewers status` to watch them accrue. No messages are sent and no Oxygen credits are charged.")
+        .description("Start (or re-arm) a durable profile-viewers (WVMP) import. Named viewers drip into a workspace table + the deduped mirror (view_count / last_viewed_at accumulate) over many ticks; poll `viewers status` to watch them accrue. No messages are sent and no Oxygen credits are charged.")
         .option("--account <ref>", "Sender account to import (sender id, connection id, or Unipile account id). Omit to import every active LinkedIn account.")
         .option("--table <ref>", "Existing workspace table (id or slug) to import into. Omit to create or reuse a 'LinkedIn Profile Viewers' table.")
-        .option("--list <slug>", "Enrollable CRM static list slug to bridge new viewers into. Omit for the default 'linkedin-profile-viewers' list.")
         .option("--json", "Print a JSON envelope.")
         .action(async (options) => {
         await handleAsyncAction("viewers import", options, () => {
             const account = readOption(options.account);
             const table = readOption(options.table);
-            const list = readOption(options.list);
             return requestOxygen("/api/cli/linkedin/viewers/import", {
                 method: "POST",
                 body: {
                     ...(account ? { account } : {}),
                     ...(table ? { table } : {}),
-                    ...(list ? { list } : {}),
                 },
             });
         });
     }))
         .addCommand(new Command("status")
-        .description("Show durable profile-viewers (WVMP) import progress (per-sender drip status, viewers ingested, last error, the preserved privacy ceiling note) plus a preview of the viewers table, the enrollable CRM list, and a deep-link to open it.")
+        .description("Show durable profile-viewers (WVMP) import progress (per-sender drip status, viewers ingested, last error, the preserved privacy ceiling note) plus a preview of the viewers table and a deep-link to open it.")
         .option("--account <ref>", "Scope to one sender account (sender id, connection id, or Unipile account id).")
         .option("--json", "Print a JSON envelope.")
         .action(async (options) => {
@@ -7757,11 +7657,10 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         });
     })));
     program.addCommand(new Command("engagement")
-        .description("Harvest a LinkedIn post's engagers (reactors + commenters) into an enrollable CRM static list. The harvest runs as a slow, durable background drip under a dedicated conservative read budget — it never bursts and never starves the sequencer's own reads.")
+        .description("Harvest a LinkedIn post's engagers (reactors + commenters) into an enrollable workspace table. The harvest runs as a slow, durable background drip under a dedicated conservative read budget — it never bursts and never starves the sequencer's own reads.")
         .addCommand(new Command("harvest")
-        .description("Start (or re-arm) a harvest of a post's engagers into a CRM static list you can enroll into a sequence. Engagers drip into the list over many ticks; poll `engagement status` to watch it fill. No messages are sent. Cookieless harvests spend Oxygen credits per scraper page and require --max-credits.")
+        .description("Start (or re-arm) a harvest of a post's engagers into a workspace table you can enroll into a sequence. Engagers drip into the table over many ticks; poll `engagement status` to watch it fill. No messages are sent. Cookieless harvests spend Oxygen credits per scraper page and require --max-credits.")
         .requiredOption("--post <social_id_or_url>", "Composite post social_id from `oxygen posts get` (NOT the activity URN), or the public LinkedIn post URL for cookieless.")
-        .requiredOption("--list <slug>", "CRM static list slug to fill (created or reused over the people object).")
         .option("--source <source>", "cookieless|unipile. Defaults to cookieless when a public post URL is supplied.")
         .option("--post-url <url>", "Public LinkedIn post URL for cookieless harvesting when --post is a social id.")
         .option("--max-credits <credits>", "Required for cookieless harvesting; caps managed scraper spend for this armed run.")
@@ -7773,7 +7672,6 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         .action(async (options) => {
         await handleAsyncAction("engagement harvest", options, () => {
             const post = readOption(options.post);
-            const list = readOption(options.list);
             const account = readOption(options.account);
             const source = readOption(options.source);
             const postUrl = readOption(options.postUrl);
@@ -7782,7 +7680,6 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
                 method: "POST",
                 body: {
                     ...(post ? { post } : {}),
-                    ...(list ? { list } : {}),
                     ...(source ? { source } : {}),
                     ...(postUrl ? { post_url: postUrl } : {}),
                     ...(maxCredits !== undefined ? { max_credits: maxCredits } : {}),
@@ -7796,7 +7693,7 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         });
     }))
         .addCommand(new Command("status")
-        .description("Show an engagement harvest's progress (drip status, engagers ingested, last error) plus the CRM list it fills and a preview of harvested engagers.")
+        .description("Show an engagement harvest's progress (drip status, engagers ingested, last error) plus the workspace table it fills and a preview of harvested engagers.")
         .option("--account <ref>", "Scope to one sender account (sender id, connection id, or Unipile account id).")
         .option("--post <social_id>", "Scope to one harvested post.")
         .option("--json", "Print a JSON envelope.")
@@ -8545,7 +8442,7 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         });
     })))
         .addCommand(new Command("reply-agent")
-        .description("The draft-only AI reply agent (the 'AI Sales Agent'): auto-classifies + auto-drafts replies into the review queue. It NEVER auto-sends.")
+        .description("The draft-only AI reply agent (the 'AI Sales Agent'): auto-classifies + auto-drafts replies into the review queue. It NEVER auto-sends. Roster + run history: `oxygen agent get inbox-reply-drafts`; web home: /agents/inbox-reply-drafts.")
         .addCommand(new Command("get")
         .description("Show the reply-agent config.")
         .option("--json", "Print a JSON envelope.")
@@ -8553,11 +8450,11 @@ fixed scan; watermark_cursor starts a later bounded replay. Consumers must retai
         await handleAsyncAction("inbox reply-agent get", options, () => requestOxygen("/api/cli/inbox/reply-agent"));
     }))
         .addCommand(new Command("set")
-        .description("Configure the reply agent (enable, persona/tone, targets). It drafts into the queue; a human approves+sends.")
+        .description("Configure the reply agent (enable, persona/tone, targets). It drafts into the queue; a human approves+sends. Configuring is free (no credits); once enabled, each draft the agent writes consumes credits.")
         .option("--enabled", "Enable the agent.")
         .option("--disabled", "Disable the agent.")
-        .option("--persona <text>", "Who the agent is.")
-        .option("--tone <text>", "Reply tone.")
+        .option("--persona <text>", "Who the agent writes as — drafts open in this voice. Richest results name role + company + what you sell, e.g. \"Jonas, founder of Acme (dev-tools for CI caching)\".")
+        .option("--tone <text>", "How drafts should read, e.g. \"warm, concise, low-pressure\".")
         .option("--instructions <text>", "Extra drafting instructions.")
         .option("--signature <text>", "Signature appended to drafts.")
         .option("--target-statuses <keys>", "Comma-separated statuses to draft for (empty = all draftable).")

package/node_modules/@oxygen/shared/dist/version.d.ts

@@ -1,3 +1,3 @@
-export declare const OXYGEN_VERSION = "1.347.1";
+export declare const OXYGEN_VERSION = "1.353.2";
 export declare const OXYGEN_MINIMUM_CLI_VERSION = "1.181.0";
 export declare const MANAGED_INBOX_MINIMUM_CLI_VERSION = "1.326.2";

package/node_modules/@oxygen/shared/dist/version.js

@@ -1,4 +1,4 @@
-export const OXYGEN_VERSION = "1.347.1";
+export const OXYGEN_VERSION = "1.353.2";
 // The GLOBAL CLI compatibility floor: the oldest CLI allowed to call any
 // operational route. Raising it hard-rejects every older CLI from the entire
 // product, so it obeys one law, enforced by scripts/ci/cli-min-version-gate.mjs:

package/node_modules/@oxygen/shared/dist/workspace-agents.d.ts

@@ -8,10 +8,12 @@ export type WorkspaceAgentSlug = "inbox-reply-drafts" | "meeting-notetaker" | "k
 export type WorkspaceAgentDeepLinkKind = "inbox_reply_agent" | "notetaker" | "knowledge_agent";
 /** A pure, serializable descriptor for one Workspace Agent specialist. */
 export type WorkspaceAgentDescriptor = {
-    /** Stable identifier used across CLI/MCP/API. */
+    /** Stable identifier used across CLI/MCP/API. Never derived from the title. */
     slug: WorkspaceAgentSlug;
-    /** Human title for roster rows and widgets. */
+    /** Persona-style display name ("AI Sales Agent"). Display-only — the slug is the contract. */
     title: string;
+    /** One honest job line shown under the persona name ("Drafts inbox replies — never sends without your approval."). */
+    subtitle: string;
     /** One outcome-framed sentence: what the specialist produces for the user. */
     description: string;
     /** The OXYGEN OS primitive this specialist writes into. */

package/node_modules/@oxygen/shared/dist/workspace-agents.js

@@ -1,15 +1,17 @@
-// The Workspace Agent roster: the single governed lens over OXYGEN's built-in
-// specialist agents. This is deliberately a *computed* registry, not a table and
-// not a runtime — the "Workspace Agent" is ONE Control-layer surface, and each
-// entry here is a product-defined specialist that already ships as an
-// approval-gated, workflow-owned behavior elsewhere in the product. It is NOT a
-// generic build-your-own-agent runtime (ADR 0006), so there is no create/define
-// verb and there are no placeholder rows: the roster lists only specialists that
-// are actually implemented today. CRM-hygiene, deliverability, and any other
-// roadmap specialist stay OUT until they ship — the no-placeholder-surface rule.
+// The Agents primitive's roster (ADR 0011): the governed registry of OXYGEN's
+// built-in workspace agents. Still deliberately a *computed* registry — each
+// entry is a product-defined agent that ships as an approval-gated, observable
+// behavior elsewhere in the product, surfaced under /agents and `oxygen agent`.
+// Agents are governed workspace workers: the runtime envelope (approval posture,
+// credit budgets, run observability) is platform-enforced, never agent-optional.
+// User-defined custom agents are ratified (ADR 0011) but arrive with the unified
+// runtime envelope in a later phase — until then there is no create/define verb,
+// and there are never placeholder rows: the roster lists only agents that are
+// actually implemented today. CRM-hygiene, deliverability, and any other roadmap
+// agent stay OUT until they ship — the no-placeholder-surface rule.
 //
 // This module is a dependency-free leaf (pure descriptors + types) so it can live
-// in @oxygen/shared without importing tenant-db: the actual per-specialist wiring
+// in @oxygen/shared without importing tenant-db: the actual per-agent wiring
 // (config read/write, run history, deep-links) lives in the web layer's
 // agent-registry, which composes these descriptors with the existing helpers.
 /**
@@ -20,7 +22,8 @@
 export const WORKSPACE_AGENT_ROSTER = [
     {
         slug: "inbox-reply-drafts",
-        title: "Inbox reply drafts",
+        title: "AI Sales Agent",
+        subtitle: "Drafts inbox replies — never sends without your approval.",
         description: "Drafts replies to inbound prospect and customer messages so you can review, edit, and approve them before anything sends.",
         owningPrimitive: "Messages",
         configCommand: "oxygen inbox reply-agent",
@@ -31,7 +34,8 @@ export const WORKSPACE_AGENT_ROSTER = [
     },
     {
         slug: "meeting-notetaker",
-        title: "Meeting notetaker",
+        title: "AI Meeting Notetaker",
+        subtitle: "Joins scoped meetings to record, transcribe, and file notes.",
         description: "Auto-joins meetings in its configured scope to record, transcribe, and file meeting notes onto the matching CRM records.",
         owningPrimitive: "Records",
         configCommand: "oxygen notetaker setup",
@@ -42,7 +46,8 @@ export const WORKSPACE_AGENT_ROSTER = [
     },
     {
         slug: "knowledge-synthesis",
-        title: "Knowledge synthesis",
+        title: "AI Knowledge Agent",
+        subtitle: "Distills outreach and meeting learnings into workspace knowledge.",
         description: "Distills captured outreach and meeting learnings into workspace knowledge pages on the schedule and daily credit cap you set.",
         owningPrimitive: "Knowledge Graph",
         configCommand: "oxygen knowledge agent",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxygen-agent/cli",
-  "version": "1.347.1",
+  "version": "1.353.2",
   "private": false,
   "license": "UNLICENSED",
   "type": "module",