agentkit-sdk-python 0.7.13__py3-none-any.whl → 0.8.0__py3-none-any.whl

agentkit/toolkit/cli/sandbox/__init__.py

@@ -18,9 +18,9 @@ from agentkit.toolkit.cli.sandbox.cli import sandbox_app
 from agentkit.toolkit.cli.sandbox.cli_build import build_command
 from agentkit.toolkit.cli.sandbox.cli_create import create_command
 from agentkit.toolkit.cli.sandbox.cli_exec import exec_command
-from agentkit.toolkit.cli.sandbox.cli_file import file_command
-from agentkit.toolkit.cli.sandbox.cli_get import get_command
-from agentkit.toolkit.cli.sandbox.cli_init_dockerfile import init_dockerfile_command
+from agentkit.toolkit.cli.sandbox.cli_scp import scp_command
+from agentkit.toolkit.cli.sandbox.cli_list import list_command
+from agentkit.toolkit.cli.sandbox.cli_init import init_command
 from agentkit.toolkit.cli.sandbox.cli_run import run_command
 from agentkit.toolkit.cli.sandbox.cli_shell import shell_command
 from agentkit.toolkit.cli.sandbox.cli_web import web_command
@@ -29,9 +29,9 @@ __all__ = [
     "build_command",
     "create_command",
     "exec_command",
-    "file_command",
-    "get_command",
-    "init_dockerfile_command",
+    "scp_command",
+    "init_command",
+    "list_command",
     "run_command",
     "sandbox_app",
     "shell_command",

agentkit/toolkit/cli/sandbox/agentkit_client.py

@@ -28,6 +28,8 @@ from agentkit.sdk.tools.client import AgentkitToolsClient as _OpenapiAgentkitToo
 from agentkit.sdk.tools.types import (
     CreateSessionRequest,
     CreateSessionResponse,
+    DeleteSessionRequest,
+    DeleteSessionResponse,
     GetSessionRequest,
     GetSessionResponse,
     ListSessionsRequest,
@@ -128,6 +130,15 @@ class TipAgentkitToolsClient(_OpenapiAgentkitToolsClient):
         if self.uses_tip_auth:
             self._tip_session = requests.Session()
             return
+        if not region:
+            try:
+                from agentkit.toolkit.cli.sandbox.config_store import (
+                    config_default_str,
+                )
+
+                region = config_default_str("region") or region
+            except Exception:
+                pass
 
         super().__init__(
             access_key=access_key,
@@ -216,6 +227,13 @@ class TipAgentkitToolsClient(_OpenapiAgentkitToolsClient):
             response_type=ListSessionsResponse,
         )
 
+    def delete_session(self, request: DeleteSessionRequest) -> DeleteSessionResponse:
+        return self._invoke_tip_api(
+            api_action="DeleteSession",
+            request=request,
+            response_type=DeleteSessionResponse,
+        )
+
     def _raise_tip_unsupported(self, api_action: str) -> None:
         raise Exception(
             f"{api_action} is not available with TIP sandbox auth. "
@@ -238,6 +256,11 @@ class TipAgentkitToolsClient(_OpenapiAgentkitToolsClient):
             self._raise_tip_unsupported("ListTools")
         return super().list_tools(request)
 
+    def delete_tool(self, request: Any) -> Any:
+        if self.uses_tip_auth:
+            self._raise_tip_unsupported("DeleteTool")
+        return super().delete_tool(request)
+
 
 def is_tip_agentkit_client(client: object) -> bool:
     return bool(getattr(client, "uses_tip_auth", False))

agentkit/toolkit/cli/sandbox/cli.py

@@ -19,12 +19,14 @@ from __future__ import annotations
 import typer
 
 from agentkit.toolkit.cli.sandbox.cli_build import build_command
+from agentkit.toolkit.cli.sandbox.cli_config import config_command
 from agentkit.toolkit.cli.sandbox.cli_create import create_command
+from agentkit.toolkit.cli.sandbox.cli_delete import delete_command
 from agentkit.toolkit.cli.sandbox.cli_exec import exec_command
-from agentkit.toolkit.cli.sandbox.cli_file import file_command
-from agentkit.toolkit.cli.sandbox.cli_get import get_command
+from agentkit.toolkit.cli.sandbox.cli_scp import scp_command
+from agentkit.toolkit.cli.sandbox.cli_list import list_command
 from agentkit.toolkit.cli.sandbox.cli_invoke import invoke_command
-from agentkit.toolkit.cli.sandbox.cli_init_dockerfile import init_dockerfile_command
+from agentkit.toolkit.cli.sandbox.cli_init import init_command
 from agentkit.toolkit.cli.sandbox.cli_model_login import codex_login_command
 from agentkit.toolkit.cli.sandbox.cli_mount import mount_command
 from agentkit.toolkit.cli.sandbox.cli_run import run_command
@@ -38,12 +40,13 @@ sandbox_app = typer.Typer(
 )
 
 sandbox_app.command(name="build")(build_command)
-sandbox_app.command(name="init-dockerfile")(init_dockerfile_command)
+sandbox_app.command(name="init")(init_command)
 sandbox_app.command(
     name="create",
     context_settings={"allow_extra_args": True, "ignore_unknown_options": True},
 )(create_command)
-sandbox_app.command(name="get")(get_command)
+sandbox_app.command(name="delete")(delete_command)
+sandbox_app.command(name="list")(list_command)
 sandbox_app.command(name="mount")(mount_command)
 sandbox_app.command(
     name="exec",
@@ -61,4 +64,5 @@ sandbox_app.command(
 sandbox_app.command(name="web")(web_command)
 sandbox_app.command(name="codex-login")(codex_login_command)
 sandbox_app.command(name="model-login")(codex_login_command)  # provider-agnostic alias
-sandbox_app.add_typer(file_command, name="file")
+sandbox_app.command(name="config")(config_command)
+sandbox_app.command(name="scp")(scp_command)

agentkit/toolkit/cli/sandbox/cli_config.py

@@ -0,0 +1,139 @@
+# Copyright (c) 2026 Beijing Volcano Engine Technology Co., Ltd. and/or its affiliates.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Config command for sandbox CLI."""
+
+from __future__ import annotations
+
+import typer
+import yaml
+
+from agentkit.toolkit.cli.sandbox.config_store import (
+    SandboxConfigError,
+    configured_sandbox_config,
+    effective_sandbox_config,
+    ensure_sandbox_config_initialized,
+    get_sandbox_config_path,
+    redact_sandbox_config,
+    set_config_value,
+    unset_config_value,
+    write_sandbox_config,
+)
+from agentkit.toolkit.cli.sandbox.sandbox_client import error
+
+
+def _dump_yaml(payload: object) -> None:
+    typer.echo(
+        yaml.safe_dump(
+            payload,
+            sort_keys=False,
+            allow_unicode=True,
+        ).rstrip()
+    )
+
+
+def _format_config_value(canonical: str, value: object) -> object:
+    if canonical in {"model-api-key", "websearch-apikey"}:
+        return "<redacted>"
+    return value
+
+
+def _parse_set_field(field: str) -> tuple[str, str]:
+    if "=" not in field:
+        raise SandboxConfigError("--set value must use KEY=VALUE format")
+    key, value = field.split("=", 1)
+    if not key.strip():
+        raise SandboxConfigError("--set key must not be empty")
+    return key, value
+
+
+def _apply_config_options(
+    set_fields: list[str],
+    unset_keys: list[str],
+    list_config: bool,
+) -> None:
+    path = get_sandbox_config_path()
+    data = None
+    wrote = False
+
+    if set_fields:
+        try:
+            path, data, _created = ensure_sandbox_config_initialized()
+            for field in set_fields:
+                key, value = _parse_set_field(field)
+                canonical, parsed = set_config_value(data, key, value)
+                typer.echo(
+                    f"Set {canonical}: {_format_config_value(canonical, parsed)}"
+                )
+        except SandboxConfigError as exc:
+            error(str(exc))
+
+    if unset_keys:
+        if data is None:
+            if not path.exists():
+                error(f"Sandbox config not found: {path}")
+            try:
+                data = configured_sandbox_config()
+            except SandboxConfigError as exc:
+                error(str(exc))
+        try:
+            for key in unset_keys:
+                canonical, removed = unset_config_value(data, key)
+                if removed:
+                    typer.echo(f"Unset {canonical}")
+                else:
+                    typer.echo(f"{canonical} was not set")
+        except SandboxConfigError as exc:
+            error(str(exc))
+
+    if data is not None:
+        write_sandbox_config(data, path)
+        wrote = True
+
+    if wrote:
+        typer.echo(f"Wrote {path}")
+
+    if list_config:
+        try:
+            _dump_yaml(redact_sandbox_config(effective_sandbox_config()))
+        except SandboxConfigError as exc:
+            error(str(exc))
+
+
+def config_command(
+    ctx: typer.Context,
+    set_fields: list[str] = typer.Option(
+        [],
+        "--set",
+        metavar="KEY=VALUE",
+        help="Set a config value. Can be repeated.",
+    ),
+    unset_keys: list[str] = typer.Option(
+        [],
+        "--unset",
+        metavar="KEY",
+        help="Unset a config value. Can be repeated.",
+    ),
+    list_config: bool = typer.Option(
+        False,
+        "--list",
+        help="List the current effective sandbox config.",
+    ),
+) -> None:
+    """Configure default values for sandbox commands."""
+    has_options = bool(set_fields or unset_keys or list_config)
+    if not has_options:
+        typer.echo(ctx.get_help())
+        raise typer.Exit()
+    _apply_config_options(set_fields, unset_keys, list_config)