talocode-loop 0.1.0__py3-none-any.whl

talocode_loop/__init__.py

@@ -0,0 +1,6 @@
+"""Talocode loop: search, verify, trace, remember."""
+
+from talocode_loop.loop import run_loop
+
+__all__ = ["run_loop"]
+__version__ = "0.1.0"

talocode_loop/cli.py

@@ -0,0 +1,20 @@
+"""Command line for the Talocode loop."""
+
+import argparse
+import json
+import sys
+
+from talocode_loop.loop import run_loop
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description="Search, verify, trace, and remember one Talocode loop.")
+    parser.add_argument("command", nargs="?", default="run", choices=["run"])
+    parser.add_argument("--query", default="Talocode official mint and credit claim")
+    parser.add_argument("--url", default="https://talocode.site/llms.txt")
+    parser.add_argument("--claim", default="6ptxwABxQz8zMhwhiPeVgRgWjGMdVcEBFBv8v8C3ory")
+    args = parser.parse_args()
+    receipt = run_loop(args.query, args.url, args.claim)
+    json.dump(receipt.to_dict(), sys.stdout, indent=2)
+    sys.stdout.write("\n")
+    raise SystemExit(0 if receipt.ok else 1)

talocode_loop/loop.py

@@ -0,0 +1,87 @@
+"""Search, verify, trace, and remember one Talocode loop."""
+
+from __future__ import annotations
+
+import json
+import uuid
+from dataclasses import asdict, dataclass
+from datetime import datetime, timezone
+from pathlib import Path
+from urllib.request import Request, urlopen
+
+STORE = Path.home() / ".talocode" / "loop-memory.json"
+
+
+@dataclass
+class Receipt:
+    ok: bool
+    product: str
+    version: str
+    query: str
+    url: str
+    trace_id: str
+    steps: list
+
+    def to_dict(self) -> dict:
+        return asdict(self)
+
+
+def search(query: str, url: str) -> dict:
+    request = Request(url, headers={"user-agent": "talocode-loop/0.1"})
+    with urlopen(request, timeout=20) as response:
+        text = response.read().decode("utf-8", "replace")
+        status = response.status
+    words = [word.lower() for word in query.split() if len(word) > 3]
+    matches = [line for line in text.splitlines() if any(word in line.lower() for word in words)]
+    return {"name": "search", "ok": status == 200, "url": url, "status": status, "matches": matches[:8], "text": text}
+
+
+def verify(text: str, claim: str) -> dict:
+    found = claim in text
+    return {
+        "name": "verify",
+        "ok": found,
+        "claim": claim,
+        "found": found,
+        "error": None if found else "claim not present in searched source",
+    }
+
+
+def remember(trace_id: str, query: str, claim: str, ok: bool) -> dict:
+    STORE.parent.mkdir(parents=True, exist_ok=True)
+    items = []
+    if STORE.exists():
+        items = json.loads(STORE.read_text())
+    memory = {
+        "id": str(uuid.uuid4()),
+        "traceId": trace_id,
+        "query": query,
+        "claim": claim,
+        "ok": ok,
+        "at": datetime.now(timezone.utc).isoformat(),
+    }
+    items.append(memory)
+    STORE.write_text(json.dumps(items[-50:], indent=2))
+    return {"name": "remember", "ok": True, "memory": memory}
+
+
+def run_loop(query: str, url: str, claim: str) -> Receipt:
+    searched = search(query, url)
+    verified = verify(searched["text"], claim)
+    trace_id = f"loop_{uuid.uuid4()}"
+    traced = {
+        "name": "trace",
+        "ok": searched["ok"] and verified["ok"],
+        "id": trace_id,
+        "spans": [{k: v for k, v in searched.items() if k != "text"}, verified],
+    }
+    remembered = remember(trace_id, query, claim, traced["ok"])
+    return Receipt(
+        ok=traced["ok"],
+        product="talocode-loop",
+        version="0.1.0",
+        query=query,
+        url=url,
+        trace_id=trace_id,
+        steps=[{k: v for k, v in searched.items() if k != "text"}, verified, traced, remembered],
+    )

talocode_loop-0.1.0.dist-info/METADATA

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: talocode-loop
+Version: 0.1.0
+Summary: The Talocode loop for agents: search a source, verify a claim against it, trace the run, and remember the receipt. CLI and SDK for the same local loop.
+Author-email: Talocode <hello@talocode.site>
+License-Expression: MIT
+Project-URL: Homepage, https://talocode.site
+Project-URL: Repository, https://github.com/talocode/loop
+Project-URL: Issues, https://github.com/talocode/loop/issues
+Keywords: talocode,agents,cli,verify,trace,search,memory
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# talocode-loop
+
+The Talocode loop is one path: search a source, verify a claim against it, trace the run, and remember the receipt.
+
+A failing verify returns the error. It does not pretend the run succeeded.
+
+## Install
+
+```bash
+pip install talocode-loop
+```
+
+## CLI
+
+```bash
+talocode-loop run \
+  --query "Talocode official mint" \
+  --url https://talocode.site/llms.txt \
+  --claim 6ptxwABxQz8zMhwhiPeVgRgWjGMdVcEBFBv8v8C3ory
+```
+
+## SDK
+
+```python
+from talocode_loop import run_loop
+
+receipt = run_loop(
+    "Talocode official mint",
+    "https://talocode.site/llms.txt",
+    "6ptxwABxQz8zMhwhiPeVgRgWjGMdVcEBFBv8v8C3ory",
+)
+```
+
+The Node package is `@talocode/loop`. The repository is https://github.com/talocode/loop.

talocode_loop-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+talocode_loop/__init__.py,sha256=gru9zJUXtGQodtMqSwjyi0aqrS_cXO07e-98HtPUbVA,141
+talocode_loop/cli.py,sha256=Y_16E6Kf6ldwLkiKBZlPbMYuXwxOd1yptN5EizZoE1w,796
+talocode_loop/loop.py,sha256=5YdUFX3uo90s7_NLU0IMKYztuSMX5S8Mymi7-3glprs,2603
+talocode_loop-0.1.0.dist-info/licenses/LICENSE,sha256=zk3xDU_kSwGYShYRgHiKyIqpG4TqQXkV2P31R-6U3-Q,1065
+talocode_loop-0.1.0.dist-info/METADATA,sha256=rziruydKGAi6n8JvRi5wpm0WQRTrzEHj-70dXjAwVAQ,1430
+talocode_loop-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+talocode_loop-0.1.0.dist-info/entry_points.txt,sha256=SodSfacWXES2riEda8qNYpIt3VOl6Wrvq_czetawaIM,57
+talocode_loop-0.1.0.dist-info/top_level.txt,sha256=0exE1VrpCk5U3gwis14LkoUWbItxAdrf6TxwjTPYdWs,14
+talocode_loop-0.1.0.dist-info/RECORD,,

talocode_loop-0.1.0.dist-info/WHEEL

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

talocode_loop-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+talocode-loop = talocode_loop.cli:main

talocode_loop-0.1.0.dist-info/licenses/LICENSE

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

talocode_loop-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+talocode_loop