gymcraft 1.2.0__tar.gz

gymcraft-1.2.0/PKG-INFO

@@ -0,0 +1,167 @@
+Metadata-Version: 2.4
+Name: gymcraft
+Version: 1.2.0
+Summary: Python RPC client for GymCraft - Gymnasium-style RL environments in Minecraft
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: grpcio>=1.81.1
+Requires-Dist: gymnasium>=1.3.0
+Requires-Dist: mcrcon>=0.7.0
+Requires-Dist: mypy>=2.1.0
+Requires-Dist: openai>=3.3.1
+Requires-Dist: protobuf>=6.33.6
+
+# GymCraft Python RPC Client
+
+Install dependencies:
+
+```powershell
+cd src\main\python
+uv sync
+```
+
+Generate Python gRPC stubs from the mod proto files, then build the wheel:
+
+```powershell
+# from repository root
+.\gradlew generatePythonStubs
+.\gradlew packagePython
+```
+
+Or build directly with uv:
+
+```powershell
+cd src\main\python
+uv build
+```
+
+Create an environment in-game with the env tool, then connect by entity UUID:
+
+```python
+from gymcraft import GymCraftEnv
+from gymcraft.gym.action.components import noop_pb2
+
+env = GymCraftEnv("entity-uuid-here")
+obs, reset_info = env.reset(options={
+    "disable_vanilla_ai": True,
+    "allow_multiple_actions": True,
+})  # Disable vanilla AI only while waiting between actions; defaults to False.
+self_state = obs["gymcraft:self"]
+
+obs, reward, terminated, truncated, step_info = env.step({
+    "timeout_seconds": 0.0,  # seconds; <= 0 means no limit
+    "actions": [
+        {"component_id": "gymcraft:noop", "payload": noop_pb2.ProtoNoop()},
+    ],
+})
+env.close()
+```
+
+`reset()` returns `(observation, info)` and `step()` returns `(observation, reward, terminated, truncated, info)` (Gymnasium-style). The observation is the unpacked `Observation` dict: a `header` plus component keys that are full registration ids such as `gymcraft:self`, `gymcraft:nearby_blocks`, `gymcraft:menu`. A step receives an ordered `ActionBatch`; each action has exactly one `component_id` and protobuf `payload`, and the server executes the list serially under one shared `timeout_seconds`. `make_action()` packs one action into `ProtoMcAction`, while `unpack_observation()` converts a raw `ProtoMcObservation` back to an `Observation`.
+
+`allow_multiple_actions` 默认为 `True`。在 reset options 中设为 `False` 后，每个 step 最多接受一个 action；多 action 批次会整体失败且不产生动作副作用，空批次 noop 仍可使用。
+
+`gymcraft:update_interesting_blocks` 可通过 `add_block_ids` / `remove_block_ids` 批量维护当前 Agent 关注的方块类型；`gymcraft:interesting_blocks` 返回附近匹配类型的可见 `ProtoBlockView`。
+
+Typecheck the Python client:
+
+```powershell
+cd src\main\python
+uv run mypy src debug demos tests
+```
+
+GitHub Actions runs stub generation, mypy, packaging, and uploads the built distributions as the `gymcraft-python-dist` artifact.
+
+## LLM Agent 工具包
+
+`gymcraft.llm` 将 LLM 相关能力拆成可独立复用的组件：
+
+- `ObservationTextFormatter`：将 protobuf 观测转换为紧凑、稳定的行式文本；
+- `ActionDslParser` / `encode_action_batch`：解析模型回复中的命令 DSL，并编码为现有 `Action`；
+- `ConversationHistory` / `ContextAssembler`：组装通用 Chat Completions 消息；
+- `LLMGymCraftEnv`：只负责串联上述组件与底层 `GymCraftEnv`，所有组件都可替换或单独使用。
+
+内置 system prompt、命令说明和动作纠错反馈均使用英文。观测只渲染决策所需的原生字段，不生成相对坐标等派生状态；附近实体、普通方块和感兴趣方块默认各最多 10 条。`action-result` 不包含服务端 `details`。
+`ConversationHistory` 按 `history_turns` 分批保留完整历史；当前批次满载后，下一轮会折叠整批历史并作为新批次的第一轮重新积累，不再逐轮滚动淘汰最旧上下文。
+
+最小 wrapper 示例：
+
+````python
+from gymcraft import GymCraftEnv
+from gymcraft.llm import LLMGymCraftEnv
+
+base_env = GymCraftEnv("entity-uuid-here")
+env = LLMGymCraftEnv(base_env, task="走到最近的箱子旁并打开它。")
+context, info = env.reset(options={"disable_vanilla_ai": True})
+
+# context["messages"] 可直接交给任意 Chat Completions 兼容 API。
+model_text = """我先靠近箱子。
+
+```gymcraft-action
+/timeout 10
+/move_to 12 64 -3 1
+```
+"""
+context, reward, terminated, truncated, info = env.step(model_text)
+env.close()
+````
+
+动作块位于回复末尾，每个非空行是一条 Minecraft 风格命令。一个动作块可以包含多个动作，服务端严格按文本行顺序串行执行，并允许重复同一组件。多条 `move_menu_item` 会保留为一个组件原生批量负载。调用 `ActionDslParser.command_reference()` 可以取得当前环境支持的完整命令表。
+
+LLM 可用一条原子命令同时增删兴趣类型，例如 `/update_interesting_blocks add minecraft:diamond_ore mod:target_block remove minecraft:stone`。匹配结果会在后续观测的 `interesting_blocks` 段中按距离排序；其文本裁剪上限由 `ObservationFormatConfig.max_interesting_blocks` 控制。
+
+连接已创建的 `simple_mob` 环境进行真实 DSL/gRPC 调试：
+
+```powershell
+uv run python debug/interesting_blocks_debug.py <entity_uuid> --add minecraft:diamond_ore
+```
+
+格式错误不会推进游戏状态。wrapper 会把错误和模型原文加入上下文，默认允许两次原地纠正，连续第三次非法输出会截断当前 rollout。服务端返回的 reward、terminated 和 truncated 不会被 Python 任务逻辑改写。
+
+## Chat Completions 闭环 Demo
+
+Chat Completions 客户端是可选依赖：
+
+```powershell
+uv sync --extra openai
+```
+
+运行 demo；`base_url`、API key 和模型均可替换为任意兼容服务提供的值：
+
+```powershell
+$env:LLM_BASE_URL = "https://api.openai.com/v1"
+$env:LLM_API_KEY = "your-api-key"
+$env:LLM_MODEL = "your-model-id"
+
+uv run --extra openai demos/llm_chat_completions_demo.py `
+  <entity_uuid> `
+  --task "找到最近的箱子并查看其中的物品"
+```
+
+demo 使用通用的 `client.chat.completions.create(model=..., messages=...)` 接口，不启用 Responses API、厂商工具调用或服务端会话存储。
+
+连接 `gymcraft:iron_mining` 环境可运行完整生存工具链 demo：
+
+```powershell
+uv run --extra openai demos/iron_mining_llm_demo.py `
+  <entity_uuid> `
+  --max-steps 64 `
+  --trace traces/iron-mining.jsonl
+```
+
+该 demo 内置从空手采集原木、使用 self 菜单 $2\times2$ 合成、放置工作台、制作石镐并拾取粗铁的任务提示。`--task` 可覆盖提示，`--trace` 可保存完整 JSONL 轨迹。
+
+## 人工终端交互
+
+```powershell
+uv run debug/llm_terminal.py <entity_uuid> --task "测试菜单和移动动作"
+```
+
+终端中可直接输入一条或多条 `/command`，空行提交；工具会自动补上 `gymcraft-action` 围栏。输入 `:obs` 查看最新观测、`:context` 查看实际消息历史、`:quit` 退出。
+
+## 检查
+
+```powershell
+uv run python -m unittest discover -s tests -v
+uv run mypy src debug demos tests
+```

gymcraft-1.2.0/README.md

@@ -0,0 +1,154 @@
+# GymCraft Python RPC Client
+
+Install dependencies:
+
+```powershell
+cd src\main\python
+uv sync
+```
+
+Generate Python gRPC stubs from the mod proto files, then build the wheel:
+
+```powershell
+# from repository root
+.\gradlew generatePythonStubs
+.\gradlew packagePython
+```
+
+Or build directly with uv:
+
+```powershell
+cd src\main\python
+uv build
+```
+
+Create an environment in-game with the env tool, then connect by entity UUID:
+
+```python
+from gymcraft import GymCraftEnv
+from gymcraft.gym.action.components import noop_pb2
+
+env = GymCraftEnv("entity-uuid-here")
+obs, reset_info = env.reset(options={
+    "disable_vanilla_ai": True,
+    "allow_multiple_actions": True,
+})  # Disable vanilla AI only while waiting between actions; defaults to False.
+self_state = obs["gymcraft:self"]
+
+obs, reward, terminated, truncated, step_info = env.step({
+    "timeout_seconds": 0.0,  # seconds; <= 0 means no limit
+    "actions": [
+        {"component_id": "gymcraft:noop", "payload": noop_pb2.ProtoNoop()},
+    ],
+})
+env.close()
+```
+
+`reset()` returns `(observation, info)` and `step()` returns `(observation, reward, terminated, truncated, info)` (Gymnasium-style). The observation is the unpacked `Observation` dict: a `header` plus component keys that are full registration ids such as `gymcraft:self`, `gymcraft:nearby_blocks`, `gymcraft:menu`. A step receives an ordered `ActionBatch`; each action has exactly one `component_id` and protobuf `payload`, and the server executes the list serially under one shared `timeout_seconds`. `make_action()` packs one action into `ProtoMcAction`, while `unpack_observation()` converts a raw `ProtoMcObservation` back to an `Observation`.
+
+`allow_multiple_actions` 默认为 `True`。在 reset options 中设为 `False` 后，每个 step 最多接受一个 action；多 action 批次会整体失败且不产生动作副作用，空批次 noop 仍可使用。
+
+`gymcraft:update_interesting_blocks` 可通过 `add_block_ids` / `remove_block_ids` 批量维护当前 Agent 关注的方块类型；`gymcraft:interesting_blocks` 返回附近匹配类型的可见 `ProtoBlockView`。
+
+Typecheck the Python client:
+
+```powershell
+cd src\main\python
+uv run mypy src debug demos tests
+```
+
+GitHub Actions runs stub generation, mypy, packaging, and uploads the built distributions as the `gymcraft-python-dist` artifact.
+
+## LLM Agent 工具包
+
+`gymcraft.llm` 将 LLM 相关能力拆成可独立复用的组件：
+
+- `ObservationTextFormatter`：将 protobuf 观测转换为紧凑、稳定的行式文本；
+- `ActionDslParser` / `encode_action_batch`：解析模型回复中的命令 DSL，并编码为现有 `Action`；
+- `ConversationHistory` / `ContextAssembler`：组装通用 Chat Completions 消息；
+- `LLMGymCraftEnv`：只负责串联上述组件与底层 `GymCraftEnv`，所有组件都可替换或单独使用。
+
+内置 system prompt、命令说明和动作纠错反馈均使用英文。观测只渲染决策所需的原生字段，不生成相对坐标等派生状态；附近实体、普通方块和感兴趣方块默认各最多 10 条。`action-result` 不包含服务端 `details`。
+`ConversationHistory` 按 `history_turns` 分批保留完整历史；当前批次满载后，下一轮会折叠整批历史并作为新批次的第一轮重新积累，不再逐轮滚动淘汰最旧上下文。
+
+最小 wrapper 示例：
+
+````python
+from gymcraft import GymCraftEnv
+from gymcraft.llm import LLMGymCraftEnv
+
+base_env = GymCraftEnv("entity-uuid-here")
+env = LLMGymCraftEnv(base_env, task="走到最近的箱子旁并打开它。")
+context, info = env.reset(options={"disable_vanilla_ai": True})
+
+# context["messages"] 可直接交给任意 Chat Completions 兼容 API。
+model_text = """我先靠近箱子。
+
+```gymcraft-action
+/timeout 10
+/move_to 12 64 -3 1
+```
+"""
+context, reward, terminated, truncated, info = env.step(model_text)
+env.close()
+````
+
+动作块位于回复末尾，每个非空行是一条 Minecraft 风格命令。一个动作块可以包含多个动作，服务端严格按文本行顺序串行执行，并允许重复同一组件。多条 `move_menu_item` 会保留为一个组件原生批量负载。调用 `ActionDslParser.command_reference()` 可以取得当前环境支持的完整命令表。
+
+LLM 可用一条原子命令同时增删兴趣类型，例如 `/update_interesting_blocks add minecraft:diamond_ore mod:target_block remove minecraft:stone`。匹配结果会在后续观测的 `interesting_blocks` 段中按距离排序；其文本裁剪上限由 `ObservationFormatConfig.max_interesting_blocks` 控制。
+
+连接已创建的 `simple_mob` 环境进行真实 DSL/gRPC 调试：
+
+```powershell
+uv run python debug/interesting_blocks_debug.py <entity_uuid> --add minecraft:diamond_ore
+```
+
+格式错误不会推进游戏状态。wrapper 会把错误和模型原文加入上下文，默认允许两次原地纠正，连续第三次非法输出会截断当前 rollout。服务端返回的 reward、terminated 和 truncated 不会被 Python 任务逻辑改写。
+
+## Chat Completions 闭环 Demo
+
+Chat Completions 客户端是可选依赖：
+
+```powershell
+uv sync --extra openai
+```
+
+运行 demo；`base_url`、API key 和模型均可替换为任意兼容服务提供的值：
+
+```powershell
+$env:LLM_BASE_URL = "https://api.openai.com/v1"
+$env:LLM_API_KEY = "your-api-key"
+$env:LLM_MODEL = "your-model-id"
+
+uv run --extra openai demos/llm_chat_completions_demo.py `
+  <entity_uuid> `
+  --task "找到最近的箱子并查看其中的物品"
+```
+
+demo 使用通用的 `client.chat.completions.create(model=..., messages=...)` 接口，不启用 Responses API、厂商工具调用或服务端会话存储。
+
+连接 `gymcraft:iron_mining` 环境可运行完整生存工具链 demo：
+
+```powershell
+uv run --extra openai demos/iron_mining_llm_demo.py `
+  <entity_uuid> `
+  --max-steps 64 `
+  --trace traces/iron-mining.jsonl
+```
+
+该 demo 内置从空手采集原木、使用 self 菜单 $2\times2$ 合成、放置工作台、制作石镐并拾取粗铁的任务提示。`--task` 可覆盖提示，`--trace` 可保存完整 JSONL 轨迹。
+
+## 人工终端交互
+
+```powershell
+uv run debug/llm_terminal.py <entity_uuid> --task "测试菜单和移动动作"
+```
+
+终端中可直接输入一条或多条 `/command`，空行提交；工具会自动补上 `gymcraft-action` 围栏。输入 `:obs` 查看最新观测、`:context` 查看实际消息历史、`:quit` 退出。
+
+## 检查
+
+```powershell
+uv run python -m unittest discover -s tests -v
+uv run mypy src debug demos tests
+```

