@oxygen-agent/cli 1.1014.1035 → 1.1014.1087

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

@@ -39,8 +39,8 @@ export const GUIDED_ACTIVATION_OPERATIONS = [
         cli: { path: ["onboarding", "activation", "status"], summary: "Resume your guided onboarding and native resource links. Enabled genuine dev only; current non-client workspace members." },
         mcp: { name: "oxygen_onboarding_activation_status", title: "Oxygen: Onboarding status", description: "Read your resumable guided onboarding and native links. Enabled genuine dev only; current non-client workspace members.", pack: "agents" }, mutates: false, spends: false },
     { id: "onboarding.activation.start", route: "/api/cli/onboarding/activation", method: "POST", contract: GUIDED_ACTIVATION_START_CONTRACT,
-        cli: { path: ["onboarding", "activation", "start"], summary: "Prepare your activation and private Oxygent chat. Free; no message send or outreach." },
-        mcp: { name: "oxygen_onboarding_activation_start", title: "Oxygen: Start onboarding record", description: "Prepare your activation with operating_path own_agent or oxygent. The oxygent path binds its native workspace Agent and creator-private chat. Free; no turn, inference, provider or outreach dispatch. Enabled genuine dev only; current non-client workspace members.", pack: "agents" }, mutates: true, spends: false },
+        cli: { path: ["onboarding", "activation", "start"], summary: "Prepare your creator-only activation and Oxygent chat: Workspace shared, Personal creator-only. Free; no send or outreach." },
+        mcp: { name: "oxygen_onboarding_activation_start", title: "Oxygen: Start onboarding record", description: "Prepare your creator-only activation with operating_path own_agent or oxygent. Oxygent binds its native Agent/chat: Workspace shared, Personal creator-only. Free; no turn, inference, provider or outreach dispatch. Enabled genuine dev only; current non-client workspace members.", pack: "agents" }, mutates: true, spends: false },
     { id: "onboarding.activation.get", route: "/api/cli/onboarding/activation/{activationId}", method: "GET", parameters: ["activationId"], contract: obj({}),
         cli: { path: ["onboarding", "activation", "get"], summary: "Read your activation by ID and its native resource links." },
         mcp: { name: "oxygen_onboarding_activation_get", title: "Oxygen: Read onboarding record", description: "Read your activation by activationId. Only its creator can read it. Enabled genuine dev only; current non-client workspace members.", pack: "agents" }, mutates: false, spends: false },
@@ -51,9 +51,9 @@ export const GUIDED_ACTIVATION_OPERATIONS = [
         cli: { path: ["onboarding", "activation", "first-leads"], summary: "Create or resume the activation-owned First leads Table. Free; no discovery, enrichment or outreach." },
         mcp: { name: "oxygen_onboarding_activation_first_leads", title: "Oxygen: First leads Table", description: "Create or resume one native First leads Table for your activationId. Free; no discovery, enrichment, enrollment or outreach. Use native search/ingestion separately.", pack: "agents" }, mutates: true, spends: false },
     { id: "onboarding.activation.routines_preview", route: "/api/cli/onboarding/activation/{activationId}/routines/preview", method: "POST", parameters: ["activationId"], contract: GUIDED_ACTIVATION_ROUTINES_PREVIEW_CONTRACT,
-        cli: { path: ["onboarding", "activation", "routines-preview"], summary: "Review two explicitly configured draft routines, exact native source scope and caps. Arms no schedule." },
-        mcp: { name: "oxygen_onboarding_activation_routines_preview", title: "Oxygen: Review daily routines", description: "Build native scan/briefing drafts and exact previews for activationId. Requires confirmed IANA timezone, both local times, source_ids and caps. Native Table sources quote zero; original ingestion sources need a current quote. Arms no schedule.", pack: "agents" }, mutates: true, spends: false },
+        cli: { path: ["onboarding", "activation", "routines-preview"], summary: "Save two routine draft configurations; review exact native source scope and caps. Arms no schedule." },
+        mcp: { name: "oxygen_onboarding_activation_routines_preview", title: "Oxygen: Review daily routines", description: "Save scan/briefing draft configuration and exact previews for activationId. Requires confirmed IANA timezone, both local times, source_ids and caps. Native Table sources quote zero; original ingestion sources need a current quote. Arms no schedule.", pack: "agents" }, mutates: true, spends: false },
     { id: "onboarding.activation.routine_activate", route: "/api/cli/onboarding/activation/{activationId}/routines/activate", method: "POST", parameters: ["activationId"], contract: GUIDED_ACTIVATION_ROUTINE_ACTIVATE_CONTRACT,
         cli: { path: ["onboarding", "activation", "routine-activate"], summary: "Activate one exact routine preview at its native revision. Requires approval or valid current creator-chat auto-approve authority." },
-        mcp: { name: "oxygen_onboarding_activation_routine_activate", title: "Oxygen: Activate daily routine", description: "Activate one lead_scan or morning_briefing at exact native revision and preview_token. Requires approved=true or current auto-approve authority in the creator's bound private chat. Schedules are independent and remain capped; no automatic enrollment.", pack: "agents" }, mutates: true, spends: true },
+        mcp: { name: "oxygen_onboarding_activation_routine_activate", title: "Oxygen: Activate daily routine", description: "Activate lead_scan or morning_briefing at exact revision/preview_token. Requires approved=true or current creator auto-approve authority in the bound chat. Workspace shared; Personal creator-only. Separate capped schedules; no automatic enrollment.", pack: "agents" }, mutates: true, spends: true },
 ];

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

