mirror of https://github.com/Darkatse/TauriTavern.git synced 2026-10-19 15:45:12 +00:00

Darkatse 528b3b51c5 feat(agent): Add Phase 2A tool loop foundation

- Implement the minimal Rust-owned agent tool loop with workspace write and
finish tools, prompt snapshot execution, checkpoints, run events, and commit
preparation/finalization.

- Add the frontend dry-run prompt snapshot adapter and explicit agent start
entrypoints for legacy Generate integration and manual prompt snapshots. Keep
legacy Generate and ToolManager behavior unchanged outside agent mode.

- Document the Phase 2A contract, current limitations, workspace layout, event
flow, and manual smoke-test workflow.

2026-04-26 19:58:26 -04:00

2.7 KiB

Raw Blame History

TauriTavern Extension APIs

TauriTavern 专属扩展 API 的统一入口是 window.__TAURITAVERN__.api。

这套 API 的目标不是把上游内部实现直接摊给扩展，而是把真正值得长期承诺的平台能力，整理成小而稳定的宿主 ABI。

入口

await (window.__TAURITAVERN__?.ready ?? window.__TAURITAVERN_MAIN_READY__);

const host = window.__TAURITAVERN__;
const api = host?.api;

API 分区

api.chat
- 面向记忆类 / 数据库 / 检索类扩展。
- 提供跨窗口聊天访问、全文检索、per-chat store、metadata、历史分页等能力。
api.layout
- 面向移动端 UI/面板/悬浮窗/iframe 等需要对齐 safe-area/viewport/IME 的扩展。
- 提供布局契约快照与订阅，并配合 data-tt-mobile-surface taxonomy 实现少量 opt-in 即稳定适配。
api.dev
- 面向调试、诊断与开发工具。
- 提供前端日志、后端日志、LLM API 日志的统一宿主入口。
api.worldInfo
- 面向角色卡作者与世界书相关扩展。
- 提供最近一次激活结果、实时订阅与 best-effort 条目跳转。
api.extension.store
- 面向需要全局持久化的扩展（不绑定 chat）。
- 提供 Extension KV JSON + Blob 存储，支持多 table。
api.agent（Phase 2A 已落地最小工具循环）
- 面向 Agent Run / timeline / workspace / checkpoint / commit。
- 当前提供启动 run、订阅/读取事件、取消、读取 workspace 文件、prepare/finalize/commit。
- approval、listRuns、readDiff、rollback 仍是后续阶段；当前入口显式 throw。
api.mcp（规划中）
- 面向 MCP server/tool/resource/prompt 的独立平台能力。
- Agent 可以消费 MCP，但 MCP 不依附 Agent Mode。

文档

文档	内容
Chat.md	`api.chat` 完整参考
Layout.md	`api.layout` 完整参考（safe-area/viewport/IME）
Dev.md	`api.dev` 完整参考
WorldInfo.md	`api.worldInfo` 完整参考
ExtensionStore.md	`api.extension.store` 完整参考
Agent.md	`api.agent` 草案（Agent Run / workspace / timeline）
MCP.md	`api.mcp` 草案（MCP server/tool/resource/prompt）
Migration.md	从 SillyTavern 扩展迁移到 TauriTavern 的适配指南

契约说明

API 类型定义见 src/types.d.ts
宿主契约与稳定性边界见 docs/FrontendHostContract.md
Agent Phase 2A 已落地最小 Host ABI；当前真实边界见 docs/API/Agent.md 与 docs/CurrentState/AgentFramework.md
MCP 仍处于规划阶段；实现前请以 docs/API/MCP.md 与 docs/FrontendHostContract.md 的草案约束为准

2.7 KiB Raw Blame History Unescape Escape

TauriTavern Extension APIs

入口

API 分区

文档

契约说明

2.7 KiB

Raw Blame History