programasweights 0.1.0.dev7__py3-none-any.whl → 0.1.0.dev9__py3-none-any.whl

programasweights/__init__.py

@@ -22,7 +22,7 @@ API reference:
     paw.api_key                API key (set via login() or PAW_API_KEY env var)
 """
 
-__version__ = "0.1.0.dev7"
+__version__ = "0.1.0.dev9"
 
 from .config import get_api_url, get_api_key, set_api_key
 
@@ -37,33 +37,38 @@ def compile(
     name: str | None = None,
     tags: list[str] | None = None,
     public: bool = True,
+    slug: str | None = None,
 ):
     """Compile a natural language specification into a neural program.
 
     The compilation runs on the PAW server. The resulting program can be
-    downloaded and run locally via ``paw.function(program.id)``.
+    downloaded and run locally via ``paw.function(program.id)`` or
+    ``paw.function(program.slug)`` if a slug was provided.
 
     Args:
         spec: Full specification text. Include examples in the text if desired.
         compiler: Compiler model (alias or snapshot name).
-        name: Human-readable program name for the hub.
+        name: Human-readable program name (display title for the hub).
         tags: Tags for hub discovery.
         public: Whether to list on the public hub.
+        slug: URL-safe handle (e.g. 'message-classifier'). Creates a
+            ``username/slug`` alias. Requires authentication.
 
     Returns:
-        A ``Program`` object with ``id``, ``status``, and ``timings``.
+        A ``Program`` object with ``id``, ``slug``, ``status``, and ``timings``.
 
     Example:
         >>> program = paw.compile(
-        ...     "Fix malformed JSON: repair missing quotes and trailing commas"
+        ...     "Fix malformed JSON: repair missing quotes and trailing commas",
+        ...     slug="json-fixer"
         ... )
-        >>> fn = paw.function(program.id)
+        >>> fn = paw.function(program.slug)  # or paw.function(program.id)
         >>> fn("{name: 'Alice',}")
         '{"name": "Alice"}'
     """
     from .client import PAWClient
     client = PAWClient(api_url=api_url, api_key=api_key)
-    return client.compile(spec, compiler=compiler, name=name, tags=tags, public=public)
+    return client.compile(spec, compiler=compiler, name=name, tags=tags, public=public, slug=slug)
 
 
 def function(
@@ -94,7 +99,7 @@ def function(
     """
     import os
     import re
-    from .cache import is_program_cached, get_program_dir
+    from .cache import is_program_cached, get_program_dir, get_cached_slug, save_slug_mapping
     from .runtime_llamacpp import PawFunction
 
     if n_gpu_layers is None:
