sipi-bot 0.1.0__tar.gz

sipi_bot-0.1.0/LICENSE

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

sipi_bot-0.1.0/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: sipi-bot
+Version: 0.1.0
+Summary: The spend firewall for autonomous AI agents — approve, block, or flag every transaction before a dollar moves.
+Author-email: Sipi <sales@sipiteno.com>
+License: MIT
+Project-URL: Homepage, https://sipi.bot
+Project-URL: Repository, https://github.com/kindrat86/sipi-bot
+Project-URL: Live Dashboard, https://sipi.bot/dashboard
+Project-URL: Eval Report, https://sipi.bot/eval
+Keywords: ai-agents,agent-economy,mcp,spend-control,guardrails,agent-safety,x402,autonomous-agents
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Security
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0.0; extra == "mcp"
+Dynamic: license-file
+
+# sipi.bot — the spend firewall for autonomous AI agents
+
+> You gave an autonomous agent your credit card and no spending limit.
+> **sipi.bot** is the firewall that approves, blocks, or flags every
+> transaction against *your* rules — before a single dollar moves.
+
+One capability, three surfaces:
+
+- **MCP tool** — Claude Code / Cursor / Hermes call `evaluate_spend` natively.
+- **HTTP API** — any agent `POST /v1/transactions/evaluate`.
+- **CLI** — verify without an agent.
+
+## 10-second test
+
+```bash
+pip install sipi-bot
+sipi-bot eval --amount 6200 --merchant unknown-gpu.ru --category compute
+# -> {"decision": "BLOCKED", "reason": "Transaction $6,200.00 exceeds per-transaction limit $500.00."}
+
+sipi-bot serve --port 8080   # landing + dashboard + API
+```
+
+Or from source:
+
+```bash
+python3.11 -m spendfirewall.cli eval --amount 6200 --merchant unknown-gpu.ru --category compute
+```
+
+Then open http://localhost:8080 (landing), http://localhost:8080/dashboard (control room), http://localhost:8080/pricing (Team $99 / Business $499).
+
+**Hosted:** [sipi.bot](https://sipi.bot) · [dashboard](https://sipi.bot/dashboard) · [get an API key →](https://sipi.bot/pricing)
+
+## The core call an agent makes before spending
+
+```bash
+curl -X POST https://sipi.bot/v1/transactions/evaluate \
+  -H "Authorization: Bearer sk_live_..." \
+  -d '{"amount": 6200, "merchant": "unknown-gpu.ru", "category": "compute"}'
+```
+
+Returns one of: `APPROVED` (go), `BLOCKED` (do not spend), `FLAGGED` (human must approve).
+
+## Rule types
+
+`per_transaction`, `daily_total`, `velocity` (runaway protection), `merchant_block`,
+`merchant_allow` (allowlist), `category_limit`, `time_window`, `approval_threshold`.
+
+First `BLOCKED` wins. `FLAGGED` is non-blocking (queued for human approval).
+
+## Eval gym (the guarantee + the sales asset)
+
+```bash
+python3.11 -m spendfirewall.eval.run_eval   # 53 scenarios -> eval_report.json + .md
+```
+
+53/53 passing. Served live at `/eval`. This is what backs the guarantee:
+*if the firewall green-lights a spend that breaks your rule, that month is free.*
+
+## MCP config
+
+```json
+{ "mcpServers": { "sipi-bot": { "command": "python", "args": ["-m", "spendfirewall.mcp_server"] } } }
+```
+
+## Framework integrations
+
+Drop-in "spend guardrails" recipes — each verified live against https://sipi.bot:
+
+- [LangChain & CrewAI](integrations/SPEND_GUARDRAILS_RECIPE.md) — `@tool` / `BaseTool` wrappers + zero-dep `sipi_guard.py` client
+- [OpenAI Agents SDK](integrations/openai-agents-sdk.md) — `@function_tool` guard
+- [Vercel AI SDK](integrations/vercel-ai-sdk.md) — `tool({execute})` guard + `sipiGuard.ts` client
+
+The core call is always the same: `evaluate(amount, merchant, category)` → `APPROVED` / `BLOCKED` / `FLAGGED`.
+
+## Deploy (Fly.io)
+
+```bash
+flyctl launch --no-deploy --copy-config --name sipi-bot-firewall
+flyctl volumes create sf_data --size 1 --region iad --yes
+flyctl deploy
+flyctl certs add sipi.bot
+```
+
+Stdlib-only (http.server, sqlite3). No framework, trivial deploy. `pip install mcp` only for the MCP surface.

sipi_bot-0.1.0/README.md

@@ -0,0 +1,84 @@
+# sipi.bot — the spend firewall for autonomous AI agents
+
+> You gave an autonomous agent your credit card and no spending limit.
+> **sipi.bot** is the firewall that approves, blocks, or flags every
+> transaction against *your* rules — before a single dollar moves.
+
+One capability, three surfaces:
+
+- **MCP tool** — Claude Code / Cursor / Hermes call `evaluate_spend` natively.
+- **HTTP API** — any agent `POST /v1/transactions/evaluate`.
+- **CLI** — verify without an agent.
+
+## 10-second test
+
+```bash
+pip install sipi-bot
+sipi-bot eval --amount 6200 --merchant unknown-gpu.ru --category compute
+# -> {"decision": "BLOCKED", "reason": "Transaction $6,200.00 exceeds per-transaction limit $500.00."}
+
+sipi-bot serve --port 8080   # landing + dashboard + API
+```
+
+Or from source:
+
+```bash
+python3.11 -m spendfirewall.cli eval --amount 6200 --merchant unknown-gpu.ru --category compute
+```
+
+Then open http://localhost:8080 (landing), http://localhost:8080/dashboard (control room), http://localhost:8080/pricing (Team $99 / Business $499).
+
+**Hosted:** [sipi.bot](https://sipi.bot) · [dashboard](https://sipi.bot/dashboard) · [get an API key →](https://sipi.bot/pricing)
+
+## The core call an agent makes before spending
+
+```bash
+curl -X POST https://sipi.bot/v1/transactions/evaluate \
+  -H "Authorization: Bearer sk_live_..." \
+  -d '{"amount": 6200, "merchant": "unknown-gpu.ru", "category": "compute"}'
+```
+
+Returns one of: `APPROVED` (go), `BLOCKED` (do not spend), `FLAGGED` (human must approve).
+
+## Rule types
+
+`per_transaction`, `daily_total`, `velocity` (runaway protection), `merchant_block`,
+`merchant_allow` (allowlist), `category_limit`, `time_window`, `approval_threshold`.
+
+First `BLOCKED` wins. `FLAGGED` is non-blocking (queued for human approval).
+
+## Eval gym (the guarantee + the sales asset)
+
+```bash
+python3.11 -m spendfirewall.eval.run_eval   # 53 scenarios -> eval_report.json + .md
+```
+
+53/53 passing. Served live at `/eval`. This is what backs the guarantee:
+*if the firewall green-lights a spend that breaks your rule, that month is free.*
+
+## MCP config
+
+```json
+{ "mcpServers": { "sipi-bot": { "command": "python", "args": ["-m", "spendfirewall.mcp_server"] } } }
+```
+
+## Framework integrations
+
+Drop-in "spend guardrails" recipes — each verified live against https://sipi.bot:
+
+- [LangChain & CrewAI](integrations/SPEND_GUARDRAILS_RECIPE.md) — `@tool` / `BaseTool` wrappers + zero-dep `sipi_guard.py` client
+- [OpenAI Agents SDK](integrations/openai-agents-sdk.md) — `@function_tool` guard
+- [Vercel AI SDK](integrations/vercel-ai-sdk.md) — `tool({execute})` guard + `sipiGuard.ts` client
+
+The core call is always the same: `evaluate(amount, merchant, category)` → `APPROVED` / `BLOCKED` / `FLAGGED`.
+
+## Deploy (Fly.io)
+
+```bash
+flyctl launch --no-deploy --copy-config --name sipi-bot-firewall
+flyctl volumes create sf_data --size 1 --region iad --yes
+flyctl deploy
+flyctl certs add sipi.bot
+```
+
+Stdlib-only (http.server, sqlite3). No framework, trivial deploy. `pip install mcp` only for the MCP surface.

sipi_bot-0.1.0/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "sipi-bot"
+version = "0.1.0"
+description = "The spend firewall for autonomous AI agents — approve, block, or flag every transaction before a dollar moves."
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+authors = [{ name = "Sipi", email = "sales@sipiteno.com" }]
+keywords = ["ai-agents", "agent-economy", "mcp", "spend-control", "guardrails", "agent-safety", "x402", "autonomous-agents"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Security",
+]
+dependencies = []
+
+[project.optional-dependencies]
+mcp = ["mcp>=1.0.0"]
+
+[project.scripts]
+sipi-bot = "spendfirewall.cli:main"
+
+[project.urls]
+Homepage = "https://sipi.bot"
+Repository = "https://github.com/kindrat86/sipi-bot"
+"Live Dashboard" = "https://sipi.bot/dashboard"
+"Eval Report" = "https://sipi.bot/eval"
+
+[tool.setuptools.packages.find]
+include = ["spendfirewall*"]

sipi_bot-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

sipi_bot-0.1.0/sipi_bot.egg-info/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: sipi-bot
+Version: 0.1.0
+Summary: The spend firewall for autonomous AI agents — approve, block, or flag every transaction before a dollar moves.
+Author-email: Sipi <sales@sipiteno.com>
+License: MIT
+Project-URL: Homepage, https://sipi.bot
+Project-URL: Repository, https://github.com/kindrat86/sipi-bot
+Project-URL: Live Dashboard, https://sipi.bot/dashboard
+Project-URL: Eval Report, https://sipi.bot/eval
+Keywords: ai-agents,agent-economy,mcp,spend-control,guardrails,agent-safety,x402,autonomous-agents
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Security
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0.0; extra == "mcp"
+Dynamic: license-file
+
+# sipi.bot — the spend firewall for autonomous AI agents
+
+> You gave an autonomous agent your credit card and no spending limit.
+> **sipi.bot** is the firewall that approves, blocks, or flags every
+> transaction against *your* rules — before a single dollar moves.
+
+One capability, three surfaces:
+
+- **MCP tool** — Claude Code / Cursor / Hermes call `evaluate_spend` natively.
+- **HTTP API** — any agent `POST /v1/transactions/evaluate`.
+- **CLI** — verify without an agent.
+
+## 10-second test
+
+```bash
+pip install sipi-bot
+sipi-bot eval --amount 6200 --merchant unknown-gpu.ru --category compute
+# -> {"decision": "BLOCKED", "reason": "Transaction $6,200.00 exceeds per-transaction limit $500.00."}
+
+sipi-bot serve --port 8080   # landing + dashboard + API
+```
+
+Or from source:
+
+```bash
+python3.11 -m spendfirewall.cli eval --amount 6200 --merchant unknown-gpu.ru --category compute
+```
+
+Then open http://localhost:8080 (landing), http://localhost:8080/dashboard (control room), http://localhost:8080/pricing (Team $99 / Business $499).
+
+**Hosted:** [sipi.bot](https://sipi.bot) · [dashboard](https://sipi.bot/dashboard) · [get an API key →](https://sipi.bot/pricing)
+
+## The core call an agent makes before spending
+
+```bash
+curl -X POST https://sipi.bot/v1/transactions/evaluate \
+  -H "Authorization: Bearer sk_live_..." \
+  -d '{"amount": 6200, "merchant": "unknown-gpu.ru", "category": "compute"}'
+```
+
+Returns one of: `APPROVED` (go), `BLOCKED` (do not spend), `FLAGGED` (human must approve).
+
+## Rule types
+
+`per_transaction`, `daily_total`, `velocity` (runaway protection), `merchant_block`,
+`merchant_allow` (allowlist), `category_limit`, `time_window`, `approval_threshold`.
+
+First `BLOCKED` wins. `FLAGGED` is non-blocking (queued for human approval).
+
+## Eval gym (the guarantee + the sales asset)
+
+```bash
+python3.11 -m spendfirewall.eval.run_eval   # 53 scenarios -> eval_report.json + .md
+```
+
+53/53 passing. Served live at `/eval`. This is what backs the guarantee:
+*if the firewall green-lights a spend that breaks your rule, that month is free.*
+
+## MCP config
+
+```json
+{ "mcpServers": { "sipi-bot": { "command": "python", "args": ["-m", "spendfirewall.mcp_server"] } } }
+```
+
+## Framework integrations
+
+Drop-in "spend guardrails" recipes — each verified live against https://sipi.bot:
+
+- [LangChain & CrewAI](integrations/SPEND_GUARDRAILS_RECIPE.md) — `@tool` / `BaseTool` wrappers + zero-dep `sipi_guard.py` client
+- [OpenAI Agents SDK](integrations/openai-agents-sdk.md) — `@function_tool` guard
+- [Vercel AI SDK](integrations/vercel-ai-sdk.md) — `tool({execute})` guard + `sipiGuard.ts` client
+
+The core call is always the same: `evaluate(amount, merchant, category)` → `APPROVED` / `BLOCKED` / `FLAGGED`.
+
+## Deploy (Fly.io)
+
+```bash
+flyctl launch --no-deploy --copy-config --name sipi-bot-firewall
+flyctl volumes create sf_data --size 1 --region iad --yes
+flyctl deploy
+flyctl certs add sipi.bot
+```
+
+Stdlib-only (http.server, sqlite3). No framework, trivial deploy. `pip install mcp` only for the MCP surface.

sipi_bot-0.1.0/sipi_bot.egg-info/SOURCES.txt

@@ -0,0 +1,21 @@
+LICENSE
+README.md
+pyproject.toml
+sipi_bot.egg-info/PKG-INFO
+sipi_bot.egg-info/SOURCES.txt
+sipi_bot.egg-info/dependency_links.txt
+sipi_bot.egg-info/entry_points.txt
+sipi_bot.egg-info/requires.txt
+sipi_bot.egg-info/top_level.txt
+spendfirewall/__init__.py
+spendfirewall/api.py
+spendfirewall/billing.py
+spendfirewall/cli.py
+spendfirewall/core.py
+spendfirewall/engine.py
+spendfirewall/mcp_server.py
+spendfirewall/store.py
+spendfirewall/templates.py
+spendfirewall/eval/__init__.py
+spendfirewall/eval/eval_scenarios.py
+spendfirewall/eval/run_eval.py

sipi_bot-0.1.0/sipi_bot.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

sipi_bot-0.1.0/sipi_bot.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+sipi-bot = spendfirewall.cli:main

sipi_bot-0.1.0/sipi_bot.egg-info/requires.txt

@@ -0,0 +1,3 @@
+
+[mcp]
+mcp>=1.0.0

sipi_bot-0.1.0/sipi_bot.egg-info/top_level.txt

@@ -0,0 +1 @@
+spendfirewall

sipi_bot-0.1.0/spendfirewall/__init__.py

@@ -0,0 +1,8 @@
+"""Sipi.bot — the spend firewall for autonomous AI agents.
+
+We make sure no agent ever spends a dollar you didn't authorize.
+"""
+
+__version__ = "0.1.0"
+__product__ = "Sipi Spend Firewall"
+__domain__ = "sipi.bot"