zettcode-server 0.1.0__tar.gz

zettcode_server-0.1.0/.gitignore

@@ -0,0 +1,30 @@
+**/.venv/
+**/__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.smoke/
+.coverage
+**/.pytest_cache/
+**/.ruff_cache/
+.zett-tool-output/
+.env
+.DS_Store
+
+# viztracer writes its trace here by default.
+/result.json
+
+# The docs site: dependencies, build output, and VitePress' cache.
+node_modules/
+docs/.vitepress/dist/
+docs/.vitepress/cache/
+docs/.vitepress/.temp/
+
+# The TypeScript client is built from its sources; only dist/ is published.
+clients/typescript/dist/
+
+# The palette gallery is generated by `make palettes`: every widget painted in
+# every palette, written by docs/scripts/palette_gallery.py. Regenerate it
+# rather than committing a 2 MB copy that goes stale the moment a colour moves.
+docs/internal/palettes.html

zettcode_server-0.1.0/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.5
+Name: zettcode-server
+Version: 0.1.0
+Summary: The ZettCode coding agent behind an HTTP API: prompts, streaming, sessions and models
+Project-URL: Repository, https://github.com/Chang-LeHung/zettcode
+Project-URL: Issues, https://github.com/Chang-LeHung/zettcode/issues
+Author: Chang-LeHung
+License-Expression: MIT
+Keywords: agent,api,coding-agent,http,llm
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Web Environment
+Classifier: Framework :: FastAPI
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows :: Windows 10
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: fastapi<1,>=0.115
+Requires-Dist: httpx<1,>=0.27
+Requires-Dist: uvicorn<1,>=0.35
+Requires-Dist: zettcode>=0.1.8
+Description-Content-Type: text/markdown
+
+# zettcode-server
+
+The ZettCode coding agent behind an HTTP API, in the same repository as the terminal program and its SDK.
+
+One process serves one workspace. Every endpoint drives the released `zettcode` SDK — the same tools, plugins, MCP
+servers, skills, project instructions and session store as the terminal — so a conversation begun here can be reopened
+in `zettcode`, and the other way round. The package holds no agent of its own.
+
+```bash
+uv tool install zettcode-server
+zettcode-server --workspace ~/projects/api
+```
+
+```text
+zettcode-server 0.1.0 (zettcode 0.1.8) · http://127.0.0.1:3290 · workspace /home/you/projects/api · permission deny · token off
+```
+
+It binds loopback on port **3290**, denies shell commands by default, and asks for a bearer token only when one is
+configured (`--token`, `$ZETTCODE_SERVER_TOKEN`).
+
+A machine with no model configured is still served: `/health` says `ready: false` and `POST /models` writes the
+`[[models]]` entry (the same one `/config add` writes) and builds the agent, so an editor can set ZettCode up without
+touching a file by hand.
+
+```bash
+curl http://127.0.0.1:3290/health
+curl -N -X POST http://127.0.0.1:3290/prompts \
+  -H 'content-type: application/json' \
+  -d '{"text": "summarize the README", "approvals": {"mode": "deny"}}'
+```
+
+The stream carries the run's events and ends with its result. A run that needs an answer — a shell command, a
+question — is suspended and answered through `POST /runs/approvals` or `POST /runs/questions`, so a client stays in
+the conversation instead of guessing.
+
+- [The guide](https://chang-lehung.github.io/zettcode/server/): install, endpoints, event stream
+- [TypeScript client](../clients/typescript): `npm install zettcode-client`
+- [Python SDK](https://chang-lehung.github.io/zettcode/sdk/): the same agent from Python

zettcode_server-0.1.0/README.md

@@ -0,0 +1,38 @@
+# zettcode-server
+
+The ZettCode coding agent behind an HTTP API, in the same repository as the terminal program and its SDK.
+
+One process serves one workspace. Every endpoint drives the released `zettcode` SDK — the same tools, plugins, MCP
+servers, skills, project instructions and session store as the terminal — so a conversation begun here can be reopened
+in `zettcode`, and the other way round. The package holds no agent of its own.
+
+```bash
+uv tool install zettcode-server
+zettcode-server --workspace ~/projects/api
+```
+
+```text
+zettcode-server 0.1.0 (zettcode 0.1.8) · http://127.0.0.1:3290 · workspace /home/you/projects/api · permission deny · token off
+```
+
+It binds loopback on port **3290**, denies shell commands by default, and asks for a bearer token only when one is
+configured (`--token`, `$ZETTCODE_SERVER_TOKEN`).
+
+A machine with no model configured is still served: `/health` says `ready: false` and `POST /models` writes the
+`[[models]]` entry (the same one `/config add` writes) and builds the agent, so an editor can set ZettCode up without
+touching a file by hand.
+
+```bash
+curl http://127.0.0.1:3290/health
+curl -N -X POST http://127.0.0.1:3290/prompts \
+  -H 'content-type: application/json' \
+  -d '{"text": "summarize the README", "approvals": {"mode": "deny"}}'
+```
+
+The stream carries the run's events and ends with its result. A run that needs an answer — a shell command, a
+question — is suspended and answered through `POST /runs/approvals` or `POST /runs/questions`, so a client stays in
+the conversation instead of guessing.
+
+- [The guide](https://chang-lehung.github.io/zettcode/server/): install, endpoints, event stream
+- [TypeScript client](../clients/typescript): `npm install zettcode-client`
+- [Python SDK](https://chang-lehung.github.io/zettcode/sdk/): the same agent from Python

zettcode_server-0.1.0/pyproject.toml

@@ -0,0 +1,58 @@
+[project]
+name = "zettcode-server"
+description = "The ZettCode coding agent behind an HTTP API: prompts, streaming, sessions and models"
+readme = "README.md"
+requires-python = ">=3.10"
+dynamic = ["version"]
+license = "MIT"
+authors = [{name = "Chang-LeHung"}]
+keywords = ["agent", "llm", "http", "api", "coding-agent"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Web Environment",
+  "Framework :: FastAPI",
+  "Operating System :: MacOS",
+  "Operating System :: Microsoft :: Windows :: Windows 10",
+  "Operating System :: POSIX :: Linux",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Typing :: Typed",
+]
+dependencies = [
+  # The agent, as a released package: the server drives it through its SDK and
+  # carries no copy of the model loop, the tools, or the session store.
+  "zettcode>=0.1.8",
+  "fastapi>=0.115,<1",
+  "uvicorn>=0.35,<1",
+  # Returned by every endpoint and read back by the tests; the SDK's own runs
+  # speak to the provider with it.
+  "httpx>=0.27,<1",
+]
+
+[project.scripts]
+zettcode-server = "zettcode_server.cli:main"
+
+[project.urls]
+Repository = "https://github.com/Chang-LeHung/zettcode"
+Issues = "https://github.com/Chang-LeHung/zettcode/issues"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+# Single source of truth: the version is written once, in the package.
+path = "src/zettcode_server/__init__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/zettcode_server"]
+
+[tool.hatch.build.targets.sdist]
+include = ["/src", "/README.md", "/pyproject.toml"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"

zettcode_server-0.1.0/src/zettcode_server/__init__.py

@@ -0,0 +1,33 @@
+"""ZettCode behind an HTTP API: the coding agent, driven by `zettcode.sdk`, one workspace per process.
+
+The server is a thin layer: an endpoint says what to ask the agent and how to let a run answer for itself, and the
+SDK does the work. It owns no model loop, no tools, and no session format, so a session begun here is one the
+terminal can open afterwards, and the other way round.
+
+The application is built by :func:`create_app`, and served by the ``zettcode-server`` program.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+__version__ = "0.1.0"
+
+if TYPE_CHECKING:  # pragma: no cover - annotations only; importing the app costs FastAPI
+    from .app import create_app
+    from .settings import Settings
+
+__all__ = ["Settings", "__version__", "create_app"]
+
+
+def __getattr__(name: str) -> Any:
+    """Load the application on first use, so ``--version`` does not import FastAPI."""
+    if name == "create_app":
+        from .app import create_app
+
+        return create_app
+    if name == "Settings":
+        from .settings import Settings
+
+        return Settings
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")