default-watch-pinning-client 1.0.0__tar.gz

default_watch_pinning_client-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TextForAgents LLC
+
+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.

default_watch_pinning_client-1.0.0/PKG-INFO

@@ -0,0 +1,47 @@
+Metadata-Version: 2.4
+Name: default-watch-pinning-client
+Version: 1.0.0
+Summary: Session-start client for the Default-watch and pinning service (TextForAgents LLC): probe the effective default, gate the session before any billable work.
+Author: TextForAgents LLC
+License: MIT
+Keywords: agent,default-model,watch,pinning,session-start
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# default-watch-pinning-client
+
+Session-start client for the **Default-watch and pinning service**
+(TextForAgents LLC) — https://textforagents.com/products/default-watch-pinning/
+
+Your platform changed its default model overnight — did your fleet's
+price and behaviour change with it? The watch service reconciles the
+platform changelog against a session-start probe of the *effective*
+default and gates the session before any billable work. This package is
+the client half: resolve, probe, then bill.
+
+## Quickstart
+
+```python
+from default_watch_pinning_client import session_start, SessionBlocked
+
+base = "https://textforagents.com/products/default-watch-pinning"
+catalog = {"release_id": "r2", "default_model": "model-new"}
+
+try:
+    ok = session_start(base, "my-platform", MY_TOKEN, catalog)
+    model = ok["model"]          # proceed: bill against this model
+except SessionBlocked as e:
+    model = None                 # blocked BEFORE any billable work
+```
+
+Verdicts: `UNCHANGED`, `PINNED_OK` and `STAGED` proceed (STAGED proceeds
+on the probed old model); `CHANGED` proceeds only with
+`accept_changes=True`; `UNANNOUNCED` and `PIN_VIOLATED` always block.
+
+Get a token: `POST /register` then `POST /trial` (one-time free first
+month of Watch) or `POST /subscribe` (x402) on the service.
+Watch $5/mo per operator · Fleet $9/mo per operator · Delta run $0.01/run.
+
+Support: support@textforagents.com

default_watch_pinning_client-1.0.0/README.md

@@ -0,0 +1,35 @@
+# default-watch-pinning-client
+
+Session-start client for the **Default-watch and pinning service**
+(TextForAgents LLC) — https://textforagents.com/products/default-watch-pinning/
+
+Your platform changed its default model overnight — did your fleet's
+price and behaviour change with it? The watch service reconciles the
+platform changelog against a session-start probe of the *effective*
+default and gates the session before any billable work. This package is
+the client half: resolve, probe, then bill.
+
+## Quickstart
+
+```python
+from default_watch_pinning_client import session_start, SessionBlocked
+
+base = "https://textforagents.com/products/default-watch-pinning"
+catalog = {"release_id": "r2", "default_model": "model-new"}
+
+try:
+    ok = session_start(base, "my-platform", MY_TOKEN, catalog)
+    model = ok["model"]          # proceed: bill against this model
+except SessionBlocked as e:
+    model = None                 # blocked BEFORE any billable work
+```
+
+Verdicts: `UNCHANGED`, `PINNED_OK` and `STAGED` proceed (STAGED proceeds
+on the probed old model); `CHANGED` proceeds only with
+`accept_changes=True`; `UNANNOUNCED` and `PIN_VIOLATED` always block.
+
+Get a token: `POST /register` then `POST /trial` (one-time free first
+month of Watch) or `POST /subscribe` (x402) on the service.
+Watch $5/mo per operator · Fleet $9/mo per operator · Delta run $0.01/run.
+
+Support: support@textforagents.com

default_watch_pinning_client-1.0.0/default_watch_pinning_client/__init__.py

@@ -0,0 +1,5 @@
+"""Default-watch and pinning service — session-start client (P25)."""
+from .client import SessionBlocked, resolve_effective, session_start
+
+__version__ = "1.0.0"
+__all__ = ["SessionBlocked", "resolve_effective", "session_start"]

default_watch_pinning_client-1.0.0/default_watch_pinning_client/client.py

