dex-agents-google-adk-cli 0.6.8__py3-none-any.whl

dex_agents_google_adk_cli/__init__.py

@@ -0,0 +1,61 @@
+# Copyright (c) 2026 Super Durable, Inc.
+#
+# Licensed under the Sustainable Use License 1.0.
+# You may not use this file except in compliance with the License.
+# See the LICENSE file in the repository root.
+#
+# SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
+
+"""The ``dex-agents-google-adk`` command: a Google ADK agent in the terminal.
+
+It builds the agent session Flow with the Google ADK adapter and
+runs it with the shared Dex Agents CLI core. See the package README.
+"""
+
+import dex_agents_cli_core  # noqa: F401  # first: it configures gRPC before anything imports it
+
+# isort: split
+
+import sys
+
+from dex_agents_cli_core import ConfigError, command_name, run_agent_cli
+from dex_agents_google_adk_cli.harness import (
+    DEFAULT_GOOGLE_ADK_MODEL,
+    DEFAULT_INSTRUCTIONS,
+    GOOGLE_ADK_CLI_FLOW_TYPE,
+    GoogleAdkHarness,
+    validate_google_adk_section,
+)
+
+__all__ = [
+    "DEFAULT_GOOGLE_ADK_MODEL",
+    "DEFAULT_INSTRUCTIONS",
+    "GOOGLE_ADK_CLI_FLOW_TYPE",
+    "GoogleAdkHarness",
+    "main",
+    "run",
+    "validate_google_adk_section",
+]
+
+
+def main(argv: list[str] | None = None) -> int:
+    """Run the command and return its exit code.
+
+    Args:
+        argv: The arguments without the program name; ``None`` reads ``sys.argv``.
+
+    Returns:
+        0 on success, 1 for a failure at run time, and 2 for a usage or
+        configuration error, such as a key in the ``google_adk`` section.
+    """
+    harness = GoogleAdkHarness()
+    try:
+        return run_agent_cli(harness, argv)
+    except ConfigError as error:
+        print(f"{command_name(harness)}: {error}", file=sys.stderr)
+        return 2
+
+
+def run() -> None:
+    """Run the command from its console script and exit with its code."""
+    raise SystemExit(main())

dex_agents_google_adk_cli/__main__.py

@@ -0,0 +1,14 @@
+# Copyright (c) 2026 Super Durable, Inc.
+#
+# Licensed under the Sustainable Use License 1.0.
+# You may not use this file except in compliance with the License.
+# See the LICENSE file in the repository root.
+#
+# SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
+
+"""``python -m dex_agents_google_adk_cli`` runs the ``dex-agents-google-adk`` command."""
+
+from dex_agents_google_adk_cli import run
+
+if __name__ == "__main__":
+    run()

dex_agents_google_adk_cli/harness.py

