@oxygen-agent/cli 1.1014.1343 → 1.1014.1451

package/node_modules/@oxygen/shared/dist/capability-args.js

@@ -0,0 +1,73 @@
+const MAX_ARG_ERRORS = 8;
+function matchesJsonType(value, type) {
+    switch (type) {
+        case "string":
+            return typeof value === "string";
+        case "number":
+            return typeof value === "number" && Number.isFinite(value);
+        case "integer":
+            return typeof value === "number" && Number.isInteger(value);
+        case "boolean":
+            return typeof value === "boolean";
+        case "array":
+            return Array.isArray(value);
+        case "object":
+            return value !== null && typeof value === "object" && !Array.isArray(value);
+        case "null":
+            return value === null;
+        default:
+            // An unrecognised type keyword is not something this shallow check gets to
+            // fail a call over — silence beats a false positive that blocks a good call.
+            return true;
+    }
+}
+/**
+ * Shallow top-level validation of proposed args against a capability's own
+ * inputSchema. Fail-open on anything it cannot read (no `properties`, exotic
+ * keywords, nested shapes): a wrongly-rejected call is a worse outcome than a
+ * call the route rejects a moment later, and the route still rejects it.
+ */
+export function validateCapabilityArgs(def, args) {
+    const schema = (def.inputSchema ?? {});
+    const properties = schema.properties;
+    if (!properties || typeof properties !== "object")
+        return { ok: true };
+    const errors = [];
+    const required = Array.isArray(schema.required)
+        ? schema.required.filter((entry) => typeof entry === "string")
+        : [];
+    for (const name of required) {
+        if (!(name in args) || args[name] === undefined) {
+            errors.push(`missing required argument "${name}"`);
+        }
+    }
+    if (schema.additionalProperties === false) {
+        for (const key of Object.keys(args)) {
+            if (!(key in properties))
+                errors.push(`unknown argument "${key}"`);
+        }
+    }
+    for (const [key, value] of Object.entries(args)) {
+        const property = properties[key];
+        if (!property || value === undefined)
+            continue;
+        const declared = Array.isArray(property.type)
+            ? property.type
+            : property.type !== undefined
+                ? [property.type]
+                : [];
+        const types = declared.filter((entry) => typeof entry === "string");
+        if (types.length > 0 && !types.some((type) => matchesJsonType(value, type))) {
+            errors.push(`argument "${key}" must be ${types.join(" or ")}`);
+        }
+        const allowed = property.enum;
+        if (Array.isArray(allowed) &&
+            allowed.length > 0 &&
+            allowed.every((entry) => typeof entry === "string") &&
+            typeof value === "string" &&
+            !allowed.includes(value)) {
+            errors.push(`argument "${key}" must be one of: ${allowed.join(", ")}`);
+        }
+    }
+    return errors.length > 0 ? { ok: false, errors: errors.slice(0, MAX_ARG_ERRORS) } : { ok: true };
+}

package/node_modules/@oxygen/shared/dist/capability-discovery.js

@@ -239,7 +239,7 @@ export const OXYGEN_CAPABILITY_ROUTES = [
         gatewayTools: ["oxygen_tables_create", "oxygen_tools_search", "oxygen_columns_add", "oxygen_columns_catalog", "oxygen_enrich_column_preview", "oxygen_tables_link_bulk", "oxygen_callables_manage", "oxygen_tables_records_import"],
         gatewayCommands: ["tables create", "tools search", "columns add", "columns catalog", "enrich-column preview", "tables link", "functions list", "functions draft", "tables records import"],
         skills: ["oxygen-tables", "oxygen-enrichment", "oxygen-table-tidy", "oxygen-diagnostics", "oxygen-clay-migration", "oxygen-signals"],
-        endpointSections: ["action-columns", "callables", "functions", "columns", "company-enrichment", "enrich-column", "enrichment", "projects", "supabase", "table-action-items", "table-action-runs", "table-ingestion-runs", "tables"],
+        endpointSections: ["action-columns", "callables", "functions", "columns", "company-enrichment", "enrich-column", "enrichment", "migrations", "projects", "supabase", "table-action-items", "table-action-runs", "table-ingestion-runs", "tables"],
         // "link"/"join"/"connect"/"relate" route here for `tables link`. Added after a
         // blind user eval asked for exactly "link two tables" and was routed to
         // `tables create` / `columns add` / `enrich-column preview` — none of which
@@ -1358,6 +1358,12 @@ function routeCardFor(card, query) {
             notFor: "Provider credentials, enrichment, workspace billing, or staff-wide database operations.",
             execution: database.execution,
         };
+    if (card.id === "tables" && isClayMigrationIntent(query))
+        card = {
+            ...card,
+            posture: "workspace_write",
+            execution: "Start oxygen_clay_migration action=connect for browser sign-in; keep its migration_id for discovery, bounded source reads, table transfers, rebuild checkpoints and coverage reports. Read oxygen-clay-migration for the native reconstruction procedure. Create destination objects through their Oxygen tools, retain source outputs and report export limitations. Imported behavior stays inactive until separately approved. External MCP uses oxygen_capabilities_call.",
+        };
     const specializedSkill = preferredSkillForIntent(card, query);
     return specializedSkill ? { ...card, skills: [specializedSkill, ...card.skills.filter((skill) => skill !== specializedSkill)] } : card;
 }
