agent-toolkit-cli 1.8.3__tar.gz → 1.8.4__tar.gz

{agent_toolkit_cli-1.8.3 → agent_toolkit_cli-1.8.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-toolkit-cli
-Version: 1.8.3
+Version: 1.8.4
 Summary: Composable AI agent toolkit — loops, skills, profiles, and MCP for Claude Code, Cursor, OpenCode, Windsurf, and more
 Project-URL: Homepage, https://github.com/ulises-jeremias/agent-toolkit
 Project-URL: Documentation, https://github.com/ulises-jeremias/agent-toolkit/tree/main/docs

{agent_toolkit_cli-1.8.3 → agent_toolkit_cli-1.8.4}/src/agent_toolkit/__init__.py

@@ -1,4 +1,4 @@
 """agent-toolkit: Composable AI agent capabilities for all major AI coding tools."""
 
-__version__ = "1.8.3"
+__version__ = "1.8.4"
 __author__ = "ulises-jeremias"

{agent_toolkit_cli-1.8.3 → agent_toolkit_cli-1.8.4}/src/agent_toolkit/swarm/cli.py

@@ -989,11 +989,26 @@ def cmd_start(args: list[str]) -> int:
                 )
     except Exception:
         pass
-    # Create artifacts placeholder
-    (run_dir / "artifacts" / "task-contract.md").write_text(
-        f"# Task Contract\n\n{task_text}\n\nRecipe: {recipe_name}\nRun: {run_id}\n",
-        encoding="utf-8",
-    )
+    # Create artifacts placeholder — interactive mode gets bootstrap note instead of empty contract
+    is_interactive_run = not task_text or not task_text.strip()
+    if is_interactive_run:
+        task_contract_body = (
+            "# Task Contract — Interactive mode (no initial task)\n\n"
+            "This swarm was started without an initial prompt. The first agent (planner/implementer) "
+            "must do a very brief context analysis and stay on standby awaiting the user's first request.\n\n"
+            "- If inside a workspace (e.g. `~/.ai-workspace`): run `agent-toolkit workspace context` and briefly review `AGENTS.md` + `knowledge/todos/pending.md`.\n"
+            "- Otherwise, briefly review the current repo (`git status`, `README.md`).\n"
+            '- Do not invent work. Confirm with: "Brief analysis done — awaiting your first request."\n\n'
+            f"Recipe: {recipe_name}\nRun: {run_id}\n"
+            f"Run dir: {run_dir}\n"
+            f"Initial roles: {', '.join(initial_roles)}\n"
+            f"When the user provides the task, apply discovery (`assistant`) + `workflow-generic-project` (plan -> approval -> implement -> draft PR).\n"
+        )
+    else:
+        task_contract_body = (
+            f"# Task Contract\n\n{task_text}\n\nRecipe: {recipe_name}\nRun: {run_id}\n"
+        )
+    (run_dir / "artifacts" / "task-contract.md").write_text(task_contract_body, encoding="utf-8")
     if ns.json:
         return _json_out(
             {

{agent_toolkit_cli-1.8.3 → agent_toolkit_cli-1.8.4}/src/agent_toolkit/swarm/prompts.py

@@ -15,6 +15,23 @@ GLOBAL_PROTOCOL = """# Agent Toolkit Swarm — Global Protocol
 - Record decisions in artifacts and trace events.
 """
 
+# Interactive bootstrap — when swarm starts without a task, the first agent must NOT invent work.
+# It does a very brief context analysis and then waits for the user to provide the first request.
+INTERACTIVE_BOOTSTRAP = """# Interactive mode — No initial task
+> This swarm was started **without an initial prompt/task**. The user will provide the first request next in this same Herdr/Tmux session.
+
+**Instructions for the first agent (planner/implementer):**
+- **Do NOT invent work** or start tasks on your own. Do not create a plan or code yet.
+- Do only a **very brief** context analysis (max 3-4 sentences / 30 seconds):
+  - If you detect a **workspace** (exists `AGENTS.md` and/or `knowledge/` or `find_workspace_root()` is not None, e.g. `~/.ai-workspace`):
+    Run `agent-toolkit workspace context` and briefly review `AGENTS.md` + `knowledge/todos/pending.md`.
+    Also check `projects/` and `loops/` if present. Summarize in 2-3 lines what workspace it is.
+  - If no workspace, briefly review the current repo (`git status`, `cat README.md` / `pyproject.toml`).
+- Then **stay on standby** and confirm with a short message:
+  "Brief analysis done — awaiting your first request. When you provide the task, I will apply `assistant` (discovery) + `workflow-generic-project` (plan -> approval -> implement -> review -> draft PR)."
+- When the user sends the request (via chat or `agent-toolkit swarm handoff create --type artifact --from planner --to implementer --artifact artifacts/task-contract.md --run-id <run-id>`), apply the full flow: discovery per `assistant` (order README -> docs/ -> AGENTS.md -> CONTRIBUTING -> PR templates -> Makefile/package.json -> devcontainer/CI), then `workflow-generic-project` with plan approval gate before implementing, and `github-cli-workflow` for draft PR.
+"""
+
 
 def load_persona_text(persona: str) -> str:
     # Load from bundled data/agents/<persona>/AGENT.md if exists
@@ -54,8 +71,23 @@ def compose_role_prompt(
     spec = recipe.get("spec", {})
     workflow = f"Execution: {spec.get('execution', {})}\nWorkspace: {spec.get('workspace', {})}\n"
     parts.append(workflow)
-    if task_contract:
+    # Empty / whitespace-only task_contract means interactive bootstrap — do not invent work
+    if task_contract and task_contract.strip():
         parts.append(f"# Task Contract\n{task_contract[:3000]}")
+    else:
+        # No task provided — inject bootstrap: analyze context very briefly, then wait for user
+        parts.append(INTERACTIVE_BOOTSTRAP)
+        # Also hint workspace context command for faster readiness
+        try:
+            from agent_toolkit._paths import find_workspace_root
+
+            ws = find_workspace_root()
+            if ws is not None:
+                parts.append(
+                    f"# Workspace context hint\nDetected workspace at `{ws}` — run `agent-toolkit workspace context` to see session state before waiting."
+                )
+        except Exception:
+            pass
     if handoff:
         parts.append(f"# Current Handoff\n{handoff}")
     if included_skills:
@@ -122,6 +154,7 @@ def compose_role_prompt(
     text = "\n\n".join(parts)
     if len(text) > 12000:
         text = text[:12000] + "\n[truncated]"
+    is_interactive = not task_contract or not task_contract.strip()
     manifest = {
         "role": role,
         "persona": persona,
@@ -131,12 +164,14 @@ def compose_role_prompt(
             "global_protocol",
             "recipe_workflow",
             "persona",
-            "task_contract" if task_contract else None,
+            "interactive_bootstrap" if is_interactive else None,
+            "task_contract" if task_contract and task_contract.strip() else None,
             "handoff" if handoff else None,
             "skills" if included_skills else None,
         ],
         "size_chars": len(text),
         "model_profile_task": role_def.get("model_profile"),
+        "is_interactive": is_interactive,
     }
     manifest["includes"] = [x for x in manifest["includes"] if x]
     return text, manifest