kimi-agent-module-api 2.0.0__tar.gz → 2.1.0__tar.gz

{kimi_agent_module_api-2.0.0/src/kimi_agent_module_api.egg-info → kimi_agent_module_api-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kimi-agent-module-api
-Version: 2.0.0
+Version: 2.1.0
 Summary: Stable contracts for community-built assistant modules
 Author: Webhead
 License-Expression: MIT
@@ -69,23 +69,27 @@ documents installation, declarations, lifecycle, and every runtime port. The
 [reference module](https://github.com/webhead2oo9/kimi-agent/tree/main/bot/modules/example)
 is a complete, commented example that exercises most ports; start there.
 
-Guild-scoped live command replacement was added in 1.1. Modules using
+Modules using guild-scoped live command replacement through
 `InteractionRouter.replace_guild_commands()` should require the host capability
 `discord.guild_commands.v1`.
 
-Version 1.2 adds typed modal forms and a narrow Components V2 layout model. Once a response uses
+The SDK provides typed modal forms and a narrow Components V2 layout model. Once a response uses
 that layout model, Discord requires every later edit of the same message to remain a layout.
 Modules using them should require
 `discord.modals.v1` and/or `discord.components_v2.v1`.
 
-Version 1.3 adds cached author classification to message-deletion events:
+Message-deletion events include cached author classification:
 `MessageDeleteEvent.author_is_bot` and `MessageBulkDeleteEvent.bot_message_ids`.
 The values remain unknown for messages that were absent from Discord's cache.
 
-Version 2 requires an explicit, source-pinned `ModuleSpec.api_version`, and
-removes the temporary guild-settings legacy flag and module table aliases.
-Modules must use namespaced guild documents and migrate legacy tables to the
-physical names returned by `ctx.storage.table()` before upgrading.
+SDK 2.1 adds `ModuleToolContext.trigger_discord_message_id`. Mention-path tool
+calls receive the exact source Discord message snowflake; other surfaces receive
+`None`. Modules that act on a user's source message should require
+`kimi-agent-module-api>=2.1,<3`, reject `None`, fetch that exact message through
+`ctx.discord`, and verify its author before acting.
+
+Modules use namespaced guild documents and the physical table names returned
+by `ctx.storage.table()`.
 
 ## Testing the SDK
 

{kimi_agent_module_api-2.0.0 → kimi_agent_module_api-2.1.0}/README.md

@@ -52,23 +52,27 @@ documents installation, declarations, lifecycle, and every runtime port. The
 [reference module](https://github.com/webhead2oo9/kimi-agent/tree/main/bot/modules/example)
 is a complete, commented example that exercises most ports; start there.
 
-Guild-scoped live command replacement was added in 1.1. Modules using
+Modules using guild-scoped live command replacement through
 `InteractionRouter.replace_guild_commands()` should require the host capability
 `discord.guild_commands.v1`.
 
-Version 1.2 adds typed modal forms and a narrow Components V2 layout model. Once a response uses
+The SDK provides typed modal forms and a narrow Components V2 layout model. Once a response uses
 that layout model, Discord requires every later edit of the same message to remain a layout.
 Modules using them should require
 `discord.modals.v1` and/or `discord.components_v2.v1`.
 
-Version 1.3 adds cached author classification to message-deletion events:
+Message-deletion events include cached author classification:
 `MessageDeleteEvent.author_is_bot` and `MessageBulkDeleteEvent.bot_message_ids`.
 The values remain unknown for messages that were absent from Discord's cache.
 
-Version 2 requires an explicit, source-pinned `ModuleSpec.api_version`, and
-removes the temporary guild-settings legacy flag and module table aliases.
-Modules must use namespaced guild documents and migrate legacy tables to the
-physical names returned by `ctx.storage.table()` before upgrading.
+SDK 2.1 adds `ModuleToolContext.trigger_discord_message_id`. Mention-path tool
+calls receive the exact source Discord message snowflake; other surfaces receive
+`None`. Modules that act on a user's source message should require
+`kimi-agent-module-api>=2.1,<3`, reject `None`, fetch that exact message through
+`ctx.discord`, and verify its author before acting.
+
+Modules use namespaced guild documents and the physical table names returned
+by `ctx.storage.table()`.
 
 ## Testing the SDK
 

{kimi_agent_module_api-2.0.0 → kimi_agent_module_api-2.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kimi-agent-module-api"
-version = "2.0.0"
+version = "2.1.0"
 description = "Stable contracts for community-built assistant modules"
 requires-python = ">=3.14"
 authors = [{ name = "Webhead" }]

{kimi_agent_module_api-2.0.0 → kimi_agent_module_api-2.1.0}/src/kimi_agent_module_api/tools.py

@@ -29,6 +29,9 @@ class ModuleToolContext:
     trust_tier: TrustTier
     # Operator per-tool configuration from ``<CONFIG_DIR>/tools/<tool>.md``.
     tool_configs: Mapping[str, Mapping[str, Any]] = field(default_factory=dict)
+    # Discord message that initiated this model turn. It is absent for personal
+    # app commands and other surfaces that are not rooted in a Discord message.
+    trigger_discord_message_id: int | None = None
 
 
 type ModuleToolHandler = Callable[[dict[str, Any], ModuleToolContext], Coroutine[Any, Any, str]]

{kimi_agent_module_api-2.0.0 → kimi_agent_module_api-2.1.0/src/kimi_agent_module_api.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kimi-agent-module-api
-Version: 2.0.0
+Version: 2.1.0
 Summary: Stable contracts for community-built assistant modules
 Author: Webhead
 License-Expression: MIT
@@ -69,23 +69,27 @@ documents installation, declarations, lifecycle, and every runtime port. The
 [reference module](https://github.com/webhead2oo9/kimi-agent/tree/main/bot/modules/example)
 is a complete, commented example that exercises most ports; start there.
 
-Guild-scoped live command replacement was added in 1.1. Modules using
+Modules using guild-scoped live command replacement through
 `InteractionRouter.replace_guild_commands()` should require the host capability
 `discord.guild_commands.v1`.
 
-Version 1.2 adds typed modal forms and a narrow Components V2 layout model. Once a response uses
+The SDK provides typed modal forms and a narrow Components V2 layout model. Once a response uses
 that layout model, Discord requires every later edit of the same message to remain a layout.
 Modules using them should require
 `discord.modals.v1` and/or `discord.components_v2.v1`.
 
-Version 1.3 adds cached author classification to message-deletion events:
+Message-deletion events include cached author classification:
 `MessageDeleteEvent.author_is_bot` and `MessageBulkDeleteEvent.bot_message_ids`.
 The values remain unknown for messages that were absent from Discord's cache.
 
-Version 2 requires an explicit, source-pinned `ModuleSpec.api_version`, and
-removes the temporary guild-settings legacy flag and module table aliases.
-Modules must use namespaced guild documents and migrate legacy tables to the
-physical names returned by `ctx.storage.table()` before upgrading.
+SDK 2.1 adds `ModuleToolContext.trigger_discord_message_id`. Mention-path tool
+calls receive the exact source Discord message snowflake; other surfaces receive
+`None`. Modules that act on a user's source message should require
+`kimi-agent-module-api>=2.1,<3`, reject `None`, fetch that exact message through
+`ctx.discord`, and verify its author before acting.
+
+Modules use namespaced guild documents and the physical table names returned
+by `ctx.storage.table()`.
 
 ## Testing the SDK
 

{kimi_agent_module_api-2.0.0 → kimi_agent_module_api-2.1.0}/tests/test_contracts.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+from importlib.metadata import version
 import dataclasses
 from typing import Any
 
@@ -82,6 +83,10 @@ def test_spec_and_runtime_context_keep_stable_defaults() -> None:
     assert {"events", "scheduler", "storage", "discord", "interactions", "services"} <= required
 
 
+def test_distribution_version_includes_trigger_message_contract() -> None:
+    assert version("kimi-agent-module-api") == "2.1.0"
+
+
 def test_spec_requires_an_explicit_keyword_api_version() -> None:
     def create(_ctx: ModuleLoadContext) -> AppModule:
         raise AssertionError("not called")