autotouch-cli 0.2.61__tar.gz → 0.2.64__tar.gz

{autotouch_cli-0.2.61 → autotouch_cli-0.2.64}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.61
+Version: 0.2.64
 Summary: Autotouch Smart Table CLI
 Project-URL: Homepage, https://app.autotouch.ai
 Project-URL: Documentation, https://github.com/nicolonic/autotouch_main/tree/main/docs/research-table/reference
@@ -158,6 +158,11 @@ For `llm_enrichment` in `agent` mode, the recommended path is:
 
 Only send `user_schema` / `response_schema` when you intentionally want to override the generated schema and keep it aligned yourself. The installed recipe surface at `autotouch columns recipe --type llm_enrichment` follows this contract.
 
+Schema ownership rules:
+- Accepted generated schemas and explicit user schemas are the saved output contract.
+- Row execution must not add fields, rename fields, or replace a valid locked schema.
+- Agent-mode evidence/scored state decides which values may fill the schema; the finalizer formats those values and schema validation gates persistence.
+
 Prompt variables in authored prompts support nested JSON access:
 - Use flat row variables like `{{company_name}}` for scalar columns.
 - Use dotted placeholders like `{{linkedin_lookup.linkedin_url}}` when the source column stores JSON or stringified JSON.

{autotouch_cli-0.2.61 → autotouch_cli-0.2.64}/README.md

@@ -133,6 +133,11 @@ For `llm_enrichment` in `agent` mode, the recommended path is:
 
 Only send `user_schema` / `response_schema` when you intentionally want to override the generated schema and keep it aligned yourself. The installed recipe surface at `autotouch columns recipe --type llm_enrichment` follows this contract.
 
+Schema ownership rules:
+- Accepted generated schemas and explicit user schemas are the saved output contract.
+- Row execution must not add fields, rename fields, or replace a valid locked schema.
+- Agent-mode evidence/scored state decides which values may fill the schema; the finalizer formats those values and schema validation gates persistence.
+
 Prompt variables in authored prompts support nested JSON access:
 - Use flat row variables like `{{company_name}}` for scalar columns.
 - Use dotted placeholders like `{{linkedin_lookup.linkedin_url}}` when the source column stores JSON or stringified JSON.

{autotouch_cli-0.2.61 → autotouch_cli-0.2.64}/autotouch_cli/cli.py

@@ -125,6 +125,21 @@ from autotouch_cli.commands.search import (
     cmd_search_reviews as cmd_search_reviews_impl,
     cmd_search_similar_companies as cmd_search_similar_companies_impl,
 )
+from autotouch_cli.commands.agents import (
+    AgentCommandRuntime as AgentCommandHandlerRuntime,
+    cmd_agents_list as cmd_agents_list_impl,
+    cmd_agents_get as cmd_agents_get_impl,
+    cmd_agents_create as cmd_agents_create_impl,
+    cmd_agents_update as cmd_agents_update_impl,
+    cmd_agents_delete as cmd_agents_delete_impl,
+    cmd_agents_run as cmd_agents_run_impl,
+    cmd_agents_runs as cmd_agents_runs_impl,
+    cmd_agents_watch as cmd_agents_watch_impl,
+    cmd_agents_generate_persona as cmd_agents_generate_persona_impl,
+    cmd_agents_generate_topics as cmd_agents_generate_topics_impl,
+    cmd_agents_generate_job_signal as cmd_agents_generate_job_signal_impl,
+    cmd_agents_signals as cmd_agents_signals_impl,
+)
 from autotouch_cli.commands.sequences import (
     SequenceCommandRuntime as SequenceCommandHandlerRuntime,
     cmd_sequences_clone as cmd_sequences_clone_impl,
@@ -1164,6 +1179,17 @@ def _sequence_command_runtime() -> SequenceCommandHandlerRuntime:
     )
 
 
