[Bug][multi-agent-shared-context]: pip-installed statewave_agents fails to import - it depends on the unpackaged core/ module #484

Affected Component

statewave-multi-agent-shared-context — pyproject.toml, statewave_agents/

Bug Description

pyproject.toml presents statewave_agents as an installable, reusable package ("Reusable shared-context coordination for multi-agent LLM systems"), but it only packages that one directory:

[tool.setuptools.packages.find]
include = ["statewave_agents*"]

statewave_agents imports two modules that live outside it:

• statewave_agents/agent.py:13 — from core.llm import LLMClient
• statewave_agents/context.py:16 — from core.statewave_client import StatewaveClient

So after pip install . (or pip install git+https://github.com/smaramwbc/statewave-multi-agent-shared-context), import statewave_agents fails with ModuleNotFoundError: No module named 'core'. It only works when run from inside the repo checkout, where core/ happens to be on sys.path.

The statewave_agents/__init__.py docstring example also doesn't match the code: it shows MyAgent(ctx, name="Planner"), but Agent.__init__ takes (llm, context, model=...) and has no name argument.

Expected Behavior

pip install . then from statewave_agents import SharedContext, Agent works in a clean virtualenv.

Suggested fix

Simplest: also include core in the find list, i.e. include = ["statewave_agents*", "core*"]. (Moving the two modules under statewave_agents/ is cleaner but touches more files.) Then fix the __init__ docstring example to match Agent(llm, context).

Steps to Reproduce

python -m venv /tmp/v && /tmp/v/bin/pip install .
cd /tmp && /tmp/v/bin/python -c "import statewave_agents"
# ModuleNotFoundError: No module named 'core'

Environment

main @ eb66ddc.

Severity

Medium — the reusable package can't be installed and imported.