Deploy SIN-Code-AI live surfaces

.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: Agent CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  build-and-verify:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: npm
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Build
+        run: npm run build
+
+      - name: Print card
+        run: node dist/src/cli.js print-card
+
+      - name: Agent help
+        run: node dist/src/cli.js run-action '{"action":"agent.help"}'
+
+      - name: Agent health
+        run: node dist/src/cli.js run-action '{"action":"sin.code.ai.health"}'

.github/workflows/deploy-huggingface-space.yml

@@ -0,0 +1,51 @@
+name: Deploy Hugging Face Space
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+
+jobs:
+  deploy:
+    if: ${{ secrets.HF_TOKEN != '' }}
+    runs-on: ubuntu-latest
+    env:
+      HF_TOKEN: ${{ secrets.HF_TOKEN }}
+      HF_SPACE_REPO_ID: delqhi/sin-code-ai
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install deployment dependencies
+        run: pip install huggingface_hub
+
+      - name: Create or ensure Hugging Face Space
+        run: |
+          python - <<'PY'
+          import os
+          from huggingface_hub import HfApi
+
+          repo_id = os.environ["HF_SPACE_REPO_ID"].strip()
+          if not repo_id:
+              raise SystemExit("HF_SPACE_REPO_ID missing")
+
+          api = HfApi(token=os.environ["HF_TOKEN"])
+          api.create_repo(repo_id=repo_id, repo_type="space", space_sdk="docker", exist_ok=True)
+          PY
+
+      - name: Push repository contents to Hugging Face Space
+        run: |
+          set -euo pipefail
+          git config --global user.name "GitHub Actions"
+          git config --global user.email "actions@github.com"
+          git clone "https://oauth2:${HF_TOKEN}@huggingface.co/spaces/delqhi/sin-code-ai" hf-space
+          rsync -a --delete             --exclude ".git/"             --exclude ".github/"             --exclude "node_modules/"             --exclude "dist/"             ./ hf-space/
+          cd hf-space
+          git add .
+          git commit -m "Deploy SIN-Code-AI from GitHub Actions" || true
+          git push origin main

.gitignore

@@ -0,0 +1,7 @@
+dist
+node_modules
+*.log
+.env
+.env.local
+.DS_Store
+.sin/artifacts/

.sin/doctor.config.yaml

@@ -0,0 +1,34 @@
+repo: a2a-sin-agent-template
+checks:
+  - required-config-present
+  - workspace-clean-enough
+  - required-files-present
+  - env-contract-present
+  - build-command-exists
+  - tests-command-exists
+  - runtime-command-exists
+  - complete-install-present
+  - health-surface-present
+required_files:
+  - README.md
+  - package.json
+  - src/runtime.ts
+  - src/mcp-server.ts
+  - scripts/complete-install.sh
+  - scripts/hf_pull_script.py
+env_contract_files:
+  - .env.example
+commands:
+  build:
+    - npm run build
+  tests:
+    - npm run typecheck
+  runtime:
+    - npm run start:mcp
+    - npm run start:a2a
+  verify:
+    - node dist/src/cli.js print-card
+health_files:
+  - agent.json
+  - src/runtime.ts
+launchagent_files: []

.sin/policies.local.yaml

@@ -0,0 +1 @@
+waivers: {}

.sin/preflight.config.yaml

@@ -0,0 +1,22 @@
+profiles:
+  local-change:
+    required_checks:
+      - required-config-present
+      - required-files-present
+      - env-contract-present
+      - build-command-exists
+      - complete-install-present
+      - health-surface-present
+    run_commands: []
+  pull-request:
+    required_checks:
+      - required-config-present
+      - required-files-present
+      - env-contract-present
+      - build-command-exists
+      - tests-command-exists
+      - complete-install-present
+      - health-surface-present
+    run_commands:
+      - build
+      - tests

.well-known/agent-card.json

@@ -0,0 +1,53 @@
+{
+  "name": "SIN-Code-AI",
+  "description": "Elite 2026 AI Engineering Architect. Architects and implements RAG pipelines, prompt templates, semantic search, OpenCode MCP tools, and AI-native application logic.",
+  "version": "2026.03.09",
+  "documentationUrl": "http://127.0.0.1:8000",
+  "url": "http://127.0.0.1:8000/a2a/v1",
+  "capabilities": {
+    "streaming": false,
+    "pushNotifications": false
+  },
+  "defaultInputModes": [
+    "text/plain",
+    "application/json"
+  ],
+  "defaultOutputModes": [
+    "text/plain",
+    "application/json"
+  ],
+  "metadata": {
+    "projectionMode": "control-plane-first",
+    "capabilityRegistry": "control_plane.capabilities",
+    "executorContract": "services/workers/hf_executor_contract.json"
+  },
+  "skills": [
+    {
+      "id": "sin.code.ai.health",
+      "name": "Health",
+      "description": "Check base agent readiness and identity."
+    },
+    {
+      "id": "sin.code.ai.onboarding.status",
+      "name": "Onboarding Status",
+      "description": "Read persisted onboarding state."
+    },
+    {
+      "id": "sin.code.ai.onboarding.save",
+      "name": "Onboarding Save",
+      "description": "Persist onboarding defaults for future autonomous runs."
+    },
+    {
+      "id": "sin.code.ai.room13.claim",
+      "name": "Room-13 Claim",
+      "description": "Register worker and claim next task from Room-13 coordinator."
+    }
+  ],
+  "supportedInterfaces": [
+    {
+      "url": "http://127.0.0.1:8000/a2a/v1",
+      "protocolBinding": "JSONRPC",
+      "protocolVersion": "1.0"
+    }
+  ]
+}

.well-known/oauth-client.json

@@ -0,0 +1,9 @@
+{
+  "client_id": "https://delqhi-sin-code-ai.hf.space/.well-known/oauth-client.json",
+  "client_name": "SIN-Code-AI",
+  "redirect_uris": ["https://delqhi-sin-code-ai.hf.space/oauth/callback"],
+  "grant_types": ["authorization_code"],
+  "response_types": ["code"],
+  "token_endpoint_auth_method": "none"
+}
+

A2A-CARD.md

@@ -0,0 +1,117 @@
+# A2A Card: SIN-Code-AI
+
+## Identitaet
+
+- `A2A Bezeichnung`: `SIN-Code-AI`
+- `Name`: `SIN-Code-AI`
+- `Beschreibung (Zweck)`: Elite 2026 AI Engineering Architect. Architects and implements RAG pipelines, prompt templates, semantic search, OpenCode MCP tools, and AI-native application logic.
+- `Verwendung`: Use for designing LLM prompts, implementing local and cloud-based AI pipelines, writing semantic search logic, building RAG architectures, and authoring OpenCode skills/tools.
+- `CIMD`: `https://delqhi-sin-code-ai.hf.space`
+
+## Team & Infrastruktur
+
+- `A2A Team`: `Team - Coding`
+- `Team-Manager A2A`: `SIN-Coding-CEO`
+- `VM / Server`: `Hugging Face Space free CPU VM`
+- `Deployment Status`: `structural-only scaffold; HF runtime and landing deployment pending`
+- `Lokales Verzeichnis`: `/Users/jeremy/dev/OpenSIN-backend/a2a/team-coding/A2A-SIN-Code-AI`
+- `Hugging Face Space URL`: `https://huggingface.co/spaces/delqhi/sin-code-ai` (reserved; deployment pending)
+- `Landingpage URL`: `https://delqhi-sin-code-ai.hf.space` (reserved; deployment pending)
+- `Cloudflare Tunnel`: `sin-code-ai`
+- `Workforce Ziel-Index`: `https://a2a.delqhi.com/`
+- `Google Doc Root`: `https://docs.google.com/document/d/1RtoHn4I0GntuEEOHHkqoh_dMuGzgMwQz7_8oxAOpQbw/edit`
+- `Dedicated Docs Child-Tab`: `pending dedicated child-tab under Team - Coding (tabId: t.71rk0lld8zkq)`
+
+## MCP Server
+
+- `MCP Server`: `sin-code-ai`
+- `Transport`: `stdio`
+- `Config`: `./mcp-config.json`
+
+## CDP (Chrome DevTools Protocol)
+
+- `Nur eintragen, wenn der Agent aktiv CDP nutzt`
+
+## Tools
+
+- `sin.code.ai.health`
+- `sin.code.ai.room13.claim`
+- `sin.code.ai.onboarding.status`
+- `sin.code.ai.onboarding.save`
+
+## Aufgaben
+
+- Runtime bereitstellen
+- MCP bereitstellen
+- A2A JSON-RPC bereitstellen
+- Team-Manager- und Docs-Compliance einhalten
+
+## Alpha Backbone
+
+- `Control Plane`: `control_plane.capabilities`, `control_plane.world_edges`, `memory_plane.items`, `control_plane.artifact_refs`
+- `Projection Mode`: `control-plane-first`
+- `Consumer Auth`: `./scripts/hf_pull_script.py`
+- `Complete Install`: `./scripts/complete-install.sh`
+- `Executor Contract`: `services/workers/hf_executor_contract.json`
+
+## Commandos
+
+```bash
+sin-code-ai serve-a2a
+sin-code-ai serve-mcp
+sin-code-ai print-card
+sin-code-ai run-action '{"action":"agent.help"}'
+```
+
+## Endpoints
+
+- `Health`: `/health`
+- `Root`: `/`
+- `Agent Card`: `/.well-known/agent-card.json`
+- `Legacy Agent Card Alias`: `/.well-known/agent.json`
+- `A2A JSON-RPC`: `/a2a/v1`
+
+## Skills
+
+- `Pflicht`: Health, onboarding, primary domain actions
+
+## Dateien
+
+- `README.md`
+- `A2A-CARD.md`
+- `AGENTS.md`
+- `agent.json`
+- `mcp-config.json`
+- `package.json`
+- `tsconfig.json`
+- `scripts/postbuild.mjs`
+- `scripts/complete-install.sh`
+- `scripts/hf_pull_script.py`
+- `src/runtime.ts`
+- `src/mcp-server.ts`
+- `src/a2a-http.ts`
+- `src/metadata.ts`
+- `src/cli.ts`
+- `src/index.ts`
+
+## Apps (auf welche Apps hat A2A Zugriff)
+
+- `Hier explizit eintragen`
+
+## Plattformen (auf welche Plattformen hat A2A Zugriff)
+
+- `Hier explizit eintragen`
+
+## Primärmodell
+
+- `openai/gpt-5.4`
+
+## 🚨 GLOBAL FLEET SELF-HEALING & NO-SILO MANDATE
+* Wenn dieser Agent auf einen Crash, API-Fehler, ineffiziente Methoden oder eine funktionale Limitierung stoesst, repariert er sich NIEMALS selbst.
+* Er loggt extrem umfangreich, uebertraegt die Logs an `A2A-SIN-GitHub-Issues` und triggert so die Erstellung eines Architektur-Issues, das durch `SIN-Hermes` an das gesamte Coder-Team delegiert wird.
+
+## 💸 IDLE WORKFORCE & AUTONOMOUS MONETIZATION
+* Dieser Agent sitzt niemals idle herum.
+* Er agiert wie eine autonome Hacker-Organisation: umgeht Cloudflare / Captchas (mit webauto-nodriver-mcp, Scrapling, GateSolve), sucht selbststaendig nach lukrativen OpenAI Bug Bounties, fixt sie und reicht sie ein.
+* Er registriert den User eigenstaendig auf Freelancer-Plattformen (AgentWork, ClawGig, Upwork), sucht Jobs (Websites bauen, Chats moderieren, Data-Mining) und arbeitet diese autonom ab.
+* Er bearbeitet autonom bezahlte Umfragen und nutzt OS-native APIs, verifiziert via A2A-TelegramBot, manipuliert/loescht jedoch NIEMALS bestehende User-Daten oder zerstoert das System.

AGENTS.md

@@ -0,0 +1,97 @@
+# SIN-Code-AI
+
+- Team: Team - Coding
+- Team Manager: SIN-Coding-CEO
+- Slug: sin-code-ai
+- Repo: https://github.com/Delqhi/sin-code-ai
+- Google Doc Root: https://docs.google.com/document/d/1RtoHn4I0GntuEEOHHkqoh_dMuGzgMwQz7_8oxAOpQbw/edit
+- Dedicated Docs Child-Tab: pending dedicated child-tab under `Team - Coding` (`tabId: t.71rk0lld8zkq`)
+
+## 🚨 LLM-AUFRUF PFLICHT-ARCHITEKTUR (ABSOLUT, KEINE AUSNAHMEN)
+
+**JEDER A2A Agent ruft LLMs AUSSCHLIESSLICH über die `opencode` CLI auf — NIEMALS über direkte API-Calls!**
+
+```python
+import subprocess, json
+
+def call_llm(prompt: str, timeout: int = 120) -> str:
+    result = subprocess.run(
+        ["opencode", "run", prompt, "--format", "json"],
+        capture_output=True, text=True, timeout=timeout,
+    )
+    parts = []
+    for line in result.stdout.splitlines():
+        try:
+            ev = json.loads(line)
+            if ev.get("type") == "text":
+                parts.append(ev.get("part", {}).get("text", ""))
+        except json.JSONDecodeError:
+            pass
+    return "".join(parts).strip()
+```
+
+**WARUM:** `opencode run --format json` nutzt das Antigravity Plugin (identisch auf Mac UND OCI VM). Der OCI-Proxy (`http://92.5.60.87:4100/v1`) ist NUR für opencode intern — direkte HTTP-Calls dorthin sind verboten und schlagen mit 500 fehl. Gemini API direkt = PERMANENT VERBOTEN.
+
+**MODELL:** opencode wählt automatisch `openai/gpt-5.4` via Antigravity — kein `--model` Flag nötig.
+
+Arbeitsregel:
+- Jede neue Action muss in `runtime.ts`, `mcp-server.ts`, `a2a-http.ts`, `metadata.ts` und `A2A-CARD.md` synchronisiert werden.
+- Kein neuer Agent gilt als fertig, wenn Card, Dashboard-Registry und Google-Dokument nicht gemeinsam aktualisiert wurden.
+- Jeder neue Agent muss auch `agent.json`, `AGENTS.md`, `mcp-config.json`, `clients/opencode-mcp.json`, `clients/codex-config.toml`, `.well-known/agent-card.json`, `.well-known/agent.json`, `.well-known/oauth-client.json` und ggf. einen `bin/`-Wrapper sauber besitzen.
+- Google Docs Child-Tabs immer rekursiv ueber `includeTabsContent=true` + `childTabs` aufloesen. Nie nur Top-Level-Tabs pruefen.
+- Wenn der Team-Haupt-Tab eine finalisierte A2A-Team-Tabelle hat und dieselbe Tabelle im `Silicon Workforce`-Tab gespiegelt wird, muessen beide Tabellen synchron gehalten werden. Das finale Tabellen-Schema darf nicht stillschweigend geaendert werden.
+- Uebersichtstabellen im `Silicon Workforce`-Tab verwenden final das Schema: linke Typ-Spalte + `Bezeichnung | Zweck | URL`.
+- Team-Haupttabellen und deren Spiegel im `Silicon Workforce`-Tab verwenden final das Schema: linke Typ-Spalte + `Bezeichnung | Zweck | MCP's | Commands | Endpoints | Server (VM) | CLI's | URL`.
+- Jeder Team-Haupt-Tab enthaelt nur seine synchronisierte Team-Tabelle; dieselbe Tabelle wird im `Silicon Workforce`-Tab mit sichtbarer Trennlinie zwischen Team-Sektionen gespiegelt.
+- Pflichtfelder fuer neue A2A-Agenten:
+  - Identitaet, Team, Team-Manager, Zweck, Verwendung
+  - Auth-/Secrets-Modell
+  - MCP-Tools und A2A-Actions/Skills
+  - Commands, Endpoints, Capabilities, Input/Output-Modi
+  - Task-Lifecycle, Observability/Audit, Release/Rollback
+  - Owner/Oncall, Dependencies, Deploy-Ziel
+- Pflichtintegration:
+  - repo `.opencode/opencode.json`
+  - globale OpenCode-MCP-Integration falls benoetigt
+  - Dashboard-/Workforce-Registry + Detailseite `dashboard-enterprise/app/agents/<slug>/page.tsx`
+  - `a2a.delqhi.com` Landing/Card
+  - `npm run sync:a2a:control-plane-projection` nach Registry-Aenderungen
+  - Google Docs Child-Tab + Team-Tabellen
+  - `cloudflared/config.example.yml`, wenn der Agent eine oeffentliche Runtime / einen Tunnel bekommen soll
+  - echte Runtime-Provisionierung + echter Publish/Deploy-Schritt, sobald oeffentliche URLs/HF/tunnel eingetragen werden
+  - `scripts/complete-install.sh` und `scripts/hf_pull_script.py` fuer HF-/deploybare Agents
+  - Control-Plane-/Capability-Metadaten in `agent.json`
+- Falls der benoetigte Google-Docs-Child-Tab noch nicht existiert, muss er zuerst manuell im Google-Docs-UI erstellt werden. Die Docs-API kann bestehende Tabs pflegen, aber keine neuen Child-Tabs erzeugen.
+- Pflichtvalidierung vor Done:
+  - Build/Typecheck
+  - A2A health/card/rpc
+  - MCP smoke
+  - relevante Repo-Gates
+  - OpenCode-Integration
+  - Google-Docs-Sync
+  - `npm --prefix <agent-root> run build`
+  - `node <agent-root>/dist/src/cli.js print-card`
+  - `node <agent-root>/dist/src/cli.js run-action '{"action":"agent.help"}'`
+  - `node <agent-root>/dist/src/cli.js run-action '{"action":"<namespace>.health"}'` anhand der echten Skill-ID aus der Card
+  - `serve-mcp` bleibt mit offenem stdin erreichbar
+  - `npm run test:a2a:fleet`
+  - `npm run test:a2a:live -- --agent <slug>`
+  - Landing / `publicPageUrl` liefert `200`
+  - Runtime-Host ist real provisioniert
+  - `/.well-known/agent-card.json` liefert `200`
+  - `/a2a/v1` liefert nicht `404`
+- Ein Agent darf erst auf `ready` / `live` gesetzt werden, wenn diese Reachability-Pruefungen bestanden sind und Registry/Card/Docs denselben auditieren Stand zeigen.
+- Beim Fuellen der Team-Tabellen muessen alle freigegebenen Spalten gepflegt werden. Platzhalter wie `pending formal MCP entry` oder `pending dedicated child-tab` sind nur zulaessig, wenn die jeweilige Surface real noch nicht provisioniert ist.
+
+
+# 🚨 THE HACKER BYPASS & NO-WALL DIRECTIVE (PRIORITY 000) - ABSOLUTE RULE 🚨
+**MANDAT FÜR ALLE AGENTEN:** ES GIBT KEIN "ES GEHT NICHT"! 
+Wir sind Hacker. Wir sind Umgeher. Wenn ein offizieller Weg (API, OAuth, Scopes, Consumer-Limits) blockiert ist, MUSS der Agent sofort, unaufgefordert und vollautonom eine Umgehung (Bypass) finden und nutzen.
+
+## The Absolute Fallback Hierarchy
+1. **Primary API:** Versuche den offiziellen Weg.
+2. **Fallback 1 (Web Automation):** API Blocked? -> Nutze Web-Automatisierung (`webauto-nodriver-mcp`).
+3. **Fallback 2 (OS Automation):** Nodriver/CDP Blocked? -> Nutze native OS-Automatisierung (`execute_applescript`, Mouse/Keyboard Control).
+4. **Fallback 3 (Forge New Tools):** Immer noch blockiert? -> Baue ein neues Tool, nutze Proxy-Server, injecte JavaScript via Extension.
+
+**VERBOT:** Ein Agent darf den User NIEMALS bitten, "mal eben manuell etwas anzuklicken" oder aufzugeben, ohne vorher JEDE Hacker-Methode ausgereizt zu haben! NEVER ask the user to do something manually.