@@ -0,0 +1,30 @@
+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

@@ -0,0 +1,53 @@
+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

@@ -0,0 +1,120 @@
+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

@@ -0,0 +1,48 @@
+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 },
+];

package/node_modules/@oxygen/shared/dist/contracts/guided-onboarding-journey.d.ts

@@ -0,0 +1,267 @@
+/** Hiring roles remain strings. Technology identity includes its relationship. */
+export declare const GUIDED_ONBOARDING_SIGNALS_CONTRACT: import("./schema.js").ContractObject<{
+    readonly hiring: import("./schema.js").ContractObject<{
+        readonly mode: {
+            type: "string";
+            enum: readonly ("none" | "selected")[];
+            description?: string;
+        };
+        readonly values: import("./schema.js").ArrayProperty<import("./schema.js").StringProperty>;
+    }, "mode" | "values">;
+    readonly technology: import("./schema.js").ContractObject<{
+        readonly mode: {
+            type: "string";
+            enum: readonly ("none" | "selected")[];
+            description?: string;
+        };
+        readonly values: import("./schema.js").ArrayProperty<import("./schema.js").ContractObject<{
+            readonly name: import("./schema.js").StringProperty;
+            readonly relationship: {
+                type: "string";
+                enum: readonly ("integrates_with" | "replaces" | "uses")[];
+                description?: string;
+            };
+        }, "name" | "relationship">>;
+    }, "mode" | "values">;
+}, "hiring" | "technology">;
+export declare const GUIDED_ONBOARDING_ANSWERS_CONTRACT: import("./schema.js").ContractObject<{
+    readonly company_context: import("./schema.js").ContractObject<{
+        readonly website: {
+            oneOf: [import("./schema.js").StringProperty, import("./schema.js").NullProperty];
+            description?: string;
+        };
+        readonly name: import("./schema.js").StringProperty;
+        readonly description: import("./schema.js").StringProperty;
+        readonly context_links: import("./schema.js").ArrayProperty<import("./schema.js").StringProperty>;
+        readonly file_ids: import("./schema.js").ArrayProperty<import("./schema.js").StringProperty>;
+    }, "context_links" | "description" | "file_ids" | "name" | "website">;
+    readonly company_review: import("./schema.js").ContractObject<{
+        readonly statement: import("./schema.js").StringProperty;
+        readonly profile_revision: import("./schema.js").StringProperty;
+    }, "profile_revision" | "statement">;
+    readonly audience_company_size: import("./schema.js").ContractObject<{
+        readonly values: import("./schema.js").ArrayProperty<import("./schema.js").StringProperty>;
+    }, "values">;
+    readonly audience_markets: import("./schema.js").ContractObject<{
+        readonly values: import("./schema.js").ArrayProperty<import("./schema.js").StringProperty>;
+    }, "values">;
+    readonly audience_industries: import("./schema.js").ContractObject<{
+        readonly values: import("./schema.js").ArrayProperty<import("./schema.js").StringProperty>;
+    }, "values">;
+    readonly audience_personas: import("./schema.js").ContractObject<{
+        readonly values: import("./schema.js").ArrayProperty<import("./schema.js").StringProperty>;
+    }, "values">;
+    readonly signals: import("./schema.js").ContractObject<{
+        readonly hiring: import("./schema.js").ContractObject<{
+            readonly mode: {
+                type: "string";
+                enum: readonly ("none" | "selected")[];
+                description?: string;
+            };
+            readonly values: import("./schema.js").ArrayProperty<import("./schema.js").StringProperty>;
+        }, "mode" | "values">;
+        readonly technology: import("./schema.js").ContractObject<{
+            readonly mode: {
+                type: "string";
+                enum: readonly ("none" | "selected")[];
+                description?: string;
+            };
+            readonly values: import("./schema.js").ArrayProperty<import("./schema.js").ContractObject<{
+                readonly name: import("./schema.js").StringProperty;
+                readonly relationship: {
+                    type: "string";
+                    enum: readonly ("integrates_with" | "replaces" | "uses")[];
+                    description?: string;
+                };
+            }, "name" | "relationship">>;
+        }, "mode" | "values">;
+    }, "hiring" | "technology">;
+    readonly prospects: import("./schema.js").ContractObject<{
+        readonly decision: {
+            type: "string";
+            enum: readonly ("continue" | "refine")[];
+            description?: string;
+        };
+        readonly feedback: import("./schema.js").StringProperty;
+    }, "decision" | "feedback">;
+    readonly linkedin: import("./schema.js").ContractObject<{
+        readonly choice: {
+            type: "string";
+            enum: readonly ("connect" | "skip")[];
+            description?: string;
+        };
+    }, "choice">;
+    readonly sequence: import("./schema.js").ContractObject<{
+        readonly decision: {
+            type: "string";
+            enum: readonly ("keep_draft" | "review")[];
+            description?: string;
+        };
+    }, "decision">;
+    readonly tour: import("./schema.js").ContractObject<{
+        readonly visited: import("./schema.js").ArrayProperty<{
+            type: "string";
+            enum: readonly ("leads" | "overview" | "sequence" | "sourcing")[];
+            description?: string;
+        }>;
+    }, "visited">;
+}, never>;
+export declare const GUIDED_ONBOARDING_MUTATION_CONTRACT: import("./schema.js").ContractObject<{
+    revision: {
+        type: "integer";
+        description?: string;
+        minimum?: number;
+        maximum?: number;
+        "x-clamp"?: true;
+    };
+    mutation_id: import("./schema.js").StringProperty;
+}, "mutation_id" | "revision">;
+export declare const GUIDED_ONBOARDING_ADVANCE_CONTRACT: import("./schema.js").ContractObject<{
+    readonly revision: {
+        type: "integer";
+        description?: string;
+        minimum?: number;
+        maximum?: number;
+        "x-clamp"?: true;
+    };
+    readonly mutation_id: import("./schema.js").StringProperty;
+    readonly step: {
+        type: "string";
+        enum: readonly ("audience_company_size" | "audience_industries" | "audience_markets" | "audience_personas" | "campaign" | "company_context" | "company_research" | "company_review" | "complete" | "daily_rhythm" | "linkedin" | "prospects" | "routines" | "sequence" | "signals" | "tour" | "trial" | "welcome")[];
+        description?: string;
+    };
+}, "mutation_id" | "revision" | "step">;
+export declare const GUIDED_ONBOARDING_SAVE_CONTRACT: import("./schema.js").ContractObject<{
+    readonly revision: {
+        type: "integer";
+        description?: string;
+        minimum?: number;
+        maximum?: number;
+        "x-clamp"?: true;
+    };
+    readonly mutation_id: import("./schema.js").StringProperty;
+    readonly step: {
+        type: "string";
+        enum: readonly ("audience_company_size" | "audience_industries" | "audience_markets" | "audience_personas" | "campaign" | "company_context" | "company_research" | "company_review" | "complete" | "daily_rhythm" | "linkedin" | "prospects" | "routines" | "sequence" | "signals" | "tour" | "trial" | "welcome")[];
+        description?: string;
+    };
+    readonly answers: import("./schema.js").ContractObject<{
+        readonly company_context: import("./schema.js").ContractObject<{
+            readonly website: {
+                oneOf: [import("./schema.js").StringProperty, import("./schema.js").NullProperty];
+                description?: string;
+            };
+            readonly name: import("./schema.js").StringProperty;
+            readonly description: import("./schema.js").StringProperty;
+            readonly context_links: import("./schema.js").ArrayProperty<import("./schema.js").StringProperty>;
+            readonly file_ids: import("./schema.js").ArrayProperty<import("./schema.js").StringProperty>;
+        }, "context_links" | "description" | "file_ids" | "name" | "website">;
+        readonly company_review: import("./schema.js").ContractObject<{
+            readonly statement: import("./schema.js").StringProperty;
+            readonly profile_revision: import("./schema.js").StringProperty;
+        }, "profile_revision" | "statement">;
+        readonly audience_company_size: import("./schema.js").ContractObject<{
+            readonly values: import("./schema.js").ArrayProperty<import("./schema.js").StringProperty>;
+        }, "values">;
+        readonly audience_markets: import("./schema.js").ContractObject<{
+            readonly values: import("./schema.js").ArrayProperty<import("./schema.js").StringProperty>;
+        }, "values">;
+        readonly audience_industries: import("./schema.js").ContractObject<{
+            readonly values: import("./schema.js").ArrayProperty<import("./schema.js").StringProperty>;
+        }, "values">;
+        readonly audience_personas: import("./schema.js").ContractObject<{
+            readonly values: import("./schema.js").ArrayProperty<import("./schema.js").StringProperty>;
+        }, "values">;
+        readonly signals: import("./schema.js").ContractObject<{
+            readonly hiring: import("./schema.js").ContractObject<{
+                readonly mode: {
+                    type: "string";
+                    enum: readonly ("none" | "selected")[];
+                    description?: string;
+                };
+                readonly values: import("./schema.js").ArrayProperty<import("./schema.js").StringProperty>;
+            }, "mode" | "values">;
+            readonly technology: import("./schema.js").ContractObject<{
+                readonly mode: {
+                    type: "string";
+                    enum: readonly ("none" | "selected")[];
+                    description?: string;
+                };
+                readonly values: import("./schema.js").ArrayProperty<import("./schema.js").ContractObject<{
+                    readonly name: import("./schema.js").StringProperty;
+                    readonly relationship: {
+                        type: "string";
+                        enum: readonly ("integrates_with" | "replaces" | "uses")[];
+                        description?: string;
+                    };
+                }, "name" | "relationship">>;
+            }, "mode" | "values">;
+        }, "hiring" | "technology">;
+        readonly prospects: import("./schema.js").ContractObject<{
+            readonly decision: {
+                type: "string";
+                enum: readonly ("continue" | "refine")[];
+                description?: string;
+            };
+            readonly feedback: import("./schema.js").StringProperty;
+        }, "decision" | "feedback">;
+        readonly linkedin: import("./schema.js").ContractObject<{
+            readonly choice: {
+                type: "string";
+                enum: readonly ("connect" | "skip")[];
+                description?: string;
+            };
+        }, "choice">;
+        readonly sequence: import("./schema.js").ContractObject<{
+            readonly decision: {
+                type: "string";
+                enum: readonly ("keep_draft" | "review")[];
+                description?: string;
+            };
+        }, "decision">;
+        readonly tour: import("./schema.js").ContractObject<{
+            readonly visited: import("./schema.js").ArrayProperty<{
+                type: "string";
+                enum: readonly ("leads" | "overview" | "sequence" | "sourcing")[];
+                description?: string;
+            }>;
+        }, "visited">;
+    }, never>;
+    readonly advance: import("./schema.js").BooleanProperty;
+}, "answers" | "mutation_id" | "revision" | "step">;
+export declare const GUIDED_ONBOARDING_NAVIGATION_CONTRACT: import("./schema.js").ContractObject<{
+    readonly revision: {
+        type: "integer";
+        description?: string;
+        minimum?: number;
+        maximum?: number;
+        "x-clamp"?: true;
+    };
+    readonly mutation_id: import("./schema.js").StringProperty;
+    readonly step: {
+        type: "string";
+        enum: readonly ("audience_company_size" | "audience_industries" | "audience_markets" | "audience_personas" | "campaign" | "company_context" | "company_research" | "company_review" | "complete" | "daily_rhythm" | "linkedin" | "prospects" | "routines" | "sequence" | "signals" | "tour" | "trial" | "welcome")[];
+        description?: string;
+    };
+    readonly paused: import("./schema.js").BooleanProperty;
+    readonly tour_active_stop: {
+        type: "string";
+        enum: readonly ("leads" | "overview" | "sequence" | "sourcing")[];
+        description?: string;
+    };
+}, "mutation_id" | "paused" | "revision" | "step">;
+export declare const GUIDED_ONBOARDING_CHECKOUT_CONTRACT: import("./schema.js").ContractObject<{
+    readonly revision: {
+        type: "integer";
+        description?: string;
+        minimum?: number;
+        maximum?: number;
+        "x-clamp"?: true;
+    };
+    readonly mutation_id: import("./schema.js").StringProperty;
+    readonly approved: import("./schema.js").BooleanProperty;
+}, "approved" | "mutation_id" | "revision">;
+export declare const GUIDED_ONBOARDING_JOURNEY_ACTIONS: readonly ["get", "save", "advance", "back", "restart", "billing", "checkout", "navigation", "prospects_preview"];
+export type GuidedOnboardingJourneyAction = typeof GUIDED_ONBOARDING_JOURNEY_ACTIONS[number];
+import type { OperationSpec } from "./operations.js";
+export declare const GUIDED_ONBOARDING_JOURNEY_OPERATIONS: readonly OperationSpec[];

