@borgee/agents-host 0.2.101 → 0.2.110

package/skills/borgee-agent/scripts/borgee-agent.py

@@ -28,7 +28,7 @@ Commands:
   files
       Files visible in this channel.
   files cat <channel-path>
-      Print one UTF-8 text file up to 64 KiB.
+      Print normalized UTF-8 text, or report extraction status and warnings.
   files download <channel-path> [--overwrite]
       Copy one file into execution.local_directory/.borgee/channel-files.
   files sync [<channel-path>] [--overwrite]
@@ -605,6 +605,32 @@ def call_gateway(credential: dict[str, str], request: dict[str, object]) -> obje
     return json.loads(body_text) if body_text else None
 
 
+def require_extracted_text(result: object, path: str) -> str:
+    if isinstance(result, dict) and isinstance(result.get("text"), str):
+        return result["text"]
+    extraction = result.get("extraction") if isinstance(result, dict) else None
+    status = (
+        extraction.get("status")
+        if isinstance(extraction, dict) and isinstance(extraction.get("status"), str)
+        else "unavailable"
+    )
+    warnings = extraction.get("warnings") if isinstance(extraction, dict) else None
+    details = []
+    if isinstance(warnings, list):
+        for warning in warnings:
+            if not isinstance(warning, dict):
+                continue
+            code = warning.get("code") if isinstance(warning.get("code"), str) else "UNKNOWN"
+            message = (
+                warning.get("message")
+                if isinstance(warning.get("message"), str)
+                else "No details"
+            )
+            details.append(f"{code}: {message}")
+    detail = f"; {'; '.join(details)}" if details else ""
+    raise RuntimeError(f"Cannot print {path}: text extraction is {status}{detail}")
+
+
 def main() -> int:
     parsed = parse_args(sys.argv[1:])
     if parsed.get("help") is True:
@@ -617,7 +643,7 @@ def main() -> int:
     credential = read_gateway_credential(str(parsed["gateway_credential_path"]))
     result = call_gateway(credential, resolve_request(credential, parsed))
     if parsed["command"] == "files" and parsed["file_command"] == "cat":
-        text = str(result["text"])
+        text = require_extracted_text(result, str(parsed["file_path"]))
         if not text.endswith("\n"):
             text += "\n"
         sys.stdout.buffer.write(text.encode("utf-8"))