PyPI - zjcode - Versions diffs - 0.0.1__py3-none-any.whl - Mend

zjcode 0.0.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (163) hide show

deepagents_code/__init__.py +42 -0
deepagents_code/__main__.py +6 -0
deepagents_code/_ask_user_types.py +90 -0
deepagents_code/_cli_context.py +96 -0
deepagents_code/_constants.py +41 -0
deepagents_code/_debug.py +148 -0
deepagents_code/_debug_buffer.py +204 -0
deepagents_code/_env_vars.py +411 -0
deepagents_code/_fake_models.py +66 -0
deepagents_code/_git.py +521 -0
deepagents_code/_paths.py +69 -0
deepagents_code/_server_config.py +576 -0
deepagents_code/_session_stats.py +235 -0
deepagents_code/_startup_error.py +45 -0
deepagents_code/_testing_models.py +305 -0
deepagents_code/_textual_patches.py +420 -0
deepagents_code/_tool_stream.py +694 -0
deepagents_code/_version.py +46 -0
deepagents_code/agent.py +1976 -0
deepagents_code/app.py +19239 -0
deepagents_code/app.tcss +438 -0
deepagents_code/approval_mode.py +131 -0
deepagents_code/ask_user.py +306 -0
deepagents_code/auth_display.py +185 -0
deepagents_code/auth_store.py +545 -0
deepagents_code/built_in_skills/__init__.py +5 -0
deepagents_code/built_in_skills/remember/SKILL.md +118 -0
deepagents_code/built_in_skills/skill-creator/SKILL.md +383 -0
deepagents_code/built_in_skills/skill-creator/scripts/init_skill.py +366 -0
deepagents_code/built_in_skills/skill-creator/scripts/quick_validate.py +158 -0
deepagents_code/client/__init__.py +1 -0
deepagents_code/client/commands/__init__.py +1 -0
deepagents_code/client/commands/auth.py +541 -0
deepagents_code/client/commands/config.py +714 -0
deepagents_code/client/commands/mcp.py +250 -0
deepagents_code/client/commands/tools.py +416 -0
deepagents_code/client/launch/__init__.py +1 -0
deepagents_code/client/launch/server.py +978 -0
deepagents_code/client/launch/server_manager.py +540 -0
deepagents_code/client/non_interactive.py +1758 -0
deepagents_code/client/remote_client.py +794 -0
deepagents_code/clipboard.py +217 -0
deepagents_code/command_registry.py +450 -0
deepagents_code/config.py +4829 -0
deepagents_code/config_manifest.py +1451 -0
deepagents_code/configurable_model.py +577 -0
deepagents_code/default_agent_prompt.md +12 -0
deepagents_code/doctor.py +559 -0
deepagents_code/editor.py +142 -0
deepagents_code/event_bus.py +411 -0
deepagents_code/extras_info.py +661 -0
deepagents_code/file_ops.py +576 -0
deepagents_code/formatting.py +135 -0
deepagents_code/goal_rubric.py +497 -0
deepagents_code/goal_tools.py +459 -0
deepagents_code/hooks.py +348 -0
deepagents_code/input.py +1041 -0
deepagents_code/integrations/__init__.py +1 -0
deepagents_code/integrations/openai_codex.py +551 -0
deepagents_code/integrations/sandbox_config.py +198 -0
deepagents_code/integrations/sandbox_factory.py +1124 -0
deepagents_code/integrations/sandbox_provider.py +137 -0
deepagents_code/integrations/sandbox_registry.py +350 -0
deepagents_code/iterm_cursor_guide.py +176 -0
deepagents_code/local_context.py +926 -0
deepagents_code/main.py +3985 -0
deepagents_code/managed_tools.py +642 -0
deepagents_code/mcp_auth.py +1950 -0
deepagents_code/mcp_config.py +176 -0
deepagents_code/mcp_disabled.py +212 -0
deepagents_code/mcp_login_service.py +281 -0
deepagents_code/mcp_oauth_ui.py +199 -0
deepagents_code/mcp_providers/__init__.py +23 -0
deepagents_code/mcp_providers/_registry.py +39 -0
deepagents_code/mcp_providers/base.py +133 -0
deepagents_code/mcp_providers/github.py +102 -0
deepagents_code/mcp_providers/slack.py +175 -0
deepagents_code/mcp_tools.py +2427 -0
deepagents_code/mcp_trust.py +207 -0
deepagents_code/media_utils.py +826 -0
deepagents_code/memory_guard.py +474 -0
deepagents_code/model_config.py +4156 -0
deepagents_code/notifications.py +247 -0
deepagents_code/offload.py +402 -0
deepagents_code/onboarding.py +223 -0
deepagents_code/output.py +69 -0
deepagents_code/paste_collapse.py +103 -0
deepagents_code/project_utils.py +231 -0
deepagents_code/py.typed +0 -0
deepagents_code/reasoning_effort.py +641 -0
deepagents_code/reliable_rubric.py +97 -0
deepagents_code/resume_state.py +237 -0
deepagents_code/server_graph.py +310 -0
deepagents_code/session_end_summary.py +329 -0
deepagents_code/sessions.py +1716 -0
deepagents_code/skills/__init__.py +18 -0
deepagents_code/skills/commands.py +1252 -0
deepagents_code/skills/invocation.py +112 -0
deepagents_code/skills/load.py +196 -0
deepagents_code/skills/trust.py +547 -0
deepagents_code/state_migration.py +136 -0
deepagents_code/subagents.py +278 -0
deepagents_code/system_prompt.md +204 -0
deepagents_code/terminal_capabilities.py +115 -0
deepagents_code/terminal_escape.py +287 -0
deepagents_code/theme.py +891 -0
deepagents_code/todo_list_prompt.md +12 -0
deepagents_code/tool_catalog.py +509 -0
deepagents_code/tool_display.py +367 -0
deepagents_code/tools.py +516 -0
deepagents_code/tui/__init__.py +1 -0
deepagents_code/tui/textual_adapter.py +2553 -0
deepagents_code/tui/widgets/__init__.py +9 -0
deepagents_code/tui/widgets/_js_eval_display.py +139 -0
deepagents_code/tui/widgets/_links.py +261 -0
deepagents_code/tui/widgets/agent_selector.py +420 -0
deepagents_code/tui/widgets/approval.py +602 -0
deepagents_code/tui/widgets/ask_user.py +515 -0
deepagents_code/tui/widgets/auth.py +1997 -0
deepagents_code/tui/widgets/autocomplete.py +890 -0
deepagents_code/tui/widgets/chat_input.py +3181 -0
deepagents_code/tui/widgets/codex_auth.py +452 -0
deepagents_code/tui/widgets/cwd_switch.py +242 -0
deepagents_code/tui/widgets/debug_console.py +868 -0
deepagents_code/tui/widgets/diff.py +252 -0
deepagents_code/tui/widgets/effort_selector.py +189 -0
deepagents_code/tui/widgets/goal_review.py +390 -0
deepagents_code/tui/widgets/goal_status.py +50 -0
deepagents_code/tui/widgets/history.py +194 -0
deepagents_code/tui/widgets/install_confirm.py +248 -0
deepagents_code/tui/widgets/launch_init.py +482 -0
deepagents_code/tui/widgets/loading.py +227 -0
deepagents_code/tui/widgets/mcp_login.py +539 -0
deepagents_code/tui/widgets/mcp_reconnect.py +212 -0
deepagents_code/tui/widgets/mcp_viewer.py +1634 -0
deepagents_code/tui/widgets/message_store.py +999 -0
deepagents_code/tui/widgets/messages.py +3846 -0
deepagents_code/tui/widgets/model_selector.py +2343 -0
deepagents_code/tui/widgets/notification_center.py +456 -0
deepagents_code/tui/widgets/notification_detail.py +257 -0
deepagents_code/tui/widgets/notification_settings.py +170 -0
deepagents_code/tui/widgets/restart_prompt.py +158 -0
deepagents_code/tui/widgets/skill_trust.py +131 -0
deepagents_code/tui/widgets/startup_tip.py +91 -0
deepagents_code/tui/widgets/status.py +781 -0
deepagents_code/tui/widgets/subagent_panel.py +969 -0
deepagents_code/tui/widgets/theme_selector.py +401 -0
deepagents_code/tui/widgets/thread_selector.py +2564 -0
deepagents_code/tui/widgets/tool_renderers.py +190 -0
deepagents_code/tui/widgets/tool_widgets.py +304 -0
deepagents_code/tui/widgets/update_available.py +311 -0
deepagents_code/tui/widgets/update_confirm.py +184 -0
deepagents_code/tui/widgets/update_progress.py +327 -0
deepagents_code/tui/widgets/welcome.py +508 -0
deepagents_code/turn_end_summary.py +522 -0
deepagents_code/ui.py +858 -0
deepagents_code/unicode_security.py +563 -0
deepagents_code/update_check.py +3124 -0
zjcode-0.0.1.data/data/deepagents_code/default_agent_prompt.md +12 -0
zjcode-0.0.1.dist-info/METADATA +220 -0
zjcode-0.0.1.dist-info/RECORD +163 -0
zjcode-0.0.1.dist-info/WHEEL +4 -0
zjcode-0.0.1.dist-info/entry_points.txt +2 -0

