trooth 0.2.0__tar.gz → 0.3.0__tar.gz

{trooth-0.2.0 → trooth-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trooth
-Version: 0.2.0
+Version: 0.3.0
 Summary: Read a company's Semanto signed copy and check it: signatures, keys, DNS binding, page proofs and the public log.
 Author: Trooth, LLC
 License-Expression: Apache-2.0
@@ -94,6 +94,9 @@ from trooth import SemantoSource
 acme = SemantoSource("acme.com", on_event=lambda e: print(e["event"], e["detail"]))
 a = acme.answer(question="How much is the Starter plan?")
 print(a["status"], a["text"])
+
+r = acme.reply(question=user_question, draft=model_text)  # built by code; the draft is discarded
+show(r["text"])
 ```
 
 It loads `/.well-known/trooth.semanto` and the company's keys from the company's site, checks the file once for each new body, reads the site again at most every 15 minutes, and answers fact IDs and plain questions in process with the same matcher as Trooth's service (`trooth_semanto_verify.answer`, compared case by case with `verifier/test-vectors/answer-v1`). When Trooth's API cannot be reached it keeps answering from the last version that checked out and logs `trooth_api_unreachable`; a new version that does not check out is refused and the last good one stays in use. A fact marked changed since signing or expired returns its mark and no value.

{trooth-0.2.0 → trooth-0.3.0}/README.md

@@ -64,6 +64,9 @@ from trooth import SemantoSource
 acme = SemantoSource("acme.com", on_event=lambda e: print(e["event"], e["detail"]))
 a = acme.answer(question="How much is the Starter plan?")
 print(a["status"], a["text"])
+
+r = acme.reply(question=user_question, draft=model_text)  # built by code; the draft is discarded
+show(r["text"])
 ```
 
 It loads `/.well-known/trooth.semanto` and the company's keys from the company's site, checks the file once for each new body, reads the site again at most every 15 minutes, and answers fact IDs and plain questions in process with the same matcher as Trooth's service (`trooth_semanto_verify.answer`, compared case by case with `verifier/test-vectors/answer-v1`). When Trooth's API cannot be reached it keeps answering from the last version that checked out and logs `trooth_api_unreachable`; a new version that does not check out is refused and the last good one stays in use. A fact marked changed since signing or expired returns its mark and no value.

{trooth-0.2.0 → trooth-0.3.0}/pyproject.toml

@@ -12,7 +12,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "trooth"
-version = "0.2.0"
+version = "0.3.0"
 description = "Read a company's Semanto signed copy and check it: signatures, keys, DNS binding, page proofs and the public log."
 readme = "README.md"
 requires-python = ">=3.11"

{trooth-0.2.0 → trooth-0.3.0}/trooth/__init__.py

@@ -14,5 +14,5 @@ kits). Framework integrations are optional extras: trooth[langchain], trooth[lla
 from trooth_semanto_verify.client import SemantoClient
 from trooth_semanto_verify.source import SemantoSource
 
-__version__ = "0.2.0"
+__version__ = "0.3.0"
 __all__ = ["SemantoClient", "SemantoSource", "__version__"]

{trooth-0.2.0 → trooth-0.3.0}/trooth.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trooth
-Version: 0.2.0
+Version: 0.3.0
 Summary: Read a company's Semanto signed copy and check it: signatures, keys, DNS binding, page proofs and the public log.
 Author: Trooth, LLC
 License-Expression: Apache-2.0
@@ -94,6 +94,9 @@ from trooth import SemantoSource
 acme = SemantoSource("acme.com", on_event=lambda e: print(e["event"], e["detail"]))
 a = acme.answer(question="How much is the Starter plan?")
 print(a["status"], a["text"])
+
+r = acme.reply(question=user_question, draft=model_text)  # built by code; the draft is discarded
+show(r["text"])
 ```
 
 It loads `/.well-known/trooth.semanto` and the company's keys from the company's site, checks the file once for each new body, reads the site again at most every 15 minutes, and answers fact IDs and plain questions in process with the same matcher as Trooth's service (`trooth_semanto_verify.answer`, compared case by case with `verifier/test-vectors/answer-v1`). When Trooth's API cannot be reached it keeps answering from the last version that checked out and logs `trooth_api_unreachable`; a new version that does not check out is refused and the last good one stays in use. A fact marked changed since signing or expired returns its mark and no value.

{trooth-0.2.0 → trooth-0.3.0}/trooth_semanto_verify/__init__.py

@@ -91,4 +91,4 @@ __all__ = [
     "version_id",
 ]
 
-__version__ = "0.2.0"
+__version__ = "0.3.0"

{trooth-0.2.0 → trooth-0.3.0}/trooth_semanto_verify/answer.py

@@ -170,3 +170,20 @@ def answer(file: dict, company: dict, fact_id: Optional[str] = None, question: O
     lines = [MARK_WORDS[mark]] if mark else [f["statement"], *([f"Conditions: {'; '.join(f['conditions'])}."] if f.get("conditions") else [])]
     lines.append(f"Check: {check}")
     return {**base, "status": "answer", "matched_by": by, "facts": [_as_answered(f, mark)], "text": "\n".join(lines[:3])}
+
+
+def assemble_reply(a: dict, draft: Optional[str] = None) -> dict:
+    """What the customer is shown, built by code from an answer; a model's own wording is never part of it.
+
+    For a value answer the first line is the signed sentence exactly as signed, then its conditions if any, then the day
+    it was signed and the check link. A marked fact shows its mark instead of a value. Candidates, the not-published
+    reply and not_read show the answer's own fixed line. `draft` (what a model wrote) is accepted and discarded:
+    `discarded` says whether one was given."""
+    discarded = isinstance(draft, str) and len(draft) > 0
+    signed_on = str(a["signed_at"])[:10] if a.get("signed_at") else None
+    f = a["facts"][0] if a["status"] == "answer" else None
+    if not f:
+        return {"status": a["status"], "fact_id": None, "statement": None, "signed_on": signed_on, "check": a.get("check"), "text": a["text"], "discarded": discarded}
+    tail = f"{f'Signed on {signed_on}. ' if signed_on else ''}Check: {a['check']}"
+    lines = [MARK_WORDS[f["mark"]], tail] if f["mark"] else [f["statement"], *([f"Conditions: {'; '.join(f['conditions'])}."] if f["conditions"] else []), tail]
+    return {"status": a["status"], "fact_id": f["fact_id"], "statement": f["statement"], "signed_on": signed_on, "check": a["check"], "text": "\n".join(lines), "discarded": discarded}

{trooth-0.2.0 → trooth-0.3.0}/trooth_semanto_verify/source.py

@@ -28,7 +28,7 @@ from datetime import datetime, timezone
 from typing import Any, Callable, Dict, List, Optional
 
 from .answer import answer as _answer
-from .answer import fact_marks
+from .answer import assemble_reply, fact_marks
 from .client import Fetch, urllib_fetch
 from .verify import verify_semanto
 
@@ -152,3 +152,7 @@ class SemantoSource:
             return {"object": "semanto.answer", "status": "not_read", "matched_by": None, "company": {"trooth_id": None, "name": None, "domain": self.domain},
                     "version": None, "facts": [], "text": f"No signed record of {self.domain} could be read and checked yet."}
         return _answer(self.file, self.company, fact_id=fact_id, question=question, marks=self.marks(), check_base=f"{self.api_base}/public/semanto")
+
+    def reply(self, fact_id: Optional[str] = None, question: Optional[str] = None, draft: Optional[str] = None) -> dict:
+        """The reply a chatbot shows for a question: built by code from the signed record, with the model's draft discarded."""
+        return assemble_reply(self.answer(fact_id=fact_id, question=question), draft)