agentlink-cli 0.1.0__py3-none-any.whl

agentlink_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,136 @@
+Metadata-Version: 2.5
+Name: agentlink-cli
+Version: 0.1.0
+Summary: Local runtime connector for AgentLink
+Requires-Python: >=3.12
+Requires-Dist: claude-agent-sdk
+Requires-Dist: httpx[socks]>=0.28.1
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: pexpect>=4.9.0; sys_platform != 'win32'
+Requires-Dist: ptyprocess>=0.7.0; sys_platform != 'win32'
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyte>=0.8.2
+Requires-Dist: python-socks>=2.8.1
+Requires-Dist: pywinpty>=2.0.13; sys_platform == 'win32'
+Requires-Dist: websockets>=16.0
+Description-Content-Type: text/markdown
+
+# AgentLink CLI
+
+Local runtime connector for AgentLink. It runs on the machine that owns
+the workspace and agent runtimes, connects to the server over HTTP/WebSocket,
+executes connector RPC locally, and uploads normalized runtime/session state
+back to the backend.
+
+## Layout
+
+```text
+connector/
+  claude/       Claude Code discovery, adapter, reducer, and transcript logic
+  codex/        Codex app-server discovery, RPC, adapter, and reducer logic
+  local/        Local filesystem, shell, and terminal backends
+  cli.py        agentlink-cli CLI
+  runtime.py    Connector config, auth, WebSocket loop, and RPC dispatch
+tests/          Connector tests
+pyproject.toml  Connector dependencies and console script
+run.sh          Local helper for saved-config startup
+```
+
+## Run
+
+Install dependencies:
+
+```bash
+uv sync
+```
+
+Start with explicit credentials from the web pairing flow:
+
+```bash
+uvx agentlink-cli start \
+  --server-url http://127.0.0.1:8000 \
+  --connector-id conn_xxx \
+  --connector-token cxt_xxx
+```
+
+Passing a connector token on the command line can store it in shell history.
+For persistent installations, prefer a saved config or the environment variables
+listed below.
+
+Or save the config locally and start without arguments:
+
+```bash
+uvx agentlink-cli configure \
+  --server-url http://127.0.0.1:8000 \
+  --connector-id conn_xxx \
+  --connector-token cxt_xxx
+
+uvx agentlink-cli start
+```
+
+The default config path is `~/.agent-server/connector.json`. Override it with
+`--config` or `AGENT_CONNECTOR_CONFIG`.
+
+## Runtime Discovery
+
+The connector discovers Codex and Claude locally and reports attached runtime
+capabilities to the server. If a runtime is not on `PATH`, set one of:
+
+```bash
+CODEX_BIN=/path/to/codex
+CLAUDE_BIN=/path/to/claude
+```
+
+The connector uses local runtime credentials and local filesystem permissions.
+AgentLink does not proxy Claude or Codex account credentials.
+
+## Local Operations
+
+The server can ask an online connector to perform local work:
+
+- read/list/write files inside workspace-safe roots
+- upload/download file content through the server
+- run one-shot shell commands
+- start and wait for shell tasks
+- create, write, resize, stream, list, and close interactive terminals
+- start, interrupt, sync, and approve runtime turns
+
+## Environment
+
+| Variable | Purpose |
+| --- | --- |
+| `AGENT_CONNECTOR_CONFIG` | Connector config path. |
+| `AGENT_SERVER_URL` | Server URL used when `--server-url` is omitted. |
+| `AGENT_CONNECTOR_ID` | Connector id used when `--connector-id` is omitted. |
+| `AGENT_CONNECTOR_TOKEN` | Connector token used when `--connector-token` is omitted. |
+| `AGENT_CONNECTOR_ATTACHMENTS_ROOT` | Runtime attachment download directory. Defaults to `~/.agent-link/attachments`. |
+| `CODEX_BIN` | Explicit Codex CLI/app-server path. |
+| `CLAUDE_BIN` | Explicit Claude Code CLI path. |
+
+## Verify
+
+```bash
+uv run ruff check connector tests
+uv run pytest -q
+```
+
+## Release
+
+Releases are published to PyPI by `.github/workflows/publish-agentlink-cli.yml`
+when a GitHub Release is published. The release tag must match the package
+version with a `v` prefix, for example `v0.1.0`.
+
+Before the first release, create a GitHub Environment named `pypi`, then add a
+pending trusted publisher in PyPI with these values:
+
+| Field | Value |
+| --- | --- |
+| PyPI project name | `agentlink-cli` |
+| GitHub owner | `zhoujun0601` |
+| GitHub repository | `AgentLink` |
+| Workflow filename | `publish-agentlink-cli.yml` |
+| Environment name | `pypi` |
+
+The workflow tests the connector, validates the tag and distribution metadata,
+checks the wheel contents and CLI entry point, and publishes through OIDC without
+a long-lived PyPI token.