gymcraft-1.2.0/pyproject.toml

@@ -0,0 +1,67 @@
+[build-system]
+requires = ["setuptools>=75", "grpcio-tools>=1.81.1"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "gymcraft"
+version = "1.2.0" # 这里和模组版本号保持一致
+description = "Python RPC client for GymCraft - Gymnasium-style RL environments in Minecraft"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "grpcio>=1.81.1",
+    "gymnasium>=1.3.0",
+    "mcrcon>=0.7.0",
+    "mypy>=2.1.0",
+    "openai>=3.3.1",
+    "protobuf>=6.33.6",
+]
+
+[dependency-groups]
+dev = [
+    "grpcio-tools>=1.81.1",
+    "mcp>=2.1.1",
+    "openai>=2.0.0",
+    "python-dotenv>=1.2.3",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["gymcraft", "gymcraft.*"]
+
+[tool.mypy]
+python_version = "3.11"
+files = ["src/gymcraft", "debug"]
+exclude = ["src/gymcraft/gym/"]
+mypy_path = "src"
+
+warn_return_any = true
+warn_unused_configs = true
+warn_unused_ignores = true
+warn_redundant_casts = true
+warn_unreachable = true
+
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+disallow_untyped_decorators = true
+
+no_implicit_optional = true
+strict_equality = true
+show_error_codes = true
+pretty = true
+
+[[tool.mypy.overrides]]
+module = [
+  "gymcraft.gym.*",
+]
+follow_imports = "skip"
+ignore_errors = true
+
+[[tool.mypy.overrides]]
+module = [
+  "grpc.*",
+  "gymnasium.*",
+  "google.*",
+]
+ignore_missing_imports = true

gymcraft-1.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

gymcraft-1.2.0/src/gymcraft/__init__.py

@@ -0,0 +1,12 @@
+from gymcraft.client import GymCraftEnv, make_action, make_step_request, single_action, unpack_observation
+from gymcraft.llm import LLMEnvConfig, LLMGymCraftEnv
+
+__all__ = [
+    "GymCraftEnv",
+    "LLMEnvConfig",
+    "LLMGymCraftEnv",
+    "make_action",
+    "make_step_request",
+    "single_action",
+    "unpack_observation",
+]

gymcraft-1.2.0/src/gymcraft/client.py

@@ -0,0 +1,159 @@
+from __future__ import annotations
+
+import json
+from collections.abc import Mapping
+from typing import Any, Tuple, TypeVar, cast
+
+import grpc
+import gymnasium as gym
+from google.protobuf import message
+
+from gymcraft.gym.action.action_pb2 import ProtoMcAction
+from gymcraft.gym.observation.components.chat_pb2 import ProtoRecentChat
+from gymcraft.gym.observation.components.menu_pb2 import ProtoMenuObservation
+from gymcraft.gym.observation.components.interesting_blocks_pb2 import ProtoInterestingBlocks
+from gymcraft.gym.observation.components.nearby_blocks_pb2 import ProtoNearbyBlocks
+from gymcraft.gym.observation.components.nearby_entities_pb2 import ProtoNearbyEntities
+from gymcraft.gym.observation.components.nearby_items_pb2 import ProtoNearbyItems
+from gymcraft.gym.observation.components.self_pb2 import ProtoSelfState
+from gymcraft.gym.observation.components.world_pb2 import ProtoWorldState
+from gymcraft.gym.observation.observation_pb2 import ProtoMcObservation
+from gymcraft.gym.rpc.env_service_pb2 import (
+    CloseSessionRequest,
+    ConnectRequest,
+    ResetRequest,
+    ResetResponse,
+    StepRequest,
+    StepResponse,
+)
+from gymcraft.gym.rpc.env_service_pb2_grpc import GymEnvServiceStub
+from gymcraft.type_info import (
+    Action,
+    ActionBatch,
+    Observation,
+    OBS_INTERESTING_BLOCKS,
+    OBS_MENU,
+    OBS_NEARBY_BLOCKS,
+    OBS_NEARBY_ENTITIES,
+    OBS_NEARBY_ITEMS,
+    OBS_CHAT,
+    OBS_SELF,
+    OBS_WORLD,
+    TIMEOUT_SECONDS,
+)
+
+_TMessage = TypeVar("_TMessage", bound=message.Message)
+
+# 观测组件注册 id（完整 wire 键，含 `gymcraft:` 命名空间）→ 解包目标 protobuf 消息类型。
+# 新增观测组件时需在此登记，否则 `unpack_observation` 会将其视为未知组件。
+_OBSERVATION_COMPONENT_TYPES: dict[str, type[message.Message]] = {
+    OBS_SELF: ProtoSelfState,
+    OBS_WORLD: ProtoWorldState,
+    OBS_NEARBY_ENTITIES: ProtoNearbyEntities,
+    OBS_NEARBY_BLOCKS: ProtoNearbyBlocks,
+    OBS_MENU: ProtoMenuObservation,
+    OBS_NEARBY_ITEMS: ProtoNearbyItems,
+    OBS_INTERESTING_BLOCKS: ProtoInterestingBlocks,
+    OBS_CHAT: ProtoRecentChat,
+}
+
+
+class GymCraftEnv(gym.Env[Any, Any]):
+    metadata = {"render_modes": []}
+
+    def __init__(self, entity_uuid: str, address: str = "localhost:50051") -> None:
+        self.entity_uuid = entity_uuid
+        self.address = address
+        self.channel = grpc.insecure_channel(address)
+        self.stub = GymEnvServiceStub(self.channel)
+
+        response = self.stub.Connect(ConnectRequest(entity_uuid=entity_uuid))
+        self.session_id = response.session_id
+        self.entity_uuid = response.entity_uuid
+        self.remote_metadata = json.loads(response.metadata)
+        self.action_space_spec = json.loads(response.action_space_json)
+        self.observation_space_spec = json.loads(response.observation_space_json)
+
+    # gymnasium 约定 info 为 dict，本环境按 proto 直接透传 info 的 JSON 字符串。
+    def reset(self, *, seed: int | None = None, options: Mapping[str, Any] | None = None) -> Tuple[Observation, str]:  # type: ignore[override]  # noqa: E501
+        super().reset(seed=seed)
+        request = ResetRequest(session_id=self.session_id)
+        if seed is not None:
+            request.seed = seed
+        request.options = json.dumps(options or {})
+
+        response = self.stub.Reset(request)
+        assert isinstance(response, ResetResponse)
+        return unpack_observation(response.observation), response.info
+
+    # gymnasium 约定 info 为 dict，本环境按 proto 直接透传 info 的 JSON 字符串。
+    def step(self, action: ActionBatch) -> Tuple[Observation, float, bool, bool, str]:  # type: ignore[override]  # noqa: E501
+        request = make_step_request(self.session_id, action)
+        response = self.stub.Step(request)
+        assert isinstance(response, StepResponse)
+        return (
+            unpack_observation(response.observation),
+            response.reward,
+            response.terminated,
+            response.truncated,
+            response.info,
+        )
+
+    def close(self) -> None:
+        session_id = getattr(self, "session_id", None)
+        if session_id:
+            self.stub.CloseSession(CloseSessionRequest(session_id=session_id))
+            self.session_id = ""
+        self.channel.close()
+
+
+def make_action(action: Action) -> ProtoMcAction:
+    """把单个 ``component_id`` / ``payload`` 动作打包为 wire 消息。"""
+    proto_action = ProtoMcAction(component_id=action["component_id"])
+    proto_action.payload.Pack(cast(message.Message, action["payload"]))
+    return proto_action
+
+
+def single_action(component_id: str, payload: message.Message, timeout_seconds: float = 0.0) -> ActionBatch:
+    """构造只包含一项的 step 动作批次。"""
+    return {
+        "timeout_seconds": timeout_seconds,
+        "actions": [{"component_id": component_id, "payload": payload}],
+    }
+
+
+def make_step_request(session_id: str, batch: ActionBatch) -> StepRequest:
+    """把用户视角的动作批次打包为 gRPC StepRequest。"""
+    return StepRequest(
+        session_id=session_id,
+        actions=[make_action(item) for item in batch["actions"]],
+        timeout_seconds=batch.get(TIMEOUT_SECONDS, 0.0),
+    )
+
+
+def _unpack_component(
+    raw_observation: ProtoMcObservation,
+    key: str,
+    message_type: type[_TMessage],
+) -> _TMessage:
+    packed = raw_observation.components[key]
+    payload = cast(_TMessage, message_type())
+    if not packed.Unpack(payload):
+        raise ValueError(f"观测组件 {key!r} 无法解包为 {message_type.DESCRIPTOR.full_name}")
+    return payload
+
+
+def unpack_observation(raw_observation: ProtoMcObservation) -> Observation:
+    """把 wire 上的 ``ProtoMcObservation`` 解包为用户视角的 ``Observation``。
+
+    ``header`` 原样保留；``components`` 中已登记的组件按注册 id 解包为对应的
+    protobuf 消息，未登记的键抛 ``ValueError``，避免静默丢失新组件。
+    """
+    unknown = set(raw_observation.components) - set(_OBSERVATION_COMPONENT_TYPES)
+    if unknown:
+        raise ValueError(f"观测包含未识别的组件: {sorted(unknown)}")
+    result: dict[str, Any] = {"header": raw_observation.header}
+    for key, message_type in _OBSERVATION_COMPONENT_TYPES.items():
+        if key in raw_observation.components:
+            result[key] = _unpack_component(raw_observation, key, message_type)
+    return cast(Observation, result)

gymcraft-1.2.0/src/gymcraft/gym/action/action_pb2.py

@@ -0,0 +1,38 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: gymcraft/gym/action/action.proto
+# Protobuf Python Version: 6.33.5
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    6,
+    33,
+    5,
+    '',
+    'gymcraft/gym/action/action.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import any_pb2 as google_dot_protobuf_dot_any__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n gymcraft/gym/action/action.proto\x12\x13gymcraft.gym.action\x1a\x19google/protobuf/any.proto\"u\n\rProtoMcAction\x12\x14\n\x0c\x63omponent_id\x18\x03 \x01(\t\x12%\n\x07payload\x18\x04 \x01(\x0b\x32\x14.google.protobuf.AnyJ\x04\x08\x01\x10\x02J\x04\x08\x02\x10\x03R\ncomponentsR\x0ftimeout_secondsB>\n-io.github.mousemeya.gymcraft.gym.action.protoB\x0b\x41\x63tionProtoP\x01\x62\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'gymcraft.gym.action.action_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n-io.github.mousemeya.gymcraft.gym.action.protoB\013ActionProtoP\001'
+  _globals['_PROTOMCACTION']._serialized_start=84
+  _globals['_PROTOMCACTION']._serialized_end=201
+# @@protoc_insertion_point(module_scope)

gymcraft-1.2.0/src/gymcraft/gym/action/action_pb2.pyi

@@ -0,0 +1,15 @@
+from google.protobuf import any_pb2 as _any_pb2
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from collections.abc import Mapping as _Mapping
+from typing import ClassVar as _ClassVar, Optional as _Optional, Union as _Union
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class ProtoMcAction(_message.Message):
+    __slots__ = ("component_id", "payload")
+    COMPONENT_ID_FIELD_NUMBER: _ClassVar[int]
+    PAYLOAD_FIELD_NUMBER: _ClassVar[int]
+    component_id: str
+    payload: _any_pb2.Any
+    def __init__(self, component_id: _Optional[str] = ..., payload: _Optional[_Union[_any_pb2.Any, _Mapping]] = ...) -> None: ...

gymcraft-1.2.0/src/gymcraft/gym/action/action_pb2_grpc.py

@@ -0,0 +1,24 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+"""Client and server classes corresponding to protobuf-defined services."""
+import grpc
+import warnings
+
+
+GRPC_GENERATED_VERSION = '1.81.1'
+GRPC_VERSION = grpc.__version__
+_version_not_supported = False
+
+try:
+    from grpc._utilities import first_version_is_lower
+    _version_not_supported = first_version_is_lower(GRPC_VERSION, GRPC_GENERATED_VERSION)
+except ImportError:
+    _version_not_supported = True
+
+if _version_not_supported:
+    raise RuntimeError(
+        f'The grpc package installed is at version {GRPC_VERSION},'
+        + ' but the generated code in gymcraft/gym/action/action_pb2_grpc.py depends on'
+        + f' grpcio>={GRPC_GENERATED_VERSION}.'
+        + f' Please upgrade your grpc module to grpcio>={GRPC_GENERATED_VERSION}'
+        + f' or downgrade your generated code using grpcio-tools<={GRPC_VERSION}.'
+    )

gymcraft-1.2.0/src/gymcraft/gym/action/components/attack_once_pb2.py

@@ -0,0 +1,37 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: gymcraft/gym/action/components/attack_once.proto
+# Protobuf Python Version: 6.33.5
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    6,
+    33,
+    5,
+    '',
+    'gymcraft/gym/action/components/attack_once.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n0gymcraft/gym/action/components/attack_once.proto\x12\x13gymcraft.gym.action\"+\n\x0fProtoAttackOnce\x12\x18\n\x10target_entity_id\x18\x01 \x01(\x05\x42\x42\n-io.github.mousemeya.gymcraft.gym.action.protoB\x0f\x41ttackOnceProtoP\x01\x62\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'gymcraft.gym.action.components.attack_once_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n-io.github.mousemeya.gymcraft.gym.action.protoB\017AttackOnceProtoP\001'
+  _globals['_PROTOATTACKONCE']._serialized_start=73
+  _globals['_PROTOATTACKONCE']._serialized_end=116
+# @@protoc_insertion_point(module_scope)