ziro 0.1.1__tar.gz

ziro-0.1.1/.claude/settings.json

@@ -0,0 +1,12 @@
+{
+    "permissions": {
+        "deny": [
+            "Read(./.env)",
+            "Read(./.env.local)",
+            "Read(./.env.staging)",
+            "Read(./.env.production)",
+            "Read(./.env.test)",
+            "Read(./.env.uat)"
+        ]
+    }
+}

ziro-0.1.1/.env.example

@@ -0,0 +1,21 @@
+# LLM via OpenRouter (https://openrouter.ai)
+OPENROUTER_API_KEY=
+OPENROUTER_MODEL=google/gemini-2.5-flash-lite
+# Enable reasoning: low | medium | high (leave empty to disable)
+OPENROUTER_REASONING_EFFORT=
+# App identity shown on OpenRouter activity/rankings (HTTP-Referer + X-OpenRouter-Title)
+OPENROUTER_APP_TITLE=Ziro
+OPENROUTER_APP_URL=https://www.langchain.com/langgraph
+
+# Langfuse monitoring (https://langfuse.com)
+LANGFUSE_PUBLIC_KEY=
+LANGFUSE_SECRET_KEY=
+LANGFUSE_HOST=https://cloud.langfuse.com
+
+# Production PostgreSQL — uncomment to enable prod backends
+# Start Postgres first: docker compose up -d
+# DATABASE_URL=postgresql+psycopg://agent:agent@localhost:5432/agentdb
+
+# Optional: LangSmith tracing
+# LANGCHAIN_TRACING_V2=true
+# LANGCHAIN_API_KEY=

ziro-0.1.1/.github/workflows/release.yml

@@ -0,0 +1,69 @@
+name: release
+
+# Two-stage release with a TestPyPI gate, tag-driven version (hatch-vcs), and
+# PyPI Trusted Publishing (OIDC — no stored tokens).
+#
+#   1. push a tag  v0.2.0            -> build + publish to TestPyPI  (smoke test)
+#   2. publish a GitHub Release      -> build + publish to PyPI      (promote)
+#
+# See docs/RELEASING.md for the runbook and the one-time PyPI/TestPyPI setup.
+
+on:
+  push:
+    tags: ["v*"]
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: build sdist + wheel
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0        # hatch-vcs needs full history + tags to resolve the version
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+      - name: Build
+        run: uv build          # -> dist/ziro-<version>.tar.gz + .whl
+      - name: Show version
+        run: ls -l dist/
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  testpypi:
+    name: publish to TestPyPI
+    needs: build
+    if: github.event_name == 'push'          # fires on the v* tag push
+    runs-on: ubuntu-latest
+    environment: testpypi                     # GitHub env; scopes the OIDC trust
+    permissions:
+      id-token: write                         # required for Trusted Publishing
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+  pypi:
+    name: publish to PyPI
+    needs: build
+    if: github.event_name == 'release'        # fires when a GitHub Release is published
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

ziro-0.1.1/.gitignore