@@ -0,0 +1,119 @@
+# Copyright (c) 2026 Super Durable, Inc.
+#
+# Licensed under the Sustainable Use License 1.0.
+# You may not use this file except in compliance with the License.
+# See the LICENSE file in the repository root.
+#
+# SPDX-License-Identifier: LicenseRef-Sustainable-Use-1.0
+
+"""The Google ADK harness: an ADK ``LlmAgent`` on Gemini with the CLI core's tools."""
+
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import Any
+
+import dex_agents_cli_core  # noqa: F401  # first: it configures gRPC before anything imports it
+
+# isort: split
+
+from google.adk.agents import LlmAgent
+from google.adk.agents.callback_context import CallbackContext
+from google.adk.agents.readonly_context import ReadonlyContext
+from google.adk.models.google_llm import Gemini
+from google.adk.models.llm_request import LlmRequest
+from google.adk.models.llm_response import LlmResponse
+
+from dex_agents import AgentSessionFlow
+from dex_agents_cli_core import ConfigError, HarnessContext, LocalToolGroup
+from dex_agents_google_adk import adk_agent_session_flow
+
+#: The Flow type of the command's sessions, before the CLI core namespaces it.
+GOOGLE_ADK_CLI_FLOW_TYPE = "DexAgentsGoogleAdkCliSession"
+
+#: The Gemini model the command uses when the configuration file sets none.
+DEFAULT_GOOGLE_ADK_MODEL = "gemini-2.5-flash"
+
+#: The instructions the agent gets when the configuration sets none.
+DEFAULT_INSTRUCTIONS = (
+    "You are a helpful assistant. Use your tools to work with the files and commands "
+    "in your workspace and with the connected services."
+)
+
+
+class GoogleAdkHarness:
+    """The ``dex-agents-google-adk`` command: a Google ADK agent in the terminal.
+
+    The agent is one ADK ``LlmAgent`` on the Gemini API. Each model call
+    sends the running turn's model and instructions, so session settings
+    that change them apply from the next turn. The CLI core's connector and
+    local tools are the agent's only tools.
+
+    The command declares no reasoning effort values, because Gemini models
+    set thinking differently by generation: Gemini 3 takes a thinking level
+    and Gemini 2.5 a thinking token budget. A ``reasoning_effort`` session
+    setting fails the turn with ``unsupported_reasoning_effort``.
+    ``suggested_models`` lists Gemini models for the terminal UI's ``/model``.
+
+    .. versionchanged:: 0.6.2
+       The suggested models.
+    """
+
+    name = "google-adk"
+    config_section = "google_adk"
+    flow_type = GOOGLE_ADK_CLI_FLOW_TYPE
+    default_model: str | None = DEFAULT_GOOGLE_ADK_MODEL
+    replaced_local_tools: frozenset[LocalToolGroup] = frozenset()
+    suggested_models = ("gemini-2.5-flash", "gemini-2.5-pro")
+
+    def create_session_flow(self, context: HarnessContext) -> AgentSessionFlow:
+        """Build the ADK agent session Flow from the effective configuration.
+
+        Args:
+            context: The configuration, workspace, and tool sources.
+
+        Returns:
+            The Flow, with ``context.flow_type`` as its type.
+
+        Raises:
+            ConfigError: If the ``google_adk`` section has a key; it has no options yet.
+        """
+        validate_google_adk_section(context.harness_options)
+
+        def instructions(readonly_context: ReadonlyContext) -> str:
+            return context.current_turn().instructions or DEFAULT_INSTRUCTIONS
+
+        def use_turn_model(
+            callback_context: CallbackContext, llm_request: LlmRequest
+        ) -> LlmResponse | None:
+            # The Gemini model sends the request's model name, so this switches models per turn.
+            llm_request.model = context.current_turn().model
+            return None
+
+        agent = LlmAgent(
+            name="assistant",
+            model=Gemini(model=context.config.model),
+            instruction=instructions,
+            before_model_callback=use_turn_model,
+        )
+        return adk_agent_session_flow(
+            agent,
+            flow_type=context.flow_type,
+            tool_sources=context.tool_sources,
+            media_store=context.media_store,
+            summary_attributes_indexed=context.is_session_summary_indexed,
+        )
+
+
+def validate_google_adk_section(options: Mapping[str, Any]) -> None:
+    """Reject every key of the ``google_adk`` section, which has no options yet.
+
+    Args:
+        options: The section, ``{}`` when the file omits it.
+
+    Raises:
+        ConfigError: ``schema`` with the first key's JSON Pointer.
+    """
+    for key in sorted(options):
+        escaped = key.replace("~", "~0").replace("/", "~1")
+        raise ConfigError("schema", f"/google_adk/{escaped}", keyword="additionalProperties")

dex_agents_google_adk_cli-0.6.8.dist-info/METADATA

