mirror of
https://github.com/NCBM/plyngent.git
synced 2026-11-07 15:37:55 +08:00
NCBM
729627eee9
doc/turns-and-rounds.md defines the two nested units the loop is built on: a round is one request→response plus the tool batch it asked for, a turn is one user message through the explicit stop (0..N rounds), and a session is a stored sequence of turns. It records what bounds each unit (max_rounds, truncation continues, retries), which work is round-scoped (request assembly, context reduction, the aggregated soft confirm) and which state resets per turn (read-before-edit, yyy auto-continue, /yolo once, the todo touched flag, usage totals) versus what outlives it (rows, todo stack, grants, reminder bands). Linked from the architecture doc, with the short version in AGENTS.md.
43 lines
2.4 KiB
Markdown
43 lines
2.4 KiB
Markdown
# Code Architecture
|
|
|
|
- plyngent
|
|
- typedef: Shared type aliases.
|
|
- lmproto: Protocols for interacting with LLM service.
|
|
- (common)
|
|
- model: Messages models of specified providers.
|
|
- config: Configurations for specified providers.
|
|
- client: Clients for accessing existent specified services.
|
|
- server: Servers for accepting other clients.
|
|
- openai_compatible: Chat Completions base (``kind=chat_completions``).
|
|
- openai: Platform Responses + chat (``kind=responses``).
|
|
- anthropic: Messages API (``kind=messages``).
|
|
- deepseek
|
|
- openai_compat (``kind=chat_completions``)
|
|
- responses (``kind=responses``; DeepSeek Responses API)
|
|
- anthropic (``kind=messages``; DeepSeek Anthropic-compatible API on
|
|
``https://api.deepseek.com/anthropic``)
|
|
- utils: Common utilities for code architecture.
|
|
- components: Utilities for class composition.
|
|
- memory: Storage controlling for sessions and messages.
|
|
- config: Plyngent configuration center (TOML), including ``[plugins]`` and
|
|
``[networking]`` (e.g. fetch SSRF Fake-IP CIDR exemptions). Model entries
|
|
may override provider ``preset`` / ``url`` for mixed API routing.
|
|
``[skills]`` holds the skill roots, discovery sources, catalog limits, and
|
|
the standing write grant.
|
|
- runtime: ``create_client`` maps effective provider preset → protocol client.
|
|
- skills: Skill discovery (ordered roots, ``SKILL.md`` frontmatter subset,
|
|
mtime-cached store) and the read/write path rules the tools use.
|
|
- agent: Kind-based tool loop, streaming, usage, compact; bridges:
|
|
``responses_bridge``/``responses_dispatch``, ``messages_bridge``/``messages_dispatch``;
|
|
``@tool`` / tags / registry. History stays chat-completions-shaped.
|
|
- tools: Workspace file/process/VCS/chat/todo/net/skill tools + directory-access
|
|
grants (`access`); catalog; plugins; instance/session context and views.
|
|
- prompting: Shared ask/choose/form for CLI and tools.
|
|
- cli: Click entry, slash registry, REPL, one-shot chat.
|
|
- web: Web service (Phase H; not implemented).
|
|
|
|
Plugins (third-party entry points, allowlisted under ``[plugins]``): [plugins.md](./plugins.md).
|
|
Conversation units (a *round* = one request→response plus its tool batch, a
|
|
*turn* = a user message to the explicit stop): [turns-and-rounds.md](./turns-and-rounds.md).
|
|
|