Create human_oversight_strategy.py

tools/human_oversight_strategy.py

@@ -0,0 +1,98 @@
+# tools/human_oversight_strategy.py
+import datetime, re
+from fpdf import FPDF
+from langdetect import detect
+import gradio as gr
+
+def export_text_to_pdf(text, output_path=None, language="en"):
+    if output_path is None:
+        timestamp = datetime.datetime.now().strftime("%Y%m%d_%H%M%S")
+        output_path = f"human_oversight_strategy_{timestamp}.pdf"
+
+    pdf = FPDF()
+    pdf.add_page()
+    pdf.set_auto_page_break(auto=True, margin=15)
+    pdf.set_font("Arial", 'B', 16)
+    pdf.set_text_color(0, 51, 102)
+    title = "Human Oversight Strategy (Art. 14)" if language == "en" else "Stratégie de Supervision Humaine"
+    pdf.cell(0, 15, title, ln=True, align='C')
+    pdf.ln(10)
+    pdf.set_font("Arial", '', 12)
+    pdf.set_text_color(0, 0, 0)
+
+    for line in text.strip().split('\n'):
+        if line.startswith("## "):
+            section = line.replace("## ", "").strip()
+            pdf.set_font("Arial", 'B', 13)
+            pdf.set_text_color(30, 30, 120)
+            pdf.ln(8)
+            pdf.cell(0, 10, section, ln=True)
+            pdf.set_font("Arial", '', 12)
+            pdf.set_text_color(0, 0, 0)
+        elif line.startswith("- **"):
+            match = re.match(r"- \*\*(.+?)\*\*: (.+)", line)
+            if match:
+                label, value = match.groups()
+                pdf.set_font("Arial", 'B', 12)
+                pdf.cell(0, 10, f"{label}:", ln=True)
+                pdf.set_font("Arial", '', 12)
+                pdf.multi_cell(0, 10, value)
+        else:
+            pdf.multi_cell(0, 10, line)
+    pdf.output(output_path)
+    return output_path
+
+QUESTIONS = [
+    ("system_name", "What is the name of the AI system?"),
+    ("oversight_roles", "Who is responsible for human oversight?"),
+    ("oversight_tasks", "What are their oversight responsibilities?"),
+    ("intervention_methods", "How can they intervene in the system?"),
+    ("training", "What training is provided to oversight personnel?"),
+    ("monitoring_tools", "What tools help humans supervise the system?"),
+    ("limitations", "What are known limitations of human control?"),
+    ("escalation", "What is the escalation protocol for risks?")
+]
+
+def get_questions():
+    return QUESTIONS
+
+def run_tool():
+    state = {"step": 0, "answers": {}}
+
+    def step_by_step_agent(user_input, state):
+        step = state["step"]
+        answers = state["answers"]
+        if step > 0:
+            key, _ = QUESTIONS[step - 1]
+            answers[key] = user_input
+        if step < len(QUESTIONS):
+            question = QUESTIONS[step][1]
+            state["step"] += 1
+            return question, state, None
+
+        content = "\n".join([f"- **{label}**: {answers.get(key, '')}" for key, label in QUESTIONS])
+        lang = detect(content)
+        pdf_path = export_text_to_pdf(content, language=lang)
+        return "✅ Strategy ready below!", {"done": True}, pdf_path
+
+    with gr.Blocks() as demo:
+        chatbot = gr.Chatbot(label="👁️ Human Oversight Assistant", value=[{"role": "assistant", "content": QUESTIONS[0][1]}], type="messages")
+        msg = gr.Textbox(label="Your answer")
+        state_var = gr.State(state)
+        file_output = gr.File(label="Download PDF")
+        reset_btn = gr.Button("🔁 Restart")
+
+        def chat_logic(msg_in, state_in):
+            reply, updated_state, file = step_by_step_agent(msg_in, state_in)
+            messages = [{"role": "user", "content": msg_in}]
+            if reply:
+                messages.append({"role": "assistant", "content": reply})
+            return messages, updated_state, file
+
+        def reset():
+            return [{"role": "assistant", "content": QUESTIONS[0][1]}], {"step": 0, "answers": {}}, None
+
+        msg.submit(chat_logic, [msg, state_var], [chatbot, state_var, file_output])
+        reset_btn.click(reset, outputs=[chatbot, state_var, file_output])
+
+    demo.launch()