qwen-web-arwaky: Instructions file for Codex

qwen-web-arwaky — Agent Operating Guide

Agent Overview

Production-grade Python CLI + MCP server that automates chat.qwen.ai with no API key: it sends prompts, waits for the response, extracts it, and saves it locally. Built on the AES 7-layer architecture, enforced in CI by lint-arwaky-cli at zero violations. Before generating code, docs, or suggestions, an agent must know: INPUT is prompt text or -i <prompt>.md, optionally -a <attachment>, driven through an authenticated chat.qwen.ai browser session; OUTPUT is a Markdown file at -o <path> whose extraction relies on pinned DOM selectors the tests lock as regressions, and whose .meta.json sidecar lives under XDG state (~/.local/state/qwen-web-arwaky/meta/), never in the output folder. The CLI is qwen-web-arwaky (alias qwa); the legacy qwen-web-cli and qwc entry points were removed in v6.0.0. Pipeline shape: CLI/MCP surface → agent orchestrator → capabilities → Playwright browser adapter → Markdown output (input → orchestrate → execute → drive → persist), wired once by the root containers. Response style: concise, technical, direct — lead with the command or the diff, explanation after if needed.

Runtime

Project Structure

.
├── modules/shared/src/              # taxonomy_*, contract_*, utility_*
├── modules/browser/src/             # agent_browser_orchestrator, capabilities_browser_*
├── modules/config/src/              # agent_config_orchestrator, capabilities_config_*
├── modules/jobs/src/                # agent_job_orchestrator, capabilities_folder_compiler, capabilities_job_storage
├── modules/logging/src/             # agent_logging_orchestrator, capabilities_metrics_counter, capabilities_observability_setup
├── modules/prompt/src/              # agent_prompt_orchestrator, agent_shared_flow_orchestrator, capabilities_*
├── modules/prompt_runtime/src/      # agent_prompt_runtime_orchestrator, capabilities_* (browser/stream/persist layer)
├── modules/session/src/             # agent_session_orchestrator, capabilities_session_*
├── modules/swarm/src/               # agent_swarm_orchestrator, capabilities_swarm_runner
├── modules/update/src/              # agent_update_orchestrator, capabilities_update_manager
├── modules/cli/src/                 # surface_cli_*, root_cli_container
├── modules/tui/src/                 # surface_tui_* (Textual TUI layer; depends on cli, never vice versa)
├── modules/mcp/src/                 # surface_mcp_*, root_mcp_container
├── modules/shared/templates/        # role templates (package data of the shared member), free of HTML-escaped tokens
├── modules/root_cli_main_entry.py   # CLI composition root entry point
├── modules/root_mcp_main_entry.py   # MCP composition root entry point
├── modules/root_core_container.py   # shared dependency wiring used by the CLI and MCP roots
├── tests/                           # shared fixtures (conftest, pipeline_fixtures, helpers) — not a pytest root; pytest lives in modules/*/tests/
├── benches/                         # benchmark suite, marker: benchmark
├── lint_arwaky.config.yaml          # architecture rules enforced by lint-arwaky-cli
├── pyproject.toml                   # build config, entry points, and pinned dependencies
├── uv.lock                          # lockfile; `uv lock --check` is a CI gate
└── Containerfile                    # containerized execution, driven by scripts/podman.sh