codee-agent 0.6.6__tar.gz → 0.6.8__tar.gz

{codee_agent-0.6.6 → codee_agent-0.6.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codee-agent
-Version: 0.6.6
+Version: 0.6.8
 Summary: A virtual co-worker that picks up Jira and Azure DevOps tasks and solves them with coding agents.
 Keywords: ai,agent,jira,azure-devops,claude-code,github-copilot,codex,automation
 Author: Denis Kibalko

{codee_agent-0.6.6 → codee_agent-0.6.8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "codee-agent"
-version = "0.6.6"
+version = "0.6.8"
 description = "A virtual co-worker that picks up Jira and Azure DevOps tasks and solves them with coding agents."
 readme = "README.md"
 license = "MIT"

{codee_agent-0.6.6 → codee_agent-0.6.8}/src/codee/admin.py

@@ -38,6 +38,7 @@ USAGE_POLL_INTERVAL = 60
 # installed or uninstalled under a running Codee, and the answer shapes the
 # page rather than anything the user can change on it.
 CLAUDE_CODE_AVAILABLE = SERVICE.claude_code_available()
+GITHUB_COPILOT_AVAILABLE = SERVICE.github_copilot_available()
 
 
 def _skill_summary(skill: dict[str, str]) -> SkillSummary:
@@ -273,6 +274,7 @@ class RunRecord(BaseModel):
     message: str
     user_message: str
     response: str
+    debug_logs: str
     preview: str
     viewer_url: str
 
@@ -360,6 +362,7 @@ class AdminState(rx.State):
 
     tasks_provider: str = "jira"
     coding_agent: str = "claude_code"
+    github_copilot_prompt_prefix: str = ""
     max_parallel_agents: str = "3"
     agent_test_open: bool = False
     agent_test_input: str = ""
@@ -856,6 +859,7 @@ class AdminState(rx.State):
                 message=message,
                 user_message=(run.get("user_message") or message).strip(),
                 response=(run.get("response") or "").strip(),
+                debug_logs=run.get("debug_logs") or "",
                 preview=preview[:120] + ("..." if len(preview) > 120 else ""),
                 viewer_url=(SERVICE.session_viewer.format(session_id=run["session_id"])
                             if SERVICE.session_viewer and run.get("session_id") else ""),
@@ -971,6 +975,7 @@ class AdminState(rx.State):
         settings = SERVICE.load_settings()
         self.tasks_provider = settings.tasks_provider.value
         self.coding_agent = settings.coding_agent.value
+        self.github_copilot_prompt_prefix = settings.github_copilot_prompt_prefix
         self.max_parallel_agents = str(settings.max_parallel_agents)
         self.claude_code_rotate_keys = settings.claude_code_rotate_keys
         self._cancel_claude_code_sign_in()
@@ -1205,6 +1210,9 @@ class AdminState(rx.State):
     def set_coding_agent(self, value: str) -> None:
         self.coding_agent = value
 
+    def set_github_copilot_prompt_prefix(self, value: str) -> None:
+        self.github_copilot_prompt_prefix = value
+
     def set_max_parallel_agents(self, value: str) -> None:
         self.max_parallel_agents = value
 
@@ -1547,6 +1555,7 @@ class AdminState(rx.State):
             work_item_queries,
             self._task_filter(),
             self.claude_code_rotate_keys,
+            self.github_copilot_prompt_prefix,
         )
         # Saving is what picks the first account when rotation has just been
         # switched on, so the badge has to be redrawn from what that decided.
@@ -2547,7 +2556,7 @@ def run_row(run: RunRecord) -> rx.Component:
             rx.cond(run.viewer_url != "", rx.link(rx.icon("external-link", size=16), href=run.viewer_url,
                                                   is_external=True, aria_label="View session", color=ACCENT)),
             gap="1rem", align="start", width="100%"),
-        rx.cond((run.user_message != "") | (run.response != ""), rx.accordion.root(rx.accordion.item(
+        rx.cond((run.user_message != "") | (run.response != "") | (run.debug_logs != ""), rx.accordion.root(rx.accordion.item(
             header="Run info", content=rx.vstack(
                 rx.text("User message", font_weight="600"),
                 rx.text(run.user_message, white_space="pre-wrap"),
@@ -2555,6 +2564,12 @@ def run_row(run: RunRecord) -> rx.Component:
                     rx.text("LLM response", font_weight="600",
                             margin_top="0.75rem"),
                     rx.text(run.response, white_space="pre-wrap"))),
+                rx.cond(run.debug_logs != "", rx.fragment(
+                        rx.text("Debug logs", font_weight="600",
+                                margin_top="0.75rem"),
+                        rx.text(run.debug_logs, white_space="pre-wrap",
+                                font_family="IBM Plex Mono, monospace",
+                                font_size="0.8rem"))),
                 spacing="2", align="start", width="100%"), value=run.started_at),
             collapsible=True, width="100%")),
         padding="1rem", background=SURFACE, border=BORDER, width="100%")