@@ -0,0 +1,34 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+# generated by hatch-vcs at build time
+ziro/_version.py
+tmp/
+.mypy_cache/
+**/.mypy_cache/
+
+# Virtual environments
+.venv
+
+# Local git worktrees
+.worktrees/
+
+# Environment variables
+.env
+.mcp.json
+
+# Dev data (SQLite checkpoints and FAISS indexes)
+data/*.db
+data/*.db-*
+data/faiss_*/
+data/audit/
+data/voices/
+data/mcp_oauth/
+data/model_catalog.json
+models/*.gguf
+*.log
+snapshot_report.html

ziro-0.1.1/.python-version

@@ -0,0 +1 @@
+3.11.9

ziro-0.1.1/.vscode/launch.json

@@ -0,0 +1,146 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Ziro: Run (pick agent)",
+      "type": "debugpy",
+      "request": "launch",
+      "module": "app.main",
+      "cwd": "${workspaceFolder}",
+      "console": "integratedTerminal",
+      "args": [
+        "--user",
+        "${input:userId}",
+        "--agent",
+        "${input:agentId}",
+        "--thread",
+        "${input:threadId}"
+      ]
+    },
+    {
+      "name": "Ziro: Run (interactive picker)",
+      "type": "debugpy",
+      "request": "launch",
+      "module": "app.main",
+      "cwd": "${workspaceFolder}",
+      "console": "integratedTerminal",
+      "args": [
+        "--user",
+        "${input:userId}",
+        "--thread",
+        "${input:threadId}"
+      ]
+    },
+    {
+      "name": "Ziro: Run Life Coach (default)",
+      "type": "debugpy",
+      "request": "launch",
+      "module": "app.main",
+      "cwd": "${workspaceFolder}",
+      "console": "integratedTerminal",
+      "args": [
+        "--user",
+        "${input:userId}",
+        "--agent",
+        "default",
+        "--thread",
+        "${input:threadId}"
+      ]
+    },
+    {
+      "name": "Ziro: Run Researcher",
+      "type": "debugpy",
+      "request": "launch",
+      "module": "app.main",
+      "cwd": "${workspaceFolder}",
+      "console": "integratedTerminal",
+      "args": [
+        "--user",
+        "${input:userId}",
+        "--agent",
+        "researcher",
+        "--thread",
+        "${input:threadId}"
+      ]
+    },
+    {
+      "name": "Ziro: chat_once (single-shot)",
+      "type": "debugpy",
+      "request": "launch",
+      "module": "app.cli.chat_once",
+      "cwd": "${workspaceFolder}",
+      "console": "integratedTerminal",
+      "args": [
+        "--user",
+        "${input:userId}",
+        "--agent",
+        "${input:agentId}",
+        "--message",
+        "${input:message}"
+      ]
+    },
+    {
+      "name": "Ziro: manage agents (list)",
+      "type": "debugpy",
+      "request": "launch",
+      "module": "app.cli.manage_agents",
+      "cwd": "${workspaceFolder}",
+      "console": "integratedTerminal",
+      "args": [
+        "list"
+      ]
+    },
+    {
+      "name": "Python Debugger: Current File with Arguments",
+      "type": "debugpy",
+      "request": "launch",
+      "program": "${file}",
+      "console": "integratedTerminal",
+      "args": "${command:pickArgs}"
+    }
+  ],
+  "inputs": [
+    {
+      "id": "userId",
+      "type": "promptString",
+      "description": "User ID (scopes long-term memory)",
+      "default": "test-user"
+    },
+    {
+      "id": "agentId",
+      "type": "pickString",
+      "description": "Agent to run",
+      "options": [
+        {
+          "label": "Generalist",
+          "value": "default"
+        },
+        {
+          "label": "Life Coach",
+          "value": "life_coach"
+        },
+        {
+          "label": "Researcher",
+          "value": "researcher"
+        },
+        {
+          "label": "Researcher (Docker sandbox)",
+          "value": "researcher_docker"
+        }
+      ],
+      "default": "default"
+    },
+    {
+      "id": "threadId",
+      "type": "promptString",
+      "description": "Thread ID to resume (blank for new session)",
+      "default": ""
+    },
+    {
+      "id": "message",
+      "type": "promptString",
+      "description": "Message (chat_once single-shot)",
+      "default": "Hello"
+    }
+  ]
+}

ziro-0.1.1/.vscode/settings.json

@@ -0,0 +1,19 @@
+{
+    "python.defaultInterpreterPath": "${workspaceFolder}/.venv/Scripts/python.exe",
+    "python.terminal.activateEnvironment": false,
+    "python.testing.pytestArgs": [
+        "."
+    ],
+    "python.testing.unittestEnabled": false,
+    "python.testing.pytestEnabled": true,
+
+    // --- Ziro TUI rendering in the integrated terminal ---
+    // The TUI (Textual) repaints fast and full-screen. VS Code's terminal GPU
+    // renderer can drop/garble glyphs under that load (text shows as "eneralist",
+    // "minima minima m"); turning it off renders the TUI cleanly.
+    "terminal.integrated.gpuAcceleration": "off",
+    // VS Code re-tints terminal colors to hit a contrast ratio, which shifts the
+    // theme's exact palette (e.g. the steel-blue agent name). 1 = use the theme's
+    // colors verbatim.
+    "terminal.integrated.minimumContrastRatio": 1
+}

ziro-0.1.1/.worktreeinclude

@@ -0,0 +1,14 @@
+# Local environment files
+.env
+.env.local
+.env.*
+
+# Extra
+tmp
+tmp/*
+
+# settings.local.json (personal permission overrides, gitignored)
+.claude/settings.json
+.claude/settings.local.json
+.mcp.json
+CLAUDE.local.md