Skip to content

Hello-QM/catgo-LRG / server/catgo/workflow

catgo-workflow

Verified

Create and manage computational chemistry workflows with CatGo. Supports VASP, CP2K, ORCA, MLP, LAMMPS. Build OER/HER/CO2RR workflows, geometry optimization, frequency analysis, Gibbs energy calculations.

FileKindSize
SKILL.mdskill md3.8 KB
__init__.pyscript1.1 KB
builtins.pyscript4.7 KB
builtins_impl.pyscript21.2 KB
config.pyscript6.5 KB
db.pyscript25.3 KB
engine/__init__.pyscript615 B
engine/advancer.pyscript9.3 KB
engine/ai_diagnosis.pyscript3.8 KB
engine/batch_submitter.pyscript9.7 KB
engine/broadcast.pyscript1.8 KB
engine/collector.pyscript8.3 KB
engine/control_flow.pyscript5.7 KB
engine/engine_builtins.pyscript19.6 KB
engine/engine_registry.pyscript1.5 KB
engine/error_handler.pyscript3.6 KB
engine/hpc_utils.pyscript4.0 KB
engine/job_script.pyscript11.6 KB
engine/lifecycle.pyscript10.8 KB
engine/orca_progress.pyscript3.4 KB
engine/poller.pyscript11.7 KB
engine/resolver.pyscript2.7 KB
engine/result_collector.pyscript56.3 KB
engine/result_handler.pyscript5.6 KB
engine/scanner.pyscript52.0 KB
engine/smart_recovery.pyscript3.6 KB
engine/submitter.pyscript26.2 KB
engine/v1_monitor.pyscript2.7 KB
engine/vasp_submission.pyscript29.0 KB
graph_converter.pyscript6.5 KB
mcp_tools.pyscript7.5 KB
provenance.pyscript5.8 KB
reference.pyscript1.1 KB
service.pyscript4.0 KB
state_map.pyscript1.5 KB
states.pyscript7.5 KB
task_decorator.pyscript2.5 KB
task_ids.pyscript986 B
v1_compat.pyscript2.8 KB
workflow.pyscript12.0 KB

service.py

View on GitHub
"""Workflow service — shared ops for REST API and MCP tools."""

from __future__ import annotations
import json
from collections import deque
from typing import Any

from catgo.workflow.db import WorkflowDB
from catgo.workflow.workflow import Workflow
from catgo.workflow.reference import OutputReference
from catgo.workflow.states import TaskState
from catgo.workflow.engine.lifecycle import (
    submit_workflow as _submit,
    pause_workflow as _pause,
    resume_workflow as _resume,
    reset_workflow as _reset,
)


def create_workflow(db: WorkflowDB, name: str, config: dict | None = None) -> dict:
    """Create a new workflow and return its id + name."""
    wf = Workflow(name, db=db, config=config)
    return {"workflow_id": wf.workflow_id, "name": wf.name}


def add_task(
    db: WorkflowDB,
    workflow_id: str,
    task_type: str,
    name: str | None = None,
    system_name: str | None = None,
    **kwargs: Any,
) -> dict:
    """Add a task to an existing workflow. Returns task_id + task_type."""
    resolved = {}
    for k, v in kwargs.items():
        if isinstance(v, dict) and "_ref" in v:
            resolved[k] = OutputReference(v["_ref"], v.get("_key"))
        else:
            resolved[k] = v

    wf = Workflow.__new__(Workflow)
    wf.db = db
    wf.workflow_id = workflow_id
    wf.name = ""
    wf.config = {}

    handle = wf.add_task(task_type, name=name, system_name=system_name, **resolved)
    return {"task_id": handle.task_id, "task_type": handle.task_type}


def get_status(db: WorkflowDB, workflow_id: str) -> dict:
    """Return workflow summary with task list."""
    wf = db.get_workflow(workflow_id)
    tasks = db.get_all_tasks(workflow_id)
    return {
        "workflow": {"id": wf["id"], "name": wf["name"], "status": wf["status"]},
        "tasks": [
            {
                "id": t["id"],
                "type": t["task_type"],
                "name": t.get("name"),
                "status": t["status"],
                "system_name": t.get("system_name"),
            }
            for t in tasks
        ],
    }


def list_workflows(db: WorkflowDB) -> list[dict]:
    """List all workflows (id, name, status)."""
    return [
        {"id": w["id"], "name": w["name"], "status": w["status"]}
        for w in db.list_workflows()
    ]


def modify_task_params(db: WorkflowDB, task_id: str, updates: dict) -> dict:
    """Merge *updates* into existing task params. Only allowed for editable states."""
    task = db.get_task(task_id)
    editable = {TaskState.WAITING.value, TaskState.READY.value, TaskState.PAUSED.value}
    if task["status"] not in editable:
        raise ValueError(f"Cannot edit: task is {task['status']}")
    existing = json.loads(task.get("params_json", "{}") or "{}")
    existing.update(updates)
    db.update_task(task_id, params_json=json.dumps(existing))
    return {"task_id": task_id, "params": existing}


def retry_task(db: WorkflowDB, task_id: str) -> list[str]:
    """Reset a task and all downstream dependents to WAITING."""
    to_reset: set[str] = set()
    queue = deque([task_id])
    while queue:
        tid = queue.popleft()
        if tid in to_reset:
            continue
        to_reset.add(tid)
        for link in db.get_task_children(tid):
            queue.append(link["target_task_id"])
    for tid in to_reset:
        db.update_task(
            tid,
            status=TaskState.WAITING.value,
            error_message=None,
            error_type=None,
            retry_count=0,
            work_dir=None,  # force recompute (prior attempt may have stickied a bad path)
        )
    return list(to_reset)


def submit(db: WorkflowDB, workflow_id: str) -> dict:
    _submit(db, workflow_id); return {"status": "running"}

def pause(db: WorkflowDB, workflow_id: str) -> dict:
    _pause(db, workflow_id); return {"status": "paused"}

def resume(db: WorkflowDB, workflow_id: str) -> dict:
    _resume(db, workflow_id); return {"status": "running"}

def reset(db: WorkflowDB, workflow_id: str) -> dict:
    _reset(db, workflow_id); return {"status": "draft"}
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall