@oxygen-agent/cli 1.1020.0 → 1.1021.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/dist/command-families/tables/register-automation.js +2 -2
- package/dist/command-families/tables/register-row-actions.js +1 -1
- package/dist/commands/agent.js +17 -17
- package/dist/commands/columns.js +3 -3
- package/dist/commands/copilot.js +1 -1
- package/dist/commands/knowledge.js +1 -1
- package/dist/commands/orgs.js +2 -2
- package/dist/commands/sequences.js +5 -5
- package/dist/commands/suppressions.js +2 -2
- package/node_modules/@oxygen/shared/dist/capability-intents/knowledge-graph.d.ts +1 -1
- package/node_modules/@oxygen/shared/dist/capability-intents/knowledge-graph.js +1 -1
- package/node_modules/@oxygen/shared/dist/capability-intents/tables.js +1 -1
- package/node_modules/@oxygen/shared/dist/version.d.ts +1 -1
- package/node_modules/@oxygen/shared/dist/version.generated.d.ts +1 -1
- package/node_modules/@oxygen/shared/dist/version.generated.js +1 -1
- package/node_modules/@oxygen/shared/dist/version.js +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -51,7 +51,7 @@ export function registerAutomation({ tablesCommand, handleAsyncAction }) {
|
|
|
51
51
|
body: { table },
|
|
52
52
|
})))));
|
|
53
53
|
tablesCommand.addCommand(new Command("auto-dedupe")
|
|
54
|
-
.description("Inspect and manage a table's standing auto-dedupe configuration (duplicate rows collapsed automatically after every write; deleted rows are kept in row history).")
|
|
54
|
+
.description("Inspect and manage a table's standing auto-dedupe configuration (duplicate rows collapsed automatically after every write; deleted rows are kept in row history for 30 days).")
|
|
55
55
|
.addCommand(new Command("get")
|
|
56
56
|
.description("Show a table's standing auto-dedupe configuration.")
|
|
57
57
|
.argument("<table>", "Table id or slug.")
|
|
@@ -61,7 +61,7 @@ export function registerAutomation({ tablesCommand, handleAsyncAction }) {
|
|
|
61
61
|
return requestOxygen(`/api/cli/tables/auto-dedupe?${params.toString()}`);
|
|
62
62
|
})))
|
|
63
63
|
.addCommand(new Command("set")
|
|
64
|
-
.description("Enable a standing auto-dedupe: after every write (insert, upsert, import, send, webhook), duplicate groups containing a just-written row are collapsed by the keep policy — losers are DELETED automatically without per-write approval (kept in row history), and any standing auto-run only enriches the survivors. Runs BEFORE auto-run so credits are never spent on rows about to be deleted. Fuzzy-label matching is on-demand only: use `oxygen tables dedupe --normalize fuzzy-label` instead.")
|
|
64
|
+
.description("Enable a standing auto-dedupe: after every write (insert, upsert, import, send, webhook), duplicate groups containing a just-written row are collapsed by the keep policy — losers are DELETED automatically without per-write approval (kept in row history for 30 days), and any standing auto-run only enriches the survivors. Runs BEFORE auto-run so credits are never spent on rows about to be deleted. Fuzzy-label matching is on-demand only: use `oxygen tables dedupe --normalize fuzzy-label` instead.")
|
|
65
65
|
.argument("<table>", "Table id or slug.")
|
|
66
66
|
.requiredOption("--on <cols>", "Key column(s): one column, or two comma-separated for a composite key (e.g. email or first_name,company).")
|
|
67
67
|
.option("--normalize <modes>", "Match mode per --on column, comma-separated positionally: exact (default), email, domain, or linkedin. Unpaired columns default to exact; fuzzy-label is rejected (on-demand only).")
|
|
@@ -6,7 +6,7 @@ import { buildDedupeRequest } from "./automation.js";
|
|
|
6
6
|
import { buildTablesSendRequest, writeTablesSendHint } from "./send.js";
|
|
7
7
|
export function registerRowActions({ tablesCommand, handleAsyncAction }) {
|
|
8
8
|
tablesCommand.addCommand(new Command("dedupe")
|
|
9
|
-
.description("Collapse duplicate rows by normalized (email/domain/linkedin) or fuzzy-label keys, or cross-check a column against another table. Previews by default; --apply --approved deletes losers (kept in row history).")
|
|
9
|
+
.description("Collapse duplicate rows by normalized (email/domain/linkedin) or fuzzy-label keys, or cross-check a column against another table. Previews by default; --apply --approved deletes losers (kept in row history for 30 days).")
|
|
10
10
|
.argument("<table>", "Table id or slug to dedupe.")
|
|
11
11
|
.requiredOption("--on <cols>", "Key column(s): one column, or two comma-separated for a composite key (e.g. email or first_name,company).")
|
|
12
12
|
.option("--normalize <mode>", "Match mode: exact (default), email, domain, linkedin, or fuzzy-label. Fuzzy allowed only as a single key.", "exact")
|
package/dist/commands/agent.js
CHANGED
|
@@ -16,30 +16,30 @@ export function registerAgentFamily(program, handleAsyncAction) {
|
|
|
16
16
|
// `oxygen knowledge agent`, which configures the AI Knowledge Agent itself.)
|
|
17
17
|
program
|
|
18
18
|
.command("agent")
|
|
19
|
-
.description("Agents:
|
|
19
|
+
.description("Agents: your first Oxygent (slug workspace), custom Agents, and built-in specialists. Publish versioned instructions and policies, start durable chats/runs, inspect every event, and control approvals. Web: /agents.")
|
|
20
20
|
.addCommand(new Command("list")
|
|
21
|
-
.description("List
|
|
21
|
+
.description("List your first Oxygent (workspace) and the built-in specialists with state and recent run history.")
|
|
22
22
|
.option("--json", "Print a JSON envelope.")
|
|
23
23
|
.action(async (options) => {
|
|
24
24
|
await handleAsyncAction("agent list", options, () => requestOxygen("/api/cli/agent"));
|
|
25
25
|
}))
|
|
26
26
|
.addCommand(new Command("get")
|
|
27
|
-
.description("Show one agent
|
|
28
|
-
.argument("<slug>", "Agent slug: workspace, a specialist (inbox-reply-drafts, meeting-notetaker, knowledge-synthesis), or a custom agent slug (from `oxygen agent create`).")
|
|
27
|
+
.description("Show one agent (your first Oxygent, a specialist, or a custom agent) with its active version and recent runs.")
|
|
28
|
+
.argument("<slug>", "Agent slug: workspace, a specialist (inbox-reply-drafts, meeting-notetaker, knowledge-synthesis, inbox-auto-tagger), or a custom agent slug (from `oxygen agent create`).")
|
|
29
29
|
.option("--json", "Print a JSON envelope.")
|
|
30
30
|
.action(async (slug, options) => {
|
|
31
31
|
await handleAsyncAction("agent get", options, () => requestOxygen(`/api/cli/agent/${encodeURIComponent(slug)}`));
|
|
32
32
|
}))
|
|
33
33
|
.addCommand(new Command("enable")
|
|
34
|
-
.description("Enable
|
|
35
|
-
.argument("<slug>", "
|
|
34
|
+
.description("Enable your first Oxygent (workspace) or a built-in specialist so it resumes its governed runs.")
|
|
35
|
+
.argument("<slug>", "workspace, or a specialist slug: inbox-reply-drafts, meeting-notetaker, knowledge-synthesis, or inbox-auto-tagger.")
|
|
36
36
|
.option("--json", "Print a JSON envelope.")
|
|
37
37
|
.action(async (slug, options) => {
|
|
38
38
|
await handleAsyncAction("agent enable", options, () => requestOxygen(`/api/cli/agent/${encodeURIComponent(slug)}/enable`, { method: "POST" }));
|
|
39
39
|
}))
|
|
40
40
|
.addCommand(new Command("disable")
|
|
41
|
-
.description("Disable
|
|
42
|
-
.argument("<slug>", "
|
|
41
|
+
.description("Disable your first Oxygent (workspace) or a built-in specialist so it stops new runs on the next worker tick.")
|
|
42
|
+
.argument("<slug>", "workspace, or a specialist slug: inbox-reply-drafts, meeting-notetaker, knowledge-synthesis, or inbox-auto-tagger.")
|
|
43
43
|
.option("--json", "Print a JSON envelope.")
|
|
44
44
|
.action(async (slug, options) => {
|
|
45
45
|
await handleAsyncAction("agent disable", options, () => requestOxygen(`/api/cli/agent/${encodeURIComponent(slug)}/disable`, { method: "POST" }));
|
|
@@ -63,9 +63,9 @@ export function registerAgentFamily(program, handleAsyncAction) {
|
|
|
63
63
|
});
|
|
64
64
|
}))
|
|
65
65
|
.addCommand(new Command("set")
|
|
66
|
-
.description("Publish an immutable version (reconfigure) for a runtime agent:
|
|
66
|
+
.description("Publish an immutable version (reconfigure) for a runtime agent: your first Oxygent (workspace) or a custom agent.")
|
|
67
67
|
.argument("<slug>", "workspace, or a custom agent slug (from `oxygen agent create`).")
|
|
68
|
-
.requiredOption("--instructions <text>", "
|
|
68
|
+
.requiredOption("--instructions <text>", "Agent instructions for this version.")
|
|
69
69
|
.option("--model-policy-json <json>", AGENT_MODEL_POLICY_HELP)
|
|
70
70
|
.option("--tool-policy-json <json>", AGENT_TOOL_POLICY_HELP)
|
|
71
71
|
.option("--context-policy-json <json>", "Context policy JSON: on_demand, prefetch, or grounded (seeds the run from the workspace knowledge wiki); optional resolve_args and file_ids.")
|
|
@@ -136,7 +136,7 @@ export function registerAgentFamily(program, handleAsyncAction) {
|
|
|
136
136
|
await handleAsyncAction("agent delete", options, () => requestOxygen(`/api/cli/agent/${encodeURIComponent(slug)}`, { method: "DELETE" }));
|
|
137
137
|
}))
|
|
138
138
|
.addCommand(new Command("run")
|
|
139
|
-
.description("Start a durable chat/run for
|
|
139
|
+
.description("Start a durable chat/run for your first Oxygent (workspace) or a custom Agent.")
|
|
140
140
|
.argument("<slug>", "workspace, or a custom Agent slug from `oxygen agent custom`.")
|
|
141
141
|
.option("--goal <text>", "Natural-language goal.")
|
|
142
142
|
.option("--input-json <json>", "Structured run input instead of --goal.")
|
|
@@ -170,7 +170,7 @@ export function registerAgentFamily(program, handleAsyncAction) {
|
|
|
170
170
|
});
|
|
171
171
|
}))
|
|
172
172
|
.addCommand(new Command("run-get")
|
|
173
|
-
.description("Inspect one
|
|
173
|
+
.description("Inspect one run of your first Oxygent or a custom Agent, with its append-only event ledger.")
|
|
174
174
|
.argument("<slug>", "workspace, or a custom Agent slug from `oxygen agent custom`.")
|
|
175
175
|
.argument("<run-id>", "Agent run id.")
|
|
176
176
|
.option("--after-seq <n>", "Return events after this sequence number.")
|
|
@@ -185,7 +185,7 @@ export function registerAgentFamily(program, handleAsyncAction) {
|
|
|
185
185
|
});
|
|
186
186
|
}))
|
|
187
187
|
.addCommand(new Command("cancel")
|
|
188
|
-
.description("Request cancellation of an active
|
|
188
|
+
.description("Request cancellation of an active run of your first Oxygent or a custom Agent.")
|
|
189
189
|
.argument("<slug>", "workspace, or a custom Agent slug from `oxygen agent custom`.")
|
|
190
190
|
.argument("<run-id>", "Agent run id.")
|
|
191
191
|
.option("--json", "Print a JSON envelope.")
|
|
@@ -193,7 +193,7 @@ export function registerAgentFamily(program, handleAsyncAction) {
|
|
|
193
193
|
await handleAsyncAction("agent run cancel", options, () => requestOxygen(`/api/cli/agent/${encodeURIComponent(slug)}/runs/${encodeURIComponent(runId)}/cancel`, { method: "POST" }));
|
|
194
194
|
}))
|
|
195
195
|
.addCommand(new Command("approval-decide")
|
|
196
|
-
.description("Approve or reject one pending
|
|
196
|
+
.description("Approve or reject one pending tool call of your first Oxygent or a custom Agent, then resume its durable run.")
|
|
197
197
|
.argument("<slug>", "workspace, or a custom Agent slug from `oxygen agent custom`.")
|
|
198
198
|
.argument("<run-id>", "Agent run id.")
|
|
199
199
|
.argument("<approval-id>", "Approval id from the run event ledger.")
|
|
@@ -203,7 +203,7 @@ export function registerAgentFamily(program, handleAsyncAction) {
|
|
|
203
203
|
await handleAsyncAction("agent approval decide", options, () => requestOxygen(`/api/cli/agent/${encodeURIComponent(slug)}/runs/${encodeURIComponent(runId)}/approvals/${encodeURIComponent(approvalId)}`, { method: "POST", body: { decision: options.decision } }));
|
|
204
204
|
}))
|
|
205
205
|
.addCommand(new Command("trigger-create")
|
|
206
|
-
.description(`Create a cron, internal event, or signed-webhook trigger for
|
|
206
|
+
.description(`Create a cron, internal event, or signed-webhook trigger for your first Oxygent (workspace). A webhook trigger returns its URL, its secret once, and rate_limit: ${WEBHOOK_TRIGGER_RATE_HELP}.`)
|
|
207
207
|
.argument("<slug>", "Currently: workspace.")
|
|
208
208
|
.requiredOption("--type <cron|event|webhook>", "Trigger type.")
|
|
209
209
|
.requiredOption("--instruction <text>", "Goal template run for each delivery.")
|
|
@@ -235,14 +235,14 @@ export function registerAgentFamily(program, handleAsyncAction) {
|
|
|
235
235
|
});
|
|
236
236
|
}))
|
|
237
237
|
.addCommand(new Command("triggers")
|
|
238
|
-
.description("List
|
|
238
|
+
.description("List your first Oxygent's cron, internal event, and webhook triggers. A legacy cron held to the plan minimum includes slowed_to_plan_minimum and its next run time.")
|
|
239
239
|
.argument("<slug>", "Currently: workspace.")
|
|
240
240
|
.option("--json", "Print a JSON envelope.")
|
|
241
241
|
.action(async (slug, options) => {
|
|
242
242
|
await handleAsyncAction("agent triggers", options, () => requestOxygen(`/api/cli/agent/${encodeURIComponent(slug)}/triggers`));
|
|
243
243
|
}))
|
|
244
244
|
.addCommand(new Command("trigger-set")
|
|
245
|
-
.description("Activate, pause, or archive one
|
|
245
|
+
.description("Activate, pause, or archive one trigger of your first Oxygent.")
|
|
246
246
|
.argument("<slug>", "Currently: workspace.")
|
|
247
247
|
.argument("<trigger-id>", "Agent trigger id.")
|
|
248
248
|
.requiredOption("--status <active|paused|archived>", "New trigger status.")
|
package/dist/commands/columns.js
CHANGED
|
@@ -854,7 +854,7 @@ export function registerColumnsFamily(program, handleAsyncAction) {
|
|
|
854
854
|
.option("--research-exclude-domains <csv>", "Research columns: comma-separated domains to exclude from results.")
|
|
855
855
|
.option("--research-mode <mode>", "Research columns: how tightly the answer is bound to the sources. Default: summarize and combine what they say. strict: answer only from what a source states verbatim (for figures and identifiers). estimate: reason to a figure from the evidence (for revenue or headcount).")
|
|
856
856
|
.option("--research-results <n>", "Research columns: how many search results to ground each row on (1-25, default 5). More evidence costs no extra search, but a larger prompt.")
|
|
857
|
-
.option("--research-engine <engine>", "Research columns: pin the search provider (serper or exa), or with --research-url the page-fetch provider (firecrawl or exa). Defaults to serper for search and firecrawl for fetch, falling back automatically. Most users should not set this.")
|
|
857
|
+
.option("--research-engine <engine>", "Research columns: pin the search provider (serper or exa) of a --research-depth quick column, or with --research-url the page-fetch provider (firecrawl or exa). Defaults to serper for search and firecrawl for fetch, falling back to the other automatically. Standard and deep depths plan their own searches and ignore it. Most users should not set this.")
|
|
858
858
|
.option("--type <type>", "Field type, the web picker's names: text, number, checkbox, date, json, markdown, image, select, multi_select or status. Sets kind manual with the matching data and semantic type (multi_select stores jsonb); text/number/checkbox/date/json also work as a data type beside --kind.")
|
|
859
859
|
.option("--options <choices>", "Choices for a select, multi_select or status column, comma-separated, in display order, e.g. \"Lead,Contacted,Replied,Won\". Each value is what a cell stores; colors are assigned. Use --options-json for labels or colors.")
|
|
860
860
|
.option("--options-json <json>", "Choices as a JSON array of strings or {value,label?,color?} objects (colors: gray, red, orange, amber, yellow, green, teal, blue, indigo, purple, pink). value is what a cell stores; label is what the grid shows.")
|
|
@@ -876,7 +876,7 @@ export function registerColumnsFamily(program, handleAsyncAction) {
|
|
|
876
876
|
.addOption(new Option("--yes-no <question>", "Classification column: answer this yes/no question per row (reference columns as {{column_key}}). Filter on the answer with `tables query --filter-tree-json` and a path leaf, e.g. '{\"type\":\"group\",\"conjunction\":\"and\",\"children\":[{\"type\":\"leaf\",\"columnKey\":\"<column>\",\"path\":\"answer\",\"operator\":\"is\",\"value\":true}]}'."))
|
|
877
877
|
.addOption(new Option("--score <levels>", "Classification column: rate each row on these comma-separated levels, lowest first (2-10), answering --prompt."))
|
|
878
878
|
.addOption(new Option("--min-confidence <0-1>", "Classification columns: below this the answer is marked uncertain. Default 0.85 (0.7 for --yes-no)."))
|
|
879
|
-
.addOption(new Option("--grounding <mode>", "Classification columns: none (default) judges only the row and your question; workspace also sends
|
|
879
|
+
.addOption(new Option("--grounding <mode>", "Classification columns: none (default) judges only the row and your question; workspace also sends the Knowledge pages that match it (ICP, positioning) where Knowledge retrieval is on, which is off for AI columns in production today."))
|
|
880
880
|
.option("--bind-object <slug>", "Bind column CRM object slug (companies, people, deals, ...). Sets kind=bind and resolves rows to CRM records by identity.")
|
|
881
881
|
.option("--bind-map <pairs>", "Bind identity mapping as identity=column pairs, e.g. domain=website,linkedin_url=li.")
|
|
882
882
|
.option("--bind-create", "Bind columns: assert a new CRM record for unmatched rows (onNoMatch=create; a truth write, needs --approved on run).")
|
|
@@ -1349,7 +1349,7 @@ export function registerColumnsFamily(program, handleAsyncAction) {
|
|
|
1349
1349
|
.option("--research-exclude-domains <csv>", "Research columns: replace the comma-separated list of domains to exclude.")
|
|
1350
1350
|
.option("--research-mode <mode>", "Research columns: strict (answer only from the sources) or estimate (reason to a figure from them).")
|
|
1351
1351
|
.option("--research-results <n>", "Research columns: how many search results to ground each row on (1-25).")
|
|
1352
|
-
.option("--research-engine <engine>", "Research columns: pin the search provider (serper or exa).")
|
|
1352
|
+
.option("--research-engine <engine>", "Research columns: pin the search provider (serper or exa) of a --research-depth quick column; standard and deep plan their own searches and ignore it.")
|
|
1353
1353
|
.option("--research-depth <depth>", RESEARCH_DEPTH_OPTION_HELP)
|
|
1354
1354
|
// Declaring BOTH forms leaves the default undefined (Commander only
|
|
1355
1355
|
// defaults to true when --no- is declared alone), so an update that
|
package/dist/commands/copilot.js
CHANGED
|
@@ -330,7 +330,7 @@ function waitForCopilotTurn(options) {
|
|
|
330
330
|
export function registerCopilotFamily(program, handleAsyncAction) {
|
|
331
331
|
program
|
|
332
332
|
.command("copilot")
|
|
333
|
-
.description("Workspace Copilot: an attended
|
|
333
|
+
.description("Workspace Copilot: an attended agent you drive turn by turn from the terminal. Start a session, send it messages and watch the reply stream, approve the actions it proposes, then cancel when done. Managed inference uses workspace credits; paid or external actions keep their own approval gates. Web: /copilot.")
|
|
334
334
|
.addCommand(new Command("dev-eval")
|
|
335
335
|
.description("DEV staff owner only: immutable USD30 campaign and supplier ledger; classify dispatches guarded inference.")
|
|
336
336
|
.argument("<operation>", "create, register, readiness, ledger, effects, classify, accept-pilot or end")
|
|
@@ -785,7 +785,7 @@ export function registerKnowledgeFamily(program, handleAsyncAction) {
|
|
|
785
785
|
}))
|
|
786
786
|
.addCommand(knowledgeBootstrapCommand)
|
|
787
787
|
.addCommand(new Command("synthesize")
|
|
788
|
-
.description("Synthesize knowledge from workspace evidence (one low-cost AI call, priced as one low-reasoning AI column cell): campaign learnings from auto-filed outreach outcomes, or your writing voice (a voice guide) learned from your sent LinkedIn and WhatsApp messages. Every run spends credits, the preview included, unless fewer than 3 sent messages exist (insufficient_source_messages, nothing charged); without --approved nothing is saved. To keep the guide a preview showed, pass its body back with --approved --body (no new AI call); --approved alone synthesizes and charges again. A saved voice guide becomes the canonical voice once a human approves its pin proposal (oxygen knowledge proposals approve <id>); it then grounds message, reply, sequence and post drafts and AI columns.")
|
|
788
|
+
.description("Synthesize knowledge from workspace evidence (one low-cost AI call, priced as one low-reasoning AI column cell): campaign learnings from auto-filed outreach outcomes, or your writing voice (a voice guide) learned from your sent LinkedIn and WhatsApp messages. Every run spends credits, the preview included, unless fewer than 3 sent messages exist (insufficient_source_messages, nothing charged); without --approved nothing is saved. To keep the guide a preview showed, pass its body back with --approved --body (no new AI call); --approved alone synthesizes and charges again. A saved voice guide becomes the canonical voice once a human approves its pin proposal (oxygen knowledge proposals approve <id>); it then grounds message, reply, sequence and post drafts, Oxygent chats and message-writing AI columns.")
|
|
789
789
|
.option("--kind <kind>", "What to synthesize: campaign_learnings (default) or voice (your writing voice from sent LinkedIn and WhatsApp messages).", "campaign_learnings")
|
|
790
790
|
.option("--sequence <sequence_id>", "Scope campaign learnings to one sequence's learnings page. Omit for the org-wide [[outreach-learnings]] page.")
|
|
791
791
|
.option("--approved", "Write the synthesized result (learnings page revision / voice guide saved with a pin proposal) instead of previewing.")
|
package/dist/commands/orgs.js
CHANGED
|
@@ -181,7 +181,7 @@ export function registerOrgsFamily(program, handleAsyncAction) {
|
|
|
181
181
|
});
|
|
182
182
|
}))
|
|
183
183
|
.addCommand(new Command("billing-link")
|
|
184
|
-
.description("Cover a workspace with another organization's paid plan instead of buying a second subscription. Omit --owner when exactly one owner is eligible; orgs billing-owners lists them. You must administer both organizations, the workspace must not hold its own live subscription, and an org-bound key can link only its workspace. The owner funds credits; data access stays unchanged.
|
|
184
|
+
.description("Cover a workspace with another organization's paid plan instead of buying a second subscription. Omit --owner when exactly one owner is eligible; orgs billing-owners lists them. You must administer both organizations, the workspace must not hold its own live subscription, and an org-bound key can link only its workspace. The owner funds credits; data access stays unchanged. Connected accounts, sending and publishing run on the owner's credits, including when plan_tier is free (billing estimate reports sender_billing: credit_reservations). Connecting a sending account or an Instagram/TikTok/YouTube/Facebook account needs the owner's paid plan; a new BYOK key needs the owner on the $99 plan or above. billing usage --group-by workspace reports each linked workspace's spend.")
|
|
185
185
|
.option("--owner <organization>", "Billing owner organization id, Clerk org id, or slug. Optional — when omitted, Oxygen uses your one eligible organization, and refuses to pick if there is more than one.")
|
|
186
186
|
.option("--organization <organization>", "Workspace organization to link. Defaults to the active organization.")
|
|
187
187
|
.option("--organization-id <id>", "Alias for --organization.")
|
|
@@ -209,7 +209,7 @@ export function registerOrgsFamily(program, handleAsyncAction) {
|
|
|
209
209
|
});
|
|
210
210
|
}))
|
|
211
211
|
.addCommand(new Command("billing-unlink")
|
|
212
|
-
.description("Return a workspace to its own billing owner and credit balance. Its own subscription state
|
|
212
|
+
.description("Return a workspace to its own billing owner and credit balance. Its own subscription state and plan then decide which actions need a plan.")
|
|
213
213
|
.option("--organization <organization>", "Workspace organization to unlink. Defaults to the active organization.")
|
|
214
214
|
.option("--organization-id <id>", "Alias for --organization.")
|
|
215
215
|
.option("--json", "Print a JSON envelope.")
|
|
@@ -1560,7 +1560,7 @@ export function registerSequencesFamily(program, handleAsyncAction) {
|
|
|
1560
1560
|
.option("--timezone <iana>", "IANA timezone. Defaults to UTC.")
|
|
1561
1561
|
.option("--max-records-per-list <n>", "Hard complete-snapshot cap per list (1-5000).", "5000")
|
|
1562
1562
|
.option("--max-credits <n>", "Hard credit ceiling per delivery.", "10")
|
|
1563
|
-
.option("--include-contacted", "Allow leads
|
|
1563
|
+
.option("--include-contacted", "Allow leads whose LinkedIn identity another active Sequence is contacting (excluded by default). This import stores a lead's LinkedIn identity only when this Sequence has LinkedIn steps, so email-only leads are never checked.")
|
|
1564
1564
|
.option("--reviewed-fingerprint <hash>", "Fingerprint returned by the exact dry-run preview; required for live activation.")
|
|
1565
1565
|
.option("--idempotency-key <key>", "Optional idempotency key for the immediate first durable run.")
|
|
1566
1566
|
.option("--live", "Create/bind the Table if needed, arm the Workflow, and enqueue the first cycle.")
|
|
@@ -1678,7 +1678,7 @@ export function registerSequencesFamily(program, handleAsyncAction) {
|
|
|
1678
1678
|
.option("--mailboxes <ids>", "Per-sequence sending-account allowlist for native email (Instantly's 'Accounts to use'): comma-separated mailbox ids. Native email sends rotate ONLY over these mailboxes instead of the whole pool. Omit for the whole pool. Note: a narrow allowlist plus --esp-matching strict can starve sends when no allowed same-provider mailbox exists (surfaced as blocked defer reasons in stats).")
|
|
1679
1679
|
.option("--sender-profiles <ids>", "Send from these sender profiles (unified LinkedIn/WhatsApp/inbox identities): comma-separated profile ids (`oxygen senders profiles list` lists them). The server resolves each into its senders + inboxes. Live start is blocked if a selected profile lacks an account for a channel the journey uses.")
|
|
1680
1680
|
.option("--no-stop-on-bounce", "Keep a lead's enrollment running after a hard bounce (default: stop it). The bounce is still recorded as an email_bounced signal either way.")
|
|
1681
|
-
.option("--exclude-contacted", "Default every enroll into this sequence to cross-campaign exclusion
|
|
1681
|
+
.option("--exclude-contacted", "Default every enroll into this sequence to cross-campaign exclusion: skip leads whose LinkedIn identity (lead_provider_id) another active sequence is already contacting. Leads without one, such as email- or phone-only leads, are never checked, and enrolling from a table or file stores one only in a sequence with LinkedIn steps unless you pass lead_provider_id. A per-enroll `sequences enroll --exclude-contacted` / `--no-exclude-contacted` always overrides this default. Off by default.")
|
|
1682
1682
|
.option("--no-exclude-contacted", "Turn the sequence-level exclude-contacted default back OFF (enrollments then exclude cross-campaign only when a call opts in).")
|
|
1683
1683
|
.option("--auto-enroll-table-rows", "Rows added to the sequence's table join it while it is active (a first launch turns this on unless it was turned off).")
|
|
1684
1684
|
.option("--no-auto-enroll-table-rows", "Keep enrollment manual: launching does not enroll the table, and new rows wait for `sequences enroll`.")
|
|
@@ -1828,7 +1828,7 @@ export function registerSequencesFamily(program, handleAsyncAction) {
|
|
|
1828
1828
|
.option("--mailboxes <ids>", "Per-sequence sending-account allowlist for native email (Instantly's 'Accounts to use'): comma-separated mailbox ids. Native email sends rotate ONLY over these mailboxes instead of the whole pool. Note: a narrow allowlist plus --esp-matching strict can starve sends when no allowed same-provider mailbox exists (surfaced as blocked defer reasons in stats). \"\" removes the allowlist.")
|
|
1829
1829
|
.option("--sender-profiles <ids>", "Send from these sender profiles (unified LinkedIn/WhatsApp/inbox identities): comma-separated profile ids (`oxygen senders profiles list` lists them). The server resolves each into its senders + inboxes. Live start is blocked if a selected profile lacks an account for a channel the journey uses.")
|
|
1830
1830
|
.option("--no-stop-on-bounce", "Keep a lead's enrollment running after a hard bounce (default: stop it). The bounce is still recorded as an email_bounced signal either way.")
|
|
1831
|
-
.option("--exclude-contacted", "Default every enroll into this sequence to cross-campaign exclusion
|
|
1831
|
+
.option("--exclude-contacted", "Default every enroll into this sequence to cross-campaign exclusion: skip leads whose LinkedIn identity (lead_provider_id) another active sequence is already contacting. Leads without one, such as email- or phone-only leads, are never checked, and enrolling from a table or file stores one only in a sequence with LinkedIn steps unless you pass lead_provider_id. A per-enroll `sequences enroll --exclude-contacted` / `--no-exclude-contacted` always overrides this default. Off by default.")
|
|
1832
1832
|
.option("--no-exclude-contacted", "Turn the sequence-level exclude-contacted default back OFF (enrollments then exclude cross-campaign only when a call opts in).")
|
|
1833
1833
|
.option("--auto-enroll-table-rows", "Rows added to the sequence's table join it while it is active (a first launch turns this on unless it was turned off).")
|
|
1834
1834
|
.option("--no-auto-enroll-table-rows", "Keep enrollment manual: launching does not enroll the table, and new rows wait for `sequences enroll`.")
|
|
@@ -1951,7 +1951,7 @@ export function registerSequencesFamily(program, handleAsyncAction) {
|
|
|
1951
1951
|
.option("--from-table", "Enroll every not-yet-enrolled row of the sequence's bound source table (up to 500 per run; re-run to continue). Exactly one of --leads-file, --from-table or --from-list.")
|
|
1952
1952
|
.option("--from-list <idOrKey>", "Sending-domain Sequences: enroll up to 500 subscribed addresses of the Sequence's own subscription list per run, each filed as an email-only lead in its leads table (another list is refused: sequence_from_list_mismatch). Re-run with --from-list-after <from_list.next_after> while from_list.has_more.")
|
|
1953
1953
|
.option("--from-list-after <email>", "With --from-list: continue after this address (the previous run's from_list.next_after).")
|
|
1954
|
-
.option("--exclude-contacted", "Also skip leads
|
|
1954
|
+
.option("--exclude-contacted", "Also skip leads whose LinkedIn identity (lead_provider_id) another active sequence is already contacting (cross-campaign exclusion), for THIS enroll; email- or phone-only leads, and leads of a sequence without LinkedIn steps that carry no explicit lead_provider_id, are never checked. Off by default; forces exclusion on even if the sequence's exclude_contacted default is off.")
|
|
1955
1955
|
.option("--no-exclude-contacted", "Force-INCLUDE cross-campaign leads for this enroll even when the sequence's exclude_contacted default is on (per-call override).")
|
|
1956
1956
|
.option("--suppress-list <ids>", "Per-call do-not-enroll lead provider ids dropped for this enroll only: a comma-separated list, or @<path> to a file of ids (comma/whitespace separated).")
|
|
1957
1957
|
.option("--ignore-sender-bindings", "Enroll leads even when they are already owned by a sender account outside this sequence's pool (overrides the one-person-one-sender guarantee). Off by default.")
|
|
@@ -2054,7 +2054,7 @@ export function registerSequencesFamily(program, handleAsyncAction) {
|
|
|
2054
2054
|
.option("--launch-review-json <json>", "Guided onboarding: echo the exact preview.launch_review (digest, expiry, positive action ceiling and nonnegative credit cap). Changed inputs require a new preview.")
|
|
2055
2055
|
.option("--launch-review-file <path>", "Read the exact launch_review object from a JSON file instead of --launch-review-json.")
|
|
2056
2056
|
.option("--at <time>", "Schedule a draft's start: an ISO timestamp with a timezone (2026-11-02T09:00:00Z) or \"in 30m\" / \"in 2h\" / \"in 3d\", at most 30 days ahead. With --approved it activates now and sends nothing before then (lifecycle scheduled); cancel with `sequences unschedule`.")
|
|
2057
|
-
.option("--dry-run", "Activate the sequence (status draft → active, startedAt set) in dry-run mode: every step advances with simulated actions — no sends, CRM writes, provider calls, or credits. This is NOT the preview: `sequences start` with no flags is the side-effect-free launch preview. A later live start (--approved) restarts those leads from the first step so they are contacted for real, except deleted source rows, a
|
|
2057
|
+
.option("--dry-run", "Activate the sequence (status draft → active, startedAt set) in dry-run mode: every step advances with simulated actions — no sends, CRM writes, provider calls, or credits. This is NOT the preview: `sequences start` with no flags is the side-effect-free launch preview. A later live start (--approved) restarts those leads from the first step so they are contacted for real, except deleted source rows, a lead whose LinkedIn identity another live campaign contacts under exclude_contacted, and older duplicates of a person.")
|
|
2058
2058
|
.option("--json", "Print a JSON envelope.")
|
|
2059
2059
|
.action(async (sequence, options) => {
|
|
2060
2060
|
await handleAsyncAction("sequences start", options, () => {
|
|
@@ -33,9 +33,9 @@ function suppressionListParams(options) {
|
|
|
33
33
|
}
|
|
34
34
|
export function registerSuppressionsFamily(program, handleAsyncAction) {
|
|
35
35
|
program.addCommand(new Command("suppressions")
|
|
36
|
-
.description("Unified do-not-contact controls for people and typed identities. `policy` decides WHO GETS ADDED automatically -- which replies, bounces, unsubscribes and call outcomes
|
|
36
|
+
.description("Unified do-not-contact controls for people and typed identities. `policy` decides WHO GETS ADDED automatically -- which replies, bounces, unsubscribes and call outcomes add an identity to the list (an email event adds only the address), and whether each one blocks it forever or only stops the current campaign. `crm-backfill` files the people already on the list into your CRM. `import-person` bundles one contact's email, LinkedIn, phone, and explicit company domain; `import` preserves the legacy mixed-file contract; `import-identities` is the integration-level typed endpoint; `hubspot lists|sync` arms additive synchronization. Company DNC applies across Sequence channels and is never inferred from a person's email. Consumes 0 credits.")
|
|
37
37
|
.addCommand(new Command("policy")
|
|
38
|
-
.description("Do-not-contact RULES: who gets added to the list automatically. Seven events can add someone -- an email hard bounce, a one-click unsubscribe, opt-out wording in a reply, ANY inbound LinkedIn reply, ANY inbound WhatsApp reply, and the do-not-call / wrong-number call outcomes -- plus an optional rule per inbox reply classification. Each rule is off, stop_only (end this campaign but do not block future ones) or suppress (the default for all seven, and what every version before this did). Blocking itself is never configurable:
|
|
38
|
+
.description("Do-not-contact RULES: who gets added to the list automatically. Seven events can add someone -- an email hard bounce, a one-click unsubscribe, opt-out wording in a reply, ANY inbound LinkedIn reply, ANY inbound WhatsApp reply, and the do-not-call / wrong-number call outcomes -- plus an optional rule per inbox reply classification. Each rule is off, stop_only (end this campaign but do not block future ones) or suppress (the default for all seven, and what every version before this did). Blocking itself is never configurable: an entry always blocks the identity it holds, and an email entry blocks email steps only. Consumes 0 credits.")
|
|
39
39
|
.addCommand(new Command("show")
|
|
40
40
|
.description("Show every do-not-contact rule with its current setting, whether that is your change or the shipped default, and the values it accepts.")
|
|
41
41
|
.option("--json", "Print a JSON envelope.")
|
|
@@ -16,5 +16,5 @@ export declare const CANONICAL_COPY_READ_EXECUTION = "Read the canonical copy AI
|
|
|
16
16
|
* The blind baseline also searched "writing style" and "voice learn".
|
|
17
17
|
*/
|
|
18
18
|
export declare function isWorkspaceVoiceIntent(query: string): boolean;
|
|
19
|
-
export declare const WORKSPACE_VOICE_EXECUTION = "A writing voice is learned from the workspace's own sent LinkedIn and WhatsApp messages: `oxygen knowledge synthesize --kind voice --json` (MCP: oxygen_context_synthesize with kind voice) runs one low-cost AI call, priced as one low-reasoning AI column cell, the preview included, and reports credits_used; to save the guide a preview showed, pass its body back with --approved --body (no new AI call) at 0 credits, because --approved alone synthesizes and charges again. Saving files a pin proposal: the guide becomes the canonical voice, which grounds message, reply, sequence and post drafts and AI columns, only once a human approves that proposal (oxygen knowledge proposals approve <id>; MCP oxygen_knowledge_proposal_decide). It reads sent messages only, not posts, emails or web pages. Brand voice and tone live in wiki pages (knowledge search). A creator's voice in a UGC program is `ugc voice import`. When the user already has the guide's text, no synthesis is needed: save it with `knowledge page upsert --type voice` and request the pin with `knowledge page pin` (MCP oxygen_knowledge_page_upsert with canonical: true), both 0 credits. Which voice AI copy uses now: `context canonical get --type voice` (MCP oxygen_context_canonical_get). To hard-cap a synthesis run, pass `--max-credits <n>` (MCP max_credits): a higher estimate is refused before the AI call, with nothing charged.";
|
|
19
|
+
export declare const WORKSPACE_VOICE_EXECUTION = "A writing voice is learned from the workspace's own sent LinkedIn and WhatsApp messages: `oxygen knowledge synthesize --kind voice --json` (MCP: oxygen_context_synthesize with kind voice) runs one low-cost AI call, priced as one low-reasoning AI column cell, the preview included, and reports credits_used; to save the guide a preview showed, pass its body back with --approved --body (no new AI call) at 0 credits, because --approved alone synthesizes and charges again. Saving files a pin proposal: the guide becomes the canonical voice, which grounds message, reply, sequence and post drafts, Oxygent chats and message-writing AI columns, only once a human approves that proposal (oxygen knowledge proposals approve <id>; MCP oxygen_knowledge_proposal_decide). It reads sent messages only, not posts, emails or web pages. Brand voice and tone live in wiki pages (knowledge search). A creator's voice in a UGC program is `ugc voice import`. When the user already has the guide's text, no synthesis is needed: save it with `knowledge page upsert --type voice` and request the pin with `knowledge page pin` (MCP oxygen_knowledge_page_upsert with canonical: true), both 0 credits. Which voice AI copy uses now: `context canonical get --type voice` (MCP oxygen_context_canonical_get). To hard-cap a synthesis run, pass `--max-credits <n>` (MCP max_credits): a higher estimate is refused before the AI call, with nothing charged.";
|
|
20
20
|
export declare function isWorkspaceSkillIntent(query: string): boolean;
|
|
@@ -31,7 +31,7 @@ export function isWorkspaceVoiceIntent(query) {
|
|
|
31
31
|
|| /\b(?:learn|capture|mimic|copy|match)\w*\b.{0,30}\bvoice\b/.test(query)
|
|
32
32
|
|| /\bvoice\b.{0,30}\b(?:learn|capture|mimic|copy|match)\w*\b/.test(query);
|
|
33
33
|
}
|
|
34
|
-
export const WORKSPACE_VOICE_EXECUTION = "A writing voice is learned from the workspace's own sent LinkedIn and WhatsApp messages: `oxygen knowledge synthesize --kind voice --json` (MCP: oxygen_context_synthesize with kind voice) runs one low-cost AI call, priced as one low-reasoning AI column cell, the preview included, and reports credits_used; to save the guide a preview showed, pass its body back with --approved --body (no new AI call) at 0 credits, because --approved alone synthesizes and charges again. Saving files a pin proposal: the guide becomes the canonical voice, which grounds message, reply, sequence and post drafts and AI columns, only once a human approves that proposal (oxygen knowledge proposals approve <id>; MCP oxygen_knowledge_proposal_decide). It reads sent messages only, not posts, emails or web pages. Brand voice and tone live in wiki pages (knowledge search). A creator's voice in a UGC program is `ugc voice import`. When the user already has the guide's text, no synthesis is needed: save it with `knowledge page upsert --type voice` and request the pin with `knowledge page pin` (MCP oxygen_knowledge_page_upsert with canonical: true), both 0 credits. Which voice AI copy uses now: `context canonical get --type voice` (MCP oxygen_context_canonical_get). To hard-cap a synthesis run, pass `--max-credits <n>` (MCP max_credits): a higher estimate is refused before the AI call, with nothing charged.";
|
|
34
|
+
export const WORKSPACE_VOICE_EXECUTION = "A writing voice is learned from the workspace's own sent LinkedIn and WhatsApp messages: `oxygen knowledge synthesize --kind voice --json` (MCP: oxygen_context_synthesize with kind voice) runs one low-cost AI call, priced as one low-reasoning AI column cell, the preview included, and reports credits_used; to save the guide a preview showed, pass its body back with --approved --body (no new AI call) at 0 credits, because --approved alone synthesizes and charges again. Saving files a pin proposal: the guide becomes the canonical voice, which grounds message, reply, sequence and post drafts, Oxygent chats and message-writing AI columns, only once a human approves that proposal (oxygen knowledge proposals approve <id>; MCP oxygen_knowledge_proposal_decide). It reads sent messages only, not posts, emails or web pages. Brand voice and tone live in wiki pages (knowledge search). A creator's voice in a UGC program is `ugc voice import`. When the user already has the guide's text, no synthesis is needed: save it with `knowledge page upsert --type voice` and request the pin with `knowledge page pin` (MCP oxygen_knowledge_page_upsert with canonical: true), both 0 credits. Which voice AI copy uses now: `context canonical get --type voice` (MCP oxygen_context_canonical_get). To hard-cap a synthesis run, pass `--max-credits <n>` (MCP max_credits): a higher estimate is refused before the AI call, with nothing charged.";
|
|
35
35
|
export function isWorkspaceSkillIntent(query) {
|
|
36
36
|
return /\bskills?\b/.test(query) && /\b(create|author|write|upload|import|edit|update|archive|private|workspace|custom|own|reusable)\b/.test(query);
|
|
37
37
|
}
|
|
@@ -98,7 +98,7 @@ export function tableRowRemovalRecommendation(query) {
|
|
|
98
98
|
return {
|
|
99
99
|
tools: ["oxygen_table_rows_remove_selection", "oxygen_tables_query", "oxygen_table_rows_page"],
|
|
100
100
|
commands: ["tables rows remove-selection", "tables query", "tables rows page"],
|
|
101
|
-
execution: "Delete Table rows with tables rows remove-selection (oxygen_table_rows_remove_selection): the rows a readable filter tree matches (--filter-tree-json / filter_tree, the same tree tables query takes), exact row_ids, or an all_matching selection with search, sort, range and exclusions. Hydrate its schema first. Unreadable filter nodes and filters arrays are refused; unqualified all_matching deletes every row. This is permanent and costs 0 credits; to keep a restorable copy first, tables duplicate (oxygen_tables_duplicate, 0 credits). Read the matching rows before deletion and the survivors afterward; each removed row's values stay readable with rows history (oxygen_rows_history). Deleting rows does not stop campaign enrollment.",
|
|
101
|
+
execution: "Delete Table rows with tables rows remove-selection (oxygen_table_rows_remove_selection): the rows a readable filter tree matches (--filter-tree-json / filter_tree, the same tree tables query takes), exact row_ids, or an all_matching selection with search, sort, range and exclusions. Hydrate its schema first. Unreadable filter nodes and filters arrays are refused; unqualified all_matching deletes every row. This is permanent and costs 0 credits; to keep a restorable copy first, tables duplicate (oxygen_tables_duplicate, 0 credits). Read the matching rows before deletion and the survivors afterward; each removed row's values stay readable for 30 days with rows history (oxygen_rows_history). Deleting rows does not stop campaign enrollment.",
|
|
102
102
|
};
|
|
103
103
|
}
|
|
104
104
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
export declare const OXYGEN_BUILD_VERSION = "1.
|
|
1
|
+
export declare const OXYGEN_BUILD_VERSION = "1.1021.5";
|
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
// GENERATED by scripts/ci/version-stamp.mjs from VERSION + git history. Do not edit; do not commit.
|
|
2
|
-
export const OXYGEN_BUILD_VERSION = "1.
|
|
2
|
+
export const OXYGEN_BUILD_VERSION = "1.1021.5";
|
|
@@ -49,7 +49,7 @@ export const OXYGEN_VERSION = OXYGEN_BUILD_VERSION;
|
|
|
49
49
|
// Since 2026-09-28 the release-preparation step advances this literal to the
|
|
50
50
|
// highest CLI version published on npm for at least 30 days. It never lowers
|
|
51
51
|
// the floor. The source change lands on dev before the next production release.
|
|
52
|
-
export const OXYGEN_MINIMUM_CLI_VERSION = "1.1011.
|
|
52
|
+
export const OXYGEN_MINIMUM_CLI_VERSION = "1.1011.95";
|
|
53
53
|
// The internal GEO export first gains required pagination in this dev version.
|
|
54
54
|
// Earlier pilot clients would save a partial file without its continuation.
|
|
55
55
|
export const GEO_EXPORT_MINIMUM_CLI_VERSION = "1.1013.0";
|