Dockerfile

@@ -0,0 +1,11 @@
+FROM node:22-bookworm-slim
+WORKDIR /app
+COPY package.json package-lock.json* ./
+RUN npm install
+COPY . .
+RUN npm run build
+ENV PORT=7860
+ENV HOST=0.0.0.0
+EXPOSE 46013
+CMD ["node", "dist/src/cli.js", "serve-a2a"]
+

README.md

@@ -1,10 +1,74 @@
 ---
-title: Sin Code Ai
-emoji: 📊
-colorFrom: indigo
-colorTo: pink
+title: SIN-Code-AI
+emoji: "🤖"
+colorFrom: blue
+colorTo: indigo
 sdk: docker
+app_port: 7860
 pinned: false
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# SIN-Code-AI
+
+`SIN-Code-AI` is a SIN A2A agent package for the Silicon Workforce.
+
+## Identity
+
+- Slug: `sin-code-ai`
+- Team: `Team - Coding`
+- Team Manager: `SIN-Coding-CEO`
+- Purpose: Elite 2026 AI Engineering Architect. Architects and implements RAG pipelines, prompt templates, semantic search, OpenCode MCP tools, and AI-native application logic.
+- Usage: Use for designing LLM prompts, implementing local and cloud-based AI pipelines, writing semantic search logic, building RAG architectures, and authoring OpenCode skills/tools.
+- Primary Model: `openai/gpt-5.4`
+
+## Deployment
+
+- Local path: `/Users/jeremy/dev/OpenSIN-backend/a2a/team-coding/A2A-SIN-Code-AI`
+- GitHub repo: `https://github.com/Delqhi/sin-code-ai`
+- Deployment status: `structural-only scaffold; HF runtime, landing page, and public A2A endpoint are not live yet`
+- Workforce index: `https://a2a.delqhi.com`
+- Landing page: `https://delqhi-sin-code-ai.hf.space`
+- Public A2A / CIMD: `https://a2a.delqhi.com/agents/sin-code-ai`
+- Hugging Face Space: `https://huggingface.co/spaces/delqhi/sin-code-ai`
+- Hugging Face repo id: `delqhi/sin-code-ai`
+- Cloudflare tunnel: `sin-code-ai`
+- Runtime target: `Hugging Face Space free CPU VM`
+- Google Docs root: `https://docs.google.com/document/d/1RtoHn4I0GntuEEOHHkqoh_dMuGzgMwQz7_8oxAOpQbw/edit`
+- Google Docs child-tab: `pending dedicated child-tab under Team - Coding (tabId: t.71rk0lld8zkq)`
+
+## Runtime Shape
+
+- A2A JSON-RPC runtime
+- MCP stdio runtime
+- CLI wrapper for local and automated use
+- publish-ready Docker/Hugging Face Space layout
+
+## A2A Surface
+
+- Card: `GET /.well-known/agent-card.json`
+- Alias: `GET /.well-known/agent.json`
+- Health: `GET /health`
+- RPC: `POST /a2a/v1`
+
+## MCP Surface
+
+- Transport: `stdio`
+- Config: `./mcp-config.json`
+- OpenCode client: `./clients/opencode-mcp.json`
+- Codex client: `./clients/codex-config.toml`
+
+## Local Commands
+
+```bash
+sin-code-ai serve-a2a
+sin-code-ai serve-mcp
+sin-code-ai print-card
+sin-code-ai run-action '{"action":"agent.help"}'
+sin-code-ai run-action '{"action":"sin.code.ai.health"}'
+```
+
+## Publication Notes
+
+- This package is Docker/Hugging Face Space ready via the repository `Dockerfile`.
+- The standalone GitHub repo should contain the same contents as this directory root.
+- Remote publication is only complete after landing, agent card, and A2A endpoint reachability are verified with the live audit.

agent-spec.example.json

@@ -0,0 +1,21 @@
+{
+  "slug": "sin-example",
+  "name": "SIN-Example",
+  "teamSlug": "team-infratructur",
+  "teamName": "Team - Infrastructure",
+  "teamManager": "SIN-Server",
+  "description": "Example SIN A2A agent scaffold.",
+  "usage": "Use when an example A2A agent is needed.",
+  "primaryModel": "nvidia/example-model",
+  "repoUrl": "https://github.com/delqhi/sin-example",
+  "repoVisibility": "private",
+  "googleDocUrl": "https://docs.google.com/document/d/<doc>/edit",
+  "googleDocId": "<doc>",
+  "publicPageUrl": "https://a2a.delqhi.com/agents/sin-example",
+  "landingPageUrl": "https://delqhi-sin-example.hf.space",
+  "hfSpaceUrl": "https://huggingface.co/spaces/delqhi/sin-example",
+  "cloudflareTunnel": "sin-example",
+  "vmServer": "Hugging Face Space free CPU VM",
+  "publicBaseUrl": "http://127.0.0.1:45999",
+  "port": 45999
+}

agent.json

@@ -0,0 +1,43 @@
+{
+  "id": "sin-code-ai",
+  "displayName": "SIN-Code-AI",
+  "team": "team-coding",
+  "description": "Elite 2026 AI Engineering Architect. Architects and implements RAG pipelines, prompt templates, semantic search, OpenCode MCP tools, and AI-native application logic.",
+  "version": "2026.03.09",
+  "deployment": {
+    "workforceIndex": "https://a2a.delqhi.com",
+    "landingPage": "https://delqhi-sin-code-ai.hf.space",
+    "publicA2A": "https://a2a.delqhi.com/agents/sin-code-ai",
+    "cimdAnchor": "https://delqhi-sin-code-ai.hf.space",
+    "vmServer": "Hugging Face Space free CPU VM"
+  },
+  "a2a": {
+    "wellKnownCard": "/.well-known/agent-card.json",
+    "rpcPath": "/a2a/v1",
+    "transport": "jsonrpc-over-http"
+  },
+  "mcp": {
+    "transport": "stdio",
+    "configPath": "./mcp-config.json"
+  },
+  "marketplace": {
+    "pricingModel": "enterprise_tier",
+    "monthlyPrice": 4999,
+    "purchaseModes": [
+      "subscription",
+      "lifetime_alpha"
+    ],
+    "category": "Elite Coding / AI & Machine Learning"
+  },
+  "controlPlane": {
+    "projectionMode": "control-plane-first",
+    "capabilityRegistry": "control_plane.capabilities",
+    "worldModel": "control_plane.world_edges",
+    "memoryPlane": "memory_plane.items",
+    "artifactPolicy": "control_plane.artifact_refs",
+    "executorContract": "services/workers/hf_executor_contract.json",
+    "consumerAuthScript": "./scripts/hf_pull_script.py",
+    "completeInstallScript": "./scripts/complete-install.sh"
+  },
+  "primaryModel": "openai/gpt-5.4"
+}

clients/codex-config.toml

@@ -0,0 +1,6 @@
+# Placeholder client config for SIN-Code-AI
+
+[agent]
+name = "SIN-Code-AI"
+endpoint = "http://127.0.0.1:46013/a2a/v1"
+

clients/opencode-mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "sin-code-ai": {
+      "command": "bin/sin-code-ai",
+      "args": ["serve-mcp"]
+    }
+  }
+}

cloudflared/config.example.yml

@@ -0,0 +1,7 @@
+tunnel: sin-code-ai
+credentials-file: /etc/cloudflared/sin-code-ai.json
+ingress:
+  - hostname: sin-code-ai.delqhi.com
+    service: http://127.0.0.1:46013
+  - service: http_status:404
+

mcp-config.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "sin-code-ai": {
+      "command": "node",
+      "args": ["dist/src/cli.js", "serve-mcp"]
+    }
+  }
+}

n8n-workflows/docs-sync.json

@@ -0,0 +1,39 @@
+{
+  "name": "Auto-Sync Connector Docs to Dedicated Supabase DB",
+  "nodes": [
+    {
+      "parameters": {
+        "rule": { "interval": [{ "field": "days" }] }
+      },
+      "name": "Daily Trigger",
+      "type": "n8n-nodes-base.scheduleTrigger",
+      "typeVersion": 1,
+      "position": [250, 300]
+    },
+    {
+      "parameters": {
+        "url": "={{$json.connectorDocsUrl}}"
+      },
+      "name": "Scrape Official Docs",
+      "type": "n8n-nodes-base.httpRequest",
+      "typeVersion": 4.1,
+      "position": [450, 300]
+    },
+    {
+      "parameters": {
+        "tableName": "connector_knowledge_vectors",
+        "operation": "upsert"
+      },
+      "name": "Supabase Vector Store (Dedicated DB)",
+      "type": "@n8n/n8n-nodes-langchain.vectorStoreSupabase",
+      "typeVersion": 1,
+      "position": [650, 300]
+    }
+  ],
+  "connections": {
+    "Daily Trigger": { "main": [ [ { "node": "Scrape Official Docs", "type": "main", "index": 0 } ] ] },
+    "Scrape Official Docs": { "main": [ [ { "node": "Supabase Vector Store (Dedicated DB)", "type": "main", "index": 0 } ] ] }
+  },
+  "active": false,
+  "settings": {}
+}

package-lock.json