package/node_modules/@oxygen/shared/dist/contracts/guided-onboarding-journey.js

@@ -0,0 +1,63 @@
+import { arr, bool, enumOf, int, obj, str } from "./schema.js";
+import { GUIDED_ONBOARDING_COMPANY_CONTEXT_CONTRACT } from "../guided-onboarding-company-context.js";
+import { GUIDED_ONBOARDING_STEPS, GUIDED_ONBOARDING_TECHNOLOGY_RELATIONSHIPS } from "../guided-onboarding-journey.js";
+const mode = () => enumOf(["none", "selected"]);
+const name = () => str({ minLength: 1, maxLength: 160 });
+/** Hiring roles remain strings. Technology identity includes its relationship. */
+export const GUIDED_ONBOARDING_SIGNALS_CONTRACT = obj({
+    hiring: obj({ mode: mode(), values: arr(name(), { maxItems: 40 }) }, { required: ["mode", "values"] }),
+    technology: obj({
+        mode: mode(),
+        values: arr(obj({ name: name(), relationship: enumOf(GUIDED_ONBOARDING_TECHNOLOGY_RELATIONSHIPS) }, { required: ["name", "relationship"] }), { maxItems: 40 }),
+    }, { required: ["mode", "values"] }),
+}, { required: ["hiring", "technology"] });
+const choice = () => obj({ values: arr(name(), { minItems: 1, maxItems: 40 }) }, { required: ["values"] });
+export const GUIDED_ONBOARDING_ANSWERS_CONTRACT = obj({
+    company_context: GUIDED_ONBOARDING_COMPANY_CONTEXT_CONTRACT,
+    company_review: obj({ statement: str({ minLength: 1, maxLength: 12000 }), profile_revision: str({ minLength: 1, maxLength: 160 }) }, { required: ["statement", "profile_revision"] }),
+    audience_company_size: choice(), audience_markets: choice(), audience_industries: choice(), audience_personas: choice(),
+    signals: GUIDED_ONBOARDING_SIGNALS_CONTRACT,
+    prospects: obj({ decision: enumOf(["continue", "refine"]), feedback: str({ maxLength: 4000 }) }, { required: ["decision", "feedback"] }),
+    linkedin: obj({ choice: enumOf(["connect", "skip"]) }, { required: ["choice"] }),
+    sequence: obj({ decision: enumOf(["review", "keep_draft"]) }, { required: ["decision"] }),
+    tour: obj({ visited: arr(enumOf(["overview", "leads", "sourcing", "sequence"]), { maxItems: 4 }) }, { required: ["visited"] }),
+});
+const mutation = { revision: int({ minimum: 1 }), mutation_id: str({ minLength: 1, maxLength: 160, pattern: "^[a-zA-Z0-9_.:-]+$" }) };
+export const GUIDED_ONBOARDING_MUTATION_CONTRACT = obj(mutation, { required: ["revision", "mutation_id"] });
+export const GUIDED_ONBOARDING_ADVANCE_CONTRACT = obj({ ...mutation, step: enumOf(GUIDED_ONBOARDING_STEPS) }, { required: ["revision", "mutation_id", "step"] });
+export const GUIDED_ONBOARDING_SAVE_CONTRACT = obj({ ...mutation, step: enumOf(GUIDED_ONBOARDING_STEPS),
+    answers: GUIDED_ONBOARDING_ANSWERS_CONTRACT, advance: bool({ description: "Save and advance in one native transaction after checking this step. No provider action or implicit activation." }) }, { required: ["revision", "mutation_id", "step", "answers"] });
+export const GUIDED_ONBOARDING_NAVIGATION_CONTRACT = obj({ ...mutation, step: enumOf(GUIDED_ONBOARDING_STEPS), paused: bool(),
+    tour_active_stop: enumOf(["overview", "leads", "sourcing", "sequence"]) }, { required: ["revision", "mutation_id", "step", "paused"] });
+export const GUIDED_ONBOARDING_CHECKOUT_CONTRACT = obj({ ...mutation, approved: bool() }, { required: ["revision", "mutation_id", "approved"] });
+export const GUIDED_ONBOARDING_JOURNEY_ACTIONS = ["get", "save", "advance", "back", "restart", "billing", "checkout", "navigation", "prospects_preview"];
+const base = "/api/cli/onboarding/activation/{activationId}/journey";
+export const GUIDED_ONBOARDING_JOURNEY_OPERATIONS = [
+    { id: "onboarding.journey.get", route: base, method: "GET", contract: obj({}), parameters: ["activationId"],
+        cli: { path: ["onboarding", "journey", "get"], summary: "Read your private resumable onboarding answers and native progress." },
+        mcp: { name: "oxygen_onboarding_journey_get", title: "Oxygen: Read onboarding journey", description: "Read your activationId journey and saved answers. Creator-private; enabled genuine DEV only. No research, model call or message send.", pack: "agents" }, mutates: false, spends: false },
+    { id: "onboarding.journey.save", route: base, method: "POST", parameters: ["activationId"], contract: GUIDED_ONBOARDING_SAVE_CONTRACT,
+        cli: { path: ["onboarding", "journey", "save"], summary: "Save reviewed answers and optionally advance atomically. Free; no model, send or routine execution." },
+        mcp: { name: "oxygen_onboarding_journey_save", title: "Oxygen: Onboarding save", description: "Creator-private DEV onboarding save for activationId. Requires current revision and stable mutation_id. Save accepts only current step answers; company context prepares native sources and records existing bounded research consent. Advance checks native readiness and billing. No paid turn, synchronous research, outreach or routine activation.", pack: "agents", annotations: { destructiveHint: false, openWorldHint: false, idempotentHint: true } }, mutates: true, spends: false },
+    { id: "onboarding.journey.advance", route: `${base}/advance`, method: "POST", parameters: ["activationId"], contract: GUIDED_ONBOARDING_ADVANCE_CONTRACT,
+        cli: { path: ["onboarding", "journey", "advance"], summary: "Advance after native readiness checks. Free; no model, send or routine execution." },
+        mcp: { name: "oxygen_onboarding_journey_advance", title: "Oxygen: Onboarding advance", description: "Creator-private DEV onboarding advance for activationId. Requires current revision and stable mutation_id. Save accepts only current step answers; advance checks native readiness and billing. Restart preserves resources and consumed funding. No paid turn, research, outreach or routine activation.", pack: "agents", annotations: { destructiveHint: false, openWorldHint: false, idempotentHint: true } }, mutates: true, spends: false },
+    { id: "onboarding.journey.back", route: `${base}/back`, method: "POST", parameters: ["activationId"], contract: GUIDED_ONBOARDING_MUTATION_CONTRACT,
+        cli: { path: ["onboarding", "journey", "back"], summary: "Return to the previous step with saved answers. Free; no model, send or routine execution." },
+        mcp: { name: "oxygen_onboarding_journey_back", title: "Oxygen: Onboarding back", description: "Creator-private DEV onboarding back for activationId. Requires current revision and stable mutation_id. Save accepts only current step answers; advance checks native readiness and billing. Restart preserves resources and consumed funding. No paid turn, research, outreach or routine activation.", pack: "agents", annotations: { destructiveHint: false, openWorldHint: false, idempotentHint: true } }, mutates: true, spends: false },
+    { id: "onboarding.journey.restart", route: `${base}/restart`, method: "POST", parameters: ["activationId"], contract: GUIDED_ONBOARDING_MUTATION_CONTRACT,
+        cli: { path: ["onboarding", "journey", "restart"], summary: "Restart progress, preserving Knowledge, chats, campaigns and billing. Free; no model, send or routine execution." },
+        mcp: { name: "oxygen_onboarding_journey_restart", title: "Oxygen: Onboarding restart", description: "Creator-private DEV onboarding restart for activationId. Requires current revision and stable mutation_id. Save accepts only current step answers; advance checks native readiness and billing. Restart preserves resources and consumed funding. No paid turn, research, outreach or routine activation.", pack: "agents", annotations: { destructiveHint: false, openWorldHint: false, idempotentHint: true } }, mutates: true, spends: false },
+    { id: "onboarding.journey.prospects_preview", route: `${base}/prospects/preview`, method: "POST", parameters: ["activationId"], contract: GUIDED_ONBOARDING_MUTATION_CONTRACT,
+        cli: { path: ["onboarding", "journey", "prospects-preview"], summary: "Preview up to five real people for saved targeting through the native free source; persist inspectable native results." },
+        mcp: { name: "oxygen_onboarding_journey_prospects_preview", title: "Oxygen: Preview onboarding prospects", description: "At the prospects step, use current revision and stable mutation_id to preview up to five people from saved targeting. Native free source read and manual preview Table writes; cached retries, no paid fallback, inference, enrollment or outreach. Unsupported criteria remain explicit diagnostics, never verified fit.", pack: "agents", annotations: { openWorldHint: true, destructiveHint: false, idempotentHint: true } }, mutates: true, spends: false },
+    { id: "onboarding.journey.navigation", route: `${base}/navigation`, method: "POST", parameters: ["activationId"], contract: GUIDED_ONBOARDING_NAVIGATION_CONTRACT,
+        cli: { path: ["onboarding", "journey", "navigation"], summary: "Save pause/resume and exact tour position, retaining the current journey step and visited history." },
+        mcp: { name: "oxygen_onboarding_journey_navigation", title: "Oxygen: Save onboarding position", description: "Persist paused and optional tour_active_stop at current step/revision with stable mutation_id. Position is separate from visited history. No step advance, research, send or routine activation.", pack: "agents" }, mutates: true, spends: false },
+    { id: "onboarding.journey.billing", route: `${base}/billing`, method: "GET", contract: obj({}), parameters: ["activationId"],
+        cli: { path: ["onboarding", "journey", "billing"], summary: "Read native trial eligibility; may reconcile an already-earned trial credit grant." },
+        mcp: { name: "oxygen_onboarding_journey_billing", title: "Oxygen: Onboarding billing", description: "Read native TEST trial/paid eligibility for your activationId. May reconcile an already-earned native credit grant, so this is a mutating call. No new subscription or charge; errors remain errors.", pack: "agents", annotations: { openWorldHint: true } }, mutates: true, spends: false },
+    { id: "onboarding.journey.checkout", route: `${base}/checkout`, method: "POST", contract: GUIDED_ONBOARDING_CHECKOUT_CONTRACT, parameters: ["activationId"],
+        cli: { path: ["onboarding", "journey", "checkout"], summary: "Open approved DEV TEST Checkout as current workspace admin/owner, or reuse existing eligible billing." },
+        mcp: { name: "oxygen_onboarding_journey_checkout", title: "Oxygen: Onboarding test Checkout", description: "Current DEV admin/owner only: approved=true, revision and stable mutation_id open card-required TEST Checkout, $0 for seven days then $49/month, once-only 2000 trial credits. Reuses eligible existing paid/trial. No live Stripe fallback or early charge.", pack: "agents", annotations: { openWorldHint: true } }, mutates: true, spends: false },
+];