@@ -102,9 +107,14 @@ def function(
 
     resolved_id = program_id
     if not re.fullmatch(r"[a-f0-9]{16,64}", program_id):
-        from .client import PAWClient
-        client = PAWClient(api_url=api_url, api_key=api_key)
-        resolved_id = client.resolve_slug(program_id)
+        cached = get_cached_slug(program_id)
+        if cached:
+            resolved_id = cached
+        else:
+            from .client import PAWClient
+            client = PAWClient(api_url=api_url, api_key=api_key)
+            resolved_id = client.resolve_slug(program_id)
+            save_slug_mapping(program_id, resolved_id)
 
     if not is_program_cached(resolved_id):
         from .client import PAWClient

programasweights/cache.py

@@ -10,10 +10,12 @@ Cache structure:
                 adapter.gguf            # ~23 MB, Q4_0 LoRA
                 prompt_template.txt
                 meta.json
+        slug_cache.json                 # slug -> program_id mapping
 """
 
 from __future__ import annotations
 
+import json
 import os
 from pathlib import Path
 
@@ -80,3 +82,36 @@ def _download_file(url: str, dest: Path):
                     mb = downloaded / 1024 / 1024
                     print(f"\r  {mb:.1f} MB ({pct:.0f}%)", end="", flush=True)
         print()
+
+
+def _slug_cache_path() -> Path:
+    return config.get_cache_dir() / "slug_cache.json"
+
+
+def get_cached_slug(slug: str) -> str | None:
+    """Look up a slug in the local cache. Returns program_id or None."""
+    path = _slug_cache_path()
+    if not path.exists():
+        return None
+    try:
+        data = json.loads(path.read_text())
+        program_id = data.get(slug)
+        if program_id and is_program_cached(program_id):
+            return program_id
+    except (json.JSONDecodeError, OSError):
+        pass
+    return None
+
+
+def save_slug_mapping(slug: str, program_id: str) -> None:
+    """Save a slug -> program_id mapping to the local cache."""
+    path = _slug_cache_path()
+    data: dict = {}
+    if path.exists():
+        try:
+            data = json.loads(path.read_text())
+        except (json.JSONDecodeError, OSError):
+            pass
+    data[slug] = program_id
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(json.dumps(data))

programasweights/cli.py

@@ -26,11 +26,12 @@ def cmd_compile(args):
     if not args.json:
         print(f"Compiling: {args.spec[:80]}...")
 
-    program = paw.compile(args.spec, compiler=args.compiler)
+    program = paw.compile(args.spec, compiler=args.compiler, slug=getattr(args, 'slug', None))
 
     if args.json:
         print(json.dumps({
             "program_id": program.id,
+            "slug": program.slug,
             "status": program.status,
             "error": program.error,
             "timings": program.timings,
@@ -42,15 +43,18 @@ def cmd_compile(args):
         return 1
 
     print(f"Program ID: {program.id}")
+    if program.slug:
+        print(f"Slug: {program.slug}")
     print(f"Status: {program.status}")
     if program.timings:
         total = program.timings.get("total_ms", 0)
         print(f"Total time: {total:.0f}ms")
+    ref = program.slug or program.id
     print(f"\nTo run locally:")
-    print(f"  paw run {program.id} \"your input here\"")
+    print(f"  paw run --program \"{ref}\" --input \"your input here\"")
     print(f"\nOr in Python:")
     print(f"  import programasweights as paw")
-    print(f"  fn = paw.function(\"{program.id}\")")
+    print(f"  fn = paw.function(\"{ref}\")")
     print(f"  fn(\"your input here\")")
     return 0
 
@@ -80,6 +84,37 @@ def cmd_login(args):
     return 0
 
 
+def cmd_rename(args):
+    import programasweights as paw
+    if args.api_url:
+        paw.api_url = args.api_url
+    if args.api_key:
+        paw.api_key = args.api_key
+
+    import httpx
+    from programasweights.client import PAWClient
+    client = PAWClient(api_url=paw.api_url, api_key=paw.api_key)
+
+    resp = httpx.patch(
+        f"{client._api_url}/api/v1/programs/{args.program}",
+        json={"slug": args.new_slug},
+        headers=client._headers(),
+        timeout=10.0,
+    )
+    resp.raise_for_status()
+    data = resp.json()
+
+    if args.json:
+        print(json.dumps(data))
+    else:
+        slug = data.get("slug")
+        if slug:
+            print(f"Renamed to: {slug}")
+        else:
+            print("Slug removed.")
+    return 0
+
+
 def cmd_info(args):
     import programasweights as paw
     if args.api_url:
@@ -129,6 +164,7 @@ def main():
     p = sub.add_parser("compile", help="Compile a spec on the server")
     p.add_argument("--spec", required=True, help="Natural language specification")
     p.add_argument("--compiler", default="paw-4b-qwen3-0.6b", help="Compiler model")
+    p.add_argument("--slug", default=None, help="URL-safe handle (e.g. 'message-classifier')")
     p.add_argument("--json", action="store_true", help="JSON output")
 
     p = sub.add_parser("run", help="Run a program locally via llama.cpp")
@@ -142,6 +178,11 @@ def main():
     p = sub.add_parser("login", help="Save API key for authentication")
     p.add_argument("key", nargs="?", default=None, help="API key (paw_sk_...). Omit to open browser.")
 
+    p = sub.add_parser("rename", help="Set or change a program's slug")
+    p.add_argument("program", help="Program ID or current slug")
+    p.add_argument("new_slug", help="New slug (e.g. 'message-classifier') or empty string to remove")
+    p.add_argument("--json", action="store_true", help="JSON output")
+
     p = sub.add_parser("info", help="Show program info")
     p.add_argument("program", help="Program name or ID")
     p.add_argument("--json", action="store_true", help="JSON output")
@@ -156,6 +197,7 @@ def main():
         "compile": cmd_compile,
         "run": cmd_run,
         "login": cmd_login,
+        "rename": cmd_rename,
         "info": cmd_info,
     }
 

programasweights/client.py

@@ -23,6 +23,7 @@ class Program:
     """Result of a compilation."""
     id: str
     status: str
+    slug: Optional[str] = None
     compiler_snapshot: Optional[str] = None
     timings: Optional[dict] = None
     error: Optional[str] = None
@@ -48,27 +49,32 @@ class PAWClient:
         name: str | None = None,
         tags: list[str] | None = None,
         public: bool = True,
+        slug: str | None = None,
     ) -> Program:
         """Compile a spec into a neural program on the server.
 
         Args:
             spec: Natural language specification. Include examples in the text.
             compiler: Compiler name (alias or snapshot).
-            name: Human-readable program name.
+            name: Human-readable program name (display title).
             tags: Tags for hub discovery.
             public: Whether to list on the public hub.
+            slug: URL-safe handle (e.g. 'message-classifier'). Creates a
+                ``username/slug`` alias for easy reference. Requires auth.
 
         Returns:
-            Program with id, status, and timings.
+            Program with id, slug, status, and timings.
 
         Raises:
             httpx.HTTPStatusError: On API errors (422 for validation, 429 for rate limit).
         """
-        body = {"spec": spec, "compiler": compiler, "public": public}
+        body: dict = {"spec": spec, "compiler": compiler, "public": public}
         if name:
             body["name"] = name
         if tags:
             body["tags"] = tags
+        if slug:
+            body["slug"] = slug
 
         resp = httpx.post(
             f"{self._api_url}/api/v1/compile",
@@ -82,6 +88,7 @@ class PAWClient:
         return Program(
             id=data.get("program_id", ""),
             status=data.get("status", "unknown"),
+            slug=data.get("slug"),
             compiler_snapshot=data.get("compiler_snapshot"),
             timings=data.get("timings"),
             error=data.get("error"),

{programasweights-0.1.0.dev7.dist-info → programasweights-0.1.0.dev9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: programasweights
-Version: 0.1.0.dev7
+Version: 0.1.0.dev9
 Summary: Compile natural language specifications into neural programs that run locally via llama.cpp.
 Project-URL: Homepage, https://programasweights.com
 Project-URL: Repository, https://github.com/programasweights/programasweights-python
@@ -22,7 +22,7 @@ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.9
 Requires-Dist: httpx<1.0,>=0.27.0
-Requires-Dist: llama-cpp-python<1.0,>=0.3.0
+Requires-Dist: llama-cpp-python<=0.3.18,>=0.3.0
 Provides-Extra: test
 Requires-Dist: pytest; extra == 'test'
 Description-Content-Type: text/markdown
@@ -60,7 +60,7 @@ fn("{name: 'Alice',}")  # '{"name": "Alice"}'
 
 ## Two Compilers
 
-|                    | Qwen3 0.6B              | GPT-2 124M             |
+|                    | Standard (Qwen3 0.6B)   | Compact (GPT-2 124M)   |
 |--------------------|-------------------------|------------------------|
 | Compiler name      | `paw-4b-qwen3-0.6b`    | `paw-4b-gpt2`          |
 | Accuracy           | Higher                  | Lower                  |
@@ -69,7 +69,7 @@ fn("{name: 'Alice',}")  # '{"name": "Alice"}'
 | Inference speed    | ~90ms (server)          | ~50ms (server)         |
 | Runs in browser    | No                      | Yes                    |
 
-Default is Qwen3 0.6B. Use GPT-2 when you need smaller files or browser deployment.
+Default is Standard (Qwen3 0.6B). Use Compact (GPT-2) when you need smaller files or browser deployment.
 
 ## Browser SDK
 
@@ -104,6 +104,7 @@ Or save [`AGENTS.md`](https://programasweights.com/agents) to your project root
 - **Classification** — sentiment, urgency, categories defined in your own words
 - **Extraction** — emails, names, dates from messy unstructured text
 - **Log triage** — extract errors from verbose output, filter noise
+- **Intent routing** — map user descriptions to the closest URL, menu item, or setting
 - **Agent preprocessing** — parse tool calls, validate outputs, route tasks
 
 ## Authentication

{programasweights-0.1.0.dev7.dist-info → programasweights-0.1.0.dev9.dist-info}/RECORD

@@ -1,8 +1,8 @@
-programasweights/__init__.py,sha256=e_IusOtFtLEunVj5N3Go3cpwQpVD0lS48v9i0cufiQk,5412
+programasweights/__init__.py,sha256=b1St5bbuKs0dXCYGiMEsqUrs2zbNyGoqvmgN11qkOvg,5952
 programasweights/artifacts.py,sha256=bSRZgYadAYyuH9aIW6P3VocExfGDGAHeDuj8vod5-Bo,1968
-programasweights/cache.py,sha256=UXGG9ihckmUKo43ECI9w8GYx9nl4moHCq4NAcSmsYi8,2656
-programasweights/cli.py,sha256=n40CQH9SbovYnHQl4k3CY1TqOzMlRqBFksgBsEiEr5Q,5117
-programasweights/client.py,sha256=1IAl1YL4P2wNbcVpy2cDqL4WjCL3Z2T1orNIXDtcrrw,4067
+programasweights/cache.py,sha256=69mOsx2Aqi3sQjFXjeBvhKySXDKdvKSINis2FprVDw4,3711
+programasweights/cli.py,sha256=_HCBRXfn9at7a4oTvVOAi2lPMMKaDxleLngdc6WKi2c,6480
+programasweights/client.py,sha256=Qk0ubKW54robuVnvEf0AyED5zX2Rw-W4HefBg_GQp8s,4391
 programasweights/config.py,sha256=zQFnVNfYR4bFx2DsZheMnPy2yd9T4-fe0u2sG1GluE8,1553
 programasweights/convert_peft_to_paw.py,sha256=yvavaAzLUqc-lFHEC_9AOhsuI-fCobu6k-GDMVQdOHk,6521
 programasweights/paw_format.py,sha256=wRXolwtnPgKoopiJC8-yMVZZtiwB-PoAqaWpDFKMoj8,10679
@@ -12,7 +12,7 @@ programasweights/compiler/dummy.py,sha256=PcLwijRNM4q2E9PNUcfCPf_y08QjsteVENR0TV
 programasweights/runtime/__init__.py,sha256=S4jp7-eWAcMa0X417U7P6HkTL1j3v8ffQA-nneh9wY0,549
 programasweights/runtime/interpreter.py,sha256=brYCtatSsu23lq87cuki4MViqZX6U32LBw7Z3USbQmA,19632
 programasweights/runtime/interpreter_onnx.py,sha256=kzYKmwg_h0tVhoQlixJGKoHPVhcCK22AcHG59oeYX2Q,21559
-programasweights-0.1.0.dev7.dist-info/METADATA,sha256=PdAZEpqWs9cGdy2gaFLiNo3jaDyp9ZtVSvkGVHJStNw,5464
-programasweights-0.1.0.dev7.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-programasweights-0.1.0.dev7.dist-info/entry_points.txt,sha256=l4ZnfCPU0oMzhGB9T2Fv9AnDbSCMM70KUUJVtSvMJBc,50
-programasweights-0.1.0.dev7.dist-info/RECORD,,
+programasweights-0.1.0.dev9.dist-info/METADATA,sha256=1WwaxDSpm7CGFxuzkCQcxlntjEnFrfmNBaN9p9oFHO8,5578
+programasweights-0.1.0.dev9.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+programasweights-0.1.0.dev9.dist-info/entry_points.txt,sha256=l4ZnfCPU0oMzhGB9T2Fv9AnDbSCMM70KUUJVtSvMJBc,50
+programasweights-0.1.0.dev9.dist-info/RECORD,,