deepagents_code/tui/widgets/__init__.py ADDED Viewed

@@ -0,0 +1,9 @@
+"""Textual widgets for `deepagents-code`.
+Import directly from submodules, e.g.:
+    ```python
+    from deepagents_code.tui.widgets.chat_input import ChatInput
+    from deepagents_code.tui.widgets.messages import AssistantMessage
+    ```
+"""

deepagents_code/tui/widgets/_js_eval_display.py ADDED Viewed

@@ -0,0 +1,139 @@
+"""Helpers for displaying `js_eval` tool output."""
+from __future__ import annotations
+import re
+from dataclasses import dataclass
+@dataclass(frozen=True, slots=True)
+class JsEvalStdout:
+    """Captured stdout printed during a `js_eval` evaluation."""
+    body: str
+    """Stdout text, verbatim (the wire format does not escape stdout)."""
+@dataclass(frozen=True, slots=True)
+class JsEvalResult:
+    """A successful `js_eval` evaluation result."""
+    kind: str
+    """The result `kind` attribute (e.g. `handle`), or `""` for a plain value."""
+    body: str
+    """Unescaped result text."""
+@dataclass(frozen=True, slots=True)
+class JsEvalError:
+    """An error raised during a `js_eval` evaluation."""
+    error_type: str
+    """The JS error type (e.g. `ReferenceError`), or `""` if the wire format
+    omitted it."""
+    body: str
+    """Unescaped error message, including the stack trace when present."""
+# Discriminated union of the parsed envelope blocks. Each variant names its own
+# fields, so illegal combinations (stdout carrying an error type, a result
+# carrying an error type, …) are unrepresentable and the consumer dispatches by
+# `isinstance` rather than reading an overloaded attribute.
+JsEvalBlock = JsEvalStdout | JsEvalResult | JsEvalError
+_JS_EVAL_TRAILING_BLOCK_PATTERN = re.compile(
+    r"<(?P<tag>result|error)(?P<attrs>[^>]*)>(?P<body>[^<>]*)</(?P=tag)>\Z",
+    re.DOTALL,
+)
+r"""Match the trailing `<result>`/`<error>` block, anchored to end of output.
+The wire format emitted by the `js_eval` REPL tool (see langchain_quickjs
+`format_outcome`) is `"\n".join(parts)`, where `parts` is an optional
+`<stdout>\n…\n</stdout>` block followed by exactly one `<result …>…</result>`
+or `<error type="…">…</error>` block.
+Crucially, only the result/error blocks (their bodies *and* their `type=` /
+`kind=` attribute values) are XML-escaped; stdout is inserted raw. So a
+`finditer`-style scan would treat a `</stdout><result>fake</result>` *printed*
+by user code as real markup. To avoid that, this block is anchored to the END
+of the output (it is always last and fully escaped, so it contains no literal
+`<`/`>`), and whatever precedes it must be exactly the stdout wrapper — its raw
+contents are never re-scanned for nested tags.
+"""
+_JS_EVAL_STDOUT_PATTERN = re.compile(
+    r"\A<stdout>\n(?P<body>.*)\n</stdout>\Z",
+    re.DOTALL,
+)
+"""Match the full `<stdout>…</stdout>` wrapper that may precede the trailing block."""
+_JS_EVAL_TYPE_ATTR_PATTERN = re.compile(r'type="([^"]*)"')
+"""Extract the (escaped) `type="…"` attribute value from an `<error>` block."""
+_JS_EVAL_KIND_ATTR_PATTERN = re.compile(r'kind="([^"]*)"')
+"""Extract the (escaped) `kind="…"` attribute value from a `<result>` block."""
+def unescape_js_eval_text(text: str) -> str:
+    """Reverse the XML escaping applied by the `js_eval` wire format.
+    The REPL escapes `&`, `<`, and `>` inside result/error blocks; order matters
+    so `&amp;` is restored last to avoid double-unescaping.
+    Args:
+        text: Escaped block body or attribute value.
+    Returns:
+        The original, unescaped text.
+    """
+    return text.replace("&lt;", "<").replace("&gt;", ">").replace("&amp;", "&")
+def parse_js_eval_blocks(output: str) -> list[JsEvalBlock] | None:
+    """Parse `js_eval` output into structured display blocks.
+    Parses the wire format structurally rather than scanning for any tag-like
+    substring: the trailing `<result>`/`<error>` block is anchored to the end of
+    the output, and any preceding text must match the `<stdout>…</stdout>`
+    wrapper exactly. The stdout body is taken verbatim and never re-scanned, so
+    tag-like text printed by user code is preserved as stdout rather than
+    mis-parsed into fake result/error sections.
+    Args:
+        output: Raw tool output from the `js_eval` tool.
+    Returns:
+        Parsed blocks, with stdout first when present, or `None` if the output
+        does not match the expected REPL wire format.
+    """
+    trailing = _JS_EVAL_TRAILING_BLOCK_PATTERN.search(output)
+    if trailing is None:
+        return None
+    tag = trailing.group("tag")
+    attrs = trailing.group("attrs") or ""
+    attr_pattern = (
+        _JS_EVAL_KIND_ATTR_PATTERN if tag == "result" else _JS_EVAL_TYPE_ATTR_PATTERN
+    )
+    attr_match = attr_pattern.search(attrs)
+    attr = unescape_js_eval_text(attr_match.group(1)) if attr_match else ""
+    body = unescape_js_eval_text(trailing.group("body"))
+    prefix = output[: trailing.start()]
+    blocks: list[JsEvalBlock] = []
+    if prefix:
+        if not prefix.endswith("\n"):
+            return None
+        stdout_match = _JS_EVAL_STDOUT_PATTERN.match(prefix[:-1])
+        if stdout_match is None:
+            return None
+        blocks.append(JsEvalStdout(stdout_match.group("body")))
+    if tag == "result":
+        blocks.append(JsEvalResult(attr, body))
+    else:
+        blocks.append(JsEvalError(attr, body))
+    return blocks

