wisp-ai 0.1.0__tar.gz

wisp_ai-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hanyu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

wisp_ai-0.1.0/PKG-INFO

@@ -0,0 +1,212 @@
+Metadata-Version: 2.4
+Name: wisp-ai
+Version: 0.1.0
+Summary: Terminal-first coding agent with typed CLI, TUI, RPC, and SDK interfaces
+Keywords: agent,ai,cli,coding-agent,llm,tui
+Author: whanyu1212
+Author-email: whanyu1212 <whanyu1212@hotmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Typing :: Typed
+Requires-Dist: anthropic>=0.116.0
+Requires-Dist: anyio>=4.14.1
+Requires-Dist: cryptography>=50.0.0
+Requires-Dist: google-genai>=2.12.0
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: jsonschema>=4.26
+Requires-Dist: mcp>=2,<3
+Requires-Dist: openai>=2.44.0
+Requires-Dist: packaging>=26.0
+Requires-Dist: pathspec>=1.1.1
+Requires-Dist: prompt-toolkit>=3.0.52
+Requires-Dist: pygments>=2.20.0
+Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: pydantic>=2.13.4
+Requires-Dist: regex>=2026.7.19
+Requires-Dist: rich>=15.0.0
+Requires-Dist: textual>=8.2.8
+Requires-Dist: typer>=0.26.8
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/whanyu1212/Wisp
+Project-URL: Repository, https://github.com/whanyu1212/Wisp
+Project-URL: Changelog, https://github.com/whanyu1212/Wisp/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/whanyu1212/Wisp/issues
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/whanyu1212/Wisp/main/assets/wisp-banner-v2.png" alt="Wisp — A coding agent that stays in sync, illustrated by a glowing spectral companion linked to a terminal." width="100%">
+</p>
+
+# Wisp
+
+<p align="center">
+  <strong>A coding agent that stays in sync with you.</strong><br>
+  Redirect it while it works. Approve what it changes. Inspect everything it did.
+</p>
+
+<p align="center">
+  <a href="#install">Install</a>
+  ·
+  <a href="#quickstart">Quickstart</a>
+  ·
+  <a href="#staying-in-sync">Staying in sync</a>
+  ·
+  <a href="#documentation">Docs</a>
+  ·
+  <a href="https://pypi.org/project/wisp-ai/">PyPI</a>
+  ·
+  <a href="https://github.com/whanyu1212/Wisp/blob/main/CHANGELOG.md">Changelog</a>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/wisp-ai/"><img src="https://img.shields.io/pypi/v/wisp-ai?label=PyPI" alt="PyPI version" /></a>
+  <a href="https://www.python.org/"><img src="https://img.shields.io/badge/Python-3.12%2B-blue" alt="Python 3.12+" /></a>
+  <a href="https://github.com/whanyu1212/Wisp/actions/workflows/ci.yml"><img src="https://github.com/whanyu1212/Wisp/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
+  <a href="https://github.com/whanyu1212/Wisp/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green" alt="MIT License" /></a>
+</p>
+
+## What is Wisp?
+
+Most coding agents ask you to choose between watching and working: you either sit and wait, or you
+walk away and audit a diff afterwards. Wisp is built for the middle — you can redirect it mid-run,
+you approve anything that touches your machine, and every action it takes is a typed event on an
+inspectable transcript.
+
+Underneath is a single event-driven runtime. The CLI, the fullscreen TUI, the JSONL RPC process, and
+the in-process SDK all drive the same command host and agent loop rather than reimplementing it.
+They share session, tool, approval, and cancellation semantics, while each frontend exposes the
+controls its input model supports: RPC and SDK clients have live steering and queue APIs, the TUI
+accepts interactive follow-ups, and print/JSON modes run one prompt without a mid-run input channel.
+
+## Install
+
+Wisp is published on PyPI as `wisp-ai`, installs a `wisp` command, and requires Python 3.12+. Linux
+and macOS are supported; Windows is best-effort until it has dedicated CI coverage.
+
+```bash
+uv tool install "wisp-ai==0.1.0"
+wisp --version
+```
+
+To run it without installing: `uvx --from "wisp-ai==0.1.0" wisp`. If `wisp` is not on your
+`PATH`, run `uv tool update-shell` once and restart your shell.
+
+See [Installation](https://whanyu1212.github.io/Wisp/guide/installation) for the update policy and
+troubleshooting.
+
+## Quickstart
+
+Run Wisp from the project you want it to work on:
+
+```bash
+cd path/to/project
+wisp
+```
+
+Wisp defaults to OpenAI Codex subscription access. Type `/connect` to open the provider panel, pick
+**OpenAI → ChatGPT Plus/Pro**, and complete the device-code flow. The same panel accepts masked API
+keys for OpenAI, xAI, DeepSeek, Anthropic, and Google. Then ask for something:
+
+```text
+explain the architecture of this repository
+```
+
+For one-shot prompts and scripts, use print mode — or run entirely offline to try it without
+credentials:
+
+```bash
+wisp -p "summarize the current changes"
+wisp -p "hello" --provider fake
+```
+
+## Staying in sync
+
+This is the part worth knowing before anything else.
+
+**Steer without starting over.** RPC and SDK clients can queue a course correction for the active
+run. Wisp injects it at the next safe request boundary without discarding completed tool work or
+rewriting the transcript. A follow-up waits until the run would otherwise finish. The TUI queues
+text entered during a run as follow-up work; print and JSON invocations are intentionally one-shot.
+
+**Cancel cleanly.** Cancellation is cooperative and leaves the session resumable rather than
+half-written. In-flight tool work is unwound, the JSONL record stays valid, and `--continue` picks
+up from the last committed state.
+
+**Approve what matters.** Tools are classified `read`, `mutating`, or `command`. Reads run
+directly; writes, edits, and shell commands stop and ask. The decision lives outside the model's
+reach — no prompt can talk Wisp into skipping it — and print mode blocks unsafe execution entirely
+unless you pass `--yes`.
+
+**Nothing happens off-screen.** Every action is a typed `WispEvent` in an enforced order, persisted
+to an append-only JSONL session you can read, resume, branch, or audit long after the run.
+
+→ [How it stays in sync](https://whanyu1212.github.io/Wisp/guide/staying-in-sync)
+
+## Interfaces
+
+| Mode | Command | Output | Best for |
+|------|---------|--------|----------|
+| **TUI** | `wisp` (or `wisp tui`) | Fullscreen Textual UI | Interactive development |
+| **Print** | `wisp -p "…"` | Assistant text on stdout, events on stderr | One-shot prompts and scripts |
+| **JSON** | `wisp -p "…" --mode json` | One `WispEvent` JSON object per line | Machine-readable automation |
+| **RPC** | `wisp --mode rpc` | Typed JSONL commands and events | Long-lived integrations |
+
+RPC mode and the in-process SDK expose the same command, event, session, trust, and approval
+contracts the built-in interfaces use. See
+[Interfaces](https://whanyu1212.github.io/Wisp/guide/interfaces) and the
+[Python SDK guide](https://whanyu1212.github.io/Wisp/guide/sdk).
+
+## Architecture
+
+One event-driven runtime, shared by every interface:
+
+```text
+CLI / JSONL-RPC / SDK adapters → RPC command host → CodingSession → AgentHarness → run_agent_loop
+```
+
+Each layer adds exactly one concern. The provider/tool cycle knows nothing about sessions or
+frontends; the harness owns in-memory conversation state; the coding session adds persistence and
+safety policy; interfaces consume typed events. The TUI is an RPC client, not a second agent loop —
+which is why it cannot drift from the guarantees above.
+
+→ [Architecture](https://whanyu1212.github.io/Wisp/architecture/)
+
+## Documentation
+
+| | |
+|---|---|
+| [Guide](https://whanyu1212.github.io/Wisp/guide/) | Installation, quickstart, providers, tools, sessions, skills, TUI |
+| [Staying in sync](https://whanyu1212.github.io/Wisp/guide/staying-in-sync) | Steering, cancellation, approvals, transcripts |
+| [Python SDK](https://whanyu1212.github.io/Wisp/guide/sdk) | In-process embedding, typed events, safety, sessions, and cleanup |
+| [Reference](https://whanyu1212.github.io/Wisp/reference/) | CLI, SDK, configuration, and environment variables |
+| [Architecture](https://whanyu1212.github.io/Wisp/architecture/) | Runtime layers and ownership boundaries |
+| [Contributing](https://whanyu1212.github.io/Wisp/contributing/) | Development setup and testing |
+
+## Contributing
+
+```bash
+uv sync                                                              # install
+uv run ruff format --check . && uv run ruff check . && uv run mypy   # quality gates
+uv run pytest tests                                                  # complete suite
+```
+
+The suite runs entirely against deterministic fake and scripted providers, so the agent core, CLI,
+and JSONL sessions are exercised without API keys or network calls. Run the complete command before
+considering a change verified, and preserve the layer boundaries described above.
+
+See [Contributing](https://whanyu1212.github.io/Wisp/contributing/) for development setup and CI
+policy. Issues and pull requests are welcome at
+[github.com/whanyu1212/Wisp/issues](https://github.com/whanyu1212/Wisp/issues).
+
+## License
+
+MIT — see [LICENSE](https://github.com/whanyu1212/Wisp/blob/main/LICENSE).

wisp_ai-0.1.0/README.md

@@ -0,0 +1,168 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/whanyu1212/Wisp/main/assets/wisp-banner-v2.png" alt="Wisp — A coding agent that stays in sync, illustrated by a glowing spectral companion linked to a terminal." width="100%">
+</p>
+
+# Wisp
+
+<p align="center">
+  <strong>A coding agent that stays in sync with you.</strong><br>
+  Redirect it while it works. Approve what it changes. Inspect everything it did.
+</p>
+
+<p align="center">
+  <a href="#install">Install</a>
+  ·
+  <a href="#quickstart">Quickstart</a>
+  ·
+  <a href="#staying-in-sync">Staying in sync</a>
+  ·
+  <a href="#documentation">Docs</a>
+  ·
+  <a href="https://pypi.org/project/wisp-ai/">PyPI</a>
+  ·
+  <a href="https://github.com/whanyu1212/Wisp/blob/main/CHANGELOG.md">Changelog</a>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/wisp-ai/"><img src="https://img.shields.io/pypi/v/wisp-ai?label=PyPI" alt="PyPI version" /></a>
+  <a href="https://www.python.org/"><img src="https://img.shields.io/badge/Python-3.12%2B-blue" alt="Python 3.12+" /></a>
+  <a href="https://github.com/whanyu1212/Wisp/actions/workflows/ci.yml"><img src="https://github.com/whanyu1212/Wisp/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
+  <a href="https://github.com/whanyu1212/Wisp/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-green" alt="MIT License" /></a>
+</p>
+
+## What is Wisp?
+
+Most coding agents ask you to choose between watching and working: you either sit and wait, or you
+walk away and audit a diff afterwards. Wisp is built for the middle — you can redirect it mid-run,
+you approve anything that touches your machine, and every action it takes is a typed event on an
+inspectable transcript.
+
+Underneath is a single event-driven runtime. The CLI, the fullscreen TUI, the JSONL RPC process, and
+the in-process SDK all drive the same command host and agent loop rather than reimplementing it.
+They share session, tool, approval, and cancellation semantics, while each frontend exposes the
+controls its input model supports: RPC and SDK clients have live steering and queue APIs, the TUI
+accepts interactive follow-ups, and print/JSON modes run one prompt without a mid-run input channel.
+
+## Install
+
+Wisp is published on PyPI as `wisp-ai`, installs a `wisp` command, and requires Python 3.12+. Linux
+and macOS are supported; Windows is best-effort until it has dedicated CI coverage.
+
+```bash
+uv tool install "wisp-ai==0.1.0"
+wisp --version
+```
+
+To run it without installing: `uvx --from "wisp-ai==0.1.0" wisp`. If `wisp` is not on your
+`PATH`, run `uv tool update-shell` once and restart your shell.
+
+See [Installation](https://whanyu1212.github.io/Wisp/guide/installation) for the update policy and
+troubleshooting.
+
+## Quickstart
+
+Run Wisp from the project you want it to work on:
+
+```bash
+cd path/to/project
+wisp
+```
+
+Wisp defaults to OpenAI Codex subscription access. Type `/connect` to open the provider panel, pick
+**OpenAI → ChatGPT Plus/Pro**, and complete the device-code flow. The same panel accepts masked API
+keys for OpenAI, xAI, DeepSeek, Anthropic, and Google. Then ask for something:
+
+```text
+explain the architecture of this repository
+```
+
+For one-shot prompts and scripts, use print mode — or run entirely offline to try it without
+credentials:
+
+```bash
+wisp -p "summarize the current changes"
+wisp -p "hello" --provider fake
+```
+
+## Staying in sync
+
+This is the part worth knowing before anything else.
+
+**Steer without starting over.** RPC and SDK clients can queue a course correction for the active
+run. Wisp injects it at the next safe request boundary without discarding completed tool work or
+rewriting the transcript. A follow-up waits until the run would otherwise finish. The TUI queues
+text entered during a run as follow-up work; print and JSON invocations are intentionally one-shot.
+
+**Cancel cleanly.** Cancellation is cooperative and leaves the session resumable rather than
+half-written. In-flight tool work is unwound, the JSONL record stays valid, and `--continue` picks
+up from the last committed state.
+
+**Approve what matters.** Tools are classified `read`, `mutating`, or `command`. Reads run
+directly; writes, edits, and shell commands stop and ask. The decision lives outside the model's
+reach — no prompt can talk Wisp into skipping it — and print mode blocks unsafe execution entirely
+unless you pass `--yes`.
+
+**Nothing happens off-screen.** Every action is a typed `WispEvent` in an enforced order, persisted
+to an append-only JSONL session you can read, resume, branch, or audit long after the run.
+
+→ [How it stays in sync](https://whanyu1212.github.io/Wisp/guide/staying-in-sync)
+
+## Interfaces
+
+| Mode | Command | Output | Best for |
+|------|---------|--------|----------|
+| **TUI** | `wisp` (or `wisp tui`) | Fullscreen Textual UI | Interactive development |
+| **Print** | `wisp -p "…"` | Assistant text on stdout, events on stderr | One-shot prompts and scripts |
+| **JSON** | `wisp -p "…" --mode json` | One `WispEvent` JSON object per line | Machine-readable automation |
+| **RPC** | `wisp --mode rpc` | Typed JSONL commands and events | Long-lived integrations |
+
+RPC mode and the in-process SDK expose the same command, event, session, trust, and approval
+contracts the built-in interfaces use. See
+[Interfaces](https://whanyu1212.github.io/Wisp/guide/interfaces) and the
+[Python SDK guide](https://whanyu1212.github.io/Wisp/guide/sdk).
+
+## Architecture
+
+One event-driven runtime, shared by every interface:
+
+```text
+CLI / JSONL-RPC / SDK adapters → RPC command host → CodingSession → AgentHarness → run_agent_loop
+```
+
+Each layer adds exactly one concern. The provider/tool cycle knows nothing about sessions or
+frontends; the harness owns in-memory conversation state; the coding session adds persistence and
+safety policy; interfaces consume typed events. The TUI is an RPC client, not a second agent loop —
+which is why it cannot drift from the guarantees above.
+
+→ [Architecture](https://whanyu1212.github.io/Wisp/architecture/)
+
+## Documentation
+
+| | |
+|---|---|
+| [Guide](https://whanyu1212.github.io/Wisp/guide/) | Installation, quickstart, providers, tools, sessions, skills, TUI |
+| [Staying in sync](https://whanyu1212.github.io/Wisp/guide/staying-in-sync) | Steering, cancellation, approvals, transcripts |
+| [Python SDK](https://whanyu1212.github.io/Wisp/guide/sdk) | In-process embedding, typed events, safety, sessions, and cleanup |
+| [Reference](https://whanyu1212.github.io/Wisp/reference/) | CLI, SDK, configuration, and environment variables |
+| [Architecture](https://whanyu1212.github.io/Wisp/architecture/) | Runtime layers and ownership boundaries |
+| [Contributing](https://whanyu1212.github.io/Wisp/contributing/) | Development setup and testing |
+
+## Contributing
+
+```bash
+uv sync                                                              # install
+uv run ruff format --check . && uv run ruff check . && uv run mypy   # quality gates
+uv run pytest tests                                                  # complete suite
+```
+
+The suite runs entirely against deterministic fake and scripted providers, so the agent core, CLI,
+and JSONL sessions are exercised without API keys or network calls. Run the complete command before
+considering a change verified, and preserve the layer boundaries described above.
+
+See [Contributing](https://whanyu1212.github.io/Wisp/contributing/) for development setup and CI
+policy. Issues and pull requests are welcome at
+[github.com/whanyu1212/Wisp/issues](https://github.com/whanyu1212/Wisp/issues).
+
+## License
+
+MIT — see [LICENSE](https://github.com/whanyu1212/Wisp/blob/main/LICENSE).

wisp_ai-0.1.0/pyproject.toml

@@ -0,0 +1,115 @@
+[project]
+name = "wisp-ai"
+version = "0.1.0"
+description = "Terminal-first coding agent with typed CLI, TUI, RPC, and SDK interfaces"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.12"
+keywords = [
+    "agent",
+    "ai",
+    "cli",
+    "coding-agent",
+    "llm",
+    "tui",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Code Generators",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+    "Typing :: Typed",
+]
+dependencies = [
+    "anthropic>=0.116.0",
+    "anyio>=4.14.1",
+    "cryptography>=50.0.0",
+    "google-genai>=2.12.0",
+    "httpx>=0.28.1",
+    "jsonschema>=4.26",
+    "mcp>=2,<3",
+    "openai>=2.44.0",
+    "packaging>=26.0",
+    "pathspec>=1.1.1",
+    "prompt-toolkit>=3.0.52",
+    "pygments>=2.20.0",
+    "pyyaml>=6.0.2",
+    "pydantic>=2.13.4",
+    "regex>=2026.7.19",
+    "rich>=15.0.0",
+    "textual>=8.2.8",
+    "typer>=0.26.8",
+]
+
+[[project.authors]]
+name = "whanyu1212"
+email = "whanyu1212@hotmail.com"
+
+[project.urls]
+Homepage = "https://github.com/whanyu1212/Wisp"
+Repository = "https://github.com/whanyu1212/Wisp"
+Changelog = "https://github.com/whanyu1212/Wisp/blob/main/CHANGELOG.md"
+Issues = "https://github.com/whanyu1212/Wisp/issues"
+
+[project.scripts]
+wisp = "wisp.cli:main"
+
+[build-system]
+requires = ["uv_build>=0.9.8,<0.10.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "wisp"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+markers = [
+    "tui: headless Textual integration tests",
+    "process: tests covering process-backed tools or process trees",
+    "benchmark: deterministic performance and resource-bound scenarios",
+    "slow: intentionally long-running tests outside the other categories",
+    "production_fault: required deterministic production fault-injection regressions",
+]
+
+[tool.ruff]
+line-length = 100
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "I",
+    "UP",
+    "B",
+]
+
+[tool.mypy]
+python_version = "3.12"
+strict = true
+files = [
+    "src/wisp",
+    "examples/sdk/common.py",
+    "examples/sdk/control_requests.py",
+    "examples/sdk/minimal.py",
+    "examples/sdk/persisted_sessions.py",
+    "examples/sdk/safety_requests.py",
+    "examples/sdk/subprocess_rpc.py",
+]
+
+[dependency-groups]
+dev = [
+    "mypy>=2.1.0",
+    "pytest>=9.1.1",
+    "pytest-asyncio>=1.4.0",
+    "ruff>=0.15.20",
+    "types-jsonschema>=4.26",
+    "types-pygments>=2.19",
+    "types-regex>=2026.7.19.20260720",
+    "types-pyyaml>=6.0.12",
+]

wisp_ai-0.1.0/pyproject.toml.orig

@@ -0,0 +1,108 @@
+[project]
+name = "wisp-ai"
+version = "0.1.0"
+description = "Terminal-first coding agent with typed CLI, TUI, RPC, and SDK interfaces"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "whanyu1212", email = "whanyu1212@hotmail.com" }
+]
+requires-python = ">=3.12"
+keywords = [
+    "agent",
+    "ai",
+    "cli",
+    "coding-agent",
+    "llm",
+    "tui",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Code Generators",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+    "Typing :: Typed",
+]
+dependencies = [
+    "anthropic>=0.116.0",
+    "anyio>=4.14.1",
+    "cryptography>=50.0.0",
+    "google-genai>=2.12.0",
+    "httpx>=0.28.1",
+    "jsonschema>=4.26",
+    "mcp>=2,<3",
+    "openai>=2.44.0",
+    "packaging>=26.0",
+    "pathspec>=1.1.1",
+    "prompt-toolkit>=3.0.52",
+    "pygments>=2.20.0",
+    "pyyaml>=6.0.2",
+    "pydantic>=2.13.4",
+    "regex>=2026.7.19",
+    "rich>=15.0.0",
+    "textual>=8.2.8",
+    "typer>=0.26.8",
+]
+
+[project.urls]
+Homepage = "https://github.com/whanyu1212/Wisp"
+Repository = "https://github.com/whanyu1212/Wisp"
+Changelog = "https://github.com/whanyu1212/Wisp/blob/main/CHANGELOG.md"
+Issues = "https://github.com/whanyu1212/Wisp/issues"
+
+[project.scripts]
+wisp = "wisp.cli:main"
+
+[build-system]
+requires = ["uv_build>=0.9.8,<0.10.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "wisp"
+
+[dependency-groups]
+dev = [
+    "mypy>=2.1.0",
+    "pytest>=9.1.1",
+    "pytest-asyncio>=1.4.0",
+    "ruff>=0.15.20",
+    "types-jsonschema>=4.26",
+    "types-pygments>=2.19",
+    "types-regex>=2026.7.19.20260720",
+    "types-pyyaml>=6.0.12",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+markers = [
+    "tui: headless Textual integration tests",
+    "process: tests covering process-backed tools or process trees",
+    "benchmark: deterministic performance and resource-bound scenarios",
+    "slow: intentionally long-running tests outside the other categories",
+    "production_fault: required deterministic production fault-injection regressions",
+]
+
+[tool.ruff]
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]
+
+[tool.mypy]
+python_version = "3.12"
+strict = true
+files = [
+    "src/wisp",
+    "examples/sdk/common.py",
+    "examples/sdk/control_requests.py",
+    "examples/sdk/minimal.py",
+    "examples/sdk/persisted_sessions.py",
+    "examples/sdk/safety_requests.py",
+    "examples/sdk/subprocess_rpc.py",
+]

wisp_ai-0.1.0/src/wisp/__init__.py

@@ -0,0 +1,3 @@
+"""Wisp: a terminal-first coding agent."""
+
+__version__ = "0.1.0"

wisp_ai-0.1.0/src/wisp/__main__.py

@@ -0,0 +1,3 @@
+from .cli import main
+
+main()

wisp_ai-0.1.0/src/wisp/agent/__init__.py

@@ -0,0 +1 @@
+"""Agent runtime package; import concrete contracts from their defining modules."""