{
  "schemaVersion": "1.0",
  "item": {
    "slug": "agentmanager",
    "name": "Agent-manager-for-AI-planner",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/NoNightWatch/agentmanager",
    "canonicalUrl": "https://clawhub.ai/NoNightWatch/agentmanager",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/agentmanager",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agentmanager",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "openapi/openapi.json",
      "package-lock.json",
      "package.json",
      "skill.md",
      "src/app.ts"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "agentmanager",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T13:47:41.062Z",
      "expiresAt": "2026-05-06T13:47:41.062Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agentmanager",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agentmanager",
        "contentDisposition": "attachment; filename=\"agentmanager-1.0.2.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "agentmanager"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/agentmanager"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/agentmanager",
    "agentPageUrl": "https://openagent3.xyz/skills/agentmanager/agent",
    "manifestUrl": "https://openagent3.xyz/skills/agentmanager/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/agentmanager/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "What this file is for",
        "body": "This file is a concise integration contract for AI tool callers and gateway implementers.\n\nThis skill.md is a compact integration guide for Clawhub and other AI clients.\n\nAgent Manager is an orchestration kernel for external AI planners. External AI builds plans, and Agent Manager validates, schedules, executes tools, enforces budgets, and provides replayable telemetry."
      },
      {
        "title": "Authentication",
        "body": "Use X-Run-Token for owner attribution and optional access control.\n\nREQUIRE_RUN_TOKEN=1 enables token enforcement.\nRUN_TOKENS contains allowed token values.\n\nExample header:\n\nX-Run-Token: tenant-a"
      },
      {
        "title": "Capability discovery and endpoint map",
        "body": "Start with:\n\nGET /v1/capabilities\nGET /v1/provider-adapter/schema\n\nCore endpoints:\n\nPOST /v1/plan (validate plus recommendations)\nPOST /v1/plan/validate\nPOST /v1/plan/generate\nPOST /v1/run\nPOST /v1/run/sync\nGET /v1/run/:id\nGET /v1/run/:id/events?after=\nGET /v1/run/:id/stream\nGET /v1/run/:id/replay\nGET /v1/run/:id/report (if enabled)\nGET /v1/runs\nPOST /v1/run/:id/cancel\nPOST /v1/run/:id/task/:name/inject\nPOST /v1/tools/register (only when enabled)"
      },
      {
        "title": "Provider selection",
        "body": "Provider choice follows this order:\n\ntask.provider_id\nrun.options.provider_id\nDEFAULT_PROVIDER_ID\nmock\n\nRead provider availability from capabilities.llm_providers.providers and capabilities.llm_providers.default_provider_id."
      },
      {
        "title": "Recommended client flow",
        "body": "GET /v1/capabilities\nPOST /v1/plan with { plan, options }\nPOST /v1/run (async) or POST /v1/run/sync\nStream with GET /v1/run/:id/stream or poll GET /v1/run/:id/events?after=<seq>\nRead final run from GET /v1/run/:id\nExport replay from GET /v1/run/:id/replay\nUse POST /v1/run/:id/task/:name/inject for deterministic overrides when needed"
      },
      {
        "title": "Tool-calling protocol rule",
        "body": "When a provider returns tool_calls, Agent Manager appends exactly one role=\"tool\" message for each tool_call_id before the next provider round.\n\nThis prevents protocol errors in model APIs."
      },
      {
        "title": "SSE reliability and resume",
        "body": "GET /v1/run/:id/stream sends event id from event sequence numbers.\n\nResume with Last-Event-ID header or ?after= query.\nIf idle and run is non-terminal, heartbeat comments are emitted:\n\n: ping\n\nHeartbeat interval uses SSE_HEARTBEAT_MS (default 15000)."
      },
      {
        "title": "Event types",
        "body": "Common emitted event types include:\n\ntask_start, task_end, task_retry\ntool_call_requested, tool_call_start, tool_call_end, tool_call_failed, tool_call_started, tool_call_finished\nllm_step_start, llm_step_tool_calls, llm_step_final\nllm_round_start, llm_round_tool_calls, llm_round_final\nbudget_violation, fallback_start, fallback_end\nrun_complete, run_cancel_requested\ndependency_truncated, artifact_limit"
      },
      {
        "title": "Replay and report data",
        "body": "GET /v1/run/:id/replay returns stable replay JSON:\n\n{\n  \"run\": { \"id\": \"run_123\", \"created_at\": 1700000000000, \"status\": \"succeeded\" },\n  \"plan_digest\": \"sha256:...\",\n  \"events\": [{ \"seq\": 1, \"type\": \"task_start\", \"run_id\": \"run_123\" }],\n  \"results_index\": { \"task_a\": { \"digest_hash\": \"sha256:...\" } }\n}\n\nRun cost attribution is exposed per task in run.metrics.cost_breakdown:\n\n{\n  \"metrics\": {\n    \"cost_breakdown\": {\n      \"task_a\": {\n        \"cost_est\": 0.0021,\n        \"tier\": \"cheap\",\n        \"tool_calls\": 1\n      }\n    }\n  }\n}"
      },
      {
        "title": "HTTP callback tools and timeout enforcement",
        "body": "Callback tools use callback_url and enforce ToolSpec.timeout_ms.\n\nThe execution signal combines run abort plus timeout. On timeout, tool result is structured with error_code as TOOL_TIMEOUT and retryable: true."
      },
      {
        "title": "Provider adapter contract",
        "body": "Use GET /v1/provider-adapter/schema to fetch schema_version, request and response schemas, and examples for your gateway implementation."
      },
      {
        "title": "Outbound security defaults",
        "body": "Outbound traffic is blocked by default until allowlists are configured.\n\nProvider and gateway calls require OUTBOUND_ALLOWLIST.\nCallback tools require TOOL_CALLBACK_ALLOWLIST.\nIP literal hostnames and redirect chains are blocked."
      },
      {
        "title": "Telemetry redaction",
        "body": "Enable REDACT_TELEMETRY=1 with mode hash or truncate to redact sensitive event and replay fields for shared deployments."
      },
      {
        "title": "Environment variables",
        "body": "This service uses validated configuration from src/config.ts. Critical outbound controls: OUTBOUND_HOST_ALLOWLIST, OUTBOUND_ALLOW_ALL, ALLOW_INSECURE_HTTP, TOOL_CALLBACK_ALLOWLIST, MAX_PROVIDER_REQUEST_BYTES, MAX_TOOL_CALLBACK_REQUEST_BYTES, and redaction flags."
      },
      {
        "title": "Outbound data disclosure",
        "body": "When gateway or callback tools are enabled, task inputs, dependency payloads, and tool payloads may be sent outbound to allowed destinations. Keep allowlists strict in shared deployments."
      }
    ],
    "body": "Agent Manager skill\nWhat this file is for\n\nThis file is a concise integration contract for AI tool callers and gateway implementers.\n\nThis skill.md is a compact integration guide for Clawhub and other AI clients.\n\nAgent Manager is an orchestration kernel for external AI planners. External AI builds plans, and Agent Manager validates, schedules, executes tools, enforces budgets, and provides replayable telemetry.\n\nAuthentication\n\nUse X-Run-Token for owner attribution and optional access control.\n\nREQUIRE_RUN_TOKEN=1 enables token enforcement.\nRUN_TOKENS contains allowed token values.\n\nExample header:\n\nX-Run-Token: tenant-a\n\nCapability discovery and endpoint map\n\nStart with:\n\nGET /v1/capabilities\nGET /v1/provider-adapter/schema\n\nCore endpoints:\n\nPOST /v1/plan (validate plus recommendations)\nPOST /v1/plan/validate\nPOST /v1/plan/generate\nPOST /v1/run\nPOST /v1/run/sync\nGET /v1/run/:id\nGET /v1/run/:id/events?after=\nGET /v1/run/:id/stream\nGET /v1/run/:id/replay\nGET /v1/run/:id/report (if enabled)\nGET /v1/runs\nPOST /v1/run/:id/cancel\nPOST /v1/run/:id/task/:name/inject\nPOST /v1/tools/register (only when enabled)\nProvider selection\n\nProvider choice follows this order:\n\ntask.provider_id\nrun.options.provider_id\nDEFAULT_PROVIDER_ID\nmock\n\nRead provider availability from capabilities.llm_providers.providers and capabilities.llm_providers.default_provider_id.\n\nRecommended client flow\nGET /v1/capabilities\nPOST /v1/plan with { plan, options }\nPOST /v1/run (async) or POST /v1/run/sync\nStream with GET /v1/run/:id/stream or poll GET /v1/run/:id/events?after=<seq>\nRead final run from GET /v1/run/:id\nExport replay from GET /v1/run/:id/replay\nUse POST /v1/run/:id/task/:name/inject for deterministic overrides when needed\nTool-calling protocol rule\n\nWhen a provider returns tool_calls, Agent Manager appends exactly one role=\"tool\" message for each tool_call_id before the next provider round.\n\nThis prevents protocol errors in model APIs.\n\nSSE reliability and resume\n\nGET /v1/run/:id/stream sends event id from event sequence numbers.\n\nResume with Last-Event-ID header or ?after= query.\nIf idle and run is non-terminal, heartbeat comments are emitted:\n: ping\n\n\nHeartbeat interval uses SSE_HEARTBEAT_MS (default 15000).\n\nEvent types\n\nCommon emitted event types include:\n\ntask_start, task_end, task_retry\ntool_call_requested, tool_call_start, tool_call_end, tool_call_failed, tool_call_started, tool_call_finished\nllm_step_start, llm_step_tool_calls, llm_step_final\nllm_round_start, llm_round_tool_calls, llm_round_final\nbudget_violation, fallback_start, fallback_end\nrun_complete, run_cancel_requested\ndependency_truncated, artifact_limit\nReplay and report data\n\nGET /v1/run/:id/replay returns stable replay JSON:\n\n{\n  \"run\": { \"id\": \"run_123\", \"created_at\": 1700000000000, \"status\": \"succeeded\" },\n  \"plan_digest\": \"sha256:...\",\n  \"events\": [{ \"seq\": 1, \"type\": \"task_start\", \"run_id\": \"run_123\" }],\n  \"results_index\": { \"task_a\": { \"digest_hash\": \"sha256:...\" } }\n}\n\n\nRun cost attribution is exposed per task in run.metrics.cost_breakdown:\n\n{\n  \"metrics\": {\n    \"cost_breakdown\": {\n      \"task_a\": {\n        \"cost_est\": 0.0021,\n        \"tier\": \"cheap\",\n        \"tool_calls\": 1\n      }\n    }\n  }\n}\n\nHTTP callback tools and timeout enforcement\n\nCallback tools use callback_url and enforce ToolSpec.timeout_ms.\n\nThe execution signal combines run abort plus timeout. On timeout, tool result is structured with error_code as TOOL_TIMEOUT and retryable: true.\n\nProvider adapter contract\n\nUse GET /v1/provider-adapter/schema to fetch schema_version, request and response schemas, and examples for your gateway implementation.\n\nOutbound security defaults\n\nOutbound traffic is blocked by default until allowlists are configured.\n\nProvider and gateway calls require OUTBOUND_ALLOWLIST.\nCallback tools require TOOL_CALLBACK_ALLOWLIST.\nIP literal hostnames and redirect chains are blocked.\nTelemetry redaction\n\nEnable REDACT_TELEMETRY=1 with mode hash or truncate to redact sensitive event and replay fields for shared deployments.\n\nEnvironment variables\n\nThis service uses validated configuration from src/config.ts. Critical outbound controls: OUTBOUND_HOST_ALLOWLIST, OUTBOUND_ALLOW_ALL, ALLOW_INSECURE_HTTP, TOOL_CALLBACK_ALLOWLIST, MAX_PROVIDER_REQUEST_BYTES, MAX_TOOL_CALLBACK_REQUEST_BYTES, and redaction flags.\n\nOutbound data disclosure\n\nWhen gateway or callback tools are enabled, task inputs, dependency payloads, and tool payloads may be sent outbound to allowed destinations. Keep allowlists strict in shared deployments."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/NoNightWatch/agentmanager",
    "publisherUrl": "https://clawhub.ai/NoNightWatch/agentmanager",
    "owner": "NoNightWatch",
    "version": "1.0.2",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/agentmanager",
    "downloadUrl": "https://openagent3.xyz/downloads/agentmanager",
    "agentUrl": "https://openagent3.xyz/skills/agentmanager/agent",
    "manifestUrl": "https://openagent3.xyz/skills/agentmanager/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/agentmanager/agent.md"
  }
}