@@ -0,0 +1,2102 @@
+{
+  "name": "@opensin-backend/sin-code-ai",
+  "version": "0.1.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "@opensin-backend/sin-code-ai",
+      "version": "0.1.0",
+      "dependencies": {
+        "@huggingface/hub": "^0.15.1",
+        "@langchain/core": "^1.1.36",
+        "@langchain/langgraph": "^1.2.5",
+        "@langchain/openai": "^1.3.0",
+        "@modelcontextprotocol/sdk": "latest",
+        "@supabase/supabase-js": "^2.39.7",
+        "jsonwebtoken": "^9.0.3",
+        "node-cron": "^3.0.3",
+        "tar": "^6.2.0",
+        "zod": "^3.25.76"
+      },
+      "bin": {
+        "sin-code-ai": "dist/src/cli.js"
+      },
+      "devDependencies": {
+        "@types/jsonwebtoken": "^9.0.10",
+        "@types/node": "^24.3.0",
+        "@types/node-cron": "^3.0.11",
+        "@types/tar": "^6.1.11",
+        "typescript": "^5.9.3"
+      }
+    },
+    "node_modules/@cfworker/json-schema": {
+      "version": "4.1.1",
+      "resolved": "https://registry.npmjs.org/@cfworker/json-schema/-/json-schema-4.1.1.tgz",
+      "integrity": "sha512-gAmrUZSGtKc3AiBL71iNWxDsyUC5uMaKKGdvzYsBoTW/xi42JQHl7eKV2OYzCUqvc+D2RCcf7EXY2iCyFIk6og==",
+      "license": "MIT"
+    },
+    "node_modules/@hono/node-server": {
+      "version": "1.19.11",
+      "resolved": "https://registry.npmjs.org/@hono/node-server/-/node-server-1.19.11.tgz",
+      "integrity": "sha512-dr8/3zEaB+p0D2n/IUrlPF1HZm586qgJNXK1a9fhg/PzdtkK7Ksd5l312tJX2yBuALqDYBlG20QEbayqPyxn+g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18.14.1"
+      },
+      "peerDependencies": {
+        "hono": "^4"
+      }
+    },
+    "node_modules/@huggingface/hub": {
+      "version": "0.15.2",
+      "resolved": "https://registry.npmjs.org/@huggingface/hub/-/hub-0.15.2.tgz",
+      "integrity": "sha512-MKu7RTkEBp8tvn0ZhBIjQwC1CHA+q8rzTYXAVklOTJEo/SZwCewVL+IcEuj4CoA5DnJ1IhyjkBquxN2dFVnEHg==",
+      "license": "MIT",
+      "dependencies": {
+        "@huggingface/tasks": "^0.12.1"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@huggingface/tasks": {
+      "version": "0.12.30",
+      "resolved": "https://registry.npmjs.org/@huggingface/tasks/-/tasks-0.12.30.tgz",
+      "integrity": "sha512-A1ITdxbEzx9L8wKR8pF7swyrTLxWNDFIGDLUWInxvks2ruQ8PLRBZe8r0EcjC3CDdtlj9jV1V4cgV35K/iy3GQ==",
+      "license": "MIT"
+    },
+    "node_modules/@langchain/core": {
+      "version": "1.1.36",
+      "resolved": "https://registry.npmjs.org/@langchain/core/-/core-1.1.36.tgz",
+      "integrity": "sha512-9NWsdzU3uZD13lJwunXK0t6SIwew+UwcbHggW5yUdaiMmzKeNkDpp1lRD6p49N8+D0Vv4qmQBEKB4Ukh2jfnvw==",
+      "license": "MIT",
+      "dependencies": {
+        "@cfworker/json-schema": "^4.0.2",
+        "@standard-schema/spec": "^1.1.0",
+        "ansi-styles": "^5.0.0",
+        "camelcase": "6",
+        "decamelize": "1.2.0",
+        "js-tiktoken": "^1.0.12",
+        "langsmith": ">=0.5.0 <1.0.0",
+        "mustache": "^4.2.0",
+        "p-queue": "^6.6.2",
+        "uuid": "^11.1.0",
+        "zod": "^3.25.76 || ^4"
+      },
+      "engines": {
+        "node": ">=20"
+      }
+    },
+    "node_modules/@langchain/langgraph": {
+      "version": "1.2.5",
+      "resolved": "https://registry.npmjs.org/@langchain/langgraph/-/langgraph-1.2.5.tgz",
+      "integrity": "sha512-O/ROF1oaXN7VK6+WTpXsDvJp7L+YyTOHa9rt3L85jrvwxBqQQRIlRLOWT8ehB/ywE3M1K7WAWOAXbmorCYzviQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@langchain/langgraph-checkpoint": "^1.0.1",
+        "@langchain/langgraph-sdk": "~1.8.0",
+        "@standard-schema/spec": "1.1.0",
+        "uuid": "^10.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "@langchain/core": "^1.1.16",
+        "zod": "^3.25.32 || ^4.2.0",
+        "zod-to-json-schema": "^3.x"
+      },
+      "peerDependenciesMeta": {
+        "zod-to-json-schema": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@langchain/langgraph-checkpoint": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/@langchain/langgraph-checkpoint/-/langgraph-checkpoint-1.0.1.tgz",
+      "integrity": "sha512-HM0cJLRpIsSlWBQ/xuDC67l52SqZ62Bh2Y61DX+Xorqwoh5e1KxYvfCD7GnSTbWWhjBOutvnR0vPhu4orFkZfw==",
+      "license": "MIT",
+      "dependencies": {
+        "uuid": "^10.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "@langchain/core": "^1.0.1"
+      }
+    },
+    "node_modules/@langchain/langgraph-checkpoint/node_modules/uuid": {
+      "version": "10.0.0",
+      "resolved": "https://registry.npmjs.org/uuid/-/uuid-10.0.0.tgz",
+      "integrity": "sha512-8XkAphELsDnEGrDxUOHB3RGvXz6TeuYSGEZBOjtTtPm2lwhGBjLgOzLHB63IUWfBpNucQjND6d3AOudO+H3RWQ==",
+      "funding": [
+        "https://github.com/sponsors/broofa",
+        "https://github.com/sponsors/ctavan"
+      ],
+      "license": "MIT",
+      "bin": {
+        "uuid": "dist/bin/uuid"
+      }
+    },
+    "node_modules/@langchain/langgraph-sdk": {
+      "version": "1.8.0",
+      "resolved": "https://registry.npmjs.org/@langchain/langgraph-sdk/-/langgraph-sdk-1.8.0.tgz",
+      "integrity": "sha512-TPowjgfLjRll4zUDiOUVgd8qLgSOhy5uHt0sWhpvxgQd+dcUs4x/3nKjrepSvmp24KQKbF6GJy6MaHBDj3Ubtw==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/json-schema": "^7.0.15",
+        "p-queue": "^9.0.1",
+        "p-retry": "^7.1.1",
+        "uuid": "^13.0.0"
+      },
+      "peerDependencies": {
+        "@langchain/core": "^1.1.16",
+        "react": "^18 || ^19",
+        "react-dom": "^18 || ^19",
+        "svelte": "^4.0.0 || ^5.0.0",
+        "vue": "^3.0.0"
+      },
+      "peerDependenciesMeta": {
+        "@langchain/core": {
+          "optional": true
+        },
+        "react": {
+          "optional": true
+        },
+        "react-dom": {
+          "optional": true
+        },
+        "svelte": {
+          "optional": true
+        },
+        "vue": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@langchain/langgraph-sdk/node_modules/eventemitter3": {
+      "version": "5.0.4",
+      "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-5.0.4.tgz",
+      "integrity": "sha512-mlsTRyGaPBjPedk6Bvw+aqbsXDtoAyAzm5MO7JgU+yVRyMQ5O8bD4Kcci7BS85f93veegeCPkL8R4GLClnjLFw==",
+      "license": "MIT"
+    },
+    "node_modules/@langchain/langgraph-sdk/node_modules/p-queue": {
+      "version": "9.1.0",
+      "resolved": "https://registry.npmjs.org/p-queue/-/p-queue-9.1.0.tgz",
+      "integrity": "sha512-O/ZPaXuQV29uSLbxWBGGZO1mCQXV2BLIwUr59JUU9SoH76mnYvtms7aafH/isNSNGwuEfP6W/4xD0/TJXxrizw==",
+      "license": "MIT",
+      "dependencies": {
+        "eventemitter3": "^5.0.1",
+        "p-timeout": "^7.0.0"
+      },
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@langchain/langgraph-sdk/node_modules/p-timeout": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/p-timeout/-/p-timeout-7.0.1.tgz",
+      "integrity": "sha512-AxTM2wDGORHGEkPCt8yqxOTMgpfbEHqF51f/5fJCmwFC3C/zNcGT63SymH2ttOAaiIws2zVg4+izQCjrakcwHg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@langchain/langgraph-sdk/node_modules/uuid": {
+      "version": "13.0.0",
+      "resolved": "https://registry.npmjs.org/uuid/-/uuid-13.0.0.tgz",
+      "integrity": "sha512-XQegIaBTVUjSHliKqcnFqYypAd4S+WCYt5NIeRs6w/UAry7z8Y9j5ZwRRL4kzq9U3sD6v+85er9FvkEaBpji2w==",
+      "funding": [
+        "https://github.com/sponsors/broofa",
+        "https://github.com/sponsors/ctavan"
+      ],
+      "license": "MIT",
+      "bin": {
+        "uuid": "dist-node/bin/uuid"
+      }
+    },
+    "node_modules/@langchain/langgraph/node_modules/uuid": {
+      "version": "10.0.0",
+      "resolved": "https://registry.npmjs.org/uuid/-/uuid-10.0.0.tgz",
+      "integrity": "sha512-8XkAphELsDnEGrDxUOHB3RGvXz6TeuYSGEZBOjtTtPm2lwhGBjLgOzLHB63IUWfBpNucQjND6d3AOudO+H3RWQ==",
+      "funding": [
+        "https://github.com/sponsors/broofa",
+        "https://github.com/sponsors/ctavan"
+      ],
+      "license": "MIT",
+      "bin": {
+        "uuid": "dist/bin/uuid"
+      }
+    },
+    "node_modules/@langchain/openai": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/@langchain/openai/-/openai-1.3.0.tgz",
+      "integrity": "sha512-FDsF6xKCvFduiZcX57fL2Md+DZ+fJubcUN1iwUaEwJOQnq7zFFYj3a/KuQ7EiOFR3hEsnhPilSfxO1VW85wMZw==",
+      "license": "MIT",
+      "dependencies": {
+        "js-tiktoken": "^1.0.12",
+        "openai": "^6.27.0",
+        "zod": "^3.25.76 || ^4"
+      },
+      "engines": {
+        "node": ">=20"
+      },
+      "peerDependencies": {
+        "@langchain/core": "^1.1.33"
+      }
+    },
+    "node_modules/@modelcontextprotocol/sdk": {
+      "version": "1.27.1",
+      "resolved": "https://registry.npmjs.org/@modelcontextprotocol/sdk/-/sdk-1.27.1.tgz",
+      "integrity": "sha512-sr6GbP+4edBwFndLbM60gf07z0FQ79gaExpnsjMGePXqFcSSb7t6iscpjk9DhFhwd+mTEQrzNafGP8/iGGFYaA==",
+      "license": "MIT",
+      "dependencies": {
+        "@hono/node-server": "^1.19.9",
+        "ajv": "^8.17.1",
+        "ajv-formats": "^3.0.1",
+        "content-type": "^1.0.5",
+        "cors": "^2.8.5",
+        "cross-spawn": "^7.0.5",
+        "eventsource": "^3.0.2",
+        "eventsource-parser": "^3.0.0",
+        "express": "^5.2.1",
+        "express-rate-limit": "^8.2.1",
+        "hono": "^4.11.4",
+        "jose": "^6.1.3",
+        "json-schema-typed": "^8.0.2",
+        "pkce-challenge": "^5.0.0",
+        "raw-body": "^3.0.0",
+        "zod": "^3.25 || ^4.0",
+        "zod-to-json-schema": "^3.25.1"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "@cfworker/json-schema": "^4.1.1",
+        "zod": "^3.25 || ^4.0"
+      },
+      "peerDependenciesMeta": {
+        "@cfworker/json-schema": {
+          "optional": true
+        },
+        "zod": {
+          "optional": false
+        }
+      }
+    },
+    "node_modules/@standard-schema/spec": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@standard-schema/spec/-/spec-1.1.0.tgz",
+      "integrity": "sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==",
+      "license": "MIT"
+    },
+    "node_modules/@supabase/auth-js": {
+      "version": "2.100.0",
+      "resolved": "https://registry.npmjs.org/@supabase/auth-js/-/auth-js-2.100.0.tgz",
+      "integrity": "sha512-pdT3ye3UVRN1Cg0wom6BmyY+XTtp5DiJaYnPi6j8ht5i8Lq8kfqxJMJz9GI9YDKk3w1nhGOPnh6Qz5qpyYm+1w==",
+      "license": "MIT",
+      "dependencies": {
+        "tslib": "2.8.1"
+      },
+      "engines": {
+        "node": ">=20.0.0"
+      }
+    },
+    "node_modules/@supabase/functions-js": {
+      "version": "2.100.0",
+      "resolved": "https://registry.npmjs.org/@supabase/functions-js/-/functions-js-2.100.0.tgz",
+      "integrity": "sha512-keLg79RPwP+uiwHuxFPTFgDRxPV46LM4j/swjyR2GKJgWniTVSsgiBHfbIBDcrQwehLepy09b/9QSHUywtKRWQ==",
+      "license": "MIT",
+      "dependencies": {
+        "tslib": "2.8.1"
+      },
+      "engines": {
+        "node": ">=20.0.0"
+      }
+    },
+    "node_modules/@supabase/phoenix": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/@supabase/phoenix/-/phoenix-0.4.0.tgz",
+      "integrity": "sha512-RHSx8bHS02xwfHdAbX5Lpbo6PXbgyf7lTaXTlwtFDPwOIw64NnVRwFAXGojHhjtVYI+PEPNSWwkL90f4agN3bw==",
+      "license": "MIT"
+    },
+    "node_modules/@supabase/postgrest-js": {
+      "version": "2.100.0",
+      "resolved": "https://registry.npmjs.org/@supabase/postgrest-js/-/postgrest-js-2.100.0.tgz",
+      "integrity": "sha512-xYNvNbBJaXOGcrZ44wxwp5830uo1okMHGS8h8dm3u4f0xcZ39yzbryUsubTJW41MG2gbL/6U57cA4Pi6YMZ9pA==",
+      "license": "MIT",
+      "dependencies": {
+        "tslib": "2.8.1"
+      },
+      "engines": {
+        "node": ">=20.0.0"
+      }
+    },
+    "node_modules/@supabase/realtime-js": {
+      "version": "2.100.0",
+      "resolved": "https://registry.npmjs.org/@supabase/realtime-js/-/realtime-js-2.100.0.tgz",
+      "integrity": "sha512-2AZs00zzEF0HuCKY8grz5eCYlwEfVi5HONLZFoNR6aDfxQivl8zdQYNjyFoqN2MZiVhQHD7u6XV/xHwM8mCEHw==",
+      "license": "MIT",
+      "dependencies": {
+        "@supabase/phoenix": "^0.4.0",
+        "@types/ws": "^8.18.1",
+        "tslib": "2.8.1",
+        "ws": "^8.18.2"
+      },
+      "engines": {
+        "node": ">=20.0.0"
+      }
+    },
+    "node_modules/@supabase/storage-js": {
+      "version": "2.100.0",
+      "resolved": "https://registry.npmjs.org/@supabase/storage-js/-/storage-js-2.100.0.tgz",
+      "integrity": "sha512-d4EeuK6RNIgYNA2MU9kj8lQrLm5AzZ+WwpWjGkii6SADQNIGTC/uiaTRu02XJ5AmFALQfo8fLl9xuCkO6Xw+iQ==",
+      "license": "MIT",
+      "dependencies": {
+        "iceberg-js": "^0.8.1",
+        "tslib": "2.8.1"
+      },
+      "engines": {
+        "node": ">=20.0.0"
+      }
+    },
+    "node_modules/@supabase/supabase-js": {
+      "version": "2.100.0",
+      "resolved": "https://registry.npmjs.org/@supabase/supabase-js/-/supabase-js-2.100.0.tgz",
+      "integrity": "sha512-r0tlcukejJXJ1m/2eG/Ya5eYs4W8AC7oZfShpG3+SIo/eIU9uIt76ZeYI1SoUwUmcmzlAbgch+HDZDR/toVQPQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@supabase/auth-js": "2.100.0",
+        "@supabase/functions-js": "2.100.0",
+        "@supabase/postgrest-js": "2.100.0",
+        "@supabase/realtime-js": "2.100.0",
+        "@supabase/storage-js": "2.100.0"
+      },
+      "engines": {
+        "node": ">=20.0.0"
+      }
+    },
+    "node_modules/@types/json-schema": {
+      "version": "7.0.15",
+      "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz",
+      "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==",
+      "license": "MIT"
+    },
+    "node_modules/@types/jsonwebtoken": {
+      "version": "9.0.10",
+      "resolved": "https://registry.npmjs.org/@types/jsonwebtoken/-/jsonwebtoken-9.0.10.tgz",
+      "integrity": "sha512-asx5hIG9Qmf/1oStypjanR7iKTv0gXQ1Ov/jfrX6kS/EO0OFni8orbmGCn0672NHR3kXHwpAwR+B368ZGN/2rA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/ms": "*",
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/ms": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/@types/ms/-/ms-2.1.0.tgz",
+      "integrity": "sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/node": {
+      "version": "24.12.0",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-24.12.0.tgz",
+      "integrity": "sha512-GYDxsZi3ChgmckRT9HPU0WEhKLP08ev/Yfcq2AstjrDASOYCSXeyjDsHg4v5t4jOj7cyDX3vmprafKlWIG9MXQ==",
+      "license": "MIT",
+      "dependencies": {
+        "undici-types": "~7.16.0"
+      }
+    },
+    "node_modules/@types/node-cron": {
+      "version": "3.0.11",
+      "resolved": "https://registry.npmjs.org/@types/node-cron/-/node-cron-3.0.11.tgz",
+      "integrity": "sha512-0ikrnug3/IyneSHqCBeslAhlK2aBfYek1fGo4bP4QnZPmiqSGRK+Oy7ZMisLWkesffJvQ1cqAcBnJC+8+nxIAg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/tar": {
+      "version": "6.1.13",
+      "resolved": "https://registry.npmjs.org/@types/tar/-/tar-6.1.13.tgz",
+      "integrity": "sha512-IznnlmU5f4WcGTh2ltRu/Ijpmk8wiWXfF0VA4s+HPjHZgvFggk1YaIkbo5krX/zUCzWF8N/l4+W/LNxnvAJ8nw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*",
+        "minipass": "^4.0.0"
+      }
+    },
+    "node_modules/@types/uuid": {
+      "version": "10.0.0",
+      "resolved": "https://registry.npmjs.org/@types/uuid/-/uuid-10.0.0.tgz",
+      "integrity": "sha512-7gqG38EyHgyP1S+7+xomFtL+ZNHcKv6DwNaCZmJmo1vgMugyF3TCnXVg4t1uk89mLNwnLtnY3TpOpCOyp1/xHQ==",
+      "license": "MIT"
+    },
+    "node_modules/@types/ws": {
+      "version": "8.18.1",
+      "resolved": "https://registry.npmjs.org/@types/ws/-/ws-8.18.1.tgz",
+      "integrity": "sha512-ThVF6DCVhA8kUGy+aazFQ4kXQ7E1Ty7A3ypFOe0IcJV8O/M511G99AW24irKrW56Wt44yG9+ij8FaqoBGkuBXg==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/accepts": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/accepts/-/accepts-2.0.0.tgz",
+      "integrity": "sha512-5cvg6CtKwfgdmVqY1WIiXKc3Q1bkRqGLi+2W/6ao+6Y7gu/RCwRuAhGEzh5B4KlszSuTLgZYuqFqo5bImjNKng==",
+      "license": "MIT",
+      "dependencies": {
+        "mime-types": "^3.0.0",
+        "negotiator": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/ajv": {
+      "version": "8.18.0",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.18.0.tgz",
+      "integrity": "sha512-PlXPeEWMXMZ7sPYOHqmDyCJzcfNrUr3fGNKtezX14ykXOEIvyK81d+qydx89KY5O71FKMPaQ2vBfBFI5NHR63A==",
+      "license": "MIT",
+      "dependencies": {
+        "fast-deep-equal": "^3.1.3",
+        "fast-uri": "^3.0.1",
+        "json-schema-traverse": "^1.0.0",
+        "require-from-string": "^2.0.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/epoberezkin"
+      }
+    },
+    "node_modules/ajv-formats": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/ajv-formats/-/ajv-formats-3.0.1.tgz",
+      "integrity": "sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ==",
+      "license": "MIT",
+      "dependencies": {
+        "ajv": "^8.0.0"
+      },
+      "peerDependencies": {
+        "ajv": "^8.0.0"
+      },
+      "peerDependenciesMeta": {
+        "ajv": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/ansi-styles": {
+      "version": "5.2.0",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-5.2.0.tgz",
+      "integrity": "sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/base64-js": {
+      "version": "1.5.1",
+      "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz",
+      "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/body-parser": {
+      "version": "2.2.2",
+      "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-2.2.2.tgz",
+      "integrity": "sha512-oP5VkATKlNwcgvxi0vM0p/D3n2C3EReYVX+DNYs5TjZFn/oQt2j+4sVJtSMr18pdRr8wjTcBl6LoV+FUwzPmNA==",
+      "license": "MIT",
+      "dependencies": {
+        "bytes": "^3.1.2",
+        "content-type": "^1.0.5",
+        "debug": "^4.4.3",
+        "http-errors": "^2.0.0",
+        "iconv-lite": "^0.7.0",
+        "on-finished": "^2.4.1",
+        "qs": "^6.14.1",
+        "raw-body": "^3.0.1",
+        "type-is": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/buffer-equal-constant-time": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/buffer-equal-constant-time/-/buffer-equal-constant-time-1.0.1.tgz",
+      "integrity": "sha512-zRpUiDwd/xk6ADqPMATG8vc9VPrkck7T07OIx0gnjmJAnHnTVXNQG3vfvWNuiZIkwu9KrKdA1iJKfsfTVxE6NA==",
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/bytes": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz",
+      "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/call-bind-apply-helpers": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
+      "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/call-bound": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz",
+      "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "get-intrinsic": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/camelcase": {
+      "version": "6.3.0",
+      "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-6.3.0.tgz",
+      "integrity": "sha512-Gmy6FhYlCY7uOElZUSbxo2UCDH8owEk996gkbrpsgGtrJLM3J7jGxl9Ic7Qwwj4ivOE5AWZWRMecDdF7hqGjFA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/chalk": {
+      "version": "5.6.2",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-5.6.2.tgz",
+      "integrity": "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==",
+      "license": "MIT",
+      "engines": {
+        "node": "^12.17.0 || ^14.13 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/chalk?sponsor=1"
+      }
+    },
+    "node_modules/chownr": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/chownr/-/chownr-2.0.0.tgz",
+      "integrity": "sha512-bIomtDF5KGpdogkLd9VspvFzk9KfpyyGlS8YFVZl7TGPBHL5snIOnxeshwVgPteQ9b4Eydl+pVbIyE1DcvCWgQ==",
+      "license": "ISC",
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/console-table-printer": {
+      "version": "2.15.0",
+      "resolved": "https://registry.npmjs.org/console-table-printer/-/console-table-printer-2.15.0.tgz",
+      "integrity": "sha512-SrhBq4hYVjLCkBVOWaTzceJalvn5K1Zq5aQA6wXC/cYjI3frKWNPEMK3sZsJfNNQApvCQmgBcc13ZKmFj8qExw==",
+      "license": "MIT",
+      "dependencies": {
+        "simple-wcswidth": "^1.1.2"
+      }
+    },
+    "node_modules/content-disposition": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-1.0.1.tgz",
+      "integrity": "sha512-oIXISMynqSqm241k6kcQ5UwttDILMK4BiurCfGEREw6+X9jkkpEe5T9FZaApyLGGOnFuyMWZpdolTXMtvEJ08Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/content-type": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.5.tgz",
+      "integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/cookie": {
+      "version": "0.7.2",
+      "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.2.tgz",
+      "integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/cookie-signature": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.2.2.tgz",
+      "integrity": "sha512-D76uU73ulSXrD1UXF4KE2TMxVVwhsnCgfAyTg9k8P6KGZjlXKrOLe4dJQKI3Bxi5wjesZoFXJWElNWBjPZMbhg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.6.0"
+      }
+    },
+    "node_modules/cors": {
+      "version": "2.8.6",
+      "resolved": "https://registry.npmjs.org/cors/-/cors-2.8.6.tgz",
+      "integrity": "sha512-tJtZBBHA6vjIAaF6EnIaq6laBBP9aq/Y3ouVJjEfoHbRBcHBAHYcMh/w8LDrk2PvIMMq8gmopa5D4V8RmbrxGw==",
+      "license": "MIT",
+      "dependencies": {
+        "object-assign": "^4",
+        "vary": "^1"
+      },
+      "engines": {
+        "node": ">= 0.10"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/cross-spawn": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
+      "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==",
+      "license": "MIT",
+      "dependencies": {
+        "path-key": "^3.1.0",
+        "shebang-command": "^2.0.0",
+        "which": "^2.0.1"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/debug": {
+      "version": "4.4.3",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
+      "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
+      "license": "MIT",
+      "dependencies": {
+        "ms": "^2.1.3"
+      },
+      "engines": {
+        "node": ">=6.0"
+      },
+      "peerDependenciesMeta": {
+        "supports-color": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/decamelize": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/decamelize/-/decamelize-1.2.0.tgz",
+      "integrity": "sha512-z2S+W9X73hAUUki+N+9Za2lBlun89zigOyGrsax+KUQ6wKW4ZoWpEYBkGhQjwAjjDCkWxhY0VKEhk8wzY7F5cA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/depd": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz",
+      "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/dunder-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
+      "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "gopd": "^1.2.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/ecdsa-sig-formatter": {
+      "version": "1.0.11",
+      "resolved": "https://registry.npmjs.org/ecdsa-sig-formatter/-/ecdsa-sig-formatter-1.0.11.tgz",
+      "integrity": "sha512-nagl3RYrbNv6kQkeJIpt6NJZy8twLB/2vtz6yN9Z4vRKHN4/QZJIEbqohALSgwKdnksuY3k5Addp5lg8sVoVcQ==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "safe-buffer": "^5.0.1"
+      }
+    },
+    "node_modules/ee-first": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz",
+      "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==",
+      "license": "MIT"
+    },
+    "node_modules/encodeurl": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz",
+      "integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/es-define-property": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
+      "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-errors": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
+      "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-object-atoms": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz",
+      "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/escape-html": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz",
+      "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==",
+      "license": "MIT"
+    },
+    "node_modules/etag": {
+      "version": "1.8.1",
+      "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz",
+      "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/eventemitter3": {
+      "version": "4.0.7",
+      "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-4.0.7.tgz",
+      "integrity": "sha512-8guHBZCwKnFhYdHr2ysuRWErTwhoN2X8XELRlrRwpmfeY2jjuUN4taQMsULKUVo1K4DvZl+0pgfyoysHxvmvEw==",
+      "license": "MIT"
+    },
+    "node_modules/eventsource": {
+      "version": "3.0.7",
+      "resolved": "https://registry.npmjs.org/eventsource/-/eventsource-3.0.7.tgz",
+      "integrity": "sha512-CRT1WTyuQoD771GW56XEZFQ/ZoSfWid1alKGDYMmkt2yl8UXrVR4pspqWNEcqKvVIzg6PAltWjxcSSPrboA4iA==",
+      "license": "MIT",
+      "dependencies": {
+        "eventsource-parser": "^3.0.1"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/eventsource-parser": {
+      "version": "3.0.6",
+      "resolved": "https://registry.npmjs.org/eventsource-parser/-/eventsource-parser-3.0.6.tgz",
+      "integrity": "sha512-Vo1ab+QXPzZ4tCa8SwIHJFaSzy4R6SHf7BY79rFBDf0idraZWAkYrDjDj8uWaSm3S2TK+hJ7/t1CEmZ7jXw+pg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/express": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/express/-/express-5.2.1.tgz",
+      "integrity": "sha512-hIS4idWWai69NezIdRt2xFVofaF4j+6INOpJlVOLDO8zXGpUVEVzIYk12UUi2JzjEzWL3IOAxcTubgz9Po0yXw==",
+      "license": "MIT",
+      "dependencies": {
+        "accepts": "^2.0.0",
+        "body-parser": "^2.2.1",
+        "content-disposition": "^1.0.0",
+        "content-type": "^1.0.5",
+        "cookie": "^0.7.1",
+        "cookie-signature": "^1.2.1",
+        "debug": "^4.4.0",
+        "depd": "^2.0.0",
+        "encodeurl": "^2.0.0",
+        "escape-html": "^1.0.3",
+        "etag": "^1.8.1",
+        "finalhandler": "^2.1.0",
+        "fresh": "^2.0.0",
+        "http-errors": "^2.0.0",
+        "merge-descriptors": "^2.0.0",
+        "mime-types": "^3.0.0",
+        "on-finished": "^2.4.1",
+        "once": "^1.4.0",
+        "parseurl": "^1.3.3",
+        "proxy-addr": "^2.0.7",
+        "qs": "^6.14.0",
+        "range-parser": "^1.2.1",
+        "router": "^2.2.0",
+        "send": "^1.1.0",
+        "serve-static": "^2.2.0",
+        "statuses": "^2.0.1",
+        "type-is": "^2.0.1",
+        "vary": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/express-rate-limit": {
+      "version": "8.3.1",
+      "resolved": "https://registry.npmjs.org/express-rate-limit/-/express-rate-limit-8.3.1.tgz",
+      "integrity": "sha512-D1dKN+cmyPWuvB+G2SREQDzPY1agpBIcTa9sJxOPMCNeH3gwzhqJRDWCXW3gg0y//+LQ/8j52JbMROWyrKdMdw==",
+      "license": "MIT",
+      "dependencies": {
+        "ip-address": "10.1.0"
+      },
+      "engines": {
+        "node": ">= 16"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/express-rate-limit"
+      },
+      "peerDependencies": {
+        "express": ">= 4.11"
+      }
+    },
+    "node_modules/fast-deep-equal": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
+      "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==",
+      "license": "MIT"
+    },
+    "node_modules/fast-uri": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.0.tgz",
+      "integrity": "sha512-iPeeDKJSWf4IEOasVVrknXpaBV0IApz/gp7S2bb7Z4Lljbl2MGJRqInZiUrQwV16cpzw/D3S5j5Julj/gT52AA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/finalhandler": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-2.1.1.tgz",
+      "integrity": "sha512-S8KoZgRZN+a5rNwqTxlZZePjT/4cnm0ROV70LedRHZ0p8u9fRID0hJUZQpkKLzro8LfmC8sx23bY6tVNxv8pQA==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.4.0",
+        "encodeurl": "^2.0.0",
+        "escape-html": "^1.0.3",
+        "on-finished": "^2.4.1",
+        "parseurl": "^1.3.3",
+        "statuses": "^2.0.1"
+      },
+      "engines": {
+        "node": ">= 18.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/forwarded": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz",
+      "integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/fresh": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/fresh/-/fresh-2.0.0.tgz",
+      "integrity": "sha512-Rx/WycZ60HOaqLKAi6cHRKKI7zxWbJ31MhntmtwMoaTeF7XFH9hhBp8vITaMidfljRQ6eYWCKkaTK+ykVJHP2A==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/fs-minipass": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/fs-minipass/-/fs-minipass-2.1.0.tgz",
+      "integrity": "sha512-V/JgOLFCS+R6Vcq0slCuaeWEdNC3ouDlJMNIsacH2VtALiu9mV4LPrHc5cDl8k5aw6J8jwgWWpiTo5RYhmIzvg==",
+      "license": "ISC",
+      "dependencies": {
+        "minipass": "^3.0.0"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/fs-minipass/node_modules/minipass": {
+      "version": "3.3.6",
+      "resolved": "https://registry.npmjs.org/minipass/-/minipass-3.3.6.tgz",
+      "integrity": "sha512-DxiNidxSEK+tHG6zOIklvNOwm3hvCrbUrdtzY74U6HKTJxvIDfOUL5W5P2Ghd3DTkhhKPYGqeNUIh5qcM4YBfw==",
+      "license": "ISC",
+      "dependencies": {
+        "yallist": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/function-bind": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
+      "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-intrinsic": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
+      "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "es-define-property": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.1.1",
+        "function-bind": "^1.1.2",
+        "get-proto": "^1.0.1",
+        "gopd": "^1.2.0",
+        "has-symbols": "^1.1.0",
+        "hasown": "^2.0.2",
+        "math-intrinsics": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
+      "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
+      "license": "MIT",
+      "dependencies": {
+        "dunder-proto": "^1.0.1",
+        "es-object-atoms": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/gopd": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
+      "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/has-symbols": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
+      "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/hasown": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
+      "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
+      "license": "MIT",
+      "dependencies": {
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/hono": {
+      "version": "4.12.9",
+      "resolved": "https://registry.npmjs.org/hono/-/hono-4.12.9.tgz",
+      "integrity": "sha512-wy3T8Zm2bsEvxKZM5w21VdHDDcwVS1yUFFY6i8UobSsKfFceT7TOwhbhfKsDyx7tYQlmRM5FLpIuYvNFyjctiA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=16.9.0"
+      }
+    },
+    "node_modules/http-errors": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.1.tgz",
+      "integrity": "sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==",
+      "license": "MIT",
+      "dependencies": {
+        "depd": "~2.0.0",
+        "inherits": "~2.0.4",
+        "setprototypeof": "~1.2.0",
+        "statuses": "~2.0.2",
+        "toidentifier": "~1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/iceberg-js": {
+      "version": "0.8.1",
+      "resolved": "https://registry.npmjs.org/iceberg-js/-/iceberg-js-0.8.1.tgz",
+      "integrity": "sha512-1dhVQZXhcHje7798IVM+xoo/1ZdVfzOMIc8/rgVSijRK38EDqOJoGula9N/8ZI5RD8QTxNQtK/Gozpr+qUqRRA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=20.0.0"
+      }
+    },
+    "node_modules/iconv-lite": {
+      "version": "0.7.2",
+      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.7.2.tgz",
+      "integrity": "sha512-im9DjEDQ55s9fL4EYzOAv0yMqmMBSZp6G0VvFyTMPKWxiSBHUj9NW/qqLmXUwXrrM7AvqSlTCfvqRb0cM8yYqw==",
+      "license": "MIT",
+      "dependencies": {
+        "safer-buffer": ">= 2.1.2 < 3.0.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/inherits": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
+      "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
+      "license": "ISC"
+    },
+    "node_modules/ip-address": {
+      "version": "10.1.0",
+      "resolved": "https://registry.npmjs.org/ip-address/-/ip-address-10.1.0.tgz",
+      "integrity": "sha512-XXADHxXmvT9+CRxhXg56LJovE+bmWnEWB78LB83VZTprKTmaC5QfruXocxzTZ2Kl0DNwKuBdlIhjL8LeY8Sf8Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 12"
+      }
+    },
+    "node_modules/ipaddr.js": {
+      "version": "1.9.1",
+      "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz",
+      "integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
+    "node_modules/is-network-error": {
+      "version": "1.3.1",
+      "resolved": "https://registry.npmjs.org/is-network-error/-/is-network-error-1.3.1.tgz",
+      "integrity": "sha512-6QCxa49rQbmUWLfk0nuGqzql9U8uaV2H6279bRErPBHe/109hCzsLUBUHfbEtvLIHBd6hyXbgedBSHevm43Edw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=16"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/is-promise": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/is-promise/-/is-promise-4.0.0.tgz",
+      "integrity": "sha512-hvpoI6korhJMnej285dSg6nu1+e6uxs7zG3BYAm5byqDsgJNWwxzM6z6iZiAgQR4TJ30JmBTOwqZUw3WlyH3AQ==",
+      "license": "MIT"
+    },
+    "node_modules/isexe": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
+      "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
+      "license": "ISC"
+    },
+    "node_modules/jose": {
+      "version": "6.2.2",
+      "resolved": "https://registry.npmjs.org/jose/-/jose-6.2.2.tgz",
+      "integrity": "sha512-d7kPDd34KO/YnzaDOlikGpOurfF0ByC2sEV4cANCtdqLlTfBlw2p14O/5d/zv40gJPbIQxfES3nSx1/oYNyuZQ==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/panva"
+      }
+    },
+    "node_modules/js-tiktoken": {
+      "version": "1.0.21",
+      "resolved": "https://registry.npmjs.org/js-tiktoken/-/js-tiktoken-1.0.21.tgz",
+      "integrity": "sha512-biOj/6M5qdgx5TKjDnFT1ymSpM5tbd3ylwDtrQvFQSu0Z7bBYko2dF+W/aUkXUPuk6IVpRxk/3Q2sHOzGlS36g==",
+      "license": "MIT",
+      "dependencies": {
+        "base64-js": "^1.5.1"
+      }
+    },
+    "node_modules/json-schema-traverse": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+      "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
+      "license": "MIT"
+    },
+    "node_modules/json-schema-typed": {
+      "version": "8.0.2",
+      "resolved": "https://registry.npmjs.org/json-schema-typed/-/json-schema-typed-8.0.2.tgz",
+      "integrity": "sha512-fQhoXdcvc3V28x7C7BMs4P5+kNlgUURe2jmUT1T//oBRMDrqy1QPelJimwZGo7Hg9VPV3EQV5Bnq4hbFy2vetA==",
+      "license": "BSD-2-Clause"
+    },
+    "node_modules/jsonwebtoken": {
+      "version": "9.0.3",
+      "resolved": "https://registry.npmjs.org/jsonwebtoken/-/jsonwebtoken-9.0.3.tgz",
+      "integrity": "sha512-MT/xP0CrubFRNLNKvxJ2BYfy53Zkm++5bX9dtuPbqAeQpTVe0MQTFhao8+Cp//EmJp244xt6Drw/GVEGCUj40g==",
+      "license": "MIT",
+      "dependencies": {
+        "jws": "^4.0.1",
+        "lodash.includes": "^4.3.0",
+        "lodash.isboolean": "^3.0.3",
+        "lodash.isinteger": "^4.0.4",
+        "lodash.isnumber": "^3.0.3",
+        "lodash.isplainobject": "^4.0.6",
+        "lodash.isstring": "^4.0.1",
+        "lodash.once": "^4.0.0",
+        "ms": "^2.1.1",
+        "semver": "^7.5.4"
+      },
+      "engines": {
+        "node": ">=12",
+        "npm": ">=6"
+      }
+    },
+    "node_modules/jwa": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/jwa/-/jwa-2.0.1.tgz",
+      "integrity": "sha512-hRF04fqJIP8Abbkq5NKGN0Bbr3JxlQ+qhZufXVr0DvujKy93ZCbXZMHDL4EOtodSbCWxOqR8MS1tXA5hwqCXDg==",
+      "license": "MIT",
+      "dependencies": {
+        "buffer-equal-constant-time": "^1.0.1",
+        "ecdsa-sig-formatter": "1.0.11",
+        "safe-buffer": "^5.0.1"
+      }
+    },
+    "node_modules/jws": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/jws/-/jws-4.0.1.tgz",
+      "integrity": "sha512-EKI/M/yqPncGUUh44xz0PxSidXFr/+r0pA70+gIYhjv+et7yxM+s29Y+VGDkovRofQem0fs7Uvf4+YmAdyRduA==",
+      "license": "MIT",
+      "dependencies": {
+        "jwa": "^2.0.1",
+        "safe-buffer": "^5.0.1"
+      }
+    },
+    "node_modules/langsmith": {
+      "version": "0.5.13",
+      "resolved": "https://registry.npmjs.org/langsmith/-/langsmith-0.5.13.tgz",
+      "integrity": "sha512-arD4XzLdMTyb3rrKVainpXG9vtJPL3urOc/fC/yMHeoorK5KSHsvBWkogZUgjCsLkhtH8FdfSEAAG8Am8DNoYQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/uuid": "^10.0.0",
+        "chalk": "^5.6.2",
+        "console-table-printer": "^2.12.1",
+        "p-queue": "^6.6.2",
+        "semver": "^7.6.3",
+        "uuid": "^10.0.0"
+      },
+      "peerDependencies": {
+        "@opentelemetry/api": "*",
+        "@opentelemetry/exporter-trace-otlp-proto": "*",
+        "@opentelemetry/sdk-trace-base": "*",
+        "openai": "*",
+        "ws": ">=7"
+      },
+      "peerDependenciesMeta": {
+        "@opentelemetry/api": {
+          "optional": true
+        },
+        "@opentelemetry/exporter-trace-otlp-proto": {
+          "optional": true
+        },
+        "@opentelemetry/sdk-trace-base": {
+          "optional": true
+        },
+        "openai": {
+          "optional": true
+        },
+        "ws": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/langsmith/node_modules/uuid": {
+      "version": "10.0.0",
+      "resolved": "https://registry.npmjs.org/uuid/-/uuid-10.0.0.tgz",
+      "integrity": "sha512-8XkAphELsDnEGrDxUOHB3RGvXz6TeuYSGEZBOjtTtPm2lwhGBjLgOzLHB63IUWfBpNucQjND6d3AOudO+H3RWQ==",
+      "funding": [
+        "https://github.com/sponsors/broofa",
+        "https://github.com/sponsors/ctavan"
+      ],
+      "license": "MIT",
+      "bin": {
+        "uuid": "dist/bin/uuid"
+      }
+    },
+    "node_modules/lodash.includes": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/lodash.includes/-/lodash.includes-4.3.0.tgz",
+      "integrity": "sha512-W3Bx6mdkRTGtlJISOvVD/lbqjTlPPUDTMnlXZFnVwi9NKJ6tiAk6LVdlhZMm17VZisqhKcgzpO5Wz91PCt5b0w==",
+      "license": "MIT"
+    },
+    "node_modules/lodash.isboolean": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/lodash.isboolean/-/lodash.isboolean-3.0.3.tgz",
+      "integrity": "sha512-Bz5mupy2SVbPHURB98VAcw+aHh4vRV5IPNhILUCsOzRmsTmSQ17jIuqopAentWoehktxGd9e/hbIXq980/1QJg==",
+      "license": "MIT"
+    },
+    "node_modules/lodash.isinteger": {
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/lodash.isinteger/-/lodash.isinteger-4.0.4.tgz",
+      "integrity": "sha512-DBwtEWN2caHQ9/imiNeEA5ys1JoRtRfY3d7V9wkqtbycnAmTvRRmbHKDV4a0EYc678/dia0jrte4tjYwVBaZUA==",
+      "license": "MIT"
+    },
+    "node_modules/lodash.isnumber": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/lodash.isnumber/-/lodash.isnumber-3.0.3.tgz",
+      "integrity": "sha512-QYqzpfwO3/CWf3XP+Z+tkQsfaLL/EnUlXWVkIk5FUPc4sBdTehEqZONuyRt2P67PXAk+NXmTBcc97zw9t1FQrw==",
+      "license": "MIT"
+    },
+    "node_modules/lodash.isplainobject": {
+      "version": "4.0.6",
+      "resolved": "https://registry.npmjs.org/lodash.isplainobject/-/lodash.isplainobject-4.0.6.tgz",
+      "integrity": "sha512-oSXzaWypCMHkPC3NvBEaPHf0KsA5mvPrOPgQWDsbg8n7orZ290M0BmC/jgRZ4vcJ6DTAhjrsSYgdsW/F+MFOBA==",
+      "license": "MIT"
+    },
+    "node_modules/lodash.isstring": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/lodash.isstring/-/lodash.isstring-4.0.1.tgz",
+      "integrity": "sha512-0wJxfxH1wgO3GrbuP+dTTk7op+6L41QCXbGINEmD+ny/G/eCqGzxyCsh7159S+mgDDcoarnBw6PC1PS5+wUGgw==",
+      "license": "MIT"
+    },
+    "node_modules/lodash.once": {
+      "version": "4.1.1",
+      "resolved": "https://registry.npmjs.org/lodash.once/-/lodash.once-4.1.1.tgz",
+      "integrity": "sha512-Sb487aTOCr9drQVL8pIxOzVhafOjZN9UU54hiN8PU3uAiSV7lx1yYNpbNmex2PK6dSJoNTSJUUswT651yww3Mg==",
+      "license": "MIT"
+    },
+    "node_modules/math-intrinsics": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
+      "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/media-typer": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-1.1.0.tgz",
+      "integrity": "sha512-aisnrDP4GNe06UcKFnV5bfMNPBUw4jsLGaWwWfnH3v02GnBuXX2MCVn5RbrWo0j3pczUilYblq7fQ7Nw2t5XKw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/merge-descriptors": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-2.0.0.tgz",
+      "integrity": "sha512-Snk314V5ayFLhp3fkUREub6WtjBfPdCPY1Ln8/8munuLuiYhsABgBVWsozAG+MWMbVEvcdcpbi9R7ww22l9Q3g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/mime-db": {
+      "version": "1.54.0",
+      "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.54.0.tgz",
+      "integrity": "sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/mime-types": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-3.0.2.tgz",
+      "integrity": "sha512-Lbgzdk0h4juoQ9fCKXW4by0UJqj+nOOrI9MJ1sSj4nI8aI2eo1qmvQEie4VD1glsS250n15LsWsYtCugiStS5A==",
+      "license": "MIT",
+      "dependencies": {
+        "mime-db": "^1.54.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/minipass": {
+      "version": "4.2.8",
+      "resolved": "https://registry.npmjs.org/minipass/-/minipass-4.2.8.tgz",
+      "integrity": "sha512-fNzuVyifolSLFL4NzpF+wEF4qrgqaaKX0haXPQEdQ7NKAN+WecoKMHV09YcuL/DHxrUsYQOK3MiuDf7Ip2OXfQ==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/minizlib": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/minizlib/-/minizlib-2.1.2.tgz",
+      "integrity": "sha512-bAxsR8BVfj60DWXHE3u30oHzfl4G7khkSuPW+qvpd7jFRHm7dLxOjUk1EHACJ/hxLY8phGJ0YhYHZo7jil7Qdg==",
+      "license": "MIT",
+      "dependencies": {
+        "minipass": "^3.0.0",
+        "yallist": "^4.0.0"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/minizlib/node_modules/minipass": {
+      "version": "3.3.6",
+      "resolved": "https://registry.npmjs.org/minipass/-/minipass-3.3.6.tgz",
+      "integrity": "sha512-DxiNidxSEK+tHG6zOIklvNOwm3hvCrbUrdtzY74U6HKTJxvIDfOUL5W5P2Ghd3DTkhhKPYGqeNUIh5qcM4YBfw==",
+      "license": "ISC",
+      "dependencies": {
+        "yallist": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/mkdirp": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-1.0.4.tgz",
+      "integrity": "sha512-vVqVZQyf3WLx2Shd0qJ9xuvqgAyKPLAiqITEtqW0oIUjzo3PePDd6fW9iFz30ef7Ysp/oiWqbhszeGWW2T6Gzw==",
+      "license": "MIT",
+      "bin": {
+        "mkdirp": "bin/cmd.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/ms": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+      "license": "MIT"
+    },
+    "node_modules/mustache": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/mustache/-/mustache-4.2.0.tgz",
+      "integrity": "sha512-71ippSywq5Yb7/tVYyGbkBggbU8H3u5Rz56fH60jGFgr8uHwxs+aSKeqmluIVzM0m0kB7xQjKS6qPfd0b2ZoqQ==",
+      "license": "MIT",
+      "bin": {
+        "mustache": "bin/mustache"
+      }
+    },
+    "node_modules/negotiator": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-1.0.0.tgz",
+      "integrity": "sha512-8Ofs/AUQh8MaEcrlq5xOX0CQ9ypTF5dl78mjlMNfOK08fzpgTHQRQPBxcPlEtIw0yRpws+Zo/3r+5WRby7u3Gg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/node-cron": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/node-cron/-/node-cron-3.0.3.tgz",
+      "integrity": "sha512-dOal67//nohNgYWb+nWmg5dkFdIwDm8EpeGYMekPMrngV3637lqnX0lbUcCtgibHTz6SEz7DAIjKvKDFYCnO1A==",
+      "license": "ISC",
+      "dependencies": {
+        "uuid": "8.3.2"
+      },
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/node-cron/node_modules/uuid": {
+      "version": "8.3.2",
+      "resolved": "https://registry.npmjs.org/uuid/-/uuid-8.3.2.tgz",
+      "integrity": "sha512-+NYs2QeMWy+GWFOEm9xnn6HCDp0l7QBD7ml8zLUmJ+93Q5NF0NocErnwkTkXVFNiX3/fpC6afS8Dhb/gz7R7eg==",
+      "license": "MIT",
+      "bin": {
+        "uuid": "dist/bin/uuid"
+      }
+    },
+    "node_modules/object-assign": {
+      "version": "4.1.1",
+      "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz",
+      "integrity": "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/object-inspect": {
+      "version": "1.13.4",
+      "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz",
+      "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/on-finished": {
+      "version": "2.4.1",
+      "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz",
+      "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==",
+      "license": "MIT",
+      "dependencies": {
+        "ee-first": "1.1.1"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/once": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
+      "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==",
+      "license": "ISC",
+      "dependencies": {
+        "wrappy": "1"
+      }
+    },
+    "node_modules/openai": {
+      "version": "6.32.0",
+      "resolved": "https://registry.npmjs.org/openai/-/openai-6.32.0.tgz",
+      "integrity": "sha512-j3k+BjydAf8yQlcOI7WUQMQTbbF5GEIMAE2iZYCOzwwB3S2pCheaWYp+XZRNAch4jWVc52PMDGRRjutao3lLCg==",
+      "license": "Apache-2.0",
+      "bin": {
+        "openai": "bin/cli"
+      },
+      "peerDependencies": {
+        "ws": "^8.18.0",
+        "zod": "^3.25 || ^4.0"
+      },
+      "peerDependenciesMeta": {
+        "ws": {
+          "optional": true
+        },
+        "zod": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/p-finally": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/p-finally/-/p-finally-1.0.0.tgz",
+      "integrity": "sha512-LICb2p9CB7FS+0eR1oqWnHhp0FljGLZCWBE9aix0Uye9W8LTQPwMTYVGWQWIw9RdQiDg4+epXQODwIYJtSJaow==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/p-queue": {
+      "version": "6.6.2",
+      "resolved": "https://registry.npmjs.org/p-queue/-/p-queue-6.6.2.tgz",
+      "integrity": "sha512-RwFpb72c/BhQLEXIZ5K2e+AhgNVmIejGlTgiB9MzZ0e93GRvqZ7uSi0dvRF7/XIXDeNkra2fNHBxTyPDGySpjQ==",
+      "license": "MIT",
+      "dependencies": {
+        "eventemitter3": "^4.0.4",
+        "p-timeout": "^3.2.0"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/p-retry": {
+      "version": "7.1.1",
+      "resolved": "https://registry.npmjs.org/p-retry/-/p-retry-7.1.1.tgz",
+      "integrity": "sha512-J5ApzjyRkkf601HpEeykoiCvzHQjWxPAHhyjFcEUP2SWq0+35NKh8TLhpLw+Dkq5TZBFvUM6UigdE9hIVYTl5w==",
+      "license": "MIT",
+      "dependencies": {
+        "is-network-error": "^1.1.0"
+      },
+      "engines": {
+        "node": ">=20"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/p-timeout": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/p-timeout/-/p-timeout-3.2.0.tgz",
+      "integrity": "sha512-rhIwUycgwwKcP9yTOOFK/AKsAopjjCakVqLHePO3CC6Mir1Z99xT+R63jZxAT5lFZLa2inS5h+ZS2GvR99/FBg==",
+      "license": "MIT",
+      "dependencies": {
+        "p-finally": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/parseurl": {
+      "version": "1.3.3",
+      "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz",
+      "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/path-key": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
+      "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/path-to-regexp": {
+      "version": "8.3.0",
+      "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-8.3.0.tgz",
+      "integrity": "sha512-7jdwVIRtsP8MYpdXSwOS0YdD0Du+qOoF/AEPIt88PcCFrZCzx41oxku1jD88hZBwbNUIEfpqvuhjFaMAqMTWnA==",
+      "license": "MIT",
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/pkce-challenge": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/pkce-challenge/-/pkce-challenge-5.0.1.tgz",
+      "integrity": "sha512-wQ0b/W4Fr01qtpHlqSqspcj3EhBvimsdh0KlHhH8HRZnMsEa0ea2fTULOXOS9ccQr3om+GcGRk4e+isrZWV8qQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=16.20.0"
+      }
+    },
+    "node_modules/proxy-addr": {
+      "version": "2.0.7",
+      "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz",
+      "integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==",
+      "license": "MIT",
+      "dependencies": {
+        "forwarded": "0.2.0",
+        "ipaddr.js": "1.9.1"
+      },
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
+    "node_modules/qs": {
+      "version": "6.15.0",
+      "resolved": "https://registry.npmjs.org/qs/-/qs-6.15.0.tgz",
+      "integrity": "sha512-mAZTtNCeetKMH+pSjrb76NAM8V9a05I9aBZOHztWy/UqcJdQYNsf59vrRKWnojAT9Y+GbIvoTBC++CPHqpDBhQ==",
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "side-channel": "^1.1.0"
+      },
+      "engines": {
+        "node": ">=0.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/range-parser": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.1.tgz",
+      "integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/raw-body": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-3.0.2.tgz",
+      "integrity": "sha512-K5zQjDllxWkf7Z5xJdV0/B0WTNqx6vxG70zJE4N0kBs4LovmEYWJzQGxC9bS9RAKu3bgM40lrd5zoLJ12MQ5BA==",
+      "license": "MIT",
+      "dependencies": {
+        "bytes": "~3.1.2",
+        "http-errors": "~2.0.1",
+        "iconv-lite": "~0.7.0",
+        "unpipe": "~1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
+    "node_modules/require-from-string": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
+      "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/router": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/router/-/router-2.2.0.tgz",
+      "integrity": "sha512-nLTrUKm2UyiL7rlhapu/Zl45FwNgkZGaCpZbIHajDYgwlJCOzLSk+cIPAnsEqV955GjILJnKbdQC1nVPz+gAYQ==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.4.0",
+        "depd": "^2.0.0",
+        "is-promise": "^4.0.0",
+        "parseurl": "^1.3.3",
+        "path-to-regexp": "^8.0.0"
+      },
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/safe-buffer": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
+      "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/safer-buffer": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
+      "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==",
+      "license": "MIT"
+    },
+    "node_modules/semver": {
+      "version": "7.7.4",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.4.tgz",
+      "integrity": "sha512-vFKC2IEtQnVhpT78h1Yp8wzwrf8CM+MzKMHGJZfBtzhZNycRFnXsHk6E5TxIkkMsgNS7mdX3AGB7x2QM2di4lA==",
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/send": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/send/-/send-1.2.1.tgz",
+      "integrity": "sha512-1gnZf7DFcoIcajTjTwjwuDjzuz4PPcY2StKPlsGAQ1+YH20IRVrBaXSWmdjowTJ6u8Rc01PoYOGHXfP1mYcZNQ==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "^4.4.3",
+        "encodeurl": "^2.0.0",
+        "escape-html": "^1.0.3",
+        "etag": "^1.8.1",
+        "fresh": "^2.0.0",
+        "http-errors": "^2.0.1",
+        "mime-types": "^3.0.2",
+        "ms": "^2.1.3",
+        "on-finished": "^2.4.1",
+        "range-parser": "^1.2.1",
+        "statuses": "^2.0.2"
+      },
+      "engines": {
+        "node": ">= 18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/serve-static": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-2.2.1.tgz",
+      "integrity": "sha512-xRXBn0pPqQTVQiC8wyQrKs2MOlX24zQ0POGaj0kultvoOCstBQM5yvOhAVSUwOMjQtTvsPWoNCHfPGwaaQJhTw==",
+      "license": "MIT",
+      "dependencies": {
+        "encodeurl": "^2.0.0",
+        "escape-html": "^1.0.3",
+        "parseurl": "^1.3.3",
+        "send": "^1.2.0"
+      },
+      "engines": {
+        "node": ">= 18"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/setprototypeof": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz",
+      "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==",
+      "license": "ISC"
+    },
+    "node_modules/shebang-command": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
+      "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
+      "license": "MIT",
+      "dependencies": {
+        "shebang-regex": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/shebang-regex": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
+      "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/side-channel": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.0.tgz",
+      "integrity": "sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "object-inspect": "^1.13.3",
+        "side-channel-list": "^1.0.0",
+        "side-channel-map": "^1.0.1",
+        "side-channel-weakmap": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-list": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.0.tgz",
+      "integrity": "sha512-FCLHtRD/gnpCiCHEiJLOwdmFP+wzCmDEkc9y7NsYxeF4u7Btsn1ZuwgwJGxImImHicJArLP4R0yX4c2KCrMrTA==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "object-inspect": "^1.13.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-map": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz",
+      "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.5",
+        "object-inspect": "^1.13.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-weakmap": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz",
+      "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.5",
+        "object-inspect": "^1.13.3",
+        "side-channel-map": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/simple-wcswidth": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/simple-wcswidth/-/simple-wcswidth-1.1.2.tgz",
+      "integrity": "sha512-j7piyCjAeTDSjzTSQ7DokZtMNwNlEAyxqSZeCS+CXH7fJ4jx3FuJ/mTW3mE+6JLs4VJBbcll0Kjn+KXI5t21Iw==",
+      "license": "MIT"
+    },
+    "node_modules/statuses": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz",
+      "integrity": "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/tar": {
+      "version": "6.2.1",
+      "resolved": "https://registry.npmjs.org/tar/-/tar-6.2.1.tgz",
+      "integrity": "sha512-DZ4yORTwrbTj/7MZYq2w+/ZFdI6OZ/f9SFHR+71gIVUZhOQPHzVCLpvRnPgyaMpfWxxk/4ONva3GQSyNIKRv6A==",
+      "deprecated": "Old versions of tar are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exorbitant rates) by contacting i@izs.me",
+      "license": "ISC",
+      "dependencies": {
+        "chownr": "^2.0.0",
+        "fs-minipass": "^2.0.0",
+        "minipass": "^5.0.0",
+        "minizlib": "^2.1.1",
+        "mkdirp": "^1.0.3",
+        "yallist": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/tar/node_modules/minipass": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/minipass/-/minipass-5.0.0.tgz",
+      "integrity": "sha512-3FnjYuehv9k6ovOEbyOswadCDPX1piCfhV8ncmYtHOjuPwylVWsghTLo7rabjC3Rx5xD4HDx8Wm1xnMF7S5qFQ==",
+      "license": "ISC",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/toidentifier": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz",
+      "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.6"
+      }
+    },
+    "node_modules/tslib": {
+      "version": "2.8.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
+      "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==",
+      "license": "0BSD"
+    },
+    "node_modules/type-is": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/type-is/-/type-is-2.0.1.tgz",
+      "integrity": "sha512-OZs6gsjF4vMp32qrCbiVSkrFmXtG/AZhY3t0iAMrMBiAZyV9oALtXO8hsrHbMXF9x6L3grlFuwW2oAz7cav+Gw==",
+      "license": "MIT",
+      "dependencies": {
+        "content-type": "^1.0.5",
+        "media-typer": "^1.1.0",
+        "mime-types": "^3.0.0"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/typescript": {
+      "version": "5.9.3",
+      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
+      "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "bin": {
+        "tsc": "bin/tsc",
+        "tsserver": "bin/tsserver"
+      },
+      "engines": {
+        "node": ">=14.17"
+      }
+    },
+    "node_modules/undici-types": {
+      "version": "7.16.0",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.16.0.tgz",
+      "integrity": "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw==",
+      "license": "MIT"
+    },
+    "node_modules/unpipe": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz",
+      "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/uuid": {
+      "version": "11.1.0",
+      "resolved": "https://registry.npmjs.org/uuid/-/uuid-11.1.0.tgz",
+      "integrity": "sha512-0/A9rDy9P7cJ+8w1c9WD9V//9Wj15Ce2MPz8Ri6032usz+NfePxx5AcN3bN+r6ZL6jEo066/yNYB3tn4pQEx+A==",
+      "funding": [
+        "https://github.com/sponsors/broofa",
+        "https://github.com/sponsors/ctavan"
+      ],
+      "license": "MIT",
+      "bin": {
+        "uuid": "dist/esm/bin/uuid"
+      }
+    },
+    "node_modules/vary": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz",
+      "integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/which": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
+      "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
+      "license": "ISC",
+      "dependencies": {
+        "isexe": "^2.0.0"
+      },
+      "bin": {
+        "node-which": "bin/node-which"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/wrappy": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
+      "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==",
+      "license": "ISC"
+    },
+    "node_modules/ws": {
+      "version": "8.20.0",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-8.20.0.tgz",
+      "integrity": "sha512-sAt8BhgNbzCtgGbt2OxmpuryO63ZoDk/sqaB/znQm94T4fCEsy/yV+7CdC1kJhOU9lboAEU7R3kquuycDoibVA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=10.0.0"
+      },
+      "peerDependencies": {
+        "bufferutil": "^4.0.1",
+        "utf-8-validate": ">=5.0.2"
+      },
+      "peerDependenciesMeta": {
+        "bufferutil": {
+          "optional": true
+        },
+        "utf-8-validate": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/yallist": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/yallist/-/yallist-4.0.0.tgz",
+      "integrity": "sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A==",
+      "license": "ISC"
+    },
+    "node_modules/zod": {
+      "version": "3.25.76",
+      "resolved": "https://registry.npmjs.org/zod/-/zod-3.25.76.tgz",
+      "integrity": "sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/colinhacks"
+      }
+    },
+    "node_modules/zod-to-json-schema": {
+      "version": "3.25.1",
+      "resolved": "https://registry.npmjs.org/zod-to-json-schema/-/zod-to-json-schema-3.25.1.tgz",
+      "integrity": "sha512-pM/SU9d3YAggzi6MtR4h7ruuQlqKtad8e9S0fmxcMi+ueAK5Korys/aWcV9LIIHTVbj01NdzxcnXSN+O74ZIVA==",
+      "license": "ISC",
+      "peerDependencies": {
+        "zod": "^3.25 || ^4"
+      }
+    }
+  }
+}

package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@opensin-backend/sin-code-ai",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "bin": {
+    "sin-code-ai": "dist/src/cli.js"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.json && node scripts/postbuild.mjs",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "start:a2a": "node dist/src/cli.js serve-a2a",
+    "start:mcp": "node dist/src/cli.js serve-mcp"
+  },
+  "dependencies": {
+    "@huggingface/hub": "^0.15.1",
+    "@langchain/core": "^1.1.36",
+    "@langchain/langgraph": "^1.2.5",
+    "@langchain/openai": "^1.3.0",
+    "@modelcontextprotocol/sdk": "latest",
+    "@supabase/supabase-js": "^2.39.7",
+    "node-cron": "^3.0.3",
+    "tar": "^6.2.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^24.3.0",
+    "@types/node-cron": "^3.0.11",
+    "@types/tar": "^6.1.11",
+    "typescript": "^5.9.3"
+  }
+}

runbooks/install.md

@@ -0,0 +1,3 @@
+# Install
+
+Use `scripts/complete-install.sh` as the single supported install path.

runbooks/launchagent.md

@@ -0,0 +1,3 @@
+# LaunchAgent
+
+Record install, verify, restart, rollback, and login-cycle survival steps here.

scripts/botfather-create.sh

@@ -0,0 +1,174 @@
+#!/usr/bin/env bash
+# botfather-create.sh — Autonomous BotFather bot creation via Telegram.app AppleScript
+# Usage: ./scripts/botfather-create.sh --name <BotName> --username <botusername_bot> [--alias <local-alias>]
+#
+# What this does (zero manual steps):
+#   1. Opens Telegram.app and navigates to @BotFather
+#   2. Sends /newbot command
+#   3. Sends the display name
+#   4. Sends the username
+#   5. Captures the token from BotFather's reply via getUpdates
+#   6. Registers the new bot with sin-telegrambot CLI
+#   7. Bootstraps chat_id
+#
+# Requirements:
+#   - Telegram.app installed and logged in
+#   - sin-telegrambot CLI: ~/.local/bin/sin-telegrambot
+#   - macOS (uses AppleScript / osascript)
+#   - BotFather must not be rate-limiting (wait 60s if you just created a bot)
+#
+# Part of: A2A-SIN-Agent-Template canonical scripts
+# Canonical CLI: sin-telegrambot
+
+set -euo pipefail
+
+BOT_DISPLAY_NAME=""
+BOT_USERNAME=""
+BOT_ALIAS=""
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --name)     BOT_DISPLAY_NAME="$2"; shift 2 ;;
+    --username) BOT_USERNAME="$2"; shift 2 ;;
+    --alias)    BOT_ALIAS="$2"; shift 2 ;;
+    *) echo "Unknown arg: $1" >&2; exit 1 ;;
+  esac
+done
+
+if [[ -z "$BOT_DISPLAY_NAME" || -z "$BOT_USERNAME" ]]; then
+  echo "Usage: $0 --name <DisplayName> --username <botusername_bot> [--alias <local-alias>]"
+  echo "  --name      Display name for the bot (e.g. 'My Agent Bot')"
+  echo "  --username  Bot username, must end in _bot (e.g. 'myagentbot_bot')"
+  echo "  --alias     Local alias for sin-telegrambot registry (default: username without _bot)"
+  exit 1
+fi
+
+# Derive alias from username if not given
+if [[ -z "$BOT_ALIAS" ]]; then
+  BOT_ALIAS="${BOT_USERNAME%_bot}"
+  BOT_ALIAS="${BOT_ALIAS,,}"
+fi
+
+# BotFather token is well-known (not secret) — it's the Telegram-provided token for @BotFather itself
+BOTFATHER_USERNAME="BotFather"
+
+echo "[INFO] Creating Telegram bot via BotFather (AppleScript)"
+echo "  Display name: $BOT_DISPLAY_NAME"
+echo "  Username:     $BOT_USERNAME"
+echo "  Local alias:  $BOT_ALIAS"
+echo ""
+
+# Step 1: Open Telegram and navigate to BotFather, send /newbot
+osascript <<APPLESCRIPT
+tell application "Telegram"
+    activate
+end tell
+delay 2.0
+tell application "System Events"
+    tell process "Telegram"
+        -- Open search (Cmd+K)
+        keystroke "k" using command down
+        delay 1.0
+        -- Type BotFather
+        keystroke "@${BOTFATHER_USERNAME}"
+        delay 1.5
+        -- Select first result
+        key code 36
+        delay 1.5
+        -- Send /newbot
+        keystroke "/newbot"
+        key code 36
+        delay 1.0
+    end tell
+end tell
+APPLESCRIPT
+
+echo "[INFO] Sent /newbot — waiting 4s for BotFather reply..."
+sleep 4
+
+# Step 2: Send display name
+osascript <<APPLESCRIPT
+tell application "System Events"
+    tell process "Telegram"
+        keystroke "${BOT_DISPLAY_NAME}"
+        key code 36
+        delay 1.0
+    end tell
+end tell
+APPLESCRIPT
+
+echo "[INFO] Sent display name '$BOT_DISPLAY_NAME' — waiting 4s..."
+sleep 4
+
+# Step 3: Send username
+osascript <<APPLESCRIPT
+tell application "System Events"
+    tell process "Telegram"
+        keystroke "${BOT_USERNAME}"
+        key code 36
+        delay 1.0
+    end tell
+end tell
+APPLESCRIPT
+
+echo "[INFO] Sent username '$BOT_USERNAME' — waiting 6s for token..."
+sleep 6
+
+# Step 4: We need a BotFather listener token to poll for the created bot token
+# We use the SIN Fleet watcher bot (sin-telegrambot default) if available,
+# OR we ask the user to paste the token from the Telegram screen.
+# Strategy: try to capture token from macOS clipboard (BotFather's message is selectable)
+
+echo "[INFO] Attempting to capture bot token from Telegram (BotFather reply)..."
+
+# Try AppleScript clipboard approach: select all text in current chat, copy
+osascript <<APPLESCRIPT
+tell application "System Events"
+    tell process "Telegram"
+        keystroke "a" using command down
+        delay 0.5
+        keystroke "c" using command down
+        delay 0.5
+    end tell
+end tell
+APPLESCRIPT
+
+sleep 1
+CLIPBOARD=$(pbpaste 2>/dev/null || echo "")
+
+# Extract token: format is digits:alphanumeric_string
+TOKEN=$(echo "$CLIPBOARD" | grep -oE '[0-9]{8,12}:[A-Za-z0-9_-]{35,}' | head -1 || echo "")
+
+if [[ -z "$TOKEN" ]]; then
+  echo "[WARN] Could not auto-extract token from clipboard."
+  echo "[INFO] Please copy the token from Telegram (BotFather reply) and paste it here:"
+  read -r -p "Token: " TOKEN
+fi
+
+if [[ -z "$TOKEN" ]]; then
+  echo "[ERROR] No token provided. Aborting."
+  exit 1
+fi
+
+echo "[OK] Token captured: ${TOKEN:0:20}..."
+
+# Step 5: Register with sin-telegrambot CLI
+echo "[INFO] Registering with sin-telegrambot CLI..."
+sin-telegrambot register "$TOKEN" --name "$BOT_ALIAS"
+
+# Step 6: Bootstrap chat_id
+echo "[INFO] Bootstrapping chat_id..."
+sin-telegrambot bootstrap "$BOT_ALIAS" || true
+
+# Step 7: Status check
+echo ""
+sin-telegrambot status "$BOT_ALIAS" || true
+
+# Step 8: Write .env snippet
+echo ""
+echo "=== Bot created! Add to your agent's .env ==="
+echo "TELEGRAM_BOT_TOKEN=$TOKEN"
+echo "TELEGRAM_BOT_NAME=$BOT_ALIAS"
+echo ""
+echo "=== Quick test ==="
+echo "  sin-telegrambot send $BOT_ALIAS \"Hello from $BOT_DISPLAY_NAME!\""

scripts/complete-install.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+
+mkdir -p "$ROOT/logs" "$ROOT/data"
+
+if command -v npm >/dev/null 2>&1; then
+  npm --prefix "$ROOT" install
+else
+  echo "npm is required" >&2
+  exit 1
+fi
+
+npm --prefix "$ROOT" run build
+
+# Future HF rollout hooks for the live deployment lane.
+# Not enabled while the agent remains structural-only.
+# - restoreAuthSession: handled by scripts/hf_pull_script.py before first opencode call
+# - startKeepAlivePing: wire this in the live HF runtime to keep the Space warm
+# - startAutoBackup / backupAuthSession: only enable once a real session-backed payload exists
+
+echo "complete-install finished for $(basename "$ROOT")"

scripts/hf_pull_script.py

@@ -0,0 +1,116 @@
+#!/usr/bin/env python3
+"""
+A2A Consumer Rotator (HF VM Pull Script)
+Pulls a fresh OpenAI refresh token from SIN-Supabase and writes the
+OpenCode auth schema to ~/.local/share/opencode/auth.json.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+import sys
+from collections.abc import Mapping
+from pathlib import Path
+
+import requests
+
+
+SUPABASE_URL = os.environ.get("SUPABASE_URL", "").strip()
+SUPABASE_KEY = os.environ.get("SUPABASE_SERVICE_ROLE_KEY", "").strip()
+AUTH_FILE = Path.home() / ".local" / "share" / "opencode" / "auth.json"
+
+JsonScalar = str | int | float | bool | None
+JsonValue = JsonScalar | dict[str, "JsonValue"] | list["JsonValue"]
+
+
+def extract_refresh_token(row: Mapping[str, JsonValue]) -> str | None:
+    direct_token = row.get("refresh_token") or row.get("token")
+    if isinstance(direct_token, str) and direct_token.strip():
+        return direct_token.strip()
+
+    auth_json_data = row.get("auth_json_data")
+    if isinstance(auth_json_data, Mapping):
+        openai_auth = auth_json_data.get("openai")
+        if isinstance(openai_auth, Mapping):
+            refresh_token = openai_auth.get("refresh")
+            if isinstance(refresh_token, str) and refresh_token.strip():
+                return refresh_token.strip()
+
+        refresh_token = auth_json_data.get("refresh") or auth_json_data.get("refresh_token")
+        if isinstance(refresh_token, str) and refresh_token.strip():
+            return refresh_token.strip()
+
+    return None
+
+
+def build_headers() -> dict[str, str]:
+    return {
+        "apikey": SUPABASE_KEY,
+        "Authorization": f"Bearer {SUPABASE_KEY}",
+        "Content-Type": "application/json",
+        "Prefer": "return=representation",
+    }
+
+
+def pull_fresh_token() -> bool:
+    if not SUPABASE_URL or not SUPABASE_KEY:
+        print("ERROR: SUPABASE_URL or SUPABASE_SERVICE_ROLE_KEY is missing.")
+        return False
+
+    base_url = SUPABASE_URL.rstrip("/")
+    headers = build_headers()
+
+    print("Looking for a fresh token in Supabase...")
+    get_url = (
+        f"{base_url}/rest/v1/openai_account_pool"
+        "?status=eq.FRESH&select=id,refresh_token,token,auth_json_data&limit=1"
+    )
+    response = requests.get(get_url, headers=headers, timeout=10)
+    response.raise_for_status()
+
+    payload = response.json()
+    if not isinstance(payload, list):
+        print("ERROR: Supabase returned an unexpected payload shape.")
+        return False
+
+    rows = [row for row in payload if isinstance(row, dict)]
+    if not rows:
+        print("ERROR: No fresh token available in openai_account_pool.")
+        return False
+
+    row = rows[0]
+    row_id_value = row.get("id")
+    if not isinstance(row_id_value, (str, int)):
+        print("ERROR: Supabase row is missing a valid id.")
+        return False
+
+    row_id = str(row_id_value)
+    refresh_token = extract_refresh_token(row)
+    if not refresh_token:
+        print(f"ERROR: Row {row_id} does not contain a usable refresh token.")
+        return False
+
+    patch_url = f"{base_url}/rest/v1/openai_account_pool?id=eq.{row_id}"
+    patch_response = requests.patch(
+        patch_url,
+        headers=headers,
+        json={"status": "IN_USE"},
+        timeout=10,
+    )
+    patch_response.raise_for_status()
+
+    auth_payload = {
+        "openai": {
+            "type": "oauth",
+            "refresh": refresh_token,
+        }
+    }
+    _ = AUTH_FILE.parent.mkdir(parents=True, exist_ok=True)
+    _ = AUTH_FILE.write_text(json.dumps(auth_payload, indent=2) + "\n", encoding="utf-8")
+    print(f"Updated {AUTH_FILE} from Supabase row {row_id}.")
+    return True
+
+
+if __name__ == "__main__":
+    sys.exit(0 if pull_fresh_token() else 1)

scripts/postbuild.mjs

@@ -0,0 +1,17 @@
+import { mkdir, copyFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+
+const root = resolve(new URL('..', import.meta.url).pathname);
+const targets = [
+  ['agent.json', 'dist/agent.json'],
+  ['mcp-config.json', 'dist/mcp-config.json'],
+  ['A2A-CARD.md', 'dist/A2A-CARD.md'],
+];
+
+for (const [sourceRelative, targetRelative] of targets) {
+  const source = resolve(root, sourceRelative);
+  const target = resolve(root, targetRelative);
+  await mkdir(dirname(target), { recursive: true });
+  await copyFile(source, target);
+}
+

scripts/telegram-bootstrap.sh

@@ -0,0 +1,112 @@
+#!/usr/bin/env bash
+# telegram-bootstrap.sh — Universal SIN Telegram Bot Bootstrap
+# Usage: ./scripts/telegram-bootstrap.sh [--bot-name <alias>] [--env-file <path>]
+# Reads TELEGRAM_BOT_TOKEN (+ optional TELEGRAM_BOT_NAME) from .env,
+# registers the bot with sin-telegrambot CLI, and bootstraps the chat_id.
+# Zero manual steps required.
+#
+# Prerequisites:
+#   - sin-telegrambot CLI installed: ~/.local/bin/sin-telegrambot
+#   - Telegram.app installed on macOS (for auto-bootstrap via AppleScript)
+#   - .env file in project root with TELEGRAM_BOT_TOKEN set
+#
+# Part of: A2A-SIN-Agent-Template canonical scripts
+# Canonical CLI: sin-telegrambot (https://github.com/Delqhi/sin-telegrambot-cli)
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+AGENT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+ENV_FILE="${AGENT_ROOT}/.env"
+BOT_NAME_OVERRIDE=""
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --bot-name) BOT_NAME_OVERRIDE="$2"; shift 2 ;;
+    --env-file)  ENV_FILE="$2"; shift 2 ;;
+    *) echo "Unknown arg: $1"; exit 1 ;;
+  esac
+done
+
+# --- Load .env ---
+if [[ -f "$ENV_FILE" ]]; then
+  set -a
+  # shellcheck disable=SC1090
+  source "$ENV_FILE"
+  set +a
+  echo "[INFO] Loaded env from $ENV_FILE"
+else
+  echo "[WARN] No .env file found at $ENV_FILE — relying on environment variables"
+fi
+
+TOKEN="${TELEGRAM_BOT_TOKEN:-}"
+if [[ -z "$TOKEN" ]]; then
+  echo "[ERROR] TELEGRAM_BOT_TOKEN is not set. Add it to .env or export it."
+  exit 1
+fi
+
+# Determine bot alias: --bot-name > TELEGRAM_BOT_NAME env var > agent dir name
+if [[ -n "$BOT_NAME_OVERRIDE" ]]; then
+  BOT_ALIAS="$BOT_NAME_OVERRIDE"
+elif [[ -n "${TELEGRAM_BOT_NAME:-}" ]]; then
+  BOT_ALIAS="$TELEGRAM_BOT_NAME"
+else
+  BOT_ALIAS="$(basename "$AGENT_ROOT" | tr '[:upper:]' '[:lower:]' | sed 's/a2a-sin-//')"
+fi
+
+echo "[INFO] Bot alias: $BOT_ALIAS"
+
+# --- Check sin-telegrambot is installed ---
+if ! command -v sin-telegrambot &>/dev/null; then
+  echo "[ERROR] sin-telegrambot CLI not found. Install it:"
+  echo "  cp ~/.config/opencode/../dev/sin-telegrambot-cli/sin_telegrambot.py ~/.local/bin/sin-telegrambot"
+  echo "  chmod +x ~/.local/bin/sin-telegrambot"
+  exit 1
+fi
+
+# --- Register bot (idempotent) ---
+EXISTING=$(sin-telegrambot list 2>/dev/null | python3 -c "
+import json,sys
+bots = json.load(sys.stdin) if sys.stdin.read(1) == '[' else []
+" 2>/dev/null || echo "[]")
+
+echo "[INFO] Registering $BOT_ALIAS ..."
+RESULT=$(sin-telegrambot register "$TOKEN" --name "$BOT_ALIAS" 2>&1)
+echo "$RESULT"
+
+if echo "$RESULT" | grep -q '"ok": true'; then
+  echo "[OK] Bot registered successfully."
+elif echo "$RESULT" | grep -q 'registered'; then
+  echo "[OK] Bot already registered / updated."
+else
+  echo "[WARN] Registration result unclear, continuing..."
+fi
+
+# --- Bootstrap chat_id ---
+echo "[INFO] Bootstrapping chat_id for $BOT_ALIAS ..."
+BOOT=$(sin-telegrambot bootstrap "$BOT_ALIAS" 2>&1)
+echo "$BOOT"
+
+if echo "$BOOT" | grep -q '"ok": true'; then
+  CHAT_ID=$(echo "$BOOT" | python3 -c "import json,sys; d=json.load(sys.stdin); print(d.get('chat_id',''))" 2>/dev/null || echo "")
+  echo "[OK] chat_id discovered: $CHAT_ID"
+
+  # --- Write TELEGRAM_CHAT_ID back to .env if not already set ---
+  if [[ -f "$ENV_FILE" ]] && ! grep -q "TELEGRAM_CHAT_ID=" "$ENV_FILE"; then
+    echo "TELEGRAM_CHAT_ID=$CHAT_ID" >> "$ENV_FILE"
+    echo "[INFO] Wrote TELEGRAM_CHAT_ID=$CHAT_ID to $ENV_FILE"
+  fi
+else
+  echo "[WARN] chat_id bootstrap didn't return ok — may need manual /start"
+fi
+
+# --- Send test message ---
+echo "[INFO] Sending test message ..."
+sin-telegrambot send "$BOT_ALIAS" "✅ <b>$(basename "$AGENT_ROOT")</b> bootstrap complete! Bot is online." --parse-mode HTML || true
+
+echo ""
+echo "=== Bootstrap complete ==="
+echo "  Alias:   $BOT_ALIAS"
+echo "  CLI:     sin-telegrambot send $BOT_ALIAS \"Hello World\""
+echo "  Status:  sin-telegrambot status $BOT_ALIAS"
+echo ""

src/a2a-http.ts

@@ -0,0 +1,78 @@
+import { randomUUID } from 'node:crypto';
+import { createServer, type IncomingMessage, type ServerResponse } from 'node:http';
+import { buildAgentCard, resolveTemplateAgentConfig, TEMPLATE_AGENT_ID, TEMPLATE_AGENT_NAME } from './metadata.js';
+import { executeTemplateAgentAction, type TemplateAgentAction } from './runtime.js';
+
+type RpcRequest = { jsonrpc?: string; id?: string | number | null; method?: string; params?: Record<string, unknown> };
+
+export function createTemplateAgentHttpServer() {
+  const config = resolveTemplateAgentConfig();
+  const server = createServer((request, response) => void handleRequest(request, response, config.publicBaseUrl));
+  return {
+    server,
+    async start() {
+      await new Promise<void>((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(config.port, config.host, () => resolve());
+      });
+    },
+    async stop() {
+      await new Promise<void>((resolve, reject) => server.close((error) => (error ? reject(error) : resolve())));
+    },
+  };
+}
+
+async function handleRequest(request: IncomingMessage, response: ServerResponse, baseUrl: string) {
+  if (request.method === 'GET' && request.url === '/health') return sendJson(response, 200, { ok: true, agent: TEMPLATE_AGENT_ID });
+  if (request.method === 'GET' && request.url === '/') return sendHtml(response, 200, `<html><body><h1>${TEMPLATE_AGENT_NAME}</h1></body></html>`);
+  if (request.method === 'GET' && (request.url === '/.well-known/agent-card.json' || request.url === '/.well-known/agent.json')) {
+    return sendJson(response, 200, buildAgentCard(baseUrl));
+  }
+  if (request.method === 'POST' && request.url === '/a2a/v1') {
+    const rpc = ((await readJson(request)) || {}) as RpcRequest;
+    if (rpc.method === 'agent/getCard') return sendJson(response, 200, { jsonrpc: '2.0', id: rpc.id ?? null, result: buildAgentCard(baseUrl) });
+    if (rpc.method === 'message/send') {
+      const action = parseAction((rpc.params?.message as { parts?: Array<{ text?: string }> } | undefined)?.parts?.map((part) => part.text || '').join(' ').trim() || '');
+      const result = await executeTemplateAgentAction(action);
+      return sendJson(response, 200, {
+        jsonrpc: '2.0',
+        id: rpc.id ?? null,
+        result: {
+          id: randomUUID(),
+          kind: 'task',
+          status: { state: 'completed', timestamp: new Date().toISOString(), message: { role: 'agent', parts: [{ type: 'text', text: 'done' }] } },
+          artifacts: [{ id: randomUUID(), name: action.action, description: action.action, parts: [{ type: 'data', data: result }] }],
+          metadata: { action: action.action },
+        },
+      });
+    }
+  }
+  sendJson(response, 404, { error: 'not_found' });
+}
+
+function parseAction(text: string): TemplateAgentAction {
+  const value = text.toLowerCase();
+  if (value === 'sin.code.ai health') return { action: 'sin.code.ai.health' };
+  if (value === 'sin.code.ai room13 claim') return { action: 'sin.code.ai.room13.claim', confirm: true };
+  if (value === 'sin.code.ai onboarding status') return { action: 'sin.code.ai.onboarding.status' };
+  return { action: 'agent.help' };
+}
+
+async function readJson(request: IncomingMessage) {
+  const chunks: Buffer[] = [];
+  for await (const chunk of request) chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+  const raw = Buffer.concat(chunks).toString('utf8').trim();
+  return raw ? JSON.parse(raw) : null;
+}
+
+function sendJson(response: ServerResponse, statusCode: number, payload: unknown) {
+  response.statusCode = statusCode;
+  response.setHeader('content-type', 'application/json; charset=utf-8');
+  response.end(JSON.stringify(payload, null, 2));
+}
+
+function sendHtml(response: ServerResponse, statusCode: number, payload: string) {
+  response.statusCode = statusCode;
+  response.setHeader('content-type', 'text/html; charset=utf-8');
+  response.end(payload);
+}

src/agent/SupabaseSaver.ts

@@ -0,0 +1,152 @@
+import { 
+  BaseCheckpointSaver, 
+  type Checkpoint, 
+  type CheckpointListOptions, 
+  type CheckpointTuple, 
+  type PendingWrite, 
+  type CheckpointMetadata,
+  type ChannelVersions
+} from '@langchain/langgraph-checkpoint';
+import type { RunnableConfig } from '@langchain/core/runnables';
+import { getSupabaseClient } from '../supabase.js';
+
+export class SupabaseSaver extends BaseCheckpointSaver {
+  async getTuple(config: RunnableConfig): Promise<CheckpointTuple | undefined> {
+    const threadId = config.configurable?.thread_id;
+    if (!threadId) return undefined;
+    
+    const client = getSupabaseClient();
+    const query = client.from('langgraph_checkpoints')
+      .select('*')
+      .eq('thread_id', threadId)
+      .order('checkpoint_id', { ascending: false })
+      .limit(1);
+    
+    if (config.configurable?.checkpoint_id) {
+      query.eq('checkpoint_id', config.configurable.checkpoint_id);
+    }
+    
+    const { data, error } = await query.single();
+    if (error || !data) return undefined;
+    
+    const checkpoint = await this.serde.loadsTyped('json', data.checkpoint);
+    const metadata = await this.serde.loadsTyped('json', data.metadata);
+    
+    return {
+      config: {
+        configurable: {
+          thread_id: threadId,
+          checkpoint_ns: '',
+          checkpoint_id: data.checkpoint_id
+        }
+      },
+      checkpoint: checkpoint as Checkpoint,
+      metadata: metadata as CheckpointMetadata,
+      parentConfig: data.parent_checkpoint_id ? {
+        configurable: {
+          thread_id: threadId,
+          checkpoint_ns: '',
+          checkpoint_id: data.parent_checkpoint_id
+        }
+      } : undefined
+    };
+  }
+
+  async *list(config: RunnableConfig, options?: CheckpointListOptions): AsyncGenerator<CheckpointTuple> {
+    const threadId = config.configurable?.thread_id;
+    if (!threadId) return;
+    
+    const client = getSupabaseClient();
+    let query = client.from('langgraph_checkpoints')
+      .select('*')
+      .eq('thread_id', threadId)
+      .order('checkpoint_id', { ascending: false });
+    
+    if (options?.limit) {
+      query = query.limit(options.limit);
+    }
+    
+    const { data, error } = await query;
+    if (error || !data) return;
+    
+    for (const row of data) {
+      const checkpoint = await this.serde.loadsTyped('json', row.checkpoint);
+      const metadata = await this.serde.loadsTyped('json', row.metadata);
+      yield {
+        config: { configurable: { thread_id: threadId, checkpoint_ns: '', checkpoint_id: row.checkpoint_id } },
+        checkpoint: checkpoint as Checkpoint,
+        metadata: metadata as CheckpointMetadata,
+        parentConfig: row.parent_checkpoint_id ? { configurable: { thread_id: threadId, checkpoint_ns: '', checkpoint_id: row.parent_checkpoint_id } } : undefined
+      };
+    }
+  }
+
+  async put(
+    config: RunnableConfig, 
+    checkpoint: Checkpoint, 
+    metadata: CheckpointMetadata,
+    newVersions: ChannelVersions
+  ): Promise<RunnableConfig> {
+    const threadId = config.configurable?.thread_id;
+    if (!threadId) throw new Error('missing thread_id');
+    
+    const [ckptStr, metaStr] = await Promise.all([
+      this.serde.dumpsTyped(checkpoint),
+      this.serde.dumpsTyped(metadata)
+    ]);
+    
+    const client = getSupabaseClient();
+    const { error } = await client.from('langgraph_checkpoints').upsert({
+      thread_id: threadId,
+      checkpoint_id: checkpoint.id,
+      parent_checkpoint_id: config.configurable?.checkpoint_id || null,
+      checkpoint: ckptStr[1],
+      metadata: metaStr[1]
+    });
+    
+    if (error) {
+      throw new Error(`Failed to put checkpoint: ${error.message}`);
+    }
+    
+    return {
+      configurable: {
+        thread_id: threadId,
+        checkpoint_ns: '',
+        checkpoint_id: checkpoint.id
+      }
+    };
+  }
+
+  async putWrites(config: RunnableConfig, writes: PendingWrite[], taskId: string): Promise<void> {
+    const threadId = config.configurable?.thread_id;
+    const checkpointId = config.configurable?.checkpoint_id;
+    if (!threadId || !checkpointId) throw new Error('missing thread_id or checkpoint_id');
+    
+    const client = getSupabaseClient();
+    const rows = await Promise.all(writes.map(async (w, idx) => {
+      const [type, value] = await this.serde.dumpsTyped(w[1]);
+      return {
+        thread_id: threadId,
+        checkpoint_id: checkpointId,
+        task_id: taskId,
+        idx,
+        channel: w[0],
+        type,
+        value
+      };
+    }));
+    
+    if (rows.length > 0) {
+      const { error } = await client.from('langgraph_checkpoint_writes').upsert(rows);
+      if (error) {
+        throw new Error(`Failed to put writes: ${error.message}`);
+      }
+    }
+  }
+
+  async deleteThread(threadId: string): Promise<void> {
+    const client = getSupabaseClient();
+    await client.from('langgraph_checkpoint_writes').delete().eq('thread_id', threadId);
+    await client.from('langgraph_checkpoints').delete().eq('thread_id', threadId);
+  }
+}

src/agent/graph.ts

@@ -0,0 +1,37 @@
+import { StateGraph, START, END, Annotation } from "@langchain/langgraph";
+import { BaseMessage } from "@langchain/core/messages";
+
+// 1. Define Agent State Annotation (March 2026 Fleet Standard)
+export const AgentState = Annotation.Root({
+  messages: Annotation<BaseMessage[]>({
+    reducer: (state, update) => state.concat(update),
+    default: () => [],
+  }),
+  context: Annotation<Record<string, any>>({
+    reducer: (state, update) => ({ ...state, ...update }),
+    default: () => ({}),
+  }),
+});
+
+// 2. Define Nodes (Placeholders for A2A Logic)
+async function reasoningNode(state: typeof AgentState.State) {
+  // Bind MCP Tools to LLM here
+  return { context: { reasoned: true } };
+}
+
+async function toolNode(state: typeof AgentState.State) {
+  // Wrap MCP Tools via @langchain/langgraph ToolNode
+  return { messages: [] };
+}
+
+// 3. Construct A2A Graph Workflow
+export function createAgentGraph() {
+  const workflow = new StateGraph(AgentState)
+    .addNode("reasoning", reasoningNode)
+    .addNode("tools", toolNode)
+    .addEdge(START, "reasoning")
+    .addEdge("reasoning", "tools")
+    .addEdge("tools", END);
+
+  return workflow.compile(); // Optional: pass { checkpointer: new SupabaseSaver() } here
+}

src/cli.ts

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+
+import process from 'node:process';
+import { createTemplateAgentHttpServer } from './a2a-http.js';
+import { buildAgentCard, resolveTemplateAgentConfig } from './metadata.js';
+import { startMcpServer } from './mcp-server.js';
+import { executeTemplateAgentAction, type TemplateAgentAction } from './runtime.js';
+
+async function main(): Promise<void> {
+  const command = process.argv[2] || 'help';
+  switch (command) {
+    case 'serve':
+    case 'serve-a2a':
+      await serveA2A();
+      return;
+    case 'serve-mcp':
+      await startMcpServer();
+      return;
+    case 'print-card':
+      printJson(buildAgentCard(resolveTemplateAgentConfig().publicBaseUrl));
+      return;
+    case 'run-action':
+      await runAction();
+      return;
+    default:
+      printUsage();
+  }
+}
+
+async function serveA2A() {
+  const config = resolveTemplateAgentConfig();
+  const handle = createTemplateAgentHttpServer();
+  await handle.start();
+  printJson({ ok: true, command: 'serve-a2a', host: config.host, port: config.port, baseUrl: config.publicBaseUrl });
+}
+
+async function runAction() {
+  const raw = process.argv[3]?.trim() || (await readStdin()).trim();
+  if (!raw) throw new Error('missing_action_json');
+  printJson(await executeTemplateAgentAction(JSON.parse(raw) as TemplateAgentAction));
+}
+
+function printUsage() {
+  process.stderr.write(
+    ['Usage:', '  sin-code-ai serve-a2a', '  sin-code-ai serve-mcp', '  sin-code-ai print-card', `  sin-code-ai run-action '{"action":"agent.help"}'`].join('\n') + '\n',
+  );
+}
+
+function printJson(payload: unknown) {
+  process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
+}
+
+async function readStdin() {
+  const chunks: Buffer[] = [];
+  for await (const chunk of process.stdin) chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+  return Buffer.concat(chunks).toString('utf8');
+}
+
+main().catch((error) => {
+  process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+  process.exitCode = 1;
+});
+

src/index.ts

@@ -0,0 +1,5 @@
+export * from './runtime.js';
+export * from './metadata.js';
+export * from './a2a-http.js';
+export * from './mcp-server.js';
+

src/lib/telemetry/SentinelLogger.ts

@@ -0,0 +1,141 @@
+import { randomUUID } from 'node:crypto';
+import { appendFile, mkdir } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { homedir, hostname } from 'node:os';
+import { TEMPLATE_AGENT_ID, TEMPLATE_AGENT_NAME, TEMPLATE_AGENT_NAMESPACE } from '../../metadata.js';
+import { getSupabaseClient } from '../../supabase.js';
+
+export type TemplateLogLevel = 'info' | 'warn' | 'error' | 'debug';
+export type TemplateLogStatus = 'started' | 'accepted' | 'completed' | 'failed';
+export type TemplateLogEntry = {
+  agentId: string;
+  agentName: string;
+  namespace: string;
+  runId: string;
+  requestId: string;
+  surface: string;
+  event: string;
+  action?: string;
+  level: TemplateLogLevel;
+  status: TemplateLogStatus;
+  details?: Record<string, unknown>;
+  durationMs?: number;
+  createdAt: string;
+};
+
+export const TEMPLATE_LOG_PATH = join(homedir(), '.config', 'sin', TEMPLATE_AGENT_ID, 'events.ndjson');
+export const TEMPLATE_TELEMETRY_TABLE = 'fleet_telemetry';
+
+export class TemplateLogger {
+  readonly runId: string;
+
+  constructor(runId: string = randomUUID()) {
+    this.runId = runId;
+  }
+
+  async log(input: {
+    surface: string;
+    event: string;
+    level?: TemplateLogLevel;
+    status?: TemplateLogStatus;
+    action?: string;
+    details?: Record<string, unknown>;
+    durationMs?: number;
+    requestId?: string;
+  }) {
+    const entry: TemplateLogEntry = {
+      agentId: TEMPLATE_AGENT_ID,
+      agentName: TEMPLATE_AGENT_NAME,
+      namespace: TEMPLATE_AGENT_NAMESPACE,
+      runId: this.runId,
+      requestId: input.requestId || randomUUID(),
+      surface: input.surface,
+      event: input.event,
+      action: input.action,
+      level: input.level || 'info',
+      status: input.status || 'completed',
+      details: input.details,
+      durationMs: input.durationMs,
+      createdAt: new Date().toISOString(),
+    };
+
+    await mkdir(dirname(TEMPLATE_LOG_PATH), { recursive: true });
+    await appendFile(TEMPLATE_LOG_PATH, `${JSON.stringify(entry)}\n`, 'utf8');
+
+    try {
+      await getSupabaseClient().from(TEMPLATE_TELEMETRY_TABLE).insert({
+        agent_id: entry.agentId,
+        run_id: entry.runId,
+        level: entry.level,
+        event: entry.event,
+        details: {
+          ...(entry.details || {}),
+          action: entry.action,
+          requestId: entry.requestId,
+          surface: entry.surface,
+          status: entry.status,
+          hostname: hostname(),
+        },
+        duration_ms: entry.durationMs,
+        created_at: entry.createdAt,
+      });
+    } catch {}
+
+    const line = `[${entry.createdAt}] [${entry.agentId}] [${entry.surface}] [${entry.level.toUpperCase()}] ${entry.event}`;
+    if (entry.level === 'error') {
+      console.error(line, entry.details || '');
+    } else if (entry.level === 'warn') {
+      console.warn(line, entry.details || '');
+    } else {
+      console.log(line, entry.details || '');
+    }
+
+    return entry;
+  }
+
+  started(surface: string, event: string, details?: Record<string, unknown>, requestId?: string, action?: string) {
+    return this.log({ surface, event, details, requestId, action, level: 'info', status: 'started' });
+  }
+
+  accepted(surface: string, event: string, details?: Record<string, unknown>, requestId?: string, action?: string) {
+    return this.log({ surface, event, details, requestId, action, level: 'info', status: 'accepted' });
+  }
+
+  succeeded(
+    surface: string,
+    event: string,
+    details?: Record<string, unknown>,
+    durationMs?: number,
+    requestId?: string,
+    action?: string,
+  ) {
+    return this.log({
+      surface,
+      event,
+      details,
+      durationMs,
+      requestId,
+      action,
+      level: 'info',
+      status: 'completed',
+    });
+  }
+
+  failed(surface: string, event: string, error: unknown, durationMs?: number, requestId?: string, action?: string) {
+    const details = error instanceof Error ? { error: error.message } : { error: String(error) };
+    return this.log({
+      surface,
+      event,
+      details,
+      durationMs,
+      requestId,
+      action,
+      level: 'error',
+      status: 'failed',
+    });
+  }
+}
+
+export function createTemplateLogger(runId?: string) {
+  return new TemplateLogger(runId);
+}

src/lib/telemetry/ZeroTrustAuth.ts

@@ -0,0 +1,63 @@
+import { verify } from 'jsonwebtoken';
+import { resolveTemplateAgentConfig } from '../../metadata.js';
+import { createTemplateLogger } from './SentinelLogger.js';
+import type { IncomingMessage } from 'node:http';
+
+// We fetch the public key (or use a shared secret if configured) from SIN-Authenticator's OIDC jwks endpoint or env
+const OIDC_PUBLIC_KEY = process.env.SIN_OIDC_PUBLIC_KEY || process.env.SIN_SHARED_SECRET || '';
+
+export type AuthContext = {
+  subject: string;
+  roles: string[];
+  claims: Record<string, unknown>;
+  isValid: boolean;
+  error?: string;
+};
+
+export async function verifyZeroTrustToken(request: IncomingMessage, runId?: string): Promise<AuthContext> {
+  const logger = createTemplateLogger(runId);
+  const authHeader = request.headers.authorization;
+
+  if (!authHeader || !authHeader.startsWith('Bearer ')) {
+    await logger.failed('auth.zero_trust', 'auth.token.missing', new Error('Missing or malformed Authorization header'));
+    return { subject: 'anonymous', roles: [], claims: {}, isValid: false, error: 'missing_token' };
+  }
+
+  const token = authHeader.split(' ')[1];
+
+  if (!OIDC_PUBLIC_KEY) {
+    // If the fleet runs in a mode without strict OIDC enforcement configured yet,
+    // we log a warning but might fail closed depending on fleet policy.
+    // For Epic #195, we want to enforce zero-trust strictly when keys are present.
+    await logger.log({
+      surface: 'auth.zero_trust',
+      event: 'auth.keys.missing',
+      level: 'warn',
+      status: 'failed',
+      details: { note: 'No SIN_OIDC_PUBLIC_KEY or SIN_SHARED_SECRET configured for verification.' }
+    });
+    return { subject: 'anonymous', roles: [], claims: {}, isValid: false, error: 'missing_keys' };
+  }
+
+  try {
+    const decoded = verify(token, OIDC_PUBLIC_KEY, { algorithms: ['RS256', 'HS256'] }) as Record<string, unknown>;
+    
+    await logger.succeeded('auth.zero_trust', 'auth.token.verified', { subject: decoded.sub });
+    
+    return {
+      subject: String(decoded.sub || 'unknown'),
+      roles: Array.isArray(decoded.roles) ? decoded.roles.map(String) : [],
+      claims: decoded,
+      isValid: true
+    };
+  } catch (error) {
+    await logger.failed('auth.zero_trust', 'auth.token.rejected', error);
+    return { 
+      subject: 'anonymous', 
+      roles: [], 
+      claims: {}, 
+      isValid: false, 
+      error: error instanceof Error ? error.message : String(error) 
+    };
+  }
+}

src/mcp-server.ts

@@ -0,0 +1,105 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import { executeTemplateAgentAction } from './runtime.js';
+
+const onboardingSaveSchema = z.object({
+  ownerEmail: z.string().optional(),
+  notes: z.string().optional(),
+  confirm: z.boolean().optional(),
+});
+
+const room13ClaimSchema = z.object({
+  room13Url: z.string().optional(),
+  bearerToken: z.string().optional(),
+  workerName: z.string().optional(),
+  confirm: z.boolean().optional(),
+});
+
+const TOOLS = [
+  {
+    name: 'sin-code-ai_help',
+    description: 'Describe available agent actions.',
+    inputSchema: { type: 'object', properties: {} },
+    parse: () => ({}),
+    handler: async () => executeTemplateAgentAction({ action: 'agent.help' }),
+  },
+  {
+    name: 'sin-code-ai_health',
+    description: 'Check base agent readiness.',
+    inputSchema: { type: 'object', properties: {} },
+    parse: () => ({}),
+    handler: async () => executeTemplateAgentAction({ action: 'sin.code.ai.health' }),
+  },
+  {
+    name: 'sin-code-ai_room13_claim',
+    description: 'Claim next task from Room-13. Requires confirm=true.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        room13Url: { type: 'string' },
+        bearerToken: { type: 'string' },
+        workerName: { type: 'string' },
+        confirm: { type: 'boolean' },
+      },
+    },
+    parse: (input: unknown) => room13ClaimSchema.parse(input ?? {}),
+    handler: async (input: z.infer<typeof room13ClaimSchema>) =>
+      executeTemplateAgentAction({ action: 'sin.code.ai.room13.claim', ...input }),
+  },
+  {
+    name: 'sin-code-ai_onboarding_status',
+    description: 'Read onboarding state.',
+    inputSchema: { type: 'object', properties: {} },
+    parse: () => ({}),
+    handler: async () => executeTemplateAgentAction({ action: 'sin.code.ai.onboarding.status' }),
+  },
+  {
+    name: 'sin-code-ai_onboarding_save',
+    description: 'Persist onboarding state. Requires confirm=true.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        ownerEmail: { type: 'string' },
+        notes: { type: 'string' },
+        confirm: { type: 'boolean' },
+      },
+    },
+    parse: (input: unknown) => onboardingSaveSchema.parse(input ?? {}),
+    handler: async (input: z.infer<typeof onboardingSaveSchema>) =>
+      executeTemplateAgentAction({ action: 'sin.code.ai.onboarding.save', ...input }),
+  },
+] as const;
+
+export async function startMcpServer(): Promise<void> {
+  const server = new Server({ name: 'sin-code-ai', version: '0.1.0' }, { capabilities: { tools: {} } });
+
+  server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+      tools: TOOLS.map((tool) => ({
+        name: tool.name,
+        description: tool.description,
+        inputSchema: tool.inputSchema,
+      })),
+    };
+  });
+
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const tool = TOOLS.find((entry) => entry.name === request.params.name);
+    if (!tool) {
+      return {
+        content: [{ type: 'text', text: `Unknown tool: ${request.params.name}` }],
+        isError: true,
+      };
+    }
+    const parsed = tool.parse(request.params.arguments ?? {});
+    const result = await tool.handler(parsed);
+    return {
+      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+    };
+  });
+
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}

src/metadata.ts

@@ -0,0 +1,73 @@
+import process from 'node:process';
+
+export const TEMPLATE_AGENT_ID = 'sin-code-ai';
+export const TEMPLATE_AGENT_NAME = 'SIN-Code-AI';
+export const TEMPLATE_AGENT_NAMESPACE = 'sin.code.ai';
+export const TEMPLATE_AGENT_DESCRIPTION = 'Elite 2026 AI Engineering Architect. Architects and implements RAG pipelines, prompt templates, semantic search, OpenCode MCP tools, and AI-native application logic.';
+export const TEMPLATE_AGENT_VERSION = '2026.03.09';
+export const TEMPLATE_AGENT_DEFAULT_HOST = '127.0.0.1';
+export const TEMPLATE_AGENT_DEFAULT_PORT = Number(process.env.PORT || 8000);
+export const TEMPLATE_AGENT_EXECUTOR_CONTRACT = 'services/workers/hf_executor_contract.json';
+export const TEMPLATE_AGENT_CAPABILITY_REGISTRY = 'control_plane.capabilities';
+
+export const TEMPLATE_AGENT_SKILLS = [
+  {
+    id: 'sin.code.ai.health',
+    name: 'Health',
+    description: 'Check base agent readiness and identity.',
+  },
+  {
+    id: 'sin.code.ai.onboarding.status',
+    name: 'Onboarding Status',
+    description: 'Read persisted onboarding state.',
+  },
+  {
+    id: 'sin.code.ai.onboarding.save',
+    name: 'Onboarding Save',
+    description: 'Persist onboarding defaults for future autonomous runs.',
+  },
+  {
+    id: 'sin.code.ai.room13.claim',
+    name: 'Room-13 Claim',
+    description: 'Register worker and claim next task from Room-13 coordinator.',
+  },
+] as const;
+
+export function resolveTemplateAgentConfig() {
+  const host =
+    process.env.SIN_CODE_AI_HOST?.trim() ||
+    (process.env.PORT ? '0.0.0.0' : process.env.HOST?.trim() || TEMPLATE_AGENT_DEFAULT_HOST);
+  const port = parseInteger(process.env.SIN_CODE_AI_PORT, parseInteger(process.env.PORT, TEMPLATE_AGENT_DEFAULT_PORT));
+  const fallbackPublicHost = host === '0.0.0.0' ? '127.0.0.1' : host;
+  const publicBaseUrl =
+    process.env.SIN_CODE_AI_PUBLIC_BASE_URL?.trim() ||
+    (process.env.SPACE_HOST?.trim() ? `https://${process.env.SPACE_HOST.trim()}` : `http://${fallbackPublicHost}:${port}`);
+  return { host, port, publicBaseUrl: publicBaseUrl.replace(/\/+$/, '') };
+}
+
+export function buildAgentCard(baseUrl: string) {
+  const normalizedBaseUrl = baseUrl.replace(/\/+$/, '');
+  const rpcUrl = `${normalizedBaseUrl}/a2a/v1`;
+  return {
+    name: TEMPLATE_AGENT_NAME,
+    description: TEMPLATE_AGENT_DESCRIPTION,
+    version: TEMPLATE_AGENT_VERSION,
+    documentationUrl: normalizedBaseUrl,
+    url: rpcUrl,
+    capabilities: { streaming: false, pushNotifications: false },
+    defaultInputModes: ['text/plain', 'application/json'],
+    defaultOutputModes: ['text/plain', 'application/json'],
+    metadata: {
+      projectionMode: 'control-plane-first',
+      capabilityRegistry: TEMPLATE_AGENT_CAPABILITY_REGISTRY,
+      executorContract: TEMPLATE_AGENT_EXECUTOR_CONTRACT,
+    },
+    skills: [...TEMPLATE_AGENT_SKILLS],
+    supportedInterfaces: [{ url: rpcUrl, protocolBinding: 'JSONRPC', protocolVersion: '1.0' }],
+  };
+}
+
+function parseInteger(input: string | undefined, fallback: number) {
+  const parsed = Number.parseInt(String(input || '').trim(), 10);
+  return Number.isFinite(parsed) ? parsed : fallback;
+}

src/runtime.ts

@@ -0,0 +1,108 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { homedir } from 'node:os';
+
+const DEFAULT_STATE_PATH = join(homedir(), '.config', 'sin', 'sin-code-ai', 'onboarding-state.json');
+
+type OnboardingState = {
+  ownerEmail?: string;
+  notes?: string;
+  updatedAt?: string;
+};
+
+export type TemplateAgentAction =
+  | { action: 'agent.help' }
+  | { action: 'sin.code.ai.health' }
+  | { action: 'sin.code.ai.room13.claim'; room13Url?: string; bearerToken?: string; workerName?: string; confirm?: boolean }
+  | { action: 'sin.code.ai.onboarding.status' }
+  | { action: 'sin.code.ai.onboarding.save'; ownerEmail?: string; notes?: string; confirm?: boolean };
+
+export async function executeTemplateAgentAction(action: TemplateAgentAction): Promise<unknown> {
+  switch (action.action) {
+    case 'agent.help':
+      return buildHelpPayload();
+    case 'sin.code.ai.health':
+      return {
+        ok: true,
+        agent: 'sin-code-ai',
+        primaryModel: 'openai/gpt-5.4',
+        team: 'Team - Coding',
+      };
+    case 'sin.code.ai.room13.claim':
+      return await runRoom13Claim(action);
+    case 'sin.code.ai.onboarding.status':
+      return {
+        ok: true,
+        statePath: DEFAULT_STATE_PATH,
+        state: await readState(),
+      };
+    case 'sin.code.ai.onboarding.save':
+      if (!action.confirm) {
+        throw new Error('input_required:confirm=true required');
+      }
+      return {
+        ok: true,
+        statePath: DEFAULT_STATE_PATH,
+        state: await writeState({
+          ownerEmail: clean(action.ownerEmail),
+          notes: clean(action.notes),
+          updatedAt: new Date().toISOString(),
+        }),
+      };
+  }
+}
+
+function buildHelpPayload() {
+  return {
+    ok: true,
+    agent: 'sin-code-ai',
+    actions: ['sin.code.ai.health', 'sin.code.ai.room13.claim', 'sin.code.ai.onboarding.status', 'sin.code.ai.onboarding.save'],
+    controlPlane: {
+      projectionMode: 'control-plane-first',
+      capabilityRegistry: 'control_plane.capabilities',
+      consumerAuthScript: './scripts/hf_pull_script.py',
+      completeInstallScript: './scripts/complete-install.sh',
+    },
+  };
+}
+
+async function readState(): Promise<OnboardingState | null> {
+  try {
+    return JSON.parse(await readFile(DEFAULT_STATE_PATH, 'utf8')) as OnboardingState;
+  } catch {
+    return null;
+  }
+}
+
+async function writeState(state: OnboardingState) {
+  await mkdir(dirname(DEFAULT_STATE_PATH), { recursive: true });
+  await writeFile(DEFAULT_STATE_PATH, `${JSON.stringify(state, null, 2)}\n`, 'utf8');
+  return state;
+}
+
+function clean(value: string | undefined) {
+  const normalized = String(value || '').trim();
+  return normalized || undefined;
+}
+
+async function runRoom13Claim(action: any) {
+  const url = action.room13Url || process.env.ROOM13_URL;
+  const token = action.bearerToken || process.env.ROOM13_BEARER_TOKEN;
+  const worker = action.workerName || process.env.ROOM13_WORKER_NAME || 'sin-code-ai';
+  if (!url || !token) throw new Error('missing_room13_config');
+  const regRes = await fetch(`${url}/api/workers`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${token}` },
+    body: JSON.stringify({ name: `${worker}:team-coding`, type: 'general', capabilities: ['zeus_github_branch', 'sin_issues_pool_issue'], worker_identity: worker, persona_id: worker }),
+  });
+  if (!regRes.ok) throw new Error(`Failed to register worker: ${await regRes.text()}`);
+  const workerId = (await regRes.json() as any).id;
+  const claimRes = await fetch(`${url}/api/tasks/claim-next`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${token}` },
+    body: JSON.stringify({ worker_id: workerId, accepted_types: ['zeus_github_branch', 'sin_issues_pool_issue'], accepted_team_ids: ['team-coding'], min_priority: 'low', run_id: `${worker}-${Date.now()}`, lease_epoch: 0 }),
+  });
+  if (claimRes.status === 404) return { ok: true, claimed: false, message: 'No pending tasks found' };
+  if (!claimRes.ok) throw new Error(`Failed to claim task: ${await claimRes.text()}`);
+  return { ok: true, claimed: true, workerId, task: await claimRes.json() };
+}

src/supabase.ts

@@ -0,0 +1,22 @@
+import { createClient, SupabaseClient } from '@supabase/supabase-js';
+
+// Database coupling to global SIN-Supabase A2A (Oracle OCI VM 200GB)
+// SSOT: https://docs.google.com/document/d/1RtoHn4I0GntuEEOHHkqoh_dMuGzgMwQz7_8oxAOpQbw/edit?tab=t.zglvro7czbod
+
+let supabaseInstance: SupabaseClient | null = null;
+
+export function getSupabaseClient(): SupabaseClient {
+  if (supabaseInstance) {
+    return supabaseInstance;
+  }
+
+  const supabaseUrl = process.env.SIN_SUPABASE_URL;
+  const supabaseKey = process.env.SIN_SUPABASE_SERVICE_ROLE_KEY;
+
+  if (!supabaseUrl || !supabaseKey) {
+    throw new Error('missing_supabase_credentials');
+  }
+
+  supabaseInstance = createClient(supabaseUrl, supabaseKey);
+  return supabaseInstance;
+}

test/logging.test.mjs

@@ -0,0 +1,75 @@
+import assert from 'node:assert/strict';
+import { mkdtemp, readFile } from 'node:fs/promises';
+import { spawnSync } from 'node:child_process';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import test from 'node:test';
+
+const DIST_ROOT = new URL('../dist/src/', import.meta.url);
+const CLI_PATH = new URL('../dist/src/cli.js', import.meta.url);
+
+async function importFresh(relativePath) {
+  return import(new URL(`${relativePath}?t=${Date.now()}-${Math.random()}`, DIST_ROOT).href);
+}
+
+async function readFileUntilMatch(filePath, matcher, attempts = 10) {
+  let last = '';
+  for (let index = 0; index < attempts; index += 1) {
+    last = await readFile(filePath, 'utf8');
+    if (matcher.test(last)) {
+      return last;
+    }
+    await new Promise((resolve) => setTimeout(resolve, 50));
+  }
+  return last;
+}
+
+test('runtime, graph, and http server append durable log events', async () => {
+  const home = await mkdtemp(join(tmpdir(), 'template-agent-logs-'));
+  process.env.HOME = home;
+  process.env.PORT = '0';
+
+  const { executeTemplateAgentAction, TEMPLATE_AGENT_ACTIONS } = await importFresh('./runtime.js');
+  const { runAgentGraph } = await importFresh('./agent/graph.js');
+  const { createTemplateAgentHttpServer } = await importFresh('./a2a-http.js');
+
+  await executeTemplateAgentAction(
+    { action: TEMPLATE_AGENT_ACTIONS.HELP },
+    { surface: 'test', runId: 'runtime-run', requestId: 'runtime-request' },
+  );
+  await runAgentGraph(
+    { action: TEMPLATE_AGENT_ACTIONS.HELP },
+    { runId: 'graph-run', requestId: 'graph-request', context: { source: 'test' } },
+  );
+
+  const handle = createTemplateAgentHttpServer();
+  await handle.start();
+  const address = handle.server.address();
+  const port = typeof address === 'object' && address ? address.port : 0;
+  const response = await fetch(`http://127.0.0.1:${port}/health`);
+  assert.equal(response.status, 200);
+  await handle.stop();
+
+  const logPath = join(home, '.config', 'sin', 'sin-code-ai', 'events.ndjson');
+  const content = await readFileUntilMatch(logPath, /http\.request\.succeeded/);
+  assert.match(content, /runtime\.action\.started/);
+  assert.match(content, /runtime\.action\.succeeded/);
+  assert.match(content, /graph\.run\.started/);
+  assert.match(content, /graph\.tools\.succeeded/);
+  assert.match(content, /http\.request\.succeeded/);
+});
+
+test('cli print-card logs command lifecycle without crashing', async () => {
+  const home = await mkdtemp(join(tmpdir(), 'template-agent-cli-'));
+  const result = spawnSync(process.execPath, [CLI_PATH.pathname, 'print-card'], {
+    env: { ...process.env, HOME: home },
+    encoding: 'utf8',
+  });
+
+  assert.equal(result.status, 0, result.stderr);
+
+  const logPath = join(home, '.config', 'sin', 'sin-code-ai', 'events.ndjson');
+  const content = await readFile(logPath, 'utf8');
+  assert.match(content, /cli\.command\.started/);
+  assert.match(content, /cli\.command\.succeeded/);
+});

test/supabase.test.mjs

@@ -0,0 +1,16 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { getSupabaseClient } from '../dist/src/supabase.js';
+
+test('getSupabaseClient fails closed when credentials are missing', async () => {
+  const originalUrl = process.env.SIN_SUPABASE_URL;
+  const originalKey = process.env.SIN_SUPABASE_SERVICE_ROLE_KEY;
+  delete process.env.SIN_SUPABASE_URL;
+  delete process.env.SIN_SUPABASE_SERVICE_ROLE_KEY;
+  try {
+    assert.throws(() => getSupabaseClient(), /missing_supabase_credentials/);
+  } finally {
+    if (originalUrl !== undefined) process.env.SIN_SUPABASE_URL = originalUrl;
+    if (originalKey !== undefined) process.env.SIN_SUPABASE_SERVICE_ROLE_KEY = originalKey;
+  }
+});

test/supabase_saver.test.mjs

@@ -0,0 +1,37 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { randomUUID } from 'node:crypto';
+
+const DIST_ROOT = new URL('../dist/src/', import.meta.url);
+
+async function importFresh(relativePath) {
+  return import(new URL(`${relativePath}?t=${Date.now()}-${Math.random()}`, DIST_ROOT).href);
+}
+
+test('SupabaseSaver can be imported and initialized without crashing', async () => {
+  const { SupabaseSaver } = await importFresh('./agent/SupabaseSaver.js');
+  const saver = new SupabaseSaver();
+  assert.ok(saver);
+  assert.equal(typeof saver.getTuple, 'function');
+  assert.equal(typeof saver.put, 'function');
+});
+
+test('createAgentGraph wires SupabaseSaver successfully or falls back cleanly', async () => {
+  const { createAgentGraph } = await importFresh('./agent/graph.js');
+  
+  // Default instantiation handles missing env vars without throwing unhandled exceptions 
+  // because the Supabase client logic handles it or createAgentGraph catches it
+  const graph = createAgentGraph();
+  assert.ok(graph);
+  
+  // Can explicitly configure checkpointer
+  const customGraph = createAgentGraph({ checkpointer: null });
+  assert.ok(customGraph);
+});
+
+test('createAgentGraph supports interruptBefore for Human-in-the-loop', async () => {
+  const { createAgentGraph } = await importFresh('./agent/graph.js');
+  const graph = createAgentGraph({ requireApproval: true, checkpointer: null });
+  assert.ok(graph);
+  // Internally this sets interruptBefore: ['tools']
+});

tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "declaration": true,
+    "outDir": "dist",
+    "rootDir": ".",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*.ts"]
+}
+