Human-in-the-loop (HITL)

from exemplar_harness import Harness, HITLTimeoutError
 
harness = Harness.from_env(agent_id="deploy-agent")
hitl = harness.hitl()
 
try:
    result = hitl.ask(
        "Deploy build 1234 to production?",
        description="All checks green. Blast radius: payments service.",
        payload={"build": "1234", "service": "payments"},
        ttl_seconds=1800,   # server-side expiry
        timeout=1800,       # local wait budget (seconds)
        poll_interval=5,
    )
except HITLTimeoutError:
    result = None
 
if result and result.approved:
    deploy()
elif result and result.state == "rejected":
    print(f"Denied: {result.response.comment}")

request = hitl.request_approval("Rotate production credentials?")
# Human approves/denies in Marshal → HITL; poll or cancel as needed
status = hitl.get(request.request_id)
if status.is_pending:
    hitl.cancel(request.request_id)
 
answer = hitl.ask("Which rollback strategy?", request_type="input")
choice = hitl.ask(
    "Pick a deployment region",
    request_type="select",
    options=["us-east-1", "eu-west-1"],
)

from langchain_core.tools import tool
 
@tool
def ask_human_approval(question: str) -> str:
    """Ask a human operator to approve or reject an action."""
    result = harness.hitl().ask(question, timeout=900)
    if result.approved:
        return "approved"
    return f"denied ({result.state}): {result.response.comment or 'no comment'}"

import {
  Harness,
  HITLTimeoutError,
} from "@exemplar-dev/exemplar-harness-typescript-sdk";
 
const harness = Harness.fromEnv({ agentId: "deploy-agent" });
const hitl = harness.hitl();
 
let result;
try {
  result = await hitl.ask("Deploy build 1234 to production?", {
    description: "All checks green. Blast radius: payments service.",
    payload: { build: "1234", service: "payments" },
    ttlSeconds: 1800,
    timeout: 1800,
    pollInterval: 5,
  });
} catch (err) {
  if (err instanceof HITLTimeoutError) result = null;
  else throw err;
}
 
if (result?.approved) {
  await deploy();
} else if (result?.state === "rejected") {
  console.log(`Denied: ${result.response?.comment}`);
}

const request = await hitl.requestApproval("Rotate production credentials?");
// Approve / deny in Marshal → HITL Approvals
const status = await hitl.get(request.requestId);
if (status.isPending) await hitl.cancel(request.requestId);