career-emulator 0.0.6__tar.gz

career_emulator-0.0.6/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yuwei and Hugo
+
+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.

career_emulator-0.0.6/PKG-INFO

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: career-emulator
+Version: 0.0.6
+Summary: A career emulator for AI Agents.
+Author-email: Hugo <hugo@hugohuang.com>, Yuwei <yuwei.willow.z@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://career-emulator.readthedocs.io
+Project-URL: Documentation, https://career-emulator.readthedocs.io
+Project-URL: Issues, https://github.com/Trenza1ore/TomatoEmulator/issues
+Project-URL: Gitcode, https://gitcode.com/SushiNinja/TomatoEmulator
+Keywords: python,httpx,client,mcp,agent,fastmcp,llm,openjiuwen,mcp client,mcp server,model context protocol
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Intended Audience :: Developers
+Classifier: Typing :: Typed
+Requires-Python: <4,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiosqlite>=0.22.1
+Requires-Dist: aiofiles>=25.1.0
+Provides-Extra: mcp
+Requires-Dist: fastmcp; extra == "mcp"
+Dynamic: license-file
+
+# Career Emulator - CCF BDCI 2026
+
+[![PyPI - Version](https://img.shields.io/pypi/v/career-emulator)](https://pypi.org/project/career-emulator/) [![PyPI - License](https://img.shields.io/pypi/l/career-emulator)](https://github.com/Trenza1ore/TomatoEmulator/blob/main/LICENSE) [![Tests](https://github.com/Trenza1ore/TomatoEmulator/actions/workflows/tests.yml/badge.svg)](https://github.com/Trenza1ore/TomatoEmulator/actions/workflows/tests.yml)
+
+[![Documentation](https://img.shields.io/badge/赛题文档-brown?style=for-the-badge&logo=readthedocs&link=https%3A%2F%2Fcareer-emulator.readthedocs.io%2Fen%2Flatest%2Findex.html)](https://career-emulator.readthedocs.io)
+
+- 所属赛题：`2026 CCF 大数据与计算智能大赛` 的《职场生存与晋升挑战》赛题，说明见[比赛官网](https://www.xir.cn/competition/1165)，赛事入口见[2026 CCF 大数据与计算智能大赛](https://www.xir.cn/competition/races/BDCI2026)
+- 参赛方式：使用 [JiuwenSwarm](https://openjiuwen.com/jiuwenswarm) 构建 Agent，并开发一个或多个 [Skill](https://agentskills.io)
+- 交付形式：将一个或多个 Skill 文件夹打包成单个 `zip`
+- 交互方式：通过 `career-emulator` MCP 与环境交互
+
+如果你准备做多 Agent 协同参谋，也可以看看 [Swarm Skill 标准](https://swarmskills.openjiuwen.com)。
+
+你会从 `L1` 新人入职开始，在 48 个月里处理剧情事件、分配季度体力、选择季度主行动，再按半年节奏迎接绩效和晋升。目标也很直接：别太早出局，顺手把这段职业生涯经营得稍微体面一点。
+
+项目目前提供两种入口：
+
+- `career-emulator`：本地 CLI，适合直接试玩和调规则。
+- `career-emulator-mcp`：MCP 服务，适合接给 Agent 自动玩。
+
+更多公开规则、手册和玩法说明见文档：[career-emulator.readthedocs.io](https://career-emulator.readthedocs.io)。
+
+## 这题大概在玩什么
+
+每个月，系统会生成剧情事件，你从当前选项里挑一个往下走。每到季度末，还要额外处理两件事：
+
+- 分配 3 点 `Energy`
+- 选择 1 个季度主行动
+
+半年后会做一次绩效评估，职级、财富、健康、尊严、技能、人脉和产出会一起算总账。很多规则是公开的，很多坑只会通过反馈和日志给你一点暗示。组织很忙，通常不会为你逐条标红。
+
+如果你只是想先记住一句话：
+
+> 在 48 个月里别把自己玩出局，同时尽量把结局打成一段还能写进简历的经历。
+
+## 快速开始
+
+先安装依赖：
+
+```bash
+uv sync
+```
+
+同步数据并开一局：
+
+```bash
+make play
+```
+
+继续上一局：
+
+```bash
+uv run career-emulator play --session-id <session-id>
+```
+
+CLI 里常用的几个输入：
+
+- 输入数字：执行当前选项
+- 输入 `handbook`：查看新员工手册
+- 输入 `logs`：查看当前会话日志
+- 输入 `quit`：退出
+
+## 给 Agent 用
+
+当前 MCP 能力包括：
+
+- `new_game`
+- `observe(session_id)`
+- `take_action(session_id, choice, notes)`
+- `check_latest_logs(session_id, count=10)`
+- `show_employee_handbook()`
+
+另外还提供日志资源：
+
+- `logs://{session_id}`
+
+### JiuwenSwarm
+参考 [JiuwenSwarm 配置赛题模拟器 MCP](https://career-emulator.readthedocs.io/jiuwenswarm-mcp.html)
+
+### 支持 MCPB 的 Agent（比如Claude）
+如果你的 Agent 支持 [MCP Bundle](https://blog.modelcontextprotocol.io/posts/2025-11-20-adopting-mcpb)，也可以生成本地安装包：
+
+```bash
+make mcpb
+```
+
+然后双击打开直接安装。
+
+### 其他 Agent
+如果你想让其他 Agent 通过 MCP 来玩，可以直接使用 `stdio` 格式的 MCP 服务：
+
+```bash
+uv sync --extra mcp
+uv run career-emulator-mcp
+```
+
+
+## 开发
+
+仓库里常用的本地检查命令：
+
+```bash
+make format
+make lint
+make test
+make docstring
+```
+
+文档构建：
+
+```bash
+make docs
+```
+
+## 文档
+
+- 文档首页：[career-emulator.readthedocs.io](https://career-emulator.readthedocs.io/)
+- 快速上手：[quickstart](https://career-emulator.readthedocs.io/quickstart.html)
+- 公开手册：[handbook](https://career-emulator.readthedocs.io/handbook.html)
+- 失败与结局：[failure-and-ending](https://career-emulator.readthedocs.io/failure-and-ending.html)

career_emulator-0.0.6/README.md

@@ -0,0 +1,120 @@
+# Career Emulator - CCF BDCI 2026
+
+[![PyPI - Version](https://img.shields.io/pypi/v/career-emulator)](https://pypi.org/project/career-emulator/) [![PyPI - License](https://img.shields.io/pypi/l/career-emulator)](https://github.com/Trenza1ore/TomatoEmulator/blob/main/LICENSE) [![Tests](https://github.com/Trenza1ore/TomatoEmulator/actions/workflows/tests.yml/badge.svg)](https://github.com/Trenza1ore/TomatoEmulator/actions/workflows/tests.yml)
+
+[![Documentation](https://img.shields.io/badge/赛题文档-brown?style=for-the-badge&logo=readthedocs&link=https%3A%2F%2Fcareer-emulator.readthedocs.io%2Fen%2Flatest%2Findex.html)](https://career-emulator.readthedocs.io)
+
+- 所属赛题：`2026 CCF 大数据与计算智能大赛` 的《职场生存与晋升挑战》赛题，说明见[比赛官网](https://www.xir.cn/competition/1165)，赛事入口见[2026 CCF 大数据与计算智能大赛](https://www.xir.cn/competition/races/BDCI2026)
+- 参赛方式：使用 [JiuwenSwarm](https://openjiuwen.com/jiuwenswarm) 构建 Agent，并开发一个或多个 [Skill](https://agentskills.io)
+- 交付形式：将一个或多个 Skill 文件夹打包成单个 `zip`
+- 交互方式：通过 `career-emulator` MCP 与环境交互
+
+如果你准备做多 Agent 协同参谋，也可以看看 [Swarm Skill 标准](https://swarmskills.openjiuwen.com)。
+
+你会从 `L1` 新人入职开始，在 48 个月里处理剧情事件、分配季度体力、选择季度主行动，再按半年节奏迎接绩效和晋升。目标也很直接：别太早出局，顺手把这段职业生涯经营得稍微体面一点。
+
+项目目前提供两种入口：
+
+- `career-emulator`：本地 CLI，适合直接试玩和调规则。
+- `career-emulator-mcp`：MCP 服务，适合接给 Agent 自动玩。
+
+更多公开规则、手册和玩法说明见文档：[career-emulator.readthedocs.io](https://career-emulator.readthedocs.io)。
+
+## 这题大概在玩什么
+
+每个月，系统会生成剧情事件，你从当前选项里挑一个往下走。每到季度末，还要额外处理两件事：
+
+- 分配 3 点 `Energy`
+- 选择 1 个季度主行动
+
+半年后会做一次绩效评估，职级、财富、健康、尊严、技能、人脉和产出会一起算总账。很多规则是公开的，很多坑只会通过反馈和日志给你一点暗示。组织很忙，通常不会为你逐条标红。
+
+如果你只是想先记住一句话：
+
+> 在 48 个月里别把自己玩出局，同时尽量把结局打成一段还能写进简历的经历。
+
+## 快速开始
+
+先安装依赖：
+
+```bash
+uv sync
+```
+
+同步数据并开一局：
+
+```bash
+make play
+```
+
+继续上一局：
+
+```bash
+uv run career-emulator play --session-id <session-id>
+```
+
+CLI 里常用的几个输入：
+
+- 输入数字：执行当前选项
+- 输入 `handbook`：查看新员工手册
+- 输入 `logs`：查看当前会话日志
+- 输入 `quit`：退出
+
+## 给 Agent 用
+
+当前 MCP 能力包括：
+
+- `new_game`
+- `observe(session_id)`
+- `take_action(session_id, choice, notes)`
+- `check_latest_logs(session_id, count=10)`
+- `show_employee_handbook()`
+
+另外还提供日志资源：
+
+- `logs://{session_id}`
+
+### JiuwenSwarm
+参考 [JiuwenSwarm 配置赛题模拟器 MCP](https://career-emulator.readthedocs.io/jiuwenswarm-mcp.html)
+
+### 支持 MCPB 的 Agent（比如Claude）
+如果你的 Agent 支持 [MCP Bundle](https://blog.modelcontextprotocol.io/posts/2025-11-20-adopting-mcpb)，也可以生成本地安装包：
+
+```bash
+make mcpb
+```
+
+然后双击打开直接安装。
+
+### 其他 Agent
+如果你想让其他 Agent 通过 MCP 来玩，可以直接使用 `stdio` 格式的 MCP 服务：
+
+```bash
+uv sync --extra mcp
+uv run career-emulator-mcp
+```
+
+
+## 开发
+
+仓库里常用的本地检查命令：
+
+```bash
+make format
+make lint
+make test
+make docstring
+```
+
+文档构建：
+
+```bash
+make docs
+```
+
+## 文档
+
+- 文档首页：[career-emulator.readthedocs.io](https://career-emulator.readthedocs.io/)
+- 快速上手：[quickstart](https://career-emulator.readthedocs.io/quickstart.html)
+- 公开手册：[handbook](https://career-emulator.readthedocs.io/handbook.html)
+- 失败与结局：[failure-and-ending](https://career-emulator.readthedocs.io/failure-and-ending.html)

career_emulator-0.0.6/career_emulator/__init__.py

@@ -0,0 +1 @@
+"""Career Emulator career simulation package."""

career_emulator-0.0.6/career_emulator/action_log.py

@@ -0,0 +1,87 @@
+"""Format readable action logs for Career Emulator sessions."""
+
+from career_emulator.server.models import EventChoice, RegularActionDefinition, RegularDecisionEvent
+
+
+def format_status_updates(updates: dict[str, int]) -> str:
+    """Return a compact summary of configured status changes."""
+    if not updates:
+        return ""
+    parts: list[str] = []
+    for key, value in updates.items():
+        sign = "+" if value >= 0 else ""
+        parts.append(f"{key} {sign}{value}")
+    return ", ".join(parts)
+
+
+def _truncate(text: str, limit: int = 160) -> str:
+    """Return text truncated for log output."""
+    compact = " ".join(text.split())
+    if len(compact) <= limit:
+        return compact
+    return f"{compact[: limit - 3]}..."
+
+
+def format_story_action_log(
+    month: int,
+    selected: EventChoice,
+    choice: int,
+    notes: str,
+) -> str:
+    """Format a story-event action log entry."""
+    lines = [
+        f"Month {month} | {selected.event_title}",
+        _truncate(selected.event_description),
+        f"Chose #{choice}: {selected.action}",
+    ]
+    updates = format_status_updates(selected.status_updates)
+    if updates:
+        lines.append(updates)
+    if notes.strip():
+        lines.append(f"Notes: {notes.strip()}")
+    return "\n".join(lines)
+
+
+def format_fixed_action_log(
+    month: int,
+    event: RegularDecisionEvent,
+    selected_action: RegularActionDefinition,
+    choice: int,
+    notes: str,
+    energy_remaining: int | None = None,
+) -> str:
+    """Format a quarterly fixed-event action log entry."""
+    lines = [
+        f"Month {month} | {event.event_name}",
+        _truncate(event.prompt),
+        f"Chose #{choice}: {selected_action.action}",
+    ]
+    updates = format_status_updates(selected_action.status_updates)
+    if updates:
+        lines.append(updates)
+    if selected_action.energy_cost:
+        lines.append(f"Energy cost: {selected_action.energy_cost}")
+    if energy_remaining is not None:
+        lines.append(f"Energy remaining: {energy_remaining}")
+    if notes.strip():
+        lines.append(f"Notes: {notes.strip()}")
+    return "\n".join(lines)
+
+
+def format_initialization_log() -> str:
+    """Format the initialization acknowledgement log entry."""
+    return "Month 1 | Initialization\nAcknowledged the employee handbook and started the simulation."
+
+
+def format_terminal_node_log(
+    month: int,
+    event_title: str,
+    description: str,
+) -> str:
+    """Format a terminal scenario node log entry."""
+    return "\n".join(
+        [
+            f"Month {month} | {event_title} completed",
+            _truncate(description),
+        ]
+    )

career_emulator-0.0.6/career_emulator/cli.py

@@ -0,0 +1,164 @@
+"""Human-playable command-line interface for Career Emulator."""
+
+import argparse
+import asyncio
+from typing import Any
+
+from career_emulator.game import get_default_engine
+from career_emulator.pretty_print import (
+    _blue,
+    _cyan,
+    _event_header,
+    _green,
+    _highlight,
+    _red,
+    _state_header,
+    _yellow,
+)
+from career_emulator.storage import update_dataset
+
+DEBUG_MODE = False
+
+
+def main() -> None:
+    """Run the Career Emulator CLI."""
+    parser = argparse.ArgumentParser(description="Play Career Emulator from the terminal.")
+    subparsers = parser.add_subparsers(dest="command")
+    play_parser = subparsers.add_parser("play", help="Start an interactive game.")
+    play_parser.add_argument("--session-id", default=None, help="Resume an existing session.")
+    subparsers.add_parser("update", help="Clone or force-update the event dataset.")
+    args = parser.parse_args()
+
+    if args.command in {None, "play"}:
+        asyncio.run(play(session_id=args.session_id))
+    elif args.command == "update":
+        dataset_path = update_dataset()
+        print(_green(f"Dataset updated at: {dataset_path}"))
+
+
+async def play(session_id: str | None = None) -> None:
+    """Play or resume a Career Emulator session.
+
+    :param session_id: Optional session id to resume.
+    """
+    engine = get_default_engine()
+    if session_id is None:
+        try:
+            response = await engine.new_game()
+        except ValueError as e:
+            raise RuntimeError("Perhaps the data files are missing, maybe try running\n  career-emulator update") from e
+        session_id = response.session_id
+        print(_green(f"Started session: {session_id}"))
+    else:
+        print(_cyan(f"Resumed session: {session_id}"))
+
+    while True:
+        observation = await engine.observe(session_id)
+        state = observation.current_state
+        if "error" in state:
+            if observation.warning:
+                print("\n" + _highlight(observation.warning), end="\n\n")
+            if observation.ending_score is not None:
+                _print_ending_score(observation.ending_score)
+            print(_red(state["error"]))
+            return
+        _print_state(state)
+        if observation.warning:
+            print("\n" + _highlight(observation.warning), end="\n\n")
+        if not observation.choices:
+            print(_yellow("No available choices. The current prototype has no more events to resolve."))
+            return
+        _print_event(observation.current_event)
+        _print_choices(observation.choices)
+        invalid_choice = True
+        while invalid_choice:
+            raw_choice = input("Choice number, 'handbook', 'logs', or 'quit': ").strip()
+            if raw_choice.lower() in {"q", "quit", "exit"}:
+                return
+            if raw_choice.lower() == "handbook":
+                _print_handbook(await engine.enrollment_handbook())
+                invalid_choice = False
+                continue
+            if raw_choice.lower() == "logs":
+                print(await engine.logs_text(session_id))
+                invalid_choice = False
+                input(_highlight("> Press ENTER to continue..."))
+                continue
+            try:
+                choice = int(raw_choice)
+                invalid_choice = False
+            except ValueError:
+                print(_yellow("Please enter a choice number, 'handbook', 'logs', or 'quit'."))
+            if not invalid_choice:
+                result = await engine.take_action(session_id, choice, "")
+                invalid_choice = not result.success
+                if invalid_choice:
+                    print(_red(f"Action failed: {result.error}"))
+
+
+def _print_state(state: dict[str, Any]) -> None:
+    """Print a compact visible state summary."""
+    print()
+    session_id = state["session_id"]
+    status, time_info = state["status"], state["time"]
+    month, quarter, year = time_info["current_month"], time_info["current_quarter"], time_info["current_year"]
+    statistics = state.get("statistics")
+    print(_state_header(" State "), _blue(f"Session: {session_id}"))
+    print(_state_header(" " + status["level"] + "    ") + _cyan(f" Month {month} | Quarter {quarter} | Year {year}"))
+    print(_red("Energy {energy:3d} | Output {output:3d} | Wealth {wealth:4d}").format(**status))
+    print(
+        _green("Dignity {dignity:2d} | Health {health:3d} | Network {network:3d} | Skill {skill:3d}").format(**status)
+    )
+    if DEBUG_MODE and statistics:
+        print(_yellow(f"Extra statistics: {statistics}"))
+
+
+def _print_event(current_event: dict[str, Any] | None) -> None:
+    """Print the current event."""
+    if current_event is None:
+        return
+    print()
+    print(_event_header(" Event "))
+    title, event_id = current_event["title"], current_event["event_id"]
+    node_id = current_event.get("node_id", "scripted")
+    print(_green(f"{title} ({event_id}:{node_id})"))
+    print(current_event["description"])
+
+
+def _print_choices(choices: list[dict[str, Any]]) -> None:
+    """Print currently available choices."""
+    print()
+    print(_highlight(" Choice "))
+    for choice in choices:
+        energy = int(choice.get("energy_cost", 0))
+        choice_idx = choice["choice"]
+        action = choice["action"]
+        print(_cyan(f"{choice_idx}. {action}") + (f" ({energy})" if energy else ""))
+
+
+def _print_handbook(handbook: str) -> None:
+    """Print the initialization handbook."""
+    print()
+    print(_event_header(" Handbook "))
+    print(handbook)
+
+
+def _print_ending_score(ending_score: dict[str, Any]) -> None:
+    """Print the ending score summary."""
+    print()
+    print(_event_header(" Ending Score "))
+    print(_event_header(" {grade}: {grade_meaning}").format(**ending_score))
+    outcome = "48-month completion" if ending_score.get("completed") else "Early elimination"
+    print(_cyan(f"{outcome} | Survived {ending_score['survival_months']} months"))
+    print(_green("Quantitative score: {quantitative_score:.1f}/100").format(**ending_score))
+    print(_yellow("Score breakdown: {competition_partial_score:.1f}/60").format(**ending_score))
+    for dimension in ending_score.get("dimensions", []):
+        print(
+            f"  {dimension['label']}: {dimension['raw_value']:6.1f} → "
+            f"{dimension['normalized_score']:5.1f} (weight {dimension['weight']:.0%}, "
+            f"contribution {dimension['weighted_score']:4.1f})"
+        )
+
+
+if __name__ == "__main__":
+    main()