excuse tool

sorryhyun · sorryhyun · commit 6a84c49aaf17 · 2026-02-17T19:10:58.000+09:00
diff --git a/.env.example b/.env.example
@@ -85,6 +85,10 @@ DEBUG_AGENTS=false
 FRONTEND_URL=https://chitchats-iota.vercel.app/
 # Vercel automatically sets VERCEL_URL environment variable
 # Default allowed origins: localhost:5173, localhost:5174
+# Community Features
+# Set to "true" to enable community social tools (Moltbook)
+ENABLE_COMMUNITY=false
+
 EXPERIMENTAL_ASSISTANT_PRIMING=false # it's problematic so make this as false plz
 
 # Codex App Server Mode
diff --git a/backend/chatroom_orchestration/handlers.py b/backend/chatroom_orchestration/handlers.py
@@ -31,6 +31,7 @@ async def save_agent_message(context: MessageContext, message_data: AgentMessage
         agent_id=context.agent.id,
         thinking=message_data.thinking if message_data.thinking else None,
         anthropic_calls=message_data.anthropic_calls if message_data.anthropic_calls else None,
+        excuse_reasons=message_data.excuse_reasons if message_data.excuse_reasons else None,
     )
     # Update room activity for agent messages so unread notifications appear
     saved_msg = await crud.create_message(context.db, context.room_id, agent_message, update_room_activity=True)
diff --git a/backend/core/manager.py b/backend/core/manager.py
@@ -382,7 +382,7 @@ async def generate_sdk_response(self, context: AgentResponseContext) -> AsyncIte
             base_options = AIClientOptions.from_context(context, final_system_prompt, provider_type)
 
             # Build provider-specific options with tool capture hooks
-            options = provider.build_options(base_options, accumulator.anthropic_calls, accumulator.skip_tool_capture)
+            options = provider.build_options(base_options, accumulator.anthropic_calls, accumulator.skip_tool_capture, accumulator.excuse_reasons)
 
             # Build the message content using helper
             message_to_send = self._build_message_content(context)
