handler-ai 0.1.0__py3-none-any.whl

handler_ai-0.1.0.dist-info/METADATA

@@ -0,0 +1,60 @@
+Metadata-Version: 2.5
+Name: handler-ai
+Version: 0.1.0
+Summary: Run coding agents (Claude Code, Codex, Vibe, pi) in rootless Podman sandboxes on Linux
+Project-URL: Homepage, https://github.com/macray/handler-ai
+Project-URL: Documentation, https://macray.github.io/handler-ai/
+Project-URL: Changelog, https://github.com/macray/handler-ai/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/macray/handler-ai/issues
+License-Expression: Apache-2.0
+Keywords: acp,agents,ai,claude-code,codex,podman,sandbox
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development
+Requires-Python: >=3.12
+Requires-Dist: cryptography>=45
+Requires-Dist: dulwich>=1.2
+Requires-Dist: fastapi>=0.141
+Requires-Dist: httpx>=0.28
+Requires-Dist: jsonschema>=4.23
+Requires-Dist: pydantic<3,>=2.13
+Requires-Dist: pyyaml>=6
+Requires-Dist: tomlkit>=0.13
+Requires-Dist: uvicorn>=0.53
+Requires-Dist: websockets>=17
+Description-Content-Type: text/markdown
+
+# Handler
+
+**Handler**: every agent needs one.
+
+Run coding agents in containers on your Linux machine. Each agent (Claude Code, Codex, Mistral
+Vibe or pi) runs in its own rootless Podman container that sees only its project folder and reaches
+only the hosts you allow. A daemon keeps the sessions, which you follow from a web UI, the
+terminal, your editor (over ACP) or your phone.
+
+## Install
+
+**You need:** Linux with rootless Podman, `passt` and a systemd user session, and about 3 GB of
+disk for the images, built on your machine.
+
+```bash
+uv tool install handler-ai   # or: pipx install handler-ai
+handler setup                # starts handlerd as a user service, checks this machine, builds the images
+handler ui                   # opens the web UI
+```
+
+The first `handler setup` downloads and builds the images: from a few minutes to half an hour.
+Without uv: `curl -fsSL https://github.com/macray/handler-ai/releases/latest/download/install.sh | sh`
+installs it, then Handler. To update: `uv tool upgrade handler-ai`.
+
+## More
+
+- [README](https://github.com/macray/handler-ai#readme): what Handler does, compared with other
+  sandboxes, and a first session.
+- [Documentation](https://macray.github.io/handler-ai/)
+- [Changelog](https://github.com/macray/handler-ai/blob/main/CHANGELOG.md) ·
+  [Issues](https://github.com/macray/handler-ai/issues)

handler_ai-0.1.0.dist-info/RECORD

@@ -0,0 +1,234 @@
+handler_cli/__init__.py,sha256=1VgCiquupUdYG5B7rt6M3zbxntmKWM6ky6R8szDS1e0,98
+handler_cli/account_commands.py,sha256=peiT-VCCN2DGr3UBgD-XYin__hUSDh8YTlXoJgpgq1A,13680
+handler_cli/addon_commands.py,sha256=1SxEXbcUznwqkyOrbxFcE3dXegooK-Pbm4sLP0jcbdE,5356
+handler_cli/agent_commands.py,sha256=rurfdJPx3ydFL8hUILflL361Xm0JqnACpPguTdB6Cqg,6164
+handler_cli/app_commands.py,sha256=l0mLyPZjRBVA2hjAaytpwQULl5ebDF4fxIpL9ErFSa4,7001
+handler_cli/app_window.py,sha256=gV29B8z-NJQtRj8pINKydZ_uOqN_3OAyqfnmH1Y8zaw,3275
+handler_cli/automation_commands.py,sha256=RVhDqcjsQFDQRDGvDAbTMpHQkJIGgw9LCyaZcPFi1vI,12795
+handler_cli/bridge.py,sha256=R6AdT9VvnkyufMl-tXtYTKrDk1OwrhFShjDvhJy9N90,1602
+handler_cli/cli.py,sha256=xU2YmvYcmVddzfqAWX6HMW2sT1WN64r3rfCvuNP_j4g,14904
+handler_cli/client.py,sha256=3IzRnG7GkSK2I0TOEInvIRdDIAYkSR_1fsOJ6OqqRL0,2812
+handler_cli/daemon_commands.py,sha256=RkagiMchdlWtoD-ciDZDPvkLAtpv1kmFSqCEjdC1bck,3472
+handler_cli/image_commands.py,sha256=PhgLBCyS9sZ13mmeVDUiWlZ3pA8vLWvTQEOhGGyq9O0,4119
+handler_cli/inbox_commands.py,sha256=M7chRV-r2d99RRLH3FQW7CeRy2OoaHvm1n8TAZTjooA,1006
+handler_cli/output.py,sha256=SJ6x6-ORzVk40Cilwee3Ln9tnQBX63jwifCR4TR0MfA,425
+handler_cli/project_commands.py,sha256=tzoHRjL8k8I5NtUmbSkeK8tuLdNCxZGIVIfCvuDNkrc,2462
+handler_cli/provider_commands.py,sha256=aSwuLC3_MCjL22ewM8NTQmQ2fAPj7RQyTktBsIuix9s,5482
+handler_cli/secret_commands.py,sha256=I6g3ta5bhWigllmmb_eyr0kZ7k2sOW4QFloLtw8h6qs,2806
+handler_cli/session_bridge.py,sha256=yMeeoZptr4MnGbVF5f6YRiSY--ieeMvCR7G1OxIaucM,4133
+handler_cli/session_commands.py,sha256=E7fG3V2FvOcIbsOmsC27y7NLqRS_2K5KGiIWVkSBzDg,22123
+handler_cli/setup.py,sha256=s_jqJ3MVL-GBy5sbZDWkzKgD_n4Dklj58_ZIw9VOPx4,4663
+handler_cli/terminal.py,sha256=2pBB2lkeFbeJHfOJELAY5MhuYcdiWoDtd2PMoRrhIDA,12057
+handler_cli/terminal_client.py,sha256=ocmCVyOrHRqT95v1vlklURjUsrGxsEzUZOGwMrf3TRw,1627
+handler_contracts/__init__.py,sha256=uEdyK24gkQQaDXvNZX7LXpDP-BzvoQiXQjQiRDEt2Gs,14777
+handler_contracts/account.py,sha256=pd-T_zCv8MVnQYLZpiTktNFJMcM4zR-nYpb5JN0gB7M,1758
+handler_contracts/acp_endpoint.py,sha256=hEjzGWK8oBJxJ-jWGAOMTQWJhMyAHYbBh73Ay3ZsxyE,2311
+handler_contracts/addon.py,sha256=7zq39o2oI79aE-K8XaG9b87m5GW9_p_ncehrjlYaOxQ,6527
+handler_contracts/agent_spec.py,sha256=8ljmD4j2qd01cedU_5lXUzwK2RT2rDxaCXm8mD2WmnI,3157
+handler_contracts/automation.py,sha256=8eeVoxMjlFbE0jkrQjARyaKOsZs8_Mr8De0LmS6xYhw,10864
+handler_contracts/common.py,sha256=MHsph8XtcNsDv7jbRf96VA7XaEMvxR69sPXwHSPv9cs,8264
+handler_contracts/control.py,sha256=vW_cX92NuzIJvoyFouviS5QVnLdk00756fSeuNBZNO4,47775
+handler_contracts/harness.py,sha256=e4sfmPJGqcLprLGQ36RG2ow8FMVYzAlsIEmELENa0RI,13379
+handler_contracts/miniapp.py,sha256=foDgXDvnYBabTMzwEFsL5toLk0X_XpoGYxaOra0pc3Y,5630
+handler_contracts/provider.py,sha256=R3iy4_z-hapzTPZgfxLDHHST4-2kEJzX_3mgH0I1AdI,3754
+handler_contracts/remote.py,sha256=NxbXZrjGmi2dNCYADxqZWa3sQQyp3KjOf4S6YQpnW6E,4886
+handler_contracts/sandbox.py,sha256=MGqKpwQIBiA2bgPsCaEKUBaERJyE6EMj7comTDpE3ys,7299
+handler_contracts/schemas.py,sha256=RagEVAohXA4sSTQGFN8UG2zHKu7OCblWZQmGT72QvI4,10715
+handler_contracts/terminal.py,sha256=lEMfu5blpK0bYDoHbDYBmwGackoDtnnu6aOWMXxPcA4,1134
+handler_control/__init__.py,sha256=AHQb0rB8Lb-tvHPl2PyZHhsUL7p2A-kaJ6hz2FvZht4,294
+handler_control/access.py,sha256=hQ9IDPZyhnZXdwc9ZqAHB8zItMt8InJVeyWCTTwdxDM,2699
+handler_control/accounts.py,sha256=KK9Q89YsYabZBDoW5LYXrn47Q_qnJT2OJ3YFuikZB9E,10459
+handler_control/addon_install.py,sha256=9YXmKu3FemIzYn0EXNAD_7W9DGPOEH6C8cHlzv2esy8,10510
+handler_control/addons.py,sha256=vk_OEjbbI0yFU1ON-hgsCWuiAsjEZ14AnGxv8e-px2I,5226
+handler_control/agent_state.py,sha256=ECIkdH0Dvlw6Fys_2biZiwTOD4QEduZmKpWGSIzPpiA,2000
+handler_control/agents.py,sha256=gdYkP0A10oDsJWXmzB3lE9qyUglP6icHAcsmBHOI3mU,10911
+handler_control/app_api.py,sha256=QH06bi8NylItlhMdXzuNCoBOc2o4HxvOY8qlJ2HfEUU,3375
+handler_control/app_http.py,sha256=I8dj_swK1omdEaPR8EsWsnnnbKDvkZB1swhI18tjiqg,9652
+handler_control/app_remote.py,sha256=BUyBHEirnSzcNACW4IWBY4oGJ3DQ6triwO2Sq02rkfU,8891
+handler_control/apps.py,sha256=9QCk1muB1lncTAnOIdpF1nrjjNnqROWnAMuZKU_0fCs,38403
+handler_control/auth.py,sha256=s3vhQGoPqckaEfMqh34Hkwd-F4Fi2cJ7WAqzUj_tUQA,1619
+handler_control/automation_config.py,sha256=XKWGtELZbiWpzn4ImEKHp5iNXOAYFDEFu-IeQmwHLw4,10160
+handler_control/automations.py,sha256=kmNptFeNXR_fIl6xeuDy6zMi-5F7WmnToh5DHDHMON0,51445
+handler_control/bindings.py,sha256=JvUD0cZi5MBR9HVED2v_vqjZgR6MNHdhC55_sT3fKxg,5572
+handler_control/builds.py,sha256=VVid-YQmbef3qR1N7r-yevQYzPgRMveQotkag7Ffq2I,14879
+handler_control/builtin_agents.py,sha256=9Fd_NZLuMdmYOVYLsuMLH33t2mDfJ-wRtek2XIHxlQk,3149
+handler_control/caches.py,sha256=OYqGZvopS8S6Qk7pH_c1A9-hLEbsCD7ooSh53jfs6b0,4327
+handler_control/checks.py,sha256=FX7zy_Ee6-QBpRIL2vIkQfzt-cHRSZ-31t4VII34F8c,12436
+handler_control/compose.py,sha256=ahJiD1MW1L3SUuLSvoB4XUCZI8urR0sqonLFxQRAwV8,12006
+handler_control/config_files.py,sha256=36P64ss5gvGfAalt4BKzTJDUFIb1bUquEqpoB1MY1MI,1412
+handler_control/contexts.py,sha256=GTLbWYnMQ3xXTGAuN1lJsRnIBO0sgmEV8QuepFvRMnU,3137
+handler_control/daemon.py,sha256=840RRUIP6x1PJIEUpMgufd-7cLkilp0QC__XovSDtss,2073
+handler_control/desktop.py,sha256=esxpMAA_9t3GMxlKR-WRyL2KSHiIHiRrrL7ErmNmbgs,2699
+handler_control/display.py,sha256=WA59tT1xmq_w0sjedPPiN9DIvRQ0AuFXBgmO0524an4,2371
+handler_control/files.py,sha256=EEw44CyZTGoQ9EJu2q13iNfnUPOGXok0_H3LufNfmnI,733
+handler_control/folders.py,sha256=3DSNrPF19PfEtUu48BVie-Eembsumo9PqXtH-Ty1snA,2740
+handler_control/git_read.py,sha256=3dOP8trIWG5SjksVKENft4o3Wpki8MFTWrka48VEhrQ,1477
+handler_control/image_check.py,sha256=Mxq4KTImuSMwnNw7krTUjkDhBVdbo0beDGWZjPI8U6Y,14329
+handler_control/image_updates.py,sha256=7LJncW2_vE6aSVsHa98XEkGMVVSJdANwbfG2shwgUPg,7266
+handler_control/inbox.py,sha256=aP7KNd7XzdtNCcexBnLWgT7BkQvqCRgUB_vlj5DkiXk,2718
+handler_control/interfaces.py,sha256=o5EbP0gY45sZVnwUkbd-ot5FRAlLANWLGEXHAWZdE8U,6522
+handler_control/knowledge.py,sha256=oedlumsLO6R2jSrEt3Hz0x-z9iunY6XQl6cED2d3_pw,9894
+handler_control/launcher.py,sha256=OfkuSL6FzTRGxJCKhFn79u60klxeRbBHeHjcRiNWjag,14206
+handler_control/llm.py,sha256=E9enxXXu3K_TM2ApfxtrW5C4Ga4DSaCvfey3CL1X0dw,8152
+handler_control/policy.py,sha256=UYvniHObbrHawC8HTe1-pPZaXZeaexBSEjmUWHohzRQ,13097
+handler_control/projects.py,sha256=VklzEM_8B8PI7zoCbAKDOtcvu_L_C4VvV23jlVUSa8k,10581
+handler_control/providers.py,sha256=cU4S8tONF5WTVT-30pbCs8YdtYwllMnqZIXr1yZrzlk,6311
+handler_control/relay.py,sha256=5KcF4qnTfw_HB761Wq8phNB2SvsXmwUPa3w4J5y3c0U,5156
+handler_control/remote.py,sha256=AW3YwJYYzsSXVFiyNIo0t2d8sP6RVkP3Sf1XzUpA_s4,38297
+handler_control/remote_crypto.py,sha256=VXZlQSkU1JiFWHH0b87r6MEbGBJrJhrlhw5DkVyDg9Q,3861
+handler_control/runtime.py,sha256=Eh3t6xBQL0Y2Zv-pwuZixkYcp5dKTrXQ39bVlo1yqnk,5435
+handler_control/sandbox_process.py,sha256=B565YLoH8pwwxZksGSlCi0rDtQWa0CkYmIaLDpjD4RA,8395
+handler_control/schedules.py,sha256=Uf8rrigyg2kGP5caVPd4nm8Ci5jI2oG_qot044FCUEo,2708
+handler_control/secrets.py,sha256=Sp1ENmXk6KeldY3iH-ckDLsxJCWym0T4yjq_w7iZ0b0,9261
+handler_control/service_router.py,sha256=Y_y7fMuW2o1eDxesQOXVQt6A6DaWXAxJQBzjZIO0H_c,7812
+handler_control/services.py,sha256=fDOHCUOocXBnLud1Q0oS6rd2vws6_a_Epu3H7CySsUQ,3530
+handler_control/session_files.py,sha256=72Rh-toPeHzBLZKf_9MxL_j6Ed9TPmzWH56GPWfQe0M,16457
+handler_control/sessions.py,sha256=xPRrAY6WzI8BC7NixJ-lVQDC63eMFE8aiOPD86AzTOY,50976
+handler_control/settings.py,sha256=e9UG5lzGOc6W6Gi3mNEJkl9hqK_2exP1Z5KO8nvzkQk,6747
+handler_control/shortcuts.py,sha256=hsFl5vrR67OAO8wKx3WfJOulrvV5SCxmjPNfQoR11f0,2716
+handler_control/skill_scan.py,sha256=BjI-mEikMVGbPb-TLxGDfBXLu_uzuHdqkLcvatkPo14,3643
+handler_control/skill_sources.py,sha256=WymoWDFCXjxVyqedo2Q3RhDDEmafrtfXo8cIb5kxYcI,2600
+handler_control/skills.py,sha256=nhGfggLa2WTI4s7gvPvwFXA4kE_1kqzsN1kkonqL01E,15781
+handler_control/terminal.py,sha256=Uhvc9bYNo-etJq1w8_4xD_iPvuLM0fY66ASflDnT7rw,2907
+handler_control/terminals.py,sha256=lNEiqMc5STt-m62wMIa8g7p5yZGFNNv1y-qZOG6Wy-k,3867
+handler_control/transcript.py,sha256=ZHzUNpgvg-Y1Pkj2rbVltF4NzTSm20qVD2BPFZAF71w,6953
+handler_control/webpush.py,sha256=QyzaJySJL-c_qrCVhahlFdkzm9tp6rXV8HAvgv_Wtyo,3474
+handler_control/webui.py,sha256=ALYd4PlibTbtnNKrJSljHH2ctMmGxtphtzlLYhO-juc,3989
+handler_control/api/__init__.py,sha256=E-5vvIc6_-WI8zbzG4EAwFGyBvXOFZsALgywHdR-Ybc,5709
+handler_control/api/accounts.py,sha256=Z17Q_Y7Ca9Afrhj6AUVu772sRfyH1es2AYliGYWymSE,9756
+handler_control/api/acp.py,sha256=RERJW0ZSz4713XycMn6kV887hq6oJfSstCoeEbgn7rY,4622
+handler_control/api/addons.py,sha256=oaxmq1ZDMMn9DeYwtXUnbHxcQiU8jFIUTRNgwwL1RnE,3971
+handler_control/api/agents.py,sha256=h-sDv20DglAMc6UE_05Kc330WDYH0iMyEL266_LyCkg,6383
+handler_control/api/apps.py,sha256=BgrOYx8hJvFkGxGOWUCUluSa6Rk7XDbB2A1s9slzjac,4179
+handler_control/api/automations.py,sha256=Fa1k7gUGxBEozf7NIr4zL3rQwOQShn-pefCJSr00B0c,5468
+handler_control/api/bindings.py,sha256=V7dtp9DllM8mDhqHkmqAvNlA_dhr1-GffzLTFF3SfqQ,4452
+handler_control/api/builtin_agents.py,sha256=EQDJ2qM44KIkz964VjGXQxnKUweiPOzZWENA4X8BdbU,824
+handler_control/api/caches.py,sha256=bxcKzdopHT5quNYfBPmDa419hvskeqdvRJPn7n3WdYM,3309
+handler_control/api/catalog.py,sha256=9MgCLFUE6jCbSiPtoJPmrypWctDO3faCG0now2dZtKI,7527
+handler_control/api/common.py,sha256=dzdQwW6zblD1auclynll4KC_XbzQXGNbqUVS9pYYXkk,7284
+handler_control/api/contexts.py,sha256=ahUqhToNdLmeYEy8JR-k_Un9DJ1J6CJ2whdbrCOSEIU,3591
+handler_control/api/folders.py,sha256=TbjyPa5-U3e0QdYqdnRcmtUAXh6IBz7PsB_I7O78bEQ,1846
+handler_control/api/images.py,sha256=6VpC_dF6jOCH3AiEJFE3s47iEgATKDKIkRYM8kDJVa8,6290
+handler_control/api/inbox.py,sha256=7UStolnSC88-P7EKWY-8Q3Zdxnl93O7fvVf2atz-Lyw,716
+handler_control/api/projects.py,sha256=9ihmtUgyAkb2apE_47FpeIUHx-saoa8fiyW3XlCHM4I,7118
+handler_control/api/providers.py,sha256=FerD5O4pailjNObAS2vVdUwB_dOOwGFkhgxgZpVhfYs,4460
+handler_control/api/remote.py,sha256=zbVqzMoJPdW6YLmt2XY7R3jtlUD0_DObY6c2HxyhpfQ,1740
+handler_control/api/secrets.py,sha256=spUEtbMhKAEtmyyNPWFWnZ2LUkdxbAdpPrrhpWmtGa8,7242
+handler_control/api/sessions.py,sha256=plg9d0YDqCD8zinuJ9Uj6te8OnrbL6TNTDCT9ayjE0Y,8171
+handler_control/api/skills.py,sha256=vR_6Dpin1XdPzMAXsbE1Tyd7PcXNhO2q8dXSYgbYnK0,11932
+handler_control/data/automation/bin/handler-llm,sha256=6QWsiPUsCtwXfvovlDi5-vLi05A_-eKwppVXePGRaTc,3511
+handler_control/data/automations/env-issues/automation.toml,sha256=kBv4ebS-is1D66WZ00z-FOm6UYjqTPFtIJDLaxXucjk,891
+handler_control/data/automations/env-issues/extract.py,sha256=Me21j2Z7RQXIpDkGO8rNriiVYPZhzNVoRbvusbD_6Q4,2466
+handler_control/data/automations/env-issues/findings.schema.json,sha256=5g-LAd6XTsjEynIBC9wR6MDtRXdnv6OWYivrUhiXFBU,622
+handler_control/data/automations/env-issues/prompt.md,sha256=cKDaL9Cee4LKWNxAox1S4kBffGZqjhpqWngjabAfAV4,1187
+handler_control/data/builtin-agents/skill-creator/agent.toml,sha256=zGr-NMM1Ok7LfBZEg29o43bOiPdMBYmh1ww5wwvYBVI,629
+handler_control/data/builtin-agents/skill-creator/instructions.md,sha256=xJ5IBfGPrhv8I7AYa2etXOFk3U1r0WtTramDnhAcZ1Y,437
+handler_control/data/builtin-agents/skill-creator/skills/handler-skills/SKILL.md,sha256=0II6NFtfz0gK2SmG6qlFwZVWeacF-s2vZGvrKUCPmeg,2449
+handler_control/data/builtin-agents/skill-creator/skills/skill-creator/LICENSE.txt,sha256=vGs68vMxy8f7DaE0Tvssvlh3oxSYtNcNvHAA80BaE2I,11345
+handler_control/data/builtin-agents/skill-creator/skills/skill-creator/SKILL.md,sha256=3NSAPmHpE-b8JylBhM06cfCfXpJP8gyKmiAXPns8K88,33168
+handler_control/data/builtin-agents/skill-creator/skills/skill-creator/agents/analyzer.md,sha256=v2j0ysWlbGc6kowubWGVhsW5PqNkAmqzdUd3LLRaZjo,10376
+handler_control/data/builtin-agents/skill-creator/skills/skill-creator/agents/comparator.md,sha256=_h_JeHxJXYZMXW6tpHOWR4VyMl_eGzOpbXi_S4Sbej4,7287
+handler_control/data/builtin-agents/skill-creator/skills/skill-creator/agents/grader.md,sha256=VxNNoMGk7qM_vXShycRKqBTwfWvGTeMD7bWG-UHl0ho,9049
+handler_control/data/builtin-agents/skill-creator/skills/skill-creator/assets/eval_review.html,sha256=zkd9zHTcHA0dM1JkankWe1pjY06TaxAZFgAlBll05FI,7058
+handler_control/data/builtin-agents/skill-creator/skills/skill-creator/eval-viewer/generate_review.py,sha256=_J0bkkP-WrYBLr1Xm9dtADXeG3n9O5ad4RTe-rJkePs,16365
+handler_control/data/builtin-agents/skill-creator/skills/skill-creator/eval-viewer/viewer.html,sha256=pTITQm7hEARB1wGjoNSc2nqEL5ktLDZGP008wCWFdfo,44998
+handler_control/data/builtin-agents/skill-creator/skills/skill-creator/references/schemas.md,sha256=joh2GAqJibQGpNPt3fh1sEzf1YBcyGFmhtVSsRzkRV8,12061
+handler_control/data/builtin-agents/skill-creator/skills/skill-creator/scripts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+handler_control/data/builtin-agents/skill-creator/skills/skill-creator/scripts/aggregate_benchmark.py,sha256=Ej7xKOpczAGksawhLvVWfyHpwT09JAYJeAvusyAMSao,14386
+handler_control/data/builtin-agents/skill-creator/skills/skill-creator/scripts/generate_report.py,sha256=E99xGKPFDIPEwyUKYG1fKyCyWj1Ey8OSs9Zp7HUoFFM,12847
+handler_control/data/builtin-agents/skill-creator/skills/skill-creator/scripts/improve_description.py,sha256=h9hkVwIgtpn6xS2jCdLW79sGBke_68dPdoEo5kasz4A,11116
+handler_control/data/builtin-agents/skill-creator/skills/skill-creator/scripts/package_skill.py,sha256=GjMFmw2x73M3XUbVE-XqgTadLog4yXBZew1S3e-NHA8,4234
+handler_control/data/builtin-agents/skill-creator/skills/skill-creator/scripts/quick_validate.py,sha256=Z89XA0AgE5Nsj7da1qGv7NiEHUXMXmBrY06wWCX942U,3972
+handler_control/data/builtin-agents/skill-creator/skills/skill-creator/scripts/run_eval.py,sha256=Q-O4-A2_acNDlnunfiaPrpkdn6PtaLMqD_AlMs1IZX8,11464
+handler_control/data/builtin-agents/skill-creator/skills/skill-creator/scripts/run_loop.py,sha256=e9b2dCAxaFIFF-7JTFX0k8DRVDObBhtNfA8NrRh9DyE,13605
+handler_control/data/builtin-agents/skill-creator/skills/skill-creator/scripts/utils.py,sha256=OviuYsQMc6txIgdDag2amB6EXyXFpwQCKesYnMjkW7E,1661
+handler_control/data/builtin-agents/skill-review/agent.toml,sha256=mHnQB_jXXzOP-jf_y-UcF6F4FXY-UZF1dLicvstT-tw,676
+handler_control/data/builtin-agents/skill-review/instructions.md,sha256=mAj4TRdTq_rZYJHYWJd7VycOAohGWOzZB8_2zAcMzXo,2215
+handler_control/data/builtin-agents/skill-review/interface.json,sha256=lc6B_tyC1B8eC8RcFswj6BEA9DaqhUpYowCpf0LRlQs,2689
+handler_control/data/interfaces/llm/v1/interface.toml,sha256=QPP3ydQSmYaDCIXnSu5FGh9mnUyNgkIGSLleHnpeApw,780
+handler_control/data/interfaces/llm/v1/tools.json,sha256=_S9q677uQUJolGYIC2sXfb0uD7kc7rP-n6xWT2wGvso,3011
+handler_control/data/templates/README.md,sha256=1bqiDC1BHTFreB3GenMhRyOyYb7H5At9zfGxi3egFa4,534
+handler_control/data/templates/providers/anthropic-api.toml,sha256=uIBXxdZ5lu_daN3ur4LfpfT1ppVSe1IEi7E6pPRwOrE,332
+handler_control/data/templates/providers/llamacpp.toml,sha256=gviB-Qm8OHU3_YWrENa3E6WrHCBHCUf-4HVH7g-dQ_I,17552
+handler_control/data/templates/providers/mistral-api.toml,sha256=fFu0rsWYyMFOdwCZFfyv7olcvNLWonlsN51Uq6ceS6k,276
+handler_control/data/templates/providers/ollama.toml,sha256=DGZ0mLso7H6rov-zmFFGe4bT0ygFrEMDkRdKapvwwzs,289
+handler_control/data/templates/providers/openai-api.toml,sha256=GFJqY8RcBITfg3P2JdeXqzc4zIYjqiMm_-YzeNz3p7w,256
+handler_control/data/templates/providers/openrouter.toml,sha256=DyLuMB5UOSpfyAPeqBhOV94BTIiMxqFZJfFUXtR3Vdg,208
+handler_control/migrations/__init__.py,sha256=RoB8DgI4wLaAXFzZC6VTRVR67KSHu4GxbtFE-3v3L9Y,2496
+handler_control/web-ui/favicon.svg,sha256=l7nmpf_PxjUNKE_U6PhDkwPDc9fMgN6e8BYQvx3ZVps,774
+handler_control/web-ui/index.html,sha256=EM6S5P_N4kPFw4xEnSR-2QJ7nDsKPipgxW1L5H7XhkQ,507
+handler_control/web-ui/assets/index-1w5RPsfA.js,sha256=4M62_lok_9g52vXDA0SJ_rhdh8pLUf_p6oJcJh-0VlU,1009903
+handler_control/web-ui/assets/index-dWnzCLzQ.css,sha256=Z2z7TQVOPrmaZYHeq5A3LHEys36KrQMhX3RmXuuKW0A,99761
+handler_control/web-ui/assets/inter-cyrillic-ext-wght-normal-BOeWTOD4.woff2,sha256=yhVwYzOaxK1BjyFPOr_tEZsHmKtNN3OGzlyeWnpDXr0,25960
+handler_control/web-ui/assets/inter-cyrillic-wght-normal-DqGufNeO.woff2,sha256=cdXuk8wenx1SCjqLZkVt4Yx4edjfCdV_zS6v91_vAHU,18748
+handler_control/web-ui/assets/inter-greek-ext-wght-normal-DlzME5K_.woff2,sha256=bp4CCiX5tW1BjywIWx08CXJaTaI_5pOltGMGRgZzIZA,11232
+handler_control/web-ui/assets/inter-greek-wght-normal-CkhJZR-_.woff2,sha256=G-NEjikvvwX_4Xb-HkPxNQE9ULHn0yStGlWPYj07tvY,18996
+handler_control/web-ui/assets/inter-latin-ext-wght-normal-DO1Apj_S.woff2,sha256=NLnFBMq3pz43t0Y0OkSRMuVs97VIGvLLgdx03P8lyVY,85068
+handler_control/web-ui/assets/inter-latin-wght-normal-Dx4kXJAl.woff2,sha256=MQDndehhbNJhG-7PojpCY9cDdYZ4m0PwNSNqLm-9TGI,48256
+handler_control/web-ui/assets/inter-vietnamese-wght-normal-CBcvBZtf.woff2,sha256=XGb54H6QxtSsSSLMaNYN4mwXsYWOZ3-15gP845UrP_I,10252
+handler_harness/__init__.py,sha256=gcqXmlxXEJoFCWAz4esFMZXObAa8I0i-QSQQF39dEZc,605
+handler_harness/addons.py,sha256=Y7CRbEB-ezO6oUWniF6kWrPL2_p4dljIGSlhavnysLg,4534
+handler_harness/catalog.py,sha256=hm3pBm7L3-A7_sV6kal_Jguwp_kql8EYJvjaWgE8glE,4184
+handler_harness/cli.py,sha256=tM2riQ7j3Y-O1UyxyS0KX6kG_npxxtAiugpDTJUimo0,4189
+handler_harness/images.py,sha256=u35iolGdG0BfhX3iyDoA-jecfUqQ9P_89A9OYwM01fw,2423
+handler_harness/providers.py,sha256=br3S7hsb1Zw_MxsnmOrKBYTnpp3R2ItM4FLiZyQpjD8,11667
+handler_harness/render.py,sha256=SJpF8Gsd5mqiP-Q3oJpMFLSYwsH0Qg7QbkK4GOSl-kM,20540
+handler_harness/data/handler-sandbox-env,sha256=KC9BsL52Tg8lPIZgybeE10p2HPSibW8QFP2R6hWGBus,1152
+handler_harness/data/addons/README.md,sha256=01iz8vdkigS66fpQ-En0cyKSYWyCVp7R48wSM9k7Mc0,2642
+handler_harness/data/addons/miniapp/Containerfile,sha256=g5sYRS3lbDsx1qkSyrNAZfYm9_DZNT5TS_4icDlxqrA,844
+handler_harness/data/addons/miniapp/PROVISIONING.md,sha256=gJAQZYnoFyNxv-Et8ht330KRbXr58L7tVnemFOZL_uY,603
+handler_harness/data/addons/miniapp/addon.toml,sha256=Hkq_KesAHtkuxkceofWsPGiZelJ1OnU-S1dpZf7QdCw,868
+handler_harness/data/addons/miniapp/skills/miniapp/SKILL.md,sha256=6w-KWy8twsfaNGxFdRCkXanZUrs14j7SRMB1JZ6ERBU,8814
+handler_harness/data/addons/miniapp/skills/miniapp/template/.gitignore,sha256=Ww_P8-8E2jmWEf6J-z_tsG6K0ZKOfRwc2XrPgirp_II,31
+handler_harness/data/addons/miniapp/skills/miniapp/template/app.toml,sha256=LE_uJYWk_hvt1-wCSmxREjsEXIyGFQcQwGl_k0o2-zA,586
+handler_harness/data/addons/miniapp/skills/miniapp/template/server/db.ts,sha256=eIdgPAY5OTOhEeZGIT1T3aja0eUKI7SE0INCT26vge0,1077
+handler_harness/data/addons/miniapp/skills/miniapp/template/server/deno.json,sha256=GpeLDbbvO6QBf0vzVF-TeC4Jkyh3uf9iSAlgZP4VoO4,255
+handler_harness/data/addons/miniapp/skills/miniapp/template/server/handler.ts,sha256=9vXpqdySnz185J8tVaQSc8ZwWZz2OG3_BZQZMmOLAAY,1185
+handler_harness/data/addons/miniapp/skills/miniapp/template/server/main.ts,sha256=2K8s8Di1HWXlj_f2-1x-6qNzEZIrbJWKsaW655AF4rw,818
+handler_harness/data/addons/miniapp/skills/miniapp/template/server/main_test.ts,sha256=FFCMemfxFEdCee-6O_FQ85u0G_GyBBdrJ0XYptbhFzI,1363
+handler_harness/data/addons/miniapp/skills/miniapp/template/server/routes.ts,sha256=5ihC8GUw_FZCK631VKtwFEqfQlMsAertG8gusIF-TuE,1487
+handler_harness/data/addons/miniapp/skills/miniapp/template/server/migrations/001_notes.sql,sha256=IFx5b26gHM0NJ4JHcxjHE0_r3TsrA-mgOBghRP08clA,171
+handler_harness/data/addons/miniapp/skills/miniapp/template/ui/deno.json,sha256=7tnHhD96JpRI4snnkwZy60sb4lGPa5dBhsJP7dByoLk,291
+handler_harness/data/addons/miniapp/skills/miniapp/template/ui/index.html,sha256=cS5eAJ9v3uNBuQHiA65jsRe5Rb43x_DEzdn2NryKCwY,288
+handler_harness/data/addons/miniapp/skills/miniapp/template/ui/vite.config.ts,sha256=uRQMeTR2JDd4GFZc9mDz5Mx20WSnacpxtLOOxFPXNYw,675
+handler_harness/data/addons/miniapp/skills/miniapp/template/ui/src/App.svelte,sha256=cszVVXfAM2_lZ226J-G-ZTxSFcho1vWvWDN7ZAEG7DE,1121
+handler_harness/data/addons/miniapp/skills/miniapp/template/ui/src/api.ts,sha256=WV1TT_HW94xBD5mvL0ZC78wcZx8QQsNbw1EmwJ13Ldw,1035
+handler_harness/data/addons/miniapp/skills/miniapp/template/ui/src/app.css,sha256=HPUcFTr42E4bKNhl26vtN09tdaVr4wemaxXMdLDyq08,289
+handler_harness/data/addons/miniapp/skills/miniapp/template/ui/src/main.ts,sha256=62oaXZ_afOhKSVUO7pGeMDGAdxePQevyhX9Q9glHWRI,142
+handler_harness/data/catalog/README.md,sha256=YseuqgRKTY5-vC-3D8ZKYkp333wPVmp_2jHKMxEh-do,883
+handler_harness/data/catalog/playwright/Containerfile,sha256=FuXXP1Xoyl8D_qNVG8yza23RzRvBn8tc1hAWDF12Ees,1699
+handler_harness/data/catalog/playwright/PROVISIONING.md,sha256=mVanfu4eQr4_ZLD-dpx0dxz7GOMgRC3Mte3aCE9rv2E,2153
+handler_harness/data/catalog/playwright/addon.toml,sha256=x3c2iNnAMNFLK4ExpBW8sv2abLbkhB1bE7LSWrgQN1c,1312
+handler_harness/data/catalog/playwright/handler/playwright-mcp-check.mjs,sha256=Attl0Zd0L-dn3UwH23K0VclQL8Jt70XdOi-bvnJyHx8,998
+handler_harness/data/catalog/playwright/handler/playwright-mcp.mjs,sha256=qk0-o8j2FmmE6Mm6730DhwZ6JWQy1GkY4kCfWyzulOY,2801
+handler_harness/data/catalog/playwright/skills/browser/SKILL.md,sha256=sFfU8fBUtOuuELSWNnv1Ooa_xfUGNQw08_AXKt0Yjzg,2192
+handler_harness/data/catalog/shopify/Containerfile,sha256=w3m7fzYkMhhTON6h_P1sAB6ga6zP01ybzUMW_WOwZR4,1208
+handler_harness/data/catalog/shopify/PROVISIONING.md,sha256=XgBVN5T6vVVB7BiJQj_RzTAMmFc8u9O28IliuRU4yH0,2110
+handler_harness/data/catalog/shopify/addon.toml,sha256=Jxzy3HrcuNHq1OPCaeMX-y6C2cj1yQWkgYzIVe1v30U,1836
+handler_harness/data/catalog/shopify/skills/shopify/SKILL.md,sha256=BNhDos63S7x5-w2arSsAffCO79Cx4NpkDpFmRXvaTBI,1971
+handler_harness/data/harnesses/README.md,sha256=REl5xKr_Gb0UHRiAgsCXvYq_gsw4C-JC4OKPiAQ65_g,4083
+handler_harness/data/harnesses/claude-code/Containerfile,sha256=NoB-o3ZsEgKG8zQAsPzgwF5aFrEtpN8yZxn2oI42IDw,1639
+handler_harness/data/harnesses/claude-code/harness.toml,sha256=OHnL3rsjengn5Ww-mqLOKwbm1uyuS7faUseqUJJxpiQ,4955
+handler_harness/data/harnesses/codex/Containerfile,sha256=eYzhS2LPOBZ4NnhrH4d4fvYlRKO0zkNAGxW-C4E5McU,1744
+handler_harness/data/harnesses/codex/harness.toml,sha256=zcRex6oTmxTZRSqQNbWlzgJZLxeSzMMxBt6NdRNCuNk,5047
+handler_harness/data/harnesses/pi/Containerfile,sha256=TX_D2KrebETpy_ATRSh87KHgitDTRPzwP8100I4oGqI,1653
+handler_harness/data/harnesses/pi/harness.toml,sha256=LWxf77QcaCAV6it56lqWwVUlyvaOuf2KAOoVZsYMglU,3314
+handler_harness/data/harnesses/vibe/Containerfile,sha256=FMdNXEvyAKXtZSVqJF4SQf1p8JrZUMrIN4stXkovPjc,884
+handler_harness/data/harnesses/vibe/harness.toml,sha256=VJuUEwGC3Mvx5iIVv_KoM3rTeR1vTook3Jt3XJecIKg,4322
+handler_harness/data/toolbox/Containerfile,sha256=PpH0e-JEpnr_eHV5hrggQQq-qrqSeFJ8lvDaJ90I1ck,2988
+handler_harness/data/toolbox/README.md,sha256=bFy_D0Nv69dR159xvE-t-fAz9vjPHGEjFs2Rm1jsMms,1648
+handler_harness/data/toolbox/toolbox.toml,sha256=W5lYuAxNQ_IQQuY41HPbn13u4L1v03o2KhC1loAktVc,1243
+handler_sandbox_podman/__init__.py,sha256=mL_TJ6_6NuZHTBItyYSMYYzjS22Oosyc8kxLhTWqoz8,62
+handler_sandbox_podman/caches.py,sha256=pld6dVa784TubQMCxcKzV22lPtwMxjrRJLvQTUFDlXI,3953
+handler_sandbox_podman/check.py,sha256=i4QUc49CS669DA7dRf769GU0N4dCz0_eHpJchlfk0d0,4274
+handler_sandbox_podman/cli.py,sha256=NFYBsmg-_Afa76HBR2ypQlUNtgRtK8ct1SqHGo3QpZc,10016
+handler_sandbox_podman/egress.py,sha256=_xkMBp3bHkjtUigdC8TsvOBoa_pWAU_ylH6e_Iwo9rQ,4720
+handler_sandbox_podman/images.py,sha256=dw8yeiWsi0X1Uw1F_zcuAMC2VHnQtDjY2CsA46Dmo4s,7192
+handler_sandbox_podman/launch.py,sha256=Wvy5QOuP7S9_jLxQsaD-G3JTLG0gzGkZllU69Hwiokw,21528
+handler_sandbox_podman/podman.py,sha256=Qnqfw4Dv_Shu7rxm5q4zV31QSqEQhkYHTsXdsdvBNAA,4445
+handler_sandbox_podman/proxy/Containerfile,sha256=dF56zLSfELXw94CC2zJEYz8FVBRbz6zDWGbmv9Tzq4g,401
+handler_sandbox_podman/proxy/addon.py,sha256=Pr8dXkFR7A5mrsJUAMij3lOQjOQpTVC-Jc2j-rydB0c,10659
+handler_ai-0.1.0.dist-info/METADATA,sha256=IEmlmZf3Ul1i0qMWIv9SKtS-dbZkldfwCWl0vNEKgO0,2497
+handler_ai-0.1.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+handler_ai-0.1.0.dist-info/entry_points.txt,sha256=BVznYHkhvLm9-vMiNdqoGKhZGx5guBFxIuLEuCNbNnA,222
+handler_ai-0.1.0.dist-info/RECORD,,

handler_ai-0.1.0.dist-info/WHEEL

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

handler_ai-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,6 @@
+[console_scripts]
+handler = handler_cli.cli:main
+handler-ai = handler_cli.cli:main
+handler-harness = handler_harness.cli:main
+handler-sandbox-podman = handler_sandbox_podman.cli:main
+handlerd = handler_control.daemon:main

handler_cli/__init__.py

@@ -0,0 +1 @@
+"""handler — command line client of handlerd (contracts C and D only; never touches podman)."""

handler_cli/account_commands.py

@@ -0,0 +1,314 @@
+"""`handler account …` — accounts (contract D.9): a subscription one harness logs in with.
+
+A token login (Claude Code): you run its sign-in yourself (`claude setup-token`, Anthropic's own,
+in your browser) and give handler the token it prints, or tell handler where you keep it; handler
+never runs that sign-in nor reads its output. A file login (Codex, Vibe): handler runs the harness's
+login here and keeps the credential file it leaves.
+
+handler account list                 accounts, their harness, plan, login and contexts
+handler account add NAME HARNESS [--description TEXT] [--plan PLAN] [--context CONTEXT …]
+                [--token | --token-env VAR | --token-file PATH | --token-command CMD]
+                                     PLAN: its subscription's (e.g. pro, max for claude-code),
+                                     told to the harness, which cannot learn it from a token.
+                                     --context: the project contexts it is made for (Work,
+                                     Personal…, or any; none: it runs nowhere a project has one)
+                                     --token…: its token login at once (as `handler account token`)
+handler account token NAME [--env VAR | --file PATH | --command CMD]
+                                     a token login: the token your own sign-in printed (asked
+                                     for, or read from stdin), kept in handler's secret store; or
+                                     where you keep it: an env var of handlerd, a file (its first
+                                     line), a command printing it (e.g. 'pass show claude-pro')
+handler account login NAME [--keep-open] a file login: its harness's own login runs here, on this
+                                     computer (npx or uvx fetches it), its state in a folder of
+                                     its own; handler keeps the file it leaves. --keep-open: wait
+                                     for Enter at the end (a window the web UI opened for it)
+handler account import NAME FILE     or give a file login done elsewhere: the credential file it
+                                     left (e.g. ~/.codex/auth.json after `codex login`)
+handler account rm NAME              it and its login (refused while an agent uses it)
+"""
+
+import argparse
+import contextlib
+import fcntl
+import getpass
+import os
+import pty
+import pwd
+import select
+import shlex
+import shutil
+import signal
+import struct
+import subprocess
+import sys
+import tempfile
+import termios
+import tty
+from pathlib import Path
+from typing import Any
+
+from .client import ClientError, Daemon
+from .output import table
+
+
+def add_parser(sub: Any) -> None:
+    account = sub.add_parser("account", help="accounts", description=__doc__,
+                             formatter_class=argparse.RawDescriptionHelpFormatter)  # fmt: skip
+    a = account.add_subparsers(dest="account_cmd", required=True)
+    a.add_parser("list")
+    add = a.add_parser("add")
+    add.add_argument("name")
+    add.add_argument("harness")
+    add.add_argument("--description")
+    add.add_argument("--plan")
+    add.add_argument(
+        "--context",
+        action="append",
+        metavar="CONTEXT",
+        default=[],
+        help="a project context it is made for (Work, any…); repeatable",
+    )
+    given = add.add_mutually_exclusive_group()
+    given.add_argument("--token", action="store_true", help="ask for the token now")
+    given.add_argument("--token-env", metavar="VAR")
+    given.add_argument("--token-file", metavar="PATH")
+    given.add_argument("--token-command", metavar="CMD")
+    token = a.add_parser("token")
+    token.add_argument("name")
+    where = token.add_mutually_exclusive_group()
+    where.add_argument("--env", metavar="VAR")
+    where.add_argument("--file", metavar="PATH")
+    where.add_argument("--command", metavar="CMD")
+    log_in = a.add_parser("login")
+    log_in.add_argument("name")
+    log_in.add_argument("--keep-open", action="store_true", help="wait for Enter at the end")
+    imp = a.add_parser("import")
+    imp.add_argument("name")
+    imp.add_argument("file", type=Path)
+    a.add_parser("rm").add_argument("name")
+
+
+def dispatch(args: argparse.Namespace) -> int:
+    d = Daemon()
+    if args.account_cmd == "list":
+        rows = [["NAME", "HARNESS", "PLAN", "LOGIN", "CONTEXTS", "AGENTS"]]
+        for a in d.call("GET", "/v1/accounts"):
+            harness, plan = a.get("harness") or "?", a.get("plan") or "-"
+            contexts = ", ".join(a.get("contexts", [])) or "-"
+            rows.append([a["name"], harness, plan, login_status(a), contexts,
+                         ", ".join(a["agents"])])  # fmt: skip
+        table(rows) if len(rows) > 1 else print("no account")
+        return 0
+    if args.account_cmd == "add":
+        return add(d, args)
+    if args.account_cmd == "token":
+        return give_token(d, args.name, token_body(args.name, args.env, args.file, args.command))
+    if args.account_cmd == "import":
+        return import_login(d, args.name, args.file)
+    if args.account_cmd == "login":
+        return login_window(d, args.name, keep_open=args.keep_open)
+    d.call("DELETE", f"/v1/accounts/{args.name}")
+    print(f"{args.name}: removed")
+    return 0
+
+
+def login_window(d: Daemon, name: str, *, keep_open: bool) -> int:
+    """`handler account login`, its errors said in its own terminal (a window may close at once)."""
+    try:
+        return login(d, name)
+    except ClientError as e:
+        print(f"handler: {e}")
+        return 1
+    finally:
+        if keep_open:
+            with contextlib.suppress(EOFError, KeyboardInterrupt):
+                input("\nPress Enter to close this window.")
+
+
+def login_status(a: dict[str, Any]) -> str:
+    """Its login as `handler account list` says it: logged in (and how), or what is missing."""
+    if a["status"] == "invalid":
+        return a.get("error") or "invalid"
+    if a["status"] != "ready":
+        return "; ".join(a.get("problems") or ["not logged in"])
+    where = {"secret": "token in handler", "env": "token from an env var",
+             "file": "token from a file",
+             "command": "token from a command"}.get(a.get("token") or "", "logged in")  # fmt: skip
+    expires = a.get("expiresAt")
+    return f"{where}, until {expires[:10]}" if expires else where
+
+
+def add(d: Daemon, args: argparse.Namespace) -> int:
+    body = {
+        "name": args.name,
+        "harness": args.harness,
+        "description": args.description,
+        "contexts": args.context,
+    }
+    body |= {"plan": args.plan} if args.plan else {}
+    made = d.call("POST", "/v1/accounts", body)
+    print(f"{args.name}: created")
+    if args.token or args.token_env or args.token_file or args.token_command:
+        given = token_body(args.name, args.token_env, args.token_file, args.token_command)
+        return give_token(d, args.name, given)
+    if made.get("login") == "token":
+        print(f"log it in: run `{token_command(d, args.harness)}`, then: handler account token "
+              f"{args.name}")  # fmt: skip
+    elif made.get("login") == "file":
+        print(f"log it in: handler account login {args.name}")
+    return 0
+
+
+def token_command(d: Daemon, harness: str) -> str:
+    found = next((h for h in d.call("GET", "/v1/harnesses") if h["name"] == harness), None)
+    return ((found or {}).get("login") or {}).get("tokenCommand") or "its sign-in"
+
+
+def token_body(name: str, env: str | None, file: str | None, command: str | None) -> dict[str, Any]:
+    """`PUT …/login`'s body: a reference to where the token is kept, else the token, asked for."""
+    if env:
+        return {"tokenRef": {"env": env}}
+    if file:
+        return {"tokenRef": {"file": str(Path(file).expanduser().resolve())}}
+    if command:
+        return {"tokenRef": {"command": shlex.split(command)}}
+    return {"token": ask_token(name)}
+
+
+def give_token(d: Daemon, name: str, body: dict[str, Any]) -> int:
+    if not body.get("tokenRef") and not body.get("token"):
+        raise ClientError(f"no token given for {name}")
+    return save(d, name, body)
+
+
+def import_login(d: Daemon, name: str, file: Path) -> int:
+    account = next((a for a in d.call("GET", "/v1/accounts") if a["name"] == name), None)
+    if account is None:
+        raise ClientError(f"no account '{name}' (handler account list)")
+    if account.get("login") != "file":
+        raise ClientError(f"the login of '{name}' is a token: handler account token {name}")
+    return save(d, name, {"file": file.read_text()})
+
+
+def ask_token(name: str, what: str = "token") -> str:
+    prompt = f"{what} for {name}: "
+    return (getpass.getpass(prompt) if sys.stdin.isatty() else sys.stdin.readline()).strip()
+
+
+def save(d: Daemon, name: str, body: dict[str, Any]) -> int:
+    made = d.call("PUT", f"/v1/accounts/{name}/login", body)
+    logged_in = made["status"] == "ready"
+    print(f"{name}: {'logged in' if logged_in else login_status(made)}")
+    return 0 if logged_in else 1
+
+
+def login(d: Daemon, name: str) -> int:
+    """A file login (D.9) on this computer, on a terminal of its own relayed to this one: its
+    state in a folder given as `{dir}`, then the file it leaves there becomes the account's
+    login. A token login is the person's own to run: said, not run."""
+    account = next((a for a in d.call("GET", "/v1/accounts") if a["name"] == name), None)
+    if account is None:
+        raise ClientError(f"no account '{name}' (handler account list)")
+    harness = next(
+        (h for h in d.call("GET", "/v1/harnesses") if h["name"] == account.get("harness")), None
+    )
+    recipe = harness and harness.get("login")
+    if not recipe:
+        raise ClientError(f"'{name}': {account.get('error') or 'its harness has no login'}")
+    if recipe.get("tokenCommand"):
+        raise ClientError(
+            f"'{name}' logs in with a token you make: run `{recipe['tokenCommand']}`, "
+            f"then: handler account token {name}"
+        )
+    if not harness.get("loginFile"):  # a handlerd older than this handler
+        raise ClientError("handlerd does not say where the login leaves its file: restart it")
+    path = search_path(recipe["command"][0], account["harness"])
+    argv = [str(shutil.which(recipe["command"][0], path=path)), *recipe["command"][1:]]
+    if recipe.get("help"):
+        print(recipe["help"])
+    with tempfile.TemporaryDirectory(prefix="handler-login-") as folder:
+        env = (
+            dict(os.environ)
+            | {"PATH": path}
+            | {k: v.replace("{dir}", folder) for k, v in (recipe.get("env") or {}).items()}
+        )
+        code = on_terminal(argv, env, folder)
+        file = Path(folder) / harness["loginFile"]
+        if not file.is_file() or not file.read_text(errors="replace").strip():
+            print(f"\n{name}: not logged in: it left no {file.name} (exit {code})")
+            return 1
+        return save(d, name, {"file": file.read_text()})
+
+
+def search_path(program: str, harness: str) -> str:
+    """The PATH the login runs with: this one when it has the program, else the person's login
+    shell's (a window handlerd opened has handlerd's, a systemd service's: without ~/.local/bin…),
+    where what the program needs (node for npx) is too."""
+    for path in (os.environ.get("PATH", ""), login_path()):
+        if shutil.which(program, path=path):
+            return path
+    raise ClientError(
+        f"the {harness} login runs {program} on this computer: install it "
+        "(npx: Node.js and npm; uvx: uv)"
+    )
+
+
+def login_path() -> str:
+    shell = pwd.getpwuid(os.getuid()).pw_shell or "/bin/sh"
+    with contextlib.suppress(OSError, subprocess.SubprocessError):
+        printed = subprocess.run(
+            [shell, "-lc", "printenv PATH"],
+            capture_output=True,
+            text=True,
+            timeout=10,
+            stdin=subprocess.DEVNULL,
+            check=False,
+        ).stdout.strip()
+        if printed:
+            return printed.splitlines()[-1]  # after what its shell profile may print
+    return ""
+
+
+def on_terminal(argv: list[str], env: dict[str, str], cwd: str) -> int:
+    """Run `argv` on a terminal of its own, relayed to this one (raw while it runs, resized with
+    it): its exit code."""
+    pid, master = pty.fork()
+    if pid == 0:  # the child, on the new terminal
+        os.chdir(cwd)
+        os.execve(argv[0], argv, env)
+    interactive = sys.stdin.isatty()
+    saved = termios.tcgetattr(0) if interactive else None
+
+    def resize(*_: object) -> None:
+        cols, rows = shutil.get_terminal_size()
+        fcntl.ioctl(master, termios.TIOCSWINSZ, struct.pack("HHHH", rows, cols, 0, 0))
+
+    resize()
+    inputs = [0, master]
+    try:
+        if interactive:
+            tty.setraw(0)
+            signal.signal(signal.SIGWINCH, resize)
+        while True:
+            ready, _, _ = select.select(inputs, [], [])
+            if master in ready:
+                try:
+                    data = os.read(master, 65536)
+                except OSError:  # EIO: the command and all it started are gone
+                    data = b""
+                if not data:
+                    break
+                os.write(1, data)
+            if 0 in ready:
+                data = os.read(0, 4096)
+                if data:
+                    os.write(master, data)
+                else:  # stdin ended (piped): the command goes on without it
+                    inputs.remove(0)
+    finally:
+        if saved is not None:
+            termios.tcsetattr(0, termios.TCSADRAIN, saved)
+            signal.signal(signal.SIGWINCH, signal.SIG_DFL)
+        os.close(master)
+    _, status = os.waitpid(pid, 0)
+    return os.waitstatus_to_exitcode(status)