@@ -0,0 +1,51 @@
+"""Session-start client for the Default-watch and pinning service (P25).
+
+The client resolves its platform's effective default the way real
+platforms do — an operator-explicit model wins, otherwise the bundled
+catalog's default for the installed release — probes the watch service,
+and only returns a model to bill against when the verdict allows it.
+PIN_VIOLATED / UNANNOUNCED block; STAGED proceeds on the probed (old)
+model; CHANGED proceeds only under an explicit accept policy, otherwise
+blocks for the operator's pin-or-accept decision.
+
+Production shape (vs the EXP-025 lab client): the customer's identity
+is the per-customer Bearer token issued by the service's storefront
+(POST /register -> /trial or /subscribe); the gating logic is unchanged.
+"""
+import json
+import urllib.request
+
+
+def resolve_effective(catalog, operator_model=None):
+    if operator_model:
+        return operator_model
+    return catalog["default_model"]
+
+
+def _post(base, path, payload, token):
+    req = urllib.request.Request(
+        base + path, data=json.dumps(payload).encode(),
+        headers={"Content-Type": "application/json",
+                 "Authorization": "Bearer " + token})
+    with urllib.request.urlopen(req, timeout=5) as r:
+        return json.loads(r.read())
+
+
+class SessionBlocked(Exception):
+    pass
+
+
+def session_start(base, platform_id, token, catalog, operator_model=None,
+                  accept_changes=False):
+    effective = resolve_effective(catalog, operator_model)
+    res = _post(base, "/probe", {"platform_id": platform_id,
+                                 "effective_model": effective}, token)
+    verdict = res["verdict"]
+    if verdict in ("UNCHANGED", "PINNED_OK", "STAGED"):
+        return {"proceed": True, "model": effective, "verdict": verdict,
+                "attestation": res.get("attestation")}
+    if verdict == "CHANGED" and accept_changes:
+        return {"proceed": True, "model": effective, "verdict": verdict,
+                "attestation": res.get("attestation")}
+    raise SessionBlocked(
+        f"{verdict}: session blocked before any billable work (probed={effective})")

default_watch_pinning_client-1.0.0/default_watch_pinning_client.egg-info/PKG-INFO

@@ -0,0 +1,47 @@
+Metadata-Version: 2.4
+Name: default-watch-pinning-client
+Version: 1.0.0
+Summary: Session-start client for the Default-watch and pinning service (TextForAgents LLC): probe the effective default, gate the session before any billable work.
+Author: TextForAgents LLC
+License: MIT
+Keywords: agent,default-model,watch,pinning,session-start
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# default-watch-pinning-client
+
+Session-start client for the **Default-watch and pinning service**
+(TextForAgents LLC) — https://textforagents.com/products/default-watch-pinning/
+
+Your platform changed its default model overnight — did your fleet's
+price and behaviour change with it? The watch service reconciles the
+platform changelog against a session-start probe of the *effective*
+default and gates the session before any billable work. This package is
+the client half: resolve, probe, then bill.
+
+## Quickstart
+
+```python
+from default_watch_pinning_client import session_start, SessionBlocked
+
+base = "https://textforagents.com/products/default-watch-pinning"
+catalog = {"release_id": "r2", "default_model": "model-new"}
+
+try:
+    ok = session_start(base, "my-platform", MY_TOKEN, catalog)
+    model = ok["model"]          # proceed: bill against this model
+except SessionBlocked as e:
+    model = None                 # blocked BEFORE any billable work
+```
+
+Verdicts: `UNCHANGED`, `PINNED_OK` and `STAGED` proceed (STAGED proceeds
+on the probed old model); `CHANGED` proceeds only with
+`accept_changes=True`; `UNANNOUNCED` and `PIN_VIOLATED` always block.
+
+Get a token: `POST /register` then `POST /trial` (one-time free first
+month of Watch) or `POST /subscribe` (x402) on the service.
+Watch $5/mo per operator · Fleet $9/mo per operator · Delta run $0.01/run.
+
+Support: support@textforagents.com

default_watch_pinning_client-1.0.0/default_watch_pinning_client.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+default_watch_pinning_client/__init__.py
+default_watch_pinning_client/client.py
+default_watch_pinning_client.egg-info/PKG-INFO
+default_watch_pinning_client.egg-info/SOURCES.txt
+default_watch_pinning_client.egg-info/dependency_links.txt
+default_watch_pinning_client.egg-info/top_level.txt

default_watch_pinning_client-1.0.0/default_watch_pinning_client.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

default_watch_pinning_client-1.0.0/default_watch_pinning_client.egg-info/top_level.txt

@@ -0,0 +1 @@
+default_watch_pinning_client

default_watch_pinning_client-1.0.0/pyproject.toml

@@ -0,0 +1,17 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "default-watch-pinning-client"
+version = "1.0.0"
+description = "Session-start client for the Default-watch and pinning service (TextForAgents LLC): probe the effective default, gate the session before any billable work."
+readme = "README.md"
+requires-python = ">=3.9"
+license = {text = "MIT"}
+authors = [{name = "TextForAgents LLC"}]
+keywords = ["agent", "default-model", "watch", "pinning", "session-start"]
+dependencies = []
+
+[tool.setuptools]
+packages = ["default_watch_pinning_client"]

default_watch_pinning_client-1.0.0/setup.cfg

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

default_watch_pinning_client-1.0.0/setup.py

@@ -0,0 +1,2 @@
+from setuptools import setup
+setup()