heylead 0.10.330__tar.gz → 0.10.332__tar.gz

{heylead-0.10.330 → heylead-0.10.332}/AGENTS.md

@@ -41,7 +41,7 @@ Never paste model-authored text as the LinkedIn message. The send tools generate
 
 Never launch a draft unless the user asked.
 
-In-process agents default to observe. Do not invent MCP kwargs to turn them to act.
+In-process agents default to observe. Turn act on with `edit_campaign(enable_reply_agent="on")`, `edit_campaign(enable_strategist_replan_agent="on")`, or `edit_campaign(enable_hot_lead_closer="on")`. Use `"observe"` to return to logging-only, `"off"` to disable.
 
 ## Authentication
 
@@ -70,7 +70,7 @@ In-process agents default to observe. Do not invent MCP kwargs to turn them to a
 |------|-------------|
 | `create_campaign` | Create an outreach campaign (as a draft) from a natural language description, with ICP-based targeting |
 | `campaign` | Campaign lifecycle — launch, pause, resume, archive, delete, emergency stop, retry failed |
-| `edit_campaign` | Update campaign name, mode, booking link, offerings, case studies, or messaging preferences |
+| `edit_campaign` | Update campaign name, mode, booking link, offerings, case studies, messaging preferences, or agent act flags |
 | `import_prospects` | Import prospects from CSV data into a campaign |
 
 ### Outreach Execution

{heylead-0.10.330 → heylead-0.10.332}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: heylead
-Version: 0.10.330
+Version: 0.10.332
 Summary: MCP-native autonomous LinkedIn SDR. Your AI sales rep, one command to fill your pipeline.
 Project-URL: Homepage, https://github.com/D4umak/heylead
 Project-URL: Repository, https://github.com/D4umak/heylead

{heylead-0.10.330 → heylead-0.10.332}/SKILL.md

@@ -85,7 +85,7 @@ Never paste model-authored text as the LinkedIn message. The send tools generate
 
 Never launch a draft unless the user asked.
 
-In-process agents default to observe. Do not invent MCP kwargs to turn them to act.
+In-process agents default to observe. Turn act on with `edit_campaign(enable_reply_agent="on")`, `edit_campaign(enable_strategist_replan_agent="on")`, or `edit_campaign(enable_hot_lead_closer="on")`. Use `"observe"` to return to logging-only, `"off"` to disable.
 
 ## Safety Model
 
@@ -103,7 +103,7 @@ Campaigns are created as drafts and only start when explicitly launched. Every s
 | `profile_signals` | Compile a targeting request (country ties, interests) into LinkedIn recall queries and profile evidence |
 | `create_campaign` | Find prospects and build an outreach campaign (as a draft) |
 | `campaign` | Launch, pause, resume, archive, delete, emergency stop, retry failed |
-| `edit_campaign` | Update name, mode, booking link, preferences |
+| `edit_campaign` | Update name, mode, booking link, preferences, or agent act flags |
 | `import_prospects` | Import prospects from CSV |
 | `generate_and_send` | Send personalized connection invitations |
 | `send_message` | Follow-up DMs, replies, and voice memos |

{heylead-0.10.330 → heylead-0.10.332}/clawhub/SKILL.md

@@ -88,7 +88,7 @@ Never paste model-authored text as the LinkedIn message. The send tools generate
 
 Never launch a draft unless the user asked.
 
-In-process agents default to observe. Do not invent MCP kwargs to turn them to act.
+In-process agents default to observe. Turn act on with `edit_campaign(enable_reply_agent="on")`, `edit_campaign(enable_strategist_replan_agent="on")`, or `edit_campaign(enable_hot_lead_closer="on")`. Use `"observe"` to return to logging-only, `"off"` to disable.
 
 ## Safety Model
 
@@ -106,7 +106,7 @@ Campaigns are created as drafts and only start when explicitly launched. Every s
 | `profile_signals` | Compile a targeting request (country ties, interests) into LinkedIn recall queries and profile evidence |
 | `create_campaign` | Find prospects and build an outreach campaign (as a draft) |
 | `campaign` | Launch, pause, resume, archive, delete, emergency stop, retry failed |
-| `edit_campaign` | Update name, mode, booking link, preferences |
+| `edit_campaign` | Update name, mode, booking link, preferences, or agent act flags |
 | `import_prospects` | Import prospects from CSV |
 | `generate_and_send` | Send personalized connection invitations |
 | `send_message` | Follow-up DMs, replies, and voice memos |