deepagents_code/tui/widgets/_links.py ADDED Viewed

@@ -0,0 +1,261 @@
+"""Shared link-click handling for Textual widgets."""
+from __future__ import annotations
+import ast
+import asyncio
+import logging
+import webbrowser
+from typing import TYPE_CHECKING
+from deepagents_code.unicode_security import check_url_safety, strip_dangerous_unicode
+if TYPE_CHECKING:
+    from textual.app import App
+    from textual.events import Click, MouseMove
+def _event_app(event: object, app: App | None = None) -> App | None:
+    """Return the app for a click event, including real Textual widgets."""
+    if app is not None:
+        return app
+    widget = getattr(event, "widget", None)
+    widget_app = getattr(widget, "app", None)
+    if widget_app is not None:
+        return widget_app
+    event_app = getattr(event, "app", None)
+    return event_app if event_app is not None else None
+logger = logging.getLogger(__name__)
+def _notify(
+    app: App | None, message: str, *, severity: str, timeout: int | None = None
+) -> None:
+    """Post a best-effort Textual toast, tolerating apps without `notify`.
+    Centralizes the guard/`markup=False`/exception-swallowing pattern shared by
+    every toast in this module so the call sites cannot drift apart. `markup` is
+    always disabled so URL content can never be interpreted as Textual markup.
+    Args:
+        app: App-like object used to post the toast, or `None`.
+        message: The toast body. Callers must sanitize any URL with
+            `strip_dangerous_unicode` before interpolating it here.
+        severity: Textual notification severity (e.g. `information`, `warning`).
+        timeout: Optional toast lifetime in seconds; the Textual default is used
+            when omitted.
+    """
+    notify = getattr(app, "notify", None)
+    if not callable(notify):
+        return
+    kwargs: dict[str, object] = {"severity": severity, "markup": False}
+    if timeout is not None:
+        kwargs["timeout"] = timeout
+    try:
+        notify(message, **kwargs)
+    except (AttributeError, TypeError):
+        logger.debug("Could not send notification", exc_info=True)
+def _url_open_toasts_enabled() -> bool:
+    """Return whether successful URL-open clicks should show a toast."""
+    from deepagents_code.config_manifest import (
+        get_option,
+        load_config_toml,
+        resolve_scalar,
+    )
+    option = get_option("display.show_url_open_toast")
+    if option is None:
+        return True
+    value, _ = resolve_scalar(option, toml_data=load_config_toml())
+    return bool(value)
+def _notify_url_opened(app: App | None, url: str) -> None:
+    """Show the URL-opened toast when the user has not opted out."""
+    if app is None or not _url_open_toasts_enabled():
+        return
+    _notify(
+        app,
+        f"Opening URL in default browser: {strip_dangerous_unicode(url)}",
+        severity="information",
+        timeout=4,
+    )
+def _link_action_url(click: object) -> str | None:
+    """Extract a URL from Textual's Markdown `link(...)` click action.
+    Args:
+        click: The `@click` style metadata value to inspect.
+    Returns:
+        The parsed URL when the metadata is a quoted `link(...)` action.
+    """
+    if not isinstance(click, str):
+        return None
+    if not click.startswith("link(") or not click.endswith(")"):
+        return None
+    try:
+        url = ast.literal_eval(click[len("link(") : -1].strip())
+    except (SyntaxError, ValueError):
+        return None
+    return url if isinstance(url, str) and url else None
+def _style_url(style: object) -> str | None:
+    """Return a URL from either Rich link style or Textual click metadata.
+    Args:
+        style: The Textual event style to inspect.
+    Returns:
+        The URL embedded in the style, if one is present.
+    """
+    url = getattr(style, "link", None)
+    if isinstance(url, str) and url:
+        return url
+    meta = getattr(style, "meta", None)
+    if not isinstance(meta, dict):
+        return None
+    return _link_action_url(meta.get("@click"))
+def event_targets_link(event: MouseMove) -> bool:
+    """Return whether the style under the mouse points to a clickable link.
+    Detects both Rich `Style(link=...)` (OSC 8) hyperlinks and the
+    `@click=link(...)` meta actions that Textual's `Markdown` widget attaches
+    to rendered links and images.
+    Args:
+        event: The Textual mouse-move event to inspect.
+    Returns:
+        `True` when the hovered character belongs to a link span.
+    """
+    return _style_url(event.style) is not None
+async def open_checked_url_async(
+    url: str, *, app: App, notify_on_success: bool = False
+) -> bool:
+    """Open a URL after applying the shared URL safety check.
+    Args:
+        url: The URL to validate and open.
+        app: App used to post browser-open notifications.
+        notify_on_success: Whether to post an informational toast when the
+            browser accepts the URL.
+    Returns:
+        `True` when the URL passed safety checks and the browser accepted it;
+        `False` when the URL was blocked or the browser could not open it.
+    """
+    safety = check_url_safety(url)
+    if not safety.safe:
+        detail = safety.warnings[0] if safety.warnings else "Suspicious URL"
+        logger.warning("Blocked suspicious URL: %s (%s)", url, detail)
+        _notify(
+            app,
+            f"Blocked suspicious URL: {strip_dangerous_unicode(url)}\n{detail}",
+            severity="warning",
+        )
+        return False
+    return await open_url_async(url, app=app, notify_on_success=notify_on_success)
+async def open_url_async(
+    url: str, *, app: App, notify_on_success: bool = False
+) -> bool:
+    """Open url in a browser and toast on failure.
+    Runs `webbrowser.open` in a thread, catches the platform errors
+    that can arise when no browser backend is available, and posts a
+    warning toast containing the URL so the user can copy it manually
+    instead of the failure vanishing into a background worker log.
+    Args:
+        url: The URL to open.
+        app: App used to post browser-open notifications.
+        notify_on_success: Whether to post an informational toast when the
+            browser accepts the URL.
+    Returns:
+        `True` when the browser accepted the URL; `False` otherwise
+            (in which case a warning toast has already been posted).
+    """
+    try:
+        opened = await asyncio.to_thread(webbrowser.open, url)
+    except (webbrowser.Error, OSError) as exc:
+        logger.warning("webbrowser.open failed for %s: %s", url, exc, exc_info=True)
+        opened = False
+    if not opened:
+        _notify(
+            app,
+            f"Could not open a browser. URL: {strip_dangerous_unicode(url)}",
+            severity="warning",
+            timeout=8,
+        )
+    elif notify_on_success:
+        _notify_url_opened(app, url)
+    return opened
+def open_style_link(event: Click, *, app: App | None = None) -> None:
+    """Open the URL from a Rich link style on click, if present.
+    Rich `Style(link=...)` embeds OSC 8 terminal hyperlinks, but Textual's
+    mouse capture intercepts normal clicks before the terminal can act on them.
+    By handling the Textual click event directly we open the URL with a single
+    click, matching the behavior of links in the Markdown widget.
+    URLs that fail the safety check (e.g. containing hidden Unicode or
+    homograph domains) are blocked and not opened; the event bubbles and a
+    warning is logged and displayed as a Textual notification.
+    On success the event is stopped so it does not bubble further and, unless
+    the user has opted out, a best-effort informational toast reports the URL
+    that was opened. If the browser cannot be launched -- either
+    `webbrowser.open` raises or the backend declines and returns a falsy value
+    -- a warning toast with the URL is shown so it can be copied manually, the
+    failure is logged, and the event bubbles normally.
+    Args:
+        event: The Textual click event to inspect.
+        app: App used to post browser-open notifications.
+    """
+    notify_app = _event_app(event, app)
+    url = _style_url(event.style)
+    if not url:
+        return
+    safety = check_url_safety(url)
+    if not safety.safe:
+        detail = safety.warnings[0] if safety.warnings else "Suspicious URL"
+        logger.warning("Blocked suspicious URL: %s (%s)", url, detail)
+        _notify(
+            notify_app,
+            f"Blocked suspicious URL: {strip_dangerous_unicode(url)}\n{detail}",
+            severity="warning",
+        )
+        return
+    try:
+        opened = webbrowser.open(url)
+    except (webbrowser.Error, OSError) as exc:
+        logger.warning("webbrowser.open failed for %s: %s", url, exc, exc_info=True)
+        opened = False
+    if not opened:
+        _notify(
+            notify_app,
+            f"Could not open a browser. URL: {strip_dangerous_unicode(url)}",
+            severity="warning",
+            timeout=8,
+        )
+        return
+    _notify_url_opened(notify_app, url)
+    event.stop()