@oxygen-agent/cli 1.1014.985 → 1.1014.1087

package/dist/credentials.js

@@ -3,7 +3,7 @@ import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync,
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 import { promisify } from "node:util";
-import { OxygenError } from "@oxygen/shared";
+import { OxygenError } from "@oxygen/shared/cli-result";
 import { sameApiOrigin } from "./runtime.js";
 const execFileAsync = promisify(execFile);
 const SERVICE_NAME = "oxygen-cli";

package/dist/customer-operation-commands.js

@@ -1,3 +1,4 @@
+import { createHash } from "node:crypto";
 import { readFile, writeFile } from "node:fs/promises";
 import { basename, extname, resolve } from "node:path";
 import { OxygenError } from "@oxygen/shared/cli-result";
@@ -31,8 +32,50 @@ const GROUP_PURPOSES = {
     "notetaker notes": "Edit saved meeting notes.",
     onboarding: "Save workspace discovery choices and resume guided onboarding.",
     "onboarding activation": "Resume your dev-pilot activation and its native resources.",
+    "onboarding journey": "Resume private onboarding, save answers and navigate using native revisions.",
+    "onboarding first-sourcing": "Read and review the native first-leads search before approving a capped run.",
+};
+const GUIDED_JOURNEY_FLAGS = {
+    activationId: { flag: "activation-id", help: "Exact activation ID returned by onboarding activation start or status." },
+    revision: { help: "Current activation revision returned by onboarding journey get; refresh after a conflict." },
+    mutation_id: { help: "Stable ID for this exact change; reuse only to recover the same request." },
+    step: { help: "Current saved step from onboarding journey get; use the revision you reviewed." },
+    answers: { help: "JSON object keyed by the current step, containing that step's reviewed answers." },
+    paused: { help: "Pause at this saved step; --no-paused resumes without advancing.", negateHelp: "Resume the saved step and tour position without changing visited history." },
+    tour_active_stop: { help: "Exact tour panel to return to, separate from visited history; only at the tour step." },
+};
+const GUIDED_FIRST_SOURCING_FLAGS = {
+    activationId: GUIDED_JOURNEY_FLAGS.activationId,
+    revision: { help: "Current activation revision from onboarding first-sourcing get; refresh and review after a conflict." },
+    generation: { help: "Current journey generation from onboarding journey get; supply revision, generation and --timezone-hint together for nightly defaults." },
+    timezoneHint: { flag: "timezone-hint", aliases: ["timezoneHint"], help: "Provisional customer/browser IANA timezone; supply revision, generation and --timezone-hint together. Does not confirm or save a schedule." },
+    "bounds.targetCount": { flag: "bounds-target-count", help: "Positive lead target, at most 50000; must match the stored preview for run." },
+    "bounds.maxPages": { flag: "bounds-max-pages", help: "Positive provider-page ceiling, at most 1000; must match the stored preview for run." },
+    "bounds.maxCredits": { flag: "bounds-max-credits", help: "Positive credit ceiling; native current pricing and the stored preview apply." },
+    previewId: { flag: "preview-id", help: "Exact stored previewId returned by onboarding first-sourcing preview; pass unchanged." },
+    previewDigest: { flag: "preview-digest", help: "Exact lowercase previewDigest from the stored native preview; pass unchanged." },
+    approved: { help: "Approve this exact stored preview and its bounds; native billing, access and current revision still apply." },
 };
 const OPERATION_FLAGS = {
+    "onboarding first-sourcing get": GUIDED_FIRST_SOURCING_FLAGS,
+    "onboarding first-sourcing preview": GUIDED_FIRST_SOURCING_FLAGS,
+    "onboarding first-sourcing run": GUIDED_FIRST_SOURCING_FLAGS,
+    "onboarding company-files upload": {
+        activationId: GUIDED_JOURNEY_FLAGS.activationId,
+        revision: GUIDED_JOURNEY_FLAGS.revision,
+        upload_id: { help: "Stable UUID for these exact original file bytes; reuse only to recover the same upload." },
+        sha256: { help: "Lowercase SHA-256 of the original file bytes; native storage verifies it." },
+        size_bytes: { help: "Exact original file byte length, before base64 encoding." },
+    },
+    "onboarding journey get": GUIDED_JOURNEY_FLAGS,
+    "onboarding journey save": GUIDED_JOURNEY_FLAGS,
+    "onboarding journey advance": GUIDED_JOURNEY_FLAGS,
+    "onboarding journey back": GUIDED_JOURNEY_FLAGS,
+    "onboarding journey restart": GUIDED_JOURNEY_FLAGS,
+    "onboarding journey navigation": GUIDED_JOURNEY_FLAGS,
+    "onboarding journey prospects-preview": GUIDED_JOURNEY_FLAGS,
+    "onboarding journey billing": GUIDED_JOURNEY_FLAGS,
+    "onboarding journey checkout": GUIDED_JOURNEY_FLAGS,
     "agent session activate": {
         revision: { help: "Current session revision returned by agent session preview; must match the reviewed configuration." },
         preview_token: { help: "Exact preview_token from agent session preview, binding reviewed resources, actions, schedule and credit caps. Pass unchanged; --approved is separate. Preview again after changes." },
@@ -85,12 +128,14 @@ export function registerCustomerOperationCommands(program, handle) {
         if (spec.binary)
             command.requiredOption("--output <path>", "Write the exact downloaded bytes to this local file.");
         if (spec.multipart)
-            command.option("--file <path>", "Upload bytes from this local file. Omit the base64 flag; file name and content type default from the path.");
+            command.option("--file <path>", "Upload bytes from this local file. Omit the base64 flag; file name and content type default from the path."
+                + (spec.multipart.fileMetadata ? " Original SHA-256 and size are derived; explicit assertions must match." : ""));
         for (const name of contract.required ?? []) {
             const property = contract.properties[name];
             const flag = `--${overlay[name]?.flag ?? name.replace(/_/g, "-")}`;
             const option = command.options.find((candidate) => candidate.long === flag || candidate.long === `${flag}-json`);
-            const multipartAlternative = spec.multipart && [spec.multipart.contentField, spec.multipart.nameField, spec.multipart.typeField].includes(name);
+            const multipartAlternative = spec.multipart && [spec.multipart.contentField, spec.multipart.nameField, spec.multipart.typeField,
+                ...(spec.multipart.fileMetadata ? [spec.multipart.fileMetadata.sha256Field, spec.multipart.fileMetadata.sizeBytesField] : [])].includes(name);
             if (multipartAlternative) {
                 if (option)
                     option.description = `${option.description} Required unless supplied by --file.`.trim();
@@ -113,9 +158,22 @@ export function registerCustomerOperationCommands(program, handle) {
                     if (input[spec.multipart.contentField] !== undefined)
                         throw new OxygenError("invalid_request", "Choose --file or the base64 content flag, not both.", { exitCode: 2 });
                     const filePath = String(options.file);
-                    input[spec.multipart.contentField] = (await readFile(filePath)).toString("base64");
+                    const bytes = await readFile(filePath);
+                    input[spec.multipart.contentField] = bytes.toString("base64");
                     input[spec.multipart.nameField] ??= basename(filePath);
                     input[spec.multipart.typeField] ??= uploadContentType(filePath);
+                    const metadata = spec.multipart.fileMetadata;
+                    if (metadata) {
+                        const digest = createHash("sha256").update(bytes).digest("hex");
+                        if (input[metadata.sha256Field] !== undefined && input[metadata.sha256Field] !== digest) {
+                            throw new OxygenError("invalid_request", `${metadata.sha256Field} must match the original file bytes.`, { exitCode: 2 });
+                        }
+                        if (input[metadata.sizeBytesField] !== undefined && input[metadata.sizeBytesField] !== bytes.length) {
+                            throw new OxygenError("invalid_request", `${metadata.sizeBytesField} must equal the original decoded byte length.`, { exitCode: 2 });
+                        }
+                        input[metadata.sha256Field] ??= digest;
+                        input[metadata.sizeBytesField] ??= bytes.length;
+                    }
                 }
                 const issues = operationInputIssues(spec, input);
                 if (issues.length)
@@ -188,6 +246,7 @@ function uploadContentType(filePath) {
     const types = {
         ".png": "image/png", ".jpg": "image/jpeg", ".jpeg": "image/jpeg", ".webp": "image/webp", ".svg": "image/svg+xml",
         ".csv": "text/csv", ".json": "application/json", ".jsonl": "application/x-ndjson",
+        ".txt": "text/plain", ".md": "text/markdown", ".markdown": "text/markdown", ".pdf": "application/pdf",
         ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
     };
     return types[extname(filePath).toLowerCase()] ?? "application/octet-stream";

package/dist/help.js

@@ -170,7 +170,7 @@ export function applyOxygenHelp(program, binaryName, docsUrl = "https://oxygen-a
         // first-touch surface names the skill that teaches the GTM loops.
         `  2. ${binaryName} skills install --json      load the skills that teach the GTM loops (automatic after login)`,
         "     Add --project to keep the skills inside the current project, including confined agent sessions.",
-        `  3. ${binaryName} context resolve --purpose onboarding --json   load workspace context and the next reads`,
+        `  3. ${binaryName} context resolve --purpose onboarding --json   load context; may migrate the workspace schema`,
         // Populated workspaces need the same first-win guidance as empty ones.
         `     Getting started? ${binaryName} skills get oxygen-onboarding --json`,
         "     It sharpens your offer and ICP, then ranks the warmest leads you can reach now.",

package/dist/index.d.ts

@@ -1,100 +1,2 @@
-import "./admin-lead-magnet-commands.js";
-import "./admin-primary-providers-render.js";
-import "./auto-update.js";
-import "./browser-login.js";
-import "./cli-values.js";
-import "./column-decision-options.js";
-import "./column-run-notices.js";
-import "./command-manifest.js";
-import "./compact-list-flags.js";
-import "./connectors-commands.js";
-import "./contract-flags.js";
-import "./credentials.js";
-import "./crm-file-read-commands.js";
-import "./crm-support-flags.js";
-import "./customer-operation-commands.js";
-import "./database-query-flags.js";
-import "./diagnostics.js";
-import "./feed-read-flags.js";
-import "./functions-commands.js";
-import "./help.js";
-import "./home-standup.js";
-import "./http-client.js";
-import "./inbox-needs-reply-notice.js";
-import "./json-output.js";
-import "./knowledge-mirror.js";
-import "./knowledge-repository-commands.js";
-import "./local-custom-http-column.js";
-import "./mailbox-ramp-notice.js";
-import "./run-wait.js";
-import "./runtime.js";
-import "./search-ai-filter-notice.js";
-import "./sender-limits-flags.js";
-import "./session.js";
-import "./settings-commands.js";
-import "./skills.js";
-import "./streamed-file-import.js";
-import "./tool-catalog-detail-command.js";
-import "./tool-catalog-search-window.js";
-import "./transcript.js";
-import "./ugc-commands.js";
-import "./update.js";
-import "./util.js";
-import "./visual-commands.js";
-import "./whatsapp-account-flags.js";
-import "./workflow-plan-limit-notices.js";
-import "./workflow-run-list-flags.js";
-import "./workspace-skill-commands.js";
-import "./workspace-utility-flags.js";
-import "@oxygen/recipe-sdk";
-import "@oxygen/shared";
-import "@oxygen/shared/billing";
-import "@oxygen/shared/company-reply-pause";
-import "@oxygen/shared/contracts/billing-owner-read";
-import "@oxygen/shared/contracts/copilot-sessions";
-import "@oxygen/shared/contracts/crm-enrichment-read";
-import "@oxygen/shared/contracts/database";
-import "@oxygen/shared/contracts/inbox-drafts-read";
-import "@oxygen/shared/contracts/integration-connect";
-import "@oxygen/shared/contracts/knowledge-content-reads";
-import "@oxygen/shared/contracts/limits-read";
-import "@oxygen/shared/contracts/linkedin-invites-list";
-import "@oxygen/shared/contracts/operations";
-import "@oxygen/shared/contracts/pipedrive-catalog";
-import "@oxygen/shared/contracts/publishing-reads";
-import "@oxygen/shared/contracts/sender-limits";
-import "@oxygen/shared/contracts/sequence-analytics-read";
-import "@oxygen/shared/contracts/sequence-list";
-import "@oxygen/shared/contracts/table-feed-update";
-import "@oxygen/shared/contracts/table-list";
-import "@oxygen/shared/contracts/table-query-grid";
-import "@oxygen/shared/contracts/table-query-raw";
-import "@oxygen/shared/contracts/whatsapp-reads";
-import "@oxygen/shared/contracts/workflow-run-list";
-import "@oxygen/shared/copilot-questions";
-import "@oxygen/shared/data-suppliers";
-import "@oxygen/shared/file-import";
-import "@oxygen/shared/knowledge-constants";
-import "@oxygen/shared/linkedin-sequences";
-import "@oxygen/shared/mailbox-import";
-import "@oxygen/shared/plan-band";
-import "@oxygen/shared/pricing-sheet";
-import "@oxygen/shared/select-options";
-import "@oxygen/shared/sequence-lifecycle";
-import "@oxygen/shared/table-field-types";
-import "@oxygen/shared/table-filter-operators";
-import "@oxygen/shared/table-run-summary";
-import "@oxygen/shared/user-capability-routing";
-import "@oxygen/workflows";
-import "commander";
-import "node:child_process";
-import "node:crypto";
-import "node:fs";
-import "node:os";
-import "node:path";
-import "node:process";
-import "node:readline/promises";
-import "node:url";
-import { Command } from "commander";
-export declare function createProgram(): Command;
+export { createProgram } from "./command-families/program.js";
 export { formatDisabledWorkflowNotices } from "./command-support.js";

package/dist/index.js

@@ -1,344 +1,12 @@
-// Preserve pre-extraction runtime import initialization order.
-import "./admin-lead-magnet-commands.js";
-import "./admin-primary-providers-render.js";
-import "./auto-update.js";
-import "./browser-login.js";
-import "./cli-values.js";
-import "./column-decision-options.js";
-import "./column-run-notices.js";
-import "./command-manifest.js";
-import "./compact-list-flags.js";
-import "./connectors-commands.js";
-import "./contract-flags.js";
-import "./credentials.js";
-import "./crm-file-read-commands.js";
-import "./crm-support-flags.js";
-import "./customer-operation-commands.js";
-import "./database-query-flags.js";
-import "./diagnostics.js";
-import "./feed-read-flags.js";
-import "./functions-commands.js";
-import "./help.js";
-import "./home-standup.js";
-import "./http-client.js";
-import "./inbox-needs-reply-notice.js";
-import "./json-output.js";
-import "./knowledge-mirror.js";
-import "./knowledge-repository-commands.js";
-import "./local-custom-http-column.js";
-import "./mailbox-ramp-notice.js";
-import "./run-wait.js";
-import "./runtime.js";
-import "./search-ai-filter-notice.js";
-import "./sender-limits-flags.js";
-import "./session.js";
-import "./settings-commands.js";
-import "./skills.js";
-import "./streamed-file-import.js";
-import "./tool-catalog-detail-command.js";
-import "./tool-catalog-search-window.js";
-import "./transcript.js";
-import "./ugc-commands.js";
-import "./update.js";
-import "./util.js";
-import "./visual-commands.js";
-import "./whatsapp-account-flags.js";
-import "./workflow-plan-limit-notices.js";
-import "./workflow-run-list-flags.js";
-import "./workspace-skill-commands.js";
-import "./workspace-utility-flags.js";
-import "@oxygen/recipe-sdk";
-import "@oxygen/shared";
-import "@oxygen/shared/billing";
-import "@oxygen/shared/company-reply-pause";
-import "@oxygen/shared/contracts/billing-owner-read";
-import "@oxygen/shared/contracts/copilot-sessions";
-import "@oxygen/shared/contracts/crm-enrichment-read";
-import "@oxygen/shared/contracts/database";
-import "@oxygen/shared/contracts/inbox-drafts-read";
-import "@oxygen/shared/contracts/integration-connect";
-import "@oxygen/shared/contracts/knowledge-content-reads";
-import "@oxygen/shared/contracts/limits-read";
-import "@oxygen/shared/contracts/linkedin-invites-list";
-import "@oxygen/shared/contracts/operations";
-import "@oxygen/shared/contracts/pipedrive-catalog";
-import "@oxygen/shared/contracts/publishing-reads";
-import "@oxygen/shared/contracts/sender-limits";
-import "@oxygen/shared/contracts/sequence-analytics-read";
-import "@oxygen/shared/contracts/sequence-list";
-import "@oxygen/shared/contracts/table-feed-update";
-import "@oxygen/shared/contracts/table-list";
-import "@oxygen/shared/contracts/table-query-grid";
-import "@oxygen/shared/contracts/table-query-raw";
-import "@oxygen/shared/contracts/whatsapp-reads";
-import "@oxygen/shared/contracts/workflow-run-list";
-import "@oxygen/shared/copilot-questions";
-import "@oxygen/shared/data-suppliers";
-import "@oxygen/shared/file-import";
-import "@oxygen/shared/knowledge-constants";
-import "@oxygen/shared/linkedin-sequences";
-import "@oxygen/shared/mailbox-import";
-import "@oxygen/shared/plan-band";
-import "@oxygen/shared/pricing-sheet";
-import "@oxygen/shared/select-options";
-import "@oxygen/shared/sequence-lifecycle";
-import "@oxygen/shared/table-field-types";
-import "@oxygen/shared/table-filter-operators";
-import "@oxygen/shared/table-run-summary";
-import "@oxygen/shared/user-capability-routing";
-import "@oxygen/workflows";
-import "commander";
-import "node:child_process";
-import "node:crypto";
-import "node:fs";
-import "node:os";
-import "node:path";
-import "node:process";
-import "node:readline/promises";
-import "node:url";
-import { registerAdminLeadMagnetCommands } from "./admin-lead-magnet-commands.js";
 import { maybeScheduleBackgroundUpdate } from "./auto-update.js";
-import { emitCliFailure, handleAsyncAction, writeJson } from "./cli-output.js";
-import { recordCliProfileFlag } from "./cli-profile-context.js";
-import { registerActionColumnFamily } from "./commands/action-column.js";
-import { registerActivationFamily } from "./commands/activation.js";
-import { registerAdminFamily } from "./commands/admin.js";
-import { registerAdsFamily } from "./commands/ads.js";
-import { registerAgentFamily } from "./commands/agent.js";
-import { registerApiKeysFamily } from "./commands/api-keys.js";
-import { registerApprovalsFamily } from "./commands/approvals.js";
-import { registerAuthFamily } from "./commands/auth.js";
-import { registerBillingFamily } from "./commands/billing.js";
-import { registerBlueprintsFamily } from "./commands/blueprints.js";
-import { registerBudgetFamily } from "./commands/budget.js";
-import { registerCallablesFamily } from "./commands/callables.js";
-import { registerCapabilitiesFamily } from "./commands/capabilities.js";
-import { registerCellsFamily } from "./commands/cells.js";
-import { registerColumnsFamily } from "./commands/columns.js";
-import { registerCommandsFamily } from "./commands/commands.js";
-import { registerCommentsFamily } from "./commands/comments.js";
-import { registerCompaniesFamily } from "./commands/companies.js";
-import { registerConnectionsFamily } from "./commands/connections.js";
-import { registerContextFamily } from "./commands/context.js";
-import { registerCopilotFamily } from "./commands/copilot.js";
-import { registerCrmFamily } from "./commands/crm.js";
-import { registerCustomIntegrationsFamily } from "./commands/custom-integrations.js";
-import { registerDashboardsFamily } from "./commands/dashboards.js";
-import { registerDbFamily } from "./commands/db.js";
-import { registerDeliverabilityFamily } from "./commands/deliverability.js";
-import { registerDirectoryFamily } from "./commands/directory.js";
-import { registerDomainsFamily } from "./commands/domains.js";
-import { registerEgressFamily } from "./commands/egress.js";
-import { registerEmailFamily } from "./commands/email.js";
-import { registerEngagementFamily } from "./commands/engagement.js";
-import { registerEnrichColumnFamily } from "./commands/enrich-column.js";
-import { registerEnrichmentFamily } from "./commands/enrichment.js";
-import { registerFeedbackFamily } from "./commands/feedback.js";
-import { registerFeedsFamily } from "./commands/feeds.js";
-import { registerFindFamily } from "./commands/find.js";
-import { registerFollowersFamily } from "./commands/followers.js";
-import { registerFormulasFamily } from "./commands/formulas.js";
-import { registerHomeFamily } from "./commands/home.js";
-import { registerInboxFamily } from "./commands/inbox.js";
-import { registerIntegrationsFamily } from "./commands/integrations.js";
-import { registerKnowledgeFamily } from "./commands/knowledge.js";
-import { registerLeadSourcingFamily } from "./commands/lead-sourcing.js";
-import { registerLimitsFamily } from "./commands/limits.js";
-import { registerLinkedinFamily } from "./commands/linkedin.js";
-import { registerLoginFamily } from "./commands/login.js";
-import { registerLogoutFamily } from "./commands/logout.js";
-import { registerMailboxesFamily } from "./commands/mailboxes.js";
-import { registerManagedInboxesFamily } from "./commands/managed-inboxes.js";
-import { registerMessagesFamily } from "./commands/messages.js";
-import { registerNotetakerFamily } from "./commands/notetaker.js";
-import { registerObservabilityFamily } from "./commands/observability.js";
-import { registerOrgsFamily } from "./commands/orgs.js";
-import { registerPeopleFamily } from "./commands/people.js";
-import { registerPostsFamily } from "./commands/posts.js";
-import { registerProfilesFamily } from "./commands/profiles.js";
-import { registerProjectsFamily } from "./commands/projects.js";
-import { registerPromptsFamily } from "./commands/prompts.js";
-import { registerPublishingFamily } from "./commands/publishing.js";
-import { registerRecipesFamily } from "./commands/recipes.js";
-import { registerReviewsFamily } from "./commands/reviews.js";
-import { registerRowsFamily } from "./commands/rows.js";
-import { registerRunsFamily } from "./commands/runs.js";
-import { registerSearchFamily } from "./commands/search.js";
-import { registerSendersFamily } from "./commands/senders.js";
-import { registerSequencesFamily } from "./commands/sequences.js";
-import { registerSessionFamily } from "./commands/session.js";
-import { registerSignalsFamily } from "./commands/signals.js";
-import { registerSignupLeadsFamily } from "./commands/signup-leads.js";
-import { registerSkillsFamily } from "./commands/skills.js";
-import { registerSourcingFamily } from "./commands/sourcing.js";
-import { registerStatusFamily } from "./commands/status.js";
-import { registerSupabaseFamily } from "./commands/supabase.js";
-import { registerSupportFamily } from "./commands/support.js";
-import { registerSuppressionsFamily } from "./commands/suppressions.js";
-import { registerTableIngestionsFamily } from "./commands/table-ingestions.js";
-import { registerTableRunsFamily } from "./commands/table-runs.js";
-import { registerTablesFamily } from "./commands/tables.js";
-import { registerTagsFamily } from "./commands/tags.js";
-import { registerToolsFamily } from "./commands/tools.js";
-import { registerUpdateFamily } from "./commands/update.js";
-import { registerVerifyFamily } from "./commands/verify.js";
-import { registerViewersFamily } from "./commands/viewers.js";
-import { registerVoiceFamily } from "./commands/voice.js";
-import { registerWhatsappFamily } from "./commands/whatsapp.js";
-import { registerWhoamiFamily } from "./commands/whoami.js";
-import { registerWorkerFamily } from "./commands/worker.js";
-import { registerWorkflowsFamily } from "./commands/workflows.js";
-import { registerWorkspaceFamily } from "./commands/workspace.js";
-import { registerConnectorsCommands } from "./connectors-commands.js";
-import { defaultApiUrl } from "./credentials.js";
-import { registerCrmFileReadCommands } from "./crm-file-read-commands.js";
-import { registerCrmSupportFlags } from "./crm-support-flags.js";
-import { registerCustomerOperationCommands } from "./customer-operation-commands.js";
+import { emitCliFailure, writeJson } from "./cli-output.js";
+import { createProgram } from "./command-families/program.js";
 import { beginCliDiagnostics, finishCliDiagnostics, setCliDiagnosticOperation, recordCliDiagnosticFailure } from "./diagnostics.js";
-import { registerFunctionsCommands } from "./functions-commands.js";
-import { applyOxygenHelp, argvRequestsJson, commanderUsageFailure, commandNameForArgv, enableCommandSuggestions, oxygenDocsUrl, unknownCommandHint, unknownOptionHint, requiredOptionHint, withoutHelpForUnknownCommand, validateRequiredOptionValues } from "./help.js";
-import { registerKnowledgeRepositoryCommands } from "./knowledge-repository-commands.js";
-import { resolveCliBinaryName } from "./runtime.js";
-import { registerSettingsCommands } from "./settings-commands.js";
-import { registerUgcCommands } from "./ugc-commands.js";
+import { argvRequestsJson, commanderUsageFailure, commandNameForArgv, unknownCommandHint, unknownOptionHint, requiredOptionHint, withoutHelpForUnknownCommand } from "./help.js";
 import { isRecord } from "./util.js";
-import { registerVisualCommands } from "./visual-commands.js";
-import { registerWorkspaceSkillCommands } from "./workspace-skill-commands.js";
 import { OxygenError } from "@oxygen/shared/cli-result";
-import { OXYGEN_VERSION } from "@oxygen/shared/version";
-import { Command, CommanderError } from "commander";
-export function createProgram() {
-    const program = new Command();
-    const binaryName = resolveCliBinaryName();
-    const directoryDocsUrl = oxygenDocsUrl(defaultApiUrl(), "/agencies");
-    const billingDocsUrl = oxygenDocsUrl(defaultApiUrl(), "/safety/billing");
-    program
-        .name(binaryName)
-        .description("The agentic GTM platform for B2B GTM teams: tables, enrichment, sequences, workflows, CRM, knowledge. Everything here also runs in the web app and over MCP; every state-changing action returns a web_url deep-link.")
-        .version(OXYGEN_VERSION)
-        .option("--pretty", "Indent JSON for human reading; omit for compact agent output.")
-        .option("--profile <name>", "Use a stored CLI profile for this command.")
-        .option("--org <organization>", "Use an organization id, Clerk org id, or slug for this command.");
-    program.hook("preAction", (_root, selected) => {
-        validateRequiredOptionValues(program, selected);
-        const options = program.opts();
-        if (options.profile) {
-            recordCliProfileFlag(options.profile);
-            process.env.OXYGEN_PROFILE = options.profile;
-        }
-        if (options.org) {
-            process.env.OXYGEN_ORG = options.org;
-        }
-    });
-    registerLoginFamily(program, handleAsyncAction);
-    registerAuthFamily(program, handleAsyncAction);
-    registerProfilesFamily(program, handleAsyncAction);
-    registerLogoutFamily(program, handleAsyncAction);
-    registerUpdateFamily(program, handleAsyncAction);
-    registerApiKeysFamily(program, handleAsyncAction);
-    registerWhoamiFamily(program, handleAsyncAction);
-    registerHomeFamily(program, handleAsyncAction);
-    registerWorkspaceFamily(program, handleAsyncAction);
-    registerActivationFamily(program, handleAsyncAction);
-    registerCommandsFamily(program, handleAsyncAction, binaryName);
-    registerCapabilitiesFamily(program, handleAsyncAction);
-    registerStatusFamily(program, handleAsyncAction);
-    registerOrgsFamily(program, handleAsyncAction);
-    registerSupportFamily(program, handleAsyncAction);
-    registerFeedbackFamily(program, handleAsyncAction);
-    registerDbFamily(program, handleAsyncAction);
-    registerProjectsFamily(program, handleAsyncAction);
-    registerNotetakerFamily(program, handleAsyncAction);
-    registerPublishingFamily(program, handleAsyncAction);
-    registerDashboardsFamily(program, handleAsyncAction);
-    registerCrmFamily(program, handleAsyncAction);
-    registerSignalsFamily(program, handleAsyncAction);
-    registerTablesFamily(program, handleAsyncAction, binaryName);
-    registerFeedsFamily(program, handleAsyncAction);
-    registerContextFamily(program, handleAsyncAction);
-    registerKnowledgeFamily(program, handleAsyncAction);
-    registerAdsFamily(program, handleAsyncAction);
-    registerTagsFamily(program, handleAsyncAction);
-    registerCommentsFamily(program, handleAsyncAction);
-    registerApprovalsFamily(program, handleAsyncAction);
-    registerBlueprintsFamily(program, handleAsyncAction);
-    registerRecipesFamily(program, handleAsyncAction);
-    registerPromptsFamily(program, handleAsyncAction);
-    registerReviewsFamily(program, handleAsyncAction);
-    registerColumnsFamily(program, handleAsyncAction);
-    registerActionColumnFamily(program, handleAsyncAction);
-    registerFormulasFamily(program, handleAsyncAction);
-    registerTableRunsFamily(program, handleAsyncAction);
-    registerTableIngestionsFamily(program, handleAsyncAction);
-    registerSourcingFamily(program, handleAsyncAction);
-    registerLeadSourcingFamily(program, handleAsyncAction);
-    registerSearchFamily(program, handleAsyncAction);
-    registerCompaniesFamily(program, handleAsyncAction);
-    registerPeopleFamily(program, handleAsyncAction);
-    registerWorkerFamily(program, handleAsyncAction);
-    registerLimitsFamily(program, handleAsyncAction, billingDocsUrl);
-    registerBillingFamily(program, handleAsyncAction, billingDocsUrl);
-    registerBudgetFamily(program, handleAsyncAction);
-    registerEgressFamily(program, handleAsyncAction);
-    registerDirectoryFamily(program, handleAsyncAction, directoryDocsUrl, billingDocsUrl);
-    registerAdminFamily(program, handleAsyncAction, binaryName);
-    registerSignupLeadsFamily(program, handleAsyncAction);
-    registerObservabilityFamily(program, handleAsyncAction);
-    registerAgentFamily(program, handleAsyncAction);
-    registerCopilotFamily(program, handleAsyncAction);
-    registerRunsFamily(program, handleAsyncAction);
-    registerRowsFamily(program, handleAsyncAction);
-    registerCellsFamily(program, handleAsyncAction);
-    registerSessionFamily(program, handleAsyncAction);
-    registerCustomIntegrationsFamily(program, handleAsyncAction);
-    registerToolsFamily(program, handleAsyncAction);
-    registerEnrichColumnFamily(program, handleAsyncAction);
-    registerFindFamily(program, handleAsyncAction);
-    registerVerifyFamily(program, handleAsyncAction);
-    registerEnrichmentFamily(program, handleAsyncAction);
-    registerSupabaseFamily(program, handleAsyncAction);
-    registerIntegrationsFamily(program, handleAsyncAction);
-    registerSendersFamily(program, handleAsyncAction);
-    registerConnectionsFamily(program, handleAsyncAction);
-    registerFollowersFamily(program, handleAsyncAction);
-    registerViewersFamily(program, handleAsyncAction);
-    registerPostsFamily(program, handleAsyncAction);
-    registerEngagementFamily(program, handleAsyncAction);
-    registerLinkedinFamily(program, handleAsyncAction);
-    registerWhatsappFamily(program, handleAsyncAction);
-    registerInboxFamily(program, handleAsyncAction);
-    registerMessagesFamily(program, handleAsyncAction);
-    registerSequencesFamily(program, handleAsyncAction);
-    registerVoiceFamily(program, handleAsyncAction);
-    registerSuppressionsFamily(program, handleAsyncAction);
-    registerEmailFamily(program, handleAsyncAction);
-    registerManagedInboxesFamily(program, handleAsyncAction);
-    registerMailboxesFamily(program, handleAsyncAction);
-    registerDeliverabilityFamily(program, handleAsyncAction);
-    registerDomainsFamily(program, handleAsyncAction);
-    registerCallablesFamily(program, handleAsyncAction);
-    registerWorkflowsFamily(program, handleAsyncAction);
-    registerSkillsFamily(program, handleAsyncAction);
-    registerVisualCommands(program, handleAsyncAction);
-    registerFunctionsCommands(program, handleAsyncAction);
-    registerUgcCommands(program, handleAsyncAction);
-    registerKnowledgeRepositoryCommands(program, handleAsyncAction);
-    registerAdminLeadMagnetCommands(program, handleAsyncAction);
-    registerConnectorsCommands(program, handleAsyncAction);
-    registerSettingsCommands(program, handleAsyncAction);
-    registerCrmSupportFlags(program);
-    registerWorkspaceSkillCommands(program, handleAsyncAction);
-    registerCustomerOperationCommands(program, handleAsyncAction);
-    registerCrmFileReadCommands(program, handleAsyncAction);
-    // After the register* helpers: help groups are assigned to the commands that
-    // exist when this runs, and a family registered later fell into commander's
-    // trailing default "Commands:" list (the 2026-09-30 blind agent read the first
-    // 80 lines of help and missed `connectors` there).
-    applyOxygenHelp(program, binaryName, oxygenDocsUrl(defaultApiUrl()));
-    // Last, so every command registered above is covered.
-    enableCommandSuggestions(program);
-    return program;
-}
+import { CommanderError } from "commander";
+export { createProgram } from "./command-families/program.js";
 // Piping CLI output into a consumer that exits early (`oxygen whoami --json |
 // head -c 20`) otherwise crashes with a raw EPIPE stack after the consumer
 // closes the pipe; a closed pipe is normal shell behavior, not an error.

package/dist/knowledge-mirror.js

@@ -16,7 +16,7 @@ import { createHash } from "node:crypto";
 import { chmodSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync, } from "node:fs";
 import { homedir } from "node:os";
 import { basename, dirname, join } from "node:path";
-import { OxygenError } from "@oxygen/shared";
+import { OxygenError } from "@oxygen/shared/cli-result";
 const MIRROR_SIDECAR_DIRNAME = ".oxygen";
 const MIRROR_MANIFEST_FILENAME = "manifest.json";
 const MIRROR_LOCK_FILENAME = "lock";

package/dist/skills.js

@@ -2,12 +2,14 @@ import { spawnSync } from "node:child_process";
 import { closeSync, existsSync, lstatSync, mkdirSync, mkdtempSync, openSync, readFileSync, readSync, readdirSync, readlinkSync, rmSync, unlinkSync, writeFileSync, } from "node:fs";
 import { homedir, tmpdir } from "node:os";
 import { dirname, join, posix, resolve } from "node:path";
-import { OxygenError, errorMessage, inferUserCapabilityRoute, serializeCapabilityRoute, toFailure, } from "@oxygen/shared";
+import { OxygenError, toFailure } from "@oxygen/shared/cli-result";
+import { errorMessage } from "@oxygen/shared/error-message";
+import { serializeCapabilityRoute } from "@oxygen/shared/capability-discovery";
+import { capabilityDiscoveryRecovery, inferUserCapabilityRoute } from "@oxygen/shared/user-capability-routing";
 import { defaultApiUrl, loadCredentials, normalizeApiUrl } from "./credentials.js";
 import { requestOxygen } from "./http-client.js";
 import { isRecord, readOption } from "./util.js";
 import { resolveCmdShimInvocation } from "./windows-shim.js";
-import { capabilityDiscoveryRecovery } from "@oxygen/shared/user-capability-routing";
 const DEFAULT_SKILL_AGENTS = ["codex", "claude-code", "cursor"];
 const SKILL_INDEX_PATH = "/.well-known/skills/index.json";
 const SKILLS_ACCESS_API_PATH = "/api/cli/skills/access";

package/dist/update.js

@@ -2,7 +2,8 @@ import { spawnSync } from "node:child_process";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
 import { fileURLToPath } from "node:url";
-import { OXYGEN_VERSION, OxygenError } from "@oxygen/shared";
+import { OxygenError } from "@oxygen/shared/cli-result";
+import { OXYGEN_VERSION } from "@oxygen/shared/version";
 import { runAutomaticSkillsInstall, skippedAutomaticSkillsInstall, } from "./skills.js";
 import { resolveCliBinaryName } from "./runtime.js";
 import { readOption } from "./util.js";

package/dist/workspace-placement-commands.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+import { type ExtractedCommandActionHandler } from "./command-support.js";
+export declare function registerWorkspacePlacementCommands(root: Command, handle: ExtractedCommandActionHandler): void;