@@ -1366,7 +1372,7 @@ function preferredSkillForIntent(card, query) {
     if (card.id === "tables") {
         if (linkedinUrlFindingRecommendation(query))
             return "oxygen-enrichment";
-        if (/\bclay\b/.test(query) && /\b(import|export|migrat\w*|mov\w*)\b/.test(query))
+        if (isClayMigrationIntent(query))
             return "oxygen-clay-migration";
         if (isTableMaintenanceIntent(query))
             return "oxygen-table-tidy";
@@ -1387,6 +1393,9 @@ function preferredSkillForIntent(card, query) {
         return "oxygen-signals";
     return null;
 }
+function isClayMigrationIntent(query) {
+    return /\bclay\b/.test(query) && /\b(import|export|migrat\w*|mov\w*|transfer|bring|rebuild)\b/.test(query);
+}
 function isTableMaintenanceIntent(query) {
     return /\b(tables?|columns?|folders?)\b/.test(query)
         && !/\b(functions?|callables?|campaigns?|tags?|workflows?|agents?)\b/.test(query)
@@ -2169,6 +2178,8 @@ function isWorkspaceSkillIntent(query) {
     return /\bskills?\b/.test(query) && /\b(create|author|write|upload|import|edit|update|archive|private|workspace|custom|own|reusable)\b/.test(query);
 }
 function explicitCapabilityIntent(query) {
+    if (isClayMigrationIntent(query))
+        return ROUTE_BY_ID.get("tables") ?? null;
     if (isWorkspaceSkillIntent(query))
         return ROUTE_BY_ID.get("knowledge-graph") ?? null;
     const readOnly = readInspectionRecommendation(query);
@@ -2867,6 +2878,8 @@ function recommendationsFor(card, query) {
         };
     }
     if (card.primitive === "tables") {
+        if (isClayMigrationIntent(query))
+            return { tools: ["oxygen_clay_migration"], commands: ["clay migration"], exactCommand: "oxygen clay migration --action connect --json", exactMcpCall: { tool: "oxygen_clay_migration", arguments: { action: "connect" } } };
         const removal = tableRowRemovalRecommendation(query);
         if (removal)
             return removal;

package/node_modules/@oxygen/shared/dist/clay-migration-auth-state.d.ts

@@ -0,0 +1,3 @@
+export declare function tagClayMigrationFailureState(error: unknown, encryptedState: string): void;
+/** Consume only state attached in this process by the migration adapter. */
+export declare function readClayMigrationFailureState(error: unknown): string | null;

package/node_modules/@oxygen/shared/dist/clay-migration-auth-state.js

@@ -0,0 +1,15 @@
+// Rotated credentials must survive a failed source read, without becoming part
+// of a customer error, operator log or serialized tool result.
+const failureStates = new WeakMap();
+export function tagClayMigrationFailureState(error, encryptedState) {
+    if (error !== null && typeof error === "object")
+        failureStates.set(error, encryptedState);
+}
+/** Consume only state attached in this process by the migration adapter. */
+export function readClayMigrationFailureState(error) {
+    if (error === null || typeof error !== "object")
+        return null;
+    const state = failureStates.get(error) ?? null;
+    failureStates.delete(error);
+    return state;
+}

package/node_modules/@oxygen/shared/dist/contracts/browser-operations.js

@@ -134,5 +134,6 @@ export const BROWSER_OPERATIONS = [
     operation("notetaker.note.edit", "/api/cli/notetaker/sessions/{session}/note", "PATCH", "notetaker notes edit", "oxygen_notetaker_note_edit", "crm", "Save the markdown note for one meeting session and return the committed note.", { markdown: text() }, ["markdown"]),
     operation("orgs.create", "/api/cli/orgs/create", "POST", "orgs create", "oxygen_workspace_create", "workspace", "Create a workspace for the authenticated person's account and begin native company setup. Workspace API keys cannot create personal workspaces.", { name: text(), company_domain: text("Company website or domain, or its LinkedIn company page URL when it has no website."), linkedin_profile_url: text("Creator's LinkedIn profile URL, separate from the company's page.") }, ["name", "company_domain"]),
     operation("onboarding.complete", "/api/cli/onboarding/complete", "POST", "onboarding complete", "oxygen_onboarding_complete", "workspace", "Complete the active workspace's onboarding step and record its discovery-source choices. The other choice requires source_other.", { sources: arr(enumOf(["linkedin_content", "linkedin_dm", "linkedin_ads", "x", "youtube", "google", "ai_assistant", "email", "word_of_mouth", "referral", "event", "other"])), source_other: text(), redirect_url: text() }, ["sources"]),
-    operation("onboarding.start", "/api/cli/onboarding/start", "POST", "onboarding start", "oxygen_onboarding_start", "workspace", "Answer onboarding's choice card. own_agent continues to connecting your own agent. copilot opens the Workspace Copilot with the onboarding conversation already started, billed in credits like any Copilot turn; choosing again reopens that conversation.", { path: enumOf(["own_agent", "copilot"]), play: text("A play slug carried to the install step.") }, ["path"], { spends: true }),
+    operation("onboarding.finish", "/api/cli/onboarding/finish", "POST", "onboarding finish", "oxygen_onboarding_finish", "workspace", "Finish agent-led onboarding once a play is chosen: the onboarding Oxygent chat opens as an ordinary chat, without the Knowledge pane. Changes nothing else and spends nothing."),
+    operation("onboarding.start", "/api/cli/onboarding/start", "POST", "onboarding start", "oxygen_onboarding_start", "workspace", "Answer onboarding's choice card. own_agent continues to connecting your own agent. copilot opens the Workspace Copilot with the onboarding conversation already started, billed in credits like any Copilot turn; choosing again reopens that conversation. restart (copilot) shows a finished onboarding again and asks the Oxygent to start over, as an ordinary send.", { path: enumOf(["own_agent", "copilot"]), play: text("A play slug carried to the install step."), restart: bool() }, ["path"], { spends: true }),
 ];

package/node_modules/@oxygen/shared/dist/contracts/clay-migration.d.ts

@@ -0,0 +1,71 @@
+import type { OperationSpec } from "./operation-request.js";
+import { type ContractIssue, type Infer } from "./schema.js";
+export declare const CLAY_MIGRATION_ACTIONS: readonly ["connect", "status", "discover", "read", "transfer", "checkpoint", "report", "disconnect"];
+export declare const CLAY_RESOURCE_TYPES: readonly ["workspace", "folder", "workbook", "table", "audience", "workflow", "function", "claygent", "knowledge", "schedule", "campaign"];
+export declare const CLAY_RESOURCE_DISPOSITIONS: readonly ["pending", "copied", "rebuilt", "needs_decision", "unsupported", "inaccessible", "excluded", "failed"];
+export declare const CLAY_MIGRATION_CONTRACT: import("./schema.js").ContractObject<{
+    readonly action: {
+        type: "string";
+        enum: readonly ("checkpoint" | "connect" | "disconnect" | "discover" | "read" | "report" | "status" | "transfer")[];
+        description?: string;
+    };
+    readonly migration_id: import("./schema.js").StringProperty;
+    readonly source_workspace_id: import("./schema.js").StringProperty;
+    readonly resource_type: {
+        type: "string";
+        enum: readonly ("audience" | "campaign" | "claygent" | "folder" | "function" | "knowledge" | "schedule" | "table" | "workbook" | "workflow" | "workspace")[];
+        description?: string;
+    };
+    readonly resource_id: import("./schema.js").StringProperty;
+    readonly section: {
+        type: "string";
+        enum: readonly ("columns" | "fields" | "graph" | "metadata" | "record_ids" | "records" | "rows" | "sequence")[];
+        description?: string;
+    };
+    readonly path: import("./schema.js").StringProperty;
+    readonly text_offset: {
+        type: "integer";
+        description?: string;
+        minimum?: number;
+        maximum?: number;
+        "x-clamp"?: true;
+    };
+    readonly entity_type: {
+        type: "string";
+        enum: readonly ("companies" | "deals" | "people")[];
+        description?: string;
+    };
+    readonly record_ids: import("./schema.js").ArrayProperty<{
+        type: "integer";
+        description?: string;
+        minimum?: number;
+        maximum?: number;
+        "x-clamp"?: true;
+    }>;
+    readonly cursor: import("./schema.js").StringProperty;
+    readonly limit: {
+        type: "integer";
+        description?: string;
+        minimum?: number;
+        maximum?: number;
+        "x-clamp"?: true;
+    };
+    readonly target_table: import("./schema.js").StringProperty;
+    readonly source_cells_column: import("./schema.js").StringProperty;
+    readonly source_row_id_column: import("./schema.js").StringProperty;
+    readonly mapping: import("./schema.js").ArrayProperty<import("./schema.js").ContractObject<{
+        readonly source_column_id: import("./schema.js").StringProperty;
+        readonly target_column: import("./schema.js").StringProperty;
+    }, "source_column_id" | "target_column">>;
+    readonly disposition: {
+        type: "string";
+        enum: readonly ("copied" | "excluded" | "failed" | "inaccessible" | "needs_decision" | "pending" | "rebuilt" | "unsupported")[];
+        description?: string;
+    };
+    readonly target_kind: import("./schema.js").StringProperty;
+    readonly target_id: import("./schema.js").StringProperty;
+    readonly notes: import("./schema.js").StringProperty;
+}, "action">;
+export type ClayMigrationInput = Infer<typeof CLAY_MIGRATION_CONTRACT>;
+export declare function clayMigrationInputIssues(args: Readonly<Record<string, unknown>>): ContractIssue[];
+export declare const CLAY_MIGRATION_OPERATION: OperationSpec<typeof CLAY_MIGRATION_CONTRACT>;

package/node_modules/@oxygen/shared/dist/contracts/clay-migration.js

@@ -0,0 +1,60 @@
+import { arr, enumOf, int, obj, str } from "./schema.js";
+export const CLAY_MIGRATION_ACTIONS = ["connect", "status", "discover", "read", "transfer", "checkpoint", "report", "disconnect"];
+export const CLAY_RESOURCE_TYPES = ["workspace", "folder", "workbook", "table", "audience", "workflow", "function", "claygent", "knowledge", "schedule", "campaign"];
+export const CLAY_RESOURCE_DISPOSITIONS = ["pending", "copied", "rebuilt", "needs_decision", "unsupported", "inaccessible", "excluded", "failed"];
+export const CLAY_MIGRATION_CONTRACT = obj({
+    action: enumOf(CLAY_MIGRATION_ACTIONS),
+    migration_id: str({ minLength: 1, maxLength: 200 }),
+    source_workspace_id: str({ minLength: 1, maxLength: 200 }),
+    resource_type: enumOf(CLAY_RESOURCE_TYPES),
+    resource_id: str({ minLength: 1, maxLength: 200 }),
+    section: enumOf(["metadata", "columns", "rows", "graph", "fields", "record_ids", "records", "sequence"]),
+    path: str({ minLength: 1, maxLength: 1000, description: "Dotted path or JSON pointer into source configuration, e.g. data.0.settings." }),
+    text_offset: int({ minimum: 0, maximum: 8388608, description: "Continue a large scalar read at next_text_offset." }),
+    entity_type: enumOf(["people", "companies", "deals"]),
+    record_ids: arr(int({ minimum: 1 }), { minItems: 1, maxItems: 100 }),
+    cursor: str({ maxLength: 4000 }),
+    limit: int({ minimum: 1, maximum: 100 }),
+    target_table: str({ minLength: 1, maxLength: 200 }),
+    source_cells_column: str({ minLength: 1, maxLength: 200, description: "Existing JSON column preserving original Clay cells; default clay_source_cells." }),
+    source_row_id_column: str({ minLength: 1, maxLength: 200, description: "Existing text column for stable source row IDs; default clay_source_row_id." }),
+    mapping: arr(obj({ source_column_id: str({ minLength: 1, maxLength: 200 }), target_column: str({ minLength: 1, maxLength: 200 }) }, { required: ["source_column_id", "target_column"] }), { minItems: 1, maxItems: 500, description: "Source Clay column IDs or Audience field keys to existing Oxygen column keys." }),
+    disposition: enumOf(CLAY_RESOURCE_DISPOSITIONS),
+    target_kind: str({ minLength: 1, maxLength: 100 }),
+    target_id: str({ minLength: 1, maxLength: 200 }),
+    notes: str({ maxLength: 8000 }),
+}, { required: ["action"] });
+export function clayMigrationInputIssues(args) {
+    const issues = [];
+    const requireField = (key) => { if (args[key] === undefined)
+        issues.push({ path: key, message: `${key} is required for ${String(args.action)}.` }); };
+    if (args.action !== "connect")
+        requireField("migration_id");
+    if (["read", "transfer", "checkpoint"].includes(String(args.action)))
+        requireField("resource_type");
+    const workspaceRead = ["workspace", "knowledge"].includes(String(args.resource_type))
+        || (args.resource_type === "audience" && ["fields", "record_ids", "records"].includes(String(args.section)));
+    if (["transfer", "checkpoint"].includes(String(args.action)) || (args.action === "read" && !workspaceRead))
+        requireField("resource_id");
+    if (args.action === "transfer") {
+        requireField("target_table");
+        requireField("mapping");
+        if (!["table", "audience"].includes(String(args.resource_type)))
+            issues.push({ path: "resource_type", message: "Bulk transfer requires a Clay table or Audience; rebuild other resources with native Oxygen tools." });
+    }
+    if (args.action === "checkpoint")
+        requireField("disposition");
+    if (args.section === "records") {
+        requireField("entity_type");
+        requireField("record_ids");
+    }
+    return issues;
+}
+export const CLAY_MIGRATION_OPERATION = {
+    id: "clay.migration", route: "/api/cli/migrations/clay", method: "POST",
+    contract: CLAY_MIGRATION_CONTRACT, inputCheck: clayMigrationInputIssues,
+    generated: { cli: false, mcp: false },
+    cli: { path: ["clay", "migration"], summary: "Migrate a Clay workspace into Oxygen: connect, discover source configuration, inspect bounded samples, transfer table and Audience rows, checkpoint native rebuilds and reconcile coverage. Creates no paid runs or active schedules." },
+    mcp: { name: "oxygen_clay_migration", title: "Oxygen: Migrate from Clay", description: "Connect to Clay with browser sign-in, discover resources, read source configuration and samples, transfer table and Audience rows to existing Oxygen tables, checkpoint rebuilds and report coverage. Use native Oxygen tools to create targets and rebuild behavior. Follow cursors; report unsupported or inaccessible resources. Never activates schedules or paid runs.", pack: "integrations", annotations: { openWorldHint: true, destructiveHint: false, idempotentHint: false } },
+    mutates: true, spends: false,
+};

package/node_modules/@oxygen/shared/dist/contracts/operations.js

@@ -12,14 +12,12 @@ import { BROWSER_OPERATIONS } from "./browser-operations.js";
 import { TABLE_FEED_UPDATE_OPERATION } from "./table-feed-update.js";
 import { GEO_OPERATIONS } from "./geo.js";
 import { CUSTOMER_OPERATIONS } from "./customer-operations.js";
-import { GUIDED_ONBOARDING_JOURNEY_OPERATIONS } from "./guided-onboarding-journey.js";
-import { GUIDED_FIRST_SOURCING_OPERATIONS } from "./guided-first-sourcing.js";
-import { GUIDED_COMPANY_FILE_UPLOAD_OPERATION } from "./guided-company-files.js";
 import { GUIDED_ACTIVATION_OPERATIONS } from "./guided-activation.js";
 import { AGENT_SESSION_OPERATIONS } from "./agent-sessions.js";
 import { REPLY_OXYGENT_OPERATIONS } from "./reply-oxygent.js";
 import { TEAMMATE_OPERATIONS } from "./teammates.js";
 import { WORKSPACE_SKILL_OPERATIONS } from "./workspace-skills.js";
+import { CLAY_MIGRATION_OPERATION } from "./clay-migration.js";
 export { operationPath, operationRequest } from "./operation-request.js";
 /** The exact public grammar, including the operation's scoped route parameters. */
 export function operationInputContract(spec) {
@@ -63,6 +61,6 @@ export function operationFormData(spec, body) {
     }
     return form;
 }
-export const OPERATION_SPECS = [SENDER_LIMITS_SET_OPERATION, CONNECTOR_UPDATE_OPERATION, CONNECTOR_EVENTS_REVOKE_OPERATION, WORKSPACE_PAGES_GET_OPERATION, WORKSPACE_PAGES_UPDATE_OPERATION, TABLE_FEED_UPDATE_OPERATION, ...CUSTOMER_OPERATIONS, ...GEO_OPERATIONS, ...BROWSER_OPERATIONS, ...AGENT_SESSION_OPERATIONS, ...GUIDED_ACTIVATION_OPERATIONS, ...GUIDED_ONBOARDING_JOURNEY_OPERATIONS, ...GUIDED_FIRST_SOURCING_OPERATIONS, GUIDED_COMPANY_FILE_UPLOAD_OPERATION, ...TEAMMATE_OPERATIONS, ...REPLY_OXYGENT_OPERATIONS, ...WORKSPACE_SKILL_OPERATIONS];
-export const CLI_OPERATIONS = [...CUSTOMER_OPERATIONS, ...GEO_OPERATIONS, ...BROWSER_OPERATIONS, ...AGENT_SESSION_OPERATIONS, ...GUIDED_ACTIVATION_OPERATIONS, ...GUIDED_ONBOARDING_JOURNEY_OPERATIONS, ...GUIDED_FIRST_SOURCING_OPERATIONS, GUIDED_COMPANY_FILE_UPLOAD_OPERATION, ...TEAMMATE_OPERATIONS, ...REPLY_OXYGENT_OPERATIONS, ...WORKSPACE_SKILL_OPERATIONS].filter((spec) => spec.generated?.cli !== false);
-export const MCP_OPERATIONS = [...CUSTOMER_OPERATIONS, ...GEO_OPERATIONS, ...BROWSER_OPERATIONS, ...AGENT_SESSION_OPERATIONS, ...GUIDED_ACTIVATION_OPERATIONS, ...GUIDED_ONBOARDING_JOURNEY_OPERATIONS, ...GUIDED_FIRST_SOURCING_OPERATIONS, GUIDED_COMPANY_FILE_UPLOAD_OPERATION, ...TEAMMATE_OPERATIONS, ...REPLY_OXYGENT_OPERATIONS, ...WORKSPACE_SKILL_OPERATIONS].filter((spec) => spec.generated?.mcp !== false);
+export const OPERATION_SPECS = [CLAY_MIGRATION_OPERATION, SENDER_LIMITS_SET_OPERATION, CONNECTOR_UPDATE_OPERATION, CONNECTOR_EVENTS_REVOKE_OPERATION, WORKSPACE_PAGES_GET_OPERATION, WORKSPACE_PAGES_UPDATE_OPERATION, TABLE_FEED_UPDATE_OPERATION, ...CUSTOMER_OPERATIONS, ...GEO_OPERATIONS, ...BROWSER_OPERATIONS, ...AGENT_SESSION_OPERATIONS, ...GUIDED_ACTIVATION_OPERATIONS, ...TEAMMATE_OPERATIONS, ...REPLY_OXYGENT_OPERATIONS, ...WORKSPACE_SKILL_OPERATIONS];
+export const CLI_OPERATIONS = [...CUSTOMER_OPERATIONS, ...GEO_OPERATIONS, ...BROWSER_OPERATIONS, ...AGENT_SESSION_OPERATIONS, ...GUIDED_ACTIVATION_OPERATIONS, ...TEAMMATE_OPERATIONS, ...REPLY_OXYGENT_OPERATIONS, ...WORKSPACE_SKILL_OPERATIONS].filter((spec) => spec.generated?.cli !== false);
+export const MCP_OPERATIONS = [...CUSTOMER_OPERATIONS, ...GEO_OPERATIONS, ...BROWSER_OPERATIONS, ...AGENT_SESSION_OPERATIONS, ...GUIDED_ACTIVATION_OPERATIONS, ...TEAMMATE_OPERATIONS, ...REPLY_OXYGENT_OPERATIONS, ...WORKSPACE_SKILL_OPERATIONS].filter((spec) => spec.generated?.mcp !== false);

package/node_modules/@oxygen/shared/dist/contracts/table-query-raw.d.ts

@@ -13,4 +13,8 @@ export declare const TABLE_QUERY_CLI_DEFAULT_MAX_CHARS = 12000;
 export declare function tableQueryRawResultFits(data: Record<string, unknown>, maxChars: number | undefined): boolean;
 /** What a page shortened to fit its result window says to do next (CLI, MCP and API alike). */
 export declare const TABLE_QUERY_RESULT_WINDOW_NEXT_STEP: string;
-export declare function tableQueryRawRecovery(table: string, row?: string): Record<string, unknown>;
+/** The field whose value is longest in a row (system fields excluded): the one to drop or inspect. */
+export declare function tableRowWidestField(row: unknown): string | undefined;
+/** Leads a refusal's next step with the exact field to drop or inspect, when the row is known. */
+export declare function tableQueryWidestFieldStep(widestField: string | undefined): string;
+export declare function tableQueryRawRecovery(table: string, row?: string, firstRow?: unknown): Record<string, unknown>;

package/node_modules/@oxygen/shared/dist/contracts/table-query-raw.js

@@ -12,10 +12,33 @@ export function tableQueryRawResultFits(data, maxChars) {
 /** What a page shortened to fit its result window says to do next (CLI, MCP and API alike). */
 export const TABLE_QUERY_RESULT_WINDOW_NEXT_STEP = "This page holds fewer rows than the limit so it fits the result window; every value is complete. "
     + "Continue with nextCursor (same table, filters, sorts and fields), or select fewer fields for more rows per page.";
-export function tableQueryRawRecovery(table, row) {
+/** The field whose value is longest in a row (system fields excluded): the one to drop or inspect. */
+export function tableRowWidestField(row) {
+    if (!row || typeof row !== "object" || Array.isArray(row))
+        return undefined;
+    let widest;
+    let widestLength = 0;
+    for (const [key, value] of Object.entries(row)) {
+        if (key.startsWith("_") || value === undefined)
+            continue;
+        const length = JSON.stringify(value).length;
+        if (length > widestLength) {
+            widest = key;
+            widestLength = length;
+        }
+    }
+    return widest;
+}
+/** Leads a refusal's next step with the exact field to drop or inspect, when the row is known. */
+export function tableQueryWidestFieldStep(widestField) {
+    return widestField ? `Field \`${widestField}\` is the largest value in that row: drop it from fields or inspect it. ` : "";
+}
+export function tableQueryRawRecovery(table, row, firstRow) {
+    const widestField = tableRowWidestField(firstRow);
     return {
         table,
         ...(row ? { row } : {}),
-        next_step: "Reduce fields/limit. Inspect a large cell with `tables rows inspect --table <table> --row <row> --field <field> --projection value --path /row/<field>/<key>`; select a JSON Pointer and continue with value_cursor. MCP: hydrate oxygen_table_row_inspect with oxygen_capabilities_schema, then dispatch it through oxygen_capabilities_read. CLI: --full restores legacy reads; --output <path> keeps full JSON outside context.",
+        ...(widestField ? { widest_field: widestField } : {}),
+        next_step: tableQueryWidestFieldStep(widestField) + "Reduce fields/limit. Inspect a large cell with `tables rows inspect --table <table> --row <row> --field <field> --projection value --path /row/<field>/<key>`; select a JSON Pointer and continue with value_cursor. MCP: hydrate oxygen_table_row_inspect with oxygen_capabilities_schema, then dispatch it through oxygen_capabilities_read. CLI: --full restores legacy reads; --output <path> keeps full JSON outside context.",
     };
 }

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

@@ -5,7 +5,7 @@ import { NEW_TEAMMATE_NAME, TEAMMATE_AVATAR_COLORS, TEAMMATE_AVATAR_KEYS, TEAMMA
 import { arr, bool, enumOf, int, obj, str } from "./schema.js";
 /**
  * AI teammates (ADR 0032), branded Oxygents: Agents with one ongoing chat,
- * shared by default or Personal, the workspace's first one ("New Bot" until named) and
+ * shared by default or Personal, the workspace's first one ("Oxygent" until named) and
  * any others added, none with a role (Tim, 2026-10-13). Every member but a client
  * login has them where the workspace does (launched 2026-10-17).
  * The people-facing names say Oxygent (`oxygen oxygents`, `oxygen_oxygents_*`,

package/node_modules/@oxygen/shared/dist/dev-eval-context.js

@@ -28,6 +28,7 @@ export async function devEvalFetch(provider, operation, input, init, transport =
     return context ? context.fetch(provider, operation, input, init, transport) : transport(input, init);
 }
 export const DEV_EVAL_SAFE_CAPABILITIES = new Set([
+    "oxygen_knowledge_index", "oxygen_knowledge_search", "oxygen_knowledge_page_get",
     "oxygen_tables_list", "oxygen_tables_sources", "oxygen_tables_describe", "oxygen_tables_preview", "oxygen_tables_query", "oxygen_tables_create", "oxygen_tables_update", "oxygen_tables_rows_add", "oxygen_tables_rows_update",
     "oxygen_columns_catalog", "oxygen_columns_deps", "oxygen_columns_add", "oxygen_columns_update", "oxygen_columns_run", "oxygen_columns_materialize",
     "oxygen_enrichment_catalog", "oxygen_tools_search", "oxygen_tools_describe", "oxygen_tools_check_access", "oxygen_tools_plan_table_batch", "oxygen_tools_run_dry", "oxygen_tools_run_live",

package/node_modules/@oxygen/shared/dist/enrollment-origin.d.ts

@@ -16,7 +16,9 @@ export type EnrollmentOriginKind = typeof ENROLLMENT_ORIGIN_KINDS[number];
 export declare const ENROLLMENT_ACTOR_TYPES: readonly ["user", "agent", "workflow", "api_key", "system"];
 export type EnrollmentActorType = typeof ENROLLMENT_ACTOR_TYPES[number];
 /** The surface the enroll call came through. */
-export declare const ENROLLMENT_GATEWAYS: readonly ["cli", "mcp", "web", "copilot", "agent", "workflow", "engagement_watch"];
+export declare const ENROLLMENT_GATEWAYS: readonly ["cli", "mcp", "web", "copilot", "agent", "workflow", "engagement_watch", 
+/** The scheduled sync that enrolls new rows of a live campaign's bound table. */
+"table_sync"];
 export type EnrollmentGateway = typeof ENROLLMENT_GATEWAYS[number];
 export declare const ENROLLMENT_REF_TYPES: readonly ["workflow_run", "agent_run", "copilot_session", "engagement_watch", "guided_activation"];
 export type EnrollmentRefType = typeof ENROLLMENT_REF_TYPES[number];

package/node_modules/@oxygen/shared/dist/enrollment-origin.js

@@ -31,6 +31,8 @@ export const ENROLLMENT_GATEWAYS = [
     "agent",
     "workflow",
     "engagement_watch",
+    /** The scheduled sync that enrolls new rows of a live campaign's bound table. */
+    "table_sync",
 ];
 export const ENROLLMENT_REF_TYPES = [
     "workflow_run",

package/node_modules/@oxygen/shared/dist/guided-activation.d.ts

@@ -47,11 +47,13 @@ export type GuidedActivation = {
     resources: GuidedActivationResources;
     outcomes: Partial<Record<"first_leads" | "sequence" | "launch" | GuidedActivationPurpose, "proposed" | "armed" | "launched" | "confirmed_sent" | "paused">>;
     reviews: Partial<Record<GuidedActivationReview["purpose"], GuidedActivationReview>>;
+    /** `finished_at`: the person chose a play (or closed onboarding), so the chat is an ordinary Oxygent chat again. */
     onboarding_start: {
         state: "claimed" | "posted";
         chat_id: string;
         turn_id?: string;
         event_seq?: number;
+        finished_at?: string;
     } | null;
     last_fault: {
         code: string;

package/node_modules/@oxygen/shared/dist/guided-onboarding-company-context.d.ts

@@ -1,4 +1,3 @@
-import type { GuidedOnboardingAnswers } from "./guided-onboarding-journey.js";
 /** One native-supported input budget for web/CLI/MCP and D research preparation. */
 export declare const GUIDED_ONBOARDING_COMPANY_CONTEXT_LIMITS: {
     readonly descriptionChars: 6000;
@@ -7,6 +6,14 @@ export declare const GUIDED_ONBOARDING_COMPANY_CONTEXT_LIMITS: {
     readonly nameChars: 160;
     readonly urlChars: 2000;
 };
+/** Company context saved on a guided activation; the knowledge bootstrap still reads it. */
+export type GuidedOnboardingCompanyContext = {
+    website: string | null;
+    name: string;
+    description: string;
+    context_links: string[];
+    file_ids: string[];
+};
 export declare const GUIDED_ONBOARDING_COMPANY_CONTEXT_CONTRACT: import("./contracts/schema.js").ContractObject<{
     readonly website: {
         oneOf: [import("./contracts/schema.js").StringProperty, import("./contracts/schema.js").NullProperty];
@@ -19,4 +26,4 @@ export declare const GUIDED_ONBOARDING_COMPANY_CONTEXT_CONTRACT: import("./contr
 }, "context_links" | "description" | "file_ids" | "name" | "website">;
 /** Input-only rule; existing evidence links retain their independent navigation policy. */
 export declare function normalizeGuidedOnboardingContextLink(value: string): string;
-export declare function normalizeGuidedOnboardingCompanyContext(input: unknown): NonNullable<GuidedOnboardingAnswers["company_context"]>;
+export declare function normalizeGuidedOnboardingCompanyContext(input: unknown): GuidedOnboardingCompanyContext;

package/node_modules/@oxygen/shared/dist/guided-trial-billing.d.ts

@@ -1,4 +1,5 @@
-/** DEV onboarding offer. Existing subscription terms and production acquisition stay intact. */
+/** Retired DEV onboarding trial offer. New checkouts no longer create it; the
+ * marker still identifies subscriptions that were started under it. */
 export declare const GUIDED_TRIAL_OFFER: {
     readonly key: "guided_onboarding_v2";
     readonly plan: "oxygen_49";
@@ -10,7 +11,6 @@ export declare const GUIDED_TRIAL_OFFER: {
     readonly card_required: true;
     readonly early_charge_allowed: false;
 };
-export declare function guidedTrialAcquisitionEnabled(env?: Record<string, string | undefined>): boolean;
 export declare function isGuidedTrialSubscription(metadata: Record<string, unknown> | null | undefined): boolean;
 export type GuidedTrialBilling = {
     offer: typeof GUIDED_TRIAL_OFFER;
@@ -24,3 +24,11 @@ export type GuidedTrialBilling = {
     spendable_credits: number;
     funded_work_paused: boolean;
 };
+/** Read projection from native billing: a paid plan or a retained guided trial. */
+export type GuidedOnboardingEligibility = {
+    state: "unverified" | "checkout_required" | "checkout_pending" | "eligible" | "unavailable";
+    basis: "paid" | "trial" | null;
+    subscription_id: string | null;
+    observed_at: string | null;
+    trial_ends_at: string | null;
+};

package/node_modules/@oxygen/shared/dist/guided-trial-billing.js

@@ -1,5 +1,5 @@
-import { guidedActivationEnabled } from "./guided-activation.js";
-/** DEV onboarding offer. Existing subscription terms and production acquisition stay intact. */
+/** Retired DEV onboarding trial offer. New checkouts no longer create it; the
+ * marker still identifies subscriptions that were started under it. */
 export const GUIDED_TRIAL_OFFER = {
     key: "guided_onboarding_v2",
     plan: "oxygen_49",
@@ -11,9 +11,6 @@ export const GUIDED_TRIAL_OFFER = {
     card_required: true,
     early_charge_allowed: false,
 };
-export function guidedTrialAcquisitionEnabled(env = process.env) {
-    return guidedActivationEnabled(env);
-}
 export function isGuidedTrialSubscription(metadata) {
     return metadata?.oxygen_trial_offer === GUIDED_TRIAL_OFFER.key;
 }

package/node_modules/@oxygen/shared/dist/hosted-ai.js

@@ -195,7 +195,10 @@ export const HOSTED_AI_MODEL_REGISTRY = {
             reasoningEffort: "medium",
             estPromptUsdPerM: 0.1,
             estCompletionUsdPerM: 0.5,
-            maxOutputTokens: 4096,
+            // Reasoning tokens count against max_tokens: at 4,096 Haiku spent 3.5-4k
+            // thinking and returned no answer. Copilot's cap for the same model and
+            // effort. Spend admission uses AI_COLUMN_TIER_COGS_USD, not this ceiling.
+            maxOutputTokens: 16_384,
         },
         high: {
             model: "openai/gpt-6.1-sol",
@@ -204,7 +207,8 @@ export const HOSTED_AI_MODEL_REGISTRY = {
             reasoningEffort: "medium",
             estPromptUsdPerM: 2,
             estCompletionUsdPerM: 10,
-            maxOutputTokens: 4096,
+            // Reasoning counts against max_tokens, so Balanced's cap (see Balanced).
+            maxOutputTokens: 16_384,
         },
     },
     copilot: COPILOT_MODEL_SPECS,
@@ -279,8 +283,8 @@ export const KNOWLEDGE_BOOTSTRAP_SYNTHESIS_MODEL = {
     fallbackModels: ["openai/gpt-6-luna"],
     disableReasoning: true,
     // The profile plus the cited note of a well-documented company runs past the
-    // Balanced tier's 4,096: on dev (2026-10-18) attio.com and lemlist.com stopped at
-    // exactly 4,096 tokens (`finish_reason: length`), mid-note, as invalid JSON, so the
+    // Balanced tier's then 4,096: on dev (2026-10-18) attio.com and lemlist.com stopped
+    // at exactly 4,096 tokens (`finish_reason: length`), mid-note, as invalid JSON, so the
     // run ended `partial` with no research page. A shorter answer is unaffected.
     maxOutputTokens: 8192,
     // The same model ran 3x apart by provider on dev (2026-10-18): DigitalOcean and

package/node_modules/@oxygen/shared/dist/knowledge-bootstrap.d.ts

@@ -256,6 +256,12 @@ export type KnowledgeBootstrapConsent = {
     source: string | null;
     /** Clerk user who accepted, when the surface knows. Informational. */
     granted_by_clerk_user_id: string | null;
+    /**
+     * `agent`: agent-led onboarding (Philipp, 2026-10-19). The Oxygent researches the
+     * company in the chat with its sub-agents, so the automatic background pass and
+     * the brain draft do not run; a manual request still does.
+     */
+    research?: "agent";
 };
 /**
  * Read consent out of an organization's control-DB metadata blob, FAIL-CLOSED.

package/node_modules/@oxygen/shared/dist/knowledge-bootstrap.js

@@ -243,6 +243,7 @@ function readGrant(raw) {
             ...(creatorLinkedinUrl ? { creator_linkedin_url: creatorLinkedinUrl } : {}),
             source: typeof record.source === "string" && record.source.length > 0 ? record.source : null,
             granted_by_clerk_user_id: grantedBy,
+            ...(record.research === "agent" ? { research: "agent" } : {}),
         },
     };
 }