ODS V3 Pre-Release: Public testing and refinement ahead of the official V3 launch. Turn your PC, Mac, or Linux box into a private AI server.
Python ai-agentsamdcomfyuidockerllama-cppllmlocal-ain8nnvidiaopen-webuiragself-hostedspeech-to-textstrix-halotext-to-speechworkflow-automation
#!/bin/bash
# ============================================================================
# ODS Installer — Background Task Management
# ============================================================================
# Part of: installers/lib/
# Purpose: Track and verify completion of background processes
#
# Expects: LOG_FILE, ai(), ai_ok(), ai_warn(), ai_bad()
# Provides: bg_task_start(), bg_task_wait(), bg_task_status()
#
# Modder notes:
# Add new background task types here.
# ============================================================================
# Registry file for background tasks. Keep the default install-scoped so a
# second ODS tree cannot report another install's task as its own.
if [[ -z "${BG_TASK_REGISTRY:-}" ]]; then
if [[ -n "${INSTALL_DIR:-}" ]]; then
BG_TASK_REGISTRY="${INSTALL_DIR}/logs/background-tasks.json"
else
BG_TASK_REGISTRY="/tmp/ods-bg-tasks.json"
fi
fi
# Start tracking a background task
# Usage: bg_task_start <task_id> <pid> <description> <log_file>
bg_task_start() {
local task_id="$1"
local pid="$2"
local description="$3"
local log_file="$4"
# Keep the registry parent install-scoped. Registry creation and updates
# happen together in Python so a starter never observes an absent registry
# between a separate shell-level `[]` initialization and its own update.
mkdir -p "$(dirname "$BG_TASK_REGISTRY")"
# Add or reconcile the task in the registry.
python3 - "$BG_TASK_REGISTRY" "$task_id" "$pid" "$description" "$log_file" <<'PY'
import json
import os
import sys
import tempfile
from pathlib import Path
registry_path = Path(sys.argv[1])
task_id = sys.argv[2]
pid = int(sys.argv[3])
description = sys.argv[4]
log_file = sys.argv[5]
tasks = json.loads(registry_path.read_text()) if registry_path.exists() else []
task = {
"id": task_id,
"pid": pid,
"description": description,
"log_file": log_file,
"status": "running"
}
# A rerun may launch a short-lived duplicate while the original long-running
# task still owns its lifecycle lock. Preserve that live task; replacing it
# with the duplicate would make the summary report completion as soon as the
# duplicate exits even though the original download is still active. Replace
# only stale records, and never append a duplicate ID.
for index, existing in enumerate(tasks):
if existing.get("id") == task_id:
existing_pid = existing.get("pid")
existing_running = False
if isinstance(existing_pid, int) and existing_pid > 0:
try:
os.kill(existing_pid, 0)
existing_running = True
except OSError:
pass
if not existing_running:
tasks[index] = task
break
else:
tasks.append(task)
fd, tmp_path = tempfile.mkstemp(dir=str(registry_path.parent), suffix=".tmp")
try:
with os.fdopen(fd, "w") as f:
json.dump(tasks, f, indent=2)
f.flush()
os.fsync(f.fileno())
os.replace(tmp_path, str(registry_path))
except BaseException:
try:
os.unlink(tmp_path)
except OSError:
pass
raise
PY
}
# Check status of a background task
# Usage: bg_task_status <task_id>
# Returns: 0 if running, 1 if completed successfully, 2 if failed, 3 if not found
bg_task_status() {
local task_id="$1"
if [[ ! -f "$BG_TASK_REGISTRY" ]]; then
return 3
fi
python3 - "$BG_TASK_REGISTRY" "$task_id" <<'PY'
import json
import sys
import os
import re
from pathlib import Path
registry_path = Path(sys.argv[1])
task_id = sys.argv[2]
if not registry_path.exists():
sys.exit(3)
tasks = json.loads(registry_path.read_text())
task = next((t for t in tasks if t["id"] == task_id), None)
if not task:
sys.exit(3)
pid = task["pid"]
# Check if process is still running
try:
os.kill(pid, 0)
sys.exit(0) # Running
except OSError:
# Process not running - check log for success/failure
log_file = task.get("log_file", "")
if log_file and Path(log_file).exists():
log_content = Path(log_file).read_text()
# OpenClaw cleanup reports zero failures in a successful summary.
# Ignore only that complete line; errors elsewhere still count.
log_content = re.sub(r"(?m)^[ \t]*Done: [0-9]+ removed, 0 failed[ \t]*\r?$", "", log_content)
if "ERROR" in log_content or "FAILED" in log_content or "failed" in log_content:
sys.exit(2) # Failed
else:
sys.exit(1) # Completed
sys.exit(1) # Assume completed if no log
PY
}
# Wait for a background task to complete with timeout
# Usage: bg_task_wait <task_id> <timeout_seconds> [check_interval]
# Returns: 0 if completed successfully, 1 if failed, 2 if timeout
bg_task_wait() {
local task_id="$1"
local timeout="${2:-1200}"
local check_interval="${3:-5}"
local elapsed=0
while [[ $elapsed -lt $timeout ]]; do
bg_task_status "$task_id"
local status=$?
case $status in
0) # Still running
sleep "$check_interval"
elapsed=$((elapsed + check_interval))
;;
1) # Completed successfully
return 0
;;
2) # Failed
return 1
;;
3) # Not found
return 1
;;
esac
done
# Timeout
return 2
}
# Get summary of all background tasks
# Usage: bg_task_summary
bg_task_summary() {
if [[ ! -f "$BG_TASK_REGISTRY" ]]; then
echo "No background tasks registered"
return
fi
python3 - "$BG_TASK_REGISTRY" <<'PY'
import json
import sys
import os
import re
from pathlib import Path
registry_path = Path(sys.argv[1])
tasks = json.loads(registry_path.read_text())
if not tasks:
print("No background tasks registered")
sys.exit(0)
print(f"Background tasks: {len(tasks)}")
for task in tasks:
task_id = task["id"]
pid = task["pid"]
desc = task["description"]
# Check if still running
try:
os.kill(pid, 0)
status = "running"
except OSError:
log_file = task.get("log_file", "")
if log_file and Path(log_file).exists():
log_content = Path(log_file).read_text()
# Ignore the successful OpenClaw cleanup line, not other failures.
log_content = re.sub(r"(?m)^[ \t]*Done: [0-9]+ removed, 0 failed[ \t]*\r?$", "", log_content)
if "ERROR" in log_content or "failed" in log_content:
status = "failed"
else:
status = "completed"
else:
status = "completed"
print(f" [{task_id}] {desc}: {status}")
PY
}