starweaver 0.3.0__tar.gz

starweaver-0.3.0/Cargo.toml

@@ -0,0 +1,100 @@
+[workspace]
+members = [
+    "crates/starweaver-cli",
+    "crates/starweaver-rpc",
+    "crates/starweaver-rpc-core",
+    "crates/starweaver-agent",
+    "crates/starweaver-context",
+    "crates/starweaver-core",
+    "crates/starweaver-model",
+    "crates/starweaver-oauth",
+    "crates/starweaver-oauth-provider",
+    "crates/starweaver-runtime",
+    "crates/starweaver-tools",
+    "crates/starweaver-environment",
+    "crates/starweaver-envd-core",
+    "crates/starweaver-envd",
+    "crates/starweaver-envd-client",
+    "crates/starweaver-session",
+    "crates/starweaver-stream",
+    "crates/starweaver-storage",
+    "crates/starweaver-usage",
+    "xtask",
+]
+exclude = ["packages/starweaver-py"]
+resolver = "2"
+
+[workspace.package]
+version = "0.3.0"
+edition = "2024"
+rust-version = "1.96"
+authors = ["wh1isper"]
+license = "BSD-3-Clause"
+repository = "https://github.com/Wh1isper/starweaver"
+homepage = "https://github.com/Wh1isper/starweaver"
+description = "Rust agent SDK workspace for Starweaver"
+readme = "README.md"
+keywords = ["agent", "sdk", "ai", "runtime"]
+categories = ["development-tools"]
+
+[workspace.dependencies]
+starweaver-agent = { path = "crates/starweaver-agent", version = "0.3.0" }
+starweaver-context = { path = "crates/starweaver-context", version = "0.3.0" }
+starweaver-core = { path = "crates/starweaver-core", version = "0.3.0" }
+starweaver-model = { path = "crates/starweaver-model", version = "0.3.0" }
+starweaver-oauth = { path = "crates/starweaver-oauth", version = "0.3.0" }
+starweaver-oauth-provider = { path = "crates/starweaver-oauth-provider", version = "0.3.0" }
+starweaver-runtime = { path = "crates/starweaver-runtime", version = "0.3.0" }
+starweaver-tools = { path = "crates/starweaver-tools", version = "0.3.0" }
+starweaver-usage = { path = "crates/starweaver-usage", version = "0.3.0" }
+starweaver-environment = { path = "crates/starweaver-environment", version = "0.3.0" }
+starweaver-envd-core = { path = "crates/starweaver-envd-core", version = "0.3.0" }
+starweaver-envd = { path = "crates/starweaver-envd", version = "0.3.0" }
+starweaver-envd-client = { path = "crates/starweaver-envd-client", version = "0.3.0" }
+starweaver-session = { path = "crates/starweaver-session", version = "0.3.0" }
+starweaver-stream = { path = "crates/starweaver-stream", version = "0.3.0" }
+starweaver-storage = { path = "crates/starweaver-storage", version = "0.3.0" }
+starweaver-cli = { path = "crates/starweaver-cli", version = "0.3.0" }
+starweaver-rpc-core = { path = "crates/starweaver-rpc-core", version = "0.3.0" }
+async-trait = "0.1.89"
+chrono = { version = "0.4.42", default-features = false, features = ["clock", "serde", "std"] }
+reqwest = { version = "0.12.24", default-features = false, features = ["json", "rustls-tls", "stream"] }
+serde = { version = "1.0.228", features = ["derive"] }
+serde_json = "1.0.145"
+semver = "1.0.27"
+schemars = { version = "1.2.1", features = ["derive"] }
+globset = "0.4.16"
+grep-matcher = "0.1.8"
+grep-regex = "0.1.14"
+grep-searcher = "0.1.16"
+ignore = "0.4.24"
+jsonschema = { version = "0.33.0", default-features = false }
+yaml_serde = "=0.10.2"
+thiserror = "2.0.17"
+tokio = { version = "1.48.0", features = ["macros", "rt-multi-thread", "net", "signal", "sync", "time"] }
+uuid = { version = "1.18.1", features = ["serde", "v4"] }
+clap = { version = "4.5.51", features = ["derive"] }
+clap_complete = "4.5.61"
+crossterm = "0.28.1"
+pulldown-cmark = "0.10"
+ring = "0.17.14"
+rusqlite = { version = "0.32.1", features = ["bundled", "chrono", "serde_json"] }
+toml = "0.8.23"
+tempfile = "3.23.0"
+unicode-width = "0.2.0"
+base64 = "0.22.1"
+futures-util = "0.3.31"
+tokio-tungstenite = { version = "0.28.0", default-features = false, features = ["connect", "rustls-tls-native-roots"] }
+fs2 = "0.4.3"
+image = { version = "0.25.8", default-features = false, features = ["jpeg", "png", "gif", "webp", "bmp", "ico"] }
+
+[workspace.lints.rust]
+unsafe_code = "forbid"
+missing_docs = "warn"
+
+[workspace.lints.clippy]
+all = "warn"
+pedantic = "warn"
+nursery = "warn"
+unwrap_used = "warn"
+expect_used = "warn"

starweaver-0.3.0/PKG-INFO

@@ -0,0 +1,121 @@
+Metadata-Version: 2.4
+Name: starweaver
+Version: 0.3.0
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: pydantic>=2.0
+Summary: Python bindings for Starweaver
+Keywords: agent,sdk,ai,runtime
+Home-Page: https://github.com/Wh1isper/starweaver
+Author: wh1isper
+Requires-Python: >=3.11, <3.14
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Repository, https://github.com/Wh1isper/starweaver
+
+# Starweaver Python
+
+`starweaver` is the in-process Python SDK and binding package for Starweaver.
+It keeps the Rust runtime as the canonical agent loop while exposing Python
+ergonomics for agents, tools, models, sessions, streams, resources, media, and
+deterministic tests.
+
+Python tools are injected directly as native Starweaver runtime tools. They do
+not use MCP, stdio, or another binary protocol.
+
+Supported Python versions are CPython 3.11 through 3.13. Local development and
+single-version CI jobs default to Python 3.13.
+
+## Quickstart
+
+```python
+import asyncio
+
+from starweaver import create_agent, tool
+from starweaver.testing import TestModel
+
+
+@tool
+async def add(left: int, right: int) -> dict[str, int]:
+    return {"total": left + right}
+
+
+async def main() -> None:
+    model = TestModel.responses(
+        [
+            TestModel.tool_call_response(
+                [{"id": "call_add", "name": "add", "arguments": {"left": 2, "right": 3}}]
+            ),
+            {"text": "done"},
+        ]
+    )
+    result = await create_agent(model=model, tools=[add]).run("Add two numbers")
+    print(result.output)
+
+
+asyncio.run(main())
+```
+
+## Core Surfaces
+
+- `create_agent()` builds a Python facade over the Rust runtime.
+- `@tool`, raw callables, and `BaseTool` register in-process tools.
+- Independent tool calls run in parallel by default; use `sequential=True` for
+  ordered side effects.
+- `Toolset`, `ToolSearchToolset`, and `ToolProxyToolset` compose grouped tools.
+- `ProviderModel`, `TestModel`, and `FunctionModel` cover production providers,
+  deterministic scripts, and callback-backed tests.
+- `OutputSchema`, `OutputPolicy`, validators, and output functions handle final
+  output.
+- `AgentSession` and `SessionArchive` preserve reusable session state.
+- `EnvironmentProvider`, `ResourceRef`, `SkillRegistry`, and `MediaUploader`
+  expose environment, resource, skill, and media boundaries.
+
+## Stream Boundary
+
+`run_stream()` currently returns `AgentRun`, an async iterator over canonical
+`StreamEvent` records plus a Python facade for `recv()`, `join()`, `result()`,
+`status()`, `recoverable_state()`, `interrupt()`, active messages, steering, and
+streamed HITL helpers. The stable portable contract is the canonical
+`StreamEvent.raw` record sequence and collected run result. Python live-control
+ergonomics are the current facade, not a separately frozen live-handle
+protocol.
+
+`AgentStream` remains a compatibility alias for `AgentRun`.
+
+## Documentation
+
+Start with `docs/python-sdk.md` in the repository. The Python docs are organized
+by feature:
+
+- `docs/python/agents.md`
+- `docs/python/tools.md`
+- `docs/python/toolsets.md`
+- `docs/python/models.md`
+- `docs/python/output.md`
+- `docs/python/sessions-streams.md`
+- `docs/python/environments-skills.md`
+- `docs/python/media.md`
+- `docs/python/testing.md`
+- `docs/python/examples.md`
+- `docs/python/stability.md`
+
+Runnable examples live in `examples/python/`.
+
+## Validation
+
+From the repository root:
+
+```bash
+make py-sync
+make py-lint
+make py-rust-check
+make py-test
+make py-check
+```
+

starweaver-0.3.0/README.md

@@ -0,0 +1,100 @@
+# Starweaver Python
+
+`starweaver` is the in-process Python SDK and binding package for Starweaver.
+It keeps the Rust runtime as the canonical agent loop while exposing Python
+ergonomics for agents, tools, models, sessions, streams, resources, media, and
+deterministic tests.
+
+Python tools are injected directly as native Starweaver runtime tools. They do
+not use MCP, stdio, or another binary protocol.
+
+Supported Python versions are CPython 3.11 through 3.13. Local development and
+single-version CI jobs default to Python 3.13.
+
+## Quickstart
+
+```python
+import asyncio
+
+from starweaver import create_agent, tool
+from starweaver.testing import TestModel
+
+
+@tool
+async def add(left: int, right: int) -> dict[str, int]:
+    return {"total": left + right}
+
+
+async def main() -> None:
+    model = TestModel.responses(
+        [
+            TestModel.tool_call_response(
+                [{"id": "call_add", "name": "add", "arguments": {"left": 2, "right": 3}}]
+            ),
+            {"text": "done"},
+        ]
+    )
+    result = await create_agent(model=model, tools=[add]).run("Add two numbers")
+    print(result.output)
+
+
+asyncio.run(main())
+```
+
+## Core Surfaces
+
+- `create_agent()` builds a Python facade over the Rust runtime.
+- `@tool`, raw callables, and `BaseTool` register in-process tools.
+- Independent tool calls run in parallel by default; use `sequential=True` for
+  ordered side effects.
+- `Toolset`, `ToolSearchToolset`, and `ToolProxyToolset` compose grouped tools.
+- `ProviderModel`, `TestModel`, and `FunctionModel` cover production providers,
+  deterministic scripts, and callback-backed tests.
+- `OutputSchema`, `OutputPolicy`, validators, and output functions handle final
+  output.
+- `AgentSession` and `SessionArchive` preserve reusable session state.
+- `EnvironmentProvider`, `ResourceRef`, `SkillRegistry`, and `MediaUploader`
+  expose environment, resource, skill, and media boundaries.
+
+## Stream Boundary
+
+`run_stream()` currently returns `AgentRun`, an async iterator over canonical
+`StreamEvent` records plus a Python facade for `recv()`, `join()`, `result()`,
+`status()`, `recoverable_state()`, `interrupt()`, active messages, steering, and
+streamed HITL helpers. The stable portable contract is the canonical
+`StreamEvent.raw` record sequence and collected run result. Python live-control
+ergonomics are the current facade, not a separately frozen live-handle
+protocol.
+
+`AgentStream` remains a compatibility alias for `AgentRun`.
+
+## Documentation
+
+Start with `docs/python-sdk.md` in the repository. The Python docs are organized
+by feature:
+
+- `docs/python/agents.md`
+- `docs/python/tools.md`
+- `docs/python/toolsets.md`
+- `docs/python/models.md`
+- `docs/python/output.md`
+- `docs/python/sessions-streams.md`
+- `docs/python/environments-skills.md`
+- `docs/python/media.md`
+- `docs/python/testing.md`
+- `docs/python/examples.md`
+- `docs/python/stability.md`
+
+Runnable examples live in `examples/python/`.
+
+## Validation
+
+From the repository root:
+
+```bash
+make py-sync
+make py-lint
+make py-rust-check
+make py-test
+make py-check
+```

starweaver-0.3.0/crates/starweaver-agent/Cargo.toml

@@ -0,0 +1,55 @@
+[package]
+name = "starweaver-agent"
+version.workspace = true
+edition.workspace = true
+rust-version.workspace = true
+authors.workspace = true
+license.workspace = true
+repository.workspace = true
+homepage.workspace = true
+description = "Ergonomic agent SDK facade for Starweaver"
+readme = "README.md"
+keywords.workspace = true
+categories.workspace = true
+
+[[bin]]
+name = "starweaver_agent_rmcp_stdio_fixture"
+path = "tests/fixtures/rmcp_stdio_server.rs"
+test = false
+bench = false
+doc = false
+
+[dependencies]
+base64.workspace = true
+async-trait.workspace = true
+chrono.workspace = true
+image.workspace = true
+serde.workspace = true
+serde_json.workspace = true
+schemars.workspace = true
+yaml_serde.workspace = true
+thiserror.workspace = true
+reqwest.workspace = true
+rmcp = { version = "1.7.0", default-features = false, features = ["client", "server", "transport-child-process", "transport-io", "transport-streamable-http-client-reqwest"] }
+uuid.workspace = true
+starweaver-context.workspace = true
+starweaver-core.workspace = true
+starweaver-environment.workspace = true
+starweaver-model.workspace = true
+starweaver-oauth-provider.workspace = true
+starweaver-runtime.workspace = true
+starweaver-session.workspace = true
+starweaver-stream.workspace = true
+starweaver-usage = { workspace = true, features = ["pricing"] }
+starweaver-tools.workspace = true
+tokio.workspace = true
+
+[dev-dependencies]
+axum = "0.8.7"
+rmcp = { version = "1.7.0", default-features = false, features = ["client", "server", "transport-child-process", "transport-io", "transport-streamable-http-client-reqwest", "transport-streamable-http-server"] }
+starweaver-core.workspace = true
+starweaver-tools.workspace = true
+tokio-util = "0.7.17"
+
+[lints]
+workspace = true

starweaver-0.3.0/crates/starweaver-agent/README.md

