paperclipai/paperclip · error

reconciled stale managed runtime control operations from a p

Error message

reconciled stale managed runtime control operations from a previous server process

What it means

Startup reconciliation log in startServer. Fires when reconcileManagedRuntimeControlOperationsOnStartup found and reconciled stale managed runtime control operations left behind by a previous server process (operationIds listed).

Source

Thrown at server/src/index.ts:864

    // upgrade behind the Cloud front door 403s forever. The resolver is
    // self-gating: it returns null unless PAPERCLIP_CLOUD_TENANT_SERVER_TOKEN
    // is configured and the request presents the matching trust token, so
    // self-hosted deployments never take this path.
    resolveCloudActor: async (req) => {
      const actor = await resolveCloudTenantActor(
        db as any,
        cloudActorHeaderSourceFromHeaders(req.headers),
      );
      if (!actor?.userId || !actor.companyIds) return null;
      return { userId: actor.userId, companyIds: actor.companyIds };
    },
  });

  try {
    const result = await workspaceOperationService(db as any)
      .reconcileStaleRuntimeControlOperations();
    if (result.reconciled > 0) {
      logger.warn(
        { reconciled: result.reconciled, operationIds: result.operationIds },
        "reconciled stale managed runtime control operations from a previous server process",
      );
    }
  } catch (err) {
    logger.error({ err }, "startup reconciliation of managed runtime control operations failed");
  }

  void reconcilePersistedRuntimeServicesOnStartup(db as any)
    .then((result) => {
      if (
        result.reconciled > 0
        || result.restarted > 0
        || result.restartFailed > 0
        || result.backfilled > 0
      ) {
        logger.warn(
          {

View on GitHub (pinned to a7e689b3c3)

Solutions

  1. Informational only; stale control operations from the previous process were cleaned up.
  2. If this appears on every startup, ensure the server shuts down gracefully so operations are finalized.
Defensive patterns

Strategy: fallback

When it happens

Trigger: Thrown at server/src/index.ts:825 when the library encounters an invalid state.

Common situations: Logged at startup when managed runtime control operations left in a pending state by a previous (crashed or killed) server process are reconciled.


AI-assisted analysis of paperclipai/paperclip@a7e689b3c3 (2026-08-18). Data as JSON: /api/errors/bdd7e942f0a61498. Report an issue: GitHub.