create-theokit 0.4.0-beta.0 → 0.5.0

package/templates/services/agent-node/README.md

@@ -1,38 +0,0 @@
-# Agent service (Node / Hono)
-
-This is a TheoKit polyglot sidecar generated by `create-theokit --backend node`.
-
-## Requirements
-
-- **Node.js 22+** (matches TheoKit's floor)
-- **pnpm** or **npm** (TheoKit's CLI prefers pnpm)
-
-## Run it
-
-The TheoKit app boots this service automatically via `pnpm dev` (per `theo.config.ts > services`).
-
-To run standalone:
-
-```bash
-cd services/agent-node
-pnpm install
-pnpm dev
-```
-
-## Endpoints
-
-- `GET /health` — healthcheck (returns `{"status":"ok"}`)
-- `POST /echo` — example: `{ "message": "..." }` → `{ "echo": "..." }`
-
-## What is wired
-
-- Native fetch handler via Hono (works on TheoCloud and local)
-- JSON-line stdout logs
-- W3C `traceparent` propagation from incoming headers
-- TheoKit injects `THEOKIT_SERVICE_NAME` + `THEOKIT_SERVICE_PORT` env vars
-
-## Add a tool the TheoKit agent can call
-
-Add another `app.post('/tool/<name>', ...)` handler. From the TheoKit TS side,
-`services.worker.<name>({...})` is auto-typed when an OpenAPI URL is reachable
-(Hey API integration — Phase 5).

package/templates/services/agent-node/package.json.tmpl

@@ -1,18 +0,0 @@
-{
-  "name": "{{name}}-agent-node",
-  "private": true,
-  "type": "module",
-  "scripts": {
-    "dev": "tsx watch src/index.ts",
-    "start": "tsx src/index.ts",
-    "build": "echo 'no build step; tsx runs TS directly'"
-  },
-  "dependencies": {
-    "hono": "^4.6.0",
-    "@hono/node-server": "^1.13.0"
-  },
-  "devDependencies": {
-    "tsx": "^4.19.0",
-    "typescript": "^5.7.0"
-  }
-}

package/templates/services/agent-node/src/index.ts

@@ -1,58 +0,0 @@
-/**
- * TheoKit polyglot agent service — Hono sidecar.
- *
- * Conforms to the Like-Vercel runtime contract (ADR-0015):
- *   - Fetch-handler entry (native fetch handler from Hono)
- *   - GET /health convention (200 / 503)
- *   - JSON-line stdout logs
- *   - W3C traceparent propagation
- *   - Env vars at runtime
- *
- * Generated by `create-theokit --backend node`.
- */
-import { Hono } from 'hono'
-import { serve } from '@hono/node-server'
-
-const SERVICE_NAME = process.env.THEOKIT_SERVICE_NAME ?? 'agent-node'
-const SERVICE_PORT = Number.parseInt(process.env.THEOKIT_SERVICE_PORT ?? '8002', 10)
-
-function log(
-  level: 'info' | 'warn' | 'error',
-  message: string,
-  extra: Record<string, unknown> = {},
-) {
-  // eslint-disable-next-line no-console -- structured stdout per ADR-0015 invariant #5
-  console.log(
-    JSON.stringify({
-      timestamp: new Date().toISOString(),
-      level,
-      message,
-      service: SERVICE_NAME,
-      ...extra,
-    }),
-  )
-}
-
-const app = new Hono()
-
-// ADR-0015 invariant #6 — W3C traceparent propagation
-app.use(async (c, next) => {
-  const tp = c.req.header('traceparent')
-  if (tp) {
-    log('info', 'request', { traceparent: tp, path: c.req.path })
-  }
-  await next()
-})
-
-// ADR-0015 invariant #4 — healthcheck convention
-app.get('/health', (c) => c.json({ status: 'ok' }))
-
-// Example endpoint — TheoKit proxies /api/worker/* to this service.
-app.post('/echo', async (c) => {
-  const body = (await c.req.json()) as { message: string }
-  return c.json({ echo: body.message })
-})
-
-serve({ fetch: app.fetch, port: SERVICE_PORT }, () => {
-  log('info', `agent-node listening on :${String(SERVICE_PORT)}`)
-})

package/templates/services/agent-node/tsconfig.json

@@ -1,13 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "Bundler",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "lib": ["ES2022"],
-    "types": ["node"]
-  },
-  "include": ["src/**/*.ts"]
-}

package/templates/services/agent-python/Dockerfile.tmpl

@@ -1,20 +0,0 @@
-FROM python:3.12-slim
-
-WORKDIR /app
-
-# Install uv (fast pip replacement)
-RUN pip install --no-cache-dir uv
-
-# Copy dependency manifest first (cache layer)
-COPY pyproject.toml ./
-RUN uv sync --no-dev --frozen || uv sync --no-dev
-
-# Copy source
-COPY . .
-
-EXPOSE 8001
-
-HEALTHCHECK --interval=10s --timeout=5s --retries=3 \
-    CMD curl -f http://localhost:8001/health || exit 1
-
-CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8001", "--workers", "4"]

