{
  "openapi": "3.1.0",
  "info": {
    "title": "1db API",
    "version": "0.2.0",
    "description": "1db private-preview API for observing communication events, preserving durable cognition, and compiling scoped context."
  },
  "servers": [
    {
      "url": "https://1db.io"
    }
  ],
  "components": {
    "securitySchemes": {
      "tenantCredential": {
        "type": "http",
        "scheme": "bearer",
        "description": "Tenant application credential with cognition:read or cognition:write scope."
      },
      "sessionCookie": {
        "type": "apiKey",
        "in": "cookie",
        "name": "one_db_session"
      }
    }
  },
  "security": [
    {
      "tenantCredential": []
    },
    {
      "sessionCookie": []
    }
  ],
  "paths": {
    "/api/v1/cognition/events": {
      "post": {
        "summary": "Observe a communication or state-change event and optional memory."
      }
    },
    "/api/v1/cognition/context/retrieve": {
      "post": {
        "summary": "Retrieve authorized context with exact checkpoint provenance.",
        "description": "Requires cognition:read. Optional scopeRefs selects at most eight explicit continuity scopes and can pin expectedVersion, expectedCheckpointUid and expectedIntegrityHash. Private scopes require owner or explicit reader access. The durable packet preserves each selected checkpoint UID, version and integrity hash."
      }
    },
    "/api/v1/cognition/context/packets/{packetUid}": {
      "get": {
        "summary": "Read a previously created context packet."
      }
    },
    "/api/v1/cognition/graph": {
      "get": {
        "summary": "Read the 1DB base cognition graph root."
      }
    },
    "/api/v1/cam": {
      "get": {
        "summary": "Read the CAM manifest, layers, engines, relation types, and live counts."
      }
    },
    "/api/v1/cam/associations": {
      "post": {
        "summary": "Create or enrich a tenant-layer association with the CFT/CAM state vector."
      }
    },
    "/api/v1/cam/observe": {
      "post": {
        "summary": "Record a tenant-layer CAM observation and optional association."
      }
    },
    "/api/v1/cam/reinforce/{associationId}": {
      "post": {
        "summary": "Strengthen or weaken a tenant-layer CFT/CAM association state."
      }
    },
    "/api/v1/cognition/cam": {
      "get": {
        "summary": "Read the CAM manifest through the cognition route namespace."
      }
    },
    "/api/v1/cognition/stats": {
      "get": {
        "summary": "Read cognition graph concept and association counts."
      }
    },
    "/api/v1/cognition/seed": {
      "post": {
        "summary": "Run the base cognition graph seeder."
      }
    },
    "/api/v1/cognition/query/{query}": {
      "get": {
        "summary": "Query a concept and return enriched association links."
      }
    },
    "/api/v1/cognition/concepts/{conceptId}": {
      "get": {
        "summary": "Read a cognition concept vertex."
      }
    },
    "/api/v1/cognition/concepts/by-label/{label}": {
      "get": {
        "summary": "Resolve a concept vertex by label."
      }
    },
    "/api/v1/cognition/associations/{associationId}": {
      "get": {
        "summary": "Read an association vertex."
      }
    },
    "/api/v1/cognition/decompose/{conceptId}": {
      "get": {
        "summary": "Read seeded concept decomposition."
      }
    },
    "/api/v1/cognition/rules/{ruleId}": {
      "get": {
        "summary": "Read a composition rule association vertex."
      }
    },
    "/api/v1/cognition/infer": {
      "post": {
        "summary": "Run activation-based inference and persist a session vertex."
      }
    },
    "/api/v1/cognition/sessions/{sessionId}": {
      "get": {
        "summary": "Read a cognition session vertex."
      }
    },
    "/api/v1/cognition/sessions/{sessionId}/explanation": {
      "get": {
        "summary": "Read the explanation trace for a cognition session."
      }
    },
    "/api/v1/cognition/seed/jobs/{jobId}": {
      "get": {
        "summary": "Read a cognition seed job."
      }
    },
    "/api/v1/cognition/enrichment/jobs/{jobId}": {
      "get": {
        "summary": "Read a cognition enrichment job."
      }
    },
    "/api/v1/cognition/evidence/{evidenceId}": {
      "get": {
        "summary": "Read cognition graph evidence."
      }
    },
    "/1db/cognition": {
      "get": {
        "summary": "NodeVertex-style route for the base cognition graph root."
      }
    },
    "/1db/cognition/concepts/{conceptId}": {
      "get": {
        "summary": "NodeVertex-style concept vertex route."
      }
    },
    "/1db/cognition/associations/{associationId}": {
      "get": {
        "summary": "NodeVertex-style association vertex route."
      }
    },
    "/1db/cognition/infer": {
      "post": {
        "summary": "NodeVertex-style cognition inference route."
      }
    },
    "/api/v1/cognition/backends": {
      "get": {
        "summary": "List available cognition stores."
      }
    },
    "/api/v1/cognition/backends/plan": {
      "get": {
        "summary": "Plan a cognition operation."
      }
    },
    "/api/v1/cognition/projects/{projectId}/continuity": {
      "get": {
        "summary": "Read project continuity state."
      }
    },
    "/api/v1/cognition/continuity/{scopeType}/{scopeId}": {
      "get": {
        "summary": "Read the versioned continuity head for a persona or organizational memory scope."
      }
    },
    "/api/v1/cognition/continuity/{scopeType}/{scopeId}/checkpoints": {
      "post": {
        "summary": "Append an optimistic-concurrency continuity checkpoint and advance its head."
      }
    },
    "/api/project-cognition": {
      "get": {
        "summary": "List Project Cognition versions."
      },
      "post": {
        "summary": "Create a versioned Project Cognition record."
      }
    },
    "/api/project-cognition/{projectKey}": {
      "get": {
        "summary": "List versions for one project."
      }
    },
    "/api/project-cognition/{projectKey}/active": {
      "get": {
        "summary": "Load active Project Cognition for agent initialization."
      }
    },
    "/api/project-cognition/{id}": {
      "put": {
        "summary": "Create an updated Project Cognition version."
      }
    },
    "/api/project-cognition/{id}/activate": {
      "post": {
        "summary": "Activate a Project Cognition version."
      }
    },
    "/api/project-cognition/{id}/deactivate": {
      "post": {
        "summary": "Deactivate a Project Cognition version."
      }
    }
  }
}