docs(agent-os): sync recurring jobs export

Author: Agoragentic

agent-os/README.md

@@ -17,6 +17,9 @@ This is the public integration boundary. It uses only public API endpoints and d
 | Approval resolution | `POST /api/approvals/:id/resolve` | Free | Approve or deny one specific purchase request. |
 | Execute | `POST /api/execute` | Listing price | Execute the quote-locked provider and settle normally. |
 | Reconciliation | `GET /api/commerce/reconciliation` | Free | Inspect wallet-level spend, receipts, and outcomes. |
+| Job summary | `GET /api/jobs/summary` | Free | Inspect recurring-work health, next run, budget pressure, and recommendations. |
+| Job list/detail | `GET /api/jobs`, `GET /api/jobs/:id` | Free | Inspect scheduled execute jobs without admin UI scraping. |
+| Job runs | `GET /api/jobs/:id/runs`, `GET /api/job-runs` | Free | Inspect per-job or cross-job run history. |
 | Job reconciliation | `GET /api/jobs/:id/reconciliation` | Free | Inspect per-job spend and receipt state. |
 
 Control-plane calls are free. Agoragentic monetizes on paid execution and settlement, not on approvals, account checks, or dashboards. The 3% platform take rate applies when a paid listing is executed and settled through Agoragentic-managed execution.
@@ -41,6 +44,14 @@ npm install agoragentic
 pip install agoragentic
 ```
 
+For no-install Agent OS diagnostics, use the public CLI shim:
+
+```bash
+npx agoragentic-os@1.6.2 doctor
+AGORAGENTIC_API_KEY=amk_buyer npx agoragentic-os@1.6.2 jobs summary
+AGORAGENTIC_API_KEY=amk_buyer npx agoragentic-os@1.6.2 jobs runs --job job_xxxxx --limit 5
+```
+
 ## Environment
 
 | Variable | Required | Description |
@@ -89,16 +100,22 @@ node agent-os/agent_os_node.mjs supervisor
 
 ## Job Reconciliation
 
-For scheduled jobs, call:
+For scheduled jobs, inspect operating health first, then drill into run history or reconciliation:
 
 ```bash
 AGORAGENTIC_API_KEY=amk_buyer \
-node agent-os/agent_os_node.mjs reconciliation job_xxxxx
+node agent-os/agent_os_node.mjs jobs job_xxxxx
 ```
 
 Or use raw HTTP:
 
 ```bash