package/templates/services/agent-python/README.md

@@ -1,37 +0,0 @@
-# Agent service (Python / FastAPI)
-
-This is a TheoKit polyglot sidecar generated by `create-theokit --backend python`.
-
-## Requirements
-
-- **Python 3.11+** (`pyproject.toml` requires it)
-- **uv** in PATH (https://github.com/astral-sh/uv)
-
-## Run it
-
-The TheoKit app boots this service automatically via `pnpm dev` (per `theo.config.ts > services`).
-
-To run standalone:
-
-```bash
-cd services/agent-python
-uv sync
-uv run uvicorn main:app --reload --port 8001
-```
-
-## Endpoints
-
-- `GET /health` — healthcheck (returns `{"status":"ok"}`)
-- `POST /echo` — example: `{ "message": "..." }` → `{ "echo": "..." }`
-
-## What is wired
-
-- ASGI fetch-handler (works on TheoCloud K8s and local uvicorn)
-- JSON-line stdout logs
-- W3C `traceparent` propagation from incoming headers
-- TheoKit injects `THEOKIT_SERVICE_NAME` + `THEOKIT_SERVICE_PORT` env vars
-
-## Add a tool the TheoKit agent can call
-
-Add another `@app.post("/tool/<name>")` endpoint. From the TheoKit TS side,
-`services.agent.<name>({...})` is auto-typed when the OpenAPI URL is reachable.

package/templates/services/agent-python/main.py

@@ -1,77 +0,0 @@
-"""
-TheoKit polyglot agent service — FastAPI sidecar.
-
-Conforms to the Like-Vercel runtime contract (ADR-0015):
-  - Fetch-handler entry (ASGI via uvicorn)
-  - GET /health convention (200 / 503)
-  - JSON-line stdout logs
-  - W3C traceparent propagation
-  - Env vars at runtime (not bundled)
-
-Generated by `create-theokit --backend python`.
-"""
-import json
-import logging
-import os
-import sys
-from datetime import datetime, timezone
-
-from fastapi import FastAPI, Request
-from pydantic import BaseModel
-
-
-SERVICE_NAME = os.environ.get("THEOKIT_SERVICE_NAME", "agent-python")
-SERVICE_PORT = os.environ.get("THEOKIT_SERVICE_PORT", "8001")
-
-
-class JsonFormatter(logging.Formatter):
-    """ADR-0015 invariant #5 — JSON-line stdout logging."""
-
-    def format(self, record: logging.LogRecord) -> str:
-        log_obj = {
-            "timestamp": datetime.now(tz=timezone.utc).isoformat(),
-            "level": record.levelname.lower(),
-            "message": record.getMessage(),
-            "service": SERVICE_NAME,
-        }
-        if hasattr(record, "traceparent"):
-            log_obj["traceparent"] = getattr(record, "traceparent")
-        return json.dumps(log_obj)
-
-
-handler = logging.StreamHandler(sys.stdout)
-handler.setFormatter(JsonFormatter())
-logging.basicConfig(level=logging.INFO, handlers=[handler])
-log = logging.getLogger("theokit.service")
-
-
-app = FastAPI(title=f"{SERVICE_NAME} agent service")
-
-
-@app.middleware("http")
-async def trace_middleware(request: Request, call_next):
-    """ADR-0015 invariant #6 — W3C traceparent propagation."""
-    traceparent = request.headers.get("traceparent")
-    if traceparent:
-        log.info(
-            "request",
-            extra={"traceparent": traceparent, "path": request.url.path},
-        )
-    response = await call_next(request)
-    return response
-
-
-@app.get("/health")
-async def health() -> dict[str, str]:
-    """ADR-0015 invariant #4 — healthcheck convention."""
-    return {"status": "ok"}
-
-
-class EchoRequest(BaseModel):
-    message: str
-
-
-@app.post("/echo")
-async def echo(req: EchoRequest) -> dict[str, str]:
-    """Example endpoint — TheoKit proxies /api/agent/* to this service."""
-    return {"echo": req.message}

package/templates/services/agent-python/pyproject.toml.tmpl

@@ -1,16 +0,0 @@
-[project]
-name = "{{name}}-agent-python"
-version = "0.1.0"
-description = "TheoKit polyglot agent service (FastAPI sidecar)"
-requires-python = ">=3.11"
-dependencies = [
-    "fastapi>=0.115",
-    "uvicorn[standard]>=0.32",
-    "pydantic>=2.9",
-]
-
-[tool.uv]
-dev-dependencies = [
-    "pytest>=8.0",
-    "httpx>=0.28",
-]