@oxygen-agent/cli 1.1014.1224 → 1.1014.1341

package/node_modules/@oxygen/shared/dist/agent-sessions.d.ts

@@ -1,4 +1,5 @@
 import type { GuidedActivationRoutine } from "./guided-activation.js";
+import { type WorkspaceEventCatalogEntry } from "./workspace-event-catalog.js";
 import { type AgentSessionSchedule } from "./agent-session-schedule.js";
 export type AgentSessionStatus = "draft" | "active" | "paused" | "budget_wait" | "completed" | "archived";
 export type AgentSessionResources = {
@@ -63,8 +64,10 @@ export declare const AGENT_SESSION_ADAPTERS: Readonly<Record<string, {
     fixed?: string;
     array?: boolean;
 }>>;
-export declare function isAgentSessionCapability(name: string): boolean;
-export declare function agentSessionCapabilityDecision(config: AgentSessionConfig, name: string, args: Record<string, unknown>): "allow" | "ask" | "deny";
+/** The adapters this deployment serves: the reviewed set, plus the Network Mining reads where it is open. */
+export declare function agentSessionAdapters(env?: Record<string, string | undefined>): Readonly<Record<string, (typeof AGENT_SESSION_ADAPTERS)[string]>>;
+export declare function isAgentSessionCapability(name: string, env?: Record<string, string | undefined>): boolean;
+export declare function agentSessionCapabilityDecision(config: AgentSessionConfig, name: string, args: Record<string, unknown>, env?: Record<string, string | undefined>): "allow" | "ask" | "deny";
 export declare const EMPTY_AGENT_SESSION_RESOURCES: AgentSessionResources;
 export declare const AGENT_SESSION_EVENT_RESOURCES: {
     readonly sequence_id: "sequences";
@@ -74,8 +77,25 @@ export declare const AGENT_SESSION_EVENT_RESOURCES: {
     readonly row_id: "records";
     readonly record_id: "records";
 };
-export declare const AGENT_SESSION_EVENTS: import("./workspace-event-catalog.js").WorkspaceEventCatalogEntry[];
-export declare function agentSessionEventIsScoped(config: AgentSessionConfig, payload: Record<string, unknown>): boolean;
+export declare const AGENT_SESSION_EVENTS: WorkspaceEventCatalogEntry[];
+/**
+ * The events a session may wake on here. Where Network Mining is open, a CRM timeline activity can too, through the
+ * records it links (S12); elsewhere this is AGENT_SESSION_EVENTS.
+ */
+export declare function agentSessionEvents(env?: Record<string, string | undefined>): readonly WorkspaceEventCatalogEntry[];
+export declare function agentSessionEventIsScoped(config: AgentSessionConfig, payload: Record<string, unknown>, env?: Record<string, string | undefined>): boolean;
+/**
+ * Focus learning (Network Mining S12, DEV-only): an unattended session over the warmest people in the focus rank. It
+ * wakes when one of them shows inbound activity and once a day, reads their brief (which carries the lineage of
+ * their enrollments), and may only append cited research findings and notes to them: every other write, and any
+ * write that would need a person's card, is refused. Its scope is the focus top-K when it was created, at most
+ * FOCUS_LEARNING_MAX_RECORDS people; it is created as a draft and runs only after a person activates it.
+ */
+export declare const FOCUS_LEARNING_TEMPLATE_ID = "focus-learning";
+export declare const FOCUS_LEARNING_DEFAULT_RECORDS = 10;
+export declare const FOCUS_LEARNING_MAX_RECORDS = 25;
+export declare const FOCUS_LEARNING_MAX_PER_RUN_CREDITS = 25;
+export declare const FOCUS_LEARNING_MAX_DAILY_CREDITS = 100;
 export declare const AGENT_SESSION_TEMPLATES: readonly [{
     readonly id: "campaign-monitor";
     readonly title: "Campaign monitor";
@@ -133,173 +153,14 @@ export declare const AGENT_SESSION_TEMPLATES: readonly [{
     readonly actions: readonly ["oxygen_crm_notes_add"];
     readonly events: readonly [];
 }];
-export declare function agentSessionTemplates(env?: Record<string, string | undefined>): ({
-    readonly id: "campaign-monitor";
-    readonly title: "Campaign monitor";
-    readonly goal: "Watch this native campaign. Compare sends, replies and meetings with earlier reviews; explain changes, propose improvements and schedule the next review.";
-    readonly resources: readonly ["sequences"];
-    readonly actions: readonly ["oxygen_sequences_set_status"];
-    readonly events: readonly ["sequencer.contact_activity.any"];
-} | {
-    readonly id: "lead-replenishment";
-    readonly title: "Lead replenishment";
-    readonly goal: "Maintain a qualified lead pool in the selected Table for this native campaign. Research gaps, deduplicate and enroll only qualified leads within the approved scope.";
-    readonly resources: readonly ["tables", "sequences"];
-    readonly actions: readonly ["oxygen_rows_upsert", "oxygen_sequences_enroll"];
-    readonly events: readonly [];
-} | {
-    readonly id: "reply-handling";
-    readonly title: "Reply handling";
-    readonly goal: "Review the selected conversations, remember prior responses, qualify intent and draft replies. Send only when explicitly authorized; hand off uncertain or sensitive replies.";
-    readonly resources: readonly ["conversations"];
-    readonly actions: readonly ["oxygen_inbox_set_status"];
-    readonly events: readonly ["crm.email_reply_classified"];
-} | {
-    readonly id: "deliverability";
-    readonly title: "Deliverability";
-    readonly goal: "Watch the selected mailboxes for sending health changes. Explain evidence and recommend or apply only approved cap and status adjustments.";
-    readonly resources: readonly ["mailboxes"];
-    readonly actions: readonly ["oxygen_mailboxes_set_cap", "oxygen_mailboxes_set_status"];
-    readonly events: readonly [];
-} | {
-    readonly id: "account-research";
-    readonly title: "Account research";
-    readonly goal: "Maintain cited account research for the selected records and knowledge pages. Track changes and recommend next actions; keep facts separate from hypotheses.";
-    readonly resources: readonly ["records", "knowledge"];
-    readonly actions: readonly ["oxygen_crm_notes_add", "oxygen_knowledge_page_upsert"];
-    readonly events: readonly [];
-} | {
-    readonly id: "inbound-qualification";
-    readonly title: "Inbound qualification";
-    readonly goal: "Qualify the selected inbound conversations and records against workspace ICP and product knowledge. Record evidence and recommendations; hand off high intent to a person.";
-    readonly resources: readonly ["conversations", "records"];
-    readonly actions: readonly ["oxygen_inbox_set_status", "oxygen_crm_notes_add"];
-    readonly events: readonly ["crm.email_reply_classified"];
-} | {
-    readonly id: "crm-hygiene";
-    readonly title: "CRM hygiene";
-    readonly goal: "Review the selected CRM objects for duplicates and missing or inconsistent fields. Propose repairs with evidence, and apply only explicitly authorized changes.";
-    readonly resources: readonly ["objects"];
-    readonly actions: readonly ["oxygen_crm_merge"];
-    readonly events: readonly [];
-} | {
-    readonly id: "pipeline-review";
-    readonly title: "Pipeline review";
-    readonly goal: "Review the selected pipeline and lifecycle stages. Remember earlier reviews, identify stalled opportunities and recommend the next action with evidence.";
-    readonly resources: readonly ["objects", "records"];
-    readonly actions: readonly ["oxygen_crm_notes_add"];
-    readonly events: readonly [];
-} | {
-    id: "campaign-monitor";
-    title: "Campaign monitor";
-    resources: readonly ["sequences"];
-    actions: readonly ["oxygen_sequences_set_status"];
-    events: readonly ["sequencer.contact_activity.any"];
-    goal: string;
-} | {
-    id: "lead-replenishment";
-    title: "Lead replenishment";
-    resources: readonly ["tables", "sequences"];
-    actions: readonly ["oxygen_rows_upsert", "oxygen_sequences_enroll"];
-    events: readonly [];
-    goal: string;
-} | {
-    id: "reply-handling";
-    title: "Reply handling";
-    resources: readonly ["conversations"];
-    actions: readonly ["oxygen_inbox_set_status"];
-    events: readonly ["crm.email_reply_classified"];
-    goal: string;
-} | {
-    id: "deliverability";
-    title: "Deliverability";
-    resources: readonly ["mailboxes"];
-    actions: readonly ["oxygen_mailboxes_set_cap", "oxygen_mailboxes_set_status"];
-    events: readonly [];
-    goal: string;
-} | {
-    id: "account-research";
-    title: "Account research";
-    resources: readonly ["records", "knowledge"];
-    actions: readonly ["oxygen_crm_notes_add", "oxygen_knowledge_page_upsert"];
-    events: readonly [];
-    goal: string;
-} | {
-    id: "inbound-qualification";
-    title: "Inbound qualification";
-    resources: readonly ["conversations", "records"];
-    actions: readonly ["oxygen_inbox_set_status", "oxygen_crm_notes_add"];
-    events: readonly ["crm.email_reply_classified"];
-    goal: string;
-} | {
-    id: "crm-hygiene";
-    title: "CRM hygiene";
-    resources: readonly ["objects"];
-    actions: readonly ["oxygen_crm_merge"];
-    events: readonly [];
-    goal: string;
-} | {
-    id: "pipeline-review";
-    title: "Pipeline review";
-    resources: readonly ["objects", "records"];
-    actions: readonly ["oxygen_crm_notes_add"];
-    events: readonly [];
+type AgentSessionTemplate = {
+    id: string;
+    title: string;
     goal: string;
-})[] | readonly [{
-    readonly id: "campaign-monitor";
-    readonly title: "Campaign monitor";
-    readonly goal: "Watch this native campaign. Compare sends, replies and meetings with earlier reviews; explain changes, propose improvements and schedule the next review.";
-    readonly resources: readonly ["sequences"];
-    readonly actions: readonly ["oxygen_sequences_set_status"];
-    readonly events: readonly ["sequencer.contact_activity.any"];
-}, {
-    readonly id: "lead-replenishment";
-    readonly title: "Lead replenishment";
-    readonly goal: "Maintain a qualified lead pool in the selected Table for this native campaign. Research gaps, deduplicate and enroll only qualified leads within the approved scope.";
-    readonly resources: readonly ["tables", "sequences"];
-    readonly actions: readonly ["oxygen_rows_upsert", "oxygen_sequences_enroll"];
-    readonly events: readonly [];
-}, {
-    readonly id: "reply-handling";
-    readonly title: "Reply handling";
-    readonly goal: "Review the selected conversations, remember prior responses, qualify intent and draft replies. Send only when explicitly authorized; hand off uncertain or sensitive replies.";
-    readonly resources: readonly ["conversations"];
-    readonly actions: readonly ["oxygen_inbox_set_status"];
-    readonly events: readonly ["crm.email_reply_classified"];
-}, {
-    readonly id: "deliverability";
-    readonly title: "Deliverability";
-    readonly goal: "Watch the selected mailboxes for sending health changes. Explain evidence and recommend or apply only approved cap and status adjustments.";
-    readonly resources: readonly ["mailboxes"];
-    readonly actions: readonly ["oxygen_mailboxes_set_cap", "oxygen_mailboxes_set_status"];
-    readonly events: readonly [];
-}, {
-    readonly id: "account-research";
-    readonly title: "Account research";
-    readonly goal: "Maintain cited account research for the selected records and knowledge pages. Track changes and recommend next actions; keep facts separate from hypotheses.";
-    readonly resources: readonly ["records", "knowledge"];
-    readonly actions: readonly ["oxygen_crm_notes_add", "oxygen_knowledge_page_upsert"];
-    readonly events: readonly [];
-}, {
-    readonly id: "inbound-qualification";
-    readonly title: "Inbound qualification";
-    readonly goal: "Qualify the selected inbound conversations and records against workspace ICP and product knowledge. Record evidence and recommendations; hand off high intent to a person.";
-    readonly resources: readonly ["conversations", "records"];
-    readonly actions: readonly ["oxygen_inbox_set_status", "oxygen_crm_notes_add"];
-    readonly events: readonly ["crm.email_reply_classified"];
-}, {
-    readonly id: "crm-hygiene";
-    readonly title: "CRM hygiene";
-    readonly goal: "Review the selected CRM objects for duplicates and missing or inconsistent fields. Propose repairs with evidence, and apply only explicitly authorized changes.";
-    readonly resources: readonly ["objects"];
-    readonly actions: readonly ["oxygen_crm_merge"];
-    readonly events: readonly [];
-}, {
-    readonly id: "pipeline-review";
-    readonly title: "Pipeline review";
-    readonly goal: "Review the selected pipeline and lifecycle stages. Remember earlier reviews, identify stalled opportunities and recommend the next action with evidence.";
-    readonly resources: readonly ["objects", "records"];
-    readonly actions: readonly ["oxygen_crm_notes_add"];
-    readonly events: readonly [];
-}];
-export declare function validateAgentSessionConfig(config: AgentSessionConfig, requireResources?: boolean): void;
+    resources: readonly string[];
+    actions: readonly string[];
+    events: readonly string[];
+};
+export declare function agentSessionTemplates(env?: Record<string, string | undefined>): readonly AgentSessionTemplate[];
+export declare function validateAgentSessionConfig(config: AgentSessionConfig, requireResources?: boolean, env?: Record<string, string | undefined>): void;
+export {};

package/node_modules/@oxygen/shared/dist/agent-sessions.js

@@ -5,7 +5,8 @@ import { validateContract } from "./contracts/schema.js";
 import { GUIDED_ACTIVATION_SCAN_POLICY_CONTRACT } from "./contracts/guided-activation.js";
 import { isStaffEmail } from "./staff.js";
 import { OxygenError } from "./cli-result.js";
-import { WORKSPACE_EVENT_CATALOG } from "./workspace-event-catalog.js";
+import { RESEARCH_FINDING_ACTIVITY_TYPE } from "./research-findings.js";
+import { servedWorkspaceEventCatalog, WORKSPACE_EVENT_CATALOG } from "./workspace-event-catalog.js";
 import { agentSessionScheduleProblem } from "./agent-session-schedule.js";
 /** The routine marker of a session's settings, or null for a general session. */
 export function agentSessionTeammateRoutine(config) {
@@ -43,6 +44,9 @@ export const AGENT_SESSION_ADAPTERS = {
     oxygen_sequences_analytics: { resource: "sequences", field: "sequence", read: true },
     oxygen_sequences_contacts: { resource: "sequences", field: "sequence", read: true },
     oxygen_sequences_enrollments: { resource: "sequences", field: "sequence", read: true },
+    oxygen_sequences_events: { resource: "sequences", field: "sequence", read: true },
+    // Email messages of one campaign; one record's messages are the gated `record` scope below.
+    oxygen_messages_query: { resource: "sequences", field: "sequence_id", read: true },
     oxygen_sequences_enroll: { resource: "sequences", field: "sequence", read: false },
     oxygen_sequences_set_status: { resource: "sequences", field: "sequence", read: false },
     oxygen_tables_describe: { resource: "tables", field: "table", read: true },
@@ -72,17 +76,41 @@ export const AGENT_SESSION_ADAPTERS = {
     oxygen_knowledge_page_upsert: { resource: "knowledge", field: "page.slug", read: false },
     oxygen_find_company: { resource: "domains", field: "domain", read: false },
 };
+/**
+ * Reviewed adapters served only where Network Mining is: the brief exists only there, and an activity log from a
+ * session may only append a cited research finding (S12).
+ */
+const NETWORK_MINING_SESSION_ADAPTERS = {
+    oxygen_crm_record_brief: { resource: "records", field: "row_id", read: true },
+    oxygen_crm_activity_log: { resource: "records", field: "row_id", read: false },
+};
+const defaultEnv = () => (typeof process === "undefined" ? {} : process.env);
+/** The adapters this deployment serves: the reviewed set, plus the Network Mining reads where it is open. */
+export function agentSessionAdapters(env = defaultEnv()) {
+    return networkMiningEnabled(env) ? { ...AGENT_SESSION_ADAPTERS, ...NETWORK_MINING_SESSION_ADAPTERS } : AGENT_SESSION_ADAPTERS;
+}
 const CONTEXT_READS = new Set([
     "oxygen_capabilities_search", "oxygen_capabilities_schema", "oxygen_skills_list", "oxygen_skills_get",
     "oxygen_knowledge_index", "oxygen_knowledge_search", "oxygen_workspace_get", "oxygen_enrichment_catalog",
 ]);
-export function isAgentSessionCapability(name) { return CONTEXT_READS.has(name) || Boolean(AGENT_SESSION_ADAPTERS[name]); }
-export function agentSessionCapabilityDecision(config, name, args) {
+export function isAgentSessionCapability(name, env = defaultEnv()) { return CONTEXT_READS.has(name) || Boolean(agentSessionAdapters(env)[name]); }
+export function agentSessionCapabilityDecision(config, name, args, env = defaultEnv()) {
+    const decision = sessionCapabilityDecision(config, name, args, env);
+    // Focus learning runs unattended on its own wakes: it never raises a card, so what it may not do it is refused.
+    return decision === "ask" && config.template === FOCUS_LEARNING_TEMPLATE_ID ? "deny" : decision;
+}
+function sessionCapabilityDecision(config, name, args, env) {
     if (CONTEXT_READS.has(name))
         return "allow";
-    const adapter = AGENT_SESSION_ADAPTERS[name];
+    const adapter = agentSessionAdapters(env)[name];
     if (!adapter)
         return "deny";
+    // One record's messages (Network Mining): scoped by the record, never the whole inbox.
+    if (name === "oxygen_messages_query" && args.record !== undefined) {
+        if (!networkMiningEnabled(env) || typeof args.record !== "string" || !args.record || args.record.includes(","))
+            return "deny";
+        return config.resources.records.includes(args.record) ? "allow" : "ask";
+    }
     // No alternate aggregate scope may widen a resource-specific read.
     if (["campaigns", "senders", "account", "crm_object", "ignore_sender_bindings"].some(key => args[key] !== undefined && args[key] !== false))
         return "deny";
@@ -96,6 +124,9 @@ export function agentSessionCapabilityDecision(config, name, args) {
         return "deny";
     if (name === "oxygen_knowledge_page_get" && args.id !== undefined)
         return "deny";
+    // A session appends findings, never other timeline facts (calls, meetings, stage changes) about a record.
+    if (name === "oxygen_crm_activity_log" && args.activity_type !== RESEARCH_FINDING_ACTIVITY_TYPE)
+        return "deny";
     const ref = adapter.fixed ?? adapter.field.split(".").reduce((value, key) => value && typeof value === "object" ? value[key] : undefined, args);
     if (adapter.array) {
         if (!Array.isArray(ref) || !ref.length || ref.some(value => typeof value !== "string" || value.includes(",")))
@@ -118,9 +149,59 @@ export const AGENT_SESSION_EVENT_RESOURCES = {
     mailbox_id: "mailboxes", row_id: "records", record_id: "records",
 };
 export const AGENT_SESSION_EVENTS = WORKSPACE_EVENT_CATALOG.filter(event => Object.keys(AGENT_SESSION_EVENT_RESOURCES).some(key => event.payloadFields.includes(key)));
-export function agentSessionEventIsScoped(config, payload) {
-    return Object.entries(AGENT_SESSION_EVENT_RESOURCES).some(([key, resource]) => typeof payload[key] === "string" && config.resources[resource].includes(payload[key]));
+/** A CRM activity names its records in `links[].row_id`, not a top-level field. */
+const LINKED_RECORDS_FIELD = "links";
+/**
+ * The events a session may wake on here. Where Network Mining is open, a CRM timeline activity can too, through the
+ * records it links (S12); elsewhere this is AGENT_SESSION_EVENTS.
+ */
+export function agentSessionEvents(env = defaultEnv()) {
+    if (!networkMiningEnabled(env))
+        return AGENT_SESSION_EVENTS;
+    return [...AGENT_SESSION_EVENTS, ...servedWorkspaceEventCatalog(env).filter(event => event.payloadFields.includes(LINKED_RECORDS_FIELD) && !AGENT_SESSION_EVENTS.includes(event))];
 }
+function linkedRecordIds(payload) {
+    const links = payload[LINKED_RECORDS_FIELD];
+    return Array.isArray(links)
+        ? links.flatMap(link => link && typeof link === "object" && typeof link.row_id === "string" ? [link.row_id] : [])
+        : [];
+}
+export function agentSessionEventIsScoped(config, payload, env = defaultEnv()) {
+    return Object.entries(AGENT_SESSION_EVENT_RESOURCES).some(([key, resource]) => typeof payload[key] === "string" && config.resources[resource].includes(payload[key]))
+        || (networkMiningEnabled(env) && linkedRecordIds(payload).some(id => config.resources.records.includes(id)));
+}
+/** Whether an event can match a session's selected resources at all. */
+function eventHasSelectedResource(event, resources) {
+    return Object.entries(AGENT_SESSION_EVENT_RESOURCES).some(([key, resource]) => event.payloadFields.includes(key) && resources[resource].length > 0)
+        || (event.payloadFields.includes(LINKED_RECORDS_FIELD) && resources.records.length > 0);
+}
+/**
+ * Focus learning (Network Mining S12, DEV-only): an unattended session over the warmest people in the focus rank. It
+ * wakes when one of them shows inbound activity and once a day, reads their brief (which carries the lineage of
+ * their enrollments), and may only append cited research findings and notes to them: every other write, and any
+ * write that would need a person's card, is refused. Its scope is the focus top-K when it was created, at most
+ * FOCUS_LEARNING_MAX_RECORDS people; it is created as a draft and runs only after a person activates it.
+ */
+export const FOCUS_LEARNING_TEMPLATE_ID = "focus-learning";
+export const FOCUS_LEARNING_DEFAULT_RECORDS = 10;
+export const FOCUS_LEARNING_MAX_RECORDS = 25;
+export const FOCUS_LEARNING_MAX_PER_RUN_CREDITS = 25;
+export const FOCUS_LEARNING_MAX_DAILY_CREDITS = 100;
+const DAY_MINUTES = 1440;
+const FOCUS_LEARNING_ACTIONS = ["oxygen_crm_activity_log", "oxygen_crm_notes_add"];
+// Inbound activity only: a finding or note the session writes itself never wakes it again.
+const FOCUS_LEARNING_EVENTS = [
+    "website_visit", "profile_view", "post_reaction", "new_follower", "connection_accepted",
+    "email_reply", "linkedin_message", "meeting_booked", "post_comment", "company_follow",
+].map(kind => `crm.activity_created.${kind}`);
+const FOCUS_LEARNING_TEMPLATE = {
+    id: FOCUS_LEARNING_TEMPLATE_ID,
+    title: "Focus learning",
+    goal: "Keep learning about the selected people, the warmest in the focus rank. On each wake, read the brief of every person a new event names (oxygen_crm_record_brief: their signals, conversations, enrollments and where they came from), or of each selected person on the daily wake. Append a research finding (oxygen_crm_activity_log with activity_type research_finding and mode live) only for a claim you can cite to this person's own message, activity or a source URL you read, with its confidence; add a note (oxygen_crm_notes_add) for what a seller should do next and why. Never change fields, merge, enroll or send, and write nothing you cannot cite.",
+    resources: ["records"],
+    actions: [...FOCUS_LEARNING_ACTIONS],
+    events: FOCUS_LEARNING_EVENTS,
+};
 export const AGENT_SESSION_TEMPLATES = [
     { id: "campaign-monitor", title: "Campaign monitor", goal: "Watch this native campaign. Compare sends, replies and meetings with earlier reviews; explain changes, propose improvements and schedule the next review.", resources: ["sequences"], actions: ["oxygen_sequences_set_status"], events: ["sequencer.contact_activity.any"] },
     { id: "lead-replenishment", title: "Lead replenishment", goal: "Maintain a qualified lead pool in the selected Table for this native campaign. Research gaps, deduplicate and enroll only qualified leads within the approved scope.", resources: ["tables", "sequences"], actions: ["oxygen_rows_upsert", "oxygen_sequences_enroll"], events: [] },
@@ -137,18 +218,49 @@ export const AGENT_SESSION_TEMPLATES = [
  */
 const BRIEF_FIRST_TEMPLATES = new Set(["account-research", "inbound-qualification"]);
 const BRIEF_FIRST_SENTENCE = "Start each record with its brief (oxygen_crm_record_brief): one free read of its fields, signals, conversations, team connections, notes, tasks and company.";
+const LINEAGE_FIRST_TEMPLATES = new Set(["reply-handling", "inbound-qualification"]);
+const LINEAGE_FIRST_SENTENCE = "Read each conversation with oxygen_inbox_get: its lineage says which sequence, step and variant the reply answered, how fast it came, from which sender and where the lead came from.";
 export function agentSessionTemplates(env = typeof process === "undefined" ? {} : process.env) {
     if (!networkMiningEnabled(env))
         return AGENT_SESSION_TEMPLATES;
-    return AGENT_SESSION_TEMPLATES.map((template) => BRIEF_FIRST_TEMPLATES.has(template.id)
-        ? { ...template, goal: `${BRIEF_FIRST_SENTENCE} ${template.goal}` }
-        : template);
+    return [...AGENT_SESSION_TEMPLATES.map((template) => {
+            const lead = [
+                ...(LINEAGE_FIRST_TEMPLATES.has(template.id) ? [LINEAGE_FIRST_SENTENCE] : []),
+                ...(BRIEF_FIRST_TEMPLATES.has(template.id) ? [BRIEF_FIRST_SENTENCE] : []),
+            ];
+            return lead.length > 0 ? { ...template, goal: `${lead.join(" ")} ${template.goal}` } : template;
+        }), {
+            ...FOCUS_LEARNING_TEMPLATE,
+            events: FOCUS_LEARNING_TEMPLATE.events.filter(id => agentSessionEvents(env).some(event => event.id === id)),
+        }];
 }
-export function validateAgentSessionConfig(config, requireResources = true) {
+function focusLearningProblem(config) {
+    const { per_run_credits: perRun, daily_credits: daily } = config.budget;
+    if (perRun > FOCUS_LEARNING_MAX_PER_RUN_CREDITS || daily > FOCUS_LEARNING_MAX_DAILY_CREDITS) {
+        return `Focus learning runs within ${FOCUS_LEARNING_MAX_PER_RUN_CREDITS} credits a run and ${FOCUS_LEARNING_MAX_DAILY_CREDITS} in any 24 hours.`;
+    }
+    if (config.actions.some(name => !FOCUS_LEARNING_ACTIONS.includes(name)))
+        return "Focus learning may only append research findings and notes.";
+    if (config.events.some(id => !FOCUS_LEARNING_EVENTS.includes(id)))
+        return "Focus learning wakes only on inbound activity of its people.";
+    if (Object.entries(config.resources).some(([key, values]) => key !== "records" && values.length > 0))
+        return "Focus learning is scoped to people only.";
+    if (config.resources.records.length > FOCUS_LEARNING_MAX_RECORDS)
+        return `Focus learning covers at most ${FOCUS_LEARNING_MAX_RECORDS} people.`;
+    const schedule = config.schedule;
+    if (schedule.kind === "cron" || schedule.min_interval_minutes < DAY_MINUTES || schedule.interval_minutes < DAY_MINUTES) {
+        return "Focus learning wakes on its people's activity and at most once a day otherwise: use an interval of at least 1,440 minutes.";
+    }
+    if (config.teammate_routine || config.guided_activation)
+        return "Focus learning is its own session, not a routine.";
+    return null;
+}
+export function validateAgentSessionConfig(config, requireResources = true, env = defaultEnv()) {
     const fail = (message) => { throw new OxygenError("invalid_session_config", message); };
     if (!config.title?.trim() || !config.goal?.trim())
         fail("A title and goal are required.");
-    if (config.template !== "custom" && !AGENT_SESSION_TEMPLATES.some(t => t.id === config.template))
+    const templates = agentSessionTemplates(env);
+    if (config.template !== "custom" && !templates.some(t => t.id === config.template))
         fail("Unknown session template.");
     const { per_run_credits: perRun, daily_credits: daily, lifetime_credits: lifetime } = config.budget;
     if (!Number.isFinite(perRun) || perRun <= 0 || perRun > 25000 || !Number.isFinite(daily) || daily < perRun)
@@ -183,20 +295,24 @@ export function validateAgentSessionConfig(config, requireResources = true) {
     }
     if (config.ends_at && !Number.isFinite(Date.parse(config.ends_at)))
         fail("Use an ISO date for the end time.");
-    if (config.actions.some(name => !AGENT_SESSION_ADAPTERS[name] || AGENT_SESSION_ADAPTERS[name].read))
+    const adapters = agentSessionAdapters(env), events = agentSessionEvents(env);
+    if (config.actions.some(name => !adapters[name] || adapters[name].read))
         fail("Choose a reviewed native action.");
-    if (config.events.some(id => !AGENT_SESSION_EVENTS.some(event => event.id === id)))
+    if (config.events.some(id => !events.some(event => event.id === id)))
         fail("Choose an event that can match the session's selected resources.");
     for (const values of Object.values(config.resources)) {
         if (!Array.isArray(values) || values.some(ref => typeof ref !== "string" || !ref.trim() || ref.includes(",") || ref === "*"))
             fail("Resources require exact native IDs or slugs.");
     }
-    const template = AGENT_SESSION_TEMPLATES.find(t => t.id === config.template);
-    if (requireResources && config.events.some(id => {
-        const event = AGENT_SESSION_EVENTS.find(entry => entry.id === id);
-        return !Object.entries(AGENT_SESSION_EVENT_RESOURCES).some(([key, resource]) => event.payloadFields.includes(key) && config.resources[resource].length);
-    }))
+    if (config.template === FOCUS_LEARNING_TEMPLATE_ID) {
+        const problem = focusLearningProblem(config);
+        if (problem)
+            fail(problem);
+    }
+    const template = templates.find(t => t.id === config.template);
+    if (requireResources && config.events.some(id => !eventHasSelectedResource(events.find(entry => entry.id === id), config.resources))) {
         fail("Select a matching resource for each event before activating.");
+    }
     if (requireResources && template?.resources.some(key => !config.resources[key]?.length))
         fail("Select the template's required resources before activating.");
 }

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

@@ -1053,7 +1053,7 @@ function recordDossierReadRecommendation(query) {
 const RECORD_DOSSIER_FIRST_COMMANDS = ["crm search", "crm get", "crm activity timeline"];
 const RECORD_BRIEF_TOOL = "oxygen_crm_record_brief";
 const RECORD_BRIEF_COMMAND = "crm brief";
-const RECORD_BRIEF_EXECUTION_PREFIX = `Start with ${RECORD_BRIEF_COMMAND} (${RECORD_BRIEF_TOOL}): one free read of everything stored about the record, with a cursor to each section's rest. `;
+const RECORD_BRIEF_EXECUTION_PREFIX = `Start with ${RECORD_BRIEF_COMMAND} (${RECORD_BRIEF_TOOL}): one free read of everything stored about the record. It takes the row id, an identity or the exact name, so no search comes first, and each cut section names the read for its rest; use the reads below only for those. `;
 /**
  * Put the Network Mining record brief first on a record-dossier route where the
  * host serves it, and take it off where it does not. The shared router decides

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

@@ -135,6 +135,7 @@ export const CUSTOMER_OPERATIONS = [
     operation("tools.check_access", "/api/cli/tools/check-access", "POST", "tools check-access", "oxygen_tools_check_access", "enrichment", "Read tool access for this workspace; verify_credential explicitly opts into a provider credential probe.", { tool_id: text(), connection_id: text(), credential_mode: enumOf(["managed", "user_api_key"]), input: json, verify_credential: bool() }, ["tool_id"], { ...cliOnly, mutates: false }),
     operation("linkedin.connections.import_status", "/api/cli/linkedin/connections/import", "GET", "linkedin connections import-status", "oxygen_linkedin_connections_import_status", "sequences", "Read the durable LinkedIn connections import status and target Table.", { account: text() }),
     operation("linkedin.followers.import_status", "/api/cli/linkedin/followers/import", "GET", "linkedin followers import-status", "oxygen_linkedin_followers_import_status", "sequences", "Read the durable LinkedIn followers import status and target Table.", { account: text() }),
+    operation("inbox.import", "/api/cli/inbox/import", "POST", "inbox import", "oxygen_inbox_import", "inbox", "Import your own Instantly or Smartlead cold-email history into Messages (record timelines, messages query; not the Unibox). Runs on your connection; each read has the own-key fee. Never stops sequences or changes DNC. Resumable; dry_run reads one page.", { provider: enumOf(["instantly", "smartlead"]), connection_id: text(), campaign_id: text(), since: text("ISO timestamp; older mail is skipped."), import_id: text("Continue this import."), max_pages: int({ minimum: 0, maximum: 10 }), dry_run: bool() }, ["provider"], { spends: true, annotations: { openWorldHint: true } }),
     operation("linkedin.inbox.backfill_status", "/api/cli/linkedin/inbox/backfill", "GET", "linkedin inbox backfill-status", "oxygen_linkedin_inbox_backfill_status", "inbox", "Read the durable LinkedIn inbox backfill status.", { account: text() }),
     operation("linkedin.viewers.list", "/api/cli/linkedin/viewers", "GET", "linkedin viewers list", "oxygen_profile_viewers", "publishing", "Read named LinkedIn profile viewers, respecting the connected account's privacy ceiling.", { account: text(), start: int({ minimum: 0 }), include_raw: bool() }, [], cliOnly),
     operation("signals.search.filters", "/api/cli/signals/search/preview", "GET", "signals search filters", "oxygen_signals_search_preview", "signals", "Read the LinkedIn post-search filter catalog and credential status; runs no search.", { source: enumOf(["linkedin_posts"]) }, [], cliOnly),

package/node_modules/@oxygen/shared/dist/conversation-lineage.d.ts

@@ -0,0 +1,131 @@
+export declare const CONVERSATION_LINEAGE_SCHEMA_VERSION = 1;
+export declare const CONVERSATION_LINEAGE_MAX_CHARS = 2500;
+export declare const LINEAGE_DIGEST_MAX_CHARS = 600;
+export type LineageCoverage = "complete" | "partial" | "unknown" | "empty";
+/**
+ * Where the lead came from, as the enrollment recorded it (migration 0541): the
+ * kind of choice, the surface and actor type it came through, the table and the
+ * run behind it, and the focus decile at enroll time where Network Mining took
+ * one. An enrollment from before 0541 holds none and reads `unknown`.
+ */
+export type LineageOrigin = {
+    kind: "unknown";
+} | {
+    kind: string;
+    gateway: string;
+    enrolled_by: string;
+    table_id: string | null;
+    ref: {
+        type: string;
+        id: string;
+    } | null;
+    focus?: {
+        in_focus: boolean;
+        rank: number | null;
+        decile: number | null;
+    } | null;
+};
+export type LineageEnrollment = {
+    enrollment_id: string;
+    sequence: {
+        id: string;
+        name: string | null;
+    };
+    status: string | null;
+    enrolled_at: string | null;
+    /** How this conversation was tied to the enrollment. */
+    link: "stored" | "chat_id" | "lead_provider_id";
+    origin: LineageOrigin;
+    touches_before_reply: {
+        total: number;
+        by_kind: Record<string, number>;
+        channels: string[];
+    } | null;
+    reply: {
+        occurred_at: string;
+        channel: string;
+        answered: {
+            action_id: string;
+            step_index: number | null;
+            variant_id: string | null;
+            action_kind: string | null;
+            sent_at: string | null;
+        } | null;
+        latency_seconds: number | null;
+        time_to_first_reply_seconds: number | null;
+        attribution: "thread" | "latest_send_before_reply" | "unattributed";
+        source: string;
+    } | null;
+    sender: {
+        account_id: string | null;
+        mailbox_id: string | null;
+        label: string | null;
+    } | null;
+    /** Which reviewed copy produced the send. `null` until sends record it (LN3). */
+    copy: null;
+};
+export type ConversationLineage = {
+    schema_version: typeof CONVERSATION_LINEAGE_SCHEMA_VERSION;
+    conversation: {
+        id: string;
+        channel: string;
+        started_by: "us" | "them" | null;
+        first_outbound_at: string | null;
+        first_inbound_at: string | null;
+        sender: {
+            account_id: string | null;
+            mailbox_id: string | null;
+            label: string | null;
+            sender_profile_id: string | null;
+        };
+        other_senders: {
+            account_id: string;
+            label: string | null;
+        }[];
+    };
+    record: {
+        object: string;
+        row_id: string;
+        tier: "crm" | "audience";
+        match: "identity";
+        matched_on: string;
+    } | {
+        match: "none";
+    };
+    enrollments: LineageEnrollment[];
+    turns: {
+        inbound_count: number;
+        latest_inbound_at: string | null;
+        response_gaps: {
+            inbound_message_id: string;
+            after_message_id: string;
+            seconds: number;
+        }[];
+    };
+    /** Newest first; the first entry is the current status. `message_id` is the newest inbound when it changed. */
+    classification_history: {
+        status: string;
+        source: string;
+        at: string | null;
+        message_id: string | null;
+        confidence: number | null;
+    }[];
+    other_conversations: {
+        id: string;
+        channel: string;
+        last_at: string | null;
+        status: string | null;
+    }[];
+    coverage: Record<"enrollments" | "record" | "origin" | "copy" | "classification_history" | "other_conversations", {
+        state: LineageCoverage;
+        reason?: string;
+    }>;
+};
+/** "a one-off send via cli, focus decile 2"; `unknown` when the enrollment recorded none. */
+export declare function originText(origin: LineageOrigin): string;
+/**
+ * One short, plain-text line set an agent reads beside the thread (≤600 chars):
+ * which sequence, step and variant the reply answered, how fast, from which
+ * sender, where the lead came from, and what is unknown.
+ */
+export declare function renderLineageDigest(lineage: ConversationLineage | null | undefined): string | null;