aria-code 0.166.0__tar.gz → 0.167.0__tar.gz

{aria_code-0.166.0/src/aria_code.egg-info → aria_code-0.167.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aria-code
-Version: 0.166.0
+Version: 0.167.0
 Summary: Open-source AI agent for coding, financial analysis and logistics operations: numbers you can check, client data kept apart, actions a person approves
 License: Apache-2.0
 Project-URL: Homepage, https://github.com/artheras/aria-code
@@ -201,7 +201,7 @@ Numbers you can check, client data kept apart, actions a person approves.</p>
 <p align="center">
   <a href="https://www.npmjs.com/package/@artheras/aria-code"><img src="https://img.shields.io/npm/v/@artheras/aria-code/latest?style=flat-square&logo=npm&label=npm" alt="npm version"></a>
   <!-- Release automation pins PyPI: the default endpoint still selects legacy 4.x. -->
-  <a href="https://pypi.org/project/aria-code/0.166.0/"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fpypi.org%2Fpypi%2Faria-code%2F0.166.0%2Fjson&amp;query=%24.info.version&amp;prefix=v&amp;style=flat-square&amp;logo=pypi&amp;label=PyPI&amp;color=blue&amp;cacheSeconds=300" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/aria-code/0.167.0/"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fpypi.org%2Fpypi%2Faria-code%2F0.167.0%2Fjson&amp;query=%24.info.version&amp;prefix=v&amp;style=flat-square&amp;logo=pypi&amp;label=PyPI&amp;color=blue&amp;cacheSeconds=300" alt="PyPI version"></a>
   <a href="https://github.com/artheras/aria-code/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/artheras/aria-code/ci.yml?branch=main&style=flat-square&logo=githubactions&label=CI" alt="CI status"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-64748b?style=flat-square" alt="Apache License 2.0"></a>
 </p>

{aria_code-0.166.0 → aria_code-0.167.0}/README.md

@@ -15,7 +15,7 @@ Numbers you can check, client data kept apart, actions a person approves.</p>
 <p align="center">
   <a href="https://www.npmjs.com/package/@artheras/aria-code"><img src="https://img.shields.io/npm/v/@artheras/aria-code/latest?style=flat-square&logo=npm&label=npm" alt="npm version"></a>
   <!-- Release automation pins PyPI: the default endpoint still selects legacy 4.x. -->
-  <a href="https://pypi.org/project/aria-code/0.166.0/"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fpypi.org%2Fpypi%2Faria-code%2F0.166.0%2Fjson&amp;query=%24.info.version&amp;prefix=v&amp;style=flat-square&amp;logo=pypi&amp;label=PyPI&amp;color=blue&amp;cacheSeconds=300" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/aria-code/0.167.0/"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fpypi.org%2Fpypi%2Faria-code%2F0.167.0%2Fjson&amp;query=%24.info.version&amp;prefix=v&amp;style=flat-square&amp;logo=pypi&amp;label=PyPI&amp;color=blue&amp;cacheSeconds=300" alt="PyPI version"></a>
   <a href="https://github.com/artheras/aria-code/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/artheras/aria-code/ci.yml?branch=main&style=flat-square&logo=githubactions&label=CI" alt="CI status"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-64748b?style=flat-square" alt="Apache License 2.0"></a>
 </p>

{aria_code-0.166.0 → aria_code-0.167.0/aria_code.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aria-code
-Version: 0.166.0
+Version: 0.167.0
 Summary: Open-source AI agent for coding, financial analysis and logistics operations: numbers you can check, client data kept apart, actions a person approves
 License: Apache-2.0
 Project-URL: Homepage, https://github.com/artheras/aria-code
@@ -201,7 +201,7 @@ Numbers you can check, client data kept apart, actions a person approves.</p>
 <p align="center">
   <a href="https://www.npmjs.com/package/@artheras/aria-code"><img src="https://img.shields.io/npm/v/@artheras/aria-code/latest?style=flat-square&logo=npm&label=npm" alt="npm version"></a>
   <!-- Release automation pins PyPI: the default endpoint still selects legacy 4.x. -->
-  <a href="https://pypi.org/project/aria-code/0.166.0/"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fpypi.org%2Fpypi%2Faria-code%2F0.166.0%2Fjson&amp;query=%24.info.version&amp;prefix=v&amp;style=flat-square&amp;logo=pypi&amp;label=PyPI&amp;color=blue&amp;cacheSeconds=300" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/aria-code/0.167.0/"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fpypi.org%2Fpypi%2Faria-code%2F0.167.0%2Fjson&amp;query=%24.info.version&amp;prefix=v&amp;style=flat-square&amp;logo=pypi&amp;label=PyPI&amp;color=blue&amp;cacheSeconds=300" alt="PyPI version"></a>
   <a href="https://github.com/artheras/aria-code/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/artheras/aria-code/ci.yml?branch=main&style=flat-square&logo=githubactions&label=CI" alt="CI status"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-64748b?style=flat-square" alt="Apache License 2.0"></a>
 </p>

{aria_code-0.166.0/src → aria_code-0.167.0}/aria_code.egg-info/SOURCES.txt

@@ -2,6 +2,31 @@ LICENSE
 NOTICE
 README.md
 pyproject.toml
+aria_code.egg-info/PKG-INFO
+aria_code.egg-info/SOURCES.txt
+aria_code.egg-info/dependency_links.txt
+aria_code.egg-info/entry_points.txt
+aria_code.egg-info/requires.txt
+aria_code.egg-info/top_level.txt
+services/aria-bots/src/aria_bots/__init__.py
+services/aria-bots/src/aria_bots/engine.py
+services/aria-bots/src/aria_bots/feishu_bot.py
+services/aria-bots/src/aria_bots/market.py
+services/aria-bots/src/aria_bots/relay_client.py
+services/aria-bots/src/aria_bots/telegram_bot.py
+services/aria-bots/src/aria_bots/channels/README.md
+services/aria-bots/src/aria_bots/channels/__init__.py
+services/aria-bots/src/aria_bots/channels/approvals.py
+services/aria-bots/src/aria_bots/channels/conversation.py
+services/aria-bots/src/aria_bots/channels/digest.py
+services/aria-bots/src/aria_bots/channels/registry.py
+services/aria-bots/src/aria_bots/logistics/__init__.py
+services/aria-bots/src/aria_bots/logistics/carriers.py
+services/aria-bots/src/aria_bots/logistics/freight.py
+services/aria-bots/src/aria_bots/logistics/inventory.py
+services/aria-bots/src/aria_bots/logistics/mcp_server.py
+services/aria-bots/src/aria_bots/logistics/records.py
+services/aria-bots/src/aria_bots/logistics/tenancy.py
 src/aria_code/__init__.py
 src/aria_code/_version.py
 src/aria_code/account_memory.py
@@ -70,12 +95,6 @@ src/aria_code/video_editor.py
 src/aria_code/workspace_changes.py
 src/aria_code/workspace_service.py
 src/aria_code/workspace_tools.py
-src/aria_code.egg-info/PKG-INFO
-src/aria_code.egg-info/SOURCES.txt
-src/aria_code.egg-info/dependency_links.txt
-src/aria_code.egg-info/entry_points.txt
-src/aria_code.egg-info/requires.txt
-src/aria_code.egg-info/top_level.txt
 src/aria_code/adk_apps/__init__.py
 src/aria_code/adk_apps/aria_code_review/__init__.py
 src/aria_code/adk_apps/aria_code_review/agent.py
@@ -360,6 +379,9 @@ src/aria_code/domain/finance_formulas.py
 src/aria_code/domain/performance_stats.py
 src/aria_code/domain/portfolio_ledger.py
 src/aria_code/domain/strategy_vault.py
+src/aria_code/domain/_finance_core/__init__.py
+src/aria_code/domain/_finance_core/backtest_engine.py
+src/aria_code/domain/_finance_core/performance_stats.py
 src/aria_code/evals/__init__.py
 src/aria_code/evals/behavior.py
 src/aria_code/evals/gap.py
@@ -416,10 +438,6 @@ src/aria_code/packages/aria_tools/__init__.py
 src/aria_code/packages/aria_tools/registry.py
 src/aria_code/packages/aria_tools/financial/__init__.py
 src/aria_code/packages/aria_tools/financial/_paths.py
-src/aria_code/packages/aria_tools/financial/compliance.py
-src/aria_code/packages/aria_tools/financial/factors.py
-src/aria_code/packages/aria_tools/financial/risk_tools.py
-src/aria_code/packages/aria_tools/financial/strategy.py
 src/aria_code/packages/quant_engine/__init__.py
 src/aria_code/packages/quant_engine/_namespace.py
 src/aria_code/packages/quant_engine/backtest/__init__.py
@@ -433,7 +451,6 @@ src/aria_code/packages/quant_engine/sports/dixon_coles.py
 src/aria_code/packages/quant_engine/sports/elo.py
 src/aria_code/packages/quant_engine/sports/form.py
 src/aria_code/packages/quant_engine/sports/h2h.py
-src/aria_code/packages/quant_engine/sports/ml_model.py
 src/aria_code/packages/quant_engine/sports/predictor.py
 src/aria_code/packages/quant_engine/sports/tracker.py
 src/aria_code/packages/quant_engine/stochastic/__init__.py
@@ -448,6 +465,7 @@ src/aria_code/packs/base.py
 src/aria_code/packs/registry.py
 src/aria_code/packs/rules.py
 src/aria_code/packs/finance/__init__.py
+src/aria_code/packs/healthcare/__init__.py
 src/aria_code/packs/logistics/__init__.py
 src/aria_code/packs/payments/__init__.py
 src/aria_code/packs/realty/__init__.py
@@ -457,6 +475,7 @@ src/aria_code/providers/__init__.py
 src/aria_code/providers/google_video_provider.py
 src/aria_code/providers/local_image_provider.py
 src/aria_code/providers/local_llm_provider.py
+src/aria_code/providers/ollama_models.py
 src/aria_code/providers/openai_params.py
 src/aria_code/providers/tool_messages.py
 src/aria_code/providers/llm/__init__.py
@@ -592,6 +611,8 @@ tests/test_agent_team_fallback.py
 tests/test_analyze_file_tool.py
 tests/test_architecture_ledger_is_true.py
 tests/test_architecture_report.py
+tests/test_aria_bots_engine.py
+tests/test_aria_bots_standalone.py
 tests/test_aria_cli_core.py
 tests/test_aria_mcp_server.py
 tests/test_aria_sdk.py
@@ -661,6 +682,7 @@ tests/test_conversation_core.py
 tests/test_conversation_policy.py
 tests/test_credential_file_permissions.py
 tests/test_custom_providers.py
+tests/test_daemon_defers_to_go.py
 tests/test_daemon_gateway_config.py
 tests/test_daemon_webhook_auth.py
 tests/test_dashboard_generator.py
@@ -696,13 +718,15 @@ tests/test_eval_usage.py
 tests/test_evals_harness.py
 tests/test_event_import_roots.py
 tests/test_exec_events.py
+tests/test_explicit_backend_paths.py
 tests/test_extended_tools.py
-tests/test_feishu_swarm_config.py
 tests/test_file_links.py
 tests/test_file_references.py
 tests/test_finalize_release.py
+tests/test_finance_core_boundaries.py
 tests/test_finance_renderers.py
 tests/test_finance_service_catalog.py
+tests/test_finance_source_lock.py
 tests/test_financial_service_mcp.py
 tests/test_financial_statement_recovery.py
 tests/test_first_run_output.py
@@ -720,6 +744,7 @@ tests/test_google_login.py
 tests/test_google_search_provider.py
 tests/test_headless_command_approval.py
 tests/test_headless_is_agentic.py
+tests/test_healthcare_pack.py
 tests/test_honest_surfaces.py
 tests/test_image_gen_tools.py
 tests/test_image_inputs.py
@@ -750,6 +775,7 @@ tests/test_market_symbol_extraction.py
 tests/test_market_universe.py
 tests/test_mcp_circuit.py
 tests/test_mcp_client.py
+tests/test_mcp_entry_handover.py
 tests/test_mcp_fast_fail.py
 tests/test_mentions.py
 tests/test_model_capability_registry.py
@@ -771,6 +797,7 @@ tests/test_native_entry.py
 tests/test_native_eval_trajectories.py
 tests/test_native_go_acceptance.py
 tests/test_native_go_app.py
+tests/test_native_go_bots.py
 tests/test_native_go_bridge.py
 tests/test_native_go_contract.py
 tests/test_native_go_delivery.py
@@ -792,6 +819,7 @@ tests/test_no_hardcoded_developer_paths.py
 tests/test_no_tools_route.py
 tests/test_no_uncommitted_imports.py
 tests/test_numeric_listings.py
+tests/test_ollama_installed_models.py
 tests/test_ollama_stream_imports.py
 tests/test_ollama_stream_tools.py
 tests/test_openai_image_client.py
@@ -815,6 +843,7 @@ tests/test_plan_without_material.py
 tests/test_platform_package_assembly.py
 tests/test_platform_packages.py
 tests/test_platform_publish.py
+tests/test_platform_wheels.py
 tests/test_plotly_html_output.py
 tests/test_portfolio_language.py
 tests/test_portfolio_ledger.py

{aria_code-0.166.0/src → aria_code-0.167.0}/aria_code.egg-info/top_level.txt

@@ -1 +1,2 @@
+aria_bots
 aria_code

{aria_code-0.166.0 → aria_code-0.167.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "aria-code"
-version = "0.166.0"
+version = "0.167.0"
 description = "Open-source AI agent for coding, financial analysis and logistics operations: numbers you can check, client data kept apart, actions a person approves"
 readme = "README.md"
 license = { text = "Apache-2.0" }
@@ -280,7 +280,9 @@ license-files = ["LICENSE", "NOTICE"]
 #
 # tests/test_wheel_is_not_empty.py builds a wheel and asserts it contains the
 # package.
-where = ["src"]
+# services/aria-bots/src: the chat bots moved there; this wheel still ships
+# aria_bots so the shims at their old paths resolve until the Python core goes.
+where = ["src", "services/aria-bots/src"]
 # Real top-level packages (dirs with __init__.py). packages.find only matches
 # package directories — single-file top-level modules are declared in
 # [tool.setuptools].py-modules above, NOT here.
@@ -301,7 +303,7 @@ where = ["src"]
 #   from setuptools.discovery import PEP420PackageFinder as F
 #   print(sorted({p.split('.')[0] for p in F.find(where='.', include=[...])}))"
 # 结果应与 `git ls-files '*/__init__.py'` 里的顶层目录集合一致。
-include = ["aria_code*"]
+include = ["aria_code*", "aria_bots*"]
 
 [tool.setuptools.package-data]
 "*" = ["*.yaml", "*.json", "*.md", "*.txt", "*.sh"]
@@ -389,7 +391,7 @@ exclude = '''
 # and apps/cli/tools/*.py put it on sys.path at import time. Declaring it here
 # makes collection deterministic instead of depending on which test module
 # happened to trigger that side effect first.
-pythonpath = [".", "src", "src/aria_code"]
+pythonpath = [".", "src", "src/aria_code", "services/aria-bots/src"]
 asyncio_mode = "auto"
 testpaths = ["tests"]
 markers = [

aria_code-0.167.0/services/aria-bots/src/aria_bots/__init__.py

@@ -0,0 +1,7 @@
+"""Aria's chat bots: Feishu and Telegram adapters, the relay client, and the
+logistics tools they answer shipper questions with.
+
+This package runs as its own service (services/aria-bots). It does not import
+aria_code; aria_code keeps shims at the old module paths until the Python core
+is removed.
+"""

{aria_code-0.166.0/src/aria_code/apps → aria_code-0.167.0/services/aria-bots/src/aria_bots}/channels/README.md

@@ -26,7 +26,7 @@ the same rules from the same code:
 | One group = one shipper (货主), bound by an admin with `/owner <id>` | `handle_owner_command`, `ConversationStore` |
 | Admins are per channel: `ARIA_CHANNEL_ADMINS=feishu:ou_x,telegram:42` | `is_admin` |
 | Context is the conversation's own recent messages, never another's; capped at 20 messages and 7 days | `ConversationStore.history` |
-| A bound conversation runs every turn with `ARIA_OWNER_SCOPE`, enforced by the logistics tools themselves | `ChannelTurn.env`, `tools/logistics_tenancy.py` |
+| A bound conversation runs every turn with `ARIA_OWNER_SCOPE`, enforced by the logistics tools themselves | `ChannelTurn.env`, `aria_bots/logistics/tenancy.py` |
 
 A new channel is an adapter: turn the platform's event into an
 `InboundMessage`, then

aria_code-0.167.0/services/aria-bots/src/aria_bots/channels/__init__.py

@@ -0,0 +1 @@
+"""Conversations, approval cards and shipper digests shared by the chat bots."""

{aria_code-0.166.0/src/aria_code/apps → aria_code-0.167.0/services/aria-bots/src/aria_bots}/channels/approvals.py

@@ -42,8 +42,8 @@ from dataclasses import dataclass
 from pathlib import Path
 from typing import Any, Callable, Dict, Iterator, List, Optional, Tuple
 
-from aria_code.apps.channels.conversation import ADMINS_ENV, default_db_path
-from aria_code.tools.logistics_tenancy import OWNER_SCOPE_ENV
+from aria_bots.channels.conversation import ADMINS_ENV, default_db_path
+from aria_bots.logistics.tenancy import OWNER_SCOPE_ENV
 
 APPROVERS_ENV = "ARIA_CHANNEL_APPROVERS"
 OUTBOX_ENV = "ARIA_APPROVAL_OUTBOX"
@@ -129,7 +129,7 @@ EXECUTORS: Dict[str, Callable[[Approval], str]] = {
 
 def propose_reorder(owner_id: str, inventory_path: str) -> Optional[Tuple[str, Dict[str, Any]]]:
     """A purchase-order draft from the shipper's reorder list, or None if nothing to order."""
-    from aria_code.tools.logistics_inventory import tool_plan_inventory_policy
+    from aria_bots.logistics.inventory import tool_plan_inventory_policy
 
     with _confined_to(owner_id):
         result = tool_plan_inventory_policy({"file_path": inventory_path})

{aria_code-0.166.0/src/aria_code/apps → aria_code-0.167.0/services/aria-bots/src/aria_bots}/channels/conversation.py

@@ -40,8 +40,8 @@ from dataclasses import dataclass, field
 from pathlib import Path
 from typing import Callable, Dict, List, Optional, Tuple
 
-from aria_code.apps.channels.registry import CHANNEL_TASK_SCHEMA
-from aria_code.tools.logistics_tenancy import OWNER_SCOPE_ENV
+from aria_bots.channels.registry import CHANNEL_TASK_SCHEMA
+from aria_bots.logistics.tenancy import OWNER_SCOPE_ENV
 
 ADMINS_ENV = "ARIA_CHANNEL_ADMINS"
 DB_ENV = "ARIA_CONVERSATIONS_DB"

{aria_code-0.166.0/src/aria_code/apps → aria_code-0.167.0/services/aria-bots/src/aria_bots}/channels/digest.py

@@ -38,8 +38,8 @@ from dataclasses import dataclass, field
 from pathlib import Path
 from typing import Awaitable, Callable, Dict, Iterator, List, Optional
 
-from aria_code.apps.channels.conversation import ConversationStore
-from aria_code.tools.logistics_tenancy import OWNER_SCOPE_ENV
+from aria_bots.channels.conversation import ConversationStore
+from aria_bots.logistics.tenancy import OWNER_SCOPE_ENV
 
 logger = logging.getLogger(__name__)
 
@@ -98,8 +98,8 @@ def _section(title: str, lines: List[str]) -> str:
 
 
 def build_digest(owner_id: str, feeds: Dict[str, Dict[str, str]]) -> Digest:
-    from aria_code.tools.logistics_carriers import tool_score_carriers
-    from aria_code.tools.logistics_inventory import tool_plan_inventory_policy
+    from aria_bots.logistics.carriers import tool_score_carriers
+    from aria_bots.logistics.inventory import tool_plan_inventory_policy
 
     digest = Digest(owner_id=owner_id, title=f"📦 {owner_id} 今日库存与运费提醒")
     sources = feeds_for(owner_id, feeds)

aria_code-0.167.0/services/aria-bots/src/aria_bots/engine.py

@@ -0,0 +1,144 @@
+"""Run one chat turn on the Go engine (`aria-runtime stream`).
+
+The bots used to shell out to aria_cli.py. Now a turn is
+
+    aria-runtime stream --format=jsonl --quiet --no-banner --prompt=...
+
+in a workspace of its own, read as JSONL until `turn.completed`. The engine
+runs headless: a tool that needs approval is refused, because nobody in the
+chat can answer the prompt. An operator grants named tools with
+ARIA_BOT_ALLOW_TOOLS.
+
+The logistics tools reach the engine as an MCP server the bots register
+through ARIA_MCP_EXTRA_CONFIG, so the user's own mcp_servers.json is left
+alone. A conversation bound to a shipper passes ARIA_OWNER_SCOPE down; the
+engine hands its environment to the MCP server, where logistics.tenancy
+enforces it.
+"""
+from __future__ import annotations
+
+import asyncio
+import json
+import os
+import shutil
+import sys
+from pathlib import Path
+from typing import Iterable, Optional
+
+from .logistics.tenancy import OWNER_SCOPE_ENV
+
+ENGINE_ENV = "ARIA_RUNTIME"
+MAX_PROMPT = 65536
+LOGISTICS_SERVER = "aria-logistics"
+
+
+def state_dir() -> Path:
+    base = os.environ.get("ARIA_BOTS_HOME", "").strip()
+    return Path(base).expanduser() if base else Path.home() / ".aria" / "bots"
+
+
+def find_engine() -> Optional[str]:
+    """ARIA_RUNTIME when it names an aria-runtime, else aria-runtime on PATH."""
+    configured = os.environ.get(ENGINE_ENV, "").strip()
+    if configured:
+        path = Path(configured).expanduser()
+        if path.name.removesuffix(".exe").startswith("aria-runtime") and path.is_file() and os.access(path, os.X_OK):
+            return str(path)
+    return shutil.which("aria-runtime")
+
+
+def mcp_config() -> Path:
+    """The servers the bots add to every engine turn (rewritten each time)."""
+    folder = state_dir()
+    folder.mkdir(parents=True, exist_ok=True)
+    server = {
+        "name": LOGISTICS_SERVER,
+        "command": sys.executable,
+        "args": ["-m", "aria_bots.logistics.mcp_server"],
+        "description": "Freight analysis, carrier scoring and inventory policy, scoped per shipper",
+    }
+    path = folder / "mcp_servers.json"
+    path.write_text(json.dumps({"servers": [server]}, indent=2), encoding="utf-8")
+    return path
+
+
+def allowed_tools() -> list[str]:
+    return [t.strip() for t in os.environ.get("ARIA_BOT_ALLOW_TOOLS", "").split(",") if t.strip()]
+
+
+def with_history(prompt: str, history: Optional[Iterable[dict]]) -> str:
+    """The engine takes one prompt; earlier messages go in front of it."""
+    lines = []
+    for item in history or []:
+        role = "Assistant" if item.get("role") == "assistant" else "User"
+        content = str(item.get("content", "")).strip()
+        if content:
+            lines.append(f"{role}: {content}")
+    if not lines:
+        return prompt
+    return "Earlier in this conversation:\n" + "\n".join(lines) + "\n\nNow answer:\n" + prompt
+
+
+def command(engine: str, prompt: str) -> list[str]:
+    argv = [engine, "stream", "--format=jsonl", "--quiet", "--no-banner", f"--prompt={prompt}"]
+    tools = allowed_tools()
+    if tools:
+        argv += ["--allow-tools", ",".join(tools)]
+    return argv
+
+
+def environment(owner: Optional[str]) -> dict[str, str]:
+    env = {**os.environ, "ARIA_BOT_MODE": "1", "ARIA_MCP_EXTRA_CONFIG": str(mcp_config())}
+    env.pop(OWNER_SCOPE_ENV, None)
+    if owner:
+        env[OWNER_SCOPE_ENV] = owner
+    return env
+
+
+def read_answer(stdout: bytes) -> tuple[bool, str]:
+    """(success, answer) from the engine's JSONL; deltas when no final text."""
+    deltas: list[str] = []
+    for raw in stdout.splitlines():
+        try:
+            event = json.loads(raw)
+        except ValueError:
+            continue
+        if not isinstance(event, dict):
+            continue
+        kind = event.get("type")
+        if kind == "answer.delta":
+            deltas.append(str(event.get("text") or event.get("delta") or ""))
+        elif kind == "turn.completed":
+            answer = str(event.get("response") or "".join(deltas)).strip()
+            return bool(event.get("success")), answer or str(event.get("error") or "")
+    return False, "".join(deltas).strip()
+
+
+async def run_turn(prompt: str, *, engine: str, owner: Optional[str] = None,
+                   history: Optional[Iterable[dict]] = None, timeout: float = 120) -> str:
+    """The answer text, or a message starting with ❌ / ⏱️ when there is none."""
+    prompt = with_history(prompt, history)
+    if len(prompt.encode("utf-8")) > MAX_PROMPT:
+        return "❌ 消息太长，请缩短后重试。"
+    workspace = state_dir() / "workspace"
+    workspace.mkdir(parents=True, exist_ok=True)
+    proc = await asyncio.create_subprocess_exec(
+        *command(engine, prompt),
+        stdin=asyncio.subprocess.PIPE,
+        stdout=asyncio.subprocess.PIPE,
+        stderr=asyncio.subprocess.PIPE,
+        cwd=str(workspace),
+        env=environment(owner),
+    )
+    try:
+        # One newline acknowledges the host; EOF after it, so nothing can wait on input.
+        stdout, stderr = await asyncio.wait_for(proc.communicate(b"\n"), timeout=timeout)
+    except asyncio.TimeoutError:
+        proc.kill()
+        await proc.wait()
+        return f"⏱️ 查询超时（>{int(timeout)}s），请简化问题后重试。"
+    ok, answer = read_answer(stdout)
+    if answer and (ok or proc.returncode == 0):
+        return answer[:3000]
+    detail = answer or stderr.decode("utf-8", errors="replace").strip()[-500:] or f"exit {proc.returncode}"
+    return f"❌ Aria 引擎未能完成：{detail}"