@@ -0,0 +1,188 @@
+# Starweaver
+
+Starweaver is a Rust agent SDK for building local-first AI agents, CLIs, and service runtimes.
+It gives you a typed agent loop, provider-neutral model protocol, function tools, structured
+output, durable session primitives, first-party environment tools, and a CLI product surface in
+one workspace.
+
+## Why Starweaver
+
+- Rust-native agent construction with `AgentBuilder`, `AgentApp`, and `AgentSession`.
+- Provider-neutral model messages, settings, profiles, streaming parts, and request audit hooks.
+- Typed function tools from Serde and `schemars`, plus toolsets, metadata, retries, approval, and deferred records.
+- Structured output through JSON Schema, typed parsing, output functions, and validation retry.
+- Runtime extension hooks for prompt preparation, request shaping, tool policy, output validation, usage, and trace recording.
+- Durable execution foundations: context export/restore, checkpoints, session records, replay streams, and SQLite storage adapters.
+- First-party SDK bundles for filesystem, shell, skills, task tracking, host search/scrape/media adapters, MCP, and subagents.
+- A CLI launcher with profile-based local runs, install/update flow, display messages, local storage, and release artifacts.
+
+## Install
+
+Install the latest public release:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/Wh1isper/starweaver/main/scripts/install.sh | sh
+```
+
+The installer downloads the matching `starweaver-cli` archive, verifies `checksums.txt` when
+available, and installs `starweaver`, `starweaver-cli`, `sw`, and `starweaver-rpc`. It installs into
+`$HOME/.local/bin` for normal users and `/usr/local/bin` for root. Override the location when
+needed:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/Wh1isper/starweaver/main/scripts/install.sh \
+  | STARWEAVER_INSTALL_DIR="$HOME/bin" sh
+```
+
+Install a pinned release or prerelease:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/Wh1isper/starweaver/main/scripts/install.sh \
+  | STARWEAVER_VERSION=vX.Y.Z sh
+```
+
+The default `latest` channel uses GitHub's latest stable release first and falls back to the
+newest public prerelease when no stable release exists yet.
+
+Update an installed CLI from GitHub release artifacts:
+
+```bash
+starweaver update
+```
+
+The update command checks the current CLI package version before invoking the installer. When the
+selected release is already installed it exits with `status=up-to-date`; pass `--force` to reinstall
+the same version.
+
+Run from a checkout:
+
+```bash
+make cli -- -p "hello" --output text
+make sw -- --help
+make sw -- -p "hello" --output text
+make sw -- version
+```
+
+## SDK Quickstart
+
+```rust
+use std::sync::Arc;
+
+use starweaver_agent::{AgentBuilder, TestModel};
+
+# async fn example() -> Result<(), starweaver_agent::AgentError> {
+let agent = AgentBuilder::new(Arc::new(TestModel::with_text("Paris")))
+    .instruction("Answer concisely.")
+    .build();
+
+let result = agent.run("What is the capital of France?").await?;
+assert_eq!(result.output, "Paris");
+# Ok(())
+# }
+```
+
+Add typed tools:
+
+```rust
+use std::sync::Arc;
+
+use schemars::JsonSchema;
+use serde::{Deserialize, Serialize};
+use starweaver_agent::{typed_tool, AgentBuilder, TestModel, ToolContext, ToolResult};
+
+#[derive(Clone, Debug, Deserialize, JsonSchema, Serialize)]
+struct LookupArgs {
+    /// City to look up.
+    city: String,
+}
+
+# async fn example() -> Result<(), starweaver_agent::AgentError> {
+let lookup = typed_tool::<LookupArgs, _, _>(
+    "lookup_weather",
+    Some("Look up weather for a city".to_string()),
+    |_ctx: ToolContext, args: LookupArgs| async move {
+        Ok(ToolResult::new(serde_json::json!({
+            "city": args.city,
+            "forecast": "clear"
+        })))
+    },
+);
+
+let agent = AgentBuilder::new(Arc::new(TestModel::with_text("clear")))
+    .tool(Arc::new(lookup))
+    .build();
+
+let result = agent.run("What is the weather in Paris?").await?;
+assert_eq!(result.output, "clear");
+# Ok(())
+# }
+```
+
+## Documentation
+
+Published docs: <https://starweaver.wh1isper.top>
+
+Start here:
+
+- [Quickstart](docs/quickstart.md)
+- [Agent SDK](docs/agent-sdk.md)
+- [Python SDK](docs/python-sdk.md)
+- [Agents](docs/agent.md)
+- [Models](docs/models.md)
+- [Tools](docs/tools.md)
+- [Structured Output](docs/output.md)
+- [CLI](docs/cli.md)
+- [Testing](docs/testing.md)
+- [Release](docs/release.md)
+
+Architecture and product decisions live in [spec/](spec/). User-facing guides live in [docs/](docs/).
+
+## Workspace
+
+Starweaver is organized as focused crates:
+
+- `starweaver-agent`: public SDK facade, app/session helpers, bundles, subagents, profiles, and filters.
+- `starweaver-runtime`: deterministic agent loop, graph state, tools, output, retries, capabilities, streams, traces, and checkpoints.
+- `starweaver-model`: provider-neutral model protocol, settings, profiles, transports, wrappers, OAuth-backed adapters, and replay tests.
+- `starweaver-tools`: function tools, toolsets, metadata, lifecycle, MCP foundations, approval, and deferred execution.
+- `starweaver-context`: `AgentContext`, typed dependencies, state, event/message buses, notes, usage, and resumable state.
+- `starweaver-environment`: local and virtual filesystem/shell providers, policies, resources, and environment snapshots.
+- `starweaver-session`, `starweaver-stream`, `starweaver-storage`: durable session, replay, display stream, and SQLite storage contracts.
+- `starweaver-cli`: local CLI product surface, launcher dispatch, profiles, TUI, storage, install, and update workflows.
+- `starweaver-rpc-core`: shared JSON-RPC host protocol helpers and stream/replay projections.
+- `starweaver-rpc`: standalone JSON-RPC host process for Desktop and local host integrations.
+- `packages/starweaver-py`: in-process Python SDK bindings, Python tool injection, live run control, message bus facades, typed HITL helpers, deterministic test models, sessions, and Python distribution artifacts.
+
+## Validation
+
+```bash
+make fmt-check
+make check
+make test
+make docs-check
+make docs-build
+```
+
+Full local gate:
+
+```bash
+make ci
+```
+
+## Release
+
+Prepare a release:
+
+```bash
+gh workflow run prepare-release.yml -f version=X.Y.Z
+```
+
+The workflow pushes `release/vX.Y.Z` for review. After that release commit reaches `main`, publish `vX.Y.Z` as a GitHub Release; the published Release event builds CLI archives and Python distributions, uploads checksums, and publishes crates plus the Python package through the `Release` environment.
+
+## Acknowledgements
+
+Thank you to the projects that helped shape Starweaver's thinking, especially [Pydantic AI](https://github.com/pydantic/pydantic-ai) and [Yet Another Agents / ya-mono](https://github.com/Wh1isper/ya-mono).
+
+## License
+
+BSD-3-Clause

starweaver-0.3.0/crates/starweaver-agent/src/bundles/context_tools/args.rs

@@ -0,0 +1,34 @@
+use schemars::JsonSchema;
+use serde::{Deserialize, Serialize};
+
+#[derive(Clone, Debug, Deserialize, Eq, JsonSchema, PartialEq, Serialize)]
+pub(super) struct SummarizeArgs {
+    /// Context summary to preserve across context handoff.
+    pub(super) content: String,
+    /// File paths to auto-load after summary.
+    #[serde(default)]
+    pub(super) auto_load_files: Option<Vec<String>>,
+}
+
+#[derive(Clone, Debug, Deserialize, Eq, JsonSchema, PartialEq, Serialize)]
+pub(super) struct NoteSetArgs {
+    /// Unique key for the note entry.
+    pub(super) key: String,
+    /// Content to store. Omit or set to null to delete the entry.
+    #[serde(default)]
+    pub(super) value: Option<String>,
+}
+
+#[derive(Clone, Debug, Deserialize, Eq, JsonSchema, PartialEq, Serialize)]
+pub(super) struct NoteGetArgs {
+    /// The note key to retrieve. Omit to list all notes.
+    #[serde(default)]
+    pub(super) key: Option<String>,
+}
+
+#[derive(Clone, Debug, Deserialize, Eq, JsonSchema, PartialEq, Serialize)]
+pub(super) struct ThinkingArgs {
+    /// A thought in markdown format.
+    #[serde(alias = "content")]
+    pub(super) thought: String,
+}

starweaver-0.3.0/crates/starweaver-agent/src/bundles/context_tools/context.rs

@@ -0,0 +1,77 @@
+use serde_json::{Map, Value};
+use starweaver_context::AgentContextHandle;
+use starweaver_tools::{ToolContext, ToolError, ToolResult};
+
+use super::args::{NoteGetArgs, NoteSetArgs, SummarizeArgs, ThinkingArgs};
+
+pub(super) async fn summarize(
+    context: ToolContext,
+    arguments: SummarizeArgs,
+) -> Result<ToolResult, ToolError> {
+    let Some(handle) = context.dependency::<AgentContextHandle>() else {
+        return Err(ToolError::Execution {
+            tool: "summarize".to_string(),
+            message: "summarize requires AgentContextHandle".to_string(),
+        });
+    };
+    let auto_load_files = arguments.auto_load_files.unwrap_or_default();
+    let rendered = render_handoff_message(&arguments.content);
+    handle.update(|agent_context| {
+        agent_context.handoff_message = Some(rendered.clone());
+        for file in &auto_load_files {
+            if !agent_context.auto_load_files.contains(file) {
+                agent_context.auto_load_files.push(file.clone());
+            }
+        }
+    });
+
+    Ok(operation(
+        "summarize",
+        serde_json::json!({
+            "content": arguments.content,
+            "rendered": rendered,
+            "auto_load_files": auto_load_files,
+        }),
+    ))
+}
+
+fn render_handoff_message(content: &str) -> String {
+    format!("# Context Summary\n\n{content}")
+}
+
+pub(super) async fn note_set(
+    _context: ToolContext,
+    arguments: NoteSetArgs,
+) -> Result<ToolResult, ToolError> {
+    Ok(operation(
+        "note",
+        serde_json::json!({"key": arguments.key, "value": arguments.value}),
+    ))
+}
+
+pub(super) async fn note_get(
+    _context: ToolContext,
+    arguments: NoteGetArgs,
+) -> Result<ToolResult, ToolError> {
+    Ok(operation(
+        "note_get",
+        serde_json::json!({"key": arguments.key}),
+    ))
+}
+
+pub(super) async fn thinking(
+    _context: ToolContext,
+    arguments: ThinkingArgs,
+) -> Result<ToolResult, ToolError> {
+    Ok(operation(
+        "thinking",
+        serde_json::json!({"thought": arguments.thought}),
+    ))
+}
+
+fn operation(name: &str, payload: Value) -> ToolResult {
+    let mut content = Map::new();
+    content.insert("operation".to_string(), Value::String(name.to_string()));
+    content.insert("payload".to_string(), payload);
+    ToolResult::new(Value::Object(content))
+}