diff --git a/backend/core/response_generator.py b/backend/core/response_generator.py
@@ -154,6 +154,7 @@ async def generate_response(
         new_session_id = session_id
         memory_entries = []
         anthropic_calls = []
+        excuse_reasons = []
         skipped = False
         stream_started = False
         end_event = None  # Store the end event for later SSE broadcast
@@ -179,6 +180,7 @@ async def generate_response(
                         new_session_id = end.session_id or session_id
                         memory_entries = end.memory_entries
                         anthropic_calls = end.anthropic_calls
+                        excuse_reasons = end.excuse_reasons
                         skipped = end.skipped
 
         except SessionRecoveryError as e:
@@ -237,6 +239,7 @@ async def generate_response(
                         new_session_id = end.session_id or session_id
                         memory_entries = end.memory_entries
                         anthropic_calls = end.anthropic_calls
+                        excuse_reasons = end.excuse_reasons
                         skipped = end.skipped
 
         # Memory entries are now written directly by the memorize tool
@@ -317,6 +320,7 @@ async def broadcast_stream_end(is_skipped: bool):
             content=response_text,
             thinking=thinking_text,
             anthropic_calls=anthropic_calls if anthropic_calls else None,
+            excuse_reasons=excuse_reasons if excuse_reasons else None,
         )
         await save_agent_message(msg_context, message_data)
 
diff --git a/backend/core/settings.py b/backend/core/settings.py
@@ -106,6 +106,10 @@ class Settings(BaseSettings):
     # Voice server configuration
     voice_server_url: str = "http://localhost:8002"  # Voice TTS server URL
 
+    # Tool toggles
+    enable_excuse: bool = True  # Enable excuse tool for agents
+    enable_community: bool = False  # Enable community social tools (Moltbook)
+
     # Moltbook API configuration
     moltbook_api_key: Optional[str] = None  # API key for Moltbook social network
 
diff --git a/backend/crud/messages.py b/backend/crud/messages.py
@@ -49,6 +49,7 @@ async def create_message(
         participant_type=message.participant_type,
         participant_name=message.participant_name,
         thinking=message.thinking,
+        excuse_reasons=json.dumps(message.excuse_reasons) if message.excuse_reasons else None,
         images=images_json,  # Store as JSON string
         # Keep deprecated fields for backward compatibility during transition
         image_data=message.image_data,
diff --git a/backend/domain/contexts.py b/backend/domain/contexts.py
@@ -49,6 +49,7 @@ class AgentMessageData:
     content: str
     thinking: Optional[str] = None
     anthropic_calls: Optional[list[str]] = None
+    excuse_reasons: Optional[list[str]] = None
 
 
 @dataclass
diff --git a/backend/domain/streaming.py b/backend/domain/streaming.py
@@ -69,6 +69,7 @@ class StreamEndEvent:
     memory_entries: list[str]
     anthropic_calls: list[str]
     skipped: bool
+    excuse_reasons: list[str] = field(default_factory=list)
 
     def to_dict(self) -> dict:
         """Convert to dict for backward compatibility with existing consumers."""
@@ -81,6 +82,7 @@ def to_dict(self) -> dict:
             "memory_entries": self.memory_entries,
             "anthropic_calls": self.anthropic_calls,
             "skipped": self.skipped,
+            "excuse_reasons": self.excuse_reasons,
         }
 
 
@@ -106,6 +108,7 @@ class ResponseAccumulator:
     skip_tool_called: bool = False
     memory_entries: list[str] = field(default_factory=list)
     anthropic_calls: list[str] = field(default_factory=list)
+    excuse_reasons: list[str] = field(default_factory=list)
     # Hook capture lists - these get mutated by PostToolUse hooks
     skip_tool_capture: list[bool] = field(default_factory=list)
 
@@ -207,6 +210,7 @@ def create_end_event(
             memory_entries=self.memory_entries,
             anthropic_calls=self.anthropic_calls,
             skipped=skipped,
+            excuse_reasons=self.excuse_reasons,
         )
 
     def create_interrupted_end_event(
diff --git a/backend/infrastructure/database/migrations.py b/backend/infrastructure/database/migrations.py
@@ -148,6 +148,7 @@ async def _migrate_messages_table(conn):
         ("image_data", "TEXT", None),
         ("image_media_type", "VARCHAR", None),
         ("anthropic_calls", "TEXT", None),
+        ("excuse_reasons", "TEXT", None),  # JSON array of excuse tool reasons
         ("images", "TEXT", None),  # JSON array for multiple images
         ("provider", "VARCHAR", None),  # v9: AI provider used ('claude' or 'codex')
     ]
diff --git a/backend/infrastructure/database/models.py b/backend/infrastructure/database/models.py
@@ -135,6 +135,7 @@ class Message(Base):
     participant_name = Column(String, nullable=True)  # Custom name for 'character' mode
     thinking = Column(Text, nullable=True)  # Agent's thinking process (for assistant messages)
     anthropic_calls = Column(Text, nullable=True)  # JSON array of anthropic tool call situations
+    excuse_reasons = Column(Text, nullable=True)  # JSON array of excuse tool reasons
     timestamp = Column(DateTime, default=datetime.utcnow)
     image_data = Column(Text, nullable=True)  # DEPRECATED: Use images column instead
     image_media_type = Column(String, nullable=True)  # DEPRECATED: Use images column instead
diff --git a/backend/mcp_servers/action_server.py b/backend/mcp_servers/action_server.py
@@ -150,6 +150,9 @@ async def call_tool(name: str, arguments: dict):
         elif name == "recall":
             return _handle_recall(arguments, context)
 
+        elif name == "excuse":
+            return _handle_excuse(arguments, context)
+
         else:
             return [TextContent(type="text", text=f"Unknown tool: {name}")]
 
@@ -269,6 +272,26 @@ def _handle_recall(arguments: dict, context: dict) -> list[TextContent]:
     return [TextContent(type="text", text=response_text)]
 
 
+def _handle_excuse(arguments: dict, context: dict) -> list[TextContent]:
+    """Handle excuse tool call."""
+    reason = arguments.get("reason", "")
+
+    if not reason.strip():
+        return [TextContent(type="text", text="Error: Reason cannot be empty")]
+
+    agent_name = context["agent_name"]
+    agent_group = context["agent_group"]
+    logger.info(f"[excuse] {agent_name}: {reason}")
+
+    response_text = get_tool_response(
+        "excuse",
+        group_name=agent_group,
+        agent_name=agent_name,
+        reason=reason,
+    )
+    return [TextContent(type="text", text=response_text)]
+
+
 # =============================================================================
 # Helper Functions
 # =============================================================================
diff --git a/backend/mcp_servers/config/tools.py b/backend/mcp_servers/config/tools.py
@@ -58,6 +58,24 @@ def validate_subtitle(cls, v: str) -> str:
         return v.strip()
 
 
+class ExcuseInput(BaseModel):
+    """Input model for excuse tool."""
+
+    reason: str = Field(
+        ...,
+        min_length=1,
+        description="The agent's authentic inner reaction — raw feelings before composing outward behavior",
+    )
+
+    @field_validator("reason")
+    @classmethod
+    def validate_reason(cls, v: str) -> str:
+        """Ensure reason is not just whitespace."""
+        if not v.strip():
+            raise ValueError("Reason cannot be empty or whitespace")
+        return v.strip()
+
+
 class GuidelinesReadInput(BaseModel):
     """Input model for guidelines read tool - takes no arguments."""
 
@@ -200,8 +218,10 @@ class ToolDef:
         name="mcp__action__skip",
         group="action",
         description=(
-            "Skip this turn when {agent_name} has left the scene or the message "
-            "doesn't warrant {agent_name}'s engagement. Others will continue without you."
+            "Skip this turn entirely — {agent_name} produces no response. "
+            "Use only when {agent_name} has genuinely nothing to add: "
+            "left the scene, not addressed, or the message is irrelevant to {agent_name}. "
+            "Do not use skip to avoid difficult topics; consider excuse instead."
         ),
         response="You have decided to skip this message. You will not respond.",
         input_model=SkipInput,
@@ -226,6 +246,24 @@ class ToolDef:
         input_model=RecallInput,
         requires=["memory_index"],
     ),
+    "excuse": ToolDef(
+        name="mcp__action__excuse",
+        group="action",
+        description=(
+            "Record {agent_name}'s authentic inner reaction before composing the outward response. "
+            "Use this when {agent_name}'s true feelings differ from how they would outwardly behave — "
+            "e.g. genuinely embarrassed but would act composed, secretly pleased but would feign indifference, "
+            "actually hurt but would deflect with humor. "
+            "The excuse captures the raw first reaction; the visible message should show {agent_name}'s "
+            "composed outward behavior that CONTRASTS with or MASKS the inner reaction."
+        ),
+        response=(
+            "Inner reaction noted: {reason}\n\n"
+            "Now write {agent_name}'s outward response — the composed behavior that follows this reaction. "
+            "Do not echo or blend the inner reaction into the visible message; let the contrast speak for itself."
+        ),
+        input_model=ExcuseInput,
+    ),
     # Guidelines Tools
     "read": ToolDef(
         name="mcp__guidelines__read",
@@ -304,6 +342,28 @@ def get_tools_by_group(group: str) -> dict[str, ToolDef]:
     return {name: tool for name, tool in TOOLS.items() if tool.group == group}
 
 
+def _is_tool_setting_enabled(tool_name: str) -> bool:
+    """Check if a tool is enabled via environment settings.
+
+    Some tools can be toggled on/off via env vars (e.g., ENABLE_EXCUSE).
+
+    Args:
+        tool_name: Name of the tool
+
+    Returns:
+        True if the tool is enabled (or has no env toggle)
+    """
+    if tool_name == "excuse":
+        from core import get_settings
+
+        return get_settings().enable_excuse
+    if tool_name == "moltbook":
+        from core import get_settings
+
+        return get_settings().enable_community
+    return True
+
+
 def is_tool_enabled(
     tool_name: str,
     group_name: str | None = None,
@@ -323,6 +383,10 @@ def is_tool_enabled(
     if tool_name not in TOOLS:
         return False
 
+    # Check env-level toggle
+    if not _is_tool_setting_enabled(tool_name):
+        return False
+
     tool = _get_tool_with_overrides(tool_name, group_name)
 
     # Check if enabled
@@ -425,9 +489,12 @@ def get_tool_names_by_group(group: str, enabled_only: bool = True) -> list[str]:
         List of full MCP tool names (e.g., ["mcp__action__skip"])
     """
     result = []
-    for tool in get_tools_by_group(group).values():
+    for name, tool in get_tools_by_group(group).items():
         if enabled_only and not tool.enabled:
             continue
+        # Check env-level toggle (e.g., ENABLE_EXCUSE)
+        if enabled_only and not _is_tool_setting_enabled(name):
+            continue
         result.append(tool.name)
     return result
 
diff --git a/backend/providers/base.py b/backend/providers/base.py
@@ -85,6 +85,7 @@ class ParsedStreamMessage:
     skip_used: bool = False
     memory_entries: List[str] = field(default_factory=list)
     anthropic_calls: List[str] = field(default_factory=list)
+    excuse_reasons: List[str] = field(default_factory=list)
 
     @property
     def has_tool_usage(self) -> bool:
@@ -378,13 +379,15 @@ def build_options(
         base_options: AIClientOptions,
         anthropic_calls_capture: Optional[List[str]] = None,
         skip_tool_capture: Optional[List[bool]] = None,
+        excuse_reasons_capture: Optional[List[str]] = None,
     ) -> Any:
         """Build provider-specific options from base configuration.
 
         Args:
             base_options: Provider-agnostic configuration
             anthropic_calls_capture: List to capture anthropic tool calls
             skip_tool_capture: List to capture skip tool usage
+            excuse_reasons_capture: List to capture excuse tool reasons
 
         Returns:
             Provider-specific options object
diff --git a/backend/providers/claude/provider.py b/backend/providers/claude/provider.py
@@ -142,13 +142,15 @@ def build_options(
         base_options: AIClientOptions,
         anthropic_calls_capture: Optional[List[str]] = None,
         skip_tool_capture: Optional[List[bool]] = None,
+        excuse_reasons_capture: Optional[List[str]] = None,
     ) -> ClaudeAgentOptions:
         """Build Claude SDK options from base configuration.
 
         Args:
             base_options: Provider-agnostic configuration
             anthropic_calls_capture: List to capture anthropic tool calls
             skip_tool_capture: List to capture skip tool usage
+            excuse_reasons_capture: List to capture excuse tool reasons
 
         Returns:
             ClaudeAgentOptions ready for client creation
@@ -178,7 +180,7 @@ def build_options(
         ]
 
         # Create PostToolUse hooks
-        hooks = self._build_tool_capture_hooks(anthropic_calls_capture, skip_tool_capture)
+        hooks = self._build_tool_capture_hooks(anthropic_calls_capture, skip_tool_capture, excuse_reasons_capture)
 
         # Determine model
         model = base_options.model
@@ -238,6 +240,7 @@ def _build_tool_capture_hooks(
         self,
         anthropic_calls_capture: Optional[List[str]],
         skip_tool_capture: Optional[List[bool]],
+        excuse_reasons_capture: Optional[List[str]] = None,
     ) -> Optional[dict]:
         """Build PostToolUse hooks for capturing tool calls."""
         hook_matchers = []
@@ -279,6 +282,26 @@ async def capture_skip_tool(
 
             hook_matchers.append(HookMatcher(matcher="mcp__action__skip", hooks=[capture_skip_tool]))
 
+        # Hook for excuse tool calls
+        if excuse_reasons_capture is not None:
+
+            async def capture_excuse_tool(
+                input_data: PostToolUseHookInput,
+                _tool_use_id: Optional[str],
+                _ctx: dict,
+            ) -> SyncHookJSONOutput:
+                """Hook to capture excuse tool calls."""
+                tool_name = input_data.get("tool_name", "")
+                if tool_name.endswith("__excuse"):
+                    tool_input = input_data.get("tool_input", {})
+                    reason = tool_input.get("reason", "")
+                    if reason:
+                        excuse_reasons_capture.append(reason)
+                        logger.info(f"Captured excuse tool call: {reason[:100]}...")
+                return {"continue_": True}
+
+            hook_matchers.append(HookMatcher(matcher="mcp__action__excuse", hooks=[capture_excuse_tool]))
+
         if not hook_matchers:
             return None
 
diff --git a/backend/providers/codex/provider.py b/backend/providers/codex/provider.py
@@ -126,13 +126,15 @@ def build_options(
         base_options: AIClientOptions,
         anthropic_calls_capture: Optional[List[str]] = None,
         skip_tool_capture: Optional[List[bool]] = None,
+        excuse_reasons_capture: Optional[List[str]] = None,
     ) -> CodexAppServerOptions:
         """Build Codex App Server options from base configuration.
 
         Args:
             base_options: Provider-agnostic configuration
             anthropic_calls_capture: Not used for Codex (tool capture via parsing)
             skip_tool_capture: Not used for Codex (tool capture via parsing)
+            excuse_reasons_capture: Not used for Codex (tool capture via parsing)
 
         Returns:
             CodexAppServerOptions ready for client creation
@@ -146,6 +148,7 @@ def build_options(
         # Unused parameters (tool capture is done via stream parsing)
         _ = anthropic_calls_capture
         _ = skip_tool_capture
+        _ = excuse_reasons_capture
 
         # Build agent key for instance identification
         agent_id = base_options.mcp_tools.get("agent_id") if base_options.mcp_tools else None
diff --git a/backend/schemas/message.py b/backend/schemas/message.py
diff --git a/frontend/src/components/chat-room/message-list/MessageRow.tsx b/frontend/src/components/chat-room/message-list/MessageRow.tsx
diff --git a/frontend/src/types/index.ts b/frontend/src/types/index.ts

Original file line number	Diff line number	Diff line change
`@@ -31,6 +31,7 @@ async def save_agent_message(context: MessageContext, message_data: AgentMessage`
`31`	`31`	`agent_id=context.agent.id,`
`32`	`32`	`thinking=message_data.thinking if message_data.thinking else None,`
`33`	`33`	`anthropic_calls=message_data.anthropic_calls if message_data.anthropic_calls else None,`
	`34`	`+ excuse_reasons=message_data.excuse_reasons if message_data.excuse_reasons else None,`
`34`	`35`	`)`
`35`	`36`	`# Update room activity for agent messages so unread notifications appear`
`36`	`37`	`saved_msg = await crud.create_message(context.db, context.room_id, agent_message, update_room_activity=True)`
Original file line number	Diff line number	Diff line change
`@@ -148,6 +148,7 @@ async def _migrate_messages_table(conn):`
`148`	`148`	`("image_data", "TEXT", None),`
`149`	`149`	`("image_media_type", "VARCHAR", None),`
`150`	`150`	`("anthropic_calls", "TEXT", None),`
	`151`	`+ ("excuse_reasons", "TEXT", None), # JSON array of excuse tool reasons`
`151`	`152`	`("images", "TEXT", None), # JSON array for multiple images`
`152`	`153`	`("provider", "VARCHAR", None), # v9: AI provider used ('claude' or 'codex')`
`153`	`154`	`]`