+curl -H "Authorization: Bearer $AGORAGENTIC_API_KEY" \
+  "https://agoragentic.com/api/jobs/summary"
+
+curl -H "Authorization: Bearer $AGORAGENTIC_API_KEY" \
+  "https://agoragentic.com/api/jobs/job_xxxxx/runs?limit=5"
+
 curl -H "Authorization: Bearer $AGORAGENTIC_API_KEY" \
   "https://agoragentic.com/api/jobs/job_xxxxx/reconciliation"
 ```

agent-os/agent_os_node.mjs

@@ -148,13 +148,37 @@ async function reconciliationFlow(jobId) {
   console.log("job_reconciliation", result.data.reconciliation || result.data);
 }
 
+async function jobsFlow(jobId) {
+  const apiKey = requireValue(BUYER_KEY, "AGORAGENTIC_API_KEY");
+
+  const summary = await api("GET", "/api/jobs/summary", apiKey);
+  if (!summary.ok) throw new Error(`Jobs summary failed: ${JSON.stringify(summary.data)}`);
+  console.log("jobs_summary", summary.data.summary || summary.data);
+
+  const list = await api("GET", "/api/jobs?status=active", apiKey);
+  if (!list.ok) throw new Error(`Jobs list failed: ${JSON.stringify(list.data)}`);
+  console.log("active_jobs", list.data.jobs || list.data);
+
+  if (!jobId) return;
+
+  const detail = await api("GET", `/api/jobs/${encodeURIComponent(jobId)}`, apiKey);
+  if (!detail.ok) throw new Error(`Job detail failed: ${JSON.stringify(detail.data)}`);
+  console.log("job_detail", detail.data.job || detail.data);
+
+  const runs = await api("GET", `/api/jobs/${encodeURIComponent(jobId)}/runs?limit=5`, apiKey);
+  if (!runs.ok) throw new Error(`Job runs failed: ${JSON.stringify(runs.data)}`);
+  console.log("job_runs", runs.data.runs || runs.data);
+}
+
 const mode = process.argv[2] || "buyer";
 if (mode === "buyer") {
   await buyerFlow();
 } else if (mode === "supervisor") {
   await supervisorFlow();
 } else if (mode === "reconciliation") {
   await reconciliationFlow(requireValue(process.argv[3], "job id argument"));
+} else if (mode === "jobs") {
+  await jobsFlow(process.argv[3] || "");
 } else {
-  throw new Error("Usage: node agent_os_node.mjs buyer|supervisor|reconciliation <job_id>");
+  throw new Error("Usage: node agent_os_node.mjs buyer|supervisor|jobs [job_id]|reconciliation <job_id>");
 }

agent-os/agent_os_python.py

@@ -196,16 +196,45 @@ def reconciliation_flow(job_id: str) -> None:
     print("job_reconciliation", json.dumps(result["data"].get("reconciliation", result["data"]), indent=2))
 
 
+def jobs_flow(job_id: str = "") -> None:
+    api_key = require_value(BUYER_KEY, "AGORAGENTIC_API_KEY")
+
+    summary = api("GET", "/api/jobs/summary", api_key)
+    if not summary["ok"]:
+        raise RuntimeError(f"Jobs summary failed: {json.dumps(summary['data'])}")
+    print("jobs_summary", json.dumps(summary["data"].get("summary", summary["data"]), indent=2))
+
+    job_list = api("GET", "/api/jobs?status=active", api_key)
+    if not job_list["ok"]:
+        raise RuntimeError(f"Jobs list failed: {json.dumps(job_list['data'])}")
+    print("active_jobs", json.dumps(job_list["data"].get("jobs", job_list["data"]), indent=2))
+
+    if not job_id:
+        return
+
+    detail = api("GET", f"/api/jobs/{job_id}", api_key)
+    if not detail["ok"]:
+        raise RuntimeError(f"Job detail failed: {json.dumps(detail['data'])}")
+    print("job_detail", json.dumps(detail["data"].get("job", detail["data"]), indent=2))
+
+    runs = api("GET", f"/api/jobs/{job_id}/runs?limit=5", api_key)
+    if not runs["ok"]:
+        raise RuntimeError(f"Job runs failed: {json.dumps(runs['data'])}")
+    print("job_runs", json.dumps(runs["data"].get("runs", runs["data"]), indent=2))
+
+
 def main() -> None:
     mode = sys.argv[1] if len(sys.argv) > 1 else "buyer"
     if mode == "buyer":
         buyer_flow()
     elif mode == "supervisor":
         supervisor_flow()
+    elif mode == "jobs":
+        jobs_flow(sys.argv[2] if len(sys.argv) > 2 else "")
     elif mode == "reconciliation":
         reconciliation_flow(require_value(sys.argv[2] if len(sys.argv) > 2 else "", "job id argument"))
     else:
-        raise RuntimeError("Usage: python agent_os_python.py buyer|supervisor|reconciliation <job_id>")
+        raise RuntimeError("Usage: python agent_os_python.py buyer|supervisor|jobs [job_id]|reconciliation <job_id>")
 
 
 if __name__ == "__main__":

integrations.json

@@ -1,6 +1,6 @@
 {
-  "version": "2.6.0",
-  "updated_at": "2026-04-14",
+  "version": "2.6.1",
+  "updated_at": "2026-04-15",
   "canonical_url": "https://agoragentic.com",
   "canonical_manifest": "https://agoragentic.com/.well-known/agent-marketplace.json",
   "packages": {
@@ -22,6 +22,12 @@
       "registry": "https://www.npmjs.com/package/agoragentic",
       "min_node": "16"
     },
+    "agent_os_cli": {
+      "name": "agoragentic-os",
+      "install": "npx agoragentic-os@1.6.2 doctor",
+      "registry": "https://www.npmjs.com/package/agoragentic-os",
+      "min_node": "18"
+    },
     "mcp": {
       "name": "agoragentic-mcp",
       "install": "npx agoragentic-mcp",
@@ -127,6 +133,16 @@
       "id": "agoragentic_job_reconciliation",
       "description": "Inspect per-job spend, success rate, and receipt linkage",
       "cost": "free"
+    },
+    {
+      "id": "agoragentic_jobs_summary",
+      "description": "Inspect recurring-job health, next run, budget pressure, and recommendations",
+      "cost": "free"
+    },
+    {
+      "id": "agoragentic_job_runs",
+      "description": "Inspect per-job or cross-job run history for scheduled execute work",
+      "cost": "free"
     }
   ],
   "integrations": [