@@ -0,0 +1,110 @@
+Metadata-Version: 2.4
+Name: dex-agents-google-adk-cli
+Version: 0.6.8
+Summary: The dex-agents-google-adk command: a durable Google ADK agent in your terminal
+Author: Super Durable
+License-Expression: LicenseRef-Sustainable-Use-1.0
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Typing :: Typed
+Requires-Dist: dex-agents==0.6.8
+Requires-Dist: dex-agents-cli-core==0.6.8
+Requires-Dist: dex-agents-google-adk==0.6.8
+Requires-Dist: dex-python-sdk==1.45.2
+Requires-Dist: google-adk>=2.13,<3
+Requires-Python: >=3.11
+Project-URL: Homepage, https://github.com/superdurable/dex/tree/main/agents/cli/python/google-adk
+Project-URL: Repository, https://github.com/superdurable/dex
+Project-URL: Changelog, https://github.com/superdurable/dex/blob/main/agents/CHANGELOG.md
+Description-Content-Type: text/markdown
+
+# dex-agents-google-adk-cli
+
+`dex-agents-google-adk-cli` provides the `dex-agents-google-adk` command. It
+runs a [Google ADK](https://github.com/google/adk-python) agent as a durable
+Dex agent session and chats with it in your terminal. The shared CLI core,
+[`dex-agents-cli-core`](../core/README.md), starts or reuses `dexcli dev`,
+connects the connectors MCP server, and runs the Worker. This package only
+builds the agent with the
+[Google ADK adapter](../../../python/google-adk/README.md).
+
+## Running it
+
+The command needs Python 3.11 or later and a Gemini API key:
+
+```bash
+export GOOGLE_API_KEY=...
+uvx --from dex-agents-google-adk-cli dex-agents-google-adk
+```
+
+The Google Gen AI SDK reads the key from `GOOGLE_API_KEY` or
+`GEMINI_API_KEY`. To call Gemini on Vertex AI instead, set
+`GOOGLE_GENAI_USE_VERTEXAI=true`, `GOOGLE_CLOUD_PROJECT`, and
+`GOOGLE_CLOUD_LOCATION`, and sign in with Application Default Credentials.
+The command passes these variables to the SDK and never prints or stores
+them.
+
+The first run asks the `init` questions and writes
+`~/.dex/agents/google-adk.yaml`. Then type a message at the `>` prompt.
+Approve or reject tool calls with `y` or `n`, and press Ctrl-D to exit. The
+session stays in Dex, and the command prints the `--resume` line that
+continues it. See the [CLI core README](../core/README.md#running-a-command)
+for every subcommand and option, and [`agents/cli`](../../README.md) for the
+configuration file.
+
+## Configuration
+
+The model defaults to `gemini-2.5-flash`; set `model` in the file or pass
+`--model` to change it. It is a Gemini model name. `system_prompt` replaces
+the default instructions. Session settings that change `model` or
+`system_prompt` apply from the session's next turn. The `google_adk` section
+has no options yet, and any key in it is a configuration error.
+
+The command has no reasoning effort setting: Gemini 3 models take a thinking
+level and Gemini 2.5 models a thinking token budget. A session whose settings
+carry `reasoning_effort` fails its turn with `unsupported_reasoning_effort`,
+and the terminal UI does not offer `/effort`. Its `/model` also offers
+`gemini-2.5-pro`.
+
+## Tools
+
+The agent is one ADK `LlmAgent`. Its tools are the CLI core's connector tools
+and local tools: files, shell commands, web fetch, and the browser. Each
+call runs in its own Dex tool Step with the CLI core's rules: reads run at
+once, writes and shell commands wait for approval unless the shell allow list
+has the command, and file tools stay in the workspace. See the
+[CLI core README](../core/README.md) for the tools and their rules.
+
+## Images
+
+`/image <path>` attaches an image file to the next message. The command gives
+the Google ADK adapter the media store of `media.store`, so the model sees the
+image, and images that tools return go to the same store. See
+[Images](../../README.md#images).
+
+## Development
+
+Develop with uv 0.12.2. The package resolves `dex-agents`, the adapter, the
+CLI core, and the shared test support from this repository by path. `ci.sh`
+installs the locked dependencies, checks that `google-adk` and `google-genai`
+match the adapter's lock, checks lint and types, and runs the tests against a
+private `dexcli dev`:
+
+```bash
+cd agents/cli/python/google-adk
+DEXCLI=/path/to/dexcli ./ci.sh
+```
+
+The tests run the command in a pseudo-terminal with a private home. ADK calls
+the scripted Gemini API of [`../testing`](../testing) on 127.0.0.1 through
+`GOOGLE_GEMINI_BASE_URL`; a refused proxy stops any other request. A fake
+connectors MCP server serves a connector read and write. The tests cover a
+chat turn and `--resume`, `read_file` without approval and `write_file` after
+approval, a connector read and an approved connector write that runs once,
+session settings that change the model, and a key in the `google_adk`
+section. A `reasoning_effort` in the session settings fails the turn.
+They also cover a `system_prompt` set in the session settings, which reaches
+the next model request, and a rejected file write and connector write, which
+never run.

dex_agents_google_adk_cli-0.6.8.dist-info/RECORD

@@ -0,0 +1,9 @@
+dex_agents_google_adk_cli/__init__.py,sha256=ec735fF1IcaMf22PjfK3N6_n6FMomfAwn1DJ9ste3vo,1754
+dex_agents_google_adk_cli/__main__.py,sha256=HvQ97Dgc77lDHVsivtawhcKUZovByd2dwlvMbBIopxM,439
+dex_agents_google_adk_cli/harness.py,sha256=ZCY_jjVrPSaC7bU93KzXxXodyAg-cpNoNQ4LbEoJrOo,4611
+dex_agents_google_adk_cli/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dex_agents_google_adk_cli-0.6.8.dist-info/licenses/LICENSE,sha256=0AJCV4ky-vrSnT08IIdYpyiFPPoF2UrtKsBAvuvt1G4,4220
+dex_agents_google_adk_cli-0.6.8.dist-info/WHEEL,sha256=q9Wah2_CgP24mRNSlTyb0F8Yrbz55SzVl8eHLkZ_wvE,80
+dex_agents_google_adk_cli-0.6.8.dist-info/entry_points.txt,sha256=usUJ6yb_PpMY3TCCoiPpLhP2sogPUSWHZRUqkaMshls,73
+dex_agents_google_adk_cli-0.6.8.dist-info/METADATA,sha256=tQeUzSYQL-E6uK22XdfTsE6A_GcJT57294eA7yj0XCE,4977
+dex_agents_google_adk_cli-0.6.8.dist-info/RECORD,,

dex_agents_google_adk_cli-0.6.8.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.12.2
+Root-Is-Purelib: true
+Tag: py3-none-any

dex_agents_google_adk_cli-0.6.8.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+dex-agents-google-adk = dex_agents_google_adk_cli:run
+

dex_agents_google_adk_cli-0.6.8.dist-info/licenses/LICENSE

@@ -0,0 +1,105 @@
+# License
+
+Copyright (c) 2026 Super Durable, Inc.
+
+Portions of this software are licensed as follows:
+
+- Legacy Materials remain under their original licenses as described in
+  `LEGACY_NOTICES.md`.
+- Third-Party Materials remain under the licenses provided by their owners.
+- The `docs/` and `examples/` directories are not licensed under the
+  Sustainable Use License and retain their existing licensing status.
+- All other material owned or licensable by Super Durable, Inc. is available
+  under the Sustainable Use License below.
+
+See `LEGACY_NOTICES.md` for the applicable legacy and third-party notices.
+
+## Sustainable Use License
+
+Version 1.0
+
+### Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+### Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject
+to the limitations below.
+
+### Limitations
+
+You may use or modify the software only for your own internal business purposes
+or for non-commercial or personal use. You may distribute the software or
+provide it to others only if you do so free of charge for non-commercial
+purposes. You may not alter, remove, or obscure any licensing, copyright, or
+other notices of the licensor in the software. Any use of the licensor's
+trademarks is subject to applicable law.
+
+### Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software.
+
+If you or your company make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license for the software
+granted under these terms ends immediately. If your company makes such a claim,
+your patent license ends immediately for work on behalf of your company.
+
+### Notices
+
+You must ensure that anyone who gets a copy of any part of the software from
+you also gets a copy of these terms. If you modify the software, you must
+include in any modified copies of the software a prominent notice stating that
+you have modified the software.
+
+### No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+### Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your license will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your license will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your license
+to terminate automatically and permanently.
+
+### No Liability
+
+As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.
+
+### Definitions
+
+The "licensor" is the entity offering these terms.
+
+The "software" is the software the licensor makes available under these terms,
+including any portion of it.
+
+"You" refers to the individual or entity agreeing to these terms.
+
+"Your company" is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that organization.
+Control means ownership of substantially all the assets of an entity, or the
+power to direct its management and policies by vote, contract, or otherwise.
+Control can be direct or indirect.
+
+"Your license" is the license granted to you for the software under these
+terms.
+
+"Use" means anything you do with the software requiring your license.
+
+"Trademark" means trademarks, service marks, and similar rights.