Hermes Agent b9a5810d85 feat(v3): human-in-the-loop — interactive steps, pluggable step_type registry
- New states: waiting (step/task), rejected (step)
- New tables: pipeline_human_tasks, pipeline_step_types
- New module: step_registry.py — pluggable step_type metadata
- New module: human.py — human_complete, approval_approve, approval_reject
- Executor: detects interactive step_types, creates human_tasks, enters waiting
- Reject with rollback: approval_reject(rollback_to=step) resets steps and re-runs
- API: human_task_complete, approval_approve, approval_reject, human_task_list
- API: pipeline_step_types, pipeline_register_step_type, pipeline_unregister_step_type
- Built-in interactive types: human_task, approval_gate
- Updated DDL and appcodes
2026-06-16 11:05:45 +08:00

343 lines
13 KiB
Python

"""Pipeline storage layer - MySQL via sqlor."""
import json
from typing import Dict, List, Optional
from sqlor.dbpools import DBPools
from appPublic.uniqueID import getID
from appPublic.log import debug
DBNAME = "pipeline"
def _get_db():
return DBPools(), DBNAME
async def get_pipeline_steps(pipeline_id: str) -> list:
"""Read step definitions from pipeline_steps table (defined by pipeline_core).
Extracts 'deps' from step_config JSON and injects it as a top-level field
so that build_step_graph() can find it.
"""
db, dbname = _get_db()
async with db.sqlorContext(dbname) as sor:
recs = await sor.R('pipeline_steps', {'pipeline_id': pipeline_id}, sort='step_order')
if not recs:
return []
result = []
for rec in recs:
if hasattr(rec, '__dict__'):
d = {k: getattr(rec, k) for k in dir(rec) if not k.startswith('_')}
else:
d = dict(rec)
# Extract deps from step_config JSON
cfg_raw = d.get('step_config', '{}')
try:
cfg = json.loads(cfg_raw) if isinstance(cfg_raw, str) else cfg_raw
except (json.JSONDecodeError, TypeError):
cfg = {}
d['deps'] = cfg.get('deps', [])
result.append(d)
return result
async def create_task(tenant_id: str, pipeline_id: str, owner_id: str, title: str, params: dict) -> str:
"""Create a new pipeline task. Returns task_id."""
db, dbname = _get_db()
async with db.sqlorContext(dbname) as sor:
task_id = getID()
data = {
"id": task_id,
"tenant_id": tenant_id,
"pipeline_id": pipeline_id,
"owner_id": owner_id,
"title": title,
"state": "submitted",
"current_version": 1,
"params": json.dumps(params, ensure_ascii=False, default=str),
}
await sor.C('pipeline_tasks', data)
return task_id
async def init_task_steps(task_id: str, step_records: list):
"""Create step execution records from pipeline step definitions."""
db, dbname = _get_db()
async with db.sqlorContext(dbname) as sor:
for rec in step_records:
step_id = getID()
data = {
"id": step_id,
"task_id": task_id,
"step_name": rec['step_name'],
"step_type": rec.get('step_type', rec['step_name']),
"display_name": rec.get('display_name', rec['step_name']),
"step_order": rec.get('step_order', 0),
"deps": rec.get('deps', '[]') if isinstance(rec.get('deps'), str) else json.dumps(rec.get('deps', [])),
"state": "pending",
}
await sor.C('pipeline_task_steps', data)
async def get_task(tenant_id: str, task_id: str) -> Optional[dict]:
"""Get task record, filtered by tenant."""
db, dbname = _get_db()
async with db.sqlorContext(dbname) as sor:
recs = await sor.R('pipeline_tasks', {'id': task_id, 'tenant_id': tenant_id})
if not recs:
return None
rec = recs[0]
if hasattr(rec, '__dict__'):
return {k: getattr(rec, k) for k in dir(rec) if not k.startswith('_')}
return dict(rec)
async def get_task_steps(task_id: str) -> list:
"""Get all step records for a task."""
db, dbname = _get_db()
async with db.sqlorContext(dbname) as sor:
recs = await sor.R('pipeline_task_steps', {'task_id': task_id}, sort='step_order')
result = []
for rec in (recs or []):
if hasattr(rec, '__dict__'):
result.append({k: getattr(rec, k) for k in dir(rec) if not k.startswith('_')})
else:
result.append(dict(rec))
return result
async def get_step_states(task_id: str) -> Dict[str, str]:
"""Get {step_name: state} for all steps of a task."""
steps = await get_task_steps(task_id)
return {s['step_name']: s['state'] for s in steps}
async def update_task_state(task_id: str, state: str):
"""Update task state."""
db, dbname = _get_db()
async with db.sqlorContext(dbname) as sor:
await sor.U('pipeline_tasks', {"id": task_id, "state": state})
async def update_task_version(task_id: str, version: int):
"""Update task current_version."""
db, dbname = _get_db()
async with db.sqlorContext(dbname) as sor:
await sor.U('pipeline_tasks', {"id": task_id, "current_version": version})
async def update_step_state(task_id: str, step_name: str, state: str, error_msg: str = None):
"""Update step state."""
db, dbname = _get_db()
async with db.sqlorContext(dbname) as sor:
recs = await sor.R('pipeline_task_steps', {'task_id': task_id, 'step_name': step_name})
if not recs:
return
rec = recs[0]
rec_id = rec.id if hasattr(rec, 'id') else rec['id']
data = {"id": rec_id, "state": state}
if state == "running":
data["started_at"] = "NOW()"
elif state in ("completed", "failed"):
data["completed_at"] = "NOW()"
if error_msg:
data["error_msg"] = error_msg
await sor.U('pipeline_task_steps', data)
async def save_artifact(task_id: str, version: int, step_name: str, io_type: str, data: dict):
"""Save or update an artifact."""
db, dbname = _get_db()
async with db.sqlorContext(dbname) as sor:
# Check if exists
existing = await sor.R('pipeline_artifacts', {
'task_id': task_id, 'version': version,
'step_name': step_name, 'io_type': io_type
})
data_json = json.dumps(data, ensure_ascii=False, default=str)
if existing:
rec = existing[0]
rec_id = rec.id if hasattr(rec, 'id') else rec['id']
await sor.U('pipeline_artifacts', {"id": rec_id, "data": data_json})
else:
await sor.C('pipeline_artifacts', {
"id": getID(),
"task_id": task_id,
"version": version,
"step_name": step_name,
"io_type": io_type,
"data": data_json,
})
async def get_artifact(task_id: str, version: int, step_name: str, io_type: str) -> Optional[dict]:
"""Get artifact data."""
db, dbname = _get_db()
async with db.sqlorContext(dbname) as sor:
recs = await sor.R('pipeline_artifacts', {
'task_id': task_id, 'version': version,
'step_name': step_name, 'io_type': io_type
})
if not recs:
return None
rec = recs[0]
raw = rec.data if hasattr(rec, 'data') else rec['data']
if isinstance(raw, str):
return json.loads(raw)
return raw
async def get_all_artifacts(task_id: str, version: int) -> Dict[str, dict]:
"""Get all artifacts for a task version. Returns {step_name_io_type: data}."""
db, dbname = _get_db()
async with db.sqlorContext(dbname) as sor:
recs = await sor.R('pipeline_artifacts', {'task_id': task_id, 'version': version})
result = {}
for rec in (recs or []):
sn = rec.step_name if hasattr(rec, 'step_name') else rec['step_name']
io = rec.io_type if hasattr(rec, 'io_type') else rec['io_type']
raw = rec.data if hasattr(rec, 'data') else rec['data']
key = f"{sn}_{io}"
result[key] = json.loads(raw) if isinstance(raw, str) else raw
return result
async def list_tasks(tenant_id: str, pipeline_id: str = None, limit: int = 100) -> list:
"""List tasks for a tenant."""
db, dbname = _get_db()
async with db.sqlorContext(dbname) as sor:
if pipeline_id:
sql = "SELECT * FROM pipeline_tasks WHERE tenant_id=${tenant_id}$ AND pipeline_id=${pipeline_id}$ ORDER BY created_at DESC"
recs = await sor.sqlExe(sql, {'tenant_id': tenant_id, 'pipeline_id': pipeline_id})
else:
sql = "SELECT * FROM pipeline_tasks WHERE tenant_id=${tenant_id}$ ORDER BY created_at DESC"
recs = await sor.sqlExe(sql, {'tenant_id': tenant_id})
result = []
for rec in (recs or [])[:limit]:
if hasattr(rec, '__dict__'):
result.append({k: getattr(rec, k) for k in dir(rec) if not k.startswith('_')})
else:
result.append(dict(rec))
return result
async def reset_steps(task_id: str, step_names: list):
"""Reset specified steps to pending state."""
db, dbname = _get_db()
async with db.sqlorContext(dbname) as sor:
for sn in step_names:
recs = await sor.R('pipeline_task_steps', {'task_id': task_id, 'step_name': sn})
if recs:
rec = recs[0]
rec_id = rec.id if hasattr(rec, 'id') else rec['id']
await sor.U('pipeline_task_steps', {
"id": rec_id, "state": "pending",
"error_msg": None, "started_at": None, "completed_at": None
})
# ── Human tasks storage ──
async def create_human_task(task_id, step_name, version, task_type, assignee_role=None,
assignee_id=None, form_schema=None, timeout_hours=None):
"""Create a pipeline_human_tasks record."""
db, dbname = _get_db()
async with db.sqlorContext(dbname) as sor:
data = {
"id": getID(),
"task_id": task_id,
"step_name": step_name,
"version": version,
"task_type": task_type,
"assignee_role": assignee_role or "",
"assignee_id": assignee_id or "",
"form_schema": json.dumps(form_schema, ensure_ascii=False) if form_schema else None,
"status": "pending",
}
if timeout_hours:
from datetime import datetime, timedelta
expired = datetime.now() + timedelta(hours=timeout_hours)
data["expired_at"] = expired.strftime("%Y-%m-%d %H:%M:%S")
await sor.C('pipeline_human_tasks', data)
return data["id"]
async def update_human_task_record(task_id, step_name, status, result_data=None, operator_id=None):
"""Update a human_tasks record."""
db, dbname = _get_db()
async with db.sqlorContext(dbname) as sor:
recs = await sor.R('pipeline_human_tasks', {'task_id': task_id, 'step_name': step_name})
if not recs:
return
rec = recs[0]
rec_id = rec.id if hasattr(rec, 'id') else rec['id']
data = {"id": rec_id, "status": status}
if result_data is not None:
data["result_data"] = json.dumps(result_data, ensure_ascii=False, default=str)
if operator_id:
data["submitted_by"] = operator_id
data["submitted_at"] = "NOW()"
await sor.U('pipeline_human_tasks', data)
async def list_human_tasks(tenant_id=None, assignee_role=None, assignee_id=None, status=None):
"""List human tasks with optional filters."""
db, dbname = _get_db()
async with db.sqlorContext(dbname) as sor:
conditions = []
params = {}
if assignee_role:
conditions.append("assignee_role=${assignee_role}$")
params["assignee_role"] = assignee_role
if assignee_id:
conditions.append("assignee_id=${assignee_id}$")
params["assignee_id"] = assignee_id
if status:
conditions.append("status=${status}$")
params["status"] = status
if tenant_id:
# Join with pipeline_tasks to filter by tenant
conditions.append("task_id IN (SELECT id FROM pipeline_tasks WHERE tenant_id=${tenant_id}$)")
params["tenant_id"] = tenant_id
where = " AND ".join(conditions) if conditions else "1=1"
sql = f"SELECT * FROM pipeline_human_tasks WHERE {where} ORDER BY created_at DESC"
recs = await sor.sqlExe(sql, params)
result = []
for rec in (recs or []):
if hasattr(rec, '__dict__'):
d = {k: getattr(rec, k) for k in dir(rec) if not k.startswith('_')}
else:
d = dict(rec)
# Parse JSON fields
for field in ('form_schema', 'result_data'):
if d.get(field) and isinstance(d[field], str):
try:
d[field] = json.loads(d[field])
except (json.JSONDecodeError, TypeError):
pass
result.append(d)
return result
async def get_human_task(task_id, step_name):
"""Get a specific human task record."""
db, dbname = _get_db()
async with db.sqlorContext(dbname) as sor:
recs = await sor.R('pipeline_human_tasks', {'task_id': task_id, 'step_name': step_name})
if not recs:
return None
rec = recs[0]
if hasattr(rec, '__dict__'):
d = {k: getattr(rec, k) for k in dir(rec) if not k.startswith('_')}
else:
d = dict(rec)
for field in ('form_schema', 'result_data'):
if d.get(field) and isinstance(d[field], str):
try:
d[field] = json.loads(d[field])
except (json.JSONDecodeError, TypeError):
pass
return d