{heylead-0.10.330 → heylead-0.10.332}/clawhub.json

@@ -17,7 +17,7 @@
     "icp",
     "campaign-management"
   ],
-  "version": "0.10.330",
+  "version": "0.10.332",
   "license": "MIT",
   "author": {
     "name": "HeyLead",

heylead-0.10.332/docs/superpowers/specs/2026-09-09-edit-campaign-agent-flags-design.md

@@ -0,0 +1,24 @@
+# edit_campaign agent flags
+
+Date: 2026-09-09
+
+The four in-process agents default to observe. Act lives on campaign config (`enable_reply_agent`, `enable_strategist_replan_agent`, `enable_hot_lead_closer`), but `edit_campaign` does not accept those kwargs. Host docs told the model not to invent them.
+
+This spec wires the three campaign flags. ICP research stays an account setting.
+
+## Goals
+
+- `edit_campaign(enable_reply_agent="", enable_strategist_replan_agent="", enable_hot_lead_closer="")`
+- Values: `on` | `off` | `observe`. Empty = no change.
+- **on** → write the enable key as a boolean `True` (same style as `enable_auto_replies`). Mode readers return `act`.
+- **off** → write `False`. Mode readers return `off`.
+- **observe** → delete the enable key and the matching `*_mode` key so unset = observe.
+- Invalid value rejected; config unchanged.
+- MCP wrapper exposes the same three parameters.
+- Playbook / MCP instructions show the real calls instead of “do not invent kwargs”.
+
+## Non-goals
+
+- `enable_icp_research_agent` (settings, not campaign config).
+- New MCP tool.
+- Changing default observe behavior.

{heylead-0.10.330 → heylead-0.10.332}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "heylead"
-version = "0.10.330"
+version = "0.10.332"
 description = "MCP-native autonomous LinkedIn SDR. Your AI sales rep, one command to fill your pipeline."
 readme = "README.md"
 license = "MIT"

{heylead-0.10.330 → heylead-0.10.332}/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.D4umak/heylead",
   "title": "HeyLead \u2014 Autonomous LinkedIn SDR",
   "description": "Autonomous LinkedIn SDR \u2014 voice-matched outreach, ICP generation, and campaign management.",
-  "version": "0.10.330",
+  "version": "0.10.332",
   "websiteUrl": "https://github.com/D4umak/heylead",
   "repository": {
     "url": "https://github.com/D4umak/heylead",
@@ -13,7 +13,7 @@
     {
       "registryType": "pypi",
       "identifier": "heylead",
-      "version": "0.10.330",
+      "version": "0.10.332",
       "runtimeHint": "uvx",
       "transport": {
         "type": "stdio"

{heylead-0.10.330 → heylead-0.10.332}/src/heylead/server.py

@@ -28,6 +28,20 @@ from .ops_log import run_traced
 _CHANGELOG = """\
 # HeyLead Changelog
 
+## v0.10.332 (2026-09-09)
+- New: brand_strategy(action="set_headline", focus="...") sets the LinkedIn
+  headline to exactly the text you pass. execute and makeover both write a
+  model-generated headline, and the headline A/B test is off, so a headline
+  you had already decided on could not be applied from HeyLead at all. The
+  write goes through the normal profile-change path, so it is logged and
+  restorable with profile(action="restore"), and it is refused over the
+  220-character LinkedIn limit instead of being silently clipped (#263)
+
+## v0.10.331 (2026-09-09)
+- New: edit_campaign can turn the reply, strategist, and closer agents
+  to act, off, or observe. Hosts no longer have to invent those kwargs
+  (#272)
+
 ## v0.10.330 (2026-09-09)
 - New: inspect(action='jobs') lists pending scheduler jobs and recent
   gated-job refusals, and explains observe / cloud ownership when the
@@ -1218,8 +1232,11 @@ mcp = FastMCP(
         "    was skipped, call inspect() first — it never writes. A hold →\n"
         "    prospect(action='conversation') then send_message(action='reply').\n"
         "    Never paste model-authored text as the LinkedIn message; the send\n"
-        "    tools generate it. Agents default to observe; do not invent\n"
-        "    edit_campaign kwargs to flip them to act.\n"
+        "    tools generate it. Agents default to observe. Turn act on with\n"
+        "    edit_campaign(enable_reply_agent='on'),\n"
+        "    edit_campaign(enable_strategist_replan_agent='on'), or\n"
+        "    edit_campaign(enable_hot_lead_closer='on'). Use 'observe' to\n"
+        "    return to logging-only, 'off' to disable.\n"
         "  - book_meeting() — put an agreed call on your Google Calendar and invite them\n"
         "  - suggest_next_action() — AI-recommended next step\n"
         "  - analytics(action='report') — detailed analytics with outcomes and stale lead warnings\n"
@@ -2038,6 +2055,9 @@ async def edit_campaign(
     enable_auto_replies: str = "",
     enable_invitations: str = "",
     enable_discovery: str = "",
+    enable_reply_agent: str = "",
+    enable_strategist_replan_agent: str = "",
+    enable_hot_lead_closer: str = "",
     engagement_mode: str = "",
     max_followups: int = 0,
     followup_delay_days: str = "",
@@ -2088,6 +2108,12 @@ async def edit_campaign(
             When off, campaign only DMs existing connections (no invitations sent).
         enable_discovery: Auto-find and enrol new prospects: "on" or "off".
             Turn off for curated campaigns with a fixed, hand-picked list.
+        enable_reply_agent: Reply exception agent: "on" (act), "off", or
+            "observe". Empty keeps the current value. Unset defaults to observe.
+        enable_strategist_replan_agent: Strategist replan: "on", "off", or
+            "observe". Empty keeps the current value.
+        enable_hot_lead_closer: Hot-lead closer: "on", "off", or "observe".
+            Empty keeps the current value.
         engagement_mode: Engagement style: "auto" (30% react / 70% comment),
             "comment_only", or "react_only".
         max_followups: Max follow-up messages (1-5). 0 to keep current.
@@ -2133,6 +2159,9 @@ async def edit_campaign(
                 enable_auto_replies=enable_auto_replies,
                 enable_invitations=enable_invitations,
                 enable_discovery=enable_discovery,
+                enable_reply_agent=enable_reply_agent,
+                enable_strategist_replan_agent=enable_strategist_replan_agent,
+                enable_hot_lead_closer=enable_hot_lead_closer,
                 engagement_mode=engagement_mode,
                 max_followups=max_followups,
                 followup_delay_days=followup_delay_days,
@@ -2433,8 +2462,11 @@ async def brand_strategy(
             "upload_photo" — Upload a profile photo (provide file_path or base64 data)
             "upload_cover" — Upload a cover/banner photo (same input as upload_photo)
             "set_link" — Set custom CTA link on profile (pass URL via focus param)
+            "set_headline" — Set the headline to exact text (pass the headline via focus).
+                Use this when the user has already decided the wording; "execute" and
+                "makeover" write a model-generated headline instead.
         focus: Focus area for analyze/plan ("headline", "summary", "content", "engagement", ""),
-            or URL string for set_link action.
+            URL string for set_link, or the literal headline text for set_headline.
         photo: File path or base64-encoded image for upload_photo / upload_cover actions.
     """
     from .tools.brand_strategy import run_brand_strategy

{heylead-0.10.330 → heylead-0.10.332}/src/heylead/tools/brand_strategy.py

@@ -46,6 +46,9 @@ from ..db.async_bridge import run_db
 
 logger = logging.getLogger(__name__)
 
+# LinkedIn truncates a headline past this, so refuse rather than silently clip.
+HEADLINE_MAX_CHARS = 220
+
 
 async def run_brand_strategy(
     action: str = "analyze",
@@ -80,6 +83,8 @@ async def run_brand_strategy(
         return await _handle_upload_cover(account_id, photo)
     elif action == "set_link":
         return await _handle_set_link(account_id, focus)
+    elif action == "set_headline":
+        return await _handle_set_headline(account_id, focus)
     elif action == "makeover":
         return await _handle_makeover(account_id)
     elif action == "photo_enhance":
@@ -98,6 +103,7 @@ async def run_brand_strategy(
             '  brand_strategy(action="upload_photo")  — Upload profile photo\n'
             '  brand_strategy(action="upload_cover")  — Upload cover photo\n'
             '  brand_strategy(action="set_link", focus="https://...")  — Set custom CTA link\n'
+            '  brand_strategy(action="set_headline", focus="Your exact headline")  — Set the headline verbatim\n'
             '  brand_strategy(action="makeover")      — One-click full profile optimization\n'
             '  brand_strategy(action="photo_enhance") — Auto-enhance profile photo settings\n'
             '  brand_strategy(action="test_headline", focus="Variant A | Variant B")  — Start headline A/B test\n'
@@ -1415,6 +1421,70 @@ async def _handle_set_link(account_id: str, url: str) -> str:
         return f"Failed to set custom link: {e}"
 
 
+async def _handle_set_headline(account_id: str, text: str) -> str:
+    """Set the headline to exactly *text*.
+
+    ``execute`` and ``makeover`` write a model-generated headline. This
+    writes the words the user chose, unchanged, so a headline decided
+    outside HeyLead does not have to be pasted into LinkedIn by hand.
+    """
+    profile = await run_db(get_setting, "profile", {})
+    current = profile.get("headline", "") or "(not set)"
+
+    headline = (text or "").strip()
+    if not headline:
+        return (
+            "Set your LinkedIn headline to exact text:\n\n"
+            '  brand_strategy(action="set_headline", focus="Your exact headline")\n\n'
+            f"  Current: {current}\n\n"
+            f"The text is written verbatim, up to {HEADLINE_MAX_CHARS} characters.\n"
+            'For a generated headline instead, use brand_strategy(action="makeover").'
+        )
+
+    if len(headline) > HEADLINE_MAX_CHARS:
+        return (
+            f"Headline is {len(headline)} characters, over the LinkedIn limit "
+            f"of {HEADLINE_MAX_CHARS}.\n\n"
+            f"Trim {len(headline) - HEADLINE_MAX_CHARS} characters and try again. "
+            "Nothing was changed."
+        )
+
+    if headline == (profile.get("headline") or ""):
+        return f"Headline is already:\n\n  {headline}\n\nNothing to change."
+
+    from .profile_editor import apply_profile_change
+
+    provider_id = profile.get("provider_id", "")
+
+    try:
+        client = get_linkedin_client()
+        result = await apply_profile_change(
+            client, account_id, provider_id, "headline", headline,
+            source="brand_strategy",
+        )
+        await client.close()
+    except Exception as e:
+        return f"Failed to set headline: {e}"
+
+    if not result.get("success"):
+        error = result.get("error", "Unknown error")
+        return f"Failed to set headline: {error}"
+
+    await run_db(
+        log_action,
+        "brand_headline_set",
+        details={"headline": headline, "previous": current},
+    )
+    return (
+        "Headline updated.\n\n"
+        f"  Before: {current}\n"
+        f"  After:  {headline}\n\n"
+        f"  {len(headline)}/{HEADLINE_MAX_CHARS} characters\n\n"
+        'Roll back with profile(action="history", field="headline") '
+        'then profile(action="restore", change_id="...").'
+    )
+
+
 async def _compute_current_health(ssi_data: dict[str, Any], campaign_stats: dict[str, Any]):
     """Compute current health score from available data."""
     daily_record = await run_db(get_rate_limit_today)
@@ -1697,8 +1767,9 @@ async def _handle_test_headline(focus: str) -> str:
             "The test could not attribute an invitation to the headline it went "
             "out under, so it changed your real LinkedIn headline without ever "
             "being able to compare the two variants.\n\n"
-            "Your headline is untouched. Edit it directly with "
-            'brand_strategy(action="makeover") or on LinkedIn.'
+            "Your headline is untouched. Set it directly with "
+            'brand_strategy(action="set_headline", focus="...") for exact text, '
+            'or brand_strategy(action="makeover") for a generated one.'
         )
 
     if not focus or "|" not in focus:

{heylead-0.10.330 → heylead-0.10.332}/src/heylead/tools/edit_campaign.py

@@ -17,6 +17,12 @@ logger = logging.getLogger(__name__)
 # Valid values for new settings
 _VALID_ENGAGEMENT_MODES = frozenset({"auto", "comment_only", "react_only"})
 _VALID_ACTIVE_DAYS = frozenset(range(7))  # 0=Mon ... 6=Sun
+_VALID_AGENT_FLAGS = frozenset({"on", "off", "observe"})
+_AGENT_FLAG_SPECS = (
+    ("enable_reply_agent", "reply_agent_mode", "Reply agent"),
+    ("enable_strategist_replan_agent", "strategist_replan_mode", "Strategist replan"),
+    ("enable_hot_lead_closer", "hot_lead_closer_mode", "Hot-lead closer"),
+)
 
 
 async def run_edit_campaign(
@@ -63,6 +69,10 @@ async def run_edit_campaign(
     active_days: str = "",
     # Message stance
     campaign_intent: str = "",
+    # In-process agents (observe is the default when unset)
+    enable_reply_agent: str = "",
+    enable_strategist_replan_agent: str = "",
+    enable_hot_lead_closer: str = "",
 ) -> str:
     """Edit a campaign's settings.
 
@@ -108,6 +118,12 @@ async def run_edit_campaign(
         send_in_business_hours: Respect prospect's business hours: "on" or "off".
         active_days: Active send days as comma-separated numbers (0=Mon, 6=Sun).
             E.g., "0,1,2,3,4" for weekdays. Leave empty to keep current.
+        enable_reply_agent: Reply exception agent: "on" (act), "off", or
+            "observe". Empty keeps the current value. Unset defaults to observe.
+        enable_strategist_replan_agent: Strategist replan agent: "on", "off",
+            or "observe". Empty keeps the current value.
+        enable_hot_lead_closer: Hot-lead closer: "on", "off", or "observe".
+            Empty keeps the current value.
     """
 
     # ── Pre-checks ──
@@ -134,13 +150,16 @@ async def run_edit_campaign(
         bool(inmail_fallback) or inmail_fallback_days > 0 or bool(inmail_first_touch)
     )
     has_timing_settings = bool(send_in_business_hours) or bool(active_days)
+    has_agent_settings = any([
+        enable_reply_agent, enable_strategist_replan_agent, enable_hot_lead_closer,
+    ])
 
     has_any = (
         name or mode or booking_link or voice_mode
         or has_context_fields or has_voice_settings or open_to_work_mode
         or has_toggle_settings or has_engagement_settings
         or has_followup_settings or has_invite_settings or has_inmail_settings
-        or has_timing_settings or campaign_intent
+        or has_timing_settings or campaign_intent or has_agent_settings
     )
 
     if not has_any:
@@ -166,6 +185,11 @@ async def run_edit_campaign(
             "  enable_invitations: on or off\n"
             "  enable_discovery: on or off\n"
             "\n"
+            "  In-process agents (default observe):\n"
+            "  enable_reply_agent: on, off, or observe\n"
+            "  enable_strategist_replan_agent: on, off, or observe\n"
+            "  enable_hot_lead_closer: on, off, or observe\n"
+            "\n"
             "  Engagement:\n"
             "  engagement_mode: auto, comment_only, or react_only\n"
             "\n"
@@ -237,6 +261,16 @@ async def run_edit_campaign(
         if val and val not in ("on", "off"):
             return f"Invalid {label}: '{val}'. Must be 'on' or 'off'."
 
+    for label, val in [
+        ("enable_reply_agent", enable_reply_agent),
+        ("enable_strategist_replan_agent", enable_strategist_replan_agent),
+        ("enable_hot_lead_closer", enable_hot_lead_closer),
+    ]:
+        if val and val not in _VALID_AGENT_FLAGS:
+            return (
+                f"Invalid {label}: '{val}'. Must be 'on', 'off', or 'observe'."
+            )
+
     # ── Validate engagement_mode ──
     if engagement_mode and engagement_mode not in _VALID_ENGAGEMENT_MODES:
         return (
@@ -390,6 +424,40 @@ async def run_edit_campaign(
                 label = _TOGGLE_LABELS[key]
                 change_descriptions.append(f"{label}: {'on' if old_bool else 'off'} -> {val}")
 
+    # ── In-process agents (on=act, off, observe=unset) ──
+    from ..services.hot_lead_closer import hot_lead_closer_mode
+    from ..services.reply_agent import reply_agent_mode
+    from ..services.strategist_replan import strategist_replan_mode
+
+    _agent_readers = {
+        "enable_reply_agent": reply_agent_mode,
+        "enable_strategist_replan_agent": strategist_replan_mode,
+        "enable_hot_lead_closer": hot_lead_closer_mode,
+    }
+    _agent_values = {
+        "enable_reply_agent": enable_reply_agent,
+        "enable_strategist_replan_agent": enable_strategist_replan_agent,
+        "enable_hot_lead_closer": enable_hot_lead_closer,
+    }
+    for key, mode_key, label in _AGENT_FLAG_SPECS:
+        val = _agent_values[key]
+        if not val:
+            continue
+        mode_of = _agent_readers[key]
+        old = mode_of(config)
+        if val == "observe":
+            config.pop(key, None)
+            config.pop(mode_key, None)
+        elif val == "on":
+            config[key] = True
+            config.pop(mode_key, None)
+        else:
+            config[key] = False
+            config.pop(mode_key, None)
+        new = mode_of(config)
+        if old != new:
+            change_descriptions.append(f"{label}: {old} -> {new}")
+
     # ── Engagement mode ──
     if engagement_mode:
         old_em = config.get("engagement_mode", "auto")