deepagents-code 0.1.47__tar.gz → 0.1.48__tar.gz

{deepagents_code-0.1.47 → deepagents_code-0.1.48}/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 # Deep Agents Code Changelog
 
+## [0.1.48](https://github.com/langchain-ai/deepagents/compare/deepagents-code==0.1.47...deepagents-code==0.1.48) (2026-07-27)
+
+### Features
+
+- Added Fireworks `kimi-k3`, GLM-5.2-Fast, and Kimi-K3 to model selection and recommended models. ([#5082](https://github.com/langchain-ai/deepagents/issues/5082), [#5072](https://github.com/langchain-ai/deepagents/issues/5072))
+- Migrated legacy hooks to v2 events. ([#4971](https://github.com/langchain-ai/deepagents/issues/4971))
+
+### Bug Fixes
+
+- Require an `AGENTS.md` marker for `/agent` discovery, resolving unintended discovery behavior. ([#5076](https://github.com/langchain-ai/deepagents/issues/5076), closes [#4991](https://github.com/langchain-ai/deepagents/issues/4991))
+- Removed the redundant `/restart` hint from the restart prompt. ([#5083](https://github.com/langchain-ai/deepagents/issues/5083))
+- Removed the caret flash in plugin type-to-search. ([#5078](https://github.com/langchain-ai/deepagents/issues/5078))
+
 ## [0.1.47](https://github.com/langchain-ai/deepagents/compare/deepagents-code==0.1.46...deepagents-code==0.1.47) (2026-07-24)
 
 ### Features

{deepagents_code-0.1.47 → deepagents_code-0.1.48}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepagents-code
-Version: 0.1.47
+Version: 0.1.48
 Summary: Terminal coding agent built on the Deep Agents SDK - works with any model, with persistent memory, customizable skills, subagents, and approval controls.
 Project-URL: Homepage, https://docs.langchain.com/oss/python/deepagents/overview
 Project-URL: Documentation, https://reference.langchain.com/python/deepagents/
@@ -31,7 +31,7 @@ Requires-Dist: deepagents-acp<1.0.0,>=0.0.9
 Requires-Dist: deepagents==0.7.0b2
 Requires-Dist: filelock<3.30,>=3.29.7
 Requires-Dist: httpx<1.0.0,>=0.28.1
-Requires-Dist: langchain-anthropic<2.0.0,>=1.5.1
+Requires-Dist: langchain-anthropic<2.0.0,>=1.5.2
 Requires-Dist: langchain-google-genai<5.0.0,>=4.3.1
 Requires-Dist: langchain-mcp-adapters<1.0.0,>=0.3.0
 Requires-Dist: langchain-openai<2.0.0,>=1.4.1
@@ -63,7 +63,7 @@ Provides-Extra: agentcore
 Requires-Dist: langchain-agentcore-codeinterpreter<1.0.0,>=0.0.5; extra == 'agentcore'
 Provides-Extra: all-providers
 Requires-Dist: aiohttp<3.15.0,>=3.14.3; extra == 'all-providers'
-Requires-Dist: langchain-anthropic<2.0.0,>=1.5.1; extra == 'all-providers'
+Requires-Dist: langchain-anthropic<2.0.0,>=1.5.2; extra == 'all-providers'
 Requires-Dist: langchain-aws<2.0.0,>=1.6.3; extra == 'all-providers'
 Requires-Dist: langchain-baseten<1.0.0,>=0.2.1; extra == 'all-providers'
 Requires-Dist: langchain-cohere<1.0.0,>=0.6.0; extra == 'all-providers'
@@ -91,7 +91,7 @@ Requires-Dist: langchain-modal>=0.0.5; extra == 'all-sandboxes'
 Requires-Dist: langchain-runloop>=0.0.6; extra == 'all-sandboxes'
 Requires-Dist: langchain-vercel-sandbox>=0.0.1; extra == 'all-sandboxes'
 Provides-Extra: anthropic
-Requires-Dist: langchain-anthropic<2.0.0,>=1.5.1; extra == 'anthropic'
+Requires-Dist: langchain-anthropic<2.0.0,>=1.5.2; extra == 'anthropic'
 Provides-Extra: baseten
 Requires-Dist: langchain-baseten<1.0.0,>=0.2.1; extra == 'baseten'
 Provides-Extra: bedrock

{deepagents_code-0.1.47 → deepagents_code-0.1.48}/deepagents_code/_build_info.py

@@ -1,3 +1,3 @@
 """Generated at build time. Do not edit or commit."""
 
-BUILD_COMMIT = "8aa29dd"
+BUILD_COMMIT = "803b832"

{deepagents_code-0.1.47 → deepagents_code-0.1.48}/deepagents_code/_version.py

@@ -2,7 +2,7 @@
 
 # Keep the `x-release-please-version` annotation — release-please uses it to
 # bump `__version__` in sync with `pyproject.toml` on every release PR.
-__version__ = "0.1.47"  # x-release-please-version
+__version__ = "0.1.48"  # x-release-please-version
 
 DOCS_URL = "https://docs.langchain.com/oss/python/deepagents/code"
 """URL for `deepagents-code` documentation."""

{deepagents_code-0.1.47 → deepagents_code-0.1.48}/deepagents_code/agent.py

@@ -1107,12 +1107,25 @@ def load_async_subagents(config_path: Path | None = None) -> list[AsyncSubAgent]
     return agents
 
 
+_AGENT_DIR_MARKER = "AGENTS.md"
+"""Filename that marks a `~/.deepagents/<name>/` directory as an agent profile.
+
+Discovery is fail-closed: only directories containing this marker are listed by
+the `/agent` picker. Real agents always create it (empty on first use when
+memory is enabled), so empty folders stay out of the picker without being
+named. Known app-owned directory names are still denylisted so a forced
+invocation such as `dcode -a plugins` cannot stamp the marker into app state
+and surface that directory as a selectable agent.
+"""
+
+
 @functools.lru_cache(maxsize=1)
 def _reserved_agent_dir_names() -> frozenset[str]:
     """Return non-agent directory names reserved by the app under `~/.deepagents/`.
 
     These directories are created by the app for its own use and must never
-    appear in the agent picker:
+    appear in the agent picker — even if they contain an `AGENTS.md` file
+    (e.g. after `dcode -a plugins` stamps the marker via memory setup):
 
     - `bin/` holds the managed `rg` binary (`managed_tools.BIN_DIR`).
     - `plugins/` holds installed plugin state (`plugins.store`).
@@ -1134,28 +1147,38 @@ def _reserved_agent_dir_names() -> frozenset[str]:
 def _is_agent_dir_entry(entry: Path) -> bool:
     """Return whether a `~/.deepagents/` entry should be listed as an agent.
 
-    Filters out symlinks (so dangling links don't masquerade as agents),
-    dot-prefixed names — `.state/` (app internal state) plus any other
-    hidden directory the user may have placed there — and reserved names
-    the app owns (`bin/`, `plugins/`, and `conversation_history/`).
+    Fail-closed on the `AGENTS.md` marker: a directory is an agent only when
+    that file exists as a regular (non-symlink) file inside it.
+
+    Also rejects:
 
-    `OSError` from `is_dir`/`is_symlink` propagates so callers can log
-    with the failing entry's name as context.
+    - Dot-prefixed names (hidden dirs such as `.state/`)
+    - Reserved app-owned names (`bin/`, `plugins/`, `conversation_history/`),
+      even if they contain the marker
+    - Symlinked directories (including dangling links)
+    - Non-directories
+
+    `OSError` from `is_dir`/`is_symlink`/`is_file` propagates so callers can
+    log with the failing entry's name as context.
     """
     if entry.name.startswith(".") or entry.name in _reserved_agent_dir_names():
         return False
-    return entry.is_dir() and not entry.is_symlink()
+    if entry.is_symlink() or not entry.is_dir():
+        return False
+    marker = entry / _AGENT_DIR_MARKER
+    # `is_file()` is True for a symlink-to-file; reject those so a dangling or
+    # external link cannot mint an agent entry.
+    return marker.is_file() and not marker.is_symlink()
 
 
 def get_available_agent_names() -> list[str]:
     """Return a sorted list of available agent names from `~/.deepagents/`.
 
     Scans the user's `.deepagents` directory and returns each real
-    subdirectory found there. Symlinks excluded so a dangling link does not
-    masquerade as an agent. Dot-prefixed entries (e.g., `.state/`) and
-    reserved app-owned directories (`bin/`, `plugins/`, and
-    `conversation_history/`) are skipped so internal state never appears as an
-    agent.
+    subdirectory that contains the `AGENTS.md` agent marker and is not an
+    app-reserved name. Fail-closed: bare directories, reserved app state
+    (`bin/`, `plugins/`, `conversation_history/`), symlinks, and hidden
+    entries are not agents.
 
     Filesystem errors (missing parent, permission denied, broken entries) are
     logged and surfaced as an empty list rather than raised — the caller shows
@@ -1222,7 +1245,9 @@ def list_agents(*, output_format: OutputFormat = "text") -> None:
                 {
                     "name": name,
                     "path": str(agent_path),
-                    "has_agents_md": (agent_path / "AGENTS.md").exists(),
+                    # Always True for names from `get_available_agent_names`
+                    # (fail-closed marker). Kept for JSON schema stability.
+                    "has_agents_md": (agent_path / _AGENT_DIR_MARKER).is_file(),
                     "is_default": name == DEFAULT_AGENT_NAME,
                 }
             )
@@ -1240,17 +1265,10 @@ def list_agents(*, output_format: OutputFormat = "text") -> None:
         is_default = name == DEFAULT_AGENT_NAME
         default_label = " [dim](default)[/dim]" if is_default else ""
 
-        if (agent_path / "AGENTS.md").exists():
-            console.print(
-                f"  {bullet} [bold]{agent_name}[/bold]{default_label}",
-                style=theme.PRIMARY,
-            )
-        else:
-            console.print(
-                f"  {bullet} [bold]{agent_name}[/bold]{default_label}"
-                " [dim](incomplete)[/dim]",
-                style=theme.WARNING,
-            )
+        console.print(
+            f"  {bullet} [bold]{agent_name}[/bold]{default_label}",
+            style=theme.PRIMARY,
+        )
         console.print(
             f"    {escape_markup(str(agent_path))}",
             style=theme.MUTED,

{deepagents_code-0.1.47 → deepagents_code-0.1.48}/deepagents_code/app.py

@@ -5052,37 +5052,20 @@ class DeepAgentsApp(App):
             and self._server_kwargs is not None
         ):
             missing = self._server_startup_missing_provider_package
-            from deepagents_code.extras_info import extra_for_package
+            from deepagents_code.extras_info import resolve_install_hint
 
-            extra = extra_for_package(missing.package)
-            if extra is not None:
+            hint = resolve_install_hint(missing.package)
+            if hint.extra is not None:
                 text += (
-                    f"\n\nHint: install the package with `/install {extra}`, "
+                    f"\n\nHint: install the package with `/install {hint.extra}`, "
                     f"then run `/model {missing.provider}:<model>` to retry. "
                     "Or pick a different provider with `/model`."
                 )
             else:
-                from deepagents_code.extras_info import ExtrasIntrospectionError
-                from deepagents_code.update_check import (
-                    ToolRequirementIntrospectionError,
-                    install_package_command,
-                )
-
-                try:
-                    install_cmd = install_package_command(missing.package)
-                except (
-                    ValueError,
-                    ExtrasIntrospectionError,
-                    ToolRequirementIntrospectionError,
-                ) as exc:
-                    logger.debug(
-                        "install_package_command failed; falling back to "
-                        "manual hint: %s",
-                        exc,
-                    )
-                    install_hint = f"install the `{missing.package}` package manually"
+                if hint.command is not None:
+                    install_hint = f"run `{hint.command}`"
                 else:
-                    install_hint = f"run `{install_cmd}`"
+                    install_hint = f"install the `{missing.package}` package manually"
                 text += (
                     f"\n\nHint: {install_hint}, then run "
                     f"`/model {missing.provider}:<model>` "
@@ -6034,9 +6017,9 @@ class DeepAgentsApp(App):
                 create_update_log_path,
                 editable_extra_hint,
                 install_extra_command,
-                install_extra_recovery_command,
                 is_valid_extra_name,
                 perform_install_extra,
+                safe_install_extra_recovery_command,
             )
         except ImportError as exc:
             logger.warning("/install command import failed", exc_info=True)
@@ -6121,19 +6104,9 @@ class DeepAgentsApp(App):
             # already bound above so the hint is never empty. `manual_cmd` is
             # rendered into a Textual `Content` (literal, not Rich markup), so no
             # bracket escaping is needed here.
-            try:
-                manual_cmd = await asyncio.to_thread(
-                    install_extra_recovery_command, extra
-                )
-            except (
-                ExtrasIntrospectionError,
-                ToolRequirementIntrospectionError,
-                ValueError,
-            ):
-                logger.warning(
-                    "/install recovery command failed (install raised)",
-                    exc_info=True,
-                )
+            manual_cmd = await asyncio.to_thread(
+                safe_install_extra_recovery_command, extra, fallback=manual_cmd
+            )
             await self._mount_message(
                 ErrorMessage(
                     f"Install failed: {type(exc).__name__}: {exc}\n"
@@ -6149,19 +6122,9 @@ class DeepAgentsApp(App):
             detail = f": {output[-200:]}" if output else ""
             # See the OSError branch above: best-effort recovery command, falling
             # back to the already-bound install-script command on failure.
-            try:
-                manual_cmd = await asyncio.to_thread(
-                    install_extra_recovery_command, extra
-                )
-            except (
-                ExtrasIntrospectionError,
-                ToolRequirementIntrospectionError,
-                ValueError,
-            ):
-                logger.warning(
-                    "/install recovery command failed (install reported failure)",
-                    exc_info=True,
-                )
+            manual_cmd = await asyncio.to_thread(
+                safe_install_extra_recovery_command, extra, fallback=manual_cmd
+            )
             await self._mount_message(
                 ErrorMessage(
                     f"Install failed{detail}\n"
@@ -16901,7 +16864,9 @@ class DeepAgentsApp(App):
         elif kind == "denial":
             text = f"Auto denied [{event.get('category', 'policy')}]: {reason}"
         elif kind == "unavailable":
-            text = f"Auto classifier unavailable: {reason}"
+            # Reason is a short cause fragment from the server; keep the UI
+            # line outcome-focused so the blocked action is obvious.
+            text = f"Auto classifier unavailable: {reason} (action blocked)"
         else:
             text = f"Auto warning: {reason}"
         await self._mount_message(AppMessage(text))

{deepagents_code-0.1.47 → deepagents_code-0.1.48}/deepagents_code/auto_mode.py

@@ -506,9 +506,9 @@ def classifier_unavailable_reason(exc: BaseException, *, timeout_seconds: float)
 
     Provider exception text stays out of the reason (it can carry secrets or
     noisy HTML). Only real local deadline expiry
-    (`_ClassifierDeadlineExceededError`) gets app-timeout wording; a bare
-    provider `TimeoutError` stays type-only so we do not claim dcode
-    cancelled a call the model failed first.
+    (`_ClassifierDeadlineExceededError`) includes the configured wait budget; a
+    bare provider `TimeoutError` stays type-only so we do not claim dcode's
+    deadline fired when the model failed first.
 
     Args:
         exc: Failure raised while invoking or validating the classifier.
@@ -518,11 +518,8 @@ def classifier_unavailable_reason(exc: BaseException, *, timeout_seconds: float)
         Compact single-line reason for tool messages and TUI events.
     """
     if isinstance(exc, _ClassifierDeadlineExceededError):
-        return (
-            "dcode cancelled the authorization classifier after its local "
-            f"{timeout_seconds:g}s timeout (app-imposed, not a provider timeout)."
-        )
-    return f"The authorization classifier was unavailable ({type(exc).__name__})."
+        return f"no decision within Auto's {timeout_seconds:g}s limit"
+    return f"failed ({type(exc).__name__})"
 
 
 def _default_counters(mode: ApprovalMode) -> AutoModeCounters:

{deepagents_code-0.1.47 → deepagents_code-0.1.48}/deepagents_code/config.py

@@ -112,6 +112,7 @@ _DOTENV_DENIED_ENV_KEYS = frozenset(
         "BASH_ENV",
         "BASHOPTS",
         "CDPATH",
+        "COMSPEC",
         "DYLD_INSERT_LIBRARIES",
         "DYLD_LIBRARY_PATH",
         "ENV",
@@ -128,6 +129,8 @@ _DOTENV_DENIED_ENV_KEYS = frozenset(
         "PYTHONSTARTUP",
         "SHELLOPTS",
         "SSH_ASKPASS",
+        "SYSTEMROOT",
+        "WINDIR",
         _INHERITED_PYTHONPATH_ENV,
     }
 )
@@ -4534,36 +4537,19 @@ def _create_model_via_init(
                 f"import for provider '{provider}': {e}"
             )
         else:
-            from deepagents_code.extras_info import extra_for_package
+            from deepagents_code.extras_info import resolve_install_hint
 
-            extra = extra_for_package(package)
-            if extra is not None:
+            hint = resolve_install_hint(package)
+            if hint.extra is not None:
                 msg = (
                     f"Missing package for provider '{provider}'. "
-                    f"Install: /install {extra}"
+                    f"Install: /install {hint.extra}"
                 )
             else:
-                from deepagents_code.extras_info import ExtrasIntrospectionError
-                from deepagents_code.update_check import (
-                    ToolRequirementIntrospectionError,
-                    install_package_command,
-                )
-
-                try:
-                    install_cmd = install_package_command(package)
-                except (
-                    ValueError,
-                    ExtrasIntrospectionError,
-                    ToolRequirementIntrospectionError,
-                ) as exc:
-                    logger.debug(
-                        "install_package_command failed; falling back to "
-                        "manual hint: %s",
-                        exc,
-                    )
-                    install_hint = f"Install the '{package}' package manually"
+                if hint.command is not None:
+                    install_hint = f"Install with: {hint.command}"
                 else:
-                    install_hint = f"Install with: {install_cmd}"
+                    install_hint = f"Install the '{package}' package manually"
                 msg = (
                     f"Missing package for provider '{provider}'. "
                     f"{install_hint}, then retry with `/model`."

{deepagents_code-0.1.47 → deepagents_code-0.1.48}/deepagents_code/extras_info.py

@@ -1129,6 +1129,88 @@ def extra_for_package(
     return None
 
 
+@dataclass(frozen=True)
+class InstallHint:
+    """Resolved recovery action for a missing provider package.
+
+    Exactly one of three outcomes:
+
+    - `extra` set, `command` `None` — prefer installing the extra that declares
+      the package (callers format this for their UI surface).
+    - `command` set, `extra` `None` — no declared extra; use this raw install
+      command.
+    - both `None` — neither could be derived; caller should fall back to
+      "install the package manually" phrasing.
+
+    Attributes:
+        extra: Preferred `deepagents-code` extra name, or `None`.
+        command: Ready-to-run install command for the raw package, or `None`.
+            Never set when `extra` is set.
+    """
+
+    extra: str | None
+    command: str | None
+
+    def __post_init__(self) -> None:
+        """Reject impossible dual-action resolutions.
+
+        Raises:
+            ValueError: If both `extra` and `command` are set.
+        """
+        if self.extra is not None and self.command is not None:
+            msg = "InstallHint cannot set both extra and command"
+            raise ValueError(msg)
+
+
+def resolve_install_hint(
+    package: str,
+    distribution_name: str = "deepagents-code",
+) -> InstallHint:
+    """Resolve how to recover from a missing provider package.
+
+    Centralizes the `extra_for_package` -> `install_package_command` fallback so
+    the TUI startup hint and the model-initialization error path render
+    consistent recovery data without each re-implementing the branching and
+    error handling. Prefers the installable extra; otherwise derives a raw
+    package install command, degrading to a manual hint (both fields `None`)
+    when that cannot be determined.
+
+    Callers own sentence wording and command framing (for example interactive
+    `/install` / `/model` copy). This helper only resolves the recovery action.
+
+    Args:
+        package: Distribution package name that failed to import.
+        distribution_name: Name of the installed distribution to inspect when
+            mapping the package to an extra and when building a raw package
+            install command that preserves already-installed extras.
+
+    Returns:
+        An `InstallHint` describing the recommended recovery action.
+    """
+    extra = extra_for_package(package, distribution_name)
+    if extra is not None:
+        return InstallHint(extra=extra, command=None)
+
+    from deepagents_code.update_check import (
+        ToolRequirementIntrospectionError,
+        install_package_command,
+    )
+
+    try:
+        command = install_package_command(package, distribution_name=distribution_name)
+    except (
+        ValueError,
+        ExtrasIntrospectionError,
+        ToolRequirementIntrospectionError,
+    ) as exc:
+        logger.debug(
+            "install_package_command failed; falling back to manual hint: %s",
+            exc,
+        )
+        return InstallHint(extra=None, command=None)
+    return InstallHint(extra=None, command=command)
+
+
 def verify_interpreter_deps() -> None:
     """Check that `langchain-quickjs` is installed for the interpreter.
 

{deepagents_code-0.1.47 → deepagents_code-0.1.48}/deepagents_code/hooks/capabilities.py

@@ -16,6 +16,8 @@ from deepagents_code.hooks.models.domain import (
     PermissionRequestEvent,
     PostToolUseDecision,
     PostToolUseEvent,
+    PreCompactDecision,
+    PreCompactEvent,
     PreToolUseDecision,
     PreToolUseEvent,
     SessionEndDecision,
@@ -28,6 +30,8 @@ from deepagents_code.hooks.models.domain import (
     SubagentStartEvent,
     SubagentStopDecision,
     SubagentStopEvent,
+    UserPromptSubmitDecision,
+    UserPromptSubmitEvent,
 )
 
 if TYPE_CHECKING:
@@ -52,6 +56,7 @@ class PlainOutputPolicy(StrEnum):
 class ExitCodePolicy(StrEnum):
     """How exit code 2 is interpreted for an event."""
 
+    BLOCK = "block"
     CONTEXT = "context"
     DENY = "deny"
     FEEDBACK = "feedback"
@@ -72,7 +77,7 @@ class AggregationPolicy(StrEnum):
 
 DEFAULT_COMMAND_TIMEOUT_SECONDS = 600.0
 MatcherField: TypeAlias = Literal[
-    "cause", "tool_name", "notification_type", "agent_name"
+    "cause", "tool_name", "notification_type", "agent_name", "trigger"
 ]
 
 
@@ -106,6 +111,18 @@ _HOOK_EVENT_SPECS: Final[Mapping[HookEvent, HookEventSpec]] = MappingProxyType(
             aggregation_policy=AggregationPolicy.CONTEXT,
             supported_handler_types=frozenset({HandlerType.COMMAND}),
         ),
+        HookEvent.USER_PROMPT_SUBMIT: HookEventSpec(
+            event=HookEvent.USER_PROMPT_SUBMIT,
+            owner=HookOwner.CLIENT,
+            event_model=UserPromptSubmitEvent,
+            decision_model=UserPromptSubmitDecision,
+            matcher_field=None,
+            default_timeout_seconds=30.0,
+            exit_code_policy=ExitCodePolicy.BLOCK,
+            plain_output_policy=PlainOutputPolicy.CONTEXT,
+            aggregation_policy=AggregationPolicy.CONTEXT,
+            supported_handler_types=frozenset({HandlerType.COMMAND}),
+        ),
         HookEvent.SESSION_END: HookEventSpec(
             event=HookEvent.SESSION_END,
             owner=HookOwner.CLIENT,
@@ -166,6 +183,18 @@ _HOOK_EVENT_SPECS: Final[Mapping[HookEvent, HookEventSpec]] = MappingProxyType(
             aggregation_policy=AggregationPolicy.FEEDBACK_AND_CONTEXT,
             supported_handler_types=frozenset({HandlerType.COMMAND}),
         ),
+        HookEvent.PRE_COMPACT: HookEventSpec(
+            event=HookEvent.PRE_COMPACT,
+            owner=HookOwner.CLIENT,
+            event_model=PreCompactEvent,
+            decision_model=PreCompactDecision,
+            matcher_field="trigger",
+            default_timeout_seconds=DEFAULT_COMMAND_TIMEOUT_SECONDS,
+            exit_code_policy=ExitCodePolicy.BLOCK,
+            plain_output_policy=PlainOutputPolicy.IGNORE,
+            aggregation_policy=AggregationPolicy.SIDE_EFFECT,
+            supported_handler_types=frozenset({HandlerType.COMMAND}),
+        ),
         HookEvent.STOP: HookEventSpec(
             event=HookEvent.STOP,
             owner=HookOwner.SERVER,
@@ -218,6 +247,8 @@ def get_event_spec(event: HookEvent) -> HookEventSpec:
     match event:
         case HookEvent.SESSION_START:
             return _HOOK_EVENT_SPECS[HookEvent.SESSION_START]
+        case HookEvent.USER_PROMPT_SUBMIT:
+            return _HOOK_EVENT_SPECS[HookEvent.USER_PROMPT_SUBMIT]
         case HookEvent.SESSION_END:
             return _HOOK_EVENT_SPECS[HookEvent.SESSION_END]
         case HookEvent.PERMISSION_REQUEST:
@@ -228,6 +259,8 @@ def get_event_spec(event: HookEvent) -> HookEventSpec:
             return _HOOK_EVENT_SPECS[HookEvent.PRE_TOOL_USE]
         case HookEvent.POST_TOOL_USE:
             return _HOOK_EVENT_SPECS[HookEvent.POST_TOOL_USE]
+        case HookEvent.PRE_COMPACT:
+            return _HOOK_EVENT_SPECS[HookEvent.PRE_COMPACT]
         case HookEvent.STOP:
             return _HOOK_EVENT_SPECS[HookEvent.STOP]
         case HookEvent.SUBAGENT_START:

{deepagents_code-0.1.47 → deepagents_code-0.1.48}/deepagents_code/hooks/env.py

@@ -10,6 +10,10 @@ from deepagents_code.config_manifest import _is_secret_env
 if TYPE_CHECKING:
     from collections.abc import Mapping
 
+# Shared bound for legacy hook subprocesses and the migration adapter's nested
+# `subprocess.run`. Keep the legacy dispatcher and Hooks v2 migration aligned.
+HOOK_SUBPROCESS_TIMEOUT = 5.0
+
 
 def sanitize_hook_environ(
     source: Mapping[str, str] | None = None,

{deepagents_code-0.1.47 → deepagents_code-0.1.48}/deepagents_code/hooks/legacy.py

@@ -82,6 +82,8 @@ import subprocess  # ruff:ignore[suspicious-subprocess-import]
 from concurrent.futures import ThreadPoolExecutor
 from typing import TYPE_CHECKING, Any
 
+from deepagents_code.hooks.env import HOOK_SUBPROCESS_TIMEOUT
+
 if TYPE_CHECKING:
     from collections.abc import Mapping
 
@@ -101,7 +103,6 @@ that act on the arguments (e.g. a linter reading a `write_file` `content`) see
 the exact value the tool received.
 """
 
-HOOK_SUBPROCESS_TIMEOUT = 5
 """Seconds a single hook subprocess may run before it is killed.
 
 Bounds how long one misbehaving hook can block the dispatch thread. Consumed in

{deepagents_code-0.1.47 → deepagents_code-0.1.48}/deepagents_code/hooks/loading.py

@@ -172,7 +172,9 @@ def canonical_hooks_bytes(config: HooksConfig) -> bytes:
 
 
 def _canonical_group(group: MatcherGroup) -> dict[str, object]:
-    raw = group.model_dump(mode="json", by_alias=True, exclude_none=True)
+    raw = group.model_dump(
+        mode="json", by_alias=True, exclude_none=True, exclude_defaults=True
+    )
     handlers: list[dict[str, object]] = []
     hooks_raw = raw.get("hooks")
     if isinstance(hooks_raw, list):
@@ -226,8 +228,8 @@ def _read_hooks_document(
         ]
         migrated = migrate_legacy_hooks(legacy_entries)
         migration_message = (
-            f"Migrated semantically equivalent session.end hooks from {path}; "
-            "all other legacy events remain unmapped"
+            f"Migrated semantically equivalent legacy hooks from {path}; "
+            "unsupported legacy events remain unmapped"
             if migrated.hooks
             else (
                 f"Legacy hooks at {path} contained no events that are safe to "