arkclaw-webchat-cli 0.6.1__tar.gz → 0.6.2__tar.gz

{arkclaw_webchat_cli-0.6.1 → arkclaw_webchat_cli-0.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arkclaw-webchat-cli
-Version: 0.6.1
+Version: 0.6.2
 Summary: CLI to chat with an ArkClaw EE space's Claw over enterprise SSO — zero permanent AK/SK.
 Author: ArkClaw Team
 Keywords: arkclaw,cli,ee,openclaw,sso,sts
@@ -31,7 +31,7 @@ at a prompt and for another agent/script (`--json` + exit codes).
 ```bash
 arkclaw init        # one-time interactive setup (asks only what it can't auto-detect)
 arkclaw login       # browser SSO
-arkclaw agents      # list the claws you can chat
+arkclaw agents      # list the agents you can chat
 arkclaw chat ci-xxxxxxxx
 ```
 
@@ -40,7 +40,8 @@ arkclaw chat ci-xxxxxxxx
 ## What it can do
 
 - **Log in as you** — browser SSO (PKCE), short-lived token, auto-refresh. No AK/SK, no client secret, nothing permanent on disk but a token in your OS keychain.
-- **List your agents** — `arkclaw agents` shows the claws you've chatted with (kept locally; add one with `arkclaw chat ci-...`).
+- **List your agents** — `arkclaw agents` shows the agents in your accessible claws (add a claw by chatting it once: `arkclaw chat ci-...`).
+- **Manage agents** — `agents create` / `agents delete` add or remove named agents in a claw, right from the terminal.
 - **Chat** — interactive REPL or one-shot `-m`, streaming token-by-token, with a live "what's it doing" spinner and tool-event trace.
 - **Talk to a specific claw** — by id (`chat ci-...`) or by name (`chat 答疑助手`).
 - **Manage a claw's files** — read/write its managed workspace files (`AGENTS.md`, `SOUL.md`, `MEMORY.md`, …) with `ls` / `pull` / `push`.
@@ -99,14 +100,16 @@ straight to `arkclaw login https://your-space...`. See **[Configuration](#config
 |---|---|
 | `arkclaw init [address]` | One-time interactive setup. Saves the address + (only what isn't auto-discovered) the CLI client and STS role to `~/.arkclaw/defaults.json`, so later commands need no env/flags. |
 | `arkclaw login [space-url]` | Browser SSO login. Uses `init` defaults if you omit the URL. `--transport a2a --endpoint <url>` for an agent endpoint. `--clawid ci-...` sets a default claw. Bare `arkclaw login` re-logs into the previous space. |
-| `arkclaw agents` | List the claws you've used from this machine (local history, newest first) + your default claw. Add a claw by chatting it once (`arkclaw chat ci-...`). Not a space-wide directory. |
+| `arkclaw agents` | List the agents in your accessible claws (verified over the ws; inaccessible claws are pruned). Candidate claws = the ones you've used from this machine + your default — add one by chatting it once (`arkclaw chat ci-...`). Not a space-wide directory. |
+| `arkclaw agents create` | Create a named agent in a claw: `--name` `--role` `--soul` (+ optional `--description`, repeatable `--skill`). Then `chat <claw> --agent <agentId>`. |
+| `arkclaw agents delete <agent>` | Delete a named agent by agentId (`a-...`) or display name. Asks for confirmation unless `--yes`; the `main` agent is protected. |
 | `arkclaw chat [TARGET] [MSG]` | Chat. `TARGET` = a claw id (`ci-...`), an agent name (from `agents`), or a profile. With `MSG` → one-shot; without → interactive REPL. `-f` attach files, `-o` write the reply, `--session NAME` name the conversation, `--approve-all` auto-approve tool runs. |
 | `arkclaw <name>` | Shortcut: `arkclaw 答疑助手` ≡ `arkclaw chat 答疑助手`. |
 | `arkclaw ls` | List the claw's managed workspace files. |
 | `arkclaw pull <name> [local]` | Download a managed file to local disk. |
 | `arkclaw push <local> [name]` | Write a local text file into a managed file. |
 | `arkclaw fanout "<msg>" --clawid ci-a --clawid ci-b` | Same message to many claws in parallel. |
-| `arkclaw sessions` | Recent chat sessions on this machine. |
+| `arkclaw sessions [claw]` | An agent's conversations from the server (`--agent` to pick one), newest first — resume with `chat --session <会话ID>`, fork with `--new`. Falls back to the local record when offline / a2a. |
 | `arkclaw profile save/use/list` | Named snapshots of the session config (multi-space / multi-claw). |
 | `arkclaw doctor` | Self-check: login freshness, keychain, pool/STS/endpoint reachability. |
 | `arkclaw schema --json` | Machine-readable command surface (for agents/tooling). |

{arkclaw_webchat_cli-0.6.1 → arkclaw_webchat_cli-0.6.2}/README.md

@@ -7,7 +7,7 @@ at a prompt and for another agent/script (`--json` + exit codes).
 ```bash
 arkclaw init        # one-time interactive setup (asks only what it can't auto-detect)
 arkclaw login       # browser SSO
-arkclaw agents      # list the claws you can chat
+arkclaw agents      # list the agents you can chat
 arkclaw chat ci-xxxxxxxx
 ```
 
@@ -16,7 +16,8 @@ arkclaw chat ci-xxxxxxxx
 ## What it can do
 
 - **Log in as you** — browser SSO (PKCE), short-lived token, auto-refresh. No AK/SK, no client secret, nothing permanent on disk but a token in your OS keychain.
-- **List your agents** — `arkclaw agents` shows the claws you've chatted with (kept locally; add one with `arkclaw chat ci-...`).
+- **List your agents** — `arkclaw agents` shows the agents in your accessible claws (add a claw by chatting it once: `arkclaw chat ci-...`).
+- **Manage agents** — `agents create` / `agents delete` add or remove named agents in a claw, right from the terminal.
 - **Chat** — interactive REPL or one-shot `-m`, streaming token-by-token, with a live "what's it doing" spinner and tool-event trace.
 - **Talk to a specific claw** — by id (`chat ci-...`) or by name (`chat 答疑助手`).
 - **Manage a claw's files** — read/write its managed workspace files (`AGENTS.md`, `SOUL.md`, `MEMORY.md`, …) with `ls` / `pull` / `push`.
@@ -75,14 +76,16 @@ straight to `arkclaw login https://your-space...`. See **[Configuration](#config
 |---|---|
 | `arkclaw init [address]` | One-time interactive setup. Saves the address + (only what isn't auto-discovered) the CLI client and STS role to `~/.arkclaw/defaults.json`, so later commands need no env/flags. |
 | `arkclaw login [space-url]` | Browser SSO login. Uses `init` defaults if you omit the URL. `--transport a2a --endpoint <url>` for an agent endpoint. `--clawid ci-...` sets a default claw. Bare `arkclaw login` re-logs into the previous space. |
-| `arkclaw agents` | List the claws you've used from this machine (local history, newest first) + your default claw. Add a claw by chatting it once (`arkclaw chat ci-...`). Not a space-wide directory. |
+| `arkclaw agents` | List the agents in your accessible claws (verified over the ws; inaccessible claws are pruned). Candidate claws = the ones you've used from this machine + your default — add one by chatting it once (`arkclaw chat ci-...`). Not a space-wide directory. |
+| `arkclaw agents create` | Create a named agent in a claw: `--name` `--role` `--soul` (+ optional `--description`, repeatable `--skill`). Then `chat <claw> --agent <agentId>`. |
+| `arkclaw agents delete <agent>` | Delete a named agent by agentId (`a-...`) or display name. Asks for confirmation unless `--yes`; the `main` agent is protected. |
 | `arkclaw chat [TARGET] [MSG]` | Chat. `TARGET` = a claw id (`ci-...`), an agent name (from `agents`), or a profile. With `MSG` → one-shot; without → interactive REPL. `-f` attach files, `-o` write the reply, `--session NAME` name the conversation, `--approve-all` auto-approve tool runs. |
 | `arkclaw <name>` | Shortcut: `arkclaw 答疑助手` ≡ `arkclaw chat 答疑助手`. |
 | `arkclaw ls` | List the claw's managed workspace files. |
 | `arkclaw pull <name> [local]` | Download a managed file to local disk. |
 | `arkclaw push <local> [name]` | Write a local text file into a managed file. |
 | `arkclaw fanout "<msg>" --clawid ci-a --clawid ci-b` | Same message to many claws in parallel. |
-| `arkclaw sessions` | Recent chat sessions on this machine. |
+| `arkclaw sessions [claw]` | An agent's conversations from the server (`--agent` to pick one), newest first — resume with `chat --session <会话ID>`, fork with `--new`. Falls back to the local record when offline / a2a. |
 | `arkclaw profile save/use/list` | Named snapshots of the session config (multi-space / multi-claw). |
 | `arkclaw doctor` | Self-check: login freshness, keychain, pool/STS/endpoint reachability. |
 | `arkclaw schema --json` | Machine-readable command surface (for agents/tooling). |

{arkclaw_webchat_cli-0.6.1 → arkclaw_webchat_cli-0.6.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "arkclaw-webchat-cli"
-version = "0.6.1"
+version = "0.6.2"
 description = "CLI to chat with an ArkClaw EE space's Claw over enterprise SSO — zero permanent AK/SK."
 readme = "README.md"
 requires-python = ">=3.10"

{arkclaw_webchat_cli-0.6.1 → arkclaw_webchat_cli-0.6.2}/src/ee_claw/cli.py

@@ -259,14 +259,76 @@ def push(
     _run(emitter, lambda: flows.do_push(local, remote, emitter, clawid=clawid))
 
 
-@app.command()
-def agents(json_mode: bool = _json_opt()) -> None:
+agents_app = typer.Typer()
+app.add_typer(agents_app, name="agents")
+
+
+@agents_app.callback(invoke_without_command=True)
+def agents(ctx: typer.Context, json_mode: bool = _json_opt()) -> None:
     """List the agents you can chat with (openclaw: the agents in your accessible
     claws; a2a: the agent at the endpoint). Then `chat <claw-or-name>`."""
+    if ctx.invoked_subcommand is not None:
+        # `agents --json create …` must honor the group-level flag — stash it
+        # for the subcommand (click contexts inherit obj), never drop it.
+        ctx.obj = {"json": json_mode}
+        return
     emitter = Emitter(json_mode=json_mode)
     _run(emitter, lambda: flows.do_agents(emitter))
 
 
+def _group_json(ctx: typer.Context, json_mode: bool) -> bool:
+    """A subcommand's effective --json: its own flag OR the group-level one."""
+    return json_mode or bool((ctx.obj or {}).get("json"))
+
+
+@agents_app.command("create")
+def agents_create(
+    ctx: typer.Context,
+    name: str = typer.Option(..., "--name", help="Agent display name."),
+    role: str = typer.Option(..., "--role", help="One-line role (what this agent does)."),
+    soul: str = typer.Option(
+        ..., "--soul", help="Persona / system instructions (the agent's SOUL.md)."
+    ),
+    description: str | None = typer.Option(None, "--description", help="Optional description."),
+    skill: list[str] = typer.Option(
+        [], "--skill", help="Skill to enable (repeat for several)."
+    ),
+    clawid: str | None = typer.Option(
+        None, "--clawid", help="Claw instance id (ci-...). Omit to use your default claw."
+    ),
+    json_mode: bool = _json_opt(),
+) -> None:
+    """Create a named agent in a claw. Then `arkclaw chat <claw> --agent <agentId>`."""
+    emitter = Emitter(json_mode=_group_json(ctx, json_mode))
+    _run(
+        emitter,
+        lambda: flows.do_agents_create(
+            emitter,
+            name=name,
+            role=role,
+            soul=soul,
+            description=description,
+            skills=list(skill),
+            clawid=clawid,
+        ),
+    )
+
+
+@agents_app.command("delete")
+def agents_delete(
+    ctx: typer.Context,
+    agent: str = typer.Argument(..., help="agentId (a-...) or display name to delete."),
+    clawid: str | None = typer.Option(
+        None, "--clawid", help="Claw instance id (ci-...). Omit to use your default claw."
+    ),
+    yes: bool = typer.Option(False, "--yes", help="Skip the confirmation prompt."),
+    json_mode: bool = _json_opt(),
+) -> None:
+    """Delete a named agent from a claw (asks for confirmation unless --yes)."""
+    emitter = Emitter(json_mode=_group_json(ctx, json_mode))
+    _run(emitter, lambda: flows.do_agents_delete(emitter, agent, clawid=clawid, yes=yes))
+
+
 @app.command()
 def fanout(
     message: str = typer.Argument(..., help="The message to send to every claw."),
@@ -412,6 +474,8 @@ def _schema_data() -> dict:
     for name, cmd in sorted(getattr(root, "commands", {}).items()):
         subs = getattr(cmd, "commands", None)
         if subs:
+            if getattr(cmd, "invoke_without_command", False):
+                commands.append(info(name, cmd))  # the bare group is a command too
             commands.extend(info(f"{name} {s}", c) for s, c in sorted(subs.items()))
         else:
             commands.append(info(name, cmd))

{arkclaw_webchat_cli-0.6.1 → arkclaw_webchat_cli-0.6.2}/src/ee_claw/flows.py

@@ -52,7 +52,7 @@ from ee_claw.identity import (
     read_chrome_recent_claw,
 )
 from ee_claw.oauth import OAuthClient
-from ee_claw.output import Emitter
+from ee_claw.output import Emitter, sanitize
 from ee_claw.providers import ProviderContext, resolve_token_source
 from ee_claw.sts import assume_role_with_oidc
 from ee_claw.transport.a2a import A2ATransport, agent_card
@@ -1201,15 +1201,14 @@ def do_agents(emitter: Emitter) -> dict[str, Any]:
     return {"current": current}
 
 
-def _openclaw_file_transport(clawid: str | None) -> tuple[OpenClawTransport, str]:
-    """Build an OpenClawTransport for file transfer (openclaw-only). Returns
-    (transport, clawid)."""
+def _openclaw_claw_transport(
+    clawid: str | None, *, feature: str, hint: str
+) -> tuple[OpenClawTransport, str]:
+    """Build an OpenClawTransport against the given (or default) claw for an
+    openclaw-only feature. Returns (transport, clawid)."""
     cfg, id_token = _load_session()
     if cfg.transport != "openclaw":
-        raise ValidationError(
-            "文件传输目前仅支持 openclaw transport(claw 工作区文件)。",
-            hint="A2A agent 没有可直传的工作区文件系统。",
-        )
+        raise ValidationError(f"{feature}目前仅支持 openclaw transport。", hint=hint)
     clawid = clawid or cfg.claw
     if not clawid:
         raise NoClawError("未指定 claw。", hint="加 --clawid <ci-...>。")
@@ -1221,6 +1220,104 @@ def _openclaw_file_transport(clawid: str | None) -> tuple[OpenClawTransport, str
     ), clawid
 
 
+def _openclaw_file_transport(clawid: str | None) -> tuple[OpenClawTransport, str]:
+    """Build an OpenClawTransport for file transfer (openclaw-only). Returns
+    (transport, clawid)."""
+    return _openclaw_claw_transport(
+        clawid, feature="文件传输", hint="A2A agent 没有可直传的工作区文件系统。"
+    )
+
+
+def _agent_mgmt_transport(clawid: str | None) -> tuple[OpenClawTransport, str]:
+    return _openclaw_claw_transport(
+        clawid, feature="agent 管理", hint="A2A 模式连接的是单个 agent 端点,没有可管理的 claw。"
+    )
+
+
+def do_agents_create(
+    emitter: Emitter,
+    *,
+    name: str,
+    role: str,
+    soul: str,
+    description: str | None = None,
+    skills: list[str] | None = None,
+    clawid: str | None = None,
+) -> dict[str, Any]:
+    """``arkclaw agents create``: create a named agent in a claw (ws RPC
+    ``arkclaw.team.agent.create``; live-calibrated 2026-06-10). The server
+    requires name+role+soul; skills may be empty."""
+    for label, value in (("--name", name), ("--role", role), ("--soul", soul)):
+        if not value.strip():
+            raise ValidationError(f"{label} 不能为空。")
+    if name.strip().startswith("a-") or name.strip() == "main":
+        raise ValidationError(
+            f"--name 不能是 {name.strip()!r} — 会与 agentId 命名空间(a-…/main)冲突。"
+        )
+    transport, clawid = _agent_mgmt_transport(clawid)
+    raw = asyncio.run(
+        transport.create_agent(
+            name=name, role=role, soul=soul, description=description, skills=skills or []
+        )
+    )
+    agent = redact_obj(raw)
+    assert isinstance(agent, dict)  # redact_obj preserves the dict shape
+    aid = str(agent.get("agentId") or "")
+    emitter.line(f"✓ 已创建 agent {agent.get('name') or name}({aid or '?'})· claw {clawid}")
+    if aid:
+        emitter.line(f"  开聊: arkclaw chat {clawid} --agent {aid}")
+    return {"claw": clawid, "agent": agent}
+
+
+def do_agents_delete(
+    emitter: Emitter, agent: str, *, clawid: str | None = None, yes: bool = False
+) -> dict[str, Any]:
+    """``arkclaw agents delete``: remove a named agent from a claw (ws RPC
+    ``arkclaw.team.agent.delete``). Accepts an agentId (``a-…``) or the agent's
+    display name; either way the target is resolved against the claw's live
+    agent list first — so a typo'd id can't delete anything, an ``a-…``-looking
+    display name can't shadow another agent's id, and the claw's default agent
+    (``main`` or ``default: true``) stays protected."""
+    if agent == "main":  # fail fast — no network needed to refuse this
+        raise ValidationError("默认(main)agent 不能删除。")
+    transport, clawid = _agent_mgmt_transport(clawid)
+    agents = asyncio.run(transport.list_agents())
+    matches = [a for a in agents if str(a.get("agentId") or "") == agent]
+    if not matches:  # not an id → try the display name
+        matches = [a for a in agents if str(a.get("name") or "") == agent]
+        if len(matches) > 1:
+            ids = ", ".join(str(a.get("agentId") or "?") for a in matches)
+            raise ValidationError(
+                f"名称 {agent!r} 对应多个 agent({ids}),请直接用 agentId。"
+            )
+    if not matches:
+        raise ValidationError(
+            f"claw {clawid} 里没有 agentId 或名称为 {agent!r} 的 agent。",
+            hint="用 `arkclaw agents` 查看 agentId 与名称。",
+        )
+    target = matches[0]
+    agent_id = str(target.get("agentId") or "")
+    if not agent_id:
+        raise ValidationError(f"服务端没有给出 {agent!r} 的 agentId,无法安全删除。")
+    if agent_id == "main" or bool(target.get("default")):
+        raise ValidationError("默认(main)agent 不能删除。")
+    if not yes:
+        if emitter.json or not sys.stdin.isatty():
+            raise ValidationError("headless 删除必须显式 --yes。")
+        # agent_id is upstream content: sanitize before it touches the TTY —
+        # input() bypasses Emitter.line's control-char stripping.
+        prompt = sanitize(f"确认删除 claw {clawid} 的 agent {agent_id}? [y/N] ")
+        answer = input(prompt).strip().lower()
+        if answer not in ("y", "yes"):
+            emitter.line("已取消。")
+            return {"cancelled": True}
+    result = redact_obj(asyncio.run(transport.delete_agent(agent_id)))
+    if isinstance(result, dict) and result.get("success") is False:
+        raise NetworkError(f"claw 未确认删除 agent {agent_id}(success=false)。")
+    emitter.line(f"✓ 已删除 agent {agent_id} · claw {clawid}")
+    return {"claw": clawid, "agentId": agent_id, "result": result}
+
+
 def do_ls(emitter: Emitter, *, clawid: str | None = None) -> dict[str, Any]:
     """``arkclaw ls``: list files in the claw workspace."""
     transport, clawid = _openclaw_file_transport(clawid)
@@ -1426,7 +1523,7 @@ def do_claw(
     if op == "delete" and not yes:
         if emitter.json or not sys.stdin.isatty():
             raise ValidationError("headless 删除必须显式 --yes。")
-        answer = input(f"确认删除 claw {clawid}? [y/N] ").strip().lower()
+        answer = input(sanitize(f"确认删除 claw {clawid}? [y/N] ")).strip().lower()
         if answer not in ("y", "yes"):
             emitter.line("已取消。")
             return {"cancelled": True}

{arkclaw_webchat_cli-0.6.1 → arkclaw_webchat_cli-0.6.2}/src/ee_claw/transport/openclaw.py

@@ -527,6 +527,35 @@ class OpenClawTransport:
                     return [a for a in v if isinstance(a, dict)]
         return []
 
+    async def create_agent(
+        self,
+        *,
+        name: str,
+        role: str,
+        soul: str,
+        description: str | None = None,
+        skills: Sequence[str] = (),
+    ) -> dict[str, Any]:
+        """Create a named agent in this claw (ws RPC ``arkclaw.team.agent.create``).
+        The server requires name + role + soul + skills (array, may be empty);
+        returns the created agent ``{agentId, name, role, soul, …}``."""
+        params: dict[str, Any] = {
+            "name": name,
+            "role": role,
+            "soul": soul,
+            "skills": list(skills),
+        }
+        if description:
+            params["description"] = description
+        payload = await self._request("arkclaw.team.agent.create", params)
+        return payload if isinstance(payload, dict) else {}
+
+    async def delete_agent(self, agent_id: str) -> dict[str, Any]:
+        """Delete an agent from this claw (ws RPC ``arkclaw.team.agent.delete``).
+        Returns the server ack (``{success: true}``)."""
+        payload = await self._request("arkclaw.team.agent.delete", {"agentId": agent_id})
+        return payload if isinstance(payload, dict) else {}
+
     async def list_sessions(self, agent_id: str = "main") -> list[dict[str, Any]]:
         """An agent's conversations (ws RPC ``sessions.list``). Each item:
         ``{key, sessionId, derivedTitle?, updatedAt, status, ...}`` — ``key`` is