+def _agent_command_runtime() -> AgentCommandHandlerRuntime:
+    return AgentCommandHandlerRuntime(
+        resolve_token=_resolve_token,
+        request_api=_request_api,
+        print_json=lambda data, compact=False: _print_json(data, compact=compact),
+        load_json_input=_load_json_input,
+        api_url=_api_url,
+        default_timeout_seconds=DEFAULT_TIMEOUT_SECONDS,
+    )
+
+
 def _column_command_runtime() -> ColumnCommandHandlerRuntime:
     return ColumnCommandHandlerRuntime(
         resolve_token=_resolve_token,
@@ -1420,6 +1446,20 @@ _register("columns_run_next", cmd_columns_run_next_impl, _column_command_runtime
 _register("columns_stop", cmd_columns_stop_impl, _column_command_runtime)
 _register("columns_estimate", cmd_columns_estimate_impl, _column_command_runtime)
 
+# -- Agent commands --
+_register("agents_list", cmd_agents_list_impl, _agent_command_runtime)
+_register("agents_get", cmd_agents_get_impl, _agent_command_runtime)
+_register("agents_create", cmd_agents_create_impl, _agent_command_runtime)
+_register("agents_update", cmd_agents_update_impl, _agent_command_runtime)
+_register("agents_delete", cmd_agents_delete_impl, _agent_command_runtime)
+_register("agents_run", cmd_agents_run_impl, _agent_command_runtime)
+_register("agents_runs", cmd_agents_runs_impl, _agent_command_runtime)
+_register("agents_watch", cmd_agents_watch_impl, _agent_command_runtime)
+_register("agents_generate_persona", cmd_agents_generate_persona_impl, _agent_command_runtime)
+_register("agents_generate_topics", cmd_agents_generate_topics_impl, _agent_command_runtime)
+_register("agents_generate_job_signal", cmd_agents_generate_job_signal_impl, _agent_command_runtime)
+_register("agents_signals", cmd_agents_signals_impl, _agent_command_runtime)
+
 # -- Sequence commands --
 _register("sequences_list", cmd_sequences_list_impl, _sequence_command_runtime)
 _register("sequences_get", cmd_sequences_get_impl, _sequence_command_runtime)

autotouch_cli-0.2.64/autotouch_cli/commands/agents.py

@@ -0,0 +1,465 @@
+"""Scheduled agent CLI commands."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+import time
+from dataclasses import dataclass
+from typing import Any, Callable, Dict, Optional, Sequence
+
+
+@dataclass(frozen=True)
+class AgentCommandRuntime:
+    resolve_token: Callable[[Optional[str], bool], Optional[str]]
+    request_api: Callable[..., Any]
+    print_json: Callable[[Any, bool], None]
+    load_json_input: Callable[..., Any]
+    api_url: Callable[[Optional[str]], str]
+    default_timeout_seconds: int
+
+
+# ---------------------------------------------------------------------------
+# CRUD
+# ---------------------------------------------------------------------------
+
+def cmd_agents_list(args: argparse.Namespace, *, runtime: AgentCommandRuntime) -> None:
+    token = runtime.resolve_token(args.token, required=True)
+    data = runtime.request_api(
+        "GET", "/api/agents",
+        base_url=args.base_url, token=token,
+        use_x_api_key=args.use_x_api_key,
+        timeout=args.timeout, verbose=args.verbose,
+    )
+    runtime.print_json(data, args.compact)
+
+
+def cmd_agents_get(args: argparse.Namespace, *, runtime: AgentCommandRuntime) -> None:
+    token = runtime.resolve_token(args.token, required=True)
+    data = runtime.request_api(
+        "GET", f"/api/agents/{args.agent_id}",
+        base_url=args.base_url, token=token,
+        use_x_api_key=args.use_x_api_key,
+        timeout=args.timeout, verbose=args.verbose,
+    )
+    runtime.print_json(data, args.compact)
+
+
+def cmd_agents_create(args: argparse.Namespace, *, runtime: AgentCommandRuntime) -> None:
+    token = runtime.resolve_token(args.token, required=True)
+
+    if getattr(args, "from_file", None):
+        payload = runtime.load_json_input(args.from_file)
+    else:
+        payload: Dict[str, Any] = {}
+        if args.name:
+            payload["name"] = args.name
+        if args.target:
+            payload["targetType"] = args.target
+        if args.assigned_user:
+            payload["assignedUserId"] = args.assigned_user
+        if args.schedule_time:
+            tz = getattr(args, "schedule_tz", None) or "UTC"
+            payload["schedule"] = {"timezone": tz, "timeOfDay": args.schedule_time}
+        if getattr(args, "auto_find_email", False):
+            payload["autoFindEmail"] = True
+        if getattr(args, "auto_find_phone", False):
+            payload["autoFindPhone"] = True
+        if getattr(args, "auto_broaden", False):
+            payload["autoBroadenSearch"] = True
+        status = getattr(args, "status", None)
+        if status:
+            payload["status"] = status
+
+    # AI generation: generate persona, signals, and create in one shot
+    if getattr(args, "generate", False) and "personaConfig" not in payload:
+        target = payload.get("targetType", "LEADS")
+        sys.stderr.write(f"Generating persona for {target}...\n")
+        persona_data = runtime.request_api(
+            "POST", "/api/agents/generate-persona",
+            base_url=args.base_url, token=token,
+            use_x_api_key=args.use_x_api_key,
+            json={"targetType": target},
+            timeout=args.timeout, verbose=args.verbose,
+        )
+        persona = persona_data.get("persona") or persona_data.get("personaConfig") or {}
+        payload["personaConfig"] = persona
+        sys.stderr.write(f"  Persona generated: {json.dumps(persona, ensure_ascii=False)[:200]}...\n")
+
+        # Generate topics
+        sys.stderr.write("Generating topic suggestions...\n")
+        topic_data = runtime.request_api(
+            "POST", "/api/agents/generate-signal-topics",
+            base_url=args.base_url, token=token,
+            use_x_api_key=args.use_x_api_key,
+            json={"targetType": target, "personaConfig": persona},
+            timeout=args.timeout, verbose=args.verbose,
+        )
+        topics = topic_data.get("topics") or []
+        sys.stderr.write(f"  Topics: {topics}\n")
+
+        # Generate job signal
+        sys.stderr.write("Generating job signal config...\n")
+        job_data = runtime.request_api(
+            "POST", "/api/agents/generate-job-signal",
+            base_url=args.base_url, token=token,
+            use_x_api_key=args.use_x_api_key,
+            json={"targetType": target, "personaConfig": persona},
+            timeout=args.timeout, verbose=args.verbose,
+        )
+        job_titles = job_data.get("jobTitles") or []
+        job_keywords = job_data.get("keywords") or []
+        sys.stderr.write(f"  Job titles: {job_titles}\n")
+
+        # Assemble signals
+        signals = []
+        if topics:
+            signals.append({
+                "key": "linkedin-topic-post-engagement",
+                "config": {"topics": [{"id": "", "label": t, "trackingMode": "all"} for t in topics[:5]]},
+            })
+        if job_titles or job_keywords:
+            signals.append({
+                "key": "hiring-signals",
+                "config": {"jobTitles": job_titles, "keywords": job_keywords, "remoteOnly": False, "lookbackWindow": "7d"},
+            })
+
+        # News scan: derive buying trigger topics from persona
+        news_topics = ["raised funding", "new executive hire"]
+        industries = (persona.get("industries") or [])[:2]
+        if industries:
+            news_topics.append(f"expansion {industries[0]}")
+        signals.append({
+            "key": "news-scan",
+            "config": {"topics": news_topics, "lookback": "24h"},
+        })
+
+        if signals:
+            payload["selectedSignals"] = signals
+
+    data = runtime.request_api(
+        "POST", "/api/agents",
+        base_url=args.base_url, token=token,
+        use_x_api_key=args.use_x_api_key,
+        json=payload,
+        timeout=args.timeout, verbose=args.verbose,
+    )
+    runtime.print_json(data, args.compact)
+
+
+def cmd_agents_update(args: argparse.Namespace, *, runtime: AgentCommandRuntime) -> None:
+    token = runtime.resolve_token(args.token, required=True)
+
+    if getattr(args, "from_file", None):
+        payload = runtime.load_json_input(args.from_file)
+    else:
+        payload: Dict[str, Any] = {}
+        if getattr(args, "name", None):
+            payload["name"] = args.name
+        if getattr(args, "status", None):
+            payload["status"] = args.status
+        if getattr(args, "auto_find_email", None) is not None:
+            payload["autoFindEmail"] = args.auto_find_email
+        if getattr(args, "auto_find_phone", None) is not None:
+            payload["autoFindPhone"] = args.auto_find_phone
+        if getattr(args, "auto_broaden", None) is not None:
+            payload["autoBroadenSearch"] = args.auto_broaden
+
+    data = runtime.request_api(
+        "PATCH", f"/api/agents/{args.agent_id}",
+        base_url=args.base_url, token=token,
+        use_x_api_key=args.use_x_api_key,
+        json=payload,
+        timeout=args.timeout, verbose=args.verbose,
+    )
+    runtime.print_json(data, args.compact)
+
+
+def cmd_agents_delete(args: argparse.Namespace, *, runtime: AgentCommandRuntime) -> None:
+    token = runtime.resolve_token(args.token, required=True)
+    data = runtime.request_api(
+        "PATCH", f"/api/agents/{args.agent_id}",
+        base_url=args.base_url, token=token,
+        use_x_api_key=args.use_x_api_key,
+        json={"status": "DRAFT"},
+        timeout=args.timeout, verbose=args.verbose,
+    )
+    sys.stderr.write(f"Agent {args.agent_id} deleted.\n")
+    runtime.print_json(data, args.compact)
+
+
+# ---------------------------------------------------------------------------
+# Run management
+# ---------------------------------------------------------------------------
+
+def cmd_agents_run(args: argparse.Namespace, *, runtime: AgentCommandRuntime) -> None:
+    token = runtime.resolve_token(args.token, required=True)
+    data = runtime.request_api(
+        "POST", f"/api/agents/{args.agent_id}/run-now",
+        base_url=args.base_url, token=token,
+        use_x_api_key=args.use_x_api_key,
+        timeout=args.timeout, verbose=args.verbose,
+    )
+    runtime.print_json(data, args.compact)
+
+
+def cmd_agents_runs(args: argparse.Namespace, *, runtime: AgentCommandRuntime) -> None:
+    token = runtime.resolve_token(args.token, required=True)
+    params = {"limit": max(1, int(getattr(args, "limit", 10) or 10))}
+    data = runtime.request_api(
+        "GET", f"/api/agents/{args.agent_id}/runs",
+        base_url=args.base_url, token=token,
+        use_x_api_key=args.use_x_api_key,
+        params=params,
+        timeout=args.timeout, verbose=args.verbose,
+    )
+    runtime.print_json(data, args.compact)
+
+
+def cmd_agents_watch(args: argparse.Namespace, *, runtime: AgentCommandRuntime) -> None:
+    """Trigger a run and poll until complete."""
+    token = runtime.resolve_token(args.token, required=True)
+
+    # Trigger
+    run_data = runtime.request_api(
+        "POST", f"/api/agents/{args.agent_id}/run-now",
+        base_url=args.base_url, token=token,
+        use_x_api_key=args.use_x_api_key,
+        timeout=args.timeout, verbose=args.verbose,
+    )
+    run_id = run_data.get("id", "")
+    sys.stderr.write(f"Run {run_id} queued. Watching...\n")
+
+    interval = max(5, int(getattr(args, "interval", 10) or 10))
+    max_wait = max(60, int(getattr(args, "max_wait", 1800) or 1800))
+    elapsed = 0
+
+    while elapsed < max_wait:
+        time.sleep(interval)
+        elapsed += interval
+
+        runs_data = runtime.request_api(
+            "GET", f"/api/agents/{args.agent_id}/runs",
+            base_url=args.base_url, token=token,
+            use_x_api_key=args.use_x_api_key,
+            params={"limit": 1},
+            timeout=args.timeout, verbose=args.verbose,
+        )
+        runs = runs_data.get("runs", [])
+        if not runs:
+            continue
+
+        latest = runs[0]
+        status = latest.get("status", "")
+        leads = latest.get("resultCounts", {}).get("leads", 0)
+        sys.stderr.write(f"  [{elapsed}s] {status} | leads={leads}\n")
+
+        if status in ("SUCCEEDED", "FAILED"):
+            runtime.print_json(latest, args.compact)
+            return
+
+    sys.stderr.write(f"Timed out after {max_wait}s. Run may still be in progress.\n")
+
+
+# ---------------------------------------------------------------------------
+# AI generation
+# ---------------------------------------------------------------------------
+
+def cmd_agents_generate_persona(args: argparse.Namespace, *, runtime: AgentCommandRuntime) -> None:
+    token = runtime.resolve_token(args.token, required=True)
+    payload: Dict[str, Any] = {"targetType": getattr(args, "target", "LEADS") or "LEADS"}
+
+    current = getattr(args, "current_config", None)
+    if current:
+        payload["currentPersonaConfig"] = runtime.load_json_input(current)
+
+    data = runtime.request_api(
+        "POST", "/api/agents/generate-persona",
+        base_url=args.base_url, token=token,
+        use_x_api_key=args.use_x_api_key,
+        json=payload,
+        timeout=args.timeout, verbose=args.verbose,
+    )
+    runtime.print_json(data, args.compact)
+
+
+def cmd_agents_generate_topics(args: argparse.Namespace, *, runtime: AgentCommandRuntime) -> None:
+    token = runtime.resolve_token(args.token, required=True)
+    payload: Dict[str, Any] = {"targetType": getattr(args, "target", "LEADS") or "LEADS"}
+
+    persona = getattr(args, "persona", None)
+    if persona:
+        payload["personaConfig"] = runtime.load_json_input(persona)
+
+    current = getattr(args, "current_topics", None)
+    if current:
+        payload["currentTopics"] = [t.strip() for t in current.split(",") if t.strip()]
+
+    data = runtime.request_api(
+        "POST", "/api/agents/generate-signal-topics",
+        base_url=args.base_url, token=token,
+        use_x_api_key=args.use_x_api_key,
+        json=payload,
+        timeout=args.timeout, verbose=args.verbose,
+    )
+    runtime.print_json(data, args.compact)
+
+
+def cmd_agents_generate_job_signal(args: argparse.Namespace, *, runtime: AgentCommandRuntime) -> None:
+    token = runtime.resolve_token(args.token, required=True)
+    payload: Dict[str, Any] = {"targetType": getattr(args, "target", "LEADS") or "LEADS"}
+
+    persona = getattr(args, "persona", None)
+    if persona:
+        payload["personaConfig"] = runtime.load_json_input(persona)
+
+    current_titles = getattr(args, "current_titles", None)
+    if current_titles:
+        payload["currentJobTitles"] = [t.strip() for t in current_titles.split(",") if t.strip()]
+
+    current_keywords = getattr(args, "current_keywords", None)
+    if current_keywords:
+        payload["currentKeywords"] = [k.strip() for k in current_keywords.split(",") if k.strip()]
+
+    data = runtime.request_api(
+        "POST", "/api/agents/generate-job-signal",
+        base_url=args.base_url, token=token,
+        use_x_api_key=args.use_x_api_key,
+        json=payload,
+        timeout=args.timeout, verbose=args.verbose,
+    )
+    runtime.print_json(data, args.compact)
+
+
+# ---------------------------------------------------------------------------
+# Skill packs / signals
+# ---------------------------------------------------------------------------
+
+def cmd_agents_signals(args: argparse.Namespace, *, runtime: AgentCommandRuntime) -> None:
+    token = runtime.resolve_token(args.token, required=True)
+    data = runtime.request_api(
+        "GET", "/api/agents/skill-packs",
+        base_url=args.base_url, token=token,
+        use_x_api_key=args.use_x_api_key,
+        timeout=args.timeout, verbose=args.verbose,
+    )
+    runtime.print_json(data, args.compact)
+
+
+# ---------------------------------------------------------------------------
+# Parser registration
+# ---------------------------------------------------------------------------
+
+def register_agents_subcommands(
+    subparsers: argparse._SubParsersAction[argparse.ArgumentParser],
+    *,
+    add_api_common_arguments: Callable[[argparse.ArgumentParser], None],
+    handlers: Dict[str, Callable[[argparse.Namespace], None]],
+) -> None:
+    pa = subparsers.add_parser("agents", help="Scheduled agent management")
+    agents_sub = pa.add_subparsers(dest="agents_cmd", required=True)
+
+    # -- list --
+    pal = agents_sub.add_parser("list", help="List all agents")
+    add_api_common_arguments(pal)
+    pal.set_defaults(func=handlers["list"])
+
+    # -- get --
+    pag = agents_sub.add_parser("get", help="Get one agent by id")
+    pag.add_argument("agent_id", help="Agent ID")
+    add_api_common_arguments(pag)
+    pag.set_defaults(func=handlers["get"])
+
+    # -- create --
+    pac = agents_sub.add_parser("create", help="Create a new agent")
+    pac.add_argument("--name", help="Agent name")
+    pac.add_argument("--target", choices=["LEADS", "COMPANIES"], help="Target type")
+    pac.add_argument("--assigned-user", dest="assigned_user", help="Assigned user ID")
+    pac.add_argument("--schedule-time", dest="schedule_time", help="Time of day (HH:MM)")
+    pac.add_argument("--schedule-tz", dest="schedule_tz", help="Timezone (default: UTC)")
+    pac.add_argument("--auto-find-email", dest="auto_find_email", action="store_true", default=False, help="Enable auto email finder")
+    pac.add_argument("--auto-find-phone", dest="auto_find_phone", action="store_true", default=False, help="Enable auto phone finder")
+    pac.add_argument("--auto-broaden", dest="auto_broaden", action="store_true", default=False, help="Enable auto broaden search")
+    pac.add_argument("--status", choices=["DRAFT", "ACTIVE", "PAUSED"], help="Initial status")
+    pac.add_argument("--from-file", dest="from_file", help="Path to JSON payload file")
+    pac.add_argument("--generate", action="store_true", help="Auto-generate persona, topics, and job signal config")
+    add_api_common_arguments(pac)
+    pac.set_defaults(func=handlers["create"])
+
+    # -- update --
+    pau = agents_sub.add_parser("update", help="Update an existing agent")
+    pau.add_argument("agent_id", help="Agent ID")
+    pau.add_argument("--name", help="New agent name")
+    pau.add_argument("--status", choices=["DRAFT", "ACTIVE", "PAUSED"], help="New status")
+    pau.add_argument("--auto-find-email", dest="auto_find_email", type=_bool_arg, default=None, help="Enable/disable auto email finder")
+    pau.add_argument("--auto-find-phone", dest="auto_find_phone", type=_bool_arg, default=None, help="Enable/disable auto phone finder")
+    pau.add_argument("--auto-broaden", dest="auto_broaden", type=_bool_arg, default=None, help="Enable/disable auto broaden search")
+    pau.add_argument("--from-file", dest="from_file", help="Path to JSON patch payload file")
+    add_api_common_arguments(pau)
+    pau.set_defaults(func=handlers["update"])
+
+    # -- delete --
+    pad = agents_sub.add_parser("delete", help="Delete an agent (sets status to DRAFT)")
+    pad.add_argument("agent_id", help="Agent ID")
+    add_api_common_arguments(pad)
+    pad.set_defaults(func=handlers["delete"])
+
+    # -- run --
+    par = agents_sub.add_parser("run", help="Trigger an immediate run")
+    par.add_argument("agent_id", help="Agent ID")
+    add_api_common_arguments(par)
+    par.set_defaults(func=handlers["run"])
+
+    # -- runs --
+    pars = agents_sub.add_parser("runs", help="List recent runs for an agent")
+    pars.add_argument("agent_id", help="Agent ID")
+    pars.add_argument("--limit", type=int, default=10, help="Max runs to return (default: 10)")
+    add_api_common_arguments(pars)
+    pars.set_defaults(func=handlers["runs"])
+
+    # -- watch --
+    paw = agents_sub.add_parser("watch", help="Trigger a run and poll until complete")
+    paw.add_argument("agent_id", help="Agent ID")
+    paw.add_argument("--interval", type=int, default=10, help="Poll interval in seconds (default: 10)")
+    paw.add_argument("--max-wait", dest="max_wait", type=int, default=1800, help="Max wait in seconds (default: 1800)")
+    add_api_common_arguments(paw)
+    paw.set_defaults(func=handlers["watch"])
+
+    # -- generate-persona --
+    pagp = agents_sub.add_parser("generate-persona", help="Generate ICP persona config via AI")
+    pagp.add_argument("--target", choices=["LEADS", "COMPANIES"], default="LEADS", help="Target type")
+    pagp.add_argument("--current-config", dest="current_config", help="Path to current persona config JSON")
+    add_api_common_arguments(pagp)
+    pagp.set_defaults(func=handlers["generate_persona"])
+
+    # -- generate-topics --
+    pagt = agents_sub.add_parser("generate-topics", help="Generate signal topic suggestions via AI")
+    pagt.add_argument("--target", choices=["LEADS", "COMPANIES"], default="LEADS", help="Target type")
+    pagt.add_argument("--persona", help="Path to persona config JSON")
+    pagt.add_argument("--current-topics", dest="current_topics", help="Comma-separated current topics")
+    add_api_common_arguments(pagt)
+    pagt.set_defaults(func=handlers["generate_topics"])
+
+    # -- generate-job-signal --
+    pagj = agents_sub.add_parser("generate-job-signal", help="Generate job signal config via AI")
+    pagj.add_argument("--target", choices=["LEADS", "COMPANIES"], default="LEADS", help="Target type")
+    pagj.add_argument("--persona", help="Path to persona config JSON")
+    pagj.add_argument("--current-titles", dest="current_titles", help="Comma-separated current job titles")
+    pagj.add_argument("--current-keywords", dest="current_keywords", help="Comma-separated current keywords")
+    add_api_common_arguments(pagj)
+    pagj.set_defaults(func=handlers["generate_job_signal"])
+
+    # -- signals --
+    pass_ = agents_sub.add_parser("signals", help="List available signal skill packs")
+    add_api_common_arguments(pass_)
+    pass_.set_defaults(func=handlers["signals"])
+
+
+def _bool_arg(v: str) -> bool:
+    """Parse boolean CLI argument values."""
+    if v.lower() in ("true", "1", "yes"):
+        return True
+    if v.lower() in ("false", "0", "no"):
+        return False
+    raise argparse.ArgumentTypeError(f"Expected true/false, got: {v}")