prism-tool 0.1.0__py3-none-any.whl

prism/cli.py

@@ -0,0 +1,62 @@
+import typer
+from rich.console import Console
+from rich.table import Table
+
+app = typer.Typer()
+console = Console()
+
+@app.command()
+def lint(provider: str = "openai-strict"):
+    """Lint a tool function for provider compatibility."""
+    from prism.linter import lint_tool
+    
+    console.print("\n[bold cyan]Paste your function. Press Enter twice when done.[/bold cyan]\n")
+    
+    lines = []
+    while True:
+        line = input()
+        if line == "" and lines and lines[-1] == "":
+            break
+        lines.append(line)
+    
+    code = "\n".join(lines)
+    namespace = {}
+    
+    try:
+        exec(code, namespace)
+    except Exception as e:
+        console.print(f"[red]Error: {e}[/red]")
+        raise typer.Exit()
+
+    func = None
+    for name, obj in namespace.items():
+        if callable(obj) and not name.startswith("_"):
+            func = obj
+            break
+
+    if not func:
+        console.print("[red]No function found.[/red]")
+        raise typer.Exit()
+
+    warnings = lint_tool(func, providers=[provider])
+
+    if not warnings:
+        console.print(f"\n[green]✅ No issues found.[/green]\n")
+        return
+
+    table = Table(title=f"Prism — {provider}", show_lines=True)
+    table.add_column("Level", style="red", width=8)
+    table.add_column("Param", style="yellow", width=15)
+    table.add_column("Issue", width=40)
+    table.add_column("Fix", style="green", width=30)
+
+    for w in warnings:
+        table.add_row(w["level"], w["param"], w["issue"], w["fix"])
+
+    console.print(table)
+
+def main():
+    app()
+
+if __name__ == "__main__":
+    main()  

prism/linter.py

@@ -0,0 +1,66 @@
+import inspect
+from typing import get_type_hints, Union, Any
+
+def lint_tool(func, providers=["openai-strict"]):
+    warnings = []
+    sig = inspect.signature(func)
+    
+    try:
+        hints = get_type_hints(func)
+    except Exception:
+        hints = {}
+
+    for param_name, param in sig.parameters.items():
+        if param_name in ("return", "self", "cls"):
+            continue
+
+        has_default = param.default != inspect.Parameter.empty
+        annotation = hints.get(param_name)
+
+        if "openai-strict" in providers and has_default and param.default is not None:
+            warnings.append({
+                "provider": "openai-strict",
+                "level": "ERROR",
+                "param": param_name,
+                "issue": f"Has default '{param.default}' — OpenAI strict will reject this.",
+                "fix": "Remove the default value."
+            })
+
+        if param_name not in hints:
+            warnings.append({
+                "provider": "all",
+                "level": "WARNING",
+                "param": param_name,
+                "issue": "No type annotation. Providers will reject this.",
+                "fix": f"Add a type like: {param_name}: str"
+            })
+
+        if annotation is Any:
+            warnings.append({
+                "provider": "openai-strict",
+                "level": "ERROR",
+                "param": param_name,
+                "issue": "'Any' type is rejected by OpenAI strict mode.",
+                "fix": "Replace with a concrete type like str or dict."
+            })
+
+        if annotation and hasattr(annotation, "__origin__"):
+            if annotation.__origin__ is Union:
+                warnings.append({
+                    "provider": "openai-strict",
+                    "level": "ERROR",
+                    "param": param_name,
+                    "issue": "Union types fail in OpenAI strict mode.",
+                    "fix": "Use a single concrete type."
+                })
+
+    if not func.__doc__:
+        warnings.append({
+            "provider": "all",
+            "level": "WARNING",
+            "param": "function",
+            "issue": "No docstring. AI uses this as the tool description.",
+            "fix": 'Add a docstring: """What this tool does."""'
+        })
+
+    return warnings 

prism_tool-0.1.0.dist-info/METADATA

@@ -0,0 +1,67 @@
+Metadata-Version: 2.4
+Name: prism-tool
+Version: 0.1.0
+Summary: Catch AI agent tool schema failures before they reach the provider
+Home-page: https://github.com/sanim-science/prism-sdk
+Author: Sanim
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: typer
+Requires-Dist: rich
+Requires-Dist: pydantic
+Requires-Dist: jsonschema
+Dynamic: author
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Prism
+
+Catch AI agent tool schema failures before they reach the provider.
+
+## The Problem
+
+You write a tool for your AI agent. It works locally.
+Then it fails with a cryptic 400 error in production.
+No explanation. No hint. Just failure.
+
+Prism catches these before they ever reach OpenAI or Anthropic.
+
+## Install
+
+pip install prism-sdk
+
+## Quick Start
+
+from prism.linter import lint_tool
+
+def search_products(query: str, limit: int = 10, category=None):
+    pass
+
+issues = lint_tool(search_products)
+for issue in issues:
+    print(f"[{issue['level']}] {issue['param']}: {issue['issue']}")
+
+## Output
+
+[ERROR] limit: Has default '10' — OpenAI strict will reject this.
+[WARNING] category: No type annotation. Providers will reject this.
+[WARNING] function: No docstring. AI uses this as the tool description.
+
+## What It Catches
+
+| Issue | Providers Affected |
+|-------|--------------------|
+| Default values not in required[] | OpenAI strict |
+| Union types | OpenAI strict |
+| Missing type annotations | All |
+| Any type | OpenAI strict |
+| Missing docstring | All |
+
+## Status
+
+Early development. Built to solve a real problem.
+Issues and feedback welcome. 

prism_tool-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+prism/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+prism/cli.py,sha256=asMbFWYbM0X7bY0XbtYh7mwEHxaJQV5y8LUj5gw2OVg,1651
+prism/linter.py,sha256=kg0HdujyVPJjeTnlQ5XCg08LNGJyXVbl1reBeNbzrV0,2355
+prism_tool-0.1.0.dist-info/METADATA,sha256=U13xs0sGf-JO9H2Byp2qaKsqNAyFbGZuetvU0tyYCK4,1745
+prism_tool-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+prism_tool-0.1.0.dist-info/entry_points.txt,sha256=Kn-Imyf8zRkFPeWfcmS5w1SaQPSzv-hmDi1bBJpXgDY,41
+prism_tool-0.1.0.dist-info/top_level.txt,sha256=ptR0npZTwkVELlV5R3NcfhrvslYW8AvRiFoKmX7tZp4,6
+prism_tool-0.1.0.dist-info/RECORD,,

prism_tool-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

prism_tool-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+prism = prism.cli:main

prism_tool-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+prism