@oxygen-agent/cli 1.1014.1138 → 1.1014.1221

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

@@ -521,7 +521,14 @@ export const S42_REVEAL_PRICE_RISES = [
 // price per hit rises, so the whole change waits for the switch. Lanes named
 // outside the default chain keep their own price, and a direct tool call keeps
 // its tool price (P-34). `pricing-resolver.ts` (@oxygen/integrations) applies
-// it; a test there pins the flat price to the pricing seed.
+// it; a test there pins the flat price to the pricing seed. The 5 holds while
+// the managed LinkedIn rail runs on Up2Data; on HarvestAPI the resolver charges
+// 5x that lookup's worst case instead (Philipp 2026-10-17), and passes the
+// matching text to `describeRepricingSchedule` through `descriptions`.
+/** The customer-facing sentence for the flat LinkedIn URL price, at `credits`. */
+export function linkedinUrlFlatPriceDescription(credits) {
+    return `A LinkedIn URL costs a flat ${credits} credits when one is found that matches the person, and nothing when none is found, instead of each provider's price on every attempt.`;
+}
 /** Whether the LinkedIn-URL waterfall bills a flat price per URL found. */
 export const LINKEDIN_URL_FLAT_PRICE_REPRICING = defineRepricedValue({
     key: "enrichment.linkedin_url_priced_per_found_url",
@@ -529,7 +536,7 @@ export const LINKEDIN_URL_FLAT_PRICE_REPRICING = defineRepricedValue({
     slice: "S43",
     decision: "4.2",
     unit: "boolean",
-    description: `A LinkedIn URL costs a flat ${SNAPSHOT_LINKEDIN_URL_FOUND_CREDITS} credits when one is found that matches the person, and nothing when none is found, instead of each provider's price on every attempt.`,
+    description: linkedinUrlFlatPriceDescription(SNAPSHOT_LINKEDIN_URL_FOUND_CREDITS),
     before: false,
     after: true,
 });
@@ -537,7 +544,12 @@ export const LINKEDIN_URL_FLAT_PRICE_REPRICING = defineRepricedValue({
 export function linkedinUrlFlatPriceInForce(options = {}) {
     return repricedValue(LINKEDIN_URL_FLAT_PRICE_REPRICING, options);
 }
-/** The flat price of one LinkedIn URL found, in credits (the pricing seed's `enrichment.linkedin_url_found`). */
+/**
+ * The flat price of one LinkedIn URL found while the managed LinkedIn rail runs
+ * on Up2Data, in credits (the pricing seed's `enrichment.linkedin_url_found`).
+ * Billing reads `linkedinUrlFoundCreditsForBackend()` in pricing-resolver.ts,
+ * which follows the supplier switch.
+ */
 export function linkedinUrlFoundCredits() {
     return SNAPSHOT_LINKEDIN_URL_FOUND_CREDITS;
 }
@@ -673,7 +685,7 @@ export function describeRepricingSchedule(options = {}) {
             key: entry.key,
             kind: entry.kind,
             unit: entry.unit,
-            description: entry.description,
+            description: options.descriptions?.[entry.key] ?? entry.description,
             value_in_force: inForce ? entry.after : entry.before,
             value_before: entry.before,
             value_after: entry.after,

package/node_modules/@oxygen/shared/dist/research-findings.d.ts

@@ -0,0 +1,80 @@
+export declare const RESEARCH_FINDING_ACTIVITY_TYPE = "research_finding";
+export type ResearchFindingActivityType = typeof RESEARCH_FINDING_ACTIVITY_TYPE;
+export declare const RESEARCH_FINDING_EVENT_DEFINITION: {
+    readonly key: "research_finding";
+    readonly label: "Research finding";
+    readonly group: "Research";
+};
+/** What a claim is about. Each class has its own shelf life. */
+export declare const RESEARCH_FINDING_CLASSES: readonly ["role", "interest", "stated_need", "company", "other"];
+export type ResearchFindingClass = (typeof RESEARCH_FINDING_CLASSES)[number];
+/** Default shelf life in days when the writer gives no `expires_at`. */
+export declare const RESEARCH_FINDING_TTL_DAYS: Readonly<Record<ResearchFindingClass, number>>;
+export declare const RESEARCH_FINDING_SOURCE_KINDS: readonly ["message", "activity", "url"];
+export type ResearchFindingSourceKind = (typeof RESEARCH_FINDING_SOURCE_KINDS)[number];
+/** Longest claim a finding stores (`summary`). */
+export declare const RESEARCH_FINDING_MAX_CLAIM_CHARS = 500;
+export type ResearchFindingMetadata = {
+    source_kind: ResearchFindingSourceKind;
+    /** Exactly one of these three, matching `source_kind`. */
+    message_id?: string;
+    activity_id?: string;
+    source_url?: string;
+    /** 0..1. */
+    confidence: number;
+    observed_at: string;
+    expires_at: string;
+    class: ResearchFindingClass;
+};
+/**
+ * Validate a finding's claim and metadata and fill the derived fields.
+ * `expires_at` defaults to observed_at plus the class's shelf life. Unknown
+ * metadata keys are kept, so a writer can add its own provenance.
+ */
+export declare function normalizeResearchFinding(input: {
+    claim: unknown;
+    metadata: unknown;
+}, now?: Date): {
+    claim: string;
+    metadata: ResearchFindingMetadata & Record<string, unknown>;
+};
+/** `message:<id>`, `activity:<id>` or `url:<url>`: the one source a finding cites. */
+export declare function researchFindingSourceRef(metadata: Pick<ResearchFindingMetadata, "source_kind" | "message_id" | "activity_id" | "source_url">): string;
+/** The ids a model actually saw. A message or activity finding must cite one of them. */
+export type ResearchFindingCitationScope = {
+    messageIds?: Iterable<string>;
+    activityIds?: Iterable<string>;
+};
+/**
+ * The citation check: keep a finding only when the message or activity it
+ * cites was in the model's input. URL findings carry their own source and pass.
+ */
+export declare function partitionCitedFindings<T extends {
+    metadata: Pick<ResearchFindingMetadata, "source_kind" | "message_id" | "activity_id">;
+}>(findings: readonly T[], scope: ResearchFindingCitationScope): {
+    cited: T[];
+    uncited: T[];
+};
+/** Whether a finding has passed its shelf life (the brief shows it as stale). */
+export declare function researchFindingIsStale(metadata: {
+    expires_at?: unknown;
+}, now?: Date): boolean;
+/** Most facts the reply classifier keeps from one inbound message. */
+export declare const MAX_STATED_FACTS_PER_REPLY = 3;
+/** A fact the prospect stated in one inbound message, cited to that message. */
+export type ConversationStatedFact = {
+    claim: string;
+    class: ResearchFindingClass;
+    confidence: number;
+    message_id: string;
+};
+/**
+ * Read the classifier's `stated_facts` answer: at most 3 well-formed facts,
+ * each citing `messageId` (the one inbound message the model was given). Every
+ * other entry is dropped and counted, so a fact citing a message the model
+ * never saw can never reach the timeline.
+ */
+export declare function normalizeStatedFacts(raw: unknown, messageId: string): {
+    facts: ConversationStatedFact[];
+    rejected: number;
+};

package/node_modules/@oxygen/shared/dist/research-findings.js

@@ -0,0 +1,199 @@
+// Research findings (Network Mining S8b): one append-only `research_finding`
+// activity per claim on a Records timeline, cited to the message, activity or
+// web page it came from. Conflicting claims coexist; a finding is never edited,
+// it expires. The kind is DEV-only behind `networkMiningEnabled`, so it stays out
+// of CRM_ACTIVITY_EVENT_DEFINITIONS (the production writer allowlist and event
+// catalog) and out of CRM_SIGNAL_ACTIVITY_TYPES: a finding is evidence, never
+// intent.
+import { OxygenError } from "./cli-result.js";
+export const RESEARCH_FINDING_ACTIVITY_TYPE = "research_finding";
+export const RESEARCH_FINDING_EVENT_DEFINITION = {
+    key: RESEARCH_FINDING_ACTIVITY_TYPE,
+    label: "Research finding",
+    group: "Research",
+};
+/** What a claim is about. Each class has its own shelf life. */
+export const RESEARCH_FINDING_CLASSES = ["role", "interest", "stated_need", "company", "other"];
+/** Default shelf life in days when the writer gives no `expires_at`. */
+export const RESEARCH_FINDING_TTL_DAYS = {
+    role: 180,
+    interest: 90,
+    stated_need: 60,
+    company: 180,
+    other: 60,
+};
+export const RESEARCH_FINDING_SOURCE_KINDS = ["message", "activity", "url"];
+/** Longest claim a finding stores (`summary`). */
+export const RESEARCH_FINDING_MAX_CLAIM_CHARS = 500;
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const CLOCK_SKEW_MS = 5 * 60_000;
+const DAY_MS = 86_400_000;
+function invalid(problems) {
+    return new OxygenError("invalid_research_finding", `Invalid research finding: ${problems.join("; ")}.`, {
+        details: { problems, required: ["source_kind", "confidence", "observed_at", "class"] },
+        exitCode: 2,
+    });
+}
+function isoOrNull(value) {
+    if (typeof value !== "string" || !value.trim())
+        return null;
+    const parsed = new Date(value);
+    return Number.isNaN(parsed.getTime()) ? null : parsed;
+}
+/**
+ * Validate a finding's claim and metadata and fill the derived fields.
+ * `expires_at` defaults to observed_at plus the class's shelf life. Unknown
+ * metadata keys are kept, so a writer can add its own provenance.
+ */
+export function normalizeResearchFinding(input, now = new Date()) {
+    const problems = [];
+    const claim = typeof input.claim === "string" ? input.claim.trim() : "";
+    if (!claim)
+        problems.push("summary (the claim) is required");
+    else if (claim.length > RESEARCH_FINDING_MAX_CLAIM_CHARS)
+        problems.push(`summary is longer than ${RESEARCH_FINDING_MAX_CLAIM_CHARS} characters`);
+    const raw = input.metadata && typeof input.metadata === "object" && !Array.isArray(input.metadata)
+        ? input.metadata
+        : {};
+    const sourceKind = raw.source_kind;
+    const refs = { message: raw.message_id, activity: raw.activity_id, url: raw.source_url };
+    if (!RESEARCH_FINDING_SOURCE_KINDS.includes(sourceKind)) {
+        problems.push(`source_kind must be one of ${RESEARCH_FINDING_SOURCE_KINDS.join(", ")}`);
+    }
+    else {
+        const kind = sourceKind;
+        const ref = refs[kind];
+        if (kind === "url") {
+            let url = null;
+            try {
+                url = typeof ref === "string" ? new URL(ref) : null;
+            }
+            catch {
+                url = null;
+            }
+            if (!url || (url.protocol !== "https:" && url.protocol !== "http:"))
+                problems.push("source_url must be an http(s) URL");
+        }
+        else if (typeof ref !== "string" || !UUID.test(ref)) {
+            problems.push(`${kind}_id must be the cited ${kind}'s id`);
+        }
+        for (const other of RESEARCH_FINDING_SOURCE_KINDS) {
+            if (other !== kind && refs[other] !== undefined && refs[other] !== null) {
+                problems.push(`a ${kind} finding cites only its ${kind === "url" ? "source_url" : `${kind}_id`}`);
+                break;
+            }
+        }
+    }
+    const confidence = raw.confidence;
+    if (typeof confidence !== "number" || !Number.isFinite(confidence) || confidence < 0 || confidence > 1) {
+        problems.push("confidence must be a number from 0 to 1");
+    }
+    const findingClass = raw.class;
+    if (!RESEARCH_FINDING_CLASSES.includes(findingClass)) {
+        problems.push(`class must be one of ${RESEARCH_FINDING_CLASSES.join(", ")}`);
+    }
+    const observedAt = isoOrNull(raw.observed_at);
+    if (!observedAt)
+        problems.push("observed_at must be an ISO-8601 timestamp");
+    else if (observedAt.getTime() > now.getTime() + CLOCK_SKEW_MS)
+        problems.push("observed_at is in the future");
+    let expiresAt = null;
+    if (raw.expires_at !== undefined && raw.expires_at !== null) {
+        expiresAt = isoOrNull(raw.expires_at);
+        if (!expiresAt)
+            problems.push("expires_at must be an ISO-8601 timestamp");
+        else if (observedAt && expiresAt.getTime() <= observedAt.getTime())
+            problems.push("expires_at must be after observed_at");
+    }
+    if (problems.length > 0)
+        throw invalid(problems);
+    const kind = sourceKind;
+    const cls = findingClass;
+    const observed = observedAt;
+    const expires = expiresAt ?? new Date(observed.getTime() + RESEARCH_FINDING_TTL_DAYS[cls] * DAY_MS);
+    const { message_id: _m, activity_id: _a, source_url: _u, ...rest } = raw;
+    return {
+        claim,
+        metadata: {
+            ...rest,
+            source_kind: kind,
+            ...(kind === "message" ? { message_id: String(refs.message).toLowerCase() } : {}),
+            ...(kind === "activity" ? { activity_id: String(refs.activity).toLowerCase() } : {}),
+            ...(kind === "url" ? { source_url: String(refs.url) } : {}),
+            confidence: confidence,
+            observed_at: observed.toISOString(),
+            expires_at: expires.toISOString(),
+            class: cls,
+        },
+    };
+}
+/** `message:<id>`, `activity:<id>` or `url:<url>`: the one source a finding cites. */
+export function researchFindingSourceRef(metadata) {
+    if (metadata.source_kind === "message")
+        return `message:${metadata.message_id ?? ""}`;
+    if (metadata.source_kind === "activity")
+        return `activity:${metadata.activity_id ?? ""}`;
+    return `url:${metadata.source_url ?? ""}`;
+}
+/**
+ * The citation check: keep a finding only when the message or activity it
+ * cites was in the model's input. URL findings carry their own source and pass.
+ */
+export function partitionCitedFindings(findings, scope) {
+    const messages = new Set([...(scope.messageIds ?? [])].map((id) => id.toLowerCase()));
+    const activities = new Set([...(scope.activityIds ?? [])].map((id) => id.toLowerCase()));
+    const cited = [];
+    const uncited = [];
+    for (const finding of findings) {
+        const { source_kind: kind, message_id: messageId, activity_id: activityId } = finding.metadata;
+        const ok = kind === "url"
+            || (kind === "message" && typeof messageId === "string" && messages.has(messageId.toLowerCase()))
+            || (kind === "activity" && typeof activityId === "string" && activities.has(activityId.toLowerCase()));
+        (ok ? cited : uncited).push(finding);
+    }
+    return { cited, uncited };
+}
+/** Whether a finding has passed its shelf life (the brief shows it as stale). */
+export function researchFindingIsStale(metadata, now = new Date()) {
+    const expires = isoOrNull(metadata.expires_at);
+    return expires !== null && expires.getTime() <= now.getTime();
+}
+/** Most facts the reply classifier keeps from one inbound message. */
+export const MAX_STATED_FACTS_PER_REPLY = 3;
+const MAX_STATED_FACT_CHARS = 280;
+/**
+ * Read the classifier's `stated_facts` answer: at most 3 well-formed facts,
+ * each citing `messageId` (the one inbound message the model was given). Every
+ * other entry is dropped and counted, so a fact citing a message the model
+ * never saw can never reach the timeline.
+ */
+export function normalizeStatedFacts(raw, messageId) {
+    if (!Array.isArray(raw))
+        return { facts: [], rejected: 0 };
+    const shaped = [];
+    let rejected = 0;
+    for (const entry of raw) {
+        const value = entry && typeof entry === "object" ? entry : {};
+        const claim = typeof value.claim === "string" ? value.claim.trim().replace(/\s+/g, " ") : "";
+        const cls = value.class;
+        const confidence = typeof value.confidence === "number" && Number.isFinite(value.confidence)
+            ? Math.min(1, Math.max(0, value.confidence))
+            : null;
+        const cited = typeof value.message_id === "string" ? value.message_id.trim() : "";
+        if (!claim || claim.length > MAX_STATED_FACT_CHARS || confidence === null
+            || !RESEARCH_FINDING_CLASSES.includes(cls)) {
+            rejected += 1;
+            continue;
+        }
+        shaped.push({
+            claim, class: cls, confidence, message_id: cited.toLowerCase(),
+            metadata: { source_kind: "message", message_id: cited },
+        });
+    }
+    const { cited, uncited } = partitionCitedFindings(shaped, { messageIds: [messageId] });
+    const kept = cited.slice(0, MAX_STATED_FACTS_PER_REPLY);
+    return {
+        facts: kept.map(({ metadata: _metadata, ...fact }) => fact),
+        rejected: rejected + uncited.length + (cited.length - kept.length),
+    };
+}

package/node_modules/@oxygen/shared/dist/sequence-internals/esp-policy.d.ts

@@ -185,6 +185,8 @@ export declare function isEspGatewayFamily(family: RecipientEspFamily | null | u
  * family → esp is decided, so display and matching can't drift.
  */
 export declare function matchableEspFromFamily(family: RecipientEspFamily | null | undefined): RecipientEsp | null;
+/** The deterministic consumer-domain table, for readers that classify recipient domains in SQL. */
+export declare function consumerRecipientDomainFamilies(): ReadonlyArray<readonly [string, RecipientEspFamily]>;
 /**
  * Map a domain's resolved MX exchange hostnames to a DISPLAY family. Returns null
  * when no host matches any known vendor — the caller records that as

package/node_modules/@oxygen/shared/dist/sequence-internals/esp-policy.js

@@ -417,6 +417,10 @@ const CONSUMER_DOMAIN_FAMILIES = new Map([
     ["gmx.de", "gmx"],
     ["web.de", "gmx"],
 ]);
+/** The deterministic consumer-domain table, for readers that classify recipient domains in SQL. */
+export function consumerRecipientDomainFamilies() {
+    return [...CONSUMER_DOMAIN_FAMILIES];
+}
 /**
  * Normalize a recipient domain: lowercase, trim, drop a trailing FQDN dot, and if
  * a full address is passed take the part after the last '@'. Returns "" for junk.

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

@@ -851,6 +851,12 @@ export declare function sequenceLinkedInOwnerConflicts(steps: readonly SequenceS
     stepId: string;
     message: string;
 }[];
+/**
+ * A comment_post step with an ai_prompt drafts its comment with a paid AI run
+ * at send time. That run bills the organization, not the sequence's
+ * max_credits reservation, so a 0-credit ceiling cannot block it.
+ */
+export declare function sequenceStepsDraftAiComments(steps: readonly SequenceStep[]): boolean;
 export declare function sequenceStepsMissingCopy(steps: readonly SequenceStep[]): SequenceMissingCopy[];
 /**
  * Validate + normalize a raw sequence definition. Assigns stable ids to steps

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

@@ -571,6 +571,14 @@ function sequenceLinkedInOwnerNotice(steps) {
         message: `Saved as a draft, but it cannot launch yet: LinkedIn connection, message, InMail and withdraw steps must all name the same sender_profile_id, or none (${named.join(", ")}). LinkedIn lets one of your accounts hold a conversation with a lead. To have one person send all of them, name that person on each; to keep every lead's own person, remove it from all.`,
     };
 }
+/**
+ * A comment_post step with an ai_prompt drafts its comment with a paid AI run
+ * at send time. That run bills the organization, not the sequence's
+ * max_credits reservation, so a 0-credit ceiling cannot block it.
+ */
+export function sequenceStepsDraftAiComments(steps) {
+    return steps.some((step) => step.kind === "comment_post" && Boolean(step.ai_prompt?.trim()));
+}
 export function sequenceStepsMissingCopy(steps) {
     const missing = [];
     const check = (step, field, value) => {

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

@@ -14,6 +14,18 @@ export function capabilityDiscoveryRecovery(query, surface) {
 // connection routes.
 export function inferUserCapabilityRoute(query) {
     const normalized = query.toLowerCase().replace(/[_-]+/g, " ");
+    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");
+        if (route) {
+            const recommendedTools = ["oxygen_oxygents_list", "oxygen_inbox_reply_oxygent_get", "oxygen_inbox_reply_oxygent_configure", "oxygen_oxygents_create"];
+            const recommendedCommands = ["oxygents list", "inbox reply-oxygent get", "inbox reply-oxygent configure", "oxygents create"];
+            return { ...route, recommendedTools, recommendedCommands, card: { ...route.card,
+                    posture: "mixed", gatewayTools: recommendedTools, gatewayCommands: recommendedCommands,
+                    execution: "Dev only: select your owned Oxygent with oxygents list, or create one with oxygents create --template reply, then configure. get requires agent_slug or batch_id. Caller-written sender voice and drafts use approved inference budgets; saving makes no model call. Exact batches of 10–30 (or a smaller remainder) need human approval before real sends. Discovery starts no routine or send.",
+                } };
+        }
+    }
     const journeyAction = savedOnboardingJourneyAction(normalized);
     if (journeyAction) {
         const route = getCapabilityRouteMatch("agents");
@@ -216,7 +228,7 @@ function isGuidedOnboardingDiscoveryIntent(query) {
     if (!/\bonboarding\b/.test(query)
         || /\b(?:invite|members?|membership|permissions?|roles?|human|colleague|coworker|delete|destroy|wipe|paid)\b/.test(query))
         return false;
-    if (/^(?:guided )?onboarding$/.test(query.trim()))
+    if (/^(?:guided )?onboarding(?: journey)?$/.test(query.trim()))
         return true;
     return /\b(?:first sourcing|daily rhythm)\b/.test(query)
         || (/\b(?:guide|guided|journey|part [12])\b/.test(query)
@@ -349,15 +361,20 @@ function oxygentsRoute(normalized) {
     const contentRead = /\b(?:read|see|view|show|transcript)\b/.test(normalized)
         || (/\bhistory\b/.test(normalized) && !historyContract);
     const contentSend = /\b(?:messages?|ask|tell|send|talk|continue|resume|handoff|delegat\w*)\b|\b(?:chat with|hand\w* off)\b/.test(normalized);
+    const visibilityUpdate = /\bvisibility\b/.test(normalized)
+        && /\b(?:confirm visibility|updat\w*|chang\w*)\b/.test(normalized);
     if (!group && privacy && ((verb === "list" && !rosterRead) || verb === "create"
         || (verb === "update" && /\bvisibility\b/.test(normalized))
+        || ((verb === "access" || verb === "share") && visibilityUpdate && !contentRead && !contentSend && !rosterRead)
         || (verb === "get" && !contentRead) || (verb === "message" && !contentSend))) {
         return inferCapabilityRoute(normalized);
     }
     // Sharing is read and changed as a pair: who has access, then share.
     const pair = verb === "share" ? ["access"] : verb === "access" ? ["share"] : [];
-    // A group's id comes from its list; the roster reads follow every ask.
-    const verbs = [...new Set([verb, ...pair, ...(group ? ["groups"] : []), "list", "get"])];
+    // Access/share are metadata operations. Do not suggest chat previews just
+    // to configure their audience. Group and content asks keep their own reads.
+    const metadataOnly = !group && (verb === "access" || verb === "share");
+    const verbs = [...new Set([verb, ...pair, ...(group ? ["groups"] : []), ...(metadataOnly ? [] : ["list", "get"])])];
     return {
         ...route,
         recommendedTools: verbs.map((name) => `oxygen_oxygents_${name}`),

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

@@ -1 +1 @@
-export declare const OXYGEN_BUILD_VERSION = "1.1014.1138";
+export declare const OXYGEN_BUILD_VERSION = "1.1014.1221";

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.1138";
+export const OXYGEN_BUILD_VERSION = "1.1014.1221";

package/node_modules/@oxygen/shared/dist/workspace-event-catalog.d.ts

@@ -1,8 +1,8 @@
 import { CRM_SIGNAL_WORKFLOW_EVENT_DEFINITIONS } from "./crm-reply-events.js";
-export declare const WORKSPACE_EVENT_PRODUCER_READINESS_REQUIREMENTS: readonly ["always", "notetaker_enabled"];
+export declare const WORKSPACE_EVENT_PRODUCER_READINESS_REQUIREMENTS: readonly ["always", "notetaker_enabled", "blacklist_monitoring_active"];
 export type WorkspaceEventProducerReadinessRequirement = (typeof WORKSPACE_EVENT_PRODUCER_READINESS_REQUIREMENTS)[number];
 export type CrmSignalWorkflowEvent = (typeof CRM_SIGNAL_WORKFLOW_EVENT_DEFINITIONS)[number]["event"];
-export type WorkspaceEventProducerId = "sequencer.contact_activity" | "sequencer.enrollment_terminal" | "crm.activity_created" | `crm.${CrmSignalWorkflowEvent}` | "notetaker.meeting_completed" | "plain_support.message_received";
+export type WorkspaceEventProducerId = "sequencer.contact_activity" | "sequencer.enrollment_terminal" | "crm.activity_created" | `crm.${CrmSignalWorkflowEvent}` | "notetaker.meeting_completed" | "deliverability.blacklist_listing_changed" | "plain_support.message_received";
 export type WorkspaceEventProducerDefinition = {
     /** Stable producer identity used by typed internal dispatchers. */
     id: WorkspaceEventProducerId;
@@ -50,3 +50,9 @@ export declare function findWorkspaceEventProducer(input: {
  * producer. Integration-specific subscriptions are merged in at request time.
  */
 export declare const WORKSPACE_EVENT_CATALOG: readonly WorkspaceEventCatalogEntry[];
+/**
+ * The catalog this deployment serves: WORKSPACE_EVENT_CATALOG, plus the DEV-only
+ * Network Mining presets where its gate is open. A gate-closed catalog is
+ * exactly WORKSPACE_EVENT_CATALOG.
+ */
+export declare function servedWorkspaceEventCatalog(env: Record<string, string | undefined>): readonly WorkspaceEventCatalogEntry[];

package/node_modules/@oxygen/shared/dist/workspace-event-catalog.js

@@ -3,9 +3,15 @@ import { CRM_SIGNAL_WORKFLOW_EVENT_DEFINITIONS, CRM_WORKFLOW_EVENT_SOURCE, } fro
 import { SEQUENCE_CONTACT_ACTIVITY_EVENT, SEQUENCE_CRM_EVENT_DEFINITIONS, SEQUENCE_WORKFLOW_EVENT_SOURCE, } from "./sequence-crm-events.js";
 import { SEQUENCE_ENROLLMENT_TERMINAL_EVENT, SEQUENCE_TERMINAL_EVENT_SOURCE, SEQUENCE_TERMINAL_STATUSES, } from "./sequence-terminal-events.js";
 import { NOTETAKER_MEETING_COMPLETED_EVENT, NOTETAKER_MEETING_COMPLETED_PAYLOAD_FIELDS, NOTETAKER_WORKFLOW_EVENT_SOURCE, } from "./notetaker-events.js";
+import { BLACKLIST_LISTING_CHANGED_EVENT, BLACKLIST_LISTING_CHANGED_PAYLOAD_FIELDS, DELIVERABILITY_WORKFLOW_EVENT_SOURCE, } from "./deliverability-blacklist.js";
+import { networkMiningEnabled } from "./network-mining.js";
+import { RESEARCH_FINDING_EVENT_DEFINITION } from "./research-findings.js";
 export const WORKSPACE_EVENT_PRODUCER_READINESS_REQUIREMENTS = [
     "always",
     "notetaker_enabled",
+    // A blacklist run in the workspace's ledger had a zone answer recently: the resolver is
+    // deployed and at least one domain zone is enabled (and keyed when licensed).
+    "blacklist_monitoring_active",
 ];
 export const WORKSPACE_EVENT_CATALOG_VERSION = 2;
 const sequenceActivityFields = [
@@ -106,6 +112,15 @@ export const WORKSPACE_EVENT_PRODUCERS = [
         readiness: "notetaker_enabled",
         payloadFields: NOTETAKER_MEETING_COMPLETED_PAYLOAD_FIELDS,
     },
+    {
+        id: "deliverability.blacklist_listing_changed",
+        source: DELIVERABILITY_WORKFLOW_EVENT_SOURCE,
+        event: BLACKLIST_LISTING_CHANGED_EVENT,
+        delivery: "transactional_outbox",
+        idempotency: "The blacklist run and zone identify the transition; the daily check commits it with the run.",
+        readiness: "blacklist_monitoring_active",
+        payloadFields: BLACKLIST_LISTING_CHANGED_PAYLOAD_FIELDS,
+    },
 ];
 const workspaceEventProducersById = new Map(WORKSPACE_EVENT_PRODUCERS.map((producer) => [producer.id, producer]));
 export function getWorkspaceEventProducer(producerId) {
@@ -133,6 +148,9 @@ function crmActivityDescription(key, label) {
     if (key === "meeting_booked") {
         return "A meeting-booked activity was added to a CRM record timeline, regardless of which producer logged it. Use the Sequencer preset for an outreach enrollment's own meeting outcome.";
     }
+    if (key === "placement_changed") {
+        return "Inbox placement for a sender domain at one receiver provider changed (inbox rate drop or Gmail Primary to Promotions). A workspace Signal with no CRM record; placement never pauses a sender.";
+    }
     return `A ${label.toLowerCase()} activity was added to a CRM timeline.`;
 }
 const sequenceActivityEntries = [
@@ -226,6 +244,30 @@ const notetakerEntries = [
         payloadFields: NOTETAKER_MEETING_COMPLETED_PAYLOAD_FIELDS,
     },
 ];
+const deliverabilityEntries = [
+    {
+        id: "deliverability.blacklist_listing_changed.listed",
+        producerId: "deliverability.blacklist_listing_changed",
+        source: DELIVERABILITY_WORKFLOW_EVENT_SOURCE,
+        event: BLACKLIST_LISTING_CHANGED_EVENT,
+        group: "Deliverability",
+        label: "Domain blacklisted",
+        description: "The daily blacklist check found a sending, tracking or link domain newly listed on a DNS blacklist.",
+        filters: [{ path: "transition", op: "eq", value: "listed" }],
+        payloadFields: BLACKLIST_LISTING_CHANGED_PAYLOAD_FIELDS,
+    },
+    {
+        id: "deliverability.blacklist_listing_changed.delisted",
+        producerId: "deliverability.blacklist_listing_changed",
+        source: DELIVERABILITY_WORKFLOW_EVENT_SOURCE,
+        event: BLACKLIST_LISTING_CHANGED_EVENT,
+        group: "Deliverability",
+        label: "Domain delisted",
+        description: "The daily blacklist check found a previously listed domain no longer listed on a DNS blacklist.",
+        filters: [{ path: "transition", op: "eq", value: "delisted" }],
+        payloadFields: BLACKLIST_LISTING_CHANGED_PAYLOAD_FIELDS,
+    },
+];
 /**
  * Every app-native workspace event that has a durable or explicitly callable
  * producer. Integration-specific subscriptions are merged in at request time.
@@ -236,4 +278,25 @@ export const WORKSPACE_EVENT_CATALOG = [
     ...crmActivityEntries,
     ...crmSignalEntries,
     ...notetakerEntries,
+    ...deliverabilityEntries,
 ];
+// Network Mining (DEV-only): a cited research finding landed on a record.
+const researchFindingEntry = {
+    id: `crm.activity_created.${RESEARCH_FINDING_EVENT_DEFINITION.key}`,
+    producerId: "crm.activity_created",
+    source: CRM_WORKFLOW_EVENT_SOURCE,
+    event: CRM_ACTIVITY_CREATED_EVENT,
+    group: `CRM · ${RESEARCH_FINDING_EVENT_DEFINITION.group}`,
+    label: RESEARCH_FINDING_EVENT_DEFINITION.label,
+    description: "A cited research finding (a claim with its source, confidence and expiry) was added to a CRM record timeline.",
+    filters: [{ path: "activity_type", op: "eq", value: RESEARCH_FINDING_EVENT_DEFINITION.key }],
+    payloadFields: crmActivityFields,
+};
+/**
+ * The catalog this deployment serves: WORKSPACE_EVENT_CATALOG, plus the DEV-only
+ * Network Mining presets where its gate is open. A gate-closed catalog is
+ * exactly WORKSPACE_EVENT_CATALOG.
+ */
+export function servedWorkspaceEventCatalog(env) {
+    return networkMiningEnabled(env) ? [...WORKSPACE_EVENT_CATALOG, researchFindingEntry] : WORKSPACE_EVENT_CATALOG;
+}

package/package.json

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