@oxygen-agent/cli 1.1014.1341 → 1.1014.1420

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

@@ -424,6 +424,54 @@ export const SEQUENCE_CRM_IDENTITY_KINDS = [
  *   route connected → then_id, not → else_id (no waiting).
  */
 export const SEQUENCE_CONNECTION_BRANCH_CONDITIONS = ["connection_accepted", "already_connected", "open_profile"];
+/**
+ * A boolean expression a signal-branch routes on. Two leaf kinds, plus the
+ * all/any/not combinators:
+ * - a SIGNAL leaf `{ signal, present? }` tests whether an accumulated enrollment
+ *   signal is present (default) or absent (present:false).
+ * - a DATA leaf `{ has_column, present? }` tests whether the lead's source row
+ *   carries a non-empty value in the named row_values column — present (default)
+ *   or absent (present:false). This is the LinkedIn/Lemlist "does the lead have an
+ *   email / phone / … ?" branch: route by what data you HAVE about the lead,
+ *   evaluated synchronously against the enrollment's row_values (no signal, no
+ *   wait). A value counts as present when it is a non-empty trimmed string, or any
+ *   number / boolean; null / undefined / "" / whitespace count as absent.
+ *
+ * Lemlist condition-key → Oxygen mapping (13 keys), so a Lemlist journey ports
+ * across without a lossy translation table:
+ *   hasEmailAddress      → { has_column: "email" }   (or any SEQUENCE_EMAIL_COLUMN_KEYS key)
+ *   hasLinkedinUrl       → { has_column: "<linkedin url column>" }
+ *   hasPhoneNumber       → { has_column: "phone" }    (or any SEQUENCE_PHONE_COLUMN_KEYS key)
+ *   linkedinInviteAccepted → a CONNECTION branch (condition: "connection_accepted")
+ *   opened               → { signal: "email_opened" }
+ *   clicked              → { signal: "email_clicked" }
+ *   replied              → { signal: "email_replied" } (or linkedin_replied / whatsapp_replied)
+ *   meetingBooked        → { signal: "meeting_booked" }
+ *   emailsUnsubscribed   → { signal: "email_unsubscribed" }
+ *   aircallDone          → out of scope (no Aircall integration)
+ * Negate any leaf with present:false (e.g. "no email on file" = { has_column: "email", present: false }).
+ *
+ * A CONTACT leaf `{ has_contact: "email" | "linkedin" | "phone", present? }` asks
+ * whether the step that channel needs could reach the lead, resolved exactly as
+ * dispatch resolves it: email and phone through the sequence's mapped column with
+ * the built-in fallbacks, LinkedIn through the profile captured at enrollment. It
+ * is what "If has email / LinkedIn / phone" in the builder writes, so one campaign
+ * can route every lead instead of splitting the audience by data.
+ */
+export const SEQUENCE_CONTACT_CHANNELS = ["email", "linkedin", "phone"];
+/**
+ * Resolve a lead's reachable contacts the way dispatch does: the mapped email or
+ * phone column first, then the built-in keys, and LinkedIn from the profile the
+ * enrollment captured (a row value alone never makes a LinkedIn step sendable).
+ */
+export function sequenceLeadContacts(input) {
+    const phoneKey = input.settings?.phone_column_key ?? null;
+    return {
+        email: recipientEmailFromRow(input.rowValues, input.settings?.email_column_key ?? null) !== null,
+        linkedin: input.linkedin,
+        phone: callPhoneFromRow(input.rowValues, phoneKey) !== null || whatsAppAttendeeIdFromRow(input.rowValues, phoneKey) !== null,
+    };
+}
 const MAX_SEQUENCE_STEPS = 50;
 const MAX_TEMPLATE_LENGTH = 8_000;
 // The Premium ceiling, and only an authoring hint: the limit that actually
@@ -835,7 +883,7 @@ function collectConditionSignals(condition, out) {
     // it contributes nothing — and must be handled BEFORE the not-fallthrough below
     // (which would otherwise read condition.not off a data leaf). This is also why
     // the native-untracked engagement-gate walker never trips on a has_column branch.
-    else if ("has_column" in condition)
+    else if ("has_column" in condition || "has_contact" in condition)
         return;
     else if ("all" in condition)
         condition.all.forEach((c) => collectConditionSignals(c, out));
@@ -1810,6 +1858,13 @@ function normalizeCondition(raw, path, issues, depth = 0) {
             return undefined;
         return { has_column: key, present: raw.present === false ? false : true };
     }
+    if (raw.has_contact !== undefined) {
+        if (typeof raw.has_contact !== "string" || !SEQUENCE_CONTACT_CHANNELS.includes(raw.has_contact)) {
+            issues.push({ path: `${path}.has_contact`, message: `has_contact must be one of ${SEQUENCE_CONTACT_CHANNELS.join(", ")}.` });
+            return undefined;
+        }
+        return { has_contact: raw.has_contact, present: raw.present === false ? false : true };
+    }
     if (Array.isArray(raw.all)) {
         return { all: normalizeConditionList(raw.all, `${path}.all`, issues, depth) };
     }
@@ -1820,7 +1875,7 @@ function normalizeCondition(raw, path, issues, depth = 0) {
         const inner = normalizeCondition(raw.not, `${path}.not`, issues, depth + 1);
         return inner ? { not: inner } : undefined;
     }
-    issues.push({ path, message: "condition must be {signal}, {has_column}, {all}, {any}, or {not}." });
+    issues.push({ path, message: "condition must be {signal}, {has_column}, {has_contact}, {all}, {any}, or {not}." });
     return undefined;
 }
 function normalizeConditionList(raw, path, issues, depth) {
@@ -2103,9 +2158,10 @@ export function sequenceTemplateVariables(definition) {
  * `rowValues` is optional and backward-compatible: when omitted (undefined), a data
  * leaf ({ has_column }) evaluates as ABSENT — present:false matches, present:true
  * does not — so an existing signal-only caller is unaffected. Signal leaves ignore
- * rowValues entirely.
+ * rowValues entirely. A contact leaf ({ has_contact }) reads `contacts`; without
+ * it, the contact counts as absent.
  */
-export function evaluateSequenceCondition(condition, firedSignals, rowValues) {
+export function evaluateSequenceCondition(condition, firedSignals, rowValues, contacts) {
     const fired = firedSignals instanceof Set ? firedSignals : new Set(firedSignals);
     if ("signal" in condition) {
         const present = fired.has(condition.signal);
@@ -2115,11 +2171,15 @@ export function evaluateSequenceCondition(condition, firedSignals, rowValues) {
         const present = rowValueIsPresent(rowValues?.[condition.has_column]);
         return condition.present === false ? !present : present;
     }
+    if ("has_contact" in condition) {
+        const present = contacts?.[condition.has_contact] === true;
+        return condition.present === false ? !present : present;
+    }
     if ("all" in condition)
-        return condition.all.every((c) => evaluateSequenceCondition(c, fired, rowValues));
+        return condition.all.every((c) => evaluateSequenceCondition(c, fired, rowValues, contacts));
     if ("any" in condition)
-        return condition.any.some((c) => evaluateSequenceCondition(c, fired, rowValues));
-    return !evaluateSequenceCondition(condition.not, fired, rowValues);
+        return condition.any.some((c) => evaluateSequenceCondition(c, fired, rowValues, contacts));
+    return !evaluateSequenceCondition(condition.not, fired, rowValues, contacts);
 }
 /**
  * Whether a lead's row_values value counts as "present" for a data-leaf branch: a

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

@@ -29,6 +29,8 @@ export declare function teammatesAvailableTo(env: Record<string, string | undefi
 export declare const DEFAULT_TEAMMATE_SLUG = "workspace";
 /** What an Oxygent is called until someone names it, as Grok Bot's are (Tim, 2026-10-13). */
 export declare const NEW_TEAMMATE_NAME = "New Bot";
+/** What the first Oxygent is called until someone renames it (Philipp, 2026-10-19). */
+export declare const DEFAULT_TEAMMATE_NAME = "Oxygent";
 export declare const TEAMMATE_NAME_MAX_CHARS = 80;
 export declare const TEAMMATE_DESCRIPTION_MAX_CHARS = 500;
 /**
@@ -79,7 +81,7 @@ export declare function teammateDefaultLook(slug: string): {
 };
 /**
  * How an Oxygent presents: its name, what it does and its look. The first
- * Oxygent is "New Bot" until its owner names it; nothing renames the stored
+ * Oxygent is "Oxygent" until its owner names it; nothing renames the stored
  * Agent to get there, and the Workspace Agent's stock description is no job.
  */
 export declare function teammatePresentation(agent: {

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

@@ -30,6 +30,8 @@ export function teammatesAvailableTo(env, viewer) {
 export const DEFAULT_TEAMMATE_SLUG = "workspace";
 /** What an Oxygent is called until someone names it, as Grok Bot's are (Tim, 2026-10-13). */
 export const NEW_TEAMMATE_NAME = "New Bot";
+/** What the first Oxygent is called until someone renames it (Philipp, 2026-10-19). */
+export const DEFAULT_TEAMMATE_NAME = "Oxygent";
 const LEGACY_WORKSPACE_AGENT_NAME = "Workspace Agent";
 const LEGACY_WORKSPACE_AGENT_DESCRIPTION = "General organization-grounded workspace worker.";
 export const TEAMMATE_NAME_MAX_CHARS = 80;
@@ -103,12 +105,12 @@ export function teammateDefaultLook(slug) {
 }
 /**
  * How an Oxygent presents: its name, what it does and its look. The first
- * Oxygent is "New Bot" until its owner names it; nothing renames the stored
+ * Oxygent is "Oxygent" until its owner names it; nothing renames the stored
  * Agent to get there, and the Workspace Agent's stock description is no job.
  */
 export function teammatePresentation(agent) {
     const first = agent.slug === DEFAULT_TEAMMATE_SLUG;
-    const name = first && agent.name === LEGACY_WORKSPACE_AGENT_NAME ? NEW_TEAMMATE_NAME : agent.name;
+    const name = first && agent.name === LEGACY_WORKSPACE_AGENT_NAME ? DEFAULT_TEAMMATE_NAME : agent.name;
     const stored = agent.description?.trim() ?? "";
     const description = first && stored === LEGACY_WORKSPACE_AGENT_DESCRIPTION ? "" : stored;
     const look = teammateDefaultLook(agent.slug);

package/node_modules/@oxygen/shared/dist/user-capability-routing.js

@@ -14,6 +14,19 @@ export function capabilityDiscoveryRecovery(query, surface) {
 // connection routes.
 export function inferUserCapabilityRoute(query) {
     const normalized = query.toLowerCase().replace(/[_-]+/g, " ");
+    if (/\b(?:buy|purchase|order|provision|subscribe)\b/.test(normalized)
+        && /\b(?:inbox(?:es)?|mailbox(?:es)?)\b/.test(normalized)
+        && !/\b(?:buy|purchase|order)\s+(?:more\s+)?credits?\b|^\s*(?:cancel|delete|remove)\b/.test(normalized)) {
+        const route = getCapabilityRouteMatch("sending-infrastructure");
+        if (route) {
+            const recommendedTools = ["oxygen_managed_inboxes_subscribe", "oxygen_managed_inboxes_list", "oxygen_domains_list", "oxygen_managed_inboxes_add_mailboxes"];
+            const recommendedCommands = ["managed-inboxes subscribe", "managed-inboxes list", "domains list", "managed-inboxes add-inboxes"];
+            return { ...route, recommendedTools, recommendedCommands, card: { ...route.card,
+                    gatewayTools: recommendedTools, gatewayCommands: recommendedCommands,
+                    execution: "Inspect owned domains, existing subscriptions and occupied/pending addresses before quoting. An owned domain without a subscription uses managed-inboxes subscribe with existing_domain=true (CLI --existing-domain), with no registration charge; a managed subscription uses add-inboxes. Preserve the requested provider and total per-domain cap. Preview first; exact quote approval authorizes only its inboxes and recurring cost. Warmup is included only when warmup_activation.automatic_after_provisioning=true. Discovery buys nothing and grants no spend authority.",
+                } };
+        }
+    }
     if (/\breply oxygent\b/.test(normalized) || (/\brepl(?:y|ies)\b/.test(normalized) && /\bbatch(?:es)?\b/.test(normalized)
         && /\b(?:approv(?:al|e)|voice|writing style)\b/.test(normalized))) {
         const route = getCapabilityRouteMatch("messages");
@@ -26,22 +39,6 @@ export function inferUserCapabilityRoute(query) {
                 } };
         }
     }
-    const journeyAction = savedOnboardingJourneyAction(normalized);
-    if (journeyAction) {
-        const route = getCapabilityRouteMatch("agents");
-        if (route) {
-            const recommendedTools = [`oxygen_onboarding_journey_${journeyAction}`, ...(journeyAction === "get" ? [] : ["oxygen_onboarding_journey_get"])];
-            const recommendedCommands = [`onboarding journey ${journeyAction}`, ...(journeyAction === "get" ? [] : ["onboarding journey get"])];
-            return { ...route, recommendedTools, recommendedCommands, card: { ...route.card,
-                    owns: "Creator-private saved guided onboarding answers, current step and pause/resume position.",
-                    notFor: "Human workspace invitations or permissions, destructive workspace reset, paid Oxygent Start or routine execution.",
-                    gatewayTools: recommendedTools, gatewayCommands: recommendedCommands,
-                    posture: journeyAction === "get" ? "read_only" : "workspace_write",
-                    execution: journeyAction === "get" ? "Read saved onboarding and its current native step. This read starts no research, model, billing reconciliation or message send."
-                        : "Read activationId and current revision first, then hydrate the selected native operation. Use a stable mutation_id; Back and non-destructive restart preserve resources and funding. Company answers prepare native sources and existing bounded research consent. Discovery executes nothing and supplies no approval or billing authority.",
-                } };
-        }
-    }
     // Exact native session activation must outrank the generic Agent gateways.
     // Discovery supplies no approval, preview token or invented session binding.
     if (/\bagent session activate\b/.test(normalized)
@@ -108,13 +105,13 @@ export function inferUserCapabilityRoute(query) {
     if (isGuidedOnboardingDiscoveryIntent(normalized)) {
         const route = getCapabilityRouteMatch("onboarding-and-copilot");
         if (route) {
-            const recommendedTools = ["oxygen_onboarding_activation_status", "oxygen_onboarding_journey_get"];
-            const recommendedCommands = ["onboarding activation status", "onboarding journey get"];
+            const recommendedTools = ["oxygen_onboarding_activation_status"];
+            const recommendedCommands = ["onboarding activation status"];
             return { ...route, recommendedTools, recommendedCommands, card: { ...route.card,
-                    owns: "Creator-owned DEV guided onboarding answers, native resources, current step and saved navigation.",
+                    owns: "Creator-owned DEV guided onboarding activation and its native resources.",
                     notFor: "Production onboarding execution, human membership or ordinary GTM consulting.",
                     posture: "read_only", gatewayTools: recommendedTools, gatewayCommands: recommendedCommands,
-                    execution: "DEV-only two-part guided onboarding; unavailable in production, shadow, local or production-data workspaces. Read your activation first, then use its activationId to read the saved journey and revision. If absent, inspect the free activation-start schema and choose own_agent or oxygent. Resume the native step; answers, prospects, TEST billing, campaigns and routines retain their own schemas, eligibility and approvals. These reads start no research, checkout, model, schedule or send. Ordinary GTM consulting remains with Recipes/Copilot.",
+                    execution: "DEV-only guided onboarding runs in the workspace Oxygent chat; unavailable in production, shadow, local or production-data workspaces. Read your activation first; its activationId binds native resources and routines. If absent, inspect the free activation-start schema and choose own_agent or oxygent. The Oxygent researches the company and proposes plays; campaigns and routines keep their own previews and approvals. This read starts no research, model, schedule or send. Ordinary GTM consulting remains with Recipes/Copilot.",
                 }, exactCommand: "oxygen onboarding activation status --json",
                 exactMcpCall: { tool: "oxygen_onboarding_activation_status", arguments: {} } };
         }
@@ -217,26 +214,8 @@ export function inferUserCapabilityRoute(query) {
     // intent is exactly what this wrapper exists to answer.
     return getCapabilityRouteMatch("connected-integrations") ?? route;
 }
-/** Saved progress is distinct from general signup research, attended Start,
- * routine schedules and human membership. Pause wins over a simultaneous resume. */
-function savedOnboardingJourneyAction(query) {
-    if (!/\bonboarding\b/.test(query) || !/\b(?:journey|guided|answers?|steps?|tour)\b/.test(query)
-        || /\b(?:invite|members?|membership|permissions?|roles?|human|colleague|coworker|delete|destroy|wipe)\b/.test(query))
-        return null;
-    if (/\b(?:pause|paused|navigation)\b/.test(query) || (/\btour\b/.test(query) && /\bresume\b/.test(query)))
-        return "navigation";
-    if (/\brestart\b/.test(query))
-        return "restart";
-    if (/\bback\b/.test(query))
-        return "back";
-    if (/\bsave\b/.test(query))
-        return "save";
-    if (/\b(?:resume|read|get)\b/.test(query))
-        return "get";
-    return null;
-}
-/** A saved action is handled first. This is discovery of the multi-step
- * product journey, not generic advice about improving a GTM operation. */
+/** Discovery of the guided DEV onboarding activation, not generic advice
+ * about improving a GTM operation. */
 function isGuidedOnboardingDiscoveryIntent(query) {
     if (!/\bonboarding\b/.test(query)
         || /\b(?:invite|members?|membership|permissions?|roles?|human|colleague|coworker|delete|destroy|wipe|paid)\b/.test(query))

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

@@ -1 +1 @@
-export declare const OXYGEN_BUILD_VERSION = "1.1014.1341";
+export declare const OXYGEN_BUILD_VERSION = "1.1014.1420";

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

@@ -1,2 +1,2 @@
 // GENERATED by scripts/ci/version-stamp.mjs from VERSION + git history. Do not edit; do not commit.
-export const OXYGEN_BUILD_VERSION = "1.1014.1341";
+export const OXYGEN_BUILD_VERSION = "1.1014.1420";

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

@@ -1,5 +1,6 @@
 import { createHash } from "node:crypto";
 import { CliHttpError } from "./cli-http-error.js";
+import { placementCopyIssue } from "./placement-copy.js";
 const UUID = /^[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}$/i;
 export function workspacePlacementId(value) { return typeof value === "string" && UUID.test(value); }
 function invalid(message) { throw new CliHttpError(400, "workspace_test_invalid", message); }
@@ -21,6 +22,9 @@ export function readWorkspacePlacementVariants(value) {
             invalid("body_html must contain between one and 200,000 characters when supplied.");
         if (/\{\{[^}]+\}\}/.test(v.subject + v.body_text + (v.body_html ?? "")))
             invalid("Resolve personalization variables before testing the exact copy.");
+        const copyIssue = placementCopyIssue(v.subject, v.body_text, v.body_html);
+        if (copyIssue)
+            invalid(copyIssue);
         keys.add(v.key);
         return { key: v.key, subject: v.subject, body_text: v.body_text, ...(typeof v.body_html === "string" ? { body_html: v.body_html } : {}) };
     });

package/package.json

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

package/node_modules/@oxygen/shared/dist/contracts/guided-company-files.d.ts

@@ -1,30 +0,0 @@
-import { type ContractIssue } from "./schema.js";
-import type { OperationSpec } from "./operations.js";
-export declare const GUIDED_COMPANY_FILE_UPLOAD_CONTRACT: import("./schema.js").ContractObject<{
-    readonly revision: {
-        type: "integer";
-        description?: string;
-        minimum?: number;
-        maximum?: number;
-        "x-clamp"?: true;
-    };
-    readonly upload_id: import("./schema.js").StringProperty;
-    readonly sha256: import("./schema.js").StringProperty;
-    readonly size_bytes: {
-        type: "integer";
-        description?: string;
-        minimum?: number;
-        maximum?: number;
-        "x-clamp"?: true;
-    };
-    readonly file_name: import("./schema.js").StringProperty;
-    readonly content_type: {
-        type: "string";
-        enum: readonly ("application/pdf" | "text/markdown" | "text/plain")[];
-        description?: string;
-    };
-    readonly content_base64: import("./schema.js").StringProperty;
-}, "content_base64" | "content_type" | "file_name" | "revision" | "sha256" | "size_bytes" | "upload_id">;
-/** Raw wire values are never trimmed or renamed; the native owner verifies original SHA/bytes. */
-export declare function guidedCompanyFileUploadInputIssues(args: Readonly<Record<string, unknown>>): readonly ContractIssue[];
-export declare const GUIDED_COMPANY_FILE_UPLOAD_OPERATION: OperationSpec;

package/node_modules/@oxygen/shared/dist/contracts/guided-company-files.js

@@ -1,53 +0,0 @@
-import { GUIDED_COMPANY_FILE_CONTENT_TYPES, GUIDED_COMPANY_FILE_LIMITS, guidedCompanyFileByteLimit } from "../guided-company-files.js";
-import { enumOf, int, obj, str } from "./schema.js";
-const uuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/iu;
-export const GUIDED_COMPANY_FILE_UPLOAD_CONTRACT = obj({
-    revision: int({ minimum: 1 }), upload_id: str({ pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$" }),
-    sha256: str({ pattern: "^[0-9a-f]{64}$" }), size_bytes: int({ minimum: 1, maximum: GUIDED_COMPANY_FILE_LIMITS.pdfBytes }),
-    file_name: str({ minLength: 1, maxLength: GUIDED_COMPANY_FILE_LIMITS.nameBytes }),
-    content_type: enumOf(GUIDED_COMPANY_FILE_CONTENT_TYPES),
-    content_base64: str({ minLength: 4, maxLength: 4 * Math.ceil(GUIDED_COMPANY_FILE_LIMITS.pdfBytes / 3) }),
-}, { required: ["revision", "upload_id", "sha256", "size_bytes", "file_name", "content_type", "content_base64"] });
-/** Raw wire values are never trimmed or renamed; the native owner verifies original SHA/bytes. */
-export function guidedCompanyFileUploadInputIssues(args) {
-    const issues = [];
-    const issue = (path, message) => issues.push({ path, message });
-    for (const key of ["activationId", "upload_id"])
-        if (typeof args[key] !== "string" || !uuid.test(args[key]))
-            issue(key, "Use a native UUID.");
-    const name = args.file_name;
-    if (typeof name !== "string" || !name.trim() || /[\\/\u0000-\u001f\u007f]/u.test(name) || new TextEncoder().encode(name).length > GUIDED_COMPANY_FILE_LIMITS.nameBytes)
-        issue("file_name", "Use a filename without paths or controls, at most 255 UTF-8 bytes.");
-    const type = args.content_type;
-    if (!GUIDED_COMPANY_FILE_CONTENT_TYPES.includes(type))
-        issue("content_type", "Use UTF-8 text, Markdown or PDF.");
-    else if (typeof args.size_bytes !== "number" || args.size_bytes > guidedCompanyFileByteLimit(type))
-        issue("size_bytes", "Use at most 1500000 text bytes or 5242880 PDF bytes.");
-    const encoded = args.content_base64;
-    if (typeof encoded !== "string" || !encoded || encoded.length % 4 !== 0 || /[^A-Za-z0-9+/=]/u.test(encoded) || !/^[^=]*={0,2}$/u.test(encoded))
-        issue("content_base64", "Use canonical non-empty base64 file bytes.");
-    else {
-        try {
-            const decoded = atob(encoded);
-            if (btoa(decoded) !== encoded)
-                issue("content_base64", "Use canonical base64 without altered padding bits.");
-            if (decoded.length !== args.size_bytes)
-                issue("size_bytes", "size_bytes must equal the original decoded byte length.");
-        }
-        catch {
-            issue("content_base64", "Use valid base64 file bytes.");
-        }
-    }
-    return issues;
-}
-export const GUIDED_COMPANY_FILE_UPLOAD_OPERATION = {
-    id: "onboarding.company_files.upload", route: "/api/cli/onboarding/activation/{activationId}/company-files", method: "POST",
-    parameters: ["activationId"], contract: GUIDED_COMPANY_FILE_UPLOAD_CONTRACT, inputCheck: guidedCompanyFileUploadInputIssues,
-    multipart: { contentField: "content_base64", nameField: "file_name", typeField: "content_type", fileField: "file",
-        fileMetadata: { sha256Field: "sha256", sizeBytesField: "size_bytes" } },
-    cli: { path: ["onboarding", "company-files", "upload"], summary: "Upload an optional company source file for your private DEV onboarding activation." },
-    mcp: { name: "oxygen_onboarding_company_files_upload", title: "Oxygen: Upload onboarding company file", pack: "agents",
-        description: "Current creator and revision only, genuine enabled DEV: upload UTF-8 text/Markdown up to 1500000 bytes or PDF up to 5242880 bytes. Supply original filename, MIME, size and SHA-256 plus stable upload_id UUID; exact retries reuse the native file. PDF retains original bytes with text unavailable. No account connection, parser, model or message send.",
-        annotations: { destructiveHint: false, openWorldHint: true, idempotentHint: true } },
-    mutates: true, spends: false,
-};

package/node_modules/@oxygen/shared/dist/contracts/guided-first-sourcing.d.ts

@@ -1,120 +0,0 @@
-import { type ContractIssue } from "./schema.js";
-import type { OperationSpec } from "./operations.js";
-/** Matches the actual native people-search and page safety ceilings. */
-export declare const GUIDED_FIRST_SOURCING_LIMITS: {
-    readonly targetCount: 50000;
-    readonly maxPages: 1000;
-};
-export declare const GUIDED_FIRST_SOURCING_BOUNDS_CONTRACT: import("./schema.js").ContractObject<{
-    readonly targetCount: {
-        type: "integer";
-        description?: string;
-        minimum?: number;
-        maximum?: number;
-        "x-clamp"?: true;
-    };
-    readonly maxPages: {
-        type: "integer";
-        description?: string;
-        minimum?: number;
-        maximum?: number;
-        "x-clamp"?: true;
-    };
-    readonly maxCredits: {
-        readonly type: "number";
-        readonly description?: string;
-        readonly minimum?: number;
-        readonly maximum?: number;
-        readonly "x-clamp"?: true;
-        readonly exclusiveMinimum: 0;
-    };
-}, "maxCredits" | "maxPages" | "targetCount">;
-export declare const GUIDED_FIRST_SOURCING_PREVIEW_CONTRACT: import("./schema.js").ContractObject<{
-    revision: {
-        type: "integer";
-        description?: string;
-        minimum?: number;
-        maximum?: number;
-        "x-clamp"?: true;
-    };
-    bounds: import("./schema.js").ContractObject<{
-        readonly targetCount: {
-            type: "integer";
-            description?: string;
-            minimum?: number;
-            maximum?: number;
-            "x-clamp"?: true;
-        };
-        readonly maxPages: {
-            type: "integer";
-            description?: string;
-            minimum?: number;
-            maximum?: number;
-            "x-clamp"?: true;
-        };
-        readonly maxCredits: {
-            readonly type: "number";
-            readonly description?: string;
-            readonly minimum?: number;
-            readonly maximum?: number;
-            readonly "x-clamp"?: true;
-            readonly exclusiveMinimum: 0;
-        };
-    }, "maxCredits" | "maxPages" | "targetCount">;
-}, "bounds" | "revision">;
-export declare const GUIDED_FIRST_SOURCING_RUN_CONTRACT: import("./schema.js").ContractObject<{
-    readonly revision: {
-        type: "integer";
-        description?: string;
-        minimum?: number;
-        maximum?: number;
-        "x-clamp"?: true;
-    };
-    readonly bounds: import("./schema.js").ContractObject<{
-        readonly targetCount: {
-            type: "integer";
-            description?: string;
-            minimum?: number;
-            maximum?: number;
-            "x-clamp"?: true;
-        };
-        readonly maxPages: {
-            type: "integer";
-            description?: string;
-            minimum?: number;
-            maximum?: number;
-            "x-clamp"?: true;
-        };
-        readonly maxCredits: {
-            readonly type: "number";
-            readonly description?: string;
-            readonly minimum?: number;
-            readonly maximum?: number;
-            readonly "x-clamp"?: true;
-            readonly exclusiveMinimum: 0;
-        };
-    }, "maxCredits" | "maxPages" | "targetCount">;
-    readonly previewId: import("./schema.js").StringProperty;
-    readonly previewDigest: import("./schema.js").StringProperty;
-    readonly approved: import("./schema.js").BooleanProperty;
-}, "approved" | "bounds" | "previewDigest" | "previewId" | "revision">;
-export declare const GUIDED_FIRST_SOURCING_GET_CONTRACT: import("./schema.js").ContractObject<{
-    readonly revision: {
-        type: "integer";
-        description?: string;
-        minimum?: number;
-        maximum?: number;
-        "x-clamp"?: true;
-    };
-    readonly generation: {
-        type: "integer";
-        description?: string;
-        minimum?: number;
-        maximum?: number;
-        "x-clamp"?: true;
-    };
-    readonly timezoneHint: import("./schema.js").StringProperty;
-}, never>;
-export declare function guidedFirstSourcingGetInputIssues(args: Readonly<Record<string, unknown>>): readonly ContractIssue[];
-export type GuidedFirstSourcingAction = "get" | "preview" | "run";
-export declare const GUIDED_FIRST_SOURCING_OPERATIONS: readonly OperationSpec[];

package/node_modules/@oxygen/shared/dist/contracts/guided-first-sourcing.js

@@ -1,48 +0,0 @@
-import { bool, int, num, obj, str } from "./schema.js";
-import { isValidTimeZone } from "../zoned-time.js";
-/** Matches the actual native people-search and page safety ceilings. */
-export const GUIDED_FIRST_SOURCING_LIMITS = { targetCount: 50000, maxPages: 1000 };
-export const GUIDED_FIRST_SOURCING_BOUNDS_CONTRACT = obj({
-    targetCount: int({ minimum: 1, maximum: GUIDED_FIRST_SOURCING_LIMITS.targetCount }),
-    maxPages: int({ minimum: 1, maximum: GUIDED_FIRST_SOURCING_LIMITS.maxPages }),
-    maxCredits: { ...num(), exclusiveMinimum: 0 },
-}, { required: ["targetCount", "maxPages", "maxCredits"] });
-const request = { revision: int({ minimum: 1 }), bounds: GUIDED_FIRST_SOURCING_BOUNDS_CONTRACT };
-export const GUIDED_FIRST_SOURCING_PREVIEW_CONTRACT = obj(request, { required: ["revision", "bounds"] });
-export const GUIDED_FIRST_SOURCING_RUN_CONTRACT = obj({ ...request,
-    previewId: str({ minLength: 36, maxLength: 36, pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$" }),
-    previewDigest: str({ minLength: 64, maxLength: 64, pattern: "^[a-f0-9]{64}$" }), approved: bool(),
-}, { required: ["revision", "bounds", "previewId", "previewDigest", "approved"] });
-export const GUIDED_FIRST_SOURCING_GET_CONTRACT = obj({
-    revision: int({ minimum: 1, maximum: Number.MAX_SAFE_INTEGER }),
-    generation: int({ minimum: 1, maximum: Number.MAX_SAFE_INTEGER }),
-    timezoneHint: str({ minLength: 1, maxLength: 80, description: "Provisional saved/browser IANA hint for current nightly defaults; never confirms a schedule." }),
-});
-export function guidedFirstSourcingGetInputIssues(args) {
-    const fields = ["revision", "generation", "timezoneHint"];
-    if (!fields.some(field => args[field] !== undefined))
-        return [];
-    const issues = fields.filter(field => args[field] === undefined).map(path => ({ path,
-        message: "Supply revision, generation and timezoneHint together to read current routine defaults." }));
-    if (typeof args.timezoneHint !== "string" || args.timezoneHint !== args.timezoneHint.trim() || !isValidTimeZone(args.timezoneHint)) {
-        issues.push({ path: "timezoneHint", message: "Use a valid customer/browser IANA timezone suggestion; no schedule is confirmed." });
-    }
-    return issues;
-}
-const base = "/api/cli/onboarding/activation/{activationId}/first-sourcing";
-export const GUIDED_FIRST_SOURCING_OPERATIONS = [
-    { id: "onboarding.first_sourcing.get", route: base, method: "GET", contract: GUIDED_FIRST_SOURCING_GET_CONTRACT, inputCheck: guidedFirstSourcingGetInputIssues, parameters: ["activationId"],
-        cli: { path: ["onboarding", "first-sourcing", "get"], summary: "Read first sourcing; optionally quote current nightly defaults with revision, generation and timezoneHint." },
-        mcp: { name: "oxygen_onboarding_first_sourcing_get", title: "Oxygen: Read first sourcing", pack: "agents",
-            description: "Read the current creator-private DEV source, native ingestion receipt and actual settled continuation. No sourcing provider call or new sourcing; historical approval cannot authorize another pull. Verifies native billing and may reconcile an earned grant. Optional revision, generation and provisional IANA timezoneHint together return current native nightly defaults after the source transaction; no draft, schedule confirmation or approval.", annotations: { openWorldHint: true } }, mutates: true, spends: false },
-    { id: "onboarding.first_sourcing.preview", route: `${base}/preview`, method: "POST", parameters: ["activationId"], contract: GUIDED_FIRST_SOURCING_PREVIEW_CONTRACT,
-        cli: { path: ["onboarding", "first-sourcing", "preview"], summary: "Review a bounded native first pull into First leads; no provider search." },
-        mcp: { name: "oxygen_onboarding_first_sourcing_preview", title: "Oxygen: Preview first sourcing", pack: "agents",
-            description: "Current creator and revision, confirmed company, saved audience and eligible trial/paid billing required. Bounds contain targetCount, maxPages and maxCredits. Creates/reuses the native First leads Table and persists a managed source quote. Returns previewId/digest; no provider search, model or outreach.",
-            annotations: { openWorldHint: true, destructiveHint: false } }, mutates: true, spends: false },
-    { id: "onboarding.first_sourcing.run", route: `${base}/run`, method: "POST", parameters: ["activationId"], contract: GUIDED_FIRST_SOURCING_RUN_CONTRACT,
-        cli: { path: ["onboarding", "first-sourcing", "run"], summary: "Approve the exact stored preview and caps; enqueue or recover the same native first-source run." },
-        mcp: { name: "oxygen_onboarding_first_sourcing_run", title: "Oxygen: Run first sourcing", pack: "agents",
-            description: "approved=true plus stored previewId/previewDigest, current revision and identical bounds authorize the reviewed managed people source into the activation's First leads Table. Current native admission, billing, quote and worker fences apply. Retry/Back/Restart with the same actual source recovers its native run. No model, enrollment or outreach.",
-            annotations: { openWorldHint: true, destructiveHint: false, idempotentHint: true } }, mutates: true, spends: true },
-];