{"record":{"id":"16e7c85929fffa67","repo":"paperclipai/paperclip","slug":"agent-wakeup-was-skipped-by-heartbeat-policy","errorCode":null,"errorMessage":"Agent wakeup was skipped by heartbeat policy","messagePattern":"Agent wakeup was skipped by heartbeat policy","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"server/src/services/plugin-host-services.ts","lineNumber":2830,"sourceCode":"        const agent = await agents.getById(params.agentId);\n        requireInCompany(\"Agent\", agent, companyId);\n        const run = await heartbeat.wakeup(params.agentId, {\n          source: \"automation\",\n          triggerDetail: \"system\",\n          reason: params.reason ?? null,\n          payload: { prompt: params.prompt },\n          contextSnapshot: {\n            wakeReason: params.reason ?? null,\n            paperclipAgentMessage: {\n              text: params.prompt,\n              source: \"plugin_invoke\",\n              pluginKey,\n            },\n          },\n          requestedByActorType: \"system\",\n          requestedByActorId: pluginId,\n        });\n        if (!run) throw new Error(\"Agent wakeup was skipped by heartbeat policy\");\n        return { runId: run.id };\n      },\n      async managedGet(params) {\n        const companyId = ensureCompanyId(params.companyId);\n        await ensurePluginAvailableForCompany(companyId);\n        return managedAgents.get(params.agentKey, companyId);\n      },\n      async managedReconcile(params) {\n        const companyId = ensureCompanyId(params.companyId);\n        await ensurePluginAvailableForCompany(companyId);\n        return managedAgents.reconcile(params.agentKey, companyId);\n      },\n      async managedReset(params) {\n        const companyId = ensureCompanyId(params.companyId);\n        await ensurePluginAvailableForCompany(companyId);\n        return managedAgents.reset(params.agentKey, companyId);\n      },\n    },","sourceCodeStart":2812,"sourceCodeEnd":2848,"githubUrl":"https://github.com/paperclipai/paperclip/blob/a7e689b3c35347b529cb9f54c9b9a8575a3dcab6/server/src/services/plugin-host-services.ts#L2812-L2848","documentation":"The heartbeat wakeup() call for an agent was suppressed by heartbeat policy (e.g. rate limits, paused agent, or cooldown), so the requested automation wakeup did not dispatch. The result is surfaced as an error so the plugin knows nothing was woken.","triggerScenarios":"Thrown at server/src/services/plugin-host-services.ts:2821 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["This is an informational outcome: the heartbeat policy declined the wakeup. Adjust the agent's heartbeat/wake policy settings or wait for the next eligible wake window."],"exampleFix":null,"handlingStrategy":"fallback","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"a7e689b3c35347b529cb9f54c9b9a8575a3dcab6","analyzedAt":"2026-08-18T22:49:45.177Z","contentChangedAt":"2026-08-18T22:49:45.177Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}