Metadata-Version: 2.4
Name: liteyukibot-v7-agent
Version: 0.1.0a9
Summary: Native OpenAI-compatible agent harness for LiteyukiBot v7.
Author: LiteyukiStudio
License-Expression: LicenseRef-LSO
Requires-Dist: liteyukibot-v7>=7.0.0a17,<8
Requires-Dist: liteyukibot-v7-commands>=0.2.0a2,<0.3
Requires-Dist: liteyukibot-v7-agent-resolver>=0.1.0a1,<0.2
Requires-Dist: openai>=2,<3
Requires-Python: >=3.14
Description-Content-Type: text/markdown

# LiteyukiBot Native Agent

The native agent is an agent-only LiteyukiBot v7 runtime. It receives normalized
events from source runtimes and emits ordinary actions back to those sources.
It uses the official OpenAI Python SDK with an OpenAI-compatible endpoint.

For each delivered Event, the kernel sends only the tool schemas authorized for
that event principal. The agent runtime has no executable tool implementation;
every tool request returns through the kernel broker, which checks the same
capabilities again before invoking a package-provided handler.

The `agent` runtime options bound each delivered event: `history_limit` defaults
to 40 messages and is also the maximum retained SQLite history per source
runtime, bot, and conversation. Retention is applied on every write; changing
the limit only affects subsequent writes. `max_concurrent_events` defaults to 16, `max_tool_rounds` to 4,
`model_timeout_seconds` to 60, and `event_timeout_seconds` to 120. A model or
event timeout produces a failed terminal delivery without recording model input,
tool arguments, or response content in logs.

When the Commands and Permissions plugins are enabled, operators may grant
`liteyukibot.agent.history.clear` to expose `/agent forget`. The command is
handled by the kernel, sends one protocol-v5 control request to the native
Agent child, and clears only the requesting source runtime, bot, and
conversation. It never sends a model request and the permission audit contains
no conversation content.