agentlink_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,55 @@
+connector/__init__.py,sha256=uSDSaR-MjP0aiGRJv852lhPq5gjGJgWJ87a5MDZw3Sk,132
+connector/adapter.py,sha256=vDkyu1U5BzcbJAlKWuxPpBNgm_9t3qkZbRqV1pi-tZU,1323
+connector/attachments.py,sha256=iKyYN9RqjTozv7RPqHwGpNPQQ7w5B_InZn-HTy5dCJo,1254
+connector/capabilities.py,sha256=9ScqYSlJbI9qJvmVZTKzW633J1TpEZxnbBmrfE6JZMY,22192
+connector/cli.py,sha256=s-GhkIu0CxxrItP8ECy8Vl-eeuGCyy-KYbeeJUR0JsY,10750
+connector/control.py,sha256=Lv1riCd05on6cxK6GuBiOz4IeIcNsSasKGfHUBJXkNo,12307
+connector/json_rpc.py,sha256=wfzGK9JLoLccDaxkitJQup9uB1YCmoodz_oQ-JGiCvs,5160
+connector/launch.py,sha256=gtiyya9Tr_Qme503wy0hcQO6tEoEmXgCdsG5aQ7NNx4,9932
+connector/local_ops.py,sha256=1MTXYxcgH6Aw2DTPF1IPqen-WLSxRdCGQFcYCTiYS88,169
+connector/local_runtime.py,sha256=o0vOrvbr8Y439brcSaW449x5qcEpguPiyvuGfKzjC50,4008
+connector/logging.py,sha256=a33VORdXbfjPS-9BZBkfXHp4puZGNz1o9ipZfZ_h1II,1708
+connector/perf.py,sha256=LMrWvoM8eh-1rpR6hQKy9-jeWsFD_6o5GAYTZHS96sE,2709
+connector/protocol.py,sha256=JEo2Y-Op-R_1bWvidieHG4U1-V52-OX0rplXWrzMVno,512
+connector/registry.py,sha256=52lL35d4OUCoBjpLprke4asSK-XivarGUDKQyNqZxsk,1876
+connector/runtime.py,sha256=AgZwMtEBDjnwWiYbKxQezGpGHnU9Ao1hyuTEP8UqLNs,59848
+connector/sync_state.py,sha256=3_U66rcC9LT1emE6Pbc967DL5MwxgZrH6QUCedM1bw4,5040
+connector/time.py,sha256=ZDCx-RaEQ0xU6siWnnnRsS7MNHy_RTkdEaiuZisDLjE,159
+connector/version.py,sha256=Ul_bRGL00-T3z30CslsJwJt4WFpQA2o2AHZbeB4fVj8,356
+connector/acp/__init__.py,sha256=xVqtUJI3lCyTm_G6Cht34YovIX0HZX9a3YCGgiMfv2Q,265
+connector/acp/adapter.py,sha256=6ds_JoI0TX2f1PrYIKwyKMbT4l9_OeAPnzpv9h6wEUo,52478
+connector/acp/config_options.py,sha256=0VetQmmqJv_TBbl3_8jw8pfex5F5pyBCL1B4nsR-8vU,5586
+connector/acp/discovery.py,sha256=pYi-YL1ClWDIFMs_n_yoR7-R6b2yLz0I8Ae4MUTDQLE,14771
+connector/acp/manifest.py,sha256=Ij4xq0oXRuJyg25X0qxZw0wEJrQmWBMskCKK0zeFQ6c,4643
+connector/acp/reducer.py,sha256=XCJFgzd4YlCqpxuBFtKeaw1pZMFAYc1CZdy8-gDBJ_I,22213
+connector/acp/rpc.py,sha256=535zztCoGRFU2GCXbDGKLgAwiQS9EGAalLHxuKYIj4o,11612
+connector/acp/manifests/__init__.py,sha256=-hTLeIHJFp9u-gMIWjk4iQxNQ_PUna6qnEGpKoHUBn0,43
+connector/acp/manifests/codebuddy.json,sha256=b0_4QARoByyAuu0LYbmNk6bYsN2_n316-c0AjpxVS5A,986
+connector/acp/manifests/cursor.json,sha256=Ka0BXhnx542bsA7IlZQzZC2ZtO0nJdIBm3DGhF2i2eI,986
+connector/acp/manifests/gemini.json,sha256=YihU5G3qmsTKSXvDZTubWseAHOtSF5L5FYskDW86G84,783
+connector/acp/manifests/grok_build.json,sha256=IMLr7fQs9VxBw-Qbngt-1waaRA9bbfn2jjBILAZDu8U,789
+connector/claude/__init__.py,sha256=lTL6yk26FR9RJ6du1DsIgVPIPH434wBpZcqn59FszMQ,243
+connector/claude/history_adapter.py,sha256=-WoCxdVB_1dmgmjKuhnRCFkMDUrnkoU7fM6QcvpOlRY,22870
+connector/claude/normalized.py,sha256=8MAErEZh7M4zLFWtJIbJ2apL8O8bxJEBNUPowQrxChw,687
+connector/claude/normalizers.py,sha256=HU4-TlZimCxQHg1_gNnLg5bzeiEQVu3B0pSdG_ccfiU,4117
+connector/claude/path_utils.py,sha256=QfXudfFUDto8rvKUoTaJ8gvOudcalTpdPx6dlWVmosA,483
+connector/claude/preferences.py,sha256=pHPUPs-gaVnoejZqwJK6tz4Zzy_V6P81EzKzVSJyRDI,1351
+connector/claude/sdk_adapter.py,sha256=Sjr2g3mJA8yu2fH2WpNO7JiGKGQatPEbEjKjhLJgDto,53564
+connector/claude/timeline_identity.py,sha256=5F4B6cH6baYkAE1JqcD-PxuzUNKFzLYuHzb3xlFpzG8,1365
+connector/claude/timeline_reducer.py,sha256=okS7VWLU-uGsVeH13bPqVYLcvYSZUATesvtDOghhJo0,13589
+connector/claude/trust.py,sha256=VmaqJmgBIGl7RGAt3bwXQzFW9EzxBk1F8hWFgz_D3G8,2150
+connector/codex/__init__.py,sha256=TeU5p5BpXLAaEaJdtJFCqbY1_QMi4R9SNKorfbOaXnk,77
+connector/codex/adapter.py,sha256=w3Hvl_Hujr0oVNEVd8UqUikGTN360_ci6kZJxWW45Xs,47833
+connector/codex/history.py,sha256=4DuA1RJGz3KatCKnVyUfhbw4YH6zzCqZcrOXNidDTa8,7012
+connector/codex/reducer.py,sha256=9Wm9-wPBarn-3p1L0y0rtD5Bz5a0J-q919H5PuyQy5k,49690
+connector/codex/rpc.py,sha256=45nNZaRksvgzIKtWbBc2NGGxJhKmQgKzQ2jcx1XfNX8,10636
+connector/local/__init__.py,sha256=Z6asmJEqFmAMGJ6Ia1ENN17j0AZfbX53zOSLcgl8ojw,207
+connector/local/common.py,sha256=43DE1ldHwworQ_CeHh_F4n0aHw9UUBD5sYmS_t80Jso,3391
+connector/local/file_ops.py,sha256=9RPYAgAhC1AaPSReX-eWM32yoZGBn6xV_11yWjWvsFo,5354
+connector/local/ops.py,sha256=U0SV4zZ822caskVTfYCpNvjPdMeZREG0j46ks5QW6bQ,3245
+connector/local/shell.py,sha256=HgHtkJmlnm0S2eyA3ZfKq6YjRpRKYarmmx1xJ4rnwwg,8375
+connector/local/terminal.py,sha256=B2JUly_tzitgKS4VPYN_0JVmPwvcGC3lBNOX8SUDVYc,24262
+agentlink_cli-0.1.0.dist-info/METADATA,sha256=nHgoDvfHUrIK-mFxCq7xExLMaP84iXaybO2XbGH93lM,4248
+agentlink_cli-0.1.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+agentlink_cli-0.1.0.dist-info/entry_points.txt,sha256=CaZ9KMv8hWjsQ9AREOZdGVcwStE128n0kWZWSmsKXpA,90
+agentlink_cli-0.1.0.dist-info/RECORD,,

agentlink_cli-0.1.0.dist-info/WHEEL

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

agentlink_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+agent-connector = connector.cli:main
+agentlink-cli = connector.cli:main

connector/__init__.py

@@ -0,0 +1,3 @@
+from connector.protocol import RpcNotification, RpcRequest, RpcResponse
+
+__all__ = ["RpcNotification", "RpcRequest", "RpcResponse"]

connector/acp/__init__.py

@@ -0,0 +1,6 @@
+"""Generic ACP (Agent Client Protocol) transport for multi-agent support."""
+
+from connector.acp.adapter import AcpAdapter
+from connector.acp.manifest import AgentManifest, load_builtin_manifests
+
+__all__ = ["AcpAdapter", "AgentManifest", "load_builtin_manifests"]