campaign-rpg-engine 1.0.0__tar.gz

campaign_rpg_engine-1.0.0/.gitignore

@@ -0,0 +1,156 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff
+instance/
+.webassets-cache
+
+# Scrapy stuff
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# poetry
+poetry.lock
+
+# pdm
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.env.local
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# IDEs
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Project specific
+logs/
+*.log

campaign_rpg_engine-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DaveH-Ghost
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

campaign_rpg_engine-1.0.0/PKG-INFO

@@ -0,0 +1,114 @@
+Metadata-Version: 2.4
+Name: campaign-rpg-engine
+Version: 1.0.0
+Summary: CampAIgn — map-based LLM RPG simulation engine (Session API, multi-area worlds, compound turns)
+Project-URL: Homepage, https://github.com/DaveH-Ghost/CampAIgn-RPG-Engine
+Project-URL: Documentation, https://github.com/DaveH-Ghost/CampAIgn-RPG-Engine/blob/main/docs/README.md
+Project-URL: Repository, https://github.com/DaveH-Ghost/CampAIgn-RPG-Engine
+Project-URL: Issues, https://github.com/DaveH-Ghost/CampAIgn-RPG-Engine/issues
+Project-URL: Changelog, https://github.com/DaveH-Ghost/CampAIgn-RPG-Engine/blob/main/docs/changelog/README.md
+Author-email: DaveH-Ghost <davidhall.a27@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,campaign,game-engine,grid,llm,roleplay,rpg,simulation
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Games/Entertainment
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Requires-Dist: openai
+Requires-Dist: pydantic
+Requires-Dist: python-dotenv
+Requires-Dist: rich
+Description-Content-Type: text/markdown
+
+# CampAIgn RPG Engine
+
+Grid-based LLM agent simulation engine: multi-area worlds, compound turns (move → look → speak → interact/emote), pluggable memory modules, and a stable **`campaign_rpg_engine`** library API. Build your own UI and scenarios on the engine; use [CampAIgn-RPG-Studio](https://github.com/DaveH-Ghost/CampAIgn-RPG-Studio) as a full GM reference app.
+
+**License:** [MIT](LICENSE) — open source.
+
+**Current version:** **1.0.0** — library-first package (`campaign_rpg_engine` only; no CLI). See [Migration from 0.7](docs/MIGRATION-0.7-to-1.0.md) and the [changelog index](docs/changelog/README.md).
+
+## Quick start
+
+```powershell
+cd path\to\CampAIgn-RPG-Engine
+uv sync
+uv run pytest
+```
+
+```python
+from campaign_rpg_engine import Session, load_profile, AgentCompoundTurn
+
+session = Session.from_profile(load_profile("default_compound"))
+session.create_agent(name="Scout", position=(0, 0), personality="Curious.")
+session.create_object(name="Chest", position=(2, 1), passive_description="An old chest.")
+prompt = session.build_prompt()
+result = session.run_compound_turn(
+    AgentCompoundTurn(reasoning="look around", action="none"),
+)
+```
+
+**GM web UI:** clone [CampAIgn-RPG-Studio](https://github.com/DaveH-Ghost/CampAIgn-RPG-Studio) (separate GitHub repo):
+
+```powershell
+cd path\to\CampAIgn-RPG-Studio
+uv sync
+copy .env.example .env   # optional; or use Settings gear in the UI
+uv run campaign-rpg-studio
+```
+
+On Windows, if Smart App Control blocks `uv run campaign-rpg-studio`, use `uv run python -m backend.main`. Open [http://127.0.0.1:8765](http://127.0.0.1:8765).
+
+## Environment
+
+Copy [`.env.example`](.env.example) to `.env` and set `OPENROUTER_API_KEY` for LLM turns. Optional `OPENROUTER_MODEL` (default `deepseek/deepseek-v4-flash`). Engine tests mock the LLM — no key required for `uv run pytest`.
+
+CampAIgn-RPG-Studio **Settings** (gear icon) can set API key and model **in memory for the current server process only** — nothing is written to disk.
+
+## Custom memory modules
+
+Register `.py` modules at process startup before creating agents or loading saves:
+
+```python
+from campaign_rpg_engine import register_memory_module_from_path
+
+register_memory_module_from_path("path/to/my_module.py")
+session.create_agent(..., memory_module="my_module_id")
+```
+
+Saves store `module_id` + state only (no bundled source). Import **fails** if a save references a module that is not loaded. Sample module and upload UI: [CampAIgn-RPG-Studio `fixtures/custom_memory/`](https://github.com/DaveH-Ghost/CampAIgn-RPG-Studio/tree/main/fixtures/custom_memory).
+
+## Lorebooks
+
+Load SillyTavern-style `.json` lorebooks via `session.load_lorebook_from_path(...)` or CampAIgn-RPG-Studio **Lorebooks** tab. Add a `lorebook` prompt block in Prompt layout to inject matched world info. Not included in the default prompt layout.
+
+## Tests
+
+```powershell
+uv run pytest
+```
+
+CampAIgn-RPG-Studio API tests live in the [CampAIgn-RPG-Studio](https://github.com/DaveH-Ghost/CampAIgn-RPG-Studio) repo.
+
+## Documentation
+
+Start at **[docs/README.md](docs/README.md)** — guides, API overview, and changelog index.
+
+| Doc | Topic |
+|-----|--------|
+| [Building on CampAIgn-RPG-Engine](docs/guides/building-on-campaign-rpg-engine.md) | App integration (typed API, hosting) |
+| [API reference](docs/guides/api-reference.md) | `campaign_rpg_engine` exports and Session methods |
+| [Migration realm-fabric → campaign-rpg-engine](docs/MIGRATION-realm-fabric-to-campaign-rpg-engine.md) | Rename from Realm-Fabric / `realm_fabric` |
+| [CampAIgn-RPG-Studio](https://github.com/DaveH-Ghost/CampAIgn-RPG-Studio) | Full GM reference UI (GitHub) |
+| [Roadmap](docs/ROADMAP.md) | Version plans |
+| [Long-term goals](LONG_TERM_GOALS.md) | Aspirational features |
+
+Older version notes: [changelog index](docs/changelog/README.md).

campaign_rpg_engine-1.0.0/README.md

@@ -0,0 +1,84 @@
+# CampAIgn RPG Engine
+
+Grid-based LLM agent simulation engine: multi-area worlds, compound turns (move → look → speak → interact/emote), pluggable memory modules, and a stable **`campaign_rpg_engine`** library API. Build your own UI and scenarios on the engine; use [CampAIgn-RPG-Studio](https://github.com/DaveH-Ghost/CampAIgn-RPG-Studio) as a full GM reference app.
+
+**License:** [MIT](LICENSE) — open source.
+
+**Current version:** **1.0.0** — library-first package (`campaign_rpg_engine` only; no CLI). See [Migration from 0.7](docs/MIGRATION-0.7-to-1.0.md) and the [changelog index](docs/changelog/README.md).
+
+## Quick start
+
+```powershell
+cd path\to\CampAIgn-RPG-Engine
+uv sync
+uv run pytest
+```
+
+```python
+from campaign_rpg_engine import Session, load_profile, AgentCompoundTurn
+
+session = Session.from_profile(load_profile("default_compound"))
+session.create_agent(name="Scout", position=(0, 0), personality="Curious.")
+session.create_object(name="Chest", position=(2, 1), passive_description="An old chest.")
+prompt = session.build_prompt()
+result = session.run_compound_turn(
+    AgentCompoundTurn(reasoning="look around", action="none"),
+)
+```
+
+**GM web UI:** clone [CampAIgn-RPG-Studio](https://github.com/DaveH-Ghost/CampAIgn-RPG-Studio) (separate GitHub repo):
+
+```powershell
+cd path\to\CampAIgn-RPG-Studio
+uv sync
+copy .env.example .env   # optional; or use Settings gear in the UI
+uv run campaign-rpg-studio
+```
+
+On Windows, if Smart App Control blocks `uv run campaign-rpg-studio`, use `uv run python -m backend.main`. Open [http://127.0.0.1:8765](http://127.0.0.1:8765).
+
+## Environment
+
+Copy [`.env.example`](.env.example) to `.env` and set `OPENROUTER_API_KEY` for LLM turns. Optional `OPENROUTER_MODEL` (default `deepseek/deepseek-v4-flash`). Engine tests mock the LLM — no key required for `uv run pytest`.
+
+CampAIgn-RPG-Studio **Settings** (gear icon) can set API key and model **in memory for the current server process only** — nothing is written to disk.
+
+## Custom memory modules
+
+Register `.py` modules at process startup before creating agents or loading saves:
+
+```python
+from campaign_rpg_engine import register_memory_module_from_path
+
+register_memory_module_from_path("path/to/my_module.py")
+session.create_agent(..., memory_module="my_module_id")
+```
+
+Saves store `module_id` + state only (no bundled source). Import **fails** if a save references a module that is not loaded. Sample module and upload UI: [CampAIgn-RPG-Studio `fixtures/custom_memory/`](https://github.com/DaveH-Ghost/CampAIgn-RPG-Studio/tree/main/fixtures/custom_memory).
+
+## Lorebooks
+
+Load SillyTavern-style `.json` lorebooks via `session.load_lorebook_from_path(...)` or CampAIgn-RPG-Studio **Lorebooks** tab. Add a `lorebook` prompt block in Prompt layout to inject matched world info. Not included in the default prompt layout.
+
+## Tests
+
+```powershell
+uv run pytest
+```
+
+CampAIgn-RPG-Studio API tests live in the [CampAIgn-RPG-Studio](https://github.com/DaveH-Ghost/CampAIgn-RPG-Studio) repo.
+
+## Documentation
+
+Start at **[docs/README.md](docs/README.md)** — guides, API overview, and changelog index.
+
+| Doc | Topic |
+|-----|--------|
+| [Building on CampAIgn-RPG-Engine](docs/guides/building-on-campaign-rpg-engine.md) | App integration (typed API, hosting) |
+| [API reference](docs/guides/api-reference.md) | `campaign_rpg_engine` exports and Session methods |
+| [Migration realm-fabric → campaign-rpg-engine](docs/MIGRATION-realm-fabric-to-campaign-rpg-engine.md) | Rename from Realm-Fabric / `realm_fabric` |
+| [CampAIgn-RPG-Studio](https://github.com/DaveH-Ghost/CampAIgn-RPG-Studio) | Full GM reference UI (GitHub) |
+| [Roadmap](docs/ROADMAP.md) | Version plans |
+| [Long-term goals](LONG_TERM_GOALS.md) | Aspirational features |
+
+Older version notes: [changelog index](docs/changelog/README.md).

campaign_rpg_engine-1.0.0/campaign_rpg_engine/__init__.py

@@ -0,0 +1,210 @@
+"""
+campaign_rpg_engine — public engine API for CampAIgn-RPG-Engine (1.0.0).
+
+Import from this package in application code.
+"""
+
+from __future__ import annotations
+
+import tomllib
+from pathlib import Path
+
+from campaign_rpg_engine.agent import Agent
+from campaign_rpg_engine.area import Area, GridBounds, create_area, create_initial_area
+from campaign_rpg_engine.area_edit import (
+    delete_agent_by_id,
+    format_agents_list,
+    format_full_list,
+    format_objects_list,
+    parse_position,
+)
+from campaign_rpg_engine.game_profile import GameProfile, default_compound_profile, load_profile
+from campaign_rpg_engine.interact_templates import interact_template_var_help
+from campaign_rpg_engine.llm.client import LLMParseError, get_compound_turn
+from campaign_rpg_engine.llm.prompt_context import PromptContext, build_prompt_context
+from campaign_rpg_engine.llm.schemas import AgentCompoundTurn
+from campaign_rpg_engine.llm.token_estimate import estimate_prompt_tokens
+from campaign_rpg_engine.llm.types import LLMResponse
+from campaign_rpg_engine.lorebook import (
+    DEFAULT_LOREBOOK_CHAR_BUDGET,
+    Lorebook,
+    LoreEntry,
+    LorebookScanConfig,
+    ST_ENTRY_DEFAULTS,
+    build_scan_corpus,
+    derive_lorebook_id_from_filename,
+    describe_scan_sources,
+    load_lorebook_from_dict,
+    load_lorebook_from_path,
+    match_lorebook_entries,
+    new_st_entry_dict,
+    render_lorebook,
+    with_st_entry_defaults,
+)
+from campaign_rpg_engine.lorebook.factory import create_empty_lorebook
+from campaign_rpg_engine.memory import TurnRecord
+from campaign_rpg_engine.memory_modules.base import MemoryModule
+from campaign_rpg_engine.memory_modules.recent_turns import DEFAULT_WINDOW, MAX_WINDOW, MIN_WINDOW
+from campaign_rpg_engine.memory_modules.registry import (
+    clear_custom_memory_registrations,
+    default_module_id,
+    format_memory_modules_list,
+    get_custom_module_metadata,
+    loaded_module_ids,
+    register_memory_module_from_path,
+    register_memory_module_from_source,
+)
+from campaign_rpg_engine.memory_modules.rolling_summary import (
+    DEFAULT_MAX_SUMMARY_CHARS,
+    DEFAULT_SUMMARY_INTERVAL,
+    DEFAULT_SUMMARY_TAIL,
+    MAX_MAX_SUMMARY_CHARS,
+    MIN_MAX_SUMMARY_CHARS,
+    MIN_SUMMARY_INTERVAL,
+    MIN_SUMMARY_TAIL,
+    RollingSummaryModule,
+)
+from campaign_rpg_engine.memory_modules.salient_turns import (
+    DEFAULT_CHAR_BUDGET,
+    MAX_CHAR_BUDGET,
+    MIN_CHAR_BUDGET,
+)
+from campaign_rpg_engine.object import Object, object_footprint_tiles
+from campaign_rpg_engine.object_action import ActionKind, ObjectAction
+from campaign_rpg_engine.perception import build_passive_vision
+from campaign_rpg_engine.prompt_blocks import (
+    PromptBlock,
+    default_prompt_blocks,
+    enrich_blocks_with_previews,
+    prompt_block_catalog,
+    prompt_blocks_from_dicts,
+    prompt_slot_catalog,
+    validate_prompt_blocks,
+)
+from campaign_rpg_engine.session import Session, SessionResult, TurnResult
+from campaign_rpg_engine.session_area_edit import (
+    AreaMutationResult,
+    delete_area_by_id,
+)
+from campaign_rpg_engine.simulation import run_compound_turn
+from campaign_rpg_engine.session_persistence import build_save_snapshot, load_session_from_snapshot
+from campaign_rpg_engine.interaction_handlers import (
+    format_handlers_list,
+    get_handler_registration,
+    is_handler_registered,
+    list_registered_handlers,
+    register_interaction_handler,
+    run_interaction_handler,
+)
+from campaign_rpg_engine.snapshot import DEFAULT_AREA_ID, build_area_snapshot, build_session_snapshot
+from campaign_rpg_engine.world_edit_api import WorldMutationResult
+
+__all__ = [
+    "__version__",
+    "ActionKind",
+    "Agent",
+    "AgentCompoundTurn",
+    "Area",
+    "AreaMutationResult",
+    "DEFAULT_AREA_ID",
+    "DEFAULT_CHAR_BUDGET",
+    "DEFAULT_LOREBOOK_CHAR_BUDGET",
+    "DEFAULT_MAX_SUMMARY_CHARS",
+    "DEFAULT_SUMMARY_INTERVAL",
+    "DEFAULT_SUMMARY_TAIL",
+    "DEFAULT_WINDOW",
+    "GameProfile",
+    "GridBounds",
+    "LLMParseError",
+    "LLMResponse",
+    "Lorebook",
+    "LoreEntry",
+    "LorebookScanConfig",
+    "MAX_CHAR_BUDGET",
+    "MAX_MAX_SUMMARY_CHARS",
+    "MAX_WINDOW",
+    "MemoryModule",
+    "MIN_CHAR_BUDGET",
+    "MIN_MAX_SUMMARY_CHARS",
+    "MIN_SUMMARY_INTERVAL",
+    "MIN_SUMMARY_TAIL",
+    "MIN_WINDOW",
+    "Object",
+    "ObjectAction",
+    "PromptBlock",
+    "PromptContext",
+    "RollingSummaryModule",
+    "Session",
+    "SessionResult",
+    "ST_ENTRY_DEFAULTS",
+    "TurnRecord",
+    "TurnResult",
+    "WorldMutationResult",
+    "build_area_snapshot",
+    "build_passive_vision",
+    "build_prompt_context",
+    "build_save_snapshot",
+    "build_scan_corpus",
+    "build_session_snapshot",
+    "clear_custom_memory_registrations",
+    "create_area",
+    "create_empty_lorebook",
+    "create_initial_area",
+    "default_compound_profile",
+    "default_module_id",
+    "default_prompt_blocks",
+    "delete_area_by_id",
+    "derive_lorebook_id_from_filename",
+    "describe_scan_sources",
+    "enrich_blocks_with_previews",
+    "estimate_prompt_tokens",
+    "format_agents_list",
+    "format_full_list",
+    "format_handlers_list",
+    "format_memory_modules_list",
+    "format_objects_list",
+    "get_compound_turn",
+    "get_custom_module_metadata",
+    "get_handler_registration",
+    "interact_template_var_help",
+    "is_handler_registered",
+    "list_registered_handlers",
+    "load_lorebook_from_dict",
+    "load_lorebook_from_path",
+    "load_profile",
+    "load_session_from_snapshot",
+    "loaded_module_ids",
+    "match_lorebook_entries",
+    "new_st_entry_dict",
+    "object_footprint_tiles",
+    "parse_position",
+    "prompt_block_catalog",
+    "prompt_blocks_from_dicts",
+    "prompt_slot_catalog",
+    "register_interaction_handler",
+    "register_memory_module_from_path",
+    "register_memory_module_from_source",
+    "render_lorebook",
+    "run_compound_turn",
+    "run_interaction_handler",
+    "validate_prompt_blocks",
+    "with_st_entry_defaults",
+]
+
+_ROOT = Path(__file__).resolve().parent.parent
+
+
+def _read_version() -> str:
+    try:
+        from importlib.metadata import version as _pkg_version
+
+        return _pkg_version("campaign-rpg-engine")
+    except Exception:
+        pass
+    pyproject_path = _ROOT / "pyproject.toml"
+    if pyproject_path.is_file():
+        return tomllib.loads(pyproject_path.read_text(encoding="utf-8"))["project"]["version"]
+    return "0.0.0"
+
+
+__version__ = _read_version()

campaign_rpg_engine-1.0.0/campaign_rpg_engine/action_outcome.py

@@ -0,0 +1,19 @@
+"""Action result types — first-person result for the actor, passive for observers."""
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class ActionOutcome:
+    """Result of executing one action."""
+
+    result: str
+    """First-person feedback for the acting agent (stored in TurnRecord)."""
+
+    passive_result: str = ""
+    """
+    Third-person summary for other agents' passive vision.
+
+    Empty when the action did not succeed or has nothing observable.
+    """

campaign_rpg_engine-1.0.0/campaign_rpg_engine/actions/__init__.py

@@ -0,0 +1,15 @@
+"""
+Actions package.
+
+Contains move, speak, and interact implementations. Look is implemented in
+perception.py (perform_look) because it shares vision/memory logic.
+"""
+from __future__ import annotations
+
+from campaign_rpg_engine.actions.emote import emote as do_emote
+from campaign_rpg_engine.actions.interact import interact as do_interact
+from campaign_rpg_engine.actions.interact import interact_phases as do_interact_phases
+from campaign_rpg_engine.actions.move import move as do_move
+from campaign_rpg_engine.actions.speak import speak as do_speak
+
+__all__ = ["do_emote", "do_interact", "do_interact_phases", "do_move", "do_speak"]

campaign_rpg_engine-1.0.0/campaign_rpg_engine/actions/emote.py

@@ -0,0 +1,24 @@
+"""Emote turn action — gesture at an entity or free-text target (V0.4.2)."""
+
+from __future__ import annotations
+
+from campaign_rpg_engine.action_outcome import ActionOutcome
+from campaign_rpg_engine.agent import Agent
+from campaign_rpg_engine.area import Area
+from campaign_rpg_engine.emote_phrasing import (
+    emote_target_phrase_for_actor,
+    emote_target_phrase_neutral,
+    format_emote_line,
+)
+
+
+def emote(agent: Agent, area: Area, target: str, action_name: str) -> ActionOutcome:
+    """Perform a past-tense emote directed at *target*."""
+    verb = action_name.strip()
+    target_id = target.strip()
+    actor_phrase = emote_target_phrase_for_actor(area, agent, target_id)
+    neutral_phrase = emote_target_phrase_neutral(area, target_id)
+    return ActionOutcome(
+        result=f"You {verb} at {actor_phrase}.",
+        passive_result=format_emote_line(agent.name, verb, neutral_phrase),
+    )