* A 2D path representation. The class provides methods for creating paths * and contours of 2D shapes similar to the 2D Canvas API. * * ```js * co

错误结果 包装错误信息，支持链式操作和 pattern matching。 Attributes: error: 错误对象（通常是 Exception） code: 错误码 message: 可选的错误消息

Base error for all SDK v2 failures.

成功结果 包装成功的返回值，支持链式操作和 pattern matching。 Attributes: value: 成功的值 Example: >>> result = Ok(42) >>> re

Failed result value.

Transport/runtime boundary failure (RPC, bus, capability unavailable).

Successful result value.

In-memory per-character topic pool prepared by background work.

Manages per-character persona files with dynamic entity sections. Core entities: 'master', 'neko', 'relationship'. Storage is entity-agnostic

Streaming filter for provider-emitted tool-call markup in assistant text.

Manages raw fact extraction, deduplication, and persistence.

SQLite main store with JSON import/export support for seeds and backups.

Canonical, provider-agnostic tool description. ``parameters`` is an OpenAI-flavoured JSON Schema object (``{"type": "object", "properties": {

One character's voice, as two orthogonal dimensions + a ref + optional config. Frozen so it can be passed around dispatch without aliasing surpri

Resolved activity tracker preferences. All fields have safe defaults — accessing the dataclass when ``user_preferences.json`` is missing or e

Raised for trigger/commit problems the router should translate to HTTP. Attributes ---------- code Stable machine-readable error

Request model for connectivity testing. Two modes: 1. Built-in provider: provide provider_key + provider_scope + api_key. Backend reso

Minimal stand-in for EmbeddingService used by recall tests. The reranker only touches a handful of methods; keep the stub narrow so tests stay

Synthesizes facts into reflections and manages the pending → confirmed lifecycle.

Outcome of executing a ``ToolCall``.

最小 OmniOfflineClient 替身。``prompt_ephemeral`` 行为由测试注入。 继承自 ``OmniOfflineClient`` 以通过 ``isinstance(...)`` 分支；跳过父类 ``__init__`` 避免拉起真实 LLM 客户端。

Raised for any recoverable save/load/import failure. Carries a ``code`` string that the router maps to HTTP status: - ``InvalidName``

Throttle study events and forward them through push_message v2.

Stateful classifier — one instance per ``UserActivityTracker``. All update methods are synchronous (no awaits) so they're safe to call from a

Config file manager

Per-session Focus signal scorer. Cheap, synchronous, no I/O.

登录失败错误

Stand-in for ``GameAgentClient`` — captures send_task calls and lets the test drive on_task_finished from the outside.

Outcome of classifying one observation. ``category`` is the broad bucket the tracker reasons over; subcategory and canonical are the specific

Per-character append-only event journal with reconciliation support. Public API is dual (sync + async twins). Sync methods are safe to call f

One entry in the detection library. ``regex`` is compiled once at module load. ``category`` groups hits for the UI (e.g., show a single "Chat

Slow evidence store, scoped per character. The in-memory view may be backed by a small local-state JSON file so short restart loops merge int

Rule-based V1 voice filter for study self-talk. The class is intentionally independent from the plugin runtime. Phase 9's SDK voice bridge ca

米家API基类异常

Jukebox configuration manager.

Event-driven state machine for a single ``(lanlan_name, user)`` session. The write path (``fire``) holds ``_write_lock``; the read path (``is

跨 chunk 安全的 TTS 文本规范化器。 Gemini Live 等 realtime 后端的 output transcript 会在中文 token 之间 插入 ASCII 空格（"你 好 世 界"），MiniMax / CosyVoice 等 streaming

Input validation failure (bad arguments, config schema, filter syntax, etc.).

Bridge-internal structured error. Carries a stable ``code`` so the front-end can reliably switch on error type (R10.1) plus a human-readable