Files
agenthub/scripts/probe_agent.py
T

79 lines
2.6 KiB
Python

"""Probe a local ACP agent: initialize handshake + capability dump.
Usage:
uv run python scripts/probe_agent.py [--agent CMD] [--transport ndjson|lsp-frame]
Example:
uv run python scripts/probe_agent.py --agent "node_modules/.bin/claude-code-acp"
"""
from __future__ import annotations
import argparse
import os
import sys
from pathlib import Path
sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "src"))
from agenthub.acp_client import ACPClient, ACPError # noqa: E402
def main() -> int:
ap = argparse.ArgumentParser()
ap.add_argument("--agent", default="node_modules/.bin/claude-code-acp")
ap.add_argument("--transport", default="ndjson", choices=["ndjson", "lsp-frame"])
ap.add_argument("--cwd", default="/tmp")
ap.add_argument("--prompt", default=None, help="optionally send one prompt")
args = ap.parse_args()
client = ACPClient(
cmd=[args.agent],
cwd=os.getcwd(),
transport=args.transport,
env={**os.environ, "PATH": os.path.expanduser("~/.npm-global/node_modules/.bin") + ":" + os.environ.get("PATH", "")},
)
client.start()
try:
info = client.request(
"initialize",
{
"protocolVersion": 1,
"clientCapabilities": {"fs": {"readTextFile": True, "writeTextFile": True}},
},
timeout=30,
)
print("== initialize ==")
print("protocolVersion:", info.get("protocolVersion"))
print("agentCapabilities:", info.get("agentCapabilities"))
print("authMethods:", info.get("authMethods"))
sid = client.session_new(cwd=args.cwd)
print("== session/new == sessionId:", sid)
updates: list[dict] = []
client.register_notification_handler(lambda m, p: updates.append(p))
if args.prompt:
try:
res = client.session_prompt(sid, [{"type": "text", "text": args.prompt}], timeout=120)
print("== session/prompt ==", res)
except ACPError as e:
print("== session/prompt rejected ==", e.code, e.message)
kinds = [u["update"]["sessionUpdate"] for u in updates if "update" in u]
print("updates seen:", kinds[:20], f"(total {len(kinds)})")
else:
print("(no --prompt given; handshake only)")
if client.stderr_tail:
print("== agent stderr tail ==")
for line in client.stderr_tail[-5:]:
print(" ", line)
return 0
finally:
client.close()
if __name__ == "__main__":
raise SystemExit(main())