@@ -3355,6 +3370,28 @@ def claude_code_setting() -> rx.Component:
         padding="1.25rem", background=SURFACE, border=BORDER, width="100%")
 
 
+def github_copilot_setting() -> rx.Component:
+    """Settings used only by GitHub Copilot CLI runs."""
+    return rx.box(
+        rx.heading("GitHub Copilot", size="4", margin_bottom="1rem"),
+        field(
+            "Prompt prefix",
+            rx.text_area(
+                value=AdminState.github_copilot_prompt_prefix,
+                on_change=AdminState.set_github_copilot_prompt_prefix,
+                placeholder="Instructions added before every Copilot prompt",
+                width="100%",
+                min_height="7rem",
+            ),
+            rx.text(
+                "Added to the beginning of every prompt sent to GitHub Copilot.",
+                color=MUTED,
+                font_size="0.82rem",
+            ),
+        ),
+        padding="1.25rem", background=SURFACE, border=BORDER, width="100%")
+
+
 def conversation_message(message: ConversationMessage) -> rx.Component:
     is_user = message.role == "user"
     return rx.box(
@@ -3532,6 +3569,7 @@ def settings_page() -> rx.Component:
         # which agents a machine has is not state: there is no event that could
         # ever flip it, and nothing on the page should be able to.
         claude_code_setting() if CLAUDE_CODE_AVAILABLE else rx.fragment(),
+        github_copilot_setting() if GITHUB_COPILOT_AVAILABLE else rx.fragment(),
         rx.box(
             rx.heading("Tasks provider", size="4", margin_bottom="1rem"),
             field("Provider", rx.select(["jira", "azure_devops"], value=AdminState.tasks_provider,

{codee_agent-0.6.6 → codee_agent-0.6.8}/src/codee/admin_service.py

@@ -26,6 +26,7 @@ from codee_agent_claude_code.provider import ClaudeCodeAgent
 from codee_agent_claude_code.usage import (
     SESSION_WINDOW, WEEKLY_WINDOW, UsageRateLimited, UsageUnavailable,
     fetch_usage)
+from codee_agent_github_copilot.provider import GitHubCopilotAgent
 from codee_tasks_abstract.provider import (
     AbstractTasksProvider, TasksProviderError)
 from codee.coding_agents import (
@@ -2109,6 +2110,7 @@ class AdminService:
         work_item_queries: dict[str, str] | None = None,
         task_filter: str = "",
         claude_code_rotate_keys: bool = False,
+        github_copilot_prompt_prefix: str | None = None,
     ) -> None:
         current = self.context.settings
         all_credentials = dict(current.credentials)
@@ -2132,6 +2134,10 @@ class AdminService:
         self.context.settings = Settings(
             tasks_provider=TasksProvider(tasks_provider),
             coding_agent=CodingAgent(coding_agent),
+            github_copilot_prompt_prefix=(
+                current.github_copilot_prompt_prefix
+                if github_copilot_prompt_prefix is None
+                else github_copilot_prompt_prefix.strip()),
             credentials=all_credentials,
             work_item_types=all_work_items,
             work_item_queries=all_work_item_queries,
@@ -2152,6 +2158,10 @@ class AdminService:
         """
         return ClaudeCodeAgent.is_installed()
 
+    def github_copilot_available(self) -> bool:
+        """Whether this machine has the GitHub Copilot CLI installed."""
+        return GitHubCopilotAgent.is_installed()
+
     def claude_code_accounts(self) -> list[ConnectedAccount]:
         """The connected accounts, in rotation order, for the settings page."""
         try:

{codee_agent-0.6.6 → codee_agent-0.6.8}/src/codee/executor.py

@@ -1,4 +1,5 @@
 import json
+import os
 import subprocess
 import threading
 import time
@@ -9,11 +10,12 @@ from datetime import datetime, timezone
 from codee_agent_abstract.provider import AbstractCodingAgent
 from codee_agent_claude_code.provider import ClaudeCodeAgent
 from codee_agent_codex.provider import CodexAgent
-from codee_agent_github_copilot.provider import GitHubCopilotAgent
+from codee_agent_github_copilot.provider import (
+    COPILOT_DEBUG_ENV_VAR, GitHubCopilotAgent)
 from codee_main_context.context import (
     CodeeMainContext, CodingAgent, Settings, codee_issue_types, data_dir,
     load_settings, project_root)
-from codee_main_context.logging import configure_logging, get_logger
+from codee_main_context.logging import DEBUG_ENV_VAR, configure_logging, get_logger
 from codee_tasks_abstract.provider import AbstractTasksProvider
 
 from codee.coding_agents import resolve_agent_code
@@ -70,6 +72,13 @@ def _max_parallel_agents() -> int:
     return max(1, context.settings.max_parallel_agents)
 
 
+def _log_debug_environment() -> None:
+    if os.environ.get(COPILOT_DEBUG_ENV_VAR, "").strip().lower() == "true":
+        log.info("COPILOT_DEBUG=true (Copilot CLI debug logs enabled)")
+    if os.environ.get(DEBUG_ENV_VAR, "").strip() == "1":
+        log.info("CODEE_DEBUG=1 (Codee debug logging enabled)")
+
+
 def _load_sessions() -> dict[str, str]:
     """Load task_id -> session_id mapping from disk."""
     if SESSIONS_FILE.exists():
@@ -276,7 +285,8 @@ def _run_agent(user_message: str, session_id: str, model: str = "",
         """
         if agent_session_id == session_id:
             return
-        log.debug("job %s runs under agent session %s", job_id, agent_session_id)
+        log.debug("job %s runs under agent session %s",
+                  job_id, agent_session_id)
         runs_db.note_agent_session(session_id, agent_session_id)
         runs_db.set_job_session(job_id, agent_session_id, main_context=context)
 
@@ -460,6 +470,7 @@ def main() -> None:
     # Entry point: install the handler before anything logs. Level comes from
     # CODEE_DEBUG, which `codee-start --debug` exports for this subprocess.
     configure_logging()
+    _log_debug_environment()
 
     if not tasks_provider.is_configured():
         log.warning("tasks provider is not configured; task polling stays "

{codee_agent-0.6.6 → codee_agent-0.6.8}/src/codee/lib/runs_db.py

@@ -11,7 +11,7 @@ from codee_main_context.context import CodeeMainContext
 from codee_database.database import get_db_connection
 
 _COLUMNS = ("id", "skill_name", "trigger_type", "session_id", "status", "error",
-            "started_at", "message", "user_message", "response")
+            "started_at", "message", "user_message", "response", "debug_logs")
 
 # Codee names a session before the agent runs, but not every agent runs under
 # the name it was given: Codex mints its own thread id and reports it back mid
@@ -52,7 +52,8 @@ def init(main_context: CodeeMainContext) -> None:
                 started_at TEXT NOT NULL,
                 message TEXT,
                 user_message TEXT,
-                response TEXT
+                response TEXT,
+                debug_logs TEXT
             )"""
         )
         conn.execute(
@@ -65,6 +66,8 @@ def init(main_context: CodeeMainContext) -> None:
             conn.execute("ALTER TABLE runs ADD COLUMN response TEXT")
         if "user_message" not in cols:
             conn.execute("ALTER TABLE runs ADD COLUMN user_message TEXT")
+        if "debug_logs" not in cols:
+            conn.execute("ALTER TABLE runs ADD COLUMN debug_logs TEXT")
         # In-flight claude runs; a row lives only while its subprocess is running.
         conn.execute(
             """CREATE TABLE IF NOT EXISTS active_jobs (
@@ -77,28 +80,33 @@ def init(main_context: CodeeMainContext) -> None:
             )"""
         )
         # Migrate DBs created before the dashboard named the agent behind a run.
-        job_cols = {row[1] for row in conn.execute("PRAGMA table_info(active_jobs)")}
+        job_cols = {row[1] for row in conn.execute(
+            "PRAGMA table_info(active_jobs)")}
         for column in ("agent", "model"):
             if column not in job_cols:
-                conn.execute(f"ALTER TABLE active_jobs ADD COLUMN {column} TEXT")
+                conn.execute(
+                    f"ALTER TABLE active_jobs ADD COLUMN {column} TEXT")
 
 
 def record_run(skill_name, trigger_type, session_id, status, error=None, started_at=None,
-               message=None, user_message=None, response=None,
+               message=None, user_message=None, response=None, debug_logs=None,
                *, main_context: CodeeMainContext) -> None:
     """Insert one run row. Never raises to the caller (FR-009)."""
     try:
         init(main_context)
         session_id = agent_session(session_id)
+        if debug_logs is None:
+            debug_logs = getattr(response, "debug_logs", None)
         if started_at is None:
             started_at = datetime.now(timezone.utc).isoformat()
         with get_db_connection(main_context) as conn:
             conn.execute(
                 "INSERT INTO runs (skill_name, trigger_type, session_id, status, error,"
-                " started_at, message, user_message, response)"
-                " VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)",
+                " started_at, message, user_message, response, debug_logs)"
+                " VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)",
                 (skill_name, trigger_type, session_id,
-                 status, error, started_at, message, user_message, response),
+                 status, error, started_at, message, user_message, response,
+                 debug_logs),
             )
     except Exception as exc:  # ponytail: a logging miss must never abort the skill run
         print(f"[runs_db] Failed to record run for {skill_name}: {exc}")
@@ -112,7 +120,7 @@ def recent_runs(limit: int = 100, offset: int = 0, *,
         with get_db_connection(main_context) as conn:
             rows = conn.execute(
                 "SELECT id, skill_name, trigger_type, session_id, status, error,"
-                " started_at, message, user_message, response"
+                " started_at, message, user_message, response, debug_logs"
                 " FROM runs ORDER BY started_at DESC, id DESC LIMIT ? OFFSET ?",
                 (limit, max(offset, 0)),
             ).fetchall()

{codee_agent-0.6.6 → codee_agent-0.6.8}/src/codee/lib/test_runs_db.py

@@ -30,7 +30,8 @@ def test_round_trip_newest_first(tmp_path):
                        started_at="2026-06-27T11:00:00+00:00", main_context=ctx)
 
     rows = runs_db.recent_runs(main_context=ctx)
-    assert [r["skill_name"] for r in rows] == ["skill-b", "skill-a"]  # newest first
+    assert [r["skill_name"] for r in rows] == [
+        "skill-b", "skill-a"]  # newest first
     assert rows[0]["trigger_type"] == "email"
     assert rows[0]["status"] == "failed"
     assert rows[0]["error"] == "boom"
@@ -74,7 +75,8 @@ def test_main_context_is_required():
             call()
         except TypeError:
             continue
-        raise AssertionError("main_context must be a required keyword argument")
+        raise AssertionError(
+            "main_context must be a required keyword argument")
 
 
 # ---------------------------------------------------------------- counts() (US1)
@@ -85,9 +87,12 @@ def _ago(hours):
 def test_counts_total_and_last_24h(tmp_path):
     ctx = _ctx(tmp_path)
     # Two inside the 24h window, one well outside, one exactly at the boundary (excluded, strict >).
-    runs_db.record_run("a", "cron", "s1", "succeeded", started_at=_ago(1), main_context=ctx)
-    runs_db.record_run("b", "cron", "s2", "succeeded", started_at=_ago(23), main_context=ctx)
-    runs_db.record_run("c", "cron", "s3", "succeeded", started_at=_ago(48), main_context=ctx)
+    runs_db.record_run("a", "cron", "s1", "succeeded",
+                       started_at=_ago(1), main_context=ctx)
+    runs_db.record_run("b", "cron", "s2", "succeeded",
+                       started_at=_ago(23), main_context=ctx)
+    runs_db.record_run("c", "cron", "s3", "succeeded",
+                       started_at=_ago(48), main_context=ctx)
     assert runs_db.counts(ctx) == {"total": 3, "last_24h": 2}
 
 
@@ -101,17 +106,22 @@ def test_counts_never_raises_on_bad_path(tmp_path):
 
 def test_runs_by_hour_buckets(tmp_path):
     ctx = _ctx(tmp_path)
-    runs_db.record_run("a", "cron", "s1", "succeeded", started_at=_ago(2), main_context=ctx)
-    runs_db.record_run("b", "cron", "s2", "succeeded", started_at=_ago(2.1), main_context=ctx)
-    runs_db.record_run("c", "cron", "s3", "succeeded", started_at=_ago(48), main_context=ctx)  # out of window
+    runs_db.record_run("a", "cron", "s1", "succeeded",
+                       started_at=_ago(2), main_context=ctx)
+    runs_db.record_run("b", "cron", "s2", "succeeded",
+                       started_at=_ago(2.1), main_context=ctx)
+    runs_db.record_run("c", "cron", "s3", "succeeded",
+                       started_at=_ago(48), main_context=ctx)  # out of window
 
     hourly = runs_db.runs_by_hour(ctx)
     assert len(hourly) == 24  # always 24 buckets
     # oldest-first: buckets are the last 24 hour labels in ascending time order
     now = datetime.now(timezone.utc).replace(minute=0, second=0, microsecond=0)
-    expected = [(now - timedelta(hours=h)).strftime("%H:00") for h in range(23, -1, -1)]
+    expected = [(now - timedelta(hours=h)).strftime("%H:00")
+                for h in range(23, -1, -1)]
     assert [h["hour"] for h in hourly] == expected
-    assert sum(h["runs"] for h in hourly) == 2  # 48h-old run excluded; the two ~2h-old runs counted
+    # 48h-old run excluded; the two ~2h-old runs counted
+    assert sum(h["runs"] for h in hourly) == 2
 
 
 def test_runs_by_hour_empty_and_bad_path(tmp_path):
@@ -123,10 +133,14 @@ def test_runs_by_hour_empty_and_bad_path(tmp_path):
 # ---------------------------------------------------------------- message column (US2)
 def test_message_round_trip(tmp_path):
     ctx = _ctx(tmp_path)
-    runs_db.record_run("a", "cron", "s1", "succeeded", message="hello", main_context=ctx)
-    runs_db.record_run("b", "email", "s2", "succeeded", message="", main_context=ctx)
-    runs_db.record_run("c", "aws-sqs", "s3", "succeeded", main_context=ctx)  # message defaults None
-    by_skill = {r["skill_name"]: r["message"] for r in runs_db.recent_runs(main_context=ctx)}
+    runs_db.record_run("a", "cron", "s1", "succeeded",
+                       message="hello", main_context=ctx)
+    runs_db.record_run("b", "email", "s2", "succeeded",
+                       message="", main_context=ctx)
+    runs_db.record_run("c", "aws-sqs", "s3", "succeeded",
+                       main_context=ctx)  # message defaults None
+    by_skill = {r["skill_name"]: r["message"]
+                for r in runs_db.recent_runs(main_context=ctx)}
     assert by_skill == {"a": "hello", "b": "", "c": None}
 
 
@@ -141,6 +155,19 @@ def test_response_round_trip(tmp_path):
     assert run["response"] == "final answer"
 
 
+def test_debug_logs_are_extracted_from_the_agent_response(tmp_path):
+    from codee_agent_abstract.provider import AgentResponse
+
+    ctx = _ctx(tmp_path)
+    response = AgentResponse("final answer", "debug one\ndebug two\n")
+    runs_db.record_run("a", "cron", "s1", "succeeded", response=response,
+                       main_context=ctx)
+
+    run, = runs_db.recent_runs(main_context=ctx)
+    assert run["response"] == "final answer"
+    assert run["debug_logs"] == "debug one\ndebug two\n"
+
+
 # ---------------------------------------------------------------- active_jobs
 def test_active_job_lifecycle(tmp_path):
     ctx = _ctx(tmp_path)
@@ -195,7 +222,8 @@ def test_active_jobs_elapsed_and_order(tmp_path):
     runs_db.start_job("young", "b", started_at=_ago(0.01), main_context=ctx)
     runs_db.start_job("old", "a", started_at=_ago(1), main_context=ctx)
     jobs = runs_db.active_jobs(ctx)
-    assert [j["session_id"] for j in jobs] == ["young", "old"]  # youngest first
+    assert [j["session_id"]
+            for j in jobs] == ["young", "old"]  # youngest first
     assert jobs[1]["elapsed"] >= 3500  # ~1h old
 
 
@@ -262,7 +290,8 @@ def test_set_job_session_repoints_a_live_job(tmp_path):
 
     runs_db.set_job_session(job_id, "codex-thread", main_context=ctx)
 
-    assert runs_db.active_jobs(main_context=ctx)[0]["session_id"] == "codex-thread"
+    assert runs_db.active_jobs(main_context=ctx)[
+        0]["session_id"] == "codex-thread"
 
 
 def test_set_job_session_is_a_no_op_without_a_job(tmp_path):
@@ -280,7 +309,8 @@ def test_a_noted_agent_session_is_what_the_run_records(tmp_path):
     runs_db.record_run("skill-a", "issue", "codee-sid", "succeeded",
                        main_context=ctx)
 
-    assert runs_db.recent_runs(main_context=ctx)[0]["session_id"] == "codex-thread"
+    assert runs_db.recent_runs(main_context=ctx)[
+        0]["session_id"] == "codex-thread"
 
 
 def test_the_note_is_consumed_so_a_later_run_keeps_its_own_id(tmp_path):

{codee_agent-0.6.6 → codee_agent-0.6.8}/src/codee/test_admin_service.py

@@ -258,6 +258,21 @@ class AdminServiceWorkItemsTest(unittest.TestCase):
 
             self.assertEqual(load_settings(directory).task_filters["jira"], "")
 
+    def test_saving_preserves_the_github_copilot_prompt_prefix(self) -> None:
+        with tempfile.TemporaryDirectory() as temporary_directory:
+            directory = Path(temporary_directory)
+            service = self._service(directory)
+
+            service.save_settings(
+                "jira", "github_copilot", 3, {},
+                github_copilot_prompt_prefix="Follow repository policy.",
+            )
+
+            self.assertEqual(
+                load_settings(directory).github_copilot_prompt_prefix,
+                "Follow repository policy.",
+            )
+
     def test_saving_keeps_the_other_provider_s_work_item_queries(self) -> None:
         # A JQL condition means nothing to Azure DevOps, so each provider keeps
         # its own and switching between them loses neither.

{codee_agent-0.6.6 → codee_agent-0.6.8}/src/codee/test_executor.py

@@ -19,6 +19,28 @@ from codee.lib import runs_db
 from codee.lib.trigger_issue_skills import IssueTriggeredSkill
 
 
+class DebugEnvironmentLoggingTest(unittest.TestCase):
+    def test_enabled_debug_flags_are_logged_at_startup(self) -> None:
+        with patch.dict(os.environ, {
+            "COPILOT_DEBUG": "TRUE",
+            "CODEE_DEBUG": "1",
+        }, clear=True), patch.object(executor.log, "info") as info:
+            executor._log_debug_environment()
+
+        info.assert_any_call(
+            "COPILOT_DEBUG=true (Copilot CLI debug logs enabled)")
+        info.assert_any_call("CODEE_DEBUG=1 (Codee debug logging enabled)")
+
+    def test_disabled_debug_flags_are_not_logged(self) -> None:
+        with patch.dict(os.environ, {
+            "COPILOT_DEBUG": "false",
+            "CODEE_DEBUG": "true",
+        }, clear=True), patch.object(executor.log, "info") as info:
+            executor._log_debug_environment()
+
+        info.assert_not_called()
+
+
 class RefreshConfigTest(unittest.TestCase):
     """The executor re-reads settings.json each poll, so edits need no restart."""
 
@@ -68,7 +90,8 @@ class RefreshConfigTest(unittest.TestCase):
 
         executor._refresh_config()
 
-        self.assertIsInstance(executor.tasks_provider, AzureDevOpsTasksProvider)
+        self.assertIsInstance(executor.tasks_provider,
+                              AzureDevOpsTasksProvider)
         self.assertEqual(executor.context.settings.tasks_provider,
                          TasksProvider.AZURE_DEVOPS)
 
@@ -446,10 +469,12 @@ class ParentWorkItemSkipTest(unittest.TestCase):
         self.provider.is_configured.return_value = True
         self.skills = [
             IssueTriggeredSkill(name="Task developer", slug="task-developer",
-                                path=Path("/repo/.claude/skills/task/SKILL.md"),
+                                path=Path(
+                                    "/repo/.claude/skills/task/SKILL.md"),
                                 statuses=("Ready",), issue_type="task"),
             IssueTriggeredSkill(name="Story developer", slug="story-developer",
-                                path=Path("/repo/.claude/skills/story/SKILL.md"),
+                                path=Path(
+                                    "/repo/.claude/skills/story/SKILL.md"),
                                 statuses=("Ready",), issue_type="story"),
         ]
         for name in ("trigger_cron_skills", "trigger_aws_sqs_skills",

{codee_agent-0.6.6 → codee_agent-0.6.8}/src/codee_agent_abstract/provider.py

@@ -19,6 +19,17 @@ class AgentModel:
     name: str
 
 
+class AgentResponse(str):
+    """Agent text with optional diagnostic output for the run record."""
+
+    debug_logs: str
+
+    def __new__(cls, response: str, debug_logs: str = "") -> "AgentResponse":
+        value = super().__new__(cls, response)
+        value.debug_logs = debug_logs
+        return value
+
+
 class AbstractCodingAgent(ABC):
     """Base class every coding agent (e.g. Claude Code) inherits from.
 

{codee_agent-0.6.6 → codee_agent-0.6.8}/src/codee_agent_github_copilot/provider.py

@@ -7,7 +7,7 @@ import time
 from collections.abc import Callable
 from pathlib import Path
 
-from codee_agent_abstract.provider import AbstractCodingAgent, AgentModel
+from codee_agent_abstract.provider import AbstractCodingAgent, AgentModel, AgentResponse
 from codee_main_context.context import Settings
 from codee_main_context.logging import get_logger
 
@@ -30,6 +30,7 @@ _SESSION_NEW_ID = 2
 # Ceiling on what one run may spend. AI credits bill at $0.04 each, so the
 # default is the same $20 cap the Claude Code agent puts on a run.
 MAX_AI_CREDITS_ENV_VAR = "CODEE_COPILOT_MAX_AI_CREDITS"
+COPILOT_DEBUG_ENV_VAR = "COPILOT_DEBUG"
 DEFAULT_MAX_AI_CREDITS = 1000
 # The CLI rejects anything lower outright, which reads as a broken agent rather
 # than a misconfigured cap, so a smaller override is raised to it instead.
@@ -66,6 +67,7 @@ class GitHubCopilotAgent(AbstractCodingAgent):
 
     def __init__(self, settings: Settings, cwd: Path):
         super().__init__(settings, cwd)
+        self._settings = settings
 
     @classmethod
     def best_model(cls) -> str:
@@ -103,6 +105,9 @@ class GitHubCopilotAgent(AbstractCodingAgent):
         # answer is known before the run starts.
         if on_session_id:
             on_session_id(session_id)
+        prefix = self._settings.github_copilot_prompt_prefix.strip()
+        if prefix:
+            user_message = f"{prefix}\n\n{user_message}"
         cmd = [
             self.CLI_COMMAND,
             "-p", user_message,
@@ -119,6 +124,10 @@ class GitHubCopilotAgent(AbstractCodingAgent):
         # body alone — so a skill's model only takes effect via this flag.
         if model:
             cmd += ["--model", model]
+        debug_enabled = os.environ.get(
+            COPILOT_DEBUG_ENV_VAR, "").strip().lower() == "true"
+        if debug_enabled:
+            cmd += ["--log-level", "debug"]
 
         log.info("Running copilot with message: %s", user_message)
         log.debug("cwd=%s cmd=%s", self._cwd, " ".join(cmd))
@@ -156,7 +165,7 @@ class GitHubCopilotAgent(AbstractCodingAgent):
             # rather than failing a run that the CLI itself called successful.
             log.warning(
                 "copilot produced no result event; returning raw output")
-            return stdout
+            return AgentResponse(stdout, stderr if debug_enabled else "")
         if outcome.get("exitCode"):
             raise RuntimeError(
                 f"Copilot run errored (exit code {outcome['exitCode']}): "
@@ -166,7 +175,7 @@ class GitHubCopilotAgent(AbstractCodingAgent):
             raise RuntimeError(
                 f"Copilot run produced no response: {_detail(errors, stderr)}"
             )
-        return reply
+        return AgentResponse(reply, stderr if debug_enabled else "")
 
 
 def _relative(path: Path, cwd: Path) -> str:

{codee_agent-0.6.6 → codee_agent-0.6.8}/src/codee_agent_github_copilot/test.py

@@ -7,7 +7,8 @@ from pathlib import Path
 from unittest.mock import Mock, patch
 
 from codee_agent_github_copilot.provider import (
-    MAX_AI_CREDITS_ENV_VAR, GitHubCopilotAgent, _await_result)
+    COPILOT_DEBUG_ENV_VAR, MAX_AI_CREDITS_ENV_VAR, GitHubCopilotAgent,
+    _await_result)
 from codee_main_context.context import Settings
 
 SESSION = "82232f47-df60-4cb3-8c3a-de12074c9205"
@@ -121,6 +122,22 @@ class CopilotRunTest(unittest.TestCase):
         self.assertEqual(self.captured.call_args.kwargs["encoding"], "utf-8")
         self.assertEqual(self.captured.call_args.kwargs["errors"], "replace")
 
+    def test_prepends_the_configured_prompt_prefix(self) -> None:
+        self.agent = GitHubCopilotAgent(
+            Settings(github_copilot_prompt_prefix="Follow repository policy."),
+            Path("/repo"),
+        )
+        stdout = _stream(_event("assistant.message", {"content": "ok"}),
+                         _event("result", exitCode=0))
+
+        self._run(_completed(stdout))
+
+        cmd = self.captured.call_args.args[0]
+        self.assertEqual(
+            cmd[cmd.index("-p") + 1],
+            "Follow repository policy.\n\n/do-it CORE-1",
+        )
+
     def test_continuing_reuses_the_same_session_id(self) -> None:
         stdout = _stream(_event("assistant.message", {"content": "ok"}),
                          _event("result", exitCode=0))
@@ -153,6 +170,26 @@ class CopilotRunTest(unittest.TestCase):
 
         self.assertNotIn("--model", self.captured.call_args.args[0])
 
+    def test_debug_env_adds_log_level_and_preserves_stderr(self) -> None:
+        stdout = _stream(_event("assistant.message", {"content": "ok"}),
+                         _event("result", exitCode=0))
+        with patch.dict(os.environ, {COPILOT_DEBUG_ENV_VAR: "true"}):
+            response = self._run(_completed(stdout, stderr="debug line\n"))
+
+        cmd = self.captured.call_args.args[0]
+        self.assertEqual(cmd[cmd.index("--log-level") + 1], "debug")
+        self.assertEqual(response, "ok")
+        self.assertEqual(response.debug_logs, "debug line\n")
+
+    def test_debug_env_must_be_true(self) -> None:
+        stdout = _stream(_event("assistant.message", {"content": "ok"}),
+                         _event("result", exitCode=0))
+        with patch.dict(os.environ, {COPILOT_DEBUG_ENV_VAR: "1"}):
+            response = self._run(_completed(stdout, stderr="not retained"))
+
+        self.assertNotIn("--log-level", self.captured.call_args.args[0])
+        self.assertEqual(response.debug_logs, "")
+
     def test_the_best_model_is_an_anthropic_catalog_id(self) -> None:
         # Copilot has no latest-tier alias, so this id is pinned by hand and only
         # a real catalog id will be accepted by the CLI.
@@ -188,6 +225,13 @@ class CopilotRunTest(unittest.TestCase):
         self.assertEqual(self._run(_completed("plain text reply\n")),
                          "plain text reply\n")
 
+    def test_raw_output_keeps_debug_logs(self) -> None:
+        with patch.dict(os.environ, {COPILOT_DEBUG_ENV_VAR: "TRUE"}):
+            response = self._run(_completed("plain text reply\n", "debug\n"))
+
+        self.assertEqual(response, "plain text reply\n")
+        self.assertEqual(response.debug_logs, "debug\n")
+
     def test_a_timeout_raises(self) -> None:
         with patch("subprocess.run",
                    side_effect=subprocess.TimeoutExpired(cmd="copilot", timeout=7200)):

{codee_agent-0.6.6 → codee_agent-0.6.8}/src/codee_main_context/context.py

@@ -142,6 +142,9 @@ class Settings:
     tasks_provider: TasksProvider = TasksProvider.JIRA
     # Which coding agent the executor drives to work on tasks.
     coding_agent: CodingAgent = CodingAgent.CLAUDE_CODE
+    # Text prepended to every prompt sent to GitHub Copilot. Other coding
+    # agents do not read this setting.
+    github_copilot_prompt_prefix: str = ""
     # Per-provider credentials, keyed by provider value -> {field key: value}.
     # Values for all providers are kept so switching provider preserves them.
     credentials: dict[str, dict[str, str]] = field(default_factory=dict)
@@ -156,7 +159,8 @@ class Settings:
     # mandatory, settings written before one work item could name several types
     # hold a bare string where there is now a list, and a work item selected by
     # a query ignores its types entirely.
-    work_item_types: dict[str, dict[str, list[str]]] = field(default_factory=dict)
+    work_item_types: dict[str, dict[str, list[str]]
+                          ] = field(default_factory=dict)
     # The advanced answer to the same question: a condition in the provider's
     # own query language that picks one Codee work item out of the backend,
     # keyed by provider value -> {codee work item: condition}. Set for a work
@@ -202,6 +206,8 @@ def load_settings(data_dir: Path) -> Settings:
                 tasks_provider=TasksProvider(data["tasks_provider"]),
                 coding_agent=CodingAgent(
                     data.get("coding_agent", CodingAgent.CLAUDE_CODE.value)),
+                github_copilot_prompt_prefix=str(
+                    data.get("github_copilot_prompt_prefix", "")),
                 credentials=data.get("credentials", {}),
                 work_item_types=data.get("work_item_types", {}),
                 work_item_queries=data.get("work_item_queries", {}),
@@ -225,6 +231,7 @@ def save_settings(data_dir: Path, settings: Settings) -> None:
     payload = json.dumps({
         "tasks_provider": settings.tasks_provider.value,
         "coding_agent": settings.coding_agent.value,
+        "github_copilot_prompt_prefix": settings.github_copilot_prompt_prefix,
         "credentials": settings.credentials,
         "work_item_types": settings.work_item_types,
         "work_item_queries": settings.work_item_queries,