scarwise 0.1.0__tar.gz

scarwise-0.1.0/PKG-INFO

@@ -0,0 +1,6 @@
+Metadata-Version: 2.4
+Name: scarwise
+Version: 0.1.0
+Summary: Your AI agents stop repeating the same tool mistakes – Python SDK (needs the scarwise CLI: npm install -g scarwise).
+License: Proprietary – see LICENSE
+Requires-Python: >=3.9

scarwise-0.1.0/pyproject.toml

@@ -0,0 +1,13 @@
+[project]
+name = "scarwise"
+version = "0.1.0"
+description = "Your AI agents stop repeating the same tool mistakes – Python SDK (needs the scarwise CLI: npm install -g scarwise)."
+requires-python = ">=3.9"
+license = { text = "Proprietary – see LICENSE" }
+
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+packages = ["scarwise"]

scarwise-0.1.0/scarwise/__init__.py

@@ -0,0 +1,117 @@
+"""Scarwise for Python applications that call tools themselves (socket C).
+
+    from scarwise import guard, ScarwiseStop
+
+    @guard("run_command")
+    def run_command(command: str): ...
+
+Before each call: a known mistake raises ScarwiseStop (the tool does not run); a verified
+correction changes the input. After: a known error gets the fix appended to its message.
+Any problem inside Scarwise lets the tool run normally. The decisions come from the same
+engine as every other agent (`scarwise decide`), so lessons are shared.
+"""
+from __future__ import annotations
+
+import functools
+import inspect
+import json
+import os
+import shutil
+import subprocess
+import uuid
+
+__all__ = ["guard", "ScarwiseStop"]
+__version__ = "0.1.0"
+
+_SESSION = "sdk-python:" + uuid.uuid4().hex
+
+
+class ScarwiseStop(Exception):
+    """A known mistake was stopped before the tool ran; the message says what worked here."""
+
+    def __init__(self, reason: str, lesson_id: int | None = None):
+        super().__init__(reason)
+        self.lesson_id = lesson_id
+
+
+def _command() -> list[str] | None:
+    cli = os.environ.get("SCARWISE_CLI")
+    if cli:
+        return ["node", cli] if cli.endswith((".mjs", ".js", ".ts")) else [cli]
+    found = shutil.which("scarwise")
+    return [found] if found else None
+
+
+def _decide(event: dict) -> dict:
+    cmd = _command()
+    if not cmd:
+        return {"kind": "none"}
+    try:
+        r = subprocess.run(cmd + ["decide"], input=json.dumps(event), capture_output=True, text=True, timeout=10)
+        return json.loads(r.stdout or '{"kind":"none"}')
+    except Exception:  # fail-open: Scarwise never blocks a tool by accident
+        return {"kind": "none"}
+
+
+def _bind(fn, args, kwargs) -> dict:
+    try:
+        bound = inspect.signature(fn).bind(*args, **kwargs)
+        bound.apply_defaults()
+        return {k: v for k, v in bound.arguments.items() if isinstance(v, (str, int, float, bool, list, dict, type(None)))}
+    except TypeError:
+        return {"args": [a for a in args if isinstance(a, (str, int, float, bool))]}
+
+
+def guard(name: str, agent: str = "sdk-python", session: str | None = None):
+    """Decorator: guards a tool function (sync or async) with Scarwise lessons."""
+
+    def deco(fn):
+        sess = session or _SESSION
+
+        def before(args, kwargs):
+            data = _bind(fn, args, kwargs)
+            d = _decide({"agent": agent, "phase": "pre", "session": sess, "tool": name, "input": data})
+            if d.get("kind") == "deny":
+                raise ScarwiseStop(d.get("reason", "Scarwise: known mistake"), d.get("lessonId"))
+            if d.get("kind") == "rewrite" and isinstance(d.get("updatedInput"), dict):
+                params = inspect.signature(fn).parameters
+                new = {k: v for k, v in d["updatedInput"].items() if k in params}
+                if new:
+                    data = {**data, **new}
+                    return (), data, data
+            return args, kwargs, data
+
+        def after_error(e, data):
+            d = _decide({"agent": agent, "phase": "failure", "session": sess, "tool": name, "input": data, "error": str(e)})
+            if d.get("kind") == "context" and e.args:
+                e.args = (f"{e.args[0]}\n{d.get('reason', '')}",) + tuple(e.args[1:])
+
+        def after_ok(result, data):
+            _decide({"agent": agent, "phase": "post", "session": sess, "tool": name, "input": data, "output": str(result)[:4000]})
+
+        if inspect.iscoroutinefunction(fn):
+            @functools.wraps(fn)
+            async def awrapper(*args, **kwargs):
+                args, kwargs, data = before(args, kwargs)
+                try:
+                    result = await fn(*args, **kwargs)
+                except Exception as e:
+                    after_error(e, data)
+                    raise
+                after_ok(result, data)
+                return result
+            return awrapper
+
+        @functools.wraps(fn)
+        def wrapper(*args, **kwargs):
+            args, kwargs, data = before(args, kwargs)
+            try:
+                result = fn(*args, **kwargs)
+            except Exception as e:
+                after_error(e, data)
+                raise
+            after_ok(result, data)
+            return result
+        return wrapper
+
+    return deco

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

@@ -0,0 +1,6 @@
+Metadata-Version: 2.4
+Name: scarwise
+Version: 0.1.0
+Summary: Your AI agents stop repeating the same tool mistakes – Python SDK (needs the scarwise CLI: npm install -g scarwise).
+License: Proprietary – see LICENSE
+Requires-Python: >=3.9

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

@@ -0,0 +1,6 @@
+pyproject.toml
+scarwise/__init__.py
+scarwise.egg-info/PKG-INFO
+scarwise.egg-info/SOURCES.txt
+scarwise.egg-info/dependency_links.txt
+scarwise.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1 @@
+scarwise

scarwise-0.1.0/setup.cfg

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